@game-infra/ai-schemas 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Igor Savin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,149 @@
+# @game-infra/ai-schemas
+
+The [`ai-service`](../../../services/ai-service/README.md) API contract: how a
+provider, a coding-plan subscription and a routing preset are described, what an
+inference request and its answer look like, and the endpoint definitions that
+carry them.
+
+Published to npm, like the other `*-schemas` packages, because a game repo
+calling ai-service needs the contract without checking out the service.
+
+## Install
+
+```jsonc
+// package.json, in a sibling checkout
+{
+  "dependencies": {
+    "@game-infra/ai-schemas": "link:../game-infra/packages/schemas/ai-schemas",
+  },
+}
+```
+
+Or from the registry: `pnpm add @game-infra/ai-schemas`.
+
+## Usage
+
+Contracts carry their own method, path and schemas, so a client never restates a
+path:
+
+```ts
+import { aiGenerateTextContract, aiPresetRoutePlanContract } from "@game-infra/ai-schemas";
+import { sendByApiContract } from "@toad-contracts/frontend-http-client";
+
+const { result } = await sendByApiContract(client, aiGenerateTextContract, {
+  body: {
+    preset: "narrative",
+    messages: [{ role: "user", content: "A rusted door in a flooded corridor." }],
+  },
+});
+
+// Every answer reports which route served it, which failed on the way, and
+// which were never tried.
+result.body.route?.served.providerId;
+```
+
+```ts
+aiPresetRoutePlanContract.pathResolver({ slug: "narrative" }); // '/presets/narrative/route'
+```
+
+## What is in here
+
+| Module              | What it describes                                                   |
+| ------------------- | ------------------------------------------------------------------- |
+| `provider.ts`       | Providers, their tiers, dialects and model routes                   |
+| `subscription.ts`   | Coding-plan credentials and the vendor profiles that reach them     |
+| `preset.ts`         | Routing presets, route candidates, and why a route was excluded     |
+| `inference.ts`      | Messages, the three inference requests, and what an answer reports  |
+| `schemaRegistry.ts` | How a registered response schema is published                       |
+| `catalog.ts`        | Provider blueprints, and model discovery                            |
+| `featuredModels.ts` | The models surfaced by name, and the id each is reached under       |
+| `preference.ts`     | The two ordering folds the service and the console must agree about |
+| `contracts.ts`      | Every endpoint definition                                           |
+
+## The two tables worth knowing
+
+**Tiers** (`PROVIDER_TIERS`) are `subscription`, `direct`, `local`, `umbrella`,
+in the order they are tried by default. The axis is who pays: a coding plan is
+flat-rate quota already bought, a direct key is metered by the vendor that
+trained the model, a local server costs whatever the hardware costs, and a
+gateway resells at a markup. Expressing preference over tiers rather than over
+provider ids is what lets a deployment state its policy once instead of per
+model.
+
+**Subscription vendors** (`SUBSCRIPTION_VENDOR_PROFILES`) carry each plan's
+dialect, endpoint and auth scheme. Four of the five speak the Anthropic Messages
+dialect, because Claude Code is an Anthropic-API client and Z.ai, Moonshot and
+DeepSeek each publish an Anthropic-compatible endpoint precisely so it can be
+pointed at them; `codex` is the exception and speaks the OpenAI Responses shape.
+Every field is a default rather than a constant, and a stored subscription can
+override any of them: a vendor moving an endpoint should be a console edit
+rather than a release of this package.
+
+## Surfaced models
+
+`FEATURED_MODELS` names the handful of models worth reaching for a kind of work,
+and the id a gateway serves each under. Today that is creative writing —
+narration, dialogue, in-world prose — and all of it is reached through
+OpenRouter, because none of those four families is worth a direct account on its
+own and one key already reaches all of them.
+
+```ts
+import { featuredModelRoutes, featuredModelsFor } from "@game-infra/ai-schemas";
+
+featuredModelsFor("creative-writing").filter((model) => model.flagship);
+// aion, euryale, mistral-large, hermes
+
+featuredModelRoutes("openrouter");
+// [{ model: 'aion', providerModelId: 'aion-labs/aion-3.0' }, …] — save these on
+// the provider and a preset naming `aion` plans like any other model.
+```
+
+The list is advisory and reaches routing through exactly one door: an operator
+saves those routes onto a provider. Until then a surfaced model is a
+recommendation with an id attached, which is why nothing in the planner reads
+this table. Consumers should read it from ai-service's `GET /catalog` rather
+than importing it, so a repinned id arrives without a release.
+
+## Extension points
+
+- **`orderedTierPreference` / `orderedProviderPreference`** are exported because
+  the service and the console must not disagree about them: the preset editor
+  shows the resulting order as somebody drags rows, and a second copy of the
+  rule in Vue is a copy that eventually differs from the one a request takes.
+  Both **reorder and never filter**, so a preference stored before a tier
+  existed cannot silently make that tier unreachable.
+- **`SUBSCRIPTION_PASSWORD_HEADER`** names the header a request carries a
+  subscription unlock in. A header rather than a body field, for the same reason
+  the bearer token is one, and exported so a browser client can list it in its
+  CORS allowance — without which a preflight drops it and every subscription
+  route silently falls through to a metered provider.
+
+## What is deliberately not here
+
+**A model catalog.** A list of every model id baked into a released package is
+wrong within weeks, and wrong in the direction that hurts: it advertises models
+a deployment cannot actually reach, so the mistake surfaces as a failed request
+rather than as an empty picker. Model routes come from the provider itself,
+through ai-service's discovery endpoint, or from an operator typing them in.
+`PROVIDER_BLUEPRINTS` holds only the parts that do not go stale: which tier a
+provider belongs to, which dialect it speaks, and where it lives.
+
+`FEATURED_MODELS` is not that catalog and does not reintroduce it. It claims no
+inventory — it answers "which model should write this", which no `/models` call
+answers and no gateway's refresh changes — and it routes nothing until an
+operator saves it onto a provider.
+
+Three of the four dialects are HTTP shapes. `workers-ai` is the exception and
+names a transport rather than a wire format: Cloudflare Workers AI is reached
+through the consuming Worker's own `AI` binding, so a provider on that dialect
+has no base URL and no credential — the platform authorises the call.
+
+## Dependencies
+
+`@game-infra/api-schemas-core` (the shared response wrappers),
+`@toad-contracts/core` and `@toad-contracts/valibot`. `valibot` is a peer.
+
+## Consumers
+
+`services/ai-service`, `apps/ai-console`, and any game-repo service calling
+ai-service.

