@veruna/api-contracts 20.0.0 → 20.2.0

package/build/v1/message/commands/create-message.command.d.ts

@@ -1,5 +1,41 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Send message and get AI response as NDJSON stream
+ *
+ * Response format: application/x-ndjson
+ * Each line is a JSON object that can be parsed with JSON.parse()
+ *
+ * @example
+ * ```typescript
+ * const response = await fetch(url, { method: 'POST', body: JSON.stringify(request) });
+ * const reader = response.body.getReader();
+ * const decoder = new TextDecoder();
+ * let buffer = '';
+ *
+ * while (true) {
+ *   const { done, value } = await reader.read();
+ *   if (done) break;
+ *
+ *   buffer += decoder.decode(value, { stream: true });
+ *   const lines = buffer.split('\n');
+ *   buffer = lines.pop()!;
+ *
+ *   for (const line of lines) {
+ *     if (line.trim()) {
+ *       const event: CreateMessageCommand.StreamEventType = JSON.parse(line);
+ *       switch (event.type) {
+ *         case 'step_start': console.log('Step started:', event.stepType); break;
+ *         case 'step_chunk': console.log(event.chunk); break;
+ *         case 'step_done': console.log('Step done:', event.stepType); break;
+ *         case 'done': console.log('Complete!'); break;
+ *         case 'error': console.error('Error!'); break;
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
 export declare namespace CreateMessageCommand {
     const Request: z.ZodObject<{
         aiModelId: z.ZodString;
@@ -28,7 +64,15 @@ export declare namespace CreateMessageCommand {
     const Response: z.ZodObject<{
         messageId: z.ZodString;
     }, z.core.$strip>;
+    /** Discriminated union of all stream events */
     const StreamEvent: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodNumber;
+        chatId: z.ZodString;
+        messageId: z.ZodString;
+        type: z.ZodLiteral<import("../schemas").StreamEventType.GENERATION_STATUS>;
+        status: z.ZodEnum<typeof import("../schemas").GenerationStatus>;
+        modelId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
         id: z.ZodNumber;
         chatId: z.ZodString;
         messageId: z.ZodString;
@@ -193,12 +237,16 @@ export declare namespace CreateMessageCommand {
         id: z.ZodNumber;
         chatId: z.ZodString;
         messageId: z.ZodString;
+        errorCategory: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof import("../schemas").MessageErrorCategory>>>;
+        errorActions: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof import("../schemas").MessageErrorAction>>>;
         type: z.ZodLiteral<import("../schemas").StreamEventType.DONE>;
         chargedTokens: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodNumber;
         chatId: z.ZodString;
         messageId: z.ZodString;
+        errorCategory: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof import("../schemas").MessageErrorCategory>>>;
+        errorActions: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof import("../schemas").MessageErrorAction>>>;
         type: z.ZodLiteral<import("../schemas").StreamEventType.CANCELLED>;
         chargedTokens: z.ZodOptional<z.ZodNumber>;
         reason: z.ZodOptional<z.ZodEnum<typeof import("../schemas").StreamCancellationReason>>;
@@ -209,6 +257,8 @@ export declare namespace CreateMessageCommand {
         id: z.ZodNumber;
         chatId: z.ZodString;
         messageId: z.ZodString;
+        errorCategory: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof import("../schemas").MessageErrorCategory>>>;
+        errorActions: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof import("../schemas").MessageErrorAction>>>;
         type: z.ZodLiteral<import("../schemas").StreamEventType.ERROR>;
         chargedTokens: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>], "type">;
@@ -335,6 +385,8 @@ export declare namespace CreateMessageCommand {
         id: z.ZodNumber;
         chatId: z.ZodString;
         messageId: z.ZodString;
+        errorCategory: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof import("../schemas").MessageErrorCategory>>>;
+        errorActions: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof import("../schemas").MessageErrorAction>>>;
         type: z.ZodLiteral<import("../schemas").StreamEventType.DONE>;
         chargedTokens: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
@@ -342,12 +394,16 @@ export declare namespace CreateMessageCommand {
         id: z.ZodNumber;
         chatId: z.ZodString;
         messageId: z.ZodString;
+        errorCategory: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof import("../schemas").MessageErrorCategory>>>;
+        errorActions: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof import("../schemas").MessageErrorAction>>>;
         type: z.ZodLiteral<import("../schemas").StreamEventType.ERROR>;
         chargedTokens: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     const URL: (chatId: string) => string;
     const METHOD = HttpMethod.POST;
+    /** Response content type */
     const CONTENT_TYPE: "application/x-ndjson";
+    /** This endpoint returns a stream, not a single response */
     const IS_STREAM: true;
     type RequestType = z.infer<typeof Request>;
     type StreamEventType = z.infer<typeof StreamEvent>;

package/build/v1/message/commands/create-message.command.js

@@ -4,10 +4,47 @@ exports.CreateMessageCommand = void 0;
 const schemas_1 = require("../schemas");
 const rest_api_1 = require("../../../rest-api");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
+/**
+ * Send message and get AI response as NDJSON stream
+ *
+ * Response format: application/x-ndjson
+ * Each line is a JSON object that can be parsed with JSON.parse()
+ *
+ * @example
+ * ```typescript
+ * const response = await fetch(url, { method: 'POST', body: JSON.stringify(request) });
+ * const reader = response.body.getReader();
+ * const decoder = new TextDecoder();
+ * let buffer = '';
+ *
+ * while (true) {
+ *   const { done, value } = await reader.read();
+ *   if (done) break;
+ *
+ *   buffer += decoder.decode(value, { stream: true });
+ *   const lines = buffer.split('\n');
+ *   buffer = lines.pop()!;
+ *
+ *   for (const line of lines) {
+ *     if (line.trim()) {
+ *       const event: CreateMessageCommand.StreamEventType = JSON.parse(line);
+ *       switch (event.type) {
+ *         case 'step_start': console.log('Step started:', event.stepType); break;
+ *         case 'step_chunk': console.log(event.chunk); break;
+ *         case 'step_done': console.log('Step done:', event.stepType); break;
+ *         case 'done': console.log('Complete!'); break;
+ *         case 'error': console.error('Error!'); break;
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
 var CreateMessageCommand;
 (function (CreateMessageCommand) {
     CreateMessageCommand.Request = schemas_1.CreateMessageRequestSchema;
     CreateMessageCommand.Response = schemas_1.CreateMessageResponseSchema;
+    /** Discriminated union of all stream events */
     CreateMessageCommand.StreamEvent = schemas_1.StreamEventSchema;
     CreateMessageCommand.StepStartEvent = schemas_1.StreamStepStartEventSchema;
     CreateMessageCommand.StepChunkEvent = schemas_1.StreamStepChunkEventSchema;
@@ -17,7 +54,9 @@ var CreateMessageCommand;
     CreateMessageCommand.ErrorEvent = schemas_1.StreamErrorEventSchema;
     CreateMessageCommand.URL = (chatId) => rest_api_1.REST_API.V1.MESSAGE.UNREG.SEND(chatId);
     CreateMessageCommand.METHOD = http_method_enum_1.HttpMethod.POST;
+    /** Response content type */
     CreateMessageCommand.CONTENT_TYPE = 'application/x-ndjson';
+    /** This endpoint returns a stream, not a single response */
     CreateMessageCommand.IS_STREAM = true;
 })(CreateMessageCommand || (exports.CreateMessageCommand = CreateMessageCommand = {}));
 //# sourceMappingURL=create-message.command.js.map

package/build/v1/message/commands/create-message.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-message.command.js","sourceRoot":"","sources":["../../../../v1/message/commands/create-message.command.ts"],"names":[],"mappings":";;;AACA,wCAUoB;AACpB,gDAA6C;AAC7C,uEAA8D;AAsC9D,IAAiB,oBAAoB,CA8BpC;AA9BD,WAAiB,oBAAoB;IACpB,4BAAO,GAAG,oCAA0B,CAAC;IACrC,6BAAQ,GAAG,qCAA2B,CAAC;IAGvC,gCAAW,GAAG,2BAAiB,CAAC;IAChC,mCAAc,GAAG,oCAA0B,CAAC;IAC5C,mCAAc,GAAG,oCAA0B,CAAC;IAC5C,mCAAc,GAAG,oCAA0B,CAAC;IAC5C,kCAAa,GAAG,mCAAyB,CAAC;IAC1C,8BAAS,GAAG,+BAAqB,CAAC;IAClC,+BAAU,GAAG,gCAAsB,CAAC;IAEpC,wBAAG,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjE,2BAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;IAGzB,iCAAY,GAAG,sBAA+B,CAAC;IAG/C,8BAAS,GAAG,IAAa,CAAC;AAU3C,CAAC,EA9BgB,oBAAoB,oCAApB,oBAAoB,QA8BpC"}
+{"version":3,"file":"create-message.command.js","sourceRoot":"","sources":["../../../../v1/message/commands/create-message.command.ts"],"names":[],"mappings":";;;AACA,wCAUoB;AACpB,gDAA6C;AAC7C,uEAA8D;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,IAAiB,oBAAoB,CA8BpC;AA9BD,WAAiB,oBAAoB;IACpB,4BAAO,GAAG,oCAA0B,CAAC;IACrC,6BAAQ,GAAG,qCAA2B,CAAC;IAEpD,+CAA+C;IAClC,gCAAW,GAAG,2BAAiB,CAAC;IAChC,mCAAc,GAAG,oCAA0B,CAAC;IAC5C,mCAAc,GAAG,oCAA0B,CAAC;IAC5C,mCAAc,GAAG,oCAA0B,CAAC;IAC5C,kCAAa,GAAG,mCAAyB,CAAC;IAC1C,8BAAS,GAAG,+BAAqB,CAAC;IAClC,+BAAU,GAAG,gCAAsB,CAAC;IAEpC,wBAAG,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjE,2BAAM,GAAG,6BAAU,CAAC,IAAI,CAAC;IAEtC,4BAA4B;IACf,iCAAY,GAAG,sBAA+B,CAAC;IAE5D,4DAA4D;IAC/C,8BAAS,GAAG,IAAa,CAAC;AAU3C,CAAC,EA9BgB,oBAAoB,oCAApB,oBAAoB,QA8BpC"}

package/build/v1/message/commands/delete-message-reg.command.d.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
 export declare namespace DeleteMessageRegCommand {
+    /** No request body - messageId is in URL params */
     const Request: z.ZodObject<{}, z.core.$strip>;
     const Response: z.ZodObject<{
         uuid: z.ZodString;

package/build/v1/message/commands/delete-message-reg.command.js

@@ -7,6 +7,7 @@ const rest_api_1 = require("../../../rest-api");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 var DeleteMessageRegCommand;
 (function (DeleteMessageRegCommand) {
+    /** No request body - messageId is in URL params */
     DeleteMessageRegCommand.Request = zod_1.z.object({});
     DeleteMessageRegCommand.Response = delete_message_schema_1.DeleteMessageResponseSchema;
     DeleteMessageRegCommand.URL = (chatId, messageId) => rest_api_1.REST_API.V1.MESSAGE.REG.DELETE(chatId, messageId);

package/build/v1/message/commands/delete-message-reg.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"delete-message-reg.command.js","sourceRoot":"","sources":["../../../../v1/message/commands/delete-message-reg.command.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4EAA+E;AAC/E,gDAA6C;AAC7C,uEAA8D;AAE9D,IAAiB,uBAAuB,CAUvC;AAVD,WAAiB,uBAAuB;IAEvB,+BAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,gCAAQ,GAAG,mDAA2B,CAAC;IACvC,2BAAG,GAAG,CAAC,MAAc,EAAE,SAAiB,EAAE,EAAE,CACrD,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC,8BAAM,GAAG,6BAAU,CAAC,MAAM,CAAC;AAI5C,CAAC,EAVgB,uBAAuB,uCAAvB,uBAAuB,QAUvC"}
+{"version":3,"file":"delete-message-reg.command.js","sourceRoot":"","sources":["../../../../v1/message/commands/delete-message-reg.command.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4EAA+E;AAC/E,gDAA6C;AAC7C,uEAA8D;AAE9D,IAAiB,uBAAuB,CAUvC;AAVD,WAAiB,uBAAuB;IACpC,mDAAmD;IACtC,+BAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,gCAAQ,GAAG,mDAA2B,CAAC;IACvC,2BAAG,GAAG,CAAC,MAAc,EAAE,SAAiB,EAAE,EAAE,CACrD,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC,8BAAM,GAAG,6BAAU,CAAC,MAAM,CAAC;AAI5C,CAAC,EAVgB,uBAAuB,uCAAvB,uBAAuB,QAUvC"}

package/build/v1/message/commands/delete-message-unreg.command.d.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
 export declare namespace DeleteMessageUnregCommand {
+    /** No request body - messageId is in URL params */
     const Request: z.ZodObject<{}, z.core.$strip>;
     const Response: z.ZodObject<{
         uuid: z.ZodString;

package/build/v1/message/commands/delete-message-unreg.command.js

@@ -7,6 +7,7 @@ const rest_api_1 = require("../../../rest-api");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
 var DeleteMessageUnregCommand;
 (function (DeleteMessageUnregCommand) {
+    /** No request body - messageId is in URL params */
     DeleteMessageUnregCommand.Request = zod_1.z.object({});
     DeleteMessageUnregCommand.Response = delete_message_schema_1.DeleteMessageResponseSchema;
     DeleteMessageUnregCommand.URL = (chatId, messageId) => rest_api_1.REST_API.V1.MESSAGE.UNREG.DELETE(chatId, messageId);

package/build/v1/message/commands/delete-message-unreg.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"delete-message-unreg.command.js","sourceRoot":"","sources":["../../../../v1/message/commands/delete-message-unreg.command.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4EAA+E;AAC/E,gDAA6C;AAC7C,uEAA8D;AAE9D,IAAiB,yBAAyB,CAUzC;AAVD,WAAiB,yBAAyB;IAEzB,iCAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,kCAAQ,GAAG,mDAA2B,CAAC;IACvC,6BAAG,GAAG,CAAC,MAAc,EAAE,SAAiB,EAAE,EAAE,CACrD,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3C,gCAAM,GAAG,6BAAU,CAAC,MAAM,CAAC;AAI5C,CAAC,EAVgB,yBAAyB,yCAAzB,yBAAyB,QAUzC"}
+{"version":3,"file":"delete-message-unreg.command.js","sourceRoot":"","sources":["../../../../v1/message/commands/delete-message-unreg.command.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4EAA+E;AAC/E,gDAA6C;AAC7C,uEAA8D;AAE9D,IAAiB,yBAAyB,CAUzC;AAVD,WAAiB,yBAAyB;IACtC,mDAAmD;IACtC,iCAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,kCAAQ,GAAG,mDAA2B,CAAC;IACvC,6BAAG,GAAG,CAAC,MAAc,EAAE,SAAiB,EAAE,EAAE,CACrD,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3C,gCAAM,GAAG,6BAAU,CAAC,MAAM,CAAC;AAI5C,CAAC,EAVgB,yBAAyB,yCAAzB,yBAAyB,QAUzC"}

package/build/v1/message/message.errors.d.ts

@@ -7,9 +7,13 @@ export declare enum MessageErrorCode {
     CHAT_DELETED = "CHAT_DELETED",
     CHAT_STREAM_IN_PROGRESS = "CHAT_STREAM_IN_PROGRESS",
     STREAM_NOT_FOUND = "STREAM_NOT_FOUND",
+    /** Stream cancelled by explicit user action (POST /cancel). */
     STREAM_CANCELLED = "STREAM_CANCELLED",
+    /** Stream killed because the consumer stopped reading for too long. */
     STREAM_TIMEOUT = "STREAM_TIMEOUT",
+    /** Stream aborted by the system (process shutdown, abort signal upstream). */
     STREAM_ABORTED = "STREAM_ABORTED",
+    /** A status transition rejected by the domain state machine. */
     MESSAGE_INVALID_STATUS_TRANSITION = "MESSAGE_INVALID_STATUS_TRANSITION",
     INVALID_PAGE_ID = "INVALID_PAGE_ID",
     MESSAGE_TEXT_EMPTY = "MESSAGE_TEXT_EMPTY",
@@ -38,6 +42,7 @@ export declare enum MessageErrorCode {
     DOCUMENT_PAGE_COUNT_UNAVAILABLE = "DOCUMENT_PAGE_COUNT_UNAVAILABLE",
     ATTACHMENTS_SYNC_FAILED = "ATTACHMENTS_SYNC_FAILED",
     ATTACHMENT_NOT_FOUND = "ATTACHMENT_NOT_FOUND",
+    /** User does not have enough wallet balance to start the message. */
     INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE"
 }
 export declare const MESSAGE_ERRORS: Record<MessageErrorCode, ErrorMetadata>;

package/build/v1/message/message.errors.js

@@ -10,9 +10,13 @@ var MessageErrorCode;
     MessageErrorCode["CHAT_DELETED"] = "CHAT_DELETED";
     MessageErrorCode["CHAT_STREAM_IN_PROGRESS"] = "CHAT_STREAM_IN_PROGRESS";
     MessageErrorCode["STREAM_NOT_FOUND"] = "STREAM_NOT_FOUND";
+    /** Stream cancelled by explicit user action (POST /cancel). */
     MessageErrorCode["STREAM_CANCELLED"] = "STREAM_CANCELLED";
+    /** Stream killed because the consumer stopped reading for too long. */
     MessageErrorCode["STREAM_TIMEOUT"] = "STREAM_TIMEOUT";
+    /** Stream aborted by the system (process shutdown, abort signal upstream). */
     MessageErrorCode["STREAM_ABORTED"] = "STREAM_ABORTED";
+    /** A status transition rejected by the domain state machine. */
     MessageErrorCode["MESSAGE_INVALID_STATUS_TRANSITION"] = "MESSAGE_INVALID_STATUS_TRANSITION";
     MessageErrorCode["INVALID_PAGE_ID"] = "INVALID_PAGE_ID";
     MessageErrorCode["MESSAGE_TEXT_EMPTY"] = "MESSAGE_TEXT_EMPTY";
@@ -41,6 +45,7 @@ var MessageErrorCode;
     MessageErrorCode["DOCUMENT_PAGE_COUNT_UNAVAILABLE"] = "DOCUMENT_PAGE_COUNT_UNAVAILABLE";
     MessageErrorCode["ATTACHMENTS_SYNC_FAILED"] = "ATTACHMENTS_SYNC_FAILED";
     MessageErrorCode["ATTACHMENT_NOT_FOUND"] = "ATTACHMENT_NOT_FOUND";
+    /** User does not have enough wallet balance to start the message. */
     MessageErrorCode["INSUFFICIENT_BALANCE"] = "INSUFFICIENT_BALANCE";
 })(MessageErrorCode || (exports.MessageErrorCode = MessageErrorCode = {}));
 exports.MESSAGE_ERRORS = {
@@ -74,11 +79,11 @@ exports.MESSAGE_ERRORS = {
     },
     [MessageErrorCode.STREAM_CANCELLED]: {
         code: MessageErrorCode.STREAM_CANCELLED,
-        statusCode: 499,
+        statusCode: 499, // Client Closed Request
     },
     [MessageErrorCode.STREAM_TIMEOUT]: {
         code: MessageErrorCode.STREAM_TIMEOUT,
-        statusCode: 504,
+        statusCode: 504, // Gateway Timeout
     },
     [MessageErrorCode.STREAM_ABORTED]: {
         code: MessageErrorCode.STREAM_ABORTED,

package/build/v1/message/message.errors.js.map

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

package/build/v1/message/queries/get-message-stream-reg.query.d.ts

@@ -1,8 +1,19 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Reattach to an existing registered message stream and replay all persisted events.
+ * GET /api/v1/chat/:chatId/message/:messageId/stream
+ */
 export declare namespace GetMessageStreamRegQuery {
     const Request: z.ZodObject<{}, z.core.$strip>;
     const Response: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodNumber;
+        chatId: z.ZodString;
+        messageId: z.ZodString;
+        type: z.ZodLiteral<import("../schemas").StreamEventType.GENERATION_STATUS>;
+        status: z.ZodEnum<typeof import("../schemas").GenerationStatus>;
+        modelId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
         id: z.ZodNumber;
         chatId: z.ZodString;
         messageId: z.ZodString;
@@ -167,12 +178,16 @@ export declare namespace GetMessageStreamRegQuery {
         id: z.ZodNumber;
         chatId: z.ZodString;
         messageId: z.ZodString;
+        errorCategory: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof import("../schemas").MessageErrorCategory>>>;
+        errorActions: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof import("../schemas").MessageErrorAction>>>;
         type: z.ZodLiteral<import("../schemas").StreamEventType.DONE>;
         chargedTokens: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodNumber;
         chatId: z.ZodString;
         messageId: z.ZodString;
+        errorCategory: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof import("../schemas").MessageErrorCategory>>>;
+        errorActions: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof import("../schemas").MessageErrorAction>>>;
         type: z.ZodLiteral<import("../schemas").StreamEventType.CANCELLED>;
         chargedTokens: z.ZodOptional<z.ZodNumber>;
         reason: z.ZodOptional<z.ZodEnum<typeof import("../schemas").StreamCancellationReason>>;
@@ -183,6 +198,8 @@ export declare namespace GetMessageStreamRegQuery {
         id: z.ZodNumber;
         chatId: z.ZodString;
         messageId: z.ZodString;
+        errorCategory: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof import("../schemas").MessageErrorCategory>>>;
+        errorActions: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof import("../schemas").MessageErrorAction>>>;
         type: z.ZodLiteral<import("../schemas").StreamEventType.ERROR>;
         chargedTokens: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>], "type">;

package/build/v1/message/queries/get-message-stream-reg.query.js

@@ -5,6 +5,10 @@ const zod_1 = require("zod");
 const schemas_1 = require("../schemas");
 const rest_api_1 = require("../../../rest-api");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
+/**
+ * Reattach to an existing registered message stream and replay all persisted events.
+ * GET /api/v1/chat/:chatId/message/:messageId/stream
+ */
 var GetMessageStreamRegQuery;
 (function (GetMessageStreamRegQuery) {
     GetMessageStreamRegQuery.Request = zod_1.z.object({});

package/build/v1/message/queries/get-message-stream-reg.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-message-stream-reg.query.js","sourceRoot":"","sources":["../../../../v1/message/queries/get-message-stream-reg.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAA+C;AAC/C,gDAA6C;AAC7C,uEAA8D;AAM9D,IAAiB,wBAAwB,CAYxC;AAZD,WAAiB,wBAAwB;IACxB,gCAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,iCAAQ,GAAG,2BAAiB,CAAC;IAE7B,4BAAG,GAAG,CAAC,MAAc,EAAE,SAAiB,EAAE,EAAE,CACrD,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC,+BAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;IACxB,qCAAY,GAAG,sBAA+B,CAAC;IAC/C,kCAAS,GAAG,IAAa,CAAC;AAI3C,CAAC,EAZgB,wBAAwB,wCAAxB,wBAAwB,QAYxC"}
+{"version":3,"file":"get-message-stream-reg.query.js","sourceRoot":"","sources":["../../../../v1/message/queries/get-message-stream-reg.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAA+C;AAC/C,gDAA6C;AAC7C,uEAA8D;AAE9D;;;GAGG;AACH,IAAiB,wBAAwB,CAYxC;AAZD,WAAiB,wBAAwB;IACxB,gCAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,iCAAQ,GAAG,2BAAiB,CAAC;IAE7B,4BAAG,GAAG,CAAC,MAAc,EAAE,SAAiB,EAAE,EAAE,CACrD,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC,+BAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;IACxB,qCAAY,GAAG,sBAA+B,CAAC;IAC/C,kCAAS,GAAG,IAAa,CAAC;AAI3C,CAAC,EAZgB,wBAAwB,wCAAxB,wBAAwB,QAYxC"}

package/build/v1/message/queries/get-message-stream-unreg.query.d.ts

@@ -1,8 +1,19 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Reattach to an existing unregistered message stream and replay all persisted events.
+ * GET /api/v1/unreg/chat/:chatId/message/:messageId/stream
+ */
 export declare namespace GetMessageStreamUnregQuery {
     const Request: z.ZodObject<{}, z.core.$strip>;
     const Response: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodNumber;
+        chatId: z.ZodString;
+        messageId: z.ZodString;
+        type: z.ZodLiteral<import("../schemas").StreamEventType.GENERATION_STATUS>;
+        status: z.ZodEnum<typeof import("../schemas").GenerationStatus>;
+        modelId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
         id: z.ZodNumber;
         chatId: z.ZodString;
         messageId: z.ZodString;
@@ -167,12 +178,16 @@ export declare namespace GetMessageStreamUnregQuery {
         id: z.ZodNumber;
         chatId: z.ZodString;
         messageId: z.ZodString;
+        errorCategory: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof import("../schemas").MessageErrorCategory>>>;
+        errorActions: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof import("../schemas").MessageErrorAction>>>;
         type: z.ZodLiteral<import("../schemas").StreamEventType.DONE>;
         chargedTokens: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodNumber;
         chatId: z.ZodString;
         messageId: z.ZodString;
+        errorCategory: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof import("../schemas").MessageErrorCategory>>>;
+        errorActions: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof import("../schemas").MessageErrorAction>>>;
         type: z.ZodLiteral<import("../schemas").StreamEventType.CANCELLED>;
         chargedTokens: z.ZodOptional<z.ZodNumber>;
         reason: z.ZodOptional<z.ZodEnum<typeof import("../schemas").StreamCancellationReason>>;
@@ -183,6 +198,8 @@ export declare namespace GetMessageStreamUnregQuery {
         id: z.ZodNumber;
         chatId: z.ZodString;
         messageId: z.ZodString;
+        errorCategory: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof import("../schemas").MessageErrorCategory>>>;
+        errorActions: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof import("../schemas").MessageErrorAction>>>;
         type: z.ZodLiteral<import("../schemas").StreamEventType.ERROR>;
         chargedTokens: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>], "type">;

package/build/v1/message/queries/get-message-stream-unreg.query.js

@@ -5,6 +5,10 @@ const zod_1 = require("zod");
 const schemas_1 = require("../schemas");
 const rest_api_1 = require("../../../rest-api");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
+/**
+ * Reattach to an existing unregistered message stream and replay all persisted events.
+ * GET /api/v1/unreg/chat/:chatId/message/:messageId/stream
+ */
 var GetMessageStreamUnregQuery;
 (function (GetMessageStreamUnregQuery) {
     GetMessageStreamUnregQuery.Request = zod_1.z.object({});

package/build/v1/message/queries/get-message-stream-unreg.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-message-stream-unreg.query.js","sourceRoot":"","sources":["../../../../v1/message/queries/get-message-stream-unreg.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAA+C;AAC/C,gDAA6C;AAC7C,uEAA8D;AAM9D,IAAiB,0BAA0B,CAY1C;AAZD,WAAiB,0BAA0B;IAC1B,kCAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,mCAAQ,GAAG,2BAAiB,CAAC;IAE7B,8BAAG,GAAG,CAAC,MAAc,EAAE,SAAiB,EAAE,EAAE,CACrD,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3C,iCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;IACxB,uCAAY,GAAG,sBAA+B,CAAC;IAC/C,oCAAS,GAAG,IAAa,CAAC;AAI3C,CAAC,EAZgB,0BAA0B,0CAA1B,0BAA0B,QAY1C"}
+{"version":3,"file":"get-message-stream-unreg.query.js","sourceRoot":"","sources":["../../../../v1/message/queries/get-message-stream-unreg.query.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,wCAA+C;AAC/C,gDAA6C;AAC7C,uEAA8D;AAE9D;;;GAGG;AACH,IAAiB,0BAA0B,CAY1C;AAZD,WAAiB,0BAA0B;IAC1B,kCAAO,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,mCAAQ,GAAG,2BAAiB,CAAC;IAE7B,8BAAG,GAAG,CAAC,MAAc,EAAE,SAAiB,EAAE,EAAE,CACrD,mBAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3C,iCAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;IACxB,uCAAY,GAAG,sBAA+B,CAAC;IAC/C,oCAAS,GAAG,IAAa,CAAC;AAI3C,CAAC,EAZgB,0BAA0B,0CAA1B,0BAA0B,QAY1C"}

package/build/v1/message/schemas/attachment-source.enum.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Attachment source - who created the attachment
+ */
 export declare enum AttachmentSource {
     USER = "USER",
     AI = "AI"

package/build/v1/message/schemas/attachment-source.enum.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AttachmentSource = void 0;
+/**
+ * Attachment source - who created the attachment
+ */
 var AttachmentSource;
 (function (AttachmentSource) {
     AttachmentSource["USER"] = "USER";

package/build/v1/message/schemas/attachment-source.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"attachment-source.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/attachment-source.enum.ts"],"names":[],"mappings":";;;AAGA,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IACxB,iCAAa,CAAA;IACb,6BAAS,CAAA;AACb,CAAC,EAHW,gBAAgB,gCAAhB,gBAAgB,QAG3B"}
+{"version":3,"file":"attachment-source.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/attachment-source.enum.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IACxB,iCAAa,CAAA;IACb,6BAAS,CAAA;AACb,CAAC,EAHW,gBAAgB,gCAAhB,gBAAgB,QAG3B"}

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

@@ -1,3 +1,6 @@
+/**
+ * Attachment status
+ */
 export declare enum AttachmentStatus {
     ACTIVE = "ACTIVE",
     DELETED = "DELETED"

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

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AttachmentStatus = void 0;
+/**
+ * Attachment status
+ */
 var AttachmentStatus;
 (function (AttachmentStatus) {
     AttachmentStatus["ACTIVE"] = "ACTIVE";

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

@@ -1 +1 @@
-{"version":3,"file":"attachment-status.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/attachment-status.enum.ts"],"names":[],"mappings":";;;AAGA,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IACxB,qCAAiB,CAAA;IACjB,uCAAmB,CAAA;AACvB,CAAC,EAHW,gBAAgB,gCAAhB,gBAAgB,QAG3B"}
+{"version":3,"file":"attachment-status.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/attachment-status.enum.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IACxB,qCAAiB,CAAA;IACjB,uCAAmB,CAAA;AACvB,CAAC,EAHW,gBAAgB,gCAAhB,gBAAgB,QAG3B"}

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

@@ -1,3 +1,6 @@
+/**
+ * Attachment type
+ */
 export declare enum AttachmentType {
     IMAGE = "IMAGE",
     AUDIO = "AUDIO",

package/build/v1/message/schemas/attachment-type.enum.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AttachmentType = void 0;
+/**
+ * Attachment type
+ */
 var AttachmentType;
 (function (AttachmentType) {
     AttachmentType["IMAGE"] = "IMAGE";

package/build/v1/message/schemas/attachment-type.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"attachment-type.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/attachment-type.enum.ts"],"names":[],"mappings":";;;AAGA,IAAY,cAKX;AALD,WAAY,cAAc;IACtB,iCAAe,CAAA;IACf,iCAAe,CAAA;IACf,iCAAe,CAAA;IACf,uCAAqB,CAAA;AACzB,CAAC,EALW,cAAc,8BAAd,cAAc,QAKzB"}
+{"version":3,"file":"attachment-type.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/attachment-type.enum.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,cAKX;AALD,WAAY,cAAc;IACtB,iCAAe,CAAA;IACf,iCAAe,CAAA;IACf,iCAAe,CAAA;IACf,uCAAqB,CAAA;AACzB,CAAC,EALW,cAAc,8BAAd,cAAc,QAKzB"}

package/build/v1/message/schemas/bash-chunk-stream.enum.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Which pipe a bash output line came from.
+ */
 export declare enum BashChunkStream {
     STDOUT = "STDOUT",
     STDERR = "STDERR"

package/build/v1/message/schemas/bash-chunk-stream.enum.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BashChunkStream = void 0;
+/**
+ * Which pipe a bash output line came from.
+ */
 var BashChunkStream;
 (function (BashChunkStream) {
     BashChunkStream["STDOUT"] = "STDOUT";

package/build/v1/message/schemas/bash-chunk-stream.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"bash-chunk-stream.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/bash-chunk-stream.enum.ts"],"names":[],"mappings":";;;AAGA,IAAY,eAGX;AAHD,WAAY,eAAe;IACvB,oCAAiB,CAAA;IACjB,oCAAiB,CAAA;AACrB,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B"}
+{"version":3,"file":"bash-chunk-stream.enum.js","sourceRoot":"","sources":["../../../../v1/message/schemas/bash-chunk-stream.enum.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,IAAY,eAGX;AAHD,WAAY,eAAe;IACvB,oCAAiB,CAAA;IACjB,oCAAiB,CAAA;AACrB,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B"}

package/build/v1/message/schemas/budget-promo-step-content.schema.d.ts

@@ -1,10 +1,30 @@
 import { z } from 'zod';
 import { GenerationStepType } from './generation-step-type.enum';
 import { CardCta, CardMessageKey } from './step-card.enums';
+/**
+ * What the BUDGET_PROMO step is announcing — and now it is only ever money.
+ *
+ *   DISCOUNT_APPLIED — the request finished but the wallet ran out mid-stream
+ *                      and we covered the gap. Reads as "we covered N tokens".
+ *
+ *   BUDGET_CUTOFF    — a heavy step (image gen / code exec) could not be funded
+ *                      and was skipped. Names the shortfall so the card can
+ *                      quote a concrete top-up.
+ *
+ * The access card and the truncation card used to live in this union too. They
+ * are their own step types now: neither has any token arithmetic to share with
+ * these two, and the only thing all four ever had in common was the slot they
+ * render in. A shared container made every reader check `kind` before knowing
+ * whether the card was about money at all.
+ */
 export declare enum BudgetPromoKind {
     DISCOUNT_APPLIED = "DISCOUNT_APPLIED",
     BUDGET_CUTOFF = "BUDGET_CUTOFF"
 }
+/**
+ * Soft-overflow case (Scenario A). Surfaces the discount amount so the card can
+ * read "we covered N tokens".
+ */
 export declare const BudgetPromoDiscountAppliedSchema: z.ZodObject<{
     cta: z.ZodEnum<typeof CardCta>;
     messageKey: z.ZodOptional<z.ZodEnum<typeof CardMessageKey>>;
@@ -13,6 +33,10 @@ export declare const BudgetPromoDiscountAppliedSchema: z.ZodObject<{
     chargedTokens: z.ZodNumber;
     requestedTokens: z.ZodNumber;
 }, z.core.$strip>;
+/**
+ * Hard-cutoff case (Scenario B). Names the step that could not run and the
+ * shortfall so the card can quote a concrete top-up amount.
+ */
 export declare const BudgetPromoBudgetCutoffSchema: z.ZodObject<{
     cta: z.ZodEnum<typeof CardCta>;
     messageKey: z.ZodOptional<z.ZodEnum<typeof CardMessageKey>>;
@@ -22,6 +46,14 @@ export declare const BudgetPromoBudgetCutoffSchema: z.ZodObject<{
     shortfallTokens: z.ZodNumber;
     suggestedTopupTokens: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
+/**
+ * Discriminated union — `kind` selects the variant. Persisted as
+ * `MessageStep.content` for the BUDGET_PROMO step type and surfaced over the
+ * message read API + stream events.
+ *
+ * `kind` survives here, unlike in the two split-out cards, because this union
+ * genuinely has two members: the step type alone does not say which.
+ */
 export declare const BudgetPromoStepContentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     cta: z.ZodEnum<typeof CardCta>;
     messageKey: z.ZodOptional<z.ZodEnum<typeof CardMessageKey>>;