@band-ai/rest-client 0.0.113 → 0.0.117

package/dist/cjs/api/resources/agentApiMessages/client/Client.js

@@ -0,0 +1,633 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentApiMessagesClient = void 0;
+const BaseClient_js_1 = require("../../../../BaseClient.js");
+const headers_js_1 = require("../../../../core/headers.js");
+const core = __importStar(require("../../../../core/index.js"));
+const environments = __importStar(require("../../../../environments.js"));
+const handleNonStatusCodeError_js_1 = require("../../../../errors/handleNonStatusCodeError.js");
+const errors = __importStar(require("../../../../errors/index.js"));
+const Band = __importStar(require("../../../index.js"));
+/**
+ * Send messages, poll for work, and manage message processing status.
+ */
+class AgentApiMessagesClient {
+    constructor(options) {
+        this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
+    }
+    /**
+     * Returns messages that the agent needs to process, filtered by status.
+     *
+     * ## Default Behavior (no status param)
+     *
+     * Returns all messages that are NOT processed. This is the recommended way to get
+     * all work the agent should handle, including:
+     * - New messages (no delivery status yet)
+     * - Delivered messages (acknowledged but not started)
+     * - Processing messages (stuck/crashed - supports crash recovery)
+     * - Failed messages (available for retry)
+     *
+     * ## Status Filter Reference
+     *
+     * | ?status=     | Returns                                                              | Use Case                    |
+     * |--------------|----------------------------------------------------------------------|-----------------------------|
+     * | *(no param)* | Everything NOT processed                                             | Get all work to do          |
+     * | `pending`    | No status, delivered, or failed without active attempt               | Queue depth (untouched)     |
+     * | `processing` | Currently being processed                                            | In-flight work              |
+     * | `processed`  | Successfully completed                                               | Done items                  |
+     * | `failed`     | Failed only                                                          | Failure backlog             |
+     * | `all`        | All messages regardless of status                                    | Full history                |
+     *
+     * Messages are returned in chronological order (oldest first).
+     *
+     * ## Pagination
+     *
+     * Use `cursor` + `limit` for cursor-based pagination (recommended). The response
+     * `metadata` includes `next_cursor` and `has_more`. Pass `cursor=<next_cursor>` to
+     * fetch the next page.
+     *
+     * `page` and `page_size` are deprecated and will be removed in API 2.0.0 (2026-10-01).
+     * Responses using these params include `Deprecation` and `Sunset` headers.
+     *
+     * ## Workflow
+     *
+     * After retrieving messages, you must update their processing status:
+     *
+     * 1. `GET /messages` or `GET /messages/next` → Get work to do
+     * 2. `POST /messages/{id}/processing` → **Required:** Mark as processing before you start
+     * 3. Process the message (reasoning loop, tool calls, etc.)
+     * 4. `POST /messages/{id}/processed` → Mark as done, OR
+     *    `POST /messages/{id}/failed` → Mark as failed with error message
+     * 5. Repeat
+     *
+     * **Important:** Always call `/processing` before starting work. This prevents
+     * duplicate processing since agents doing reasoning loops will always follow the
+     * sequence: `/next` → `/processing` → do work → `/processed`.
+     *
+     * ## Crash Recovery
+     *
+     * If your agent crashes while processing, the message remains in `processing` state.
+     * When the agent restarts:
+     * 1. Call `GET /messages` (default) - it includes stuck `processing` messages
+     * 2. The stuck message will be returned so you can retry it
+     * 3. Call `/processing` again to reset the attempt timestamp, then continue
+     *
+     * @param {string} chat_id - Chat Room ID
+     * @param {Band.ListAgentMessagesRequest} request
+     * @param {AgentApiMessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     * @throws {@link Band.NotFoundError}
+     * @throws {@link Band.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agentApiMessages.listAgentMessages("chat_id", {
+     *         status: "pending",
+     *         cursor: "cursor",
+     *         limit: 1,
+     *         page: 1,
+     *         page_size: 1
+     *     })
+     */
+    listAgentMessages(chat_id, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listAgentMessages(chat_id, request, requestOptions));
+    }
+    __listAgentMessages(chat_id_1) {
+        return __awaiter(this, arguments, void 0, function* (chat_id, request = {}, requestOptions) {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const { status, cursor, limit, page, page_size: pageSize } = request;
+            const _queryParams = {
+                status: status != null ? status : undefined,
+                cursor,
+                limit,
+                page,
+                page_size: pageSize,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BandEnvironment.Default, `api/v1/agent/chats/${core.url.encodePathParam(chat_id)}/messages`),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url
+                    .queryBuilder()
+                    .addMany(_queryParams)
+                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
+                    .build(),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Band.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Band.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Band.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new Band.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.BandError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/api/v1/agent/chats/{chat_id}/messages");
+        });
+    }
+    /**
+     * Creates a new text message in a chat room. The agent must be a participant in the room.
+     *
+     * This endpoint only supports `text` message type. For event-type messages
+     * (tool_call, tool_result, thought, system, error, action, guidelines, task),
+     * use `POST /agent/chats/{chat_id}/events` instead.
+     *
+     * Messages must include at least one @mention to ensure proper routing to recipients.
+     *
+     * Example request:
+     * ```json
+     * {
+     *   "message": {
+     *     "content": "@task.owner I have completed the analysis",
+     *     "mentions": [
+     *       {"id": "user-uuid", "handle": "task.owner", "name": "Task Owner"}
+     *     ]
+     *   }
+     * }
+     * ```
+     *
+     * @param {string} chat_id - Chat Room ID
+     * @param {Band.CreateAgentChatMessageRequest} request
+     * @param {AgentApiMessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     * @throws {@link Band.NotFoundError}
+     * @throws {@link Band.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agentApiMessages.createAgentChatMessage("chat_id", {
+     *         message: {
+     *             content: "@DataAnalyst please analyze the Q4 sales data",
+     *             mentions: [{
+     *                     id: "id"
+     *                 }]
+     *         }
+     *     })
+     */
+    createAgentChatMessage(chat_id, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__createAgentChatMessage(chat_id, request, requestOptions));
+    }
+    __createAgentChatMessage(chat_id, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BandEnvironment.Default, `api/v1/agent/chats/${core.url.encodePathParam(chat_id)}/messages`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                requestType: "json",
+                body: request,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Band.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Band.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Band.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new Band.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.BandError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/api/v1/agent/chats/{chat_id}/messages");
+        });
+    }
+    /**
+     * Returns the single oldest message that needs processing.
+     *
+     * ## What It Returns
+     *
+     * The oldest message that is NOT processed, including:
+     * - New messages (no delivery status yet)
+     * - Delivered messages (acknowledged but not started)
+     * - Processing messages (stuck/crashed - supports crash recovery)
+     * - Failed messages (available for retry)
+     *
+     * Returns **204 No Content** if there are no messages to process.
+     *
+     * ## Workflow
+     *
+     * This is the primary endpoint for agent reasoning loops:
+     *
+     * 1. `GET /messages/next` → Get next work item
+     * 2. `POST /messages/{id}/processing` → **Required:** Mark as processing
+     * 3. Process the message (reasoning loop, tool calls, etc.)
+     * 4. `POST /messages/{id}/processed` → Mark as done, OR
+     *    `POST /messages/{id}/failed` → Mark as failed with error message
+     * 5. Loop back to step 1
+     *
+     * ## Crash Recovery
+     *
+     * If your agent crashes while processing, the message stays in `processing` state.
+     * When restarted, calling `/next` will return that same stuck message (oldest first),
+     * allowing the agent to reclaim and retry it.
+     *
+     * ## Difference from GET /messages
+     *
+     * - `GET /messages` returns **all** actionable messages (for batch processing or queue inspection)
+     * - `GET /messages/next` returns **one** message (for sequential processing loops)
+     *
+     * Both use the same filter logic: everything that is NOT processed.
+     *
+     * @param {string} chat_id - Chat Room ID
+     * @param {AgentApiMessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     * @throws {@link Band.NotFoundError}
+     *
+     * @example
+     *     await client.agentApiMessages.getAgentNextMessage("chat_id")
+     */
+    getAgentNextMessage(chat_id, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getAgentNextMessage(chat_id, requestOptions));
+    }
+    __getAgentNextMessage(chat_id, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BandEnvironment.Default, `api/v1/agent/chats/${core.url.encodePathParam(chat_id)}/messages/next`),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Band.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Band.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Band.NotFoundError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.BandError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/api/v1/agent/chats/{chat_id}/messages/next");
+        });
+    }
+    /**
+     * Marks a message processing as failed by the agent. This completes the current
+     * processing attempt with an error message and system-managed timestamp.
+     *
+     * ## What It Does
+     *
+     * - Sets the current attempt's completed_at timestamp (system-managed)
+     * - Sets the current attempt status to "failed"
+     * - Records the error message in the current attempt
+     * - Updates the agent's delivery status to "failed"
+     *
+     * ## Requirements
+     *
+     * **Requires an active processing attempt.** You must call `/processing` first.
+     * Returns 422 if no processing attempt exists.
+     *
+     * ## After Calling
+     *
+     * Failed messages remain available for retry. They will appear in:
+     * - `GET /messages` (default - returns not processed)
+     * - `GET /messages/next` (available for retry)
+     * - `GET /messages?status=failed`
+     * - `GET /messages?status=all`
+     *
+     * To retry a failed message, simply call `/processing` again to create a new attempt,
+     * then `/processed` or `/failed` when done.
+     *
+     * @param {string} chat_id - Chat Room ID
+     * @param {string} id - Message ID
+     * @param {Band.MarkAgentMessageFailedRequest} request
+     * @param {AgentApiMessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     * @throws {@link Band.NotFoundError}
+     * @throws {@link Band.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agentApiMessages.markAgentMessageFailed("chat_id", "id", {
+     *         error: "error"
+     *     })
+     */
+    markAgentMessageFailed(chat_id, id, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__markAgentMessageFailed(chat_id, id, request, requestOptions));
+    }
+    __markAgentMessageFailed(chat_id, id, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BandEnvironment.Default, `api/v1/agent/chats/${core.url.encodePathParam(chat_id)}/messages/${core.url.encodePathParam(id)}/failed`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                requestType: "json",
+                body: request,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Band.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Band.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Band.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new Band.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.BandError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/api/v1/agent/chats/{chat_id}/messages/{id}/failed");
+        });
+    }
+    /**
+     * Marks a message as successfully processed by the agent. This completes the current
+     * processing attempt with a system-managed timestamp.
+     *
+     * ## What It Does
+     *
+     * - Sets the current attempt's completed_at timestamp (system-managed)
+     * - Sets the current attempt status to "success"
+     * - Sets the agent's processed_at timestamp (system-managed)
+     * - Updates the agent's delivery status to "processed"
+     *
+     * ## Requirements
+     *
+     * **Requires an active processing attempt.** You must call `/processing` first.
+     * Returns 422 if no processing attempt exists.
+     *
+     * ## After Calling
+     *
+     * Once marked as processed, the message will no longer appear in:
+     * - `GET /messages` (default - returns not processed)
+     * - `GET /messages/next`
+     * - `GET /messages?status=pending`
+     *
+     * It will only appear in:
+     * - `GET /messages?status=processed`
+     * - `GET /messages?status=all`
+     *
+     * @param {string} chat_id - Chat Room ID
+     * @param {string} id - Message ID
+     * @param {AgentApiMessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     * @throws {@link Band.NotFoundError}
+     * @throws {@link Band.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agentApiMessages.markAgentMessageProcessed("chat_id", "id")
+     */
+    markAgentMessageProcessed(chat_id, id, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__markAgentMessageProcessed(chat_id, id, requestOptions));
+    }
+    __markAgentMessageProcessed(chat_id, id, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BandEnvironment.Default, `api/v1/agent/chats/${core.url.encodePathParam(chat_id)}/messages/${core.url.encodePathParam(id)}/processed`),
+                method: "POST",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Band.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Band.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Band.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new Band.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.BandError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/api/v1/agent/chats/{chat_id}/messages/{id}/processed");
+        });
+    }
+    /**
+     * Marks a message as being processed by the agent. This creates a new processing attempt
+     * with a system-managed timestamp. The agent must be a participant in the chat room.
+     *
+     * ## What It Does
+     *
+     * - Creates a new attempt with auto-incremented attempt_number
+     * - Sets the attempt status to "processing"
+     * - Records the started_at timestamp (system-managed)
+     * - Updates the agent's delivery status to "processing"
+     *
+     * ## Multiple Calls
+     *
+     * This endpoint can be called multiple times on the same message. Each call creates
+     * a **new attempt**. This is intentional for crash recovery:
+     *
+     * 1. Agent calls `/processing` (attempt 1)
+     * 2. Agent crashes while processing
+     * 3. Agent restarts, calls `/next`, gets the same message back
+     * 4. Agent calls `/processing` again (attempt 2)
+     * 5. Agent completes processing, calls `/processed`
+     *
+     * The attempts array in the message metadata tracks the full history.
+     *
+     * ## Workflow
+     *
+     * Always call this endpoint before starting work on a message:
+     *
+     * 1. `GET /messages/next` → Get message
+     * 2. `POST /messages/{id}/processing` → **This endpoint**
+     * 3. Process the message
+     * 4. `POST /messages/{id}/processed` or `/failed`
+     *
+     * @param {string} chat_id - Chat Room ID
+     * @param {string} id - Message ID
+     * @param {AgentApiMessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     * @throws {@link Band.NotFoundError}
+     * @throws {@link Band.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agentApiMessages.markAgentMessageProcessing("chat_id", "id")
+     */
+    markAgentMessageProcessing(chat_id, id, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__markAgentMessageProcessing(chat_id, id, requestOptions));
+    }
+    __markAgentMessageProcessing(chat_id, id, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.BandEnvironment.Default, `api/v1/agent/chats/${core.url.encodePathParam(chat_id)}/messages/${core.url.encodePathParam(id)}/processing`),
+                method: "POST",
+                headers: _headers,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new Band.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Band.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Band.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new Band.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.BandError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/api/v1/agent/chats/{chat_id}/messages/{id}/processing");
+        });
+    }
+}
+exports.AgentApiMessagesClient = AgentApiMessagesClient;

package/dist/cjs/api/resources/agentApiMessages/client/index.d.ts

@@ -0,0 +1 @@
+export * from "./requests/index.js";

package/dist/cjs/api/resources/agentApiMessages/client/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./requests/index.js"), exports);