@kaana.ai/contracts 0.0.0-stage → 4.4.0

package/dist/internal/realtime.d.ts

@@ -0,0 +1,1005 @@
+/**
+ * The signed realtime session request and the server events that name the
+ * serving provider and deployment.
+ *
+ * Moved from `@oxy.so/contracts` 4.12.0 (`src/inference/realtime.ts`) by Kaana ADR 0002.
+ */
+import { z } from 'zod';
+/**
+ * What the edge records about the session CALL. Strict for the reason
+ * `clientRequestMetadataSchema` is: this object is where an IP would be added.
+ */
+export declare const realtimeClientMetadataSchema: z.ZodObject<{
+    endpoint: z.ZodString;
+    clientSessionId: z.ZodOptional<z.ZodString>;
+    receivedAt: z.ZodString;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
+/**
+ * The signed request that opens a session: the first frame of its connection.
+ */
+export declare const realtimeSessionRequestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    attribution: z.ZodObject<{
+        principal: z.ZodObject<{
+            billing: z.ZodObject<{
+                accountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
+            }, z.core.$strict>;
+            applicationId: z.ZodString;
+            credentialId: z.ZodString;
+            environment: z.ZodEnum<{
+                development: "development";
+                staging: "staging";
+                production: "production";
+            }>;
+            inferenceScopes: z.ZodArray<z.ZodEnum<{
+                "inference:invoke": "inference:invoke";
+                "inference:models:read": "inference:models:read";
+                "inference:usage:read": "inference:usage:read";
+                "inference:routing:read": "inference:routing:read";
+                "inference:routing:write": "inference:routing:write";
+                "inference:providers:read": "inference:providers:read";
+                "inference:providers:write": "inference:providers:write";
+            }>>;
+        }, z.core.$strip>;
+        userId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "DelegatedUserId", "out">>;
+        requestId: z.ZodString;
+        generationId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    modelReference: z.ZodString;
+    kind: z.ZodEnum<{
+        conversation: "conversation";
+        transcription: "transcription";
+        translation: "translation";
+    }>;
+    transport: 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.ZodObject<{
+        maxDurationMs: z.ZodNumber;
+        idleTimeoutMs: z.ZodNumber;
+        maxInputAudioBytes: z.ZodNumber;
+        maxOutputAudioBytes: z.ZodNumber;
+        maxResponses: z.ZodNumber;
+    }, z.core.$strict>;
+    client: z.ZodObject<{
+        endpoint: z.ZodString;
+        clientSessionId: z.ZodOptional<z.ZodString>;
+        receivedAt: z.ZodString;
+        labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>;
+    routingPolicy: z.ZodObject<{
+        routingPolicyId: z.ZodString;
+        policyVersion: z.ZodNumber;
+    }, z.core.$strict>;
+    authorizedRoutes: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        deploymentId: z.ZodString;
+        modelReference: z.ZodString;
+        provider: z.ZodString;
+        regions: z.ZodArray<z.ZodString>;
+        maxFundingTier: z.ZodOptional<z.ZodEnum<{
+            free: "free";
+            credit: "credit";
+            paid: "paid";
+        }>>;
+        customerProviderCredential: z.ZodOptional<z.ZodObject<{
+            credentialHandle: z.ZodString;
+            credentialRevision: z.ZodNumber;
+            ownerAccountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
+            connectionId: z.ZodString;
+            environment: z.ZodEnum<{
+                development: "development";
+                staging: "staging";
+                production: "production";
+            }>;
+        }, z.core.$strict>>;
+        substitution: z.ZodLiteral<"same_model">;
+    }, z.core.$strict>, z.ZodObject<{
+        authorizedByPolicy: z.ZodLiteral<true>;
+        deploymentId: z.ZodString;
+        modelReference: z.ZodString;
+        provider: z.ZodString;
+        regions: z.ZodArray<z.ZodString>;
+        maxFundingTier: z.ZodOptional<z.ZodEnum<{
+            free: "free";
+            credit: "credit";
+            paid: "paid";
+        }>>;
+        customerProviderCredential: z.ZodOptional<z.ZodObject<{
+            credentialHandle: z.ZodString;
+            credentialRevision: z.ZodNumber;
+            ownerAccountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
+            connectionId: z.ZodString;
+            environment: z.ZodEnum<{
+                development: "development";
+                staging: "staging";
+                production: "production";
+            }>;
+        }, z.core.$strict>>;
+        substitution: z.ZodLiteral<"cross_model">;
+    }, z.core.$strict>], "substitution">>;
+}, z.core.$strip>;
+/**
+ * The session opened. Names the revision-pinned model, the serving provider and
+ * the exact deployment — fixed for the rest of the session — and the effective
+ * configuration and limits. `deploymentId` is for settlement: like the usage
+ * event's, it is not rendered to the customer.
+ */
+export declare const realtimeSessionCreatedEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"session.created">;
+    resolvedModelReference: z.ZodString;
+    servingProvider: z.ZodString;
+    deploymentId: 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 — measurement evidence, as on
+ * the one-shot usage event. A cancelled or failed response still consumed what
+ * it consumed, so its units are reported too.
+ */
+export declare const realtimeResponseDoneEventSchema: 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";
+    }>>;
+    deploymentId: z.ZodString;
+    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. `fatal: false` refuses one command and the session continues;
+ * `fatal: true` is followed by `session.closed` and nothing else.
+ */
+export declare const realtimeErrorEventSchema: 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";
+            deployment_unavailable: "deployment_unavailable";
+            provider_credential_invalid: "provider_credential_invalid";
+            provider_billing_refused: "provider_billing_refused";
+        }>;
+        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";
+        }>>;
+        providerError: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodString;
+            status: z.ZodOptional<z.ZodNumber>;
+            code: z.ZodOptional<z.ZodString>;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strip>;
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    commandId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * The terminal event. Carries the session's total units; `deploymentId` is
+ * absent only when no route ever opened, in which case nothing was consumed.
+ */
+export declare const realtimeSessionClosedEventSchema: 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";
+    }>;
+    deploymentId: z.ZodOptional<z.ZodString>;
+    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 session can emit. */
+export declare const realtimeServerEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"session.created">;
+    resolvedModelReference: z.ZodString;
+    servingProvider: z.ZodString;
+    deploymentId: 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";
+    }>>;
+    deploymentId: z.ZodString;
+    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";
+            deployment_unavailable: "deployment_unavailable";
+            provider_credential_invalid: "provider_credential_invalid";
+            provider_billing_refused: "provider_billing_refused";
+        }>;
+        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";
+        }>>;
+        providerError: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodString;
+            status: z.ZodOptional<z.ZodNumber>;
+            code: z.ZodOptional<z.ZodString>;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strip>;
+    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";
+    }>;
+    deploymentId: z.ZodOptional<z.ZodString>;
+    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 RealtimeClientMetadata = z.infer<typeof realtimeClientMetadataSchema>;
+export type RealtimeSessionRequest = z.infer<typeof realtimeSessionRequestSchema>;
+export type RealtimeServerEvent = z.infer<typeof realtimeServerEventSchema>;