@band-ai/sdk 0.1.4 → 0.1.10

package/dist/adapters.cjs

@@ -30,32 +30,81 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/contracts/protocols.ts
-function isToolExecutorError(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const candidate = value;
-  return candidate.ok === false && typeof candidate.errorType === "string" && TOOL_EXECUTOR_ERROR_TYPES.includes(candidate.errorType) && typeof candidate.toolName === "string" && typeof candidate.message === "string" && typeof candidate.legacyMessage === "string";
+// src/contracts/memory.ts
+function namedValues(values) {
+  return Object.fromEntries(values.map((value) => [value, value]));
 }
-function toLegacyToolExecutorErrorMessage(value) {
-  if (typeof value === "string") {
-    return value;
-  }
-  if (!isToolExecutorError(value)) {
-    return null;
-  }
-  return value.legacyMessage;
-}
-var TOOL_EXECUTOR_ERROR_TYPES;
-var init_protocols = __esm({
-  "src/contracts/protocols.ts"() {
+var SENSORY_MEMORY_TYPES, COGNITIVE_MEMORY_TYPES, 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;
+var init_memory = __esm({
+  "src/contracts/memory.ts"() {
     "use strict";
-    TOOL_EXECUTOR_ERROR_TYPES = [
-      "ToolArgumentsValidationError",
-      "ToolNotFoundError",
-      "ToolExecutionError"
+    SENSORY_MEMORY_TYPES = [
+      "iconic",
+      // Visual input
+      "echoic",
+      // Auditory input
+      "haptic"
+      // Tactile input
     ];
+    COGNITIVE_MEMORY_TYPES = [
+      "episodic",
+      // Events that occurred
+      "semantic",
+      // Facts, preferences, learned knowledge
+      "procedural"
+      // How to perform tasks
+    ];
+    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
+    };
+    MEMORY_SYSTEMS = Object.keys(MEMORY_SYSTEM_TYPES);
+    MEMORY_TYPES = [
+      ...SENSORY_MEMORY_TYPES,
+      ...COGNITIVE_MEMORY_TYPES
+    ];
+    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
+    ];
+    MEMORY_STORE_SCOPES = [
+      "subject",
+      // About one person/agent; requires subject_id
+      "organization"
+      // Shared org-wide
+    ];
+    MEMORY_LIST_SCOPES = [
+      "subject",
+      // Subject-scoped memories only
+      "organization",
+      // Organization-scoped memories only
+      "all"
+      // Both scopes (no scope filter)
+    ];
+    MEMORY_STATUSES = [
+      "active",
+      // Normal, visible memories
+      "superseded",
+      // Outdated; soft-deleted via thenvoi_supersede_memory
+      "archived",
+      // Hidden but preserved via thenvoi_archive_memory
+      "all"
+      // Any status (no filter)
+    ];
+    MEMORY_SYSTEM = namedValues(MEMORY_SYSTEMS);
+    MEMORY_TYPE = namedValues(MEMORY_TYPES);
+    MEMORY_SEGMENT = namedValues(MEMORY_SEGMENTS);
+    MEMORY_STORE_SCOPE = namedValues(MEMORY_STORE_SCOPES);
   }
 });
 
@@ -115,6 +164,7 @@ var init_schemas = __esm({
   "src/runtime/tools/schemas.ts"() {
     "use strict";
     init_chatEvents();
+    init_memory();
     TOOL_MODELS = {
       thenvoi_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.",
@@ -301,29 +351,22 @@ var init_schemas = __esm({
           },
           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: {
@@ -338,7 +381,7 @@ var init_schemas = __esm({
           },
           status: {
             type: "string",
-            enum: ["active", "superseded", "archived", "all"],
+            enum: [...MEMORY_STATUSES],
             description: "Filter by status."
           }
         },
@@ -353,24 +396,17 @@ var init_schemas = __esm({
           },
           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: {
@@ -379,7 +415,7 @@ var init_schemas = __esm({
           },
           scope: {
             type: "string",
-            enum: ["subject", "organization"],
+            enum: [...MEMORY_STORE_SCOPES],
             description: "Visibility scope."
           },
           subject_id: {
@@ -449,6 +485,35 @@ var init_schemas = __esm({
   }
 });
 
+// src/contracts/protocols.ts
+function isToolExecutorError(value) {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const candidate = value;
+  return candidate.ok === false && typeof candidate.errorType === "string" && TOOL_EXECUTOR_ERROR_TYPES.includes(candidate.errorType) && typeof candidate.toolName === "string" && typeof candidate.message === "string" && typeof candidate.legacyMessage === "string";
+}
+function toLegacyToolExecutorErrorMessage(value) {
+  if (typeof value === "string") {
+    return value;
+  }
+  if (!isToolExecutorError(value)) {
+    return null;
+  }
+  return value.legacyMessage;
+}
+var TOOL_EXECUTOR_ERROR_TYPES;
+var init_protocols = __esm({
+  "src/contracts/protocols.ts"() {
+    "use strict";
+    TOOL_EXECUTOR_ERROR_TYPES = [
+      "ToolArgumentsValidationError",
+      "ToolNotFoundError",
+      "ToolExecutionError"
+    ];
+  }
+});
+
 // src/mcp/registrations.ts
 function buildRoomScopedRegistrations(resolver, options = {}) {
   const toolNames = resolveToolNames(options);
@@ -567,6 +632,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;
+}
 var init_registrations = __esm({
   "src/mcp/registrations.ts"() {
     "use strict";
@@ -625,16 +697,16 @@ __export(sdk_exports, {
   createThenvoiSdkMcpServer: () => createThenvoiSdkMcpServer
 });
 function createThenvoiSdkMcpServer(options) {
-  const registrations = buildRoomScopedRegistrations(
-    options.getToolsForRoom,
-    {
-      enableMemoryTools: options.enableMemoryTools,
-      enableContactTools: true,
-      additionalTools: options.additionalTools
-    }
-  );
+  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",
     tools: toolDefinitions
@@ -642,9 +714,205 @@ function createThenvoiSdkMcpServer(options) {
   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_zod5.z,
@@ -795,16 +1063,15 @@ var ACPClientHistoryConverter = class {
   }
 };
 
-// src/runtime/prompts.ts
-var BASE_INSTRUCTIONS = `
+// 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
+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:
@@ -830,14 +1097,12 @@ 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!
-
-## IMPORTANT: Always Share Your Thinking
+3. Do NOT just thank the helper agent - the requester is waiting for their answer!`;
+var THINKING_SECTION = `## IMPORTANT: Always Share Your Thinking
 
 You MUST call \`thenvoi_send_event(content, message_type="thought")\` BEFORE every action.
-This is required so users can see your reasoning process.
-
-## Examples
+This is required so users can see your reasoning process.`;
+var EXAMPLES_SECTION = `## Examples
 
 ### Simple question - answer directly
 [John Doe]: What's 2+2?
@@ -870,8 +1135,75 @@ This is required so users can see your reasoning process.
 
 [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"])
-`;
+-> thenvoi_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
+init_memory();
+init_schemas();
+var MEMORY_INTRO = `## Memory Tools
+
+You have access to memory tools for storing and retrieving information
+across conversations. Use \`thenvoi_store_memory\` to persist important
+information and \`thenvoi_list_memories\` / \`thenvoi_get_memory\` to recall it.
+Use \`thenvoi_supersede_memory\` to mark outdated memories and
+\`thenvoi_archive_memory\` to hide memories that should be preserved.`;
+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 \`thenvoi_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.thenvoi_store_memory.properties;
+  const systems = storeMemoryProps.system.enum;
+  const segments = storeMemoryProps.segment.enum;
+  const scopes = storeMemoryProps.scope.enum;
+  const fieldRules = `When calling \`thenvoi_store_memory\`, the \`system\`, \`type\`, \`segment\`, and \`scope\` fields
+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}.
 
@@ -890,7 +1222,13 @@ ${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);
+  const parts = [
+    templateString.replaceAll("{agent_name}", agentName).replaceAll("{agent_description}", agentDescription).replaceAll("{custom_section}", customSection)
+  ];
+  if (options?.capabilities?.memory) {
+    parts.push(MEMORY_SECTION);
+  }
+  return parts.join("\n\n");
 }
 
 // src/mcp/server.ts
@@ -2971,7 +3309,7 @@ function replaceUuidMentions(content, participants) {
     const participantId = participant.id;
     const handle = participant.handle;
     if (typeof participantId === "string" && typeof handle === "string") {
-      next = next.replaceAll(`@[[${participantId}]]`, `@${handle}`);
+      next = next.replaceAll(`@[[${participantId}]]`, ensureHandlePrefix(handle) ?? "");
     }
   }
   return next;
@@ -4390,7 +4728,8 @@ var GoogleADKAdapter = class extends SimpleAdapter {
     this.systemPrompt = this.systemPromptOverride ?? renderSystemPrompt({
       agentName,
       agentDescription,
-      customSection: this.customSection
+      customSection: this.customSection,
+      capabilities: { memory: this.enableMemoryTools }
     });
   }
   async onMessage(message, tools, history, participantsMessage, contactsMessage, context) {
@@ -4630,7 +4969,8 @@ var LangGraphAdapter = class extends SimpleAdapter {
     this.renderedSystemPrompt = this.systemPromptOverride ?? renderSystemPrompt({
       agentName,
       agentDescription,
-      customSection: this.customSection
+      customSection: this.customSection,
+      capabilities: { memory: this.includeMemoryTools }
     });
   }
   async onMessage(message, tools, history, participantsMessage, contactsMessage, context) {
@@ -4649,14 +4989,17 @@ var LangGraphAdapter = class extends SimpleAdapter {
       ];
     }
     const graph = await this.resolveGraph(sdk, langGraphTools);
-    const messages = this.buildMessages(
-      history,
-      message,
-      participantsMessage,
-      contactsMessage,
-      context.isSessionBootstrap,
-      context.roomId
-    );
+    const usesCheckpointer = Boolean(this.checkpointer);
+    const isFirstBootstrap = context.isSessionBootstrap && !this.bootstrappedRooms.has(context.roomId);
+    const replayHistory = !usesCheckpointer || isFirstBootstrap;
+    const includeSystemPrompt = this.usesCustomGraph && (!usesCheckpointer || isFirstBootstrap);
+    if (context.isSessionBootstrap) {
+      this.bootstrappedRooms.add(context.roomId);
+    }
+    const messages = this.buildMessages(history, message, participantsMessage, contactsMessage, {
+      replayHistory,
+      includeSystemPrompt
+    });
     const input = { messages };
     const graphConfig = {
       configurable: {
@@ -4683,6 +5026,10 @@ var LangGraphAdapter = class extends SimpleAdapter {
   async onCleanup(roomId) {
     this.bootstrappedRooms.delete(roomId);
   }
+  /** A caller-supplied graph rather than the built-in createReactAgent. */
+  get usesCustomGraph() {
+    return Boolean(this.graph || this.graphFactory);
+  }
   resolveGraph(sdk, langGraphTools) {
     if (this.graphFactory) {
       return Promise.resolve(this.graphFactory(langGraphTools));
@@ -4703,14 +5050,13 @@ var LangGraphAdapter = class extends SimpleAdapter {
       prompt: this.renderedSystemPrompt
     }));
   }
-  buildMessages(history, message, participantsMessage, contactsMessage, isSessionBootstrap, roomId) {
+  buildMessages(history, message, participantsMessage, contactsMessage, options) {
     const messages = [];
-    if (isSessionBootstrap && !this.bootstrappedRooms.has(roomId)) {
+    if (options.includeSystemPrompt) {
       messages.push(["system", this.renderedSystemPrompt]);
-      this.bootstrappedRooms.add(roomId);
     }
-    if (isSessionBootstrap && history.length > 0) {
-      const historical = history.raw.slice(-this.maxHistoryMessages);
+    if (options.replayHistory && history.length > 0) {
+      const historical = history.raw.filter((item) => item.id !== message.id).slice(-this.maxHistoryMessages);
       for (const item of historical) {
         const role = String(item.sender_type ?? "") === "Agent" ? "assistant" : "user";
         const content = String(item.content ?? "");
@@ -4729,7 +5075,7 @@ var LangGraphAdapter = class extends SimpleAdapter {
     return messages;
   }
   async forwardStreamEvents(graph, input, config, tools) {
-    const stream = graph.streamEvents?.(input, config, { version: "v2" });
+    const stream = graph.streamEvents?.(input, { ...config, version: "v2" });
     if (!stream) {
       return null;
     }
@@ -4756,6 +5102,10 @@ var LangGraphAdapter = class extends SimpleAdapter {
         );
       }
       if (eventType === "on_chain_end") {
+        const chainName = String(data.name ?? "");
+        if (!this.usesCustomGraph && chainName !== "LangGraph" && chainName !== "agent") {
+          continue;
+        }
         const output = asOptionalRecord(data.data) ?? {};
         const text = extractAssistantText(output.output);
         if (text) {
@@ -4817,18 +5167,25 @@ function stringifyToolResult2(value, logger, toolName) {
   });
 }
 function extractAssistantText(result) {
-  if (typeof result === "string" && result.trim().length > 0) {
-    return result.trim();
+  if (typeof result === "string") {
+    const trimmed = result.trim();
+    return trimmed.length > 0 && !isInternalLangGraphMarker(trimmed) ? trimmed : null;
   }
   const record = asOptionalRecord(result) ?? {};
+  if (isLangChainAssistantMessage(record)) {
+    const text = asLangChainMessageContent(record);
+    if (text && !isInternalLangGraphMarker(text)) {
+      return text;
+    }
+  }
   const directContent = asMessageContent(record.content);
-  if (directContent) {
+  if (directContent && !isInternalLangGraphMarker(directContent)) {
     return directContent;
   }
   const messages = Array.isArray(record.messages) ? record.messages : [];
   for (let index = messages.length - 1; index >= 0; index -= 1) {
     const text = asMessageText(messages[index]);
-    if (text) {
+    if (text && !isInternalLangGraphMarker(text)) {
       return text;
     }
   }
@@ -4845,12 +5202,40 @@ function asMessageText(value) {
   if (!record) {
     return null;
   }
+  if (isLangChainAssistantMessage(record)) {
+    return asLangChainMessageContent(record);
+  }
   const role = String(record.role ?? "");
   if (role !== "assistant") {
     return null;
   }
   return asMessageContent(record.content);
 }
+function isLangChainAssistantMessage(record) {
+  const id = record.id;
+  if (Array.isArray(id)) {
+    const typeName = String(id[id.length - 1] ?? "");
+    if (typeName === "AIMessage" || typeName === "AIMessageChunk") {
+      return true;
+    }
+  }
+  const getType = record.getType;
+  if (typeof getType === "function") {
+    try {
+      return getType.call(record) === "ai";
+    } catch {
+      return false;
+    }
+  }
+  return false;
+}
+function asLangChainMessageContent(record) {
+  const kwargs = asOptionalRecord(record.kwargs);
+  return asMessageContent(kwargs?.content ?? record.content);
+}
+function isInternalLangGraphMarker(text) {
+  return text === "__end__" || text === "__start__";
+}
 function asMessageContent(value) {
   if (typeof value === "string" && value.trim().length > 0) {
     return value.trim();
@@ -7804,20 +8189,17 @@ function registerTools3(mcpServer, z4, registrations) {
 
 // src/mcp/backends.ts
 async function createThenvoiMcpBackend(options) {
-  const registrations = buildRoomScopedRegistrations(
-    options.getToolsForRoom,
-    {
-      enableMemoryTools: options.enableMemoryTools,
-      enableContactTools: true,
-      additionalTools: options.additionalTools
-    }
-  );
-  const allowedTools = mcpToolNames(new Set(registrations.map((registration) => registration.name)));
+  const registrationOptions = {
+    enableMemoryTools: options.enableMemoryTools,
+    enableContactTools: true,
+    additionalTools: options.additionalTools
+  };
   if (options.kind === "sdk") {
     const { createThenvoiSdkMcpServer: createThenvoiSdkMcpServer2 } = await Promise.resolve().then(() => (init_sdk(), sdk_exports));
     const server2 = createThenvoiSdkMcpServer2({
-      enableMemoryTools: options.enableMemoryTools,
       getToolsForRoom: options.getToolsForRoom,
+      multiRoom: options.multiRoom,
+      enableMemoryTools: options.enableMemoryTools,
       additionalTools: options.additionalTools
     });
     return {
@@ -7827,9 +8209,12 @@ async function createThenvoiMcpBackend(options) {
       stop: async () => void 0
     };
   }
+  const resolvedTools = options.multiRoom === false ? resolveSingleRoomTools(options.getToolsForRoom) : options.getToolsForRoom;
+  const registrations = options.multiRoom === false ? buildSingleContextRegistrations(resolvedTools, registrationOptions) : buildRoomScopedRegistrations(resolvedTools, registrationOptions);
+  const allowedTools = mcpToolNames(new Set(registrations.map((registration) => registration.name)));
   if (options.kind === "stdio") {
     const server2 = new ThenvoiMcpStdioServer({
-      tools: options.getToolsForRoom,
+      tools: resolvedTools,
       enableMemoryTools: options.enableMemoryTools,
       enableContactTools: true,
       additionalTools: options.additionalTools
@@ -7846,7 +8231,7 @@ async function createThenvoiMcpBackend(options) {
   }
   if (options.kind === "sse") {
     const server2 = new ThenvoiMcpSseServer({
-      tools: options.getToolsForRoom,
+      tools: resolvedTools,
       enableMemoryTools: options.enableMemoryTools,
       enableContactTools: true,
       additionalTools: options.additionalTools
@@ -7862,7 +8247,7 @@ async function createThenvoiMcpBackend(options) {
     };
   }
   const server = new ThenvoiMcpServer({
-    tools: options.getToolsForRoom,
+    tools: resolvedTools,
     enableMemoryTools: options.enableMemoryTools,
     enableContactTools: true,
     additionalTools: options.additionalTools
@@ -8302,7 +8687,8 @@ var OpencodeAdapter = class extends SimpleAdapter {
       agentName,
       agentDescription,
       customSection: this.config.customSection,
-      includeBaseInstructions: this.config.includeBaseInstructions
+      includeBaseInstructions: this.config.includeBaseInstructions,
+      capabilities: { memory: this.config.enableMemoryTools }
     }).trim();
     this.systemPrompt = `${systemPrompt}
 
@@ -9169,7 +9555,8 @@ var ClaudeSDKAdapter = class extends SimpleAdapter {
       agentName,
       agentDescription,
       customSection: this.customSection,
-      includeBaseInstructions: this.includeBaseInstructions
+      includeBaseInstructions: this.includeBaseInstructions,
+      capabilities: { memory: this.enableMemoryTools }
     });
     if (this.enableMcpTools) {
       const createThenvoiMcpBridge = await thenvoiMcpBridgeFactory.get();
@@ -9889,7 +10276,8 @@ var CodexAdapter = class extends SimpleAdapter {
       agentName: this.agentName,
       agentDescription: this.agentDescription,
       customSection,
-      includeBaseInstructions: this.baseConfig.includeBaseInstructions ?? true
+      includeBaseInstructions: this.baseConfig.includeBaseInstructions ?? true,
+      capabilities: { memory: this.includeMemoryTools }
     }).trim();
     this.systemPrompt = prompt.length > 0 ? prompt : null;
   }