mojentic 1.2.4 → 1.5.0

package/dist/realtime/schemas.d.ts

@@ -0,0 +1,333 @@
+/**
+ * Zod schemas for OpenAI Realtime API events.
+ *
+ * These validate the shape at the gateway boundary. We accept unknown extra
+ * fields (Zod's default) so provider drift doesn't crash parsing — only the
+ * fields the broker actually consumes are validated. Use `rawEvents()` on
+ * the session if you need access to fields outside this schema.
+ *
+ * Schema snapshot: OpenAI Realtime API beta circa 2026-05.
+ */
+import { z } from 'zod';
+export declare const sessionCreatedSchema: z.ZodObject<{
+    type: z.ZodLiteral<"session.created">;
+    session: z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const sessionUpdatedSchema: z.ZodObject<{
+    type: z.ZodLiteral<"session.updated">;
+    session: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const speechStartedSchema: z.ZodObject<{
+    type: z.ZodLiteral<"input_audio_buffer.speech_started">;
+    audio_start_ms: z.ZodOptional<z.ZodNumber>;
+    item_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const speechStoppedSchema: z.ZodObject<{
+    type: z.ZodLiteral<"input_audio_buffer.speech_stopped">;
+    audio_end_ms: z.ZodOptional<z.ZodNumber>;
+    item_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const inputTranscriptionCompletedSchema: z.ZodObject<{
+    type: z.ZodLiteral<"conversation.item.input_audio_transcription.completed">;
+    item_id: z.ZodString;
+    transcript: z.ZodString;
+}, z.core.$strip>;
+export declare const inputTranscriptionDeltaSchema: z.ZodObject<{
+    type: z.ZodLiteral<"conversation.item.input_audio_transcription.delta">;
+    item_id: z.ZodString;
+    delta: z.ZodString;
+}, z.core.$strip>;
+export declare const responseCreatedSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.created">;
+    response: z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const responseDoneSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.done">;
+    response: z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodOptional<z.ZodString>;
+        status_details: z.ZodOptional<z.ZodObject<{
+            type: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            reason: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        }, z.core.$strip>>;
+        usage: z.ZodOptional<z.ZodObject<{
+            total_tokens: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+            input_tokens: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+            output_tokens: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+            input_token_details: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            output_token_details: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        }, z.core.$strip>>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const outputItemAddedSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.output_item.added">;
+    response_id: z.ZodString;
+    output_index: z.ZodOptional<z.ZodNumber>;
+    item: z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        type: z.ZodString;
+        call_id: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const outputItemDoneSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.output_item.done">;
+    response_id: z.ZodString;
+    item: z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        type: z.ZodString;
+        call_id: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        arguments: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export declare const audioDeltaSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.audio.delta">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    delta: z.ZodString;
+}, z.core.$strip>;
+export declare const outputAudioDeltaSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.output_audio.delta">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    delta: z.ZodString;
+}, z.core.$strip>;
+export declare const audioTranscriptDeltaSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.audio_transcript.delta">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    delta: z.ZodString;
+}, z.core.$strip>;
+export declare const outputAudioTranscriptDeltaSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.output_audio_transcript.delta">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    delta: z.ZodString;
+}, z.core.$strip>;
+export declare const audioTranscriptDoneSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.audio_transcript.done">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    transcript: z.ZodString;
+}, z.core.$strip>;
+export declare const outputAudioTranscriptDoneSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.output_audio_transcript.done">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    transcript: z.ZodString;
+}, z.core.$strip>;
+export declare const textDeltaSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.text.delta">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    delta: z.ZodString;
+}, z.core.$strip>;
+export declare const outputTextDeltaSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.output_text.delta">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    delta: z.ZodString;
+}, z.core.$strip>;
+export declare const textDoneSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.text.done">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    text: z.ZodString;
+}, z.core.$strip>;
+export declare const outputTextDoneSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.output_text.done">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    text: z.ZodString;
+}, z.core.$strip>;
+export declare const functionCallArgsDeltaSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.function_call_arguments.delta">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    call_id: z.ZodString;
+    delta: z.ZodString;
+}, z.core.$strip>;
+export declare const functionCallArgsDoneSchema: z.ZodObject<{
+    type: z.ZodLiteral<"response.function_call_arguments.done">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    call_id: z.ZodString;
+    name: z.ZodString;
+    arguments: z.ZodString;
+}, z.core.$strip>;
+export declare const rateLimitsUpdatedSchema: z.ZodObject<{
+    type: z.ZodLiteral<"rate_limits.updated">;
+    rate_limits: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const errorSchema: z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    error: z.ZodObject<{
+        type: z.ZodOptional<z.ZodString>;
+        code: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+/**
+ * Discriminated union of every server event the broker consumes.
+ *
+ * Other server events (the OpenAI API emits ~30 in total) are accepted as
+ * raw `{ type: string }` and surfaced via `rawEvents()` only.
+ */
+export declare const serverEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"session.created">;
+    session: z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$loose>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"session.updated">;
+    session: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"input_audio_buffer.speech_started">;
+    audio_start_ms: z.ZodOptional<z.ZodNumber>;
+    item_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"input_audio_buffer.speech_stopped">;
+    audio_end_ms: z.ZodOptional<z.ZodNumber>;
+    item_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"conversation.item.input_audio_transcription.completed">;
+    item_id: z.ZodString;
+    transcript: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"conversation.item.input_audio_transcription.delta">;
+    item_id: z.ZodString;
+    delta: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.created">;
+    response: z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$loose>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.done">;
+    response: z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodOptional<z.ZodString>;
+        status_details: z.ZodOptional<z.ZodObject<{
+            type: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            reason: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        }, z.core.$strip>>;
+        usage: z.ZodOptional<z.ZodObject<{
+            total_tokens: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+            input_tokens: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+            output_tokens: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+            input_token_details: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            output_token_details: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        }, z.core.$strip>>;
+    }, z.core.$loose>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.output_item.added">;
+    response_id: z.ZodString;
+    output_index: z.ZodOptional<z.ZodNumber>;
+    item: z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        type: z.ZodString;
+        call_id: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.output_item.done">;
+    response_id: z.ZodString;
+    item: z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        type: z.ZodString;
+        call_id: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        arguments: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.audio.delta">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    delta: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.output_audio.delta">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    delta: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.audio_transcript.delta">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    delta: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.output_audio_transcript.delta">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    delta: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.audio_transcript.done">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    transcript: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.output_audio_transcript.done">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    transcript: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.text.delta">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    delta: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.output_text.delta">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    delta: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.text.done">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    text: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.output_text.done">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    text: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.function_call_arguments.delta">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    call_id: z.ZodString;
+    delta: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"response.function_call_arguments.done">;
+    response_id: z.ZodString;
+    item_id: z.ZodOptional<z.ZodString>;
+    call_id: z.ZodString;
+    name: z.ZodString;
+    arguments: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"rate_limits.updated">;
+    rate_limits: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    error: z.ZodObject<{
+        type: z.ZodOptional<z.ZodString>;
+        code: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+    }, z.core.$loose>;
+}, z.core.$strip>], "type">;
+export type ServerEvent = z.infer<typeof serverEventSchema>;
+/** Server event we recognise plus a fallback for unknown event types. */
+export type RawServerEvent = ServerEvent | {
+    type: string;
+    [k: string]: unknown;
+};
+/**
+ * Best-effort parse: returns the validated event when recognised, otherwise
+ * returns the raw payload so callers can still surface it through
+ * `rawEvents()`.
+ */
+export declare function parseServerEvent(raw: unknown): RawServerEvent;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/realtime/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/realtime/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4BxB,eAAO,MAAM,oBAAoB;;;;;iBAG/B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;iBAI9B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;iBAI9B,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;;iBAI5C,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;iBAIxC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;iBAGhC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;iBAU7B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;iBAYhC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAY/B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;iBAK3B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;iBAKjC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;iBAKrC,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;;iBAK3C,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;iBAKpC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;iBAK1C,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;iBAK1B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;iBAKhC,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;iBAKzB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;iBAK/B,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;iBAMtC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;iBAOrC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;iBAStB,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAyB5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,yEAAyE;AACzE,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAElF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAS7D"}

