@oxy.so/contracts 1.1.1 → 1.3.0

package/dist/types/inference/request.d.ts

@@ -490,7 +490,7 @@ export declare const inferenceMessageSchema: z.ZodEffects<z.ZodObject<{
         type: "refusal";
         text: string;
     })[];
-    role: "tool" | "system" | "user" | "developer" | "assistant";
+    role: "system" | "tool" | "user" | "developer" | "assistant";
     name?: string | undefined;
     toolCallId?: string | undefined;
     toolCalls?: {
@@ -538,7 +538,7 @@ export declare const inferenceMessageSchema: z.ZodEffects<z.ZodObject<{
         type: "refusal";
         text: string;
     })[];
-    role: "tool" | "system" | "user" | "developer" | "assistant";
+    role: "system" | "tool" | "user" | "developer" | "assistant";
     name?: string | undefined;
     toolCallId?: string | undefined;
     toolCalls?: {
@@ -586,7 +586,7 @@ export declare const inferenceMessageSchema: z.ZodEffects<z.ZodObject<{
         type: "refusal";
         text: string;
     })[];
-    role: "tool" | "system" | "user" | "developer" | "assistant";
+    role: "system" | "tool" | "user" | "developer" | "assistant";
     name?: string | undefined;
     toolCallId?: string | undefined;
     toolCalls?: {
@@ -634,7 +634,7 @@ export declare const inferenceMessageSchema: z.ZodEffects<z.ZodObject<{
         type: "refusal";
         text: string;
     })[];
-    role: "tool" | "system" | "user" | "developer" | "assistant";
+    role: "system" | "tool" | "user" | "developer" | "assistant";
     name?: string | undefined;
     toolCallId?: string | undefined;
     toolCalls?: {
@@ -871,7 +871,7 @@ export declare const inferenceInputSchema: z.ZodDiscriminatedUnion<"format", [z.
             type: "refusal";
             text: string;
         })[];
-        role: "tool" | "system" | "user" | "developer" | "assistant";
+        role: "system" | "tool" | "user" | "developer" | "assistant";
         name?: string | undefined;
         toolCallId?: string | undefined;
         toolCalls?: {
@@ -919,7 +919,7 @@ export declare const inferenceInputSchema: z.ZodDiscriminatedUnion<"format", [z.
             type: "refusal";
             text: string;
         })[];
-        role: "tool" | "system" | "user" | "developer" | "assistant";
+        role: "system" | "tool" | "user" | "developer" | "assistant";
         name?: string | undefined;
         toolCallId?: string | undefined;
         toolCalls?: {
@@ -967,7 +967,7 @@ export declare const inferenceInputSchema: z.ZodDiscriminatedUnion<"format", [z.
             type: "refusal";
             text: string;
         })[];
-        role: "tool" | "system" | "user" | "developer" | "assistant";
+        role: "system" | "tool" | "user" | "developer" | "assistant";
         name?: string | undefined;
         toolCallId?: string | undefined;
         toolCalls?: {
@@ -1015,7 +1015,7 @@ export declare const inferenceInputSchema: z.ZodDiscriminatedUnion<"format", [z.
             type: "refusal";
             text: string;
         })[];
-        role: "tool" | "system" | "user" | "developer" | "assistant";
+        role: "system" | "tool" | "user" | "developer" | "assistant";
         name?: string | undefined;
         toolCallId?: string | undefined;
         toolCalls?: {
@@ -1066,7 +1066,7 @@ export declare const inferenceInputSchema: z.ZodDiscriminatedUnion<"format", [z.
             type: "refusal";
             text: string;
         })[];
-        role: "tool" | "system" | "user" | "developer" | "assistant";
+        role: "system" | "tool" | "user" | "developer" | "assistant";
         name?: string | undefined;
         toolCallId?: string | undefined;
         toolCalls?: {
@@ -1117,7 +1117,7 @@ export declare const inferenceInputSchema: z.ZodDiscriminatedUnion<"format", [z.
             type: "refusal";
             text: string;
         })[];
