@remnic/core 9.3.770 → 9.4.0

package/dist/{chunk-OP43P53G.js → chunk-GEVIE5NV.js}

@@ -1,9 +1,12 @@
 import {
   buildCitationGuidance
 } from "./chunk-D24OXEPB.js";
+import {
+  applyToolOutputSchemas
+} from "./chunk-5RUE3GHQ.js";
 import {
   validateRequest
-} from "./chunk-2MR3MFQB.js";
+} from "./chunk-6Y4JTNX7.js";
 import {
   REMNIC_CHATGPT_MEMORY_INSPECTOR_MIME_TYPE,
   REMNIC_CHATGPT_MEMORY_INSPECTOR_TOOL,
@@ -12,17 +15,17 @@ import {
 } from "./chunk-T4WDJPEZ.js";
 import {
   getOperation
-} from "./chunk-ZT34X56N.js";
+} from "./chunk-YPL66L3U.js";
 import {
   EngramAccessInputError
-} from "./chunk-EWGMA5W5.js";
+} from "./chunk-IGF4DII6.js";
 import {
   readEnvVar
 } from "./chunk-JUC24CTX.js";
 
 // src/access-mcp.ts
-import { readFile as readFile2 } from "fs/promises";
 import { randomUUID as randomUUID2 } from "crypto";
