@veruna/api-contracts 19.1.0 → 20.1.0

package/build-esm/v1/message/schemas/message-error-action.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-error-action.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/message-error-action.enum.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,CAAN,IAAY,kBAgBX;AAhBD,WAAY,kBAAkB;IAC1B,uFAAuF;IACvF,qCAAe,CAAA;IACf,+EAA+E;IAC/E,mDAA6B,CAAA;IAC7B,iFAAiF;IACjF,2CAAqB,CAAA;IACrB;4FACwF;IACxF,2CAAqB,CAAA;IACrB,uEAAuE;IACvE,uCAAiB,CAAA;IACjB,4EAA4E;IAC5E,2CAAqB,CAAA;IACrB,+EAA+E;IAC/E,2CAAqB,CAAA;AACzB,CAAC,EAhBW,kBAAkB,KAAlB,kBAAkB,QAgB7B"}

package/build-esm/v1/message/schemas/message-error-category.enum.js

@@ -0,0 +1,16 @@
+export var MessageErrorCategory;
+(function (MessageErrorCategory) {
+    MessageErrorCategory["MODEL_TIMEOUT"] = "MODEL_TIMEOUT";
+    MessageErrorCategory["PROVIDER_UNAVAILABLE"] = "PROVIDER_UNAVAILABLE";
+    MessageErrorCategory["POLICY_REFUSAL"] = "POLICY_REFUSAL";
+    MessageErrorCategory["CHAT_TOO_LONG"] = "CHAT_TOO_LONG";
+    MessageErrorCategory["REQUEST_TOO_LONG"] = "REQUEST_TOO_LONG";
+    MessageErrorCategory["FILE_UNREADABLE"] = "FILE_UNREADABLE";
+    MessageErrorCategory["NOT_SUPPORTED"] = "NOT_SUPPORTED";
+    MessageErrorCategory["INSUFFICIENT_FUNDS"] = "INSUFFICIENT_FUNDS";
+    MessageErrorCategory["INTERRUPTED"] = "INTERRUPTED";
+    /** Reserved for budget exits in the long-documents branch; no producer here. */
+    MessageErrorCategory["LIMIT_REACHED"] = "LIMIT_REACHED";
+    MessageErrorCategory["UNKNOWN"] = "UNKNOWN";
+})(MessageErrorCategory || (MessageErrorCategory = {}));
+//# sourceMappingURL=message-error-category.enum.js.map

package/build-esm/v1/message/schemas/message-error-category.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-error-category.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/message-error-category.enum.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,oBAaX;AAbD,WAAY,oBAAoB;IAC5B,uDAA+B,CAAA;IAC/B,qEAA6C,CAAA;IAC7C,yDAAiC,CAAA;IACjC,uDAA+B,CAAA;IAC/B,6DAAqC,CAAA;IACrC,2DAAmC,CAAA;IACnC,uDAA+B,CAAA;IAC/B,iEAAyC,CAAA;IACzC,mDAA2B,CAAA;IAC3B,gFAAgF;IAChF,uDAA+B,CAAA;IAC/B,2CAAmB,CAAA;AACvB,CAAC,EAbW,oBAAoB,KAApB,oBAAoB,QAa/B"}

package/build-esm/v1/message/schemas/message-response.schema.js

@@ -1,21 +1,37 @@
 import { z } from 'zod';
+import { ErrorMetaSchema } from './error-meta.schema';
 import { MessageRole } from './message-role.enum';
 import { MessageStatus } from './message-status.enum';
 import { UserRating } from './user-rating.enum';
 import { MessageStepsResponseSchema } from './message-step-response.schema';
 import { MessageAttachmentsResponseSchema } from './message-attachment-response.schema';
 import { MessageCitationsResponseSchema } from './message-citation-response.schema';
