feat(tracing): derive LLM Ops URL source param from span Source field

[saksharthakkar]

Motivation

The ?source= query param on the v3 ingest call is what the server persists as Trace.Source (the span body Source is ignored on ingest), but _build_url hardcoded CodedAgents — so every non-coded-agent producer that exports through this SDK (e.g. Agent Builder, which sets uipath.source=1 → Agents) was mislabeled CodedAgents, corrupting per-product migration/cost attribution on the v2→v3 dashboards. This derives the param from the span's already-resolved SpanSource, so each producer self-labels with no per-repo changes. Supersedes stale PR #1428 (re-implemented cleanly on the current v3 URL + SpanSource StrEnum).

Summary

• LlmOpsHttpExporter._build_url now reads span_list[0]["Source"] (a SpanSource) and renders its wire string into &source=…, defaulting to CodedAgents when absent (back-compat for coded agents and minimal/fallback span dicts).
• Import SpanSource alongside SpanStatus from uipath.platform.common._span_utils.
• v3 endpoint (/api/Traces/v3/spans) unchanged; no server, dependency, or uipath-agents-python changes.
• Added 4 tests: explicit Agents, explicit CodedAgents, missing-Source default, and an end-to-end guard driving uipath.source=1 through otel_span_to_uipath_span().to_dict() → _build_url → &source=Agents.

Tests performed

cd packages/uipath && uv run pytest tests/tracing/test_otel_exporters.py (documented via showboat):

• Source-derivation (3/3 passed): test_build_url_uses_span_source_agents (renders source=Agents, not CodedAgents — the regression guard), test_build_url_uses_span_source_coded_agents, test_build_url_defaults_to_coded_agents_when_source_missing.
• End-to-end (1/1 passed): test_agent_builder_span_yields_source_agents — real span with uipath.source=1 resolves to Source=Agents and yields &source=Agents.
• Full exporter file: 35/35 passed, no regressions; _otel_exporters.py coverage 73%.
• Live run (alpha / joetest / ToBeDeleted): deployed the branch as a hacked-coded agent (editable local SDK), ran a Serverless job → Successful, 4 spans ingested to /api/Traces/v3/spans (200). The trace's agent spans stored Source=Agents, and running the deployed branch's _build_url against that trace emits …&source=Agents (vs &source=CodedAgents for a Source-less span).

OR Test

Test plan

• uv run pytest tests/tracing/test_otel_exporters.py green (35/35)
• _build_url has no hardcoded source= literal; v3 endpoint intact
• ruff check / ruff format --check clean on changed files
• End-to-end: Agent Builder–style span (uipath.source=1) exports as source=Agents
• Reviewer confirms server persists Trace.Source=Agents from the query param (server-side behavior; out of scope for this diff)

---

🤖 Generated with Claude Code

https://claude.ai/code/session_0137aKdrnRYUdFg7iY7GmPYM

[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

[Copilot]

Pull request overview

Updates the LLM Ops HTTP exporter to derive the source query parameter from the span’s resolved Source field (a SpanSource) instead of hardcoding CodedAgents, ensuring traces are attributed to the correct producing product on the server-side Trace.Source.

Changes:

• Derive &source=... in LlmOpsHttpExporter._build_url() from span_list[0].get("Source"), defaulting to SpanSource.CODED_AGENTS when absent.
• Add targeted unit + end-to-end-style tests validating explicit Sources and the uipath.source=1 -> Source=Agents -> &source=Agents flow.
• Bump uipath package version from 2.12.4 to 2.12.5.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File	Description
packages/uipath/src/uipath/tracing/_otel_exporters.py	Builds v3 ingest URL using the span’s SpanSource for the source query param (with CodedAgents fallback).
packages/uipath/tests/tracing/test_otel_exporters.py	Adds regression and end-to-end guard tests for correct source= derivation and defaulting behavior.
packages/uipath/pyproject.toml	Version bump to release the tracing attribution fix.

---

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

[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 →