Add start_time and end_time parameters to OpenTelemetry scope classes

[Copilot]

Port of Node.js PR #205. Enables explicit span timestamps for operations recorded after completion (e.g., LangChain tracer using run.start_time/run.end_time).

Changes

• OpenTelemetryScope: Add start_time/end_time constructor params and set_end_time() method
• Scope subclasses: Forward params through InferenceScope, InvokeAgentScope, ExecuteToolScope, OutputScope
• Type: Use datetime | None (simpler than Node.js TimeInput union—more Pythonic)

Usage

from datetime import datetime, UTC
from microsoft_agents_a365.observability.core import ExecuteToolScope

# Pass datetime objects for custom timestamps
scope = ExecuteToolScope.start(
    details, agent, tenant,
    start_time=datetime(2023, 11, 14, 22, 13, 20, tzinfo=UTC),
    end_time=datetime(2023, 11, 14, 22, 13, 25, tzinfo=UTC),
)

# Or override end time before dispose
scope.set_end_time(custom_end)
scope.dispose()

Note: LangChain tracer already uses run.start_time/run.end_time via as_utc_nano()—no changes needed there.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• il-1234567812345678123456781234567.8.tenant.api.powerplatform.com
  • Triggering command: /home/REDACTED/work/Agent365-python/Agent365-python/.venv/bin/pytest pytest tests/observability/ -v --tb=short -m not integration (dns block)
  • Triggering command: /home/REDACTED/work/Agent365-python/Agent365-python/.venv/bin/pytest pytest tests/ -v --tb=short -m not integration (dns block)
• il-testtenan.t.tenant.api.powerplatform.com
  • Triggering command: /home/REDACTED/work/Agent365-python/Agent365-python/.venv/bin/pytest pytest tests/observability/ -v --tb=short -m not integration (dns block)
  • Triggering command: /home/REDACTED/work/Agent365-python/Agent365-python/.venv/bin/pytest pytest tests/ -v --tb=short -m not integration (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[github-actions]

⚠️ Deprecation Warning: The deny-licenses option is deprecated for possible removal in the next major release. For more information, see issue 997.

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

[Copilot]

Pull request overview

This PR adds support for explicit start and end timestamps to OpenTelemetry scope classes, porting functionality from Node.js PR #205. This enables post-hoc telemetry recording where operations complete before spans are created, such as in LangChain callbacks that use run.start_time and run.end_time.

Changes:

• Added start_time and end_time parameters (type datetime | None) to all OpenTelemetry scope classes
• Implemented _datetime_to_ns() helper for datetime-to-nanoseconds conversion
• Added set_end_time() method to allow dynamic end time updates
• Created comprehensive test suite covering custom timestamps, time overrides, and fallback to wall-clock time

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/opentelemetry_scope.py	Core implementation: added start_time/end_time parameters, _datetime_to_ns() converter, and set_end_time() method to base OpenTelemetryScope class
libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/execute_tool_scope.py	Forward start_time/end_time parameters through ExecuteToolScope constructor and start() method with detailed docstrings
libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/inference_scope.py	Forward start_time/end_time parameters through InferenceScope constructor and start() method
libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/invoke_agent_scope.py	Forward start_time/end_time parameters through InvokeAgentScope constructor and start() method
libraries/microsoft-agents-a365-observability-core/microsoft_agents_a365/observability/core/spans_scopes/output_scope.py	Forward start_time/end_time parameters through OutputScope constructor and start() method
tests/observability/core/test_custom_start_end_time.py	Comprehensive test suite with 4 test cases covering datetime conversion, time overrides, wall-clock fallback, and partial custom times