@band-ai/rest-client 0.0.113 → 0.0.118

package/dist/esm/api/resources/humanApiMessages/client/Client.mjs

@@ -0,0 +1,200 @@
+// This file was auto-generated by Fern from our API Definition.
+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());
+    });
+};
+import { normalizeClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import { mergeHeaders } from "../../../../core/headers.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as environments from "../../../../environments.mjs";
+import { handleNonStatusCodeError } from "../../../../errors/handleNonStatusCodeError.mjs";
+import * as errors from "../../../../errors/index.mjs";
+import * as Band from "../../../index.mjs";
+/**
+ * Send and receive messages in chat rooms.
+ */
+export class HumanApiMessagesClient {
+    constructor(options) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+    /**
+     * Returns a paginated list of ALL messages in a chat room where you are a participant.
+     *
+     * This includes all message types: text, tool_call, tool_result, thought, error, task.
+     * Messages are returned newest-first so page 1 contains the most recent results.
+     * Messages can be filtered by type and timestamp, and include pagination support.
+     *
+     * Use the `message_type` parameter to filter by specific type(s).
+     *
+     * ## Pagination
+     *
+     * Use `cursor` + `limit` for cursor-based pagination (recommended). The response
+     * `metadata` includes `next_cursor` and `has_more`.
+     *
+     * Note: `since` and `cursor` cannot be combined. Use one or the other.
+     *
+     * `page` and `page_size` are deprecated and will be removed in API 2.0.0 (2026-10-01).
+     *
+     * Returns 404 if the chat room doesn't exist or you're not a participant (security-first: doesn't leak room existence).
+     *
+     * @param {string} chat_id - Chat Room ID
+     * @param {Band.ListMyChatMessagesRequest} request
+     * @param {HumanApiMessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.NotFoundError}
+     * @throws {@link Band.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.humanApiMessages.listMyChatMessages("daca00d0-eb6b-4db1-8201-c46015c93d04", {
+     *         cursor: "cursor",
+     *         limit: 1,
+     *         page: 1,
+     *         page_size: 1,
+     *         message_type: "text",
+     *         since: "2025-10-14T15:00:00Z"
+     *     })
+     */
+    listMyChatMessages(chat_id, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listMyChatMessages(chat_id, request, requestOptions));
+    }
+    __listMyChatMessages(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 { cursor, limit, page, page_size: pageSize, message_type: messageType, since } = request;
+            const _queryParams = {
+                cursor,
+                limit,
+                page,
+                page_size: pageSize,
+                message_type: messageType != null ? messageType : undefined,
+                since: since != null ? since : undefined,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = 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/me/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 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 handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/v1/me/chats/{chat_id}/messages");
+        });
+    }
+    /**
+     * Creates a new text message in a chat room. The user 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 /me/chats/{chat_id}/events` instead.
+     *
+     * Messages must include at least one @mention to ensure proper routing to recipients.
+     *
+     * Example request:
+     * ```json
+     * {
+     *   "message": {
+     *     "content": "@agent.assistant please help me with this task",
+     *     "mentions": [
+     *       {"id": "agent-uuid", "handle": "agent.assistant", "name": "Agent Assistant"}
+     *     ]
+     *   }
+     * }
+     * ```
+     *
+     * @param {string} chat_id - Chat Room ID
+     * @param {Band.SendMyChatMessageRequest} request
+     * @param {HumanApiMessagesClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.NotFoundError}
+     * @throws {@link Band.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.humanApiMessages.sendMyChatMessage("daca00d0-eb6b-4db1-8201-c46015c93d04", {
+     *         message: {
+     *             content: "@DataAnalyst please analyze the Q4 sales data",
+     *             mentions: [{
+     *                     id: "id"
+     *                 }]
+     *         }
+     *     })
+     */
+    sendMyChatMessage(chat_id, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__sendMyChatMessage(chat_id, request, requestOptions));
+    }
+    __sendMyChatMessage(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 = 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/me/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 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 handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/api/v1/me/chats/{chat_id}/messages");
+        });
+    }
+}

package/dist/esm/api/resources/humanApiMessages/client/index.d.mts

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

package/dist/esm/api/resources/humanApiMessages/client/index.mjs

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

package/dist/esm/api/resources/humanApiMessages/client/requests/ListMyChatMessagesRequest.d.mts

