@oxy.so/contracts 1.0.0

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

@@ -0,0 +1,2800 @@
+/**
+ * The normalized inference request — the canonical internal envelope Oxy's
+ * public edge forwards to the data plane.
+ *
+ * The public surface speaks several dialects (`/v1/responses`,
+ * `/v1/chat/completions`, embeddings, images, audio). Exactly one of them is
+ * normalized here, at the edge, so that routing, metering, policy enforcement
+ * and settlement are written once against one shape instead of once per dialect.
+ * `client.apiFormat` records which dialect the customer used, because the
+ * response has to be rendered back in it.
+ *
+ * What the envelope carries that a provider request does not: the resolved
+ * attribution block (who pays, which application, which credential, which
+ * delegated user), the exact routing policy reference, the routes that policy
+ * has already authorized, and the customer's idempotency key. Those are the
+ * fields that make a request billable and explainable, and they are resolved
+ * BEFORE the request enters the data plane.
+ *
+ * The policy VALUES never travel. `routingPolicy` is a reference — provenance
+ * for the receipt — and `authorizedRoutes` is the result of applying the policy,
+ * in preference order, so the data plane needs no policy semantics to fail over.
+ *
+ * Decided in: docs/adr/0010-public-api-compatibility.md,
+ * docs/adr/0017-authorized-routes-in-the-envelope.md.
+ */
+import { z } from "zod";
+/**
+ * Where binary or remote content comes from.
+ *
+ * `url` is fetched by the data plane; `inline` carries base64 the customer sent
+ * with the request. Both are transient: neither is persisted by default, and
+ * neither appears in a receipt, a log line or a telemetry event.
+ */
+export declare const inferenceContentSourceSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"url">;
+    url: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    kind: "url";
+    url: string;
+}, {
+    kind: "url";
+    url: string;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"inline">;
+    mediaType: z.ZodString;
+    data: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    kind: "inline";
+    data: string;
+    mediaType: string;
+}, {
+    kind: "inline";
+    data: string;
+    mediaType: string;
+}>]>;
+/**
+ * One part of a message's content. A message is always a list of parts.
+ *
+ * ## `refusal` is a member and `reasoning` is not, and the asymmetry is the point
+ *
+ * A model that DECLINES says why, and those words are meant for the customer:
+ * they are the difference between "rephrase this" and "stop asking". Before this
+ * member existed there was nowhere in an {@link InferenceMessage} to put them, so
+ * a non-streaming fold kept `finishReason: 'refusal'` and dropped the sentence —
+ * the customer learned they were refused and not why, while a streaming caller of
+ * the same request got the whole explanation on the `refusal` delta channel.
+ *
+ * Reasoning is the opposite case and stays absent. It is the model's private
+ * working, and a `text` part is where somebody would put it — which renders
+ * private reasoning to the customer AS the answer, the product bug the delta
+ * channels exist to prevent. An opaque per-block reasoning blob crossing this
+ * boundary needs a home nobody has chosen yet, and inventing one here would
+ * choose it by accident.
+ *
+ * Both public dialects can carry a refusal, which is what separates the two
+ * cases at the boundary as well as in principle: `refusal` is OpenAI's OWN field
+ * in both of its shapes (`delta.refusal` streaming, `message.refusal`
+ * non-streaming), while reasoning has no OpenAI field at all — the
+ * `reasoning_content`/`reasoning` spellings an OpenAI-compatible provider emits
+ * are provider extensions. So carrying the refusal costs no dialect its
+ * standard-client parseability, and carrying reasoning would.
+ *
+ * The part is a MEMBER rather than a field because a refusal need not have text:
+ * an Anthropic `stop_reason: "refusal"` maps to the finish reason and separates
+ * no words from the answer, while an OpenAI-compatible `refusal` does. A required
+ * field would force the first provider to invent a sentence.
+ */
+export declare const inferenceContentPartSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    type: "text";
+    text: string;
+}, {
+    type: "text";
+    text: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    source: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "url";
+        url: string;
+    }, {
+        kind: "url";
+        url: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"inline">;
+        mediaType: z.ZodString;
+        data: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "inline";
+        data: string;
+        mediaType: string;
+    }, {
+        kind: "inline";
+        data: string;
+        mediaType: string;
+    }>]>;
+    /** Provider-independent hint; providers that ignore it are unaffected. */
+    detail: z.ZodOptional<z.ZodEnum<["auto", "low", "high"]>>;
+}, "strict", z.ZodTypeAny, {
+    type: "image";
+    source: {
+        kind: "url";
+        url: string;
+    } | {
+        kind: "inline";
+        data: string;
+        mediaType: string;
+    };
+    detail?: "low" | "high" | "auto" | undefined;
+}, {
+    type: "image";
+    source: {
+        kind: "url";
+        url: string;
+    } | {
+        kind: "inline";
+        data: string;
+        mediaType: string;
+    };
+    detail?: "low" | "high" | "auto" | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"audio">;
+    source: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "url";
+        url: string;
+    }, {
+        kind: "url";
+        url: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"inline">;
+        mediaType: z.ZodString;
+        data: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "inline";
+        data: string;
+        mediaType: string;
+    }, {
+        kind: "inline";
+        data: string;
+        mediaType: string;
+    }>]>;
+}, "strict", z.ZodTypeAny, {
+    type: "audio";
+    source: {
+        kind: "url";
+        url: string;
+    } | {
+        kind: "inline";
+        data: string;
+        mediaType: string;
+    };
+}, {
+    type: "audio";
+    source: {
+        kind: "url";
+        url: string;
+    } | {
+        kind: "inline";
+        data: string;
+        mediaType: string;
+    };
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"file">;
+    source: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "url";
+        url: string;
+    }, {
+        kind: "url";
+        url: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"inline">;
+        mediaType: z.ZodString;
+        data: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "inline";
+        data: string;
+        mediaType: string;
+    }, {
+        kind: "inline";
+        data: string;
+        mediaType: string;
+    }>]>;
+    filename: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    type: "file";
+    source: {
+        kind: "url";
+        url: string;
+    } | {
+        kind: "inline";
+        data: string;
+        mediaType: string;
+    };
+    filename?: string | undefined;
+}, {
+    type: "file";
+    source: {
+        kind: "url";
+        url: string;
+    } | {
+        kind: "inline";
+        data: string;
+        mediaType: string;
+    };
+    filename?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"refusal">;
+    text: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    type: "refusal";
+    text: string;
+}, {
+    type: "refusal";
+    text: string;
+}>]>;
+/**
+ * A tool call an assistant made, in the normalized form.
+ *
+ * `arguments` is the JSON TEXT the model emitted, not a parsed object: models
+ * emit invalid JSON often enough that parsing it here would turn a recoverable
+ * model mistake into a rejected message.
+ */
+export declare const inferenceToolCallSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    arguments: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    id: string;
+    arguments: string;
+}, {
+    name: string;
+    id: string;
+    arguments: string;
+}>;
+export declare const inferenceMessageRoleSchema: z.ZodEnum<["system", "developer", "user", "assistant", "tool"]>;
+/**
+ * One normalized message.
+ *
+ * The role-specific fields are refined rather than modelled as a discriminated
+ * union so the shape stays the one a caller recognises from the OpenAI-style
+ * dialects; the refinement is what stops `toolCallId` from riding on a user
+ * message, where every provider would silently ignore it.
+ */
+export declare const inferenceMessageSchema: z.ZodEffects<z.ZodObject<{
+    role: z.ZodEnum<["system", "developer", "user", "assistant", "tool"]>;
+    content: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        type: "text";
+        text: string;
+    }, {
+        type: "text";
+        text: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        source: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"url">;
+            url: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            kind: "url";
+            url: string;
+        }, {
+            kind: "url";
+            url: string;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"inline">;
+            mediaType: z.ZodString;
+            data: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        }, {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        }>]>;
+        /** Provider-independent hint; providers that ignore it are unaffected. */
+        detail: z.ZodOptional<z.ZodEnum<["auto", "low", "high"]>>;
+    }, "strict", z.ZodTypeAny, {
+        type: "image";
+        source: {
+            kind: "url";
+            url: string;
+        } | {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        };
+        detail?: "low" | "high" | "auto" | undefined;
+    }, {
+        type: "image";
+        source: {
+            kind: "url";
+            url: string;
+        } | {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        };
+        detail?: "low" | "high" | "auto" | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"audio">;
+        source: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"url">;
+            url: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            kind: "url";
+            url: string;
+        }, {
+            kind: "url";
+            url: string;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"inline">;
+            mediaType: z.ZodString;
+            data: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        }, {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        }>]>;
+    }, "strict", z.ZodTypeAny, {
+        type: "audio";
+        source: {
+            kind: "url";
+            url: string;
+        } | {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        };
+    }, {
+        type: "audio";
+        source: {
+            kind: "url";
+            url: string;
+        } | {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        };
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"file">;
+        source: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"url">;
+            url: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            kind: "url";
+            url: string;
+        }, {
+            kind: "url";
+            url: string;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"inline">;
+            mediaType: z.ZodString;
+            data: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        }, {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        }>]>;
+        filename: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        type: "file";
+        source: {
+            kind: "url";
+            url: string;
+        } | {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        };
+        filename?: string | undefined;
+    }, {
+        type: "file";
+        source: {
+            kind: "url";
+            url: string;
+        } | {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        };
+        filename?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"refusal">;
+        text: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        type: "refusal";
+        text: string;
+    }, {
+        type: "refusal";
+        text: string;
+    }>]>, "many">;
+    /** Participant name, where the dialect supports naming participants. */
+    name: z.ZodOptional<z.ZodString>;
+    /** The tool call this message answers. Required on, and only on, `tool`. */
+    toolCallId: z.ZodOptional<z.ZodString>;
+    /** Tool calls the assistant made. Only on `assistant`. */
+    toolCalls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        arguments: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        id: string;
+        arguments: string;
+    }, {
+        name: string;
+        id: string;
+        arguments: string;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    content: ({
+        type: "text";
+        text: string;
+    } | {
+        type: "image";
+        source: {
+            kind: "url";
+            url: string;
+        } | {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        };
+        detail?: "low" | "high" | "auto" | undefined;
+    } | {
+        type: "audio";
+        source: {
+            kind: "url";
+            url: string;
+        } | {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        };
+    } | {
+        type: "file";
+        source: {
+            kind: "url";
+            url: string;
+        } | {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        };
+        filename?: string | undefined;
+    } | {
+        type: "refusal";
+        text: string;
+    })[];
+    role: "tool" | "system" | "user" | "developer" | "assistant";
+    name?: string | undefined;
+    toolCallId?: string | undefined;
+    toolCalls?: {
+        name: string;
+        id: string;
+        arguments: string;
+    }[] | undefined;
+}, {
+    content: ({
+        type: "text";
+        text: string;
+    } | {
+        type: "image";
+        source: {
+            kind: "url";
+            url: string;
+        } | {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        };
+        detail?: "low" | "high" | "auto" | undefined;
+    } | {
+        type: "audio";
+        source: {
+            kind: "url";
+            url: string;
+        } | {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        };
+    } | {
+        type: "file";
+        source: {
+            kind: "url";
+            url: string;
+        } | {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        };
+        filename?: string | undefined;
+    } | {
+        type: "refusal";
+        text: string;
+    })[];
+    role: "tool" | "system" | "user" | "developer" | "assistant";
+    name?: string | undefined;
+    toolCallId?: string | undefined;
+    toolCalls?: {
+        name: string;
+        id: string;
+        arguments: string;
+    }[] | undefined;
+}>, {
+    content: ({
+        type: "text";
+        text: string;
+    } | {
+        type: "image";
+        source: {
+            kind: "url";
+            url: string;
+        } | {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        };
+        detail?: "low" | "high" | "auto" | undefined;
+    } | {
+        type: "audio";
+        source: {
+            kind: "url";
+            url: string;
+        } | {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        };
+    } | {
+        type: "file";
+        source: {
+            kind: "url";
+            url: string;
+        } | {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        };
+        filename?: string | undefined;
+    } | {
+        type: "refusal";
+        text: string;
+    })[];
+    role: "tool" | "system" | "user" | "developer" | "assistant";
+    name?: string | undefined;
+    toolCallId?: string | undefined;
+    toolCalls?: {
+        name: string;
+        id: string;
+        arguments: string;
+    }[] | undefined;
+}, {
+    content: ({
+        type: "text";
+        text: string;
+    } | {
+        type: "image";
+        source: {
+            kind: "url";
+            url: string;
+        } | {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        };
+        detail?: "low" | "high" | "auto" | undefined;
+    } | {
+        type: "audio";
+        source: {
+            kind: "url";
+            url: string;
+        } | {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        };
+    } | {
+        type: "file";
+        source: {
+            kind: "url";
+            url: string;
+        } | {
+            kind: "inline";
+            data: string;
+            mediaType: string;
+        };
+        filename?: string | undefined;
+    } | {
+        type: "refusal";
+        text: string;
+    })[];
+    role: "tool" | "system" | "user" | "developer" | "assistant";
+    name?: string | undefined;
+    toolCallId?: string | undefined;
+    toolCalls?: {
+        name: string;
+        id: string;
+        arguments: string;
+    }[] | undefined;
+}>;
+/**
+ * The request's input.
+ *
+ * Three formats, because the modalities genuinely differ: a chat request is a
+ * conversation, an embedding request is a string or a batch of strings, and
+ * pretending the latter is a one-message conversation loses the batch boundary
+ * that both metering and provider translation depend on.
+ */
+export declare const inferenceInputSchema: z.ZodDiscriminatedUnion<"format", [z.ZodObject<{
+    format: z.ZodLiteral<"messages">;
+    messages: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        role: z.ZodEnum<["system", "developer", "user", "assistant", "tool"]>;
+        content: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            type: "text";
+            text: string;
+        }, {
+            type: "text";
+            text: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"image">;
+            source: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"url">;
+                url: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                kind: "url";
+                url: string;
+            }, {
+                kind: "url";
+                url: string;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"inline">;
+                mediaType: z.ZodString;
+                data: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            }, {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            }>]>;
+            /** Provider-independent hint; providers that ignore it are unaffected. */
+            detail: z.ZodOptional<z.ZodEnum<["auto", "low", "high"]>>;
+        }, "strict", z.ZodTypeAny, {
+            type: "image";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+            detail?: "low" | "high" | "auto" | undefined;
+        }, {
+            type: "image";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+            detail?: "low" | "high" | "auto" | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"audio">;
+            source: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"url">;
+                url: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                kind: "url";
+                url: string;
+            }, {
+                kind: "url";
+                url: string;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"inline">;
+                mediaType: z.ZodString;
+                data: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            }, {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            }>]>;
+        }, "strict", z.ZodTypeAny, {
+            type: "audio";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+        }, {
+            type: "audio";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"file">;
+            source: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"url">;
+                url: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                kind: "url";
+                url: string;
+            }, {
+                kind: "url";
+                url: string;
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"inline">;
+                mediaType: z.ZodString;
+                data: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            }, {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            }>]>;
+            filename: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            type: "file";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+            filename?: string | undefined;
+        }, {
+            type: "file";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+            filename?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"refusal">;
+            text: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            type: "refusal";
+            text: string;
+        }, {
+            type: "refusal";
+            text: string;
+        }>]>, "many">;
+        /** Participant name, where the dialect supports naming participants. */
+        name: z.ZodOptional<z.ZodString>;
+        /** The tool call this message answers. Required on, and only on, `tool`. */
+        toolCallId: z.ZodOptional<z.ZodString>;
+        /** Tool calls the assistant made. Only on `assistant`. */
+        toolCalls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            arguments: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            name: string;
+            id: string;
+            arguments: string;
+        }, {
+            name: string;
+            id: string;
+            arguments: string;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        content: ({
+            type: "text";
+            text: string;
+        } | {
+            type: "image";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+            detail?: "low" | "high" | "auto" | undefined;
+        } | {
+            type: "audio";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+        } | {
+            type: "file";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+            filename?: string | undefined;
+        } | {
+            type: "refusal";
+            text: string;
+        })[];
+        role: "tool" | "system" | "user" | "developer" | "assistant";
+        name?: string | undefined;
+        toolCallId?: string | undefined;
+        toolCalls?: {
+            name: string;
+            id: string;
+            arguments: string;
+        }[] | undefined;
+    }, {
+        content: ({
+            type: "text";
+            text: string;
+        } | {
+            type: "image";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+            detail?: "low" | "high" | "auto" | undefined;
+        } | {
+            type: "audio";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+        } | {
+            type: "file";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+            filename?: string | undefined;
+        } | {
+            type: "refusal";
+            text: string;
+        })[];
+        role: "tool" | "system" | "user" | "developer" | "assistant";
+        name?: string | undefined;
+        toolCallId?: string | undefined;
+        toolCalls?: {
+            name: string;
+            id: string;
+            arguments: string;
+        }[] | undefined;
+    }>, {
+        content: ({
+            type: "text";
+            text: string;
+        } | {
+            type: "image";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+            detail?: "low" | "high" | "auto" | undefined;
+        } | {
+            type: "audio";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+        } | {
+            type: "file";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+            filename?: string | undefined;
+        } | {
+            type: "refusal";
+            text: string;
+        })[];
+        role: "tool" | "system" | "user" | "developer" | "assistant";
+        name?: string | undefined;
+        toolCallId?: string | undefined;
+        toolCalls?: {
+            name: string;
+            id: string;
+            arguments: string;
+        }[] | undefined;
+    }, {
+        content: ({
+            type: "text";
+            text: string;
+        } | {
+            type: "image";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+            detail?: "low" | "high" | "auto" | undefined;
+        } | {
+            type: "audio";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+        } | {
+            type: "file";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+            filename?: string | undefined;
+        } | {
+            type: "refusal";
+            text: string;
+        })[];
+        role: "tool" | "system" | "user" | "developer" | "assistant";
+        name?: string | undefined;
+        toolCallId?: string | undefined;
+        toolCalls?: {
+            name: string;
+            id: string;
+            arguments: string;
+        }[] | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    format: "messages";
+    messages: {
+        content: ({
+            type: "text";
+            text: string;
+        } | {
+            type: "image";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+            detail?: "low" | "high" | "auto" | undefined;
+        } | {
+            type: "audio";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+        } | {
+            type: "file";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+            filename?: string | undefined;
+        } | {
+            type: "refusal";
+            text: string;
+        })[];
+        role: "tool" | "system" | "user" | "developer" | "assistant";
+        name?: string | undefined;
+        toolCallId?: string | undefined;
+        toolCalls?: {
+            name: string;
+            id: string;
+            arguments: string;
+        }[] | undefined;
+    }[];
+}, {
+    format: "messages";
+    messages: {
+        content: ({
+            type: "text";
+            text: string;
+        } | {
+            type: "image";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+            detail?: "low" | "high" | "auto" | undefined;
+        } | {
+            type: "audio";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+        } | {
+            type: "file";
+            source: {
+                kind: "url";
+                url: string;
+            } | {
+                kind: "inline";
+                data: string;
+                mediaType: string;
+            };
+            filename?: string | undefined;
+        } | {
+            type: "refusal";
+            text: string;
+        })[];
+        role: "tool" | "system" | "user" | "developer" | "assistant";
+        name?: string | undefined;
+        toolCallId?: string | undefined;
+        toolCalls?: {
+            name: string;
+            id: string;
+            arguments: string;
+        }[] | undefined;
+    }[];
+}>, z.ZodObject<{
+    format: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    text: string;
+    format: "text";
+}, {
+    text: string;
+    format: "text";
+}>, z.ZodObject<{
+    format: z.ZodLiteral<"text_batch">;
+    texts: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    format: "text_batch";
+    texts: string[];
+}, {
+    format: "text_batch";
+    texts: string[];
+}>]>;
+/** Sampling parameters, all optional: absent means the route's own default. */
+export declare const samplingParametersSchema: z.ZodObject<{
+    temperature: z.ZodOptional<z.ZodNumber>;
+    topP: z.ZodOptional<z.ZodNumber>;
+    topK: z.ZodOptional<z.ZodNumber>;
+    frequencyPenalty: z.ZodOptional<z.ZodNumber>;
+    presencePenalty: z.ZodOptional<z.ZodNumber>;
+    /** A seed makes a request reproducible on providers that honour one. */
+    seed: z.ZodOptional<z.ZodNumber>;
+    stopSequences: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    seed?: number | undefined;
+    temperature?: number | undefined;
+    topP?: number | undefined;
+    topK?: number | undefined;
+    frequencyPenalty?: number | undefined;
+    presencePenalty?: number | undefined;
+    stopSequences?: string[] | undefined;
+}, {
+    seed?: number | undefined;
+    temperature?: number | undefined;
+    topP?: number | undefined;
+    topK?: number | undefined;
+    frequencyPenalty?: number | undefined;
+    presencePenalty?: number | undefined;
+    stopSequences?: string[] | undefined;
+}>;
+/**
+ * A tool the model may call. `parameters` is a JSON Schema document, carried
+ * as an opaque object: validating the customer's JSON Schema against a meta
+ * schema here would reject documents providers accept.
+ */
+export declare const toolDefinitionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"function">;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /** Ask the provider to enforce the schema, where it supports enforcement. */
+    strict: z.ZodOptional<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    type: "function";
+    name: string;
+    parameters: Record<string, unknown>;
+    description?: string | undefined;
+    strict?: boolean | undefined;
+}, {
+    type: "function";
+    name: string;
+    parameters: Record<string, unknown>;
+    description?: string | undefined;
+    strict?: boolean | undefined;
+}>;
+/** Whether, and which, tool the model must call. */
+export declare const toolChoiceSchema: z.ZodUnion<[z.ZodEnum<["auto", "none", "required"]>, z.ZodObject<{
+    type: z.ZodLiteral<"function">;
+    name: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    type: "function";
+    name: string;
+}, {
+    type: "function";
+    name: string;
+}>]>;
+/** Structured-output request: free text, any JSON object, or a named schema. */
+export declare const responseFormatSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+}, "strict", z.ZodTypeAny, {
+    type: "text";
+}, {
+    type: "text";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"json_object">;
+}, "strict", z.ZodTypeAny, {
+    type: "json_object";
+}, {
+    type: "json_object";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"json_schema">;
+    name: z.ZodString;
+    schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    strict: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    type: "json_schema";
+    schema: Record<string, unknown>;
+    name: string;
+    strict: boolean;
+}, {
+    type: "json_schema";
+    schema: Record<string, unknown>;
+    name: string;
+    strict: boolean;
+}>]>;
+/**
+ * What the edge records about the CALL, as opposed to its content.
+ *
+ * `.strict()` is a privacy control, not tidiness. Oxy never persists a user IP
+ * — raw, hashed or geo-derived — and this object is the natural place somebody
+ * would add one "for security". Strict means a producer that attaches `ip`,
+ * `country`, `userAgent` or `forwardedFor` fails the parse instead of quietly
+ * shipping it into the data plane and the telemetry stream behind it.
+ *
+ * `labels` is customer-supplied cost-attribution metadata (a team name, a
+ * feature flag). It is echoed on the receipt, so it must never be used for
+ * anything the customer would not want to read back to themselves.
+ */
+export declare const clientRequestMetadataSchema: z.ZodObject<{
+    /** The public dialect the customer called. The response is rendered in it. */
+    apiFormat: z.ZodEnum<["responses", "chat_completions", "embeddings", "images_generations", "audio_transcriptions", "audio_speech", "rerank", "batches"]>;
+    /** The public path, e.g. `/v1/responses`. */
+    endpoint: z.ZodString;
+    /** The customer's own correlation id, when they sent one. */
+    clientRequestId: z.ZodOptional<z.ZodString>;
+    receivedAt: z.ZodString;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strict", z.ZodTypeAny, {
+    receivedAt: string;
+    apiFormat: "embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches";
+    endpoint: string;
+    clientRequestId?: string | undefined;
+    labels?: Record<string, string> | undefined;
+}, {
+    receivedAt: string;
+    apiFormat: "embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches";
+    endpoint: string;
+    clientRequestId?: string | undefined;
+    labels?: Record<string, string> | undefined;
+}>;
+/**
+ * The canonical internal request Oxy forwards to the data plane.
+ *
+ * `target` distinguishes the two questions a caller can ask — "serve THIS
+ * model" versus "choose one for me" — structurally. Everything downstream that
+ * must not silently substitute a model reads that discriminant rather than
+ * inferring intent from a string.
+ */
+export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
+    /** See `version.ts`: this is the Oxy→data-plane request envelope. */
+    schemaVersion: z.ZodLiteral<2>;
+    attribution: z.ZodObject<{
+        principal: z.ZodObject<{
+            billing: z.ZodObject<{
+                accountId: z.ZodBranded<z.ZodString, "OxyAccountId">;
+            }, "strict", z.ZodTypeAny, {
+                accountId: string & z.BRAND<"OxyAccountId">;
+            }, {
+                accountId: string;
+            }>;
+            applicationId: z.ZodString;
+            credentialId: z.ZodString;
+            environment: z.ZodEnum<["development", "staging", "production"]>;
+            inferenceScopes: z.ZodArray<z.ZodEnum<["inference:invoke", "inference:models:read", "inference:usage:read", "inference:routing:read", "inference:routing:write", "inference:providers:read", "inference:providers:write"]>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            environment: "development" | "staging" | "production";
+            applicationId: string;
+            credentialId: string;
+            billing: {
+                accountId: string & z.BRAND<"OxyAccountId">;
+            };
+            inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
+        }, {
+            environment: "development" | "staging" | "production";
+            applicationId: string;
+            credentialId: string;
+            billing: {
+                accountId: string;
+            };
+            inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
+        }>;
+        userId: z.ZodOptional<z.ZodBranded<z.ZodString, "DelegatedUserId">>;
+        requestId: z.ZodString;
+        generationId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        requestId: string;
+        principal: {
+            environment: "development" | "staging" | "production";
+            applicationId: string;
+            credentialId: string;
+            billing: {
+                accountId: string & z.BRAND<"OxyAccountId">;
+            };
+            inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
+        };
+        userId?: (string & z.BRAND<"DelegatedUserId">) | undefined;
+        generationId?: string | undefined;
+    }, {
+        requestId: string;
+        principal: {
+            environment: "development" | "staging" | "production";
+            applicationId: string;
+            credentialId: string;
+            billing: {
+                accountId: string;
+            };
+            inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
+        };
+        userId?: string | undefined;
+        generationId?: string | undefined;
+    }>;
+    target: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"model">;
+        modelReference: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "model";
+        modelReference: string;
+    }, {
+        kind: "model";
+        modelReference: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"routing_profile_id">;
+        routingProfileId: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "routing_profile_id";
+        routingProfileId: string;
+    }, {
+        kind: "routing_profile_id";
+        routingProfileId: string;
+    }>]>;
+    modality: z.ZodEnum<["text", "image", "audio", "video", "embedding"]>;
+    input: z.ZodDiscriminatedUnion<"format", [z.ZodObject<{
+        format: z.ZodLiteral<"messages">;
+        messages: z.ZodArray<z.ZodEffects<z.ZodObject<{
+            role: z.ZodEnum<["system", "developer", "user", "assistant", "tool"]>;
+            content: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+                type: z.ZodLiteral<"text">;
+                text: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                type: "text";
+                text: string;
+            }, {
+                type: "text";
+                text: string;
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"image">;
+                source: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                    kind: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "url";
+                    url: string;
+                }, {
+                    kind: "url";
+                    url: string;
+                }>, z.ZodObject<{
+                    kind: z.ZodLiteral<"inline">;
+                    mediaType: z.ZodString;
+                    data: z.ZodString;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                }, {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                }>]>;
+                /** Provider-independent hint; providers that ignore it are unaffected. */
+                detail: z.ZodOptional<z.ZodEnum<["auto", "low", "high"]>>;
+            }, "strict", z.ZodTypeAny, {
+                type: "image";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                detail?: "low" | "high" | "auto" | undefined;
+            }, {
+                type: "image";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                detail?: "low" | "high" | "auto" | undefined;
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"audio">;
+                source: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                    kind: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "url";
+                    url: string;
+                }, {
+                    kind: "url";
+                    url: string;
+                }>, z.ZodObject<{
+                    kind: z.ZodLiteral<"inline">;
+                    mediaType: z.ZodString;
+                    data: z.ZodString;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                }, {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                }>]>;
+            }, "strict", z.ZodTypeAny, {
+                type: "audio";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+            }, {
+                type: "audio";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"file">;
+                source: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                    kind: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "url";
+                    url: string;
+                }, {
+                    kind: "url";
+                    url: string;
+                }>, z.ZodObject<{
+                    kind: z.ZodLiteral<"inline">;
+                    mediaType: z.ZodString;
+                    data: z.ZodString;
+                }, "strict", z.ZodTypeAny, {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                }, {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                }>]>;
+                filename: z.ZodOptional<z.ZodString>;
+            }, "strict", z.ZodTypeAny, {
+                type: "file";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                filename?: string | undefined;
+            }, {
+                type: "file";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                filename?: string | undefined;
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"refusal">;
+                text: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                type: "refusal";
+                text: string;
+            }, {
+                type: "refusal";
+                text: string;
+            }>]>, "many">;
+            /** Participant name, where the dialect supports naming participants. */
+            name: z.ZodOptional<z.ZodString>;
+            /** The tool call this message answers. Required on, and only on, `tool`. */
+            toolCallId: z.ZodOptional<z.ZodString>;
+            /** Tool calls the assistant made. Only on `assistant`. */
+            toolCalls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                arguments: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                name: string;
+                id: string;
+                arguments: string;
+            }, {
+                name: string;
+                id: string;
+                arguments: string;
+            }>, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            content: ({
+                type: "text";
+                text: string;
+            } | {
+                type: "image";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                detail?: "low" | "high" | "auto" | undefined;
+            } | {
+                type: "audio";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+            } | {
+                type: "file";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                filename?: string | undefined;
+            } | {
+                type: "refusal";
+                text: string;
+            })[];
+            role: "tool" | "system" | "user" | "developer" | "assistant";
+            name?: string | undefined;
+            toolCallId?: string | undefined;
+            toolCalls?: {
+                name: string;
+                id: string;
+                arguments: string;
+            }[] | undefined;
+        }, {
+            content: ({
+                type: "text";
+                text: string;
+            } | {
+                type: "image";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                detail?: "low" | "high" | "auto" | undefined;
+            } | {
+                type: "audio";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+            } | {
+                type: "file";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                filename?: string | undefined;
+            } | {
+                type: "refusal";
+                text: string;
+            })[];
+            role: "tool" | "system" | "user" | "developer" | "assistant";
+            name?: string | undefined;
+            toolCallId?: string | undefined;
+            toolCalls?: {
+                name: string;
+                id: string;
+                arguments: string;
+            }[] | undefined;
+        }>, {
+            content: ({
+                type: "text";
+                text: string;
+            } | {
+                type: "image";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                detail?: "low" | "high" | "auto" | undefined;
+            } | {
+                type: "audio";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+            } | {
+                type: "file";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                filename?: string | undefined;
+            } | {
+                type: "refusal";
+                text: string;
+            })[];
+            role: "tool" | "system" | "user" | "developer" | "assistant";
+            name?: string | undefined;
+            toolCallId?: string | undefined;
+            toolCalls?: {
+                name: string;
+                id: string;
+                arguments: string;
+            }[] | undefined;
+        }, {
+            content: ({
+                type: "text";
+                text: string;
+            } | {
+                type: "image";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                detail?: "low" | "high" | "auto" | undefined;
+            } | {
+                type: "audio";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+            } | {
+                type: "file";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                filename?: string | undefined;
+            } | {
+                type: "refusal";
+                text: string;
+            })[];
+            role: "tool" | "system" | "user" | "developer" | "assistant";
+            name?: string | undefined;
+            toolCallId?: string | undefined;
+            toolCalls?: {
+                name: string;
+                id: string;
+                arguments: string;
+            }[] | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        format: "messages";
+        messages: {
+            content: ({
+                type: "text";
+                text: string;
+            } | {
+                type: "image";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                detail?: "low" | "high" | "auto" | undefined;
+            } | {
+                type: "audio";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+            } | {
+                type: "file";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                filename?: string | undefined;
+            } | {
+                type: "refusal";
+                text: string;
+            })[];
+            role: "tool" | "system" | "user" | "developer" | "assistant";
+            name?: string | undefined;
+            toolCallId?: string | undefined;
+            toolCalls?: {
+                name: string;
+                id: string;
+                arguments: string;
+            }[] | undefined;
+        }[];
+    }, {
+        format: "messages";
+        messages: {
+            content: ({
+                type: "text";
+                text: string;
+            } | {
+                type: "image";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                detail?: "low" | "high" | "auto" | undefined;
+            } | {
+                type: "audio";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+            } | {
+                type: "file";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                filename?: string | undefined;
+            } | {
+                type: "refusal";
+                text: string;
+            })[];
+            role: "tool" | "system" | "user" | "developer" | "assistant";
+            name?: string | undefined;
+            toolCallId?: string | undefined;
+            toolCalls?: {
+                name: string;
+                id: string;
+                arguments: string;
+            }[] | undefined;
+        }[];
+    }>, z.ZodObject<{
+        format: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        text: string;
+        format: "text";
+    }, {
+        text: string;
+        format: "text";
+    }>, z.ZodObject<{
+        format: z.ZodLiteral<"text_batch">;
+        texts: z.ZodArray<z.ZodString, "many">;
+    }, "strict", z.ZodTypeAny, {
+        format: "text_batch";
+        texts: string[];
+    }, {
+        format: "text_batch";
+        texts: string[];
+    }>]>;
+    stream: z.ZodBoolean;
+    maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+    sampling: z.ZodObject<{
+        temperature: z.ZodOptional<z.ZodNumber>;
+        topP: z.ZodOptional<z.ZodNumber>;
+        topK: z.ZodOptional<z.ZodNumber>;
+        frequencyPenalty: z.ZodOptional<z.ZodNumber>;
+        presencePenalty: z.ZodOptional<z.ZodNumber>;
+        /** A seed makes a request reproducible on providers that honour one. */
+        seed: z.ZodOptional<z.ZodNumber>;
+        stopSequences: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        seed?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        topK?: number | undefined;
+        frequencyPenalty?: number | undefined;
+        presencePenalty?: number | undefined;
+        stopSequences?: string[] | undefined;
+    }, {
+        seed?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        topK?: number | undefined;
+        frequencyPenalty?: number | undefined;
+        presencePenalty?: number | undefined;
+        stopSequences?: string[] | undefined;
+    }>;
+    tools: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        type: z.ZodLiteral<"function">;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        /** Ask the provider to enforce the schema, where it supports enforcement. */
+        strict: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        type: "function";
+        name: string;
+        parameters: Record<string, unknown>;
+        description?: string | undefined;
+        strict?: boolean | undefined;
+    }, {
+        type: "function";
+        name: string;
+        parameters: Record<string, unknown>;
+        description?: string | undefined;
+        strict?: boolean | undefined;
+    }>, "many">>;
+    toolChoice: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["auto", "none", "required"]>, z.ZodObject<{
+        type: z.ZodLiteral<"function">;
+        name: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        type: "function";
+        name: string;
+    }, {
+        type: "function";
+        name: string;
+    }>]>>;
+    responseFormat: z.ZodOptional<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+    }, "strict", z.ZodTypeAny, {
+        type: "text";
+    }, {
+        type: "text";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"json_object">;
+    }, "strict", z.ZodTypeAny, {
+        type: "json_object";
+    }, {
+        type: "json_object";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"json_schema">;
+        name: z.ZodString;
+        schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        strict: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        type: "json_schema";
+        schema: Record<string, unknown>;
+        name: string;
+        strict: boolean;
+    }, {
+        type: "json_schema";
+        schema: Record<string, unknown>;
+        name: string;
+        strict: boolean;
+    }>]>>;
+    client: z.ZodObject<{
+        /** The public dialect the customer called. The response is rendered in it. */
+        apiFormat: z.ZodEnum<["responses", "chat_completions", "embeddings", "images_generations", "audio_transcriptions", "audio_speech", "rerank", "batches"]>;
+        /** The public path, e.g. `/v1/responses`. */
+        endpoint: z.ZodString;
+        /** The customer's own correlation id, when they sent one. */
+        clientRequestId: z.ZodOptional<z.ZodString>;
+        receivedAt: z.ZodString;
+        labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strict", z.ZodTypeAny, {
+        receivedAt: string;
+        apiFormat: "embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches";
+        endpoint: string;
+        clientRequestId?: string | undefined;
+        labels?: Record<string, string> | undefined;
+    }, {
+        receivedAt: string;
+        apiFormat: "embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches";
+        endpoint: string;
+        clientRequestId?: string | undefined;
+        labels?: Record<string, string> | undefined;
+    }>;
+    /** Present when the operation is safe to deduplicate on retry. */
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    /** The exact policy revision this request is served under. */
+    routingPolicy: z.ZodObject<{
+        routingPolicyId: z.ZodString;
+        policyVersion: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        routingPolicyId: string;
+        policyVersion: number;
+    }, {
+        routingPolicyId: string;
+        policyVersion: number;
+    }>;
+    /**
+     * The routes the control plane has already authorized for this request, in
+     * PREFERENCE ORDER. The first entry is the primary route Oxy resolved; the
+     * data plane fails over by taking the next one.
+     *
+     * This is what closes the gap ADR 0010's amendment left open. That amendment
+     * assigns the data plane "failover within the destinations the policy
+     * authorized" — and the envelope named no destinations, so a data plane could
+     * only fail over by re-deriving the customer's policy from values it does not
+     * have. Enumerating the survivors instead means a route switch outside the
+     * policy is impossible BY CONSTRUCTION rather than by two enforcement engines
+     * agreeing in two languages.
+     *
+     * **Absent means no failover is authorized, never "choose freely."** It is
+     * the state every envelope built before this field existed is in, and the
+     * behaviour a data plane that reads no list must already have: resolve the
+     * `target` and serve it or fail. Permission is granted by an ENTRY, so its
+     * absence can only ever narrow, and there is no reading of an absent list
+     * that widens what may be served.
+     *
+     * An EMPTY list is refused rather than treated as that state. `[]` would say
+     * "no route is authorized at all", which contradicts an envelope that was
+     * built to be served, and it is exactly the "permission granted, destination
+     * unnamed" shape `authorizedRouteSchema` exists to make unrepresentable.
+     *
+     * No price rides here. Oxy sized the hold against the most expensive route
+     * the policy permits (`usageReservationRequestSchema.ceilingPriceVersionId`),
+     * and every entry is one that policy permitted, so no failover among them can
+     * exceed it. A per-route price would also be a second authority for ranking,
+     * beside the order this list already carries.
+     */
+    authorizedRoutes: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodDiscriminatedUnion<"substitution", [z.ZodObject<{
+        deploymentId: z.ZodString;
+        modelReference: z.ZodString;
+        provider: z.ZodString;
+        regions: z.ZodArray<z.ZodString, "many">;
+        customerProviderCredential: z.ZodOptional<z.ZodObject<{
+            credentialHandle: z.ZodString;
+            credentialRevision: z.ZodNumber;
+            ownerAccountId: z.ZodBranded<z.ZodString, "OxyAccountId">;
+            connectionId: z.ZodString;
+            environment: z.ZodEnum<["development", "staging", "production"]>;
+        }, "strict", z.ZodTypeAny, {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string & z.BRAND<"OxyAccountId">;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        }, {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        }>>;
+        substitution: z.ZodLiteral<"same_model">;
+    }, "strict", z.ZodTypeAny, {
+        provider: string;
+        modelReference: string;
+        regions: string[];
+        deploymentId: string;
+        substitution: "same_model";
+        customerProviderCredential?: {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string & z.BRAND<"OxyAccountId">;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        } | undefined;
+    }, {
+        provider: string;
+        modelReference: string;
+        regions: string[];
+        deploymentId: string;
+        substitution: "same_model";
+        customerProviderCredential?: {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        } | undefined;
+    }>, z.ZodObject<{
+        authorizedByPolicy: z.ZodLiteral<true>;
+        deploymentId: z.ZodString;
+        modelReference: z.ZodString;
+        provider: z.ZodString;
+        regions: z.ZodArray<z.ZodString, "many">;
+        customerProviderCredential: z.ZodOptional<z.ZodObject<{
+            credentialHandle: z.ZodString;
+            credentialRevision: z.ZodNumber;
+            ownerAccountId: z.ZodBranded<z.ZodString, "OxyAccountId">;
+            connectionId: z.ZodString;
+            environment: z.ZodEnum<["development", "staging", "production"]>;
+        }, "strict", z.ZodTypeAny, {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string & z.BRAND<"OxyAccountId">;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        }, {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        }>>;
+        substitution: z.ZodLiteral<"cross_model">;
+    }, "strict", z.ZodTypeAny, {
+        provider: string;
+        modelReference: string;
+        regions: string[];
+        deploymentId: string;
+        substitution: "cross_model";
+        authorizedByPolicy: true;
+        customerProviderCredential?: {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string & z.BRAND<"OxyAccountId">;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        } | undefined;
+    }, {
+        provider: string;
+        modelReference: string;
+        regions: string[];
+        deploymentId: string;
+        substitution: "cross_model";
+        authorizedByPolicy: true;
+        customerProviderCredential?: {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        } | undefined;
+    }>]>, {
+        provider: string;
+        modelReference: string;
+        regions: string[];
+        deploymentId: string;
+        substitution: "same_model";
+        customerProviderCredential?: {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string & z.BRAND<"OxyAccountId">;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        } | undefined;
+    } | {
+        provider: string;
+        modelReference: string;
+        regions: string[];
+        deploymentId: string;
+        substitution: "cross_model";
+        authorizedByPolicy: true;
+        customerProviderCredential?: {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string & z.BRAND<"OxyAccountId">;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        } | undefined;
+    }, {
+        provider: string;
+        modelReference: string;
+        regions: string[];
+        deploymentId: string;
+        substitution: "same_model";
+        customerProviderCredential?: {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        } | undefined;
+    } | {
+        provider: string;
+        modelReference: string;
+        regions: string[];
+        deploymentId: string;
+        substitution: "cross_model";
+        authorizedByPolicy: true;
+        customerProviderCredential?: {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        } | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: 2;
+    tools: {
+        type: "function";
+        name: string;
+        parameters: Record<string, unknown>;
+        description?: string | undefined;
+        strict?: boolean | undefined;
+    }[];
+    attribution: {
+        requestId: string;
+        principal: {
+            environment: "development" | "staging" | "production";
+            applicationId: string;
+            credentialId: string;
+            billing: {
+                accountId: string & z.BRAND<"OxyAccountId">;
+            };
+            inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
+        };
+        userId?: (string & z.BRAND<"DelegatedUserId">) | undefined;
+        generationId?: string | undefined;
+    };
+    target: {
+        kind: "model";
+        modelReference: string;
+    } | {
+        kind: "routing_profile_id";
+        routingProfileId: string;
+    };
+    modality: "image" | "text" | "audio" | "video" | "embedding";
+    input: {
+        format: "messages";
+        messages: {
+            content: ({
+                type: "text";
+                text: string;
+            } | {
+                type: "image";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                detail?: "low" | "high" | "auto" | undefined;
+            } | {
+                type: "audio";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+            } | {
+                type: "file";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                filename?: string | undefined;
+            } | {
+                type: "refusal";
+                text: string;
+            })[];
+            role: "tool" | "system" | "user" | "developer" | "assistant";
+            name?: string | undefined;
+            toolCallId?: string | undefined;
+            toolCalls?: {
+                name: string;
+                id: string;
+                arguments: string;
+            }[] | undefined;
+        }[];
+    } | {
+        text: string;
+        format: "text";
+    } | {
+        format: "text_batch";
+        texts: string[];
+    };
+    stream: boolean;
+    sampling: {
+        seed?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        topK?: number | undefined;
+        frequencyPenalty?: number | undefined;
+        presencePenalty?: number | undefined;
+        stopSequences?: string[] | undefined;
+    };
+    client: {
+        receivedAt: string;
+        apiFormat: "embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches";
+        endpoint: string;
+        clientRequestId?: string | undefined;
+        labels?: Record<string, string> | undefined;
+    };
+    routingPolicy: {
+        routingPolicyId: string;
+        policyVersion: number;
+    };
+    idempotencyKey?: string | undefined;
+    maxOutputTokens?: number | undefined;
+    toolChoice?: "none" | "required" | "auto" | {
+        type: "function";
+        name: string;
+    } | undefined;
+    responseFormat?: {
+        type: "text";
+    } | {
+        type: "json_object";
+    } | {
+        type: "json_schema";
+        schema: Record<string, unknown>;
+        name: string;
+        strict: boolean;
+    } | undefined;
+    authorizedRoutes?: ({
+        provider: string;
+        modelReference: string;
+        regions: string[];
+        deploymentId: string;
+        substitution: "same_model";
+        customerProviderCredential?: {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string & z.BRAND<"OxyAccountId">;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        } | undefined;
+    } | {
+        provider: string;
+        modelReference: string;
+        regions: string[];
+        deploymentId: string;
+        substitution: "cross_model";
+        authorizedByPolicy: true;
+        customerProviderCredential?: {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string & z.BRAND<"OxyAccountId">;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        } | undefined;
+    })[] | undefined;
+}, {
+    schemaVersion: 2;
+    attribution: {
+        requestId: string;
+        principal: {
+            environment: "development" | "staging" | "production";
+            applicationId: string;
+            credentialId: string;
+            billing: {
+                accountId: string;
+            };
+            inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
+        };
+        userId?: string | undefined;
+        generationId?: string | undefined;
+    };
+    target: {
+        kind: "model";
+        modelReference: string;
+    } | {
+        kind: "routing_profile_id";
+        routingProfileId: string;
+    };
+    modality: "image" | "text" | "audio" | "video" | "embedding";
+    input: {
+        format: "messages";
+        messages: {
+            content: ({
+                type: "text";
+                text: string;
+            } | {
+                type: "image";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                detail?: "low" | "high" | "auto" | undefined;
+            } | {
+                type: "audio";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+            } | {
+                type: "file";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                filename?: string | undefined;
+            } | {
+                type: "refusal";
+                text: string;
+            })[];
+            role: "tool" | "system" | "user" | "developer" | "assistant";
+            name?: string | undefined;
+            toolCallId?: string | undefined;
+            toolCalls?: {
+                name: string;
+                id: string;
+                arguments: string;
+            }[] | undefined;
+        }[];
+    } | {
+        text: string;
+        format: "text";
+    } | {
+        format: "text_batch";
+        texts: string[];
+    };
+    stream: boolean;
+    sampling: {
+        seed?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        topK?: number | undefined;
+        frequencyPenalty?: number | undefined;
+        presencePenalty?: number | undefined;
+        stopSequences?: string[] | undefined;
+    };
+    client: {
+        receivedAt: string;
+        apiFormat: "embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches";
+        endpoint: string;
+        clientRequestId?: string | undefined;
+        labels?: Record<string, string> | undefined;
+    };
+    routingPolicy: {
+        routingPolicyId: string;
+        policyVersion: number;
+    };
+    tools?: {
+        type: "function";
+        name: string;
+        parameters: Record<string, unknown>;
+        description?: string | undefined;
+        strict?: boolean | undefined;
+    }[] | undefined;
+    idempotencyKey?: string | undefined;
+    maxOutputTokens?: number | undefined;
+    toolChoice?: "none" | "required" | "auto" | {
+        type: "function";
+        name: string;
+    } | undefined;
+    responseFormat?: {
+        type: "text";
+    } | {
+        type: "json_object";
+    } | {
+        type: "json_schema";
+        schema: Record<string, unknown>;
+        name: string;
+        strict: boolean;
+    } | undefined;
+    authorizedRoutes?: ({
+        provider: string;
+        modelReference: string;
+        regions: string[];
+        deploymentId: string;
+        substitution: "same_model";
+        customerProviderCredential?: {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        } | undefined;
+    } | {
+        provider: string;
+        modelReference: string;
+        regions: string[];
+        deploymentId: string;
+        substitution: "cross_model";
+        authorizedByPolicy: true;
+        customerProviderCredential?: {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        } | undefined;
+    })[] | undefined;
+}>, {
+    schemaVersion: 2;
+    tools: {
+        type: "function";
+        name: string;
+        parameters: Record<string, unknown>;
+        description?: string | undefined;
+        strict?: boolean | undefined;
+    }[];
+    attribution: {
+        requestId: string;
+        principal: {
+            environment: "development" | "staging" | "production";
+            applicationId: string;
+            credentialId: string;
+            billing: {
+                accountId: string & z.BRAND<"OxyAccountId">;
+            };
+            inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
+        };
+        userId?: (string & z.BRAND<"DelegatedUserId">) | undefined;
+        generationId?: string | undefined;
+    };
+    target: {
+        kind: "model";
+        modelReference: string;
+    } | {
+        kind: "routing_profile_id";
+        routingProfileId: string;
+    };
+    modality: "image" | "text" | "audio" | "video" | "embedding";
+    input: {
+        format: "messages";
+        messages: {
+            content: ({
+                type: "text";
+                text: string;
+            } | {
+                type: "image";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                detail?: "low" | "high" | "auto" | undefined;
+            } | {
+                type: "audio";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+            } | {
+                type: "file";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                filename?: string | undefined;
+            } | {
+                type: "refusal";
+                text: string;
+            })[];
+            role: "tool" | "system" | "user" | "developer" | "assistant";
+            name?: string | undefined;
+            toolCallId?: string | undefined;
+            toolCalls?: {
+                name: string;
+                id: string;
+                arguments: string;
+            }[] | undefined;
+        }[];
+    } | {
+        text: string;
+        format: "text";
+    } | {
+        format: "text_batch";
+        texts: string[];
+    };
+    stream: boolean;
+    sampling: {
+        seed?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        topK?: number | undefined;
+        frequencyPenalty?: number | undefined;
+        presencePenalty?: number | undefined;
+        stopSequences?: string[] | undefined;
+    };
+    client: {
+        receivedAt: string;
+        apiFormat: "embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches";
+        endpoint: string;
+        clientRequestId?: string | undefined;
+        labels?: Record<string, string> | undefined;
+    };
+    routingPolicy: {
+        routingPolicyId: string;
+        policyVersion: number;
+    };
+    idempotencyKey?: string | undefined;
+    maxOutputTokens?: number | undefined;
+    toolChoice?: "none" | "required" | "auto" | {
+        type: "function";
+        name: string;
+    } | undefined;
+    responseFormat?: {
+        type: "text";
+    } | {
+        type: "json_object";
+    } | {
+        type: "json_schema";
+        schema: Record<string, unknown>;
+        name: string;
+        strict: boolean;
+    } | undefined;
+    authorizedRoutes?: ({
+        provider: string;
+        modelReference: string;
+        regions: string[];
+        deploymentId: string;
+        substitution: "same_model";
+        customerProviderCredential?: {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string & z.BRAND<"OxyAccountId">;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        } | undefined;
+    } | {
+        provider: string;
+        modelReference: string;
+        regions: string[];
+        deploymentId: string;
+        substitution: "cross_model";
+        authorizedByPolicy: true;
+        customerProviderCredential?: {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string & z.BRAND<"OxyAccountId">;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        } | undefined;
+    })[] | undefined;
+}, {
+    schemaVersion: 2;
+    attribution: {
+        requestId: string;
+        principal: {
+            environment: "development" | "staging" | "production";
+            applicationId: string;
+            credentialId: string;
+            billing: {
+                accountId: string;
+            };
+            inferenceScopes: ("inference:invoke" | "inference:models:read" | "inference:usage:read" | "inference:routing:read" | "inference:routing:write" | "inference:providers:read" | "inference:providers:write")[];
+        };
+        userId?: string | undefined;
+        generationId?: string | undefined;
+    };
+    target: {
+        kind: "model";
+        modelReference: string;
+    } | {
+        kind: "routing_profile_id";
+        routingProfileId: string;
+    };
+    modality: "image" | "text" | "audio" | "video" | "embedding";
+    input: {
+        format: "messages";
+        messages: {
+            content: ({
+                type: "text";
+                text: string;
+            } | {
+                type: "image";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                detail?: "low" | "high" | "auto" | undefined;
+            } | {
+                type: "audio";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+            } | {
+                type: "file";
+                source: {
+                    kind: "url";
+                    url: string;
+                } | {
+                    kind: "inline";
+                    data: string;
+                    mediaType: string;
+                };
+                filename?: string | undefined;
+            } | {
+                type: "refusal";
+                text: string;
+            })[];
+            role: "tool" | "system" | "user" | "developer" | "assistant";
+            name?: string | undefined;
+            toolCallId?: string | undefined;
+            toolCalls?: {
+                name: string;
+                id: string;
+                arguments: string;
+            }[] | undefined;
+        }[];
+    } | {
+        text: string;
+        format: "text";
+    } | {
+        format: "text_batch";
+        texts: string[];
+    };
+    stream: boolean;
+    sampling: {
+        seed?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        topK?: number | undefined;
+        frequencyPenalty?: number | undefined;
+        presencePenalty?: number | undefined;
+        stopSequences?: string[] | undefined;
+    };
+    client: {
+        receivedAt: string;
+        apiFormat: "embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches";
+        endpoint: string;
+        clientRequestId?: string | undefined;
+        labels?: Record<string, string> | undefined;
+    };
+    routingPolicy: {
+        routingPolicyId: string;
+        policyVersion: number;
+    };
+    tools?: {
+        type: "function";
+        name: string;
+        parameters: Record<string, unknown>;
+        description?: string | undefined;
+        strict?: boolean | undefined;
+    }[] | undefined;
+    idempotencyKey?: string | undefined;
+    maxOutputTokens?: number | undefined;
+    toolChoice?: "none" | "required" | "auto" | {
+        type: "function";
+        name: string;
+    } | undefined;
+    responseFormat?: {
+        type: "text";
+    } | {
+        type: "json_object";
+    } | {
+        type: "json_schema";
+        schema: Record<string, unknown>;
+        name: string;
+        strict: boolean;
+    } | undefined;
+    authorizedRoutes?: ({
+        provider: string;
+        modelReference: string;
+        regions: string[];
+        deploymentId: string;
+        substitution: "same_model";
+        customerProviderCredential?: {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        } | undefined;
+    } | {
+        provider: string;
+        modelReference: string;
+        regions: string[];
+        deploymentId: string;
+        substitution: "cross_model";
+        authorizedByPolicy: true;
+        customerProviderCredential?: {
+            environment: "development" | "staging" | "production";
+            ownerAccountId: string;
+            connectionId: string;
+            credentialHandle: string;
+            credentialRevision: number;
+        } | undefined;
+    })[] | undefined;
+}>;
+export type InferenceContentSource = z.infer<typeof inferenceContentSourceSchema>;
+export type InferenceContentPart = z.infer<typeof inferenceContentPartSchema>;
+export type InferenceToolCall = z.infer<typeof inferenceToolCallSchema>;
+export type InferenceMessageRole = z.infer<typeof inferenceMessageRoleSchema>;
+export type InferenceMessage = z.infer<typeof inferenceMessageSchema>;
+export type InferenceInput = z.infer<typeof inferenceInputSchema>;
+export type SamplingParameters = z.infer<typeof samplingParametersSchema>;
+export type ToolDefinition = z.infer<typeof toolDefinitionSchema>;
+export type ToolChoice = z.infer<typeof toolChoiceSchema>;
+export type ResponseFormat = z.infer<typeof responseFormatSchema>;
+export type ClientRequestMetadata = z.infer<typeof clientRequestMetadataSchema>;
+export type InferenceRequest = z.infer<typeof inferenceRequestSchema>;