@veruna/api-contracts 20.0.0 → 20.1.0

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

@@ -1,3 +1,6 @@
+/**
+ * Citation status for database records
+ */
 export var CitationStatus;
 (function (CitationStatus) {
     CitationStatus["ACTIVE"] = "ACTIVE";

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

@@ -1 +1 @@
-{"version":3,"file":"citation-status.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/citation-status.enum.ts"],"names":[],"mappings":"AAGA,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACtB,mCAAiB,CAAA;IACjB,qCAAmB,CAAA;AACvB,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB"}
+{"version":3,"file":"citation-status.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/citation-status.enum.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACtB,mCAAiB,CAAA;IACjB,qCAAmB,CAAA;AACvB,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB"}

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

@@ -1,9 +1,17 @@
 import { z } from 'zod';
+/**
+ * Citation from web search
+ */
 export const CitationSchema = z.object({
+    /** Source URL */
     url: z.string().url(),
+    /** Page title */
     title: z.string(),
+    /** Content snippet */
     content: z.string().optional(),
+    /** Start index in message content */
     startIndex: z.number().int().nonnegative(),
+    /** End index in message content */
     endIndex: z.number().int().nonnegative(),
 });
 //# sourceMappingURL=citation.schema.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"citation.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/citation.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAEnC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAErB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IAEjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE9B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAE1C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CAC3C,CAAC,CAAC"}
+{"version":3,"file":"citation.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/citation.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,iBAAiB;IACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,iBAAiB;IACjB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,sBAAsB;IACtB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,qCAAqC;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,mCAAmC;IACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CAC3C,CAAC,CAAC"}

package/build-esm/v1/message/schemas/create-message-request.schema.js

@@ -3,6 +3,10 @@ import { MESSAGE_TEXT_MAX_LENGTH } from '../../../shared';
 import { PluginRequestArraySchema } from '../../ai/plugins.types';
 import { ToolSelectionArraySchema } from '../../ai/tool.types';
 import { ConnectorSelectionArraySchema } from '../../connector/schemas/connector-selection.schema';
+/**
+ * Create Message Request Schema
+ * Error messages: CreateMessageRequest.{field}.{rule}
+ */
 export const CreateMessageRequestSchema = z.object({
     aiModelId: z
         .string({ error: 'CreateMessageRequest.aiModelId.required' })
@@ -24,9 +28,23 @@ export const CreateMessageRequestSchema = z.object({
         .string()
         .uuid({ message: 'CreateMessageRequest.assistantId.invalid' })
         .optional(),
+    /**
+     * Set by the client when this message was sent by tapping a follow-up
+     * suggestion chip rather than typed by hand. Changes nothing in how the
+     * message is processed — it exists so the effect of suggestions on
+     * conversation continuation can actually be measured. Absent means
+     * "typed by hand"; clients that do not send it simply never attribute.
+     */
     fromSuggestion: z
         .boolean({ error: 'CreateMessageRequest.fromSuggestion.invalid' })
         .optional(),
+    /**
+     * Статья блога, из которой пришёл вопрос (кнопка «пересказать пост»).
+     * Текст статьи с клиента НЕ передаётся: бэкенд сам достаёт опубликованный
+     * пост и подмешивает его в контекст как недоверенные данные. Привязка
+     * сохраняется у сообщения, поэтому уточняющие вопросы в том же чате
+     * продолжают видеть статью — до тех пор, пока не пришлют другую.
+     */
     sourcePostId: z
         .string()
         .uuid({ message: 'CreateMessageRequest.sourcePostId.invalid' })

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

@@ -1 +1 @@
-{"version":3,"file":"create-message-request.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/create-message-request.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAMnG,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,SAAS,EAAE,CAAC;SACP,MAAM,CAAC,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC;SAC5D,IAAI,CAAC,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC;IAChE,IAAI,EAAE,CAAC;SACF,MAAM,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;SACvD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;SACpD,GAAG,CAAC,uBAAuB,EAAE,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;IAC/E,OAAO,EAAE,wBAAwB,CAAC,QAAQ,EAAE;IAC5C,KAAK,EAAE,wBAAwB,CAAC,QAAQ,EAAE;IAC1C,UAAU,EAAE,6BAA6B,CAAC,QAAQ,EAAE;IACpD,iBAAiB,EAAE,CAAC;SACf,OAAO,CAAC,EAAE,KAAK,EAAE,gDAAgD,EAAE,CAAC;SACpE,QAAQ,EAAE;IACf,kBAAkB,EAAE,CAAC;SAChB,OAAO,CAAC,EAAE,KAAK,EAAE,iDAAiD,EAAE,CAAC;SACrE,QAAQ,EAAE;IACf,WAAW,EAAE,CAAC;SACT,MAAM,EAAE;SACR,IAAI,CAAC,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;SAC7D,QAAQ,EAAE;IAQf,cAAc,EAAE,CAAC;SACZ,OAAO,CAAC,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;SACjE,QAAQ,EAAE;IAQf,YAAY,EAAE,CAAC;SACV,MAAM,EAAE;SACR,IAAI,CAAC,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;SAC9D,QAAQ,EAAE;CAClB,CAAC,CAAC"}
+{"version":3,"file":"create-message-request.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/create-message-request.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAEnG;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,SAAS,EAAE,CAAC;SACP,MAAM,CAAC,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC;SAC5D,IAAI,CAAC,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC;IAChE,IAAI,EAAE,CAAC;SACF,MAAM,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;SACvD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;SACpD,GAAG,CAAC,uBAAuB,EAAE,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;IAC/E,OAAO,EAAE,wBAAwB,CAAC,QAAQ,EAAE;IAC5C,KAAK,EAAE,wBAAwB,CAAC,QAAQ,EAAE;IAC1C,UAAU,EAAE,6BAA6B,CAAC,QAAQ,EAAE;IACpD,iBAAiB,EAAE,CAAC;SACf,OAAO,CAAC,EAAE,KAAK,EAAE,gDAAgD,EAAE,CAAC;SACpE,QAAQ,EAAE;IACf,kBAAkB,EAAE,CAAC;SAChB,OAAO,CAAC,EAAE,KAAK,EAAE,iDAAiD,EAAE,CAAC;SACrE,QAAQ,EAAE;IACf,WAAW,EAAE,CAAC;SACT,MAAM,EAAE;SACR,IAAI,CAAC,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;SAC7D,QAAQ,EAAE;IACf;;;;;;OAMG;IACH,cAAc,EAAE,CAAC;SACZ,OAAO,CAAC,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;SACjE,QAAQ,EAAE;IACf;;;;;;OAMG;IACH,YAAY,EAAE,CAAC;SACV,MAAM,EAAE;SACR,IAAI,CAAC,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;SAC9D,QAAQ,EAAE;CAClB,CAAC,CAAC"}

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

@@ -1,4 +1,8 @@
 import { z } from 'zod';
+/**
+ * Delete Message Params Schema
+ * Error messages: DeleteMessageParams.{field}.{rule}
+ */
 export const DeleteMessageParamsSchema = z.object({
     chatId: z
         .string({ error: 'DeleteMessageParams.chatId.required' })

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

@@ -1 +1 @@
-{"version":3,"file":"delete-message.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/delete-message.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,CAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;SACxD,IAAI,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;IAC5D,SAAS,EAAE,CAAC;SACP,MAAM,CAAC,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC;SAC3D,IAAI,CAAC,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;CAClE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;CAC1B,CAAC,CAAC"}
+{"version":3,"file":"delete-message.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/delete-message.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,CAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;SACxD,IAAI,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;IAC5D,SAAS,EAAE,CAAC;SACP,MAAM,CAAC,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC;SAC3D,IAAI,CAAC,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;CAClE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;CAC1B,CAAC,CAAC"}

package/build-esm/v1/message/schemas/error-meta.schema.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import { MessageErrorCategory } from './message-error-category.enum';
+import { MessageErrorAction } from './message-error-action.enum';
+/** Public terminal details, shared by live events and message history. */
+export const ErrorMetaSchema = z.object({
+    /** Null for success/user Stop; absent on older responses. */
+    errorCategory: z.enum(MessageErrorCategory).nullable().optional(),
+    /** Empty for success/user Stop; absent on older responses. */
+    errorActions: z.array(z.enum(MessageErrorAction)).optional(),
+});
+//# sourceMappingURL=error-meta.schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-meta.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/error-meta.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,6DAA6D;IAC7D,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACjE,8DAA8D;IAC9D,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC/D,CAAC,CAAC"}

package/build-esm/v1/message/schemas/file-truncated-step-content.schema.js

@@ -1,15 +1,56 @@
 import { z } from 'zod';
 import { CardCta, CardMessageKey } from './step-card.enums';
+/** What `pagesRead` / `pagesTotal` are counted in. */
 export var TruncationUnit;
 (function (TruncationUnit) {
     TruncationUnit["PAGES"] = "PAGES";
+    /** Text files have no pages. Their budget — and their truncation — is tokens. */
     TruncationUnit["TOKENS"] = "TOKENS";
 })(TruncationUnit || (TruncationUnit = {}));
+/**
+ * Content of the `FILE_TRUNCATED` step: a document was read only in part.
+ *
+ * Not about money and not about access — the capability worked, the answer is
+ * real, it just did not cover the whole file. Says how much actually reached
+ * the model so the reader can judge the answer instead of assuming it saw
+ * everything.
+ *
+ * Its own step type for the same reason as the capability card: it has no token
+ * arithmetic to share with the budget cards, and calling it a "budget promo"
+ * would tell the reader the wrong thing about their own answer.
+ */
 export const FileTruncatedStepContentSchema = z.object({
+    /** Original filename, so a turn with several files names the right one. */
     filename: z.string(),
+    /**
+     * Optional for backward compatibility: rows written before text files were
+     * covered are all page-based, so an absent value means PAGES.
+     */
     unit: z.enum(TruncationUnit).optional(),
+    /**
+     * Units that actually reached the model.
+     *
+     * Zero is meaningful and must stay valid: the document failed to convert at
+     * upload, so nothing at all reached the model. That is the truncation worth
+     * warning about most, and rejecting it here would drop the only signal the
+     * reader gets.
+     */
     pagesRead: z.number().int().nonnegative(),
+    /**
+     * Total the document has. **Optional**, because the count can be missing —
+     * a PDF without usable metadata, or a failure while reading it. Truncation
+     * still happened and still has to be admitted; suppressing the card
+     * whenever the total is unknown would hide it in exactly the cases where
+     * the file was most likely enormous.
+     *
+     * Absent → say "read the first N pages" and leave the total out.
+     */
     pagesTotal: z.number().int().positive().optional(),
+    /**
+     * REGISTER for guests: offer to continue working with the document
+     * («Продолжить разбор»), never promise an unlimited/full read.
+     * Omitted for registered users; registration cannot raise their limits.
+     */
     cta: z.enum(CardCta).optional(),
     messageKey: z.enum(CardMessageKey).optional(),
 });

package/build-esm/v1/message/schemas/file-truncated-step-content.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-truncated-step-content.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/file-truncated-step-content.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAG5D,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACtB,iCAAe,CAAA;IAEf,mCAAiB,CAAA;AACrB,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB;AAcD,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IAEnD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IAKpB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;IASvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAUzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAMlD,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE;IAC/B,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC"}
+{"version":3,"file":"file-truncated-step-content.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/file-truncated-step-content.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE5D,sDAAsD;AACtD,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACtB,iCAAe,CAAA;IACf,iFAAiF;IACjF,mCAAiB,CAAA;AACrB,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,2EAA2E;IAC3E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB;;;OAGG;IACH,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;IACvC;;;;;;;OAOG;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACzC;;;;;;;;OAQG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAClD;;;;OAIG;IACH,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE;IAC/B,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC"}

package/build-esm/v1/message/schemas/followup-suggestions-step-content.schema.js

@@ -1,6 +1,33 @@
 import { z } from 'zod';
+/**
+ * How many suggestions the server emits at most. The utility model is asked
+ * for exactly this many; anything above is dropped server-side before the
+ * step is persisted, so clients can render the array as-is.
+ */
 export const FOLLOWUP_SUGGESTIONS_MAX_COUNT = 5;
+/**
+ * Per-suggestion character cap. A suggestion is sent verbatim as the next
+ * user message when picked, so it must stay a single short line — longer
+ * candidates are truncated server-side, never rejected.
+ */
 export const FOLLOWUP_SUGGESTION_MAX_CHARS = 120;
+/**
+ * FOLLOWUP_SUGGESTIONS step content — ready-to-send prompts the user can pick
+ * to continue the conversation, in the language of the conversation.
+ *
+ * Each entry is a complete, self-contained user message: clicking one sends
+ * that exact string as the next user turn, so the client must not decorate or
+ * re-word it.
+ *
+ * `suggestions` MAY be empty: the model returns nothing when a follow-up makes
+ * no sense (greeting, refusal, pure small talk) and the server also persists an
+ * empty array when generation failed. An empty array means "render nothing" —
+ * it is never an error state.
+ *
+ * Caps are enforced server-side (`FOLLOWUP_SUGGESTIONS_MAX_COUNT` /
+ * `FOLLOWUP_SUGGESTION_MAX_CHARS`); the schema itself stays permissive so a
+ * legacy row can never fail a whole history load.
+ */
 export const FollowupSuggestionsStepContentSchema = z.object({
     suggestions: z.array(z.string()),
 });

package/build-esm/v1/message/schemas/followup-suggestions-step-content.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"followup-suggestions-step-content.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/followup-suggestions-step-content.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC;AAOhD,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAmBjD,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACnC,CAAC,CAAC"}
+{"version":3,"file":"followup-suggestions-step-content.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/followup-suggestions-step-content.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAEjD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACnC,CAAC,CAAC"}

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

@@ -0,0 +1,7 @@
+export var GenerationStatus;
+(function (GenerationStatus) {
+    GenerationStatus["RETRYING"] = "RETRYING";
+    GenerationStatus["SWITCHING_ROUTE"] = "SWITCHING_ROUTE";
+    GenerationStatus["SWITCHING_MODEL"] = "SWITCHING_MODEL";
+})(GenerationStatus || (GenerationStatus = {}));
+//# sourceMappingURL=generation-status.enum.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generation-status.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/generation-status.enum.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IACxB,yCAAqB,CAAA;IACrB,uDAAmC,CAAA;IACnC,uDAAmC,CAAA;AACvC,CAAC,EAJW,gBAAgB,KAAhB,gBAAgB,QAI3B"}

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

@@ -1,26 +1,94 @@
+/**
+ * Generation step types for multi-stage generation
+ */
 export var GenerationStepType;
 (function (GenerationStepType) {
+    /** Reasoning step (model thinking) */
     GenerationStepType["REASONING"] = "REASONING";
+    /** Prompt generation step (AI generates image prompt) */
     GenerationStepType["PROMPT_GENERATION"] = "PROMPT_GENERATION";
+    /** Image edit prompt generation step (AI prepares constrained edit prompt) */
     GenerationStepType["EDIT_PROMPT_GENERATION"] = "EDIT_PROMPT_GENERATION";
+    /** Text generation step */
     GenerationStepType["TEXT_GENERATION"] = "TEXT_GENERATION";
+    /** Image generation step */
     GenerationStepType["IMAGE_GENERATION"] = "IMAGE_GENERATION";
+    /** Image edit step */
     GenerationStepType["IMAGE_EDIT"] = "IMAGE_EDIT";
+    /** Upload step (S3 upload) */
     GenerationStepType["UPLOAD"] = "UPLOAD";
+    /** Web search step */
     GenerationStepType["WEB_SEARCH"] = "WEB_SEARCH";
+    /** YouTube video analysis step */
     GenerationStepType["VIDEO_ANALYSIS"] = "VIDEO_ANALYSIS";
+    /** HTML visualization step */
     GenerationStepType["HTML_VISUALIZATION"] = "HTML_VISUALIZATION";
+    /** Code execution step (sandboxed Python/bash via e2b) */
     GenerationStepType["CODE_EXECUTION"] = "CODE_EXECUTION";
+    /** view_file tool — model opens an attached file */
     GenerationStepType["VIEW_FILE"] = "VIEW_FILE";
+    /** find_in_chat tool — model searches the chat's file registry */
     GenerationStepType["FIND_IN_CHAT"] = "FIND_IN_CHAT";
+    /** send_file tool — model delivers a sandbox-rendered file to the user */
     GenerationStepType["SEND_FILE"] = "SEND_FILE";
+    /**
+     * Server-emitted, non-billable money card. Carries a structured payload
+     * (see {@link BudgetPromoStepContentSchema}) telling the UI to render a
+     * "we covered N tokens — register / top up" notice or a "couldn't fund
+     * step X — top up" cutoff.
+     *
+     * Money ONLY. The access card and the truncation card used to ride in this
+     * type and now have their own — see CAPABILITY_LOCKED and FILE_TRUNCATED.
+     *
+     * Has no input/output tokens, no internal price, no provider call.
+     * Persisted as the message's last step so reload renders the same
+     * banner from history without re-running the stream.
+     */
     GenerationStepType["BUDGET_PROMO"] = "BUDGET_PROMO";
+    /**
+     * The user asked for a capability that did not run: they are anonymous,
+     * their plan does not include it, or they switched it off. Payload in
+     * {@link CapabilityLockedStepContentSchema}; `cta` says which of the three,
+     * and none of them is a top-up.
+     *
+     * Its own type rather than a BUDGET_PROMO variant, because it shares nothing
+     * with one — no tokens, no shortfall, no money at all. The only thing they
+     * ever had in common was the slot they render in.
+     */
     GenerationStepType["CAPABILITY_LOCKED"] = "CAPABILITY_LOCKED";
+    /**
+     * A document reached the model only in part. Payload in
+     * {@link FileTruncatedStepContentSchema}.
+     *
+     * Neither money nor access: the capability worked and the answer is real,
+     * it just did not cover the whole file. Says how much actually got read so
+     * the reader can judge the answer instead of assuming it saw everything.
+     */
     GenerationStepType["FILE_TRUNCATED"] = "FILE_TRUNCATED";
+    /** Memory management step (model calls MANAGE_MEMORY tool) */
     GenerationStepType["MEMORY"] = "MEMORY";
+    /** Conversation search step (model searches past chats by topic) */
     GenerationStepType["CONVERSATION_SEARCH"] = "CONVERSATION_SEARCH";
+    /** Recent chats step (model retrieves user's most recent chats by time) */
     GenerationStepType["RECENT_CHATS"] = "RECENT_CHATS";
+    /**
+     * Connector (MCP gateway) tool step — the model invoked a tool exposed by a
+     * connected first-party provider or a custom MCP server. Rendered as a live
+     * tool card, persisted to history, and replayed as a native tool interaction
+     * on later turns (function name + args come from the toolReplay snapshot).
+     */
     GenerationStepType["CONNECTOR_TOOL"] = "CONNECTOR_TOOL";
+    /**
+     * Server-emitted, non-billable step carrying the "what to ask next"
+     * prompts rendered under a finished answer (see
+     * {@link FollowupSuggestionsStepContentSchema}). Produced by a utility-model
+     * JSON call after the agent loop's final turn and BEFORE the terminal
+     * event, so it both streams live and persists as the message's last step —
+     * a reload renders the same chips without re-running the stream.
+     *
+     * Never re-enters LLM context: picking a suggestion sends it back as an
+     * ordinary user message, which is the only thing the model should see.
+     */
     GenerationStepType["FOLLOWUP_SUGGESTIONS"] = "FOLLOWUP_SUGGESTIONS";
 })(GenerationStepType || (GenerationStepType = {}));
 //# sourceMappingURL=generation-step-type.enum.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"generation-step-type.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/generation-step-type.enum.ts"],"names":[],"mappings":"AAGA,MAAM,CAAN,IAAY,kBAwFX;AAxFD,WAAY,kBAAkB;IAE1B,6CAAuB,CAAA;IAEvB,6DAAuC,CAAA;IAEvC,uEAAiD,CAAA;IAEjD,yDAAmC,CAAA;IAEnC,2DAAqC,CAAA;IAErC,+CAAyB,CAAA;IAEzB,uCAAiB,CAAA;IAEjB,+CAAyB,CAAA;IAEzB,uDAAiC,CAAA;IAEjC,+DAAyC,CAAA;IAEzC,uDAAiC,CAAA;IAEjC,6CAAuB,CAAA;IAEvB,mDAA6B,CAAA;IAE7B,6CAAuB,CAAA;IAcvB,mDAA6B,CAAA;IAW7B,6DAAuC,CAAA;IASvC,uDAAiC,CAAA;IAEjC,uCAAiB,CAAA;IAEjB,iEAA2C,CAAA;IAE3C,mDAA6B,CAAA;IAO7B,uDAAiC,CAAA;IAYjC,mEAA6C,CAAA;AACjD,CAAC,EAxFW,kBAAkB,KAAlB,kBAAkB,QAwF7B"}
+{"version":3,"file":"generation-step-type.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/generation-step-type.enum.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,kBAwFX;AAxFD,WAAY,kBAAkB;IAC1B,sCAAsC;IACtC,6CAAuB,CAAA;IACvB,yDAAyD;IACzD,6DAAuC,CAAA;IACvC,8EAA8E;IAC9E,uEAAiD,CAAA;IACjD,2BAA2B;IAC3B,yDAAmC,CAAA;IACnC,4BAA4B;IAC5B,2DAAqC,CAAA;IACrC,sBAAsB;IACtB,+CAAyB,CAAA;IACzB,8BAA8B;IAC9B,uCAAiB,CAAA;IACjB,sBAAsB;IACtB,+CAAyB,CAAA;IACzB,kCAAkC;IAClC,uDAAiC,CAAA;IACjC,8BAA8B;IAC9B,+DAAyC,CAAA;IACzC,0DAA0D;IAC1D,uDAAiC,CAAA;IACjC,oDAAoD;IACpD,6CAAuB,CAAA;IACvB,kEAAkE;IAClE,mDAA6B,CAAA;IAC7B,0EAA0E;IAC1E,6CAAuB,CAAA;IACvB;;;;;;;;;;;;OAYG;IACH,mDAA6B,CAAA;IAC7B;;;;;;;;;OASG;IACH,6DAAuC,CAAA;IACvC;;;;;;;OAOG;IACH,uDAAiC,CAAA;IACjC,8DAA8D;IAC9D,uCAAiB,CAAA;IACjB,oEAAoE;IACpE,iEAA2C,CAAA;IAC3C,2EAA2E;IAC3E,mDAA6B,CAAA;IAC7B;;;;;OAKG;IACH,uDAAiC,CAAA;IACjC;;;;;;;;;;OAUG;IACH,mEAA6C,CAAA;AACjD,CAAC,EAxFW,kBAAkB,KAAlB,kBAAkB,QAwF7B"}

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

@@ -1,12 +1,22 @@
 import { z } from 'zod';
 import { GenerationStepType } from './generation-step-type.enum';
+/**
+ * Single generation step in multi-stage process
+ */
 export const GenerationStepSchema = z.object({
+    /** Step type identifier */
     type: z.enum(GenerationStepType),
+    /** Step content (e.g., generated prompt text) */
     content: z.string(),
+    /** Model UUID used for this step */
     modelId: z.string().uuid().optional(),
+    /** Model display name for UI */
     modelTitle: z.string().optional(),
+    /** Whether to include this step in context for future generations */
     includeInContext: z.boolean().default(false),
+    /** Timestamp when step started */
     startedAt: z.string().optional(),
+    /** Timestamp when step completed */
     completedAt: z.string().optional(),
 });
 //# sourceMappingURL=generation-step.schema.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"generation-step.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/generation-step.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAKjE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAEzC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC;IAEhC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IAEnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAErC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEjC,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAE5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEhC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC"}
+{"version":3,"file":"generation-step.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/generation-step.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,2BAA2B;IAC3B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC;IAChC,iDAAiD;IACjD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,oCAAoC;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACrC,gCAAgC;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,qEAAqE;IACrE,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC5C,kCAAkC;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,oCAAoC;IACpC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC"}

package/build-esm/v1/message/schemas/index.js

@@ -8,7 +8,7 @@ export { MessageStepResponseSchema, MessageStepsResponseSchema, StepContentRespo
 export { MessageAttachmentResponseSchema, MessageAttachmentsResponseSchema, AttachmentMetaResponseSchema, } from './message-attachment-response.schema';
 export { MessageCitationResponseSchema, MessageCitationsResponseSchema, } from './message-citation-response.schema';
 export { StreamEventType } from './stream-event-type.enum';
-export { StreamEventSchema, StreamStepStartEventSchema, StreamStepChunkEventSchema, StreamStepErrorEventSchema, StreamStepDoneEventSchema, StreamStepBilledEventSchema, StreamBillingEstimateEventSchema, StreamImageEventSchema, StreamImageGenerationErrorEventSchema, StreamCitationsEventSchema, StreamHeartbeatEventSchema, StreamDoneEventSchema, StreamCancelledEventSchema, StreamErrorEventSchema, StreamCancellationReason, } from './stream-events.schema';
+export { StreamEventSchema, StreamGenerationStatusEventSchema, StreamStepStartEventSchema, StreamStepChunkEventSchema, StreamStepErrorEventSchema, StreamStepDoneEventSchema, StreamStepBilledEventSchema, StreamBillingEstimateEventSchema, StreamImageEventSchema, StreamImageGenerationErrorEventSchema, StreamCitationsEventSchema, StreamHeartbeatEventSchema, StreamDoneEventSchema, StreamCancelledEventSchema, StreamErrorEventSchema, StreamCancellationReason, } from './stream-events.schema';
 export { CitationStatus } from './citation-status.enum';
 export { CitationSchema } from './citation.schema';
 export { StepStartMetadataSchema, StepDoneMetadataSchema, WebSearchStepStartMetadataSchema, ConversationSearchStepStartMetadataSchema, ImageEditStepStartMetadataSchema, VideoAnalysisStepStartMetadataSchema, CodeExecutionStepStartMetadataSchema, ConnectorToolStepStartMetadataSchema, UploadStepDoneMetadataSchema, StepStartMetadataByType, StepDoneMetadataByType, } from './step-metadata.schema';
@@ -18,7 +18,7 @@ export { STEP_CHUNK_LINE_MAX_LENGTH, STEP_CHUNK_LINES_MAX_ITEMS, StepChunkMetada
 export { AttachmentSource } from './attachment-source.enum';
 export { AttachmentType } from './attachment-type.enum';
 export { AttachmentStatus } from './attachment-status.enum';
-export { AttachmentSchema, AttachmentsSchema, } from './message-attachment.schema';
+export { AttachmentSchema, AttachmentsSchema } from './message-attachment.schema';
 export { GenerationStepType } from './generation-step-type.enum';
 export { MODEL_ATTRIBUTED_STEP_TYPES, isModelAttributedStepType, } from './model-attributed-step-types.const';
 export { MessageStepStatus } from './message-step-status.enum';
@@ -31,4 +31,8 @@ export { GenerationStepSchema } from './generation-step.schema';
 export { RateMessageRequestSchema, RateMessageResponseSchema, RateMessageParamsSchema, } from './rate-message.schema';
 export { DeleteMessageParamsSchema, DeleteMessageResponseSchema } from './delete-message.schema';
 export { CancelStreamResponseSchema } from './cancel-stream-response.schema';
+export { MessageErrorCategory } from './message-error-category.enum';
+export { MessageErrorAction } from './message-error-action.enum';
+export { GenerationStatus } from './generation-status.enum';
+export { ErrorMetaSchema } from './error-meta.schema';
 //# sourceMappingURL=index.js.map

package/build-esm/v1/message/schemas/index.js.map

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

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

@@ -2,20 +2,39 @@ import { z } from 'zod';
 import { AttachmentSource } from './attachment-source.enum';
 import { AttachmentType } from './attachment-type.enum';
 import { ClientFileMark } from '../../client-file/schemas/client-file-mark.enum';
+/**
+ * Attachment metadata (dimensions for images)
+ */
 export const AttachmentMetaResponseSchema = z.object({
     width: z.number().int().positive().optional(),
     height: z.number().int().positive().optional(),
 });
+/**
+ * Message attachment response schema for frontend
+ * Returns URL instead of S3 key
+ */
 export const MessageAttachmentResponseSchema = z.object({
+    /** Attachment UUID */
     uuid: z.string().uuid(),
+    /** Who created the attachment */
     source: z.enum(AttachmentSource),
+    /** Attachment type */
     type: z.enum(AttachmentType),
+    /** Public URL to access the file */
     url: z.string().url(),
+    /** MIME type */
     mimeType: z.string().nullable(),
+    /** Original filename */
     filename: z.string().nullable(),
+    /** File size in bytes */
     size: z.number().int().positive().nullable(),
+    /** Metadata (dimensions for images) */
     meta: AttachmentMetaResponseSchema.nullable(),
+    /** Frontend-facing flags propagated from the source client-file row. */
     marks: z.array(z.enum(ClientFileMark)),
 });
+/**
+ * Array of attachment responses
+ */
 export const MessageAttachmentsResponseSchema = z.array(MessageAttachmentResponseSchema);
 //# sourceMappingURL=message-attachment-response.schema.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"message-attachment-response.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/message-attachment-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AAKjF,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC;AAQH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IAEpD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAEvB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;IAEhC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IAE5B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAErB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAE5C,IAAI,EAAE,4BAA4B,CAAC,QAAQ,EAAE;IAE7C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;CACzC,CAAC,CAAC;AAOH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC"}
+{"version":3,"file":"message-attachment-response.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/message-attachment-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AAEjF;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,sBAAsB;IACtB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACvB,iCAAiC;IACjC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;IAChC,sBAAsB;IACtB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IAC5B,oCAAoC;IACpC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,gBAAgB;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,wBAAwB;IACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,yBAAyB;IACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,uCAAuC;IACvC,IAAI,EAAE,4BAA4B,CAAC,QAAQ,EAAE;IAC7C,wEAAwE;IACxE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;CACzC,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC"}

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

@@ -1,8 +1,18 @@
 import { z } from 'zod';
 import { AttachmentType } from './attachment-type.enum';
+/**
+ * Attachment schema - stores S3 reference for generated assets
+ * Used internally for file management (deletion, tracking)
+ * NOT sent to frontend - frontend gets images via markdown in content
+ */
 export const AttachmentSchema = z.object({
+    /** Asset type */
     type: z.enum(AttachmentType),
+    /** S3 object key */
     key: z.string().min(1),
 });
+/**
+ * Array of attachments for message
+ */
 export const AttachmentsSchema = z.array(AttachmentSchema);
 //# sourceMappingURL=message-attachment.schema.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"message-attachment.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/message-attachment.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAOxD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAErC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IAE5B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACzB,CAAC,CAAC;AAOH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"message-attachment.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/message-attachment.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,iBAAiB;IACjB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IAC5B,oBAAoB;IACpB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACzB,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC"}

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

@@ -1,11 +1,24 @@
 import { z } from 'zod';
+/**
+ * Message citation response schema for frontend
+ * Web search results with text highlighting indices
+ */
 export const MessageCitationResponseSchema = z.object({
+    /** Citation UUID */
     uuid: z.string().uuid(),
+    /** Source URL */
     url: z.string().url(),
+    /** Page title */
     title: z.string().nullable(),
+    /** Content snippet */
     content: z.string().nullable(),
+    /** Start index in message content for highlighting */
     startIndex: z.number().int().nonnegative().nullable(),
+    /** End index in message content for highlighting */
     endIndex: z.number().int().nonnegative().nullable(),
 });
+/**
+ * Array of citation responses
+ */
 export const MessageCitationsResponseSchema = z.array(MessageCitationResponseSchema);
 //# sourceMappingURL=message-citation-response.schema.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"message-citation-response.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/message-citation-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAElD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAEvB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAErB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE5B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE9B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAErD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAOH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC"}
+{"version":3,"file":"message-citation-response.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/message-citation-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,oBAAoB;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACvB,iBAAiB;IACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,iBAAiB;IACjB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,sBAAsB;IACtB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,sDAAsD;IACtD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACrD,oDAAoD;IACpD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC"}

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

@@ -0,0 +1,20 @@
+/** Suggested client actions for a terminal message error. */
+export var MessageErrorAction;
+(function (MessageErrorAction) {
+    /** Resend using the message's aiModelId, the model originally selected by the user. */
+    MessageErrorAction["RETRY"] = "RETRY";
+    /** Let the user select another model in this chat, then resend the request. */
+    MessageErrorAction["SWITCH_MODEL"] = "SWITCH_MODEL";
+    /** Start a new chat and send the request there, without the overlong history. */
+    MessageErrorAction["NEW_CHAT"] = "NEW_CHAT";
+    /** Send a normal new message in the same chat with localized text «Продолжи».
+     * No special endpoint. The long-document agent resumes from questions.md/answers.md. */
+    MessageErrorAction["CONTINUE"] = "CONTINUE";
+    /** Open the balance top-up flow; after funding, the user can retry. */
+    MessageErrorAction["TOP_UP"] = "TOP_UP";
+    /** Let the user edit or shorten the request, then send the revised text. */
+    MessageErrorAction["REPHRASE"] = "REPHRASE";
+    /** Ask the user to upload a readable supported file and resend the request. */
+    MessageErrorAction["REUPLOAD"] = "REUPLOAD";
+})(MessageErrorAction || (MessageErrorAction = {}));
+//# sourceMappingURL=message-error-action.enum.js.map

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(),