@oxyhq/contracts 0.26.0 → 0.28.0

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

@@ -0,0 +1,1612 @@
+/**
+ * The canonical model catalogue.
+ *
+ * Six things are kept DISTINCT here, because collapsing any pair of them is how
+ * a catalogue starts lying to customers:
+ *
+ *  1. **Publisher** — who released the model (`openai`, `meta`, `alia`).
+ *  2. **Model** — a long-lived product identity, `<publisher>/<model>`. Its
+ *     behaviour changes over time as revisions ship.
+ *  3. **Model revision** — an IMMUTABLE point in that history,
+ *     `<publisher>/<model>@<revision>`. This is what an evaluation result, a
+ *     model card and an artifact digest actually describe.
+ *  4. **Inference provider** — who runs the weights (a third party, Oxy's own
+ *     hosting, or the customer's own account under BYOK).
+ *  5. **Deployment/endpoint** — one concrete servable route: a revision, on a
+ *     provider, in a region, under a data policy, with a commercial permission.
+ *  6. **Routing profile** — a named strategy for CHOOSING among routes
+ *     (`auto`, `fast`, `quality`). A profile is not a model; it has no weights,
+ *     no revision and no license, and it is never written in the shape of a
+ *     model id.
+ *
+ * `modelCatalogueEntrySchema` is the customer-safe projection Oxy serves from
+ * `GET /v1/models`: it repeats the customer-facing fields rather than embedding
+ * the operational descriptors, so internal deployment ids, upstream wholesale
+ * costs and route health can never reach it by accident of nesting.
+ *
+ * Decided in: docs/adr/0008-catalogue-concept-separation.md.
+ */
+import { z } from 'zod';
+/** The modalities a model can consume or produce. */
+export declare const inferenceModalitySchema: z.ZodEnum<["text", "image", "audio", "video", "embedding"]>;
+/**
+ * What a model can do, in the terms a caller has to decide against before
+ * sending a request: can it call tools, does it accept images, will it honour a
+ * JSON schema, how much context does it take, how much can it emit.
+ */
+export declare const modelCapabilitiesSchema: z.ZodObject<{
+    inputModalities: z.ZodArray<z.ZodEnum<["text", "image", "audio", "video", "embedding"]>, "many">;
+    outputModalities: z.ZodArray<z.ZodEnum<["text", "image", "audio", "video", "embedding"]>, "many">;
+    tools: z.ZodBoolean;
+    parallelToolCalls: z.ZodBoolean;
+    structuredOutput: z.ZodBoolean;
+    jsonMode: z.ZodBoolean;
+    reasoning: z.ZodBoolean;
+    streaming: z.ZodBoolean;
+    promptCaching: z.ZodBoolean;
+    maxContextTokens: z.ZodNumber;
+    maxOutputTokens: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    inputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+    outputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+    tools: boolean;
+    parallelToolCalls: boolean;
+    structuredOutput: boolean;
+    jsonMode: boolean;
+    reasoning: boolean;
+    streaming: boolean;
+    promptCaching: boolean;
+    maxContextTokens: number;
+    maxOutputTokens: number;
+}, {
+    inputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+    outputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+    tools: boolean;
+    parallelToolCalls: boolean;
+    structuredOutput: boolean;
+    jsonMode: boolean;
+    reasoning: boolean;
+    streaming: boolean;
+    promptCaching: boolean;
+    maxContextTokens: number;
+    maxOutputTokens: number;
+}>;
+/**
+ * License terms, including the two questions that decide whether Oxy may serve
+ * a model to third parties at all: is commercial use permitted, and must the
+ * base model be attributed.
+ */
+export declare const modelLicenseSchema: z.ZodObject<{
+    /** SPDX identifier where one exists, otherwise the publisher's own name. */
+    licenseId: z.ZodString;
+    displayName: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+    commercialUseAllowed: z.ZodBoolean;
+    requiresAttribution: z.ZodBoolean;
+    acceptableUsePolicyUrl: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    displayName: string;
+    licenseId: string;
+    commercialUseAllowed: boolean;
+    requiresAttribution: boolean;
+    url?: string | undefined;
+    acceptableUsePolicyUrl?: string | undefined;
+}, {
+    displayName: string;
+    licenseId: string;
+    commercialUseAllowed: boolean;
+    requiresAttribution: boolean;
+    url?: string | undefined;
+    acceptableUsePolicyUrl?: string | undefined;
+}>;
+/**
+ * How a model came to exist.
+ *
+ * `releaseKind` is what stops `alia/*` from becoming a re-badging namespace:
+ * a first-party namespace may only carry models Alia actually trained or
+ * derived, never a third-party route wearing an Oxy name.
+ */
+export declare const modelProvenanceSchema: z.ZodObject<{
+    releaseKind: z.ZodEnum<["first_party_original", "first_party_derived", "open_weight", "third_party_hosted"]>;
+    /** The model this one was derived/fine-tuned from, where there is one. */
+    baseModelId: z.ZodOptional<z.ZodString>;
+    trainingOrganization: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    releaseKind: "first_party_original" | "first_party_derived" | "open_weight" | "third_party_hosted";
+    baseModelId?: string | undefined;
+    trainingOrganization?: string | undefined;
+}, {
+    releaseKind: "first_party_original" | "first_party_derived" | "open_weight" | "third_party_hosted";
+    baseModelId?: string | undefined;
+    trainingOrganization?: string | undefined;
+}>;
+/**
+ * What happens to the customer's prompts and responses on a given route.
+ *
+ * Every field here is enforceable by a routing policy, which is the reason they
+ * are structured rather than a prose paragraph on a docs page.
+ */
+export declare const inferenceDataPolicySchema: z.ZodEffects<z.ZodObject<{
+    retainsPayloads: z.ZodBoolean;
+    /** Zero when nothing is retained. */
+    retentionDays: z.ZodNumber;
+    trainsOnCustomerData: z.ZodBoolean;
+    zeroDataRetentionAvailable: z.ZodBoolean;
+    /** Named subprocessors a payload may pass through, for compliance review. */
+    subprocessors: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    policyUrl: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    retainsPayloads: boolean;
+    retentionDays: number;
+    trainsOnCustomerData: boolean;
+    zeroDataRetentionAvailable: boolean;
+    subprocessors: string[];
+    policyUrl?: string | undefined;
+}, {
+    retainsPayloads: boolean;
+    retentionDays: number;
+    trainsOnCustomerData: boolean;
+    zeroDataRetentionAvailable: boolean;
+    subprocessors?: string[] | undefined;
+    policyUrl?: string | undefined;
+}>, {
+    retainsPayloads: boolean;
+    retentionDays: number;
+    trainsOnCustomerData: boolean;
+    zeroDataRetentionAvailable: boolean;
+    subprocessors: string[];
+    policyUrl?: string | undefined;
+}, {
+    retainsPayloads: boolean;
+    retentionDays: number;
+    trainsOnCustomerData: boolean;
+    zeroDataRetentionAvailable: boolean;
+    subprocessors?: string[] | undefined;
+    policyUrl?: string | undefined;
+}>;
+/**
+ * Who a route may be served to. Availability inside Alia never implies
+ * permission to resell the same provider/model publicly, which is why this is
+ * an explicit scope on the route rather than a boolean derived from "it works".
+ */
+export declare const availabilityScopeSchema: z.ZodEnum<["internal_alia", "public_payg", "enterprise", "byok_only", "oxy_hosted"]>;
+/** The commercial basis on which Oxy may serve a route. */
+export declare const commercialPermissionSchema: z.ZodEnum<["standard_application_use", "public_resale_approved", "wholesale_contract", "customer_byok", "open_weight_hosting"]>;
+/** Deprecation state, with the replacement a customer should migrate to. */
+export declare const modelDeprecationSchema: z.ZodEffects<z.ZodObject<{
+    status: z.ZodEnum<["active", "deprecated", "retired"]>;
+    replacementModelReference: z.ZodOptional<z.ZodString>;
+    announcedAt: z.ZodOptional<z.ZodString>;
+    sunsetAt: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    status: "active" | "deprecated" | "retired";
+    replacementModelReference?: string | undefined;
+    announcedAt?: string | undefined;
+    sunsetAt?: string | undefined;
+}, {
+    status: "active" | "deprecated" | "retired";
+    replacementModelReference?: string | undefined;
+    announcedAt?: string | undefined;
+    sunsetAt?: string | undefined;
+}>, {
+    status: "active" | "deprecated" | "retired";
+    replacementModelReference?: string | undefined;
+    announcedAt?: string | undefined;
+    sunsetAt?: string | undefined;
+}, {
+    status: "active" | "deprecated" | "retired";
+    replacementModelReference?: string | undefined;
+    announcedAt?: string | undefined;
+    sunsetAt?: string | undefined;
+}>;
+/** One published evaluation result for a revision. */
+export declare const modelEvaluationResultSchema: z.ZodObject<{
+    suite: z.ZodString;
+    metric: z.ZodString;
+    /** Kept as a string: an eval score is published text, not arithmetic. */
+    score: z.ZodString;
+    evaluatedAt: z.ZodOptional<z.ZodString>;
+    reportUrl: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    score: string;
+    suite: string;
+    metric: string;
+    evaluatedAt?: string | undefined;
+    reportUrl?: string | undefined;
+}, {
+    score: string;
+    suite: string;
+    metric: string;
+    evaluatedAt?: string | undefined;
+    reportUrl?: string | undefined;
+}>;
+/**
+ * Safety metadata a downstream developer needs, and the EU AI Act / GPAI
+ * documentation trail expects to find beside a served model.
+ */
+export declare const modelSafetyMetadataSchema: z.ZodObject<{
+    safetyCardUrl: z.ZodOptional<z.ZodString>;
+    contentFilteringDefault: z.ZodEnum<["none", "provider_default", "strict"]>;
+    knownLimitations: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Content-provenance marking the modality requires, where it requires one. */
+    provenanceMarking: z.ZodEnum<["none", "visible_watermark", "invisible_watermark", "c2pa"]>;
+}, "strict", z.ZodTypeAny, {
+    contentFilteringDefault: "strict" | "none" | "provider_default";
+    knownLimitations: string[];
+    provenanceMarking: "none" | "visible_watermark" | "invisible_watermark" | "c2pa";
+    safetyCardUrl?: string | undefined;
+}, {
+    contentFilteringDefault: "strict" | "none" | "provider_default";
+    provenanceMarking: "none" | "visible_watermark" | "invisible_watermark" | "c2pa";
+    safetyCardUrl?: string | undefined;
+    knownLimitations?: string[] | undefined;
+}>;
+/** Who released a model. Never a provider, and never a routing profile. */
+export declare const modelPublisherSchema: z.ZodObject<{
+    /** See `version.ts`: served on its own by the catalogue, so it is versioned. */
+    schemaVersion: z.ZodLiteral<1>;
+    publisherId: z.ZodString;
+    slug: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    websiteUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    displayName: string;
+    schemaVersion: 1;
+    publisherId: string;
+    slug: string;
+    description?: string | undefined;
+    websiteUrl?: string | undefined;
+}, {
+    displayName: string;
+    schemaVersion: 1;
+    publisherId: string;
+    slug: string;
+    description?: string | undefined;
+    websiteUrl?: string | undefined;
+}>;
+/**
+ * A model: the long-lived product identity `<publisher>/<model>`.
+ *
+ * Carries no provider, no region, no price and no availability — those belong
+ * to a DEPLOYMENT, because the same model is served on several routes whose
+ * answers to those questions differ.
+ */
+export declare const catalogueModelSchema: z.ZodEffects<z.ZodObject<{
+    /** See `version.ts`: served on its own by the catalogue, so it is versioned. */
+    schemaVersion: z.ZodLiteral<1>;
+    modelId: z.ZodString;
+    publisher: z.ZodString;
+    slug: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodObject<{
+        inputModalities: z.ZodArray<z.ZodEnum<["text", "image", "audio", "video", "embedding"]>, "many">;
+        outputModalities: z.ZodArray<z.ZodEnum<["text", "image", "audio", "video", "embedding"]>, "many">;
+        tools: z.ZodBoolean;
+        parallelToolCalls: z.ZodBoolean;
+        structuredOutput: z.ZodBoolean;
+        jsonMode: z.ZodBoolean;
+        reasoning: z.ZodBoolean;
+        streaming: z.ZodBoolean;
+        promptCaching: z.ZodBoolean;
+        maxContextTokens: z.ZodNumber;
+        maxOutputTokens: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        inputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        outputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        tools: boolean;
+        parallelToolCalls: boolean;
+        structuredOutput: boolean;
+        jsonMode: boolean;
+        reasoning: boolean;
+        streaming: boolean;
+        promptCaching: boolean;
+        maxContextTokens: number;
+        maxOutputTokens: number;
+    }, {
+        inputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        outputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        tools: boolean;
+        parallelToolCalls: boolean;
+        structuredOutput: boolean;
+        jsonMode: boolean;
+        reasoning: boolean;
+        streaming: boolean;
+        promptCaching: boolean;
+        maxContextTokens: number;
+        maxOutputTokens: number;
+    }>;
+    license: z.ZodObject<{
+        /** SPDX identifier where one exists, otherwise the publisher's own name. */
+        licenseId: z.ZodString;
+        displayName: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        commercialUseAllowed: z.ZodBoolean;
+        requiresAttribution: z.ZodBoolean;
+        acceptableUsePolicyUrl: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        displayName: string;
+        licenseId: string;
+        commercialUseAllowed: boolean;
+        requiresAttribution: boolean;
+        url?: string | undefined;
+        acceptableUsePolicyUrl?: string | undefined;
+    }, {
+        displayName: string;
+        licenseId: string;
+        commercialUseAllowed: boolean;
+        requiresAttribution: boolean;
+        url?: string | undefined;
+        acceptableUsePolicyUrl?: string | undefined;
+    }>;
+    provenance: z.ZodObject<{
+        releaseKind: z.ZodEnum<["first_party_original", "first_party_derived", "open_weight", "third_party_hosted"]>;
+        /** The model this one was derived/fine-tuned from, where there is one. */
+        baseModelId: z.ZodOptional<z.ZodString>;
+        trainingOrganization: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        releaseKind: "first_party_original" | "first_party_derived" | "open_weight" | "third_party_hosted";
+        baseModelId?: string | undefined;
+        trainingOrganization?: string | undefined;
+    }, {
+        releaseKind: "first_party_original" | "first_party_derived" | "open_weight" | "third_party_hosted";
+        baseModelId?: string | undefined;
+        trainingOrganization?: string | undefined;
+    }>;
+    knowledgeCutoff: z.ZodOptional<z.ZodString>;
+    releasedOn: z.ZodOptional<z.ZodString>;
+    /** The revision served when a caller names the model without pinning one. */
+    currentRevision: z.ZodString;
+    deprecation: z.ZodEffects<z.ZodObject<{
+        status: z.ZodEnum<["active", "deprecated", "retired"]>;
+        replacementModelReference: z.ZodOptional<z.ZodString>;
+        announcedAt: z.ZodOptional<z.ZodString>;
+        sunsetAt: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        status: "active" | "deprecated" | "retired";
+        replacementModelReference?: string | undefined;
+        announcedAt?: string | undefined;
+        sunsetAt?: string | undefined;
+    }, {
+        status: "active" | "deprecated" | "retired";
+        replacementModelReference?: string | undefined;
+        announcedAt?: string | undefined;
+        sunsetAt?: string | undefined;
+    }>, {
+        status: "active" | "deprecated" | "retired";
+        replacementModelReference?: string | undefined;
+        announcedAt?: string | undefined;
+        sunsetAt?: string | undefined;
+    }, {
+        status: "active" | "deprecated" | "retired";
+        replacementModelReference?: string | undefined;
+        announcedAt?: string | undefined;
+        sunsetAt?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    displayName: string;
+    schemaVersion: 1;
+    slug: string;
+    modelId: string;
+    publisher: string;
+    capabilities: {
+        inputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        outputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        tools: boolean;
+        parallelToolCalls: boolean;
+        structuredOutput: boolean;
+        jsonMode: boolean;
+        reasoning: boolean;
+        streaming: boolean;
+        promptCaching: boolean;
+        maxContextTokens: number;
+        maxOutputTokens: number;
+    };
+    license: {
+        displayName: string;
+        licenseId: string;
+        commercialUseAllowed: boolean;
+        requiresAttribution: boolean;
+        url?: string | undefined;
+        acceptableUsePolicyUrl?: string | undefined;
+    };
+    provenance: {
+        releaseKind: "first_party_original" | "first_party_derived" | "open_weight" | "third_party_hosted";
+        baseModelId?: string | undefined;
+        trainingOrganization?: string | undefined;
+    };
+    currentRevision: string;
+    deprecation: {
+        status: "active" | "deprecated" | "retired";
+        replacementModelReference?: string | undefined;
+        announcedAt?: string | undefined;
+        sunsetAt?: string | undefined;
+    };
+    description?: string | undefined;
+    knowledgeCutoff?: string | undefined;
+    releasedOn?: string | undefined;
+}, {
+    displayName: string;
+    schemaVersion: 1;
+    slug: string;
+    modelId: string;
+    publisher: string;
+    capabilities: {
+        inputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        outputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        tools: boolean;
+        parallelToolCalls: boolean;
+        structuredOutput: boolean;
+        jsonMode: boolean;
+        reasoning: boolean;
+        streaming: boolean;
+        promptCaching: boolean;
+        maxContextTokens: number;
+        maxOutputTokens: number;
+    };
+    license: {
+        displayName: string;
+        licenseId: string;
+        commercialUseAllowed: boolean;
+        requiresAttribution: boolean;
+        url?: string | undefined;
+        acceptableUsePolicyUrl?: string | undefined;
+    };
+    provenance: {
+        releaseKind: "first_party_original" | "first_party_derived" | "open_weight" | "third_party_hosted";
+        baseModelId?: string | undefined;
+        trainingOrganization?: string | undefined;
+    };
+    currentRevision: string;
+    deprecation: {
+        status: "active" | "deprecated" | "retired";
+        replacementModelReference?: string | undefined;
+        announcedAt?: string | undefined;
+        sunsetAt?: string | undefined;
+    };
+    description?: string | undefined;
+    knowledgeCutoff?: string | undefined;
+    releasedOn?: string | undefined;
+}>, {
+    displayName: string;
+    schemaVersion: 1;
+    slug: string;
+    modelId: string;
+    publisher: string;
+    capabilities: {
+        inputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        outputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        tools: boolean;
+        parallelToolCalls: boolean;
+        structuredOutput: boolean;
+        jsonMode: boolean;
+        reasoning: boolean;
+        streaming: boolean;
+        promptCaching: boolean;
+        maxContextTokens: number;
+        maxOutputTokens: number;
+    };
+    license: {
+        displayName: string;
+        licenseId: string;
+        commercialUseAllowed: boolean;
+        requiresAttribution: boolean;
+        url?: string | undefined;
+        acceptableUsePolicyUrl?: string | undefined;
+    };
+    provenance: {
+        releaseKind: "first_party_original" | "first_party_derived" | "open_weight" | "third_party_hosted";
+        baseModelId?: string | undefined;
+        trainingOrganization?: string | undefined;
+    };
+    currentRevision: string;
+    deprecation: {
+        status: "active" | "deprecated" | "retired";
+        replacementModelReference?: string | undefined;
+        announcedAt?: string | undefined;
+        sunsetAt?: string | undefined;
+    };
+    description?: string | undefined;
+    knowledgeCutoff?: string | undefined;
+    releasedOn?: string | undefined;
+}, {
+    displayName: string;
+    schemaVersion: 1;
+    slug: string;
+    modelId: string;
+    publisher: string;
+    capabilities: {
+        inputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        outputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        tools: boolean;
+        parallelToolCalls: boolean;
+        structuredOutput: boolean;
+        jsonMode: boolean;
+        reasoning: boolean;
+        streaming: boolean;
+        promptCaching: boolean;
+        maxContextTokens: number;
+        maxOutputTokens: number;
+    };
+    license: {
+        displayName: string;
+        licenseId: string;
+        commercialUseAllowed: boolean;
+        requiresAttribution: boolean;
+        url?: string | undefined;
+        acceptableUsePolicyUrl?: string | undefined;
+    };
+    provenance: {
+        releaseKind: "first_party_original" | "first_party_derived" | "open_weight" | "third_party_hosted";
+        baseModelId?: string | undefined;
+        trainingOrganization?: string | undefined;
+    };
+    currentRevision: string;
+    deprecation: {
+        status: "active" | "deprecated" | "retired";
+        replacementModelReference?: string | undefined;
+        announcedAt?: string | undefined;
+        sunsetAt?: string | undefined;
+    };
+    description?: string | undefined;
+    knowledgeCutoff?: string | undefined;
+    releasedOn?: string | undefined;
+}>;
+/**
+ * An immutable revision of a model.
+ *
+ * `reference` is the exact string a customer pins (`<publisher>/<model>@<revision>`)
+ * and is checked against its parts, so a record cannot claim a reference that
+ * resolves elsewhere. Evaluation and safety metadata hang here rather than on
+ * the model, because they describe specific weights.
+ */
+export declare const modelRevisionSchema: z.ZodEffects<z.ZodObject<{
+    /** See `version.ts`: served on its own by the catalogue, so it is versioned. */
+    schemaVersion: z.ZodLiteral<1>;
+    revisionId: z.ZodString;
+    modelId: z.ZodString;
+    revision: z.ZodString;
+    reference: z.ZodString;
+    releasedAt: z.ZodString;
+    retiredAt: z.ZodOptional<z.ZodString>;
+    /** Digest of the served artifact, where Oxy hosts the weights itself. */
+    artifactDigest: z.ZodOptional<z.ZodString>;
+    modelCardUrl: z.ZodOptional<z.ZodString>;
+    evaluations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        suite: z.ZodString;
+        metric: z.ZodString;
+        /** Kept as a string: an eval score is published text, not arithmetic. */
+        score: z.ZodString;
+        evaluatedAt: z.ZodOptional<z.ZodString>;
+        reportUrl: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        score: string;
+        suite: string;
+        metric: string;
+        evaluatedAt?: string | undefined;
+        reportUrl?: string | undefined;
+    }, {
+        score: string;
+        suite: string;
+        metric: string;
+        evaluatedAt?: string | undefined;
+        reportUrl?: string | undefined;
+    }>, "many">>;
+    safety: z.ZodOptional<z.ZodObject<{
+        safetyCardUrl: z.ZodOptional<z.ZodString>;
+        contentFilteringDefault: z.ZodEnum<["none", "provider_default", "strict"]>;
+        knownLimitations: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** Content-provenance marking the modality requires, where it requires one. */
+        provenanceMarking: z.ZodEnum<["none", "visible_watermark", "invisible_watermark", "c2pa"]>;
+    }, "strict", z.ZodTypeAny, {
+        contentFilteringDefault: "strict" | "none" | "provider_default";
+        knownLimitations: string[];
+        provenanceMarking: "none" | "visible_watermark" | "invisible_watermark" | "c2pa";
+        safetyCardUrl?: string | undefined;
+    }, {
+        contentFilteringDefault: "strict" | "none" | "provider_default";
+        provenanceMarking: "none" | "visible_watermark" | "invisible_watermark" | "c2pa";
+        safetyCardUrl?: string | undefined;
+        knownLimitations?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    revision: string;
+    schemaVersion: 1;
+    modelId: string;
+    revisionId: string;
+    reference: string;
+    releasedAt: string;
+    evaluations: {
+        score: string;
+        suite: string;
+        metric: string;
+        evaluatedAt?: string | undefined;
+        reportUrl?: string | undefined;
+    }[];
+    retiredAt?: string | undefined;
+    artifactDigest?: string | undefined;
+    modelCardUrl?: string | undefined;
+    safety?: {
+        contentFilteringDefault: "strict" | "none" | "provider_default";
+        knownLimitations: string[];
+        provenanceMarking: "none" | "visible_watermark" | "invisible_watermark" | "c2pa";
+        safetyCardUrl?: string | undefined;
+    } | undefined;
+}, {
+    revision: string;
+    schemaVersion: 1;
+    modelId: string;
+    revisionId: string;
+    reference: string;
+    releasedAt: string;
+    retiredAt?: string | undefined;
+    artifactDigest?: string | undefined;
+    modelCardUrl?: string | undefined;
+    evaluations?: {
+        score: string;
+        suite: string;
+        metric: string;
+        evaluatedAt?: string | undefined;
+        reportUrl?: string | undefined;
+    }[] | undefined;
+    safety?: {
+        contentFilteringDefault: "strict" | "none" | "provider_default";
+        provenanceMarking: "none" | "visible_watermark" | "invisible_watermark" | "c2pa";
+        safetyCardUrl?: string | undefined;
+        knownLimitations?: string[] | undefined;
+    } | undefined;
+}>, {
+    revision: string;
+    schemaVersion: 1;
+    modelId: string;
+    revisionId: string;
+    reference: string;
+    releasedAt: string;
+    evaluations: {
+        score: string;
+        suite: string;
+        metric: string;
+        evaluatedAt?: string | undefined;
+        reportUrl?: string | undefined;
+    }[];
+    retiredAt?: string | undefined;
+    artifactDigest?: string | undefined;
+    modelCardUrl?: string | undefined;
+    safety?: {
+        contentFilteringDefault: "strict" | "none" | "provider_default";
+        knownLimitations: string[];
+        provenanceMarking: "none" | "visible_watermark" | "invisible_watermark" | "c2pa";
+        safetyCardUrl?: string | undefined;
+    } | undefined;
+}, {
+    revision: string;
+    schemaVersion: 1;
+    modelId: string;
+    revisionId: string;
+    reference: string;
+    releasedAt: string;
+    retiredAt?: string | undefined;
+    artifactDigest?: string | undefined;
+    modelCardUrl?: string | undefined;
+    evaluations?: {
+        score: string;
+        suite: string;
+        metric: string;
+        evaluatedAt?: string | undefined;
+        reportUrl?: string | undefined;
+    }[] | undefined;
+    safety?: {
+        contentFilteringDefault: "strict" | "none" | "provider_default";
+        provenanceMarking: "none" | "visible_watermark" | "invisible_watermark" | "c2pa";
+        safetyCardUrl?: string | undefined;
+        knownLimitations?: string[] | undefined;
+    } | undefined;
+}>;
+/** Who runs the weights for a route. */
+export declare const inferenceProviderSchema: z.ZodObject<{
+    /** See `version.ts`: served on its own by the catalogue, so it is versioned. */
+    schemaVersion: z.ZodLiteral<1>;
+    providerId: z.ZodString;
+    slug: z.ZodString;
+    displayName: z.ZodString;
+    /**
+     * `customer_byok` means the customer's own upstream account is billed
+     * directly by the provider and Oxy charges only its platform fee.
+     */
+    kind: z.ZodEnum<["third_party", "oxy_hosted", "customer_byok"]>;
+    websiteUrl: z.ZodOptional<z.ZodString>;
+    statusPageUrl: z.ZodOptional<z.ZodString>;
+    regions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    dataPolicy: z.ZodEffects<z.ZodObject<{
+        retainsPayloads: z.ZodBoolean;
+        /** Zero when nothing is retained. */
+        retentionDays: z.ZodNumber;
+        trainsOnCustomerData: z.ZodBoolean;
+        zeroDataRetentionAvailable: z.ZodBoolean;
+        /** Named subprocessors a payload may pass through, for compliance review. */
+        subprocessors: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        policyUrl: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors: string[];
+        policyUrl?: string | undefined;
+    }, {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors?: string[] | undefined;
+        policyUrl?: string | undefined;
+    }>, {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors: string[];
+        policyUrl?: string | undefined;
+    }, {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors?: string[] | undefined;
+        policyUrl?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    displayName: string;
+    kind: "third_party" | "oxy_hosted" | "customer_byok";
+    schemaVersion: 1;
+    slug: string;
+    providerId: string;
+    regions: string[];
+    dataPolicy: {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors: string[];
+        policyUrl?: string | undefined;
+    };
+    websiteUrl?: string | undefined;
+    statusPageUrl?: string | undefined;
+}, {
+    displayName: string;
+    kind: "third_party" | "oxy_hosted" | "customer_byok";
+    schemaVersion: 1;
+    slug: string;
+    providerId: string;
+    dataPolicy: {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors?: string[] | undefined;
+        policyUrl?: string | undefined;
+    };
+    websiteUrl?: string | undefined;
+    statusPageUrl?: string | undefined;
+    regions?: string[] | undefined;
+}>;
+/**
+ * One concrete servable route: a revision, on a provider, in some regions,
+ * under a data policy, with an availability scope and a commercial permission.
+ *
+ * This is the object a routing policy filters and a route switch names — never
+ * a model. Two deployments of the SAME revision are what same-model failover
+ * moves between; moving to a deployment of a different revision or model is a
+ * cross-model fallback and needs explicit authorization.
+ */
+export declare const modelDeploymentSchema: z.ZodEffects<z.ZodObject<{
+    /** See `version.ts`: exchanged with the data plane on its own. */
+    schemaVersion: z.ZodLiteral<1>;
+    deploymentId: z.ZodString;
+    provider: z.ZodString;
+    /** Always revision-pinned: a deployment serves specific weights. */
+    modelReference: z.ZodString;
+    regions: z.ZodArray<z.ZodString, "many">;
+    dataPolicy: z.ZodEffects<z.ZodObject<{
+        retainsPayloads: z.ZodBoolean;
+        /** Zero when nothing is retained. */
+        retentionDays: z.ZodNumber;
+        trainsOnCustomerData: z.ZodBoolean;
+        zeroDataRetentionAvailable: z.ZodBoolean;
+        /** Named subprocessors a payload may pass through, for compliance review. */
+        subprocessors: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        policyUrl: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors: string[];
+        policyUrl?: string | undefined;
+    }, {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors?: string[] | undefined;
+        policyUrl?: string | undefined;
+    }>, {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors: string[];
+        policyUrl?: string | undefined;
+    }, {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors?: string[] | undefined;
+        policyUrl?: string | undefined;
+    }>;
+    availabilityScope: z.ZodEnum<["internal_alia", "public_payg", "enterprise", "byok_only", "oxy_hosted"]>;
+    commercialPermission: z.ZodEnum<["standard_application_use", "public_resale_approved", "wholesale_contract", "customer_byok", "open_weight_hosting"]>;
+    status: z.ZodEnum<["active", "degraded", "disabled", "retired"]>;
+    /** Reserved capacity for one enterprise account rather than shared. */
+    dedicatedCapacity: z.ZodBoolean;
+    /** The price version customers are charged under on this route. */
+    priceVersionId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "active" | "disabled" | "retired" | "degraded";
+    provider: string;
+    schemaVersion: 1;
+    modelReference: string;
+    regions: string[];
+    dataPolicy: {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors: string[];
+        policyUrl?: string | undefined;
+    };
+    deploymentId: string;
+    availabilityScope: "internal_alia" | "public_payg" | "enterprise" | "byok_only" | "oxy_hosted";
+    commercialPermission: "standard_application_use" | "public_resale_approved" | "wholesale_contract" | "customer_byok" | "open_weight_hosting";
+    dedicatedCapacity: boolean;
+    priceVersionId?: string | undefined;
+}, {
+    status: "active" | "disabled" | "retired" | "degraded";
+    provider: string;
+    schemaVersion: 1;
+    modelReference: string;
+    regions: string[];
+    dataPolicy: {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors?: string[] | undefined;
+        policyUrl?: string | undefined;
+    };
+    deploymentId: string;
+    availabilityScope: "internal_alia" | "public_payg" | "enterprise" | "byok_only" | "oxy_hosted";
+    commercialPermission: "standard_application_use" | "public_resale_approved" | "wholesale_contract" | "customer_byok" | "open_weight_hosting";
+    dedicatedCapacity: boolean;
+    priceVersionId?: string | undefined;
+}>, {
+    status: "active" | "disabled" | "retired" | "degraded";
+    provider: string;
+    schemaVersion: 1;
+    modelReference: string;
+    regions: string[];
+    dataPolicy: {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors: string[];
+        policyUrl?: string | undefined;
+    };
+    deploymentId: string;
+    availabilityScope: "internal_alia" | "public_payg" | "enterprise" | "byok_only" | "oxy_hosted";
+    commercialPermission: "standard_application_use" | "public_resale_approved" | "wholesale_contract" | "customer_byok" | "open_weight_hosting";
+    dedicatedCapacity: boolean;
+    priceVersionId?: string | undefined;
+}, {
+    status: "active" | "disabled" | "retired" | "degraded";
+    provider: string;
+    schemaVersion: 1;
+    modelReference: string;
+    regions: string[];
+    dataPolicy: {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors?: string[] | undefined;
+        policyUrl?: string | undefined;
+    };
+    deploymentId: string;
+    availabilityScope: "internal_alia" | "public_payg" | "enterprise" | "byok_only" | "oxy_hosted";
+    commercialPermission: "standard_application_use" | "public_resale_approved" | "wholesale_contract" | "customer_byok" | "open_weight_hosting";
+    dedicatedCapacity: boolean;
+    priceVersionId?: string | undefined;
+}>;
+/** One candidate a profile may resolve to, and how strongly it is preferred. */
+export declare const routingProfileCandidateSchema: z.ZodObject<{
+    modelReference: z.ZodString;
+    /** Lower sorts first. Ties are broken by the profile's optimisation target. */
+    priority: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    modelReference: string;
+    priority: number;
+}, {
+    modelReference: string;
+    priority: number;
+}>;
+/**
+ * A named strategy for choosing among routes — `auto`, `fast`, `quality`.
+ *
+ * Not a model: it has no publisher, no revision, no license and no weights, and
+ * its slug cannot be written as `<publisher>/<model>`. A request that names a
+ * profile is asking Oxy to choose; a request that names a model is not, which is
+ * the distinction the "never silently substituted" invariant rests on.
+ */
+export declare const routingProfileSchema: z.ZodObject<{
+    /** See `version.ts`: served on its own by the catalogue, so it is versioned. */
+    schemaVersion: z.ZodLiteral<1>;
+    routingProfileId: z.ZodString;
+    slug: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    /** What the profile optimises for when several candidates qualify. */
+    optimiseFor: z.ZodEnum<["price", "latency", "throughput", "quality", "balanced"]>;
+    candidates: z.ZodArray<z.ZodObject<{
+        modelReference: z.ZodString;
+        /** Lower sorts first. Ties are broken by the profile's optimisation target. */
+        priority: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        modelReference: string;
+        priority: number;
+    }, {
+        modelReference: string;
+        priority: number;
+    }>, "many">;
+    /** A product preset (Alia's "fast" toggle) rather than a customer's own profile. */
+    isProductPreset: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    displayName: string;
+    schemaVersion: 1;
+    slug: string;
+    routingProfileId: string;
+    optimiseFor: "price" | "latency" | "throughput" | "quality" | "balanced";
+    candidates: {
+        modelReference: string;
+        priority: number;
+    }[];
+    isProductPreset: boolean;
+    description?: string | undefined;
+}, {
+    displayName: string;
+    schemaVersion: 1;
+    slug: string;
+    routingProfileId: string;
+    optimiseFor: "price" | "latency" | "throughput" | "quality" | "balanced";
+    candidates: {
+        modelReference: string;
+        priority: number;
+    }[];
+    isProductPreset: boolean;
+    description?: string | undefined;
+}>;
+/** The publisher fields a customer sees beside a model. */
+export declare const cataloguePublisherSummarySchema: z.ZodObject<{
+    slug: z.ZodString;
+    displayName: z.ZodString;
+    websiteUrl: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    displayName: string;
+    slug: string;
+    websiteUrl?: string | undefined;
+}, {
+    displayName: string;
+    slug: string;
+    websiteUrl?: string | undefined;
+}>;
+/**
+ * A serving provider as a customer may see it: who ran the request and where.
+ *
+ * Deliberately has no deployment id, no route id, no health score and no
+ * upstream cost — the customer-safe half of the serving boundary, so that
+ * exposing attribution can never leak operational topology.
+ */
+export declare const catalogueServingProviderSummarySchema: z.ZodObject<{
+    slug: z.ZodString;
+    displayName: z.ZodString;
+    regions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    dataPolicy: z.ZodEffects<z.ZodObject<{
+        retainsPayloads: z.ZodBoolean;
+        /** Zero when nothing is retained. */
+        retentionDays: z.ZodNumber;
+        trainsOnCustomerData: z.ZodBoolean;
+        zeroDataRetentionAvailable: z.ZodBoolean;
+        /** Named subprocessors a payload may pass through, for compliance review. */
+        subprocessors: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        policyUrl: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors: string[];
+        policyUrl?: string | undefined;
+    }, {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors?: string[] | undefined;
+        policyUrl?: string | undefined;
+    }>, {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors: string[];
+        policyUrl?: string | undefined;
+    }, {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors?: string[] | undefined;
+        policyUrl?: string | undefined;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    displayName: string;
+    slug: string;
+    regions: string[];
+    dataPolicy: {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors: string[];
+        policyUrl?: string | undefined;
+    };
+}, {
+    displayName: string;
+    slug: string;
+    dataPolicy: {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors?: string[] | undefined;
+        policyUrl?: string | undefined;
+    };
+    regions?: string[] | undefined;
+}>;
+/**
+ * One entry of the customer-facing catalogue (`GET /v1/models`).
+ *
+ * A projection, not a container: it repeats the customer-facing fields instead
+ * of embedding the operational descriptors, so no internal identifier can reach
+ * a customer by being nested one level deeper than anybody looked.
+ */
+export declare const modelCatalogueEntrySchema: z.ZodObject<{
+    /** See `version.ts`: this is the public catalogue response shape. */
+    schemaVersion: z.ZodLiteral<1>;
+    modelId: z.ZodString;
+    publisher: z.ZodObject<{
+        slug: z.ZodString;
+        displayName: z.ZodString;
+        websiteUrl: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        displayName: string;
+        slug: string;
+        websiteUrl?: string | undefined;
+    }, {
+        displayName: string;
+        slug: string;
+        websiteUrl?: string | undefined;
+    }>;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    currentRevision: z.ZodString;
+    /** Revisions a customer may pin today, newest first. */
+    availableRevisions: z.ZodArray<z.ZodString, "many">;
+    capabilities: z.ZodObject<{
+        inputModalities: z.ZodArray<z.ZodEnum<["text", "image", "audio", "video", "embedding"]>, "many">;
+        outputModalities: z.ZodArray<z.ZodEnum<["text", "image", "audio", "video", "embedding"]>, "many">;
+        tools: z.ZodBoolean;
+        parallelToolCalls: z.ZodBoolean;
+        structuredOutput: z.ZodBoolean;
+        jsonMode: z.ZodBoolean;
+        reasoning: z.ZodBoolean;
+        streaming: z.ZodBoolean;
+        promptCaching: z.ZodBoolean;
+        maxContextTokens: z.ZodNumber;
+        maxOutputTokens: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        inputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        outputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        tools: boolean;
+        parallelToolCalls: boolean;
+        structuredOutput: boolean;
+        jsonMode: boolean;
+        reasoning: boolean;
+        streaming: boolean;
+        promptCaching: boolean;
+        maxContextTokens: number;
+        maxOutputTokens: number;
+    }, {
+        inputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        outputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        tools: boolean;
+        parallelToolCalls: boolean;
+        structuredOutput: boolean;
+        jsonMode: boolean;
+        reasoning: boolean;
+        streaming: boolean;
+        promptCaching: boolean;
+        maxContextTokens: number;
+        maxOutputTokens: number;
+    }>;
+    license: z.ZodObject<{
+        /** SPDX identifier where one exists, otherwise the publisher's own name. */
+        licenseId: z.ZodString;
+        displayName: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        commercialUseAllowed: z.ZodBoolean;
+        requiresAttribution: z.ZodBoolean;
+        acceptableUsePolicyUrl: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        displayName: string;
+        licenseId: string;
+        commercialUseAllowed: boolean;
+        requiresAttribution: boolean;
+        url?: string | undefined;
+        acceptableUsePolicyUrl?: string | undefined;
+    }, {
+        displayName: string;
+        licenseId: string;
+        commercialUseAllowed: boolean;
+        requiresAttribution: boolean;
+        url?: string | undefined;
+        acceptableUsePolicyUrl?: string | undefined;
+    }>;
+    provenance: z.ZodObject<{
+        releaseKind: z.ZodEnum<["first_party_original", "first_party_derived", "open_weight", "third_party_hosted"]>;
+        /** The model this one was derived/fine-tuned from, where there is one. */
+        baseModelId: z.ZodOptional<z.ZodString>;
+        trainingOrganization: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        releaseKind: "first_party_original" | "first_party_derived" | "open_weight" | "third_party_hosted";
+        baseModelId?: string | undefined;
+        trainingOrganization?: string | undefined;
+    }, {
+        releaseKind: "first_party_original" | "first_party_derived" | "open_weight" | "third_party_hosted";
+        baseModelId?: string | undefined;
+        trainingOrganization?: string | undefined;
+    }>;
+    knowledgeCutoff: z.ZodOptional<z.ZodString>;
+    releasedOn: z.ZodOptional<z.ZodString>;
+    regions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    servingProviders: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        displayName: z.ZodString;
+        regions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        dataPolicy: z.ZodEffects<z.ZodObject<{
+            retainsPayloads: z.ZodBoolean;
+            /** Zero when nothing is retained. */
+            retentionDays: z.ZodNumber;
+            trainsOnCustomerData: z.ZodBoolean;
+            zeroDataRetentionAvailable: z.ZodBoolean;
+            /** Named subprocessors a payload may pass through, for compliance review. */
+            subprocessors: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            policyUrl: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            retainsPayloads: boolean;
+            retentionDays: number;
+            trainsOnCustomerData: boolean;
+            zeroDataRetentionAvailable: boolean;
+            subprocessors: string[];
+            policyUrl?: string | undefined;
+        }, {
+            retainsPayloads: boolean;
+            retentionDays: number;
+            trainsOnCustomerData: boolean;
+            zeroDataRetentionAvailable: boolean;
+            subprocessors?: string[] | undefined;
+            policyUrl?: string | undefined;
+        }>, {
+            retainsPayloads: boolean;
+            retentionDays: number;
+            trainsOnCustomerData: boolean;
+            zeroDataRetentionAvailable: boolean;
+            subprocessors: string[];
+            policyUrl?: string | undefined;
+        }, {
+            retainsPayloads: boolean;
+            retentionDays: number;
+            trainsOnCustomerData: boolean;
+            zeroDataRetentionAvailable: boolean;
+            subprocessors?: string[] | undefined;
+            policyUrl?: string | undefined;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        displayName: string;
+        slug: string;
+        regions: string[];
+        dataPolicy: {
+            retainsPayloads: boolean;
+            retentionDays: number;
+            trainsOnCustomerData: boolean;
+            zeroDataRetentionAvailable: boolean;
+            subprocessors: string[];
+            policyUrl?: string | undefined;
+        };
+    }, {
+        displayName: string;
+        slug: string;
+        dataPolicy: {
+            retainsPayloads: boolean;
+            retentionDays: number;
+            trainsOnCustomerData: boolean;
+            zeroDataRetentionAvailable: boolean;
+            subprocessors?: string[] | undefined;
+            policyUrl?: string | undefined;
+        };
+        regions?: string[] | undefined;
+    }>, "many">>;
+    dataPolicy: z.ZodEffects<z.ZodObject<{
+        retainsPayloads: z.ZodBoolean;
+        /** Zero when nothing is retained. */
+        retentionDays: z.ZodNumber;
+        trainsOnCustomerData: z.ZodBoolean;
+        zeroDataRetentionAvailable: z.ZodBoolean;
+        /** Named subprocessors a payload may pass through, for compliance review. */
+        subprocessors: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        policyUrl: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors: string[];
+        policyUrl?: string | undefined;
+    }, {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors?: string[] | undefined;
+        policyUrl?: string | undefined;
+    }>, {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors: string[];
+        policyUrl?: string | undefined;
+    }, {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors?: string[] | undefined;
+        policyUrl?: string | undefined;
+    }>;
+    /** Absent for routes a customer cannot buy per-unit (BYOK-only, internal). */
+    pricing: z.ZodOptional<z.ZodObject<{
+        priceVersionId: z.ZodString;
+        currency: z.ZodString;
+        unitPrices: z.ZodArray<z.ZodObject<{
+            unit: z.ZodEnum<["input_tokens", "cached_input_tokens", "output_tokens", "reasoning_tokens", "requests", "images", "audio_input_milliseconds", "audio_output_milliseconds", "video_milliseconds", "characters", "embeddings"]>;
+            amount: z.ZodBranded<z.ZodString, "ExactDecimal">;
+            per: z.ZodNumber;
+            currency: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            amount: string & z.BRAND<"ExactDecimal">;
+            currency: string;
+            unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings";
+            per: number;
+        }, {
+            amount: string;
+            currency: string;
+            unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings";
+            per: number;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        currency: string;
+        priceVersionId: string;
+        unitPrices: {
+            amount: string & z.BRAND<"ExactDecimal">;
+            currency: string;
+            unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings";
+            per: number;
+        }[];
+    }, {
+        currency: string;
+        priceVersionId: string;
+        unitPrices: {
+            amount: string;
+            currency: string;
+            unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings";
+            per: number;
+        }[];
+    }>>;
+    availabilityScope: z.ZodEnum<["internal_alia", "public_payg", "enterprise", "byok_only", "oxy_hosted"]>;
+    commercialPermission: z.ZodEnum<["standard_application_use", "public_resale_approved", "wholesale_contract", "customer_byok", "open_weight_hosting"]>;
+    deprecation: z.ZodEffects<z.ZodObject<{
+        status: z.ZodEnum<["active", "deprecated", "retired"]>;
+        replacementModelReference: z.ZodOptional<z.ZodString>;
+        announcedAt: z.ZodOptional<z.ZodString>;
+        sunsetAt: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        status: "active" | "deprecated" | "retired";
+        replacementModelReference?: string | undefined;
+        announcedAt?: string | undefined;
+        sunsetAt?: string | undefined;
+    }, {
+        status: "active" | "deprecated" | "retired";
+        replacementModelReference?: string | undefined;
+        announcedAt?: string | undefined;
+        sunsetAt?: string | undefined;
+    }>, {
+        status: "active" | "deprecated" | "retired";
+        replacementModelReference?: string | undefined;
+        announcedAt?: string | undefined;
+        sunsetAt?: string | undefined;
+    }, {
+        status: "active" | "deprecated" | "retired";
+        replacementModelReference?: string | undefined;
+        announcedAt?: string | undefined;
+        sunsetAt?: string | undefined;
+    }>;
+    evaluations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        suite: z.ZodString;
+        metric: z.ZodString;
+        /** Kept as a string: an eval score is published text, not arithmetic. */
+        score: z.ZodString;
+        evaluatedAt: z.ZodOptional<z.ZodString>;
+        reportUrl: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        score: string;
+        suite: string;
+        metric: string;
+        evaluatedAt?: string | undefined;
+        reportUrl?: string | undefined;
+    }, {
+        score: string;
+        suite: string;
+        metric: string;
+        evaluatedAt?: string | undefined;
+        reportUrl?: string | undefined;
+    }>, "many">>;
+    safety: z.ZodOptional<z.ZodObject<{
+        safetyCardUrl: z.ZodOptional<z.ZodString>;
+        contentFilteringDefault: z.ZodEnum<["none", "provider_default", "strict"]>;
+        knownLimitations: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** Content-provenance marking the modality requires, where it requires one. */
+        provenanceMarking: z.ZodEnum<["none", "visible_watermark", "invisible_watermark", "c2pa"]>;
+    }, "strict", z.ZodTypeAny, {
+        contentFilteringDefault: "strict" | "none" | "provider_default";
+        knownLimitations: string[];
+        provenanceMarking: "none" | "visible_watermark" | "invisible_watermark" | "c2pa";
+        safetyCardUrl?: string | undefined;
+    }, {
+        contentFilteringDefault: "strict" | "none" | "provider_default";
+        provenanceMarking: "none" | "visible_watermark" | "invisible_watermark" | "c2pa";
+        safetyCardUrl?: string | undefined;
+        knownLimitations?: string[] | undefined;
+    }>>;
+    modelCardUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    displayName: string;
+    schemaVersion: 1;
+    modelId: string;
+    publisher: {
+        displayName: string;
+        slug: string;
+        websiteUrl?: string | undefined;
+    };
+    capabilities: {
+        inputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        outputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        tools: boolean;
+        parallelToolCalls: boolean;
+        structuredOutput: boolean;
+        jsonMode: boolean;
+        reasoning: boolean;
+        streaming: boolean;
+        promptCaching: boolean;
+        maxContextTokens: number;
+        maxOutputTokens: number;
+    };
+    license: {
+        displayName: string;
+        licenseId: string;
+        commercialUseAllowed: boolean;
+        requiresAttribution: boolean;
+        url?: string | undefined;
+        acceptableUsePolicyUrl?: string | undefined;
+    };
+    provenance: {
+        releaseKind: "first_party_original" | "first_party_derived" | "open_weight" | "third_party_hosted";
+        baseModelId?: string | undefined;
+        trainingOrganization?: string | undefined;
+    };
+    currentRevision: string;
+    deprecation: {
+        status: "active" | "deprecated" | "retired";
+        replacementModelReference?: string | undefined;
+        announcedAt?: string | undefined;
+        sunsetAt?: string | undefined;
+    };
+    evaluations: {
+        score: string;
+        suite: string;
+        metric: string;
+        evaluatedAt?: string | undefined;
+        reportUrl?: string | undefined;
+    }[];
+    regions: string[];
+    dataPolicy: {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors: string[];
+        policyUrl?: string | undefined;
+    };
+    availabilityScope: "internal_alia" | "public_payg" | "enterprise" | "byok_only" | "oxy_hosted";
+    commercialPermission: "standard_application_use" | "public_resale_approved" | "wholesale_contract" | "customer_byok" | "open_weight_hosting";
+    availableRevisions: string[];
+    servingProviders: {
+        displayName: string;
+        slug: string;
+        regions: string[];
+        dataPolicy: {
+            retainsPayloads: boolean;
+            retentionDays: number;
+            trainsOnCustomerData: boolean;
+            zeroDataRetentionAvailable: boolean;
+            subprocessors: string[];
+            policyUrl?: string | undefined;
+        };
+    }[];
+    description?: string | undefined;
+    knowledgeCutoff?: string | undefined;
+    releasedOn?: string | undefined;
+    modelCardUrl?: string | undefined;
+    safety?: {
+        contentFilteringDefault: "strict" | "none" | "provider_default";
+        knownLimitations: string[];
+        provenanceMarking: "none" | "visible_watermark" | "invisible_watermark" | "c2pa";
+        safetyCardUrl?: string | undefined;
+    } | undefined;
+    pricing?: {
+        currency: string;
+        priceVersionId: string;
+        unitPrices: {
+            amount: string & z.BRAND<"ExactDecimal">;
+            currency: string;
+            unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings";
+            per: number;
+        }[];
+    } | undefined;
+}, {
+    displayName: string;
+    schemaVersion: 1;
+    modelId: string;
+    publisher: {
+        displayName: string;
+        slug: string;
+        websiteUrl?: string | undefined;
+    };
+    capabilities: {
+        inputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        outputModalities: ("image" | "text" | "audio" | "video" | "embedding")[];
+        tools: boolean;
+        parallelToolCalls: boolean;
+        structuredOutput: boolean;
+        jsonMode: boolean;
+        reasoning: boolean;
+        streaming: boolean;
+        promptCaching: boolean;
+        maxContextTokens: number;
+        maxOutputTokens: number;
+    };
+    license: {
+        displayName: string;
+        licenseId: string;
+        commercialUseAllowed: boolean;
+        requiresAttribution: boolean;
+        url?: string | undefined;
+        acceptableUsePolicyUrl?: string | undefined;
+    };
+    provenance: {
+        releaseKind: "first_party_original" | "first_party_derived" | "open_weight" | "third_party_hosted";
+        baseModelId?: string | undefined;
+        trainingOrganization?: string | undefined;
+    };
+    currentRevision: string;
+    deprecation: {
+        status: "active" | "deprecated" | "retired";
+        replacementModelReference?: string | undefined;
+        announcedAt?: string | undefined;
+        sunsetAt?: string | undefined;
+    };
+    dataPolicy: {
+        retainsPayloads: boolean;
+        retentionDays: number;
+        trainsOnCustomerData: boolean;
+        zeroDataRetentionAvailable: boolean;
+        subprocessors?: string[] | undefined;
+        policyUrl?: string | undefined;
+    };
+    availabilityScope: "internal_alia" | "public_payg" | "enterprise" | "byok_only" | "oxy_hosted";
+    commercialPermission: "standard_application_use" | "public_resale_approved" | "wholesale_contract" | "customer_byok" | "open_weight_hosting";
+    availableRevisions: string[];
+    description?: string | undefined;
+    knowledgeCutoff?: string | undefined;
+    releasedOn?: string | undefined;
+    modelCardUrl?: string | undefined;
+    evaluations?: {
+        score: string;
+        suite: string;
+        metric: string;
+        evaluatedAt?: string | undefined;
+        reportUrl?: string | undefined;
+    }[] | undefined;
+    safety?: {
+        contentFilteringDefault: "strict" | "none" | "provider_default";
+        provenanceMarking: "none" | "visible_watermark" | "invisible_watermark" | "c2pa";
+        safetyCardUrl?: string | undefined;
+        knownLimitations?: string[] | undefined;
+    } | undefined;
+    regions?: string[] | undefined;
+    servingProviders?: {
+        displayName: string;
+        slug: string;
+        dataPolicy: {
+            retainsPayloads: boolean;
+            retentionDays: number;
+            trainsOnCustomerData: boolean;
+            zeroDataRetentionAvailable: boolean;
+            subprocessors?: string[] | undefined;
+            policyUrl?: string | undefined;
+        };
+        regions?: string[] | undefined;
+    }[] | undefined;
+    pricing?: {
+        currency: string;
+        priceVersionId: string;
+        unitPrices: {
+            amount: string;
+            currency: string;
+            unit: "input_tokens" | "cached_input_tokens" | "output_tokens" | "reasoning_tokens" | "requests" | "images" | "audio_input_milliseconds" | "audio_output_milliseconds" | "video_milliseconds" | "characters" | "embeddings";
+            per: number;
+        }[];
+    } | undefined;
+}>;
+export type InferenceModality = z.infer<typeof inferenceModalitySchema>;
+export type ModelCapabilities = z.infer<typeof modelCapabilitiesSchema>;
+export type ModelLicense = z.infer<typeof modelLicenseSchema>;
+export type ModelProvenance = z.infer<typeof modelProvenanceSchema>;
+export type InferenceDataPolicy = z.infer<typeof inferenceDataPolicySchema>;
+export type AvailabilityScope = z.infer<typeof availabilityScopeSchema>;
+export type CommercialPermission = z.infer<typeof commercialPermissionSchema>;
+export type ModelDeprecation = z.infer<typeof modelDeprecationSchema>;
+export type ModelEvaluationResult = z.infer<typeof modelEvaluationResultSchema>;
+export type ModelSafetyMetadata = z.infer<typeof modelSafetyMetadataSchema>;
+export type ModelPublisher = z.infer<typeof modelPublisherSchema>;
+export type CatalogueModel = z.infer<typeof catalogueModelSchema>;
+export type ModelRevision = z.infer<typeof modelRevisionSchema>;
+export type InferenceProvider = z.infer<typeof inferenceProviderSchema>;
+export type ModelDeployment = z.infer<typeof modelDeploymentSchema>;
+export type RoutingProfileCandidate = z.infer<typeof routingProfileCandidateSchema>;
+export type RoutingProfile = z.infer<typeof routingProfileSchema>;
+export type CataloguePublisherSummary = z.infer<typeof cataloguePublisherSummarySchema>;
+export type CatalogueServingProviderSummary = z.infer<typeof catalogueServingProviderSummarySchema>;
+export type ModelCatalogueEntry = z.infer<typeof modelCatalogueEntrySchema>;