fix(tracing): use a span processor to add custom span attributes

[dhaifley]

• Fix custom tracing span attributes for the kagent-adk, kagent-langgraph, kagent-crewai packages.
• Add a custom span processor which can be used to include custom kagent span metrics for all spans created within a particular OTel trace context.
• Use the custom span processor, and update the execute method of each agent framework package to set the custom span attributes in context.

[Copilot]

Pull Request Overview

This PR adds a custom span processor to propagate kagent-specific attributes to all tracing spans, including those created by auto-instrumentation libraries. The change ensures that user_id, task_id, and session_id attributes are automatically added to all spans in a request context.

• Introduces KagentAttributesSpanProcessor that reads attributes from OpenTelemetry context and applies them to spans
• Registers the new span processor alongside the existing OTLP processor in the tracing configuration
• Refactors attribute setting in _agent_executor.py to use context variables instead of manually setting attributes on individual spans, and fixes a typo in the conversation ID attribute name

Reviewed Changes

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

File	Description
python/packages/kagent-core/src/kagent/core/tracing/_span_processor.py	Implements the new KagentAttributesSpanProcessor class and helper functions for managing kagent span attributes in the OpenTelemetry context
python/packages/kagent-core/src/kagent/core/tracing/_utils.py	Integrates the new span processor by registering it alongside the OTLP processor in both the existing and new TracerProvider code paths
python/packages/kagent-adk/src/kagent/adk/_agent_executor.py	Refactors to set attributes via context variables at the start of request handling instead of manually setting them on individual spans, and fixes the "gen_ai.converstation.id" typo to "gen_ai.conversation.id"

---

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

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.