respan-exporter-anthropic-agents 1.0.10

Exporter for Anthropic Agent SDK telemetry to Respan

Respan Exporter for Anthropic Agent SDK

respan.ai | Documentation

Exporter for Anthropic Agent SDK telemetry to Respan.

Installation

pip install respan-exporter-anthropic-agents

Quickstart

import asyncio
from claude_agent_sdk import ClaudeAgentOptions
from respan_exporter_anthropic_agents.respan_anthropic_agents_exporter import (
    RespanAnthropicAgentsExporter,
)

exporter = RespanAnthropicAgentsExporter()

async def main() -> None:
    options = exporter.with_options(
        options=ClaudeAgentOptions(
            allowed_tools=["Read", "Glob", "Grep"],
            permission_mode="acceptEdits",
        )
    )

    async for message in exporter.query(
        prompt="Analyze this repository and summarize architecture.",
        options=options,
    ):
        print(message)

asyncio.run(main())

Configuration

Environment Variables

Variable	Required	Description
RESPAN_API_KEY	Yes	Your Respan API key.
RESPAN_BASE_URL	No	Base URL for all Respan services. Defaults to https://api.respan.ai.

RESPAN_BASE_URL is the single base URL that controls where telemetry is exported. The exporter automatically appends /api/v1/traces/ingest to build the full endpoint.

Constructor Parameters

All configuration can also be passed directly to the constructor.

Recommended pattern (matches the runnable examples):

exporter = RespanAnthropicAgentsExporter(
    api_key="your_respan_key",        # Optional; falls back to RESPAN_API_KEY
    base_url="https://api.respan.ai", # Optional; falls back to RESPAN_BASE_URL
)

Optional advanced override:

exporter = RespanAnthropicAgentsExporter(
    endpoint="https://custom-host/api/v1/traces/ingest",  # Full ingest URL
    timeout_seconds=15,
    max_retries=3,
    base_delay_seconds=1.0,
    max_delay_seconds=30.0,
)

Resolution order:

• api_key: constructor api_key -> RESPAN_API_KEY
• endpoint: constructor endpoint -> derived from constructor base_url -> derived from RESPAN_BASE_URL

Note: if both endpoint and base_url are provided, endpoint takes precedence.

Examples

Runnable examples with full setup instructions:

• Python examples root: python/tracing/anthropic-agents-sdk
• Python basic scripts:
  • hello_world_test.py
  • wrapped_query_test.py
  • tool_use_test.py
  • gateway_test.py
• TypeScript examples root: typescript/tracing/anthropic-agents-sdk

Dev Guide

Running Tests

# Unit tests
python -m unittest tests.test_exporter -v

# Live integration test (opt-in, makes real API calls)
export RESPAN_API_KEY="your_respan_key"
export IS_REAL_GATEWAY_TESTING_ENABLED=1
python -m unittest tests.test_real_gateway_integration -v