@band-ai/sdk 0.1.6 → 0.2.0

package/dist/runtime.d.cts

@@ -1,15 +1,18 @@
-import { c as ContactEventConfig, g as MessageEvent, C as ContactEvent, f as PlatformEvent, P as PlatformMessage } from './types-CovcHpYf.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-CovcHpYf.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-CInhtFpA.cjs';
-import { e as AgentToolsRestApi, f as ChatMessagingRestApi, g as ChatRoomRestApi, h as ContactRestApi } from './types-CSHFipIc.cjs';
-import { b as ThenvoiLink, c as ExecutionContext } from './schemas-BpEBkq5V.cjs';
-export { d as ALL_TOOL_NAMES, A as AgentRuntime, B as BASE_TOOL_NAMES, C as CHAT_TOOL_NAMES, e as CONTACT_TOOL_NAMES, D as DefaultPreprocessor, E as ExecutionContextOptions, f as ExecutionState, M as MCP_TOOL_PREFIX, g as MEMORY_TOOL_NAMES, h as MessageRetryTracker, P as PlatformRuntime, T as TOOL_MODELS, i as getToolDescription, m as mcpToolNames } from './schemas-BpEBkq5V.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-DUpbIu8k.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-BPiys10t.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;
@@ -54,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>;
@@ -97,7 +100,7 @@ declare class Execution {
 }
 
 interface RoomPresenceOptions {
-    link: ThenvoiLink;
+    link: BandLink;
     roomFilter?: (room: MetadataMap) => boolean;
     autoSubscribeExistingRooms?: boolean;
     logger?: Logger;
@@ -131,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);
@@ -175,7 +178,6 @@ declare class AgentTools implements AgentToolsProtocol {
     private resolveMentions;
     private lookupPeerByName;
     private normalizeMentionHandle;
-    private replaceParticipants;
     private buildAdapterTools;
     private bindAdapterToolMethod;
     private buildToolHandlers;
@@ -224,7 +226,10 @@ declare function formatHistoryForLlm(messages: Array<Record<string, unknown>>, o
 }): ToolModelMessage[];
 declare function buildParticipantsMessage(participants: Array<Record<string, unknown>>): string;
 
