Xpander instrumentation

[srilaasya]

📥 Pull Request

📘 Description

• Adds complete instrumentation for Xpander enterprise agent SDK with session tracking and 5-level span hierarchy

• Creates persistent sessions across executions using memory_thread_id for conversation continuity

• Captures tool calls, LLM interactions, and agent workflows with OpenAI-compatible message formatting

  Session Management

• Implemented XpanderContext for thread-safe session tracking across agent executions

• Sessions persist until conversation completion detected via xpfinish-agent-execution-finished tool

• Handles concurrent sessions with proper span lifecycle management

Span Hierarchy

• Session spans (root) → Agent/Workflow spans → LLM spans → Execution spans → Tool spans
• Agent contexts propagate to LLM calls through session ID mapping
• Tool execution maintains parent context from calling LLM interaction

Files Added/Modified

• instrumentor.py - Main instrumentation class with method wrapping
• context.py - Session context management separated from core logic
• trace_probe.py - Auto-activation and backward compatibility functions
• init.py - Updated imports for modular architecture

🧪 Testing

• Pre-commit hooks pass (ruff + ruff-format)
• Session persistence verified across multiple executions
• Span nesting confirmed with proper parent-child relationships
• Tool extraction tested with various call formats

Example

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[dudutwizer]

We released version 2 of the xpander-sdk to complete the transition to a backend platform. We will submit a pull request to your codebase with the necessary changes.

In the meantime, please lock the xpander-sdk to version 1.64.0

You can find the package here: https://pypi.org/project/xpander-sdk/