-export const MessageResponseSchema = z.object({
+export const MessageResponseSchema = ErrorMetaSchema.extend({
     uuid: z.string().uuid(),
     role: z.enum(MessageRole),
     status: z.enum(MessageStatus),
     content: z.string().nullable(),
+    /**
+     * Model selected by the user for this message, including AI responses.
+     * Retry uses this model. A last-resort switch preserves this value;
+     * the answer step's modelUuid identifies the model that actually served.
+     */
     aiModelId: z.string().uuid().nullable(),
     assistantId: z.string().uuid().nullable(),
     userRating: z.enum(UserRating).nullable(),
+    /** Generation steps (for multi-stage generation) */
     steps: MessageStepsResponseSchema,
+    /** Attachments (images, files) */
     attachments: MessageAttachmentsResponseSchema,
+    /** Citations from web search */
     citations: MessageCitationsResponseSchema,
+    /**
+     * User-paid amount in internal tokens — sum of all settled steps'
+     * `internalPrice` after finalize. `0` while the stream is still
+     * GENERATING (terminal save hasn't run yet); the live spend climb
+     * is delivered via the `STEP_BILLED` SSE events. Never reflects
+     * provider cost — that stays internal.
+     */
     internalTotalPrice: z.number().int().nonnegative(),
     createdAt: z.string(),
     updatedAt: z.string(),

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

@@ -1 +1 @@
-{"version":3,"file":"message-response.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/message-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,gCAAgC,EAAE,MAAM,sCAAsC,CAAC;AACxF,OAAO,EAAE,8BAA8B,EAAE,MAAM,oCAAoC,CAAC;AAEpF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACvB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACvC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACzC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE;IAEzC,KAAK,EAAE,0BAA0B;IAEjC,WAAW,EAAE,gCAAgC;IAE7C,SAAS,EAAE,8BAA8B;IAQzC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAClD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC"}
+{"version":3,"file":"message-response.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/message-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,gCAAgC,EAAE,MAAM,sCAAsC,CAAC;AACxF,OAAO,EAAE,8BAA8B,EAAE,MAAM,oCAAoC,CAAC;AAEpF,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAC,MAAM,CAAC;IACxD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACvB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B;;;;OAIG;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACvC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACzC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE;IACzC,oDAAoD;IACpD,KAAK,EAAE,0BAA0B;IACjC,kCAAkC;IAClC,WAAW,EAAE,gCAAgC;IAC7C,gCAAgC;IAChC,SAAS,EAAE,8BAA8B;IACzC;;;;;;OAMG;IACH,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAClD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC"}

package/build-esm/v1/message/schemas/message-step-response.schema.js

@@ -7,22 +7,47 @@ import { GenerationStepType } from './generation-step-type.enum';
 import { MessageStepStatus } from './message-step-status.enum';
 import { MemoryEditCommand } from '../../memory/schemas/memory-edit-command.enum';
 import { FollowupSuggestionsStepContentSchema } from './followup-suggestions-step-content.schema';
+/**
+ * Text-based step content (REASONING, TEXT_GENERATION, PROMPT_GENERATION)
+ */
 export const TextStepContentSchema = z.object({
     content: z.string(),
 });
+/**
+ * Web search citation schema
+ */
 export const WebSearchCitationSchema = z.object({
     url: z.string(),
     title: z.string(),
     content: z.string(),
 });
+/**
+ * Web search step content
+ */
 export const WebSearchStepContentSchema = z.object({
     queries: z.array(z.string()),
     citations: z.array(WebSearchCitationSchema),
 });
+/**
+ * Image generation step content (always null - images stored in attachments)
+ */
 export const ImageGenStepContentSchema = z.null();
+/**
+ * Upload step content - array of uploaded URLs
+ */
 export const UploadStepContentSchema = z.object({
     urls: z.array(z.string()),
 });
+/**
+ * Code execution step content — full execution record for history rendering.
+ *
+ * `primitive` carries the per-primitive completion payload (path, hunk,
+ * preview, view meta, …) so the UI can rebuild the live GitHub-style card
+ * from history without parsing `code` / `stdout`. Absent on legacy rows.
+ *
+ * `description` carries the cold-path one-line summary emitted by the
+ * step-lifecycle middleware when args were not streamed token-by-token.
+ */
 export const CodeExecutionStepContentResponseSchema = z.object({
     code: z.string(),
     language: z.string(),
@@ -45,10 +70,21 @@ export const CodeExecutionStepContentResponseSchema = z.object({
     primitive: SandboxPrimitiveCompletionSchema.optional(),
     description: z.string().optional(),
 });
+/**
+ * Memory step content (MEMORY step). Lets the UI show what the assistant
+ * remembered / removed / changed: `command` is the operation and `text` is the
+ * affected memory text (the new value for ADD/REPLACE; null for REMOVE/VIEW).
+ * The FE localizes the verb from `command` so the text stays language-neutral.
+ */
 export const MemoryStepContentSchema = z.object({
     command: z.enum(MemoryEditCommand),
     text: z.string().nullable(),
 });
+/**
+ * One matched chat in a CONVERSATION_SEARCH step. `chatId` + `messageId` let the
+ * FE deep-link straight to the matched message (messageId is null when the match
+ * was on the chat title / no message snippet).
+ */
 export const ConversationSearchResultItemSchema = z.object({
     chatId: z.string().uuid(),
     messageId: z.string().uuid().nullable(),
@@ -56,21 +92,59 @@ export const ConversationSearchResultItemSchema = z.object({
     snippet: z.string(),
     lastMessageAt: z.string(),
 });
+/**
+ * CONVERSATION_SEARCH step content. `query` is what was searched (also on
+ * STEP_START metadata for the live "searching for X"); `results` are the matched
+ * past chats with deep-link ids so the user can jump straight to them.
+ */
 export const ConversationSearchStepContentSchema = z.object({
     query: z.string(),
     results: z.array(ConversationSearchResultItemSchema),
     hasMore: z.boolean(),
 });
+/**
+ * VIDEO_ANALYSIS step content. `content` is the analysis text; `videoUrl` is the
+ * analysed video so the UI can show/link it in history (mirrors the STEP_START
+ * `metadata.videoUrl`). MUST be ordered before `TextStepContentSchema` in the
+ * union below — both accept `{ content }`, and a union picks the first match, so
+ * Text-first would strip `videoUrl` on parse.
+ */
 export const VideoAnalysisStepContentSchema = z.object({
     content: z.string(),
+    // `.url()` mirrors VideoAnalysisStepStartMetadataSchema exactly. Safe even
+    // for a hypothetically-malformed stored value: this is the first union arm,
+    // so a non-URL falls through to TextStepContentSchema (text-only) rather
+    // than failing the whole step.
     videoUrl: z.string().url(),
 });
+/**
+ * CONNECTOR_TOOL step content — records which connector tool ran so the UI can
+ * render the tool card in history and the model can replay the call.
+ *
+ * `toolName` is the provider-local tool name (UI label); `connectionUuid` lets
+ * the FE resolve the owning connection; `providerKey` is the first-party
+ * provider key or null for a custom MCP connection; `resultPreview` is a
+ * truncated, neutralized output preview (ends with an ellipsis when truncated).
+ * NB: FAILED steps persist NO content at all (`content: null` on the step) —
+ * failure is signalled by the step's status/errorCode, never by this shape.
+ * No field is named `content` — the unique keys keep this arm unambiguous in
+ * the plain union.
+ */
 export const ConnectorToolStepContentSchema = z.object({
     toolName: z.string(),
     connectionUuid: z.string(),
     providerKey: z.string().nullable(),
     resultPreview: z.string().nullable(),
 });
+/**
+ * Union of all step content types.
+ *
+ * Anything MISSING here is silently erased on read: `stripInternalContentFields`
+ * parses against this union and returns `null` on a miss, so the step survives
+ * in the database and disappears from the API. A card that renders live and
+ * vanishes on reload is exactly that bug — the shape has to be listed here too,
+ * not only in the domain schema.
+ */
 export const StepContentResponseSchema = z.union([
     BudgetPromoStepContentSchema,
     CapabilityLockedStepContentSchema,
@@ -86,18 +160,78 @@ export const StepContentResponseSchema = z.union([
     ConnectorToolStepContentSchema,
     FollowupSuggestionsStepContentSchema,
 ]);
+/**
+ * Message step response schema for frontend
+ * Shows generation progress and step details
+ */
 export const MessageStepResponseSchema = z.object({
+    /** Step UUID */
     uuid: z.string().uuid(),
+    /** Step type */
     type: z.enum(GenerationStepType),
+    /** Current status */
     status: z.enum(MessageStepStatus),
+    /**
+     * AiModel UUID that produced this step. Mirrors the value emitted on
+     * stream `STEP_*` events for the same step. 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. Frontend uses this to render which model
+     * generated each section after the live stream is gone.
+     * For a last-resort answer, TEXT_GENERATION carries the served model;
+     * the message's aiModelId retains the user's selected model. Compare these
+     * UUIDs to show "answered by model X". Billing and analytics that need the
+     * served model use this step attribution (message_steps.model_id).
+     */
     modelUuid: z.string().uuid().nullable(),
+    /** Step content (text, reasoning) */
     content: StepContentResponseSchema.nullable(),
+    /** Whether to show in UI */
     showInUi: z.boolean(),
+    /**
+     * Typed error code for FAILED steps (`MessageErrorCode` values, e.g.
+     * IMAGE_CONTENT_FILTERED / IMAGE_REQUEST_PROHIBITED), `null` otherwise.
+     * Mirrors the streaming `STEP_DONE` error payload so the frontend can
+     * render the same dedicated state (e.g. the censorship plate) after a
+     * reload as it does live. Error MESSAGE is deliberately not exposed —
+     * it may carry internal detail; the code + client locales suffice.
+     */
     errorCode: z.string().nullable(),
+    /** When step started */
     startedAt: z.string().nullable(),
+    /** When step completed */
     completedAt: z.string().nullable(),
+    /**
+     * User-facing charge for this step in internal tokens.
+     * - `null`     — step is still in flight or was never settled
+     *                (e.g. PRICED-but-not-SETTLED orphan).
+     * - `0`        — free-for-user system step (PROMPT_GENERATION /
+     *                EDIT_PROMPT_GENERATION) or a step type that
+     *                produces no price by policy (REASONING).
+     * - positive   — actual token amount the user paid for this step.
+     * Provider cost (`external_price` in DB) is never exposed.
+     */
     internalPrice: z.number().int().nonnegative().nullable(),
+    /**
+     * What the step would have cost at full price.
+     * - Equals `internalPrice` for ordinary settlements.
+     * - Strictly greater than `internalPrice` when the
+     *   `StreamBudgetPolicy` applied a discount on this step
+     *   (DISCOUNT mid-stream) — drives the "💚 covered N" badge.
+     * - For `INSUFFICIENT_FUNDS` (CUTOFF) steps `internalPrice` is `0`
+     *   and `requestedInternalPrice` carries the missed amount used by
+     *   the "you missed N tokens" banner.
+     * - `null` only when the step never reached pricing (PENDING /
+     *   PRICED-not-yet-SETTLED).
+     *
+     * The discount is always derivable as
+     * `requestedInternalPrice - internalPrice`; we don't ship a
+     * separate field to keep wire-shape minimal.
+     */
     requestedInternalPrice: z.number().int().nonnegative().nullable(),
 });
+/**
+ * Array of step responses
+ */
 export const MessageStepsResponseSchema = z.array(MessageStepResponseSchema);
 //# sourceMappingURL=message-step-response.schema.js.map

package/build-esm/v1/message/schemas/message-step-response.schema.js.map

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

package/build-esm/v1/message/schemas/message-step-status.enum.js

@@ -1,3 +1,16 @@
+/**
+ * Message step status for tracking generation progress.
+ *
+ * `INSUFFICIENT_FUNDS` is the terminal status the
+ * `StreamBudgetPolicy` writes when a step couldn't be funded mid-stream
+ * (the CUTOFF branch). Semantically a kind of cancel, but separated from
+ * the generic `CANCELLED` so reporting / orphan-scan can short-circuit
+ * without an extra column. When `status = INSUFFICIENT_FUNDS`:
+ *   - `internal_price = 0`              (nothing was actually charged)
+ *   - `requested_internal_price` > 0   (what the step would have cost)
+ *   - `external_price` may be set       (provider was already paid)
+ *   - `pricingSnapshot` stays NULL      (no settle ran)
+ */
 export var MessageStepStatus;
 (function (MessageStepStatus) {
     MessageStepStatus["PENDING"] = "PENDING";

package/build-esm/v1/message/schemas/message-step-status.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"message-step-status.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/message-step-status.enum.ts"],"names":[],"mappings":"AAaA,MAAM,CAAN,IAAY,iBAQX;AARD,WAAY,iBAAiB;IACzB,wCAAmB,CAAA;IACnB,wCAAmB,CAAA;IACnB,4CAAuB,CAAA;IACvB,wCAAmB,CAAA;IACnB,sCAAiB,CAAA;IACjB,4CAAuB,CAAA;IACvB,8DAAyC,CAAA;AAC7C,CAAC,EARW,iBAAiB,KAAjB,iBAAiB,QAQ5B"}
+{"version":3,"file":"message-step-status.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/message-step-status.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAN,IAAY,iBAQX;AARD,WAAY,iBAAiB;IACzB,wCAAmB,CAAA;IACnB,wCAAmB,CAAA;IACnB,4CAAuB,CAAA;IACvB,wCAAmB,CAAA;IACnB,sCAAiB,CAAA;IACjB,4CAAuB,CAAA;IACvB,8DAAyC,CAAA;AAC7C,CAAC,EARW,iBAAiB,KAAjB,iBAAiB,QAQ5B"}

package/build-esm/v1/message/schemas/model-attributed-step-types.const.js

@@ -1,4 +1,19 @@
 import { GenerationStepType } from './generation-step-type.enum';
+/**
+ * Step types whose `STEP_START` stream event carries a `modelUuid`
+ * pointing at the AiModel that produced the step's output.
+ *
+ * Source of truth — both backend emit logic and frontend rendering
+ * MUST read this set instead of hardcoding their own list. Any other
+ * step type emits `modelUuid: null` on the wire (tool / IO steps —
+ * CODE_EXECUTION, UPLOAD, VIEW_FILE, SEND_FILE, FIND_IN_CHAT,
+ * HTML_VISUALIZATION — and internal utility-LLM steps —
+ * PROMPT_GENERATION, EDIT_PROMPT_GENERATION — that aren't
+ * user-attributed).
+ *
+ * VIDEO_ANALYSIS is attributed: the analysis is produced by a real
+ * AiModel and the UI surfaces which model did the processing.
+ */
 export const MODEL_ATTRIBUTED_STEP_TYPES = new Set([
     GenerationStepType.TEXT_GENERATION,
     GenerationStepType.REASONING,

package/build-esm/v1/message/schemas/model-attributed-step-types.const.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-attributed-step-types.const.js","sourceRoot":"","sources":["../../../../v1/message/schemas/model-attributed-step-types.const.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAiBjE,MAAM,CAAC,MAAM,2BAA2B,GAAoC,IAAI,GAAG,CAAC;IAChF,kBAAkB,CAAC,eAAe;IAClC,kBAAkB,CAAC,SAAS;IAC5B,kBAAkB,CAAC,UAAU;IAC7B,kBAAkB,CAAC,gBAAgB;IACnC,kBAAkB,CAAC,UAAU;IAC7B,kBAAkB,CAAC,cAAc;CACpC,CAAC,CAAC;AAEH,MAAM,UAAU,yBAAyB,CAAC,IAAwB;IAC9D,OAAO,2BAA2B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC"}
+{"version":3,"file":"model-attributed-step-types.const.js","sourceRoot":"","sources":["../../../../v1/message/schemas/model-attributed-step-types.const.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAoC,IAAI,GAAG,CAAC;IAChF,kBAAkB,CAAC,eAAe;IAClC,kBAAkB,CAAC,SAAS;IAC5B,kBAAkB,CAAC,UAAU;IAC7B,kBAAkB,CAAC,gBAAgB;IACnC,kBAAkB,CAAC,UAAU;IAC7B,kBAAkB,CAAC,cAAc;CACpC,CAAC,CAAC;AAEH,MAAM,UAAU,yBAAyB,CAAC,IAAwB;IAC9D,OAAO,2BAA2B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC"}

package/build-esm/v1/message/schemas/rate-message.schema.js

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { UserRating } from './user-rating.enum';
+/**
+ * Rate Message Request Schema
+ * Error messages: RateMessageRequest.{field}.{rule}
+ */
 export const RateMessageRequestSchema = z.object({
     rating: z.enum(UserRating, {
         error: 'RateMessageRequest.rating.invalid',
@@ -8,6 +12,10 @@ export const RateMessageRequestSchema = z.object({
 export const RateMessageResponseSchema = z.object({
     id: z.string().uuid(),
 });
+/**
+ * Rate Message Params Schema
+ * Error messages: RateMessageParams.{field}.{rule}
+ */
 export const RateMessageParamsSchema = z.object({
     chatId: z
         .string({ error: 'RateMessageParams.chatId.required' })

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

@@ -1 +1 @@
-{"version":3,"file":"rate-message.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/rate-message.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAMhD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE;QACvB,KAAK,EAAE,mCAAmC;KAC7C,CAAC;CACL,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;CACxB,CAAC,CAAC;AAMH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,CAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;SACtD,IAAI,CAAC,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;IAC1D,SAAS,EAAE,CAAC;SACP,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;SACzD,IAAI,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;CAChE,CAAC,CAAC"}
+{"version":3,"file":"rate-message.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/rate-message.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE;QACvB,KAAK,EAAE,mCAAmC;KAC7C,CAAC;CACL,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;CACxB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,CAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;SACtD,IAAI,CAAC,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;IAC1D,SAAS,EAAE,CAAC;SACP,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;SACzD,IAAI,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;CAChE,CAAC,CAAC"}

package/build-esm/v1/message/schemas/step-card.enums.js

@@ -1,10 +1,41 @@
+/**
+ * Pieces shared by every server-emitted card that hangs under an answer.
+ *
+ * They live apart from any one card because all three step types use them —
+ * BUDGET_PROMO, CAPABILITY_LOCKED and FILE_TRUNCATED. Naming them after one of
+ * those (as `BudgetPromoCta` did) is the same lie the split exists to remove:
+ * a card about a locked tool has nothing to do with a budget.
+ */
+/** The single action the card offers. Absent on purely informational cards. */
 export var CardCta;
 (function (CardCta) {
+    /** Unregistered users — promote a free signup with starter tokens. */
     CardCta["REGISTER"] = "REGISTER";
+    /** Registered users — promote a balance top-up. */
     CardCta["TOPUP"] = "TOPUP";
+    /**
+     * Registered users whose PLAN lacks the tool. Money is not the blocker, so
+     * a topup button would take them to a screen that cannot unlock anything.
+     */
     CardCta["UPGRADE"] = "UPGRADE";
+    /**
+     * The tool is already theirs and simply switched off. Neither money nor a
+     * plan stands in the way, so the button opens the tool picker — sending
+     * this person to a paywall would be asking them to buy what they own.
+     */
     CardCta["ENABLE"] = "ENABLE";
 })(CardCta || (CardCta = {}));
+/**
+ * Stable identifier the server stamps on a card so the frontend (or i18n layer)
+ * can pick localized copy without re-deriving it from the structural fields.
+ *
+ * The prefix is the STEP TYPE the key belongs to, so a key names its own card
+ * without anyone having to look up which union it came from.
+ *
+ * Frontend treats unknown values as "fall back to the default copy derived from
+ * the structural fields" so a future server adding a key doesn't crash old
+ * clients.
+ */
 export var CardMessageKey;
 (function (CardMessageKey) {
     CardMessageKey["DISCOUNT_APPLIED_REGISTER"] = "BUDGET_PROMO.DISCOUNT_APPLIED.REGISTER";
@@ -15,7 +46,15 @@ export var CardMessageKey;
     CardMessageKey["CAPABILITY_LOCKED_UPGRADE"] = "CAPABILITY_LOCKED.UPGRADE";
     CardMessageKey["CAPABILITY_LOCKED_ENABLE"] = "CAPABILITY_LOCKED.ENABLE";
     CardMessageKey["FILE_TRUNCATED"] = "FILE_TRUNCATED";
+    /** Guest CTA: «Продолжить разбор», without promising a complete read. */
     CardMessageKey["FILE_TRUNCATED_REGISTER"] = "FILE_TRUNCATED.REGISTER";
+    /**
+     * Nothing at all reached the model — the document failed to convert.
+     *
+     * Its own key, and never a CTA: an account does not repair a broken
+     * conversion, so offering one here sells a fix that does not exist. The
+     * honest ask is to try the file again.
+     */
     CardMessageKey["FILE_TRUNCATED_UNREADABLE"] = "FILE_TRUNCATED.UNREADABLE";
 })(CardMessageKey || (CardMessageKey = {}));
 //# sourceMappingURL=step-card.enums.js.map

package/build-esm/v1/message/schemas/step-card.enums.js.map

@@ -1 +1 @@
-{"version":3,"file":"step-card.enums.js","sourceRoot":"","sources":["../../../../v1/message/schemas/step-card.enums.ts"],"names":[],"mappings":"AAUA,MAAM,CAAN,IAAY,OAgBX;AAhBD,WAAY,OAAO;IAEf,gCAAqB,CAAA;IAErB,0BAAe,CAAA;IAKf,8BAAmB,CAAA;IAMnB,4BAAiB,CAAA;AACrB,CAAC,EAhBW,OAAO,KAAP,OAAO,QAgBlB;AAaD,MAAM,CAAN,IAAY,cAmBX;AAnBD,WAAY,cAAc;IACtB,sFAAoE,CAAA;IACpE,gFAA8D,CAAA;IAC9D,gFAA8D,CAAA;IAC9D,0EAAwD,CAAA;IACxD,2EAAyD,CAAA;IACzD,yEAAuD,CAAA;IACvD,uEAAqD,CAAA;IACrD,mDAAiC,CAAA;IAEjC,qEAAmD,CAAA;IAQnD,yEAAuD,CAAA;AAC3D,CAAC,EAnBW,cAAc,KAAd,cAAc,QAmBzB"}
+{"version":3,"file":"step-card.enums.js","sourceRoot":"","sources":["../../../../v1/message/schemas/step-card.enums.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,+EAA+E;AAC/E,MAAM,CAAN,IAAY,OAgBX;AAhBD,WAAY,OAAO;IACf,sEAAsE;IACtE,gCAAqB,CAAA;IACrB,mDAAmD;IACnD,0BAAe,CAAA;IACf;;;OAGG;IACH,8BAAmB,CAAA;IACnB;;;;OAIG;IACH,4BAAiB,CAAA;AACrB,CAAC,EAhBW,OAAO,KAAP,OAAO,QAgBlB;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAN,IAAY,cAmBX;AAnBD,WAAY,cAAc;IACtB,sFAAoE,CAAA;IACpE,gFAA8D,CAAA;IAC9D,gFAA8D,CAAA;IAC9D,0EAAwD,CAAA;IACxD,2EAAyD,CAAA;IACzD,yEAAuD,CAAA;IACvD,uEAAqD,CAAA;IACrD,mDAAiC,CAAA;IACjC,yEAAyE;IACzE,qEAAmD,CAAA;IACnD;;;;;;OAMG;IACH,yEAAuD,CAAA;AAC3D,CAAC,EAnBW,cAAc,KAAd,cAAc,QAmBzB"}

package/build-esm/v1/message/schemas/step-chunk-kind.enum.js

@@ -1,3 +1,15 @@
+/**
+ * Discriminator for STEP_CHUNK metadata shapes.
+ *
+ * - `ARGS` — emitted WHILE the LLM is still streaming tool-call JSON
+ *   arguments. The intent's `chunk` field carries the streamed text; the
+ *   primitive widget on the UI accumulates it live.
+ * - `DESCRIBE` — emitted ONCE by the step-lifecycle middleware when no
+ *   pre-assigned stepId exists (cold-start path). Carries the finalized
+ *   "describe-code" summary text on `chunk`.
+ * - The rest are emitted by specific sandbox primitives with rich payloads
+ *   for GitHub-style UX.
+ */
 export var StepChunkKind;
 (function (StepChunkKind) {
     StepChunkKind["ARGS"] = "ARGS";

package/build-esm/v1/message/schemas/step-chunk-kind.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"step-chunk-kind.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/step-chunk-kind.enum.ts"],"names":[],"mappings":"AAYA,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACrB,8BAAa,CAAA;IACb,sCAAqB,CAAA;IACrB,8BAAa,CAAA;IACb,4CAA2B,CAAA;IAC3B,4CAA2B,CAAA;IAC3B,8BAAa,CAAA;AACjB,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB"}
+{"version":3,"file":"step-chunk-kind.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/step-chunk-kind.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAN,IAAY,aAOX;AAPD,WAAY,aAAa;IACrB,8BAAa,CAAA;IACb,sCAAqB,CAAA;IACrB,8BAAa,CAAA;IACb,4CAA2B,CAAA;IAC3B,4CAA2B,CAAA;IAC3B,8BAAa,CAAA;AACjB,CAAC,EAPW,aAAa,KAAb,aAAa,QAOxB"}

package/build-esm/v1/message/schemas/step-chunk-metadata.schema.js

@@ -3,20 +3,63 @@ import { FilePreviewSchema, SANDBOX_CHUNK_LINE_MAX_LENGTH, SANDBOX_CHUNK_LINES_M
 import { SandboxPrimitiveType } from '../../tool/sandbox/sandbox-primitive-type.enum';
 import { StepChunkKind } from './step-chunk-kind.enum';
 import { BashChunkStream } from './bash-chunk-stream.enum';
+/**
+ * Per-line wire cap. Re-exported from the sandbox layer so existing call
+ * sites keep their symbol; single source of truth lives in
+ * `primitive-completion.schema.ts`.
+ */
 export const STEP_CHUNK_LINE_MAX_LENGTH = SANDBOX_CHUNK_LINE_MAX_LENGTH;
+/**
+ * Absolute line-array cap on the wire. Same source of truth.
+ */
 export const STEP_CHUNK_LINES_MAX_ITEMS = SANDBOX_CHUNK_LINES_MAX_ITEMS;
+/**
+ * ARGS chunk — live tool-call argument streaming.
+ *
+ * The primitive is not yet running. The chunk text on the enclosing intent
+ * is a partial / streaming slice of the argument field being assembled (the
+ * LLM is still typing). The UI attributes each delta to the right primitive
+ * widget via `primitiveType`.
+ *
+ * The argument text is carried on the intent's `chunk` field, NOT here.
+ */
 export const ArgsChunkMetadataSchema = z.object({
     kind: z.literal(StepChunkKind.ARGS),
     primitiveType: z.enum(SandboxPrimitiveType),
 });
+/**
+ * DESCRIBE chunk — finalized describe-code summary.
+ *
+ * Emitted exactly once per step, at step open, by the pipeline middleware
+ * for primitives that did NOT get a pre-assigned stepId (i.e. the LLM did
+ * not stream arguments live — the tool call arrived in one shot). The chunk
+ * text on the enclosing intent is the already-finalized one-line code
+ * summary (e.g. `bash ls -la`, `create_file /home/user/app.py`).
+ *
+ * Mutually exclusive with ARGS on the same stepId.
+ */
 export const DescribeChunkMetadataSchema = z.object({
     kind: z.literal(StepChunkKind.DESCRIBE),
     primitiveType: z.enum(SandboxPrimitiveType),
 });
+/**
+ * BASH chunk — one line of sandbox bash output. Emitted many times per
+ * step while the command runs, plus a final chunk if the buffer overflowed
+ * or output was truncated.
+ *
+ * The line text is on the intent's `chunk` field.
+ */
 export const BashChunkMetadataSchema = z.object({
     kind: z.literal(StepChunkKind.BASH),
     stream: z.enum(BashChunkStream),
 });
+/**
+ * CREATE_FILE chunk — emitted once after a successful write. Carries the
+ * information the UI needs to render a GitHub-style "files added" card.
+ * Inner payload (path/preview/…) is shared with the persisted
+ * `CreateFileCompletion` on the step content, so live card and history
+ * card render from the same shape.
+ */
 export const CreateFileChunkMetadataSchema = z.object({
     kind: z.literal(StepChunkKind.CREATE_FILE),
     path: z.string().min(1).max(4096),
@@ -25,6 +68,10 @@ export const CreateFileChunkMetadataSchema = z.object({
     overwrite: z.boolean(),
     preview: FilePreviewSchema,
 });
+/**
+ * STR_REPLACE chunk — emitted once after a successful single-occurrence
+ * replace. Same shape as the persisted `StrReplaceCompletion`.
+ */
 export const StrReplaceChunkMetadataSchema = z.object({
     kind: z.literal(StepChunkKind.STR_REPLACE),
     path: z.string().min(1).max(4096),
@@ -34,11 +81,23 @@ export const StrReplaceChunkMetadataSchema = z.object({
     linesAfter: z.number().int().nonnegative(),
     hunk: StrReplaceHunkSchema,
 });
+/**
+ * VIEW chunk — emitted once per successful view operation. The `view`
+ * payload is the same shape persisted on `ViewCompletion`.
+ *
+ * Actual content (directory entries, file text slice, image URL) lands on
+ * the STEP_DONE `content` payload or separate ATTACHMENT_READY intents —
+ * this chunk only carries header/metadata for the live card.
+ */
 export const ViewChunkMetadataSchema = z.object({
     kind: z.literal(StepChunkKind.VIEW),
     path: z.string().min(1).max(4096),
     view: SandboxViewDataSchema,
 });
+/**
+ * Discriminated union of every possible STEP_CHUNK metadata shape. The
+ * frontend narrows on `metadata.kind` and renders accordingly.
+ */
 export const StepChunkMetadataSchema = z.discriminatedUnion('kind', [
     ArgsChunkMetadataSchema,
     DescribeChunkMetadataSchema,

package/build-esm/v1/message/schemas/step-chunk-metadata.schema.js.map

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