-        role: "tool" | "system" | "user" | "developer" | "assistant";
+        role: "system" | "tool" | "user" | "developer" | "assistant";
         name?: string | undefined;
         toolCallId?: string | undefined;
         toolCalls?: {
@@ -1272,6 +1272,21 @@ export declare const clientRequestMetadataSchema: z.ZodObject<{
     clientRequestId?: string | undefined;
     labels?: Record<string, string> | undefined;
 }>;
+/** Parameters for text-to-speech, preserved in the signed request. */
+export declare const inferenceSpeechParametersSchema: z.ZodObject<{
+    voice: z.ZodString;
+    responseFormat: z.ZodEnum<["mp3", "opus", "aac", "flac", "wav", "pcm"]>;
+    speed: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    voice: string;
+    responseFormat: "mp3" | "opus" | "aac" | "flac" | "wav" | "pcm";
+    speed?: number | undefined;
+}, {
+    voice: string;
+    responseFormat: "mp3" | "opus" | "aac" | "flac" | "wav" | "pcm";
+    speed?: number | undefined;
+}>;
+export type InferenceSpeechParameters = z.infer<typeof inferenceSpeechParametersSchema>;
 /**
  * The canonical internal request Oxy forwards to the data plane.
  *
@@ -1583,7 +1598,7 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
                 type: "refusal";
                 text: string;
             })[];
-            role: "tool" | "system" | "user" | "developer" | "assistant";
+            role: "system" | "tool" | "user" | "developer" | "assistant";
             name?: string | undefined;
             toolCallId?: string | undefined;
             toolCalls?: {
@@ -1631,7 +1646,7 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
                 type: "refusal";
                 text: string;
             })[];
-            role: "tool" | "system" | "user" | "developer" | "assistant";
+            role: "system" | "tool" | "user" | "developer" | "assistant";
             name?: string | undefined;
             toolCallId?: string | undefined;
             toolCalls?: {
@@ -1679,7 +1694,7 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
                 type: "refusal";
                 text: string;
             })[];
-            role: "tool" | "system" | "user" | "developer" | "assistant";
+            role: "system" | "tool" | "user" | "developer" | "assistant";
             name?: string | undefined;
             toolCallId?: string | undefined;
             toolCalls?: {
@@ -1727,7 +1742,7 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
                 type: "refusal";
                 text: string;
             })[];
-            role: "tool" | "system" | "user" | "developer" | "assistant";
+            role: "system" | "tool" | "user" | "developer" | "assistant";
             name?: string | undefined;
             toolCallId?: string | undefined;
             toolCalls?: {
@@ -1778,7 +1793,7 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
                 type: "refusal";
                 text: string;
             })[];
-            role: "tool" | "system" | "user" | "developer" | "assistant";
+            role: "system" | "tool" | "user" | "developer" | "assistant";
             name?: string | undefined;
             toolCallId?: string | undefined;
             toolCalls?: {
@@ -1829,7 +1844,7 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
                 type: "refusal";
                 text: string;
             })[];
-            role: "tool" | "system" | "user" | "developer" | "assistant";
+            role: "system" | "tool" | "user" | "developer" | "assistant";
             name?: string | undefined;
             toolCallId?: string | undefined;
             toolCalls?: {
@@ -1885,6 +1900,19 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
         presencePenalty?: number | undefined;
         stopSequences?: string[] | undefined;
     }>;
+    speech: z.ZodOptional<z.ZodObject<{
+        voice: z.ZodString;
+        responseFormat: z.ZodEnum<["mp3", "opus", "aac", "flac", "wav", "pcm"]>;
+        speed: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        voice: string;
+        responseFormat: "mp3" | "opus" | "aac" | "flac" | "wav" | "pcm";
+        speed?: number | undefined;
+    }, {
+        voice: string;
+        responseFormat: "mp3" | "opus" | "aac" | "flac" | "wav" | "pcm";
+        speed?: number | undefined;
+    }>>;
     tools: z.ZodDefault<z.ZodArray<z.ZodObject<{
         type: z.ZodLiteral<"function">;
         name: z.ZodString;
@@ -2249,7 +2277,7 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
                 type: "refusal";
                 text: string;
             })[];
-            role: "tool" | "system" | "user" | "developer" | "assistant";
+            role: "system" | "tool" | "user" | "developer" | "assistant";
             name?: string | undefined;
             toolCallId?: string | undefined;
             toolCalls?: {
@@ -2281,10 +2309,6 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
     };
     idempotencyKey?: string | undefined;
     maxOutputTokens?: number | undefined;
-    toolChoice?: "none" | "required" | "auto" | {
-        type: "function";
-        name: string;
-    } | undefined;
     responseFormat?: {
         type: "text";
     } | {
@@ -2295,6 +2319,15 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
         name: string;
         strict: boolean;
     } | undefined;
+    speech?: {
+        voice: string;
+        responseFormat: "mp3" | "opus" | "aac" | "flac" | "wav" | "pcm";
+        speed?: number | undefined;
+    } | undefined;
+    toolChoice?: "none" | "required" | "auto" | {
+        type: "function";
+        name: string;
+    } | undefined;
     authorizedRoutes?: ({
         provider: string;
         modelReference: string;
@@ -2396,7 +2429,7 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
                 type: "refusal";
                 text: string;
             })[];
-            role: "tool" | "system" | "user" | "developer" | "assistant";
+            role: "system" | "tool" | "user" | "developer" | "assistant";
             name?: string | undefined;
             toolCallId?: string | undefined;
             toolCalls?: {
@@ -2435,10 +2468,6 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
     }[] | undefined;
     idempotencyKey?: string | undefined;
     maxOutputTokens?: number | undefined;
-    toolChoice?: "none" | "required" | "auto" | {
-        type: "function";
-        name: string;
-    } | undefined;
     responseFormat?: {
         type: "text";
     } | {
@@ -2449,6 +2478,15 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
         name: string;
         strict: boolean;
     } | undefined;
+    speech?: {
+        voice: string;
+        responseFormat: "mp3" | "opus" | "aac" | "flac" | "wav" | "pcm";
+        speed?: number | undefined;
+    } | undefined;
+    toolChoice?: "none" | "required" | "auto" | {
+        type: "function";
+        name: string;
+    } | undefined;
     authorizedRoutes?: ({
         provider: string;
         modelReference: string;
@@ -2557,7 +2595,7 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
                 type: "refusal";
                 text: string;
             })[];
-            role: "tool" | "system" | "user" | "developer" | "assistant";
+            role: "system" | "tool" | "user" | "developer" | "assistant";
             name?: string | undefined;
             toolCallId?: string | undefined;
             toolCalls?: {
@@ -2589,10 +2627,6 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
     };
     idempotencyKey?: string | undefined;
     maxOutputTokens?: number | undefined;
-    toolChoice?: "none" | "required" | "auto" | {
-        type: "function";
-        name: string;
-    } | undefined;
     responseFormat?: {
         type: "text";
     } | {
@@ -2603,6 +2637,15 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
         name: string;
         strict: boolean;
     } | undefined;
+    speech?: {
+        voice: string;
+        responseFormat: "mp3" | "opus" | "aac" | "flac" | "wav" | "pcm";
+        speed?: number | undefined;
+    } | undefined;
+    toolChoice?: "none" | "required" | "auto" | {
+        type: "function";
+        name: string;
+    } | undefined;
     authorizedRoutes?: ({
         provider: string;
         modelReference: string;
@@ -2704,7 +2747,7 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
                 type: "refusal";
                 text: string;
             })[];
-            role: "tool" | "system" | "user" | "developer" | "assistant";
+            role: "system" | "tool" | "user" | "developer" | "assistant";
             name?: string | undefined;
             toolCallId?: string | undefined;
             toolCalls?: {
@@ -2743,10 +2786,6 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
     }[] | undefined;
     idempotencyKey?: string | undefined;
     maxOutputTokens?: number | undefined;
-    toolChoice?: "none" | "required" | "auto" | {
-        type: "function";
-        name: string;
-    } | undefined;
     responseFormat?: {
         type: "text";
     } | {
@@ -2757,6 +2796,15 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
         name: string;
         strict: boolean;
     } | undefined;
+    speech?: {
+        voice: string;
+        responseFormat: "mp3" | "opus" | "aac" | "flac" | "wav" | "pcm";
+        speed?: number | undefined;
+    } | undefined;
+    toolChoice?: "none" | "required" | "auto" | {
+        type: "function";
+        name: string;
+    } | undefined;
     authorizedRoutes?: ({
         provider: string;
         modelReference: string;

package/dist/types/inference/streamEvents.d.ts

@@ -2,7 +2,7 @@
  * Normalized stream events — what the data plane emits and the Oxy edge
  * forwards as SSE.
  *
- * One discriminated union, seven shapes, all carrying `requestId` and a
+ * One discriminated union, eight shapes, all carrying `requestId` and a
  * monotonic `sequence`. `requestId` is on EVERY event rather than only the
  * first because a proxy that re-frames or a client that reconnects would
  * otherwise be holding events it cannot attribute; `sequence` is what makes a
@@ -93,6 +93,37 @@ export declare const inferenceStreamDeltaEventSchema: z.ZodObject<{
     sequence: number;
     outputIndex: number;
 }>;
+/** The encodings an audio output may carry. */
+export declare const inferenceAudioMediaTypeSchema: z.ZodEnum<["audio/mpeg", "audio/wav", "audio/ogg", "audio/aac", "audio/flac", "audio/pcm"]>;
+export type InferenceAudioMediaType = z.infer<typeof inferenceAudioMediaTypeSchema>;
+/** The most bytes one folded audio output may hold, at the edge and in the SDK. */
+export declare const MAX_INFERENCE_AUDIO_BYTES: number;
+/** A bounded, independently base64-encoded chunk of one audio output. */
+export declare const inferenceStreamAudioEventSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"audio">;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    outputIndex: z.ZodNumber;
+    mediaType: z.ZodEnum<["audio/mpeg", "audio/wav", "audio/ogg", "audio/aac", "audio/flac", "audio/pcm"]>;
+    data: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "audio";
+    schemaVersion: 1;
+    data: string;
+    requestId: string;
+    mediaType: "audio/mpeg" | "audio/wav" | "audio/ogg" | "audio/aac" | "audio/flac" | "audio/pcm";
+    sequence: number;
+    outputIndex: number;
+}, {
+    type: "audio";
+    schemaVersion: 1;
+    data: string;
+    requestId: string;
+    mediaType: "audio/mpeg" | "audio/wav" | "audio/ogg" | "audio/aac" | "audio/flac" | "audio/pcm";
+    sequence: number;
+    outputIndex: number;
+}>;
 /**
  * A tool call being streamed.
  *
@@ -400,7 +431,7 @@ export declare const inferenceStreamErrorEventSchema: z.ZodObject<{
             status?: number | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
-        code: "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "cancelled" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
+        code: "cancelled" | "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
         message: string;
         schemaVersion: 1;
         requestId: string;
@@ -415,7 +446,7 @@ export declare const inferenceStreamErrorEventSchema: z.ZodObject<{
             status?: number | undefined;
         } | undefined;
     }, {
-        code: "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "cancelled" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
+        code: "cancelled" | "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
         message: string;
         schemaVersion: 1;
         requestId: string;
@@ -430,7 +461,7 @@ export declare const inferenceStreamErrorEventSchema: z.ZodObject<{
             status?: number | undefined;
         } | undefined;
     }>, {
-        code: "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "cancelled" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
+        code: "cancelled" | "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
         message: string;
         schemaVersion: 1;
         requestId: string;
@@ -445,7 +476,7 @@ export declare const inferenceStreamErrorEventSchema: z.ZodObject<{
             status?: number | undefined;
         } | undefined;
     }, {
-        code: "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "cancelled" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
+        code: "cancelled" | "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
         message: string;
         schemaVersion: 1;
         requestId: string;
@@ -465,7 +496,7 @@ export declare const inferenceStreamErrorEventSchema: z.ZodObject<{
     schemaVersion: 1;
     requestId: string;
     error: {
-        code: "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "cancelled" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
+        code: "cancelled" | "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
         message: string;
         schemaVersion: 1;
         requestId: string;
@@ -486,7 +517,7 @@ export declare const inferenceStreamErrorEventSchema: z.ZodObject<{
     schemaVersion: 1;
     requestId: string;
     error: {
-        code: "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "cancelled" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
+        code: "cancelled" | "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
         message: string;
         schemaVersion: 1;
         requestId: string;
@@ -610,6 +641,30 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
     text: string;
     sequence: number;
     outputIndex: number;
+}>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"audio">;
+    requestId: z.ZodString;
+    sequence: z.ZodNumber;
+    outputIndex: z.ZodNumber;
+    mediaType: z.ZodEnum<["audio/mpeg", "audio/wav", "audio/ogg", "audio/aac", "audio/flac", "audio/pcm"]>;
+    data: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "audio";
+    schemaVersion: 1;
+    data: string;
+    requestId: string;
+    mediaType: "audio/mpeg" | "audio/wav" | "audio/ogg" | "audio/aac" | "audio/flac" | "audio/pcm";
+    sequence: number;
+    outputIndex: number;
+}, {
+    type: "audio";
+    schemaVersion: 1;
+    data: string;
+    requestId: string;
+    mediaType: "audio/mpeg" | "audio/wav" | "audio/ogg" | "audio/aac" | "audio/flac" | "audio/pcm";
+    sequence: number;
+    outputIndex: number;
 }>, z.ZodObject<{
     /** See `version.ts`: each stream event is a whole message on the wire. */
     schemaVersion: z.ZodLiteral<1>;