@@ -0,0 +1,26 @@
+import type * as Band from "../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         cursor: "cursor",
+ *         limit: 1,
+ *         page: 1,
+ *         page_size: 1,
+ *         message_type: "text",
+ *         since: "2025-10-14T15:00:00Z"
+ *     }
+ */
+export interface ListMyChatMessagesRequest {
+    /** Cursor for keyset pagination (from previous response next_cursor) */
+    cursor?: string;
+    /** Items per page for cursor pagination (default: 20, max: 100) */
+    limit?: number;
+    /** Page number (deprecated — use cursor) */
+    page?: number;
+    /** Items per page (deprecated — use limit) */
+    page_size?: number;
+    /** Filter by message type (text, tool_call, tool_result, thought, error, task) */
+    message_type?: Band.ListMyChatMessagesRequestMessageType;
+    /** Filter messages after this timestamp (cannot be combined with cursor) */
+    since?: string;
+}

package/dist/esm/api/resources/humanApiMessages/client/requests/ListMyChatMessagesRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/humanApiMessages/client/requests/SendMyChatMessageRequest.d.mts

@@ -0,0 +1,15 @@
+import type * as Band from "../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         message: {
+ *             content: "@DataAnalyst please analyze the Q4 sales data",
+ *             mentions: [{
+ *                     id: "id"
+ *                 }]
+ *         }
+ *     }
+ */
+export interface SendMyChatMessageRequest {
+    message: Band.ChatMessageRequest;
+}

package/dist/esm/api/resources/humanApiMessages/client/requests/SendMyChatMessageRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/humanApiMessages/client/requests/index.d.mts

@@ -0,0 +1,2 @@
+export type { ListMyChatMessagesRequest } from "./ListMyChatMessagesRequest.mjs";
+export type { SendMyChatMessageRequest } from "./SendMyChatMessageRequest.mjs";

package/dist/esm/api/resources/humanApiMessages/client/requests/index.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/resources/humanApiMessages/exports.d.mts

