@oxyhq/contracts 0.28.0 → 0.30.0

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

@@ -43,19 +43,19 @@ export declare const inferenceStreamStartEventSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     type: "start";
     requestId: string;
-    schemaVersion: 1;
-    sequence: number;
     resolvedModelReference: string;
     servingProvider: string;
+    schemaVersion: 1;
+    sequence: number;
     startedAt: string;
     generationId?: string | undefined;
 }, {
     type: "start";
     requestId: string;
-    schemaVersion: 1;
-    sequence: number;
     resolvedModelReference: string;
     servingProvider: string;
+    schemaVersion: 1;
+    sequence: number;
     startedAt: string;
     generationId?: string | undefined;
 }>;
@@ -77,7 +77,7 @@ export declare const inferenceStreamDeltaEventSchema: z.ZodObject<{
     channel: z.ZodEnum<["output_text", "reasoning", "refusal"]>;
     text: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    channel: "reasoning" | "output_text" | "refusal";
+    channel: "reasoning" | "refusal" | "output_text";
     type: "delta";
     requestId: string;
     schemaVersion: 1;
@@ -85,7 +85,7 @@ export declare const inferenceStreamDeltaEventSchema: z.ZodObject<{
     sequence: number;
     outputIndex: number;
 }, {
-    channel: "reasoning" | "output_text" | "refusal";
+    channel: "reasoning" | "refusal" | "output_text";
     type: "delta";
     requestId: string;
     schemaVersion: 1;
@@ -136,6 +136,33 @@ export declare const inferenceStreamToolCallEventSchema: z.ZodObject<{
  * derived from these units and a price version at settlement; a cost quoted by
  * the data plane would be a second, unauthoritative answer to the same
  * question.
+ *
+ * ## This event is MEASUREMENT EVIDENCE, never a settleable record
+ *
+ * `normalizedUsageReportSchema` is the only shape a settlement is written from,
+ * and this event is deliberately NOT a subset of it that could be widened into
+ * one. It carries units and a source; a report additionally carries the
+ * attribution block, the outcome, the resolved route, the route-switch count and
+ * the two timestamps. Every one of those is knowable only by one END of the
+ * request rather than by the frame: the outcome only by the edge, which is the
+ * only party that knows whether the CLIENT cancelled, and the route record only
+ * by the data plane.
+ *
+ * So the event is not widened, and that is a decision rather than an omission.
+ * Adding the route record and the attribution block here would repeat both on
+ * EVERY usage frame of every stream, and each repetition is one more place two
+ * frames of one stream could disagree about which route served it — a second
+ * source of truth per frame, for fields no consumer of a progress signal reads.
+ *
+ * **What the edge may do with it, and what it may not.** The units are exact and
+ * may be settled; the record around them may not be inferred. When no terminal
+ * report arrives — the ordinary case for a client disconnect, since the report
+ * frame can no longer be delivered to a connection that is gone — the edge
+ * settles the units from the last such event and takes the OUTCOME from itself,
+ * never from the event. Its outcome is then `cancelled`, `partial` or `failed`;
+ * it is never `completed`, because nothing here can witness that the customer
+ * received the whole answer. Zero units marked `estimated` is the arm for no
+ * evidence at ALL, not for a disconnect that reported some.
  */
 export declare const inferenceStreamUsageEventSchema: z.ZodObject<{
     /** See `version.ts`: each stream event is a whole message on the wire. */
@@ -216,18 +243,18 @@ export declare const inferenceRouteSwitchDetailSchema: z.ZodDiscriminatedUnion<"
     authorizedByPolicy: z.ZodLiteral<true>;
 }, "strict", z.ZodTypeAny, {
     scope: "model";
+    authorizedByPolicy: true;
     toProvider: string;
     requestedModelId: string;
     fromModelReference: string;
     toModelReference: string;
-    authorizedByPolicy: true;
 }, {
     scope: "model";
+    authorizedByPolicy: true;
     toProvider: string;
     requestedModelId: string;
     fromModelReference: string;
     toModelReference: string;
-    authorizedByPolicy: true;
 }>]>;
 /** Why a route changed mid-request. */
 export declare const inferenceRouteSwitchReasonSchema: z.ZodEnum<["deployment_unavailable", "provider_error", "provider_timeout", "provider_overloaded", "rate_limited", "capacity", "policy_preference"]>;
@@ -277,18 +304,18 @@ export declare const inferenceStreamRouteSwitchEventSchema: z.ZodObject<{
         authorizedByPolicy: z.ZodLiteral<true>;
     }, "strict", z.ZodTypeAny, {
         scope: "model";
+        authorizedByPolicy: true;
         toProvider: string;
         requestedModelId: string;
         fromModelReference: string;
         toModelReference: string;
-        authorizedByPolicy: true;
     }, {
         scope: "model";
+        authorizedByPolicy: true;
         toProvider: string;
         requestedModelId: string;
         fromModelReference: string;
         toModelReference: string;
-        authorizedByPolicy: true;
     }>]>;
     occurredAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -304,11 +331,11 @@ export declare const inferenceStreamRouteSwitchEventSchema: z.ZodObject<{
         toDeploymentId?: string | undefined;
     } | {
         scope: "model";
+        authorizedByPolicy: true;
         toProvider: string;
         requestedModelId: string;
         fromModelReference: string;
         toModelReference: string;
-        authorizedByPolicy: true;
     };
     sequence: number;
 }, {
@@ -324,11 +351,11 @@ export declare const inferenceStreamRouteSwitchEventSchema: z.ZodObject<{
         toDeploymentId?: string | undefined;
     } | {
         scope: "model";
+        authorizedByPolicy: true;
         toProvider: string;
         requestedModelId: string;
         fromModelReference: string;
         toModelReference: string;
-        authorizedByPolicy: true;
     };
     sequence: number;
 }>;