@@ -806,7 +861,7 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
             status?: number | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
-        code: "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "cancelled" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
+        code: "cancelled" | "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
         message: string;
         schemaVersion: 1;
         requestId: string;
@@ -821,7 +876,7 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
             status?: number | undefined;
         } | undefined;
     }, {
-        code: "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "cancelled" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
+        code: "cancelled" | "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
         message: string;
         schemaVersion: 1;
         requestId: string;
@@ -836,7 +891,7 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
             status?: number | undefined;
         } | undefined;
     }>, {
-        code: "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "cancelled" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
+        code: "cancelled" | "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
         message: string;
         schemaVersion: 1;
         requestId: string;
@@ -851,7 +906,7 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
             status?: number | undefined;
         } | undefined;
     }, {
-        code: "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "cancelled" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
+        code: "cancelled" | "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
         message: string;
         schemaVersion: 1;
         requestId: string;
@@ -871,7 +926,7 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
     schemaVersion: 1;
     requestId: string;
     error: {
-        code: "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "cancelled" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
+        code: "cancelled" | "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
         message: string;
         schemaVersion: 1;
         requestId: string;
@@ -892,7 +947,7 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
     schemaVersion: 1;
     requestId: string;
     error: {
-        code: "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "cancelled" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
+        code: "cancelled" | "invalid_request" | "authentication_failed" | "permission_denied" | "insufficient_scope" | "model_not_found" | "unsupported_modality" | "context_length_exceeded" | "request_too_large" | "output_limit_exceeded" | "idempotency_conflict" | "insufficient_balance" | "spending_limit_exceeded" | "quota_exceeded" | "byok_credential_invalid" | "policy_violation" | "commercial_permission_denied" | "no_route_available" | "upstream_content_filtered" | "rate_limited" | "deployment_unavailable" | "provider_error" | "provider_timeout" | "provider_overloaded" | "provider_credential_invalid" | "provider_billing_refused" | "service_unavailable" | "internal_error";
         message: string;
         schemaVersion: 1;
         requestId: string;
@@ -939,6 +994,7 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
 }>]>;
 export type InferenceStreamStartEvent = z.infer<typeof inferenceStreamStartEventSchema>;
 export type InferenceStreamDeltaEvent = z.infer<typeof inferenceStreamDeltaEventSchema>;
+export type InferenceStreamAudioEvent = z.infer<typeof inferenceStreamAudioEventSchema>;
 export type InferenceStreamToolCallEvent = z.infer<typeof inferenceStreamToolCallEventSchema>;
 export type InferenceStreamUsageEvent = z.infer<typeof inferenceStreamUsageEventSchema>;
 export type InferenceRouteSwitchDetail = z.infer<typeof inferenceRouteSwitchDetailSchema>;

package/dist/types/inference/usage.d.ts

@@ -490,7 +490,7 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     schemaVersion: 2;
     requestId: string;
-    outcome: "failed" | "cancelled" | "completed" | "partial";
+    outcome: "failed" | "completed" | "cancelled" | "partial";
     resolvedModelReference: string;
     servingProvider: string;
     attribution: {
@@ -521,7 +521,7 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
 }, {
     schemaVersion: 2;
     requestId: string;
-    outcome: "failed" | "cancelled" | "completed" | "partial";
+    outcome: "failed" | "completed" | "cancelled" | "partial";
     resolvedModelReference: string;
     servingProvider: string;
     attribution: {
@@ -552,7 +552,7 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
 }>, {
     schemaVersion: 2;
     requestId: string;
-    outcome: "failed" | "cancelled" | "completed" | "partial";
+    outcome: "failed" | "completed" | "cancelled" | "partial";
     resolvedModelReference: string;
     servingProvider: string;
     attribution: {
@@ -583,7 +583,7 @@ export declare const normalizedUsageReportSchema: z.ZodEffects<z.ZodObject<{
 }, {
     schemaVersion: 2;
     requestId: string;
-    outcome: "failed" | "cancelled" | "completed" | "partial";
+    outcome: "failed" | "completed" | "cancelled" | "partial";
     resolvedModelReference: string;
     servingProvider: string;
     attribution: {
@@ -753,7 +753,7 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
     settledAt: string;
     billedAmount: string & z.BRAND<"ExactDecimal">;
     currency: string;
-    outcome: "failed" | "cancelled" | "completed" | "partial";
+    outcome: "failed" | "completed" | "cancelled" | "partial";
     resolvedModelReference: string;
     servingProvider: string;
     platformFeeOnly: boolean;
@@ -794,7 +794,7 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
     settledAt: string;
     billedAmount: string;
     currency: string;
-    outcome: "failed" | "cancelled" | "completed" | "partial";
+    outcome: "failed" | "completed" | "cancelled" | "partial";
     resolvedModelReference: string;
     servingProvider: string;
     platformFeeOnly: boolean;
@@ -835,7 +835,7 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
     settledAt: string;
     billedAmount: string & z.BRAND<"ExactDecimal">;
     currency: string;
-    outcome: "failed" | "cancelled" | "completed" | "partial";
+    outcome: "failed" | "completed" | "cancelled" | "partial";
     resolvedModelReference: string;
     servingProvider: string;
     platformFeeOnly: boolean;
@@ -876,7 +876,7 @@ export declare const usageReceiptSchema: z.ZodEffects<z.ZodObject<{
     settledAt: string;
     billedAmount: string;
     currency: string;
-    outcome: "failed" | "cancelled" | "completed" | "partial";
+    outcome: "failed" | "completed" | "cancelled" | "partial";
     resolvedModelReference: string;
     servingProvider: string;
     platformFeeOnly: boolean;

package/dist/types/inference/version.d.ts

@@ -99,4 +99,4 @@
  * change to, say, the catalogue reject every in-flight inference request; the
  * per-shape `schemaVersion` is what a message is validated against.
  */
-export declare const INFERENCE_CONTRACT_VERSION = "2.0.0";
+export declare const INFERENCE_CONTRACT_VERSION = "3.0.0";

package/dist/types/keyRotation.d.ts

@@ -72,17 +72,17 @@ export declare const rotateKeyCompleteRequestSchema: z.ZodObject<{
     signOutEverywhere: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     signature: string;
-    timestamp: number;
     challenge: string;
     newPublicKey: string;
     newKeyProof: string;
+    timestamp: number;
     signOutEverywhere?: boolean | undefined;
 }, {
     signature: string;
-    timestamp: number;
     challenge: string;
     newPublicKey: string;
     newKeyProof: string;
+    timestamp: number;
     signOutEverywhere?: boolean | undefined;
 }>;
 export type RotateKeyCompleteRequest = z.infer<typeof rotateKeyCompleteRequestSchema>;