+import { readFile as readFile2 } from "fs/promises";
 
 // src/chat/chat-system-prompt.ts
 function buildChatSystemPrompt(opts) {
@@ -1167,11 +1170,7 @@ var MCP_READ_ONLY_TOOL_SUFFIXES = {
   codegraph_get_architecture: true,
   codegraph_search_code: true
 };
-var MCP_SUPPORTED_PROTOCOL_VERSIONS = [
-  "2025-06-18",
-  "2025-03-26",
-  "2024-11-05"
-];
+var MCP_SUPPORTED_PROTOCOL_VERSIONS = ["2025-06-18", "2025-03-26", "2024-11-05"];
 var MCP_DEFAULT_PROTOCOL_VERSION = MCP_SUPPORTED_PROTOCOL_VERSIONS[0] ?? "2025-06-18";
 var LEGACY_MCP_PREFIX = "engram.";
 var CANONICAL_MCP_PREFIX = "remnic.";
@@ -1304,14 +1303,7 @@ var MCP_MIGRATED_OPERATIONS = {
   "engram.memory_chat": "chat_message"
 };
 var STRICT_MCP_SCHEMA_KEYS = {
-  daySummary: [
-    "memories",
-    "sessionKey",
-    "namespace",
-    "timeZone",
-    "cwd",
-    "projectTag"
-  ],
+  daySummary: ["memories", "sessionKey", "namespace", "timeZone", "cwd", "projectTag"],
   memoryStore: [
     "schemaVersion",
     "idempotencyKey",
@@ -1444,10 +1436,7 @@ var EngramMcpServer = class {
       }
     ];
     this.resourceTextByUri = /* @__PURE__ */ new Map([
-      [
-        REMNIC_CHATGPT_MEMORY_INSPECTOR_WIDGET_URI,
-        REMNIC_CHATGPT_MEMORY_INSPECTOR_WIDGET_HTML
-      ]
+      [REMNIC_CHATGPT_MEMORY_INSPECTOR_WIDGET_URI, REMNIC_CHATGPT_MEMORY_INSPECTOR_WIDGET_HTML]
     ]);
     this.tools = [
       {
@@ -1468,7 +1457,10 @@ var EngramMcpServer = class {
             // without it being silently dropped.
             disclosure: { type: "string", enum: ["chunk", "section", "raw"] },
             cwd: { type: "string", description: "Working directory for auto git-context resolution." },
-            projectTag: { type: "string", description: "Project tag for non-git project scoping (e.g. 'blend-supply')." },
+            projectTag: {
+              type: "string",
+              description: "Project tag for non-git project scoping (e.g. 'blend-supply')."
+            },
             asOf: {
               type: "string",
               description: "Historical recall pin (issue #680). ISO 8601 timestamp; when set, the recall returns the corpus as it existed at this instant."
@@ -1519,7 +1511,10 @@ var EngramMcpServer = class {
                     projectId: { type: "string", description: "Stable project id (origin:<hex> or root:<hex>)." },
                     branch: { type: ["string", "null"], description: "Current branch, or null in detached HEAD." },
                     rootPath: { type: "string", description: "Absolute path to the repo root." },
-                    defaultBranch: { type: ["string", "null"], description: "Default branch (usually main/master), or null when unknown." }
+                    defaultBranch: {
+                      type: ["string", "null"],
+                      description: "Default branch (usually main/master), or null when unknown."
+                    }
                   },
                   required: ["projectId", "branch", "rootPath", "defaultBranch"],
                   additionalProperties: false
@@ -1730,12 +1725,7 @@ var EngramMcpServer = class {
                 properties: {
                   kind: {
                     type: "string",
-                    enum: [
-                      "ask-before",
-                      "do-not-use-outside-this-context",
-                      "never",
-                      "requires-escalation"
-                    ]
+                    enum: ["ask-before", "do-not-use-outside-this-context", "never", "requires-escalation"]
                   },
                   description: { type: "string" },
                   matched: { type: "boolean" }
@@ -2175,7 +2165,10 @@ var EngramMcpServer = class {
             namespace: { type: "string" },
             skipExtraction: { type: "boolean" },
             cwd: { type: "string", description: "Working directory for auto git-context resolution." },
-            projectTag: { type: "string", description: "Project tag for non-git project scoping (e.g. 'blend-supply')." }
+            projectTag: {
+              type: "string",
+              description: "Project tag for non-git project scoping (e.g. 'blend-supply')."
+            }
           },
           required: ["sessionKey", "messages"],
           additionalProperties: false
@@ -2233,7 +2226,10 @@ var EngramMcpServer = class {
           type: "object",
           properties: {
             period: { type: "string", enum: ["weekly", "monthly"] },
-            key: { type: "string", description: "Period key (weekly: YYYY-Www, monthly: YYYY-MM). Defaults to current." }
+            key: {
+              type: "string",
+              description: "Period key (weekly: YYYY-Www, monthly: YYYY-MM). Defaults to current."
+            }
           },
           additionalProperties: false
         }
@@ -2336,7 +2332,10 @@ var EngramMcpServer = class {
           properties: {
             namespace: { type: "string" },
             identityTraits: { type: "string", description: "Updates for 'Identity Traits' section." },
-            communicationPreferences: { type: "string", description: "Updates for 'Communication Preferences' section." },
+            communicationPreferences: {
+              type: "string",
+              description: "Updates for 'Communication Preferences' section."
+            },
             operatingPrinciples: { type: "string", description: "Updates for 'Operating Principles' section." },
             continuityNotes: { type: "string", description: "Updates for 'Continuity Notes' section." }
           },
@@ -2546,7 +2545,10 @@ var EngramMcpServer = class {
             query: { type: "string" },
             namespace: { type: "string" },
             maxResults: { type: "number" },
-            collection: { type: "string", description: "QMD collection. With namespaces enabled, omitted, base, and 'global' searches stay scoped to readable namespaces; namespace-derived collections require matching namespace access." }
+            collection: {
+              type: "string",
+              description: "QMD collection. With namespaces enabled, omitted, base, and 'global' searches stay scoped to readable namespaces; namespace-derived collections require matching namespace access."
+            }
           },
           required: ["query"],
           additionalProperties: false
@@ -2629,7 +2631,10 @@ var EngramMcpServer = class {
             namespace: { type: "string" },
             limit: { type: "number", description: "Maximum number of edges to return (default 500, max 5000)." },
             since: { type: "string", description: "Inclusive lower bound on edge timestamp (ISO-8601)." },
-            focusNodeId: { type: "string", description: "When set, restrict the snapshot to the focus node and its neighbors." },
+            focusNodeId: {
+              type: "string",
+              description: "When set, restrict the snapshot to the focus node and its neighbors."
+            },
             categories: {
               type: "array",
               items: { type: "string" },
@@ -2742,21 +2747,29 @@ var EngramMcpServer = class {
       // Uses the legacy "engram.*" prefix like every other tool in this array;
       // withToolAliases (applied via .flatMap below) generates the canonical
       // "remnic.briefing" alias automatically.
-      ...service.briefingEnabled ? [{
-        name: "engram.briefing",
-        description: "Generate a daily context briefing by cross-referencing active entities, recent facts, open commitments, and optional calendar events.",
-        inputSchema: {
-          type: "object",
-          properties: {
-            since: { type: "string", description: "Lookback window (e.g. 'yesterday', '3d', '1w', '24h')." },
-            focus: { type: "string", description: "Optional focus filter (e.g. 'person:Jane Doe', 'project:remnic-core', 'topic:retrieval')." },
-            namespace: { type: "string" },
-            format: { type: "string", enum: ["markdown", "json"] },
-            maxFollowups: { type: "number", description: "Maximum LLM-suggested follow-ups (0 disables that section)." }
-          },
-          additionalProperties: false
+      ...service.briefingEnabled ? [
+        {
+          name: "engram.briefing",
+          description: "Generate a daily context briefing by cross-referencing active entities, recent facts, open commitments, and optional calendar events.",
+          inputSchema: {
+            type: "object",
+            properties: {
+              since: { type: "string", description: "Lookback window (e.g. 'yesterday', '3d', '1w', '24h')." },
+              focus: {
+                type: "string",
+                description: "Optional focus filter (e.g. 'person:Jane Doe', 'project:remnic-core', 'topic:retrieval')."
+              },
+              namespace: { type: "string" },
+              format: { type: "string", enum: ["markdown", "json"] },
+              maxFollowups: {
+                type: "number",
+                description: "Maximum LLM-suggested follow-ups (0 disables that section)."
+              }
+            },
+            additionalProperties: false
+          }
         }
-      }] : [],
+      ] : [],
       // ── Contradiction Review (issue #520) ────────────────────────────────
       {
         name: "engram.review_list",
@@ -2764,7 +2777,11 @@ var EngramMcpServer = class {
         inputSchema: {
           type: "object",
           properties: {
-            filter: { type: "string", enum: ["all", "unresolved", "contradicts", "independent", "duplicates", "needs-user"], description: "Filter by verdict type. Default: unresolved." },
+            filter: {
+              type: "string",
+              enum: ["all", "unresolved", "contradicts", "independent", "duplicates", "needs-user"],
+              description: "Filter by verdict type. Default: unresolved."
+            },
             namespace: { type: "string" },
             limit: { type: "number", description: "Max items to return (default 50)." }
           },
@@ -2778,7 +2795,11 @@ var EngramMcpServer = class {
           type: "object",
           properties: {
             pairId: { type: "string", description: "The contradiction pair ID to resolve." },
-            verb: { type: "string", enum: ["keep-a", "keep-b", "merge", "both-valid", "needs-more-context"], description: "Resolution action." },
+            verb: {
+              type: "string",
+              enum: ["keep-a", "keep-b", "merge", "both-valid", "needs-more-context"],
+              description: "Resolution action."
+            },
             mergedMemoryId: { type: "string", description: "Existing merged memory ID to use when verb is merge." },
             mergedContent: { type: "string", description: "Content for a new merged memory when verb is merge." }
           },
@@ -3019,8 +3040,14 @@ var EngramMcpServer = class {
                 enum: ["list", "get", "record", "supersede"],
                 description: "Which decision-record operation to run."
               },
-              sessionKey: { type: "string", description: "Session identifier whose coding context scopes the operation." },
-              namespace: { type: "string", description: "Optional explicit namespace (overrides coding-context overlay)." },
+              sessionKey: {
+                type: "string",
+                description: "Session identifier whose coding context scopes the operation."
+              },
+              namespace: {
+                type: "string",
+                description: "Optional explicit namespace (overrides coding-context overlay)."
+              },
               id: { type: "string", description: "Decision record id (required for get and supersede)." },
               title: { type: "string", description: "Decision title (required for record and supersede)." },
               status: {
@@ -3036,7 +3063,10 @@ var EngramMcpServer = class {
                 items: { type: "string" },
                 description: "Entity references the decision relates to."
               },
-              supersedesId: { type: "string", description: "Id of the record this decision supersedes (supersede only)." }
+              supersedesId: {
+                type: "string",
+                description: "Id of the record this decision supersedes (supersede only)."
+              }
             },
             required: ["subcommand"],
             additionalProperties: false
@@ -3059,8 +3089,14 @@ var EngramMcpServer = class {
                 enum: ["get", "refresh"],
                 description: "Which architecture-card operation to run."
               },
-              sessionKey: { type: "string", description: "Session identifier whose coding context scopes the operation." },
-              namespace: { type: "string", description: "Optional explicit namespace (overrides coding-context overlay)." }
+              sessionKey: {
+                type: "string",
+                description: "Session identifier whose coding context scopes the operation."
+              },
+              namespace: {
+                type: "string",
+                description: "Optional explicit namespace (overrides coding-context overlay)."
+              }
             },
             required: ["subcommand"],
             additionalProperties: false
@@ -3074,18 +3110,42 @@ var EngramMcpServer = class {
       const codegraphToolDefs = [
         { suffix: "index", description: "Index a repository into the code graph.", required: ["repoRoot"] },
         { suffix: "list_projects", description: "List code graph projects for the principal." },
-        { suffix: "delete_project", description: "Delete a code graph project (requires confirm: true).", required: ["confirm"] },
+        {
+          suffix: "delete_project",
+          description: "Delete a code graph project (requires confirm: true).",
+          required: ["confirm"]
+        },
         { suffix: "index_status", description: "Get the indexing status for a project." },
         { suffix: "search_graph", description: "Search the code graph for symbols.", required: ["query"] },
-        { suffix: "trace_path", description: "Trace call/dependency paths from a starting symbol.", required: ["start"] },
+        {
+          suffix: "trace_path",
+          description: "Trace call/dependency paths from a starting symbol.",
+          required: ["start"]
+        },
         { suffix: "detect_changes", description: "Detect changed symbols since a git ref.", required: ["head"] },
-        { suffix: "query_graph", description: "Run a structured query against the code graph.", required: ["structuredQuery"] },
+        {
+          suffix: "query_graph",
+          description: "Run a structured query against the code graph.",
+          required: ["structuredQuery"]
+        },
         { suffix: "get_schema", description: "Get the code graph schema statistics." },
         { suffix: "get_snippet", description: "Get a source code snippet for a symbol.", required: ["qualifiedName"] },
         { suffix: "get_architecture", description: "Get the composed architecture card + graph stats." },
-        { suffix: "search_code", description: "Search the code graph for code (functions, classes, methods).", required: ["query"] },
-        { suffix: "manage_adr", description: "Manage ADRs via Track A decision records (list, get, record, supersede).", required: ["subcommand"] },
-        { suffix: "ingest_traces", description: "Ingest call-site traces to upgrade edge confidence.", required: ["traces"] }
+        {
+          suffix: "search_code",
+          description: "Search the code graph for code (functions, classes, methods).",
+          required: ["query"]
+        },
+        {
+          suffix: "manage_adr",
+          description: "Manage ADRs via Track A decision records (list, get, record, supersede).",
+          required: ["subcommand"]
+        },
+        {
+          suffix: "ingest_traces",
+          description: "Ingest call-site traces to upgrade edge confidence.",
+          required: ["traces"]
+        }
       ];
       for (const def of codegraphToolDefs) {
         const tools = withToolAliases(
@@ -3095,7 +3155,10 @@ var EngramMcpServer = class {
             inputSchema: {
               type: "object",
               properties: {
-                sessionKey: { type: "string", description: "Session identifier whose coding context scopes the operation." },
+                sessionKey: {
+                  type: "string",
+                  description: "Session identifier whose coding context scopes the operation."
+                },
                 project: { type: "string", description: "Explicit project id (defaults to session coding context)." },
                 principal: { type: "string", description: "Authenticated principal override." },
                 query: { type: "string" },
@@ -3143,8 +3206,14 @@ var EngramMcpServer = class {
                 enum: ["get"],
                 description: "Which delta operation to run."
               },
-              sessionKey: { type: "string", description: "Session identifier whose coding context scopes the operation." },
-              namespace: { type: "string", description: "Optional explicit namespace (overrides coding-context overlay)." }
+              sessionKey: {
+                type: "string",
+                description: "Session identifier whose coding context scopes the operation."
+              },
+              namespace: {
+                type: "string",
+                description: "Optional explicit namespace (overrides coding-context overlay)."
+              }
             },
             required: ["subcommand"],
             additionalProperties: false
@@ -3208,8 +3277,14 @@ var EngramMcpServer = class {
           inputSchema: {
             type: "object",
             properties: {
-              message: { type: "string", description: "The user's message \u2014 a question about memories, a correction request, or a confirmation (yes/apply) to proceed with a pending plan." },
-              chatSessionId: { type: "string", description: "Optional existing chat session id to resume. Omit to start a new session." }
+              message: {
+                type: "string",
+                description: "The user's message \u2014 a question about memories, a correction request, or a confirmation (yes/apply) to proceed with a pending plan."
+              },
+              chatSessionId: {
+                type: "string",
+                description: "Optional existing chat session id to resume. Omit to start a new session."
+              }
             },
             required: ["message"],
             additionalProperties: false
@@ -3222,6 +3297,7 @@ var EngramMcpServer = class {
     this.tools = this.tools.map(
       (tool) => isReadOnlyToolName(tool.name) && tool.annotations?.readOnlyHint !== true ? { ...tool, annotations: { ...tool.annotations ?? {}, readOnlyHint: true } } : tool
     );
+    this.tools = applyToolOutputSchemas(this.tools, CANONICAL_MCP_PREFIX, LEGACY_MCP_PREFIX);
   }
   service;
   buffer = Buffer.alloc(0);
@@ -3440,7 +3516,14 @@ var EngramMcpServer = class {
           ...options?.namespaceOverride ? { namespace: options.namespaceOverride } : {},
           ...options?.sessionKeyOverride ? { sessionKey: options.sessionKeyOverride } : {}
         };
-        const result = await this.callTool(name, argumentsObject, effectivePrincipal, options?.sessionId, mcpScope, options?.enforceWriteQuota);
+        const result = await this.callTool(
+          name,
+          argumentsObject,
+          effectivePrincipal,
+          options?.sessionId,
+          mcpScope,
+          options?.enforceWriteQuota
+        );
         return {
           jsonrpc: "2.0",
           id,
@@ -3516,7 +3599,7 @@ var EngramMcpServer = class {
         this.buffer = Buffer.alloc(0);
         return;
       }
-      const contentLength = parseInt(contentLengthHeader.split(":")[1]?.trim() ?? "0", 10);
+      const contentLength = Number.parseInt(contentLengthHeader.split(":")[1]?.trim() ?? "0", 10);
       if (!Number.isFinite(contentLength) || contentLength < 0) {
         this.buffer = Buffer.alloc(0);
         return;
@@ -3608,11 +3691,11 @@ ${body}`;
   async callTool(name, args, effectivePrincipal, mcpSessionId, scope, enforceWriteQuota) {
     const migrated = MCP_MIGRATED_OPERATIONS[toLegacyToolName(name)];
     if (!migrated) {
-      throw new Error("unknown tool: " + name);
+      throw new Error(`unknown tool: ${name}`);
     }
     const op = getOperation(migrated);
     if (!op) {
-      throw new EngramAccessInputError("access-boundary: operation not registered: " + migrated);
+      throw new EngramAccessInputError(`access-boundary: operation not registered: ${migrated}`);
     }
     let envelope;
     if (migrated === "memory_store") {
@@ -3660,13 +3743,20 @@ ${body}`;
       envelope = args;
     }
     if (migrated === "recall") {
-      const result = await op.run(envelope, { service: this.service, authenticatedPrincipal: effectivePrincipal });
+      const result = await op.run(envelope, {
+        service: this.service,
+        authenticatedPrincipal: effectivePrincipal
+      });
       const response = result.result;
       if (this.shouldEmitCitations(mcpSessionId)) {
         const citations = this.buildRecallCitations(response);
         const guidance = buildCitationGuidance(citations);
         if (guidance.length > 0) {
-          return { ...response, context: (response.context ?? "") + guidance, citations };
+          return {
+            ...response,
+            context: (response.context ?? "") + guidance,
+            citations
+          };
         }
       }
       return response;
@@ -3694,4 +3784,4 @@ export {
   MCP_SUPPORTED_PROTOCOL_VERSIONS,
   EngramMcpServer
 };
-//# sourceMappingURL=chunk-OP43P53G.js.map
+//# sourceMappingURL=chunk-GEVIE5NV.js.map