@band-ai/sdk 0.1.10 → 0.2.0

package/dist/{chunk-FP237EAG.js → chunk-N2QTUMGO.js}

@@ -3,8 +3,10 @@ import {
   SYNTHETIC_CONTACT_EVENTS_SENDER_ID,
   SYNTHETIC_CONTACT_EVENTS_SENDER_NAME,
   SYNTHETIC_SENDER_TYPE,
-  buildParticipantsMessage
-} from "./chunk-RDM4TE4B.js";
+  buildParticipantsMessage,
+  toParticipantRecord,
+  toParticipantRecordFromRest
+} from "./chunk-LBWKISBS.js";
 import {
   CHAT_EVENT_TYPES,
   CHAT_TOOL_NAMES,
@@ -28,7 +30,7 @@ import {
   isMemoryType,
   isMemoryTypeForSystem,
   memoryTypeForSystemError
-} from "./chunk-MLROFDKR.js";
+} from "./chunk-RV76SKFT.js";
 import {
   WebSocketDisconnectError,
   genericCloseReason,
@@ -39,7 +41,7 @@ import {
   DEFAULT_REQUEST_OPTIONS,
   FernRestAdapter,
   fetchPaginated
-} from "./chunk-SG4WLD2H.js";
+} from "./chunk-EAI2M3WM.js";
 import {
   DEFAULT_AGENT_TOOLS_CAPABILITIES,
   createToolExecutorError,
@@ -53,7 +55,7 @@ import {
   TransportError,
   UnsupportedFeatureError,
   ValidationError
-} from "./chunk-YR3BOQNW.js";
+} from "./chunk-JY75VSQK.js";
 
 // src/contracts/capabilities.ts
 var CAPABILITY_LABELS = {
@@ -170,7 +172,7 @@ import { Socket } from "phoenix";
 import { WebSocket as NodeWebSocket } from "ws";
 function createNodeWebSocketFactory(headers) {
   const Constructor = NodeWebSocket;
-  class ThenvoiNodeWebSocket {
+  class BandNodeWebSocket {
     constructor(address, protocols) {
       const socket = new Constructor(address, protocols, headers ? { headers } : void 0);
       socket.once("unexpected-response", (request, response) => {
@@ -179,7 +181,7 @@ function createNodeWebSocketFactory(headers) {
       return socket;
     }
   }
-  return ThenvoiNodeWebSocket;
+  return BandNodeWebSocket;
 }
 async function emitUpgradeError(websocket, request, response) {
   const body = await readResponseBody(response);
@@ -567,9 +569,9 @@ function getSocketChannelCount(socket) {
   return candidate.channels.length;
 }
 
-// src/platform/ThenvoiLink.ts
-import { ThenvoiClient } from "@thenvoi/rest-client";
-var DEFAULT_WS_URL = "wss://app.thenvoi.com/api/v1/socket";
+// src/platform/BandLink.ts
+import { BandClient } from "@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:";
@@ -594,7 +596,7 @@ function toPlatformMessage(roomId, message) {
     createdAt: new Date(message.inserted_at)
   };
 }
-var ThenvoiLink = class {
+var BandLink = class {
   agentId;
   apiKey;
   wsUrl;
@@ -620,7 +622,7 @@ var ThenvoiLink = class {
       ...options.capabilities
     };
     const restApi = options.restApi ?? new FernRestAdapter(
-      new ThenvoiClient({
+      new BandClient({
         apiKey: this.apiKey,
         baseUrl: this.restUrl
       })
@@ -1235,6 +1237,7 @@ var Execution = class {
 };
 
 // src/runtime/tools/AgentTools.ts
+import { ParticipantRoster } from "@band-ai/band-sdk-core";
 var REQUIRED_ADAPTER_TOOL_METHODS = [
   "sendMessage",
   "sendEvent",
@@ -1273,13 +1276,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 ParticipantRoster();
     this.capabilities = {
       ...DEFAULT_AGENT_TOOLS_CAPABILITIES,
       ...options.capabilities
@@ -1291,17 +1294,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) {
@@ -1312,8 +1318,7 @@ var AgentTools = class {
         content,
         messageType,
         metadata
-      },
-      DEFAULT_REQUEST_OPTIONS
+      }
     );
   }
   async createChatroom(taskId) {
@@ -1352,7 +1357,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"
@@ -1367,7 +1372,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,
@@ -1395,17 +1400,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_);
@@ -1453,7 +1453,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;
@@ -1648,7 +1648,7 @@ var AgentTools = class {
     }
     return this.rest.archiveMemory(normalizedMemoryId, DEFAULT_REQUEST_OPTIONS);
   }
-  resolveMentions(mentions) {
+  resolveMentions(mentions, participants) {
     if (mentions.length === 0) {
       return [];
     }
@@ -1661,7 +1661,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
@@ -1717,9 +1717,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
@@ -1750,51 +1747,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_) {
@@ -2038,13 +2035,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(
@@ -2052,7 +2049,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)) {
@@ -2061,7 +2058,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)}`);
     }
@@ -2090,58 +2087,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/ExecutionContext.ts
+import { ParticipantRoster as ParticipantRoster2, RetryTracker } from "@band-ai/band-sdk-core";
 var DEDUP_CACHE_MAX = 500;
 var ExecutionContext = class {
   roomId;
@@ -2153,11 +2100,10 @@ var ExecutionContext = class {
   history = [];
   messageIds = /* @__PURE__ */ new Set();
   dedupCache = /* @__PURE__ */ new Map();
-  participants = [];
+  roster = new ParticipantRoster2();
   tools;
   adapterTools;
   participantsMessage = null;
-  lastSentParticipantIds = null;
   contactsMessage = null;
   contextCache = null;
   contextCacheExpiresAt = 0;
@@ -2172,11 +2118,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 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();
@@ -2244,23 +2190,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.`;
     }
@@ -2270,16 +2213,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;
     }
@@ -2289,15 +2223,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() {
@@ -2348,27 +2276,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 = [];
@@ -2410,7 +2330,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();
   }
@@ -3048,14 +2968,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;
 }
@@ -3099,8 +3011,7 @@ var ContactCallbackTools = class {
       {
         content,
         ...normalizedMentions ? { mentions: normalizedMentions } : {}
-      },
-      DEFAULT_REQUEST_OPTIONS
+      }
     );
   }
   async sendEvent(content, messageType, metadata) {
@@ -3114,8 +3025,7 @@ var ContactCallbackTools = class {
         content,
         messageType,
         ...metadata ? { metadata } : {}
-      },
-      DEFAULT_REQUEST_OPTIONS
+      }
     );
   }
   async addParticipant() {
@@ -3129,7 +3039,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);
@@ -3219,48 +3129,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"),
@@ -3273,15 +3183,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}`);
@@ -3295,14 +3205,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
@@ -3311,14 +3221,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;
@@ -3646,6 +3556,8 @@ function normalizeHandle(handle) {
 }
 
 // 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;
@@ -3682,6 +3594,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;
@@ -3734,7 +3652,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,
@@ -3958,10 +3876,9 @@ async function runWithGracefulShutdown(agent, options) {
 
 export {
   deriveDefaultRestUrl,
-  ThenvoiLink,
+  BandLink,
   Execution,
   AgentTools,
-  MessageRetryTracker,
   ExecutionContext,
   trackRoomJoin,
   trackRoomLeave,