@konneal/engine 0.2.137 → 0.2.138

package/dist/mcp-proto.d.ts

@@ -1,4 +1,10 @@
 export declare const PROTOCOL_VERSION = "2025-06-18";
+/** Registry tool name → the MCP-presented name. */
+export declare function mcpName(registryName: string): string;
+/** MCP-presented name → the name the handlers dispatch on. Raw
+ *  registry names pass through (transition tolerance for early
+ *  consumers of the unprefixed surface). */
+export declare function registryName(presented: string): string;
 export interface McpTool {
     name: string;
     description: string;

package/dist/worker_public/src/index.js

@@ -961,9 +961,30 @@ async function deleteAttachment(deps, sub, id) {
 
 // workers/worker_public/src/mcp-proto.ts
 var PROTOCOL_VERSION = "2025-06-18";
+var mcpPrefix = () => `${P().publisher.id}_`;
+var MCP_NAME_OVERRIDES = {
+  retrieve: `${P().publisher.id}_search`,
+  // the published retrieval contract
+  "documents.family": `${P().publisher.id}_documents`
+  // the published registry contract
+};
+function mcpName(registryName2) {
+  return MCP_NAME_OVERRIDES[registryName2] ?? `${mcpPrefix()}${registryName2.replace(/\./g, "_")}`;
+}
+function registryName(presented) {
+  const pid = P().publisher.id;
+  if (presented === `${pid}_ask`) return "ask";
+  for (const [reg, mc] of Object.entries(MCP_NAME_OVERRIDES)) if (mc === presented) return reg;
+  if (presented.startsWith(`${pid}_`)) {
+    const rest = presented.slice(pid.length + 1);
+    const hit = TOOLS_REGISTRY.find((t) => t.audiences.includes("mcp") && t.name.replace(/\./g, "_") === rest);
+    if (hit) return hit.name;
+  }
+  return presented;
+}
 var TOOLS = [
   {
-    name: "ask",
+    name: mcpName("ask"),
     description: "Ask the corpus a question; returns a citation-grounded answer with the passages it rests on.",
     inputSchema: {
       type: "object",
@@ -975,7 +996,7 @@ var TOOLS = [
     }
   },
   {
-    name: "retrieve",
+    name: mcpName("retrieve"),
     description: "Retrieve the top passages for a query (hybrid dense + metadata steering, reranked).",
     inputSchema: {
       type: "object",
@@ -987,7 +1008,7 @@ var TOOLS = [
     }
   },
   ...TOOLS_REGISTRY.filter((t) => t.audiences.includes("mcp")).map((t) => ({
-    name: t.name,
+    name: mcpName(t.name),
     description: t.description,
     inputSchema: {
       type: "object",
@@ -1010,7 +1031,7 @@ function dispatch(method, params, callTool) {
       if (!TOOLS.some((t) => t.name === name)) {
         return Promise.resolve({ ok: false, code: -32602, message: `unknown tool: ${name}` });
       }
-      return callTool(name, params?.arguments ?? {}).then(
+      return callTool(registryName(name), params?.arguments ?? {}).then(
         (payload) => ({ ok: true, result: { content: [{ type: "text", text: JSON.stringify(payload) }] } })
       );
     }

package/package.json

@@ -27,7 +27,7 @@
     "playwright": "^1.62.1",
     "yaml": "^2.9.1"
   },
-  "version": "0.2.137",
+  "version": "0.2.138",
   "description": "The Konneal engine: the publisher-agnostic build pipeline and API plane for standards intelligence (retrieval, answer contract, verdicts, evaluation).",
   "license": "BSD-3-Clause",
   "type": "module",

package/workers/worker_public/src/mcp-proto.ts

@@ -2,8 +2,40 @@
 // dependency-free so plain node can load it for unit tests — the
 // route adapter (mcp.ts) owns the handler wiring.
 import { TOOLS_REGISTRY } from "./tools.ts";
+import { P } from "./profile.ts";
 export const PROTOCOL_VERSION = "2025-06-18";
 
+// The MCP naming convention (2026-10-12): every tool the publisher
+// exposes over MCP carries the publisher prefix — MCP clients render
+// tool names in a SHARED namespace, so generic names ("ask") collide
+// across servers. The three names docs/MCP.md already publishes keep
+// their exact spelling; the mechanical transform covers the rest.
+const mcpPrefix = () => `${P().publisher.id}_`;
+const MCP_NAME_OVERRIDES: Record<string, string> = {
+  retrieve: `${P().publisher.id}_search`,          // the published retrieval contract
+  "documents.family": `${P().publisher.id}_documents`, // the published registry contract
+};
+
+/** Registry tool name → the MCP-presented name. */
+export function mcpName(registryName: string): string {
+  return MCP_NAME_OVERRIDES[registryName] ?? `${mcpPrefix()}${registryName.replace(/\./g, "_")}`;
+}
+
+/** MCP-presented name → the name the handlers dispatch on. Raw
+ *  registry names pass through (transition tolerance for early
+ *  consumers of the unprefixed surface). */
+export function registryName(presented: string): string {
+  const pid = P().publisher.id;
+  if (presented === `${pid}_ask`) return "ask";
+  for (const [reg, mc] of Object.entries(MCP_NAME_OVERRIDES)) if (mc === presented) return reg;
+  if (presented.startsWith(`${pid}_`)) {
+    const rest = presented.slice(pid.length + 1);
+    const hit = TOOLS_REGISTRY.find((t) => t.audiences.includes("mcp") && t.name.replace(/\./g, "_") === rest);
+    if (hit) return hit.name;
+  }
+  return presented;
+}
+
 export interface McpTool {
   name: string;
   description: string;
@@ -14,7 +46,7 @@ export interface McpTool {
 // tool registers it; this list is never hand-extended for them)
 export const TOOLS: McpTool[] = [
   {
-    name: "ask",
+    name: mcpName("ask"),
     description: "Ask the corpus a question; returns a citation-grounded answer with the passages it rests on.",
     inputSchema: {
       type: "object",
@@ -26,7 +58,7 @@ export const TOOLS: McpTool[] = [
     },
   },
   {
-    name: "retrieve",
+    name: mcpName("retrieve"),
     description: "Retrieve the top passages for a query (hybrid dense + metadata steering, reranked).",
     inputSchema: {
       type: "object",
@@ -40,7 +72,7 @@ export const TOOLS: McpTool[] = [
   ...TOOLS_REGISTRY
     .filter((t) => t.audiences.includes("mcp"))
     .map((t): McpTool => ({
-      name: t.name,
+      name: mcpName(t.name),
       description: t.description,
       inputSchema: {
         type: "object",
@@ -75,7 +107,7 @@ export function dispatch(
       if (!TOOLS.some((t) => t.name === name)) {
         return Promise.resolve({ ok: false, code: -32602, message: `unknown tool: ${name}` });
       }
-      return callTool(name, params?.arguments ?? {}).then(
+      return callTool(registryName(name), params?.arguments ?? {}).then(
         (payload) => ({ ok: true, result: { content: [{ type: "text", text: JSON.stringify(payload) }] } }) as McpResult,
       );
     }