@game-infra/ai-schemas 0.3.0

package/dist/contracts.d.ts.map

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

package/dist/contracts.js

@@ -0,0 +1,243 @@
+import { ContractNoBody, defineApiContract, withObjectKeys } from "@toad-contracts/valibot";
+import { object, string } from "valibot";
+import { CatalogResponseSchema, DiscoveredModelsResponseSchema } from "./catalog.js";
+import { GenerateObjectRequestSchema, GenerateObjectResponseSchema, GenerateTextRequestSchema, GenerateTextResponseSchema, } from "./inference.js";
+import { CreatePresetRequestSchema, PresetListResponseSchema, PresetResponseSchema, RoutePlanResponseSchema, UpdatePresetRequestSchema, } from "./preset.js";
+import { CreateProviderRequestSchema, ProviderListResponseSchema, ProviderProbeResponseSchema, ProviderResponseSchema, SetProviderCredentialRequestSchema, UpdateProviderRequestSchema, } from "./provider.js";
+import { SchemaListResponseSchema, SchemaResponseSchema } from "./schemaRegistry.js";
+import { AiReadinessResponseSchema, CallListQuerySchema, CallListResponseSchema, DeleteResponseSchema, } from "./service.js";
+import { CreateSubscriptionRequestSchema, SubscriptionListResponseSchema, SubscriptionResponseSchema, UnlockSubscriptionRequestSchema, UnlockSubscriptionResponseSchema, UpdateSubscriptionRequestSchema, } from "./subscription.js";
+/**
+ * Typed endpoint contracts for the ai-service API.
+ *
+ * Each contract carries its method, path, params and request/response schemas
+ * in one object: `pathResolver` builds the URL and `mapApiContractToPath`
+ * derives the `:param` route pattern, so the service and the console never
+ * restate a path. Wire them into a Hono app with `@toad-contracts/hono` and
+ * into a browser client with `@toad-contracts/frontend-http-client`.
+ *
+ * The surface splits in two, and the split is deliberate. `/generate/*` is what
+ * game services call at runtime and is the only part that has to be fast and
+ * boring. Everything else configures it, is used by people rather than by
+ * programs, and is guarded by a separate claim, because a token that may ask a
+ * model a question should not thereby be able to read out which keys exist.
+ *
+ * @example
+ * ```ts
+ * import { aiGenerateTextContract, aiPresetGetContract } from '@game-infra/ai-schemas'
+ *
+ * aiGenerateTextContract.pathResolver() // '/generate/text'
+ * aiPresetGetContract.pathResolver({ presetId: 'pst_1' }) // '/presets/pst_1'
+ * ```
+ */
+const providerParams = withObjectKeys(object({ providerId: string() }));
+const subscriptionParams = withObjectKeys(object({ subscriptionId: string() }));
+const presetParams = withObjectKeys(object({ presetId: string() }));
+const presetSlugParams = withObjectKeys(object({ slug: string() }));
+const schemaParams = withObjectKeys(object({ schemaId: string() }));
+// ============================================================================
+// Service
+// ============================================================================
+export const aiReadinessContract = defineApiContract({
+    method: "get",
+    pathResolver: () => "/readiness",
+    responsesByStatusCode: { 200: AiReadinessResponseSchema },
+});
+/** Everything the console needs to render its provider pickers. */
+export const aiCatalogContract = defineApiContract({
+    method: "get",
+    pathResolver: () => "/catalog",
+    responsesByStatusCode: { 200: CatalogResponseSchema },
+});
+/** Recent calls and their per-provider fold. */
+export const aiCallListContract = defineApiContract({
+    method: "get",
+    pathResolver: () => "/calls",
+    requestQuerySchema: CallListQuerySchema,
+    responsesByStatusCode: { 200: CallListResponseSchema },
+});
+// ============================================================================
+// Providers
+// ============================================================================
+export const aiProviderListContract = defineApiContract({
+    method: "get",
+    pathResolver: () => "/providers",
+    responsesByStatusCode: { 200: ProviderListResponseSchema },
+});
+export const aiProviderCreateContract = defineApiContract({
+    method: "post",
+    pathResolver: () => "/providers",
+    requestBodySchema: CreateProviderRequestSchema,
+    responsesByStatusCode: { 201: ProviderResponseSchema },
+});
+export const aiProviderGetContract = defineApiContract({
+    method: "get",
+    requestPathParamsSchema: providerParams,
+    pathResolver: ({ providerId }) => `/providers/${providerId}`,
+    responsesByStatusCode: { 200: ProviderResponseSchema },
+});
+export const aiProviderUpdateContract = defineApiContract({
+    method: "patch",
+    requestPathParamsSchema: providerParams,
+    pathResolver: ({ providerId }) => `/providers/${providerId}`,
+    requestBodySchema: UpdateProviderRequestSchema,
+    responsesByStatusCode: { 200: ProviderResponseSchema },
+});
+export const aiProviderDeleteContract = defineApiContract({
+    method: "delete",
+    requestPathParamsSchema: providerParams,
+    pathResolver: ({ providerId }) => `/providers/${providerId}`,
+    responsesByStatusCode: { 200: DeleteResponseSchema },
+});
+/** Seal a key for a provider, replacing whatever was stored. */
+export const aiProviderCredentialSetContract = defineApiContract({
+    method: "put",
+    requestPathParamsSchema: providerParams,
+    pathResolver: ({ providerId }) => `/providers/${providerId}/credential`,
+    requestBodySchema: SetProviderCredentialRequestSchema,
+    responsesByStatusCode: { 200: ProviderResponseSchema },
+});
+export const aiProviderCredentialDeleteContract = defineApiContract({
+    method: "delete",
+    requestPathParamsSchema: providerParams,
+    pathResolver: ({ providerId }) => `/providers/${providerId}/credential`,
+    responsesByStatusCode: { 200: ProviderResponseSchema },
+});
+/** Call the provider for real and report what came back. */
+export const aiProviderProbeContract = defineApiContract({
+    method: "post",
+    requestPathParamsSchema: providerParams,
+    pathResolver: ({ providerId }) => `/providers/${providerId}/probe`,
+    requestBodySchema: ContractNoBody,
+    responsesByStatusCode: { 200: ProviderProbeResponseSchema },
+});
+/** Ask the provider which models it serves. */
+export const aiProviderModelsContract = defineApiContract({
+    method: "get",
+    requestPathParamsSchema: providerParams,
+    pathResolver: ({ providerId }) => `/providers/${providerId}/models`,
+    responsesByStatusCode: { 200: DiscoveredModelsResponseSchema },
+});
+// ============================================================================
+// Subscriptions
+// ============================================================================
+export const aiSubscriptionListContract = defineApiContract({
+    method: "get",
+    pathResolver: () => "/subscriptions",
+    responsesByStatusCode: { 200: SubscriptionListResponseSchema },
+});
+export const aiSubscriptionCreateContract = defineApiContract({
+    method: "post",
+    pathResolver: () => "/subscriptions",
+    requestBodySchema: CreateSubscriptionRequestSchema,
+    responsesByStatusCode: { 201: SubscriptionResponseSchema },
+});
+export const aiSubscriptionUpdateContract = defineApiContract({
+    method: "patch",
+    requestPathParamsSchema: subscriptionParams,
+    pathResolver: ({ subscriptionId }) => `/subscriptions/${subscriptionId}`,
+    requestBodySchema: UpdateSubscriptionRequestSchema,
+    responsesByStatusCode: { 200: SubscriptionResponseSchema },
+});
+export const aiSubscriptionDeleteContract = defineApiContract({
+    method: "delete",
+    requestPathParamsSchema: subscriptionParams,
+    pathResolver: ({ subscriptionId }) => `/subscriptions/${subscriptionId}`,
+    responsesByStatusCode: { 200: DeleteResponseSchema },
+});
+/** Check that a password opens the seal, without spending anything on a model. */
+export const aiSubscriptionUnlockContract = defineApiContract({
+    method: "post",
+    requestPathParamsSchema: subscriptionParams,
+    pathResolver: ({ subscriptionId }) => `/subscriptions/${subscriptionId}/unlock`,
+    requestBodySchema: UnlockSubscriptionRequestSchema,
+    responsesByStatusCode: { 200: UnlockSubscriptionResponseSchema },
+});
+// ============================================================================
+// Presets
+// ============================================================================
+export const aiPresetListContract = defineApiContract({
+    method: "get",
+    pathResolver: () => "/presets",
+    responsesByStatusCode: { 200: PresetListResponseSchema },
+});
+export const aiPresetCreateContract = defineApiContract({
+    method: "post",
+    pathResolver: () => "/presets",
+    requestBodySchema: CreatePresetRequestSchema,
+    responsesByStatusCode: { 201: PresetResponseSchema },
+});
+export const aiPresetGetContract = defineApiContract({
+    method: "get",
+    requestPathParamsSchema: presetParams,
+    pathResolver: ({ presetId }) => `/presets/${presetId}`,
+    responsesByStatusCode: { 200: PresetResponseSchema },
+});
+export const aiPresetUpdateContract = defineApiContract({
+    method: "patch",
+    requestPathParamsSchema: presetParams,
+    pathResolver: ({ presetId }) => `/presets/${presetId}`,
+    requestBodySchema: UpdatePresetRequestSchema,
+    responsesByStatusCode: { 200: PresetResponseSchema },
+});
+export const aiPresetDeleteContract = defineApiContract({
+    method: "delete",
+    requestPathParamsSchema: presetParams,
+    pathResolver: ({ presetId }) => `/presets/${presetId}`,
+    responsesByStatusCode: { 200: DeleteResponseSchema },
+});
+/**
+ * The routes a preset would take against the current configuration, without
+ * calling anything. Addressed by slug rather than by id, because that is what a
+ * caller writes into a request and therefore what somebody debugging one has in
+ * front of them.
+ */
+export const aiPresetRoutePlanContract = defineApiContract({
+    method: "get",
+    requestPathParamsSchema: presetSlugParams,
+    pathResolver: ({ slug }) => `/presets/${slug}/route`,
+    responsesByStatusCode: { 200: RoutePlanResponseSchema },
+});
+// ============================================================================
+// Request schemas
+// ============================================================================
+export const aiSchemaListContract = defineApiContract({
+    method: "get",
+    pathResolver: () => "/schemas",
+    responsesByStatusCode: { 200: SchemaListResponseSchema },
+});
+export const aiSchemaGetContract = defineApiContract({
+    method: "get",
+    requestPathParamsSchema: schemaParams,
+    pathResolver: ({ schemaId }) => `/schemas/${schemaId}`,
+    responsesByStatusCode: { 200: SchemaResponseSchema },
+});
+// ============================================================================
+// Inference
+// ============================================================================
+export const aiGenerateTextContract = defineApiContract({
+    method: "post",
+    pathResolver: () => "/generate/text",
+    requestBodySchema: GenerateTextRequestSchema,
+    responsesByStatusCode: { 200: GenerateTextResponseSchema },
+});
+export const aiGenerateObjectContract = defineApiContract({
+    method: "post",
+    pathResolver: () => "/generate/object",
+    requestBodySchema: GenerateObjectRequestSchema,
+    responsesByStatusCode: { 200: GenerateObjectResponseSchema },
+});
+/**
+ * The streaming twin of {@link aiGenerateTextContract}.
+ *
+ * It declares no success response because it does not answer with one: the body
+ * is an SSE stream whose events are described by `STREAM_EVENTS`, and a schema
+ * claiming a JSON body would be a lie a generated client would then act on.
+ */
+export const aiGenerateStreamContract = defineApiContract({
+    method: "post",
+    pathResolver: () => "/generate/stream",
+    requestBodySchema: GenerateTextRequestSchema,
+    responsesByStatusCode: {},
+});
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

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

