@veruna/api-contracts 20.0.0 → 20.2.0

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

@@ -2,23 +2,39 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MessageResponseSchema = void 0;
 const zod_1 = require("zod");
+const error_meta_schema_1 = require("./error-meta.schema");
 const message_role_enum_1 = require("./message-role.enum");
 const message_status_enum_1 = require("./message-status.enum");
 const user_rating_enum_1 = require("./user-rating.enum");
 const message_step_response_schema_1 = require("./message-step-response.schema");
 const message_attachment_response_schema_1 = require("./message-attachment-response.schema");
 const message_citation_response_schema_1 = require("./message-citation-response.schema");
-exports.MessageResponseSchema = zod_1.z.object({
+exports.MessageResponseSchema = error_meta_schema_1.ErrorMetaSchema.extend({
     uuid: zod_1.z.string().uuid(),
     role: zod_1.z.enum(message_role_enum_1.MessageRole),
     status: zod_1.z.enum(message_status_enum_1.MessageStatus),
     content: zod_1.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: zod_1.z.string().uuid().nullable(),
     assistantId: zod_1.z.string().uuid().nullable(),
     userRating: zod_1.z.enum(user_rating_enum_1.UserRating).nullable(),
+    /** Generation steps (for multi-stage generation) */
     steps: message_step_response_schema_1.MessageStepsResponseSchema,
+    /** Attachments (images, files) */
     attachments: message_attachment_response_schema_1.MessageAttachmentsResponseSchema,
+    /** Citations from web search */
     citations: message_citation_response_schema_1.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: zod_1.z.number().int().nonnegative(),
     createdAt: zod_1.z.string(),
     updatedAt: zod_1.z.string(),

package/build/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,6BAAwB;AACxB,2DAAkD;AAClD,+DAAsD;AACtD,yDAAgD;AAChD,iFAA4E;AAC5E,6FAAwF;AACxF,yFAAoF;AAEvE,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACvB,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,+BAAW,CAAC;IACzB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,mCAAa,CAAC;IAC7B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACvC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACzC,UAAU,EAAE,OAAC,CAAC,IAAI,CAAC,6BAAU,CAAC,CAAC,QAAQ,EAAE;IAEzC,KAAK,EAAE,yDAA0B;IAEjC,WAAW,EAAE,qEAAgC;IAE7C,SAAS,EAAE,iEAA8B;IAQzC,kBAAkB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAClD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,OAAC,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,6BAAwB;AACxB,2DAAsD;AACtD,2DAAkD;AAClD,+DAAsD;AACtD,yDAAgD;AAChD,iFAA4E;AAC5E,6FAAwF;AACxF,yFAAoF;AAEvE,QAAA,qBAAqB,GAAG,mCAAe,CAAC,MAAM,CAAC;IACxD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACvB,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,+BAAW,CAAC;IACzB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,mCAAa,CAAC;IAC7B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B;;;;OAIG;IACH,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACvC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACzC,UAAU,EAAE,OAAC,CAAC,IAAI,CAAC,6BAAU,CAAC,CAAC,QAAQ,EAAE;IACzC,oDAAoD;IACpD,KAAK,EAAE,yDAA0B;IACjC,kCAAkC;IAClC,WAAW,EAAE,qEAAgC;IAC7C,gCAAgC;IAChC,SAAS,EAAE,iEAA8B;IACzC;;;;;;OAMG;IACH,kBAAkB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAClD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC"}

package/build/v1/message/schemas/message-role.enum.d.ts

@@ -5,6 +5,6 @@ export declare enum MessageRole {
     USER = "USER",
     COMPACT = "COMPACT",
     TOOL = "TOOL",
-    INTERNAL = "INTERNAL",
+    INTERNAL = "INTERNAL",// For system costs tracking, not shown to frontend
     SYSTEM_NO_FUNDS = "SYSTEM_NO_FUNDS"
 }

package/build/v1/message/schemas/message-step-response.schema.d.ts

@@ -2,14 +2,23 @@ import { z } from 'zod';
 import { GenerationStepType } from './generation-step-type.enum';
 import { MessageStepStatus } from './message-step-status.enum';
 import { MemoryEditCommand } from '../../memory/schemas/memory-edit-command.enum';
+/**
+ * Text-based step content (REASONING, TEXT_GENERATION, PROMPT_GENERATION)
+ */
 export declare const TextStepContentSchema: z.ZodObject<{
     content: z.ZodString;
 }, z.core.$strip>;
+/**
+ * Web search citation schema
+ */
 export declare const WebSearchCitationSchema: z.ZodObject<{
     url: z.ZodString;
     title: z.ZodString;
     content: z.ZodString;
 }, z.core.$strip>;
+/**
+ * Web search step content
+ */
 export declare const WebSearchStepContentSchema: z.ZodObject<{
     queries: z.ZodArray<z.ZodString>;
     citations: z.ZodArray<z.ZodObject<{
@@ -18,10 +27,26 @@ export declare const WebSearchStepContentSchema: z.ZodObject<{
         content: z.ZodString;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+/**
+ * Image generation step content (always null - images stored in attachments)
+ */
 export declare const ImageGenStepContentSchema: z.ZodNull;
+/**
+ * Upload step content - array of uploaded URLs
+ */
 export declare const UploadStepContentSchema: z.ZodObject<{
     urls: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * 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 declare const CodeExecutionStepContentResponseSchema: z.ZodObject<{
     code: z.ZodString;
     language: z.ZodString;
@@ -87,10 +112,21 @@ export declare const CodeExecutionStepContentResponseSchema: z.ZodObject<{
     }, z.core.$strip>], "type">>;
     description: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * 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 declare const MemoryStepContentSchema: z.ZodObject<{
     command: z.ZodEnum<typeof MemoryEditCommand>;
     text: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * 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 declare const ConversationSearchResultItemSchema: z.ZodObject<{
     chatId: z.ZodString;
     messageId: z.ZodNullable<z.ZodString>;
@@ -98,6 +134,11 @@ export declare const ConversationSearchResultItemSchema: z.ZodObject<{
     snippet: z.ZodString;
     lastMessageAt: z.ZodString;
 }, z.core.$strip>;
+/**
+ * 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 declare const ConversationSearchStepContentSchema: z.ZodObject<{
     query: z.ZodString;
     results: z.ZodArray<z.ZodObject<{
@@ -109,16 +150,45 @@ export declare const ConversationSearchStepContentSchema: z.ZodObject<{
     }, z.core.$strip>>;
     hasMore: z.ZodBoolean;
 }, z.core.$strip>;
+/**
+ * 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 declare const VideoAnalysisStepContentSchema: z.ZodObject<{
     content: z.ZodString;
     videoUrl: z.ZodString;
 }, z.core.$strip>;
+/**
+ * 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 declare const ConnectorToolStepContentSchema: z.ZodObject<{
     toolName: z.ZodString;
     connectionUuid: z.ZodString;
     providerKey: z.ZodNullable<z.ZodString>;
     resultPreview: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
+/**
+ * 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 declare const StepContentResponseSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
     cta: z.ZodEnum<typeof import("./step-card.enums").CardCta>;
     messageKey: z.ZodOptional<z.ZodEnum<typeof import("./step-card.enums").CardMessageKey>>;
@@ -245,6 +315,10 @@ export declare const StepContentResponseSchema: z.ZodUnion<readonly [z.ZodDiscri
 }, z.core.$strip>, z.ZodObject<{
     suggestions: z.ZodArray<z.ZodString>;
 }, z.core.$strip>]>;
+/**
+ * Message step response schema for frontend
+ * Shows generation progress and step details
+ */
 export declare const MessageStepResponseSchema: z.ZodObject<{
     uuid: z.ZodString;
     type: z.ZodEnum<typeof GenerationStepType>;
@@ -396,6 +470,9 @@ export type ConversationSearchResultItem = z.infer<typeof ConversationSearchResu
 export type ConversationSearchStepContent = z.infer<typeof ConversationSearchStepContentSchema>;
 export type VideoAnalysisStepContent = z.infer<typeof VideoAnalysisStepContentSchema>;
 export type ConnectorToolStepContent = z.infer<typeof ConnectorToolStepContentSchema>;
+/**
+ * Array of step responses
+ */
 export declare const MessageStepsResponseSchema: z.ZodArray<z.ZodObject<{
     uuid: z.ZodString;
     type: z.ZodEnum<typeof GenerationStepType>;

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

@@ -10,22 +10,47 @@ const generation_step_type_enum_1 = require("./generation-step-type.enum");
 const message_step_status_enum_1 = require("./message-step-status.enum");
 const memory_edit_command_enum_1 = require("../../memory/schemas/memory-edit-command.enum");
 const followup_suggestions_step_content_schema_1 = require("./followup-suggestions-step-content.schema");
+/**
+ * Text-based step content (REASONING, TEXT_GENERATION, PROMPT_GENERATION)
+ */
 exports.TextStepContentSchema = zod_1.z.object({
     content: zod_1.z.string(),
 });
+/**
+ * Web search citation schema
+ */
 exports.WebSearchCitationSchema = zod_1.z.object({
     url: zod_1.z.string(),
     title: zod_1.z.string(),
     content: zod_1.z.string(),
 });
+/**
+ * Web search step content
+ */
 exports.WebSearchStepContentSchema = zod_1.z.object({
     queries: zod_1.z.array(zod_1.z.string()),
     citations: zod_1.z.array(exports.WebSearchCitationSchema),
 });
+/**
+ * Image generation step content (always null - images stored in attachments)
+ */
 exports.ImageGenStepContentSchema = zod_1.z.null();
+/**
+ * Upload step content - array of uploaded URLs
+ */
 exports.UploadStepContentSchema = zod_1.z.object({
     urls: zod_1.z.array(zod_1.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.
+ */
 exports.CodeExecutionStepContentResponseSchema = zod_1.z.object({
     code: zod_1.z.string(),
     language: zod_1.z.string(),
@@ -48,10 +73,21 @@ exports.CodeExecutionStepContentResponseSchema = zod_1.z.object({
     primitive: primitive_completion_schema_1.SandboxPrimitiveCompletionSchema.optional(),
     description: zod_1.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.
+ */
 exports.MemoryStepContentSchema = zod_1.z.object({
     command: zod_1.z.enum(memory_edit_command_enum_1.MemoryEditCommand),
     text: zod_1.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).
+ */
 exports.ConversationSearchResultItemSchema = zod_1.z.object({
     chatId: zod_1.z.string().uuid(),
     messageId: zod_1.z.string().uuid().nullable(),
@@ -59,21 +95,59 @@ exports.ConversationSearchResultItemSchema = zod_1.z.object({
     snippet: zod_1.z.string(),
     lastMessageAt: zod_1.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.
+ */
 exports.ConversationSearchStepContentSchema = zod_1.z.object({
     query: zod_1.z.string(),
     results: zod_1.z.array(exports.ConversationSearchResultItemSchema),
     hasMore: zod_1.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.
+ */
 exports.VideoAnalysisStepContentSchema = zod_1.z.object({
     content: zod_1.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: zod_1.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.
+ */
 exports.ConnectorToolStepContentSchema = zod_1.z.object({
     toolName: zod_1.z.string(),
     connectionUuid: zod_1.z.string(),
     providerKey: zod_1.z.string().nullable(),
     resultPreview: zod_1.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.
+ */
 exports.StepContentResponseSchema = zod_1.z.union([
     budget_promo_step_content_schema_1.BudgetPromoStepContentSchema,
     capability_locked_step_content_schema_1.CapabilityLockedStepContentSchema,
@@ -89,18 +163,78 @@ exports.StepContentResponseSchema = zod_1.z.union([
     exports.ConnectorToolStepContentSchema,
     followup_suggestions_step_content_schema_1.FollowupSuggestionsStepContentSchema,
 ]);
+/**
+ * Message step response schema for frontend
+ * Shows generation progress and step details
+ */
 exports.MessageStepResponseSchema = zod_1.z.object({
+    /** Step UUID */
     uuid: zod_1.z.string().uuid(),
+    /** Step type */
     type: zod_1.z.enum(generation_step_type_enum_1.GenerationStepType),
+    /** Current status */
     status: zod_1.z.enum(message_step_status_enum_1.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: zod_1.z.string().uuid().nullable(),
+    /** Step content (text, reasoning) */
     content: exports.StepContentResponseSchema.nullable(),
+    /** Whether to show in UI */
     showInUi: zod_1.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: zod_1.z.string().nullable(),
+    /** When step started */
     startedAt: zod_1.z.string().nullable(),
+    /** When step completed */
     completedAt: zod_1.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: zod_1.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: zod_1.z.number().int().nonnegative().nullable(),
 });
+/**
+ * Array of step responses
+ */
 exports.MessageStepsResponseSchema = zod_1.z.array(exports.MessageStepResponseSchema);
 //# sourceMappingURL=message-step-response.schema.js.map

package/build/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/v1/message/schemas/message-step-status.enum.d.ts

@@ -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 declare enum MessageStepStatus {
     PENDING = "PENDING",
     RUNNING = "RUNNING",

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

@@ -1,6 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MessageStepStatus = void 0;
+/**
+ * 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)
+ */
 var MessageStepStatus;
 (function (MessageStepStatus) {
     MessageStepStatus["PENDING"] = "PENDING";

package/build/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,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,iCAAjB,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,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,iCAAjB,iBAAiB,QAQ5B"}

package/build/v1/message/schemas/model-attributed-step-types.const.d.ts

@@ -1,3 +1,18 @@
 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 declare const MODEL_ATTRIBUTED_STEP_TYPES: ReadonlySet<GenerationStepType>;
 export declare function isModelAttributedStepType(type: GenerationStepType): boolean;

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

@@ -3,6 +3,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MODEL_ATTRIBUTED_STEP_TYPES = void 0;
 exports.isModelAttributedStepType = isModelAttributedStepType;
 const generation_step_type_enum_1 = require("./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.
+ */
 exports.MODEL_ATTRIBUTED_STEP_TYPES = new Set([
     generation_step_type_enum_1.GenerationStepType.TEXT_GENERATION,
     generation_step_type_enum_1.GenerationStepType.REASONING,

package/build/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":";;;AA0BA,8DAEC;AA5BD,2EAAiE;AAiBpD,QAAA,2BAA2B,GAAoC,IAAI,GAAG,CAAC;IAChF,8CAAkB,CAAC,eAAe;IAClC,8CAAkB,CAAC,SAAS;IAC5B,8CAAkB,CAAC,UAAU;IAC7B,8CAAkB,CAAC,gBAAgB;IACnC,8CAAkB,CAAC,UAAU;IAC7B,8CAAkB,CAAC,cAAc;CACpC,CAAC,CAAC;AAEH,SAAgB,yBAAyB,CAAC,IAAwB;IAC9D,OAAO,mCAA2B,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":";;;AA0BA,8DAEC;AA5BD,2EAAiE;AAEjE;;;;;;;;;;;;;;GAcG;AACU,QAAA,2BAA2B,GAAoC,IAAI,GAAG,CAAC;IAChF,8CAAkB,CAAC,eAAe;IAClC,8CAAkB,CAAC,SAAS;IAC5B,8CAAkB,CAAC,UAAU;IAC7B,8CAAkB,CAAC,gBAAgB;IACnC,8CAAkB,CAAC,UAAU;IAC7B,8CAAkB,CAAC,cAAc;CACpC,CAAC,CAAC;AAEH,SAAgB,yBAAyB,CAAC,IAAwB;IAC9D,OAAO,mCAA2B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC"}

package/build/v1/message/schemas/rate-message.schema.d.ts

@@ -1,11 +1,19 @@
 import { z } from 'zod';
 import { UserRating } from './user-rating.enum';
+/**
+ * Rate Message Request Schema
+ * Error messages: RateMessageRequest.{field}.{rule}
+ */
 export declare const RateMessageRequestSchema: z.ZodObject<{
     rating: z.ZodEnum<typeof UserRating>;
 }, z.core.$strip>;
 export declare const RateMessageResponseSchema: z.ZodObject<{
     id: z.ZodString;
 }, z.core.$strip>;
+/**
+ * Rate Message Params Schema
+ * Error messages: RateMessageParams.{field}.{rule}
+ */
 export declare const RateMessageParamsSchema: z.ZodObject<{
     chatId: z.ZodString;
     messageId: z.ZodString;

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

@@ -3,6 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RateMessageParamsSchema = exports.RateMessageResponseSchema = exports.RateMessageRequestSchema = void 0;
 const zod_1 = require("zod");
 const user_rating_enum_1 = require("./user-rating.enum");
+/**
+ * Rate Message Request Schema
+ * Error messages: RateMessageRequest.{field}.{rule}
+ */
 exports.RateMessageRequestSchema = zod_1.z.object({
     rating: zod_1.z.enum(user_rating_enum_1.UserRating, {
         error: 'RateMessageRequest.rating.invalid',
@@ -11,6 +15,10 @@ exports.RateMessageRequestSchema = zod_1.z.object({
 exports.RateMessageResponseSchema = zod_1.z.object({
     id: zod_1.z.string().uuid(),
 });
+/**
+ * Rate Message Params Schema
+ * Error messages: RateMessageParams.{field}.{rule}
+ */
 exports.RateMessageParamsSchema = zod_1.z.object({
     chatId: zod_1.z
         .string({ error: 'RateMessageParams.chatId.required' })

package/build/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,6BAAwB;AACxB,yDAAgD;AAMnC,QAAA,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,6BAAU,EAAE;QACvB,KAAK,EAAE,mCAAmC;KAC7C,CAAC;CACL,CAAC,CAAC;AAEU,QAAA,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9C,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;CACxB,CAAC,CAAC;AAMU,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,OAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;SACtD,IAAI,CAAC,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;IAC1D,SAAS,EAAE,OAAC;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,6BAAwB;AACxB,yDAAgD;AAEhD;;;GAGG;AACU,QAAA,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,6BAAU,EAAE;QACvB,KAAK,EAAE,mCAAmC;KAC7C,CAAC;CACL,CAAC,CAAC;AAEU,QAAA,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9C,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;CACxB,CAAC,CAAC;AAEH;;;GAGG;AACU,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,OAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;SACtD,IAAI,CAAC,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;IAC1D,SAAS,EAAE,OAAC;SACP,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;SACzD,IAAI,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;CAChE,CAAC,CAAC"}

package/build/v1/message/schemas/step-card.enums.d.ts

@@ -1,9 +1,40 @@
+/**
+ * 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 declare enum CardCta {
+    /** Unregistered users — promote a free signup with starter tokens. */
     REGISTER = "REGISTER",
+    /** Registered users — promote a balance top-up. */
     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.
+     */
     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.
+     */
     ENABLE = "ENABLE"
 }
+/**
+ * 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 declare enum CardMessageKey {
     DISCOUNT_APPLIED_REGISTER = "BUDGET_PROMO.DISCOUNT_APPLIED.REGISTER",
     DISCOUNT_APPLIED_TOPUP = "BUDGET_PROMO.DISCOUNT_APPLIED.TOPUP",
@@ -13,6 +44,14 @@ export declare enum CardMessageKey {
     CAPABILITY_LOCKED_UPGRADE = "CAPABILITY_LOCKED.UPGRADE",
     CAPABILITY_LOCKED_ENABLE = "CAPABILITY_LOCKED.ENABLE",
     FILE_TRUNCATED = "FILE_TRUNCATED",
+    /** Guest CTA: «Продолжить разбор», without promising a complete read. */
     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.
+     */
     FILE_TRUNCATED_UNREADABLE = "FILE_TRUNCATED.UNREADABLE"
 }