@veruna/api-contracts 20.0.0 → 20.1.0

package/build-esm/v1/message/schemas/stream-event-type.enum.js

@@ -1,17 +1,46 @@
+/**
+ * Stream Event Types for message streaming (NDJSON format)
+ */
 export var StreamEventType;
 (function (StreamEventType) {
+    /** Transient routing status before visible model output. */
+    StreamEventType["GENERATION_STATUS"] = "GENERATION_STATUS";
+    /** Generation step started */
     StreamEventType["STEP_START"] = "STEP_START";
+    /** Chunk from any step (text, reasoning, prompt generation) */
     StreamEventType["STEP_CHUNK"] = "STEP_CHUNK";
+    /** Generation step failed (terminal error for the step) */
     StreamEventType["STEP_ERROR"] = "STEP_ERROR";
+    /** Generation step completed (NOT the whole stream) */
     StreamEventType["STEP_DONE"] = "STEP_DONE";
+    /** Image generated by AI */
     StreamEventType["IMAGE"] = "IMAGE";
+    /** Image generation failed (content filter, etc.) */
     StreamEventType["IMAGE_GENERATION_ERROR"] = "IMAGE_GENERATION_ERROR";
+    /** Web search citations/sources */
     StreamEventType["CITATIONS"] = "CITATIONS";
+    /** Keep-alive heartbeat (sent every 15 seconds) */
     StreamEventType["HEARTBEAT"] = "HEARTBEAT";
+    /**
+     * Initial billing hold opened (BEFORE the stream's first token).
+     * Carries the hold id and estimated lock amount so the frontend can
+     * show "X tokens locked" immediately. Reflects the lower-bound
+     * estimate (model.price + Σ explicit option deltas); runtime tools
+     * top up the hold mid-stream and surface via STEP_BILLED.
+     */
     StreamEventType["BILLING_ESTIMATE"] = "BILLING_ESTIMATE";
+    /**
+     * Per-step billing settled. Emitted after each billable step's
+     * settleStep call, carrying the step's individual cost and the
+     * cumulative held amount (initial estimate + Σ top-ups). Lets the
+     * UI show real-time spend climbing during the stream.
+     */
     StreamEventType["STEP_BILLED"] = "STEP_BILLED";
+    /** Stream completed successfully */
     StreamEventType["DONE"] = "DONE";
+    /** Stream cancelled by user */
     StreamEventType["CANCELLED"] = "CANCELLED";
+    /** Error occurred during streaming */
     StreamEventType["ERROR"] = "ERROR";
 })(StreamEventType || (StreamEventType = {}));
 //# sourceMappingURL=stream-event-type.enum.js.map

package/build-esm/v1/message/schemas/stream-event-type.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"stream-event-type.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/stream-event-type.enum.ts"],"names":[],"mappings":"AAGA,MAAM,CAAN,IAAY,eAsCX;AAtCD,WAAY,eAAe;IAEvB,4CAAyB,CAAA;IAEzB,4CAAyB,CAAA;IAEzB,4CAAyB,CAAA;IAEzB,0CAAuB,CAAA;IAEvB,kCAAe,CAAA;IAEf,oEAAiD,CAAA;IAEjD,0CAAuB,CAAA;IAEvB,0CAAuB,CAAA;IAQvB,wDAAqC,CAAA;IAOrC,8CAA2B,CAAA;IAE3B,gCAAa,CAAA;IAEb,0CAAuB,CAAA;IAEvB,kCAAe,CAAA;AACnB,CAAC,EAtCW,eAAe,KAAf,eAAe,QAsC1B"}
+{"version":3,"file":"stream-event-type.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/stream-event-type.enum.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,eAwCX;AAxCD,WAAY,eAAe;IACvB,4DAA4D;IAC5D,0DAAuC,CAAA;IACvC,8BAA8B;IAC9B,4CAAyB,CAAA;IACzB,+DAA+D;IAC/D,4CAAyB,CAAA;IACzB,2DAA2D;IAC3D,4CAAyB,CAAA;IACzB,uDAAuD;IACvD,0CAAuB,CAAA;IACvB,4BAA4B;IAC5B,kCAAe,CAAA;IACf,qDAAqD;IACrD,oEAAiD,CAAA;IACjD,mCAAmC;IACnC,0CAAuB,CAAA;IACvB,mDAAmD;IACnD,0CAAuB,CAAA;IACvB;;;;;;OAMG;IACH,wDAAqC,CAAA;IACrC;;;;;OAKG;IACH,8CAA2B,CAAA;IAC3B,oCAAoC;IACpC,gCAAa,CAAA;IACb,+BAA+B;IAC/B,0CAAuB,CAAA;IACvB,sCAAsC;IACtC,kCAAe,CAAA;AACnB,CAAC,EAxCW,eAAe,KAAf,eAAe,QAwC1B"}