package/dist/featuredModels.d.ts

@@ -0,0 +1,95 @@
+import { type InferOutput } from "valibot";
+import type { ProviderModelRoute } from "./provider.js";
+/**
+ * The models this deployment surfaces by name, and the id a gateway serves each
+ * under.
+ *
+ * A provider blueprint deliberately carries no model list, because an inventory
+ * of what a gateway serves is wrong within weeks and wrong in the direction
+ * that hurts — it advertises models a deployment cannot reach. This list is a
+ * different claim and earns its place for a different reason: it does not say
+ * what OpenRouter has, it says which models are worth reaching for a particular
+ * kind of work. That answer changes when the field moves, not when a gateway
+ * rotates its inventory, and nothing else can produce it — discovery returns
+ * three hundred ids in alphabetical order and none of them says "this is the
+ * one to narrate with".
+ *
+ * It is advisory throughout. Routing still comes from the provider records an
+ * operator configured: a featured model is reachable once its route is on a
+ * provider, and until then it is a recommendation with an id attached. What
+ * this buys is that the id is entered once, here, rather than retyped in every
+ * repo that wanted the same model.
+ */
+/**
+ * Why a model is surfaced.
+ *
+ * A purpose rather than a category, because the list exists to answer "what
+ * should write this" rather than to classify models. One value today; the shape
+ * is what keeps the next answer from being a second parallel table.
+ */
+export declare const FEATURED_MODEL_PURPOSES: readonly ["creative-writing"];
+export declare const FeaturedModelPurposeSchema: import("valibot").PicklistSchema<readonly ["creative-writing"], undefined>;
+export type FeaturedModelPurpose = InferOutput<typeof FeaturedModelPurposeSchema>;
+/** One surfaced model: what it is for, and where it is reached. */
+export interface FeaturedModel {
+    /** Canonical id, the short name a preset or a request asks for. */
+    model: string;
+    /** Display name. */
+    label: string;
+    purpose: FeaturedModelPurpose;
+    /** The provider that serves it. Every entry here is an OpenRouter route. */
+    providerId: string;
+    /** The id that provider serves it under. */
+    providerModelId: string;
+    /**
+     * Whether this is the one to reach for in its family. The rest are earlier
+     * generations and smaller siblings, kept because a deployment that tuned a
+     * prompt against one should not lose it to a refresh.
+     */
+    flagship: boolean;
+    /** One line on what it is good at, shown beside its name in a picker. */
+    note: string;
+}
+/**
+ * Models for writing prose — narration, dialogue, in-world text.
+ *
+ * All four families are reached through OpenRouter rather than their vendors,
+ * and that is the point of listing them: none of them is worth a direct account
+ * on its own, and one key already reaches all of them. The ids are pinned
+ * because vendors publish a new dated id per refresh, so "the latest Euryale"
+ * is a line changed here instead of a search across every repo that named it.
+ *
+ * Check a replacement against `GET https://openrouter.ai/api/v1/models` before
+ * pinning it: a superseded id is eventually withdrawn from the gateway, and the
+ * failure it produces is a route that simply stops answering.
+ */
+export declare const FEATURED_MODELS: readonly FeaturedModel[];
+/** A surfaced model, on the wire. */
+export declare const FeaturedModelSchema: 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>;
+/** Every surfaced model for one kind of work, in the order it is offered. */
+export declare function featuredModelsFor(purpose: FeaturedModelPurpose): readonly FeaturedModel[];
+/**
+ * The surfaced models one provider serves, as routes ready to save on it.
+ *
+ * This is the whole mechanism by which a surfaced model becomes a routable one:
+ * a console offers these rows, an operator saves them onto the provider, and
+ * from then on a preset naming `euryale` plans exactly as one naming any other
+ * configured model. Nothing here reaches routing on its own.
+ *
+ * @example
+ * ```ts
+ * import { featuredModelRoutes } from '@game-infra/ai-schemas'
+ *
+ * await updateProvider('openrouter', { models: featuredModelRoutes('openrouter') })
+ * ```
+ */
+export declare function featuredModelRoutes(providerId: string): ProviderModelRoute[];
+//# sourceMappingURL=featuredModels.d.ts.map

