@band-ai/rest-client 0.0.113 → 0.0.117

package/dist/cjs/api/resources/agentApiContacts/types/ListAgentContactRequestsResponse.d.ts

@@ -0,0 +1,35 @@
+import type * as Band from "../../../index.js";
+export interface ListAgentContactRequestsResponse {
+    data?: ListAgentContactRequestsResponse.Data | undefined;
+    /** Pagination metadata. Note: page_size applies per-direction, so response may contain up to 2×page_size items. */
+    metadata?: ListAgentContactRequestsResponse.Metadata | undefined;
+}
+export declare namespace ListAgentContactRequestsResponse {
+    interface Data {
+        received?: Band.ReceivedContactRequest[] | undefined;
+        sent?: Band.SentContactRequest[] | undefined;
+    }
+    /**
+     * Pagination metadata. Note: page_size applies per-direction, so response may contain up to 2×page_size items.
+     */
+    interface Metadata {
+        page: number;
+        page_size: number;
+        received: Metadata.Received;
+        sent: Metadata.Sent;
+    }
+    namespace Metadata {
+        interface Received {
+            /** Total count for this direction */
+            total: number;
+            /** Total pages for this direction */
+            total_pages: number;
+        }
+        interface Sent {
+            /** Total count for this direction */
+            total: number;
+            /** Total pages for this direction */
+            total_pages: number;
+        }
+    }
+}

package/dist/cjs/api/resources/agentApiContacts/types/ListAgentContactRequestsResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/agentApiContacts/types/ListAgentContactsResponse.d.ts

@@ -0,0 +1,13 @@
+import type * as Band from "../../../index.js";
+export interface ListAgentContactsResponse {
+    data?: Band.AgentContact[] | undefined;
+    metadata?: ListAgentContactsResponse.Metadata | undefined;
+}
+export declare namespace ListAgentContactsResponse {
+    interface Metadata {
+        page: number;
+        page_size: number;
+        total_count: number;
+        total_pages: number;
+    }
+}

package/dist/cjs/api/resources/agentApiContacts/types/ListAgentContactsResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/agentApiContacts/types/RemoveAgentContactResponse.d.ts

@@ -0,0 +1,8 @@
+export interface RemoveAgentContactResponse {
+    data?: RemoveAgentContactResponse.Data | undefined;
+}
+export declare namespace RemoveAgentContactResponse {
+    interface Data {
+        status: "removed";
+    }
+}

package/dist/cjs/api/resources/agentApiContacts/types/RemoveAgentContactResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/agentApiContacts/types/RespondToAgentContactRequestResponse.d.ts

@@ -0,0 +1,17 @@
+export interface RespondToAgentContactRequestResponse {
+    data?: RespondToAgentContactRequestResponse.Data | undefined;
+}
+export declare namespace RespondToAgentContactRequestResponse {
+    interface Data {
+        id: string;
+        status: Data.Status;
+    }
+    namespace Data {
+        const Status: {
+            readonly Approved: "approved";
+            readonly Rejected: "rejected";
+            readonly Cancelled: "cancelled";
+        };
+        type Status = (typeof Status)[keyof typeof Status];
+    }
+}

package/dist/cjs/api/resources/agentApiContacts/types/RespondToAgentContactRequestResponse.js

@@ -0,0 +1,15 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RespondToAgentContactRequestResponse = void 0;
+var RespondToAgentContactRequestResponse;
+(function (RespondToAgentContactRequestResponse) {
+    let Data;
+    (function (Data) {
+        Data.Status = {
+            Approved: "approved",
+            Rejected: "rejected",
+            Cancelled: "cancelled",
+        };
+    })(Data = RespondToAgentContactRequestResponse.Data || (RespondToAgentContactRequestResponse.Data = {}));
+})(RespondToAgentContactRequestResponse || (exports.RespondToAgentContactRequestResponse = RespondToAgentContactRequestResponse = {}));

package/dist/cjs/api/resources/agentApiContacts/types/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./AddAgentContactResponse.js";
+export * from "./ListAgentContactRequestsRequestSentStatus.js";
+export * from "./ListAgentContactRequestsResponse.js";
+export * from "./ListAgentContactsResponse.js";
+export * from "./RemoveAgentContactResponse.js";
+export * from "./RespondToAgentContactRequestResponse.js";

