import { Response } from 'openai/resources/responses/responses';
import { AgentSpanData, CustomSpanData, FunctionSpanData, GenerationSpanData, GuardrailSpanData, HandoffSpanData, MCPListToolsSpanData, ResponseSpanData, SpeechGroupSpanData, SpeechSpanData, TranscriptionSpanData } from './span-data';
import { Span } from './spans';
import { Trace } from './traces';
/**
 * 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.
 *
 * @param workflowName - 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.
 * @param traceId - The ID of the trace. Optional. If not provided, we will generate an ID. We
 * recommend using `util.genTraceId()` to generate a trace ID, to guarantee that IDs are
 * correctly formatted.
 * @param groupId - Optional grouping identifier to link multiple traces from the same conversation
 * or process. For instance, you might use a chat thread ID.
 * @param metadata - Optional dictionary of additional metadata to attach to the trace.
 * @param disabled - If True, we will return a Trace but the Trace will not be recorded. This will
 * not be checked if there's an existing trace and `even_if_trace_running` is True.
 * @returns The newly created trace object.
 */
export declare function trace(workflowName: string, traceId?: string | null, groupId?: string | null, metadata?: Record<string, any> | null, disabled?: boolean): Trace;
/**
 * Returns the currently active trace, if present.
 */
export declare function getCurrentTrace(): Trace | null;
/**
 * Returns the currently active span, if present.
 */
export declare function getCurrentSpan(): Span<any> | null;
/**
 * Create a new agent span. The span will not be started automatically, you should either do
 * `with agent_span() ...` or call `span.start()` + `span.finish()` manually.
 *
 * @param name - The name of the agent.
 * @param handoffs - Optional list of agent names to which this agent could hand off control.
 * @param tools - Optional list of tool names available to this agent.
 * @param outputType - Optional name of the output type produced by the agent.
 * @param spanId - The ID of the span. Optional. If not provided, we will generate an ID. We
 * recommend using `util.genSpanId()` to generate a span ID, to guarantee that IDs are
 * correctly formatted.
 * @param parent - The parent span or trace. If not provided, we will automatically use the current
 * trace/span as the parent.
 * @param disabled - If True, we will return a Span but the Span will not be recorded.
 * @returns The newly created agent span.
 */
export declare function agentSpan(name: string, handoffs?: string[] | null, tools?: string[] | null, outputType?: string | null, spanId?: string | null, parent?: Trace | Span<any> | null, disabled?: boolean): Span<AgentSpanData>;
/**
 * Create 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.
 *
 * @param name - The name of the function.
 * @param input - The input to the function.
 * @param output - The output of the function.
 * @param spanId - The ID of the span. Optional. If not provided, we will generate an ID. We
 * recommend using `util.genSpanId()` to generate a span ID, to guarantee that IDs are
 * correctly formatted.
 * @param parent - The parent span or trace. If not provided, we will automatically use the current
 * trace/span as the parent.
 * @param disabled - If True, we will return a Span but the Span will not be recorded.
 * @returns The newly created function span.
 */
export declare function functionSpan(name: string, input?: string | null, output?: any | null, spanId?: string | null, parent?: Trace | Span<any> | null, disabled?: boolean): Span<FunctionSpanData>;
/**
 * Create 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 `responseSpan()` instead.
 *
 * @param input - The sequence of input messages sent to the model.
 * @param output - The sequence of output messages received from the model.
 * @param model - The model identifier used for the generation.
 * @param modelConfig - The model configuration (hyperparameters) used.
 * @param usage - A dictionary of usage information (input tokens, output tokens, etc.).
 * @param spanId - The ID of the span. Optional. If not provided, we will generate an ID. We
 * recommend using `util.genSpanId()` to generate a span ID, to guarantee that IDs are
 * correctly formatted.
 * @param parent - The parent span or trace. If not provided, we will automatically use the current
 * trace/span as the parent.
 * @param disabled - If True, we will return a Span but the Span will not be recorded.
 * @returns The newly created generation span.
 */
export declare function generationSpan(input?: Array<Record<string, any>> | null, output?: Array<Record<string, any>> | null, model?: string | null, modelConfig?: Record<string, any> | null, usage?: Record<string, any> | null, spanId?: string | null, parent?: Trace | Span<any> | null, disabled?: boolean): Span<GenerationSpanData>;
/**
 * 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.
 *
 * @param response - The OpenAI Response object.
 * @param spanId - The ID of the span. Optional. If not provided, we will generate an ID. We
 * recommend using `util.genSpanId()` to generate a span ID, to guarantee that IDs are
 * correctly formatted.
 * @param parent - The parent span or trace. If not provided, we will automatically use the current
 * trace/span as the parent.
 * @param disabled - If True, we will return a Span but the Span will not be recorded.
 * @returns The newly created response span.
 */
export declare function responseSpan(response?: Response | null, spanId?: string | null, parent?: Trace | Span<any> | null, disabled?: boolean): Span<ResponseSpanData>;
/**
 * Create 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.
 *
 * @param fromAgent - The name of the agent that is handing off.
 * @param toAgent - The name of the agent that is receiving the handoff.
 * @param spanId - The ID of the span. Optional. If not provided, we will generate an ID. We
 * recommend using `util.genSpanId()` to generate a span ID, to guarantee that IDs are
 * correctly formatted.
 * @param parent - The parent span or trace. If not provided, we will automatically use the current
 * trace/span as the parent.
 * @param disabled - If True, we will return a Span but the Span will not be recorded.
 * @returns The newly created handoff span.
 */
