"""
LiveKit integration for Noveum Trace SDK.

This package provides automatic tracing for LiveKit AgentSession and RealtimeSession,
as well as optional wrappers for STT and TTS providers.

For voice agents using AgentSession, use setup_livekit_tracing() which automatically
captures (no manual configuration needed):
- LLM metrics (tokens, cost, model, TTFT, latency) from metrics_collected events
- Conversation history from LiveKit's built-in ChatContext
- Function calls and outputs from function_tools_executed events
- Available tools extracted from the agent
- Full conversation audio from LiveKit's RecorderIO (when record=True)
- All AgentSession and RealtimeSession events as spans

The recommended approach is to use setup_livekit_tracing() which hooks into the session's
event system. Optionally, you can also wrap STT/TTS providers for individual operation tracing.

See docs/examples/livekit_integration_example.py for complete usage examples.
"""

# Import STT/TTS/LLM wrappers
from noveum_trace.integrations.livekit.livekit_llm import LiveKitLLMWrapper

# Import session tracing (recommended for AgentSession)
from noveum_trace.integrations.livekit.livekit_session import setup_livekit_tracing
from noveum_trace.integrations.livekit.livekit_stt import LiveKitSTTWrapper
from noveum_trace.integrations.livekit.livekit_tts import LiveKitTTSWrapper

# Import utility functions
from noveum_trace.integrations.livekit.livekit_utils import extract_job_context

__all__ = [
    # Session tracing (recommended)
    "setup_livekit_tracing",
    # STT/TTS/LLM Wrappers
    "LiveKitSTTWrapper",
    "LiveKitTTSWrapper",
    "LiveKitLLMWrapper",
    # Utility functions
    "extract_job_context",
]