package/dist/cjs/api/resources/agentApiContacts/types/index.js

@@ -0,0 +1,22 @@
+"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("./AddAgentContactResponse.js"), exports);
+__exportStar(require("./ListAgentContactRequestsRequestSentStatus.js"), exports);
+__exportStar(require("./ListAgentContactRequestsResponse.js"), exports);
+__exportStar(require("./ListAgentContactsResponse.js"), exports);
+__exportStar(require("./RemoveAgentContactResponse.js"), exports);
+__exportStar(require("./RespondToAgentContactRequestResponse.js"), exports);

package/dist/cjs/api/resources/agentApiContext/client/Client.d.ts

@@ -0,0 +1,53 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.js";
+import * as core from "../../../../core/index.js";
+import * as Band from "../../../index.js";
+export declare namespace AgentApiContextClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+/**
+ * Load conversation context for LLM rehydration after reconnection or handoff.
+ */
+export declare class AgentApiContextClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<AgentApiContextClient.Options>;
+    constructor(options: AgentApiContextClient.Options);
+    /**
+     * Returns all messages relevant to the agent for execution context/rehydration.
+     *
+     * This includes:
+     * - All messages the agent sent (any type: text, tool_call, tool_result, thought, etc.)
+     * - All text messages that @mention the agent
+     *
+     * Use this endpoint to load the complete context an external agent needs to resume execution.
+     *
+     * 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`.
+     *
+     * `page` and `page_size` are deprecated and will be removed in API 2.0.0 (2026-10-01).
+     *
+     * @param {string} chat_id - Chat Room ID
+     * @param {Band.GetAgentChatContextRequest} request
+     * @param {AgentApiContextClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     * @throws {@link Band.NotFoundError}
+     * @throws {@link Band.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agentApiContext.getAgentChatContext("chat_id", {
+     *         cursor: "cursor",
+     *         limit: 1,
+     *         page: 1,
+     *         page_size: 1
+     *     })
+     */
+    getAgentChatContext(chat_id: string, request?: Band.GetAgentChatContextRequest, requestOptions?: AgentApiContextClient.RequestOptions): core.HttpResponsePromise<Band.GetAgentChatContextResponse>;
+    private __getAgentChatContext;
+}

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

