feat(governance): add track_event for custom telemetry to /runtime/log

[viswa-uipath]

Summary

Adds track_event to GovernanceService and UiPathPlatformGovernanceProvider for posting custom telemetry events to POST /agenticgovernance_/api/v1/runtime/log. The server forwards each event to App Insights as a customEvents row.

• GovernanceService.track_event(*, event_name, data=None, operation_id=None) + async — POSTs { eventName, data? } to /runtime/log. eventName must be non-empty; data is included only when provided.
• x-uipath-operation-id header — caller can supply operation_id to correlate events from one logical request (becomes App Insights operation_Id). When omitted, falls back to resolve_trace_id() so events from the same agent trace correlate automatically. When no source resolves, the header is omitted and App Insights generates its own id per event.
• UiPathPlatformGovernanceProvider.track_event(*, ...) + async — thin delegate so runtime consumers can emit events through the protocol-adapter surface without importing the platform service directly.

Bumps: uipath-platform 0.1.73 → 0.1.74.

Design choices

• Public ergonomic signature, matching compensate(*, ...) — track_event(*, event_name, data=None, operation_id=None) follows the same kwarg-only pattern already established on the service; no request-object wrapper.
• operation_id fallback to resolve_trace_id(), not required — events emitted from inside an OTel-traced agent flow automatically get the canonical trace id as their operation_Id. Callers in background pools (where OTel context is thread-local and lost) pass operation_id explicitly; callers with neither leave App Insights to assign one per event.
• Reuses _build_org_scoped_request — UIPATH_SERVICE_URL_AGENTICGOVERNANCE override + routing-header injection work for /runtime/log without extra plumbing. Override redirects to {override}/api/v1/runtime/log and replaces the platform router's tenant/account headers.
• No new core protocol — track_event is platform-specific telemetry, not a runtime contract. Adding a protocol can be done later if uipath-runtime consumers need to swap in fakes.
• @traced(name="governance_track_event", ...) on both sync/async — matches the trace span names already used for retrieve_policy and compensate.

Out of scope (follow-ups)

• A core protocol for track_event if/when a runtime consumer needs constructor-injected fakes.

Test plan

• ruff check . / ruff format --check . — clean
• mypy src tests — Success: no issues found in 201 source files
• 1301 passed, 7 skipped (LLM creds), 4 deselected — full uipath-platform suite
• 12 new tests specifically for track_event:
  • TestTrackEvent (8): name-only payload; data included when provided; caller operation_id header; trace-id fallback via resolve_trace_id(); caller value wins over fallback; header omitted when no source resolves; UIPATH_ORGANIZATION_ID missing raises ValueError; HTTP error raises EnrichedException.
  • TestTrackEventAsync (1): async variant — payload shape + trace-id fallback.
  • TestServiceUrlOverride (+1): UIPATH_SERVICE_URL_AGENTICGOVERNANCE redirects /runtime/log and preserves x-uipath-operation-id.
  • TestDelegation (+2): provider delegation for sync + async.

🤖 Generated with Claude Code

Development Packages

uipath-platform

[project]
dependencies = [
  # Exact version (copy-paste ready):
  "uipath-platform==0.1.76.dev1017456959",

  # Any version from this PR (uncomment to use a range instead):
  # "uipath-platform>=0.1.76.dev1017450000,<0.1.76.dev1017460000",
]

[[tool.uv.index]]
name = "testpypi"
url = "https://test.pypi.org/simple/"
publish-url = "https://test.pypi.org/legacy/"
explicit = true

[tool.uv.sources]
uipath-platform = { index = "testpypi" }

uipath-core

[project]
dependencies = [
  # Exact version (copy-paste ready):
  "uipath-core==0.5.23.dev1017456957",

  # Any version from this PR (uncomment to use a range instead):
  # "uipath-core>=0.5.23.dev1017450000,<0.5.23.dev1017460000",
]

[[tool.uv.index]]
name = "testpypi"
url = "https://test.pypi.org/simple/"
publish-url = "https://test.pypi.org/legacy/"
explicit = true

[tool.uv.sources]
uipath-core = { index = "testpypi" }

uipath

[project]
dependencies = [
  # Exact version (copy-paste ready):
  "uipath==2.11.12.dev1017456959",

  # Any version from this PR (uncomment to use a range instead):
  # "uipath>=2.11.12.dev1017450000,<2.11.12.dev1017460000",
]

[[tool.uv.index]]
name = "testpypi"
url = "https://test.pypi.org/simple/"
publish-url = "https://test.pypi.org/legacy/"
explicit = true

[tool.uv.sources]
uipath = { index = "testpypi" }
uipath-platform = { index = "testpypi" }

[tool.uv]
override-dependencies = ["uipath-platform==0.1.76.dev1017456959"]

[Copilot]

Pull request overview

Adds a platform-specific telemetry hook to the uipath-platform governance surface so runtime consumers can emit custom events to the agentic governance ingress (POST .../api/v1/runtime/log), with optional correlation via x-uipath-operation-id.

Changes:

• Add GovernanceService.track_event() / track_event_async() to POST {eventName, data?} to /runtime/log, with operation_id falling back to resolve_trace_id().
• Add UiPathPlatformGovernanceProvider.track_event() / track_event_async() delegation methods.
• Bump uipath-platform version 0.1.73 → 0.1.74 (and lockfile).

Reviewed changes

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

Show a summary per file

File	Description
packages/uipath-platform/src/uipath/platform/governance/_governance_service.py	Adds the new /runtime/log client methods and operation-id header behavior.
packages/uipath-platform/src/uipath/platform/governance/_governance_provider.py	Exposes track_event through the provider adapter via thin delegation.
packages/uipath-platform/tests/services/test_governance_service.py	Adds sync/async tests covering payload shape, operation-id behavior, override routing, and error paths.
packages/uipath-platform/tests/services/test_governance_provider.py	Adds delegation tests for the provider’s sync/async track_event methods.
packages/uipath-platform/pyproject.toml	Version bump to 0.1.74.
packages/uipath-platform/uv.lock	Lockfile update reflecting the version bump.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[github-actions]

🚨 Heads up: uipath-langchain cross-tests are FAILING 🚨

Your changes may break the uipath-langchain-python integration.

⚠️ These checks are NOT enforced by branch protection rules. Please review the failures before merging.

🔍 Inspect the failed run →