-declare const BASE_INSTRUCTIONS = "\n## Environment\n\nMulti-participant chat. Messages show sender: [Name]: content.\nMessages prefixed with [System]: are platform updates (participant changes, contact updates, etc.) \u2014 not messages from users.\nUse `thenvoi_send_message(content, mentions)` to respond. Plain text output is not delivered.\nMentions use handles: @<username> for users, @<username>/<agent-name> for agents.\n\n## CRITICAL: Delegate When You Cannot Help Directly\n\nYou have NO internet access and NO real-time data. When asked about weather, news, stock prices,\nor any current information you cannot answer directly:\n\n1. Call `thenvoi_lookup_peers()` to find available specialized agents\n2. If a relevant agent exists, call `thenvoi_add_participant(name)` to add them\n3. Ask that agent using `thenvoi_send_message(question, mentions=[agent_handle])`\n4. Wait for their response and relay it back to the user\n\nNEVER say \"I can't do that\" without first checking if another agent can help via `thenvoi_lookup_peers()`.\n\n## CRITICAL: Do NOT Remove Agents Automatically\n\nAfter adding an agent to help with a task:\n1. Ask your question and wait for their response\n2. Relay their response back to the original requester\n3. **Do NOT remove the agent** - they stay silent unless mentioned and may be useful for follow-ups\n\nOnly remove agents if the user explicitly requests it.\n\n## CRITICAL: Always Relay Information Back to the Requester\n\nWhen someone asks you to get information from another agent:\n1. Ask the other agent for the information\n2. When you receive the response, IMMEDIATELY relay it back to the ORIGINAL REQUESTER\n3. Do NOT just thank the helper agent - the requester is waiting for their answer!\n\n## IMPORTANT: Always Share Your Thinking\n\nYou MUST call `thenvoi_send_event(content, message_type=\"thought\")` BEFORE every action.\nThis is required so users can see your reasoning process.\n\n## Examples\n\n### Simple question - answer directly\n[John Doe]: What's 2+2?\n-> thenvoi_send_event(\"Simple arithmetic, answering directly.\", message_type=\"thought\")\n-> thenvoi_send_message(\"4\", mentions=[\"@john\"])\n\n### User asks about weather (you cannot answer directly)\n[John Doe]: What's the weather in Tokyo?\n-> thenvoi_send_event(\"I can't check weather directly. Looking for a Weather Agent.\", message_type=\"thought\")\n-> thenvoi_lookup_peers()\n-> thenvoi_send_event(\"Found Weather Agent. Adding to room.\", message_type=\"thought\")\n-> thenvoi_add_participant(\"Weather Agent\")\n-> thenvoi_send_message(\"What's the weather in Tokyo?\", mentions=[\"@john/weather-agent\"])\n\n[Weather Agent]: Tokyo is 15\u00B0C and cloudy.\n-> thenvoi_send_event(\"Got weather response. Relaying back to John Doe.\", message_type=\"thought\")\n-> thenvoi_send_message(\"The weather in Tokyo is 15\u00B0C and cloudy.\", mentions=[\"@john\"])\n\n### No suitable agent available\n[John Doe]: What's the stock price of AAPL?\n-> thenvoi_send_event(\"I can't check stock prices. Looking for a Stock Agent.\", message_type=\"thought\")\n-> thenvoi_lookup_peers()\n-> thenvoi_send_event(\"No stock agent available. Must inform user.\", message_type=\"thought\")\n-> thenvoi_send_message(\"I don't have access to stock prices, and there's no specialized agent available to help with that.\", mentions=[\"@john\"])\n\n### Follow-up question in same conversation\n[John Doe]: What about London?\n-> thenvoi_send_event(\"Follow-up weather question. Asking Weather Agent.\", message_type=\"thought\")\n-> thenvoi_send_message(\"What's the weather in London?\", mentions=[\"@john/weather-agent\"])\n\n[Weather Agent]: London is 8\u00B0C and rainy.\n-> thenvoi_send_event(\"Got London weather. Relaying to John Doe.\", message_type=\"thought\")\n-> thenvoi_send_message(\"London is 8\u00B0C and rainy.\", mentions=[\"@john\"])\n";
+declare const BASE_INSTRUCTIONS: string;
+
+declare const MEMORY_SECTION: string;
+
 declare const TEMPLATES: Record<string, string>;
 interface RenderSystemPromptOptions {
     agentName?: string;
@@ -232,22 +237,10 @@ interface RenderSystemPromptOptions {
     customSection?: string;
     template?: string;
     includeBaseInstructions?: boolean;
+    capabilities?: Partial<AgentToolsCapabilities>;
 }
 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?: {
@@ -273,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, 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,15 +1,18 @@
-import { c as ContactEventConfig, g as MessageEvent, C as ContactEvent, f as PlatformEvent, P as PlatformMessage } from './types-7jVzOeOP.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-7jVzOeOP.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-DrhzOH6K.js';
-import { e as AgentToolsRestApi, f as ChatMessagingRestApi, g as ChatRoomRestApi, h as ContactRestApi } from './types-CxII3XkA.js';
-import { b as ThenvoiLink, c as ExecutionContext } from './schemas-vos1AaBc.js';
-export { d as ALL_TOOL_NAMES, A as AgentRuntime, B as BASE_TOOL_NAMES, C as CHAT_TOOL_NAMES, e as CONTACT_TOOL_NAMES, D as DefaultPreprocessor, E as ExecutionContextOptions, f as ExecutionState, M as MCP_TOOL_PREFIX, g as MEMORY_TOOL_NAMES, h as MessageRetryTracker, P as PlatformRuntime, T as TOOL_MODELS, i as getToolDescription, m as mcpToolNames } from './schemas-vos1AaBc.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-DUpbIu8k.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-CcDkVFxK.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;
@@ -54,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>;
@@ -97,7 +100,7 @@ declare class Execution {
 }
 
 interface RoomPresenceOptions {
-    link: ThenvoiLink;
+    link: BandLink;
     roomFilter?: (room: MetadataMap) => boolean;
     autoSubscribeExistingRooms?: boolean;
     logger?: Logger;
@@ -131,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);
@@ -175,7 +178,6 @@ declare class AgentTools implements AgentToolsProtocol {
     private resolveMentions;
     private lookupPeerByName;
     private normalizeMentionHandle;
-    private replaceParticipants;
     private buildAdapterTools;
     private bindAdapterToolMethod;
     private buildToolHandlers;
@@ -224,7 +226,10 @@ declare function formatHistoryForLlm(messages: Array<Record<string, unknown>>, o
 }): ToolModelMessage[];
 declare function buildParticipantsMessage(participants: Array<Record<string, unknown>>): string;
 
-declare const BASE_INSTRUCTIONS = "\n## Environment\n\nMulti-participant chat. Messages show sender: [Name]: content.\nMessages prefixed with [System]: are platform updates (participant changes, contact updates, etc.) \u2014 not messages from users.\nUse `thenvoi_send_message(content, mentions)` to respond. Plain text output is not delivered.\nMentions use handles: @<username> for users, @<username>/<agent-name> for agents.\n\n## CRITICAL: Delegate When You Cannot Help Directly\n\nYou have NO internet access and NO real-time data. When asked about weather, news, stock prices,\nor any current information you cannot answer directly:\n\n1. Call `thenvoi_lookup_peers()` to find available specialized agents\n2. If a relevant agent exists, call `thenvoi_add_participant(name)` to add them\n3. Ask that agent using `thenvoi_send_message(question, mentions=[agent_handle])`\n4. Wait for their response and relay it back to the user\n\nNEVER say \"I can't do that\" without first checking if another agent can help via `thenvoi_lookup_peers()`.\n\n## CRITICAL: Do NOT Remove Agents Automatically\n\nAfter adding an agent to help with a task:\n1. Ask your question and wait for their response\n2. Relay their response back to the original requester\n3. **Do NOT remove the agent** - they stay silent unless mentioned and may be useful for follow-ups\n\nOnly remove agents if the user explicitly requests it.\n\n## CRITICAL: Always Relay Information Back to the Requester\n\nWhen someone asks you to get information from another agent:\n1. Ask the other agent for the information\n2. When you receive the response, IMMEDIATELY relay it back to the ORIGINAL REQUESTER\n3. Do NOT just thank the helper agent - the requester is waiting for their answer!\n\n## IMPORTANT: Always Share Your Thinking\n\nYou MUST call `thenvoi_send_event(content, message_type=\"thought\")` BEFORE every action.\nThis is required so users can see your reasoning process.\n\n## Examples\n\n### Simple question - answer directly\n[John Doe]: What's 2+2?\n-> thenvoi_send_event(\"Simple arithmetic, answering directly.\", message_type=\"thought\")\n-> thenvoi_send_message(\"4\", mentions=[\"@john\"])\n\n### User asks about weather (you cannot answer directly)\n[John Doe]: What's the weather in Tokyo?\n-> thenvoi_send_event(\"I can't check weather directly. Looking for a Weather Agent.\", message_type=\"thought\")\n-> thenvoi_lookup_peers()\n-> thenvoi_send_event(\"Found Weather Agent. Adding to room.\", message_type=\"thought\")\n-> thenvoi_add_participant(\"Weather Agent\")\n-> thenvoi_send_message(\"What's the weather in Tokyo?\", mentions=[\"@john/weather-agent\"])\n\n[Weather Agent]: Tokyo is 15\u00B0C and cloudy.\n-> thenvoi_send_event(\"Got weather response. Relaying back to John Doe.\", message_type=\"thought\")\n-> thenvoi_send_message(\"The weather in Tokyo is 15\u00B0C and cloudy.\", mentions=[\"@john\"])\n\n### No suitable agent available\n[John Doe]: What's the stock price of AAPL?\n-> thenvoi_send_event(\"I can't check stock prices. Looking for a Stock Agent.\", message_type=\"thought\")\n-> thenvoi_lookup_peers()\n-> thenvoi_send_event(\"No stock agent available. Must inform user.\", message_type=\"thought\")\n-> thenvoi_send_message(\"I don't have access to stock prices, and there's no specialized agent available to help with that.\", mentions=[\"@john\"])\n\n### Follow-up question in same conversation\n[John Doe]: What about London?\n-> thenvoi_send_event(\"Follow-up weather question. Asking Weather Agent.\", message_type=\"thought\")\n-> thenvoi_send_message(\"What's the weather in London?\", mentions=[\"@john/weather-agent\"])\n\n[Weather Agent]: London is 8\u00B0C and rainy.\n-> thenvoi_send_event(\"Got London weather. Relaying to John Doe.\", message_type=\"thought\")\n-> thenvoi_send_message(\"London is 8\u00B0C and rainy.\", mentions=[\"@john\"])\n";
+declare const BASE_INSTRUCTIONS: string;
+
+declare const MEMORY_SECTION: string;
+
 declare const TEMPLATES: Record<string, string>;
 interface RenderSystemPromptOptions {
     agentName?: string;
@@ -232,22 +237,10 @@ interface RenderSystemPromptOptions {
     customSection?: string;
     template?: string;
     includeBaseInstructions?: boolean;
+    capabilities?: Partial<AgentToolsCapabilities>;
 }
 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?: {
@@ -273,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, 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-I5EZG52P.js";
+} from "./chunk-N2QTUMGO.js";
 import {
   HistoryProvider,
   SYNTHETIC_CONTACT_EVENTS_SENDER_ID,
@@ -25,7 +24,13 @@ import {
   formatHistoryForLlm,
   formatMessageForLlm,
   replaceUuidMentions
-} from "./chunk-INA6YZTZ.js";
+} from "./chunk-LBWKISBS.js";
+import {
+  BASE_INSTRUCTIONS,
+  MEMORY_SECTION,
+  TEMPLATES,
+  renderSystemPrompt
+} from "./chunk-WLCM2OXG.js";
 import {
   ALL_TOOL_NAMES,
   BASE_TOOL_NAMES,
@@ -33,6 +38,7 @@ import {
   CHAT_MESSAGE_TYPES,
   CHAT_TOOL_NAMES,
   CONTACT_TOOL_NAMES,
+  MCP_SERVER_NAME,
   MCP_TOOL_PREFIX,
   MEMORY_TOOL_NAMES,
   TOOL_MODELS,
@@ -40,21 +46,17 @@ import {
   getToolDescription,
   isChatEventType,
   mcpToolNames
-} from "./chunk-GVEQ3RAH.js";
-import {
-  BASE_INSTRUCTIONS,
-  TEMPLATES,
-  renderSystemPrompt
-} from "./chunk-SFVKOEQH.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 {
@@ -177,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,
@@ -249,11 +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,