package/dist/featuredModels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"featuredModels.d.ts","sourceRoot":"","sources":["../src/featuredModels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAqC,MAAM,SAAS,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,YAAI,kBAAkB,CAAU,CAAC;AACrE,eAAO,MAAM,0BAA0B,4EAAoC,CAAC;AAC5E,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAElF,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,oBAAoB,CAAC;IAC9B,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EA6GnD,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,mBAAmB;;;;;;;;aAQ9B,CAAC;AAEH,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,aAAa,EAAE,CAEzF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAK5E"}

package/dist/featuredModels.js

@@ -0,0 +1,189 @@
+import { boolean, object, picklist, string } from "valibot";
+/**
+ * The models this deployment surfaces by name, and the id a gateway serves each
+ * under.
+ *
+ * A provider blueprint deliberately carries no model list, because an inventory
+ * of what a gateway serves is wrong within weeks and wrong in the direction
+ * that hurts — it advertises models a deployment cannot reach. This list is a
+ * different claim and earns its place for a different reason: it does not say
+ * what OpenRouter has, it says which models are worth reaching for a particular
+ * kind of work. That answer changes when the field moves, not when a gateway
+ * rotates its inventory, and nothing else can produce it — discovery returns
+ * three hundred ids in alphabetical order and none of them says "this is the
+ * one to narrate with".
+ *
+ * It is advisory throughout. Routing still comes from the provider records an
+ * operator configured: a featured model is reachable once its route is on a
+ * provider, and until then it is a recommendation with an id attached. What
+ * this buys is that the id is entered once, here, rather than retyped in every
+ * repo that wanted the same model.
+ */
+/**
+ * Why a model is surfaced.
+ *
+ * A purpose rather than a category, because the list exists to answer "what
+ * should write this" rather than to classify models. One value today; the shape
+ * is what keeps the next answer from being a second parallel table.
+ */
+export const FEATURED_MODEL_PURPOSES = ["creative-writing"];
+export const FeaturedModelPurposeSchema = picklist(FEATURED_MODEL_PURPOSES);
+/**
+ * Models for writing prose — narration, dialogue, in-world text.
+ *
+ * All four families are reached through OpenRouter rather than their vendors,
+ * and that is the point of listing them: none of them is worth a direct account
+ * on its own, and one key already reaches all of them. The ids are pinned
+ * because vendors publish a new dated id per refresh, so "the latest Euryale"
+ * is a line changed here instead of a search across every repo that named it.
+ *
+ * Check a replacement against `GET https://openrouter.ai/api/v1/models` before
+ * pinning it: a superseded id is eventually withdrawn from the gateway, and the
+ * failure it produces is a route that simply stops answering.
+ */
+export const FEATURED_MODELS = [
+    {
+        model: "aion",
+        label: "Aion 3.0",
+        purpose: "creative-writing",
+        providerId: "openrouter",
+        providerModelId: "aion-labs/aion-3.0",
+        flagship: true,
+        note: "Aion Labs' flagship. Long-form narration that holds a thread across a scene.",
+    },
+    {
+        model: "aion-mini",
+        label: "Aion 3.0 Mini",
+        purpose: "creative-writing",
+        providerId: "openrouter",
+        providerModelId: "aion-labs/aion-3.0-mini",
+        flagship: false,
+        note: "The small Aion. Cheap enough for the drafts nobody reads twice.",
+    },
+    {
+        model: "aion-2",
+        label: "Aion 2.0",
+        purpose: "creative-writing",
+        providerId: "openrouter",
+        providerModelId: "aion-labs/aion-2.0",
+        flagship: false,
+        note: "The previous Aion generation, for prompts tuned against it.",
+    },
+    {
+        model: "aion-rp",
+        label: "Aion RP",
+        purpose: "creative-writing",
+        providerId: "openrouter",
+        providerModelId: "aion-labs/aion-rp-llama-3.1-8b",
+        flagship: false,
+        note: "Aion's roleplay-tuned 8B. Stays in character; does not reason.",
+    },
+    {
+        model: "euryale",
+        label: "Euryale 3.3 70B",
+        purpose: "creative-writing",
+        providerId: "openrouter",
+        providerModelId: "sao10k/l3.3-euryale-70b",
+        flagship: true,
+        note: "Sao10K's Llama-3.3 finetune. Distinctive voice, little assistant register.",
+    },
+    {
+        model: "euryale-3.1",
+        label: "Euryale 3.1 70B",
+        purpose: "creative-writing",
+        providerId: "openrouter",
+        providerModelId: "sao10k/l3.1-euryale-70b",
+        flagship: false,
+        note: "The Llama-3.1 generation of Euryale.",
+    },
+    {
+        model: "mistral-large",
+        label: "Mistral Large 3",
+        purpose: "creative-writing",
+        providerId: "openrouter",
+        providerModelId: "mistralai/mistral-large-2512",
+        flagship: true,
+        note: "The steadiest of the four at following a structured brief.",
+    },
+    {
+        model: "mistral-large-2407",
+        label: "Mistral Large 2 (2407)",
+        purpose: "creative-writing",
+        providerId: "openrouter",
+        providerModelId: "mistralai/mistral-large-2407",
+        flagship: false,
+        note: "The 2024 Large, kept for prompts written against it.",
+    },
+    {
+        model: "mistral-medium",
+        label: "Mistral Medium 3.5",
+        purpose: "creative-writing",
+        providerId: "openrouter",
+        providerModelId: "mistralai/mistral-medium-3-5",
+        flagship: false,
+        note: "The cheaper Mistral. A reasonable fallback rather than a first choice.",
+    },
+    {
+        model: "hermes",
+        label: "Hermes 4 405B",
+        purpose: "creative-writing",
+        providerId: "openrouter",
+        providerModelId: "nousresearch/hermes-4-405b",
+        flagship: true,
+        note: "Nous Research's largest. Follows a persona brief more literally than most.",
+    },
+    {
+        model: "hermes-70b",
+        label: "Hermes 4 70B",
+        purpose: "creative-writing",
+        providerId: "openrouter",
+        providerModelId: "nousresearch/hermes-4-70b",
+        flagship: false,
+        note: "The 70B Hermes 4, at a fraction of the flagship's price.",
+    },
+    {
+        model: "hermes-3",
+        label: "Hermes 3 405B",
+        purpose: "creative-writing",
+        providerId: "openrouter",
+        providerModelId: "nousresearch/hermes-3-llama-3.1-405b",
+        flagship: false,
+        note: "The Hermes 3 generation.",
+    },
+];
+/** A surfaced model, on the wire. */
+export const FeaturedModelSchema = object({
+    model: string(),
+    label: string(),
+    purpose: FeaturedModelPurposeSchema,
+    providerId: string(),
+    providerModelId: string(),
+    flagship: boolean(),
+    note: string(),
+});
+/** Every surfaced model for one kind of work, in the order it is offered. */
+export function featuredModelsFor(purpose) {
+    return FEATURED_MODELS.filter((entry) => entry.purpose === purpose);
+}
+/**
+ * The surfaced models one provider serves, as routes ready to save on it.
+ *
+ * This is the whole mechanism by which a surfaced model becomes a routable one:
+ * a console offers these rows, an operator saves them onto the provider, and
+ * from then on a preset naming `euryale` plans exactly as one naming any other
+ * configured model. Nothing here reaches routing on its own.
+ *
+ * @example
+ * ```ts
+ * import { featuredModelRoutes } from '@game-infra/ai-schemas'
+ *
+ * await updateProvider('openrouter', { models: featuredModelRoutes('openrouter') })
+ * ```
+ */
+export function featuredModelRoutes(providerId) {
+    return FEATURED_MODELS.filter((entry) => entry.providerId === providerId).map((entry) => ({
+        model: entry.model,
+        providerModelId: entry.providerModelId,
+    }));
+}
+//# sourceMappingURL=featuredModels.js.map

