@remnic/core 9.3.722 → 9.3.724

package/dist/{chunk-B7WISIAJ.js → chunk-FN6QP7JQ.js}

@@ -1,35 +1,21 @@
+import {
+  buildCitationGuidance
+} from "./chunk-D24OXEPB.js";
 import {
   REMNIC_CHATGPT_MEMORY_INSPECTOR_MIME_TYPE,
   REMNIC_CHATGPT_MEMORY_INSPECTOR_TOOL,
   REMNIC_CHATGPT_MEMORY_INSPECTOR_WIDGET_HTML,
-  REMNIC_CHATGPT_MEMORY_INSPECTOR_WIDGET_URI,
-  buildChatGptMemoryInspectorActionRequest,
-  buildChatGptMemoryInspectorResult
+  REMNIC_CHATGPT_MEMORY_INSPECTOR_WIDGET_URI
 } from "./chunk-T4WDJPEZ.js";
-import {
-  buildCitationGuidance
-} from "./chunk-D24OXEPB.js";
 import {
   validateRequest
 } from "./chunk-FVZ2ISIX.js";
 import {
   getOperation
-} from "./chunk-LLUGAZ3B.js";
+} from "./chunk-NT36GU6X.js";
 import {
   EngramAccessInputError
-} from "./chunk-GDUOCHCD.js";
-import {
-  projectTagProjectId
-} from "./chunk-J6BH2OBA.js";
-import {
-  validateBriefingFormat
-} from "./chunk-UO5ZHIIH.js";
-import {
-  resolvePrincipal
-} from "./chunk-UZYLX7M6.js";
-import {
-  expandTildePath
-} from "./chunk-EYIEWJNI.js";
+} from "./chunk-KGZF2VO3.js";
 import {
   readEnvVar
 } from "./chunk-JUC24CTX.js";
@@ -1080,13 +1066,90 @@ var MCP_MIGRATED_OPERATIONS = {
   "engram.coding_delta": "coding_delta",
   // Correction Contract (issue #1580) — one plan/apply pipeline.
   "engram.memory_correct_plan": "memory_correct_plan",
-  "engram.memory_correct_apply": "memory_correct_apply"
+  "engram.memory_correct_apply": "memory_correct_apply",
+  // Fully migrated through the strict-schema boundary (#1668).
+  "engram.recall": "recall",
+  "engram.recall_explain": "recall_explain",
+  "engram.set_coding_context": "set_coding_context",
+  "engram.recall_tier_explain": "recall_tier_explain",
+  "engram.recall_xray": "recall_xray",
+  "engram.wearables_status": "wearables_status",
+  "engram.wearables_sync": "wearables_sync",
+  "engram.transcript_day": "transcript_day",
+  "engram.transcript_search": "transcript_search",
+  "engram.transcript_memories": "transcript_memories",
+  "engram.action_confidence": "action_confidence",
+  "engram.chatgpt_memory_inspector": "chatgpt_memory_inspector",
+  "engram.day_summary": "day_summary",
+  "engram.capsule_export": "capsule_export",
+  "engram.capsule_import": "capsule_import",
+  "engram.capsule_list": "capsule_list",
+  "engram.memory_governance_run": "memory_governance_run",
+  "engram.procedure_mining_run": "procedure_mining_run",
+  "engram.pattern_reinforcement_run": "pattern_reinforcement_run",
+  "engram.procedural_stats": "procedural_stats",
+  "engram.memory_timeline": "memory_timeline",
+  "engram.suggestion_submit": "suggestion_submit",
+  "engram.entity_get": "entity_get",
+  "engram.review_queue_list": "review_queue_list",
+  "engram.observe": "observe",
+  "engram.lcm_search": "lcm_search",
+  "engram.lcm_compaction_flush": "lcm_compaction_flush",
+  "engram.lcm_compaction_record": "lcm_compaction_record",
+  "engram.continuity_audit_generate": "continuity_audit_generate",
+  "engram.continuity_incident_open": "continuity_incident_open",
+  "engram.continuity_incident_close": "continuity_incident_close",
+  "engram.continuity_incident_list": "continuity_incident_list",
+  "engram.continuity_loop_add_or_update": "continuity_loop_add_or_update",
+  "engram.continuity_loop_review": "continuity_loop_review",
+  "engram.identity_anchor_get": "identity_anchor_get",
+  "engram.identity_anchor_update": "identity_anchor_update",
+  "engram.memory_identity": "memory_identity",
+  "engram.work_task": "work_task",
+  "engram.work_project": "work_project",
+  "engram.work_board": "work_board",
+  "engram.shared_context_write_output": "shared_context_write_output",
+  "engram.shared_feedback_record": "shared_feedback_record",
+  "engram.shared_priorities_append": "shared_priorities_append",
+  "engram.shared_context_cross_signals_run": "shared_context_cross_signals_run",
+  "engram.shared_context_curate_daily": "shared_context_curate_daily",
+  "engram.compounding_weekly_synthesize": "compounding_weekly_synthesize",
+  "engram.compounding_promote_candidate": "compounding_promote_candidate",
+  "engram.compression_guidelines_optimize": "compression_guidelines_optimize",
+  "engram.compression_guidelines_activate": "compression_guidelines_activate",
+  "engram.memory_profile": "memory_profile",
+  "engram.memory_entities_list": "memory_entities_list",
+  "engram.memory_questions": "memory_questions",
+  "engram.memory_last_recall": "memory_last_recall",
+  "engram.memory_intent_debug": "memory_intent_debug",
+  "engram.memory_qmd_debug": "memory_qmd_debug",
+  "engram.memory_graph_explain": "memory_graph_explain",
+  "engram.graph_snapshot": "graph_snapshot",
+  "engram.memory_feedback": "memory_feedback",
+  "engram.memory_promote": "memory_promote",
+  "engram.memory_outcome": "memory_outcome",
+  "engram.memory_action_apply": "memory_action_apply",
+  "engram.context_checkpoint": "context_checkpoint",
+  "engram.briefing": "briefing",
+  "engram.review_list": "review_list",
+  "engram.review_resolve": "review_resolve",
+  "engram.contradiction_scan_run": "contradiction_scan_run",
+  "engram.memory_summarize_hourly": "memory_summarize_hourly",
+  "engram.conversation_index_update": "conversation_index_update",
+  "engram.profiling_report": "profiling_report",
+  "engram.graph_edge_decay_run": "graph_edge_decay_run",
+  "engram.live_connectors_run": "live_connectors_run",
+  "engram.peer_list": "peer_list",
+  "engram.peer_get": "peer_get",
+  "engram.peer_set": "peer_set",
+  "engram.peer_delete": "peer_delete",
+  "engram.peer_profile_get": "peer_profile_get",
+  "engram.peer_forget": "peer_forget",
+  "engram.console_state": "console_state",
+  "engram.dreams_status": "dreams_status",
+  "engram.dreams_run": "dreams_run",
+  "engram.memory_chat": "chat_message"
 };
