CjJSSKJr SSKJrJr SSKJrJr SSKJr SSK J r SSK J r SS K JrJrJrJrJrJrJrJrJrJrJrJrJr SS KJr SS KJr \(aSS KJ r SSSjjr!S Sjr"S!Sjr#S"S#Sjjr$S$S%Sjjr%S$S&Sjjr&SS'Sjjr'S(S)Sjjr(S*S+Sjjr)SS,Sjjr*S*S-Sjjr+S.S/Sjjr,S0S1Sjjr-S2S3Sjjr.S*S4Sjjr/SS5Sjjr0g )6) annotations)MappingSequence) TYPE_CHECKINGAny)logger) TracingConfig)get_trace_provider) AgentSpanDataCustomSpanDataFunctionSpanDataGenerationSpanDataGuardrailSpanDataHandoffSpanDataMCPListToolsSpanDataResponseSpanDataSpeechGroupSpanDataSpeechSpanData TaskSpanDataTranscriptionSpanData TurnSpanData)Span)Trace)ResponseNc [5R5nU(a[R"S5 [5R UUUUUUS9$)a Create a new trace. The trace will not be started automatically; you should either use it as a context manager (`with trace(...):`) or call `trace.start()` + `trace.finish()` manually. In addition to the workflow name and optional grouping identifier, you can provide an arbitrary metadata dictionary to attach additional user-defined information to the trace. Args: workflow_name: The name of the logical app or workflow. For example, you might provide "code_bot" for a coding agent, or "customer_support_agent" for a customer support agent. trace_id: The ID of the trace. Optional. If not provided, we will generate an ID. We recommend using `util.gen_trace_id()` to generate a trace ID, to guarantee that IDs are correctly formatted. group_id: Optional grouping identifier to link multiple traces from the same conversation or process. For instance, you might use a chat thread ID. metadata: Optional dictionary of additional metadata to attach to the trace. tracing: Optional tracing configuration for exporting this trace. disabled: If True, we will return a Trace but the Trace will not be recorded. Returns: The newly created trace object. zKTrace already exists. Creating a new trace, but this is probably a mistake.)nametrace_idgroup_idmetadatatracingdisabled)r get_current_tracer warning create_trace) workflow_namerr r!r"r# current_traces g/home/rurouni/.local/share/pipx/venvs/strix-agent/lib/python3.13/site-packages/agents/tracing/create.pytracer*sW@'(::r6r7r#s r) turn_spanr?s0   + +D@ , r+cF[5R[XUS9UUUS9$)aCreate a new function span. The span will not be started automatically, you should either do `with function_span() ...` or call `span.start()` + `span.finish()` manually. Args: name: The name of the function. input: The input to the function. output: The output of the function. span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. Returns: The newly created function span. )rinputoutputr4)r r8r)rrArBr6r7r#s r) function_spanrCs22   + +"&I , r+c L[5R[UUUUUS9UUUS9$)aCreate a new generation span. The span will not be started automatically, you should either do `with generation_span() ...` or call `span.start()` + `span.finish()` manually. This span captures the details of a model generation, including the input message sequence, any generated outputs, the model name and configuration, and usage data. If you only need to capture a model response identifier, use `response_span()` instead. Args: input: The sequence of input messages sent to the model. output: The sequence of output messages received from the model. model: The model identifier used for the generation. model_config: The model configuration (hyperparameters) used. usage: A dictionary of usage information (input tokens, output tokens, etc.). span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. Returns: The newly created generation span. )rArBmodel model_configusager4)r r8r)rArBrErFrGr6r7r#s r)generation_spanrHsBD   + +$%   ,  r+cD[5R[US9UUUS9$)a}Create a new response span. The span will not be started automatically, you should either do `with response_span() ...` or call `span.start()` + `span.finish()` manually. Args: response: The OpenAI Response object. span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. )responser4)r r8r)rJr6r7r#s r) response_spanrKs0$   + +"H5 , r+cD[5R[XS9UUUS9$)aCreate a new handoff span. The span will not be started automatically, you should either do `with handoff_span() ...` or call `span.start()` + `span.finish()` manually. Args: from_agent: The name of the agent that is handing off. to_agent: The name of the agent that is receiving the handoff. span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. Returns: The newly created handoff span. ) from_agentto_agentr4)r r8r)rMrNr6r7r#s r) handoff_spanrOs0.   + +!ZK , r+cV[5R[X=(d 0S9UUUS9$)a Create a new custom span, to which you can add your own metadata. The span will not be started automatically, you should either do `with custom_span() ...` or call `span.start()` + `span.finish()` manually. Args: name: The name of the custom span. data: Arbitrary structured data to associate with the span. span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. Returns: The newly created custom span. )rdatar4)r r8r)rrQr6r7r#s r) custom_spanrR%s40   + + d< , r+cD[5R[XS9UUUS9$)aCreate a new guardrail span. The span will not be started automatically, you should either do `with guardrail_span() ...` or call `span.start()` + `span.finish()` manually. Args: name: The name of the guardrail. triggered: Whether the guardrail was triggered. span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. )r triggeredr4)r r8r)rrTr6r7r#s r)guardrail_spanrUEs0(   + +#C , r+c L[5R[UUUUUS9UUUS9$)aCreate a new transcription span. The span will not be started automatically, you should either do `with transcription_span() ...` or call `span.start()` + `span.finish()` manually. Args: model: The name of the model used for the speech-to-text. input: The audio input of the speech-to-text transcription, as a base64 encoded string of audio bytes. input_format: The format of the audio input (defaults to "pcm"). output: The output of the speech-to-text transcription. model_config: The model configuration (hyperparameters) used. span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. Returns: The newly created speech-to-text span. )rA input_formatrBrErFr4)r r8r)rErArWrBrFr6r7r#s r)transcription_spanrXasA<   + +'%%   ,  r+c N[5R[UUUUUUS9UUUS9$)aCreate a new speech span. The span will not be started automatically, you should either do `with speech_span() ...` or call `span.start()` + `span.finish()` manually. Args: model: The name of the model used for the text-to-speech. input: The text input of the text-to-speech. output: The audio output of the text-to-speech as base64 encoded string of PCM audio bytes. output_format: The format of the audio output (defaults to "pcm"). model_config: The model configuration (hyperparameters) used. first_content_at: The time of the first byte of the audio output. span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. )rErArB output_formatrFfirst_content_atr4)r r8r) rErArBrZrFr[r6r7r#s r) speech_spanr\sD8   + + '%-   ,  r+cD[5R[US9UUUS9$)aCreate a new speech group span. The span will not be started automatically, you should either do `with speech_group_span() ...` or call `span.start()` + `span.finish()` manually. Args: input: The input text used for the speech request. span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. )rAr4)r r8r)rAr6r7r#s r)speech_group_spanr^s0$   + +%E2 , r+cD[5R[XS9UUUS9$)aCreate a new MCP list tools span. The span will not be started automatically, you should either do `with mcp_tools_span() ...` or call `span.start()` + `span.finish()` manually. Args: server: The name of the MCP server. result: The result of the MCP list tools call. span_id: The ID of the span. Optional. If not provided, we will generate an ID. We recommend using `util.gen_span_id()` to generate a span ID, to guarantee that IDs are correctly formatted. parent: The parent span or trace. If not provided, we will automatically use the current trace/span as the parent. disabled: If True, we will return a Span but the Span will not be recorded. )serverresultr4)r r8r)r`rar6r7r#s r)mcp_tools_spanrbs0(   + +&fD , r+)NNNNF)r'strr str | Noner rdr!dict[str, Any] | Noner"zTracingConfig | Noner#boolreturnr)rgz Trace | None)rgzSpan[Any] | None)NNNNNF)rrcr1list[str] | Noner2rhr3rdr6rdr7Trace | Span[Any] | Noner#rfrgzSpan[AgentSpanData])NNF) rrcr6rdr7rir#rfrgzSpan[TaskSpanData]) r=intr>rcr6rdr7rir#rfrgzSpan[TurnSpanData])rrcrArdrBrdr6rdr7rir#rfrgzSpan[FunctionSpanData])NNNNNNNF)rA"Sequence[Mapping[str, Any]] | NonerBrkrErdrFMapping[str, Any] | NonerGrer6rdr7rir#rfrgzSpan[GenerationSpanData])NNNF) rJzResponse | Noner6rdr7rir#rfrgzSpan[ResponseSpanData]) rMrdrNrdr6rdr7rir#rfrgzSpan[HandoffSpanData]) rrcrQrer6rdr7rir#rfrgzSpan[CustomSpanData])FNNF) rrcrTrfr6rdr7rir#rfrgzSpan[GuardrailSpanData])NNpcmNNNNF)rErdrArdrWrdrBrdrFrlr6rdr7rir#rfrgzSpan[TranscriptionSpanData]) NNNrmNNNNF)rErdrArdrBrdrZrdrFrlr[rdr6rdr7rir#rfrgzSpan[SpeechSpanData]) rArdr6rdr7rir#rfrgzSpan[SpeechGroupSpanData]) r`rdrarhr6rdr7rir#rfrgzSpan[MCPListToolsSpanData])1 __future__rcollections.abcrrtypingrrr configr setupr r5r rrrrrrrrrrrrspansrtracesropenai.types.responsesrr*r$r/r9r;r?rCrHrKrOrRrUrXr\r^rbr-r+r)rvs"-%!%/  &*$( ----$ - " -  - -`4 3"&""'+          %   J'+      %    $'+      %     $'+      %   D1515-1#''+- -- .- -+ - ! -  - %---b!%'+   %   6"'+  %     B#''+    %     D'+   %     :$-1'+) ) ))  ) + )  ) %))!)Z %-1#''+( ( ( ( ( + ( ! (( %(((X'+    %   6#'+    %     r+