package/dist/featuredModels.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @game-infra/ai-schemas
+ *
+ * The ai-service 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.
+ */
+export { CREDENTIAL_KINDS, CreateProviderRequestSchema, CredentialKindSchema, DEFAULT_TIER_PREFERENCE, PROVIDER_DIALECTS, PROVIDER_TIERS, ProviderDialectSchema, ProviderIdSchema, ProviderListResponseSchema, ProviderModelRouteSchema, ProviderProbeResponseSchema, ProviderResponseSchema, ProviderSchema, ProviderTierSchema, SetProviderCredentialRequestSchema, UpdateProviderRequestSchema, } from "./provider.js";
+export type { CreateProviderRequest, CredentialKind, Provider, ProviderDialect, ProviderListResponse, ProviderModelRoute, ProviderProbeResponse, ProviderResponse, ProviderTier, SetProviderCredentialRequest, UpdateProviderRequest, } from "./provider.js";
+export { CreateSubscriptionRequestSchema, SUBSCRIPTION_AUTH_SCHEMES, SUBSCRIPTION_VENDOR_PROFILES, SUBSCRIPTION_VENDORS, SubscriptionListResponseSchema, SubscriptionResponseSchema, SubscriptionAuthSchemeSchema, SubscriptionSchema, SubscriptionVendorSchema, UnlockSubscriptionRequestSchema, UnlockSubscriptionResponseSchema, UpdateSubscriptionRequestSchema, } from "./subscription.js";
+export type { CreateSubscriptionRequest, Subscription, SubscriptionAuthScheme, SubscriptionListResponse, SubscriptionResponse, SubscriptionVendor, SubscriptionVendorProfile, UnlockSubscriptionRequest, UnlockSubscriptionResponse, UpdateSubscriptionRequest, } from "./subscription.js";
+export { CreatePresetRequestSchema, LOCKED_SUBSCRIPTION_POLICIES, LockedSubscriptionPolicySchema, PresetListResponseSchema, PresetModelEntrySchema, PresetResponseSchema, PresetSchema, PresetSlugSchema, ROUTE_EXCLUSION_REASONS, RouteCandidateSchema, RouteExclusionReasonSchema, RouteExclusionSchema, RoutePlanResponseSchema, UpdatePresetRequestSchema, } from "./preset.js";
+export type { CreatePresetRequest, LockedSubscriptionPolicy, Preset, PresetListResponse, PresetModelEntry, PresetResponse, RouteCandidate, RouteExclusion, RouteExclusionReason, RoutePlanResponse, UpdatePresetRequest, } from "./preset.js";
+export { AttemptFailureSchema, GenerateObjectRequestSchema, GenerateObjectResponseSchema, GenerateTextRequestSchema, GenerateTextResponseSchema, ImagePartSchema, MESSAGE_ROLES, MessageRoleSchema, MessageSchema, RouteOutcomeSchema, STREAM_EVENTS, StreamEventSchema, TextPartSchema, UsageSchema, } from "./inference.js";
+export type { AttemptFailure, GenerateObjectRequest, GenerateObjectResponse, GenerateTextRequest, GenerateTextResponse, Message, MessageRole, RouteOutcome, StreamEvent, Usage, } from "./inference.js";
+export { RegisteredSchemaSchema, SchemaListResponseSchema, SchemaResponseSchema, } from "./schemaRegistry.js";
+export type { RegisteredSchema, SchemaListResponse, SchemaResponse } from "./schemaRegistry.js";
+export { CatalogResponseSchema, DiscoveredModelsResponseSchema, PROVIDER_BLUEPRINTS, ProviderBlueprintSchema, SubscriptionVendorOptionSchema, } from "./catalog.js";
+export type { CatalogResponse, DiscoveredModelsResponse, ProviderBlueprint } from "./catalog.js";
+export { FEATURED_MODEL_PURPOSES, FEATURED_MODELS, FeaturedModelPurposeSchema, FeaturedModelSchema, featuredModelRoutes, featuredModelsFor, } from "./featuredModels.js";
+export type { FeaturedModel, FeaturedModelPurpose } from "./featuredModels.js";
+export { AiReadinessResponseSchema, CALL_LIST_SCOPES, CallListQuerySchema, CallListResponseSchema, CallListScopeSchema, CallRecordSchema, DeleteResponseSchema, } from "./service.js";
+export type { AiReadinessResponse, CallListQuery, CallListResponse, CallListScope, CallRecord, DeleteResponse, } from "./service.js";
+export { aiCallListContract, aiCatalogContract, aiGenerateObjectContract, aiGenerateStreamContract, aiGenerateTextContract, aiPresetCreateContract, aiPresetDeleteContract, aiPresetGetContract, aiPresetListContract, aiPresetRoutePlanContract, aiPresetUpdateContract, aiProviderCreateContract, aiProviderCredentialDeleteContract, aiProviderCredentialSetContract, aiProviderDeleteContract, aiProviderGetContract, aiProviderListContract, aiProviderModelsContract, aiProviderProbeContract, aiProviderUpdateContract, aiReadinessContract, aiSchemaGetContract, aiSchemaListContract, aiSubscriptionCreateContract, aiSubscriptionDeleteContract, aiSubscriptionListContract, aiSubscriptionUnlockContract, aiSubscriptionUpdateContract, } from "./contracts.js";
+export { orderedProviderPreference, orderedTierPreference } from "./preference.js";
+/**
+ * The header a request carries the subscription unlock password in.
+ *
+ * A header rather than a body field, for the same reason the bearer token is
+ * one: it is a credential rather than an argument, it must not vary between the
+ * text and the streaming forms of the same call, and a body field would end up
+ * copied into request logs by every client that logs what it posted.
+ */
+export declare const SUBSCRIPTION_PASSWORD_HEADER = "X-AI-Subscription-Password";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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