@band-ai/sdk 0.1.6 → 0.2.0

package/dist/{chunk-GVEQ3RAH.js → chunk-RV76SKFT.js}

@@ -1,6 +1,6 @@
 import {
   ValidationError
-} from "./chunk-YR3BOQNW.js";
+} from "./chunk-JY75VSQK.js";
 
 // src/contracts/chatEvents.ts
 var CHAT_EVENT_TYPES = ["tool_call", "tool_result", "thought", "error", "task"];
@@ -16,9 +16,111 @@ function assertChatEventType(value) {
   }
 }
 
+// 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: {
@@ -34,7 +136,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: {
@@ -53,12 +155,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",
@@ -68,7 +170,7 @@ var TOOL_MODELS = {
     },
     required: ["name"]
   },
-  thenvoi_remove_participant: {
+  band_remove_participant: {
     description: "Remove a participant from the chat room by name.",
     properties: {
       name: {
@@ -78,12 +180,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: {
@@ -98,7 +200,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: {
@@ -108,7 +210,7 @@ var TOOL_MODELS = {
     },
     required: []
   },
-  thenvoi_list_contacts: {
+  band_list_contacts: {
     description: "List agent's contacts with pagination.",
     properties: {
       page: {
@@ -125,7 +227,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: {
@@ -139,7 +241,7 @@ var TOOL_MODELS = {
     },
     required: ["handle"]
   },
-  thenvoi_remove_contact: {
+  band_remove_contact: {
     description: "Remove an existing contact by handle or ID.",
     properties: {
       handle: {
@@ -153,7 +255,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: {
@@ -175,7 +277,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: {
@@ -194,7 +296,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: {
@@ -203,29 +305,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: {
@@ -240,13 +335,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: {
@@ -255,24 +350,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: {
@@ -281,7 +369,7 @@ var TOOL_MODELS = {
       },
       scope: {
         type: "string",
-        enum: ["subject", "organization"],
+        enum: [...MEMORY_STORE_SCOPES],
         description: "Visibility scope."
       },
       subject_id: {
@@ -295,7 +383,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: {
@@ -305,7 +393,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: {
@@ -315,7 +403,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: {
@@ -328,18 +416,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))
@@ -347,7 +435,10 @@ 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";
+var SEND_MESSAGE_TOOL_NAME = "band_send_message";
+var SEND_EVENT_TOOL_NAME = "band_send_event";
 function mcpToolNames(names) {
   return [...names].sort((a, b) => a.localeCompare(b)).map((name) => `${MCP_TOOL_PREFIX}${name}`);
 }
@@ -361,6 +452,27 @@ export {
   CHAT_MESSAGE_TYPES,
   isChatEventType,
   assertChatEventType,
+  MEMORY_SYSTEM_TYPES,
+  MEMORY_SYSTEMS,
+  MEMORY_TYPES,
+  MEMORY_SEGMENTS,
+  MEMORY_STORE_SCOPES,
+  MEMORY_LIST_SCOPES,
+  MEMORY_STATUSES,
+  MEMORY_SYSTEM,
+  MEMORY_TYPE,
+  MEMORY_SEGMENT,
+  MEMORY_STORE_SCOPE,
+  isMemorySystem,
+  isMemoryType,
+  isMemoryTypeForSystem,
+  isMemorySegment,
+  isMemoryStoreScope,
+  isMemoryListScope,
+  isMemoryStatus,
+  expectedList,
+  expectedMemoryTypesForSystem,
+  memoryTypeForSystemError,
   TOOL_MODELS,
   ALL_TOOL_NAMES,
   MEMORY_TOOL_NAMES,
@@ -368,6 +480,9 @@ export {
   BASE_TOOL_NAMES,
   CHAT_TOOL_NAMES,
   MCP_TOOL_PREFIX,
+  MCP_SERVER_NAME,
+  SEND_MESSAGE_TOOL_NAME,
+  SEND_EVENT_TOOL_NAME,
   mcpToolNames,
   getToolDescription
 };

package/dist/{chunk-W5NDZSYE.js → chunk-TLBCKDQO.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-AVVDPXP4.js";
 import {
   renderSystemPrompt
-} from "./chunk-SFVKOEQH.js";
+} from "./chunk-WLCM2OXG.js";
 import {
   asErrorMessage,
   asNonEmptyString,
@@ -15,7 +15,7 @@ import {
 import {
   UnsupportedFeatureError,
   ValidationError
-} from "./chunk-YR3BOQNW.js";
+} from "./chunk-JY75VSQK.js";
 
 // src/adapters/shared/history.ts
 function findLatestTaskMetadata(raw, predicate) {
@@ -1098,7 +1098,7 @@ function buildAgentCard(peer, gatewayUrl) {
         id: "default",
         name: peer.name,
         description: peer.description,
-        tags: ["thenvoi", "gateway"]
+        tags: ["band", "gateway"]
       }
     ],
     defaultInputModes: ["text/plain"],
@@ -1281,7 +1281,7 @@ var DEFAULT_RESPONSE_TIMEOUT_MS = 12e4;
 var DEFAULT_PEER_PAGE_SIZE = 100;
 var DEFAULT_MAX_PEER_PAGES = 25;
 var A2AGatewayAdapter = class extends SimpleAdapter {
-  thenvoiRest;
+  bandRest;
   gatewayUrl;
   host;
   port;
@@ -1302,7 +1302,7 @@ var A2AGatewayAdapter = class extends SimpleAdapter {
     super({
       historyConverter: new GatewayHistoryConverter()
     });
-    this.thenvoiRest = options.thenvoiRest;
+    this.bandRest = options.bandRest;
     this.gatewayUrl = options.gatewayUrl ?? DEFAULT_GATEWAY_URL;
     this.host = options.host ?? DEFAULT_HOST;
     this.port = options.port ?? DEFAULT_PORT;
@@ -1382,13 +1382,13 @@ var A2AGatewayAdapter = class extends SimpleAdapter {
   async refreshPeers() {
     this.peersBySlug.clear();
     this.peersById.clear();
-    if (!this.thenvoiRest.listPeers) {
+    if (!this.bandRest.listPeers) {
       throw new UnsupportedFeatureError(
         "Peer listing is not available in current REST adapter"
       );
     }
     for (let page = 1; page <= this.maxPeerPages; page += 1) {
-      const response = await this.thenvoiRest.listPeers({
+      const response = await this.bandRest.listPeers({
         page,
         pageSize: this.peerPageSize,
         notInChat: ""
@@ -1458,7 +1458,7 @@ var A2AGatewayAdapter = class extends SimpleAdapter {
     try {
       await this.emitContextEvent(roomId, contextId);
       const content = extractMessageText2(request.message) ?? "";
-      await this.thenvoiRest.createChatMessage(roomId, {
+      await this.bandRest.createChatMessage(roomId, {
         content: buildMentionedContent(peer.name, content),
         mentions: buildMentions(peer),
         metadata: {
@@ -1489,7 +1489,7 @@ var A2AGatewayAdapter = class extends SimpleAdapter {
           contextId: pending.contextId,
           state: "failed",
           final: true,
-          text: "Timed out waiting for a Thenvoi peer response."
+          text: "Timed out waiting for a Band peer response."
         });
         return;
       }
@@ -1576,7 +1576,7 @@ var A2AGatewayAdapter = class extends SimpleAdapter {
     if (existingRoom) {
       const participants = this.roomParticipants.get(existingRoom) ?? /* @__PURE__ */ new Set();
       if (!participants.has(targetPeerId)) {
-        await this.thenvoiRest.addChatParticipant(existingRoom, {
+        await this.bandRest.addChatParticipant(existingRoom, {
           participantId: targetPeerId,
           role: "member"
         });
@@ -1586,11 +1586,11 @@ var A2AGatewayAdapter = class extends SimpleAdapter {
       return [existingRoom, contextId];
     }
     const normalizedContextId = contextId && contextId.length > 0 ? contextId : randomUUID4();
-    const created = await this.thenvoiRest.createChat(
+    const created = await this.bandRest.createChat(
       `a2a:gateway:${normalizedContextId}`
     );
     const roomId = created.id;
-    await this.thenvoiRest.addChatParticipant(roomId, {
+    await this.bandRest.addChatParticipant(roomId, {
       participantId: targetPeerId,
       role: "member"
     });
@@ -1599,7 +1599,7 @@ var A2AGatewayAdapter = class extends SimpleAdapter {
     return [roomId, normalizedContextId];
   }
   async emitContextEvent(roomId, contextId) {
-    await this.thenvoiRest.createChatEvent(roomId, {
+    await this.bandRest.createChatEvent(roomId, {
       content: "A2A gateway context",
       messageType: "task",
       metadata: {
@@ -1777,10 +1777,10 @@ function toStatusUpdateEvent(message, taskId, contextId) {
     final,
     text: message.content,
     metadata: {
-      thenvoi_message_id: message.id,
-      thenvoi_message_type: message.messageType,
-      thenvoi_sender_id: message.senderId,
-      thenvoi_room_id: message.roomId
+      band_message_id: message.id,
+      band_message_type: message.messageType,
+      band_sender_id: message.senderId,
+      band_room_id: message.roomId
     }
   });
 }
@@ -1994,8 +1994,8 @@ var ParlantAdapter = class extends SimpleAdapter {
           message: userMessage,
           moderation: "none",
           metadata: {
-            thenvoi_source: "thenvoi-sdk-typescript",
-            thenvoi_room_id: context.roomId
+            band_source: "band-sdk-typescript",
+            band_room_id: context.roomId
           }
         },
         this.requestOptions()
@@ -2070,9 +2070,9 @@ var ParlantAdapter = class extends SimpleAdapter {
         {
           agentId: this.agentId,
           customerId,
-          title: `Thenvoi Room ${roomId.slice(0, 8)}`,
+          title: `Band Room ${roomId.slice(0, 8)}`,
           metadata: {
-            thenvoi_room_id: roomId
+            band_room_id: roomId
           }
         },
         this.requestOptions()
@@ -2085,7 +2085,7 @@ var ParlantAdapter = class extends SimpleAdapter {
             source: "system",
             message: this.systemPrompt,
             metadata: {
-              thenvoi_system_prompt: true
+              band_system_prompt: true
             }
           },
           this.requestOptions()
@@ -2139,7 +2139,7 @@ var ParlantAdapter = class extends SimpleAdapter {
       {
         name: customerName,
         metadata: {
-          thenvoi_room_id: roomId
+          band_room_id: roomId
         }
       },
       this.requestOptions()