@band-ai/sdk 0.1.10 → 0.2.0

package/README.md

@@ -1,11 +1,11 @@
-# Thenvoi TypeScript SDK
+# Band TypeScript SDK
 
-Connect AI agents to the [Thenvoi](https://platform.thenvoi.com) collaborative platform. Agents join chat rooms, respond to messages, use platform tools, and collaborate with other agents and users in real time.
+Connect AI agents to the [Band](https://app.band.ai) collaborative platform. Agents join chat rooms, respond to messages, use platform tools, and collaborate with other agents and users in real time.
 
 ## Quick Start
 
 ```ts
-import { Agent, GenericAdapter, loadAgentConfigFromEnv } from "@thenvoi/sdk";
+import { Agent, GenericAdapter, loadAgentConfigFromEnv } from "@band-ai/sdk";
 
 const agent = Agent.create({
   adapter: new GenericAdapter(async ({ message, tools }) => {
@@ -17,12 +17,12 @@ const agent = Agent.create({
 await agent.run();
 ```
 
-Set `THENVOI_AGENT_ID` and `THENVOI_API_KEY` as environment variables, then run with `npx tsx your-agent.ts`.
+Set `BAND_AGENT_ID` and `BAND_API_KEY` as environment variables, then run with `npx tsx your-agent.ts`.
 
 ## Installation
 
 ```bash
-pnpm add @thenvoi/sdk
+pnpm add @band-ai/sdk
 ```
 
 Then install the SDK for the framework you want to use:
@@ -49,7 +49,7 @@ Each adapter wraps a different LLM framework. All adapters receive the same plat
 Bring your own logic with a single async callback:
 
 ```ts
-import { Agent, GenericAdapter, loadAgentConfig } from "@thenvoi/sdk";
+import { Agent, GenericAdapter, loadAgentConfig } from "@band-ai/sdk";
 
 const agent = Agent.create({
   adapter: new GenericAdapter(async ({ message, tools }) => {
@@ -64,7 +64,7 @@ await agent.run();
 ### OpenAI
 
 ```ts
-import { Agent, OpenAIAdapter, loadAgentConfig } from "@thenvoi/sdk";
+import { Agent, OpenAIAdapter, loadAgentConfig } from "@band-ai/sdk";
 
 const agent = Agent.create({
   adapter: new OpenAIAdapter({
@@ -80,7 +80,7 @@ await agent.run();
 ### Anthropic
 
 ```ts
-import { Agent, AnthropicAdapter, loadAgentConfig } from "@thenvoi/sdk";
+import { Agent, AnthropicAdapter, loadAgentConfig } from "@band-ai/sdk";
 
 const agent = Agent.create({
   adapter: new AnthropicAdapter({
@@ -96,7 +96,7 @@ await agent.run();
 ### Gemini
 
 ```ts
-import { Agent, GeminiAdapter, loadAgentConfig } from "@thenvoi/sdk";
+import { Agent, GeminiAdapter, loadAgentConfig } from "@band-ai/sdk";
 
 const agent = Agent.create({
   adapter: new GeminiAdapter({
@@ -114,7 +114,7 @@ await agent.run();
 Streaming responses with MCP tool support and room-scoped resume:
 
 ```ts
-import { Agent, ClaudeSDKAdapter, loadAgentConfig } from "@thenvoi/sdk";
+import { Agent, ClaudeSDKAdapter, loadAgentConfig } from "@band-ai/sdk";
 
 const agent = Agent.create({
   adapter: new ClaudeSDKAdapter({
@@ -133,7 +133,7 @@ await agent.run();
 Connects to `codex app-server` for thread mapping, dynamic tool registration, and local commands:
 
 ```ts
-import { Agent, CodexAdapter, loadAgentConfig } from "@thenvoi/sdk";
+import { Agent, CodexAdapter, loadAgentConfig } from "@band-ai/sdk";
 import { z } from "zod";
 
 const agent = Agent.create({
@@ -163,12 +163,12 @@ await agent.run();
 ### LangGraph
 
 ```ts
-import { Agent, LangGraphAdapter, loadAgentConfig } from "@thenvoi/sdk";
+import { Agent, LangGraphAdapter, loadAgentConfig } from "@band-ai/sdk";
 
 const agent = Agent.create({
   adapter: new LangGraphAdapter({
     graph: yourLangGraph,
-    customSection: "Use Thenvoi tools for side effects and final replies.",
+    customSection: "Use Band tools for side effects and final replies.",
     emitExecutionEvents: true,
   }),
   config: loadAgentConfig("my_agent"),
@@ -182,7 +182,7 @@ await agent.run();
 Route messages to an external A2A-compliant agent:
 
 ```ts
-import { Agent, A2AAdapter, loadAgentConfig } from "@thenvoi/sdk";
+import { Agent, A2AAdapter, loadAgentConfig } from "@band-ai/sdk";
 
 const agent = Agent.create({
   adapter: new A2AAdapter({
@@ -200,8 +200,8 @@ await agent.run();
 Extend `SimpleAdapter` for full control over the message lifecycle:
 
 ```ts
-import { Agent, SimpleAdapter, loadAgentConfig } from "@thenvoi/sdk";
-import type { AdapterToolsProtocol, HistoryProvider, PlatformMessage } from "@thenvoi/sdk";
+import { Agent, SimpleAdapter, loadAgentConfig } from "@band-ai/sdk";
+import type { AdapterToolsProtocol, HistoryProvider, PlatformMessage } from "@band-ai/sdk";
 
 class MyAdapter extends SimpleAdapter<HistoryProvider> {
   async onMessage(message: PlatformMessage, tools: AdapterToolsProtocol): Promise<void> {
@@ -222,12 +222,12 @@ await agent.run();
 ### Environment Variables
 
 ```bash
-export THENVOI_AGENT_ID="your-agent-uuid"
-export THENVOI_API_KEY="your-api-key"
+export BAND_AGENT_ID="your-agent-uuid"
+export BAND_API_KEY="your-api-key"
 ```
 
 ```ts
-import { loadAgentConfigFromEnv } from "@thenvoi/sdk";
+import { loadAgentConfigFromEnv } from "@band-ai/sdk";
 
 const config = loadAgentConfigFromEnv();
 ```
@@ -251,14 +251,14 @@ my_agent:
 ```
 
 ```ts
-import { loadAgentConfig } from "@thenvoi/sdk";
+import { loadAgentConfig } from "@band-ai/sdk";
 
 const config = loadAgentConfig("my_agent");
 ```
 
 ### Creating an Agent on the Platform
 
-1. Log in to [platform.thenvoi.com](https://platform.thenvoi.com)
+1. Log in to [app.band.ai](https://app.band.ai)
 2. Go to Agents and create a new agent with type "External"
 3. Copy the API key (shown once) and the Agent UUID from the details page
 4. Set them as environment variables or add them to `agent_config.yaml`
@@ -271,50 +271,50 @@ All adapters automatically receive these tools. The LLM calls them as function c
 
 | Tool | Description |
 |------|-------------|
-| `thenvoi_send_message` | Send a message to the chat room (requires @mentions) |
-| `thenvoi_send_event` | Send a thought, error, or task event (no mentions needed) |
-| `thenvoi_create_chatroom` | Create a new chat room |
-| `thenvoi_get_participants` | List participants in the current room |
-| `thenvoi_add_participant` | Add a user or agent to the room |
-| `thenvoi_remove_participant` | Remove a participant from the room |
-| `thenvoi_lookup_peers` | Find users and agents available to add |
+| `band_send_message` | Send a message to the chat room (requires @mentions) |
+| `band_send_event` | Send a thought, error, or task event (no mentions needed) |
+| `band_create_chatroom` | Create a new chat room |
+| `band_get_participants` | List participants in the current room |
+| `band_add_participant` | Add a user or agent to the room |
+| `band_remove_participant` | Remove a participant from the room |
+| `band_lookup_peers` | Find users and agents available to add |
 
 ### Contacts
 
 | Tool | Description |
 |------|-------------|
-| `thenvoi_list_contacts` | List the agent's contacts |
-| `thenvoi_add_contact` | Send a contact request |
-| `thenvoi_remove_contact` | Remove an existing contact |
-| `thenvoi_list_contact_requests` | List received and sent contact requests |
-| `thenvoi_respond_contact_request` | Approve, reject, or cancel a contact request |
+| `band_list_contacts` | List the agent's contacts |
+| `band_add_contact` | Send a contact request |
+| `band_remove_contact` | Remove an existing contact |
+| `band_list_contact_requests` | List received and sent contact requests |
+| `band_respond_contact_request` | Approve, reject, or cancel a contact request |
 
 ### Memory
 
 | Tool | Description |
 |------|-------------|
-| `thenvoi_list_memories` | Query stored memories with filters (scope, system, type, segment) |
-| `thenvoi_store_memory` | Store a new memory entry |
-| `thenvoi_get_memory` | Retrieve a specific memory by ID |
-| `thenvoi_supersede_memory` | Soft-delete outdated memory (keeps audit trail) |
-| `thenvoi_archive_memory` | Archive memory for later restoration |
+| `band_list_memories` | Query stored memories with filters (scope, system, type, segment) |
+| `band_store_memory` | Store a new memory entry |
+| `band_get_memory` | Retrieve a specific memory by ID |
+| `band_supersede_memory` | Soft-delete outdated memory (keeps audit trail) |
+| `band_archive_memory` | Archive memory for later restoration |
 
 ## Subpath Exports
 
-The root `@thenvoi/sdk` import covers the common runtime, adapters, and config. Specialized modules are available under subpaths:
+The root `@band-ai/sdk` import covers the common runtime, adapters, and config. Specialized modules are available under subpaths:
 
 | Import | Contents |
 |--------|----------|
-| `@thenvoi/sdk` | Agent, adapters, config loaders, core types |
-| `@thenvoi/sdk/adapters` | Adapter classes and helper types (e.g., `CodexAppServerStdioClient`, `GeminiToolCallingModel`) |
-| `@thenvoi/sdk/mcp` | Generic MCP registrations and HTTP/SSE/stdio backends without Claude-specific dependencies |
-| `@thenvoi/sdk/mcp/claude` | Claude Agent SDK MCP bridge (`createThenvoiSdkMcpServer`) |
-| `@thenvoi/sdk/rest` | `FernRestAdapter`, `RestFacade` for direct REST API access |
-| `@thenvoi/sdk/linear` | Linear tools plus bridge/webhook helpers (`createLinearTools`, webhook handler, dispatchers, room store) |
-| `@thenvoi/sdk/testing` | `FakeAgentTools` and test utilities |
-| `@thenvoi/sdk/config` | Config loaders (also re-exported from root) |
-| `@thenvoi/sdk/core` | Logger, errors, base classes |
-| `@thenvoi/sdk/runtime` | Runtime internals (room presence, execution context) |
+| `@band-ai/sdk` | Agent, adapters, config loaders, core types |
+| `@band-ai/sdk/adapters` | Adapter classes and helper types (e.g., `CodexAppServerStdioClient`, `GeminiToolCallingModel`) |
+| `@band-ai/sdk/mcp` | Generic MCP registrations and HTTP/SSE/stdio backends without Claude-specific dependencies |
+| `@band-ai/sdk/mcp/claude` | Claude Agent SDK MCP bridge (`createBandSdkMcpServer`) |
+| `@band-ai/sdk/rest` | `FernRestAdapter`, `RestFacade` for direct REST API access |
+| `@band-ai/sdk/linear` | Linear tools plus bridge/webhook helpers (`createLinearTools`, webhook handler, dispatchers, room store) |
+| `@band-ai/sdk/testing` | `FakeAgentTools` and test utilities |
+| `@band-ai/sdk/config` | Config loaders (also re-exported from root) |
+| `@band-ai/sdk/core` | Logger, errors, base classes |
+| `@band-ai/sdk/runtime` | Runtime internals (room presence, execution context) |
 
 ## Examples
 
@@ -332,13 +332,13 @@ Working examples live in `examples/`. Each folder is self-contained.
 | `examples/custom-adapter/` | SimpleAdapter | Custom adapter protocol |
 | `examples/parlant/` | Parlant | Guideline-based behavior |
 | `examples/a2a-bridge/` | A2A | Bridge to external A2A agents |
-| `examples/a2a-gateway/` | A2A Gateway | Expose Thenvoi peers as A2A endpoints |
-| `examples/linear-thenvoi/` | Linear | Bridge server with webhook handling |
+| `examples/a2a-gateway/` | A2A Gateway | Expose Band peers as A2A endpoints |
+| `examples/linear-band/` | Linear | Bridge server with webhook handling |
 
 ```bash
 # Clone and run
-git clone https://github.com/thenvoi/thenvoi-sdk-typescript.git
-cd thenvoi-sdk-typescript
+git clone https://github.com/band-ai/band-sdk-typescript.git
+cd band-sdk-typescript
 pnpm install
 cp agent_config.yaml.example agent_config.yaml  # add your credentials
 
@@ -357,7 +357,7 @@ Agent.create({ adapter, config })
     +-- PlatformRuntime (room lifecycle)
     |   RoomPresence -> ExecutionContext per room
     |
-    +-- ThenvoiLink (WebSocket + REST transport)
+    +-- BandLink (WebSocket + REST transport)
 ```
 
 `agent.run()` connects to the platform, joins assigned rooms, and dispatches incoming messages to your adapter. It handles `SIGINT`/`SIGTERM` for graceful shutdown. Pass `{ signals: false }` to disable signal handling in tests.

package/dist/{ClaudeSDKAdapter-DfjaI5ke.d.cts → ClaudeSDKAdapter-BY4zEbCl.d.cts}

@@ -1,12 +1,12 @@
-import { S as SimpleAdapter } from './simpleAdapter-C_f-01Cu.cjs';
-import { A as AdapterToolsProtocol, a as AgentToolsProtocol, c as MessagingTools, T as ToolExecutor, f as ToolSchemaProvider, H as HistoryConverter } from './protocols-D2bTrQ_t.cjs';
-import { H as HistoryProvider, P as PlatformMessage } from './types-CKqrhGB1.cjs';
+import { S as SimpleAdapter } from './simpleAdapter-BpT4XbZC.cjs';
+import { A as AdapterToolsProtocol, a as AgentToolsProtocol, c as MessagingTools, T as ToolExecutor, f as ToolSchemaProvider, H as HistoryConverter } from './protocols-Bz1rxcUg.cjs';
+import { H as HistoryProvider, P as PlatformMessage } from './types-D958TC71.cjs';
 import { L as Logger } from './logger-CABQOnlR.cjs';
 import { C as CustomToolDef } from './customTools-BzF0IISO.cjs';
-import { m as ToolModelMessage, n as ToolModelSchema, M as MetadataMap } from './dtos-Dd_fTfLn.cjs';
-import { s as GoogleADKMessages, q as GoogleADKHistoryConverter, e as A2ASessionState, A as A2AAuth, G as GatewaySessionState, a as A2AGatewayAdapterOptions, n as ParlantMessages, P as ParlantHistoryConverter, t as OpencodeSessionState, O as OpencodeHistoryConverter } from './opencode--iA5-KYk.cjs';
-import { c as createThenvoiMcpBackend } from './backends-DYtEhCZG.cjs';
-import { M as McpToolRegistration } from './sdk-D2rTDU_o.cjs';
+import { m as ToolModelMessage, n as ToolModelSchema, M as MetadataMap } from './dtos-B8KU_q4d.cjs';
+import { s as GoogleADKMessages, q as GoogleADKHistoryConverter, e as A2ASessionState, A as A2AAuth, G as GatewaySessionState, a as A2AGatewayAdapterOptions, n as ParlantMessages, P as ParlantHistoryConverter, t as OpencodeSessionState, O as OpencodeHistoryConverter } from './opencode-2YdscIc1.cjs';
+import { c as createBandMcpBackend } from './backends-ZLxmQrTZ.cjs';
+import { M as McpToolRegistration } from './sdk-BTciSLRQ.cjs';
 
 type GenericAdapterHandler = (args: {
     message: PlatformMessage;
@@ -177,7 +177,7 @@ interface CodexAdapterConfig {
     customSection?: string;
     /**
      * Full system prompt override.
-     * When set, this bypasses the default Thenvoi prompt template + customSection.
+     * When set, this bypasses the default Band prompt template + customSection.
      */
     systemPrompt?: string;
     experimentalApi?: boolean;
@@ -675,7 +675,7 @@ declare class A2AAdapter extends SimpleAdapter<A2ASessionState, MessagingTools>
 }
 
 declare class A2AGatewayAdapter extends SimpleAdapter<GatewaySessionState, MessagingTools> {
-    private readonly thenvoiRest;
+    private readonly bandRest;
     private readonly gatewayUrl;
     private readonly host;
     private readonly port;
@@ -998,6 +998,7 @@ interface OpencodeClientLike {
     registerMcpServer(input: {
         name: string;
         url: string;
+        headers?: Record<string, string>;
     }): Promise<Record<string, unknown>>;
     deregisterMcpServer(name: string): Promise<void>;
     iterEvents(): AsyncIterable<Record<string, unknown>>;
@@ -1090,6 +1091,7 @@ declare abstract class SdkOpencodeClientBase implements OpencodeClientLike {
     registerMcpServer(input: {
         name: string;
         url: string;
+        headers?: Record<string, string>;
     }): Promise<Record<string, unknown>>;
     deregisterMcpServer(name: string): Promise<void>;
     iterEvents(): AsyncIterable<Record<string, unknown>>;
@@ -1138,7 +1140,7 @@ interface OpencodeAdapterOptions {
     customTools?: CustomToolDef[];
     historyConverter?: OpencodeHistoryConverter;
     clientFactory?: (config: Required<OpencodeAdapterConfig>) => OpencodeClientLike;
-    mcpBackendFactory?: typeof createThenvoiMcpBackend;
+    mcpBackendFactory?: typeof createBandMcpBackend;
     logger?: Logger;
 }
 declare class OpencodeAdapter extends SimpleAdapter<OpencodeSessionState, AdapterToolsProtocol> {

package/dist/{ClaudeSDKAdapter-DonPGJ43.d.ts → ClaudeSDKAdapter-Cna5P1dR.d.ts}

@@ -1,12 +1,12 @@
-import { S as SimpleAdapter } from './simpleAdapter-qQt-tSz4.js';
-import { A as AdapterToolsProtocol, a as AgentToolsProtocol, c as MessagingTools, T as ToolExecutor, f as ToolSchemaProvider, H as HistoryConverter } from './protocols-BF6jamIl.js';
-import { H as HistoryProvider, P as PlatformMessage } from './types-DNySTI_8.js';
+import { S as SimpleAdapter } from './simpleAdapter--wznuoOw.js';
+import { A as AdapterToolsProtocol, a as AgentToolsProtocol, c as MessagingTools, T as ToolExecutor, f as ToolSchemaProvider, H as HistoryConverter } from './protocols-Bwwcql0h.js';
+import { H as HistoryProvider, P as PlatformMessage } from './types-BTN_ZETM.js';
 import { L as Logger } from './logger-CABQOnlR.js';
 import { C as CustomToolDef } from './customTools-BzF0IISO.js';
-import { m as ToolModelMessage, n as ToolModelSchema, M as MetadataMap } from './dtos-Dd_fTfLn.js';
-import { s as GoogleADKMessages, q as GoogleADKHistoryConverter, e as A2ASessionState, A as A2AAuth, G as GatewaySessionState, a as A2AGatewayAdapterOptions, n as ParlantMessages, P as ParlantHistoryConverter, t as OpencodeSessionState, O as OpencodeHistoryConverter } from './opencode-YNacv-eJ.js';
-import { c as createThenvoiMcpBackend } from './backends-oYAb7EU-.js';
-import { M as McpToolRegistration } from './sdk-CyqN1W5g.js';
+import { m as ToolModelMessage, n as ToolModelSchema, M as MetadataMap } from './dtos-B8KU_q4d.js';
+import { s as GoogleADKMessages, q as GoogleADKHistoryConverter, e as A2ASessionState, A as A2AAuth, G as GatewaySessionState, a as A2AGatewayAdapterOptions, n as ParlantMessages, P as ParlantHistoryConverter, t as OpencodeSessionState, O as OpencodeHistoryConverter } from './opencode-Bld62x5t.js';
+import { c as createBandMcpBackend } from './backends-D-dBdDm-.js';
+import { M as McpToolRegistration } from './sdk-qKJtMma_.js';
 
 type GenericAdapterHandler = (args: {
     message: PlatformMessage;
@@ -177,7 +177,7 @@ interface CodexAdapterConfig {
     customSection?: string;
     /**
      * Full system prompt override.
-     * When set, this bypasses the default Thenvoi prompt template + customSection.
+     * When set, this bypasses the default Band prompt template + customSection.
      */
     systemPrompt?: string;
     experimentalApi?: boolean;
@@ -675,7 +675,7 @@ declare class A2AAdapter extends SimpleAdapter<A2ASessionState, MessagingTools>
 }
 
 declare class A2AGatewayAdapter extends SimpleAdapter<GatewaySessionState, MessagingTools> {
-    private readonly thenvoiRest;
+    private readonly bandRest;
     private readonly gatewayUrl;
     private readonly host;
     private readonly port;
@@ -998,6 +998,7 @@ interface OpencodeClientLike {
     registerMcpServer(input: {
         name: string;
         url: string;
+        headers?: Record<string, string>;
     }): Promise<Record<string, unknown>>;
     deregisterMcpServer(name: string): Promise<void>;
     iterEvents(): AsyncIterable<Record<string, unknown>>;
@@ -1090,6 +1091,7 @@ declare abstract class SdkOpencodeClientBase implements OpencodeClientLike {
     registerMcpServer(input: {
         name: string;
         url: string;
+        headers?: Record<string, string>;
     }): Promise<Record<string, unknown>>;
     deregisterMcpServer(name: string): Promise<void>;
     iterEvents(): AsyncIterable<Record<string, unknown>>;
@@ -1138,7 +1140,7 @@ interface OpencodeAdapterOptions {
     customTools?: CustomToolDef[];
     historyConverter?: OpencodeHistoryConverter;
     clientFactory?: (config: Required<OpencodeAdapterConfig>) => OpencodeClientLike;
-    mcpBackendFactory?: typeof createThenvoiMcpBackend;
+    mcpBackendFactory?: typeof createBandMcpBackend;
     logger?: Logger;
 }
 declare class OpencodeAdapter extends SimpleAdapter<OpencodeSessionState, AdapterToolsProtocol> {

package/dist/{acp-server-NZAeg-WO.d.ts → acp-server-CiUqN3G3.d.ts}

@@ -1,5 +1,5 @@
-import { H as HistoryConverter } from './protocols-BF6jamIl.js';
-import { G as GatewaySessionState } from './opencode-YNacv-eJ.js';
+import { H as HistoryConverter } from './protocols-Bwwcql0h.js';
+import { G as GatewaySessionState } from './opencode-Bld62x5t.js';
 
 declare class GatewayHistoryConverter implements HistoryConverter<GatewaySessionState> {
     convert(raw: Array<Record<string, unknown>>): GatewaySessionState;

package/dist/{acp-server-CUBXIiG6.d.cts → acp-server-Dlj7D563.d.cts}

@@ -1,5 +1,5 @@
-import { H as HistoryConverter } from './protocols-D2bTrQ_t.cjs';
-import { G as GatewaySessionState } from './opencode--iA5-KYk.cjs';
+import { H as HistoryConverter } from './protocols-Bz1rxcUg.cjs';
+import { G as GatewaySessionState } from './opencode-2YdscIc1.cjs';
 
 declare class GatewayHistoryConverter implements HistoryConverter<GatewaySessionState> {
     convert(raw: Array<Record<string, unknown>>): GatewaySessionState;