@band-ai/sdk 0.1.10 → 0.2.0

package/dist/runtime.d.cts

@@ -1,16 +1,18 @@
-import { c as ContactEventConfig, g as MessageEvent, C as ContactEvent, f as PlatformEvent, P as PlatformMessage } from './types-CKqrhGB1.cjs';
-export { A as AgentConfig, b as ContactEventCallback, d as ContactEventStrategy, e as ConversationContext, H as HistoryProvider, M as MessageHandler, h as SYNTHETIC_CONTACT_EVENTS_SENDER_ID, i as SYNTHETIC_CONTACT_EVENTS_SENDER_NAME, j as SYNTHETIC_SENDER_TYPE, S as SessionConfig, k as ensureHandlePrefix } from './types-CKqrhGB1.cjs';
+import { c as ContactEventConfig, g as MessageEvent, C as ContactEvent, f as PlatformEvent, P as PlatformMessage } from './types-D958TC71.cjs';
+export { A as AgentConfig, b as ContactEventCallback, d as ContactEventStrategy, e as ConversationContext, H as HistoryProvider, M as MessageHandler, h as SYNTHETIC_CONTACT_EVENTS_SENDER_ID, i as SYNTHETIC_CONTACT_EVENTS_SENDER_NAME, j as SYNTHETIC_SENDER_TYPE, S as SessionConfig, k as ensureHandlePrefix } from './types-D958TC71.cjs';
 import { L as Logger } from './logger-CABQOnlR.cjs';
-import { A as AdapterToolsProtocol, a as AgentToolsProtocol, h as AgentToolsCapabilities, C as ContactTools } from './protocols-D2bTrQ_t.cjs';
-import { e as AgentToolsRestApi, f as ChatMessagingRestApi, g as ChatRoomRestApi, h as ContactRestApi } from './types-DtMms5Fi.cjs';
-import { b as ThenvoiLink, c as ExecutionContext } from './schemas-CI0qgcp_.cjs';
-export { e as ALL_TOOL_NAMES, A as AgentRuntime, B as BASE_TOOL_NAMES, C as CHAT_TOOL_NAMES, f as CONTACT_TOOL_NAMES, D as DefaultPreprocessor, E as ExecutionContextOptions, g as ExecutionState, M as MCP_TOOL_PREFIX, h as MEMORY_TOOL_NAMES, i as MessageRetryTracker, P as PlatformRuntime, T as TOOL_MODELS, j as getToolDescription, m as mcpToolNames } from './schemas-CI0qgcp_.cjs';
-import { M as MetadataMap, P as ParticipantRecord, a as MentionInput, T as ToolOperationResult, c as PaginatedList, d as PeerRecord, b as ToolSchemaRecord, L as ListContactsArgs, C as ContactRecord, A as AddContactArgs, R as RemoveContactArgs, e as ListContactRequestsArgs, f as ContactRequestsResult, g as RespondContactRequestArgs, h as ListMemoriesArgs, i as MemoryRecord, S as StoreMemoryArgs, m as ToolModelMessage } from './dtos-Dd_fTfLn.cjs';
+import { A as AdapterToolsProtocol, a as AgentToolsProtocol, h as AgentToolsCapabilities, C as ContactTools } from './protocols-Bz1rxcUg.cjs';
+import { e as AgentToolsRestApi, f as ChatMessagingRestApi, g as ChatRoomRestApi, h as ContactRestApi } from './types-BgYFd_Yw.cjs';
+import { B as BandLink, c as ExecutionContext } from './schemas-BotL3ZLH.cjs';
+export { e as ALL_TOOL_NAMES, A as AgentRuntime, f as BASE_TOOL_NAMES, C as CHAT_TOOL_NAMES, g as CONTACT_TOOL_NAMES, D as DefaultPreprocessor, E as ExecutionContextOptions, h as ExecutionState, M as MCP_SERVER_NAME, b as MCP_TOOL_PREFIX, i as MEMORY_TOOL_NAMES, P as PlatformRuntime, T as TOOL_MODELS, j as getToolDescription, m as mcpToolNames } from './schemas-BotL3ZLH.cjs';
+import { M as MetadataMap, a as MentionInput, T as ToolOperationResult, c as PaginatedList, d as PeerRecord, P as ParticipantRecord, b as ToolSchemaRecord, L as ListContactsArgs, C as ContactRecord, A as AddContactArgs, R as RemoveContactArgs, e as ListContactRequestsArgs, f as ContactRequestsResult, g as RespondContactRequestArgs, h as ListMemoriesArgs, i as MemoryRecord, S as StoreMemoryArgs, m as ToolModelMessage } from './dtos-B8KU_q4d.cjs';
+import { ParticipantRoster } from '@band-ai/band-sdk-core';
+export { ParticipantRoster, RetryTracker } from '@band-ai/band-sdk-core';
 import 'zod';
-import './pagination-CqidD-L_.cjs';
+import './pagination-DqdkQArT.cjs';
 import './disconnectReason-IuADl6TH.cjs';
 