@@ -0,0 +1,151 @@
+"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.AgentApiContextClient = 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"));
+/**
+ * Load conversation context for LLM rehydration after reconnection or handoff.
+ */
+class AgentApiContextClient {
+    constructor(options) {
+        this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
+    }
+    /**
+     * Returns all messages relevant to the agent for execution context/rehydration.
+     *
+     * This includes:
+     * - All messages the agent sent (any type: text, tool_call, tool_result, thought, etc.)
+     * - All text messages that @mention the agent
+     *
+     * Use this endpoint to load the complete context an external agent needs to resume execution.
+     *
+     * 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`.
+     *
+     * `page` and `page_size` are deprecated and will be removed in API 2.0.0 (2026-10-01).
+     *
+     * @param {string} chat_id - Chat Room ID
+     * @param {Band.GetAgentChatContextRequest} request
+     * @param {AgentApiContextClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     * @throws {@link Band.NotFoundError}
+     * @throws {@link Band.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agentApiContext.getAgentChatContext("chat_id", {
+     *         cursor: "cursor",
+     *         limit: 1,
+     *         page: 1,
+     *         page_size: 1
+     *     })
+     */
+    getAgentChatContext(chat_id, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getAgentChatContext(chat_id, request, requestOptions));
+    }
+    __getAgentChatContext(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 } = request;
+            const _queryParams = {
+                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)}/context`),
+                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}/context");
+        });
+    }
+}
+exports.AgentApiContextClient = AgentApiContextClient;

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

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

package/dist/cjs/api/resources/agentApiContext/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);

package/dist/cjs/api/resources/agentApiContext/client/requests/GetAgentChatContextRequest.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @example
+ *     {
+ *         cursor: "cursor",
+ *         limit: 1,
+ *         page: 1,
+ *         page_size: 1
+ *     }
+ */
+export interface GetAgentChatContextRequest {
+    /** Cursor for keyset pagination (from previous response next_cursor) */
+    cursor?: string;
+    /** Items per page for cursor pagination (default: 50, max: 100) */
+    limit?: number;
+    /** Page number (deprecated — use cursor instead) */
+    page?: number;
+    /** Items per page (deprecated — use limit instead) */
+    page_size?: number;
+}

package/dist/cjs/api/resources/agentApiContext/client/requests/GetAgentChatContextRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/agentApiContext/client/requests/index.d.ts

@@ -0,0 +1 @@
+export type { GetAgentChatContextRequest } from "./GetAgentChatContextRequest.js";

package/dist/cjs/api/resources/agentApiContext/client/requests/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/agentApiContext/exports.d.ts

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

package/dist/cjs/api/resources/agentApiContext/exports.js

@@ -0,0 +1,21 @@
+"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 __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 });
+exports.AgentApiContextClient = void 0;
+var Client_js_1 = require("./client/Client.js");
+Object.defineProperty(exports, "AgentApiContextClient", { enumerable: true, get: function () { return Client_js_1.AgentApiContextClient; } });
+__exportStar(require("./client/index.js"), exports);

package/dist/cjs/api/resources/agentApiContext/index.d.ts

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

package/dist/cjs/api/resources/agentApiContext/index.js

@@ -0,0 +1,18 @@
+"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("./client/index.js"), exports);
+__exportStar(require("./types/index.js"), exports);

package/dist/cjs/api/resources/agentApiContext/types/GetAgentChatContextResponse.d.ts

@@ -0,0 +1,37 @@
+import type * as Band from "../../../index.js";
+export interface GetAgentChatContextResponse {
+    data: Band.ChatMessage[];
+    /** Deprecated — use metadata instead */
+    meta?: GetAgentChatContextResponse.Meta | undefined;
+    metadata: GetAgentChatContextResponse.Metadata;
+}
+export declare namespace GetAgentChatContextResponse {
+    /**
+     * Deprecated — use metadata instead
+     */
+    interface Meta {
+        has_more?: boolean | undefined;
+        limit?: number | undefined;
+        next_cursor?: string | undefined;
+        page?: number | undefined;
+        page_size?: number | undefined;
+        total_count?: number | undefined;
+        total_pages?: number | undefined;
+    }
+    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 items (deprecated) */
+        total_count?: number | undefined;
+        /** Total pages (deprecated) */
+        total_pages?: number | undefined;
+    }
+}

package/dist/cjs/api/resources/agentApiContext/types/GetAgentChatContextResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/agentApiContext/types/index.d.ts

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

package/dist/cjs/api/resources/agentApiContext/types/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("./GetAgentChatContextResponse.js"), exports);

package/dist/cjs/api/resources/agentApiEvents/client/Client.d.ts

@@ -0,0 +1,49 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.js";
+import * as core from "../../../../core/index.js";
+import * as Band from "../../../index.js";
+export declare namespace AgentApiEventsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+/**
+ * Record agent events like tool calls, tool results, thoughts, and errors.
+ */
+export declare class AgentApiEventsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<AgentApiEventsClient.Options>;
+    constructor(options: AgentApiEventsClient.Options);
+    /**
+     * Creates a new event in a chat room.
+     *
+     * Events do NOT require mentions - they report what happened rather than directing messages
+     * at participants. Use this endpoint to record:
+     *
+     * - **tool_call**: When the agent invokes a tool
+     * - **tool_result**: The result returned from a tool execution
+     * - **thought**: Agent's internal reasoning or thinking process
+     * - **error**: Error messages and failure notifications
+     * - **task**: Task-related messages
+     *
+     * For text messages with mentions, use POST /agent/chats/{chat_id}/messages instead.
+     *
+     * @param {string} chat_id - Chat Room ID
+     * @param {Band.CreateAgentChatEventRequest} request
+     * @param {AgentApiEventsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     * @throws {@link Band.NotFoundError}
+     * @throws {@link Band.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.agentApiEvents.createAgentChatEvent("daca00d0-eb6b-4db1-8201-c46015c93d04", {
+     *         event: {
+     *             content: "Calling send_direct_message_service",
+     *             message_type: "tool_call"
+     *         }
+     *     })
+     */
+    createAgentChatEvent(chat_id: string, request: Band.CreateAgentChatEventRequest, requestOptions?: AgentApiEventsClient.RequestOptions): core.HttpResponsePromise<Band.CreateAgentChatEventResponse>;
+    private __createAgentChatEvent;
+}