@kaana.ai/contracts 0.0.0-stage → 4.3.0

package/dist/internal/request.d.ts

@@ -0,0 +1,1079 @@
+/**
+ * The signed Oxy→Kaana request envelope (versions 1–4).
+ *
+ * Moved from `@oxy.so/contracts` 4.12.0 (`src/inference/request.ts`) by Kaana ADR 0002.
+ */
+import { z } from 'zod';
+/**
+ * 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<[z.ZodObject<{
+    format: z.ZodLiteral<"decisions">;
+    decisions: z.ZodObject<{
+        state: z.ZodString;
+        instructions: z.ZodOptional<z.ZodString>;
+        questions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"choice">;
+            options: z.ZodArray<z.ZodString>;
+            id: z.ZodString;
+            question: z.ZodString;
+            criteria: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"score">;
+            levels: z.ZodArray<z.ZodString>;
+            id: z.ZodString;
+            question: z.ZodString;
+            criteria: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"noul">;
+            id: z.ZodString;
+            question: z.ZodString;
+            criteria: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>], "kind">>;
+        effort: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+            instant: "instant";
+            xhigh: "xhigh";
+        }>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    format: z.ZodLiteral<"messages">;
+    messages: z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<{
+            user: "user";
+            system: "system";
+            developer: "developer";
+            assistant: "assistant";
+            tool: "tool";
+        }>;
+        content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"image">;
+            source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"url">;
+                url: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"inline">;
+                mediaType: z.ZodString;
+                data: z.ZodString;
+            }, z.core.$strict>], "kind">;
+            detail: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                high: "high";
+                auto: "auto";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"audio">;
+            source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"url">;
+                url: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"inline">;
+                mediaType: z.ZodString;
+                data: z.ZodString;
+            }, z.core.$strict>], "kind">;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"file">;
+            source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"url">;
+                url: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"inline">;
+                mediaType: z.ZodString;
+                data: z.ZodString;
+            }, z.core.$strict>], "kind">;
+            filename: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"refusal">;
+            text: z.ZodString;
+        }, z.core.$strict>], "type">>;
+        name: z.ZodOptional<z.ZodString>;
+        toolCallId: z.ZodOptional<z.ZodString>;
+        toolCalls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            arguments: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    format: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    format: z.ZodLiteral<"text_batch">;
+    texts: z.ZodArray<z.ZodString>;
+}, z.core.$strict>], "format">;
+/**
+ * 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<{
+    apiFormat: z.ZodEnum<{
+        embeddings: "embeddings";
+        decisions: "decisions";
+        responses: "responses";
+        chat_completions: "chat_completions";
+        images_generations: "images_generations";
+        audio_transcriptions: "audio_transcriptions";
+        audio_speech: "audio_speech";
+        rerank: "rerank";
+        batches: "batches";
+    }>;
+    endpoint: z.ZodString;
+    clientRequestId: z.ZodOptional<z.ZodString>;
+    receivedAt: z.ZodString;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strict>;
+export declare const inferenceRequestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    scopedExecution: z.ZodOptional<z.ZodObject<{
+        permitId: z.ZodString;
+        idempotencyKey: z.ZodString;
+        fixtureSha256: z.ZodString;
+        expiresAt: z.ZodString;
+        principal: z.ZodObject<{
+            accountId: z.ZodString;
+            applicationId: z.ZodString;
+            credentialId: z.ZodString;
+            environment: z.ZodEnum<{
+                development: "development";
+                staging: "staging";
+                production: "production";
+            }>;
+        }, z.core.$strict>;
+        policy: z.ZodObject<{
+            routingPolicyId: z.ZodString;
+            policyVersion: z.ZodNumber;
+        }, z.core.$strict>;
+        deploymentId: z.ZodString;
+        provider: z.ZodString;
+        keyId: z.ZodString;
+        modelReference: z.ZodString;
+        upstreamModelId: z.ZodString;
+        priceVersionId: z.ZodString;
+        providerRateCardVersionId: z.ZodString;
+        providerSourceVersion: z.ZodString;
+        maxCostUsd: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
+        requestId: z.ZodString;
+        snapshotId: z.ZodString;
+        catalogueEvidenceHash: z.ZodString;
+    }, z.core.$strict>>;
+    attribution: z.ZodObject<{
+        principal: z.ZodObject<{
+            billing: z.ZodObject<{
+                accountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
+            }, z.core.$strict>;
+            applicationId: z.ZodString;
+            credentialId: z.ZodString;
+            environment: z.ZodEnum<{
+                development: "development";
+                staging: "staging";
+                production: "production";
+            }>;
+            inferenceScopes: z.ZodArray<z.ZodEnum<{
+                "inference:invoke": "inference:invoke";
+                "inference:models:read": "inference:models:read";
+                "inference:usage:read": "inference:usage:read";
+                "inference:routing:read": "inference:routing:read";
+                "inference:routing:write": "inference:routing:write";
+                "inference:providers:read": "inference:providers:read";
+                "inference:providers:write": "inference:providers:write";
+            }>>;
+        }, z.core.$strip>;
+        userId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "DelegatedUserId", "out">>;
+        requestId: z.ZodString;
+        generationId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"model">;
+        modelReference: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"routing_profile_id">;
+        routingProfileId: z.ZodString;
+    }, z.core.$strict>], "kind">;
+    modality: z.ZodEnum<{
+        text: "text";
+        audio: "audio";
+        image: "image";
+        video: "video";
+        embedding: "embedding";
+    }>;
+    input: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        format: z.ZodLiteral<"decisions">;
+        decisions: z.ZodObject<{
+            state: z.ZodString;
+            instructions: z.ZodOptional<z.ZodString>;
+            questions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"choice">;
+                options: z.ZodArray<z.ZodString>;
+                id: z.ZodString;
+                question: z.ZodString;
+                criteria: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"score">;
+                levels: z.ZodArray<z.ZodString>;
+                id: z.ZodString;
+                question: z.ZodString;
+                criteria: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"noul">;
+                id: z.ZodString;
+                question: z.ZodString;
+                criteria: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>], "kind">>;
+            effort: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                instant: "instant";
+                xhigh: "xhigh";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        format: z.ZodLiteral<"messages">;
+        messages: z.ZodArray<z.ZodObject<{
+            role: z.ZodEnum<{
+                user: "user";
+                system: "system";
+                developer: "developer";
+                assistant: "assistant";
+                tool: "tool";
+            }>;
+            content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"text">;
+                text: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"image">;
+                source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"inline">;
+                    mediaType: z.ZodString;
+                    data: z.ZodString;
+                }, z.core.$strict>], "kind">;
+                detail: z.ZodOptional<z.ZodEnum<{
+                    low: "low";
+                    high: "high";
+                    auto: "auto";
+                }>>;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"audio">;
+                source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"inline">;
+                    mediaType: z.ZodString;
+                    data: z.ZodString;
+                }, z.core.$strict>], "kind">;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"file">;
+                source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"inline">;
+                    mediaType: z.ZodString;
+                    data: z.ZodString;
+                }, z.core.$strict>], "kind">;
+                filename: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"refusal">;
+                text: z.ZodString;
+            }, z.core.$strict>], "type">>;
+            name: z.ZodOptional<z.ZodString>;
+            toolCallId: z.ZodOptional<z.ZodString>;
+            toolCalls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                arguments: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        format: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        format: z.ZodLiteral<"text_batch">;
+        texts: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>], "format">;
+    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>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        stopSequences: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>;
+    reasoning: z.ZodOptional<z.ZodObject<{
+        effort: z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>;
+    }, z.core.$strict>>;
+    speech: z.ZodOptional<z.ZodObject<{
+        voice: z.ZodString;
+        responseFormat: z.ZodEnum<{
+            mp3: "mp3";
+            opus: "opus";
+            aac: "aac";
+            flac: "flac";
+            wav: "wav";
+            pcm: "pcm";
+        }>;
+        speed: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    audioOutput: z.ZodOptional<z.ZodObject<{
+        voice: z.ZodString;
+        format: z.ZodEnum<{
+            mp3: "mp3";
+            opus: "opus";
+            flac: "flac";
+            wav: "wav";
+            pcm: "pcm";
+        }>;
+    }, z.core.$strict>>;
+    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>;
+        strict: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    toolChoice: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        auto: "auto";
+        none: "none";
+        required: "required";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"function">;
+        name: z.ZodString;
+    }, z.core.$strict>]>>;
+    responseFormat: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"json_object">;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"json_schema">;
+        name: z.ZodString;
+        schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        strict: z.ZodBoolean;
+    }, z.core.$strict>], "type">>;
+    client: z.ZodObject<{
+        apiFormat: z.ZodEnum<{
+            embeddings: "embeddings";
+            decisions: "decisions";
+            responses: "responses";
+            chat_completions: "chat_completions";
+            images_generations: "images_generations";
+            audio_transcriptions: "audio_transcriptions";
+            audio_speech: "audio_speech";
+            rerank: "rerank";
+            batches: "batches";
+        }>;
+        endpoint: z.ZodString;
+        clientRequestId: z.ZodOptional<z.ZodString>;
+        receivedAt: z.ZodString;
+        labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    routingPolicy: z.ZodObject<{
+        routingPolicyId: z.ZodString;
+        policyVersion: z.ZodNumber;
+    }, z.core.$strict>;
+    authorizedRoutes: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        deploymentId: z.ZodString;
+        modelReference: z.ZodString;
+        provider: z.ZodString;
+        regions: z.ZodArray<z.ZodString>;
+        maxFundingTier: z.ZodOptional<z.ZodEnum<{
+            free: "free";
+            credit: "credit";
+            paid: "paid";
+        }>>;
+        customerProviderCredential: z.ZodOptional<z.ZodObject<{
+            credentialHandle: z.ZodString;
+            credentialRevision: z.ZodNumber;
+            ownerAccountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
+            connectionId: z.ZodString;
+            environment: z.ZodEnum<{
+                development: "development";
+                staging: "staging";
+                production: "production";
+            }>;
+        }, z.core.$strict>>;
+        substitution: z.ZodLiteral<"same_model">;
+    }, z.core.$strict>, z.ZodObject<{
+        authorizedByPolicy: z.ZodLiteral<true>;
+        deploymentId: z.ZodString;
+        modelReference: z.ZodString;
+        provider: z.ZodString;
+        regions: z.ZodArray<z.ZodString>;
+        maxFundingTier: z.ZodOptional<z.ZodEnum<{
+            free: "free";
+            credit: "credit";
+            paid: "paid";
+        }>>;
+        customerProviderCredential: z.ZodOptional<z.ZodObject<{
+            credentialHandle: z.ZodString;
+            credentialRevision: z.ZodNumber;
+            ownerAccountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
+            connectionId: z.ZodString;
+            environment: z.ZodEnum<{
+                development: "development";
+                staging: "staging";
+                production: "production";
+            }>;
+        }, z.core.$strict>>;
+        substitution: z.ZodLiteral<"cross_model">;
+    }, z.core.$strict>], "substitution">>>;
+}, z.core.$strip>;
+/** Explicit restrictive generation: old v2 receivers reject this version whole. */
+export declare const scopedInferenceRequestSchema: z.ZodObject<{
+    attribution: z.ZodObject<{
+        principal: z.ZodObject<{
+            billing: z.ZodObject<{
+                accountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
+            }, z.core.$strict>;
+            applicationId: z.ZodString;
+            credentialId: z.ZodString;
+            environment: z.ZodEnum<{
+                development: "development";
+                staging: "staging";
+                production: "production";
+            }>;
+            inferenceScopes: z.ZodArray<z.ZodEnum<{
+                "inference:invoke": "inference:invoke";
+                "inference:models:read": "inference:models:read";
+                "inference:usage:read": "inference:usage:read";
+                "inference:routing:read": "inference:routing:read";
+                "inference:routing:write": "inference:routing:write";
+                "inference:providers:read": "inference:providers:read";
+                "inference:providers:write": "inference:providers:write";
+            }>>;
+        }, z.core.$strip>;
+        userId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "DelegatedUserId", "out">>;
+        requestId: z.ZodString;
+        generationId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"model">;
+        modelReference: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"routing_profile_id">;
+        routingProfileId: z.ZodString;
+    }, z.core.$strict>], "kind">;
+    modality: z.ZodEnum<{
+        text: "text";
+        audio: "audio";
+        image: "image";
+        video: "video";
+        embedding: "embedding";
+    }>;
+    input: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        format: z.ZodLiteral<"decisions">;
+        decisions: z.ZodObject<{
+            state: z.ZodString;
+            instructions: z.ZodOptional<z.ZodString>;
+            questions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"choice">;
+                options: z.ZodArray<z.ZodString>;
+                id: z.ZodString;
+                question: z.ZodString;
+                criteria: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"score">;
+                levels: z.ZodArray<z.ZodString>;
+                id: z.ZodString;
+                question: z.ZodString;
+                criteria: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"noul">;
+                id: z.ZodString;
+                question: z.ZodString;
+                criteria: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>], "kind">>;
+            effort: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                instant: "instant";
+                xhigh: "xhigh";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        format: z.ZodLiteral<"messages">;
+        messages: z.ZodArray<z.ZodObject<{
+            role: z.ZodEnum<{
+                user: "user";
+                system: "system";
+                developer: "developer";
+                assistant: "assistant";
+                tool: "tool";
+            }>;
+            content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"text">;
+                text: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"image">;
+                source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"inline">;
+                    mediaType: z.ZodString;
+                    data: z.ZodString;
+                }, z.core.$strict>], "kind">;
+                detail: z.ZodOptional<z.ZodEnum<{
+                    low: "low";
+                    high: "high";
+                    auto: "auto";
+                }>>;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"audio">;
+                source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"inline">;
+                    mediaType: z.ZodString;
+                    data: z.ZodString;
+                }, z.core.$strict>], "kind">;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"file">;
+                source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"inline">;
+                    mediaType: z.ZodString;
+                    data: z.ZodString;
+                }, z.core.$strict>], "kind">;
+                filename: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"refusal">;
+                text: z.ZodString;
+            }, z.core.$strict>], "type">>;
+            name: z.ZodOptional<z.ZodString>;
+            toolCallId: z.ZodOptional<z.ZodString>;
+            toolCalls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                arguments: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        format: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        format: z.ZodLiteral<"text_batch">;
+        texts: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>], "format">;
+    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>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        stopSequences: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>;
+    reasoning: z.ZodOptional<z.ZodObject<{
+        effort: z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>;
+    }, z.core.$strict>>;
+    speech: z.ZodOptional<z.ZodObject<{
+        voice: z.ZodString;
+        responseFormat: z.ZodEnum<{
+            mp3: "mp3";
+            opus: "opus";
+            aac: "aac";
+            flac: "flac";
+            wav: "wav";
+            pcm: "pcm";
+        }>;
+        speed: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    audioOutput: z.ZodOptional<z.ZodObject<{
+        voice: z.ZodString;
+        format: z.ZodEnum<{
+            mp3: "mp3";
+            opus: "opus";
+            flac: "flac";
+            wav: "wav";
+            pcm: "pcm";
+        }>;
+    }, z.core.$strict>>;
+    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>;
+        strict: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    toolChoice: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        auto: "auto";
+        none: "none";
+        required: "required";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"function">;
+        name: z.ZodString;
+    }, z.core.$strict>]>>;
+    responseFormat: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"json_object">;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"json_schema">;
+        name: z.ZodString;
+        schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        strict: z.ZodBoolean;
+    }, z.core.$strict>], "type">>;
+    client: z.ZodObject<{
+        apiFormat: z.ZodEnum<{
+            embeddings: "embeddings";
+            decisions: "decisions";
+            responses: "responses";
+            chat_completions: "chat_completions";
+            images_generations: "images_generations";
+            audio_transcriptions: "audio_transcriptions";
+            audio_speech: "audio_speech";
+            rerank: "rerank";
+            batches: "batches";
+        }>;
+        endpoint: z.ZodString;
+        clientRequestId: z.ZodOptional<z.ZodString>;
+        receivedAt: z.ZodString;
+        labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    routingPolicy: z.ZodObject<{
+        routingPolicyId: z.ZodString;
+        policyVersion: z.ZodNumber;
+    }, z.core.$strict>;
+    authorizedRoutes: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        deploymentId: z.ZodString;
+        modelReference: z.ZodString;
+        provider: z.ZodString;
+        regions: z.ZodArray<z.ZodString>;
+        maxFundingTier: z.ZodOptional<z.ZodEnum<{
+            free: "free";
+            credit: "credit";
+            paid: "paid";
+        }>>;
+        customerProviderCredential: z.ZodOptional<z.ZodObject<{
+            credentialHandle: z.ZodString;
+            credentialRevision: z.ZodNumber;
+            ownerAccountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
+            connectionId: z.ZodString;
+            environment: z.ZodEnum<{
+                development: "development";
+                staging: "staging";
+                production: "production";
+            }>;
+        }, z.core.$strict>>;
+        substitution: z.ZodLiteral<"same_model">;
+    }, z.core.$strict>, z.ZodObject<{
+        authorizedByPolicy: z.ZodLiteral<true>;
+        deploymentId: z.ZodString;
+        modelReference: z.ZodString;
+        provider: z.ZodString;
+        regions: z.ZodArray<z.ZodString>;
+        maxFundingTier: z.ZodOptional<z.ZodEnum<{
+            free: "free";
+            credit: "credit";
+            paid: "paid";
+        }>>;
+        customerProviderCredential: z.ZodOptional<z.ZodObject<{
+            credentialHandle: z.ZodString;
+            credentialRevision: z.ZodNumber;
+            ownerAccountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
+            connectionId: z.ZodString;
+            environment: z.ZodEnum<{
+                development: "development";
+                staging: "staging";
+                production: "production";
+            }>;
+        }, z.core.$strict>>;
+        substitution: z.ZodLiteral<"cross_model">;
+    }, z.core.$strict>], "substitution">>>;
+    schemaVersion: z.ZodLiteral<3>;
+    scopedExecution: z.ZodObject<{
+        permitId: z.ZodString;
+        idempotencyKey: z.ZodString;
+        fixtureSha256: z.ZodString;
+        expiresAt: z.ZodString;
+        principal: z.ZodObject<{
+            accountId: z.ZodString;
+            applicationId: z.ZodString;
+            credentialId: z.ZodString;
+            environment: z.ZodEnum<{
+                development: "development";
+                staging: "staging";
+                production: "production";
+            }>;
+        }, z.core.$strict>;
+        policy: z.ZodObject<{
+            routingPolicyId: z.ZodString;
+            policyVersion: z.ZodNumber;
+        }, z.core.$strict>;
+        deploymentId: z.ZodString;
+        provider: z.ZodString;
+        keyId: z.ZodString;
+        modelReference: z.ZodString;
+        upstreamModelId: z.ZodString;
+        priceVersionId: z.ZodString;
+        providerRateCardVersionId: z.ZodString;
+        providerSourceVersion: z.ZodString;
+        maxCostUsd: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
+        requestId: z.ZodString;
+        snapshotId: z.ZodString;
+        catalogueEvidenceHash: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strip>;
+/** Private repeated Auto is independently negotiated, never a v3 fixture renewal. */
+export declare const privateAutoInferenceRequestSchema: z.ZodObject<{
+    input: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        format: z.ZodLiteral<"decisions">;
+        decisions: z.ZodObject<{
+            state: z.ZodString;
+            instructions: z.ZodOptional<z.ZodString>;
+            questions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"choice">;
+                options: z.ZodArray<z.ZodString>;
+                id: z.ZodString;
+                question: z.ZodString;
+                criteria: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"score">;
+                levels: z.ZodArray<z.ZodString>;
+                id: z.ZodString;
+                question: z.ZodString;
+                criteria: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"noul">;
+                id: z.ZodString;
+                question: z.ZodString;
+                criteria: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>], "kind">>;
+            effort: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+                instant: "instant";
+                xhigh: "xhigh";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        format: z.ZodLiteral<"messages">;
+        messages: z.ZodArray<z.ZodObject<{
+            role: z.ZodEnum<{
+                user: "user";
+                system: "system";
+                developer: "developer";
+                assistant: "assistant";
+                tool: "tool";
+            }>;
+            content: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"text">;
+                text: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"image">;
+                source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"inline">;
+                    mediaType: z.ZodString;
+                    data: z.ZodString;
+                }, z.core.$strict>], "kind">;
+                detail: z.ZodOptional<z.ZodEnum<{
+                    low: "low";
+                    high: "high";
+                    auto: "auto";
+                }>>;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"audio">;
+                source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"inline">;
+                    mediaType: z.ZodString;
+                    data: z.ZodString;
+                }, z.core.$strict>], "kind">;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"file">;
+                source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"inline">;
+                    mediaType: z.ZodString;
+                    data: z.ZodString;
+                }, z.core.$strict>], "kind">;
+                filename: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"refusal">;
+                text: z.ZodString;
+            }, z.core.$strict>], "type">>;
+            name: z.ZodOptional<z.ZodString>;
+            toolCallId: z.ZodOptional<z.ZodString>;
+            toolCalls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                arguments: z.ZodString;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        format: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        format: z.ZodLiteral<"text_batch">;
+        texts: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>], "format">;
+    reasoning: z.ZodOptional<z.ZodObject<{
+        effort: z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>;
+    }, z.core.$strict>>;
+    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>;
+        strict: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+    stream: z.ZodBoolean;
+    responseFormat: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"json_object">;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"json_schema">;
+        name: z.ZodString;
+        schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        strict: z.ZodBoolean;
+    }, z.core.$strict>], "type">>;
+    toolChoice: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        auto: "auto";
+        none: "none";
+        required: "required";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"function">;
+        name: z.ZodString;
+    }, z.core.$strict>]>>;
+    routingPolicy: z.ZodObject<{
+        routingPolicyId: z.ZodString;
+        policyVersion: z.ZodNumber;
+    }, z.core.$strict>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    attribution: z.ZodObject<{
+        principal: z.ZodObject<{
+            billing: z.ZodObject<{
+                accountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
+            }, z.core.$strict>;
+            applicationId: z.ZodString;
+            credentialId: z.ZodString;
+            environment: z.ZodEnum<{
+                development: "development";
+                staging: "staging";
+                production: "production";
+            }>;
+            inferenceScopes: z.ZodArray<z.ZodEnum<{
+                "inference:invoke": "inference:invoke";
+                "inference:models:read": "inference:models:read";
+                "inference:usage:read": "inference:usage:read";
+                "inference:routing:read": "inference:routing:read";
+                "inference:routing:write": "inference:routing:write";
+                "inference:providers:read": "inference:providers:read";
+                "inference:providers:write": "inference:providers:write";
+            }>>;
+        }, z.core.$strip>;
+        userId: z.ZodOptional<z.core.$ZodBranded<z.ZodString, "DelegatedUserId", "out">>;
+        requestId: z.ZodString;
+        generationId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"model">;
+        modelReference: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"routing_profile_id">;
+        routingProfileId: z.ZodString;
+    }, z.core.$strict>], "kind">;
+    client: z.ZodObject<{
+        apiFormat: z.ZodEnum<{
+            embeddings: "embeddings";
+            decisions: "decisions";
+            responses: "responses";
+            chat_completions: "chat_completions";
+            images_generations: "images_generations";
+            audio_transcriptions: "audio_transcriptions";
+            audio_speech: "audio_speech";
+            rerank: "rerank";
+            batches: "batches";
+        }>;
+        endpoint: z.ZodString;
+        clientRequestId: z.ZodOptional<z.ZodString>;
+        receivedAt: z.ZodString;
+        labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strict>;
+    authorizedRoutes: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        deploymentId: z.ZodString;
+        modelReference: z.ZodString;
+        provider: z.ZodString;
+        regions: z.ZodArray<z.ZodString>;
+        maxFundingTier: z.ZodOptional<z.ZodEnum<{
+            free: "free";
+            credit: "credit";
+            paid: "paid";
+        }>>;
+        customerProviderCredential: z.ZodOptional<z.ZodObject<{
+            credentialHandle: z.ZodString;
+            credentialRevision: z.ZodNumber;
+            ownerAccountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
+            connectionId: z.ZodString;
+            environment: z.ZodEnum<{
+                development: "development";
+                staging: "staging";
+                production: "production";
+            }>;
+        }, z.core.$strict>>;
+        substitution: z.ZodLiteral<"same_model">;
+    }, z.core.$strict>, z.ZodObject<{
+        authorizedByPolicy: z.ZodLiteral<true>;
+        deploymentId: z.ZodString;
+        modelReference: z.ZodString;
+        provider: z.ZodString;
+        regions: z.ZodArray<z.ZodString>;
+        maxFundingTier: z.ZodOptional<z.ZodEnum<{
+            free: "free";
+            credit: "credit";
+            paid: "paid";
+        }>>;
+        customerProviderCredential: z.ZodOptional<z.ZodObject<{
+            credentialHandle: z.ZodString;
+            credentialRevision: z.ZodNumber;
+            ownerAccountId: z.core.$ZodBranded<z.ZodString, "OxyAccountId", "out">;
+            connectionId: z.ZodString;
+            environment: z.ZodEnum<{
+                development: "development";
+                staging: "staging";
+                production: "production";
+            }>;
+        }, z.core.$strict>>;
+        substitution: z.ZodLiteral<"cross_model">;
+    }, z.core.$strict>], "substitution">>>;
+    modality: z.ZodEnum<{
+        text: "text";
+        audio: "audio";
+        image: "image";
+        video: "video";
+        embedding: "embedding";
+    }>;
+    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>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        stopSequences: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>;
+    speech: z.ZodOptional<z.ZodObject<{
+        voice: z.ZodString;
+        responseFormat: z.ZodEnum<{
+            mp3: "mp3";
+            opus: "opus";
+            aac: "aac";
+            flac: "flac";
+            wav: "wav";
+            pcm: "pcm";
+        }>;
+        speed: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    audioOutput: z.ZodOptional<z.ZodObject<{
+        voice: z.ZodString;
+        format: z.ZodEnum<{
+            mp3: "mp3";
+            opus: "opus";
+            flac: "flac";
+            wav: "wav";
+            pcm: "pcm";
+        }>;
+    }, z.core.$strict>>;
+    schemaVersion: z.ZodLiteral<4>;
+    privateAutoExecution: z.ZodObject<{
+        contractVersion: z.ZodLiteral<"3.7.0">;
+        purpose: z.ZodLiteral<"private_auto_classifier">;
+        classifierVersion: z.ZodLiteral<"jev-auto-v1">;
+        approvalId: z.ZodString;
+        approvalVersion: z.ZodNumber;
+        approvalSha256: z.ZodString;
+        parentMeteredUsageId: z.ZodGUID;
+        parentRequestId: z.ZodString;
+        operationId: z.ZodString;
+        requestId: z.ZodString;
+        inputSha256: z.ZodString;
+        expiresAt: z.ZodString;
+        runtimeExpiresAt: z.ZodString;
+        principal: z.ZodObject<{
+            accountId: z.ZodString;
+            applicationId: z.ZodString;
+            credentialId: z.ZodString;
+            environment: z.ZodLiteral<"production">;
+            lane: z.ZodLiteral<"service_token">;
+        }, z.core.$strict>;
+        policy: z.ZodObject<{
+            routingPolicyId: z.ZodString;
+            policyVersion: z.ZodNumber;
+        }, z.core.$strict>;
+        economicPolicyVersion: z.ZodString;
+        economicRelationshipId: z.ZodString;
+        deploymentId: z.ZodString;
+        provider: z.ZodString;
+        keyId: z.ZodString;
+        modelReference: z.ZodString;
+        upstreamModelId: z.ZodString;
+        regions: z.ZodArray<z.ZodString>;
+        priceVersionId: z.ZodString;
+        providerRateCardVersionId: z.ZodString;
+        providerSourceVersion: z.ZodString;
+        maxCostUsd: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
+        snapshotId: z.ZodString;
+        catalogueEvidenceHash: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ScopedInferenceRequest = z.infer<typeof scopedInferenceRequestSchema>;
+export type PrivateAutoInferenceRequest = z.infer<typeof privateAutoInferenceRequestSchema>;
+export type InferenceInput = z.infer<typeof inferenceInputSchema>;
+export type ClientRequestMetadata = z.infer<typeof clientRequestMetadataSchema>;
+export type InferenceRequest = z.infer<typeof inferenceRequestSchema>;