@oxyhq/contracts 0.26.0 → 0.28.0

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

@@ -0,0 +1,2364 @@
+/**
+ * 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 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.
+ *
+ * Decided in: docs/adr/0010-public-api-compatibility.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. */
+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;
+}>]>;
+/**
+ * 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;
+    }>]>, "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;
+    })[];
+    role: "system" | "user" | "developer" | "assistant" | "tool";
+    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;
+    })[];
+    role: "system" | "user" | "developer" | "assistant" | "tool";
+    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;
+    })[];
+    role: "system" | "user" | "developer" | "assistant" | "tool";
+    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;
+    })[];
+    role: "system" | "user" | "developer" | "assistant" | "tool";
+    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;
+        }>]>, "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;
+        })[];
+        role: "system" | "user" | "developer" | "assistant" | "tool";
+        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;
+        })[];
+        role: "system" | "user" | "developer" | "assistant" | "tool";
+        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;
+        })[];
+        role: "system" | "user" | "developer" | "assistant" | "tool";
+        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;
+        })[];
+        role: "system" | "user" | "developer" | "assistant" | "tool";
+        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;
+        })[];
+        role: "system" | "user" | "developer" | "assistant" | "tool";
+        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;
+        })[];
+        role: "system" | "user" | "developer" | "assistant" | "tool";
+        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";
+    name: string;
+    strict: boolean;
+    schema: Record<string, unknown>;
+}, {
+    type: "json_schema";
+    name: string;
+    strict: boolean;
+    schema: Record<string, unknown>;
+}>]>;
+/**
+ * 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, {
+    apiFormat: "embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches";
+    endpoint: string;
+    receivedAt: string;
+    clientRequestId?: string | undefined;
+    labels?: Record<string, string> | undefined;
+}, {
+    apiFormat: "embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches";
+    endpoint: string;
+    receivedAt: 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<1>;
+    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";
+            credentialId: string;
+            applicationId: 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";
+            credentialId: string;
+            applicationId: 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";
+            credentialId: string;
+            applicationId: 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";
+            credentialId: string;
+            applicationId: 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">;
+        routingProfile: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "routing_profile";
+        routingProfile: string;
+    }, {
+        kind: "routing_profile";
+        routingProfile: 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;
+            }>]>, "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;
+            })[];
+            role: "system" | "user" | "developer" | "assistant" | "tool";
+            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;
+            })[];
+            role: "system" | "user" | "developer" | "assistant" | "tool";
+            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;
+            })[];
+            role: "system" | "user" | "developer" | "assistant" | "tool";
+            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;
+            })[];
+            role: "system" | "user" | "developer" | "assistant" | "tool";
+            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;
+            })[];
+            role: "system" | "user" | "developer" | "assistant" | "tool";
+            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;
+            })[];
+            role: "system" | "user" | "developer" | "assistant" | "tool";
+            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";
+        name: string;
+        strict: boolean;
+        schema: Record<string, unknown>;
+    }, {
+        type: "json_schema";
+        name: string;
+        strict: boolean;
+        schema: Record<string, unknown>;
+    }>]>>;
+    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, {
+        apiFormat: "embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches";
+        endpoint: string;
+        receivedAt: string;
+        clientRequestId?: string | undefined;
+        labels?: Record<string, string> | undefined;
+    }, {
+        apiFormat: "embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches";
+        endpoint: string;
+        receivedAt: 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;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    attribution: {
+        requestId: string;
+        principal: {
+            environment: "development" | "staging" | "production";
+            credentialId: string;
+            applicationId: 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;
+    };
+    schemaVersion: 1;
+    tools: {
+        type: "function";
+        name: string;
+        parameters: Record<string, unknown>;
+        description?: string | undefined;
+        strict?: boolean | undefined;
+    }[];
+    target: {
+        kind: "model";
+        modelReference: string;
+    } | {
+        kind: "routing_profile";
+        routingProfile: 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;
+            })[];
+            role: "system" | "user" | "developer" | "assistant" | "tool";
+            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: {
+        apiFormat: "embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches";
+        endpoint: string;
+        receivedAt: string;
+        clientRequestId?: string | undefined;
+        labels?: Record<string, string> | undefined;
+    };
+    routingPolicy: {
+        routingPolicyId: string;
+        policyVersion: number;
+    };
+    idempotencyKey?: string | undefined;
+    maxOutputTokens?: number | undefined;
+    toolChoice?: "none" | "auto" | "required" | {
+        type: "function";
+        name: string;
+    } | undefined;
+    responseFormat?: {
+        type: "text";
+    } | {
+        type: "json_object";
+    } | {
+        type: "json_schema";
+        name: string;
+        strict: boolean;
+        schema: Record<string, unknown>;
+    } | undefined;
+}, {
+    attribution: {
+        requestId: string;
+        principal: {
+            environment: "development" | "staging" | "production";
+            credentialId: string;
+            applicationId: 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;
+    };
+    schemaVersion: 1;
+    target: {
+        kind: "model";
+        modelReference: string;
+    } | {
+        kind: "routing_profile";
+        routingProfile: 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;
+            })[];
+            role: "system" | "user" | "developer" | "assistant" | "tool";
+            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: {
+        apiFormat: "embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches";
+        endpoint: string;
+        receivedAt: string;
+        clientRequestId?: string | undefined;
+        labels?: Record<string, string> | undefined;
+    };
+    routingPolicy: {
+        routingPolicyId: string;
+        policyVersion: number;
+    };
+    idempotencyKey?: string | undefined;
+    tools?: {
+        type: "function";
+        name: string;
+        parameters: Record<string, unknown>;
+        description?: string | undefined;
+        strict?: boolean | undefined;
+    }[] | undefined;
+    maxOutputTokens?: number | undefined;
+    toolChoice?: "none" | "auto" | "required" | {
+        type: "function";
+        name: string;
+    } | undefined;
+    responseFormat?: {
+        type: "text";
+    } | {
+        type: "json_object";
+    } | {
+        type: "json_schema";
+        name: string;
+        strict: boolean;
+        schema: Record<string, unknown>;
+    } | undefined;
+}>, {
+    attribution: {
+        requestId: string;
+        principal: {
+            environment: "development" | "staging" | "production";
+            credentialId: string;
+            applicationId: 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;
+    };
+    schemaVersion: 1;
+    tools: {
+        type: "function";
+        name: string;
+        parameters: Record<string, unknown>;
+        description?: string | undefined;
+        strict?: boolean | undefined;
+    }[];
+    target: {
+        kind: "model";
+        modelReference: string;
+    } | {
+        kind: "routing_profile";
+        routingProfile: 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;
+            })[];
+            role: "system" | "user" | "developer" | "assistant" | "tool";
+            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: {
+        apiFormat: "embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches";
+        endpoint: string;
+        receivedAt: string;
+        clientRequestId?: string | undefined;
+        labels?: Record<string, string> | undefined;
+    };
+    routingPolicy: {
+        routingPolicyId: string;
+        policyVersion: number;
+    };
+    idempotencyKey?: string | undefined;
+    maxOutputTokens?: number | undefined;
+    toolChoice?: "none" | "auto" | "required" | {
+        type: "function";
+        name: string;
+    } | undefined;
+    responseFormat?: {
+        type: "text";
+    } | {
+        type: "json_object";
+    } | {
+        type: "json_schema";
+        name: string;
+        strict: boolean;
+        schema: Record<string, unknown>;
+    } | undefined;
+}, {
+    attribution: {
+        requestId: string;
+        principal: {
+            environment: "development" | "staging" | "production";
+            credentialId: string;
+            applicationId: 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;
+    };
+    schemaVersion: 1;
+    target: {
+        kind: "model";
+        modelReference: string;
+    } | {
+        kind: "routing_profile";
+        routingProfile: 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;
+            })[];
+            role: "system" | "user" | "developer" | "assistant" | "tool";
+            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: {
+        apiFormat: "embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches";
+        endpoint: string;
+        receivedAt: string;
+        clientRequestId?: string | undefined;
+        labels?: Record<string, string> | undefined;
+    };
+    routingPolicy: {
+        routingPolicyId: string;
+        policyVersion: number;
+    };
+    idempotencyKey?: string | undefined;
+    tools?: {
+        type: "function";
+        name: string;
+        parameters: Record<string, unknown>;
+        description?: string | undefined;
+        strict?: boolean | undefined;
+    }[] | undefined;
+    maxOutputTokens?: number | undefined;
+    toolChoice?: "none" | "auto" | "required" | {
+        type: "function";
+        name: string;
+    } | undefined;
+    responseFormat?: {
+        type: "text";
+    } | {
+        type: "json_object";
+    } | {
+        type: "json_schema";
+        name: string;
+        strict: boolean;
+        schema: Record<string, unknown>;
+    } | 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>;