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

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

  # Any version from this PR (uncomment to use a range instead):
  # "uipath>=2.11.10.dev1017450000,<2.11.10.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.74.dev1017456915"]