@oxy.so/contracts 4.11.0-oxy-one.0 → 4.12.0

package/dist/cjs/inference/realtime.js

@@ -129,13 +129,9 @@ exports.realtimeResponseIdSchema = zod_1.z.string().min(1).max(128);
  * The audio encodings a session carries, in both directions. Named by what they
  * ARE (sample format, rate) because a realtime stream has no container to say so.
  */
-exports.realtimeAudioFormatSchema = zod_1.z.enum([
-    "pcm16_24khz",
-    "g711_ulaw",
-    "g711_alaw",
-]);
+exports.realtimeAudioFormatSchema = zod_1.z.enum(['pcm16_24khz', 'g711_ulaw', 'g711_alaw']);
 /** What a session's responses produce. */
-exports.realtimeOutputModalitySchema = zod_1.z.enum(["text", "audio"]);
+exports.realtimeOutputModalitySchema = zod_1.z.enum(['text', 'audio']);
 const audioFrameSchema = zod_1.z
     .string()
     .min(4)
@@ -155,11 +151,11 @@ const milliseconds = zod_1.z.number().int().nonnegative().safe();
  * off, are the two behaviours a caller most needs to have chosen, and a default
  * would choose them silently — and differently per provider.
  */
-exports.realtimeTurnDetectionSchema = zod_1.z.discriminatedUnion("type", [
-    zod_1.z.object({ type: zod_1.z.literal("none") }).strict(),
+exports.realtimeTurnDetectionSchema = zod_1.z.discriminatedUnion('type', [
+    zod_1.z.object({ type: zod_1.z.literal('none') }).strict(),
     zod_1.z
         .object({
-        type: zod_1.z.literal("server_vad"),
+        type: zod_1.z.literal('server_vad'),
         threshold: zod_1.z.number().min(0).max(1).optional(),
         prefixPaddingMs: zod_1.z.number().int().min(0).max(5000).optional(),
         silenceDurationMs: zod_1.z.number().int().min(0).max(10000).optional(),
@@ -169,8 +165,8 @@ exports.realtimeTurnDetectionSchema = zod_1.z.discriminatedUnion("type", [
         .strict(),
     zod_1.z
         .object({
-        type: zod_1.z.literal("semantic_vad"),
-        eagerness: zod_1.z.enum(["low", "medium", "high", "auto"]),
+        type: zod_1.z.literal('semantic_vad'),
+        eagerness: zod_1.z.enum(['low', 'medium', 'high', 'auto']),
         createResponse: zod_1.z.boolean(),
         interruptResponse: zod_1.z.boolean(),
     })
@@ -245,7 +241,7 @@ exports.realtimeSessionConfigUpdateSchema = zod_1.z
     if (Object.keys(update).length === 0) {
         ctx.addIssue({
             code: zod_1.z.ZodIssueCode.custom,
-            message: "a session update changes at least one field",
+            message: 'a session update changes at least one field',
         });
     }
 });
@@ -281,7 +277,7 @@ exports.realtimeClientMetadataSchema = zod_1.z
 /*  The session request                                                       */
 /* -------------------------------------------------------------------------- */
 const modelLineOf = (reference) => {
-    const at = reference.indexOf("@");
+    const at = reference.indexOf('@');
     return at === -1 ? reference : reference.slice(0, at);
 };
 /**
@@ -306,72 +302,83 @@ exports.realtimeSessionRequestSchema = zod_1.z
     const { config } = request;
     const issue = (path, message) => ctx.addIssue({ code: zod_1.z.ZodIssueCode.custom, path, message });
     if (request.limits.idleTimeoutMs > request.limits.maxDurationMs) {
-        issue(["limits", "idleTimeoutMs"], "an idle timeout cannot outlast the session");
+        issue(['limits', 'idleTimeoutMs'], 'an idle timeout cannot outlast the session');
     }
-    const producesAudio = config.outputModalities?.includes("audio") === true;
+    const producesAudio = config.outputModalities?.includes('audio') === true;
     const hasTools = config.tools !== undefined && config.tools.length > 0;
     switch (request.kind) {
-        case "conversation":
+        case 'conversation':
             if (config.outputModalities === undefined) {
-                issue(["config", "outputModalities"], "a conversation names what its responses produce");
+                issue(['config', 'outputModalities'], 'a conversation names what its responses produce');
             }
-            if (producesAudio && (config.voice === undefined || config.outputAudioFormat === undefined)) {
-                issue(["config"], "spoken responses need a voice and an output audio format");
+            if (producesAudio &&
+                (config.voice === undefined || config.outputAudioFormat === undefined)) {
+                issue(['config'], 'spoken responses need a voice and an output audio format');
             }
             if (config.translation !== undefined) {
-                issue(["config", "translation"], "only a translation session translates");
+                issue(['config', 'translation'], 'only a translation session translates');
             }
             break;
-        case "transcription":
+        case 'transcription':
             if (config.inputAudioTranscription === undefined) {
-                issue(["config", "inputAudioTranscription"], "a transcription session transcribes its input");
+                issue(['config', 'inputAudioTranscription'], 'a transcription session transcribes its input');
             }
-            for (const field of ["outputModalities", "voice", "outputAudioFormat", "translation", "tools", "toolChoice", "maxOutputTokens"]) {
+            for (const field of [
+                'outputModalities',
+                'voice',
+                'outputAudioFormat',
+                'translation',
+                'tools',
+                'toolChoice',
+                'maxOutputTokens',
+            ]) {
                 if (config[field] !== undefined) {
-                    issue(["config", field], "a transcription session never responds");
+                    issue(['config', field], 'a transcription session never responds');
                 }
             }
-            if (config.turnDetection.type !== "none" && (config.turnDetection.createResponse || config.turnDetection.interruptResponse)) {
-                issue(["config", "turnDetection"], "a transcription session has no response to create or interrupt");
+            if (config.turnDetection.type !== 'none' &&
+                (config.turnDetection.createResponse || config.turnDetection.interruptResponse)) {
+                issue(['config', 'turnDetection'], 'a transcription session has no response to create or interrupt');
             }
             break;
-        case "translation":
+        case 'translation':
             if (config.translation === undefined || config.outputAudioFormat === undefined) {
-                issue(["config"], "a translation session names its target language and output audio format");
+                issue(['config'], 'a translation session names its target language and output audio format');
             }
             if (config.tools !== undefined || config.toolChoice !== undefined) {
-                issue(["config", "tools"], "a translation session calls no tools");
+                issue(['config', 'tools'], 'a translation session calls no tools');
             }
             break;
     }
     if (config.toolChoice !== undefined && !hasTools) {
-        issue(["config", "toolChoice"], "a tool choice requires at least one tool definition");
+        issue(['config', 'toolChoice'], 'a tool choice requires at least one tool definition');
     }
     if (config.tools !== undefined) {
         const names = config.tools.map((tool) => tool.name);
         if (new Set(names).size !== names.length) {
-            issue(["config", "tools"], "tool names must be unique within one session");
+            issue(['config', 'tools'], 'tool names must be unique within one session');
         }
     }
-    if (config.outputModalities !== undefined && new Set(config.outputModalities).size !== config.outputModalities.length) {
-        issue(["config", "outputModalities"], "each output modality is named at most once");
+    if (config.outputModalities !== undefined &&
+        new Set(config.outputModalities).size !== config.outputModalities.length) {
+        issue(['config', 'outputModalities'], 'each output modality is named at most once');
     }
     // A session is never substituted: the conversation it holds belongs to one
     // model, so every route serves the line the caller named, and a pinned
     // request is served on exactly the revision it pinned.
     const line = modelLineOf(request.modelReference);
-    const pinned = request.modelReference.includes("@");
+    const pinned = request.modelReference.includes('@');
     for (const [index, route] of request.authorizedRoutes.entries()) {
-        if (route.substitution !== "same_model" || modelLineOf(route.modelReference) !== line) {
-            issue(["authorizedRoutes", index], "every route of a session serves the model it named");
+        if (route.substitution !== 'same_model' || modelLineOf(route.modelReference) !== line) {
+            issue(['authorizedRoutes', index], 'every route of a session serves the model it named');
         }
         if (pinned && route.modelReference !== request.modelReference) {
-            issue(["authorizedRoutes", index, "modelReference"], "a pinned session is served on exactly the revision it pinned");
+            issue(['authorizedRoutes', index, 'modelReference'], 'a pinned session is served on exactly the revision it pinned');
         }
     }
     const deployments = request.authorizedRoutes.map((route) => route.deploymentId);
     if (new Set(deployments).size !== deployments.length) {
-        issue(["authorizedRoutes"], "each deployment appears at most once in the authorized route list");
+        issue(['authorizedRoutes'], 'each deployment appears at most once in the authorized route list');
     }
 });
 /* -------------------------------------------------------------------------- */
@@ -384,26 +391,26 @@ exports.realtimeSessionRequestSchema = zod_1.z
  * never does — spoken output arrives as `output_audio.delta` events, and an
  * item echoing it carries only the format and, once known, the transcript.
  */
-exports.realtimeContentPartSchema = zod_1.z.discriminatedUnion("type", [
-    zod_1.z.object({ type: zod_1.z.literal("input_text"), text: zod_1.z.string().max(1048576) }).strict(),
+exports.realtimeContentPartSchema = zod_1.z.discriminatedUnion('type', [
+    zod_1.z.object({ type: zod_1.z.literal('input_text'), text: zod_1.z.string().max(1048576) }).strict(),
     zod_1.z
         .object({
-        type: zod_1.z.literal("input_audio"),
+        type: zod_1.z.literal('input_audio'),
         format: exports.realtimeAudioFormatSchema,
         data: audioFrameSchema.optional(),
         transcript: zod_1.z.string().optional(),
     })
         .strict(),
-    zod_1.z.object({ type: zod_1.z.literal("output_text"), text: zod_1.z.string() }).strict(),
+    zod_1.z.object({ type: zod_1.z.literal('output_text'), text: zod_1.z.string() }).strict(),
     zod_1.z
         .object({
-        type: zod_1.z.literal("output_audio"),
+        type: zod_1.z.literal('output_audio'),
         format: exports.realtimeAudioFormatSchema,
         transcript: zod_1.z.string().optional(),
     })
         .strict(),
 ]);
-const INPUT_PARTS = new Set(["input_text", "input_audio"]);
+const INPUT_PARTS = new Set(['input_text', 'input_audio']);
 /**
  * One item of the conversation a session holds.
  *
@@ -411,18 +418,18 @@ const INPUT_PARTS = new Set(["input_text", "input_audio"]);
  * is always stated by the server on the events that carry an item.
  */
 exports.realtimeConversationItemSchema = zod_1.z
-    .discriminatedUnion("type", [
+    .discriminatedUnion('type', [
     zod_1.z
         .object({
-        type: zod_1.z.literal("message"),
+        type: zod_1.z.literal('message'),
         itemId: exports.realtimeItemIdSchema.optional(),
-        role: zod_1.z.enum(["system", "user", "assistant"]),
+        role: zod_1.z.enum(['system', 'user', 'assistant']),
         content: zod_1.z.array(exports.realtimeContentPartSchema).min(1).max(64),
     })
         .strict(),
     zod_1.z
         .object({
-        type: zod_1.z.literal("function_call"),
+        type: zod_1.z.literal('function_call'),
         itemId: exports.realtimeItemIdSchema.optional(),
         callId: zod_1.z.string().min(1).max(128),
         name: zod_1.z.string().min(1).max(128),
@@ -431,7 +438,7 @@ exports.realtimeConversationItemSchema = zod_1.z
         .strict(),
     zod_1.z
         .object({
-        type: zod_1.z.literal("function_call_output"),
+        type: zod_1.z.literal('function_call_output'),
         itemId: exports.realtimeItemIdSchema.optional(),
         callId: zod_1.z.string().min(1).max(128),
         output: zod_1.z.string().max(1048576),
@@ -439,24 +446,24 @@ exports.realtimeConversationItemSchema = zod_1.z
         .strict(),
 ])
     .superRefine((item, ctx) => {
-    if (item.type !== "message")
+    if (item.type !== 'message')
         return;
     for (const [index, part] of item.content.entries()) {
         const isInput = INPUT_PARTS.has(part.type);
         // A user or system turn is input; an assistant turn is output. A part on
         // the wrong side is one every provider would silently ignore.
-        if (item.role === "assistant" ? isInput : !isInput) {
+        if (item.role === 'assistant' ? isInput : !isInput) {
             ctx.addIssue({
                 code: zod_1.z.ZodIssueCode.custom,
-                path: ["content", index, "type"],
+                path: ['content', index, 'type'],
                 message: `a ${item.role} message cannot carry ${part.type}`,
             });
         }
-        if (item.role === "system" && part.type !== "input_text") {
+        if (item.role === 'system' && part.type !== 'input_text') {
             ctx.addIssue({
                 code: zod_1.z.ZodIssueCode.custom,
-                path: ["content", index, "type"],
-                message: "a system message is text",
+                path: ['content', index, 'type'],
+                message: 'a system message is text',
             });
         }
     }
@@ -481,19 +488,19 @@ const commandBase = {
 };
 exports.realtimeSessionUpdateCommandSchema = zod_1.z.object({
     ...commandBase,
-    type: zod_1.z.literal("session.update"),
+    type: zod_1.z.literal('session.update'),
     config: exports.realtimeSessionConfigUpdateSchema,
 });
 exports.realtimeItemCreateCommandSchema = zod_1.z.object({
     ...commandBase,
-    type: zod_1.z.literal("conversation.item.create"),
+    type: zod_1.z.literal('conversation.item.create'),
     /** Insert after this item; absent appends. */
     previousItemId: exports.realtimeItemIdSchema.optional(),
     item: exports.realtimeConversationItemSchema,
 });
 exports.realtimeItemDeleteCommandSchema = zod_1.z.object({
     ...commandBase,
-    type: zod_1.z.literal("conversation.item.delete"),
+    type: zod_1.z.literal('conversation.item.delete'),
     itemId: exports.realtimeItemIdSchema,
 });
 /**
@@ -503,33 +510,33 @@ exports.realtimeItemDeleteCommandSchema = zod_1.z.object({
  */
 exports.realtimeItemTruncateCommandSchema = zod_1.z.object({
     ...commandBase,
-    type: zod_1.z.literal("conversation.item.truncate"),
+    type: zod_1.z.literal('conversation.item.truncate'),
     itemId: exports.realtimeItemIdSchema,
     contentIndex: zod_1.z.number().int().nonnegative().safe(),
     audioEndMs: milliseconds,
 });
 exports.realtimeInputAudioAppendCommandSchema = zod_1.z.object({
     ...commandBase,
-    type: zod_1.z.literal("input_audio.append"),
+    type: zod_1.z.literal('input_audio.append'),
     /** One bounded frame in the session's `inputAudioFormat`. */
     data: audioFrameSchema,
 });
 exports.realtimeInputAudioCommitCommandSchema = zod_1.z.object({
     ...commandBase,
-    type: zod_1.z.literal("input_audio.commit"),
+    type: zod_1.z.literal('input_audio.commit'),
 });
 exports.realtimeInputAudioClearCommandSchema = zod_1.z.object({
     ...commandBase,
-    type: zod_1.z.literal("input_audio.clear"),
+    type: zod_1.z.literal('input_audio.clear'),
 });
 exports.realtimeResponseCreateCommandSchema = zod_1.z.object({
     ...commandBase,
-    type: zod_1.z.literal("response.create"),
+    type: zod_1.z.literal('response.create'),
     response: exports.realtimeResponseParametersSchema.optional(),
 });
 exports.realtimeResponseCancelCommandSchema = zod_1.z.object({
     ...commandBase,
-    type: zod_1.z.literal("response.cancel"),
+    type: zod_1.z.literal('response.cancel'),
     /** Absent cancels the response in progress, if any. */
     responseId: exports.realtimeResponseIdSchema.optional(),
 });
@@ -539,15 +546,15 @@ exports.realtimeResponseCancelCommandSchema = zod_1.z.object({
  */
 exports.realtimeSessionResumeCommandSchema = zod_1.z.object({
     ...commandBase,
-    type: zod_1.z.literal("session.resume"),
+    type: zod_1.z.literal('session.resume'),
     afterSequence: zod_1.z.number().int().min(-1).safe(),
 });
 exports.realtimeSessionCloseCommandSchema = zod_1.z.object({
     ...commandBase,
-    type: zod_1.z.literal("session.close"),
+    type: zod_1.z.literal('session.close'),
 });
 /** Every command a client can send. */
-exports.realtimeClientCommandSchema = zod_1.z.discriminatedUnion("type", [
+exports.realtimeClientCommandSchema = zod_1.z.discriminatedUnion('type', [
     exports.realtimeSessionUpdateCommandSchema,
     exports.realtimeItemCreateCommandSchema,
     exports.realtimeItemDeleteCommandSchema,
@@ -580,7 +587,7 @@ const eventBase = {
  */
 exports.realtimeSessionCreatedEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("session.created"),
+    type: zod_1.z.literal('session.created'),
     resolvedModelReference: identifiers_1.modelReferenceSchema,
     servingProvider: identifiers_1.inferenceProviderSlugSchema,
     deploymentId: identifiers_1.deploymentIdSchema,
@@ -593,42 +600,42 @@ exports.realtimeSessionCreatedEventSchema = zod_1.z.object({
 });
 exports.realtimeSessionUpdatedEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("session.updated"),
+    type: zod_1.z.literal('session.updated'),
     config: exports.realtimeSessionConfigSchema,
 });
 exports.realtimeSessionResumedEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("session.resumed"),
+    type: zod_1.z.literal('session.resumed'),
     afterSequence: zod_1.z.number().int().min(-1).safe(),
 });
 /** Sent before a command is applied. `duplicate` means it was not applied again. */
 exports.realtimeCommandAcceptedEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("command.accepted"),
+    type: zod_1.z.literal('command.accepted'),
     commandId: exports.realtimeCommandIdSchema,
     duplicate: zod_1.z.boolean(),
 });
 exports.realtimeItemAddedEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("conversation.item.added"),
+    type: zod_1.z.literal('conversation.item.added'),
     itemId: exports.realtimeItemIdSchema,
     previousItemId: exports.realtimeItemIdSchema.optional(),
     item: exports.realtimeConversationItemSchema,
 });
 exports.realtimeItemDoneEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("conversation.item.done"),
+    type: zod_1.z.literal('conversation.item.done'),
     itemId: exports.realtimeItemIdSchema,
     item: exports.realtimeConversationItemSchema,
 });
 exports.realtimeItemDeletedEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("conversation.item.deleted"),
+    type: zod_1.z.literal('conversation.item.deleted'),
     itemId: exports.realtimeItemIdSchema,
 });
 exports.realtimeItemTruncatedEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("conversation.item.truncated"),
+    type: zod_1.z.literal('conversation.item.truncated'),
     itemId: exports.realtimeItemIdSchema,
     contentIndex: zod_1.z.number().int().nonnegative().safe(),
     audioEndMs: milliseconds,
@@ -640,35 +647,35 @@ exports.realtimeItemTruncatedEventSchema = zod_1.z.object({
  */
 exports.realtimeSpeechStartedEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("input_audio.speech_started"),
+    type: zod_1.z.literal('input_audio.speech_started'),
     itemId: exports.realtimeItemIdSchema,
     audioStartMs: milliseconds,
 });
 exports.realtimeSpeechStoppedEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("input_audio.speech_stopped"),
+    type: zod_1.z.literal('input_audio.speech_stopped'),
     itemId: exports.realtimeItemIdSchema,
     audioEndMs: milliseconds,
 });
 exports.realtimeInputAudioCommittedEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("input_audio.committed"),
+    type: zod_1.z.literal('input_audio.committed'),
     itemId: exports.realtimeItemIdSchema,
     previousItemId: exports.realtimeItemIdSchema.optional(),
 });
 exports.realtimeInputAudioClearedEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("input_audio.cleared"),
+    type: zod_1.z.literal('input_audio.cleared'),
 });
 exports.realtimeResponseCreatedEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("response.created"),
+    type: zod_1.z.literal('response.created'),
     responseId: exports.realtimeResponseIdSchema,
 });
 /** One bounded frame of spoken output, in the session's `outputAudioFormat`. */
 exports.realtimeOutputAudioDeltaEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("output_audio.delta"),
+    type: zod_1.z.literal('output_audio.delta'),
     responseId: exports.realtimeResponseIdSchema,
     itemId: exports.realtimeItemIdSchema,
     contentIndex: zod_1.z.number().int().nonnegative().safe(),
@@ -677,7 +684,7 @@ exports.realtimeOutputAudioDeltaEventSchema = zod_1.z.object({
 });
 exports.realtimeOutputAudioDoneEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("output_audio.done"),
+    type: zod_1.z.literal('output_audio.done'),
     responseId: exports.realtimeResponseIdSchema,
     itemId: exports.realtimeItemIdSchema,
     contentIndex: zod_1.z.number().int().nonnegative().safe(),
@@ -686,10 +693,10 @@ exports.realtimeOutputAudioDoneEventSchema = zod_1.z.object({
  * Which audio a transcript describes: the caller's (`input_audio`) or the
  * model's own speech (`output_audio`). Neither is answer text.
  */
-exports.realtimeTranscriptSourceSchema = zod_1.z.enum(["input_audio", "output_audio"]);
+exports.realtimeTranscriptSourceSchema = zod_1.z.enum(['input_audio', 'output_audio']);
 exports.realtimeTranscriptDeltaEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("transcript.delta"),
+    type: zod_1.z.literal('transcript.delta'),
     source: exports.realtimeTranscriptSourceSchema,
     itemId: exports.realtimeItemIdSchema,
     contentIndex: zod_1.z.number().int().nonnegative().safe(),
@@ -699,7 +706,7 @@ exports.realtimeTranscriptDeltaEventSchema = zod_1.z.object({
 });
 exports.realtimeTranscriptDoneEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("transcript.done"),
+    type: zod_1.z.literal('transcript.done'),
     source: exports.realtimeTranscriptSourceSchema,
     itemId: exports.realtimeItemIdSchema,
     contentIndex: zod_1.z.number().int().nonnegative().safe(),
@@ -709,7 +716,7 @@ exports.realtimeTranscriptDoneEventSchema = zod_1.z.object({
 /** Written output of a response (`outputModalities` including `text`). */
 exports.realtimeTextDeltaEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("text.delta"),
+    type: zod_1.z.literal('text.delta'),
     responseId: exports.realtimeResponseIdSchema,
     itemId: exports.realtimeItemIdSchema,
     contentIndex: zod_1.z.number().int().nonnegative().safe(),
@@ -718,7 +725,7 @@ exports.realtimeTextDeltaEventSchema = zod_1.z.object({
 /** A tool call being streamed; same accumulation rules as the one-shot event. */
 exports.realtimeToolCallEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("tool_call"),
+    type: zod_1.z.literal('tool_call'),
     responseId: exports.realtimeResponseIdSchema,
     itemId: exports.realtimeItemIdSchema,
     toolCallId: zod_1.z.string().min(1).max(128),
@@ -728,10 +735,10 @@ exports.realtimeToolCallEventSchema = zod_1.z.object({
 });
 /** How a response ended. */
 exports.realtimeResponseStatusSchema = zod_1.z.enum([
-    "completed",
-    "cancelled",
-    "incomplete",
-    "failed",
+    'completed',
+    'cancelled',
+    'incomplete',
+    'failed',
 ]);
 /**
  * A response ended, with the units it consumed — measurement evidence, as on
@@ -740,7 +747,7 @@ exports.realtimeResponseStatusSchema = zod_1.z.enum([
  */
 exports.realtimeResponseDoneEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("response.done"),
+    type: zod_1.z.literal('response.done'),
     responseId: exports.realtimeResponseIdSchema,
     status: exports.realtimeResponseStatusSchema,
     finishReason: streamEvents_1.inferenceFinishReasonSchema.optional(),
@@ -754,21 +761,21 @@ exports.realtimeResponseDoneEventSchema = zod_1.z.object({
  */
 exports.realtimeErrorEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("error"),
+    type: zod_1.z.literal('error'),
     fatal: zod_1.z.boolean(),
     error: errors_1.inferenceErrorSchema,
 });
 /** Why a session ended. */
 exports.realtimeSessionCloseReasonSchema = zod_1.z.enum([
-    "client_closed",
-    "max_duration",
-    "idle_timeout",
-    "limit_exceeded",
-    "resume_expired",
-    "upstream_closed",
-    "upstream_error",
-    "no_route_available",
-    "server_shutdown",
+    'client_closed',
+    'max_duration',
+    'idle_timeout',
+    'limit_exceeded',
+    'resume_expired',
+    'upstream_closed',
+    'upstream_error',
+    'no_route_available',
+    'server_shutdown',
 ]);
 /**
  * The terminal event. Carries the session's total units; `deploymentId` is
@@ -776,7 +783,7 @@ exports.realtimeSessionCloseReasonSchema = zod_1.z.enum([
  */
 exports.realtimeSessionClosedEventSchema = zod_1.z.object({
     ...eventBase,
-    type: zod_1.z.literal("session.closed"),
+    type: zod_1.z.literal('session.closed'),
     reason: exports.realtimeSessionCloseReasonSchema,
     deploymentId: identifiers_1.deploymentIdSchema.optional(),
     units: zod_1.z.array(money_1.usageQuantitySchema),
@@ -785,7 +792,7 @@ exports.realtimeSessionClosedEventSchema = zod_1.z.object({
 });
 /** Every event a session can emit. */
 exports.realtimeServerEventSchema = zod_1.z
-    .discriminatedUnion("type", [
+    .discriminatedUnion('type', [
     exports.realtimeSessionCreatedEventSchema,
     exports.realtimeSessionUpdatedEventSchema,
     exports.realtimeSessionResumedEventSchema,
@@ -813,14 +820,14 @@ exports.realtimeServerEventSchema = zod_1.z
     // Each unit is reported once, as a total — the rule every usage record in
     // this contract holds. Checked on the union because a discriminated union's
     // options must stay plain objects.
-    if (event.type !== "response.done" && event.type !== "session.closed")
+    if (event.type !== 'response.done' && event.type !== 'session.closed')
         return;
     const units = event.units.map((quantity) => quantity.unit);
     if (new Set(units).size !== units.length) {
         ctx.addIssue({
             code: zod_1.z.ZodIssueCode.custom,
-            path: ["units"],
-            message: "each unit is reported at most once",
+            path: ['units'],
+            message: 'each unit is reported at most once',
         });
     }
 });

package/dist/cjs/inference/routingPolicy.js

@@ -295,6 +295,16 @@ const authorizedRouteFields = {
     modelReference: identifiers_1.modelReferenceSchema,
     provider: identifiers_1.inferenceProviderSlugSchema,
     regions: zod_1.z.array(identifiers_1.inferenceRegionSchema),
+    /**
+     * The dearest funding tier the data plane may spend on this route. Absent
+     * means no ceiling. Present, the data plane walks only provider keys whose
+     * STATED tier is at or below it — a key whose economics nobody stated is
+     * never admitted — and refuses the route rather than fall through to a
+     * dearer key. It is how Oxy authorizes a route only while credit funds it
+     * (Alia Pro and Ultra spend credits only, ADR 0038). Meaningless with a
+     * customer credential, which the provider bills to the customer.
+     */
+    maxFundingTier: identifiers_1.inferenceFundingTierSchema.optional(),
     /**
      * Exact customer credential binding. Absence means a platform credential;
      * presence names the immutable Kaana generation this route may use.
@@ -349,6 +359,13 @@ exports.authorizedRouteSchema = zod_1.z
         .strict(),
 ])
     .superRefine((route, ctx) => {
+    if (route.maxFundingTier !== undefined && route.customerProviderCredential !== undefined) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['maxFundingTier'],
+            message: 'a funding ceiling bounds platform keys; a customer credential is billed to the customer',
+        });
+    }
     // Same rule as `modelDeploymentSchema`: a route serves specific weights. An
     // unpinned entry would leave the data plane choosing a revision, which is
     // the one substitution the customer never authorized by naming a model.