/** Reusable function-tool contracts and execution registry. */
export type JsonSchema = Record<string, unknown>;
export interface RealtimeToolDefinition {
    type: "function";
    name: string;
    description?: string;
    parameters: JsonSchema;
}
/** A remote MCP server or OpenAI-managed connector executed by Realtime. */
export interface RealtimeMcpTool {
    type: "mcp";
    server_label: string;
    server_url?: string;
    connector_id?: string;
    authorization?: string;
    headers?: Record<string, string>;
    allowed_tools?: readonly string[];
    require_approval?: "always" | "never" | Record<string, unknown>;
    server_description?: string;
}
export type RealtimeSessionTool = RealtimeToolDefinition | RealtimeMcpTool;
export declare function defineMcpTool(tool: RealtimeMcpTool): RealtimeMcpTool;
export interface ToolContext {
    callId?: string;
    signal?: AbortSignal;
    metadata?: Record<string, unknown>;
}
export type ToolHandler<TArgs = unknown, TResult = unknown> = (args: TArgs, context: ToolContext) => TResult | Promise<TResult>;
export interface RealtimeTool<TArgs = unknown, TResult = unknown> extends RealtimeToolDefinition {
    execute: ToolHandler<TArgs, TResult>;
}
export interface ToolCall {
    name: string;
    callId: string;
    arguments: string | Record<string, unknown>;
}
type AnyRealtimeTool = RealtimeTool<any, any>;
export declare class ToolRegistry {
    private readonly tools;
    constructor(tools?: readonly AnyRealtimeTool[]);
    register<TArgs, TResult>(tool: RealtimeTool<TArgs, TResult>): this;
    has(name: string): boolean;
    definitions(): RealtimeToolDefinition[];
    execute(call: ToolCall, context?: Omit<ToolContext, "callId">): Promise<unknown>;
}
export declare function serializeToolOutput(output: unknown): string;
export {};
//# sourceMappingURL=tools.d.ts.map