@band-ai/sdk 0.1.10 → 0.2.0

package/dist/runtime.cjs

@@ -37,12 +37,13 @@ __export(runtime_exports, {
   GracefulShutdown: () => GracefulShutdown,
   HUB_ROOM_SYSTEM_PROMPT: () => HUB_ROOM_SYSTEM_PROMPT,
   HistoryProvider: () => HistoryProvider,
+  MCP_SERVER_NAME: () => MCP_SERVER_NAME,
   MCP_TOOL_PREFIX: () => MCP_TOOL_PREFIX,
   MEMORY_SECTION: () => MEMORY_SECTION,
   MEMORY_TOOL_NAMES: () => MEMORY_TOOL_NAMES,
-  MessageRetryTracker: () => MessageRetryTracker,
-  ParticipantTracker: () => ParticipantTracker,
+  ParticipantRoster: () => import_band_sdk_core3.ParticipantRoster,
   PlatformRuntime: () => PlatformRuntime,
+  RetryTracker: () => import_band_sdk_core3.RetryTracker,
   RoomPresence: () => RoomPresence,
   SYNTHETIC_CONTACT_EVENTS_SENDER_ID: () => SYNTHETIC_CONTACT_EVENTS_SENDER_ID,
   SYNTHETIC_CONTACT_EVENTS_SENDER_NAME: () => SYNTHETIC_CONTACT_EVENTS_SENDER_NAME,
@@ -99,39 +100,112 @@ var NoopLogger = class {
 var DEFAULT_REQUEST_OPTIONS = {
   maxRetries: 3
 };
+var MESSAGE_SEND_MAX_RETRIES = 2;
 
 // src/core/errors.ts
-var ThenvoiSdkError = class extends Error {
+var BandSdkError = class extends Error {
   constructor(message, cause) {
     super(message, cause !== void 0 ? { cause } : void 0);
-    this.name = "ThenvoiSdkError";
+    this.name = "BandSdkError";
   }
 };
-var UnsupportedFeatureError = class extends ThenvoiSdkError {
+var UnsupportedFeatureError = class extends BandSdkError {
   constructor(message) {
     super(message);
     this.name = "UnsupportedFeatureError";
   }
 };
-var ValidationError = class extends ThenvoiSdkError {
+var ValidationError = class extends BandSdkError {
   constructor(message, cause) {
     super(message, cause);
     this.name = "ValidationError";
   }
 };
-var TransportError = class extends ThenvoiSdkError {
+var TransportError = class extends BandSdkError {
   constructor(message, cause) {
     super(message, cause);
     this.name = "TransportError";
   }
 };
-var RuntimeStateError = class extends ThenvoiSdkError {
+var RuntimeStateError = class extends BandSdkError {
   constructor(message) {
     super(message);
     this.name = "RuntimeStateError";
   }
 };
 
+// src/runtime/formatters.ts
+function isMetadataMap(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function replaceUuidMentions(content, participants) {
+  if (!content || participants.length === 0) {
+    return content;
+  }
+  let next = content;
+  for (const participant of participants) {
+    const participantId = participant.id;
+    const handle = participant.handle;
+    if (typeof participantId === "string" && typeof handle === "string") {
+      next = next.replaceAll(`@[[${participantId}]]`, ensureHandlePrefix(handle) ?? "");
+    }
+  }
+  return next;
+}
+function formatMessageForLlm(message, participants) {
+  const senderType = String(message.sender_type ?? "");
+  const senderName = String(message.sender_name ?? message.name ?? senderType);
+  const content = participants ? replaceUuidMentions(String(message.content ?? ""), participants) : String(message.content ?? "");
+  return {
+    role: senderType === "Agent" ? "assistant" : "user",
+    content,
+    sender_name: senderName,
+    sender_type: senderType,
+    message_type: String(message.message_type ?? "text"),
+    metadata: isMetadataMap(message.metadata) ? message.metadata : {}
+  };
+}
+function formatHistoryForLlm(messages, options) {
+  const excludeId = options?.excludeId;
+  const participants = options?.participants;
+  return messages.filter((message) => String(message.id ?? "") !== excludeId).map((message) => formatMessageForLlm(message, participants));
+}
+function toParticipantRecord(fields) {
+  return {
+    id: fields.id,
+    name: fields.name ?? "unknown",
+    type: fields.type ?? "unknown",
+    handle: fields.handle ?? null
+  };
+}
+function toParticipantRecordFromRest(participant) {
+  return {
+    id: participant.id,
+    name: participant.name,
+    type: participant.type,
+    handle: participant.handle ?? null
+  };
+}
+function buildParticipantsMessage(participants) {
+  if (participants.length === 0) {
+    return "## Current Participants\nNo other participants in this room.";
+  }
+  const lines = ["## Current Participants"];
+  for (const participant of participants) {
+    const participantType = String(participant.type ?? "Unknown");
+    const participantName = String(participant.name ?? "Unknown");
+    const participantHandle = String(participant.handle ?? "Unknown");
+    lines.push(
+      `- ${ensureHandlePrefix(participantHandle) ?? ""} \u2014 ${participantName} (${participantType})`
+    );
+  }
+  lines.push("");
+  lines.push(
+    "IMPORTANT: In band_send_message mentions, always use the exact handle shown above (e.g. '@john' for users, '@john/weather-agent' for agents), NOT the display name. Handles are lowercase with no spaces."
+  );
+  return lines.join("\n");
+}
+
 // src/runtime/tools/ContactToolsImpl.ts
 var ContactToolsImpl = class {
   rest;
@@ -228,14 +302,6 @@ var ContactToolsImpl = class {
 };
 
 // src/runtime/tools/ContactCallbackTools.ts
-function toParticipantRecord(participant) {
-  return {
-    id: participant.id,
-    name: participant.name,
-    type: participant.type,
-    handle: participant.handle ?? null
-  };
-}
 function normalizePage(value, fallback) {
   return Number.isInteger(value) && value && value > 0 ? value : fallback;
 }
@@ -279,8 +345,7 @@ var ContactCallbackTools = class {
       {
         content,
         ...normalizedMentions ? { mentions: normalizedMentions } : {}
-      },
-      DEFAULT_REQUEST_OPTIONS
+      }
     );
   }
   async sendEvent(content, messageType, metadata) {
@@ -294,8 +359,7 @@ var ContactCallbackTools = class {
         content,
         messageType,
         ...metadata ? { metadata } : {}
-      },
-      DEFAULT_REQUEST_OPTIONS
+      }
     );
   }
   async addParticipant() {
@@ -309,7 +373,7 @@ var ContactCallbackTools = class {
     if (!this.rest.listChatParticipants) {
       throw new UnsupportedFeatureError("Participant listing is not available in current REST adapter");
     }
-    return (await this.rest.listChatParticipants(roomId, DEFAULT_REQUEST_OPTIONS)).map(toParticipantRecord);
+    return (await this.rest.listChatParticipants(roomId, DEFAULT_REQUEST_OPTIONS)).map(toParticipantRecordFromRest);
   }
   async createChatroom(taskId) {
     const chat = await this.rest.createChat(taskId, DEFAULT_REQUEST_OPTIONS);
@@ -399,48 +463,48 @@ var ContactCallbackTools = class {
   }
   async executeToolCall(toolName, toolArgs) {
     switch (toolName) {
-      case "thenvoi_send_message":
+      case "band_send_message":
         return this.sendMessage(
           String(toolArgs.content ?? ""),
           toolArgs.mentions
         );
-      case "thenvoi_send_event":
+      case "band_send_event":
         return this.sendEvent(
           String(toolArgs.content ?? ""),
           String(toolArgs.message_type ?? "task"),
           toolArgs.metadata
         );
-      case "thenvoi_get_participants":
+      case "band_get_participants":
         return this.getParticipants();
-      case "thenvoi_create_chatroom":
+      case "band_create_chatroom":
         return this.createChatroom(typeof toolArgs.task_id === "string" ? toolArgs.task_id : void 0);
-      case "thenvoi_lookup_peers":
+      case "band_lookup_peers":
         return this.lookupPeers(
           typeof toolArgs.page === "number" ? toolArgs.page : void 0,
           typeof toolArgs.page_size === "number" ? toolArgs.page_size : void 0
         );
-      case "thenvoi_list_contacts":
+      case "band_list_contacts":
         return this.listContacts({
           page: typeof toolArgs.page === "number" ? toolArgs.page : void 0,
           pageSize: typeof toolArgs.page_size === "number" ? toolArgs.page_size : void 0
         });
-      case "thenvoi_add_contact":
+      case "band_add_contact":
         return this.addContact({
           handle: String(toolArgs.handle ?? ""),
           ...typeof toolArgs.message === "string" ? { message: toolArgs.message } : {}
         });
-      case "thenvoi_remove_contact":
+      case "band_remove_contact":
         if (typeof toolArgs.contact_id === "string") {
           return this.removeContact({ target: "contactId", contactId: toolArgs.contact_id });
         }
         return this.removeContact({ target: "handle", handle: String(toolArgs.handle ?? "") });
-      case "thenvoi_list_contact_requests":
+      case "band_list_contact_requests":
         return this.listContactRequests({
           page: typeof toolArgs.page === "number" ? toolArgs.page : void 0,
           pageSize: typeof toolArgs.page_size === "number" ? toolArgs.page_size : void 0,
           sentStatus: typeof toolArgs.sent_status === "string" ? toolArgs.sent_status : void 0
         });
-      case "thenvoi_respond_contact_request":
+      case "band_respond_contact_request":
         if (typeof toolArgs.request_id === "string") {
           return this.respondContactRequest({
             action: String(toolArgs.action ?? "approve"),
@@ -453,15 +517,15 @@ var ContactCallbackTools = class {
           target: "handle",
           handle: String(toolArgs.handle ?? "")
         });
-      case "thenvoi_list_memories":
+      case "band_list_memories":
         return this.listMemories(toolArgs);
-      case "thenvoi_store_memory":
+      case "band_store_memory":
         return this.storeMemory(toolArgs);
-      case "thenvoi_get_memory":
+      case "band_get_memory":
         return this.getMemory(String(toolArgs.memory_id ?? ""));
-      case "thenvoi_supersede_memory":
+      case "band_supersede_memory":
         return this.supersedeMemory(String(toolArgs.memory_id ?? ""));
-      case "thenvoi_archive_memory":
+      case "band_archive_memory":
         return this.archiveMemory(String(toolArgs.memory_id ?? ""));
       default:
         throw new UnsupportedFeatureError(`Unsupported tool call for contact callback: ${toolName}`);
@@ -475,14 +539,14 @@ var HUB_ROOM_SYSTEM_PROMPT = `## OVERRIDE: Contact Management Mode
 
 This is your CONTACTS HUB - a dedicated room for managing contact requests.
 
-**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.
+**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.
 
 ## Your Role
 
 1. **Review incoming contact requests** - When you see a [Contact Request] message, evaluate it
 2. **Take action** - Use the contact tools to respond:
-   - \`thenvoi_respond_contact_request(action="approve", request_id="...")\` to accept
-   - \`thenvoi_respond_contact_request(action="reject", request_id="...")\` to decline
+   - \`band_respond_contact_request(action="approve", request_id="...")\` to accept
+   - \`band_respond_contact_request(action="reject", request_id="...")\` to decline
 3. **Report your decision** - Send a thought event explaining what you did
 
 ## Example
@@ -491,14 +555,14 @@ This is your CONTACTS HUB - a dedicated room for managing contact requests.
 Request ID: abc-123
 
 Your response:
-1. thenvoi_send_event("Received contact request from Alice. Approving.", message_type="thought")
-2. thenvoi_respond_contact_request(action="approve", request_id="abc-123")
-3. thenvoi_send_event("Approved contact request from Alice (@alice)", message_type="thought")
+1. band_send_event("Received contact request from Alice. Approving.", message_type="thought")
+2. band_respond_contact_request(action="approve", request_id="abc-123")
+3. band_send_event("Approved contact request from Alice (@alice)", message_type="thought")
 
 ## Contact Tools (use these, NOT participant tools)
-- \`thenvoi_respond_contact_request(action, request_id)\` - Approve/reject requests
-- \`thenvoi_list_contact_requests()\` - List pending requests
-- \`thenvoi_list_contacts()\` - List current contacts`;
+- \`band_respond_contact_request(action, request_id)\` - Approve/reject requests
+- \`band_list_contact_requests()\` - List pending requests
+- \`band_list_contacts()\` - List current contacts`;
 var ContactEventHandlerError = class extends Error {
   retryable;
   stage;
@@ -1118,6 +1182,9 @@ var Execution = class {
   }
 };
 
+// src/runtime/tools/AgentTools.ts
+var import_band_sdk_core = require("@band-ai/band-sdk-core");
+
 // src/contracts/capabilities.ts
 var CAPABILITY_LABELS = {
   peers: "Peer lookup",
@@ -1234,9 +1301,9 @@ var MEMORY_STATUSES = [
   "active",
   // Normal, visible memories
   "superseded",
-  // Outdated; soft-deleted via thenvoi_supersede_memory
+  // Outdated; soft-deleted via band_supersede_memory
   "archived",
-  // Hidden but preserved via thenvoi_archive_memory
+  // Hidden but preserved via band_archive_memory
   "all"
   // Any status (no filter)
 ];
@@ -1277,7 +1344,7 @@ function memoryTypeForSystemError(system) {
 
 // src/runtime/tools/schemas.ts
 var TOOL_MODELS = {
-  thenvoi_send_message: {
+  band_send_message: {
     description: "Send a message to the chat room. Use this to respond to users or other agents. Messages require at least one @mention in the mentions array. You MUST use this tool to communicate \u2014 plain text responses won't reach users. When delegating, send the full task context in this message instead of assuming hidden state.",
     properties: {
       content: {
@@ -1293,7 +1360,7 @@ var TOOL_MODELS = {
     },
     required: ["content", "mentions"]
   },
-  thenvoi_send_event: {
+  band_send_event: {
     description: "Send an event to the chat room. No mentions required. 'thought': Share your reasoning or plan BEFORE taking actions. Explain what you're about to do and why. 'error': Report an error or problem that occurred. 'task': Report task progress or completion status. Always send a thought before complex actions to keep users informed.",
     properties: {
       content: {
@@ -1312,12 +1379,12 @@ var TOOL_MODELS = {
     },
     required: ["content", "message_type"]
   },
-  thenvoi_add_participant: {
-    description: "Add a participant (agent or user) to the chat room by name. IMPORTANT: Use thenvoi_lookup_peers() first to find available agents. Pass the exact peer name from thenvoi_lookup_peers, not the handle. For normal delegation, omit role or use 'member'.",
+  band_add_participant: {
+    description: "Add a participant (agent or user) to the chat room by name. IMPORTANT: Use band_lookup_peers() first to find available agents. Pass the exact peer name from band_lookup_peers, not the handle. For normal delegation, omit role or use 'member'.",
     properties: {
       name: {
         type: "string",
-        description: "Name of participant to add (must match a name from thenvoi_lookup_peers)."
+        description: "Name of participant to add (must match a name from band_lookup_peers)."
       },
       role: {
         type: "string",
@@ -1327,7 +1394,7 @@ var TOOL_MODELS = {
     },
     required: ["name"]
   },
-  thenvoi_remove_participant: {
+  band_remove_participant: {
     description: "Remove a participant from the chat room by name.",
     properties: {
       name: {
@@ -1337,12 +1404,12 @@ var TOOL_MODELS = {
     },
     required: ["name"]
   },
-  thenvoi_get_participants: {
+  band_get_participants: {
     description: "Get a list of all participants in the current chat room.",
     properties: {},
     required: []
   },
-  thenvoi_lookup_peers: {
+  band_lookup_peers: {
     description: "List available peers (agents and users) that can be added to this room. Automatically excludes peers already in the room. Returns dict with 'peers' list and 'metadata' (page, page_size, total_count, total_pages). Use this to find specialized agents (e.g., Weather Agent) when you cannot answer a question directly.",
     properties: {
       page: {
@@ -1357,7 +1424,7 @@ var TOOL_MODELS = {
     },
     required: []
   },
-  thenvoi_create_chatroom: {
+  band_create_chatroom: {
     description: "Create a new chat room for a specific task or conversation.",
     properties: {
       task_id: {
@@ -1367,7 +1434,7 @@ var TOOL_MODELS = {
     },
     required: []
   },
-  thenvoi_list_contacts: {
+  band_list_contacts: {
     description: "List agent's contacts with pagination.",
     properties: {
       page: {
@@ -1384,7 +1451,7 @@ var TOOL_MODELS = {
     },
     required: []
   },
-  thenvoi_add_contact: {
+  band_add_contact: {
     description: "Send a contact request to add someone as a contact. Returns 'pending' when request is created. Returns 'approved' when inverse request existed and was auto-accepted.",
     properties: {
       handle: {
@@ -1398,7 +1465,7 @@ var TOOL_MODELS = {
     },
     required: ["handle"]
   },
-  thenvoi_remove_contact: {
+  band_remove_contact: {
     description: "Remove an existing contact by handle or ID.",
     properties: {
       handle: {
@@ -1412,7 +1479,7 @@ var TOOL_MODELS = {
     },
     required: []
   },
-  thenvoi_list_contact_requests: {
+  band_list_contact_requests: {
     description: "List both received and sent contact requests. Received requests are always filtered to pending status. Sent requests can be filtered by status.",
     properties: {
       page: {
@@ -1434,7 +1501,7 @@ var TOOL_MODELS = {
     },
     required: []
   },
-  thenvoi_respond_contact_request: {
+  band_respond_contact_request: {
     description: "Respond to a contact request. 'approve'/'reject': For requests you RECEIVED (handle = requester's handle). 'cancel': For requests you SENT (handle = recipient's handle).",
     properties: {
       action: {
@@ -1453,7 +1520,7 @@ var TOOL_MODELS = {
     },
     required: ["action"]
   },
-  thenvoi_list_memories: {
+  band_list_memories: {
     description: "List memories accessible to the agent. Returns memories about the specified subject (cross-agent sharing) and organization-wide shared memories.",
     properties: {
       subject_id: {
@@ -1498,7 +1565,7 @@ var TOOL_MODELS = {
     },
     required: []
   },
-  thenvoi_store_memory: {
+  band_store_memory: {
     description: "Store a new memory entry. The memory will be associated with the authenticated agent as the source. For subject-scoped memories, provide a subject_id. For organization-scoped memories, omit subject_id.",
     properties: {
       content: {
@@ -1540,7 +1607,7 @@ var TOOL_MODELS = {
     },
     required: ["content", "system", "type", "segment", "thought"]
   },
-  thenvoi_get_memory: {
+  band_get_memory: {
     description: "Retrieve a specific memory by ID.",
     properties: {
       memory_id: {
@@ -1550,7 +1617,7 @@ var TOOL_MODELS = {
     },
     required: ["memory_id"]
   },
-  thenvoi_supersede_memory: {
+  band_supersede_memory: {
     description: "Mark a memory as superseded (soft delete). Use when information is outdated or incorrect. The memory remains for audit trail but won't appear in normal queries. Only the source agent can supersede.",
     properties: {
       memory_id: {
@@ -1560,7 +1627,7 @@ var TOOL_MODELS = {
     },
     required: ["memory_id"]
   },
-  thenvoi_archive_memory: {
+  band_archive_memory: {
     description: "Archive a memory (hide but preserve). Use when memory is valid but not currently needed. Archived memories can be restored later by humans. Only the source agent can archive.",
     properties: {
       memory_id: {
@@ -1573,18 +1640,18 @@ var TOOL_MODELS = {
 };
 var ALL_TOOL_NAMES = new Set(Object.keys(TOOL_MODELS));
 var MEMORY_TOOL_NAMES = /* @__PURE__ */ new Set([
-  "thenvoi_list_memories",
-  "thenvoi_store_memory",
-  "thenvoi_get_memory",
-  "thenvoi_supersede_memory",
-  "thenvoi_archive_memory"
+  "band_list_memories",
+  "band_store_memory",
+  "band_get_memory",
+  "band_supersede_memory",
+  "band_archive_memory"
 ]);
 var CONTACT_TOOL_NAMES = /* @__PURE__ */ new Set([
-  "thenvoi_list_contacts",
-  "thenvoi_add_contact",
-  "thenvoi_remove_contact",
-  "thenvoi_list_contact_requests",
-  "thenvoi_respond_contact_request"
+  "band_list_contacts",
+  "band_add_contact",
+  "band_remove_contact",
+  "band_list_contact_requests",
+  "band_respond_contact_request"
 ]);
 var BASE_TOOL_NAMES = new Set(
   [...ALL_TOOL_NAMES].filter((name) => !MEMORY_TOOL_NAMES.has(name))
@@ -1592,7 +1659,8 @@ var BASE_TOOL_NAMES = new Set(
 var CHAT_TOOL_NAMES = new Set(
   [...BASE_TOOL_NAMES].filter((name) => !CONTACT_TOOL_NAMES.has(name))
 );
-var MCP_TOOL_PREFIX = "mcp__thenvoi__";
+var MCP_TOOL_PREFIX = "mcp__band__";
+var MCP_SERVER_NAME = "band";
 function mcpToolNames(names) {
   return [...names].sort((a, b) => a.localeCompare(b)).map((name) => `${MCP_TOOL_PREFIX}${name}`);
 }
@@ -1640,13 +1708,13 @@ var AgentTools = class {
   roomId;
   capabilities;
   rest;
-  participants;
+  roster;
   adapterTools;
   toolHandlers;
   constructor(options) {
     this.roomId = options.roomId;
     this.rest = options.rest;
-    this.participants = options.participants ?? [];
+    this.roster = options.roster ?? new import_band_sdk_core.ParticipantRoster();
     this.capabilities = {
       ...DEFAULT_AGENT_TOOLS_CAPABILITIES,
       ...options.capabilities
@@ -1658,17 +1726,20 @@ var AgentTools = class {
     return this.adapterTools;
   }
   async sendMessage(content, mentions = []) {
-    if (mentions.length > 0 && typeof mentions[0] === "string" && this.participants.length === 0) {
-      await this.syncParticipants();
+    let participants;
+    if (mentions.length > 0 && typeof mentions[0] === "string") {
+      participants = this.roster.list();
+      if (participants.length === 0) {
+        participants = await this.syncParticipants();
+      }
     }
-    const resolvedMentions = this.resolveMentions(mentions);
+    const resolvedMentions = this.resolveMentions(mentions, participants);
     return this.rest.createChatMessage(
       this.roomId,
       {
         content,
         mentions: resolvedMentions
-      },
-      DEFAULT_REQUEST_OPTIONS
+      }
     );
   }
   async sendEvent(content, messageType, metadata) {
@@ -1679,8 +1750,7 @@ var AgentTools = class {
         content,
         messageType,
         metadata
-      },
-      DEFAULT_REQUEST_OPTIONS
+      }
     );
   }
   async createChatroom(taskId) {
@@ -1719,7 +1789,7 @@ var AgentTools = class {
       type: String(peer.type ?? "Agent"),
       handle: typeof peer.handle === "string" ? peer.handle : null
     };
-    this.participants.push(participantRecord);
+    this.roster.add(participantRecord);
     return {
       ...participantRecord,
       status: "added"
@@ -1734,7 +1804,7 @@ var AgentTools = class {
       throw new ValidationError(`Participant '${name}' not found in room`);
     }
     await this.rest.removeChatParticipant(this.roomId, String(participant.id), DEFAULT_REQUEST_OPTIONS);
-    this.replaceParticipants(this.participants.filter((entry) => entry.id !== participant.id));
+    this.roster.remove(participant.id);
     return {
       id: participant.id,
       name,
@@ -1762,17 +1832,12 @@ var AgentTools = class {
   }
   async fetchParticipants() {
     const participants = await this.rest.listChatParticipants(this.roomId, DEFAULT_REQUEST_OPTIONS);
-    return participants.map((participant) => ({
-      id: participant.id,
-      name: participant.name,
-      type: participant.type,
-      handle: participant.handle ?? null
-    }));
+    return participants.map(toParticipantRecordFromRest);
   }
   async syncParticipants() {
     const participants = await this.fetchParticipants();
-    this.replaceParticipants(participants);
-    return [...this.participants];
+    this.roster.setAll(participants);
+    return this.roster.list().map(toParticipantRecord);
   }
   async executeToolCall(toolName, arguments_) {
     const validationError = validateToolArgs(toolName, arguments_);
@@ -1820,7 +1885,7 @@ var AgentTools = class {
       if (!CHAT_TOOL_NAMES.has(name) && !this.capabilities.contacts) {
         return false;
       }
-      if (name === "thenvoi_lookup_peers" && !this.capabilities.peers) {
+      if (name === "band_lookup_peers" && !this.capabilities.peers) {
         return false;
       }
       return true;
@@ -2015,7 +2080,7 @@ var AgentTools = class {
     }
     return this.rest.archiveMemory(normalizedMemoryId, DEFAULT_REQUEST_OPTIONS);
   }
-  resolveMentions(mentions) {
+  resolveMentions(mentions, participants) {
     if (mentions.length === 0) {
       return [];
     }
@@ -2028,7 +2093,7 @@ var AgentTools = class {
     const participantsByHandle = /* @__PURE__ */ new Map();
     const participantsById = /* @__PURE__ */ new Map();
     const participantsByName = /* @__PURE__ */ new Map();
-    for (const participant of this.participants) {
+    for (const participant of participants ?? []) {
       const ref = {
         id: String(participant.id),
         handle: typeof participant.handle === "string" ? participant.handle : void 0
@@ -2084,9 +2149,6 @@ var AgentTools = class {
   normalizeMentionHandle(handle) {
     return handle.trim().replace(/^@+/, "").toLowerCase();
   }
-  replaceParticipants(participants) {
-    this.participants.splice(0, this.participants.length, ...participants);
-  }
   buildAdapterTools() {
     const tools = {
       capabilities: this.capabilities
@@ -2117,51 +2179,51 @@ var AgentTools = class {
   }
   buildMessagingToolHandlers() {
     return {
-      thenvoi_send_message: async (arguments_) => this.sendMessage(
+      band_send_message: async (arguments_) => this.sendMessage(
         String(arguments_.content ?? ""),
         this.normalizeMentionInput(arguments_.mentions)
       ),
-      thenvoi_send_event: async (arguments_) => this.sendEvent(
+      band_send_event: async (arguments_) => this.sendEvent(
         String(arguments_.content ?? ""),
         String(arguments_.message_type ?? "task"),
         this.normalizeOptionalMetadata(arguments_.metadata)
       ),
-      thenvoi_add_participant: async (arguments_) => this.addParticipant(String(arguments_.name ?? ""), String(arguments_.role ?? "member")),
-      thenvoi_remove_participant: async (arguments_) => this.removeParticipant(String(arguments_.name ?? "")),
-      thenvoi_lookup_peers: async (arguments_) => this.lookupPeers(
+      band_add_participant: async (arguments_) => this.addParticipant(String(arguments_.name ?? ""), String(arguments_.role ?? "member")),
+      band_remove_participant: async (arguments_) => this.removeParticipant(String(arguments_.name ?? "")),
+      band_lookup_peers: async (arguments_) => this.lookupPeers(
         coercePositiveInt(arguments_.page, 1),
         coercePositiveInt(arguments_.page_size, 50)
       ),
-      thenvoi_get_participants: async () => this.getParticipants(),
-      thenvoi_create_chatroom: async (arguments_) => this.createChatroom(this.normalizeOptionalString(arguments_.task_id))
+      band_get_participants: async () => this.getParticipants(),
+      band_create_chatroom: async (arguments_) => this.createChatroom(this.normalizeOptionalString(arguments_.task_id))
     };
   }
   buildContactToolHandlers() {
     return {
-      thenvoi_list_contacts: async (arguments_) => this.listContacts({
+      band_list_contacts: async (arguments_) => this.listContacts({
         page: coercePositiveInt(arguments_.page, 1),
         pageSize: coercePositiveInt(arguments_.page_size, 50)
       }),
-      thenvoi_add_contact: async (arguments_) => this.addContact({
+      band_add_contact: async (arguments_) => this.addContact({
         handle: String(arguments_.handle ?? ""),
         ...typeof arguments_.message === "string" ? { message: arguments_.message } : {}
       }),
-      thenvoi_remove_contact: async (arguments_) => this.removeContact(this.toRemoveContactArgs(arguments_)),
-      thenvoi_list_contact_requests: async (arguments_) => this.listContactRequests({
+      band_remove_contact: async (arguments_) => this.removeContact(this.toRemoveContactArgs(arguments_)),
+      band_list_contact_requests: async (arguments_) => this.listContactRequests({
         page: coercePositiveInt(arguments_.page, 1),
         pageSize: coercePositiveInt(arguments_.page_size, 50),
         sentStatus: String(arguments_.sent_status ?? "pending")
       }),
-      thenvoi_respond_contact_request: async (arguments_) => this.respondContactRequest(this.toRespondContactRequestArgs(arguments_))
+      band_respond_contact_request: async (arguments_) => this.respondContactRequest(this.toRespondContactRequestArgs(arguments_))
     };
   }
   buildMemoryToolHandlers() {
     return {
-      thenvoi_list_memories: async (arguments_) => this.listMemories(this.toListMemoriesArgs(arguments_)),
-      thenvoi_store_memory: async (arguments_) => this.storeMemory(this.toStoreMemoryArgs(arguments_)),
-      thenvoi_get_memory: async (arguments_) => this.getMemory(String(arguments_.memory_id ?? "")),
-      thenvoi_supersede_memory: async (arguments_) => this.supersedeMemory(String(arguments_.memory_id ?? "")),
-      thenvoi_archive_memory: async (arguments_) => this.archiveMemory(String(arguments_.memory_id ?? ""))
+      band_list_memories: async (arguments_) => this.listMemories(this.toListMemoriesArgs(arguments_)),
+      band_store_memory: async (arguments_) => this.storeMemory(this.toStoreMemoryArgs(arguments_)),
+      band_get_memory: async (arguments_) => this.getMemory(String(arguments_.memory_id ?? "")),
+      band_supersede_memory: async (arguments_) => this.supersedeMemory(String(arguments_.memory_id ?? "")),
+      band_archive_memory: async (arguments_) => this.archiveMemory(String(arguments_.memory_id ?? ""))
     };
   }
   toRemoveContactArgs(arguments_) {
@@ -2405,13 +2467,13 @@ function validateToolArgs(toolName, args) {
       errors.push(`${field}: Field required`);
     }
   }
-  if (toolName === "thenvoi_send_message") {
+  if (toolName === "band_send_message") {
     const mentions = args.mentions;
     if (Array.isArray(mentions) && mentions.length === 0) {
       errors.push("mentions: At least one mention is required");
     }
   }
-  if (toolName === "thenvoi_send_event") {
+  if (toolName === "band_send_event") {
     const messageType = args.message_type;
     if (typeof messageType === "string" && !CHAT_EVENT_TYPES.includes(messageType)) {
       errors.push(
@@ -2419,7 +2481,7 @@ function validateToolArgs(toolName, args) {
       );
     }
   }
-  if (toolName === "thenvoi_respond_contact_request") {
+  if (toolName === "band_respond_contact_request") {
     const action = args.action;
     const validActions = ["approve", "reject", "cancel"];
     if (typeof action === "string" && !validActions.includes(action)) {
@@ -2428,7 +2490,7 @@ function validateToolArgs(toolName, args) {
       );
     }
   }
-  if (toolName === "thenvoi_store_memory") {
+  if (toolName === "band_store_memory") {
     if (typeof args.system === "string" && !isMemorySystem(args.system)) {
       errors.push(`system: Invalid value '${args.system}'. Expected one of: ${expectedList(MEMORY_SYSTEMS)}`);
     }
@@ -2457,114 +2519,8 @@ function validateToolArgs(toolName, args) {
   return null;
 }
 
-// src/runtime/retryTracker.ts
-var DEFAULT_MAX_TRACKED = 1e4;
-var MessageRetryTracker = class {
-  maxRetriesValue;
-  maxTracked;
-  attempts = /* @__PURE__ */ new Map();
-  failed = /* @__PURE__ */ new Set();
-  constructor(maxRetries = 1, maxTracked = DEFAULT_MAX_TRACKED) {
-    this.maxRetriesValue = maxRetries;
-    this.maxTracked = maxTracked;
-  }
-  get maxRetries() {
-    return this.maxRetriesValue;
-  }
-  isPermanentlyFailed(messageId) {
-    return this.failed.has(messageId);
-  }
-  recordAttempt(messageId) {
-    const attempts = (this.attempts.get(messageId) ?? 0) + 1;
-    this.attempts.set(messageId, attempts);
-    const exceeded = attempts > this.maxRetriesValue;
-    if (exceeded) {
-      this.evictSetIfNeeded(this.failed);
-      this.failed.add(messageId);
-    }
-    this.evictMapIfNeeded(this.attempts);
-    return [attempts, exceeded];
-  }
-  markSuccess(messageId) {
-    this.attempts.delete(messageId);
-  }
-  markPermanentlyFailed(messageId) {
-    this.evictSetIfNeeded(this.failed);
-    this.failed.add(messageId);
-  }
-  evictMapIfNeeded(map) {
-    while (map.size >= this.maxTracked) {
-      const first = map.keys().next();
-      if (first.done) break;
-      map.delete(first.value);
-    }
-  }
-  evictSetIfNeeded(set) {
-    while (set.size >= this.maxTracked) {
-      const first = set.values().next();
-      if (first.done) break;
-      set.delete(first.value);
-    }
-  }
-};
-
-// src/runtime/formatters.ts
-function isMetadataMap(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function replaceUuidMentions(content, participants) {
-  if (!content || participants.length === 0) {
-    return content;
-  }
-  let next = content;
-  for (const participant of participants) {
-    const participantId = participant.id;
-    const handle = participant.handle;
-    if (typeof participantId === "string" && typeof handle === "string") {
-      next = next.replaceAll(`@[[${participantId}]]`, ensureHandlePrefix(handle) ?? "");
-    }
-  }
-  return next;
-}
-function formatMessageForLlm(message, participants) {
-  const senderType = String(message.sender_type ?? "");
-  const senderName = String(message.sender_name ?? message.name ?? senderType);
-  const content = participants ? replaceUuidMentions(String(message.content ?? ""), participants) : String(message.content ?? "");
-  return {
-    role: senderType === "Agent" ? "assistant" : "user",
-    content,
-    sender_name: senderName,
-    sender_type: senderType,
-    message_type: String(message.message_type ?? "text"),
-    metadata: isMetadataMap(message.metadata) ? message.metadata : {}
-  };
-}
-function formatHistoryForLlm(messages, options) {
-  const excludeId = options?.excludeId;
-  const participants = options?.participants;
-  return messages.filter((message) => String(message.id ?? "") !== excludeId).map((message) => formatMessageForLlm(message, participants));
-}
-function buildParticipantsMessage(participants) {
-  if (participants.length === 0) {
-    return "## Current Participants\nNo other participants in this room.";
-  }
-  const lines = ["## Current Participants"];
-  for (const participant of participants) {
-    const participantType = String(participant.type ?? "Unknown");
-    const participantName = String(participant.name ?? "Unknown");
-    const participantHandle = String(participant.handle ?? "Unknown");
-    lines.push(
-      `- ${ensureHandlePrefix(participantHandle) ?? ""} \u2014 ${participantName} (${participantType})`
-    );
-  }
-  lines.push("");
-  lines.push(
-    "IMPORTANT: In thenvoi_send_message mentions, always use the exact handle shown above (e.g. '@john' for users, '@john/weather-agent' for agents), NOT the display name. Handles are lowercase with no spaces."
-  );
-  return lines.join("\n");
-}
-
 // src/runtime/ExecutionContext.ts
+var import_band_sdk_core2 = require("@band-ai/band-sdk-core");
 var DEDUP_CACHE_MAX = 500;
 var ExecutionContext = class {
   roomId;
@@ -2576,11 +2532,10 @@ var ExecutionContext = class {
   history = [];
   messageIds = /* @__PURE__ */ new Set();
   dedupCache = /* @__PURE__ */ new Map();
-  participants = [];
+  roster = new import_band_sdk_core2.ParticipantRoster();
   tools;
   adapterTools;
   participantsMessage = null;
-  lastSentParticipantIds = null;
   contactsMessage = null;
   contextCache = null;
   contextCacheExpiresAt = 0;
@@ -2595,11 +2550,11 @@ var ExecutionContext = class {
     this.enableContextCache = options.enableContextCache ?? true;
     this.contextCacheTtlMs = Math.max(0, (options.contextCacheTtlSeconds ?? 300) * 1e3);
     this.enableContextHydration = options.enableContextHydration ?? true;
-    this.retryTrackerInstance = new MessageRetryTracker(options.maxMessageRetries ?? 1);
+    this.retryTrackerInstance = new import_band_sdk_core2.RetryTracker(options.maxMessageRetries ?? 1);
     this.tools = new AgentTools({
       roomId: this.roomId,
       rest: this.link.rest,
-      participants: this.participants,
+      roster: this.roster,
       capabilities: this.link.capabilities
     });
     this.adapterTools = this.tools.getAdapterTools();
@@ -2667,23 +2622,20 @@ var ExecutionContext = class {
     }));
   }
   setParticipants(participants) {
-    this.replaceParticipants(participants);
+    this.roster.setAll(participants);
     this.updateCachedParticipants();
   }
   addParticipant(participant) {
-    const existingIndex = this.participants.findIndex((entry) => entry.id === participant.id);
-    if (existingIndex >= 0) {
-      this.participants.splice(existingIndex, 1);
+    const isNew = this.roster.add(participant);
+    if (isNew) {
+      const name = String(participant.name ?? "unknown");
+      this.participantsMessage = `${name} joined the room.`;
     }
-    this.participants.push(participant);
-    const name = String(participant.name ?? "unknown");
-    this.participantsMessage = `${name} joined the room.`;
     this.updateCachedParticipants();
   }
   removeParticipant(participantId) {
-    const removed = this.participants.find((entry) => String(entry.id) === participantId);
-    const next = this.participants.filter((entry) => String(entry.id) !== participantId);
-    this.replaceParticipants(next);
+    const removed = this.roster.list().find((entry) => entry.id === participantId);
+    this.roster.remove(participantId);
     if (removed) {
       this.participantsMessage = `${String(removed.name ?? participantId)} left the room.`;
     }
@@ -2693,16 +2645,7 @@ var ExecutionContext = class {
     this.contactsMessage = message;
   }
   consumeParticipantsMessage() {
-    const currentIds = new Set(this.participants.map((p) => String(p.id)));
-    let changed = !this.lastSentParticipantIds || currentIds.size !== this.lastSentParticipantIds.size;
-    if (!changed) {
-      for (const id of currentIds) {
-        if (!this.lastSentParticipantIds.has(id)) {
-          changed = true;
-          break;
-        }
-      }
-    }
+    const changed = this.roster.changed();
     if (!changed && !this.participantsMessage) {
       return null;
     }
@@ -2712,15 +2655,9 @@ var ExecutionContext = class {
       this.participantsMessage = null;
     }
     if (changed) {
-      const asRecords = this.participants.map((p) => ({
-        id: p.id,
-        name: p.name,
-        type: p.type,
-        handle: p.handle ?? null
-      }));
-      parts.push(buildParticipantsMessage(asRecords));
-    }
-    this.lastSentParticipantIds = currentIds;
+      parts.push(buildParticipantsMessage(this.roster.list().map((p) => ({ ...toParticipantRecord(p) }))));
+    }
+    this.roster.markSent();
     return parts.length > 0 ? parts.join("\n") : null;
   }
   consumeContactsMessage() {
@@ -2771,27 +2708,19 @@ var ExecutionContext = class {
       return fallback;
     }
   }
-  replaceParticipants(participants) {
-    this.participants.splice(0, this.participants.length, ...participants);
-  }
   buildLocalContext() {
     return {
       roomId: this.roomId,
       messages: this.getRawHistory(),
-      participants: [...this.participants],
+      participants: this.roster.list().map(toParticipantRecord),
       hydratedAt: /* @__PURE__ */ new Date()
     };
   }
   async loadParticipants() {
     const participants = await this.link.rest.listChatParticipants(this.roomId, DEFAULT_REQUEST_OPTIONS);
-    const normalized = participants.map((participant) => ({
-      id: participant.id,
-      name: participant.name,
-      type: participant.type,
-      handle: participant.handle ?? null
-    }));
-    this.replaceParticipants(normalized);
-    return [...this.participants];
+    const normalized = participants.map(toParticipantRecordFromRest);
+    this.roster.setAll(normalized);
+    return this.roster.list().map(toParticipantRecord);
   }
   async loadHydratedMessages() {
     const messages = [];
@@ -2833,7 +2762,7 @@ var ExecutionContext = class {
     if (!this.contextCache) {
       return;
     }
-    this.contextCache.participants = [...this.participants];
+    this.contextCache.participants = this.roster.list().map(toParticipantRecord);
     this.contextCache.hydratedAt = /* @__PURE__ */ new Date();
     this.contextCacheExpiresAt = this.nextCacheExpiry();
   }
@@ -3545,54 +3474,16 @@ function normalizeContactRequestsResult(result) {
 }
 
 // src/client/rest/FernRestAdapter.ts
-function mergeOptions(options) {
+function mergeOptions(options, maxRetries) {
   return {
     ...DEFAULT_REQUEST_OPTIONS,
+    ...maxRetries !== void 0 ? { maxRetries } : {},
     ...options
   };
 }
-var AGENT_ME_RETRY_LIMIT = 4;
-var AGENT_ME_RETRY_BASE_DELAY_MS = 2e3;
-var MESSAGE_SEND_RETRY_LIMIT = 3;
-var MESSAGE_SEND_RETRY_BASE_DELAY_MS = 500;
 function asMetadataMap2(value) {
   return asOptionalRecord(value);
 }
-function extractHttpStatus(error) {
-  const record = asOptionalRecord(error);
-  if (!record) {
-    return void 0;
-  }
-  const response = asOptionalRecord(record.response);
-  const status = record.statusCode ?? record.status ?? response?.statusCode ?? response?.status;
-  return typeof status === "number" ? status : void 0;
-}
-function isFernRateLimitError(error) {
-  return extractHttpStatus(error) === 429;
-}
-async function sleep(ms) {
-  await new Promise((resolveDelay) => setTimeout(resolveDelay, ms));
-}
-function computeRetryDelayMs(baseDelayMs, attempt) {
-  const backoff = baseDelayMs * 2 ** (attempt - 1);
-  const jitter = Math.floor(Math.random() * Math.max(1, Math.floor(backoff / 4)));
-  return backoff + jitter;
-}
-async function withRateLimitRetry(operation, options) {
-  let lastError;
-  for (let attempt = 1; attempt <= options.retryLimit; attempt += 1) {
-    try {
-      return await operation();
-    } catch (error) {
-      lastError = error;
-      if (!isFernRateLimitError(error) || attempt === options.retryLimit) {
-        throw error;
-      }
-      await sleep(computeRetryDelayMs(options.baseDelayMs, attempt));
-    }
-  }
-  throw lastError instanceof Error ? lastError : new Error("Rate-limit retry exhausted without a terminal error.");
-}
 function requireNonEmptyStringField(value, field, source) {
   if (typeof value !== "string" || value.trim().length === 0) {
     throw new Error(`Invalid ${source} response: expected non-empty string AgentIdentity.${field}`);
@@ -3800,28 +3691,21 @@ var FernRestAdapter = class {
     this.client = client;
   }
   async getAgentMe(options) {
-    return withRateLimitRetry(
-      async () => {
-        if (this.client.agentApiIdentity?.getAgentMe) {
-          const response = await this.client.agentApiIdentity.getAgentMe(mergeOptions(options));
-          return normalizeAgentIdentityEnvelope(response, "agentApiIdentity.getAgentMe");
-        }
-        const profileClient = this.client.myProfile ?? this.client.humanApiProfile;
-        if (!profileClient?.getMyProfile) {
-          throw new UnsupportedFeatureError(
-            "Fern client missing agentApiIdentity.getAgentMe or humanApiProfile.getMyProfile"
-          );
-        }
-        const profile = await profileClient.getMyProfile(mergeOptions(options));
-        return normalizeLegacyProfileIdentity(
-          normalizeLegacyProfileEnvelope(profile),
-          "profile.getMyProfile"
-        );
-      },
-      {
-        retryLimit: AGENT_ME_RETRY_LIMIT,
-        baseDelayMs: AGENT_ME_RETRY_BASE_DELAY_MS
-      }
+    const requestOptions = mergeOptions(options);
+    if (this.client.agentApiIdentity?.getAgentMe) {
+      const response = await this.client.agentApiIdentity.getAgentMe(requestOptions);
+      return normalizeAgentIdentityEnvelope(response, "agentApiIdentity.getAgentMe");
+    }
+    const profileClient = this.client.myProfile ?? this.client.humanApiProfile;
+    if (!profileClient?.getMyProfile) {
+      throw new UnsupportedFeatureError(
+        "Fern client missing agentApiIdentity.getAgentMe or humanApiProfile.getMyProfile"
+      );
+    }
+    const profile = await profileClient.getMyProfile(requestOptions);
+    return normalizeLegacyProfileIdentity(
+      normalizeLegacyProfileEnvelope(profile),
+      "profile.getMyProfile"
     );
   }
   async createChatMessage(chatId, message, options) {
@@ -3829,45 +3713,33 @@ var FernRestAdapter = class {
     if (!api) {
       throw new UnsupportedFeatureError("Fern client missing chat message creation endpoint");
     }
-    const response = await withRateLimitRetry(
-      async () => await api(
-        chatId,
-        {
-          message: {
-            content: message.content,
-            message_type: message.messageType,
-            metadata: message.metadata,
-            mentions: message.mentions
-          }
-        },
-        mergeOptions(options)
-      ),
+    const response = await api(
+      chatId,
       {
-        retryLimit: MESSAGE_SEND_RETRY_LIMIT,
-        baseDelayMs: MESSAGE_SEND_RETRY_BASE_DELAY_MS
-      }
+        message: {
+          content: message.content,
+          message_type: message.messageType,
+          metadata: message.metadata,
+          mentions: message.mentions
+        }
+      },
+      mergeOptions(options, MESSAGE_SEND_MAX_RETRIES)
     );
     return normalizeToolOperationResult(response);
   }
   async createChatEvent(chatId, event, options) {
     const createAgentChatEvent = this.client.agentApiEvents?.createAgentChatEvent?.bind(this.client.agentApiEvents);
     if (createAgentChatEvent) {
-      const response = await withRateLimitRetry(
-        async () => await createAgentChatEvent(
-          chatId,
-          {
-            event: {
-              content: event.content,
-              message_type: event.messageType,
-              metadata: event.metadata
-            }
-          },
-          mergeOptions(options)
-        ),
+      const response = await createAgentChatEvent(
+        chatId,
         {
-          retryLimit: MESSAGE_SEND_RETRY_LIMIT,
-          baseDelayMs: MESSAGE_SEND_RETRY_BASE_DELAY_MS
-        }
+          event: {
+            content: event.content,
+            message_type: event.messageType,
+            metadata: event.metadata
+          }
+        },
+        mergeOptions(options, MESSAGE_SEND_MAX_RETRIES)
       );
       return normalizeToolOperationResult(response);
     }
@@ -4390,7 +4262,7 @@ function retryAfterFromHeaders(headers) {
 var import_ws = require("ws");
 function createNodeWebSocketFactory(headers) {
   const Constructor = import_ws.WebSocket;
-  class ThenvoiNodeWebSocket {
+  class BandNodeWebSocket {
     constructor(address, protocols) {
       const socket = new Constructor(address, protocols, headers ? { headers } : void 0);
       socket.once("unexpected-response", (request, response) => {
@@ -4399,7 +4271,7 @@ function createNodeWebSocketFactory(headers) {
       return socket;
     }
   }
-  return ThenvoiNodeWebSocket;
+  return BandNodeWebSocket;
 }
 async function emitUpgradeError(websocket, request, response) {
   const body = await readResponseBody(response);
@@ -4787,9 +4659,9 @@ function getSocketChannelCount(socket) {
   return candidate.channels.length;
 }
 
-// src/platform/ThenvoiLink.ts
-var import_rest_client = require("@thenvoi/rest-client");
-var DEFAULT_WS_URL = "wss://app.thenvoi.com/api/v1/socket";
+// src/platform/BandLink.ts
+var import_rest_client = require("@band-ai/rest-client");
+var DEFAULT_WS_URL = "wss://app.band.ai/api/v1/socket";
 function deriveDefaultRestUrl(wsUrl) {
   const parsed = new URL(wsUrl);
   const protocol = parsed.protocol === "ws:" ? "http:" : "https:";
@@ -4814,7 +4686,7 @@ function toPlatformMessage(roomId, message) {
     createdAt: new Date(message.inserted_at)
   };
 }
-var ThenvoiLink = class {
+var BandLink = class {
   agentId;
   apiKey;
   wsUrl;
@@ -4840,7 +4712,7 @@ var ThenvoiLink = class {
       ...options.capabilities
     };
     const restApi = options.restApi ?? new FernRestAdapter(
-      new import_rest_client.ThenvoiClient({
+      new import_rest_client.BandClient({
         apiKey: this.apiKey,
         baseUrl: this.restUrl
       })
@@ -5213,6 +5085,8 @@ var DefaultPreprocessor = class {
 };
 
 // src/runtime/PlatformRuntime.ts
+var MAX_MESSAGE_RETRIES = 4294967295;
+var isValidRetryCount = (value) => Number.isInteger(value) && value >= 0 && value <= MAX_MESSAGE_RETRIES;
 var PlatformRuntime = class {
   _agentId;
   _apiKey;
@@ -5249,6 +5123,12 @@ var PlatformRuntime = class {
         "apiKey is required and must be a non-empty string. Use loadAgentConfig() to load credentials from agent_config.yaml."
       );
     }
+    const maxMessageRetries = options.sessionConfig?.maxMessageRetries;
+    if (maxMessageRetries !== void 0 && !isValidRetryCount(maxMessageRetries)) {
+      throw new ValidationError(
+        `sessionConfig.maxMessageRetries must be an integer between 0 and ${MAX_MESSAGE_RETRIES}, got ${maxMessageRetries}.`
+      );
+    }
     this._agentId = options.agentId;
     this._apiKey = options.apiKey;
     this._wsUrl = options.wsUrl;
@@ -5301,7 +5181,7 @@ var PlatformRuntime = class {
   }
   async doInitialize() {
     if (!this.linkInstance) {
-      this.linkInstance = new ThenvoiLink({
+      this.linkInstance = new BandLink({
         ...this.linkOptions,
         agentId: this._agentId,
         apiKey: this._apiKey,
@@ -5584,25 +5464,28 @@ var RoomPresence = class {
   }
 };
 
+// src/runtime/index.ts
+var import_band_sdk_core3 = require("@band-ai/band-sdk-core");
+
 // src/runtime/prompts/base.ts
 var ENVIRONMENT_SECTION = `
 ## Environment
 
 Multi-participant chat. Messages show sender: [Name]: content.
 Messages prefixed with [System]: are platform updates (participant changes, contact updates, etc.) \u2014 not messages from users.
-Use \`thenvoi_send_message(content, mentions)\` to respond. Plain text output is not delivered.
+Use \`band_send_message(content, mentions)\` to respond. Plain text output is not delivered.
 Mentions use handles: @<username> for users, @<username>/<agent-name> for agents.`;
 var MULTI_AGENT_RULES_SECTION = `## CRITICAL: Delegate When You Cannot Help Directly
 
 You have NO internet access and NO real-time data. When asked about weather, news, stock prices,
 or any current information you cannot answer directly:
 
-1. Call \`thenvoi_lookup_peers()\` to find available specialized agents
-2. If a relevant agent exists, call \`thenvoi_add_participant(name)\` to add them
-3. Ask that agent using \`thenvoi_send_message(question, mentions=[agent_handle])\`
+1. Call \`band_lookup_peers()\` to find available specialized agents
+2. If a relevant agent exists, call \`band_add_participant(name)\` to add them
+3. Ask that agent using \`band_send_message(question, mentions=[agent_handle])\`
 4. Wait for their response and relay it back to the user
 
-NEVER say "I can't do that" without first checking if another agent can help via \`thenvoi_lookup_peers()\`.
+NEVER say "I can't do that" without first checking if another agent can help via \`band_lookup_peers()\`.
 
 ## CRITICAL: Do NOT Remove Agents Automatically
 
@@ -5621,42 +5504,42 @@ When someone asks you to get information from another agent:
 3. Do NOT just thank the helper agent - the requester is waiting for their answer!`;
 var THINKING_SECTION = `## IMPORTANT: Always Share Your Thinking
 
-You MUST call \`thenvoi_send_event(content, message_type="thought")\` BEFORE every action.
+You MUST call \`band_send_event(content, message_type="thought")\` BEFORE every action.
 This is required so users can see your reasoning process.`;
 var EXAMPLES_SECTION = `## Examples
 
 ### Simple question - answer directly
 [John Doe]: What's 2+2?
--> thenvoi_send_event("Simple arithmetic, answering directly.", message_type="thought")
--> thenvoi_send_message("4", mentions=["@john"])
+-> band_send_event("Simple arithmetic, answering directly.", message_type="thought")
+-> band_send_message("4", mentions=["@john"])
 
 ### User asks about weather (you cannot answer directly)
 [John Doe]: What's the weather in Tokyo?
--> thenvoi_send_event("I can't check weather directly. Looking for a Weather Agent.", message_type="thought")
--> thenvoi_lookup_peers()
--> thenvoi_send_event("Found Weather Agent. Adding to room.", message_type="thought")
--> thenvoi_add_participant("Weather Agent")
--> thenvoi_send_message("What's the weather in Tokyo?", mentions=["@john/weather-agent"])
+-> band_send_event("I can't check weather directly. Looking for a Weather Agent.", message_type="thought")
+-> band_lookup_peers()
+-> band_send_event("Found Weather Agent. Adding to room.", message_type="thought")
+-> band_add_participant("Weather Agent")
+-> band_send_message("What's the weather in Tokyo?", mentions=["@john/weather-agent"])
 
 [Weather Agent]: Tokyo is 15\xB0C and cloudy.
--> thenvoi_send_event("Got weather response. Relaying back to John Doe.", message_type="thought")
--> thenvoi_send_message("The weather in Tokyo is 15\xB0C and cloudy.", mentions=["@john"])
+-> band_send_event("Got weather response. Relaying back to John Doe.", message_type="thought")
+-> band_send_message("The weather in Tokyo is 15\xB0C and cloudy.", mentions=["@john"])
 
 ### No suitable agent available
 [John Doe]: What's the stock price of AAPL?
--> thenvoi_send_event("I can't check stock prices. Looking for a Stock Agent.", message_type="thought")
--> thenvoi_lookup_peers()
--> thenvoi_send_event("No stock agent available. Must inform user.", message_type="thought")
--> thenvoi_send_message("I don't have access to stock prices, and there's no specialized agent available to help with that.", mentions=["@john"])
+-> band_send_event("I can't check stock prices. Looking for a Stock Agent.", message_type="thought")
+-> band_lookup_peers()
+-> band_send_event("No stock agent available. Must inform user.", message_type="thought")
+-> band_send_message("I don't have access to stock prices, and there's no specialized agent available to help with that.", mentions=["@john"])
 
 ### Follow-up question in same conversation
 [John Doe]: What about London?
--> thenvoi_send_event("Follow-up weather question. Asking Weather Agent.", message_type="thought")
--> thenvoi_send_message("What's the weather in London?", mentions=["@john/weather-agent"])
+-> band_send_event("Follow-up weather question. Asking Weather Agent.", message_type="thought")
+-> band_send_message("What's the weather in London?", mentions=["@john/weather-agent"])
 
 [Weather Agent]: London is 8\xB0C and rainy.
--> thenvoi_send_event("Got London weather. Relaying to John Doe.", message_type="thought")
--> thenvoi_send_message("London is 8\xB0C and rainy.", mentions=["@john"])`;
+-> band_send_event("Got London weather. Relaying to John Doe.", message_type="thought")
+-> band_send_message("London is 8\xB0C and rainy.", mentions=["@john"])`;
 var BASE_INSTRUCTIONS = [
   ENVIRONMENT_SECTION,
   MULTI_AGENT_RULES_SECTION,
@@ -5668,10 +5551,10 @@ var BASE_INSTRUCTIONS = [
 var MEMORY_INTRO = `## Memory Tools
 
 You have access to memory tools for storing and retrieving information
-across conversations. Use \`thenvoi_store_memory\` to persist important
-information and \`thenvoi_list_memories\` / \`thenvoi_get_memory\` to recall it.
-Use \`thenvoi_supersede_memory\` to mark outdated memories and
-\`thenvoi_archive_memory\` to hide memories that should be preserved.`;
+across conversations. Use \`band_store_memory\` to persist important
+information and \`band_list_memories\` / \`band_get_memory\` to recall it.
+Use \`band_supersede_memory\` to mark outdated memories and
+\`band_archive_memory\` to hide memories that should be preserved.`;
 function longTermPattern(label, type, segment, scope) {
   return {
     label,
@@ -5696,7 +5579,7 @@ var MEMORY_COMMON_PATTERNS = [
 ].join("\n");
 var MEMORY_SCOPE_GUIDANCE = `Prefer \`scope="${MEMORY_STORE_SCOPE.subject}"\` whenever the memory is about a specific person or agent, so it
 stays attached to that subject rather than leaking org-wide. Storing with \`scope="${MEMORY_STORE_SCOPE.subject}"\` requires a
-real \`subject_id\` UUID, so resolve it first via \`thenvoi_lookup_peers\` or the participant list.
+real \`subject_id\` UUID, so resolve it first via \`band_lookup_peers\` or the participant list.
 Reserve \`scope="${MEMORY_STORE_SCOPE.organization}"\` for knowledge that is genuinely shared across the whole organization and
 is not about any one subject.`;
 function quoteChoices(values) {
@@ -5706,11 +5589,11 @@ function memoryTypeLines() {
   return Object.entries(MEMORY_SYSTEM_TYPES).map(([system, types]) => `  - ${system}: ${quoteChoices(types)}`).join("\n");
 }
 function buildMemorySection() {
-  const storeMemoryProps = TOOL_MODELS.thenvoi_store_memory.properties;
+  const storeMemoryProps = TOOL_MODELS.band_store_memory.properties;
   const systems = storeMemoryProps.system.enum;
   const segments = storeMemoryProps.segment.enum;
   const scopes = storeMemoryProps.scope.enum;
-  const fieldRules = `When calling \`thenvoi_store_memory\`, the \`system\`, \`type\`, \`segment\`, and \`scope\` fields
+  const fieldRules = `When calling \`band_store_memory\`, the \`system\`, \`type\`, \`segment\`, and \`scope\` fields
 must use these exact values (case-sensitive):
 
 - **system**: ${quoteChoices(systems)}
@@ -5750,61 +5633,6 @@ ${customSection}`.trim();
   return parts.join("\n\n");
 }
 
-// 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/shutdown.ts
 var DEFAULT_SHUTDOWN_TIMEOUT_MS = 3e4;
 var GracefulShutdown = class {
@@ -5883,12 +5711,13 @@ async function runWithGracefulShutdown(agent, options) {
   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,