@band-ai/sdk 0.1.6 → 0.2.0

package/dist/runtime.cjs

@@ -37,11 +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,
@@ -98,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;
@@ -227,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;
 }
@@ -278,8 +345,7 @@ var ContactCallbackTools = class {
       {
         content,
         ...normalizedMentions ? { mentions: normalizedMentions } : {}
-      },
-      DEFAULT_REQUEST_OPTIONS
+      }
     );
   }
   async sendEvent(content, messageType, metadata) {
@@ -293,8 +359,7 @@ var ContactCallbackTools = class {
         content,
         messageType,
         ...metadata ? { metadata } : {}
-      },
-      DEFAULT_REQUEST_OPTIONS
+      }
     );
   }
   async addParticipant() {
@@ -308,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);
@@ -398,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"),
@@ -452,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}`);
@@ -474,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
@@ -490,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;
@@ -1117,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",
@@ -1172,9 +1240,111 @@ var DEFAULT_AGENT_TOOLS_CAPABILITIES = {
   memory: true
 };
 
+// src/contracts/memory.ts
+var SENSORY_MEMORY_TYPES = [
+  "iconic",
+  // Visual input
+  "echoic",
+  // Auditory input
+  "haptic"
+  // Tactile input
+];
+var COGNITIVE_MEMORY_TYPES = [
+  "episodic",
+  // Events that occurred
+  "semantic",
+  // Facts, preferences, learned knowledge
+  "procedural"
+  // How to perform tasks
+];
+function namedValues(values) {
+  return Object.fromEntries(values.map((value) => [value, value]));
+}
+var MEMORY_SYSTEM_TYPES = {
+  sensory: SENSORY_MEMORY_TYPES,
+  // Brief sensory inputs
+  working: COGNITIVE_MEMORY_TYPES,
+  // Short-term session context
+  long_term: COGNITIVE_MEMORY_TYPES
+  // Persistent cross-conversation memory
+};
+var MEMORY_SYSTEMS = Object.keys(MEMORY_SYSTEM_TYPES);
+var MEMORY_TYPES = [
+  ...SENSORY_MEMORY_TYPES,
+  ...COGNITIVE_MEMORY_TYPES
+];
+var MEMORY_SEGMENTS = [
+  "user",
+  // User preferences or profile info
+  "agent",
+  // Facts or events about agents/entities
+  "tool",
+  // Tool usage or task procedures
+  "guideline"
+  // Behavioral rules or policies
+];
+var MEMORY_STORE_SCOPES = [
+  "subject",
+  // About one person/agent; requires subject_id
+  "organization"
+  // Shared org-wide
+];
+var MEMORY_LIST_SCOPES = [
+  "subject",
+  // Subject-scoped memories only
+  "organization",
+  // Organization-scoped memories only
+  "all"
+  // Both scopes (no scope filter)
+];
+var MEMORY_STATUSES = [
+  "active",
+  // Normal, visible memories
+  "superseded",
+  // Outdated; soft-deleted via band_supersede_memory
+  "archived",
+  // Hidden but preserved via band_archive_memory
+  "all"
+  // Any status (no filter)
+];
+var MEMORY_SYSTEM = namedValues(MEMORY_SYSTEMS);
+var MEMORY_TYPE = namedValues(MEMORY_TYPES);
+var MEMORY_SEGMENT = namedValues(MEMORY_SEGMENTS);
+var MEMORY_STORE_SCOPE = namedValues(MEMORY_STORE_SCOPES);
+function isMemorySystem(value) {
+  return MEMORY_SYSTEMS.includes(value);
+}
+function isMemoryType(value) {
+  return MEMORY_TYPES.includes(value);
+}
+function isMemoryTypeForSystem(system, type) {
+  return MEMORY_SYSTEM_TYPES[system].includes(type);
+}
+function isMemorySegment(value) {
+  return MEMORY_SEGMENTS.includes(value);
+}
+function isMemoryStoreScope(value) {
+  return MEMORY_STORE_SCOPES.includes(value);
+}
+function isMemoryListScope(value) {
+  return MEMORY_LIST_SCOPES.includes(value);
+}
+function isMemoryStatus(value) {
+  return MEMORY_STATUSES.includes(value);
+}
+function expectedList(values) {
+  return values.join(", ");
+}
+function expectedMemoryTypesForSystem(system) {
+  return expectedList(MEMORY_SYSTEM_TYPES[system]);
+}
+function memoryTypeForSystemError(system) {
+  return `type must be one of: ${expectedMemoryTypesForSystem(system)} for system "${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: {
@@ -1190,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: {
@@ -1209,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",
@@ -1224,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: {
@@ -1234,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: {
@@ -1254,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: {
@@ -1264,7 +1434,7 @@ var TOOL_MODELS = {
     },
     required: []
   },
-  thenvoi_list_contacts: {
+  band_list_contacts: {
     description: "List agent's contacts with pagination.",
     properties: {
       page: {
@@ -1281,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: {
@@ -1295,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: {
@@ -1309,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: {
@@ -1331,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: {
@@ -1350,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: {
@@ -1359,29 +1529,22 @@ var TOOL_MODELS = {
       },
       scope: {
         type: "string",
-        enum: ["subject", "organization", "all"],
+        enum: [...MEMORY_LIST_SCOPES],
         description: "Filter by scope."
       },
       system: {
         type: "string",
-        enum: ["sensory", "working", "long_term"],
+        enum: [...MEMORY_SYSTEMS],
         description: "Filter by memory system."
       },
       type: {
         type: "string",
-        enum: [
-          "iconic",
-          "echoic",
-          "haptic",
-          "episodic",
-          "semantic",
-          "procedural"
-        ],
+        enum: [...MEMORY_TYPES],
         description: "Filter by memory type."
       },
       segment: {
         type: "string",
-        enum: ["user", "agent", "tool", "guideline"],
+        enum: [...MEMORY_SEGMENTS],
         description: "Filter by segment."
       },
       content_query: {
@@ -1396,13 +1559,13 @@ var TOOL_MODELS = {
       },
       status: {
         type: "string",
-        enum: ["active", "superseded", "archived", "all"],
+        enum: [...MEMORY_STATUSES],
         description: "Filter by status."
       }
     },
     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: {
@@ -1411,24 +1574,17 @@ var TOOL_MODELS = {
       },
       system: {
         type: "string",
-        enum: ["sensory", "working", "long_term"],
+        enum: [...MEMORY_SYSTEMS],
         description: "Memory system tier."
       },
       type: {
         type: "string",
-        enum: [
-          "iconic",
-          "echoic",
-          "haptic",
-          "episodic",
-          "semantic",
-          "procedural"
-        ],
+        enum: [...MEMORY_TYPES],
         description: "Memory type (must be valid for selected system)."
       },
       segment: {
         type: "string",
-        enum: ["user", "agent", "tool", "guideline"],
+        enum: [...MEMORY_SEGMENTS],
         description: "Logical segment."
       },
       thought: {
@@ -1437,7 +1593,7 @@ var TOOL_MODELS = {
       },
       scope: {
         type: "string",
-        enum: ["subject", "organization"],
+        enum: [...MEMORY_STORE_SCOPES],
         description: "Visibility scope."
       },
       subject_id: {
@@ -1451,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: {
@@ -1461,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: {
@@ -1471,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: {
@@ -1484,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))
@@ -1503,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}`);
 }
@@ -1547,51 +1704,17 @@ var CONTACT_REQUEST_ACTIONS = /* @__PURE__ */ new Set([
   "reject",
   "cancel"
 ]);
-var MEMORY_SYSTEMS = /* @__PURE__ */ new Set([
-  "sensory",
-  "working",
-  "long_term"
-]);
-var MEMORY_TYPES = /* @__PURE__ */ new Set([
-  "iconic",
-  "echoic",
-  "haptic",
-  "episodic",
-  "semantic",
-  "procedural"
-]);
-var MEMORY_SEGMENTS = /* @__PURE__ */ new Set([
-  "user",
-  "agent",
-  "tool",
-  "guideline"
-]);
-var LIST_MEMORY_SCOPES = /* @__PURE__ */ new Set([
-  "subject",
-  "organization",
-  "all"
-]);
-var LIST_MEMORY_STATUSES = /* @__PURE__ */ new Set([
-  "active",
-  "superseded",
-  "archived",
-  "all"
-]);
-var MEMORY_SCOPES = /* @__PURE__ */ new Set([
-  "subject",
-  "organization"
-]);
 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
@@ -1603,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) {
@@ -1624,8 +1750,7 @@ var AgentTools = class {
         content,
         messageType,
         metadata
-      },
-      DEFAULT_REQUEST_OPTIONS
+      }
     );
   }
   async createChatroom(taskId) {
@@ -1664,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"
@@ -1679,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,
@@ -1707,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_);
@@ -1765,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;
@@ -1960,7 +2080,7 @@ var AgentTools = class {
     }
     return this.rest.archiveMemory(normalizedMemoryId, DEFAULT_REQUEST_OPTIONS);
   }
-  resolveMentions(mentions) {
+  resolveMentions(mentions, participants) {
     if (mentions.length === 0) {
       return [];
     }
@@ -1973,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
@@ -2029,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
@@ -2062,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_) {
@@ -2158,6 +2275,9 @@ var AgentTools = class {
     const status = this.normalizeOptionalMemoryStatus(arguments_.status);
     const subjectId = this.normalizeOptionalString(arguments_.subject_id);
     const contentQuery = this.normalizeOptionalString(arguments_.content_query);
+    if (system && type && !isMemoryTypeForSystem(system, type)) {
+      throw new ValidationError(memoryTypeForSystemError(system));
+    }
     return {
       ...subjectId ? { subject_id: subjectId } : {},
       ...scope ? { scope } : {},
@@ -2179,13 +2299,21 @@ var AgentTools = class {
     const subjectId = this.normalizeOptionalString(arguments_.subject_id);
     const metadata = this.normalizeOptionalMetadata(arguments_.metadata);
     if (!system) {
-      throw new ValidationError("system must be one of: sensory, working, long_term");
+      throw new ValidationError(`system must be one of: ${expectedList(MEMORY_SYSTEMS)}`);
     }
     if (!type) {
-      throw new ValidationError("type must be one of: iconic, echoic, haptic, episodic, semantic, procedural");
+      throw new ValidationError(`type must be one of: ${expectedList(MEMORY_TYPES)}`);
+    }
+    if (!isMemoryTypeForSystem(system, type)) {
+      throw new ValidationError(memoryTypeForSystemError(system));
     }
     if (!segment) {
-      throw new ValidationError("segment must be one of: user, agent, tool, guideline");
+      throw new ValidationError(`segment must be one of: ${expectedList(MEMORY_SEGMENTS)}`);
+    }
+    if (scope === "subject" && !subjectId) {
+      throw new ValidationError(
+        'scope="subject" requires a subject_id (the UUID of the person or agent the memory is about). If you do not have a concrete subject UUID, retry with scope="organization" and omit subject_id. Do not invent a UUID.'
+      );
     }
     return {
       content,
@@ -2265,8 +2393,8 @@ var AgentTools = class {
     if (!normalized) {
       return void 0;
     }
-    if (!isListMemoryScope(normalized)) {
-      throw new ValidationError("scope must be one of: subject, organization, all");
+    if (!isMemoryListScope(normalized)) {
+      throw new ValidationError(`scope must be one of: ${expectedList(MEMORY_LIST_SCOPES)}`);
     }
     return normalized;
   }
@@ -2276,7 +2404,7 @@ var AgentTools = class {
       return void 0;
     }
     if (!isMemorySystem(normalized)) {
-      throw new ValidationError("system must be one of: sensory, working, long_term");
+      throw new ValidationError(`system must be one of: ${expectedList(MEMORY_SYSTEMS)}`);
     }
     return normalized;
   }
@@ -2286,7 +2414,7 @@ var AgentTools = class {
       return void 0;
     }
     if (!isMemoryType(normalized)) {
-      throw new ValidationError("type must be one of: iconic, echoic, haptic, episodic, semantic, procedural");
+      throw new ValidationError(`type must be one of: ${expectedList(MEMORY_TYPES)}`);
     }
     return normalized;
   }
@@ -2296,7 +2424,7 @@ var AgentTools = class {
       return void 0;
     }
     if (!isMemorySegment(normalized)) {
-      throw new ValidationError("segment must be one of: user, agent, tool, guideline");
+      throw new ValidationError(`segment must be one of: ${expectedList(MEMORY_SEGMENTS)}`);
     }
     return normalized;
   }
@@ -2306,7 +2434,7 @@ var AgentTools = class {
       return void 0;
     }
     if (!isMemoryStatus(normalized)) {
-      throw new ValidationError("status must be one of: active, superseded, archived, all");
+      throw new ValidationError(`status must be one of: ${expectedList(MEMORY_STATUSES)}`);
     }
     return normalized;
   }
@@ -2315,8 +2443,8 @@ var AgentTools = class {
     if (!normalized) {
       return void 0;
     }
-    if (!isStoreMemoryScope(normalized)) {
-      throw new ValidationError("scope must be one of: subject, organization");
+    if (!isMemoryStoreScope(normalized)) {
+      throw new ValidationError(`scope must be one of: ${expectedList(MEMORY_STORE_SCOPES)}`);
     }
     return normalized;
   }
@@ -2324,24 +2452,6 @@ var AgentTools = class {
 function isContactRequestAction(value) {
   return CONTACT_REQUEST_ACTIONS.has(value);
 }
-function isMemorySystem(value) {
-  return MEMORY_SYSTEMS.has(value);
-}
-function isMemoryType(value) {
-  return MEMORY_TYPES.has(value);
-}
-function isMemorySegment(value) {
-  return MEMORY_SEGMENTS.has(value);
-}
-function isStoreMemoryScope(value) {
-  return MEMORY_SCOPES.has(value);
-}
-function isListMemoryScope(value) {
-  return LIST_MEMORY_SCOPES.has(value);
-}
-function isMemoryStatus(value) {
-  return LIST_MEMORY_STATUSES.has(value);
-}
 function coercePositiveInt(value, fallback) {
   const num = Number(value ?? fallback);
   return Number.isFinite(num) && num >= 1 ? Math.floor(num) : fallback;
@@ -2357,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(
@@ -2371,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)) {
@@ -2380,18 +2490,20 @@ function validateToolArgs(toolName, args) {
       );
     }
   }
-  if (toolName === "thenvoi_store_memory") {
-    const validSystems = ["sensory", "working", "long_term"];
-    const validTypes = ["iconic", "echoic", "haptic", "episodic", "semantic", "procedural"];
-    const validSegments = ["user", "agent", "tool", "guideline"];
-    if (typeof args.system === "string" && !validSystems.includes(args.system)) {
-      errors.push(`system: Invalid value '${args.system}'. Expected one of: ${validSystems.join(", ")}`);
+  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)}`);
     }
-    if (typeof args.type === "string" && !validTypes.includes(args.type)) {
-      errors.push(`type: Invalid value '${args.type}'. Expected one of: ${validTypes.join(", ")}`);
+    if (typeof args.type === "string" && !isMemoryType(args.type)) {
+      errors.push(`type: Invalid value '${args.type}'. Expected one of: ${expectedList(MEMORY_TYPES)}`);
+    }
+    if (typeof args.system === "string" && isMemorySystem(args.system) && typeof args.type === "string" && isMemoryType(args.type) && !isMemoryTypeForSystem(args.system, args.type)) {
+      errors.push(
+        `type: Invalid value '${args.type}' for system '${args.system}'. Expected one of: ${expectedMemoryTypesForSystem(args.system)}`
+      );
     }
-    if (typeof args.segment === "string" && !validSegments.includes(args.segment)) {
-      errors.push(`segment: Invalid value '${args.segment}'. Expected one of: ${validSegments.join(", ")}`);
+    if (typeof args.segment === "string" && !isMemorySegment(args.segment)) {
+      errors.push(`segment: Invalid value '${args.segment}'. Expected one of: ${expectedList(MEMORY_SEGMENTS)}`);
     }
   }
   if (errors.length > 0) {
@@ -2407,112 +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}]]`, `@${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(`- @${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;
@@ -2524,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;
@@ -2543,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();
@@ -2615,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.`;
     }
@@ -2641,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;
     }
@@ -2660,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() {
@@ -2719,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 = [];
@@ -2781,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();
   }
@@ -2982,7 +2963,7 @@ var AgentRuntime = class {
     await this.link.disconnect();
   }
   async stop(timeoutMs) {
-    if (!this.running || this.stopping) {
+    if (this.stopping || !this.running && !this.fatalError) {
       return true;
     }
     this.stopping = true;
@@ -3002,7 +2983,8 @@ var AgentRuntime = class {
       }
     }
     for (const roomId of [...this.subscribedRooms]) {
-      await this.leaveTrackedRoom(roomId);
+      const remaining = deadline === void 0 ? void 0 : Math.max(0, deadline - Date.now());
+      await this.leaveTrackedRoom(roomId, remaining);
     }
     for (const roomId of [...this.contexts.keys()]) {
       await this.onSessionCleanup(roomId);
@@ -3038,7 +3020,13 @@ var AgentRuntime = class {
   }
   async consumeLoop(signal) {
     while (!signal.aborted) {
-      const event = await this.link.nextEvent(signal);
+      let event;
+      try {
+        event = await this.link.nextEvent(signal);
+      } catch (error) {
+        await this.failRuntime(error, syntheticRuntimeFailureEvent(this.agentId));
+        return;
+      }
       if (!event) {
         return;
       }
@@ -3201,13 +3189,13 @@ var AgentRuntime = class {
       }
     });
   }
-  async leaveTrackedRoom(roomId) {
+  async leaveTrackedRoom(roomId, timeoutMs) {
     await trackRoomLeave({
       link: this.link,
       roomId,
       trackedRooms: this.subscribedRooms,
       onLeft: async (leftRoomId) => {
-        await this.executions.get(leftRoomId)?.stop();
+        await this.executions.get(leftRoomId)?.stop(timeoutMs);
         this.contexts.delete(leftRoomId);
         this.executions.delete(leftRoomId);
         await this.onSessionCleanup(leftRoomId);
@@ -3244,6 +3232,23 @@ var AgentRuntime = class {
     }
   }
 };
+function syntheticRuntimeFailureEvent(agentId) {
+  return {
+    type: "message_created",
+    roomId: null,
+    payload: {
+      id: "runtime-failed",
+      content: "",
+      sender_id: agentId,
+      sender_type: "Agent",
+      sender_name: null,
+      message_type: "text",
+      metadata: {},
+      inserted_at: (/* @__PURE__ */ new Date(0)).toISOString(),
+      updated_at: (/* @__PURE__ */ new Date(0)).toISOString()
+    }
+  };
+}
 function assertNever2(value) {
   throw new Error(`Unhandled platform event: ${JSON.stringify(value)}`);
 }
@@ -3469,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}`);
@@ -3724,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) {
@@ -3753,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);
     }
@@ -4185,55 +4133,241 @@ var payloadSchemas = {
 
 // src/platform/streaming/PhoenixChannelsTransport.ts
 var import_phoenix = require("phoenix");
+
+// src/platform/streaming/disconnectReason.ts
+var import_zod2 = require("zod");
+var UPGRADE_CODES = [
+  "invalid_on_conflict",
+  "connection_conflict",
+  "too_many_requests",
+  "tracking_failed"
+];
+var UPGRADE_REASONS = {
+  invalid_on_conflict: {
+    status: 400,
+    message: "Invalid websocket conflict policy.",
+    retryable: false
+  },
+  connection_conflict: {
+    status: 409,
+    message: "Websocket connection conflict.",
+    retryable: false
+  },
+  too_many_requests: {
+    status: 429,
+    message: "Too many websocket connection attempts.",
+    retryable: true
+  },
+  tracking_failed: {
+    status: 503,
+    message: "Websocket connection tracking failed.",
+    retryable: true
+  }
+};
+var upgradeErrorSchema = import_zod2.z.object({
+  status: import_zod2.z.number(),
+  body: import_zod2.z.preprocess(
+    (body) => {
+      if (typeof body !== "string") {
+        return body;
+      }
+      try {
+        return JSON.parse(body);
+      } catch {
+        return null;
+      }
+    },
+    import_zod2.z.object({
+      error: import_zod2.z.object({
+        code: import_zod2.z.enum(UPGRADE_CODES),
+        message: import_zod2.z.string().optional(),
+        retry_after: import_zod2.z.number().nullable().optional(),
+        request_id: import_zod2.z.string().nullable().optional()
+      })
+    })
+  ),
+  headers: import_zod2.z.record(import_zod2.z.unknown()).optional()
+});
+var WebSocketDisconnectError = class extends Error {
+  reason;
+  constructor(reason) {
+    super(reason.message);
+    this.name = "WebSocketDisconnectError";
+    this.reason = reason;
+  }
+};
+function parseSupersedeDisconnectReason(payload) {
+  if (typeof payload.reason !== "string" || typeof payload.message !== "string") {
+    return null;
+  }
+  return {
+    source: "agent_control",
+    code: payload.reason,
+    message: payload.message,
+    retryable: false,
+    retryAfter: typeof payload.retry_after === "number" ? payload.retry_after : null,
+    targetSocketId: typeof payload.target_socket_id === "string" ? payload.target_socket_id : null,
+    correlationId: typeof payload.correlation_id === "string" ? payload.correlation_id : null
+  };
+}
+function parseUpgradeDisconnectReason(event) {
+  const parsed = upgradeErrorSchema.safeParse(event);
+  if (!parsed.success) {
+    return null;
+  }
+  const { status, body, headers } = parsed.data;
+  const {
+    code,
+    message,
+    retry_after: retryAfter,
+    request_id: requestId
+  } = body.error;
+  const reason = UPGRADE_REASONS[code];
+  if (status !== reason.status) {
+    return null;
+  }
+  return {
+    source: "upgrade",
+    status: reason.status,
+    code,
+    message: message ?? reason.message,
+    retryable: reason.retryable,
+    retryAfter: retryAfter ?? retryAfterFromHeaders(headers),
+    requestId: requestId ?? null
+  };
+}
+function genericCloseReason(event) {
+  return {
+    source: "websocket_close",
+    code: "websocket.closed",
+    message: "Phoenix socket closed without a platform disconnect reason.",
+    retryable: true,
+    closeCode: typeof event?.code === "number" ? event.code : null,
+    closeReason: typeof event?.reason === "string" && event.reason.length > 0 ? event.reason : null
+  };
+}
+function retryAfterFromHeaders(headers) {
+  const value = headers?.["retry-after"] ?? headers?.["Retry-After"];
+  if (typeof value === "number") {
+    return value;
+  }
+  if (typeof value === "string" && value.trim() !== "") {
+    const seconds = Number(value);
+    return Number.isFinite(seconds) ? seconds : null;
+  }
+  return null;
+}
+
+// src/platform/streaming/nodeWebSocketFactory.ts
 var import_ws = require("ws");
+function createNodeWebSocketFactory(headers) {
+  const Constructor = import_ws.WebSocket;
+  class BandNodeWebSocket {
+    constructor(address, protocols) {
+      const socket = new Constructor(address, protocols, headers ? { headers } : void 0);
+      socket.once("unexpected-response", (request, response) => {
+        void emitUpgradeError(socket, request, response);
+      });
+      return socket;
+    }
+  }
+  return BandNodeWebSocket;
+}
+async function emitUpgradeError(websocket, request, response) {
+  const body = await readResponseBody(response);
+  const error = new Error(
+    `Unexpected server response: ${response.statusCode ?? "unknown"}`
+  );
+  error.status = response.statusCode;
+  error.body = body;
+  error.headers = response.headers;
+  request.destroy();
+  websocket.emit("error", error);
+  websocket.emit("close", 1006, Buffer.alloc(0));
+}
+async function readResponseBody(response) {
+  const chunks = [];
+  for await (const chunk of response) {
+    chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+  }
+  return Buffer.concat(chunks).toString("utf8");
+}
+
+// src/platform/streaming/PhoenixChannelsTransport.ts
 var PhoenixChannelsTransport = class {
   socket;
+  agentId;
   channels = /* @__PURE__ */ new Map();
   channelRefs = /* @__PURE__ */ new Map();
   pendingJoins = /* @__PURE__ */ new Map();
   logger;
+  onTerminalDisconnect;
   onHandlerError;
   connected = false;
   connectPromise = null;
   connectResolve = null;
+  connectReject = null;
+  lastDisconnectReason = null;
+  terminalDisconnectError = null;
+  runForeverWaiters = /* @__PURE__ */ new Set();
+  stoppingReconnect = false;
+  suppressNextCloseReason = false;
   constructor(options) {
     this.logger = options.logger ?? new NoopLogger();
+    this.agentId = options.agentId;
+    this.onTerminalDisconnect = options.onTerminalDisconnect;
     let wsUrl = options.wsUrl;
     if (wsUrl.endsWith("/websocket")) {
       wsUrl = wsUrl.slice(0, -"/websocket".length);
     }
+    const reconnectAfterMs = options.reconnectAfterMs ?? ((tries) => [1e3, 2e3, 5e3, 1e4, 3e4][tries - 1] ?? 3e4);
     this.socket = new import_phoenix.Socket(wsUrl, {
       params: {
-        api_key: options.apiKey,
-        agent_id: options.agentId
+        agent_id: options.agentId,
+        ...options.conflictPolicy ? { on_conflict: options.conflictPolicy } : {}
       },
       heartbeatIntervalMs: options.heartbeatIntervalMs,
-      reconnectAfterMs: options.reconnectAfterMs ?? ((tries) => [1e3, 2e3, 5e3, 1e4, 3e4][tries - 1] ?? 3e4),
-      transport: options.websocketFactory ?? resolveWebSocketFactory()
+      reconnectAfterMs: (tries) => {
+        if (this.terminalDisconnectError) {
+          return Number.POSITIVE_INFINITY;
+        }
+        return reconnectAfterMs(tries);
+      },
+      transport: options.websocketFactory ?? resolveWebSocketFactory(options.apiKey)
     });
     this.socket.onOpen(() => {
-      this.connected = true;
-      this.connectResolve?.();
-      this.connectResolve = null;
-      this.logger.info("Phoenix socket opened", {
-        channels: getSocketChannelCount(this.socket)
-      });
+      void this.handleOpen();
     });
     this.socket.onClose((event) => {
-      this.connected = false;
-      if (getSocketChannelCount(this.socket) === 0) {
-        this.socket.disconnect();
-      }
-      this.logger.info("Phoenix socket closed", {
-        code: event?.code ?? null,
-        reason: event?.reason ?? null
-      });
+      this.recordSocketClose(event);
     });
     this.socket.onError((event) => {
+      const errorEvent = unwrapErrorEvent(event);
+      const upgradeReason = parseUpgradeDisconnectReason(errorEvent);
+      if (upgradeReason) {
+        if (upgradeReason.retryable) {
+          this.lastDisconnectReason = upgradeReason;
+          this.connectReject?.(new WebSocketDisconnectError(upgradeReason));
+          this.stopReconnectIfNoChannels({ suppressCloseReason: true });
+        } else {
+          this.recordTerminalDisconnect(upgradeReason);
+        }
+        this.logger.warn("Phoenix socket upgrade failed", {
+          reason: upgradeReason
+        });
+        return;
+      }
+      this.connectReject?.(
+        new TransportError("Phoenix socket connection failed", errorEvent)
+      );
+      this.stopReconnectIfNoChannels({ suppressCloseReason: true });
       this.logger.warn("Phoenix socket error", { event });
     });
   }
   async connect() {
+    if (this.terminalDisconnectError) {
+      throw this.terminalDisconnectError;
+    }
     if (this.connected) {
       return;
     }
@@ -4257,15 +4391,30 @@ var PhoenixChannelsTransport = class {
     await this.connectPromise;
   }
   async disconnect() {
-    for (const topic of this.channels.keys()) {
-      await this.leave(topic);
-    }
+    const results = await Promise.allSettled(
+      [...this.channels.keys()].map((topic) => this.leave(topic))
+    );
     this.socket.disconnect();
     this.connected = false;
+    const failures = [];
+    for (const result of results) {
+      if (result.status === "rejected") {
+        failures.push(result.reason);
+      }
+    }
+    if (failures.length > 0) {
+      throw new AggregateError(
+        failures,
+        "Failed to leave one or more Phoenix topics during disconnect"
+      );
+    }
   }
   isConnected() {
     return this.connected;
   }
+  getDisconnectReason() {
+    return this.lastDisconnectReason;
+  }
   async join(topic, handlers) {
     if (this.channels.has(topic)) {
       return;
@@ -4301,7 +4450,10 @@ var PhoenixChannelsTransport = class {
         channel.join().receive("ok", () => resolve()).receive(
           "error",
           (error) => reject(new TransportError(`Failed to join topic ${topic}`, error))
-        ).receive("timeout", () => reject(new TransportError(`Timeout joining topic ${topic}`)));
+        ).receive(
+          "timeout",
+          () => reject(new TransportError(`Timeout joining topic ${topic}`))
+        );
       });
     } catch (error) {
       for (const [event, ref] of refs) {
@@ -4329,19 +4481,127 @@ var PhoenixChannelsTransport = class {
       channel.leave().receive("ok", () => resolve()).receive(
         "error",
         (error) => reject(new TransportError(`Failed to leave topic ${topic}`, error))
-      ).receive("timeout", () => reject(new TransportError(`Timeout leaving topic ${topic}`)));
+      ).receive(
+        "timeout",
+        () => reject(new TransportError(`Timeout leaving topic ${topic}`))
+      );
     });
     this.channels.delete(topic);
     this.logger.debug("Left topic", { topic });
   }
   async runForever(signal) {
+    if (this.terminalDisconnectError) {
+      throw this.terminalDisconnectError;
+    }
     if (signal.aborted) {
       return;
     }
-    await new Promise((resolve) => {
-      signal.addEventListener("abort", () => resolve(), { once: true });
+    await new Promise((resolve, reject) => {
+      let settled = false;
+      const abortController = new AbortController();
+      const waiter = {
+        reject: (error) => {
+          if (settled) {
+            return;
+          }
+          settled = true;
+          this.runForeverWaiters.delete(waiter);
+          abortController.abort();
+          reject(error);
+        }
+      };
+      this.runForeverWaiters.add(waiter);
+      signal.addEventListener(
+        "abort",
+        () => {
+          if (settled) {
+            return;
+          }
+          settled = true;
+          this.runForeverWaiters.delete(waiter);
+          resolve();
+        },
+        { once: true, signal: abortController.signal }
+      );
     });
   }
+  async handleOpen() {
+    try {
+      await this.subscribeAgentControl();
+    } catch (error) {
+      this.connected = false;
+      this.socket.disconnect();
+      this.connectReject?.(
+        error instanceof Error ? error : new TransportError(String(error))
+      );
+      this.logger.warn("Failed to join mandatory agent_control channel", {
+        error
+      });
+      return;
+    }
+    this.connected = true;
+    this.connectResolve?.();
+    this.connectResolve = null;
+    this.connectReject = null;
+    this.logger.info("Phoenix socket opened", {
+      channels: getSocketChannelCount(this.socket)
+    });
+  }
+  stopReconnectIfNoChannels(options = {}) {
+    if (this.stoppingReconnect || getSocketChannelCount(this.socket) !== 0) {
+      return;
+    }
+    this.suppressNextCloseReason = options.suppressCloseReason ?? false;
+    this.stoppingReconnect = true;
+    this.socket.disconnect();
+    this.stoppingReconnect = false;
+  }
+  async subscribeAgentControl() {
+    if (!this.agentId) {
+      return;
+    }
+    await this.join(`agent_control:${this.agentId}`, {
+      supersede: (payload) => {
+        const reason = parseSupersedeDisconnectReason(payload);
+        if (!reason) {
+          this.logger.warn("Invalid agent_control supersede payload", {
+            payload
+          });
+          return;
+        }
+        this.recordTerminalDisconnect(reason);
+      }
+    });
+  }
+  recordSocketClose(event) {
+    this.connected = false;
+    const suppressCloseReason = this.suppressNextCloseReason;
+    this.suppressNextCloseReason = false;
+    this.stopReconnectIfNoChannels();
+    if (!suppressCloseReason && !this.terminalDisconnectError && !this.lastDisconnectReason) {
+      this.lastDisconnectReason = genericCloseReason(event);
+    }
+    this.logger.info("Phoenix socket closed", {
+      code: event?.code ?? null,
+      reason: event?.reason ?? null,
+      platformReason: this.lastDisconnectReason
+    });
+  }
+  recordTerminalDisconnect(reason) {
+    if (this.terminalDisconnectError) {
+      return;
+    }
+    const error = new WebSocketDisconnectError(reason);
+    this.lastDisconnectReason = reason;
+    this.terminalDisconnectError = error;
+    this.onTerminalDisconnect?.(reason);
+    this.connectReject?.(error);
+    for (const waiter of this.runForeverWaiters) {
+      waiter.reject(error);
+    }
+    this.runForeverWaiters.clear();
+    this.socket.disconnect();
+  }
   async waitForConnection(timeoutMs = 1e4) {
     if (this.connected) {
       return;
@@ -4349,20 +4609,43 @@ var PhoenixChannelsTransport = class {
     await new Promise((resolve, reject) => {
       const timeout = setTimeout(() => {
         this.connectResolve = null;
-        reject(new TransportError("Timed out waiting for Phoenix socket connection"));
+        this.connectReject = null;
+        reject(
+          new TransportError("Timed out waiting for Phoenix socket connection")
+        );
       }, timeoutMs);
       this.connectResolve = () => {
         clearTimeout(timeout);
+        this.connectReject = null;
         resolve();
       };
+      this.connectReject = (error) => {
+        clearTimeout(timeout);
+        this.connectResolve = null;
+        this.connectReject = null;
+        reject(
+          error instanceof Error ? error : new TransportError(String(error))
+        );
+      };
     });
   }
 };
-function resolveWebSocketFactory() {
+function resolveWebSocketFactory(apiKey) {
   if (typeof process !== "undefined" && process.versions?.node) {
-    return import_ws.WebSocket;
+    return createNodeWebSocketFactory({ "x-api-key": apiKey });
+  }
+  throw new TransportError(
+    "Phoenix WebSocket API-key auth requires a WebSocket transport that can set handshake headers."
+  );
+}
+function unwrapErrorEvent(event) {
+  if (!isErrorEvent(event)) {
+    return event;
   }
-  return WebSocket;
+  return event.error;
+}
+function isErrorEvent(event) {
+  return typeof event === "object" && event !== null && "error" in event;
 }
 function removeSocketChannel(socket, channel) {
   const candidate = socket;
@@ -4376,14 +4659,20 @@ 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:";
   return `${protocol}//${parsed.host}`;
 }
+function roomTopics(roomId) {
+  return {
+    chat: `chat_room:${roomId}`,
+    participants: `room_participants:${roomId}`
+  };
+}
 function toPlatformMessage(roomId, message) {
   return {
     id: message.id,
@@ -4397,7 +4686,7 @@ function toPlatformMessage(roomId, message) {
     createdAt: new Date(message.inserted_at)
   };
 }
-var ThenvoiLink = class {
+var BandLink = class {
   agentId;
   apiKey;
   wsUrl;
@@ -4410,6 +4699,8 @@ var ThenvoiLink = class {
   eventQueue = [];
   waiters = [];
   connected = false;
+  lastDisconnectReason = null;
+  terminalDisconnectError = null;
   constructor(options) {
     this.agentId = options.agentId;
     this.apiKey = options.apiKey;
@@ -4421,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
       })
@@ -4431,17 +4722,35 @@ var ThenvoiLink = class {
       wsUrl: this.wsUrl,
       apiKey: this.apiKey,
       agentId: this.agentId,
-      logger: this.logger
+      logger: this.logger,
+      conflictPolicy: options.conflictPolicy,
+      onTerminalDisconnect: (reason) => {
+        this.recordDisconnectReason(reason);
+      }
     });
   }
   isConnected() {
     return this.connected;
   }
+  getDisconnectReason() {
+    return this.lastDisconnectReason;
+  }
   async connect() {
     if (this.connected) {
       return;
     }
-    await this.transport.connect();
+    try {
+      await this.transport.connect();
+    } catch (error) {
+      if (error instanceof WebSocketDisconnectError) {
+        if (error.reason.retryable) {
+          this.lastDisconnectReason = error.reason;
+        } else {
+          this.recordDisconnectError(error);
+        }
+      }
+      throw error;
+    }
     this.connected = true;
   }
   async disconnect() {
@@ -4455,8 +4764,23 @@ var ThenvoiLink = class {
     this.connected = false;
   }
   async runForever(signal) {
+    if (this.terminalDisconnectError) {
+      throw this.terminalDisconnectError;
+    }
     await this.transport.runForever(signal);
   }
+  recordDisconnectReason(reason) {
+    this.recordDisconnectError(new WebSocketDisconnectError(reason));
+  }
+  recordDisconnectError(error) {
+    this.connected = false;
+    this.lastDisconnectReason = error.reason;
+    this.terminalDisconnectError = error;
+    while (this.waiters.length > 0) {
+      const waiter = this.waiters.shift();
+      waiter?.reject(error);
+    }
+  }
   queueEvent(event) {
     const waiter = this.waiters.shift();
     if (waiter) {
@@ -4481,32 +4805,42 @@ var ThenvoiLink = class {
     if (this.subscribedRooms.has(roomId)) {
       return;
     }
-    await this.transport.join(`chat_room:${roomId}`, {
-      message_created: (payload) => {
-        this.emit("message_created", payload, roomId);
-      }
-    });
-    await this.transport.join(`room_participants:${roomId}`, {
-      participant_added: (payload) => {
-        this.emit("participant_added", payload, roomId);
-      },
-      participant_removed: (payload) => {
-        this.emit("participant_removed", payload, roomId);
-      },
-      room_deleted: (payload) => {
-        this.emit("room_deleted", payload, roomId);
-      }
-    });
+    await this.joinRoomTopics(roomId);
     this.subscribedRooms.add(roomId);
   }
   async unsubscribeRoom(roomId) {
     if (!this.subscribedRooms.has(roomId)) {
       return;
     }
-    await this.transport.leave(`chat_room:${roomId}`);
-    await this.transport.leave(`room_participants:${roomId}`);
+    const topics = roomTopics(roomId);
+    await this.transport.leave(topics.chat);
+    await this.transport.leave(topics.participants);
     this.subscribedRooms.delete(roomId);
   }
+  async joinRoomTopics(roomId) {
+    const topics = roomTopics(roomId);
+    await this.transport.join(topics.chat, {
+      message_created: (payload) => {
+        this.emit("message_created", payload, roomId);
+      }
+    });
+    try {
+      await this.transport.join(topics.participants, {
+        participant_added: (payload) => {
+          this.emit("participant_added", payload, roomId);
+        },
+        participant_removed: (payload) => {
+          this.emit("participant_removed", payload, roomId);
+        },
+        room_deleted: (payload) => {
+          this.emit("room_deleted", payload, roomId);
+        }
+      });
+    } catch (error) {
+      await this.transport.leave(topics.chat);
+      throw error;
+    }
+  }
   async subscribeAgentContacts() {
     assertCapability(this.capabilities, "contacts", "Contacts streaming");
     await this.transport.join(`agent_contacts:${this.agentId}`, {
@@ -4528,6 +4862,9 @@ var ThenvoiLink = class {
     await this.transport.leave(`agent_contacts:${this.agentId}`);
   }
   async nextEvent(signal) {
+    if (this.terminalDisconnectError) {
+      throw this.terminalDisconnectError;
+    }
     if (signal?.aborted) {
       return null;
     }
@@ -4535,19 +4872,19 @@ var ThenvoiLink = class {
     if (queued) {
       return queued;
     }
-    return new Promise((resolve) => {
+    return new Promise((resolve, reject) => {
       let settled = false;
       const onAbort = () => {
         const index = this.waiters.indexOf(waiter);
         if (index >= 0) {
           this.waiters.splice(index, 1);
         }
-        finalize(null);
+        finalizeResolve(null);
       };
       const cleanup = () => {
         signal?.removeEventListener("abort", onAbort);
       };
-      const finalize = (event) => {
+      const finalizeResolve = (event) => {
         if (settled) {
           return;
         }
@@ -4555,8 +4892,17 @@ var ThenvoiLink = class {
         cleanup();
         resolve(event);
       };
+      const finalizeReject = (error) => {
+        if (settled) {
+          return;
+        }
+        settled = true;
+        cleanup();
+        reject(error);
+      };
       const waiter = {
-        resolve: finalize,
+        resolve: finalizeResolve,
+        reject: finalizeReject,
         cleanup
       };
       this.waiters.push(waiter);
@@ -4568,7 +4914,10 @@ var ThenvoiLink = class {
       next: async () => {
         const value = await this.nextEvent();
         if (value === null) {
-          return { done: true, value: void 0 };
+          return {
+            done: true,
+            value: void 0
+          };
         }
         return { done: false, value };
       }
@@ -4650,7 +4999,9 @@ var ThenvoiLink = class {
   }
   async listChats(request, requestOptions) {
     if (!this.rest.listChats) {
-      throw new UnsupportedFeatureError("Chat listing is not available in current REST adapter");
+      throw new UnsupportedFeatureError(
+        "Chat listing is not available in current REST adapter"
+      );
     }
     return this.rest.listChats(request, requestOptions);
   }
@@ -4734,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;
@@ -4770,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;
@@ -4822,12 +5181,13 @@ var PlatformRuntime = class {
   }
   async doInitialize() {
     if (!this.linkInstance) {
-      this.linkInstance = new ThenvoiLink({
+      this.linkInstance = new BandLink({
         ...this.linkOptions,
         agentId: this._agentId,
         apiKey: this._apiKey,
         wsUrl: this._wsUrl,
-        restUrl: this._restUrl
+        restUrl: this._restUrl,
+        logger: this.logger
       });
     }
     if (this.configuredIdentity) {
@@ -5104,26 +5464,28 @@ var RoomPresence = class {
   }
 };
 
-// src/runtime/prompts.ts
-var BASE_INSTRUCTIONS = `
+// 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.
-Mentions use handles: @<username> for users, @<username>/<agent-name> for agents.
-
-## CRITICAL: Delegate When You Cannot Help Directly
+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
 
@@ -5139,48 +5501,111 @@ Only remove agents if the user explicitly requests it.
 When someone asks you to get information from another agent:
 1. Ask the other agent for the information
 2. When you receive the response, IMMEDIATELY relay it back to the ORIGINAL REQUESTER
-3. Do NOT just thank the helper agent - the requester is waiting for their answer!
+3. Do NOT just thank the helper agent - the requester is waiting for their answer!`;
+var THINKING_SECTION = `## IMPORTANT: Always Share Your Thinking
 
-## IMPORTANT: Always Share Your Thinking
-
-You MUST call \`thenvoi_send_event(content, message_type="thought")\` BEFORE every action.
-This is required so users can see your reasoning process.
-
-## Examples
+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,
+  THINKING_SECTION,
+  EXAMPLES_SECTION
+].join("\n\n") + "\n";
+
+// src/runtime/prompts/memory.ts
+var MEMORY_INTRO = `## Memory Tools
+
+You have access to memory tools for storing and retrieving information
+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,
+    system: MEMORY_SYSTEM.long_term,
+    type,
+    segment,
+    scope
+  };
+}
+var COMMON_MEMORY_PATTERNS = [
+  longTermPattern("Facts learned about a specific agent/entity", MEMORY_TYPE.semantic, MEMORY_SEGMENT.agent, MEMORY_STORE_SCOPE.subject),
+  longTermPattern("Events involving a specific person/agent", MEMORY_TYPE.episodic, MEMORY_SEGMENT.agent, MEMORY_STORE_SCOPE.subject),
+  longTermPattern("A user's preferences or profile info", MEMORY_TYPE.semantic, MEMORY_SEGMENT.user, MEMORY_STORE_SCOPE.subject),
+  longTermPattern("Org-wide knowledge or how to perform a task", MEMORY_TYPE.procedural, MEMORY_SEGMENT.tool, MEMORY_STORE_SCOPE.organization)
+];
+function renderMemoryPattern(pattern) {
+  return `- ${pattern.label}: \`system="${pattern.system}"\`, \`type="${pattern.type}"\`, \`segment="${pattern.segment}"\`, \`scope="${pattern.scope}"\``;
+}
+var MEMORY_COMMON_PATTERNS = [
+  "Common patterns:",
+  ...COMMON_MEMORY_PATTERNS.map(renderMemoryPattern)
+].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 \`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) {
+  return values.map((value) => `\`"${value}"\``).join(" | ");
+}
+function memoryTypeLines() {
+  return Object.entries(MEMORY_SYSTEM_TYPES).map(([system, types]) => `  - ${system}: ${quoteChoices(types)}`).join("\n");
+}
+function buildMemorySection() {
+  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 \`band_store_memory\`, the \`system\`, \`type\`, \`segment\`, and \`scope\` fields
+must use these exact values (case-sensitive):
+
+- **system**: ${quoteChoices(systems)}
+- **type** (must match the chosen system):
+${memoryTypeLines()}
+- **segment**: ${quoteChoices(segments)}
+- **scope**: ${quoteChoices(scopes)}`;
+  return [MEMORY_INTRO, fieldRules, MEMORY_COMMON_PATTERNS, MEMORY_SCOPE_GUIDANCE].join("\n\n");
+}
+var MEMORY_SECTION = buildMemorySection();
+
+// src/runtime/prompts/templates.ts
 var TEMPLATES = {
   default: `You are {agent_name}, {agent_description}.
 
@@ -5199,63 +5624,14 @@ ${customSection}`.trim();
   }
   const template = options?.template ?? "default";
   const templateString = TEMPLATES[template] ?? TEMPLATES.default;
-  return templateString.replaceAll("{agent_name}", agentName).replaceAll("{agent_description}", agentDescription).replaceAll("{custom_section}", customSection);
-}
-
-// 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;
+  const parts = [
+    templateString.replaceAll("{agent_name}", agentName).replaceAll("{agent_description}", agentDescription).replaceAll("{custom_section}", customSection)
+  ];
+  if (options?.capabilities?.memory) {
+    parts.push(MEMORY_SECTION);
   }
-  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 }));
-  }
-};
+  return parts.join("\n\n");
+}
 
 // src/runtime/shutdown.ts
 var DEFAULT_SHUTDOWN_TIMEOUT_MS = 3e4;
@@ -5335,11 +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,