@kaana.ai/contracts 0.0.0-stage → 4.4.0

package/dist/public/realtime.d.ts

@@ -0,0 +1,2006 @@
+/**
+ * Realtime sessions as a public client speaks them (`GET /v1/realtime`).
+ *
+ * Moved from `@oxy.so/contracts` 4.12.0 (`src/inference/realtime.ts`) by Kaana ADR 0002.
+ */
+import { z } from 'zod';
+import { type ModelAudioCapabilities, type ModelCapabilities, realtimeSessionKindSchema } from './catalogue.js';
+/**
+ * The most base64 characters one audio frame may carry: 49 152 bytes of audio,
+ * about one second of 24 kHz mono PCM16. Bounded so no frame is large enough to
+ * stall a connection, and so a byte cap can be enforced as audio arrives rather
+ * than after it has been buffered.
+ */
+export declare const MAX_REALTIME_AUDIO_FRAME_BASE64_LENGTH = 65536;
+/** The longest a session may be signed for: one hour. */
+export declare const MAX_REALTIME_SESSION_DURATION_MS = 3600000;
+/**
+ * The most audio a session may be signed for in EACH direction: one hour of
+ * 24 kHz mono PCM16 (48 000 bytes per second), the densest format a session
+ * carries.
+ */
+export declare const MAX_REALTIME_SESSION_AUDIO_BYTES = 172800000;
+/** The longest a dropped connection may be resumed after: one minute. */
+export declare const MAX_REALTIME_RESUME_WINDOW_MS = 60000;
+/** A client-chosen command identity, unique within one session. */
+export declare const realtimeCommandIdSchema: z.ZodString;
+/** A conversation item's identity within one session. */
+export declare const realtimeItemIdSchema: z.ZodString;
+/** A response's identity within one session. */
+export declare const realtimeResponseIdSchema: z.ZodString;
+/** What a session's responses produce. */
+export declare const realtimeOutputModalitySchema: z.ZodEnum<{
+    text: "text";
+    audio: "audio";
+}>;
+/**
+ * How the end of a user's turn is detected.
+ *
+ * `none` means the client commits input audio itself. The two VAD forms name
+ * `createResponse` and `interruptResponse` explicitly rather than defaulting
+ * them: whether the model answers on its own, and whether new speech cuts it
+ * off, are the two behaviours a caller most needs to have chosen, and a default
+ * would choose them silently — and differently per provider.
+ */
+export declare const realtimeTurnDetectionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"none">;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"server_vad">;
+    threshold: z.ZodOptional<z.ZodNumber>;
+    prefixPaddingMs: z.ZodOptional<z.ZodNumber>;
+    silenceDurationMs: z.ZodOptional<z.ZodNumber>;
+    createResponse: z.ZodBoolean;
+    interruptResponse: z.ZodBoolean;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"semantic_vad">;
+    eagerness: z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+        auto: "auto";
+    }>;
+    createResponse: z.ZodBoolean;
+    interruptResponse: z.ZodBoolean;
+}, z.core.$strict>], "type">;
+/**
+ * Transcription of the caller's input audio. Presence enables it; the
+ * transcription model is the deployment's own, declared where the deployment
+ * is, never chosen by a string here.
+ *
+ * In a `conversation` it is served only by a model whose catalogue entry says
+ * so (`capabilities.realtime.inputAudioTranscription`, contract set 4.1.0),
+ * and each transcribed turn arrives as `transcript.delta` / `transcript.done`
+ * with `source: 'input_audio'`. What it costs is settled with the session:
+ * where the provider bills the transcription apart from the session model, as
+ * `input_transcription_milliseconds` (see `USAGE_UNITS`); where the session's
+ * own price includes it, as nothing more.
+ *
+ * `language`, when given, is one of the model's published `audio.languages`.
+ */
+export declare const realtimeInputTranscriptionSchema: z.ZodObject<{
+    language: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** The target of a `translation` session. */
+export declare const realtimeTranslationSchema: z.ZodObject<{
+    targetLanguage: z.ZodString;
+}, z.core.$strict>;
+/**
+ * A session's full configuration, as signed at open and as echoed back by
+ * `session.created` and `session.updated`.
+ *
+ * `inputAudioFormat` and `turnDetection` are required because every session
+ * kind consumes audio and has to know when a turn ends; nothing else is,
+ * because each kind needs a different subset — see the refinement on
+ * {@link realtimeSessionRequestSchema}.
+ */
+export declare const realtimeSessionConfigSchema: z.ZodObject<{
+    instructions: z.ZodOptional<z.ZodString>;
+    outputModalities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        text: "text";
+        audio: "audio";
+    }>>>;
+    voice: z.ZodOptional<z.ZodString>;
+    inputAudioFormat: z.ZodEnum<{
+        pcm16_24khz: "pcm16_24khz";
+        g711_ulaw: "g711_ulaw";
+        g711_alaw: "g711_alaw";
+    }>;
+    outputAudioFormat: z.ZodOptional<z.ZodEnum<{
+        pcm16_24khz: "pcm16_24khz";
+        g711_ulaw: "g711_ulaw";
+        g711_alaw: "g711_alaw";
+    }>>;
+    turnDetection: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"none">;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"server_vad">;
+        threshold: z.ZodOptional<z.ZodNumber>;
+        prefixPaddingMs: z.ZodOptional<z.ZodNumber>;
+        silenceDurationMs: z.ZodOptional<z.ZodNumber>;
+        createResponse: z.ZodBoolean;
+        interruptResponse: z.ZodBoolean;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"semantic_vad">;
+        eagerness: z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+            auto: "auto";
+        }>;
+        createResponse: z.ZodBoolean;
+        interruptResponse: z.ZodBoolean;
+    }, z.core.$strict>], "type">;
+    inputAudioTranscription: z.ZodOptional<z.ZodObject<{
+        language: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    translation: z.ZodOptional<z.ZodObject<{
+        targetLanguage: z.ZodString;
+    }, z.core.$strict>>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodLiteral<"function">;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        strict: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    toolChoice: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        auto: "auto";
+        none: "none";
+        required: "required";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"function">;
+        name: z.ZodString;
+    }, z.core.$strict>]>>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/**
+ * What `session.update` may change mid-session.
+ *
+ * The session's kind, its audio formats and its voice are fixed at open —
+ * providers refuse to change a voice once it has spoken, and a format change
+ * mid-stream would make every buffered frame ambiguous — so they are not fields
+ * here, and the strict parse refuses them rather than ignoring them.
+ */
+export declare const realtimeSessionConfigUpdateSchema: z.ZodObject<{
+    instructions: z.ZodOptional<z.ZodString>;
+    outputModalities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        text: "text";
+        audio: "audio";
+    }>>>;
+    turnDetection: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"none">;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"server_vad">;
+        threshold: z.ZodOptional<z.ZodNumber>;
+        prefixPaddingMs: z.ZodOptional<z.ZodNumber>;
+        silenceDurationMs: z.ZodOptional<z.ZodNumber>;
+        createResponse: z.ZodBoolean;
+        interruptResponse: z.ZodBoolean;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"semantic_vad">;
+        eagerness: z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+            auto: "auto";
+        }>;
+        createResponse: z.ZodBoolean;
+        interruptResponse: z.ZodBoolean;
+    }, z.core.$strict>], "type">>;
+    inputAudioTranscription: z.ZodOptional<z.ZodObject<{
+        language: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodLiteral<"function">;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        strict: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    toolChoice: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        auto: "auto";
+        none: "none";
+        required: "required";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"function">;
+        name: z.ZodString;
+    }, z.core.$strict>]>>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/**
+ * The ceilings Oxy signed the session for. The data plane enforces each one and
+ * closes the session (`limit_exceeded`, `max_duration`, `idle_timeout`) rather
+ * than exceeding it: these bound what the session can cost, which is what Oxy's
+ * spend reservation was sized against.
+ */
+export declare const realtimeSessionLimitsSchema: z.ZodObject<{
+    maxDurationMs: z.ZodNumber;
+    idleTimeoutMs: z.ZodNumber;
+    maxInputAudioBytes: z.ZodNumber;
+    maxOutputAudioBytes: z.ZodNumber;
+    maxResponses: z.ZodNumber;
+}, z.core.$strict>;
+/**
+ * One part of a conversation message.
+ *
+ * `input_audio` carries its audio inline (one bounded frame); `output_audio`
+ * never does — spoken output arrives as `output_audio.delta` events, and an
+ * item echoing it carries only the format and, once known, the transcript.
+ */
+export declare const realtimeContentPartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"input_text">;
+    text: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"input_audio">;
+    format: z.ZodEnum<{
+        pcm16_24khz: "pcm16_24khz";
+        g711_ulaw: "g711_ulaw";
+        g711_alaw: "g711_alaw";
+    }>;
+    data: z.ZodOptional<z.ZodString>;
+    transcript: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"output_text">;
+    text: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"output_audio">;
+    format: z.ZodEnum<{
+        pcm16_24khz: "pcm16_24khz";
+        g711_ulaw: "g711_ulaw";
+        g711_alaw: "g711_alaw";
+    }>;
+    transcript: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "type">;
+/**
+ * One item of the conversation a session holds.
+ *
+ * `itemId` is optional on an item a client CREATES (the server assigns one) and
+ * is always stated by the server on the events that carry an item.
+ */
+export declare const realtimeConversationItemSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"message">;
+    itemId: z.ZodOptional<z.ZodString>;
+    role: z.ZodEnum<{
+        user: "user";
+        system: "system";
+        assistant: "assistant";
+    }>;
+    content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"input_text">;
+        text: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"input_audio">;
+        format: z.ZodEnum<{
+            pcm16_24khz: "pcm16_24khz";
+            g711_ulaw: "g711_ulaw";
+            g711_alaw: "g711_alaw";
+        }>;
+        data: z.ZodOptional<z.ZodString>;
+        transcript: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"output_text">;
+        text: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"output_audio">;
+        format: z.ZodEnum<{
+            pcm16_24khz: "pcm16_24khz";
+            g711_ulaw: "g711_ulaw";
+            g711_alaw: "g711_alaw";
+        }>;
+        transcript: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "type">>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"function_call">;
+    itemId: z.ZodOptional<z.ZodString>;
+    callId: z.ZodString;
+    name: z.ZodString;
+    arguments: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"function_call_output">;
+    itemId: z.ZodOptional<z.ZodString>;
+    callId: z.ZodString;
+    output: z.ZodString;
+}, z.core.$strict>], "type">;
+/** Per-response overrides for `response.create`. Absent fields keep the session's. */
+export declare const realtimeResponseParametersSchema: z.ZodObject<{
+    instructions: z.ZodOptional<z.ZodString>;
+    outputModalities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        text: "text";
+        audio: "audio";
+    }>>>;
+    maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+    toolChoice: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        auto: "auto";
+        none: "none";
+        required: "required";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"function">;
+        name: z.ZodString;
+    }, z.core.$strict>]>>;
+}, z.core.$strict>;
+export declare const realtimeSessionUpdateCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"session.update">;
+    config: z.ZodObject<{
+        instructions: z.ZodOptional<z.ZodString>;
+        outputModalities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            text: "text";
+            audio: "audio";
+        }>>>;
+        turnDetection: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"server_vad">;
+            threshold: z.ZodOptional<z.ZodNumber>;
+            prefixPaddingMs: z.ZodOptional<z.ZodNumber>;
+            silenceDurationMs: z.ZodOptional<z.ZodNumber>;
+            createResponse: z.ZodBoolean;
+            interruptResponse: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"semantic_vad">;
+            eagerness: z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                auto: "auto";
+            }>;
+            createResponse: z.ZodBoolean;
+            interruptResponse: z.ZodBoolean;
+        }, z.core.$strict>], "type">>;
+        inputAudioTranscription: z.ZodOptional<z.ZodObject<{
+            language: z.ZodOptional<z.ZodString>;
+            prompt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodLiteral<"function">;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            strict: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        toolChoice: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            auto: "auto";
+            none: "none";
+            required: "required";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"function">;
+            name: z.ZodString;
+        }, z.core.$strict>]>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>;
+export declare const realtimeItemCreateCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"conversation.item.create">;
+    previousItemId: z.ZodOptional<z.ZodString>;
+    item: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"message">;
+        itemId: z.ZodOptional<z.ZodString>;
+        role: z.ZodEnum<{
+            user: "user";
+            system: "system";
+            assistant: "assistant";
+        }>;
+        content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"input_text">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"input_audio">;
+            format: z.ZodEnum<{
+                pcm16_24khz: "pcm16_24khz";
+                g711_ulaw: "g711_ulaw";
+                g711_alaw: "g711_alaw";
+            }>;
+            data: z.ZodOptional<z.ZodString>;
+            transcript: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"output_text">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"output_audio">;
+            format: z.ZodEnum<{
+                pcm16_24khz: "pcm16_24khz";
+                g711_ulaw: "g711_ulaw";
+                g711_alaw: "g711_alaw";
+            }>;
+            transcript: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"function_call">;
+        itemId: z.ZodOptional<z.ZodString>;
+        callId: z.ZodString;
+        name: z.ZodString;
+        arguments: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"function_call_output">;
+        itemId: z.ZodOptional<z.ZodString>;
+        callId: z.ZodString;
+        output: z.ZodString;
+    }, z.core.$strict>], "type">;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>;
+export declare const realtimeItemDeleteCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"conversation.item.delete">;
+    itemId: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Cut an assistant's audio item at the point the listener actually heard, after
+ * an interruption, so the conversation the model remembers is the one that was
+ * spoken rather than the one that was generated.
+ */
+export declare const realtimeItemTruncateCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"conversation.item.truncate">;
+    itemId: z.ZodString;
+    contentIndex: z.ZodNumber;
+    audioEndMs: z.ZodNumber;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>;
+export declare const realtimeInputAudioAppendCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"input_audio.append">;
+    data: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>;
+export declare const realtimeInputAudioCommitCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"input_audio.commit">;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>;
+export declare const realtimeInputAudioClearCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"input_audio.clear">;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>;
+export declare const realtimeResponseCreateCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.create">;
+    response: z.ZodOptional<z.ZodObject<{
+        instructions: z.ZodOptional<z.ZodString>;
+        outputModalities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            text: "text";
+            audio: "audio";
+        }>>>;
+        maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+        toolChoice: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            auto: "auto";
+            none: "none";
+            required: "required";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"function">;
+            name: z.ZodString;
+        }, z.core.$strict>]>>;
+    }, z.core.$strict>>;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>;
+export declare const realtimeResponseCancelCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.cancel">;
+    responseId: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>;
+/**
+ * The first frame of a reconnection: replay every event after `afterSequence`.
+ * `-1` asks for every buffered event from the start.
+ */
+export declare const realtimeSessionResumeCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"session.resume">;
+    afterSequence: z.ZodNumber;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>;
+export declare const realtimeSessionCloseCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"session.close">;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>;
+/** Every command a client can send. */
+export declare const realtimeClientCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"session.update">;
+    config: z.ZodObject<{
+        instructions: z.ZodOptional<z.ZodString>;
+        outputModalities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            text: "text";
+            audio: "audio";
+        }>>>;
+        turnDetection: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"server_vad">;
+            threshold: z.ZodOptional<z.ZodNumber>;
+            prefixPaddingMs: z.ZodOptional<z.ZodNumber>;
+            silenceDurationMs: z.ZodOptional<z.ZodNumber>;
+            createResponse: z.ZodBoolean;
+            interruptResponse: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"semantic_vad">;
+            eagerness: z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                auto: "auto";
+            }>;
+            createResponse: z.ZodBoolean;
+            interruptResponse: z.ZodBoolean;
+        }, z.core.$strict>], "type">>;
+        inputAudioTranscription: z.ZodOptional<z.ZodObject<{
+            language: z.ZodOptional<z.ZodString>;
+            prompt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodLiteral<"function">;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            strict: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        toolChoice: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            auto: "auto";
+            none: "none";
+            required: "required";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"function">;
+            name: z.ZodString;
+        }, z.core.$strict>]>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"conversation.item.create">;
+    previousItemId: z.ZodOptional<z.ZodString>;
+    item: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"message">;
+        itemId: z.ZodOptional<z.ZodString>;
+        role: z.ZodEnum<{
+            user: "user";
+            system: "system";
+            assistant: "assistant";
+        }>;
+        content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"input_text">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"input_audio">;
+            format: z.ZodEnum<{
+                pcm16_24khz: "pcm16_24khz";
+                g711_ulaw: "g711_ulaw";
+                g711_alaw: "g711_alaw";
+            }>;
+            data: z.ZodOptional<z.ZodString>;
+            transcript: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"output_text">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"output_audio">;
+            format: z.ZodEnum<{
+                pcm16_24khz: "pcm16_24khz";
+                g711_ulaw: "g711_ulaw";
+                g711_alaw: "g711_alaw";
+            }>;
+            transcript: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"function_call">;
+        itemId: z.ZodOptional<z.ZodString>;
+        callId: z.ZodString;
+        name: z.ZodString;
+        arguments: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"function_call_output">;
+        itemId: z.ZodOptional<z.ZodString>;
+        callId: z.ZodString;
+        output: z.ZodString;
+    }, z.core.$strict>], "type">;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"conversation.item.delete">;
+    itemId: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"conversation.item.truncate">;
+    itemId: z.ZodString;
+    contentIndex: z.ZodNumber;
+    audioEndMs: z.ZodNumber;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"input_audio.append">;
+    data: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"input_audio.commit">;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"input_audio.clear">;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.create">;
+    response: z.ZodOptional<z.ZodObject<{
+        instructions: z.ZodOptional<z.ZodString>;
+        outputModalities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            text: "text";
+            audio: "audio";
+        }>>>;
+        maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+        toolChoice: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            auto: "auto";
+            none: "none";
+            required: "required";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"function">;
+            name: z.ZodString;
+        }, z.core.$strict>]>>;
+    }, z.core.$strict>>;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.cancel">;
+    responseId: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"session.resume">;
+    afterSequence: z.ZodNumber;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"session.close">;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    commandId: z.ZodString;
+}, z.core.$strip>], "type">;
+export declare const realtimeSessionUpdatedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"session.updated">;
+    config: z.ZodObject<{
+        instructions: z.ZodOptional<z.ZodString>;
+        outputModalities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            text: "text";
+            audio: "audio";
+        }>>>;
+        voice: z.ZodOptional<z.ZodString>;
+        inputAudioFormat: z.ZodEnum<{
+            pcm16_24khz: "pcm16_24khz";
+            g711_ulaw: "g711_ulaw";
+            g711_alaw: "g711_alaw";
+        }>;
+        outputAudioFormat: z.ZodOptional<z.ZodEnum<{
+            pcm16_24khz: "pcm16_24khz";
+            g711_ulaw: "g711_ulaw";
+            g711_alaw: "g711_alaw";
+        }>>;
+        turnDetection: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"server_vad">;
+            threshold: z.ZodOptional<z.ZodNumber>;
+            prefixPaddingMs: z.ZodOptional<z.ZodNumber>;
+            silenceDurationMs: z.ZodOptional<z.ZodNumber>;
+            createResponse: z.ZodBoolean;
+            interruptResponse: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"semantic_vad">;
+            eagerness: z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                auto: "auto";
+            }>;
+            createResponse: z.ZodBoolean;
+            interruptResponse: z.ZodBoolean;
+        }, z.core.$strict>], "type">;
+        inputAudioTranscription: z.ZodOptional<z.ZodObject<{
+            language: z.ZodOptional<z.ZodString>;
+            prompt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        translation: z.ZodOptional<z.ZodObject<{
+            targetLanguage: z.ZodString;
+        }, z.core.$strict>>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodLiteral<"function">;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            strict: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        toolChoice: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            auto: "auto";
+            none: "none";
+            required: "required";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"function">;
+            name: z.ZodString;
+        }, z.core.$strict>]>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const realtimeSessionResumedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"session.resumed">;
+    afterSequence: z.ZodNumber;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Sent before a command is applied. `duplicate` means it was not applied again. */
+export declare const realtimeCommandAcceptedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"command.accepted">;
+    commandId: z.ZodString;
+    duplicate: z.ZodBoolean;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+}, z.core.$strip>;
+export declare const realtimeItemAddedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"conversation.item.added">;
+    itemId: z.ZodString;
+    previousItemId: z.ZodOptional<z.ZodString>;
+    item: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"message">;
+        itemId: z.ZodOptional<z.ZodString>;
+        role: z.ZodEnum<{
+            user: "user";
+            system: "system";
+            assistant: "assistant";
+        }>;
+        content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"input_text">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"input_audio">;
+            format: z.ZodEnum<{
+                pcm16_24khz: "pcm16_24khz";
+                g711_ulaw: "g711_ulaw";
+                g711_alaw: "g711_alaw";
+            }>;
+            data: z.ZodOptional<z.ZodString>;
+            transcript: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"output_text">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"output_audio">;
+            format: z.ZodEnum<{
+                pcm16_24khz: "pcm16_24khz";
+                g711_ulaw: "g711_ulaw";
+                g711_alaw: "g711_alaw";
+            }>;
+            transcript: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"function_call">;
+        itemId: z.ZodOptional<z.ZodString>;
+        callId: z.ZodString;
+        name: z.ZodString;
+        arguments: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"function_call_output">;
+        itemId: z.ZodOptional<z.ZodString>;
+        callId: z.ZodString;
+        output: z.ZodString;
+    }, z.core.$strict>], "type">;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const realtimeItemDoneEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"conversation.item.done">;
+    itemId: z.ZodString;
+    item: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"message">;
+        itemId: z.ZodOptional<z.ZodString>;
+        role: z.ZodEnum<{
+            user: "user";
+            system: "system";
+            assistant: "assistant";
+        }>;
+        content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"input_text">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"input_audio">;
+            format: z.ZodEnum<{
+                pcm16_24khz: "pcm16_24khz";
+                g711_ulaw: "g711_ulaw";
+                g711_alaw: "g711_alaw";
+            }>;
+            data: z.ZodOptional<z.ZodString>;
+            transcript: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"output_text">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"output_audio">;
+            format: z.ZodEnum<{
+                pcm16_24khz: "pcm16_24khz";
+                g711_ulaw: "g711_ulaw";
+                g711_alaw: "g711_alaw";
+            }>;
+            transcript: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"function_call">;
+        itemId: z.ZodOptional<z.ZodString>;
+        callId: z.ZodString;
+        name: z.ZodString;
+        arguments: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"function_call_output">;
+        itemId: z.ZodOptional<z.ZodString>;
+        callId: z.ZodString;
+        output: z.ZodString;
+    }, z.core.$strict>], "type">;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const realtimeItemDeletedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"conversation.item.deleted">;
+    itemId: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const realtimeItemTruncatedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"conversation.item.truncated">;
+    itemId: z.ZodString;
+    contentIndex: z.ZodNumber;
+    audioEndMs: z.ZodNumber;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Voice activity began. With `interruptResponse`, a response in progress is
+ * cancelled by it: this event is the interruption, and the client should stop
+ * playback and truncate what was not heard.
+ */
+export declare const realtimeSpeechStartedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"input_audio.speech_started">;
+    itemId: z.ZodString;
+    audioStartMs: z.ZodNumber;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const realtimeSpeechStoppedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"input_audio.speech_stopped">;
+    itemId: z.ZodString;
+    audioEndMs: z.ZodNumber;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const realtimeInputAudioCommittedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"input_audio.committed">;
+    itemId: z.ZodString;
+    previousItemId: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const realtimeInputAudioClearedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"input_audio.cleared">;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const realtimeResponseCreatedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.created">;
+    responseId: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** One bounded frame of spoken output, in the session's `outputAudioFormat`. */
+export declare const realtimeOutputAudioDeltaEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"output_audio.delta">;
+    responseId: z.ZodString;
+    itemId: z.ZodString;
+    contentIndex: z.ZodNumber;
+    format: z.ZodEnum<{
+        pcm16_24khz: "pcm16_24khz";
+        g711_ulaw: "g711_ulaw";
+        g711_alaw: "g711_alaw";
+    }>;
+    data: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const realtimeOutputAudioDoneEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"output_audio.done">;
+    responseId: z.ZodString;
+    itemId: z.ZodString;
+    contentIndex: z.ZodNumber;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Which audio a transcript describes: the caller's (`input_audio`) or the
+ * model's own speech (`output_audio`). Neither is answer text.
+ */
+export declare const realtimeTranscriptSourceSchema: z.ZodEnum<{
+    input_audio: "input_audio";
+    output_audio: "output_audio";
+}>;
+export declare const realtimeTranscriptDeltaEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"transcript.delta">;
+    source: z.ZodEnum<{
+        input_audio: "input_audio";
+        output_audio: "output_audio";
+    }>;
+    itemId: z.ZodString;
+    contentIndex: z.ZodNumber;
+    responseId: z.ZodOptional<z.ZodString>;
+    text: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const realtimeTranscriptDoneEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"transcript.done">;
+    source: z.ZodEnum<{
+        input_audio: "input_audio";
+        output_audio: "output_audio";
+    }>;
+    itemId: z.ZodString;
+    contentIndex: z.ZodNumber;
+    responseId: z.ZodOptional<z.ZodString>;
+    transcript: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Written output of a response (`outputModalities` including `text`). */
+export declare const realtimeTextDeltaEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"text.delta">;
+    responseId: z.ZodString;
+    itemId: z.ZodString;
+    contentIndex: z.ZodNumber;
+    text: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** A tool call being streamed; same accumulation rules as the one-shot event. */
+export declare const realtimeToolCallEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"tool_call">;
+    responseId: z.ZodString;
+    itemId: z.ZodString;
+    toolCallId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    argumentsDelta: z.ZodOptional<z.ZodString>;
+    complete: z.ZodBoolean;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** How a response ended. */
+export declare const realtimeResponseStatusSchema: z.ZodEnum<{
+    cancelled: "cancelled";
+    completed: "completed";
+    failed: "failed";
+    incomplete: "incomplete";
+}>;
+/** Why a session ended. */
+export declare const realtimeSessionCloseReasonSchema: z.ZodEnum<{
+    no_route_available: "no_route_available";
+    client_closed: "client_closed";
+    max_duration: "max_duration";
+    idle_timeout: "idle_timeout";
+    limit_exceeded: "limit_exceeded";
+    resume_expired: "resume_expired";
+    upstream_closed: "upstream_closed";
+    upstream_error: "upstream_error";
+    server_shutdown: "server_shutdown";
+}>;
+/** One configuration a session kind cannot honour, with its path inside `config`. */
+export interface RealtimeConfigIssue {
+    readonly path: (string | number)[];
+    readonly message: string;
+}
+/**
+ * What a session kind requires of its configuration. Each kind needs a
+ * different subset of the config, so these rules are cross-field and live
+ * here once: the public `session.open` frame and the signed session request
+ * apply the same ones, and a session a client may open is one Kaana may run.
+ */
+export declare function realtimeConfigIssues(kind: z.infer<typeof realtimeSessionKindSchema>, config: z.infer<typeof realtimeSessionConfigSchema>): RealtimeConfigIssue[];
+/**
+ * The most text `conversation.item.create` commands a session may be opened
+ * for: the bound a duration-priced route's hold is sized from.
+ */
+export declare const MAX_REALTIME_TEXT_ITEMS = 10000;
+/**
+ * The customer's partial limits request: every signed limit, each filled from
+ * Kaana's defaults when omitted, plus `maxTextItems`, the most billable text
+ * items the session may send (absent, it defaults to `maxResponses`).
+ */
+export declare const realtimeOpenLimitsSchema: z.ZodObject<{
+    maxDurationMs: z.ZodOptional<z.ZodNumber>;
+    idleTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    maxInputAudioBytes: z.ZodOptional<z.ZodNumber>;
+    maxOutputAudioBytes: z.ZodOptional<z.ZodNumber>;
+    maxResponses: z.ZodOptional<z.ZodNumber>;
+    maxTextItems: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/**
+ * The first frame a client sends on `GET /v1/realtime?model=…` to OPEN a
+ * session (a reconnection instead sends `session.resume`). One grant covers the
+ * whole session and it is settled exactly once, when the session closes.
+ *
+ * Moved from the Oxy edge (`realtimeOpenFrameSchema`) by Kaana ADR 0002.
+ */
+export declare const realtimeSessionOpenSchema: z.ZodObject<{
+    type: z.ZodLiteral<"session.open">;
+    kind: z.ZodEnum<{
+        conversation: "conversation";
+        transcription: "transcription";
+        translation: "translation";
+    }>;
+    transport: z.ZodOptional<z.ZodEnum<{
+        websocket: "websocket";
+    }>>;
+    config: z.ZodObject<{
+        instructions: z.ZodOptional<z.ZodString>;
+        outputModalities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            text: "text";
+            audio: "audio";
+        }>>>;
+        voice: z.ZodOptional<z.ZodString>;
+        inputAudioFormat: z.ZodEnum<{
+            pcm16_24khz: "pcm16_24khz";
+            g711_ulaw: "g711_ulaw";
+            g711_alaw: "g711_alaw";
+        }>;
+        outputAudioFormat: z.ZodOptional<z.ZodEnum<{
+            pcm16_24khz: "pcm16_24khz";
+            g711_ulaw: "g711_ulaw";
+            g711_alaw: "g711_alaw";
+        }>>;
+        turnDetection: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"server_vad">;
+            threshold: z.ZodOptional<z.ZodNumber>;
+            prefixPaddingMs: z.ZodOptional<z.ZodNumber>;
+            silenceDurationMs: z.ZodOptional<z.ZodNumber>;
+            createResponse: z.ZodBoolean;
+            interruptResponse: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"semantic_vad">;
+            eagerness: z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                auto: "auto";
+            }>;
+            createResponse: z.ZodBoolean;
+            interruptResponse: z.ZodBoolean;
+        }, z.core.$strict>], "type">;
+        inputAudioTranscription: z.ZodOptional<z.ZodObject<{
+            language: z.ZodOptional<z.ZodString>;
+            prompt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        translation: z.ZodOptional<z.ZodObject<{
+            targetLanguage: z.ZodString;
+        }, z.core.$strict>>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodLiteral<"function">;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            strict: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        toolChoice: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            auto: "auto";
+            none: "none";
+            required: "required";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"function">;
+            name: z.ZodString;
+        }, z.core.$strict>]>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+    limits: z.ZodOptional<z.ZodObject<{
+        maxDurationMs: z.ZodOptional<z.ZodNumber>;
+        idleTimeoutMs: z.ZodOptional<z.ZodNumber>;
+        maxInputAudioBytes: z.ZodOptional<z.ZodNumber>;
+        maxOutputAudioBytes: z.ZodOptional<z.ZodNumber>;
+        maxResponses: z.ZodOptional<z.ZodNumber>;
+        maxTextItems: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    clientSessionId: z.ZodOptional<z.ZodString>;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
+/** Why a session open cannot be served by a model, before anything is held. */
+export interface RealtimeOpenIssue {
+    /** The open frame's field at fault, as `invalid_request.param` names it. */
+    readonly param: string;
+    readonly message: string;
+}
+/**
+ * Check a `session.open` against the model's published catalogue entry — its
+ * `capabilities.realtime` and its `audio` — the realtime counterpart of
+ * {@link checkSpeechRequest} (Kaana ADR 0002 decision 9; Alia ADR 0017 §5).
+ * Kaana refuses an open with `invalid_request` and the first issue's `param`
+ * BEFORE asking Oxy for a grant; a client may run the same check to choose a
+ * model.
+ *
+ * A field the catalogue leaves undeclared (an older producer) is not checked:
+ * absent is unknown, never "everything" and never "nothing". The one
+ * exception is input transcription in a conversation, which a model must
+ * declare to be asked for, because asking for it starts a charge.
+ *
+ * Returns every issue, in field order; an empty list means the model accepts
+ * the open.
+ */
+export declare function checkRealtimeSessionOpen(open: z.infer<typeof realtimeSessionOpenSchema>, model: {
+    readonly capabilities: ModelCapabilities;
+    readonly audio?: ModelAudioCapabilities;
+}): RealtimeOpenIssue[];
+/**
+ * The session opened: the revision-pinned model, fixed for the rest of the
+ * session, and the effective configuration and limits. The signed lane's
+ * `realtimeSessionCreatedEventSchema` also names the provider and deployment;
+ * a public client is never told either.
+ */
+export declare const realtimePublicSessionCreatedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"session.created">;
+    model: z.ZodString;
+    kind: z.ZodEnum<{
+        conversation: "conversation";
+        transcription: "transcription";
+        translation: "translation";
+    }>;
+    config: z.ZodObject<{
+        instructions: z.ZodOptional<z.ZodString>;
+        outputModalities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            text: "text";
+            audio: "audio";
+        }>>>;
+        voice: z.ZodOptional<z.ZodString>;
+        inputAudioFormat: z.ZodEnum<{
+            pcm16_24khz: "pcm16_24khz";
+            g711_ulaw: "g711_ulaw";
+            g711_alaw: "g711_alaw";
+        }>;
+        outputAudioFormat: z.ZodOptional<z.ZodEnum<{
+            pcm16_24khz: "pcm16_24khz";
+            g711_ulaw: "g711_ulaw";
+            g711_alaw: "g711_alaw";
+        }>>;
+        turnDetection: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"server_vad">;
+            threshold: z.ZodOptional<z.ZodNumber>;
+            prefixPaddingMs: z.ZodOptional<z.ZodNumber>;
+            silenceDurationMs: z.ZodOptional<z.ZodNumber>;
+            createResponse: z.ZodBoolean;
+            interruptResponse: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"semantic_vad">;
+            eagerness: z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                auto: "auto";
+            }>;
+            createResponse: z.ZodBoolean;
+            interruptResponse: z.ZodBoolean;
+        }, z.core.$strict>], "type">;
+        inputAudioTranscription: z.ZodOptional<z.ZodObject<{
+            language: z.ZodOptional<z.ZodString>;
+            prompt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        translation: z.ZodOptional<z.ZodObject<{
+            targetLanguage: z.ZodString;
+        }, z.core.$strict>>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodLiteral<"function">;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            strict: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        toolChoice: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            auto: "auto";
+            none: "none";
+            required: "required";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"function">;
+            name: z.ZodString;
+        }, z.core.$strict>]>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+    limits: z.ZodObject<{
+        maxDurationMs: z.ZodNumber;
+        idleTimeoutMs: z.ZodNumber;
+        maxInputAudioBytes: z.ZodNumber;
+        maxOutputAudioBytes: z.ZodNumber;
+        maxResponses: z.ZodNumber;
+    }, z.core.$strict>;
+    resumeWindowMs: z.ZodNumber;
+    startedAt: z.ZodString;
+    expiresAt: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** A response ended, with the units it consumed. */
+export declare const realtimePublicResponseDoneEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.done">;
+    responseId: z.ZodString;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        completed: "completed";
+        failed: "failed";
+        incomplete: "incomplete";
+    }>;
+    finishReason: z.ZodOptional<z.ZodEnum<{
+        content_filter: "content_filter";
+        cancelled: "cancelled";
+        refusal: "refusal";
+        stop: "stop";
+        length: "length";
+        tool_calls: "tool_calls";
+    }>>;
+    units: z.ZodArray<z.ZodObject<{
+        unit: z.ZodEnum<{
+            input_tokens: "input_tokens";
+            cached_input_tokens: "cached_input_tokens";
+            output_tokens: "output_tokens";
+            reasoning_tokens: "reasoning_tokens";
+            requests: "requests";
+            images: "images";
+            audio_input_milliseconds: "audio_input_milliseconds";
+            audio_output_milliseconds: "audio_output_milliseconds";
+            video_milliseconds: "video_milliseconds";
+            characters: "characters";
+            embeddings: "embeddings";
+            audio_input_tokens: "audio_input_tokens";
+            cached_audio_input_tokens: "cached_audio_input_tokens";
+            audio_output_tokens: "audio_output_tokens";
+            session_milliseconds: "session_milliseconds";
+            input_transcription_milliseconds: "input_transcription_milliseconds";
+        }>;
+        quantity: z.ZodNumber;
+    }, z.core.$strict>>;
+    usageSource: z.ZodEnum<{
+        provider_reported: "provider_reported";
+        oxy_measured: "oxy_measured";
+        estimated: "estimated";
+    }>;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * An error in the public vocabulary. `fatal: false` refuses one command and
+ * the session continues; `fatal: true` is followed by `session.closed`.
+ */
+export declare const realtimePublicErrorEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    fatal: z.ZodBoolean;
+    error: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        code: z.ZodEnum<{
+            invalid_request: "invalid_request";
+            authentication_failed: "authentication_failed";
+            permission_denied: "permission_denied";
+            insufficient_scope: "insufficient_scope";
+            model_not_found: "model_not_found";
+            unsupported_modality: "unsupported_modality";
+            context_length_exceeded: "context_length_exceeded";
+            request_too_large: "request_too_large";
+            output_limit_exceeded: "output_limit_exceeded";
+            idempotency_conflict: "idempotency_conflict";
+            insufficient_balance: "insufficient_balance";
+            spending_limit_exceeded: "spending_limit_exceeded";
+            quota_exceeded: "quota_exceeded";
+            byok_credential_invalid: "byok_credential_invalid";
+            policy_violation: "policy_violation";
+            commercial_permission_denied: "commercial_permission_denied";
+            no_route_available: "no_route_available";
+            upstream_content_filtered: "upstream_content_filtered";
+            cancelled: "cancelled";
+            rate_limited: "rate_limited";
+            provider_error: "provider_error";
+            provider_timeout: "provider_timeout";
+            provider_overloaded: "provider_overloaded";
+            service_unavailable: "service_unavailable";
+            internal_error: "internal_error";
+        }>;
+        message: z.ZodString;
+        retryable: z.ZodBoolean;
+        requestId: z.ZodString;
+        retryAfterMs: z.ZodOptional<z.ZodNumber>;
+        param: z.ZodOptional<z.ZodString>;
+        upstreamCategory: z.ZodOptional<z.ZodEnum<{
+            rate_limit: "rate_limit";
+            quota: "quota";
+            timeout: "timeout";
+            overloaded: "overloaded";
+            server_error: "server_error";
+            content_filter: "content_filter";
+            invalid_request: "invalid_request";
+            authentication: "authentication";
+            unknown: "unknown";
+        }>>;
+    }, z.core.$strict>;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** The terminal event, with the session's total units. */
+export declare const realtimePublicSessionClosedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"session.closed">;
+    reason: z.ZodEnum<{
+        no_route_available: "no_route_available";
+        client_closed: "client_closed";
+        max_duration: "max_duration";
+        idle_timeout: "idle_timeout";
+        limit_exceeded: "limit_exceeded";
+        resume_expired: "resume_expired";
+        upstream_closed: "upstream_closed";
+        upstream_error: "upstream_error";
+        server_shutdown: "server_shutdown";
+    }>;
+    units: z.ZodArray<z.ZodObject<{
+        unit: z.ZodEnum<{
+            input_tokens: "input_tokens";
+            cached_input_tokens: "cached_input_tokens";
+            output_tokens: "output_tokens";
+            reasoning_tokens: "reasoning_tokens";
+            requests: "requests";
+            images: "images";
+            audio_input_milliseconds: "audio_input_milliseconds";
+            audio_output_milliseconds: "audio_output_milliseconds";
+            video_milliseconds: "video_milliseconds";
+            characters: "characters";
+            embeddings: "embeddings";
+            audio_input_tokens: "audio_input_tokens";
+            cached_audio_input_tokens: "cached_audio_input_tokens";
+            audio_output_tokens: "audio_output_tokens";
+            session_milliseconds: "session_milliseconds";
+            input_transcription_milliseconds: "input_transcription_milliseconds";
+        }>;
+        quantity: z.ZodNumber;
+    }, z.core.$strict>>;
+    usageSource: z.ZodEnum<{
+        provider_reported: "provider_reported";
+        oxy_measured: "oxy_measured";
+        estimated: "estimated";
+    }>;
+    closedAt: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Every event a public session can emit. */
+export declare const realtimePublicServerEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"session.created">;
+    model: z.ZodString;
+    kind: z.ZodEnum<{
+        conversation: "conversation";
+        transcription: "transcription";
+        translation: "translation";
+    }>;
+    config: z.ZodObject<{
+        instructions: z.ZodOptional<z.ZodString>;
+        outputModalities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            text: "text";
+            audio: "audio";
+        }>>>;
+        voice: z.ZodOptional<z.ZodString>;
+        inputAudioFormat: z.ZodEnum<{
+            pcm16_24khz: "pcm16_24khz";
+            g711_ulaw: "g711_ulaw";
+            g711_alaw: "g711_alaw";
+        }>;
+        outputAudioFormat: z.ZodOptional<z.ZodEnum<{
+            pcm16_24khz: "pcm16_24khz";
+            g711_ulaw: "g711_ulaw";
+            g711_alaw: "g711_alaw";
+        }>>;
+        turnDetection: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"server_vad">;
+            threshold: z.ZodOptional<z.ZodNumber>;
+            prefixPaddingMs: z.ZodOptional<z.ZodNumber>;
+            silenceDurationMs: z.ZodOptional<z.ZodNumber>;
+            createResponse: z.ZodBoolean;
+            interruptResponse: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"semantic_vad">;
+            eagerness: z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                auto: "auto";
+            }>;
+            createResponse: z.ZodBoolean;
+            interruptResponse: z.ZodBoolean;
+        }, z.core.$strict>], "type">;
+        inputAudioTranscription: z.ZodOptional<z.ZodObject<{
+            language: z.ZodOptional<z.ZodString>;
+            prompt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        translation: z.ZodOptional<z.ZodObject<{
+            targetLanguage: z.ZodString;
+        }, z.core.$strict>>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodLiteral<"function">;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            strict: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        toolChoice: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            auto: "auto";
+            none: "none";
+            required: "required";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"function">;
+            name: z.ZodString;
+        }, z.core.$strict>]>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+    limits: z.ZodObject<{
+        maxDurationMs: z.ZodNumber;
+        idleTimeoutMs: z.ZodNumber;
+        maxInputAudioBytes: z.ZodNumber;
+        maxOutputAudioBytes: z.ZodNumber;
+        maxResponses: z.ZodNumber;
+    }, z.core.$strict>;
+    resumeWindowMs: z.ZodNumber;
+    startedAt: z.ZodString;
+    expiresAt: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"session.updated">;
+    config: z.ZodObject<{
+        instructions: z.ZodOptional<z.ZodString>;
+        outputModalities: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            text: "text";
+            audio: "audio";
+        }>>>;
+        voice: z.ZodOptional<z.ZodString>;
+        inputAudioFormat: z.ZodEnum<{
+            pcm16_24khz: "pcm16_24khz";
+            g711_ulaw: "g711_ulaw";
+            g711_alaw: "g711_alaw";
+        }>;
+        outputAudioFormat: z.ZodOptional<z.ZodEnum<{
+            pcm16_24khz: "pcm16_24khz";
+            g711_ulaw: "g711_ulaw";
+            g711_alaw: "g711_alaw";
+        }>>;
+        turnDetection: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"none">;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"server_vad">;
+            threshold: z.ZodOptional<z.ZodNumber>;
+            prefixPaddingMs: z.ZodOptional<z.ZodNumber>;
+            silenceDurationMs: z.ZodOptional<z.ZodNumber>;
+            createResponse: z.ZodBoolean;
+            interruptResponse: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"semantic_vad">;
+            eagerness: z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                auto: "auto";
+            }>;
+            createResponse: z.ZodBoolean;
+            interruptResponse: z.ZodBoolean;
+        }, z.core.$strict>], "type">;
+        inputAudioTranscription: z.ZodOptional<z.ZodObject<{
+            language: z.ZodOptional<z.ZodString>;
+            prompt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        translation: z.ZodOptional<z.ZodObject<{
+            targetLanguage: z.ZodString;
+        }, z.core.$strict>>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodLiteral<"function">;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            strict: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        toolChoice: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+            auto: "auto";
+            none: "none";
+            required: "required";
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"function">;
+            name: z.ZodString;
+        }, z.core.$strict>]>>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"session.resumed">;
+    afterSequence: z.ZodNumber;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"command.accepted">;
+    commandId: z.ZodString;
+    duplicate: z.ZodBoolean;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"conversation.item.added">;
+    itemId: z.ZodString;
+    previousItemId: z.ZodOptional<z.ZodString>;
+    item: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"message">;
+        itemId: z.ZodOptional<z.ZodString>;
+        role: z.ZodEnum<{
+            user: "user";
+            system: "system";
+            assistant: "assistant";
+        }>;
+        content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"input_text">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"input_audio">;
+            format: z.ZodEnum<{
+                pcm16_24khz: "pcm16_24khz";
+                g711_ulaw: "g711_ulaw";
+                g711_alaw: "g711_alaw";
+            }>;
+            data: z.ZodOptional<z.ZodString>;
+            transcript: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"output_text">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"output_audio">;
+            format: z.ZodEnum<{
+                pcm16_24khz: "pcm16_24khz";
+                g711_ulaw: "g711_ulaw";
+                g711_alaw: "g711_alaw";
+            }>;
+            transcript: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"function_call">;
+        itemId: z.ZodOptional<z.ZodString>;
+        callId: z.ZodString;
+        name: z.ZodString;
+        arguments: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"function_call_output">;
+        itemId: z.ZodOptional<z.ZodString>;
+        callId: z.ZodString;
+        output: z.ZodString;
+    }, z.core.$strict>], "type">;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"conversation.item.done">;
+    itemId: z.ZodString;
+    item: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"message">;
+        itemId: z.ZodOptional<z.ZodString>;
+        role: z.ZodEnum<{
+            user: "user";
+            system: "system";
+            assistant: "assistant";
+        }>;
+        content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"input_text">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"input_audio">;
+            format: z.ZodEnum<{
+                pcm16_24khz: "pcm16_24khz";
+                g711_ulaw: "g711_ulaw";
+                g711_alaw: "g711_alaw";
+            }>;
+            data: z.ZodOptional<z.ZodString>;
+            transcript: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"output_text">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"output_audio">;
+            format: z.ZodEnum<{
+                pcm16_24khz: "pcm16_24khz";
+                g711_ulaw: "g711_ulaw";
+                g711_alaw: "g711_alaw";
+            }>;
+            transcript: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"function_call">;
+        itemId: z.ZodOptional<z.ZodString>;
+        callId: z.ZodString;
+        name: z.ZodString;
+        arguments: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"function_call_output">;
+        itemId: z.ZodOptional<z.ZodString>;
+        callId: z.ZodString;
+        output: z.ZodString;
+    }, z.core.$strict>], "type">;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"conversation.item.deleted">;
+    itemId: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"conversation.item.truncated">;
+    itemId: z.ZodString;
+    contentIndex: z.ZodNumber;
+    audioEndMs: z.ZodNumber;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"input_audio.speech_started">;
+    itemId: z.ZodString;
+    audioStartMs: z.ZodNumber;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"input_audio.speech_stopped">;
+    itemId: z.ZodString;
+    audioEndMs: z.ZodNumber;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"input_audio.committed">;
+    itemId: z.ZodString;
+    previousItemId: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"input_audio.cleared">;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.created">;
+    responseId: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"output_audio.delta">;
+    responseId: z.ZodString;
+    itemId: z.ZodString;
+    contentIndex: z.ZodNumber;
+    format: z.ZodEnum<{
+        pcm16_24khz: "pcm16_24khz";
+        g711_ulaw: "g711_ulaw";
+        g711_alaw: "g711_alaw";
+    }>;
+    data: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"output_audio.done">;
+    responseId: z.ZodString;
+    itemId: z.ZodString;
+    contentIndex: z.ZodNumber;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"transcript.delta">;
+    source: z.ZodEnum<{
+        input_audio: "input_audio";
+        output_audio: "output_audio";
+    }>;
+    itemId: z.ZodString;
+    contentIndex: z.ZodNumber;
+    responseId: z.ZodOptional<z.ZodString>;
+    text: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"transcript.done">;
+    source: z.ZodEnum<{
+        input_audio: "input_audio";
+        output_audio: "output_audio";
+    }>;
+    itemId: z.ZodString;
+    contentIndex: z.ZodNumber;
+    responseId: z.ZodOptional<z.ZodString>;
+    transcript: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"text.delta">;
+    responseId: z.ZodString;
+    itemId: z.ZodString;
+    contentIndex: z.ZodNumber;
+    text: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_call">;
+    responseId: z.ZodString;
+    itemId: z.ZodString;
+    toolCallId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    argumentsDelta: z.ZodOptional<z.ZodString>;
+    complete: z.ZodBoolean;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.done">;
+    responseId: z.ZodString;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        completed: "completed";
+        failed: "failed";
+        incomplete: "incomplete";
+    }>;
+    finishReason: z.ZodOptional<z.ZodEnum<{
+        content_filter: "content_filter";
+        cancelled: "cancelled";
+        refusal: "refusal";
+        stop: "stop";
+        length: "length";
+        tool_calls: "tool_calls";
+    }>>;
+    units: z.ZodArray<z.ZodObject<{
+        unit: z.ZodEnum<{
+            input_tokens: "input_tokens";
+            cached_input_tokens: "cached_input_tokens";
+            output_tokens: "output_tokens";
+            reasoning_tokens: "reasoning_tokens";
+            requests: "requests";
+            images: "images";
+            audio_input_milliseconds: "audio_input_milliseconds";
+            audio_output_milliseconds: "audio_output_milliseconds";
+            video_milliseconds: "video_milliseconds";
+            characters: "characters";
+            embeddings: "embeddings";
+            audio_input_tokens: "audio_input_tokens";
+            cached_audio_input_tokens: "cached_audio_input_tokens";
+            audio_output_tokens: "audio_output_tokens";
+            session_milliseconds: "session_milliseconds";
+            input_transcription_milliseconds: "input_transcription_milliseconds";
+        }>;
+        quantity: z.ZodNumber;
+    }, z.core.$strict>>;
+    usageSource: z.ZodEnum<{
+        provider_reported: "provider_reported";
+        oxy_measured: "oxy_measured";
+        estimated: "estimated";
+    }>;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    fatal: z.ZodBoolean;
+    error: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        code: z.ZodEnum<{
+            invalid_request: "invalid_request";
+            authentication_failed: "authentication_failed";
+            permission_denied: "permission_denied";
+            insufficient_scope: "insufficient_scope";
+            model_not_found: "model_not_found";
+            unsupported_modality: "unsupported_modality";
+            context_length_exceeded: "context_length_exceeded";
+            request_too_large: "request_too_large";
+            output_limit_exceeded: "output_limit_exceeded";
+            idempotency_conflict: "idempotency_conflict";
+            insufficient_balance: "insufficient_balance";
+            spending_limit_exceeded: "spending_limit_exceeded";
+            quota_exceeded: "quota_exceeded";
+            byok_credential_invalid: "byok_credential_invalid";
+            policy_violation: "policy_violation";
+            commercial_permission_denied: "commercial_permission_denied";
+            no_route_available: "no_route_available";
+            upstream_content_filtered: "upstream_content_filtered";
+            cancelled: "cancelled";
+            rate_limited: "rate_limited";
+            provider_error: "provider_error";
+            provider_timeout: "provider_timeout";
+            provider_overloaded: "provider_overloaded";
+            service_unavailable: "service_unavailable";
+            internal_error: "internal_error";
+        }>;
+        message: z.ZodString;
+        retryable: z.ZodBoolean;
+        requestId: z.ZodString;
+        retryAfterMs: z.ZodOptional<z.ZodNumber>;
+        param: z.ZodOptional<z.ZodString>;
+        upstreamCategory: z.ZodOptional<z.ZodEnum<{
+            rate_limit: "rate_limit";
+            quota: "quota";
+            timeout: "timeout";
+            overloaded: "overloaded";
+            server_error: "server_error";
+            content_filter: "content_filter";
+            invalid_request: "invalid_request";
+            authentication: "authentication";
+            unknown: "unknown";
+        }>>;
+    }, z.core.$strict>;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"session.closed">;
+    reason: z.ZodEnum<{
+        no_route_available: "no_route_available";
+        client_closed: "client_closed";
+        max_duration: "max_duration";
+        idle_timeout: "idle_timeout";
+        limit_exceeded: "limit_exceeded";
+        resume_expired: "resume_expired";
+        upstream_closed: "upstream_closed";
+        upstream_error: "upstream_error";
+        server_shutdown: "server_shutdown";
+    }>;
+    units: z.ZodArray<z.ZodObject<{
+        unit: z.ZodEnum<{
+            input_tokens: "input_tokens";
+            cached_input_tokens: "cached_input_tokens";
+            output_tokens: "output_tokens";
+            reasoning_tokens: "reasoning_tokens";
+            requests: "requests";
+            images: "images";
+            audio_input_milliseconds: "audio_input_milliseconds";
+            audio_output_milliseconds: "audio_output_milliseconds";
+            video_milliseconds: "video_milliseconds";
+            characters: "characters";
+            embeddings: "embeddings";
+            audio_input_tokens: "audio_input_tokens";
+            cached_audio_input_tokens: "cached_audio_input_tokens";
+            audio_output_tokens: "audio_output_tokens";
+            session_milliseconds: "session_milliseconds";
+            input_transcription_milliseconds: "input_transcription_milliseconds";
+        }>;
+        quantity: z.ZodNumber;
+    }, z.core.$strict>>;
+    usageSource: z.ZodEnum<{
+        provider_reported: "provider_reported";
+        oxy_measured: "oxy_measured";
+        estimated: "estimated";
+    }>;
+    closedAt: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export type RealtimeOutputModality = z.infer<typeof realtimeOutputModalitySchema>;
+export type RealtimeTurnDetection = z.infer<typeof realtimeTurnDetectionSchema>;
+export type RealtimeInputTranscription = z.infer<typeof realtimeInputTranscriptionSchema>;
+export type RealtimeTranslation = z.infer<typeof realtimeTranslationSchema>;
+export type RealtimeSessionConfig = z.infer<typeof realtimeSessionConfigSchema>;
+export type RealtimeSessionConfigUpdate = z.infer<typeof realtimeSessionConfigUpdateSchema>;
+export type RealtimeSessionLimits = z.infer<typeof realtimeSessionLimitsSchema>;
+export type RealtimeContentPart = z.infer<typeof realtimeContentPartSchema>;
+export type RealtimeConversationItem = z.infer<typeof realtimeConversationItemSchema>;
+export type RealtimeResponseParameters = z.infer<typeof realtimeResponseParametersSchema>;
+export type RealtimeClientCommand = z.infer<typeof realtimeClientCommandSchema>;
+export type RealtimeTranscriptSource = z.infer<typeof realtimeTranscriptSourceSchema>;
+export type RealtimeResponseStatus = z.infer<typeof realtimeResponseStatusSchema>;
+export type RealtimeSessionCloseReason = z.infer<typeof realtimeSessionCloseReasonSchema>;
+export type RealtimeOpenLimits = z.infer<typeof realtimeOpenLimitsSchema>;
+export type RealtimeSessionOpen = z.infer<typeof realtimeSessionOpenSchema>;
+/** What a public client sends after `session.open`: the commands. */
+export type RealtimeClientEvent = RealtimeClientCommand;
+export type RealtimeServerEvent = z.infer<typeof realtimePublicServerEventSchema>;