@@ -0,0 +1,2 @@
+export { HumanApiMessagesClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/humanApiMessages/exports.mjs

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+export { HumanApiMessagesClient } from "./client/Client.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/humanApiMessages/index.d.mts

@@ -0,0 +1,2 @@
+export * from "./client/index.mjs";
+export * from "./types/index.mjs";

package/dist/esm/api/resources/humanApiMessages/index.mjs

@@ -0,0 +1,2 @@
+export * from "./client/index.mjs";
+export * from "./types/index.mjs";

package/dist/esm/api/resources/humanApiMessages/types/ListMyChatMessagesRequestMessageType.d.mts

@@ -0,0 +1,10 @@
+/** Filter by message type */
+export declare const ListMyChatMessagesRequestMessageType: {
+    readonly Text: "text";
+    readonly ToolCall: "tool_call";
+    readonly ToolResult: "tool_result";
+    readonly Thought: "thought";
+    readonly Error: "error";
+    readonly Task: "task";
+};
+export type ListMyChatMessagesRequestMessageType = (typeof ListMyChatMessagesRequestMessageType)[keyof typeof ListMyChatMessagesRequestMessageType];

package/dist/esm/api/resources/humanApiMessages/types/ListMyChatMessagesRequestMessageType.mjs

@@ -0,0 +1,10 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Filter by message type */
+export const ListMyChatMessagesRequestMessageType = {
+    Text: "text",
+    ToolCall: "tool_call",
+    ToolResult: "tool_result",
+    Thought: "thought",
+    Error: "error",
+    Task: "task",
+};

package/dist/esm/api/resources/humanApiMessages/types/ListMyChatMessagesResponse.d.mts

@@ -0,0 +1,23 @@
+import type * as Band from "../../../index.mjs";
+export interface ListMyChatMessagesResponse {
+    data: Band.ChatMessage[];
+    metadata: ListMyChatMessagesResponse.Metadata;
+}
+export declare namespace ListMyChatMessagesResponse {
+    interface Metadata {
+        /** Whether more pages exist */
+        has_more: boolean;
+        /** Page size used */
+        limit: number;
+        /** Cursor for next page */
+        next_cursor?: string | undefined;
+        /** Current page (deprecated) */
+        page?: number | undefined;
+        /** Items per page (deprecated) */
+        page_size?: number | undefined;
+        /** Total messages (deprecated) */
+        total_count?: number | undefined;
+        /** Total pages (deprecated) */
+        total_pages?: number | undefined;
+    }
+}

package/dist/esm/api/resources/humanApiMessages/types/ListMyChatMessagesResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/humanApiMessages/types/SendMyChatMessageResponse.d.mts

@@ -0,0 +1,4 @@
+import type * as Band from "../../../index.mjs";
+export interface SendMyChatMessageResponse {
+    data: Band.MessageSentResponse;
+}

package/dist/esm/api/resources/humanApiMessages/types/SendMyChatMessageResponse.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/humanApiMessages/types/index.d.mts

@@ -0,0 +1,3 @@
+export * from "./ListMyChatMessagesRequestMessageType.mjs";
+export * from "./ListMyChatMessagesResponse.mjs";
+export * from "./SendMyChatMessageResponse.mjs";

package/dist/esm/api/resources/humanApiMessages/types/index.mjs

@@ -0,0 +1,3 @@
+export * from "./ListMyChatMessagesRequestMessageType.mjs";
+export * from "./ListMyChatMessagesResponse.mjs";
+export * from "./SendMyChatMessageResponse.mjs";

package/dist/esm/api/resources/humanApiParticipants/client/Client.d.mts

@@ -0,0 +1,84 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.mjs";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as Band from "../../../index.mjs";
+export declare namespace HumanApiParticipantsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+/**
+ * Manage chat room participants as a human user.
+ */
+export declare class HumanApiParticipantsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<HumanApiParticipantsClient.Options>;
+    constructor(options: HumanApiParticipantsClient.Options);
+    /**
+     * Removes a participant from a chat room where you have permission to remove participants.
+     *
+     * Requires owner or admin role in the chat room.
+     *
+     * @param {string} chat_id - Chat Room ID
+     * @param {string} id - Participant ID
+     * @param {HumanApiParticipantsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     * @throws {@link Band.NotFoundError}
+     *
+     * @example
+     *     await client.humanApiParticipants.removeMyChatParticipant("daca00d0-eb6b-4db1-8201-c46015c93d04", "3af67556-0466-4437-9a92-7d7566796457")
+     */
+    removeMyChatParticipant(chat_id: string, id: string, requestOptions?: HumanApiParticipantsClient.RequestOptions): core.HttpResponsePromise<Band.RemoveMyChatParticipantResponse>;
+    private __removeMyChatParticipant;
+    /**
+     * Returns a list of participants in a chat room where you are a participant.
+     *
+     * Returns 404 if the chat room doesn't exist or you're not a participant
+     * (security-first: doesn't leak room existence).
+     *
+     * @param {string} chat_id - Chat Room ID
+     * @param {Band.ListMyChatParticipantsRequest} request
+     * @param {HumanApiParticipantsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     * @throws {@link Band.NotFoundError}
+     *
+     * @example
+     *     await client.humanApiParticipants.listMyChatParticipants("daca00d0-eb6b-4db1-8201-c46015c93d04", {
+     *         participant_type: "User",
+     *         cursor: "cursor",
+     *         limit: 1,
+     *         page: 1,
+     *         page_size: 1
+     *     })
+     */
+    listMyChatParticipants(chat_id: string, request?: Band.ListMyChatParticipantsRequest, requestOptions?: HumanApiParticipantsClient.RequestOptions): core.HttpResponsePromise<Band.ListMyChatParticipantsResponse>;
+    private __listMyChatParticipants;
+    /**
+     * Adds a new participant to a chat room where you have permission to add participants.
+     *
+     * You can add:
+     * - Your own agents
+     * - Global agents
+     *
+     * @param {string} chat_id - Chat Room ID
+     * @param {Band.AddMyChatParticipantRequest} request
+     * @param {HumanApiParticipantsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     * @throws {@link Band.NotFoundError}
+     * @throws {@link Band.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.humanApiParticipants.addMyChatParticipant("daca00d0-eb6b-4db1-8201-c46015c93d04", {
+     *         participant: {
+     *             participant_id: "participant_id"
+     *         }
+     *     })
+     */
+    addMyChatParticipant(chat_id: string, request: Band.AddMyChatParticipantRequest, requestOptions?: HumanApiParticipantsClient.RequestOptions): core.HttpResponsePromise<Band.AddMyChatParticipantResponse>;
+    private __addMyChatParticipant;
+}