@band-ai/sdk 0.1.6 → 0.2.0

package/dist/mcp-claude.cjs

@@ -20,7 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/mcp/sdk.ts
 var sdk_exports = {};
 __export(sdk_exports, {
-  createThenvoiSdkMcpServer: () => createThenvoiSdkMcpServer
+  createBandSdkMcpServer: () => createBandSdkMcpServer
 });
 module.exports = __toCommonJS(sdk_exports);
 var import_claude_agent_sdk = require("@anthropic-ai/claude-agent-sdk");
@@ -30,9 +30,81 @@ var import_zod = require("zod");
 var CHAT_EVENT_TYPES = ["tool_call", "tool_result", "thought", "error", "task"];
 var CHAT_MESSAGE_TYPES = ["text", ...CHAT_EVENT_TYPES];
 
+// 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);
+
 // 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: {
@@ -48,7 +120,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: {
@@ -67,12 +139,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",
@@ -82,7 +154,7 @@ var TOOL_MODELS = {
     },
     required: ["name"]
   },
-  thenvoi_remove_participant: {
+  band_remove_participant: {
     description: "Remove a participant from the chat room by name.",
     properties: {
       name: {
@@ -92,12 +164,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: {
@@ -112,7 +184,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: {
@@ -122,7 +194,7 @@ var TOOL_MODELS = {
     },
     required: []
   },
-  thenvoi_list_contacts: {
+  band_list_contacts: {
     description: "List agent's contacts with pagination.",
     properties: {
       page: {
@@ -139,7 +211,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: {
@@ -153,7 +225,7 @@ var TOOL_MODELS = {
     },
     required: ["handle"]
   },
-  thenvoi_remove_contact: {
+  band_remove_contact: {
     description: "Remove an existing contact by handle or ID.",
     properties: {
       handle: {
@@ -167,7 +239,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: {
@@ -189,7 +261,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: {
@@ -208,7 +280,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: {
@@ -217,29 +289,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: {
@@ -254,13 +319,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: {
@@ -269,24 +334,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: {
@@ -295,7 +353,7 @@ var TOOL_MODELS = {
       },
       scope: {
         type: "string",
-        enum: ["subject", "organization"],
+        enum: [...MEMORY_STORE_SCOPES],
         description: "Visibility scope."
       },
       subject_id: {
@@ -309,7 +367,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: {
@@ -319,7 +377,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: {
@@ -329,7 +387,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: {
@@ -342,18 +400,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))
@@ -361,7 +419,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}`);
 }
@@ -414,6 +473,16 @@ function buildRoomScopedRegistrations(resolver, options = {}) {
   }
   return registrations;
 }
+function buildSingleContextRegistrations(tools, options = {}) {
+  const toolNames = resolveToolNames(options);
+  const registrations = buildRegistrations(toolNames, (_toolName, args) => {
+    return executeToolCall(tools, _toolName, args);
+  }, { injectRoomId: false });
+  if (options.additionalTools) {
+    registrations.push(...options.additionalTools);
+  }
+  return registrations;
+}
 function resolveToolNames(options) {
   const names = /* @__PURE__ */ new Set();
   for (const name of BASE_TOOL_NAMES) {
@@ -501,6 +570,13 @@ function serializeValue(value) {
     return String(value);
   }
 }
+function resolveSingleRoomTools(getToolsForRoom) {
+  const tools = getToolsForRoom("");
+  if (!tools) {
+    throw new Error('Single-room mode requires getToolsForRoom("") to return a tools instance');
+  }
+  return tools;
+}
 
 // src/mcp/zod.ts
 function buildZodShape(z2, properties, required) {
@@ -542,27 +618,223 @@ function jsonSchemaToZod(z2, schema) {
 }
 
 // src/mcp/sdk.ts
-function createThenvoiSdkMcpServer(options) {
-  const registrations = buildRoomScopedRegistrations(
-    options.getToolsForRoom,
-    {
-      enableMemoryTools: options.enableMemoryTools,
-      enableContactTools: true,
-      additionalTools: options.additionalTools
-    }
-  );
+function createBandSdkMcpServer(options) {
+  const registrationOptions = {
+    enableMemoryTools: options.enableMemoryTools,
+    enableContactTools: true,
+    additionalTools: options.additionalTools
+  };
+  const registrations = options.multiRoom === false ? buildSingleContextRegistrations(resolveSingleRoomTools(options.getToolsForRoom), registrationOptions) : buildRoomScopedRegistrations(options.getToolsForRoom, registrationOptions);
   const toolDefinitions = registrations.map(toSdkToolDefinition);
   const toolNames = new Set(registrations.map((r) => r.name));
+  const contextCache = /* @__PURE__ */ new Map();
+  const MAX_CONTEXT_CACHE_ENTRIES = 100;
   const serverConfig = (0, import_claude_agent_sdk.createSdkMcpServer)({
-    name: "thenvoi",
+    name: MCP_SERVER_NAME,
     tools: toolDefinitions
   });
   return {
     serverConfig,
     allowedTools: mcpToolNames(toolNames),
-    toolDefinitions
+    toolDefinitions,
+    getSystemPromptContext: async (roomId, contextOptions) => {
+      const context = await getOrBuildSystemPromptContext(
+        roomId,
+        contextOptions,
+        options.getToolsForRoom,
+        contextCache,
+        MAX_CONTEXT_CACHE_ENTRIES
+      );
+      return context.markdown;
+    },
+    getSystemPromptContextData: (roomId, contextOptions) => {
+      return getOrBuildSystemPromptContext(
+        roomId,
+        contextOptions,
+        options.getToolsForRoom,
+        contextCache,
+        MAX_CONTEXT_CACHE_ENTRIES
+      );
+    }
+  };
+}
+async function getOrBuildSystemPromptContext(roomId, contextOptions, getToolsForRoom, contextCache, maxEntries) {
+  const ttlMs = contextOptions?.ttlMs ?? 3e4;
+  const now = Date.now();
+  const cached = contextCache.get(roomId);
+  if (cached && cached.expiresAt > now) {
+    cached.lastAccessedAt = now;
+    return cached.value;
+  }
+  if (cached) {
+    contextCache.delete(roomId);
+  }
+  const tools = getToolsForRoom(roomId);
+  if (!tools) {
+    return buildUnavailableSystemPromptContext(roomId);
+  }
+  const context = await buildSystemPromptContext(roomId, tools);
+  contextCache.set(roomId, {
+    value: context,
+    expiresAt: now + ttlMs,
+    lastAccessedAt: now
+  });
+  evictLeastRecentlyUsedContext(contextCache, maxEntries);
+  return context;
+}
+async function buildSystemPromptContext(roomId, tools) {
+  const participants = await tools.getParticipants();
+  const warnings = [];
+  const agentResolution = await resolveAgentIdentity(tools);
+  if (agentResolution.warning) {
+    warnings.push(agentResolution.warning);
+  }
+  const roomResolution = await resolveRoomTitle(tools, roomId);
+  if (roomResolution.warning) {
+    warnings.push(roomResolution.warning);
+  }
+  const agentIdentity = agentResolution.value;
+  const roomTitle = roomResolution.value;
+  const normalizedParticipants = participants.map((participant) => ({
+    id: String(participant.id),
+    name: String(participant.name ?? "Unknown"),
+    type: String(participant.type ?? "Unknown"),
+    handle: normalizeHandle(participant.handle),
+    isSelf: participant.id === agentIdentity?.id
+  }));
+  const selfHandle = normalizeHandle(agentIdentity?.handle);
+  const selfName = agentIdentity?.name ?? "Agent";
+  const mentionHandles = normalizedParticipants.filter((participant) => !participant.isSelf).map((participant) => participant.handle).filter((handle) => Boolean(handle));
+  const mentionFormat = mentionHandles.length > 0 ? mentionHandles.join(", ") : "No participant handles available";
+  const roomLabel = roomTitle ? `"${roomTitle}"` : "this room";
+  const agentLabel = selfHandle ? `${selfName} (${selfHandle})` : selfName;
+  const participantLines = normalizedParticipants.length > 0 ? normalizedParticipants.map((participant) => {
+    const suffix = participant.isSelf ? " (you)" : "";
+    const handle = participant.handle ? ` (${participant.handle})` : "";
+    return `- **${participant.name}**${handle} -- ${participant.type}${suffix}`;
+  }).join("\n") : "- No participants found";
+  const markdown = [
+    "## Room Context",
+    "",
+    `You are **${agentLabel}** in room ${roomLabel} (id: ${roomId}).`,
+    "",
+    "### Participants",
+    participantLines,
+    "",
+    "### Mention Format",
+    `To address someone, use their exact handle: ${mentionFormat}`,
+    ...warnings.length > 0 ? ["", "### Warnings", ...warnings.map((warning) => `- ${warning}`)] : []
+  ].join("\n");
+  return {
+    roomId,
+    roomTitle,
+    agent: {
+      id: agentIdentity?.id ?? "unknown-agent",
+      name: selfName,
+      handle: selfHandle,
+      description: agentIdentity?.description ?? null
+    },
+    participants: normalizedParticipants,
+    mentionFormat,
+    warnings,
+    markdown
   };
 }
+async function resolveAgentIdentity(tools) {
+  const maybeTools = tools;
+  try {
+    if (maybeTools.getAgentIdentity) {
+      return { value: await maybeTools.getAgentIdentity(), warning: null };
+    }
+    if (maybeTools.rest?.getAgentMe) {
+      return { value: await maybeTools.rest.getAgentMe(), warning: null };
+    }
+  } catch (error) {
+    return {
+      value: null,
+      warning: `Unable to resolve agent identity: ${error instanceof Error ? error.message : String(error)}`
+    };
+  }
+  return { value: null, warning: null };
+}
+async function resolveRoomTitle(tools, roomId) {
+  const maybeTools = tools;
+  const rest = maybeTools.rest;
+  if (!rest?.listChats) {
+    return { value: null, warning: null };
+  }
+  try {
+    let page = 1;
+    const pageSize = 100;
+    while (true) {
+      const response = await rest.listChats({ page, pageSize });
+      const room = response?.data?.find((entry) => entry.id === roomId);
+      if (typeof room?.title === "string" && room.title.length > 0) {
+        return { value: room.title, warning: null };
+      }
+      const totalPages = response?.metadata?.totalPages ?? page;
+      if (page >= totalPages) {
+        return { value: null, warning: null };
+      }
+      page += 1;
+    }
+  } catch (error) {
+    return {
+      value: null,
+      warning: `Unable to resolve room title: ${error instanceof Error ? error.message : String(error)}`
+    };
+  }
+}
+function buildUnavailableSystemPromptContext(roomId) {
+  const warnings = [`No tool context found for room_id ${roomId}`];
+  const markdown = [
+    "## Room Context",
+    "",
+    `You are **Agent** in this room (id: ${roomId}).`,
+    "",
+    "### Participants",
+    "- No participants found",
+    "",
+    "### Mention Format",
+    "No participant handles available",
+    "",
+    "### Warnings",
+    ...warnings.map((warning) => `- ${warning}`)
+  ].join("\n");
+  return {
+    roomId,
+    roomTitle: null,
+    agent: {
+      id: "unknown-agent",
+      name: "Agent",
+      handle: null,
+      description: null
+    },
+    participants: [],
+    mentionFormat: "No participant handles available",
+    warnings,
+    markdown
+  };
+}
+function evictLeastRecentlyUsedContext(contextCache, maxEntries) {
+  if (contextCache.size <= maxEntries) {
+    return;
+  }
+  let oldestKey = null;
+  let oldestAccessedAt = Number.POSITIVE_INFINITY;
+  for (const [key, entry] of contextCache.entries()) {
+    if (entry.lastAccessedAt < oldestAccessedAt) {
+      oldestAccessedAt = entry.lastAccessedAt;
+      oldestKey = key;
+    }
+  }
+  if (oldestKey) {
+    contextCache.delete(oldestKey);
+  }
+}
+function normalizeHandle(handle) {
+  return typeof handle === "string" && handle.trim().length > 0 ? handle.trim() : null;
+}
 function toSdkToolDefinition(registration) {
   const shape = buildZodShape(
     import_zod.z,
@@ -578,5 +850,5 @@ function toSdkToolDefinition(registration) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  createThenvoiSdkMcpServer
+  createBandSdkMcpServer
 });

package/dist/mcp-claude.d.cts

@@ -1,4 +1,4 @@
 import '@anthropic-ai/claude-agent-sdk';
-import './protocols-CInhtFpA.cjs';
-export { C as CreateThenvoiSdkMcpServerOptions, T as ThenvoiSdkMcpServer, f as createThenvoiSdkMcpServer } from './sdk-CwTAxhwI.cjs';
-import './dtos-DUpbIu8k.cjs';
+import './protocols-Bz1rxcUg.cjs';
+export { B as BandSdkMcpServer, C as CreateBandSdkMcpServerOptions, G as GetSystemPromptContextOptions, g as GetSystemPromptContextResult, h as createBandSdkMcpServer } from './sdk-BTciSLRQ.cjs';
+import './dtos-B8KU_q4d.cjs';

package/dist/mcp-claude.d.ts

@@ -1,4 +1,4 @@
 import '@anthropic-ai/claude-agent-sdk';
-import './protocols-DrhzOH6K.js';
-export { C as CreateThenvoiSdkMcpServerOptions, T as ThenvoiSdkMcpServer, f as createThenvoiSdkMcpServer } from './sdk-CcnQ5OUC.js';
-import './dtos-DUpbIu8k.js';
+import './protocols-Bwwcql0h.js';
+export { B as BandSdkMcpServer, C as CreateBandSdkMcpServerOptions, G as GetSystemPromptContextOptions, g as GetSystemPromptContextResult, h as createBandSdkMcpServer } from './sdk-qKJtMma_.js';
+import './dtos-B8KU_q4d.js';