package/dist/catalog.d.ts

@@ -0,0 +1,137 @@
+import { type InferOutput } from "valibot";
+import { type CredentialKind, type ProviderDialect, type ProviderTier } from "./provider.js";
+/**
+ * The out-of-the-box provider blueprints.
+ *
+ * A blueprint is the part of a provider nobody should have to look up: which
+ * tier it belongs to, which dialect it speaks, and where it lives. It is not a
+ * configured provider and holds no credential; the console offers these as
+ * starting points and writes a real provider record from the one an operator
+ * picks, at which point every field becomes editable.
+ *
+ * What is deliberately NOT here is a list of models. A model list baked into a
+ * released package is wrong within weeks and wrong in the direction that
+ * matters, because it advertises models a deployment cannot actually reach.
+ * Model routes come from the provider itself, through the discovery endpoint,
+ * or from an operator typing them in.
+ *
+ * The surfaced models in `featuredModels.ts` are not that list and do not
+ * contradict this one. They claim no inventory: they name the handful of models
+ * worth reaching for a kind of work, which is a judgement no `/models` call
+ * answers, and they become routable only once an operator saves them onto a
+ * provider.
+ */
+export interface ProviderBlueprint {
+    /** The `providerId` a created provider gets by default. */
+    providerId: string;
+    /** Display name. */
+    name: string;
+    tier: ProviderTier;
+    dialect: ProviderDialect;
+    credentialKind: CredentialKind;
+    /**
+     * Where it lives. Absent for the two first-party dialects, whose SDKs carry
+     * their own host, and for the self-hosted gateways and local runners, which
+     * have no public instance to point at and resolve only once an operator says
+     * where theirs is.
+     */
+    baseUrl?: string;
+    /** One line on what this provider is for, shown under its name in the picker. */
+    note: string;
+}
+/**
+ * The blueprints, in the order the console offers them: the model vendors
+ * first, then the gateways that resell them, then the servers an operator runs.
+ */
+export declare const PROVIDER_BLUEPRINTS: readonly ProviderBlueprint[];
+/** A blueprint, on the wire. */
+export declare const ProviderBlueprintSchema: import("valibot").ObjectSchema<{
+    readonly providerId: import("valibot").StringSchema<undefined>;
+    readonly name: import("valibot").StringSchema<undefined>;
+    readonly tier: import("valibot").PicklistSchema<readonly ["subscription", "direct", "local", "umbrella"], undefined>;
+    readonly dialect: import("valibot").PicklistSchema<readonly ["openai", "anthropic", "openai-compatible", "workers-ai"], undefined>;
+    readonly credentialKind: import("valibot").PicklistSchema<readonly ["api-key", "subscription", "none"], undefined>;
+    readonly baseUrl: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+    readonly note: import("valibot").StringSchema<undefined>;
+}, undefined>;
+/** A subscription vendor the console can offer, with what it takes to store one. */
+export declare const SubscriptionVendorOptionSchema: import("valibot").ObjectSchema<{
+    readonly vendor: import("valibot").StringSchema<undefined>;
+    readonly label: import("valibot").StringSchema<undefined>;
+    readonly baseUrl: import("valibot").StringSchema<undefined>;
+    readonly dialect: import("valibot").StringSchema<undefined>;
+    /** Where the credential goes: `bearer` or `api-key`. */
+    readonly authScheme: import("valibot").StringSchema<undefined>;
+    /** Whether the vendor licenses the plan to one named individual. */
+    readonly individualOnly: import("valibot").BooleanSchema<undefined>;
+}, undefined>;
+/**
+ * Everything the console needs to render its "add a provider" screens without
+ * restating this package's tables in Vue.
+ */
+export declare const CatalogResponseSchema: import("valibot").ObjectSchema<{
+    readonly success: import("valibot").BooleanSchema<undefined>;
+    readonly error: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+} & {
+    providers: import("valibot").OptionalSchema<import("valibot").ArraySchema<import("valibot").ObjectSchema<{
+        readonly providerId: import("valibot").StringSchema<undefined>;
+        readonly name: import("valibot").StringSchema<undefined>;
+        readonly tier: import("valibot").PicklistSchema<readonly ["subscription", "direct", "local", "umbrella"], undefined>;
+        readonly dialect: import("valibot").PicklistSchema<readonly ["openai", "anthropic", "openai-compatible", "workers-ai"], undefined>;
+        readonly credentialKind: import("valibot").PicklistSchema<readonly ["api-key", "subscription", "none"], undefined>;
+        readonly baseUrl: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+        readonly note: import("valibot").StringSchema<undefined>;
+    }, undefined>, undefined>, undefined>;
+    subscriptionVendors: import("valibot").OptionalSchema<import("valibot").ArraySchema<import("valibot").ObjectSchema<{
+        readonly vendor: import("valibot").StringSchema<undefined>;
+        readonly label: import("valibot").StringSchema<undefined>;
+        readonly baseUrl: import("valibot").StringSchema<undefined>;
+        readonly dialect: import("valibot").StringSchema<undefined>;
+        /** Where the credential goes: `bearer` or `api-key`. */
+        readonly authScheme: import("valibot").StringSchema<undefined>;
+        /** Whether the vendor licenses the plan to one named individual. */
+        readonly individualOnly: import("valibot").BooleanSchema<undefined>;
+    }, undefined>, undefined>, undefined>;
+    tiers: import("valibot").OptionalSchema<import("valibot").ArraySchema<import("valibot").PicklistSchema<readonly ["subscription", "direct", "local", "umbrella"], undefined>, undefined>, undefined>;
+    /** The built-in tier order, so the preset editor can show what "default" means. */
+    defaultTierPreference: import("valibot").OptionalSchema<import("valibot").ArraySchema<import("valibot").PicklistSchema<readonly ["subscription", "direct", "local", "umbrella"], undefined>, undefined>, undefined>;
+    /**
+     * The models this deployment surfaces by name, with the id each is reached
+     * under. Served rather than imported for the same reason the blueprints are:
+     * a consumer built against an older contract package would otherwise offer a
+     * model this service has since repinned, and the mistake would surface as a
+     * request that stopped answering.
+     */
+    featuredModels: import("valibot").OptionalSchema<import("valibot").ArraySchema<import("valibot").ObjectSchema<{
+        readonly model: import("valibot").StringSchema<undefined>;
+        readonly label: import("valibot").StringSchema<undefined>;
+        readonly purpose: import("valibot").PicklistSchema<readonly ["creative-writing"], undefined>;
+        readonly providerId: import("valibot").StringSchema<undefined>;
+        readonly providerModelId: import("valibot").StringSchema<undefined>;
+        readonly flagship: import("valibot").BooleanSchema<undefined>;
+        readonly note: import("valibot").StringSchema<undefined>;
+    }, undefined>, undefined>, undefined>;
+}, undefined>;
+export type CatalogResponse = InferOutput<typeof CatalogResponseSchema>;
+/**
+ * Model ids a provider says it serves.
+ *
+ * Read from the provider, never from a table here: an operator adding a gateway
+ * wants the models that gateway has today, and the endpoint that answers that
+ * question is the gateway's own. A provider whose dialect has no such endpoint
+ * reports `supported: false` rather than an empty list, because "this provider
+ * serves nothing" and "there is no way to ask" are different facts and only one
+ * of them means the operator should type the ids in by hand.
+ */
+export declare const DiscoveredModelsResponseSchema: import("valibot").ObjectSchema<{
+    readonly success: import("valibot").BooleanSchema<undefined>;
+    readonly error: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+} & {
+    providerId: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+    supported: import("valibot").OptionalSchema<import("valibot").BooleanSchema<undefined>, undefined>;
+    models: import("valibot").OptionalSchema<import("valibot").ArraySchema<import("valibot").StringSchema<undefined>, undefined>, undefined>;
+    /** Why discovery could not answer, when it could not. */
+    failure: import("valibot").OptionalSchema<import("valibot").StringSchema<undefined>, undefined>;
+}, undefined>;
+export type DiscoveredModelsResponse = InferOutput<typeof DiscoveredModelsResponseSchema>;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAA4C,MAAM,SAAS,CAAC;AAErF,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,eAAe,EAEpB,KAAK,YAAY,EAGlB,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,eAAe,CAAC;IACzB,cAAc,EAAE,cAAc,CAAC;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,iBAAiB,EAgJ3D,CAAC;AAEF,gCAAgC;AAChC,eAAO,MAAM,uBAAuB;;;;;;;;aAQlC,CAAC;AAEH,oFAAoF;AACpF,eAAO,MAAM,8BAA8B;;;;;IAKzC,wDAAwD;;IAExD,oEAAoE;;aAEpE,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;QAVhC,wDAAwD;;QAExD,oEAAoE;;;;IAYpE,mFAAmF;;IAEnF;;;;;;OAMG;;;;;;;;;;aAEH,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAExE;;;;;;;;;GASG;AACH,eAAO,MAAM,8BAA8B;;;;;;;IAIzC,yDAAyD;;aAEzD,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,WAAW,CAAC,OAAO,8BAA8B,CAAC,CAAC"}