@@ -345,7 +372,7 @@ export declare const inferenceStreamErrorEventSchema: z.ZodObject<{
     /** Carries its own `schemaVersion`: the same body is returned non-streaming. */
     error: z.ZodEffects<z.ZodObject<{
         schemaVersion: z.ZodLiteral<1>;
-        code: z.ZodEnum<["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", "service_unavailable", "internal_error"]>;
+        code: z.ZodEnum<["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"]>;
         message: z.ZodEffects<z.ZodString, string, string>;
         retryable: z.ZodBoolean;
         requestId: z.ZodString;
@@ -369,7 +396,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" | "service_unavailable" | "internal_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";
         message: string;
         requestId: string;
         schemaVersion: 1;
@@ -384,7 +411,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" | "service_unavailable" | "internal_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";
         message: string;
         requestId: string;
         schemaVersion: 1;
@@ -399,7 +426,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" | "service_unavailable" | "internal_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";
         message: string;
         requestId: string;
         schemaVersion: 1;
@@ -414,7 +441,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" | "service_unavailable" | "internal_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";
         message: string;
         requestId: string;
         schemaVersion: 1;
@@ -435,7 +462,7 @@ export declare const inferenceStreamErrorEventSchema: z.ZodObject<{
     schemaVersion: 1;
     sequence: number;
     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" | "service_unavailable" | "internal_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";
         message: string;
         requestId: string;
         schemaVersion: 1;
@@ -456,7 +483,7 @@ export declare const inferenceStreamErrorEventSchema: z.ZodObject<{
     schemaVersion: 1;
     sequence: number;
     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" | "service_unavailable" | "internal_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";
         message: string;
         requestId: string;
         schemaVersion: 1;
@@ -472,8 +499,17 @@ export declare const inferenceStreamErrorEventSchema: z.ZodObject<{
         } | undefined;
     };
 }>;
-/** Why generation stopped. */
-export declare const inferenceFinishReasonSchema: z.ZodEnum<["stop", "length", "tool_calls", "content_filter", "cancelled"]>;
+/**
+ * Why generation stopped.
+ *
+ * `refusal` and `content_filter` are separate members because they are separate
+ * events: the MODEL declining to answer is a property of the answer, while a
+ * filter is an upstream system removing one. The delta channels already carry
+ * that distinction (`channel: 'refusal'` beside the filter's own error code),
+ * so collapsing it here would have made the terminal event less specific than
+ * the stream that produced it.
+ */
+export declare const inferenceFinishReasonSchema: z.ZodEnum<["stop", "length", "tool_calls", "content_filter", "refusal", "cancelled"]>;
 /**
  * The successful terminal event.
  *
@@ -487,7 +523,7 @@ export declare const inferenceStreamDoneEventSchema: z.ZodObject<{
     requestId: z.ZodString;
     sequence: z.ZodNumber;
     generationId: z.ZodOptional<z.ZodString>;
-    finishReason: z.ZodEnum<["stop", "length", "tool_calls", "content_filter", "cancelled"]>;
+    finishReason: z.ZodEnum<["stop", "length", "tool_calls", "content_filter", "refusal", "cancelled"]>;
     receiptId: z.ZodOptional<z.ZodString>;
     completedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -495,19 +531,19 @@ export declare const inferenceStreamDoneEventSchema: z.ZodObject<{
     requestId: string;
     schemaVersion: 1;
     sequence: number;
-    finishReason: "length" | "cancelled" | "content_filter" | "stop" | "tool_calls";
+    finishReason: "length" | "cancelled" | "content_filter" | "refusal" | "stop" | "tool_calls";
     completedAt: string;
-    generationId?: string | undefined;
     receiptId?: string | undefined;
+    generationId?: string | undefined;
 }, {
     type: "done";
     requestId: string;
     schemaVersion: 1;
     sequence: number;
-    finishReason: "length" | "cancelled" | "content_filter" | "stop" | "tool_calls";
+    finishReason: "length" | "cancelled" | "content_filter" | "refusal" | "stop" | "tool_calls";
     completedAt: string;
-    generationId?: string | undefined;
     receiptId?: string | undefined;
+    generationId?: string | undefined;
 }>;
 /**
  * Every event a normalized stream can carry.
@@ -529,19 +565,19 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
 }, "strip", z.ZodTypeAny, {
     type: "start";
     requestId: string;
-    schemaVersion: 1;
-    sequence: number;
     resolvedModelReference: string;
     servingProvider: string;
+    schemaVersion: 1;
+    sequence: number;
     startedAt: string;
     generationId?: string | undefined;
 }, {
     type: "start";
     requestId: string;
-    schemaVersion: 1;
-    sequence: number;
     resolvedModelReference: string;
     servingProvider: string;
+    schemaVersion: 1;
+    sequence: number;
     startedAt: string;
     generationId?: string | undefined;
 }>, z.ZodObject<{
@@ -555,7 +591,7 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
     channel: z.ZodEnum<["output_text", "reasoning", "refusal"]>;
     text: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    channel: "reasoning" | "output_text" | "refusal";
+    channel: "reasoning" | "refusal" | "output_text";
     type: "delta";
     requestId: string;
     schemaVersion: 1;
@@ -563,7 +599,7 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
     sequence: number;
     outputIndex: number;
 }, {
-    channel: "reasoning" | "output_text" | "refusal";
+    channel: "reasoning" | "refusal" | "output_text";
     type: "delta";
     requestId: string;
     schemaVersion: 1;
@@ -675,18 +711,18 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
         authorizedByPolicy: z.ZodLiteral<true>;
     }, "strict", z.ZodTypeAny, {
         scope: "model";
+        authorizedByPolicy: true;
         toProvider: string;
         requestedModelId: string;
         fromModelReference: string;
         toModelReference: string;
-        authorizedByPolicy: true;
     }, {
         scope: "model";
+        authorizedByPolicy: true;
         toProvider: string;
         requestedModelId: string;
         fromModelReference: string;
         toModelReference: string;
-        authorizedByPolicy: true;
     }>]>;
     occurredAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -702,11 +738,11 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
         toDeploymentId?: string | undefined;
     } | {
         scope: "model";
+        authorizedByPolicy: true;
         toProvider: string;
         requestedModelId: string;
         fromModelReference: string;
         toModelReference: string;
-        authorizedByPolicy: true;
     };
     sequence: number;
 }, {
@@ -722,11 +758,11 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
         toDeploymentId?: string | undefined;
     } | {
         scope: "model";
+        authorizedByPolicy: true;
         toProvider: string;
         requestedModelId: string;
         fromModelReference: string;
         toModelReference: string;
-        authorizedByPolicy: true;
     };
     sequence: number;
 }>, z.ZodObject<{
@@ -738,7 +774,7 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
     /** Carries its own `schemaVersion`: the same body is returned non-streaming. */
     error: z.ZodEffects<z.ZodObject<{
         schemaVersion: z.ZodLiteral<1>;
-        code: z.ZodEnum<["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", "service_unavailable", "internal_error"]>;
+        code: z.ZodEnum<["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"]>;
         message: z.ZodEffects<z.ZodString, string, string>;
         retryable: z.ZodBoolean;
         requestId: z.ZodString;
@@ -762,7 +798,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" | "service_unavailable" | "internal_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";
         message: string;
         requestId: string;
         schemaVersion: 1;
@@ -777,7 +813,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" | "service_unavailable" | "internal_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";
         message: string;
         requestId: string;
         schemaVersion: 1;
@@ -792,7 +828,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" | "service_unavailable" | "internal_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";
         message: string;
         requestId: string;
         schemaVersion: 1;
@@ -807,7 +843,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" | "service_unavailable" | "internal_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";
         message: string;
         requestId: string;
         schemaVersion: 1;
@@ -828,7 +864,7 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
     schemaVersion: 1;
     sequence: number;
     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" | "service_unavailable" | "internal_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";
         message: string;
         requestId: string;
         schemaVersion: 1;
@@ -849,7 +885,7 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
     schemaVersion: 1;
     sequence: number;
     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" | "service_unavailable" | "internal_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";
         message: string;
         requestId: string;
         schemaVersion: 1;
@@ -871,7 +907,7 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
     requestId: z.ZodString;
     sequence: z.ZodNumber;
     generationId: z.ZodOptional<z.ZodString>;
-    finishReason: z.ZodEnum<["stop", "length", "tool_calls", "content_filter", "cancelled"]>;
+    finishReason: z.ZodEnum<["stop", "length", "tool_calls", "content_filter", "refusal", "cancelled"]>;
     receiptId: z.ZodOptional<z.ZodString>;
     completedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -879,19 +915,19 @@ export declare const inferenceStreamEventSchema: z.ZodDiscriminatedUnion<"type",
     requestId: string;
     schemaVersion: 1;
     sequence: number;
-    finishReason: "length" | "cancelled" | "content_filter" | "stop" | "tool_calls";
+    finishReason: "length" | "cancelled" | "content_filter" | "refusal" | "stop" | "tool_calls";
     completedAt: string;
-    generationId?: string | undefined;
     receiptId?: string | undefined;
+    generationId?: string | undefined;
 }, {
     type: "done";
     requestId: string;
     schemaVersion: 1;
     sequence: number;
-    finishReason: "length" | "cancelled" | "content_filter" | "stop" | "tool_calls";
+    finishReason: "length" | "cancelled" | "content_filter" | "refusal" | "stop" | "tool_calls";
     completedAt: string;
-    generationId?: string | undefined;
     receiptId?: string | undefined;
+    generationId?: string | undefined;
 }>]>;
 export type InferenceStreamStartEvent = z.infer<typeof inferenceStreamStartEventSchema>;
 export type InferenceStreamDeltaEvent = z.infer<typeof inferenceStreamDeltaEventSchema>;