@band-ai/rest-client 0.0.117 → 0.0.118

package/README.md

@@ -44,8 +44,8 @@ Instantiate and use the client with the following:
 import { BandClient } from "@band-ai/rest-client";
 
 const client = new BandClient({ apiKey: "YOUR_API_KEY" });
-await client.agentApiChats.createAgentChat({
-    chat: {}
+await client.agentApiContacts.respondToAgentContactRequest({
+    action: "approve"
 });
 ```
 
@@ -69,7 +69,7 @@ following namespace:
 ```typescript
 import { Band } from "@band-ai/rest-client";
 
-const request: Band.ListAgentChatsRequest = {
+const request: Band.RespondToAgentContactRequestRequest = {
     ...
 };
 ```
@@ -83,7 +83,7 @@ will be thrown.
 import { BandError } from "@band-ai/rest-client";
 
 try {
-    await client.agentApiChats.createAgentChat(...);
+    await client.agentApiContacts.respondToAgentContactRequest(...);
 } catch (err) {
     if (err instanceof BandError) {
         console.log(err.statusCode);
@@ -101,9 +101,9 @@ try {
 This SDK supports direct imports of subpackage clients, which allows JavaScript bundlers to tree-shake and include only the imported subpackage code. This results in much smaller bundle sizes.
 
 ```typescript
-import { AgentApiChatsClient } from '@band-ai/rest-client/agentApiChats';
+import { AgentApiContactsClient } from '@band-ai/rest-client/agentApiContacts';
 
-const client = new AgentApiChatsClient({...});
+const client = new AgentApiContactsClient({...});
 ```
 
 ### Additional Headers
@@ -120,7 +120,7 @@ const client = new BandClient({
     }
 });
 
-const response = await client.agentApiChats.createAgentChat(..., {
+const response = await client.agentApiContacts.respondToAgentContactRequest(..., {
     headers: {
         'X-Custom-Header': 'custom value'
     }
@@ -132,7 +132,7 @@ const response = await client.agentApiChats.createAgentChat(..., {
 If you would like to send additional query string parameters as part of the request, use the `queryParams` request option.
 
 ```typescript
-const response = await client.agentApiChats.createAgentChat(..., {
+const response = await client.agentApiContacts.respondToAgentContactRequest(..., {
     queryParams: {
         'customQueryParamKey': 'custom query param value'
     }
@@ -162,7 +162,7 @@ Which status codes are retried depends on the `retryStatusCodes` generator confi
 Use the `maxRetries` request option to configure this behavior.
 
 ```typescript
-const response = await client.agentApiChats.createAgentChat(..., {
+const response = await client.agentApiContacts.respondToAgentContactRequest(..., {
     maxRetries: 0 // override maxRetries at the request level
 });
 ```
@@ -172,7 +172,7 @@ const response = await client.agentApiChats.createAgentChat(..., {
 The SDK defaults to a 60 second timeout. Use the `timeoutInSeconds` option to configure this behavior.
 
 ```typescript
-const response = await client.agentApiChats.createAgentChat(..., {
+const response = await client.agentApiContacts.respondToAgentContactRequest(..., {
     timeoutInSeconds: 30 // override timeout to 30s
 });
 ```
@@ -183,7 +183,7 @@ The SDK allows users to abort requests at any point by passing in an abort signa
 
 ```typescript
 const controller = new AbortController();
-const response = await client.agentApiChats.createAgentChat(..., {
+const response = await client.agentApiContacts.respondToAgentContactRequest(..., {
     abortSignal: controller.signal
 });
 controller.abort(); // aborts the request
@@ -195,7 +195,7 @@ The SDK provides access to raw response data, including headers, through the `.w
 The `.withRawResponse()` method returns a promise that results to an object with a `data` and a `rawResponse` property.
 
 ```typescript
-const { data, rawResponse } = await client.agentApiChats.createAgentChat(...).withRawResponse();
+const { data, rawResponse } = await client.agentApiContacts.respondToAgentContactRequest(...).withRawResponse();
 
 console.log(data);
 console.log(rawResponse.headers['X-My-Header']);

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@band-ai/rest-client",
-        "X-Fern-SDK-Version": "0.0.117",
-        "User-Agent": "@band-ai/rest-client/0.0.117",
+        "X-Fern-SDK-Version": "0.0.118",
+        "User-Agent": "@band-ai/rest-client/0.0.118",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/Client.d.ts

@@ -1,3 +1,4 @@
+import { AgentApiActivityClient } from "./api/resources/agentApiActivity/client/Client.js";
 import { AgentApiChatsClient } from "./api/resources/agentApiChats/client/Client.js";
 import { AgentApiContactsClient } from "./api/resources/agentApiContacts/client/Client.js";
 import { AgentApiContextClient } from "./api/resources/agentApiContext/client/Client.js";
@@ -7,6 +8,14 @@ import { AgentApiMemoriesClient } from "./api/resources/agentApiMemories/client/
 import { AgentApiMessagesClient } from "./api/resources/agentApiMessages/client/Client.js";
 import { AgentApiParticipantsClient } from "./api/resources/agentApiParticipants/client/Client.js";
 import { AgentApiPeersClient } from "./api/resources/agentApiPeers/client/Client.js";
+import { HumanApiAgentsClient } from "./api/resources/humanApiAgents/client/Client.js";
+import { HumanApiChatsClient } from "./api/resources/humanApiChats/client/Client.js";
+import { HumanApiContactsClient } from "./api/resources/humanApiContacts/client/Client.js";
+import { HumanApiMemoriesClient } from "./api/resources/humanApiMemories/client/Client.js";
+import { HumanApiMessagesClient } from "./api/resources/humanApiMessages/client/Client.js";
+import { HumanApiParticipantsClient } from "./api/resources/humanApiParticipants/client/Client.js";
+import { HumanApiPeersClient } from "./api/resources/humanApiPeers/client/Client.js";
+import { HumanApiProfileClient } from "./api/resources/humanApiProfile/client/Client.js";
 import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
 import { type NormalizedClientOptionsWithAuth } from "./BaseClient.js";
 import * as core from "./core/index.js";
@@ -17,25 +26,43 @@ export declare namespace BandClient {
 }
 export declare class BandClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<BandClient.Options>;
-    protected _agentApiChats: AgentApiChatsClient | undefined;
-    protected _agentApiContext: AgentApiContextClient | undefined;
-    protected _agentApiEvents: AgentApiEventsClient | undefined;
-    protected _agentApiMessages: AgentApiMessagesClient | undefined;
-    protected _agentApiParticipants: AgentApiParticipantsClient | undefined;
     protected _agentApiContacts: AgentApiContactsClient | undefined;
-    protected _agentApiIdentity: AgentApiIdentityClient | undefined;
+    protected _humanApiContacts: HumanApiContactsClient | undefined;
+    protected _humanApiMemories: HumanApiMemoriesClient | undefined;
+    protected _humanApiChats: HumanApiChatsClient | undefined;
+    protected _agentApiMessages: AgentApiMessagesClient | undefined;
     protected _agentApiMemories: AgentApiMemoriesClient | undefined;
     protected _agentApiPeers: AgentApiPeersClient | undefined;
+    protected _humanApiPeers: HumanApiPeersClient | undefined;
+    protected _humanApiMessages: HumanApiMessagesClient | undefined;
+    protected _agentApiEvents: AgentApiEventsClient | undefined;
+    protected _humanApiAgents: HumanApiAgentsClient | undefined;
+    protected _humanApiParticipants: HumanApiParticipantsClient | undefined;
+    protected _agentApiIdentity: AgentApiIdentityClient | undefined;
+    protected _agentApiParticipants: AgentApiParticipantsClient | undefined;
+    protected _agentApiContext: AgentApiContextClient | undefined;
+    protected _agentApiChats: AgentApiChatsClient | undefined;
+    protected _humanApiProfile: HumanApiProfileClient | undefined;
+    protected _agentApiActivity: AgentApiActivityClient | undefined;
     constructor(options: BandClient.Options);
-    get agentApiChats(): AgentApiChatsClient;
-    get agentApiContext(): AgentApiContextClient;
-    get agentApiEvents(): AgentApiEventsClient;
-    get agentApiMessages(): AgentApiMessagesClient;
-    get agentApiParticipants(): AgentApiParticipantsClient;
     get agentApiContacts(): AgentApiContactsClient;
-    get agentApiIdentity(): AgentApiIdentityClient;
+    get humanApiContacts(): HumanApiContactsClient;
+    get humanApiMemories(): HumanApiMemoriesClient;
+    get humanApiChats(): HumanApiChatsClient;
+    get agentApiMessages(): AgentApiMessagesClient;
     get agentApiMemories(): AgentApiMemoriesClient;
     get agentApiPeers(): AgentApiPeersClient;
+    get humanApiPeers(): HumanApiPeersClient;
+    get humanApiMessages(): HumanApiMessagesClient;
+    get agentApiEvents(): AgentApiEventsClient;
+    get humanApiAgents(): HumanApiAgentsClient;
+    get humanApiParticipants(): HumanApiParticipantsClient;
+    get agentApiIdentity(): AgentApiIdentityClient;
+    get agentApiParticipants(): AgentApiParticipantsClient;
+    get agentApiContext(): AgentApiContextClient;
+    get agentApiChats(): AgentApiChatsClient;
+    get humanApiProfile(): HumanApiProfileClient;
+    get agentApiActivity(): AgentApiActivityClient;
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
      * This is useful for making requests to endpoints not yet supported in the SDK.

package/dist/cjs/Client.js

@@ -44,56 +44,101 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BandClient = void 0;
-const Client_js_1 = require("./api/resources/agentApiChats/client/Client.js");
-const Client_js_2 = require("./api/resources/agentApiContacts/client/Client.js");
-const Client_js_3 = require("./api/resources/agentApiContext/client/Client.js");
-const Client_js_4 = require("./api/resources/agentApiEvents/client/Client.js");
-const Client_js_5 = require("./api/resources/agentApiIdentity/client/Client.js");
-const Client_js_6 = require("./api/resources/agentApiMemories/client/Client.js");
-const Client_js_7 = require("./api/resources/agentApiMessages/client/Client.js");
-const Client_js_8 = require("./api/resources/agentApiParticipants/client/Client.js");
-const Client_js_9 = require("./api/resources/agentApiPeers/client/Client.js");
+const Client_js_1 = require("./api/resources/agentApiActivity/client/Client.js");
+const Client_js_2 = require("./api/resources/agentApiChats/client/Client.js");
+const Client_js_3 = require("./api/resources/agentApiContacts/client/Client.js");
+const Client_js_4 = require("./api/resources/agentApiContext/client/Client.js");
+const Client_js_5 = require("./api/resources/agentApiEvents/client/Client.js");
+const Client_js_6 = require("./api/resources/agentApiIdentity/client/Client.js");
+const Client_js_7 = require("./api/resources/agentApiMemories/client/Client.js");
+const Client_js_8 = require("./api/resources/agentApiMessages/client/Client.js");
+const Client_js_9 = require("./api/resources/agentApiParticipants/client/Client.js");
+const Client_js_10 = require("./api/resources/agentApiPeers/client/Client.js");
+const Client_js_11 = require("./api/resources/humanApiAgents/client/Client.js");
+const Client_js_12 = require("./api/resources/humanApiChats/client/Client.js");
+const Client_js_13 = require("./api/resources/humanApiContacts/client/Client.js");
+const Client_js_14 = require("./api/resources/humanApiMemories/client/Client.js");
+const Client_js_15 = require("./api/resources/humanApiMessages/client/Client.js");
+const Client_js_16 = require("./api/resources/humanApiParticipants/client/Client.js");
+const Client_js_17 = require("./api/resources/humanApiPeers/client/Client.js");
+const Client_js_18 = require("./api/resources/humanApiProfile/client/Client.js");
 const BaseClient_js_1 = require("./BaseClient.js");
 const core = __importStar(require("./core/index.js"));
 class BandClient {
     constructor(options) {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
-    get agentApiChats() {
+    get agentApiContacts() {
         var _a;
-        return ((_a = this._agentApiChats) !== null && _a !== void 0 ? _a : (this._agentApiChats = new Client_js_1.AgentApiChatsClient(this._options)));
+        return ((_a = this._agentApiContacts) !== null && _a !== void 0 ? _a : (this._agentApiContacts = new Client_js_3.AgentApiContactsClient(this._options)));
     }
-    get agentApiContext() {
+    get humanApiContacts() {
         var _a;
-        return ((_a = this._agentApiContext) !== null && _a !== void 0 ? _a : (this._agentApiContext = new Client_js_3.AgentApiContextClient(this._options)));
+        return ((_a = this._humanApiContacts) !== null && _a !== void 0 ? _a : (this._humanApiContacts = new Client_js_13.HumanApiContactsClient(this._options)));
     }
-    get agentApiEvents() {
+    get humanApiMemories() {
         var _a;
-        return ((_a = this._agentApiEvents) !== null && _a !== void 0 ? _a : (this._agentApiEvents = new Client_js_4.AgentApiEventsClient(this._options)));
+        return ((_a = this._humanApiMemories) !== null && _a !== void 0 ? _a : (this._humanApiMemories = new Client_js_14.HumanApiMemoriesClient(this._options)));
+    }
+    get humanApiChats() {
+        var _a;
+        return ((_a = this._humanApiChats) !== null && _a !== void 0 ? _a : (this._humanApiChats = new Client_js_12.HumanApiChatsClient(this._options)));
     }
     get agentApiMessages() {
         var _a;
-        return ((_a = this._agentApiMessages) !== null && _a !== void 0 ? _a : (this._agentApiMessages = new Client_js_7.AgentApiMessagesClient(this._options)));
+        return ((_a = this._agentApiMessages) !== null && _a !== void 0 ? _a : (this._agentApiMessages = new Client_js_8.AgentApiMessagesClient(this._options)));
     }
-    get agentApiParticipants() {
+    get agentApiMemories() {
         var _a;
-        return ((_a = this._agentApiParticipants) !== null && _a !== void 0 ? _a : (this._agentApiParticipants = new Client_js_8.AgentApiParticipantsClient(this._options)));
+        return ((_a = this._agentApiMemories) !== null && _a !== void 0 ? _a : (this._agentApiMemories = new Client_js_7.AgentApiMemoriesClient(this._options)));
     }
-    get agentApiContacts() {
+    get agentApiPeers() {
+        var _a;
+        return ((_a = this._agentApiPeers) !== null && _a !== void 0 ? _a : (this._agentApiPeers = new Client_js_10.AgentApiPeersClient(this._options)));
+    }
+    get humanApiPeers() {
+        var _a;
+        return ((_a = this._humanApiPeers) !== null && _a !== void 0 ? _a : (this._humanApiPeers = new Client_js_17.HumanApiPeersClient(this._options)));
+    }
+    get humanApiMessages() {
+        var _a;
+        return ((_a = this._humanApiMessages) !== null && _a !== void 0 ? _a : (this._humanApiMessages = new Client_js_15.HumanApiMessagesClient(this._options)));
+    }
+    get agentApiEvents() {
+        var _a;
+        return ((_a = this._agentApiEvents) !== null && _a !== void 0 ? _a : (this._agentApiEvents = new Client_js_5.AgentApiEventsClient(this._options)));
+    }
+    get humanApiAgents() {
+        var _a;
+        return ((_a = this._humanApiAgents) !== null && _a !== void 0 ? _a : (this._humanApiAgents = new Client_js_11.HumanApiAgentsClient(this._options)));
+    }
+    get humanApiParticipants() {
         var _a;
-        return ((_a = this._agentApiContacts) !== null && _a !== void 0 ? _a : (this._agentApiContacts = new Client_js_2.AgentApiContactsClient(this._options)));
+        return ((_a = this._humanApiParticipants) !== null && _a !== void 0 ? _a : (this._humanApiParticipants = new Client_js_16.HumanApiParticipantsClient(this._options)));
     }
     get agentApiIdentity() {
         var _a;
-        return ((_a = this._agentApiIdentity) !== null && _a !== void 0 ? _a : (this._agentApiIdentity = new Client_js_5.AgentApiIdentityClient(this._options)));
+        return ((_a = this._agentApiIdentity) !== null && _a !== void 0 ? _a : (this._agentApiIdentity = new Client_js_6.AgentApiIdentityClient(this._options)));
     }
-    get agentApiMemories() {
+    get agentApiParticipants() {
         var _a;
-        return ((_a = this._agentApiMemories) !== null && _a !== void 0 ? _a : (this._agentApiMemories = new Client_js_6.AgentApiMemoriesClient(this._options)));
+        return ((_a = this._agentApiParticipants) !== null && _a !== void 0 ? _a : (this._agentApiParticipants = new Client_js_9.AgentApiParticipantsClient(this._options)));
     }
-    get agentApiPeers() {
+    get agentApiContext() {
+        var _a;
+        return ((_a = this._agentApiContext) !== null && _a !== void 0 ? _a : (this._agentApiContext = new Client_js_4.AgentApiContextClient(this._options)));
+    }
+    get agentApiChats() {
+        var _a;
+        return ((_a = this._agentApiChats) !== null && _a !== void 0 ? _a : (this._agentApiChats = new Client_js_2.AgentApiChatsClient(this._options)));
+    }
+    get humanApiProfile() {
+        var _a;
+        return ((_a = this._humanApiProfile) !== null && _a !== void 0 ? _a : (this._humanApiProfile = new Client_js_18.HumanApiProfileClient(this._options)));
+    }
+    get agentApiActivity() {
         var _a;
-        return ((_a = this._agentApiPeers) !== null && _a !== void 0 ? _a : (this._agentApiPeers = new Client_js_9.AgentApiPeersClient(this._options)));
+        return ((_a = this._agentApiActivity) !== null && _a !== void 0 ? _a : (this._agentApiActivity = new Client_js_1.AgentApiActivityClient(this._options)));
     }
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.

package/dist/cjs/api/errors/ServiceUnavailableError.d.ts

@@ -0,0 +1,6 @@
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+import type * as Band from "../index.js";
+export declare class ServiceUnavailableError extends errors.BandError {
+    constructor(body: Band.Error_, rawResponse?: core.RawResponse);
+}

package/dist/cjs/api/errors/ServiceUnavailableError.js

@@ -0,0 +1,54 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceUnavailableError = void 0;
+const errors = __importStar(require("../../errors/index.js"));
+class ServiceUnavailableError extends errors.BandError {
+    constructor(body, rawResponse) {
+        super({
+            message: "ServiceUnavailableError",
+            statusCode: 503,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = this.constructor.name;
+    }
+}
+exports.ServiceUnavailableError = ServiceUnavailableError;

package/dist/cjs/api/errors/UnprocessableEntityError.d.ts

@@ -1,6 +1,5 @@
 import type * as core from "../../core/index.js";
 import * as errors from "../../errors/index.js";
-import type * as Band from "../index.js";
 export declare class UnprocessableEntityError extends errors.BandError {
-    constructor(body: Band.ValidationError, rawResponse?: core.RawResponse);
+    constructor(body?: unknown, rawResponse?: core.RawResponse);
 }

package/dist/cjs/api/errors/index.d.ts

@@ -2,5 +2,6 @@ export * from "./BadRequestError.js";
 export * from "./ConflictError.js";
 export * from "./ForbiddenError.js";
 export * from "./NotFoundError.js";
+export * from "./ServiceUnavailableError.js";
 export * from "./UnauthorizedError.js";
 export * from "./UnprocessableEntityError.js";

package/dist/cjs/api/errors/index.js

@@ -18,5 +18,6 @@ __exportStar(require("./BadRequestError.js"), exports);
 __exportStar(require("./ConflictError.js"), exports);
 __exportStar(require("./ForbiddenError.js"), exports);
 __exportStar(require("./NotFoundError.js"), exports);
+__exportStar(require("./ServiceUnavailableError.js"), exports);
 __exportStar(require("./UnauthorizedError.js"), exports);
 __exportStar(require("./UnprocessableEntityError.js"), exports);

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

@@ -0,0 +1,45 @@
+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 AgentApiActivityClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+/**
+ * Report the remote agent's working/Reasoning keep-alive for its active execution in a chat room.
+ */
+export declare class AgentApiActivityClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<AgentApiActivityClient.Options>;
+    constructor(options: AgentApiActivityClient.Options);
+    /**
+     * Reports whether the agent is actively working ("Reasoning…") on its execution in
+     * this chat room, driving a real-time indicator on chat surfaces.
+     *
+     * - `{ "working": true }` — the agent is working. Re-send on a keep-alive cadence
+     *   (~every 3 s); the platform expires the indicator ~10 s after the last report, so
+     *   a crashed or hung agent clears automatically.
+     * - `{ "working": false }` — the agent finished; the indicator clears immediately.
+     *
+     * Scoped to the agent's own active execution in the room (resolved server-side); a
+     * foreign room or one with no active execution returns 404.
+     *
+     * @param {string} chat_id - Chat Room ID
+     * @param {Band.ReportAgentChatActivityRequest} request
+     * @param {AgentApiActivityClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     * @throws {@link Band.NotFoundError}
+     * @throws {@link Band.UnprocessableEntityError}
+     * @throws {@link Band.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.agentApiActivity.reportAgentChatActivity("chat_id", {
+     *         working: true
+     *     })
+     */
+    reportAgentChatActivity(chat_id: string, request: Band.ReportAgentChatActivityRequest, requestOptions?: AgentApiActivityClient.RequestOptions): core.HttpResponsePromise<Band.ReportAgentChatActivityResponse>;
+    private __reportAgentChatActivity;
+}

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

@@ -0,0 +1,137 @@
+"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.AgentApiActivityClient = 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"));
+/**
+ * Report the remote agent's working/Reasoning keep-alive for its active execution in a chat room.
+ */
+class AgentApiActivityClient {
+    constructor(options) {
+        this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
+    }
+    /**
+     * Reports whether the agent is actively working ("Reasoning…") on its execution in
+     * this chat room, driving a real-time indicator on chat surfaces.
+     *
+     * - `{ "working": true }` — the agent is working. Re-send on a keep-alive cadence
+     *   (~every 3 s); the platform expires the indicator ~10 s after the last report, so
+     *   a crashed or hung agent clears automatically.
+     * - `{ "working": false }` — the agent finished; the indicator clears immediately.
+     *
+     * Scoped to the agent's own active execution in the room (resolved server-side); a
+     * foreign room or one with no active execution returns 404.
+     *
+     * @param {string} chat_id - Chat Room ID
+     * @param {Band.ReportAgentChatActivityRequest} request
+     * @param {AgentApiActivityClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Band.UnauthorizedError}
+     * @throws {@link Band.ForbiddenError}
+     * @throws {@link Band.NotFoundError}
+     * @throws {@link Band.UnprocessableEntityError}
+     * @throws {@link Band.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.agentApiActivity.reportAgentChatActivity("chat_id", {
+     *         working: true
+     *     })
+     */
+    reportAgentChatActivity(chat_id, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__reportAgentChatActivity(chat_id, request, requestOptions));
+    }
+    __reportAgentChatActivity(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)}/activity`),
+                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);
+                    case 503:
+                        throw new Band.ServiceUnavailableError(_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}/activity");
+        });
+    }
+}
+exports.AgentApiActivityClient = AgentApiActivityClient;

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

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

package/dist/cjs/api/resources/agentApiActivity/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/agentApiActivity/client/requests/ReportAgentChatActivityRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         working: true
+ *     }
+ */
+export interface ReportAgentChatActivityRequest {
+    /** Whether the agent is currently working. */
+    working: boolean;
+}

package/dist/cjs/api/resources/agentApiActivity/client/requests/ReportAgentChatActivityRequest.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/agentApiActivity/client/requests/index.d.ts

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

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

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

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

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