@veruna/api-contracts 20.0.0 → 20.1.0

package/build/v1/model-route/schemas/kie-protocol.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"kie-protocol.enum.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/kie-protocol.enum.ts"],"names":[],"mappings":";;;AAIA,IAAY,WAEX;AAFD,WAAY,WAAW;IACnB,4BAAa,CAAA;AACjB,CAAC,EAFW,WAAW,2BAAX,WAAW,QAEtB"}
+{"version":3,"file":"kie-protocol.enum.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/kie-protocol.enum.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,WAEX;AAFD,WAAY,WAAW;IACnB,4BAAa,CAAA;AACjB,CAAC,EAFW,WAAW,2BAAX,WAAW,QAEtB"}

package/build/v1/model-route/schemas/list-model-routes-filters.schema.d.ts

@@ -3,6 +3,10 @@ import { ModelRouteStatus } from './model-route-status.enum';
 import { ApiProvider } from '../../ai-model/schemas/api-provider.enum';
 import { AdminModelRouteSortField } from './admin-model-route-sort.enum';
 import { SortOrder } from '../../shared/sort-order.enum';
+/**
+ * List Model Routes Filters Schema
+ * Error messages: ListModelRoutesFilters.{field}.{rule}
+ */
 export declare const ListModelRoutesFiltersSchema: z.ZodObject<{
     q: z.ZodOptional<z.ZodString>;
     status: z.ZodOptional<z.ZodEnum<typeof ModelRouteStatus>>;

package/build/v1/model-route/schemas/list-model-routes-filters.schema.js

@@ -6,6 +6,10 @@ const model_route_status_enum_1 = require("./model-route-status.enum");
 const api_provider_enum_1 = require("../../ai-model/schemas/api-provider.enum");
 const admin_model_route_sort_enum_1 = require("./admin-model-route-sort.enum");
 const sort_order_enum_1 = require("../../shared/sort-order.enum");
+/**
+ * List Model Routes Filters Schema
+ * Error messages: ListModelRoutesFilters.{field}.{rule}
+ */
 exports.ListModelRoutesFiltersSchema = zod_1.z.object({
     q: zod_1.z.string().max(255).optional(),
     status: zod_1.z.enum(model_route_status_enum_1.ModelRouteStatus).optional(),

package/build/v1/model-route/schemas/list-model-routes-filters.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-model-routes-filters.schema.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/list-model-routes-filters.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,uEAA6D;AAC7D,gFAAuE;AACvE,+EAAyE;AACzE,kEAAyD;AAM5C,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,0CAAgB,CAAC,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,OAAC,CAAC,IAAI,CAAC,+BAAW,CAAC,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,OAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC;SACnE,QAAQ,EAAE;IACf,SAAS,EAAE,OAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;SACjE,QAAQ,EAAE;IACf,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,sDAAwB,CAAC,CAAC,OAAO,CAAC,sDAAwB,CAAC,QAAQ,CAAC;IACnF,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,2BAAS,CAAC,CAAC,OAAO,CAAC,2BAAS,CAAC,GAAG,CAAC;CACtD,CAAC,CAAC"}
+{"version":3,"file":"list-model-routes-filters.schema.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/list-model-routes-filters.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,uEAA6D;AAC7D,gFAAuE;AACvE,+EAAyE;AACzE,kEAAyD;AAEzD;;;GAGG;AACU,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,0CAAgB,CAAC,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,OAAC,CAAC,IAAI,CAAC,+BAAW,CAAC,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,OAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC;SACnE,QAAQ,EAAE;IACf,SAAS,EAAE,OAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;SACjE,QAAQ,EAAE;IACf,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,sDAAwB,CAAC,CAAC,OAAO,CAAC,sDAAwB,CAAC,QAAQ,CAAC;IACnF,SAAS,EAAE,OAAC,CAAC,IAAI,CAAC,2BAAS,CAAC,CAAC,OAAO,CAAC,2BAAS,CAAC,GAAG,CAAC;CACtD,CAAC,CAAC"}

package/build/v1/model-route/schemas/openrouter-transport.enum.d.ts

@@ -1,3 +1,24 @@
+/**
+ * Wire-transport discriminator for OpenRouter-routed models.
+ *
+ * OpenRouter is one vendor with one auth and base URL, but serves image
+ * models over TWO different HTTP surfaces, and a model published on one
+ * is not callable on the other. `OpenRouterProvider` dispatches on this
+ * discriminator, read from the route's `runtimeOverrides.openrouter.transport`.
+ *
+ * - `CHAT` — `POST /chat/completions`. Text models, and the multimodal
+ *   chat models that emit images inside the completion (the `gemini-*-image`
+ *   and `gpt-5-image*` families). Default when `transport` is omitted, so
+ *   every existing route keeps its current behaviour.
+ *
+ * - `IMAGES` — `POST /images`, the unified image API. REQUIRED for the
+ *   dedicated image models (`openai/gpt-image-1*`, `krea/*`, `recraft/*`,
+ *   `black-forest-labs/flux.2-*`, `sourceful/riverflow-*`,
+ *   `microsoft/mai-image-*`, `bytedance-seed/seedream-*`,
+ *   `x-ai/grok-imagine-*`): they do not exist in the chat catalogue at all,
+ *   so calling them on `CHAT` returns a hard 404 telling you to use
+ *   `/api/v1/images`. Verify a slug with `GET /api/v1/images/models`.
+ */
 export declare enum OpenRouterTransport {
     CHAT = "CHAT",
     IMAGES = "IMAGES"

package/build/v1/model-route/schemas/openrouter-transport.enum.js

@@ -1,6 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenRouterTransport = void 0;
+/**
+ * Wire-transport discriminator for OpenRouter-routed models.
+ *
+ * OpenRouter is one vendor with one auth and base URL, but serves image
+ * models over TWO different HTTP surfaces, and a model published on one
+ * is not callable on the other. `OpenRouterProvider` dispatches on this
+ * discriminator, read from the route's `runtimeOverrides.openrouter.transport`.
+ *
+ * - `CHAT` — `POST /chat/completions`. Text models, and the multimodal
+ *   chat models that emit images inside the completion (the `gemini-*-image`
+ *   and `gpt-5-image*` families). Default when `transport` is omitted, so
+ *   every existing route keeps its current behaviour.
+ *
+ * - `IMAGES` — `POST /images`, the unified image API. REQUIRED for the
+ *   dedicated image models (`openai/gpt-image-1*`, `krea/*`, `recraft/*`,
+ *   `black-forest-labs/flux.2-*`, `sourceful/riverflow-*`,
+ *   `microsoft/mai-image-*`, `bytedance-seed/seedream-*`,
+ *   `x-ai/grok-imagine-*`): they do not exist in the chat catalogue at all,
+ *   so calling them on `CHAT` returns a hard 404 telling you to use
+ *   `/api/v1/images`. Verify a slug with `GET /api/v1/images/models`.
+ */
 var OpenRouterTransport;
 (function (OpenRouterTransport) {
     OpenRouterTransport["CHAT"] = "CHAT";

package/build/v1/model-route/schemas/openrouter-transport.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"openrouter-transport.enum.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/openrouter-transport.enum.ts"],"names":[],"mappings":";;;AAqBA,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC3B,oCAAa,CAAA;IACb,wCAAiB,CAAA;AACrB,CAAC,EAHW,mBAAmB,mCAAnB,mBAAmB,QAG9B"}
+{"version":3,"file":"openrouter-transport.enum.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/openrouter-transport.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC3B,oCAAa,CAAA;IACb,wCAAiB,CAAA;AACrB,CAAC,EAHW,mBAAmB,mCAAnB,mBAAmB,QAG9B"}

package/build/v1/model-route/schemas/provider-generation-config.schema.d.ts

@@ -86,6 +86,7 @@ export declare const RouteFailoverConfigSchema: z.ZodObject<{
     ttfbTimeoutMs: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strict>;
 export type RouteFailoverConfig = z.infer<typeof RouteFailoverConfigSchema>;
+/** Потолок здравого смысла для `limits.maxInputImages` — с запасом выше любой реальной модели. */
 export declare const ROUTE_MAX_INPUT_IMAGES_CEILING = 100;
 export declare const RouteLimitsConfigSchema: z.ZodObject<{
     maxInputImages: z.ZodOptional<z.ZodNumber>;

package/build/v1/model-route/schemas/provider-generation-config.schema.js

@@ -9,6 +9,13 @@ const openrouter_transport_enum_1 = require("./openrouter-transport.enum");
 const reseller_transport_enum_1 = require("./reseller-transport.enum");
 const route_image_pricing_schema_1 = require("./route-image-pricing.schema");
 const route_token_pricing_schema_1 = require("./route-token-pricing.schema");
+// KIE per-call cost in credits ($0.005 per credit). Lives at the route layer
+// (`ModelRoute.runtimeOverrides.kie.pricing`) — pricing is a property of the
+// integration path, not of any specific tool binding.
+//
+// Effective cost = base + Σ modifiers[settingKey][selectedOptionId].
+// `fallback` documents an approximation for non-additive pricing
+// (qwen image-edit per-megapixel, grok-imagine per-batch).
 exports.KiePricingSchema = zod_1.z
     .object({
     base: zod_1.z.number().nonnegative(),
@@ -35,15 +42,28 @@ exports.OpenRouterProviderConfigSchema = zod_1.z
     .strict();
 exports.OpenRouterGenerationConfigSchema = zod_1.z
     .object({
+    // Wire-transport discriminator, dispatched in
+    // `OpenRouterProvider.generateStream()`. Omitted == CHAT, so routes
+    // predating the unified image API keep their behaviour. Dedicated
+    // image models (absent from the chat catalogue) MUST set `IMAGES`
+    // or every call 404s — see `OpenRouterTransport`.
     transport: zod_1.z.enum(openrouter_transport_enum_1.OpenRouterTransport).optional(),
     imageConfig: exports.OpenRouterImageConfigSchema.optional(),
+    // Images transport: source images of an edit go inline as `data:` URLs instead of our file
+    // URLs. For upstreams that never fetch a URL themselves (Krea under zero data retention
+    // answers "external asset inputs must be data URIs").
     inputImagesAsDataUri: zod_1.z.boolean().optional(),
     provider: exports.OpenRouterProviderConfigSchema.optional(),
+    // OpenRouter-native fallback list — passed as the `models: [primary,
+    // ...fallback]` array on a single OR API call. Distinct from our
+    // route-pool fallback (which iterates ModelRoutes by priority across
+    // providers). Cap kept loose since OR has no documented hard limit.
     fallbackModels: zod_1.z.array(zod_1.z.string().min(1).max(200)).max(20).optional(),
 })
     .strict();
 exports.KieGenerationConfigSchema = zod_1.z
     .object({
+    // JOBS (or omitted) selects the async createTask/webhook flow.
     protocol: zod_1.z.enum(kie_protocol_enum_1.KieProtocol).optional(),
     input: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
     inputUrlsKey: zod_1.z.string().optional(),
@@ -52,9 +72,13 @@ exports.KieGenerationConfigSchema = zod_1.z
     bodyMode: zod_1.z.enum(kie_body_mode_enum_1.KieBodyMode).optional(),
     promptMaxLen: zod_1.z.number().int().positive().max(50000).optional(),
     pricing: exports.KiePricingSchema.optional(),
+    // Resolved option selection per setting key, captured at config-build
+    // time. Fed to the cost calculator together with `pricing.modifiers`.
     selectedOptions: zod_1.z.record(zod_1.z.string().max(100), zod_1.z.string().max(200)).optional(),
 })
     .strict();
+// Wire values of the OpenAI Images API the tool capability resolved for one call (`size`, `quality`, `n`).
+// Written by the tool patch; a route may also carry it as a base default.
 exports.OpenAiImagesConfigSchema = zod_1.z
     .object({
     size: zod_1.z.string().max(16).optional(),
@@ -64,26 +88,55 @@ exports.OpenAiImagesConfigSchema = zod_1.z
     .strict();
 exports.WellflowGenerationConfigSchema = zod_1.z
     .object({
+    // Wire-protocol discriminator. Picks the inner transport in
+    // `WellflowAiProvider.generateStream()`. REQUIRED in practice:
+    // there is no slug inference — a route whose
+    // `runtimeOverrides.wellflow` omits this fails dispatch with
+    // PROVIDER_ERROR. Kept `.optional()` here only because the
+    // enclosing `wellflow` block is itself optional; seeds always set
+    // it.
     protocol: zod_1.z.enum(wellflow_protocol_enum_1.WellflowProtocol).optional(),
+    // Output token cap forwarded as `max_tokens` to the WellFlow upstream.
+    // Set high in seeds (e.g. 100k) so long answers are not truncated
+    // mid-stream by a low upstream default. Omitted → upstream default.
     maxTokens: zod_1.z.number().int().positive().max(1_000_000).optional(),
+    // Image settings of an `OPENAI_IMAGES` route.
     imageConfig: exports.OpenAiImagesConfigSchema.optional(),
 })
     .strict();
+// OpenAI-compatible resellers (DEROUTER, APIROUTE): one shape for both vendors.
 exports.ResellerGenerationConfigSchema = zod_1.z
     .object({
+    // Output token cap forwarded as `max_tokens`. Omitted → upstream default.
     maxTokens: zod_1.z.number().int().positive().max(1_000_000).optional(),
+    // Wire transport, dispatched in the reseller provider. Omitted == CHAT. Dedicated image models
+    // MUST set `IMAGES` or every call goes to the chat endpoint and fails.
     transport: zod_1.z.enum(reseller_transport_enum_1.ResellerTransport).optional(),
+    // Image settings of an `IMAGES` route.
     imageConfig: exports.OpenAiImagesConfigSchema.optional(),
 })
     .strict();
+// Provider-agnostic failover tuning for a route. Lives alongside the provider
+// blocks in `runtimeOverrides` and is admin-editable per route.
 exports.RouteFailoverConfigSchema = zod_1.z
     .object({
+    // Time-to-first-content-chunk budget in ms before this route is failed
+    // over to the next one (a TTFB timeout counts as an infra strike).
+    // `null` = no TTFB timeout — used for image models where we wait until
+    // the upstream responds. Omitted → the provider/global default applies.
     ttfbTimeoutMs: zod_1.z.number().int().positive().max(600_000).nullable().optional(),
 })
     .strict();
+/** Потолок здравого смысла для `limits.maxInputImages` — с запасом выше любой реальной модели. */
 exports.ROUTE_MAX_INPUT_IMAGES_CEILING = 100;
+// Ёмкость эндпоинта модели за роутом, не зависящая от провайдера. Пул роутов
+// читает её ДО вызова: запрос, который эндпоинт не примет, уходит на следующий
+// роут, а не получает отказ апстрима (и не обрезается молча). Не задано —
+// лимит неизвестен, роут принимает любой запрос.
 exports.RouteLimitsConfigSchema = zod_1.z
     .object({
+    // Сколько входных (референсных) картинок может нести один запрос к роуту.
+    // `0` — эндпоинт картинок на вход не принимает вовсе (только text-to-image).
     maxInputImages: zod_1.z
         .number({ error: 'RouteLimitsConfig.maxInputImages.invalid' })
         .int({ message: 'RouteLimitsConfig.maxInputImages.int' })
@@ -102,7 +155,11 @@ exports.ProviderGenerationConfigSchema = zod_1.z
     reseller: exports.ResellerGenerationConfigSchema.optional(),
     failover: exports.RouteFailoverConfigSchema.optional(),
     limits: exports.RouteLimitsConfigSchema.optional(),
+    // Generic USD price table for the route's tokens. Read by `provider-cost.policy.ts`
+    // for PriceTable providers (Wellflow today); other providers ignore it.
     tokenPricing: route_token_pricing_schema_1.RouteTokenPricingSchema.optional(),
+    // USD price of one image for a route billed per image (reseller / Wellflow image endpoints).
+    // Read by `provider-cost.policy.ts`; without it an image call has no cost of record.
     imagePricing: route_image_pricing_schema_1.RouteImagePricingSchema.optional(),
 })
     .strict();

package/build/v1/model-route/schemas/provider-generation-config.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-generation-config.schema.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/provider-generation-config.schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"provider-generation-config.schema.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/provider-generation-config.schema.ts"],"names":[],"mappings":"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"}

package/build/v1/model-route/schemas/reseller-transport.enum.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Wire-transport discriminator for OpenAI-compatible resellers (DEROUTER, APIROUTE), read from the route's
+ * `runtimeOverrides.reseller.transport`.
+ *
+ * - `CHAT` — `POST /v1/chat/completions`, streaming. Default when `transport` is omitted, so every
+ *   existing route keeps its behaviour.
+ *
+ * - `IMAGES` — `POST /v1/images/generations` and `/v1/images/edits`, synchronous request/response, billed
+ *   per image. Dedicated image models (gpt-image-2 and the like) are only served there.
+ */
 export declare enum ResellerTransport {
     CHAT = "CHAT",
     IMAGES = "IMAGES"

package/build/v1/model-route/schemas/reseller-transport.enum.js

@@ -1,6 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ResellerTransport = void 0;
+/**
+ * Wire-transport discriminator for OpenAI-compatible resellers (DEROUTER, APIROUTE), read from the route's
+ * `runtimeOverrides.reseller.transport`.
+ *
+ * - `CHAT` — `POST /v1/chat/completions`, streaming. Default when `transport` is omitted, so every
+ *   existing route keeps its behaviour.
+ *
+ * - `IMAGES` — `POST /v1/images/generations` and `/v1/images/edits`, synchronous request/response, billed
+ *   per image. Dedicated image models (gpt-image-2 and the like) are only served there.
+ */
 var ResellerTransport;
 (function (ResellerTransport) {
     ResellerTransport["CHAT"] = "CHAT";

package/build/v1/model-route/schemas/reseller-transport.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"reseller-transport.enum.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/reseller-transport.enum.ts"],"names":[],"mappings":";;;AAUA,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IACzB,kCAAa,CAAA;IACb,sCAAiB,CAAA;AACrB,CAAC,EAHW,iBAAiB,iCAAjB,iBAAiB,QAG5B"}
+{"version":3,"file":"reseller-transport.enum.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/reseller-transport.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IACzB,kCAAa,CAAA;IACb,sCAAiB,CAAA;AACrB,CAAC,EAHW,iBAAiB,iCAAjB,iBAAiB,QAG5B"}

package/build/v1/model-route/schemas/route-circuit-view.schema.d.ts

@@ -1,6 +1,10 @@
 import { z } from 'zod';
 import { ApiProvider } from '../../ai-model/schemas/api-provider.enum';
 import { CircuitState } from '../../ai-provider/schemas/circuit-state.enum';
+/**
+ * Effective circuit state of a single route (derived from its recent AI calls and the admin
+ * override), with its escalation level and event log for the admin read-only circuit panel.
+ */
 export declare const RouteCircuitViewSchema: z.ZodObject<{
     routeUuid: z.ZodString;
     provider: z.ZodEnum<typeof ApiProvider>;
@@ -22,6 +26,7 @@ export declare const RouteCircuitViewSchema: z.ZodObject<{
         reason: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+/** List of every route currently OPEN (banned) across all providers. */
 export declare const OpenRoutesResponseSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
         routeUuid: z.ZodString;

package/build/v1/model-route/schemas/route-circuit-view.schema.js

@@ -6,7 +6,12 @@ const shared_1 = require("../../../shared");
 const api_provider_enum_1 = require("../../ai-model/schemas/api-provider.enum");
 const circuit_event_schema_1 = require("../../ai-provider/schemas/circuit-event.schema");
 const circuit_state_enum_1 = require("../../ai-provider/schemas/circuit-state.enum");
+/**
+ * Effective circuit state of a single route (derived from its recent AI calls and the admin
+ * override), with its escalation level and event log for the admin read-only circuit panel.
+ */
 exports.RouteCircuitViewSchema = zod_1.z.object({
+    // Health is tracked per route: the identity the ban / reset endpoints take.
     routeUuid: zod_1.z.string().uuid(),
     provider: zod_1.z.enum(api_provider_enum_1.ApiProvider),
     modelUuid: zod_1.z.string().uuid(),
@@ -20,6 +25,7 @@ exports.RouteCircuitViewSchema = zod_1.z.object({
     lastSuccessAt: zod_1.z.string().regex(shared_1.DATETIME_REGEX).nullable(),
     events: zod_1.z.array(circuit_event_schema_1.CircuitEventSchema),
 });
+/** List of every route currently OPEN (banned) across all providers. */
 exports.OpenRoutesResponseSchema = zod_1.z.object({
     items: zod_1.z.array(exports.RouteCircuitViewSchema),
 });

package/build/v1/model-route/schemas/route-circuit-view.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"route-circuit-view.schema.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/route-circuit-view.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAAiD;AACjD,gFAAuE;AACvE,yFAAoF;AACpF,qFAA4E;AAM/D,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAE3C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC5B,QAAQ,EAAE,OAAC,CAAC,IAAI,CAAC,+BAAW,CAAC;IAC7B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC5B,KAAK,EAAE,OAAC,CAAC,IAAI,CAAC,iCAAY,CAAC;IAC3B,mBAAmB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACnD,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC/C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC,CAAC,QAAQ,EAAE;IACtD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC,CAAC,QAAQ,EAAE;IAC1D,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC,CAAC,QAAQ,EAAE;IAC1D,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC,CAAC,QAAQ,EAAE;IAC1D,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,yCAAkB,CAAC;CACtC,CAAC,CAAC;AAGU,QAAA,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,8BAAsB,CAAC;CACzC,CAAC,CAAC"}
+{"version":3,"file":"route-circuit-view.schema.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/route-circuit-view.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAAiD;AACjD,gFAAuE;AACvE,yFAAoF;AACpF,qFAA4E;AAE5E;;;GAGG;AACU,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,4EAA4E;IAC5E,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC5B,QAAQ,EAAE,OAAC,CAAC,IAAI,CAAC,+BAAW,CAAC;IAC7B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC5B,KAAK,EAAE,OAAC,CAAC,IAAI,CAAC,iCAAY,CAAC;IAC3B,mBAAmB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACnD,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC/C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC,CAAC,QAAQ,EAAE;IACtD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC,CAAC,QAAQ,EAAE;IAC1D,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC,CAAC,QAAQ,EAAE;IAC1D,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,uBAAc,CAAC,CAAC,QAAQ,EAAE;IAC1D,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,yCAAkB,CAAC;CACtC,CAAC,CAAC;AAEH,wEAAwE;AAC3D,QAAA,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,8BAAsB,CAAC;CACzC,CAAC,CAAC"}

package/build/v1/model-route/schemas/route-image-pricing.schema.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+/** Ceiling for the price of one image, USD. Far above any real model; catches a misplaced decimal point. */
 export declare const ROUTE_IMAGE_PRICE_MAX_USD = 10;
 export declare const RouteImagePricingSchema: z.ZodObject<{
     perImageUsd: z.ZodNumber;

package/build/v1/model-route/schemas/route-image-pricing.schema.js

@@ -2,7 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RouteImagePricingSchema = exports.ROUTE_IMAGE_PRICE_MAX_USD = void 0;
 const zod_1 = require("zod");
+/** Ceiling for the price of one image, USD. Far above any real model; catches a misplaced decimal point. */
 exports.ROUTE_IMAGE_PRICE_MAX_USD = 10;
+// A route that is billed per image, not per token (resellers' image endpoints: the price is flat whatever
+// the size or quality). Cost of a call = `perImageUsd` x images returned.
 exports.RouteImagePricingSchema = zod_1.z
     .object({
     perImageUsd: zod_1.z
@@ -10,6 +13,7 @@ exports.RouteImagePricingSchema = zod_1.z
         .positive({ message: 'RouteImagePricing.perImageUsd.invalid' })
         .max(exports.ROUTE_IMAGE_PRICE_MAX_USD, { message: 'RouteImagePricing.perImageUsd.max' }),
     source: zod_1.z.string().max(200).optional(),
+    // When the price was last checked against the provider's own usage log.
     verifiedAt: zod_1.z.iso.date({ error: 'RouteImagePricing.verifiedAt.invalid' }),
 })
     .strict();

package/build/v1/model-route/schemas/route-image-pricing.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"route-image-pricing.schema.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/route-image-pricing.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAGX,QAAA,yBAAyB,GAAG,EAAE,CAAC;AAI/B,QAAA,uBAAuB,GAAG,OAAC;KACnC,MAAM,CAAC;IACJ,WAAW,EAAE,OAAC;SACT,MAAM,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC;SAC1D,QAAQ,CAAC,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;SAC9D,GAAG,CAAC,iCAAyB,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;IACrF,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAEtC,UAAU,EAAE,OAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;CAC5E,CAAC;KACD,MAAM,EAAE,CAAC"}
+{"version":3,"file":"route-image-pricing.schema.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/route-image-pricing.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,4GAA4G;AAC/F,QAAA,yBAAyB,GAAG,EAAE,CAAC;AAE5C,0GAA0G;AAC1G,0EAA0E;AAC7D,QAAA,uBAAuB,GAAG,OAAC;KACnC,MAAM,CAAC;IACJ,WAAW,EAAE,OAAC;SACT,MAAM,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC;SAC1D,QAAQ,CAAC,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;SAC9D,GAAG,CAAC,iCAAyB,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;IACrF,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACtC,wEAAwE;IACxE,UAAU,EAAE,OAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;CAC5E,CAAC;KACD,MAAM,EAAE,CAAC"}

package/build/v1/model-route/schemas/route-token-pricing.schema.d.ts

@@ -1,6 +1,8 @@
 import { z } from 'zod';
+/** Ceiling for one price, USD per 1M tokens. Far above any real model; catches a misplaced decimal point. */
 export declare const ROUTE_TOKEN_PRICE_MAX_USD_PER_MTOK = 10000;
 export declare const ROUTE_TOKEN_PRICING_MAX_TIERS = 4;
+/** Floor of the calibration multiplier: a price table that bills at under 5% of list is a typo. */
 export declare const ROUTE_TOKEN_PRICING_MIN_MULTIPLIER = 0.05;
 export declare const TokenPriceTierSchema: z.ZodObject<{
     maxPromptTokens: z.ZodNullable<z.ZodNumber>;

package/build/v1/model-route/schemas/route-token-pricing.schema.js

@@ -2,21 +2,29 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RouteTokenPricingSchema = exports.TokenPriceTierSchema = exports.ROUTE_TOKEN_PRICING_MIN_MULTIPLIER = exports.ROUTE_TOKEN_PRICING_MAX_TIERS = exports.ROUTE_TOKEN_PRICE_MAX_USD_PER_MTOK = void 0;
 const zod_1 = require("zod");
+/** Ceiling for one price, USD per 1M tokens. Far above any real model; catches a misplaced decimal point. */
 exports.ROUTE_TOKEN_PRICE_MAX_USD_PER_MTOK = 10_000;
 exports.ROUTE_TOKEN_PRICING_MAX_TIERS = 4;
+/** Floor of the calibration multiplier: a price table that bills at under 5% of list is a typo. */
 exports.ROUTE_TOKEN_PRICING_MIN_MULTIPLIER = 0.05;
 const UsdPerMTokSchema = zod_1.z
     .number({ error: 'RouteTokenPricing.price.invalid' })
     .nonnegative({ message: 'RouteTokenPricing.price.invalid' })
     .max(exports.ROUTE_TOKEN_PRICE_MAX_USD_PER_MTOK, { message: 'RouteTokenPricing.price.max' });
+/** Input and output are what every call is billed on: a zero there silently makes the route free. */
 const BilledUsdPerMTokSchema = UsdPerMTokSchema.positive({ message: 'RouteTokenPricing.price.invalid' });
+// The whole request is priced at the first tier whose `maxPromptTokens` covers the total prompt
+// (uncached + cache read + cache writes). `null` marks the open last tier.
 exports.TokenPriceTierSchema = zod_1.z
     .object({
     maxPromptTokens: zod_1.z.number().int().positive().nullable(),
     input: BilledUsdPerMTokSchema,
     output: BilledUsdPerMTokSchema,
+    // Omitted -> `input`.
     cacheRead: UsdPerMTokSchema.optional(),
+    // Omitted -> `input` (OpenAI-style: a cache write costs plain input).
     cacheWrite5m: UsdPerMTokSchema.optional(),
+    // Omitted -> `cacheWrite5m`.
     cacheWrite1h: UsdPerMTokSchema.optional(),
 })
     .strict();
@@ -30,6 +38,8 @@ function tiersAreOrdered(tiers) {
             (next.maxPromptTokens === null || next.maxPromptTokens > tier.maxPromptTokens));
     });
 }
+// Prices are USD per 1M tokens. `multiplier` calibrates published list prices to what the
+// provider really charges (WF Opus 5.5 = Anthropic list x 0.2).
 exports.RouteTokenPricingSchema = zod_1.z
     .object({
     tiers: zod_1.z
@@ -43,6 +53,7 @@ exports.RouteTokenPricingSchema = zod_1.z
         .max(1, { message: 'RouteTokenPricing.multiplier.max' })
         .optional(),
     source: zod_1.z.string().max(200).optional(),
+    // When the table was last checked against the provider's own usage figures.
     verifiedAt: zod_1.z.iso.date({ error: 'RouteTokenPricing.verifiedAt.invalid' }),
 })
     .strict();

package/build/v1/model-route/schemas/route-token-pricing.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"route-token-pricing.schema.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/route-token-pricing.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAGX,QAAA,kCAAkC,GAAG,MAAM,CAAC;AAC5C,QAAA,6BAA6B,GAAG,CAAC,CAAC;AAElC,QAAA,kCAAkC,GAAG,IAAI,CAAC;AAEvD,MAAM,gBAAgB,GAAG,OAAC;KACrB,MAAM,CAAC,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAC;KACpD,WAAW,CAAC,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;KAC3D,GAAG,CAAC,0CAAkC,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC,CAAC;AAGzF,MAAM,sBAAsB,GAAG,gBAAgB,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,CAAC;AAI5F,QAAA,oBAAoB,GAAG,OAAC;KAChC,MAAM,CAAC;IACJ,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACvD,KAAK,EAAE,sBAAsB;IAC7B,MAAM,EAAE,sBAAsB;IAE9B,SAAS,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IAEtC,YAAY,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IAEzC,YAAY,EAAE,gBAAgB,CAAC,QAAQ,EAAE;CAC5C,CAAC;KACD,MAAM,EAAE,CAAC;AAGd,SAAS,eAAe,CAAC,KAAgC;IACrD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/B,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,eAAe,KAAK,IAAI,CAAC;QAC9D,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC9B,OAAO,CACH,IAAI,CAAC,eAAe,KAAK,IAAI;YAC7B,CAAC,IAAI,CAAC,eAAe,KAAK,IAAI,IAAI,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,CACjF,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC;AAIY,QAAA,uBAAuB,GAAG,OAAC;KACnC,MAAM,CAAC;IACJ,KAAK,EAAE,OAAC;SACH,KAAK,CAAC,4BAAoB,CAAC;SAC3B,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;SAClD,GAAG,CAAC,qCAA6B,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;SAC9E,MAAM,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;IAC1E,UAAU,EAAE,OAAC;SACR,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;SACzD,GAAG,CAAC,0CAAkC,EAAE,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;SACxF,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;SACvD,QAAQ,EAAE;IACf,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAEtC,UAAU,EAAE,OAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;CAC5E,CAAC;KACD,MAAM,EAAE,CAAC"}
+{"version":3,"file":"route-token-pricing.schema.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/route-token-pricing.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,6GAA6G;AAChG,QAAA,kCAAkC,GAAG,MAAM,CAAC;AAC5C,QAAA,6BAA6B,GAAG,CAAC,CAAC;AAC/C,mGAAmG;AACtF,QAAA,kCAAkC,GAAG,IAAI,CAAC;AAEvD,MAAM,gBAAgB,GAAG,OAAC;KACrB,MAAM,CAAC,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAC;KACpD,WAAW,CAAC,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;KAC3D,GAAG,CAAC,0CAAkC,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC,CAAC;AAEzF,qGAAqG;AACrG,MAAM,sBAAsB,GAAG,gBAAgB,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,CAAC;AAEzG,gGAAgG;AAChG,2EAA2E;AAC9D,QAAA,oBAAoB,GAAG,OAAC;KAChC,MAAM,CAAC;IACJ,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACvD,KAAK,EAAE,sBAAsB;IAC7B,MAAM,EAAE,sBAAsB;IAC9B,sBAAsB;IACtB,SAAS,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IACtC,sEAAsE;IACtE,YAAY,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IACzC,6BAA6B;IAC7B,YAAY,EAAE,gBAAgB,CAAC,QAAQ,EAAE;CAC5C,CAAC;KACD,MAAM,EAAE,CAAC;AAGd,SAAS,eAAe,CAAC,KAAgC;IACrD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/B,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,eAAe,KAAK,IAAI,CAAC;QAC9D,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC9B,OAAO,CACH,IAAI,CAAC,eAAe,KAAK,IAAI;YAC7B,CAAC,IAAI,CAAC,eAAe,KAAK,IAAI,IAAI,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,CACjF,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC;AAED,0FAA0F;AAC1F,gEAAgE;AACnD,QAAA,uBAAuB,GAAG,OAAC;KACnC,MAAM,CAAC;IACJ,KAAK,EAAE,OAAC;SACH,KAAK,CAAC,4BAAoB,CAAC;SAC3B,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;SAClD,GAAG,CAAC,qCAA6B,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;SAC9E,MAAM,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;IAC1E,UAAU,EAAE,OAAC;SACR,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;SACzD,GAAG,CAAC,0CAAkC,EAAE,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;SACxF,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;SACvD,QAAQ,EAAE;IACf,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACtC,4EAA4E;IAC5E,UAAU,EAAE,OAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;CAC5E,CAAC;KACD,MAAM,EAAE,CAAC"}

package/build/v1/model-route/schemas/route-tool-settings.schema.d.ts

@@ -1,5 +1,18 @@
 import { z } from 'zod';
 import { SettingKey } from '../../ai-model/schemas/setting-key.enum';
+/**
+ * Route-scoped tool settings. Unlike the model-level `SettingOption` (which
+ * carried a per-`ApiProvider` `providerValues` map because settings were shared
+ * across a model's routes), a route fixes exactly one provider — so the
+ * provider-keyed map collapses to a single `wireValue` (the value sent to THIS
+ * route's provider). User selection stays by stable option `id`, so on failover
+ * A→B the choice is preserved and each route resolves its own `wireValue`.
+ *
+ * Route settings are WIRE-only. `promptSuffix` is intentionally absent: it shapes
+ * the pre-route PROMPT_GENERATION step (provider-independent) and is read from the
+ * model-level `AiModelTool.settingsConfig` via `getStylePromptSuffix`. If a
+ * prompt-shaping setting is ever introduced it stays a model-level concern.
+ */
 export declare const RouteToolSettingOptionSchema: z.ZodObject<{
     id: z.ZodString;
     priceModifier: z.ZodDefault<z.ZodNumber>;
@@ -7,6 +20,15 @@ export declare const RouteToolSettingOptionSchema: z.ZodObject<{
     wireValue: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type RouteToolSettingOption = z.infer<typeof RouteToolSettingOptionSchema>;
+/**
+ * READ/RESPONSE shape — mirrors what the DB can actually hold. The domain read
+ * path is deliberately lenient (`RouteToolSettings.fromPersistenceOrEmpty`
+ * keeps `autoSchemaConfig` optional so a dirty/hand-edited row degrades
+ * per-element instead of collapsing), so the response schema must tolerate the
+ * same shape — re-validating a stored row against the WRITE-strict schema would
+ * 500 the admin LIST on the first dirty row. Write-time strictness lives in
+ * `RouteToolSettingDefinitionWriteSchema` below.
+ */
 export declare const RouteToolSettingDefinitionSchema: z.ZodObject<{
     key: z.ZodEnum<typeof SettingKey>;
     options: z.ZodArray<z.ZodObject<{
@@ -37,6 +59,7 @@ export declare const RouteToolSettingsConfigSchema: z.ZodArray<z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strict>>;
 export type RouteToolSettingsConfig = z.infer<typeof RouteToolSettingsConfigSchema>;
+/** WRITE shape — strict: admin upserts must be complete and self-consistent. */
 export declare const RouteToolSettingDefinitionWriteSchema: z.ZodObject<{
     key: z.ZodEnum<typeof SettingKey>;
     options: z.ZodArray<z.ZodObject<{

package/build/v1/model-route/schemas/route-tool-settings.schema.js

@@ -4,6 +4,19 @@ exports.RouteToolSettingsConfigWriteSchema = exports.RouteToolSettingDefinitionW
 const zod_1 = require("zod");
 const setting_key_enum_1 = require("../../ai-model/schemas/setting-key.enum");
 const model_settings_schema_1 = require("../../ai-model/schemas/model-settings.schema");
+/**
+ * Route-scoped tool settings. Unlike the model-level `SettingOption` (which
+ * carried a per-`ApiProvider` `providerValues` map because settings were shared
+ * across a model's routes), a route fixes exactly one provider — so the
+ * provider-keyed map collapses to a single `wireValue` (the value sent to THIS
+ * route's provider). User selection stays by stable option `id`, so on failover
+ * A→B the choice is preserved and each route resolves its own `wireValue`.
+ *
+ * Route settings are WIRE-only. `promptSuffix` is intentionally absent: it shapes
+ * the pre-route PROMPT_GENERATION step (provider-independent) and is read from the
+ * model-level `AiModelTool.settingsConfig` via `getStylePromptSuffix`. If a
+ * prompt-shaping setting is ever introduced it stays a model-level concern.
+ */
 exports.RouteToolSettingOptionSchema = zod_1.z
     .object({
     id: zod_1.z.string().min(1).max(100),
@@ -12,6 +25,15 @@ exports.RouteToolSettingOptionSchema = zod_1.z
     wireValue: zod_1.z.string().min(1).max(1000).optional(),
 })
     .strict();
+/**
+ * READ/RESPONSE shape — mirrors what the DB can actually hold. The domain read
+ * path is deliberately lenient (`RouteToolSettings.fromPersistenceOrEmpty`
+ * keeps `autoSchemaConfig` optional so a dirty/hand-edited row degrades
+ * per-element instead of collapsing), so the response schema must tolerate the
+ * same shape — re-validating a stored row against the WRITE-strict schema would
+ * 500 the admin LIST on the first dirty row. Write-time strictness lives in
+ * `RouteToolSettingDefinitionWriteSchema` below.
+ */
 exports.RouteToolSettingDefinitionSchema = zod_1.z
     .object({
     key: zod_1.z.enum(setting_key_enum_1.SettingKey),
@@ -21,6 +43,7 @@ exports.RouteToolSettingDefinitionSchema = zod_1.z
 })
     .strict();
 exports.RouteToolSettingsConfigSchema = zod_1.z.array(exports.RouteToolSettingDefinitionSchema).max(20);
+/** WRITE shape — strict: admin upserts must be complete and self-consistent. */
 exports.RouteToolSettingDefinitionWriteSchema = zod_1.z
     .object({
     key: zod_1.z.enum(setting_key_enum_1.SettingKey),
@@ -29,6 +52,9 @@ exports.RouteToolSettingDefinitionWriteSchema = zod_1.z
     autoSchemaConfig: model_settings_schema_1.AutoSchemaConfigSchema,
 })
     .strict()
+    // defaultOptionId must reference one of this definition's own options — a
+    // dangling default silently falls back to options[0] at resolve time, so the
+    // route would serve/cost a different option than configured. Reject at write.
     .refine((def) => def.options.some((o) => o.id === def.defaultOptionId), {
     message: 'RouteToolSettingDefinition.defaultOptionId.notInOptions',
     path: ['defaultOptionId'],

package/build/v1/model-route/schemas/route-tool-settings.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"route-tool-settings.schema.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/route-tool-settings.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,8EAAqE;AACrE,wFAGsD;AAezC,QAAA,4BAA4B,GAAG,OAAC;KACxC,MAAM,CAAC;IACJ,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC9B,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,+CAAuB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3E,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;CACpD,CAAC;KACD,MAAM,EAAE,CAAC;AAYD,QAAA,gCAAgC,GAAG,OAAC;KAC5C,MAAM,CAAC;IACJ,GAAG,EAAE,OAAC,CAAC,IAAI,CAAC,6BAAU,CAAC;IACvB,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,oCAA4B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC9D,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC3C,gBAAgB,EAAE,8CAAsB,CAAC,QAAQ,EAAE;CACtD,CAAC;KACD,MAAM,EAAE,CAAC;AAGD,QAAA,6BAA6B,GAAG,OAAC,CAAC,KAAK,CAAC,wCAAgC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAIlF,QAAA,qCAAqC,GAAG,OAAC;KACjD,MAAM,CAAC;IACJ,GAAG,EAAE,OAAC,CAAC,IAAI,CAAC,6BAAU,CAAC;IACvB,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,oCAA4B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC9D,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC3C,gBAAgB,EAAE,8CAAsB;CAC3C,CAAC;KACD,MAAM,EAAE;KAIR,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,eAAe,CAAC,EAAE;IACpE,OAAO,EAAE,yDAAyD;IAClE,IAAI,EAAE,CAAC,iBAAiB,CAAC;CAC5B,CAAC,CAAC;AAGM,QAAA,kCAAkC,GAAG,OAAC;KAC9C,KAAK,CAAC,6CAAqC,CAAC;KAC5C,GAAG,CAAC,EAAE,CAAC,CAAC"}
+{"version":3,"file":"route-tool-settings.schema.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/route-tool-settings.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,8EAAqE;AACrE,wFAGsD;AAEtD;;;;;;;;;;;;GAYG;AACU,QAAA,4BAA4B,GAAG,OAAC;KACxC,MAAM,CAAC;IACJ,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC9B,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,+CAAuB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3E,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;CACpD,CAAC;KACD,MAAM,EAAE,CAAC;AAGd;;;;;;;;GAQG;AACU,QAAA,gCAAgC,GAAG,OAAC;KAC5C,MAAM,CAAC;IACJ,GAAG,EAAE,OAAC,CAAC,IAAI,CAAC,6BAAU,CAAC;IACvB,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,oCAA4B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC9D,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC3C,gBAAgB,EAAE,8CAAsB,CAAC,QAAQ,EAAE;CACtD,CAAC;KACD,MAAM,EAAE,CAAC;AAGD,QAAA,6BAA6B,GAAG,OAAC,CAAC,KAAK,CAAC,wCAAgC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAG/F,gFAAgF;AACnE,QAAA,qCAAqC,GAAG,OAAC;KACjD,MAAM,CAAC;IACJ,GAAG,EAAE,OAAC,CAAC,IAAI,CAAC,6BAAU,CAAC;IACvB,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,oCAA4B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC9D,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC3C,gBAAgB,EAAE,8CAAsB;CAC3C,CAAC;KACD,MAAM,EAAE;IACT,0EAA0E;IAC1E,6EAA6E;IAC7E,8EAA8E;KAC7E,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,eAAe,CAAC,EAAE;IACpE,OAAO,EAAE,yDAAyD;IAClE,IAAI,EAAE,CAAC,iBAAiB,CAAC;CAC5B,CAAC,CAAC;AAGM,QAAA,kCAAkC,GAAG,OAAC;KAC9C,KAAK,CAAC,6CAAqC,CAAC;KAC5C,GAAG,CAAC,EAAE,CAAC,CAAC"}

package/build/v1/model-route/schemas/update-model-route-request.schema.js

@@ -4,6 +4,8 @@ exports.UpdateModelRouteRequestSchema = void 0;
 const zod_1 = require("zod");
 const model_route_status_enum_1 = require("./model-route-status.enum");
 const provider_generation_config_schema_1 = require("./provider-generation-config.schema");
+// `apiProvider` and `externalSlug` are fixed at creation: `ai_calls` rows reference the route and
+// its cost history must stay attributable to the provider and model slug that produced it.
 exports.UpdateModelRouteRequestSchema = zod_1.z.object({
     priority: zod_1.z
         .number()

package/build/v1/model-route/schemas/update-model-route-request.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-model-route-request.schema.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/update-model-route-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,uEAA6D;AAC7D,2FAAqF;AAIxE,QAAA,6BAA6B,GAAG,OAAC,CAAC,MAAM,CAAC;IAClD,QAAQ,EAAE,OAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;SACxD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;SAC3D,QAAQ,EAAE;IACf,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,0CAAgB,CAAC,CAAC,QAAQ,EAAE;IAC3C,gBAAgB,EAAE,kEAA8B,CAAC,QAAQ,EAAE;CAC9D,CAAC,CAAC"}
+{"version":3,"file":"update-model-route-request.schema.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/update-model-route-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,uEAA6D;AAC7D,2FAAqF;AAErF,kGAAkG;AAClG,2FAA2F;AAC9E,QAAA,6BAA6B,GAAG,OAAC,CAAC,MAAM,CAAC;IAClD,QAAQ,EAAE,OAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;SACxD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;SAC3D,QAAQ,EAAE;IACf,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,0CAAgB,CAAC,CAAC,QAAQ,EAAE;IAC3C,gBAAgB,EAAE,kEAA8B,CAAC,QAAQ,EAAE;CAC9D,CAAC,CAAC"}

package/build/v1/model-route/schemas/wellflow-protocol.enum.d.ts

@@ -1,3 +1,19 @@
+/**
+ * Protocol discriminator for WellFlow-routed AI models.
+ *
+ * WellFlow (wellflow.dev) fronts upstream model providers behind two
+ * compatible wire formats. `WellflowAiProvider` dispatches internally
+ * to the right transport based on this discriminator from the model's
+ * `runtimeOverrides.wellflow.protocol` field.
+ *
+ * - `CLAUDE_MESSAGES` — `POST /v1/messages`, Anthropic Messages wire
+ *   (`X-Api-Key: wf_...` + `anthropic-version: 2023-06-01`). Used for
+ *   the Claude family.
+ *
+ * - `OPENAI_IMAGES` — `POST /v1/images/generations` and `/v1/images/edits`,
+ *   OpenAI Images wire, synchronous; the answer carries a signed media URL.
+ *   Billed per image.
+ */
 export declare enum WellflowProtocol {
     CLAUDE_MESSAGES = "CLAUDE_MESSAGES",
     OPENAI_IMAGES = "OPENAI_IMAGES"

package/build/v1/model-route/schemas/wellflow-protocol.enum.js

@@ -1,6 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WellflowProtocol = void 0;
+/**
+ * Protocol discriminator for WellFlow-routed AI models.
+ *
+ * WellFlow (wellflow.dev) fronts upstream model providers behind two
+ * compatible wire formats. `WellflowAiProvider` dispatches internally
+ * to the right transport based on this discriminator from the model's
+ * `runtimeOverrides.wellflow.protocol` field.
+ *
+ * - `CLAUDE_MESSAGES` — `POST /v1/messages`, Anthropic Messages wire
+ *   (`X-Api-Key: wf_...` + `anthropic-version: 2023-06-01`). Used for
+ *   the Claude family.
+ *
+ * - `OPENAI_IMAGES` — `POST /v1/images/generations` and `/v1/images/edits`,
+ *   OpenAI Images wire, synchronous; the answer carries a signed media URL.
+ *   Billed per image.
+ */
 var WellflowProtocol;
 (function (WellflowProtocol) {
     WellflowProtocol["CLAUDE_MESSAGES"] = "CLAUDE_MESSAGES";