package/dist/catalog.js

@@ -0,0 +1,209 @@
+import { createSuccessResponseSchema } from "@game-infra/api-schemas-core";
+import { array, boolean, object, optional, string } from "valibot";
+import { FeaturedModelSchema } from "./featuredModels.js";
+import { ProviderDialectSchema, CredentialKindSchema, ProviderTierSchema, } from "./provider.js";
+/**
+ * The blueprints, in the order the console offers them: the model vendors
+ * first, then the gateways that resell them, then the servers an operator runs.
+ */
+export const PROVIDER_BLUEPRINTS = [
+    {
+        providerId: "openai",
+        name: "OpenAI",
+        tier: "direct",
+        dialect: "openai",
+        credentialKind: "api-key",
+        note: "OpenAI's own API. Native structured outputs.",
+    },
+    {
+        providerId: "anthropic",
+        name: "Anthropic",
+        tier: "direct",
+        dialect: "anthropic",
+        credentialKind: "api-key",
+        note: "Anthropic's own API. Native tool-schema structured outputs and prompt caching.",
+    },
+    {
+        providerId: "google",
+        name: "Google Gemini",
+        tier: "direct",
+        dialect: "openai-compatible",
+        credentialKind: "api-key",
+        baseUrl: "https://generativelanguage.googleapis.com/v1beta/openai",
+        note: "Gemini through Google's OpenAI-compatible endpoint.",
+    },
+    {
+        providerId: "mistral",
+        name: "Mistral",
+        tier: "direct",
+        dialect: "openai-compatible",
+        credentialKind: "api-key",
+        baseUrl: "https://api.mistral.ai/v1",
+        note: "Mistral's own API.",
+    },
+    {
+        providerId: "deepseek",
+        name: "DeepSeek",
+        tier: "direct",
+        dialect: "openai-compatible",
+        credentialKind: "api-key",
+        baseUrl: "https://api.deepseek.com",
+        note: "DeepSeek's own API.",
+    },
+    {
+        providerId: "qwen",
+        name: "Qwen (DashScope)",
+        tier: "direct",
+        dialect: "openai-compatible",
+        credentialKind: "api-key",
+        baseUrl: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
+        note: "Alibaba's shared DashScope domain. An account with a workspace-dedicated domain " +
+            "replaces this base URL with its own.",
+    },
+    {
+        providerId: "moonshot",
+        name: "Moonshot (Kimi)",
+        tier: "direct",
+        dialect: "openai-compatible",
+        credentialKind: "api-key",
+        baseUrl: "https://api.moonshot.ai/v1",
+        note: "Moonshot's own API.",
+    },
+    {
+        providerId: "xai",
+        name: "xAI",
+        tier: "direct",
+        dialect: "openai-compatible",
+        credentialKind: "api-key",
+        baseUrl: "https://api.x.ai/v1",
+        note: "xAI's own API.",
+    },
+    {
+        providerId: "openrouter",
+        name: "OpenRouter",
+        tier: "umbrella",
+        dialect: "openai-compatible",
+        credentialKind: "api-key",
+        baseUrl: "https://openrouter.ai/api/v1",
+        note: "One key for most vendors' models, at a resale price. The usual first fallback.",
+    },
+    {
+        providerId: "workers-ai",
+        name: "Cloudflare Workers AI",
+        tier: "umbrella",
+        dialect: "workers-ai",
+        credentialKind: "none",
+        note: "Cloudflare's hosted models through ai-service's own AI binding. No account id, no API " +
+            "token and no egress: the call is served inside the runtime. Add it and it works.",
+    },
+    {
+        providerId: "bifrost",
+        name: "Bifrost",
+        tier: "umbrella",
+        dialect: "openai-compatible",
+        credentialKind: "api-key",
+        note: "A self-hosted gateway. No public instance, so it resolves only once its URL is set.",
+    },
+    {
+        providerId: "litellm",
+        name: "LiteLLM",
+        tier: "umbrella",
+        dialect: "openai-compatible",
+        credentialKind: "api-key",
+        note: "A self-hosted gateway. Model ids are the operator's own config.yaml aliases.",
+    },
+    {
+        providerId: "vllm",
+        name: "vLLM",
+        tier: "local",
+        dialect: "openai-compatible",
+        credentialKind: "none",
+        baseUrl: "http://localhost:8000/v1",
+        note: "A vLLM server. Serves whatever weights it was started with.",
+    },
+    {
+        providerId: "ollama",
+        name: "Ollama",
+        tier: "local",
+        dialect: "openai-compatible",
+        credentialKind: "none",
+        baseUrl: "http://localhost:11434/v1",
+        note: "An Ollama server. Model ids are the tags it has pulled.",
+    },
+    {
+        providerId: "lmstudio",
+        name: "LM Studio",
+        tier: "local",
+        dialect: "openai-compatible",
+        credentialKind: "none",
+        baseUrl: "http://localhost:1234/v1",
+        note: "An LM Studio server.",
+    },
+    {
+        providerId: "llamacpp",
+        name: "llama.cpp",
+        tier: "local",
+        dialect: "openai-compatible",
+        credentialKind: "none",
+        baseUrl: "http://localhost:8080/v1",
+        note: "A llama-server instance.",
+    },
+];
+/** A blueprint, on the wire. */
+export const ProviderBlueprintSchema = object({
+    providerId: string(),
+    name: string(),
+    tier: ProviderTierSchema,
+    dialect: ProviderDialectSchema,
+    credentialKind: CredentialKindSchema,
+    baseUrl: optional(string()),
+    note: string(),
+});
+/** A subscription vendor the console can offer, with what it takes to store one. */
+export const SubscriptionVendorOptionSchema = object({
+    vendor: string(),
+    label: string(),
+    baseUrl: string(),
+    dialect: string(),
+    /** Where the credential goes: `bearer` or `api-key`. */
+    authScheme: string(),
+    /** Whether the vendor licenses the plan to one named individual. */
+    individualOnly: boolean(),
+});
+/**
+ * Everything the console needs to render its "add a provider" screens without
+ * restating this package's tables in Vue.
+ */
+export const CatalogResponseSchema = createSuccessResponseSchema({
+    providers: optional(array(ProviderBlueprintSchema)),
+    subscriptionVendors: optional(array(SubscriptionVendorOptionSchema)),
+    tiers: optional(array(ProviderTierSchema)),
+    /** The built-in tier order, so the preset editor can show what "default" means. */
+    defaultTierPreference: optional(array(ProviderTierSchema)),
+    /**
+     * The models this deployment surfaces by name, with the id each is reached
+     * under. Served rather than imported for the same reason the blueprints are:
+     * a consumer built against an older contract package would otherwise offer a
+     * model this service has since repinned, and the mistake would surface as a
+     * request that stopped answering.
+     */
+    featuredModels: optional(array(FeaturedModelSchema)),
+});
+/**
+ * Model ids a provider says it serves.
+ *
+ * Read from the provider, never from a table here: an operator adding a gateway
+ * wants the models that gateway has today, and the endpoint that answers that
+ * question is the gateway's own. A provider whose dialect has no such endpoint
+ * reports `supported: false` rather than an empty list, because "this provider
+ * serves nothing" and "there is no way to ask" are different facts and only one
+ * of them means the operator should type the ids in by hand.
+ */
+export const DiscoveredModelsResponseSchema = createSuccessResponseSchema({
+    providerId: optional(string()),
+    supported: optional(boolean()),
+    models: optional(array(string())),
+    /** Why discovery could not answer, when it could not. */
+    failure: optional(string()),
+});
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"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"}