@veruna/api-contracts 19.1.0 → 20.1.0

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

@@ -3,16 +3,57 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileTruncatedStepContentSchema = exports.TruncationUnit = void 0;
 const zod_1 = require("zod");
 const step_card_enums_1 = require("./step-card.enums");
+/** What `pagesRead` / `pagesTotal` are counted in. */
 var TruncationUnit;
 (function (TruncationUnit) {
     TruncationUnit["PAGES"] = "PAGES";
+    /** Text files have no pages. Their budget — and their truncation — is tokens. */
     TruncationUnit["TOKENS"] = "TOKENS";
 })(TruncationUnit || (exports.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.
+ */
 exports.FileTruncatedStepContentSchema = zod_1.z.object({
+    /** Original filename, so a turn with several files names the right one. */
     filename: zod_1.z.string(),
+    /**
+     * Optional for backward compatibility: rows written before text files were
+     * covered are all page-based, so an absent value means PAGES.
+     */
     unit: zod_1.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: zod_1.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: zod_1.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: zod_1.z.enum(step_card_enums_1.CardCta).optional(),
     messageKey: zod_1.z.enum(step_card_enums_1.CardMessageKey).optional(),
 });

package/build/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,6BAAwB;AACxB,uDAA4D;AAG5D,IAAY,cAIX;AAJD,WAAY,cAAc;IACtB,iCAAe,CAAA;IAEf,mCAAiB,CAAA;AACrB,CAAC,EAJW,cAAc,8BAAd,cAAc,QAIzB;AAcY,QAAA,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IAEnD,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IAKpB,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;IASvC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAUzC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAMlD,GAAG,EAAE,OAAC,CAAC,IAAI,CAAC,yBAAO,CAAC,CAAC,QAAQ,EAAE;IAC/B,UAAU,EAAE,OAAC,CAAC,IAAI,CAAC,gCAAc,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,6BAAwB;AACxB,uDAA4D;AAE5D,sDAAsD;AACtD,IAAY,cAIX;AAJD,WAAY,cAAc;IACtB,iCAAe,CAAA;IACf,iFAAiF;IACjF,mCAAiB,CAAA;AACrB,CAAC,EAJW,cAAc,8BAAd,cAAc,QAIzB;AAED;;;;;;;;;;;GAWG;AACU,QAAA,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,2EAA2E;IAC3E,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB;;;OAGG;IACH,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;IACvC;;;;;;;OAOG;IACH,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACzC;;;;;;;;OAQG;IACH,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAClD;;;;OAIG;IACH,GAAG,EAAE,OAAC,CAAC,IAAI,CAAC,yBAAO,CAAC,CAAC,QAAQ,EAAE;IAC/B,UAAU,EAAE,OAAC,CAAC,IAAI,CAAC,gCAAc,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC"}

package/build/v1/message/schemas/followup-suggestions-step-content.schema.d.ts

@@ -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 declare 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 declare 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 declare const FollowupSuggestionsStepContentSchema: z.ZodObject<{
     suggestions: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;

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

@@ -2,8 +2,35 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FollowupSuggestionsStepContentSchema = exports.FOLLOWUP_SUGGESTION_MAX_CHARS = exports.FOLLOWUP_SUGGESTIONS_MAX_COUNT = void 0;
 const zod_1 = require("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.
+ */
 exports.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.
+ */
 exports.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.
+ */
 exports.FollowupSuggestionsStepContentSchema = zod_1.z.object({
     suggestions: zod_1.z.array(zod_1.z.string()),
 });

package/build/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,6BAAwB;AAOX,QAAA,8BAA8B,GAAG,CAAC,CAAC;AAOnC,QAAA,6BAA6B,GAAG,GAAG,CAAC;AAmBpC,QAAA,oCAAoC,GAAG,OAAC,CAAC,MAAM,CAAC;IACzD,WAAW,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,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,6BAAwB;AAExB;;;;GAIG;AACU,QAAA,8BAA8B,GAAG,CAAC,CAAC;AAEhD;;;;GAIG;AACU,QAAA,6BAA6B,GAAG,GAAG,CAAC;AAEjD;;;;;;;;;;;;;;;;GAgBG;AACU,QAAA,oCAAoC,GAAG,OAAC,CAAC,MAAM,CAAC;IACzD,WAAW,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;CACnC,CAAC,CAAC"}

package/build/v1/message/schemas/generation-status.enum.d.ts

@@ -0,0 +1,5 @@
+export declare enum GenerationStatus {
+    RETRYING = "RETRYING",
+    SWITCHING_ROUTE = "SWITCHING_ROUTE",
+    SWITCHING_MODEL = "SWITCHING_MODEL"
+}

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenerationStatus = void 0;
+var GenerationStatus;
+(function (GenerationStatus) {
+    GenerationStatus["RETRYING"] = "RETRYING";
+    GenerationStatus["SWITCHING_ROUTE"] = "SWITCHING_ROUTE";
+    GenerationStatus["SWITCHING_MODEL"] = "SWITCHING_MODEL";
+})(GenerationStatus || (exports.GenerationStatus = GenerationStatus = {}));
+//# sourceMappingURL=generation-status.enum.js.map

package/build/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,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IACxB,yCAAqB,CAAA;IACrB,uDAAmC,CAAA;IACnC,uDAAmC,CAAA;AACvC,CAAC,EAJW,gBAAgB,gCAAhB,gBAAgB,QAI3B"}

package/build/v1/message/schemas/generation-step-type.enum.d.ts

@@ -1,24 +1,92 @@
+/**
+ * Generation step types for multi-stage generation
+ */
 export declare enum GenerationStepType {
+    /** Reasoning step (model thinking) */
     REASONING = "REASONING",
+    /** Prompt generation step (AI generates image prompt) */
     PROMPT_GENERATION = "PROMPT_GENERATION",
+    /** Image edit prompt generation step (AI prepares constrained edit prompt) */
     EDIT_PROMPT_GENERATION = "EDIT_PROMPT_GENERATION",
+    /** Text generation step */
     TEXT_GENERATION = "TEXT_GENERATION",
+    /** Image generation step */
     IMAGE_GENERATION = "IMAGE_GENERATION",
+    /** Image edit step */
     IMAGE_EDIT = "IMAGE_EDIT",
+    /** Upload step (S3 upload) */
     UPLOAD = "UPLOAD",
+    /** Web search step */
     WEB_SEARCH = "WEB_SEARCH",
+    /** YouTube video analysis step */
     VIDEO_ANALYSIS = "VIDEO_ANALYSIS",
+    /** HTML visualization step */
     HTML_VISUALIZATION = "HTML_VISUALIZATION",
+    /** Code execution step (sandboxed Python/bash via e2b) */
     CODE_EXECUTION = "CODE_EXECUTION",
+    /** view_file tool — model opens an attached file */
     VIEW_FILE = "VIEW_FILE",
+    /** find_in_chat tool — model searches the chat's file registry */
     FIND_IN_CHAT = "FIND_IN_CHAT",
+    /** send_file tool — model delivers a sandbox-rendered file to the user */
     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.
+     */
     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.
+     */
     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.
+     */
     FILE_TRUNCATED = "FILE_TRUNCATED",
+    /** Memory management step (model calls MANAGE_MEMORY tool) */
     MEMORY = "MEMORY",
+    /** Conversation search step (model searches past chats by topic) */
     CONVERSATION_SEARCH = "CONVERSATION_SEARCH",
+    /** Recent chats step (model retrieves user's most recent chats by time) */
     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).
+     */
     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.
+     */
     FOLLOWUP_SUGGESTIONS = "FOLLOWUP_SUGGESTIONS"
 }

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

@@ -1,29 +1,97 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GenerationStepType = void 0;
+/**
+ * Generation step types for multi-stage generation
+ */
 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 || (exports.GenerationStepType = GenerationStepType = {}));
 //# sourceMappingURL=generation-step-type.enum.js.map

package/build/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,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,kCAAlB,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,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,kCAAlB,kBAAkB,QAwF7B"}

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

@@ -1,5 +1,8 @@
 import { z } from 'zod';
 import { GenerationStepType } from './generation-step-type.enum';
+/**
+ * Single generation step in multi-stage process
+ */
 export declare const GenerationStepSchema: z.ZodObject<{
     type: z.ZodEnum<typeof GenerationStepType>;
     content: z.ZodString;

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

@@ -3,13 +3,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GenerationStepSchema = void 0;
 const zod_1 = require("zod");
 const generation_step_type_enum_1 = require("./generation-step-type.enum");
+/**
+ * Single generation step in multi-stage process
+ */
 exports.GenerationStepSchema = zod_1.z.object({
+    /** Step type identifier */
     type: zod_1.z.enum(generation_step_type_enum_1.GenerationStepType),
+    /** Step content (e.g., generated prompt text) */
     content: zod_1.z.string(),
+    /** Model UUID used for this step */
     modelId: zod_1.z.string().uuid().optional(),
+    /** Model display name for UI */
     modelTitle: zod_1.z.string().optional(),
+    /** Whether to include this step in context for future generations */
     includeInContext: zod_1.z.boolean().default(false),
+    /** Timestamp when step started */
     startedAt: zod_1.z.string().optional(),
+    /** Timestamp when step completed */
     completedAt: zod_1.z.string().optional(),
 });
 //# sourceMappingURL=generation-step.schema.js.map

package/build/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,6BAAwB;AACxB,2EAAiE;AAKpD,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAEzC,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,8CAAkB,CAAC;IAEhC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IAEnB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAErC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEjC,gBAAgB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAE5C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEhC,WAAW,EAAE,OAAC,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,6BAAwB;AACxB,2EAAiE;AAEjE;;GAEG;AACU,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,2BAA2B;IAC3B,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,8CAAkB,CAAC;IAChC,iDAAiD;IACjD,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,oCAAoC;IACpC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACrC,gCAAgC;IAChC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,qEAAqE;IACrE,gBAAgB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC5C,kCAAkC;IAClC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,oCAAoC;IACpC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC"}

package/build/v1/message/schemas/index.d.ts

@@ -11,7 +11,7 @@ export type { MessageAttachmentResponse, MessageAttachmentsResponse, AttachmentM
 export { MessageCitationResponseSchema, MessageCitationsResponseSchema, } from './message-citation-response.schema';
 export type { MessageCitationResponse, MessageCitationsResponse, } 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, type Citation } from './citation.schema';
 export { StepStartMetadataSchema, StepDoneMetadataSchema, WebSearchStepStartMetadataSchema, ConversationSearchStepStartMetadataSchema, ImageEditStepStartMetadataSchema, VideoAnalysisStepStartMetadataSchema, CodeExecutionStepStartMetadataSchema, ConnectorToolStepStartMetadataSchema, UploadStepDoneMetadataSchema, StepStartMetadataByType, StepDoneMetadataByType, } from './step-metadata.schema';
@@ -23,7 +23,7 @@ export type { ArgsChunkMetadata, DescribeChunkMetadata, BashChunkMetadata, Creat
 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 type { Attachment, Attachments } from './message-attachment.schema';
 export { GenerationStepType } from './generation-step-type.enum';
 export { MODEL_ATTRIBUTED_STEP_TYPES, isModelAttributedStepType, } from './model-attributed-step-types.const';
@@ -45,3 +45,8 @@ export { DeleteMessageParamsSchema, DeleteMessageResponseSchema } from './delete
 export type { DeleteMessageParamsDto, DeleteMessageResponseDto } from './delete-message.schema';
 export { CancelStreamResponseSchema } from './cancel-stream-response.schema';
 export type { CancelStreamResponseDto } 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';
+export type { ErrorMeta } from './error-meta.schema';

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

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CodeExecutionStepStartMetadataSchema = exports.VideoAnalysisStepStartMetadataSchema = exports.ImageEditStepStartMetadataSchema = exports.ConversationSearchStepStartMetadataSchema = exports.WebSearchStepStartMetadataSchema = exports.StepDoneMetadataSchema = exports.StepStartMetadataSchema = exports.CitationSchema = exports.CitationStatus = exports.StreamCancellationReason = exports.StreamErrorEventSchema = exports.StreamCancelledEventSchema = exports.StreamDoneEventSchema = exports.StreamHeartbeatEventSchema = exports.StreamCitationsEventSchema = exports.StreamImageGenerationErrorEventSchema = exports.StreamImageEventSchema = exports.StreamBillingEstimateEventSchema = exports.StreamStepBilledEventSchema = exports.StreamStepDoneEventSchema = exports.StreamStepErrorEventSchema = exports.StreamStepChunkEventSchema = exports.StreamStepStartEventSchema = exports.StreamEventSchema = exports.StreamEventType = exports.MessageCitationsResponseSchema = exports.MessageCitationResponseSchema = exports.AttachmentMetaResponseSchema = exports.MessageAttachmentsResponseSchema = exports.MessageAttachmentResponseSchema = exports.ConnectorToolStepContentSchema = exports.VideoAnalysisStepContentSchema = exports.ConversationSearchStepContentSchema = exports.ConversationSearchResultItemSchema = exports.MemoryStepContentSchema = exports.CodeExecutionStepContentResponseSchema = exports.UploadStepContentSchema = exports.ImageGenStepContentSchema = exports.WebSearchStepContentSchema = exports.WebSearchCitationSchema = exports.TextStepContentSchema = exports.StepContentResponseSchema = exports.MessageStepsResponseSchema = exports.MessageStepResponseSchema = exports.MessageResponseSchema = exports.CreateMessageResponseSchema = exports.CreateMessageRequestSchema = exports.UserRating = exports.MessageStatus = exports.MessageRole = void 0;
-exports.CancelStreamResponseSchema = exports.DeleteMessageResponseSchema = exports.DeleteMessageParamsSchema = exports.RateMessageParamsSchema = exports.RateMessageResponseSchema = exports.RateMessageRequestSchema = exports.GenerationStepSchema = exports.FollowupSuggestionsStepContentSchema = exports.FOLLOWUP_SUGGESTION_MAX_CHARS = exports.FOLLOWUP_SUGGESTIONS_MAX_COUNT = exports.FileTruncatedStepContentSchema = exports.TruncationUnit = exports.CapabilityLockedStepContentSchema = exports.LockedCapability = exports.BudgetPromoBudgetCutoffSchema = exports.BudgetPromoDiscountAppliedSchema = exports.BudgetPromoStepContentSchema = exports.BudgetPromoKind = exports.CardMessageKey = exports.CardCta = exports.MessageStepStatus = exports.isModelAttributedStepType = exports.MODEL_ATTRIBUTED_STEP_TYPES = exports.GenerationStepType = exports.AttachmentsSchema = exports.AttachmentSchema = exports.AttachmentStatus = exports.AttachmentType = exports.AttachmentSource = exports.ViewChunkMetadataSchema = exports.StrReplaceChunkMetadataSchema = exports.CreateFileChunkMetadataSchema = exports.BashChunkMetadataSchema = exports.DescribeChunkMetadataSchema = exports.ArgsChunkMetadataSchema = exports.StepChunkMetadataSchema = exports.STEP_CHUNK_LINES_MAX_ITEMS = exports.STEP_CHUNK_LINE_MAX_LENGTH = exports.BashChunkStream = exports.StepChunkKind = exports.StepDoneMetadataByType = exports.StepStartMetadataByType = exports.UploadStepDoneMetadataSchema = exports.ConnectorToolStepStartMetadataSchema = void 0;
+exports.VideoAnalysisStepStartMetadataSchema = exports.ImageEditStepStartMetadataSchema = exports.ConversationSearchStepStartMetadataSchema = exports.WebSearchStepStartMetadataSchema = exports.StepDoneMetadataSchema = exports.StepStartMetadataSchema = exports.CitationSchema = exports.CitationStatus = exports.StreamCancellationReason = exports.StreamErrorEventSchema = exports.StreamCancelledEventSchema = exports.StreamDoneEventSchema = exports.StreamHeartbeatEventSchema = exports.StreamCitationsEventSchema = exports.StreamImageGenerationErrorEventSchema = exports.StreamImageEventSchema = exports.StreamBillingEstimateEventSchema = exports.StreamStepBilledEventSchema = exports.StreamStepDoneEventSchema = exports.StreamStepErrorEventSchema = exports.StreamStepChunkEventSchema = exports.StreamStepStartEventSchema = exports.StreamGenerationStatusEventSchema = exports.StreamEventSchema = exports.StreamEventType = exports.MessageCitationsResponseSchema = exports.MessageCitationResponseSchema = exports.AttachmentMetaResponseSchema = exports.MessageAttachmentsResponseSchema = exports.MessageAttachmentResponseSchema = exports.ConnectorToolStepContentSchema = exports.VideoAnalysisStepContentSchema = exports.ConversationSearchStepContentSchema = exports.ConversationSearchResultItemSchema = exports.MemoryStepContentSchema = exports.CodeExecutionStepContentResponseSchema = exports.UploadStepContentSchema = exports.ImageGenStepContentSchema = exports.WebSearchStepContentSchema = exports.WebSearchCitationSchema = exports.TextStepContentSchema = exports.StepContentResponseSchema = exports.MessageStepsResponseSchema = exports.MessageStepResponseSchema = exports.MessageResponseSchema = exports.CreateMessageResponseSchema = exports.CreateMessageRequestSchema = exports.UserRating = exports.MessageStatus = exports.MessageRole = void 0;
+exports.ErrorMetaSchema = exports.GenerationStatus = exports.MessageErrorAction = exports.MessageErrorCategory = exports.CancelStreamResponseSchema = exports.DeleteMessageResponseSchema = exports.DeleteMessageParamsSchema = exports.RateMessageParamsSchema = exports.RateMessageResponseSchema = exports.RateMessageRequestSchema = exports.GenerationStepSchema = exports.FollowupSuggestionsStepContentSchema = exports.FOLLOWUP_SUGGESTION_MAX_CHARS = exports.FOLLOWUP_SUGGESTIONS_MAX_COUNT = exports.FileTruncatedStepContentSchema = exports.TruncationUnit = exports.CapabilityLockedStepContentSchema = exports.LockedCapability = exports.BudgetPromoBudgetCutoffSchema = exports.BudgetPromoDiscountAppliedSchema = exports.BudgetPromoStepContentSchema = exports.BudgetPromoKind = exports.CardMessageKey = exports.CardCta = exports.MessageStepStatus = exports.isModelAttributedStepType = exports.MODEL_ATTRIBUTED_STEP_TYPES = exports.GenerationStepType = exports.AttachmentsSchema = exports.AttachmentSchema = exports.AttachmentStatus = exports.AttachmentType = exports.AttachmentSource = exports.ViewChunkMetadataSchema = exports.StrReplaceChunkMetadataSchema = exports.CreateFileChunkMetadataSchema = exports.BashChunkMetadataSchema = exports.DescribeChunkMetadataSchema = exports.ArgsChunkMetadataSchema = exports.StepChunkMetadataSchema = exports.STEP_CHUNK_LINES_MAX_ITEMS = exports.STEP_CHUNK_LINE_MAX_LENGTH = exports.BashChunkStream = exports.StepChunkKind = exports.StepDoneMetadataByType = exports.StepStartMetadataByType = exports.UploadStepDoneMetadataSchema = exports.ConnectorToolStepStartMetadataSchema = exports.CodeExecutionStepStartMetadataSchema = void 0;
 var message_role_enum_1 = require("./message-role.enum");
 Object.defineProperty(exports, "MessageRole", { enumerable: true, get: function () { return message_role_enum_1.MessageRole; } });
 var message_status_enum_1 = require("./message-status.enum");
@@ -40,6 +40,7 @@ var stream_event_type_enum_1 = require("./stream-event-type.enum");
 Object.defineProperty(exports, "StreamEventType", { enumerable: true, get: function () { return stream_event_type_enum_1.StreamEventType; } });
 var stream_events_schema_1 = require("./stream-events.schema");
 Object.defineProperty(exports, "StreamEventSchema", { enumerable: true, get: function () { return stream_events_schema_1.StreamEventSchema; } });
+Object.defineProperty(exports, "StreamGenerationStatusEventSchema", { enumerable: true, get: function () { return stream_events_schema_1.StreamGenerationStatusEventSchema; } });
 Object.defineProperty(exports, "StreamStepStartEventSchema", { enumerable: true, get: function () { return stream_events_schema_1.StreamStepStartEventSchema; } });
 Object.defineProperty(exports, "StreamStepChunkEventSchema", { enumerable: true, get: function () { return stream_events_schema_1.StreamStepChunkEventSchema; } });
 Object.defineProperty(exports, "StreamStepErrorEventSchema", { enumerable: true, get: function () { return stream_events_schema_1.StreamStepErrorEventSchema; } });
@@ -129,4 +130,12 @@ Object.defineProperty(exports, "DeleteMessageParamsSchema", { enumerable: true,
 Object.defineProperty(exports, "DeleteMessageResponseSchema", { enumerable: true, get: function () { return delete_message_schema_1.DeleteMessageResponseSchema; } });
 var cancel_stream_response_schema_1 = require("./cancel-stream-response.schema");
 Object.defineProperty(exports, "CancelStreamResponseSchema", { enumerable: true, get: function () { return cancel_stream_response_schema_1.CancelStreamResponseSchema; } });
+var message_error_category_enum_1 = require("./message-error-category.enum");
+Object.defineProperty(exports, "MessageErrorCategory", { enumerable: true, get: function () { return message_error_category_enum_1.MessageErrorCategory; } });
+var message_error_action_enum_1 = require("./message-error-action.enum");
+Object.defineProperty(exports, "MessageErrorAction", { enumerable: true, get: function () { return message_error_action_enum_1.MessageErrorAction; } });
+var generation_status_enum_1 = require("./generation-status.enum");
+Object.defineProperty(exports, "GenerationStatus", { enumerable: true, get: function () { return generation_status_enum_1.GenerationStatus; } });
+var error_meta_schema_1 = require("./error-meta.schema");
+Object.defineProperty(exports, "ErrorMetaSchema", { enumerable: true, get: function () { return error_meta_schema_1.ErrorMetaSchema; } });
 //# sourceMappingURL=index.js.map

package/build/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/v1/message/schemas/message-attachment-response.schema.d.ts

@@ -2,11 +2,18 @@ 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 declare const AttachmentMetaResponseSchema: z.ZodObject<{
     width: z.ZodOptional<z.ZodNumber>;
     height: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type AttachmentMetaResponse = z.infer<typeof AttachmentMetaResponseSchema>;
+/**
+ * Message attachment response schema for frontend
+ * Returns URL instead of S3 key
+ */
 export declare const MessageAttachmentResponseSchema: z.ZodObject<{
     uuid: z.ZodString;
     source: z.ZodEnum<typeof AttachmentSource>;
@@ -22,6 +29,9 @@ export declare const MessageAttachmentResponseSchema: z.ZodObject<{
     marks: z.ZodArray<z.ZodEnum<typeof ClientFileMark>>;
 }, z.core.$strip>;
 export type MessageAttachmentResponse = z.infer<typeof MessageAttachmentResponseSchema>;
+/**
+ * Array of attachment responses
+ */
 export declare const MessageAttachmentsResponseSchema: z.ZodArray<z.ZodObject<{
     uuid: z.ZodString;
     source: z.ZodEnum<typeof AttachmentSource>;

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

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

package/build/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,6BAAwB;AACxB,qEAA4D;AAC5D,iEAAwD;AACxD,2FAAiF;AAKpE,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7C,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC;AAQU,QAAA,+BAA+B,GAAG,OAAC,CAAC,MAAM,CAAC;IAEpD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAEvB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,yCAAgB,CAAC;IAEhC,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,qCAAc,CAAC;IAE5B,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAErB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE/B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE/B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAE5C,IAAI,EAAE,oCAA4B,CAAC,QAAQ,EAAE;IAE7C,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,sCAAc,CAAC,CAAC;CACzC,CAAC,CAAC;AAOU,QAAA,gCAAgC,GAAG,OAAC,CAAC,KAAK,CAAC,uCAA+B,CAAC,CAAC"}
+{"version":3,"file":"message-attachment-response.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/message-attachment-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,qEAA4D;AAC5D,iEAAwD;AACxD,2FAAiF;AAEjF;;GAEG;AACU,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7C,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC;AAIH;;;GAGG;AACU,QAAA,+BAA+B,GAAG,OAAC,CAAC,MAAM,CAAC;IACpD,sBAAsB;IACtB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACvB,iCAAiC;IACjC,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,yCAAgB,CAAC;IAChC,sBAAsB;IACtB,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,qCAAc,CAAC;IAC5B,oCAAoC;IACpC,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,gBAAgB;IAChB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,wBAAwB;IACxB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,yBAAyB;IACzB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,uCAAuC;IACvC,IAAI,EAAE,oCAA4B,CAAC,QAAQ,EAAE;IAC7C,wEAAwE;IACxE,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,sCAAc,CAAC,CAAC;CACzC,CAAC,CAAC;AAIH;;GAEG;AACU,QAAA,gCAAgC,GAAG,OAAC,CAAC,KAAK,CAAC,uCAA+B,CAAC,CAAC"}

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

@@ -1,10 +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 declare const AttachmentSchema: z.ZodObject<{
     type: z.ZodEnum<typeof AttachmentType>;
     key: z.ZodString;
 }, z.core.$strip>;
 export type Attachment = z.infer<typeof AttachmentSchema>;
+/**
+ * Array of attachments for message
+ */
 export declare const AttachmentsSchema: z.ZodArray<z.ZodObject<{
     type: z.ZodEnum<typeof AttachmentType>;
     key: z.ZodString;

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

@@ -3,9 +3,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AttachmentsSchema = exports.AttachmentSchema = void 0;
 const zod_1 = require("zod");
 const attachment_type_enum_1 = require("./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
+ */
 exports.AttachmentSchema = zod_1.z.object({
+    /** Asset type */
     type: zod_1.z.enum(attachment_type_enum_1.AttachmentType),
+    /** S3 object key */
     key: zod_1.z.string().min(1),
 });
+/**
+ * Array of attachments for message
+ */
 exports.AttachmentsSchema = zod_1.z.array(exports.AttachmentSchema);
 //# sourceMappingURL=message-attachment.schema.js.map

package/build/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,6BAAwB;AACxB,iEAAwD;AAO3C,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IAErC,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,qCAAc,CAAC;IAE5B,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACzB,CAAC,CAAC;AAOU,QAAA,iBAAiB,GAAG,OAAC,CAAC,KAAK,CAAC,wBAAgB,CAAC,CAAC"}
+{"version":3,"file":"message-attachment.schema.js","sourceRoot":"","sources":["../../../../v1/message/schemas/message-attachment.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,iEAAwD;AAExD;;;;GAIG;AACU,QAAA,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,iBAAiB;IACjB,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,qCAAc,CAAC;IAC5B,oBAAoB;IACpB,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACzB,CAAC,CAAC;AAIH;;GAEG;AACU,QAAA,iBAAiB,GAAG,OAAC,CAAC,KAAK,CAAC,wBAAgB,CAAC,CAAC"}