-function resolveChatGptInspectorRecallSessionKey(explicitSessionKey, authenticatedPrincipal) {
-  if (explicitSessionKey) return explicitSessionKey;
-  if (!authenticatedPrincipal) return void 0;
-  return `remnic:chatgpt-memory-inspector:${randomUUID2()}`;
-}
 var STRICT_MCP_SCHEMA_KEYS = {
   daySummary: [
     "memories",
@@ -1180,24 +1243,6 @@ function parseMcpRequest(schemaName, args) {
     details.length > 0 ? `${validation.error.error}: ${details}` : validation.error.error
   );
 }
-function optionalNonEmptyString(value, label) {
-  if (value === void 0 || value === null || value === "") return void 0;
-  if (typeof value !== "string") {
-    throw new Error(`${label} expects a string; got ${JSON.stringify(value)}`);
-  }
-  return value;
-}
-function optionalPositiveInteger(value, label) {
-  if (value === void 0 || value === null || value === "") return void 0;
-  if (typeof value !== "number" && typeof value !== "string") {
-    throw new Error(`${label} expects a positive integer; got ${JSON.stringify(value)}`);
-  }
-  const parsed = typeof value === "number" ? value : Number(value);
-  if (!Number.isFinite(parsed) || parsed <= 0 || !Number.isInteger(parsed)) {
-    throw new Error(`${label} expects a positive integer; got ${JSON.stringify(value)}`);
-  }
-  return parsed;
-}
 function getObjectProperties(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
@@ -3396,1034 +3441,76 @@ ${body}`;
   }
   async callTool(name, args, effectivePrincipal, mcpSessionId, scope, enforceWriteQuota) {
     const migrated = MCP_MIGRATED_OPERATIONS[toLegacyToolName(name)];
-    if (migrated) {
-      const op = getOperation(migrated);
-      if (!op) {
-        throw new EngramAccessInputError(`access-boundary: operation not registered: ${migrated}`);
-      }
-      let envelope;
-      if (migrated === "memory_store") {
-        envelope = parseMcpRequest("memoryStore", args);
-      } else if (migrated.startsWith("codegraph_")) {
-        envelope = { ...args, tool: migrated.slice("codegraph_".length) };
-      } else {
-        envelope = args;
-      }
-      const output = await op.run(envelope, {
+    if (!migrated) {
+      throw new Error("unknown tool: " + name);
+    }
+    const op = getOperation(migrated);
+    if (!op) {
+      throw new EngramAccessInputError("access-boundary: operation not registered: " + migrated);
+    }
+    let envelope;
+    if (migrated === "memory_store") {
+      envelope = parseMcpRequest("memoryStore", args);
+    } else if (migrated === "suggestion_submit") {
+      envelope = parseMcpRequest("suggestionSubmit", args);
+    } else if (migrated === "action_confidence") {
+      envelope = parseMcpRequest("actionConfidence", args);
+    } else if (migrated === "day_summary") {
+      envelope = parseMcpRequest("daySummary", args);
+    } else if (migrated === "capsule_export") {
+      envelope = parseMcpRequest("capsuleExport", args);
+    } else if (migrated === "capsule_import") {
+      envelope = parseMcpRequest("capsuleImport", args);
+    } else if (migrated === "capsule_list") {
+      envelope = parseMcpRequest("capsuleList", args);
+    } else if (migrated === "observe") {
+      envelope = parseMcpRequest("observe", args);
+    } else if (migrated === "lcm_compaction_flush") {
+      envelope = parseMcpRequest("lcmCompactionFlush", args);
+    } else if (migrated === "lcm_compaction_record") {
+      envelope = parseMcpRequest("lcmCompactionRecord", args);
+    } else if (migrated.startsWith("codegraph_")) {
+      envelope = { ...args, tool: migrated.slice("codegraph_".length) };
+    } else if (migrated === "chat_message") {
+      const message = typeof args.message === "string" ? args.message : "";
+      if (!message) throw new EngramAccessInputError("message is required");
+      const chatSessionId = typeof args.chatSessionId === "string" ? args.chatSessionId : void 0;
+      const chatResult = await processChatMessage({
         service: this.service,
-        authenticatedPrincipal: effectivePrincipal
+        config: this.service.configRef?.chat,
+        memoryDir: this.service.memoryDir,
+        message,
+        ...chatSessionId ? { chatSessionId } : {},
+        ...effectivePrincipal ? { principal: effectivePrincipal } : {},
+        ...scope?.namespace ? { namespace: scope.namespace } : {},
+        ...scope?.sessionKey ? { sessionKey: scope.sessionKey } : {}
       });
-      return output.result;
-    }
-    switch (toLegacyToolName(name)) {
-      case "engram.recall": {
-        let disclosure;
-        if ("disclosure" in args && args.disclosure !== void 0 && args.disclosure !== null) {
-          if (typeof args.disclosure !== "string") {
-            throw new EngramAccessInputError(
-              "disclosure must be a string (one of: chunk, section, raw)"
-            );
-          }
-          disclosure = args.disclosure;
-        }
-        if ("cwd" in args && args.cwd !== void 0 && args.cwd !== null && typeof args.cwd !== "string") {
-          throw new EngramAccessInputError("cwd must be a string");
-        }
-        if ("projectTag" in args && args.projectTag !== void 0 && args.projectTag !== null && typeof args.projectTag !== "string") {
-          throw new EngramAccessInputError("projectTag must be a string");
-        }
-        if ("asOf" in args && args.asOf !== void 0 && args.asOf !== null && typeof args.asOf !== "string") {
-          throw new EngramAccessInputError("asOf must be a string (ISO 8601 timestamp)");
-        }
-        let tags;
-        if ("tags" in args && args.tags !== void 0 && args.tags !== null) {
-          if (!Array.isArray(args.tags) || !args.tags.every((t) => typeof t === "string")) {
-            throw new EngramAccessInputError("tags must be an array of strings");
-          }
-          tags = args.tags;
-        }
-        let tagMatch;
-        if ("tagMatch" in args && args.tagMatch !== void 0 && args.tagMatch !== null) {
-          if (typeof args.tagMatch !== "string" || args.tagMatch !== "any" && args.tagMatch !== "all") {
-            throw new EngramAccessInputError(
-              `tagMatch must be one of: any, all (got: ${String(args.tagMatch)})`
-            );
-          }
-          tagMatch = args.tagMatch;
-        }
-        const response = await this.service.recall({
-          query: typeof args.query === "string" ? args.query : "",
-          sessionKey: typeof args.sessionKey === "string" ? args.sessionKey : void 0,
-          authenticatedPrincipal: effectivePrincipal,
-          namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-          topK: typeof args.topK === "number" && Number.isFinite(args.topK) ? args.topK : void 0,
-          mode: typeof args.mode === "string" ? args.mode : void 0,
-          includeDebug: args.includeDebug === true,
-          disclosure,
-          cwd: typeof args.cwd === "string" ? args.cwd : void 0,
-          projectTag: typeof args.projectTag === "string" ? args.projectTag : void 0,
-          asOf: typeof args.asOf === "string" ? args.asOf : void 0,
-          ...tags !== void 0 ? { tags } : {},
-          ...tagMatch !== void 0 ? { tagMatch } : {}
-        });
-        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;
-      }
-      case "engram.recall_explain":
-        return this.service.recallExplain({
-          sessionKey: typeof args.sessionKey === "string" ? args.sessionKey : void 0,
-          namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-          authenticatedPrincipal: effectivePrincipal
-        });
-      case "engram.set_coding_context": {
-        const sessionKey = typeof args.sessionKey === "string" ? args.sessionKey : "";
-        const hasProjectTag = typeof args.projectTag === "string" && args.projectTag.trim().length > 0;
-        const hasCodingContext = "codingContext" in args;
-        if (!hasCodingContext && hasProjectTag) {
-          const tag = args.projectTag.trim();
-          const projectId = projectTagProjectId(tag);
-          this.service.setCodingContext({
-            sessionKey,
-            codingContext: {
-              projectId,
-              branch: null,
-              rootPath: projectId,
-              defaultBranch: null
-            }
-          });
-          return { ok: true };
-        }
-        if (!hasCodingContext && !hasProjectTag) {
-          throw new EngramAccessInputError(
-            "set_coding_context requires either codingContext or projectTag"
-          );
-        }
-        const rawCtx = args.codingContext;
-        let codingContext = null;
-        if (rawCtx !== null) {
-          if (typeof rawCtx !== "object" || rawCtx === void 0) {
-            throw new EngramAccessInputError("codingContext must be an object or null");
-          }
-          const obj = rawCtx;
-          const projectId = typeof obj.projectId === "string" ? obj.projectId : "";
-          const rootPath = typeof obj.rootPath === "string" ? obj.rootPath : "";
-          const branch = obj.branch === null ? null : typeof obj.branch === "string" ? obj.branch : void 0;
-          const defaultBranch = obj.defaultBranch === null ? null : typeof obj.defaultBranch === "string" ? obj.defaultBranch : void 0;
-          if (branch === void 0) {
-            throw new EngramAccessInputError("codingContext.branch must be a string or null");
-          }
-          if (defaultBranch === void 0) {
-            throw new EngramAccessInputError("codingContext.defaultBranch must be a string or null");
-          }
-          codingContext = { projectId, branch, rootPath, defaultBranch };
-        }
-        this.service.setCodingContext({ sessionKey, codingContext });
-        return { ok: true };
-      }
-      case "engram.recall_tier_explain":
-        return this.service.recallTierExplain(
-          typeof args.sessionKey === "string" && args.sessionKey.length > 0 ? args.sessionKey : void 0,
-          typeof args.namespace === "string" && args.namespace.length > 0 ? args.namespace : void 0,
-          effectivePrincipal
-        );
-      case "engram.recall_xray": {
-        const query = typeof args.query === "string" ? args.query : "";
-        const sessionKey = typeof args.sessionKey === "string" && args.sessionKey.length > 0 ? args.sessionKey : void 0;
-        const namespace = typeof args.namespace === "string" && args.namespace.length > 0 ? args.namespace : void 0;
-        let budget;
-        if (args.budget !== void 0 && args.budget !== null) {
-          if (typeof args.budget !== "number" && typeof args.budget !== "string") {
-            throw new Error(
-              `engram.recall_xray: budget expects a positive integer; got ${JSON.stringify(args.budget)}`
-            );
-          }
-          const parsed = typeof args.budget === "number" ? args.budget : Number(args.budget);
-          if (!Number.isFinite(parsed) || parsed <= 0 || !Number.isInteger(parsed)) {
-            throw new Error(
-              `engram.recall_xray: budget expects a positive integer; got ${JSON.stringify(args.budget)}`
-            );
-          }
-          budget = parsed;
-        }
-        let disclosure;
-        if ("disclosure" in args && args.disclosure !== void 0 && args.disclosure !== null && args.disclosure !== "") {
-          if (typeof args.disclosure !== "string") {
-            throw new Error(
-              "engram.recall_xray: disclosure must be a string (one of: chunk, section, raw)"
-            );
-          }
-          disclosure = args.disclosure;
-        }
-        return this.service.recallXray({
-          query,
-          sessionKey,
-          namespace,
-          budget,
-          authenticatedPrincipal: effectivePrincipal,
-          ...disclosure !== void 0 ? { disclosure } : {}
-        });
-      }
-      case "engram.wearables_status":
-        return this.service.wearablesStatus();
-      case "engram.wearables_sync": {
-        const source = optionalNonEmptyString(args.source, "engram.wearables_sync: source");
-        const date = optionalNonEmptyString(args.date, "engram.wearables_sync: date");
-        const days = optionalPositiveInteger(args.days, "engram.wearables_sync: days");
-        let forceMemories;
-        if (args.forceMemories !== void 0 && args.forceMemories !== null) {
-          if (typeof args.forceMemories !== "boolean") {
-            throw new Error(
-              `engram.wearables_sync: forceMemories expects a boolean; got ${JSON.stringify(args.forceMemories)}`
-            );
-          }
-          forceMemories = args.forceMemories;
-        }
-        return this.service.wearablesSync({ source, date, days, forceMemories });
-      }
-      case "engram.transcript_day": {
-        const date = typeof args.date === "string" ? args.date : "";
-        if (date.trim().length === 0) {
-          throw new Error(
-            "engram.transcript_day: date is required and must be YYYY-MM-DD"
-          );
-        }
-        const source = optionalNonEmptyString(args.source, "engram.transcript_day: source");
-        return this.service.wearablesTranscriptDay({ date, source });
-      }
-      case "engram.transcript_search": {
-        const query = typeof args.query === "string" ? args.query : "";
-        if (query.trim().length === 0) {
-          throw new Error(
-            "engram.transcript_search: query is required and must be non-empty"
-          );
-        }
-        return this.service.wearablesTranscriptSearch({
-          query,
-          source: optionalNonEmptyString(args.source, "engram.transcript_search: source"),
-          from: optionalNonEmptyString(args.from, "engram.transcript_search: from"),
-          to: optionalNonEmptyString(args.to, "engram.transcript_search: to"),
-          limit: optionalPositiveInteger(args.limit, "engram.transcript_search: limit")
-        });
-      }
-      case "engram.transcript_memories":
-        return this.service.wearablesTranscriptMemories({
-          source: optionalNonEmptyString(args.source, "engram.transcript_memories: source"),
-          date: optionalNonEmptyString(args.date, "engram.transcript_memories: date"),
-          limit: optionalPositiveInteger(args.limit, "engram.transcript_memories: limit")
-        });
-      case "engram.action_confidence": {
-        const body = parseMcpRequest("actionConfidence", args);
-        return this.service.actionConfidence(body);
-      }
-      case REMNIC_CHATGPT_MEMORY_INSPECTOR_TOOL: {
-        if (typeof args.query !== "string" || args.query.trim().length === 0) {
-          throw new EngramAccessInputError(
-            "chatgpt_memory_inspector requires a non-empty query string"
-          );
-        }
-        if ("sessionKey" in args && args.sessionKey !== void 0 && args.sessionKey !== null && typeof args.sessionKey !== "string") {
-          throw new EngramAccessInputError("sessionKey must be a string");
-        }
-        if ("namespace" in args && args.namespace !== void 0 && args.namespace !== null && typeof args.namespace !== "string") {
-          throw new EngramAccessInputError("namespace must be a string");
-        }
-        let currentContextScopes;
-        if (args.currentContextScopes !== void 0 && args.currentContextScopes !== null) {
-          if (!Array.isArray(args.currentContextScopes) || !args.currentContextScopes.every((scope2) => typeof scope2 === "string")) {
-            throw new EngramAccessInputError(
-              "currentContextScopes must be an array of strings"
-            );
-          }
-          currentContextScopes = args.currentContextScopes;
-        }
-        const input = {
-          query: args.query.trim()
-        };
-        if (typeof args.sessionKey === "string" && args.sessionKey.trim().length > 0) {
-          input.sessionKey = args.sessionKey;
-        }
-        if (typeof args.namespace === "string" && args.namespace.trim().length > 0) {
-          input.namespace = args.namespace;
-        }
-        if (currentContextScopes !== void 0) {
-          input.currentContextScopes = currentContextScopes;
-        }
-        if (args.allowUnverifiedPreview !== void 0 && args.allowUnverifiedPreview !== null) {
-          if (typeof args.allowUnverifiedPreview !== "boolean") {
-            throw new EngramAccessInputError(
-              "allowUnverifiedPreview must be a boolean"
-            );
-          }
-          input.allowUnverifiedPreview = args.allowUnverifiedPreview;
-        }
-        const recallSessionKey = resolveChatGptInspectorRecallSessionKey(
-          input.sessionKey,
-          effectivePrincipal
-        );
-        const xrayResponse = await this.service.recallXray({
-          query: input.query,
-          sessionKey: recallSessionKey,
-          namespace: input.namespace,
-          currentContextScopes: input.currentContextScopes,
-          authenticatedPrincipal: effectivePrincipal,
-          mode: "full",
-          disclosure: "chunk",
-          includeRecall: true
-        });
-        const xray = xrayResponse.snapshotFound === true ? xrayResponse.snapshot ?? null : null;
-        const recall = xrayResponse.recall ?? {
-          query: input.query,
-          namespace: input.namespace ?? xray?.namespace ?? "global",
-          context: "",
-          count: 0,
-          memoryIds: [],
-          results: [],
-          fallbackUsed: false,
-          sourcesUsed: [],
-          disclosure: "chunk"
-        };
-        const actionRequest = buildChatGptMemoryInspectorActionRequest(
-          input,
-          recall,
-          xray
-        );
-        const actionConfidence = await this.service.actionConfidence(actionRequest);
-        return buildChatGptMemoryInspectorResult(
-          input,
-          recall,
-          xray,
-          actionConfidence
-        );
-      }
-      case "engram.day_summary": {
-        const body = parseMcpRequest("daySummary", args);
-        return this.service.daySummary(body);
-      }
-      case "engram.capsule_export": {
-        const body = parseMcpRequest("capsuleExport", args);
-        return this.service.capsuleExport({
-          name: body.name,
-          namespace: body.namespace,
-          principal: effectivePrincipal,
-          since: body.since,
-          includeKinds: body.includeKinds,
-          peerIds: body.peerIds,
-          includeTranscripts: body.includeTranscripts,
-          encrypt: body.encrypt
-        });
-      }
-      case "engram.capsule_import": {
-        const body = parseMcpRequest("capsuleImport", args);
-        return this.service.capsuleImport({
-          archivePath: expandTildePath(body.archivePath),
-          namespace: body.namespace,
-          principal: effectivePrincipal,
-          mode: body.mode,
-          passphrase: body.passphrase
-        });
-      }
-      case "engram.capsule_list": {
-        const body = parseMcpRequest("capsuleList", args);
-        const requestPrincipal = effectivePrincipal ?? (body.sessionKey && this.service.configRef ? resolvePrincipal(body.sessionKey, this.service.configRef) : void 0);
-        return this.service.capsuleList({
-          namespace: body.namespace,
-          principal: requestPrincipal
-        });
-      }
-      case "engram.memory_governance_run":
-        return this.service.governanceRun({
-          namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-          mode: args.mode === "apply" ? "apply" : "shadow",
-          recentDays: typeof args.recentDays === "number" && Number.isFinite(args.recentDays) ? args.recentDays : void 0,
-          maxMemories: typeof args.maxMemories === "number" && Number.isFinite(args.maxMemories) ? args.maxMemories : void 0,
-          batchSize: typeof args.batchSize === "number" && Number.isFinite(args.batchSize) ? args.batchSize : void 0,
-          authenticatedPrincipal: effectivePrincipal
-        }, effectivePrincipal);
-      case "engram.procedure_mining_run":
-        return this.service.procedureMiningRun(
-          {
-            namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-            authenticatedPrincipal: effectivePrincipal
-          },
-          effectivePrincipal
-        );
-      case "engram.pattern_reinforcement_run":
-        return this.service.patternReinforcementRun(
-          {
-            namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-            authenticatedPrincipal: effectivePrincipal,
-            force: args.force === true
-          },
-          effectivePrincipal
-        );
-      case "remnic.procedural_stats":
-      case "engram.procedural_stats":
-        return this.service.procedureStats(
-          {
-            namespace: typeof args.namespace === "string" ? args.namespace : void 0
-          },
-          effectivePrincipal
-        );
-      case "engram.memory_timeline": {
-        const limit = typeof args.limit === "number" && Number.isFinite(args.limit) ? args.limit : 200;
-        return this.service.memoryTimeline(
-          typeof args.memoryId === "string" ? args.memoryId : "",
-          typeof args.namespace === "string" ? args.namespace : void 0,
-          limit,
-          effectivePrincipal
-        );
-      }
-      case "engram.suggestion_submit": {
-        const body = parseMcpRequest("suggestionSubmit", args);
-        return this.service.suggestionSubmit({
-          schemaVersion: body.schemaVersion,
-          idempotencyKey: body.idempotencyKey,
-          dryRun: body.dryRun,
-          sessionKey: body.sessionKey,
-          authenticatedPrincipal: effectivePrincipal,
-          content: body.content,
-          category: body.category,
-          confidence: body.confidence,
-          namespace: body.namespace,
-          tags: body.tags,
-          entityRef: body.entityRef,
-          ttl: body.ttl,
-          sourceReason: body.sourceReason,
-          cwd: body.cwd,
-          projectTag: body.projectTag
-        });
-      }
-      case "engram.entity_get":
-        return this.service.entityGet(
-          typeof args.name === "string" ? args.name : "",
-          typeof args.namespace === "string" ? args.namespace : void 0
-        );
-      case "engram.review_queue_list":
-        return this.service.reviewQueue(
-          typeof args.runId === "string" ? args.runId : void 0,
-          typeof args.namespace === "string" ? args.namespace : void 0,
-          effectivePrincipal
-        );
-      case "engram.observe": {
-        const body = parseMcpRequest("observe", args);
-        return this.service.observe(
-          {
-            sessionKey: body.sessionKey,
-            messages: body.messages.map((message) => ({
-              role: message.role,
-              content: message.content,
-              parts: message.parts ?? void 0,
-              rawContent: message.rawContent ?? void 0,
-              sourceFormat: message.sourceFormat ?? void 0
-            })),
-            skipExtraction: body.skipExtraction === true,
-            idempotencyKey: body.idempotencyKey,
-            namespace: body.namespace,
-            authenticatedPrincipal: effectivePrincipal,
-            cwd: body.cwd,
-            projectTag: body.projectTag
-          },
-          // Forward the transport's write-quota enforcer into observe's
-          // idempotency lock so a replay is never 429'd (issue #1649).
-          enforceWriteQuota ? { enforceWriteQuota } : void 0
-        );
-      }
-      case "engram.lcm_search":
-        return this.service.lcmSearch({
-          query: typeof args.query === "string" ? args.query : "",
-          sessionKey: typeof args.sessionKey === "string" ? args.sessionKey : void 0,
-          sessionPrefix: typeof args.sessionPrefix === "string" ? args.sessionPrefix : void 0,
-          namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-          limit: typeof args.limit === "number" && Number.isFinite(args.limit) ? args.limit : void 0,
-          authenticatedPrincipal: effectivePrincipal
-        });
-      case "engram.lcm_compaction_flush": {
-        const body = parseMcpRequest("lcmCompactionFlush", args);
-        return this.service.lcmCompactionFlush({
-          sessionKey: body.sessionKey,
-          namespace: body.namespace,
-          authenticatedPrincipal: effectivePrincipal
-        });
-      }
-      case "engram.lcm_compaction_record": {
-        const body = parseMcpRequest("lcmCompactionRecord", args);
-        return this.service.lcmCompactionRecord({
-          sessionKey: body.sessionKey,
-          namespace: body.namespace,
-          tokensBefore: body.tokensBefore,
-          tokensAfter: body.tokensAfter,
-          authenticatedPrincipal: effectivePrincipal
-        });
-      }
-      // ── Continuity / Identity tools ───────────────────────────────────
-      case "engram.continuity_audit_generate":
-        return this.service.continuityAuditGenerate({
-          period: args.period === "monthly" ? "monthly" : args.period === "weekly" ? "weekly" : void 0,
-          key: typeof args.key === "string" ? args.key : void 0
-        });
-      case "engram.continuity_incident_open":
-        return this.service.continuityIncidentOpen({
-          symptom: typeof args.symptom === "string" ? args.symptom : "",
-          namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-          principal: effectivePrincipal,
-          triggerWindow: typeof args.triggerWindow === "string" ? args.triggerWindow : void 0,
-          suspectedCause: typeof args.suspectedCause === "string" ? args.suspectedCause : void 0
-        });
-      case "engram.continuity_incident_close":
-        return this.service.continuityIncidentClose({
-          id: typeof args.id === "string" ? args.id : "",
-          namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-          principal: effectivePrincipal,
-          fixApplied: typeof args.fixApplied === "string" ? args.fixApplied : "",
-          verificationResult: typeof args.verificationResult === "string" ? args.verificationResult : "",
-          preventiveRule: typeof args.preventiveRule === "string" ? args.preventiveRule : void 0
-        });
-      case "engram.continuity_incident_list":
-        return this.service.continuityIncidentList({
-          state: args.state === "closed" ? "closed" : args.state === "all" ? "all" : args.state === "open" ? "open" : void 0,
-          namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-          principal: effectivePrincipal,
-          limit: typeof args.limit === "number" ? args.limit : void 0
-        });
-      case "engram.continuity_loop_add_or_update":
-        return this.service.continuityLoopAddOrUpdate({
-          id: typeof args.id === "string" ? args.id : "",
-          cadence: args.cadence ?? "weekly",
-          purpose: typeof args.purpose === "string" ? args.purpose : "",
-          status: args.status ?? "active",
-          killCondition: typeof args.killCondition === "string" ? args.killCondition : "",
-          namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-          principal: effectivePrincipal,
-          lastReviewed: typeof args.lastReviewed === "string" ? args.lastReviewed : void 0,
-          notes: typeof args.notes === "string" ? args.notes : void 0
-        });
-      case "engram.continuity_loop_review":
-        return this.service.continuityLoopReview({
-          id: typeof args.id === "string" ? args.id : "",
-          namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-          principal: effectivePrincipal,
-          status: args.status === "active" || args.status === "paused" || args.status === "retired" ? args.status : void 0,
-          notes: typeof args.notes === "string" ? args.notes : void 0,
-          reviewedAt: typeof args.reviewedAt === "string" ? args.reviewedAt : void 0
-        });
-      case "engram.identity_anchor_get":
-        return this.service.identityAnchorGet({
-          namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-          principal: effectivePrincipal
-        });
-      case "engram.identity_anchor_update":
-        return this.service.identityAnchorUpdate({
-          namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-          principal: effectivePrincipal,
-          identityTraits: typeof args.identityTraits === "string" ? args.identityTraits : void 0,
-          communicationPreferences: typeof args.communicationPreferences === "string" ? args.communicationPreferences : void 0,
-          operatingPrinciples: typeof args.operatingPrinciples === "string" ? args.operatingPrinciples : void 0,
-          continuityNotes: typeof args.continuityNotes === "string" ? args.continuityNotes : void 0
-        });
-      case "engram.memory_identity":
-        return this.service.memoryIdentity({
-          namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-          principal: effectivePrincipal
-        });
-      // ── Work Layer tools ──────────────────────────────────────────────
-      case "engram.work_task":
-        return this.service.workTask({
-          action: args.action ?? "list",
-          id: typeof args.id === "string" ? args.id : void 0,
-          title: typeof args.title === "string" ? args.title : void 0,
-          description: typeof args.description === "string" ? args.description : void 0,
-          status: typeof args.status === "string" ? args.status : void 0,
-          priority: typeof args.priority === "string" ? args.priority : void 0,
-          owner: typeof args.owner === "string" ? args.owner : void 0,
-          assignee: typeof args.assignee === "string" ? args.assignee : void 0,
-          projectId: typeof args.projectId === "string" ? args.projectId : void 0,
-          tags: Array.isArray(args.tags) ? args.tags.filter((x) => typeof x === "string") : void 0,
-          dueAt: typeof args.dueAt === "string" ? args.dueAt : void 0
-        });
-      case "engram.work_project":
-        return this.service.workProject({
-          action: args.action ?? "list",
-          id: typeof args.id === "string" ? args.id : void 0,
-          name: typeof args.name === "string" ? args.name : void 0,
-          description: typeof args.description === "string" ? args.description : void 0,
-          status: typeof args.status === "string" ? args.status : void 0,
-          owner: typeof args.owner === "string" ? args.owner : void 0,
-          tags: Array.isArray(args.tags) ? args.tags.filter((x) => typeof x === "string") : void 0,
-          taskId: typeof args.taskId === "string" ? args.taskId : void 0,
-          projectId: typeof args.projectId === "string" ? args.projectId : void 0
-        });
-      case "engram.work_board":
-        return this.service.workBoard({
-          action: args.action ?? "export_markdown",
-          projectId: typeof args.projectId === "string" ? args.projectId : void 0,
-          snapshotJson: typeof args.snapshotJson === "string" ? args.snapshotJson : void 0,
-          linkToMemory: args.linkToMemory === true
-        });
-      // ── Shared Context / Compounding tools ─────────────────────────
-      case "engram.shared_context_write_output":
-        return this.service.sharedContextWriteOutput({
-          agentId: typeof args.agentId === "string" ? args.agentId : "",
-          title: typeof args.title === "string" ? args.title : "",
-          content: typeof args.content === "string" ? args.content : ""
-        });
-      case "engram.shared_feedback_record":
-        return this.service.sharedFeedbackRecord({
-          agent: typeof args.agent === "string" ? args.agent : "",
-          decision: args.decision ?? "approved",
-          reason: typeof args.reason === "string" ? args.reason : "",
-          date: typeof args.date === "string" ? args.date : void 0,
-          learning: typeof args.learning === "string" ? args.learning : void 0,
-          outcome: typeof args.outcome === "string" ? args.outcome : void 0,
-          severity: args.severity === "low" || args.severity === "medium" || args.severity === "high" ? args.severity : void 0,
-          confidence: typeof args.confidence === "number" ? args.confidence : void 0,
-          workflow: typeof args.workflow === "string" ? args.workflow : void 0,
-          tags: Array.isArray(args.tags) ? args.tags.filter((x) => typeof x === "string") : void 0,
-          evidenceWindowStart: typeof args.evidenceWindowStart === "string" ? args.evidenceWindowStart : void 0,
-          evidenceWindowEnd: typeof args.evidenceWindowEnd === "string" ? args.evidenceWindowEnd : void 0,
-          refs: Array.isArray(args.refs) ? args.refs.filter((x) => typeof x === "string") : void 0
-        });
-      case "engram.shared_priorities_append":
-        return this.service.sharedPrioritiesAppend({
-          agentId: typeof args.agentId === "string" ? args.agentId : "",
-          text: typeof args.text === "string" ? args.text : ""
-        });
-      case "engram.shared_context_cross_signals_run":
-        return this.service.sharedContextCrossSignalsRun({
-          date: typeof args.date === "string" ? args.date : void 0
-        });
-      case "engram.shared_context_curate_daily":
-        return this.service.sharedContextCurateDaily({
-          date: typeof args.date === "string" ? args.date : void 0
-        });
-      case "engram.compounding_weekly_synthesize":
-        return this.service.compoundingWeeklySynthesize({
-          weekId: typeof args.weekId === "string" ? args.weekId : void 0
-        });
-      case "engram.compounding_promote_candidate":
-        return this.service.compoundingPromoteCandidate({
-          weekId: typeof args.weekId === "string" ? args.weekId : "",
-          candidateId: typeof args.candidateId === "string" ? args.candidateId : "",
-          dryRun: args.dryRun === true
-        });
-      // ── Compression Guidelines tools ───────────────────────────────────
-      case "engram.compression_guidelines_optimize":
-        return this.service.compressionGuidelinesOptimize({
-          dryRun: args.dryRun === true,
-          eventLimit: typeof args.eventLimit === "number" ? args.eventLimit : void 0
-        });
-      case "engram.compression_guidelines_activate":
-        return this.service.compressionGuidelinesActivate({
-          expectedContentHash: typeof args.expectedContentHash === "string" ? args.expectedContentHash : void 0,
-          expectedGuidelineVersion: typeof args.expectedGuidelineVersion === "number" ? args.expectedGuidelineVersion : void 0
-        });
-      // ── Memory search & debug tools ──────────────────────────────────
-      case "engram.memory_profile":
-        return this.service.memoryProfile(
-          typeof args.namespace === "string" ? args.namespace : void 0,
-          effectivePrincipal
-        );
-      case "engram.memory_entities_list":
-        return this.service.memoryEntitiesList(
-          typeof args.namespace === "string" ? args.namespace : void 0,
-          effectivePrincipal
-        );
-      case "engram.memory_questions":
-        return this.service.memoryQuestions(
-          typeof args.namespace === "string" ? args.namespace : void 0,
-          effectivePrincipal
-        );
-      case "engram.memory_last_recall":
-        return this.service.lastRecallSnapshot(
-          typeof args.sessionKey === "string" ? args.sessionKey : void 0
-        );
-      case "engram.memory_intent_debug":
-        return this.service.intentDebug(
-          typeof args.namespace === "string" ? args.namespace : void 0
-        );
-      case "engram.memory_qmd_debug":
-        return this.service.qmdDebug(
-          typeof args.namespace === "string" ? args.namespace : void 0
-        );
-      case "engram.memory_graph_explain":
-        return this.service.graphExplainLastRecall(
-          typeof args.namespace === "string" ? args.namespace : void 0
-        );
-      case "engram.graph_snapshot": {
-        if (args.limit !== void 0 && typeof args.limit !== "number") {
-          throw new Error("engram.graph_snapshot: limit must be a number");
-        }
-        if (args.since !== void 0 && typeof args.since !== "string") {
-          throw new Error("engram.graph_snapshot: since must be a string");
-        }
-        if (args.focusNodeId !== void 0 && typeof args.focusNodeId !== "string") {
-          throw new Error("engram.graph_snapshot: focusNodeId must be a string");
-        }
-        let categories;
-        if (args.categories !== void 0) {
-          if (!Array.isArray(args.categories)) {
-            throw new Error(
-              "engram.graph_snapshot: categories must be an array of strings"
-            );
-          }
-          categories = args.categories.map((value, index) => {
-            if (typeof value !== "string") {
-              throw new Error(
-                `engram.graph_snapshot: categories[${index}] must be a string`
-              );
-            }
-            return value;
-          });
-        }
-        return this.service.graphSnapshot(
-          {
-            namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-            limit: typeof args.limit === "number" ? args.limit : void 0,
-            since: typeof args.since === "string" ? args.since : void 0,
-            focusNodeId: typeof args.focusNodeId === "string" ? args.focusNodeId : void 0,
-            ...categories !== void 0 ? { categories } : {}
-          },
-          effectivePrincipal
-        );
-      }
-      case "engram.memory_feedback":
-        return this.service.memoryFeedback({
-          memoryId: typeof args.memoryId === "string" ? args.memoryId : "",
-          vote: args.vote === "down" ? "down" : "up",
-          note: typeof args.note === "string" ? args.note : void 0
-        });
-      case "engram.memory_promote":
-        return this.service.memoryPromote({
-          memoryId: typeof args.memoryId === "string" ? args.memoryId : "",
-          namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-          principal: effectivePrincipal,
-          sessionKey: typeof args.sessionKey === "string" ? args.sessionKey : void 0
-        });
-      case "engram.memory_outcome": {
-        const outcome = args.outcome;
-        if (outcome !== "success" && outcome !== "failure") {
-          throw new Error(
-            `engram.memory_outcome: outcome must be "success" or "failure"; got ${JSON.stringify(outcome)}`
-          );
-        }
-        return this.service.memoryOutcome({
-          memoryId: typeof args.memoryId === "string" ? args.memoryId : "",
-          outcome,
-          namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-          principal: effectivePrincipal,
-          sessionKey: typeof args.sessionKey === "string" ? args.sessionKey : void 0,
-          timestamp: typeof args.timestamp === "string" ? args.timestamp : void 0
-        });
-      }
-      case "engram.memory_action_apply":
-        return this.service.memoryActionApply({
-          action: typeof args.action === "string" ? args.action : "",
-          outcome: typeof args.outcome === "string" ? args.outcome : void 0,
-          reason: typeof args.reason === "string" ? args.reason : void 0,
-          memoryId: typeof args.memoryId === "string" ? args.memoryId : void 0,
-          namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-          principal: effectivePrincipal,
-          sessionKey: typeof args.sessionKey === "string" ? args.sessionKey : void 0,
-          content: typeof args.content === "string" ? args.content : void 0,
-          category: typeof args.category === "string" ? args.category : void 0,
-          linkTargetId: typeof args.linkTargetId === "string" ? args.linkTargetId : void 0,
-          linkType: typeof args.linkType === "string" ? args.linkType : void 0,
-          linkStrength: typeof args.linkStrength === "number" ? args.linkStrength : void 0,
-          artifactType: typeof args.artifactType === "string" ? args.artifactType : void 0,
-          execute: typeof args.execute === "boolean" ? args.execute : void 0,
-          sourcePrompt: typeof args.sourcePrompt === "string" ? args.sourcePrompt : void 0,
-          dryRun: args.dryRun === true
-        });
-      case "engram.context_checkpoint":
-        return this.service.contextCheckpoint({
-          sessionKey: typeof args.sessionKey === "string" ? args.sessionKey : "",
-          context: typeof args.context === "string" ? args.context : "",
-          namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-          principal: effectivePrincipal
-        });
-      // ── Daily Context Briefing (#370) ───────────────────────────────────
-      case "engram.briefing": {
-        const rawFormat = typeof args.format === "string" ? args.format : void 0;
-        const formatErr = validateBriefingFormat(rawFormat);
-        if (formatErr) throw new Error(formatErr);
-        return this.service.briefing({
-          since: typeof args.since === "string" ? args.since : void 0,
-          focus: typeof args.focus === "string" ? args.focus : void 0,
-          namespace: typeof args.namespace === "string" ? args.namespace : void 0,
-          format: rawFormat,
-          maxFollowups: typeof args.maxFollowups === "number" ? args.maxFollowups : void 0,
-          principal: effectivePrincipal
-        });
-      }
-      // ── Contradiction Review (issue #520) ──────────────────────────────────
-      case "engram.review_list":
-      case "remnic.review_list": {
-        const {
-          isDefaultReviewNamespace,
-          listPairs
-        } = await import("./contradiction-review-QKJH5DKD.js");
-        const VALID_REVIEW_FILTERS = /* @__PURE__ */ new Set(["all", "unresolved", "contradicts", "independent", "duplicates", "needs-user"]);
-        const rawFilter = typeof args.filter === "string" ? args.filter : "unresolved";
-        if (!VALID_REVIEW_FILTERS.has(rawFilter)) {
-          throw new Error(`Invalid filter '${rawFilter}'. Valid: ${[...VALID_REVIEW_FILTERS].join(", ")}`);
-        }
-        const filter = rawFilter;
-        const ns = typeof args.namespace === "string" ? args.namespace : void 0;
-        const limit = typeof args.limit === "number" ? args.limit : 50;
-        const resolved = await this.service.getReadableStorageForNamespace(ns, effectivePrincipal);
-        const reviewNamespace = this.service.configRef.namespacesEnabled ? resolved.namespace : void 0;
-        const includeUnscopedForNamespace = Boolean(
-          reviewNamespace && isDefaultReviewNamespace(this.service.configRef.defaultNamespace, ns, reviewNamespace)
-        );
-        return listPairs(this.service.memoryDir, {
-          filter,
-          namespace: reviewNamespace,
-          includeUnscopedForNamespace,
-          limit
-        });
-      }
-      case "engram.review_resolve":
-      case "remnic.review_resolve": {
-        const pairId = typeof args.pairId === "string" ? args.pairId : "";
-        const verb = typeof args.verb === "string" ? args.verb : "";
-        if (!pairId) throw new Error("pairId is required");
-        if (!verb) throw new Error("verb is required");
-        const { isValidResolutionVerb } = await import("./resolution-MN36NW5P.js");
-        if (!isValidResolutionVerb(verb)) throw new Error(`Invalid verb: ${verb}. Must be one of: keep-a, keep-b, merge, both-valid, needs-more-context`);
-        const { executeResolution } = await import("./resolution-MN36NW5P.js");
-        return executeResolution(this.service.memoryDir, this.service.storageRef, pairId, verb, {
-          mergedMemoryId: typeof args.mergedMemoryId === "string" ? args.mergedMemoryId : void 0,
-          mergedContent: typeof args.mergedContent === "string" ? args.mergedContent : void 0,
-          storageForNamespace: async (namespace) => {
-            const resolved = await this.service.getWritableStorageForNamespace(namespace, effectivePrincipal);
-            return resolved.storage;
-          },
-          // Catalog write touch (issue #1499 sweep): a contradiction merge writes
-          // a new memory directly to the resolved namespace storage, bypassing the
-          // extraction write path. Record it so QMD maintenance / writtenSince
-          // don't miss the write. Best-effort and failure-tolerant.
-          onMergedMemoryWritten: (namespace, storageDir) => {
-          }
-        });
-      }
-      case "engram.contradiction_scan_run":
-      case "remnic.contradiction_scan_run": {
-        const { runContradictionScan } = await import("./contradiction-scan-HWGEOUDS.js");
-        return runContradictionScan({
-          storage: this.service.storageRef,
-          config: this.service.configRef,
-          memoryDir: this.service.memoryDir,
-          embeddingLookupFactory: this.service.embeddingLookupFactoryRef,
-          storageForNamespace: (namespace) => this.service.getWritableStorageForNamespace(namespace, effectivePrincipal),
-          localLlm: this.service.localLlmRef,
-          fallbackLlm: this.service.fallbackLlmRef,
-          namespace: typeof args.namespace === "string" ? args.namespace : void 0
-        });
-      }
-      case "engram.memory_summarize_hourly":
-      case "remnic.memory_summarize_hourly":
-        return this.service.memorySummarizeHourly();
-      case "engram.conversation_index_update":
-      case "remnic.conversation_index_update": {
-        if ("sessionKey" in args && args.sessionKey !== void 0 && typeof args.sessionKey !== "string") {
-          throw new Error("sessionKey must be a string when provided");
-        }
-        const sessionKey = typeof args.sessionKey === "string" ? args.sessionKey : void 0;
-        return this.service.conversationIndexUpdate({
-          sessionKey,
-          hours: typeof args.hours === "number" && Number.isFinite(args.hours) ? args.hours : void 0,
-          embed: typeof args.embed === "boolean" ? args.embed : void 0
-        });
-      }
-      case "engram.profiling_report":
-      case "remnic.profiling_report": {
-        if ("format" in args && args.format !== void 0 && typeof args.format !== "string") {
-          throw new EngramAccessInputError("format must be a string when provided");
-        }
-        if ("limit" in args && args.limit !== void 0 && typeof args.limit !== "number") {
-          throw new EngramAccessInputError("limit must be a number when provided");
-        }
-        return this.service.profilingReport({
-          format: typeof args.format === "string" ? args.format : void 0,
-          limit: typeof args.limit === "number" ? args.limit : void 0
-        });
-      }
-      case "engram.graph_edge_decay_run":
-      case "remnic.graph_edge_decay_run": {
-        const cfg = this.service.configRef;
-        if (!cfg.graphEdgeDecayEnabled) {
-          return {
-            ranAt: (/* @__PURE__ */ new Date()).toISOString(),
-            disabled: true,
-            reason: "graphEdgeDecayEnabled is false"
-          };
-        }
-        const { runGraphEdgeDecayMaintenanceAcrossNamespaces } = await import("./graph-edge-decay-QPRJQ7DL.js");
-        const dryRun = args.dryRun === true;
-        const results = await runGraphEdgeDecayMaintenanceAcrossNamespaces(
-          this.service.memoryDir,
-          {
-            windowMs: cfg.graphEdgeDecayWindowMs,
-            perWindow: cfg.graphEdgeDecayPerWindow,
-            floor: cfg.graphEdgeDecayFloor,
-            visibilityThreshold: cfg.graphEdgeDecayVisibilityThreshold,
-            dryRun,
-            namespacesEnabled: cfg.namespacesEnabled === true,
-            defaultNamespace: cfg.defaultNamespace
-          }
-        );
-        return { results };
-      }
-      case "engram.live_connectors_run":
-      case "remnic.live_connectors_run":
-        return this.service.liveConnectorsRun(
-          {
-            authenticatedPrincipal: effectivePrincipal,
-            force: args.force === true
-          },
-          effectivePrincipal
-        );
-      // ── Peer Registry dispatchers (issue #679 PR 4/5) ─────────────────
-      case "engram.peer_list":
-      case "remnic.peer_list":
-        return this.service.peerList();
-      case "engram.peer_get":
-      case "remnic.peer_get": {
-        const id = typeof args.id === "string" ? args.id : "";
-        if (!id) throw new Error("engram.peer_get: id is required");
-        return this.service.peerGet(id);
+      if (chatResult && typeof chatResult === "object" && "error" in chatResult) {
+        const { error: _stripped, ...wireResult } = chatResult;
+        return wireResult;
       }
-      case "engram.peer_set":
-      case "remnic.peer_set": {
-        const id = typeof args.id === "string" ? args.id : "";
-        if (!id) throw new Error("engram.peer_set: id is required");
-        if (args.kind !== void 0 && typeof args.kind !== "string") {
-          throw new Error("engram.peer_set: kind must be a string when provided");
-        }
-        if (args.displayName !== void 0 && typeof args.displayName !== "string") {
-          throw new Error("engram.peer_set: displayName must be a string when provided");
-        }
-        if (args.notes !== void 0 && typeof args.notes !== "string") {
-          throw new Error("engram.peer_set: notes must be a string when provided");
-        }
-        return this.service.peerSet({
-          id,
-          kind: typeof args.kind === "string" ? args.kind : void 0,
-          displayName: typeof args.displayName === "string" ? args.displayName : void 0,
-          notes: typeof args.notes === "string" ? args.notes : void 0
-        });
-      }
-      case "engram.peer_delete":
-      case "remnic.peer_delete": {
-        const id = typeof args.id === "string" ? args.id : "";
-        if (!id) throw new Error("engram.peer_delete: id is required");
-        return this.service.peerDelete(id);
-      }
-      case "engram.peer_profile_get":
-      case "remnic.peer_profile_get": {
-        const id = typeof args.id === "string" ? args.id : "";
-        if (!id) throw new Error("engram.peer_profile_get: id is required");
-        return this.service.peerProfileGet(id);
-      }
-      case "engram.peer_forget":
-      case "remnic.peer_forget": {
-        const id = typeof args.id === "string" ? args.id : "";
-        if (!id) throw new Error("engram.peer_forget: id is required");
-        const confirm = typeof args.confirm === "string" ? args.confirm : "";
-        if (confirm !== "yes") {
-          throw new Error(
-            "engram.peer_forget: confirm must be 'yes' to prevent accidental data loss"
-          );
-        }
-        return this.service.peerForget(id, { confirm: "yes" });
-      }
-      // ── Operator Console state (issue #688 PR 2/3) ──────────────────────────
-      case "engram.console_state":
-      case "remnic.console_state":
-        return this.service.consoleState(
-          typeof args.namespace === "string" ? args.namespace : void 0,
-          effectivePrincipal
-        );
-      // ── Dreams telemetry (issue #678 PR 3+4) ──────────────────────────────
-      case "engram.dreams_status":
-      case "remnic.dreams_status": {
-        const { normalizeDreamsStatusWindowHours } = await import("./dreams-ledger-3WSCI5V4.js");
-        let windowHours = 24;
-        try {
-          windowHours = normalizeDreamsStatusWindowHours(args.windowHours);
-        } catch {
-          throw new Error(
-            `engram.dreams_status: windowHours must be a positive integer (e.g. 24). Got: ${String(args.windowHours)}`
-          );
-        }
-        if ("namespace" in args && args.namespace !== void 0 && typeof args.namespace !== "string") {
-          throw new Error("engram.dreams_status: namespace must be a string when provided");
-        }
-        const namespace = typeof args.namespace === "string" ? args.namespace : void 0;
-        return this.service.dreamsStatus({
-          windowHours,
-          namespace,
-          principal: effectivePrincipal
-        });
-      }
-      case "engram.dreams_run":
-      case "remnic.dreams_run": {
-        const VALID_PHASES = ["lightSleep", "rem", "deepSleep"];
-        const phase = typeof args.phase === "string" ? args.phase : "";
-        if (!phase || !VALID_PHASES.includes(phase)) {
-          throw new Error(
-            `engram.dreams_run: phase is required and must be one of: ${VALID_PHASES.join(", ")}`
-          );
-        }
-        if ("dryRun" in args && args.dryRun !== void 0 && typeof args.dryRun !== "boolean") {
-          throw new Error("engram.dreams_run: dryRun must be a boolean when provided");
-        }
-        if ("namespace" in args && args.namespace !== void 0 && typeof args.namespace !== "string") {
-          throw new Error("engram.dreams_run: namespace must be a string when provided");
-        }
-        const namespace = typeof args.namespace === "string" ? args.namespace : void 0;
-        const dryRun = args.dryRun === true;
-        return this.service.dreamsRun({
-          phase,
-          dryRun,
-          namespace,
-          authenticatedPrincipal: effectivePrincipal
-        });
-      }
-      case "engram.memory_chat": {
-        const message = typeof args.message === "string" ? args.message : "";
-        if (!message) {
-          throw new EngramAccessInputError("message is required");
-        }
-        const chatSessionId = typeof args.chatSessionId === "string" ? args.chatSessionId : void 0;
-        const chatResult = await processChatMessage({
-          service: this.service,
-          config: this.service.configRef?.chat,
-          memoryDir: this.service.memoryDir,
-          message,
-          ...chatSessionId ? { chatSessionId } : {},
-          ...effectivePrincipal ? { principal: effectivePrincipal } : {},
-          ...scope?.namespace ? { namespace: scope.namespace } : {},
-          ...scope?.sessionKey ? { sessionKey: scope.sessionKey } : {}
-        });
-        if (chatResult && typeof chatResult === "object" && "error" in chatResult) {
-          const { error: _stripped, ...wireResult } = chatResult;
-          return wireResult;
+      return chatResult;
+    } else {
+      envelope = args;
+    }
+    if (migrated === "recall") {
+      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 chatResult;
       }
-      default:
-        throw new Error(`unknown tool: ${name}`);
+      return response;
     }
+    const output = await op.run(envelope, {
+      service: this.service,
+      authenticatedPrincipal: effectivePrincipal,
+      ...enforceWriteQuota ? { hooks: { enforceWriteQuota } } : {}
+    });
+    return output.result;
   }
 };
 
@@ -4441,4 +3528,4 @@ export {
   sessionBelongsToPrincipal,
   EngramMcpServer
 };
-//# sourceMappingURL=chunk-B7WISIAJ.js.map
+//# sourceMappingURL=chunk-FN6QP7JQ.js.map