@kaana.ai/contracts 0.0.0-stage → 4.4.0

package/dist/internal/catalogue.d.ts

@@ -0,0 +1,1059 @@
+/**
+ * The operational catalogue Oxy and Kaana share: deployments, providers and
+ * routing profiles. None of it is public: it names who serves a route.
+ *
+ * Moved from `@oxy.so/contracts` 4.12.0 (`src/inference/catalogue.ts`) by Kaana ADR 0002.
+ */
+import { z } from 'zod';
+/**
+ * Who a route may be served to. Availability to an official Oxy product 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<{
+    platform_internal: "platform_internal";
+    public_payg: "public_payg";
+    enterprise: "enterprise";
+    byok_only: "byok_only";
+    oxy_hosted: "oxy_hosted";
+}>;
+/** The commercial basis on which Oxy may serve a route. */
+export declare const commercialPermissionSchema: z.ZodEnum<{
+    standard_application_use: "standard_application_use";
+    public_resale_approved: "public_resale_approved";
+    wholesale_contract: "wholesale_contract";
+    customer_byok: "customer_byok";
+    open_weight_hosting: "open_weight_hosting";
+}>;
+/** Who released a model. Never a provider, and never a routing profile. */
+export declare const modelPublisherSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    publisherId: z.ZodString;
+    slug: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    websiteUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * 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.ZodObject<{
+    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: "text";
+            audio: "audio";
+            image: "image";
+            video: "video";
+            embedding: "embedding";
+        }>>;
+        outputModalities: z.ZodArray<z.ZodEnum<{
+            text: "text";
+            audio: "audio";
+            image: "image";
+            video: "video";
+            embedding: "embedding";
+            decisions: "decisions";
+        }>>;
+        tools: z.ZodBoolean;
+        parallelToolCalls: z.ZodBoolean;
+        structuredOutput: z.ZodBoolean;
+        jsonMode: z.ZodBoolean;
+        reasoning: z.ZodBoolean;
+        reasoningEfforts: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>>;
+        streaming: z.ZodBoolean;
+        promptCaching: z.ZodBoolean;
+        maxContextTokens: z.ZodNumber;
+        maxOutputTokens: z.ZodNumber;
+        apiFormats: z.ZodOptional<z.ZodArray<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";
+        }>>>;
+        realtime: z.ZodOptional<z.ZodObject<{
+            transports: z.ZodArray<z.ZodEnum<{
+                websocket: "websocket";
+            }>>;
+            sessionKinds: z.ZodArray<z.ZodEnum<{
+                conversation: "conversation";
+                transcription: "transcription";
+                translation: "translation";
+            }>>;
+            inputAudioTranscription: z.ZodOptional<z.ZodBoolean>;
+            audioFormats: z.ZodOptional<z.ZodObject<{
+                input: z.ZodArray<z.ZodEnum<{
+                    pcm16_24khz: "pcm16_24khz";
+                    g711_ulaw: "g711_ulaw";
+                    g711_alaw: "g711_alaw";
+                }>>;
+                output: z.ZodArray<z.ZodEnum<{
+                    pcm16_24khz: "pcm16_24khz";
+                    g711_ulaw: "g711_ulaw";
+                    g711_alaw: "g711_alaw";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    license: z.ZodObject<{
+        licenseId: z.ZodString;
+        displayName: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        commercialUseAllowed: z.ZodBoolean;
+        requiresAttribution: z.ZodBoolean;
+        acceptableUsePolicyUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    provenance: z.ZodObject<{
+        releaseKind: z.ZodEnum<{
+            first_party_original: "first_party_original";
+            first_party_derived: "first_party_derived";
+            open_weight: "open_weight";
+            third_party_hosted: "third_party_hosted";
+        }>;
+        baseModelId: z.ZodOptional<z.ZodString>;
+        trainingOrganization: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    knowledgeCutoff: z.ZodOptional<z.ZodString>;
+    releasedOn: z.ZodOptional<z.ZodString>;
+    currentRevision: z.ZodString;
+    deprecation: z.ZodObject<{
+        status: z.ZodEnum<{
+            active: "active";
+            deprecated: "deprecated";
+            retired: "retired";
+        }>;
+        replacementModelReference: z.ZodOptional<z.ZodString>;
+        announcedAt: z.ZodOptional<z.ZodString>;
+        sunsetAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strip>;
+/**
+ * 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.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    revisionId: z.ZodString;
+    modelId: z.ZodString;
+    revision: z.ZodString;
+    reference: z.ZodString;
+    releasedAt: z.ZodString;
+    retiredAt: z.ZodOptional<z.ZodString>;
+    artifactDigest: z.ZodOptional<z.ZodString>;
+    modelCardUrl: z.ZodOptional<z.ZodString>;
+    evaluations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        suite: z.ZodString;
+        metric: z.ZodString;
+        score: z.ZodString;
+        evaluatedAt: z.ZodOptional<z.ZodString>;
+        reportUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    safety: z.ZodOptional<z.ZodObject<{
+        safetyCardUrl: z.ZodOptional<z.ZodString>;
+        contentFilteringDefault: z.ZodEnum<{
+            none: "none";
+            provider_default: "provider_default";
+            strict: "strict";
+        }>;
+        knownLimitations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        provenanceMarking: z.ZodEnum<{
+            none: "none";
+            visible_watermark: "visible_watermark";
+            invisible_watermark: "invisible_watermark";
+            c2pa: "c2pa";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
+/** Who runs the weights for a route. */
+export declare const inferenceProviderSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    providerId: z.ZodString;
+    slug: z.ZodString;
+    displayName: z.ZodString;
+    kind: z.ZodEnum<{
+        oxy_hosted: "oxy_hosted";
+        customer_byok: "customer_byok";
+        third_party: "third_party";
+    }>;
+    websiteUrl: z.ZodOptional<z.ZodString>;
+    statusPageUrl: z.ZodOptional<z.ZodString>;
+    regions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    dataPolicy: z.ZodObject<{
+        retainsPayloads: z.ZodBoolean;
+        retentionDays: z.ZodNumber;
+        trainsOnCustomerData: z.ZodBoolean;
+        zeroDataRetentionAvailable: z.ZodBoolean;
+        subprocessors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        policyUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strip>;
+/**
+ * One concrete servable route: a revision, on a provider, with its attested
+ * regions, data policy, availability scope and commercial permission.
+ *
+ * `regions: []` means the provider supplied no location attestation. It never
+ * means global availability: Oxy excludes that route whenever a request carries
+ * any explicit regional control, while an unconstrained request may still use it.
+ *
+ * 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.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    deploymentId: z.ZodString;
+    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">;
+    }, z.core.$strict>>;
+    provider: z.ZodString;
+    modelReference: z.ZodString;
+    regions: z.ZodArray<z.ZodString>;
+    dataPolicy: z.ZodObject<{
+        retainsPayloads: z.ZodBoolean;
+        retentionDays: z.ZodNumber;
+        trainsOnCustomerData: z.ZodBoolean;
+        zeroDataRetentionAvailable: z.ZodBoolean;
+        subprocessors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        policyUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    availabilityScope: z.ZodEnum<{
+        platform_internal: "platform_internal";
+        public_payg: "public_payg";
+        enterprise: "enterprise";
+        byok_only: "byok_only";
+        oxy_hosted: "oxy_hosted";
+    }>;
+    commercialPermission: z.ZodEnum<{
+        standard_application_use: "standard_application_use";
+        public_resale_approved: "public_resale_approved";
+        wholesale_contract: "wholesale_contract";
+        customer_byok: "customer_byok";
+        open_weight_hosting: "open_weight_hosting";
+    }>;
+    status: z.ZodEnum<{
+        active: "active";
+        retired: "retired";
+        degraded: "degraded";
+        disabled: "disabled";
+    }>;
+    dedicatedCapacity: z.ZodBoolean;
+    priceVersionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * The commercial facts Kaana publishes about ONE deployment on the descriptors
+ * it serves to Oxy (`POST /internal/v1/deployments/query` and
+ * `/internal/v1/models/query`), from the reviewed file
+ * `configs/deployment-commercial.json`. A deployment that is not sold carries
+ * no `commercial` at all, which is why the member is optional on the
+ * descriptor. New in contract set 4.4.0.
+ *
+ * `customer_byok` is the commercial basis of a `byok_only` route and of no
+ * other: the two say the same thing and may not disagree.
+ */
+export declare const deploymentCommercialSchema: z.ZodObject<{
+    availabilityScope: z.ZodEnum<{
+        platform_internal: "platform_internal";
+        public_payg: "public_payg";
+        enterprise: "enterprise";
+        byok_only: "byok_only";
+        oxy_hosted: "oxy_hosted";
+    }>;
+    commercialPermission: z.ZodEnum<{
+        standard_application_use: "standard_application_use";
+        public_resale_approved: "public_resale_approved";
+        wholesale_contract: "wholesale_contract";
+        customer_byok: "customer_byok";
+        open_weight_hosting: "open_weight_hosting";
+    }>;
+    dedicatedCapacity: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+/** One candidate a profile may resolve to, and how strongly it is preferred. */
+export declare const routingProfileCandidateSchema: z.ZodObject<{
+    modelReference: z.ZodString;
+    priority: z.ZodNumber;
+}, z.core.$strict>;
+/**
+ * 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<{
+    schemaVersion: z.ZodLiteral<1>;
+    routingProfileId: z.ZodString;
+    slug: z.ZodString;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    optimiseFor: z.ZodEnum<{
+        quality: "quality";
+        price: "price";
+        latency: "latency";
+        throughput: "throughput";
+        balanced: "balanced";
+    }>;
+    candidates: z.ZodArray<z.ZodObject<{
+        modelReference: z.ZodString;
+        priority: z.ZodNumber;
+    }, z.core.$strict>>;
+    isProductPreset: z.ZodBoolean;
+    powerLevel: z.ZodOptional<z.ZodEnum<{
+        medium: "medium";
+        high: "high";
+        auto: "auto";
+        instant: "instant";
+        xhigh: "xhigh";
+        pro: "pro";
+        ultra: "ultra";
+    }>>;
+    reasoningEffort: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>>;
+}, z.core.$strip>;
+/**
+ * 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>>;
+    dataPolicy: z.ZodObject<{
+        retainsPayloads: z.ZodBoolean;
+        retentionDays: z.ZodNumber;
+        trainsOnCustomerData: z.ZodBoolean;
+        zeroDataRetentionAvailable: z.ZodBoolean;
+        subprocessors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        policyUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+/**
+ * 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<{
+    schemaVersion: z.ZodLiteral<3>;
+    modelId: z.ZodString;
+    publisher: z.ZodObject<{
+        slug: z.ZodString;
+        displayName: z.ZodString;
+        websiteUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    displayName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    currentRevision: z.ZodString;
+    availableRevisions: z.ZodArray<z.ZodString>;
+    capabilities: z.ZodObject<{
+        inputModalities: z.ZodArray<z.ZodEnum<{
+            text: "text";
+            audio: "audio";
+            image: "image";
+            video: "video";
+            embedding: "embedding";
+        }>>;
+        outputModalities: z.ZodArray<z.ZodEnum<{
+            text: "text";
+            audio: "audio";
+            image: "image";
+            video: "video";
+            embedding: "embedding";
+            decisions: "decisions";
+        }>>;
+        tools: z.ZodBoolean;
+        parallelToolCalls: z.ZodBoolean;
+        structuredOutput: z.ZodBoolean;
+        jsonMode: z.ZodBoolean;
+        reasoning: z.ZodBoolean;
+        reasoningEfforts: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>>;
+        streaming: z.ZodBoolean;
+        promptCaching: z.ZodBoolean;
+        maxContextTokens: z.ZodNumber;
+        maxOutputTokens: z.ZodNumber;
+        apiFormats: z.ZodOptional<z.ZodArray<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";
+        }>>>;
+        realtime: z.ZodOptional<z.ZodObject<{
+            transports: z.ZodArray<z.ZodEnum<{
+                websocket: "websocket";
+            }>>;
+            sessionKinds: z.ZodArray<z.ZodEnum<{
+                conversation: "conversation";
+                transcription: "transcription";
+                translation: "translation";
+            }>>;
+            inputAudioTranscription: z.ZodOptional<z.ZodBoolean>;
+            audioFormats: z.ZodOptional<z.ZodObject<{
+                input: z.ZodArray<z.ZodEnum<{
+                    pcm16_24khz: "pcm16_24khz";
+                    g711_ulaw: "g711_ulaw";
+                    g711_alaw: "g711_alaw";
+                }>>;
+                output: z.ZodArray<z.ZodEnum<{
+                    pcm16_24khz: "pcm16_24khz";
+                    g711_ulaw: "g711_ulaw";
+                    g711_alaw: "g711_alaw";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    license: z.ZodObject<{
+        licenseId: z.ZodString;
+        displayName: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        commercialUseAllowed: z.ZodBoolean;
+        requiresAttribution: z.ZodBoolean;
+        acceptableUsePolicyUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    provenance: z.ZodObject<{
+        releaseKind: z.ZodEnum<{
+            first_party_original: "first_party_original";
+            first_party_derived: "first_party_derived";
+            open_weight: "open_weight";
+            third_party_hosted: "third_party_hosted";
+        }>;
+        baseModelId: z.ZodOptional<z.ZodString>;
+        trainingOrganization: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    knowledgeCutoff: z.ZodOptional<z.ZodString>;
+    releasedOn: z.ZodOptional<z.ZodString>;
+    releasedAt: z.ZodOptional<z.ZodString>;
+    regions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    servingProviders: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        displayName: z.ZodString;
+        regions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        dataPolicy: z.ZodObject<{
+            retainsPayloads: z.ZodBoolean;
+            retentionDays: z.ZodNumber;
+            trainsOnCustomerData: z.ZodBoolean;
+            zeroDataRetentionAvailable: z.ZodBoolean;
+            subprocessors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            policyUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>>;
+    dataPolicy: z.ZodObject<{
+        retainsPayloads: z.ZodBoolean;
+        retentionDays: z.ZodNumber;
+        trainsOnCustomerData: z.ZodBoolean;
+        zeroDataRetentionAvailable: z.ZodBoolean;
+        subprocessors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        policyUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    pricing: z.ZodOptional<z.ZodObject<{
+        priceVersionId: z.ZodString;
+        currency: z.ZodString;
+        unitPrices: z.ZodArray<z.ZodObject<{
+            unit: z.ZodEnum<{
+                input_tokens: "input_tokens";
+                cached_input_tokens: "cached_input_tokens";
+                output_tokens: "output_tokens";
+                reasoning_tokens: "reasoning_tokens";
+                requests: "requests";
+                images: "images";
+                audio_input_milliseconds: "audio_input_milliseconds";
+                audio_output_milliseconds: "audio_output_milliseconds";
+                video_milliseconds: "video_milliseconds";
+                characters: "characters";
+                embeddings: "embeddings";
+                audio_input_tokens: "audio_input_tokens";
+                cached_audio_input_tokens: "cached_audio_input_tokens";
+                audio_output_tokens: "audio_output_tokens";
+                session_milliseconds: "session_milliseconds";
+                input_transcription_milliseconds: "input_transcription_milliseconds";
+            }>;
+            amount: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
+            per: z.ZodNumber;
+            currency: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    availabilityScope: z.ZodOptional<z.ZodEnum<{
+        platform_internal: "platform_internal";
+        public_payg: "public_payg";
+        enterprise: "enterprise";
+        byok_only: "byok_only";
+        oxy_hosted: "oxy_hosted";
+    }>>;
+    commercialPermission: z.ZodOptional<z.ZodEnum<{
+        standard_application_use: "standard_application_use";
+        public_resale_approved: "public_resale_approved";
+        wholesale_contract: "wholesale_contract";
+        customer_byok: "customer_byok";
+        open_weight_hosting: "open_weight_hosting";
+    }>>;
+    deprecation: z.ZodObject<{
+        status: z.ZodEnum<{
+            active: "active";
+            deprecated: "deprecated";
+            retired: "retired";
+        }>;
+        replacementModelReference: z.ZodOptional<z.ZodString>;
+        announcedAt: z.ZodOptional<z.ZodString>;
+        sunsetAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    evaluations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        suite: z.ZodString;
+        metric: z.ZodString;
+        score: z.ZodString;
+        evaluatedAt: z.ZodOptional<z.ZodString>;
+        reportUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    safety: z.ZodOptional<z.ZodObject<{
+        safetyCardUrl: z.ZodOptional<z.ZodString>;
+        contentFilteringDefault: z.ZodEnum<{
+            none: "none";
+            provider_default: "provider_default";
+            strict: "strict";
+        }>;
+        knownLimitations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        provenanceMarking: z.ZodEnum<{
+            none: "none";
+            visible_watermark: "visible_watermark";
+            invisible_watermark: "invisible_watermark";
+            c2pa: "c2pa";
+        }>;
+    }, z.core.$strict>>;
+    modelCardUrl: z.ZodOptional<z.ZodString>;
+    powerClass: z.ZodOptional<z.ZodEnum<{
+        medium: "medium";
+        high: "high";
+        instant: "instant";
+        pro: "pro";
+        ultra: "ultra";
+    }>>;
+}, z.core.$strip>;
+/**
+ * One model as Kaana DECLARES it in `configs/public-catalogue.json` (Kaana ADR
+ * 0002, amendment 2026-10-15): the public `modelSchema` without the three
+ * fields Kaana fills from its inventory when it serves `GET /v1/models`
+ * (`schemaVersion`, `currentRevision`, `availableRevisions`), plus the audience
+ * allowed to see it.
+ *
+ * Strict on purpose. A declared model carries no serving provider, no
+ * availability scope and no commercial permission: those are properties of a
+ * route, decided by the signed inventory and by Oxy's grant, and a file that
+ * named them would publish an operator on the customer surface.
+ */
+export declare const declaredModelSchema: z.ZodObject<{
+    audio: z.ZodOptional<z.ZodObject<{
+        voices: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            languages: z.ZodArray<z.ZodString>;
+            gender: z.ZodOptional<z.ZodEnum<{
+                female: "female";
+                male: "male";
+                neutral: "neutral";
+            }>>;
+        }, z.core.$strict>>;
+        languages: z.ZodArray<z.ZodString>;
+        audioFormats: z.ZodObject<{
+            input: z.ZodArray<z.ZodEnum<{
+                "audio/mpeg": "audio/mpeg";
+                "audio/wav": "audio/wav";
+                "audio/ogg": "audio/ogg";
+                "audio/aac": "audio/aac";
+                "audio/flac": "audio/flac";
+                "audio/pcm": "audio/pcm";
+                "audio/mp4": "audio/mp4";
+                "audio/webm": "audio/webm";
+            }>>;
+            output: z.ZodArray<z.ZodEnum<{
+                "audio/mpeg": "audio/mpeg";
+                "audio/wav": "audio/wav";
+                "audio/ogg": "audio/ogg";
+                "audio/aac": "audio/aac";
+                "audio/flac": "audio/flac";
+                "audio/pcm": "audio/pcm";
+            }>>;
+        }, z.core.$strict>;
+        speed: z.ZodOptional<z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+        }, z.core.$strict>>;
+        maxInputCharacters: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    displayName: z.ZodString;
+    modelId: z.ZodString;
+    publisher: z.ZodObject<{
+        slug: z.ZodString;
+        displayName: z.ZodString;
+        websiteUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    capabilities: z.ZodObject<{
+        inputModalities: z.ZodArray<z.ZodEnum<{
+            text: "text";
+            audio: "audio";
+            image: "image";
+            video: "video";
+            embedding: "embedding";
+        }>>;
+        outputModalities: z.ZodArray<z.ZodEnum<{
+            text: "text";
+            audio: "audio";
+            image: "image";
+            video: "video";
+            embedding: "embedding";
+            decisions: "decisions";
+        }>>;
+        tools: z.ZodBoolean;
+        parallelToolCalls: z.ZodBoolean;
+        structuredOutput: z.ZodBoolean;
+        jsonMode: z.ZodBoolean;
+        reasoning: z.ZodBoolean;
+        reasoningEfforts: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>>;
+        streaming: z.ZodBoolean;
+        promptCaching: z.ZodBoolean;
+        maxContextTokens: z.ZodNumber;
+        maxOutputTokens: z.ZodNumber;
+        apiFormats: z.ZodOptional<z.ZodArray<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";
+        }>>>;
+        realtime: z.ZodOptional<z.ZodObject<{
+            transports: z.ZodArray<z.ZodEnum<{
+                websocket: "websocket";
+            }>>;
+            sessionKinds: z.ZodArray<z.ZodEnum<{
+                conversation: "conversation";
+                transcription: "transcription";
+                translation: "translation";
+            }>>;
+            inputAudioTranscription: z.ZodOptional<z.ZodBoolean>;
+            audioFormats: z.ZodOptional<z.ZodObject<{
+                input: z.ZodArray<z.ZodEnum<{
+                    pcm16_24khz: "pcm16_24khz";
+                    g711_ulaw: "g711_ulaw";
+                    g711_alaw: "g711_alaw";
+                }>>;
+                output: z.ZodArray<z.ZodEnum<{
+                    pcm16_24khz: "pcm16_24khz";
+                    g711_ulaw: "g711_ulaw";
+                    g711_alaw: "g711_alaw";
+                }>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    license: z.ZodObject<{
+        licenseId: z.ZodString;
+        displayName: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        commercialUseAllowed: z.ZodBoolean;
+        requiresAttribution: z.ZodBoolean;
+        acceptableUsePolicyUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    provenance: z.ZodObject<{
+        releaseKind: z.ZodEnum<{
+            first_party_original: "first_party_original";
+            first_party_derived: "first_party_derived";
+            open_weight: "open_weight";
+            third_party_hosted: "third_party_hosted";
+        }>;
+        baseModelId: z.ZodOptional<z.ZodString>;
+        trainingOrganization: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    dataPolicy: z.ZodObject<{
+        retainsPayloads: z.ZodBoolean;
+        retentionDays: z.ZodNumber;
+        trainsOnCustomerData: z.ZodBoolean;
+        zeroDataRetentionAvailable: z.ZodBoolean;
+        subprocessors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        policyUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    deprecation: z.ZodObject<{
+        status: z.ZodEnum<{
+            active: "active";
+            deprecated: "deprecated";
+            retired: "retired";
+        }>;
+        replacementModelReference: z.ZodOptional<z.ZodString>;
+        announcedAt: z.ZodOptional<z.ZodString>;
+        sunsetAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    description: z.ZodOptional<z.ZodString>;
+    knowledgeCutoff: z.ZodOptional<z.ZodString>;
+    releasedOn: z.ZodOptional<z.ZodString>;
+    releasedAt: z.ZodOptional<z.ZodString>;
+    regions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    pricing: z.ZodOptional<z.ZodObject<{
+        priceVersionId: z.ZodString;
+        currency: z.ZodString;
+        unitPrices: z.ZodArray<z.ZodObject<{
+            unit: z.ZodEnum<{
+                input_tokens: "input_tokens";
+                cached_input_tokens: "cached_input_tokens";
+                output_tokens: "output_tokens";
+                reasoning_tokens: "reasoning_tokens";
+                requests: "requests";
+                images: "images";
+                audio_input_milliseconds: "audio_input_milliseconds";
+                audio_output_milliseconds: "audio_output_milliseconds";
+                video_milliseconds: "video_milliseconds";
+                characters: "characters";
+                embeddings: "embeddings";
+                audio_input_tokens: "audio_input_tokens";
+                cached_audio_input_tokens: "cached_audio_input_tokens";
+                audio_output_tokens: "audio_output_tokens";
+                session_milliseconds: "session_milliseconds";
+                input_transcription_milliseconds: "input_transcription_milliseconds";
+            }>;
+            amount: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
+            per: z.ZodNumber;
+            currency: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    evaluations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        suite: z.ZodString;
+        metric: z.ZodString;
+        score: z.ZodString;
+        evaluatedAt: z.ZodOptional<z.ZodString>;
+        reportUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    safety: z.ZodOptional<z.ZodObject<{
+        safetyCardUrl: z.ZodOptional<z.ZodString>;
+        contentFilteringDefault: z.ZodEnum<{
+            none: "none";
+            provider_default: "provider_default";
+            strict: "strict";
+        }>;
+        knownLimitations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        provenanceMarking: z.ZodEnum<{
+            none: "none";
+            visible_watermark: "visible_watermark";
+            invisible_watermark: "invisible_watermark";
+            c2pa: "c2pa";
+        }>;
+    }, z.core.$strict>>;
+    modelCardUrl: z.ZodOptional<z.ZodString>;
+    powerClass: z.ZodOptional<z.ZodEnum<{
+        medium: "medium";
+        high: "high";
+        instant: "instant";
+        pro: "pro";
+        ultra: "ultra";
+    }>>;
+    audience: z.ZodEnum<{
+        platform_internal: "platform_internal";
+        public: "public";
+    }>;
+}, z.core.$strict>;
+/**
+ * The declared catalogue: identity, publisher, licence, provenance, data
+ * policy, capabilities, voices and the LIST PRICE per unit of every model
+ * Kaana may serve. Kaana is its only source of truth. It is the file
+ * `configs/public-catalogue.json`, and the `declaredCatalogue` member of the
+ * signed `GET /internal/v1/models` response (contract set 4.3.0), from which
+ * Oxy reads the price it rates a grant at. New in contract set 4.3.0.
+ */
+export declare const declaredCatalogueSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    models: z.ZodArray<z.ZodObject<{
+        audio: z.ZodOptional<z.ZodObject<{
+            voices: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                languages: z.ZodArray<z.ZodString>;
+                gender: z.ZodOptional<z.ZodEnum<{
+                    female: "female";
+                    male: "male";
+                    neutral: "neutral";
+                }>>;
+            }, z.core.$strict>>;
+            languages: z.ZodArray<z.ZodString>;
+            audioFormats: z.ZodObject<{
+                input: z.ZodArray<z.ZodEnum<{
+                    "audio/mpeg": "audio/mpeg";
+                    "audio/wav": "audio/wav";
+                    "audio/ogg": "audio/ogg";
+                    "audio/aac": "audio/aac";
+                    "audio/flac": "audio/flac";
+                    "audio/pcm": "audio/pcm";
+                    "audio/mp4": "audio/mp4";
+                    "audio/webm": "audio/webm";
+                }>>;
+                output: z.ZodArray<z.ZodEnum<{
+                    "audio/mpeg": "audio/mpeg";
+                    "audio/wav": "audio/wav";
+                    "audio/ogg": "audio/ogg";
+                    "audio/aac": "audio/aac";
+                    "audio/flac": "audio/flac";
+                    "audio/pcm": "audio/pcm";
+                }>>;
+            }, z.core.$strict>;
+            speed: z.ZodOptional<z.ZodObject<{
+                min: z.ZodNumber;
+                max: z.ZodNumber;
+            }, z.core.$strict>>;
+            maxInputCharacters: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        displayName: z.ZodString;
+        modelId: z.ZodString;
+        publisher: z.ZodObject<{
+            slug: z.ZodString;
+            displayName: z.ZodString;
+            websiteUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        capabilities: z.ZodObject<{
+            inputModalities: z.ZodArray<z.ZodEnum<{
+                text: "text";
+                audio: "audio";
+                image: "image";
+                video: "video";
+                embedding: "embedding";
+            }>>;
+            outputModalities: z.ZodArray<z.ZodEnum<{
+                text: "text";
+                audio: "audio";
+                image: "image";
+                video: "video";
+                embedding: "embedding";
+                decisions: "decisions";
+            }>>;
+            tools: z.ZodBoolean;
+            parallelToolCalls: z.ZodBoolean;
+            structuredOutput: z.ZodBoolean;
+            jsonMode: z.ZodBoolean;
+            reasoning: z.ZodBoolean;
+            reasoningEfforts: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+            }>>>;
+            streaming: z.ZodBoolean;
+            promptCaching: z.ZodBoolean;
+            maxContextTokens: z.ZodNumber;
+            maxOutputTokens: z.ZodNumber;
+            apiFormats: z.ZodOptional<z.ZodArray<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";
+            }>>>;
+            realtime: z.ZodOptional<z.ZodObject<{
+                transports: z.ZodArray<z.ZodEnum<{
+                    websocket: "websocket";
+                }>>;
+                sessionKinds: z.ZodArray<z.ZodEnum<{
+                    conversation: "conversation";
+                    transcription: "transcription";
+                    translation: "translation";
+                }>>;
+                inputAudioTranscription: z.ZodOptional<z.ZodBoolean>;
+                audioFormats: z.ZodOptional<z.ZodObject<{
+                    input: z.ZodArray<z.ZodEnum<{
+                        pcm16_24khz: "pcm16_24khz";
+                        g711_ulaw: "g711_ulaw";
+                        g711_alaw: "g711_alaw";
+                    }>>;
+                    output: z.ZodArray<z.ZodEnum<{
+                        pcm16_24khz: "pcm16_24khz";
+                        g711_ulaw: "g711_ulaw";
+                        g711_alaw: "g711_alaw";
+                    }>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        license: z.ZodObject<{
+            licenseId: z.ZodString;
+            displayName: z.ZodString;
+            url: z.ZodOptional<z.ZodString>;
+            commercialUseAllowed: z.ZodBoolean;
+            requiresAttribution: z.ZodBoolean;
+            acceptableUsePolicyUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        provenance: z.ZodObject<{
+            releaseKind: z.ZodEnum<{
+                first_party_original: "first_party_original";
+                first_party_derived: "first_party_derived";
+                open_weight: "open_weight";
+                third_party_hosted: "third_party_hosted";
+            }>;
+            baseModelId: z.ZodOptional<z.ZodString>;
+            trainingOrganization: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        dataPolicy: z.ZodObject<{
+            retainsPayloads: z.ZodBoolean;
+            retentionDays: z.ZodNumber;
+            trainsOnCustomerData: z.ZodBoolean;
+            zeroDataRetentionAvailable: z.ZodBoolean;
+            subprocessors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            policyUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        deprecation: z.ZodObject<{
+            status: z.ZodEnum<{
+                active: "active";
+                deprecated: "deprecated";
+                retired: "retired";
+            }>;
+            replacementModelReference: z.ZodOptional<z.ZodString>;
+            announcedAt: z.ZodOptional<z.ZodString>;
+            sunsetAt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        description: z.ZodOptional<z.ZodString>;
+        knowledgeCutoff: z.ZodOptional<z.ZodString>;
+        releasedOn: z.ZodOptional<z.ZodString>;
+        releasedAt: z.ZodOptional<z.ZodString>;
+        regions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        pricing: z.ZodOptional<z.ZodObject<{
+            priceVersionId: z.ZodString;
+            currency: z.ZodString;
+            unitPrices: z.ZodArray<z.ZodObject<{
+                unit: z.ZodEnum<{
+                    input_tokens: "input_tokens";
+                    cached_input_tokens: "cached_input_tokens";
+                    output_tokens: "output_tokens";
+                    reasoning_tokens: "reasoning_tokens";
+                    requests: "requests";
+                    images: "images";
+                    audio_input_milliseconds: "audio_input_milliseconds";
+                    audio_output_milliseconds: "audio_output_milliseconds";
+                    video_milliseconds: "video_milliseconds";
+                    characters: "characters";
+                    embeddings: "embeddings";
+                    audio_input_tokens: "audio_input_tokens";
+                    cached_audio_input_tokens: "cached_audio_input_tokens";
+                    audio_output_tokens: "audio_output_tokens";
+                    session_milliseconds: "session_milliseconds";
+                    input_transcription_milliseconds: "input_transcription_milliseconds";
+                }>;
+                amount: z.core.$ZodBranded<z.ZodString, "ExactDecimal", "out">;
+                per: z.ZodNumber;
+                currency: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        evaluations: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            suite: z.ZodString;
+            metric: z.ZodString;
+            score: z.ZodString;
+            evaluatedAt: z.ZodOptional<z.ZodString>;
+            reportUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>;
+        safety: z.ZodOptional<z.ZodObject<{
+            safetyCardUrl: z.ZodOptional<z.ZodString>;
+            contentFilteringDefault: z.ZodEnum<{
+                none: "none";
+                provider_default: "provider_default";
+                strict: "strict";
+            }>;
+            knownLimitations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            provenanceMarking: z.ZodEnum<{
+                none: "none";
+                visible_watermark: "visible_watermark";
+                invisible_watermark: "invisible_watermark";
+                c2pa: "c2pa";
+            }>;
+        }, z.core.$strict>>;
+        modelCardUrl: z.ZodOptional<z.ZodString>;
+        powerClass: z.ZodOptional<z.ZodEnum<{
+            medium: "medium";
+            high: "high";
+            instant: "instant";
+            pro: "pro";
+            ultra: "ultra";
+        }>>;
+        audience: z.ZodEnum<{
+            platform_internal: "platform_internal";
+            public: "public";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type DeclaredModel = z.infer<typeof declaredModelSchema>;
+export type DeclaredCatalogue = z.infer<typeof declaredCatalogueSchema>;
+export type AvailabilityScope = z.infer<typeof availabilityScopeSchema>;
+export type CommercialPermission = z.infer<typeof commercialPermissionSchema>;
+export type DeploymentCommercial = z.infer<typeof deploymentCommercialSchema>;
+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 CatalogueServingProviderSummary = z.infer<typeof catalogueServingProviderSummarySchema>;
+export type ModelCatalogueEntry = z.infer<typeof modelCatalogueEntrySchema>;