package/build-esm/v1/message/schemas/stream-events.schema.js

@@ -1,103 +1,276 @@
+import { ErrorMetaSchema } from './error-meta.schema';
+import { GenerationStatus } from './generation-status.enum';
 import { z } from 'zod';
 import { GenerationStepType } from './generation-step-type.enum';
 import { StreamEventType } from './stream-event-type.enum';
 import { CitationSchema } from './citation.schema';
-import { StepStartMetadataSchema, StepDoneMetadataSchema, } from './step-metadata.schema';
+import { StepStartMetadataSchema, StepDoneMetadataSchema } from './step-metadata.schema';
 import { StepChunkMetadataSchema } from './step-chunk-metadata.schema';
+// ============================================================================
+// Base Event Schema
+// ============================================================================
 const BaseStreamEventSchema = z.object({
+    /** Sequential event ID (starts from 1) */
     id: z.number().int().positive(),
+    /** Chat UUID */
     chatId: z.string().uuid(),
+    /** AI Message UUID */
     messageId: z.string().uuid(),
 });
+// ============================================================================
+// Specific Event Schemas
+// ============================================================================
+/**
+ * Step start event - a generation step started
+ */
 export const StreamStepStartEventSchema = BaseStreamEventSchema.extend({
     type: z.literal(StreamEventType.STEP_START),
+    /** Which step type started */
     stepType: z.enum(GenerationStepType),
+    /** Unique step execution ID (UUID) */
     stepId: z.string().uuid(),
+    /** Step index in pipeline (0-based) */
     stepIndex: z.number().int().nonnegative(),
+    /**
+     * AiModel UUID that produced this step's output. Populated for
+     * step types in `MODEL_ATTRIBUTED_STEP_TYPES` (TEXT_GENERATION,
+     * REASONING, WEB_SEARCH, IMAGE_GENERATION, IMAGE_EDIT,
+     * VIDEO_ANALYSIS); `null` for
+     * tool / IO / utility-LLM steps that aren't user-attributed and
+     * for replayed events that pre-date this field. Frontend uses
+     * this to render which model generated each section of a message.
+     */
     modelUuid: z.string().uuid().nullable().default(null),
+    /** Typed metadata per step type (queries for web_search, sourceResolution for image_edit, etc.) */
     metadata: StepStartMetadataSchema,
 });
+/**
+ * Step chunk event - chunk from any step (text, reasoning, prompt generation).
+ *
+ * For text-producing steps (TEXT_GENERATION, REASONING, etc.) `chunk`
+ * carries the delta text and `metadata` is omitted. For CODE_EXECUTION
+ * steps the `metadata` discriminated union describes what the chunk
+ * represents (args streaming, bash line, create_file preview, etc.) and
+ * the frontend branches rendering on `metadata.kind`.
+ */
 export const StreamStepChunkEventSchema = BaseStreamEventSchema.extend({
     type: z.literal(StreamEventType.STEP_CHUNK),
+    /** Which step type this chunk belongs to */
     stepType: z.enum(GenerationStepType),
+    /** Unique step execution ID (UUID) */
     stepId: z.string().uuid(),
+    /** Chunk content */
     chunk: z.string(),
+    /**
+     * AiModel UUID that produced this step. Mirrors the value emitted on
+     * `STEP_START` for the same `stepId` — duplicated on every chunk so
+     * the FE can attribute the chunk to a model without maintaining a
+     * stepId→modelUuid map. `null` for non-attributed step types.
+     * See `MODEL_ATTRIBUTED_STEP_TYPES`.
+     */
     modelUuid: z.string().uuid().nullable().default(null),
+    /** Typed per-kind metadata for CODE_EXECUTION chunks; omitted otherwise. */
     metadata: StepChunkMetadataSchema.optional(),
 });
