feat(a365): propagate sessions and custom baggage

[Nikhil Navakiran (nikhilNava)]

Summary

• propagate request session IDs to manual InvokeAgent, Inference, and ExecuteTool scopes
• add opt-in custom baggage registration and recognized-GenAI span enrichment
• preserve span/SDK precedence and document inbound baggage trust boundaries

Validation

• npm run typecheck:baggage-public-api
• targeted baggage tests
• npm run build
• npm run format
• npm run lint (warnings only)
• npm run test:unit
• npm run test:functional
• npm run test:esm-build
• npm run docs (existing warnings only)

Parity with microsoft/opentelemetry-distro-dotnet#116. ETW logger changes are out of scope; JavaScript already omits obsolete tool-server-name data.

[Copilot]

🟡 Changes recommended

Update the documentation to cover the full recognized GenAI operation set.

Get a fresh assessment by requesting another Copilot review.

Pull request overview

Adds session ID propagation to manual A365 scopes and opt-in custom baggage enrichment for recognized GenAI spans.

Changes:

• Propagates session IDs through inference and tool scopes.
• Adds custom baggage registration and span enrichment with precedence handling.
• Adds tests, API typechecks, documentation, changelog, and CI validation.

File summaries

File	Reviewed changes
tsconfig.baggage-public-api.json	Focused public API typecheck configuration.
test/typecheck/baggageBuilder.public-api.typecheck.ts	Public API compatibility checks.
test/internal/unit/a365/scopes.test.ts	Session propagation coverage.
test/internal/unit/a365/baggageBuilder.test.ts	Custom baggage behavior coverage.
test/internal/unit/a365/a365SpanProcessor.test.ts	Span enrichment coverage.
src/a365/scopes/InferenceScope.ts	Session ID propagation.
src/a365/scopes/ExecuteToolScope.ts	Session ID propagation.
src/a365/processors/A365SpanProcessor.ts	Custom baggage span enrichment.
src/a365/middleware/BaggageBuilder.ts	Custom baggage registration and metadata handling.
src/a365/constants.ts	Internal metadata constant.
package.json	Public API typecheck script.
CHANGELOG.md	Feature release note.
A365_DOCUMENTATION.md	Session and custom baggage documentation; recognized operation coverage needs alignment.
.github/workflows/pr-validation.yml	CI typecheck validation.

Review details

• Files reviewed: 14/14 changed files
• Comments generated: 1
• Review effort level: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Radhika Gupta (rads-1996)]

LGTM