-declare const HUB_ROOM_SYSTEM_PROMPT = "## OVERRIDE: Contact Management Mode\n\nThis is your CONTACTS HUB - a dedicated room for managing contact requests.\n\n**IMPORTANT: Do NOT delegate or add participants here.** You handle contact events DIRECTLY using the contact tools below. Do NOT call thenvoi_lookup_peers() or thenvoi_add_participant() in this room.\n\n## Your Role\n\n1. **Review incoming contact requests** - When you see a [Contact Request] message, evaluate it\n2. **Take action** - Use the contact tools to respond:\n   - `thenvoi_respond_contact_request(action=\"approve\", request_id=\"...\")` to accept\n   - `thenvoi_respond_contact_request(action=\"reject\", request_id=\"...\")` to decline\n3. **Report your decision** - Send a thought event explaining what you did\n\n## Example\n\n[Contact Events]: [Contact Request] Alice (@alice) wants to connect.\nRequest ID: abc-123\n\nYour response:\n1. thenvoi_send_event(\"Received contact request from Alice. Approving.\", message_type=\"thought\")\n2. thenvoi_respond_contact_request(action=\"approve\", request_id=\"abc-123\")\n3. thenvoi_send_event(\"Approved contact request from Alice (@alice)\", message_type=\"thought\")\n\n## Contact Tools (use these, NOT participant tools)\n- `thenvoi_respond_contact_request(action, request_id)` - Approve/reject requests\n- `thenvoi_list_contact_requests()` - List pending requests\n- `thenvoi_list_contacts()` - List current contacts";
+declare const HUB_ROOM_SYSTEM_PROMPT = "## OVERRIDE: Contact Management Mode\n\nThis is your CONTACTS HUB - a dedicated room for managing contact requests.\n\n**IMPORTANT: Do NOT delegate or add participants here.** You handle contact events DIRECTLY using the contact tools below. Do NOT call band_lookup_peers() or band_add_participant() in this room.\n\n## Your Role\n\n1. **Review incoming contact requests** - When you see a [Contact Request] message, evaluate it\n2. **Take action** - Use the contact tools to respond:\n   - `band_respond_contact_request(action=\"approve\", request_id=\"...\")` to accept\n   - `band_respond_contact_request(action=\"reject\", request_id=\"...\")` to decline\n3. **Report your decision** - Send a thought event explaining what you did\n\n## Example\n\n[Contact Events]: [Contact Request] Alice (@alice) wants to connect.\nRequest ID: abc-123\n\nYour response:\n1. band_send_event(\"Received contact request from Alice. Approving.\", message_type=\"thought\")\n2. band_respond_contact_request(action=\"approve\", request_id=\"abc-123\")\n3. band_send_event(\"Approved contact request from Alice (@alice)\", message_type=\"thought\")\n\n## Contact Tools (use these, NOT participant tools)\n- `band_respond_contact_request(action, request_id)` - Approve/reject requests\n- `band_list_contact_requests()` - List pending requests\n- `band_list_contacts()` - List current contacts";
 type ContactHandlerRestApi = Partial<AgentToolsRestApi> & Pick<ChatMessagingRestApi, "createChatEvent"> & Pick<ChatRoomRestApi, "createChat"> & Partial<Pick<ContactRestApi, "listContactRequests">>;
 interface ContactEventHandlerOptions {
     config: ContactEventConfig;
@@ -55,7 +57,7 @@ declare class ContactEventHandler {
 type ExecutionHandler = (context: ExecutionContext, event: PlatformEvent) => Promise<void>;
 interface ExecutionOptions {
     roomId: string;
-    link: ThenvoiLink;
+    link: BandLink;
     context: ExecutionContext;
     onExecute: ExecutionHandler;
     onFailure?: (error: unknown, event: PlatformEvent) => void | Promise<void>;
@@ -98,7 +100,7 @@ declare class Execution {
 }
 
 interface RoomPresenceOptions {
-    link: ThenvoiLink;
+    link: BandLink;
     roomFilter?: (room: MetadataMap) => boolean;
     autoSubscribeExistingRooms?: boolean;
     logger?: Logger;
@@ -132,14 +134,14 @@ declare class RoomPresence {
 interface AgentToolsOptions {
     roomId: string;
     rest: AgentToolsRestApi;
-    participants?: ParticipantRecord[];
+    roster?: ParticipantRoster;
     capabilities?: Partial<AgentToolsCapabilities>;
 }
 declare class AgentTools implements AgentToolsProtocol {
     readonly roomId: string;
     readonly capabilities: Readonly<AgentToolsCapabilities>;
     private readonly rest;
-    private participants;
+    private readonly roster;
     private readonly adapterTools;
     private readonly toolHandlers;
     constructor(options: AgentToolsOptions);
@@ -176,7 +178,6 @@ declare class AgentTools implements AgentToolsProtocol {
     private resolveMentions;
     private lookupPeerByName;
     private normalizeMentionHandle;
-    private replaceParticipants;
     private buildAdapterTools;
     private bindAdapterToolMethod;
     private buildToolHandlers;
@@ -240,19 +241,6 @@ interface RenderSystemPromptOptions {
 }
 declare function renderSystemPrompt(options?: RenderSystemPromptOptions): string;
 
-declare class ParticipantTracker {
-    private participantsList;
-    private lastSent;
-    private loaded;
-    get participants(): Array<Record<string, unknown>>;
-    get isLoaded(): boolean;
-    setLoaded(participants: Array<Record<string, unknown>>): void;
-    add(participant: Record<string, unknown>): boolean;
-    remove(participantId: string): boolean;
-    changed(): boolean;
-    markSent(): void;
-}
-
 interface StoppableAgent {
     stop(timeoutMs?: number | null): Promise<boolean>;
     run(options?: {
@@ -278,4 +266,4 @@ declare class GracefulShutdown {
 }
 declare function runWithGracefulShutdown(agent: StoppableAgent, options?: GracefulShutdownOptions): Promise<void>;
 
-export { AgentTools, BASE_INSTRUCTIONS, CHAT_EVENT_TYPES, CHAT_MESSAGE_TYPES, type ChatEventType, type ChatMessageType, ContactEventConfig, ContactEventHandler, ContactToolsImpl, Execution, ExecutionContext, type ExecutionHandler, GracefulShutdown, HUB_ROOM_SYSTEM_PROMPT, MEMORY_SECTION, ParticipantTracker, PlatformMessage, type RenderSystemPromptOptions, RoomPresence, TEMPLATES, assertChatEventType, buildParticipantsMessage, formatHistoryForLlm, formatMessageForLlm, isChatEventType, renderSystemPrompt, replaceUuidMentions, runWithGracefulShutdown };
+export { AgentTools, BASE_INSTRUCTIONS, CHAT_EVENT_TYPES, CHAT_MESSAGE_TYPES, type ChatEventType, type ChatMessageType, ContactEventConfig, ContactEventHandler, ContactToolsImpl, Execution, ExecutionContext, type ExecutionHandler, GracefulShutdown, HUB_ROOM_SYSTEM_PROMPT, MEMORY_SECTION, PlatformMessage, type RenderSystemPromptOptions, RoomPresence, TEMPLATES, assertChatEventType, buildParticipantsMessage, formatHistoryForLlm, formatMessageForLlm, isChatEventType, renderSystemPrompt, replaceUuidMentions, runWithGracefulShutdown };

package/dist/runtime.d.ts

@@ -1,16 +1,18 @@
-import { c as ContactEventConfig, g as MessageEvent, C as ContactEvent, f as PlatformEvent, P as PlatformMessage } from './types-DNySTI_8.js';
-export { A as AgentConfig, b as ContactEventCallback, d as ContactEventStrategy, e as ConversationContext, H as HistoryProvider, M as MessageHandler, h as SYNTHETIC_CONTACT_EVENTS_SENDER_ID, i as SYNTHETIC_CONTACT_EVENTS_SENDER_NAME, j as SYNTHETIC_SENDER_TYPE, S as SessionConfig, k as ensureHandlePrefix } from './types-DNySTI_8.js';
+import { c as ContactEventConfig, g as MessageEvent, C as ContactEvent, f as PlatformEvent, P as PlatformMessage } from './types-BTN_ZETM.js';
+export { A as AgentConfig, b as ContactEventCallback, d as ContactEventStrategy, e as ConversationContext, H as HistoryProvider, M as MessageHandler, h as SYNTHETIC_CONTACT_EVENTS_SENDER_ID, i as SYNTHETIC_CONTACT_EVENTS_SENDER_NAME, j as SYNTHETIC_SENDER_TYPE, S as SessionConfig, k as ensureHandlePrefix } from './types-BTN_ZETM.js';
 import { L as Logger } from './logger-CABQOnlR.js';
-import { A as AdapterToolsProtocol, a as AgentToolsProtocol, h as AgentToolsCapabilities, C as ContactTools } from './protocols-BF6jamIl.js';
-import { e as AgentToolsRestApi, f as ChatMessagingRestApi, g as ChatRoomRestApi, h as ContactRestApi } from './types-D3AsUnd0.js';
-import { b as ThenvoiLink, c as ExecutionContext } from './schemas-B1Fd3oUM.js';
-export { e as ALL_TOOL_NAMES, A as AgentRuntime, B as BASE_TOOL_NAMES, C as CHAT_TOOL_NAMES, f as CONTACT_TOOL_NAMES, D as DefaultPreprocessor, E as ExecutionContextOptions, g as ExecutionState, M as MCP_TOOL_PREFIX, h as MEMORY_TOOL_NAMES, i as MessageRetryTracker, P as PlatformRuntime, T as TOOL_MODELS, j as getToolDescription, m as mcpToolNames } from './schemas-B1Fd3oUM.js';
-import { M as MetadataMap, P as ParticipantRecord, a as MentionInput, T as ToolOperationResult, c as PaginatedList, d as PeerRecord, b as ToolSchemaRecord, L as ListContactsArgs, C as ContactRecord, A as AddContactArgs, R as RemoveContactArgs, e as ListContactRequestsArgs, f as ContactRequestsResult, g as RespondContactRequestArgs, h as ListMemoriesArgs, i as MemoryRecord, S as StoreMemoryArgs, m as ToolModelMessage } from './dtos-Dd_fTfLn.js';
+import { A as AdapterToolsProtocol, a as AgentToolsProtocol, h as AgentToolsCapabilities, C as ContactTools } from './protocols-Bwwcql0h.js';
+import { e as AgentToolsRestApi, f as ChatMessagingRestApi, g as ChatRoomRestApi, h as ContactRestApi } from './types-BivGO7I9.js';
+import { B as BandLink, c as ExecutionContext } from './schemas-DBsC4J1g.js';
+export { e as ALL_TOOL_NAMES, A as AgentRuntime, f as BASE_TOOL_NAMES, C as CHAT_TOOL_NAMES, g as CONTACT_TOOL_NAMES, D as DefaultPreprocessor, E as ExecutionContextOptions, h as ExecutionState, M as MCP_SERVER_NAME, b as MCP_TOOL_PREFIX, i as MEMORY_TOOL_NAMES, P as PlatformRuntime, T as TOOL_MODELS, j as getToolDescription, m as mcpToolNames } from './schemas-DBsC4J1g.js';
+import { M as MetadataMap, a as MentionInput, T as ToolOperationResult, c as PaginatedList, d as PeerRecord, P as ParticipantRecord, b as ToolSchemaRecord, L as ListContactsArgs, C as ContactRecord, A as AddContactArgs, R as RemoveContactArgs, e as ListContactRequestsArgs, f as ContactRequestsResult, g as RespondContactRequestArgs, h as ListMemoriesArgs, i as MemoryRecord, S as StoreMemoryArgs, m as ToolModelMessage } from './dtos-B8KU_q4d.js';
+import { ParticipantRoster } from '@band-ai/band-sdk-core';
+export { ParticipantRoster, RetryTracker } from '@band-ai/band-sdk-core';
 import 'zod';
-import './pagination-BBLsYLhT.js';
+import './pagination-BgEx-HeL.js';
 import './disconnectReason-IuADl6TH.js';
 
-declare const HUB_ROOM_SYSTEM_PROMPT = "## OVERRIDE: Contact Management Mode\n\nThis is your CONTACTS HUB - a dedicated room for managing contact requests.\n\n**IMPORTANT: Do NOT delegate or add participants here.** You handle contact events DIRECTLY using the contact tools below. Do NOT call thenvoi_lookup_peers() or thenvoi_add_participant() in this room.\n\n## Your Role\n\n1. **Review incoming contact requests** - When you see a [Contact Request] message, evaluate it\n2. **Take action** - Use the contact tools to respond:\n   - `thenvoi_respond_contact_request(action=\"approve\", request_id=\"...\")` to accept\n   - `thenvoi_respond_contact_request(action=\"reject\", request_id=\"...\")` to decline\n3. **Report your decision** - Send a thought event explaining what you did\n\n## Example\n\n[Contact Events]: [Contact Request] Alice (@alice) wants to connect.\nRequest ID: abc-123\n\nYour response:\n1. thenvoi_send_event(\"Received contact request from Alice. Approving.\", message_type=\"thought\")\n2. thenvoi_respond_contact_request(action=\"approve\", request_id=\"abc-123\")\n3. thenvoi_send_event(\"Approved contact request from Alice (@alice)\", message_type=\"thought\")\n\n## Contact Tools (use these, NOT participant tools)\n- `thenvoi_respond_contact_request(action, request_id)` - Approve/reject requests\n- `thenvoi_list_contact_requests()` - List pending requests\n- `thenvoi_list_contacts()` - List current contacts";
+declare const HUB_ROOM_SYSTEM_PROMPT = "## OVERRIDE: Contact Management Mode\n\nThis is your CONTACTS HUB - a dedicated room for managing contact requests.\n\n**IMPORTANT: Do NOT delegate or add participants here.** You handle contact events DIRECTLY using the contact tools below. Do NOT call band_lookup_peers() or band_add_participant() in this room.\n\n## Your Role\n\n1. **Review incoming contact requests** - When you see a [Contact Request] message, evaluate it\n2. **Take action** - Use the contact tools to respond:\n   - `band_respond_contact_request(action=\"approve\", request_id=\"...\")` to accept\n   - `band_respond_contact_request(action=\"reject\", request_id=\"...\")` to decline\n3. **Report your decision** - Send a thought event explaining what you did\n\n## Example\n\n[Contact Events]: [Contact Request] Alice (@alice) wants to connect.\nRequest ID: abc-123\n\nYour response:\n1. band_send_event(\"Received contact request from Alice. Approving.\", message_type=\"thought\")\n2. band_respond_contact_request(action=\"approve\", request_id=\"abc-123\")\n3. band_send_event(\"Approved contact request from Alice (@alice)\", message_type=\"thought\")\n\n## Contact Tools (use these, NOT participant tools)\n- `band_respond_contact_request(action, request_id)` - Approve/reject requests\n- `band_list_contact_requests()` - List pending requests\n- `band_list_contacts()` - List current contacts";
 type ContactHandlerRestApi = Partial<AgentToolsRestApi> & Pick<ChatMessagingRestApi, "createChatEvent"> & Pick<ChatRoomRestApi, "createChat"> & Partial<Pick<ContactRestApi, "listContactRequests">>;
 interface ContactEventHandlerOptions {
     config: ContactEventConfig;
@@ -55,7 +57,7 @@ declare class ContactEventHandler {
 type ExecutionHandler = (context: ExecutionContext, event: PlatformEvent) => Promise<void>;
 interface ExecutionOptions {
     roomId: string;
-    link: ThenvoiLink;
+    link: BandLink;
     context: ExecutionContext;
     onExecute: ExecutionHandler;
     onFailure?: (error: unknown, event: PlatformEvent) => void | Promise<void>;
@@ -98,7 +100,7 @@ declare class Execution {
 }
 
 interface RoomPresenceOptions {
-    link: ThenvoiLink;
+    link: BandLink;
     roomFilter?: (room: MetadataMap) => boolean;
     autoSubscribeExistingRooms?: boolean;
     logger?: Logger;
@@ -132,14 +134,14 @@ declare class RoomPresence {
 interface AgentToolsOptions {
     roomId: string;
     rest: AgentToolsRestApi;
-    participants?: ParticipantRecord[];
+    roster?: ParticipantRoster;
     capabilities?: Partial<AgentToolsCapabilities>;
 }
 declare class AgentTools implements AgentToolsProtocol {
     readonly roomId: string;
     readonly capabilities: Readonly<AgentToolsCapabilities>;
     private readonly rest;
-    private participants;
+    private readonly roster;
     private readonly adapterTools;
     private readonly toolHandlers;
     constructor(options: AgentToolsOptions);
@@ -176,7 +178,6 @@ declare class AgentTools implements AgentToolsProtocol {
     private resolveMentions;
     private lookupPeerByName;
     private normalizeMentionHandle;
-    private replaceParticipants;
     private buildAdapterTools;
     private bindAdapterToolMethod;
     private buildToolHandlers;
@@ -240,19 +241,6 @@ interface RenderSystemPromptOptions {
 }
 declare function renderSystemPrompt(options?: RenderSystemPromptOptions): string;
 
-declare class ParticipantTracker {
-    private participantsList;
-    private lastSent;
-    private loaded;
-    get participants(): Array<Record<string, unknown>>;
-    get isLoaded(): boolean;
-    setLoaded(participants: Array<Record<string, unknown>>): void;
-    add(participant: Record<string, unknown>): boolean;
-    remove(participantId: string): boolean;
-    changed(): boolean;
-    markSent(): void;
-}
-
 interface StoppableAgent {
     stop(timeoutMs?: number | null): Promise<boolean>;
     run(options?: {
@@ -278,4 +266,4 @@ declare class GracefulShutdown {
 }
 declare function runWithGracefulShutdown(agent: StoppableAgent, options?: GracefulShutdownOptions): Promise<void>;
 
-export { AgentTools, BASE_INSTRUCTIONS, CHAT_EVENT_TYPES, CHAT_MESSAGE_TYPES, type ChatEventType, type ChatMessageType, ContactEventConfig, ContactEventHandler, ContactToolsImpl, Execution, ExecutionContext, type ExecutionHandler, GracefulShutdown, HUB_ROOM_SYSTEM_PROMPT, MEMORY_SECTION, ParticipantTracker, PlatformMessage, type RenderSystemPromptOptions, RoomPresence, TEMPLATES, assertChatEventType, buildParticipantsMessage, formatHistoryForLlm, formatMessageForLlm, isChatEventType, renderSystemPrompt, replaceUuidMentions, runWithGracefulShutdown };
+export { AgentTools, BASE_INSTRUCTIONS, CHAT_EVENT_TYPES, CHAT_MESSAGE_TYPES, type ChatEventType, type ChatMessageType, ContactEventConfig, ContactEventHandler, ContactToolsImpl, Execution, ExecutionContext, type ExecutionHandler, GracefulShutdown, HUB_ROOM_SYSTEM_PROMPT, MEMORY_SECTION, PlatformMessage, type RenderSystemPromptOptions, RoomPresence, TEMPLATES, assertChatEventType, buildParticipantsMessage, formatHistoryForLlm, formatMessageForLlm, isChatEventType, renderSystemPrompt, replaceUuidMentions, runWithGracefulShutdown };

package/dist/runtime.js

@@ -8,13 +8,12 @@ import {
   ExecutionContext,
   GracefulShutdown,
   HUB_ROOM_SYSTEM_PROMPT,
-  MessageRetryTracker,
   PlatformRuntime,
   hydrateTrackedRooms,
   runWithGracefulShutdown,
   trackRoomJoin,
   trackRoomLeave
-} from "./chunk-FP237EAG.js";
+} from "./chunk-N2QTUMGO.js";
 import {
   HistoryProvider,
   SYNTHETIC_CONTACT_EVENTS_SENDER_ID,
@@ -25,13 +24,13 @@ import {
   formatHistoryForLlm,
   formatMessageForLlm,
   replaceUuidMentions
-} from "./chunk-RDM4TE4B.js";
+} from "./chunk-LBWKISBS.js";
 import {
   BASE_INSTRUCTIONS,
   MEMORY_SECTION,
   TEMPLATES,
   renderSystemPrompt
-} from "./chunk-DNPVCR3S.js";
+} from "./chunk-WLCM2OXG.js";
 import {
   ALL_TOOL_NAMES,
   BASE_TOOL_NAMES,
@@ -39,6 +38,7 @@ import {
   CHAT_MESSAGE_TYPES,
   CHAT_TOOL_NAMES,
   CONTACT_TOOL_NAMES,
+  MCP_SERVER_NAME,
   MCP_TOOL_PREFIX,
   MEMORY_TOOL_NAMES,
   TOOL_MODELS,
@@ -46,17 +46,17 @@ import {
   getToolDescription,
   isChatEventType,
   mcpToolNames
-} from "./chunk-MLROFDKR.js";
+} from "./chunk-RV76SKFT.js";
 import "./chunk-US226AS4.js";
 import {
   DEFAULT_REQUEST_OPTIONS
-} from "./chunk-SG4WLD2H.js";
+} from "./chunk-EAI2M3WM.js";
 import "./chunk-ZZJRRBPQ.js";
 import "./chunk-3BKAC4OZ.js";
 import {
   NoopLogger
 } from "./chunk-OD2G5LFQ.js";
-import "./chunk-YR3BOQNW.js";
+import "./chunk-JY75VSQK.js";
 
 // src/runtime/rooms/RoomPresence.ts
 var RoomPresence = class {
@@ -179,60 +179,8 @@ var RoomPresence = class {
   }
 };
 
-// src/runtime/participantTracker.ts
-var ParticipantTracker = class {
-  participantsList = [];
-  lastSent = null;
-  loaded = false;
-  get participants() {
-    return [...this.participantsList];
-  }
-  get isLoaded() {
-    return this.loaded;
-  }
-  setLoaded(participants) {
-    this.participantsList = participants.map((participant) => ({ ...participant }));
-    this.loaded = true;
-  }
-  add(participant) {
-    if (this.participantsList.some((entry) => entry.id === participant.id)) {
-      return false;
-    }
-    this.participantsList.push({
-      id: participant.id,
-      name: participant.name,
-      type: participant.type,
-      handle: participant.handle
-    });
-    return true;
-  }
-  remove(participantId) {
-    const before = this.participantsList.length;
-    this.participantsList = this.participantsList.filter(
-      (participant) => participant.id !== participantId
-    );
-    return this.participantsList.length < before;
-  }
-  changed() {
-    if (!this.lastSent) {
-      return true;
-    }
-    const oldIds = new Set(this.lastSent.map((participant) => participant.id));
-    const newIds = new Set(this.participantsList.map((participant) => participant.id));
-    if (oldIds.size !== newIds.size) {
-      return true;
-    }
-    for (const id of oldIds) {
-      if (!newIds.has(id)) {
-        return true;
-      }
-    }
-    return false;
-  }
-  markSent() {
-    this.lastSent = this.participantsList.map((participant) => ({ ...participant }));
-  }
-};
+// src/runtime/index.ts
+import { ParticipantRoster, RetryTracker } from "@band-ai/band-sdk-core";
 export {
   ALL_TOOL_NAMES,
   AgentRuntime,
@@ -251,12 +199,13 @@ export {
   GracefulShutdown,
   HUB_ROOM_SYSTEM_PROMPT,
   HistoryProvider,
+  MCP_SERVER_NAME,
   MCP_TOOL_PREFIX,
   MEMORY_SECTION,
   MEMORY_TOOL_NAMES,
-  MessageRetryTracker,
-  ParticipantTracker,
+  ParticipantRoster,
   PlatformRuntime,
+  RetryTracker,
   RoomPresence,
   SYNTHETIC_CONTACT_EVENTS_SENDER_ID,
   SYNTHETIC_CONTACT_EVENTS_SENDER_NAME,

package/dist/{schemas-CI0qgcp_.d.cts → schemas-BotL3ZLH.d.cts}

@@ -1,10 +1,11 @@
-import { h as AgentToolsCapabilities, g as PlatformMessageLike, A as AdapterToolsProtocol, e as Preprocessor, F as FrameworkAdapter, i as PreprocessorContext } from './protocols-D2bTrQ_t.cjs';
-import { f as PlatformEvent, P as PlatformMessage, e as ConversationContext, S as SessionConfig, c as ContactEventConfig, A as AgentConfig, C as ContactEvent, a as AgentInput } from './types-CKqrhGB1.cjs';
-import { M as MetadataMap, P as ParticipantRecord } from './dtos-Dd_fTfLn.cjs';
+import { h as AgentToolsCapabilities, g as PlatformMessageLike, A as AdapterToolsProtocol, e as Preprocessor, F as FrameworkAdapter, i as PreprocessorContext } from './protocols-Bz1rxcUg.cjs';
+import { f as PlatformEvent, P as PlatformMessage, e as ConversationContext, S as SessionConfig, c as ContactEventConfig, A as AgentConfig, C as ContactEvent, a as AgentInput } from './types-D958TC71.cjs';
+import { M as MetadataMap, P as ParticipantRecord } from './dtos-B8KU_q4d.cjs';
 import { L as Logger } from './logger-CABQOnlR.cjs';
-import { T as ThenvoiLinkRestApi, b as RestRequestOptions, P as PaginatedResponse, e as AgentToolsRestApi } from './types-DtMms5Fi.cjs';
-import { P as PaginationOptions } from './pagination-CqidD-L_.cjs';
+import { B as BandLinkRestApi, b as RestRequestOptions, P as PaginatedResponse, e as AgentToolsRestApi } from './types-BgYFd_Yw.cjs';
+import { P as PaginationOptions } from './pagination-DqdkQArT.cjs';
 import { W as WebSocketConflictPolicy, b as WebSocketDisconnectReason } from './disconnectReason-IuADl6TH.cjs';
+import { RetryTracker } from '@band-ai/band-sdk-core';
 
 interface TopicHandlers {
     [event: string]: (payload: Record<string, unknown>) => Promise<void> | void;
@@ -18,12 +19,12 @@ interface StreamingTransport {
     isConnected(): boolean;
 }
 
-interface ThenvoiLinkOptions {
+interface BandLinkOptions {
     agentId: string;
     apiKey: string;
     wsUrl?: string;
     restUrl?: string;
-    restApi?: ThenvoiLinkRestApi;
+    restApi?: BandLinkRestApi;
     transport?: StreamingTransport;
     logger?: Logger;
     capabilities?: Partial<AgentToolsCapabilities>;
@@ -33,12 +34,12 @@ declare function deriveDefaultRestUrl(wsUrl: string): string;
 interface MessageMarkOptions {
     bestEffort?: boolean;
 }
-declare class ThenvoiLink implements AsyncIterable<PlatformEvent> {
+declare class BandLink implements AsyncIterable<PlatformEvent> {
     readonly agentId: string;
     private readonly apiKey;
     readonly wsUrl: string;
     readonly restUrl: string;
-    readonly rest: ThenvoiLinkRestApi;
+    readonly rest: BandLinkRestApi;
     readonly capabilities: AgentToolsCapabilities;
     private readonly logger;
     private readonly transport;
@@ -48,7 +49,7 @@ declare class ThenvoiLink implements AsyncIterable<PlatformEvent> {
     private connected;
     private lastDisconnectReason;
     private terminalDisconnectError;
-    constructor(options: ThenvoiLinkOptions);
+    constructor(options: BandLinkOptions);
     isConnected(): boolean;
     getDisconnectReason(): WebSocketDisconnectReason | null;
     connect(): Promise<void>;
@@ -79,21 +80,6 @@ declare class ThenvoiLink implements AsyncIterable<PlatformEvent> {
     private emit;
 }
 
-declare class MessageRetryTracker {
-    private readonly maxRetriesValue;
-    private readonly maxTracked;
-    private attempts;
-    private failed;
-    constructor(maxRetries?: number, maxTracked?: number);
-    get maxRetries(): number;
-    isPermanentlyFailed(messageId: string): boolean;
-    recordAttempt(messageId: string): [number, boolean];
-    markSuccess(messageId: string): void;
-    markPermanentlyFailed(messageId: string): void;
-    private evictMapIfNeeded;
-    private evictSetIfNeeded;
-}
-
 type ExecutionState = "starting" | "idle" | "processing";
 interface ExecutionContextLink {
     rest: AgentToolsRestApi;
@@ -118,11 +104,10 @@ declare class ExecutionContext {
     private readonly history;
     private messageIds;
     private readonly dedupCache;
-    private participants;
+    private readonly roster;
     private readonly tools;
     private readonly adapterTools;
     private participantsMessage;
-    private lastSentParticipantIds;
     private contactsMessage;
     private contextCache;
     private contextCacheExpiresAt;
@@ -133,7 +118,7 @@ declare class ExecutionContext {
     constructor(options: ExecutionContextOptions);
     get state(): ExecutionState;
     setState(state: ExecutionState): void;
-    getRetryTracker(): MessageRetryTracker;
+    getRetryTracker(): RetryTracker;
     get isLlmInitialized(): boolean;
     markLlmInitialized(): void;
     injectSystemMessage(message: string): void;
@@ -143,14 +128,13 @@ declare class ExecutionContext {
     recordMessage(message: PlatformMessage): void;
     getRawHistory(): MetadataMap[];
     setParticipants(participants: ParticipantRecord[]): void;
-    addParticipant(participant: ParticipantRecord): void;
+    addParticipant(participant: Partial<ParticipantRecord> & Pick<ParticipantRecord, "id">): void;
     removeParticipant(participantId: string): void;
     setContactsMessage(message: string | null): void;
     consumeParticipantsMessage(): string | null;
     consumeContactsMessage(): string | null;
     getHydratedHistory(excludeMessageId?: string): Promise<MetadataMap[]>;
     hydrateContext(forceRefresh?: boolean): Promise<ConversationContext>;
-    private replaceParticipants;
     private buildLocalContext;
     private loadParticipants;
     private loadHydratedMessages;
@@ -167,8 +151,8 @@ interface PlatformRuntimeOptions {
     apiKey: string;
     wsUrl?: string;
     restUrl?: string;
-    link?: ThenvoiLink;
-    linkOptions?: Omit<ThenvoiLinkOptions, "agentId" | "apiKey">;
+    link?: BandLink;
+    linkOptions?: Omit<BandLinkOptions, "agentId" | "apiKey">;
     preprocessor?: Preprocessor<PlatformEvent>;
     sessionConfig?: SessionConfig;
     contactConfig?: ContactEventConfig;
@@ -209,7 +193,7 @@ declare class PlatformRuntime {
     private _agentDescription;
     private contactsSubscribed;
     constructor(options: PlatformRuntimeOptions);
-    get link(): ThenvoiLink;
+    get link(): BandLink;
     get name(): string;
     get agentId(): string;
     get description(): string;
@@ -227,7 +211,7 @@ declare class PlatformRuntime {
 }
 
 interface AgentRuntimeOptions {
-    link: ThenvoiLink;
+    link: BandLink;
     agentId: string;
     onExecute: (context: ExecutionContext, event: PlatformEvent) => Promise<void>;
     onSessionCleanup?: (roomId: string) => Promise<void>;
@@ -293,7 +277,7 @@ declare class DefaultPreprocessor implements Preprocessor<PlatformEvent> {
 }
 
 declare const TOOL_MODELS: {
-    readonly thenvoi_send_message: {
+    readonly band_send_message: {
         readonly description: string;
         readonly properties: {
             readonly content: {
@@ -311,7 +295,7 @@ declare const TOOL_MODELS: {
         };
         readonly required: readonly ["content", "mentions"];
     };
-    readonly thenvoi_send_event: {
+    readonly band_send_event: {
         readonly description: string;
         readonly properties: {
             readonly content: {
@@ -330,12 +314,12 @@ declare const TOOL_MODELS: {
         };
         readonly required: readonly ["content", "message_type"];
     };
-    readonly thenvoi_add_participant: {
+    readonly band_add_participant: {
         readonly description: string;
         readonly properties: {
             readonly name: {
                 readonly type: "string";
-                readonly description: "Name of participant to add (must match a name from thenvoi_lookup_peers).";
+                readonly description: "Name of participant to add (must match a name from band_lookup_peers).";
             };
             readonly role: {
                 readonly type: "string";
@@ -345,7 +329,7 @@ declare const TOOL_MODELS: {
         };
         readonly required: readonly ["name"];
     };
-    readonly thenvoi_remove_participant: {
+    readonly band_remove_participant: {
         readonly description: "Remove a participant from the chat room by name.";
         readonly properties: {
             readonly name: {
@@ -355,12 +339,12 @@ declare const TOOL_MODELS: {
         };
         readonly required: readonly ["name"];
     };
-    readonly thenvoi_get_participants: {
+    readonly band_get_participants: {
         readonly description: "Get a list of all participants in the current chat room.";
         readonly properties: {};
         readonly required: readonly [];
     };
-    readonly thenvoi_lookup_peers: {
+    readonly band_lookup_peers: {
         readonly description: string;
         readonly properties: {
             readonly page: {
@@ -375,7 +359,7 @@ declare const TOOL_MODELS: {
         };
         readonly required: readonly [];
     };
-    readonly thenvoi_create_chatroom: {
+    readonly band_create_chatroom: {
         readonly description: "Create a new chat room for a specific task or conversation.";
         readonly properties: {
             readonly task_id: {
@@ -385,7 +369,7 @@ declare const TOOL_MODELS: {
         };
         readonly required: readonly [];
     };
-    readonly thenvoi_list_contacts: {
+    readonly band_list_contacts: {
         readonly description: "List agent's contacts with pagination.";
         readonly properties: {
             readonly page: {
@@ -402,7 +386,7 @@ declare const TOOL_MODELS: {
         };
         readonly required: readonly [];
     };
-    readonly thenvoi_add_contact: {
+    readonly band_add_contact: {
         readonly description: string;
         readonly properties: {
             readonly handle: {
@@ -416,7 +400,7 @@ declare const TOOL_MODELS: {
         };
         readonly required: readonly ["handle"];
     };
-    readonly thenvoi_remove_contact: {
+    readonly band_remove_contact: {
         readonly description: "Remove an existing contact by handle or ID.";
         readonly properties: {
             readonly handle: {
@@ -430,7 +414,7 @@ declare const TOOL_MODELS: {
         };
         readonly required: readonly [];
     };
-    readonly thenvoi_list_contact_requests: {
+    readonly band_list_contact_requests: {
         readonly description: string;
         readonly properties: {
             readonly page: {
@@ -452,7 +436,7 @@ declare const TOOL_MODELS: {
         };
         readonly required: readonly [];
     };
-    readonly thenvoi_respond_contact_request: {
+    readonly band_respond_contact_request: {
         readonly description: string;
         readonly properties: {
             readonly action: {
@@ -471,7 +455,7 @@ declare const TOOL_MODELS: {
         };
         readonly required: readonly ["action"];
     };
-    readonly thenvoi_list_memories: {
+    readonly band_list_memories: {
         readonly description: string;
         readonly properties: {
             readonly subject_id: {
@@ -516,7 +500,7 @@ declare const TOOL_MODELS: {
         };
         readonly required: readonly [];
     };
-    readonly thenvoi_store_memory: {
+    readonly band_store_memory: {
         readonly description: string;
         readonly properties: {
             readonly content: {
@@ -558,7 +542,7 @@ declare const TOOL_MODELS: {
         };
         readonly required: readonly ["content", "system", "type", "segment", "thought"];
     };
-    readonly thenvoi_get_memory: {
+    readonly band_get_memory: {
         readonly description: "Retrieve a specific memory by ID.";
         readonly properties: {
             readonly memory_id: {
@@ -568,7 +552,7 @@ declare const TOOL_MODELS: {
         };
         readonly required: readonly ["memory_id"];
     };
-    readonly thenvoi_supersede_memory: {
+    readonly band_supersede_memory: {
         readonly description: string;
         readonly properties: {
             readonly memory_id: {
@@ -578,7 +562,7 @@ declare const TOOL_MODELS: {
         };
         readonly required: readonly ["memory_id"];
     };
-    readonly thenvoi_archive_memory: {
+    readonly band_archive_memory: {
         readonly description: string;
         readonly properties: {
             readonly memory_id: {
@@ -594,8 +578,10 @@ declare const MEMORY_TOOL_NAMES: Set<string>;
 declare const CONTACT_TOOL_NAMES: Set<string>;
 declare const BASE_TOOL_NAMES: Set<string>;
 declare const CHAT_TOOL_NAMES: Set<string>;
-declare const MCP_TOOL_PREFIX = "mcp__thenvoi__";
+declare const MCP_TOOL_PREFIX = "mcp__band__";
+/** The single Band MCP server name; owns every server-name default and integration. */
+declare const MCP_SERVER_NAME = "band";
 declare function mcpToolNames(names: Set<string>): string[];
 declare function getToolDescription(name: string): string;
 
-export { AgentRuntime as A, BASE_TOOL_NAMES as B, CHAT_TOOL_NAMES as C, DefaultPreprocessor as D, type ExecutionContextOptions as E, MCP_TOOL_PREFIX as M, PlatformRuntime as P, TOOL_MODELS as T, type PlatformRuntimeOptions as a, ThenvoiLink as b, ExecutionContext as c, deriveDefaultRestUrl as d, ALL_TOOL_NAMES as e, CONTACT_TOOL_NAMES as f, type ExecutionState as g, MEMORY_TOOL_NAMES as h, MessageRetryTracker as i, getToolDescription as j, mcpToolNames as m };
+export { AgentRuntime as A, BandLink as B, CHAT_TOOL_NAMES as C, DefaultPreprocessor as D, type ExecutionContextOptions as E, MCP_SERVER_NAME as M, PlatformRuntime as P, TOOL_MODELS as T, type PlatformRuntimeOptions as a, MCP_TOOL_PREFIX as b, ExecutionContext as c, deriveDefaultRestUrl as d, ALL_TOOL_NAMES as e, BASE_TOOL_NAMES as f, CONTACT_TOOL_NAMES as g, type ExecutionState as h, MEMORY_TOOL_NAMES as i, getToolDescription as j, mcpToolNames as m };