start_span

with start_span("manual_span", type="SPAN") as span:
    # Do work
    span.update(metadata={"status": "done"})

def rag_pipeline(query: str, trace_id: str) -> str:
    token = set_context(trace_id=trace_id)

    try:
        # Retrieval step
        with start_span(
            "retrieve_documents",
            type="RETRIEVER",
            description="Searches vector store for relevant documents",
            input={"query": query},
        ) as span:
            # Simulated vector store search
            docs = [
                {"id": "doc1", "content": "Paris is the capital of France."},
                {"id": "doc2", "content": "France is in Western Europe."},
            ]
            span.update(output={"doc_count": len(docs), "docs": docs})

        # Generation step
        with start_span(
            "generate_response",
            type="GENERATION",
            description="Generates final response using retrieved context",
            input={"query": query},
        ) as span:
            # Simulated LLM response
            response_content = "Based on the documents, Paris is the capital of France."
            span.update(
                output={"response": response_content},
                metadata={"tokens_used": 42, "model": "gpt-4"},
            )

        return response_content
    finally:
        clear_context(token)


# Create a trace to associate spans with
trace_for_rag = galtea.traces.create(
    session_id=session_start_span.id,
    input="What is the capital of France?",
)
if trace_for_rag is None:
    raise ValueError("trace_for_rag is None")

result = rag_pipeline("What is the capital of France?", trace_for_rag.id)

def process_with_nested_spans(trace_id: str) -> dict:
    token = set_context(trace_id=trace_id)

    try:
        with start_span("parent_operation", type="CHAIN", input={"task": "process_all"}) as parent:
            # First child
            with start_span("child_step_1", type="TOOL") as span:
                step1_result = {"processed": True, "items": 5}
                span.update(output=step1_result)

            # Second child
            with start_span("child_step_2", type="TOOL") as span:
                step2_result = {"validated": True, "errors": 0}
                span.update(output=step2_result)

            parent.update(output={"total_steps": 2, "status": "completed"})

        return {"step1": step1_result, "step2": step2_result}
    finally:
        clear_context(token)


# Create another trace for nested span example
trace_for_nested = galtea.traces.create(
    session_id=session_start_span.id,
    input="Process all items",
)
if trace_for_nested is None:
    raise ValueError("trace_for_nested is None")

nested_result = process_with_nested_spans(trace_for_nested.id)