Source code for tracing.util

"""
AdalFlow tracing utilities module with OpenAI Agents SDK compatibility.

This module provides utility functions for tracing such as ID generation and
time formatting following OpenAI Agents SDK patterns.

References:
- OpenAI Tracing Interface: https://github.com/openai/openai-agents-python/blob/main/src/agents/tracing/util.py
"""

import uuid
from datetime import datetime, timezone



[docs]
def time_iso() -> str:
    """Returns the current time in ISO 8601 format."""
    return datetime.now(timezone.utc).isoformat()




[docs]
def gen_trace_id() -> str:
    """Generates a new trace ID."""
    return f"trace_{uuid.uuid4().hex}"




[docs]
def gen_span_id() -> str:
    """Generates a new span ID."""
    return f"span_{uuid.uuid4().hex[:24]}"




[docs]
def gen_group_id() -> str:
    """Generates a new group ID."""
    return f"group_{uuid.uuid4().hex[:24]}"