@band-ai/sdk 0.1.4 → 0.1.10

package/dist/mcp-claude.cjs

@@ -30,6 +30,78 @@ 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 thenvoi_supersede_memory
+  "archived",
+  // Hidden but preserved via thenvoi_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: {
@@ -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,7 +319,7 @@ var TOOL_MODELS = {
       },
       status: {
         type: "string",
-        enum: ["active", "superseded", "archived", "all"],
+        enum: [...MEMORY_STATUSES],
         description: "Filter by status."
       }
     },
@@ -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: {
@@ -414,6 +472,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 +569,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) {
@@ -543,16 +618,16 @@ function jsonSchemaToZod(z2, schema) {
 
 // src/mcp/sdk.ts
 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
@@ -560,9 +635,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_zod.z,

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-D2bTrQ_t.cjs';
+export { C as CreateThenvoiSdkMcpServerOptions, G as GetSystemPromptContextOptions, f as GetSystemPromptContextResult, T as ThenvoiSdkMcpServer, g as createThenvoiSdkMcpServer } from './sdk-D2rTDU_o.cjs';
+import './dtos-Dd_fTfLn.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-BF6jamIl.js';
+export { C as CreateThenvoiSdkMcpServerOptions, G as GetSystemPromptContextOptions, f as GetSystemPromptContextResult, T as ThenvoiSdkMcpServer, g as createThenvoiSdkMcpServer } from './sdk-CyqN1W5g.js';
+import './dtos-Dd_fTfLn.js';

package/dist/mcp-claude.js

@@ -1,10 +1,12 @@
 import {
   buildRoomScopedRegistrations,
-  buildZodShape
-} from "./chunk-EDPKUUJL.js";
+  buildSingleContextRegistrations,
+  buildZodShape,
+  resolveSingleRoomTools
+} from "./chunk-6RXWL6TC.js";
 import {
   mcpToolNames
-} from "./chunk-GVEQ3RAH.js";
+} from "./chunk-MLROFDKR.js";
 import "./chunk-3BKAC4OZ.js";
 import "./chunk-YR3BOQNW.js";
 
@@ -15,16 +17,16 @@ import {
 } from "@anthropic-ai/claude-agent-sdk";
 import { z } from "zod";
 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 = createSdkMcpServer({
     name: "thenvoi",
     tools: toolDefinitions
@@ -32,9 +34,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(
     z,