package/dist/realtime/schemas.js

@@ -0,0 +1,243 @@
+"use strict";
+/**
+ * Zod schemas for OpenAI Realtime API events.
+ *
+ * These validate the shape at the gateway boundary. We accept unknown extra
+ * fields (Zod's default) so provider drift doesn't crash parsing — only the
+ * fields the broker actually consumes are validated. Use `rawEvents()` on
+ * the session if you need access to fields outside this schema.
+ *
+ * Schema snapshot: OpenAI Realtime API beta circa 2026-05.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serverEventSchema = exports.errorSchema = exports.rateLimitsUpdatedSchema = exports.functionCallArgsDoneSchema = exports.functionCallArgsDeltaSchema = exports.outputTextDoneSchema = exports.textDoneSchema = exports.outputTextDeltaSchema = exports.textDeltaSchema = exports.outputAudioTranscriptDoneSchema = exports.audioTranscriptDoneSchema = exports.outputAudioTranscriptDeltaSchema = exports.audioTranscriptDeltaSchema = exports.outputAudioDeltaSchema = exports.audioDeltaSchema = exports.outputItemDoneSchema = exports.outputItemAddedSchema = exports.responseDoneSchema = exports.responseCreatedSchema = exports.inputTranscriptionDeltaSchema = exports.inputTranscriptionCompletedSchema = exports.speechStoppedSchema = exports.speechStartedSchema = exports.sessionUpdatedSchema = exports.sessionCreatedSchema = void 0;
+exports.parseServerEvent = parseServerEvent;
+const zod_1 = require("zod");
+// -----------------------------------------------------------------------------
+// Shared sub-shapes
+// -----------------------------------------------------------------------------
+const usageSchema = zod_1.z
+    .object({
+    total_tokens: zod_1.z.number().optional(),
+    input_tokens: zod_1.z.number().optional(),
+    output_tokens: zod_1.z.number().optional(),
+    input_token_details: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+    output_token_details: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+})
+    .partial();
+const responseStatusDetails = zod_1.z
+    .object({
+    type: zod_1.z.string().optional(),
+    reason: zod_1.z.string().optional(),
+})
+    .partial()
+    .optional();
+// -----------------------------------------------------------------------------
+// Server → Client events
+// -----------------------------------------------------------------------------
+exports.sessionCreatedSchema = zod_1.z.object({
+    type: zod_1.z.literal('session.created'),
+    session: zod_1.z.object({ id: zod_1.z.string() }).passthrough(),
+});
+exports.sessionUpdatedSchema = zod_1.z.object({
+    type: zod_1.z.literal('session.updated'),
+    session: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+});
+exports.speechStartedSchema = zod_1.z.object({
+    type: zod_1.z.literal('input_audio_buffer.speech_started'),
+    audio_start_ms: zod_1.z.number().optional(),
+    item_id: zod_1.z.string().optional(),
+});
+exports.speechStoppedSchema = zod_1.z.object({
+    type: zod_1.z.literal('input_audio_buffer.speech_stopped'),
+    audio_end_ms: zod_1.z.number().optional(),
+    item_id: zod_1.z.string().optional(),
+});
+exports.inputTranscriptionCompletedSchema = zod_1.z.object({
+    type: zod_1.z.literal('conversation.item.input_audio_transcription.completed'),
+    item_id: zod_1.z.string(),
+    transcript: zod_1.z.string(),
+});
+exports.inputTranscriptionDeltaSchema = zod_1.z.object({
+    type: zod_1.z.literal('conversation.item.input_audio_transcription.delta'),
+    item_id: zod_1.z.string(),
+    delta: zod_1.z.string(),
+});
+exports.responseCreatedSchema = zod_1.z.object({
+    type: zod_1.z.literal('response.created'),
+    response: zod_1.z.object({ id: zod_1.z.string() }).passthrough(),
+});
+exports.responseDoneSchema = zod_1.z.object({
+    type: zod_1.z.literal('response.done'),
+    response: zod_1.z
+        .object({
+        id: zod_1.z.string(),
+        status: zod_1.z.string().optional(),
+        status_details: responseStatusDetails,
+        usage: usageSchema.optional(),
+    })
+        .passthrough(),
+});
+exports.outputItemAddedSchema = zod_1.z.object({
+    type: zod_1.z.literal('response.output_item.added'),
+    response_id: zod_1.z.string(),
+    output_index: zod_1.z.number().optional(),
+    item: zod_1.z
+        .object({
+        id: zod_1.z.string().optional(),
+        type: zod_1.z.string(),
+        call_id: zod_1.z.string().optional(),
+        name: zod_1.z.string().optional(),
+    })
+        .passthrough(),
+});
+exports.outputItemDoneSchema = zod_1.z.object({
+    type: zod_1.z.literal('response.output_item.done'),
+    response_id: zod_1.z.string(),
+    item: zod_1.z
+        .object({
+        id: zod_1.z.string().optional(),
+        type: zod_1.z.string(),
+        call_id: zod_1.z.string().optional(),
+        name: zod_1.z.string().optional(),
+        arguments: zod_1.z.string().optional(),
+    })
+        .passthrough(),
+});
+exports.audioDeltaSchema = zod_1.z.object({
+    type: zod_1.z.literal('response.audio.delta'),
+    response_id: zod_1.z.string(),
+    item_id: zod_1.z.string().optional(),
+    delta: zod_1.z.string(), // base64 PCM
+});
+exports.outputAudioDeltaSchema = zod_1.z.object({
+    type: zod_1.z.literal('response.output_audio.delta'),
+    response_id: zod_1.z.string(),
+    item_id: zod_1.z.string().optional(),
+    delta: zod_1.z.string(),
+});
+exports.audioTranscriptDeltaSchema = zod_1.z.object({
+    type: zod_1.z.literal('response.audio_transcript.delta'),
+    response_id: zod_1.z.string(),
+    item_id: zod_1.z.string().optional(),
+    delta: zod_1.z.string(),
+});
+exports.outputAudioTranscriptDeltaSchema = zod_1.z.object({
+    type: zod_1.z.literal('response.output_audio_transcript.delta'),
+    response_id: zod_1.z.string(),
+    item_id: zod_1.z.string().optional(),
+    delta: zod_1.z.string(),
+});
+exports.audioTranscriptDoneSchema = zod_1.z.object({
+    type: zod_1.z.literal('response.audio_transcript.done'),
+    response_id: zod_1.z.string(),
+    item_id: zod_1.z.string().optional(),
+    transcript: zod_1.z.string(),
+});
+exports.outputAudioTranscriptDoneSchema = zod_1.z.object({
+    type: zod_1.z.literal('response.output_audio_transcript.done'),
+    response_id: zod_1.z.string(),
+    item_id: zod_1.z.string().optional(),
+    transcript: zod_1.z.string(),
+});
+exports.textDeltaSchema = zod_1.z.object({
+    type: zod_1.z.literal('response.text.delta'),
+    response_id: zod_1.z.string(),
+    item_id: zod_1.z.string().optional(),
+    delta: zod_1.z.string(),
+});
+exports.outputTextDeltaSchema = zod_1.z.object({
+    type: zod_1.z.literal('response.output_text.delta'),
+    response_id: zod_1.z.string(),
+    item_id: zod_1.z.string().optional(),
+    delta: zod_1.z.string(),
+});
+exports.textDoneSchema = zod_1.z.object({
+    type: zod_1.z.literal('response.text.done'),
+    response_id: zod_1.z.string(),
+    item_id: zod_1.z.string().optional(),
+    text: zod_1.z.string(),
+});
+exports.outputTextDoneSchema = zod_1.z.object({
+    type: zod_1.z.literal('response.output_text.done'),
+    response_id: zod_1.z.string(),
+    item_id: zod_1.z.string().optional(),
+    text: zod_1.z.string(),
+});
+exports.functionCallArgsDeltaSchema = zod_1.z.object({
+    type: zod_1.z.literal('response.function_call_arguments.delta'),
+    response_id: zod_1.z.string(),
+    item_id: zod_1.z.string().optional(),
+    call_id: zod_1.z.string(),
+    delta: zod_1.z.string(),
+});
+exports.functionCallArgsDoneSchema = zod_1.z.object({
+    type: zod_1.z.literal('response.function_call_arguments.done'),
+    response_id: zod_1.z.string(),
+    item_id: zod_1.z.string().optional(),
+    call_id: zod_1.z.string(),
+    name: zod_1.z.string(),
+    arguments: zod_1.z.string(),
+});
+exports.rateLimitsUpdatedSchema = zod_1.z.object({
+    type: zod_1.z.literal('rate_limits.updated'),
+    rate_limits: zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.unknown())),
+});
+exports.errorSchema = zod_1.z.object({
+    type: zod_1.z.literal('error'),
+    error: zod_1.z
+        .object({
+        type: zod_1.z.string().optional(),
+        code: zod_1.z.string().optional(),
+        message: zod_1.z.string(),
+    })
+        .passthrough(),
+});
+/**
+ * Discriminated union of every server event the broker consumes.
+ *
+ * Other server events (the OpenAI API emits ~30 in total) are accepted as
+ * raw `{ type: string }` and surfaced via `rawEvents()` only.
+ */
+exports.serverEventSchema = zod_1.z.discriminatedUnion('type', [
+    exports.sessionCreatedSchema,
+    exports.sessionUpdatedSchema,
+    exports.speechStartedSchema,
+    exports.speechStoppedSchema,
+    exports.inputTranscriptionCompletedSchema,
+    exports.inputTranscriptionDeltaSchema,
+    exports.responseCreatedSchema,
+    exports.responseDoneSchema,
+    exports.outputItemAddedSchema,
+    exports.outputItemDoneSchema,
+    exports.audioDeltaSchema,
+    exports.outputAudioDeltaSchema,
+    exports.audioTranscriptDeltaSchema,
+    exports.outputAudioTranscriptDeltaSchema,
+    exports.audioTranscriptDoneSchema,
+    exports.outputAudioTranscriptDoneSchema,
+    exports.textDeltaSchema,
+    exports.outputTextDeltaSchema,
+    exports.textDoneSchema,
+    exports.outputTextDoneSchema,
+    exports.functionCallArgsDeltaSchema,
+    exports.functionCallArgsDoneSchema,
+    exports.rateLimitsUpdatedSchema,
+    exports.errorSchema,
+]);
+/**
+ * Best-effort parse: returns the validated event when recognised, otherwise
+ * returns the raw payload so callers can still surface it through
+ * `rawEvents()`.
+ */
+function parseServerEvent(raw) {
+    const result = exports.serverEventSchema.safeParse(raw);
+    if (result.success) {
+        return result.data;
+    }
+    if (typeof raw === 'object' && raw !== null && 'type' in raw) {
+        return raw;
+    }
+    return { type: 'unknown' };
+}
+//# sourceMappingURL=schemas.js.map

package/dist/realtime/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/realtime/schemas.ts"],"names":[],"mappings":"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"}