+/**
+ * Step error event - a generation step failed
+ */
 export const StreamStepErrorEventSchema = BaseStreamEventSchema.extend({
     type: z.literal(StreamEventType.STEP_ERROR),
+    /** Which step type failed */
     stepType: z.enum(GenerationStepType),
+    /** Unique step execution ID (UUID) */
     stepId: z.string().uuid(),
+    /** Step index in pipeline (0-based) */
     stepIndex: z.number().int().nonnegative(),
+    /**
+     * AiModel UUID that owned this step (mirrors `STEP_START.modelUuid`).
+     * `null` for non-attributed step types — see `MODEL_ATTRIBUTED_STEP_TYPES`.
+     */
     modelUuid: z.string().uuid().nullable().default(null),
+    /** Step error code */
     errorCode: z.string().min(1),
+    /** Optional step error message */
     errorMessage: z.string().optional(),
 });
+/**
+ * Step done event - a generation step completed (NOT the whole stream)
+ */
 export const StreamStepDoneEventSchema = BaseStreamEventSchema.extend({
     type: z.literal(StreamEventType.STEP_DONE),
+    /** Which step type completed */
     stepType: z.enum(GenerationStepType),
+    /** Unique step execution ID (UUID) */
     stepId: z.string().uuid(),
+    /** Step index in pipeline (0-based) */
     stepIndex: z.number().int().nonnegative(),
+    /**
+     * AiModel UUID that produced this step (mirrors `STEP_START.modelUuid`).
+     * `null` for non-attributed step types — see `MODEL_ATTRIBUTED_STEP_TYPES`.
+     */
     modelUuid: z.string().uuid().nullable().default(null),
+    /** Full content of the completed step (text steps) */
     fullContent: z.string().optional(),
+    /** Structured content for non-text steps (code_execution, web_search, etc.) */
     structuredContent: z.record(z.string(), z.unknown()).optional(),
+    /** Typed metadata per step type (imageUrl/imageUrls for upload step) */
     metadata: StepDoneMetadataSchema,
 });
+/**
+ * Billing estimate event — initial hold opened before stream start.
+ * Sized at `model.price + Σ explicit option deltas`. Tools called
+ * during the run top up via STEP_BILLED on the fly.
+ */
 export const StreamBillingEstimateEventSchema = BaseStreamEventSchema.extend({
     type: z.literal(StreamEventType.BILLING_ESTIMATE),
+    /** Hold UUID — same id used in transactions and DB. */
     holdId: z.string().uuid(),
+    /** Estimated amount locked at the start of the stream. */
     estimatedTokens: z.number().int().nonnegative(),
 });
+/**
+ * Per-step billing event — emitted after each billable step settles.
+ * `stepTokens` is the cost of this single step (after markup), and
+ * `heldTokens` is the cumulative hold size including this step (initial
+ * estimate + Σ top-ups so far). For non-billable steps no event is sent.
+ */
 export const StreamStepBilledEventSchema = BaseStreamEventSchema.extend({
     type: z.literal(StreamEventType.STEP_BILLED),
+    /** Hold UUID — same id used in transactions and DB. */
     holdId: z.string().uuid(),
+    /** Step UUID this charge belongs to. */
     stepId: z.string().uuid(),
+    /** Cost of this single step (already in user-facing tokens). */
     stepTokens: z.number().int().nonnegative(),
+    /** Cumulative hold size after this step (initial + top-ups). */
     heldTokens: z.number().int().nonnegative(),
+    /**
+     * What the step would have cost if balance were unlimited. Equal to
+     * `stepTokens` (or omitted) for ordinary settlements; greater than
+     * `stepTokens` when the wallet ran out and the StreamBudgetPolicy
+     * applied a discount on this step. UI can render a "💚 covered N
+     * tokens" badge inline when `discountTokens > 0`.
+     */
     requestedTokens: z.number().int().nonnegative().optional(),
+    /**
+     * Per-step write-off — `requestedTokens - stepTokens`. Always `>= 0`.
+     * Omitted when no overflow occurred.
+     */
     discountTokens: z.number().int().nonnegative().optional(),
 });