export declare function handoffSpan(fromAgent?: string | null, toAgent?: string | null, spanId?: string | null, parent?: Trace | Span<any> | null, disabled?: boolean): Span<HandoffSpanData>;
/**
 * 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.
 *
 * @param name - The name of the custom span.
 * @param data - Arbitrary structured data to associate with the span.
 * @param spanId - The ID of the span. Optional. If not provided, we will generate an ID. We
 * recommend using `util.genSpanId()` to generate a span ID, to guarantee that IDs are
 * correctly formatted.
 * @param parent - The parent span or trace. If not provided, we will automatically use the current
 * trace/span as the parent.
 * @param disabled - If True, we will return a Span but the Span will not be recorded.
 * @returns The newly created custom span.
 */
export declare function customSpan(name: string, data?: Record<string, any> | null, spanId?: string | null, parent?: Trace | Span<any> | null, disabled?: boolean): Span<CustomSpanData>;
/**
 * Create 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.
 *
 * @param name - The name of the guardrail.
 * @param triggered - Whether the guardrail was triggered.
 * @param spanId - The ID of the span. Optional. If not provided, we will generate an ID. We
 * recommend using `util.genSpanId()` to generate a span ID, to guarantee that IDs are
 * correctly formatted.
 * @param parent - The parent span or trace. If not provided, we will automatically use the current
 * trace/span as the parent.
 * @param disabled - If True, we will return a Span but the Span will not be recorded.
 * @returns The newly created guardrail span.
 */
export declare function guardrailSpan(name: string, triggered?: boolean, spanId?: string | null, parent?: Trace | Span<any> | null, disabled?: boolean): Span<GuardrailSpanData>;
/**
 * Create 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.
 *
 * @param model - The name of the model used for the speech-to-text.
 * @param input - The audio input of the speech-to-text transcription, as a base64 encoded string of
 * audio bytes.
 * @param inputFormat - The format of the audio input (defaults to "pcm").
 * @param output - The output of the speech-to-text transcription.
 * @param modelConfig - The model configuration (hyperparameters) used.
 * @param spanId - The ID of the span. Optional. If not provided, we will generate an ID. We
 * recommend using `util.genSpanId()` to generate a span ID, to guarantee that IDs are
 * correctly formatted.
 * @param parent - The parent span or trace. If not provided, we will automatically use the current
 * trace/span as the parent.
 * @param disabled - If True, we will return a Span but the Span will not be recorded.
 * @returns The newly created speech-to-text span.
 */
export declare function transcriptionSpan(model?: string | null, input?: string | null, inputFormat?: string | null, output?: string | null, modelConfig?: Record<string, any> | null, spanId?: string | null, parent?: Trace | Span<any> | null, disabled?: boolean): Span<TranscriptionSpanData>;
/**
 * Create 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.
 *
 * @param model - The name of the model used for the text-to-speech.
 * @param input - The text input of the text-to-speech.
 * @param output - The audio output of the text-to-speech as base64 encoded string of PCM audio bytes.
 * @param outputFormat - The format of the audio output (defaults to "pcm").
 * @param modelConfig - The model configuration (hyperparameters) used.
 * @param firstContentAt - The time of the first byte of the audio output.
 * @param spanId - The ID of the span. Optional. If not provided, we will generate an ID. We
 * recommend using `util.genSpanId()` to generate a span ID, to guarantee that IDs are
 * correctly formatted.
 * @param parent - The parent span or trace. If not provided, we will automatically use the current
 * trace/span as the parent.
 * @param disabled - If True, we will return a Span but the Span will not be recorded.
 * @returns The newly created speech span.
 */
export declare function speechSpan(model?: string | null, input?: string | null, output?: string | null, outputFormat?: string | null, modelConfig?: Record<string, any> | null, firstContentAt?: string | null, spanId?: string | null, parent?: Trace | Span<any> | null, disabled?: boolean): Span<SpeechSpanData>;
/**
 * Create 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.
 *
 * @param input - The input text used for the speech request.
 * @param spanId - The ID of the span. Optional. If not provided, we will generate an ID. We
 * recommend using `util.genSpanId()` to generate a span ID, to guarantee that IDs are
 * correctly formatted.
 * @param parent - The parent span or trace. If not provided, we will automatically use the current
 * trace/span as the parent.
 * @param disabled - If True, we will return a Span but the Span will not be recorded.
 * @returns The newly created speech group span.
 */
export declare function speechGroupSpan(input?: string | null, spanId?: string | null, parent?: Trace | Span<any> | null, disabled?: boolean): Span<SpeechGroupSpanData>;
/**
 * Create 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.
 *
 * @param server - The name of the MCP server.
 * @param result - The result of the MCP list tools call.
 * @param spanId - The ID of the span. Optional. If not provided, we will generate an ID. We
 * recommend using `util.genSpanId()` to generate a span ID, to guarantee that IDs are
 * correctly formatted.
 * @param parent - The parent span or trace. If not provided, we will automatically use the current
 * trace/span as the parent.
 * @param disabled - If True, we will return a Span but the Span will not be recorded.
 * @returns The newly created MCP list tools span.
 */
export declare function mcpToolsSpan(server?: string | null, result?: string[] | null, spanId?: string | null, parent?: Trace | Span<any> | null, disabled?: boolean): Span<MCPListToolsSpanData>;