-export const StreamDoneEventSchema = BaseStreamEventSchema.extend({
+/**
+ * Done event - stream completed successfully.
+ *
+ * `chargedTokens` is the final amount billed to the user — set after
+ * finalize() completes (via the outbox sync fast-path). Optional
+ * because the worker may finalize asynchronously after the stream's
+ * terminal event has already been delivered; clients that need the
+ * exact charge should fall back to GET /messages/:id when absent.
+ */
+export const StreamDoneEventSchema = BaseStreamEventSchema.extend(ErrorMetaSchema.shape).extend({
     type: z.literal(StreamEventType.DONE),
     chargedTokens: z.number().int().nonnegative().optional(),
 });
+/**
+ * Why the stream was cancelled. Surfaced in the CANCELLED event so the UI
+ * can render an explanation distinct from "user pressed stop" — in
+ * particular, INSUFFICIENT_FUNDS pairs with a BUDGET_PROMO step in the
+ * persisted message and a topup / register CTA banner.
+ */
 export var StreamCancellationReason;
 (function (StreamCancellationReason) {
+    /** User invoked the stop button. */
     StreamCancellationReason["USER"] = "USER";
+    /** A heavy step couldn't be funded (StreamBudgetPolicy CUTOFF mode). */
     StreamCancellationReason["INSUFFICIENT_FUNDS"] = "INSUFFICIENT_FUNDS";
+    /** Internal failure (db drop, runtime crash). */
     StreamCancellationReason["SYSTEM"] = "SYSTEM";
 })(StreamCancellationReason || (StreamCancellationReason = {}));
-export const StreamCancelledEventSchema = BaseStreamEventSchema.extend({
+/**
+ * Cancelled event - stream cancelled by user OR by the runtime.
+ *
+ * `chargedTokens` reflects the partial settlement — only the steps that
+ * completed before cancel are charged. Additional fields explain *why*
+ * the stream stopped so the UI can render an actionable banner.
+ */
+export const StreamCancelledEventSchema = BaseStreamEventSchema.extend(ErrorMetaSchema.shape).extend({
     type: z.literal(StreamEventType.CANCELLED),
     chargedTokens: z.number().int().nonnegative().optional(),
+    /** Why the stream stopped. Optional for backwards compat with old clients. */
     reason: z.enum(StreamCancellationReason).optional(),
+    /**
+     * For INSUFFICIENT_FUNDS — the step type that couldn't be funded
+     * (e.g. IMAGE_GENERATION). Omitted for USER / SYSTEM.
+     */
     failedStepType: z.enum(GenerationStepType).optional(),
+    /**
+     * For INSUFFICIENT_FUNDS — tokens the failed step would have needed.
+     * Mirrors the BUDGET_PROMO step's `requiredTokens` for clients that
+     * render the banner from the live event before reload.
+     */
     requiredTokens: z.number().int().nonnegative().optional(),
+    /** For INSUFFICIENT_FUNDS — `requiredTokens - available`. */
     shortfallTokens: z.number().int().nonnegative().optional(),
 });
-export const StreamErrorEventSchema = BaseStreamEventSchema.extend({
+/**
+ * Error event - error occurred during streaming.
+ * No details are exposed to frontend for security reasons; the
+ * partial charge for steps that succeeded before the failure is
+ * surfaced via `chargedTokens` when available.
+ */
+export const StreamErrorEventSchema = BaseStreamEventSchema.extend(ErrorMetaSchema.shape).extend({
     type: z.literal(StreamEventType.ERROR),
     chargedTokens: z.number().int().nonnegative().optional(),
 });
+/**
+ * Image event - AI generated image (base64)
+ */
 export const StreamImageEventSchema = BaseStreamEventSchema.extend({
     type: z.literal(StreamEventType.IMAGE),
+    /** Base64 encoded image data */
     imageBase64: z.string().min(1),
+    /** Image MIME type (image/jpeg, image/png, etc.) */
     imageMimeType: z.string().min(1),
+    /** Image index (for multiple images in one message) */
     imageIndex: z.number().int().nonnegative(),
 });
+/**
+ * Image generation error event - image generation failed (content filter, etc.)
+ */
 export const StreamImageGenerationErrorEventSchema = BaseStreamEventSchema.extend({
     type: z.literal(StreamEventType.IMAGE_GENERATION_ERROR),
 });
+/**
+ * Citations event - web search sources
+ */
 export const StreamCitationsEventSchema = BaseStreamEventSchema.extend({
     type: z.literal(StreamEventType.CITATIONS),
+    /** Array of citations from web search */
     citations: z.array(CitationSchema),
 });
+/**
+ * Heartbeat event - keep-alive signal to prevent connection timeout
+ * Sent every 15 seconds during streaming
+ */
 export const StreamHeartbeatEventSchema = z.object({
     type: z.literal(StreamEventType.HEARTBEAT),
+    /** Server timestamp (ISO 8601) */
     timestamp: z.string().datetime(),
 });
+// ============================================================================
+// Union Schema
+// ============================================================================
+/** Transient routing status before the first text or reasoning output. */
+export const StreamGenerationStatusEventSchema = BaseStreamEventSchema.extend({
+    type: z.literal(StreamEventType.GENERATION_STATUS),
+    /** May arrive in replay after text. Clients ignore statuses once visible text exists. */
+    status: z.enum(GenerationStatus),
+    /** Model being tried now; SWITCHING_MODEL carries the new candidate model ID. */
+    modelId: z.string().uuid(),
+});
+/** Discriminated union of all stream events; narrow by `type`. */
 export const StreamEventSchema = z.discriminatedUnion('type', [
+    StreamGenerationStatusEventSchema,
     StreamStepStartEventSchema,
     StreamStepChunkEventSchema,
     StreamStepErrorEventSchema,

package/build-esm/v1/message/schemas/stream-events.schema.js.map

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

package/build-esm/v1/model-route/model-route.errors.js

@@ -1,13 +1,32 @@
 export var ModelRouteErrorCode;
 (function (ModelRouteErrorCode) {
+    ModelRouteErrorCode["PROTECTED_MODEL_LAST_ROUTE"] = "PROTECTED_MODEL_LAST_ROUTE";
     ModelRouteErrorCode["MODEL_ROUTE_NOT_FOUND"] = "MODEL_ROUTE_NOT_FOUND";
     ModelRouteErrorCode["DUPLICATE_MODEL_ROUTE"] = "DUPLICATE_MODEL_ROUTE";
     ModelRouteErrorCode["INVALID_MODEL_ROUTE"] = "INVALID_MODEL_ROUTE";
+    /**
+     * A numeric `runtimeOverrides.failover.ttfbTimeoutMs` override would
+     * violate the derived timeout hierarchy's pool nesting — e.g. it exceeds
+     * the image pool wall-clock, or it undercuts the KIE waiter floor for a
+     * KIE async-jobs route.
+     */
     ModelRouteErrorCode["INVALID_TTFB_TIMEOUT_OVERRIDE"] = "INVALID_TTFB_TIMEOUT_OVERRIDE";
+    /** No ModelRouteTool row exists for (route, tool) on lookup/delete. */
     ModelRouteErrorCode["ROUTE_TOOL_NOT_FOUND"] = "ROUTE_TOOL_NOT_FOUND";
+    /**
+     * A route-tool upsert carries an option id (for a setting the model also
+     * defines) that is not among the model-level `AiModelTool.settingsConfig`
+     * option ids for that setting. The AI-visible schema and the user-charged
+     * price modifiers are keyed by option id at the model level, so a route
+     * introducing an unknown id would silently diverge billing from generation.
+     */
     ModelRouteErrorCode["ROUTE_TOOL_OPTION_MISMATCH"] = "ROUTE_TOOL_OPTION_MISMATCH";
 })(ModelRouteErrorCode || (ModelRouteErrorCode = {}));
 export const MODEL_ROUTE_ERRORS = {
+    [ModelRouteErrorCode.PROTECTED_MODEL_LAST_ROUTE]: {
+        code: ModelRouteErrorCode.PROTECTED_MODEL_LAST_ROUTE,
+        statusCode: 409,
+    },
     [ModelRouteErrorCode.MODEL_ROUTE_NOT_FOUND]: {
         code: ModelRouteErrorCode.MODEL_ROUTE_NOT_FOUND,
         statusCode: 404,

package/build-esm/v1/model-route/model-route.errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-route.errors.js","sourceRoot":"","sources":["../../../v1/model-route/model-route.errors.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,mBAqBX;AArBD,WAAY,mBAAmB;IAC3B,sEAA+C,CAAA;IAC/C,sEAA+C,CAAA;IAC/C,kEAA2C,CAAA;IAO3C,sFAA+D,CAAA;IAE/D,oEAA6C,CAAA;IAQ7C,gFAAyD,CAAA;AAC7D,CAAC,EArBW,mBAAmB,KAAnB,mBAAmB,QAqB9B;AAED,MAAM,CAAC,MAAM,kBAAkB,GAA+C;IAC1E,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,EAAE;QACzC,IAAI,EAAE,mBAAmB,CAAC,qBAAqB;QAC/C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,EAAE;QACzC,IAAI,EAAE,mBAAmB,CAAC,qBAAqB;QAC/C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,EAAE;QACvC,IAAI,EAAE,mBAAmB,CAAC,mBAAmB;QAC7C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,mBAAmB,CAAC,6BAA6B,CAAC,EAAE;QACjD,IAAI,EAAE,mBAAmB,CAAC,6BAA6B;QACvD,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,mBAAmB,CAAC,oBAAoB,CAAC,EAAE;QACxC,IAAI,EAAE,mBAAmB,CAAC,oBAAoB;QAC9C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,mBAAmB,CAAC,0BAA0B,CAAC,EAAE;QAC9C,IAAI,EAAE,mBAAmB,CAAC,0BAA0B;QACpD,UAAU,EAAE,GAAG;KAClB;CACK,CAAC"}
+{"version":3,"file":"model-route.errors.js","sourceRoot":"","sources":["../../../v1/model-route/model-route.errors.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,mBAsBX;AAtBD,WAAY,mBAAmB;IAC3B,gFAAyD,CAAA;IACzD,sEAA+C,CAAA;IAC/C,sEAA+C,CAAA;IAC/C,kEAA2C,CAAA;IAC3C;;;;;OAKG;IACH,sFAA+D,CAAA;IAC/D,uEAAuE;IACvE,oEAA6C,CAAA;IAC7C;;;;;;OAMG;IACH,gFAAyD,CAAA;AAC7D,CAAC,EAtBW,mBAAmB,KAAnB,mBAAmB,QAsB9B;AAED,MAAM,CAAC,MAAM,kBAAkB,GAA+C;IAC1E,CAAC,mBAAmB,CAAC,0BAA0B,CAAC,EAAE;QAC9C,IAAI,EAAE,mBAAmB,CAAC,0BAA0B;QACpD,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,EAAE;QACzC,IAAI,EAAE,mBAAmB,CAAC,qBAAqB;QAC/C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,mBAAmB,CAAC,qBAAqB,CAAC,EAAE;QACzC,IAAI,EAAE,mBAAmB,CAAC,qBAAqB;QAC/C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,EAAE;QACvC,IAAI,EAAE,mBAAmB,CAAC,mBAAmB;QAC7C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,mBAAmB,CAAC,6BAA6B,CAAC,EAAE;QACjD,IAAI,EAAE,mBAAmB,CAAC,6BAA6B;QACvD,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,mBAAmB,CAAC,oBAAoB,CAAC,EAAE;QACxC,IAAI,EAAE,mBAAmB,CAAC,oBAAoB;QAC9C,UAAU,EAAE,GAAG;KAClB;IACD,CAAC,mBAAmB,CAAC,0BAA0B,CAAC,EAAE;QAC9C,IAAI,EAAE,mBAAmB,CAAC,0BAA0B;QACpD,UAAU,EAAE,GAAG;KAClB;CACK,CAAC"}

package/build-esm/v1/model-route/schemas/admin-model-route-sort.enum.js

@@ -1,3 +1,8 @@
+/**
+ * Admin ModelRoute sort fields.
+ * Values map to sortable ModelRoute columns.
+ * Sort direction uses the shared `SortOrder` enum.
+ */
 export var AdminModelRouteSortField;
 (function (AdminModelRouteSortField) {
     AdminModelRouteSortField["PRIORITY"] = "priority";

package/build-esm/v1/model-route/schemas/admin-model-route-sort.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-model-route-sort.enum.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/admin-model-route-sort.enum.ts"],"names":[],"mappings":"AAKA,MAAM,CAAN,IAAY,wBAIX;AAJD,WAAY,wBAAwB;IAChC,iDAAqB,CAAA;IACrB,oDAAwB,CAAA;IACxB,oDAAwB,CAAA;AAC5B,CAAC,EAJW,wBAAwB,KAAxB,wBAAwB,QAInC"}
+{"version":3,"file":"admin-model-route-sort.enum.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/admin-model-route-sort.enum.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAN,IAAY,wBAIX;AAJD,WAAY,wBAAwB;IAChC,iDAAqB,CAAA;IACrB,oDAAwB,CAAA;IACxB,oDAAwB,CAAA;AAC5B,CAAC,EAJW,wBAAwB,KAAxB,wBAAwB,QAInC"}

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

@@ -1,3 +1,7 @@
+/**
+ * KIE async createTask / webhook flow (image/video/audio generation).
+ * JOBS is also the default when runtimeOverrides.kie.protocol is omitted.
+ */
 export var KieProtocol;
 (function (KieProtocol) {
     KieProtocol["JOBS"] = "JOBS";

package/build-esm/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,MAAM,CAAN,IAAY,WAEX;AAFD,WAAY,WAAW;IACnB,4BAAa,CAAA;AACjB,CAAC,EAFW,WAAW,KAAX,WAAW,QAEtB"}
+{"version":3,"file":"kie-protocol.enum.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/kie-protocol.enum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,WAEX;AAFD,WAAY,WAAW;IACnB,4BAAa,CAAA;AACjB,CAAC,EAFW,WAAW,KAAX,WAAW,QAEtB"}

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

@@ -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 const ListModelRoutesFiltersSchema = z.object({
     q: z.string().max(255).optional(),
     status: z.enum(ModelRouteStatus).optional(),

package/build-esm/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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAMzD,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC;SACnE,QAAQ,EAAE;IACf,SAAS,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;SACjE,QAAQ,EAAE;IACf,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,QAAQ,CAAC;IACnF,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,SAAS,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,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC;SACnE,QAAQ,EAAE;IACf,SAAS,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,CAAC,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;SACjE,QAAQ,EAAE;IACf,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,QAAQ,CAAC;IACnF,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC;CACtD,CAAC,CAAC"}

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

@@ -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 var OpenRouterTransport;
 (function (OpenRouterTransport) {
     OpenRouterTransport["CHAT"] = "CHAT";

package/build-esm/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,MAAM,CAAN,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC3B,oCAAa,CAAA;IACb,wCAAiB,CAAA;AACrB,CAAC,EAHW,mBAAmB,KAAnB,mBAAmB,QAG9B"}
+{"version":3,"file":"openrouter-transport.enum.js","sourceRoot":"","sources":["../../../../v1/model-route/schemas/openrouter-transport.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAN,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC3B,oCAAa,CAAA;IACb,wCAAiB,CAAA;AACrB,CAAC,EAHW,mBAAmB,KAAnB,mBAAmB,QAG9B"}

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

@@ -6,6 +6,13 @@ import { OpenRouterTransport } from './openrouter-transport.enum';
 import { ResellerTransport } from './reseller-transport.enum';
 import { RouteImagePricingSchema } from './route-image-pricing.schema';
 import { RouteTokenPricingSchema } from './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).
 export const KiePricingSchema = z
     .object({
     base: z.number().nonnegative(),
@@ -32,15 +39,28 @@ export const OpenRouterProviderConfigSchema = z
     .strict();
 export const OpenRouterGenerationConfigSchema = 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: z.enum(OpenRouterTransport).optional(),
     imageConfig: 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: z.boolean().optional(),
     provider: 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: z.array(z.string().min(1).max(200)).max(20).optional(),
 })
     .strict();
 export const KieGenerationConfigSchema = z
     .object({
+    // JOBS (or omitted) selects the async createTask/webhook flow.
     protocol: z.enum(KieProtocol).optional(),
     input: z.record(z.string(), z.unknown()).optional(),
     inputUrlsKey: z.string().optional(),
@@ -49,9 +69,13 @@ export const KieGenerationConfigSchema = z
     bodyMode: z.enum(KieBodyMode).optional(),
     promptMaxLen: z.number().int().positive().max(50000).optional(),
     pricing: KiePricingSchema.optional(),
+    // Resolved option selection per setting key, captured at config-build
+    // time. Fed to the cost calculator together with `pricing.modifiers`.
     selectedOptions: z.record(z.string().max(100), 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.
 export const OpenAiImagesConfigSchema = z
     .object({
     size: z.string().max(16).optional(),
@@ -61,26 +85,55 @@ export const OpenAiImagesConfigSchema = z
     .strict();
 export const WellflowGenerationConfigSchema = 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: z.enum(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: z.number().int().positive().max(1_000_000).optional(),
+    // Image settings of an `OPENAI_IMAGES` route.
     imageConfig: OpenAiImagesConfigSchema.optional(),
 })
     .strict();
+// OpenAI-compatible resellers (DEROUTER, APIROUTE): one shape for both vendors.
 export const ResellerGenerationConfigSchema = z
     .object({
+    // Output token cap forwarded as `max_tokens`. Omitted → upstream default.
     maxTokens: 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: z.enum(ResellerTransport).optional(),
+    // Image settings of an `IMAGES` route.
     imageConfig: OpenAiImagesConfigSchema.optional(),
 })
     .strict();
+// Provider-agnostic failover tuning for a route. Lives alongside the provider
+// blocks in `runtimeOverrides` and is admin-editable per route.
 export const RouteFailoverConfigSchema = 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: z.number().int().positive().max(600_000).nullable().optional(),
 })
     .strict();
+/** Потолок здравого смысла для `limits.maxInputImages` — с запасом выше любой реальной модели. */
 export const ROUTE_MAX_INPUT_IMAGES_CEILING = 100;
+// Ёмкость эндпоинта модели за роутом, не зависящая от провайдера. Пул роутов
+// читает её ДО вызова: запрос, который эндпоинт не примет, уходит на следующий
+// роут, а не получает отказ апстрима (и не обрезается молча). Не задано —
+// лимит неизвестен, роут принимает любой запрос.
 export const RouteLimitsConfigSchema = z
     .object({
+    // Сколько входных (референсных) картинок может нести один запрос к роуту.
+    // `0` — эндпоинт картинок на вход не принимает вовсе (только text-to-image).
     maxInputImages: z
         .number({ error: 'RouteLimitsConfig.maxInputImages.invalid' })
         .int({ message: 'RouteLimitsConfig.maxInputImages.int' })
@@ -99,7 +152,11 @@ export const ProviderGenerationConfigSchema = z
     reseller: ResellerGenerationConfigSchema.optional(),
     failover: RouteFailoverConfigSchema.optional(),
     limits: 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: 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: RouteImagePricingSchema.optional(),
 })
     .strict();