@remnic/core 9.69.42 → 9.69.44

package/dist/{chunk-JMAP6L6Q.js → chunk-KDLOKVX7.js}

@@ -1,6 +1,6 @@
 import {
   listNamespaces
-} from "./chunk-AHHFBJX7.js";
+} from "./chunk-JDL5BYYF.js";
 import {
   capabilityAllowsNamespace
 } from "./chunk-MZWSOLMT.js";
@@ -282,4 +282,4 @@ export {
   computeServiceCorpusWatermarks,
   computeServiceCorpusCensus
 };
-//# sourceMappingURL=chunk-JMAP6L6Q.js.map
+//# sourceMappingURL=chunk-KDLOKVX7.js.map

package/dist/chunk-KIW3OOZE.js

@@ -0,0 +1,39 @@
+// src/recall-navigation-renderer.ts
+function renderNavigationResult(result) {
+  if (!result.ok) {
+    return ["# Memory navigation", "", `- error: ${result.error}`, `- ${result.message}`, ""].join("\n");
+  }
+  const lines = ["# Memory navigation", ""];
+  lines.push(`- action: ${result.action}`);
+  lines.push(`- memory: ${result.memoryId}`);
+  lines.push(`- namespace: ${result.namespace}`);
+  if (result.items.length === 0) {
+    lines.push("- neighbors: (none)");
+  } else {
+    lines.push("");
+    for (const [index, item] of result.items.entries()) {
+      const via = item.linkType !== void 0 ? ` via ${item.linkType}` : "";
+      lines.push(`${index + 1}. **${item.memoryId}** (${item.disclosure}${via})`);
+      if (item.content !== void 0) {
+        lines.push(item.content);
+      } else {
+        lines.push(`   ${item.preview.replace(/\s+/g, " ").trim()}`);
+      }
+    }
+  }
+  lines.push("");
+  lines.push(
+    `- budget: ${result.budget.used}/${result.budget.chars} chars${result.truncated ? " (truncated)" : ""}`
+  );
+  const spend = result.disclosureSpend;
+  lines.push(
+    `- disclosure spend: chunk=${spend.chunk.estimatedTokens}t, section=${spend.section.estimatedTokens}t, raw=${spend.raw.estimatedTokens}t`
+  );
+  lines.push("");
+  return lines.join("\n");
+}
+
+export {
+  renderNavigationResult
+};
+//# sourceMappingURL=chunk-KIW3OOZE.js.map

package/dist/chunk-KIW3OOZE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-navigation-renderer.ts"],"sourcesContent":["/**\n * Shared markdown renderer for recall navigation (issue #1956).\n *\n * Rule 22: CLI text output, MCP `rendered`, and HTTP human output all\n * render through this one module — never forked per surface.\n * Deterministic: items in result order, budget and disclosure spend last.\n */\n\nimport type { RecallNavigationResult } from \"./recall-navigation.js\";\n\ntype NavigationRenderInput = RecallNavigationResult extends infer Result\n  ? Result extends { rendered: string }\n    ? Omit<Result, \"rendered\">\n    : never\n  : never;\n\nexport function renderNavigationResult(result: NavigationRenderInput): string {\n  if (!result.ok) {\n    return [\"# Memory navigation\", \"\", `- error: ${result.error}`, `- ${result.message}`, \"\"].join(\"\\n\");\n  }\n  const lines = [\"# Memory navigation\", \"\"];\n  lines.push(`- action: ${result.action}`);\n  lines.push(`- memory: ${result.memoryId}`);\n  lines.push(`- namespace: ${result.namespace}`);\n  if (result.items.length === 0) {\n    lines.push(\"- neighbors: (none)\");\n  } else {\n    lines.push(\"\");\n    for (const [index, item] of result.items.entries()) {\n      const via = item.linkType !== undefined ? ` via ${item.linkType}` : \"\";\n      lines.push(`${index + 1}. **${item.memoryId}** (${item.disclosure}${via})`);\n      if (item.content !== undefined) {\n        lines.push(item.content);\n      } else {\n        lines.push(`   ${item.preview.replace(/\\s+/g, \" \").trim()}`);\n      }\n    }\n  }\n  lines.push(\"\");\n  lines.push(\n    `- budget: ${result.budget.used}/${result.budget.chars} chars${result.truncated ? \" (truncated)\" : \"\"}`,\n  );\n  const spend = result.disclosureSpend;\n  lines.push(\n    `- disclosure spend: chunk=${spend.chunk.estimatedTokens}t, section=${spend.section.estimatedTokens}t, raw=${spend.raw.estimatedTokens}t`,\n  );\n  lines.push(\"\");\n  return lines.join(\"\\n\");\n}\n"],"mappings":";AAgBO,SAAS,uBAAuB,QAAuC;AAC5E,MAAI,CAAC,OAAO,IAAI;AACd,WAAO,CAAC,uBAAuB,IAAI,YAAY,OAAO,KAAK,IAAI,KAAK,OAAO,OAAO,IAAI,EAAE,EAAE,KAAK,IAAI;AAAA,EACrG;AACA,QAAM,QAAQ,CAAC,uBAAuB,EAAE;AACxC,QAAM,KAAK,aAAa,OAAO,MAAM,EAAE;AACvC,QAAM,KAAK,aAAa,OAAO,QAAQ,EAAE;AACzC,QAAM,KAAK,gBAAgB,OAAO,SAAS,EAAE;AAC7C,MAAI,OAAO,MAAM,WAAW,GAAG;AAC7B,UAAM,KAAK,qBAAqB;AAAA,EAClC,OAAO;AACL,UAAM,KAAK,EAAE;AACb,eAAW,CAAC,OAAO,IAAI,KAAK,OAAO,MAAM,QAAQ,GAAG;AAClD,YAAM,MAAM,KAAK,aAAa,SAAY,QAAQ,KAAK,QAAQ,KAAK;AACpE,YAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,KAAK,QAAQ,OAAO,KAAK,UAAU,GAAG,GAAG,GAAG;AAC1E,UAAI,KAAK,YAAY,QAAW;AAC9B,cAAM,KAAK,KAAK,OAAO;AAAA,MACzB,OAAO;AACL,cAAM,KAAK,MAAM,KAAK,QAAQ,QAAQ,QAAQ,GAAG,EAAE,KAAK,CAAC,EAAE;AAAA,MAC7D;AAAA,IACF;AAAA,EACF;AACA,QAAM,KAAK,EAAE;AACb,QAAM;AAAA,IACJ,aAAa,OAAO,OAAO,IAAI,IAAI,OAAO,OAAO,KAAK,SAAS,OAAO,YAAY,iBAAiB,EAAE;AAAA,EACvG;AACA,QAAM,QAAQ,OAAO;AACrB,QAAM;AAAA,IACJ,6BAA6B,MAAM,MAAM,eAAe,cAAc,MAAM,QAAQ,eAAe,UAAU,MAAM,IAAI,eAAe;AAAA,EACxI;AACA,QAAM,KAAK,EAAE;AACb,SAAO,MAAM,KAAK,IAAI;AACxB;","names":[]}

package/dist/{chunk-HK44SV6K.js → chunk-KORQWGUA.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-PIWFNPQT.js";
 import {
   StorageManager
-} from "./chunk-I65KB36L.js";
+} from "./chunk-GMU7MAHS.js";
 import {
   projectProceduresToSkills
 } from "./chunk-236PXYG7.js";
@@ -134,4 +134,4 @@ export {
   runCodexMaterialize,
   runPostConsolidationMaterialize
 };
-//# sourceMappingURL=chunk-HK44SV6K.js.map
+//# sourceMappingURL=chunk-KORQWGUA.js.map

package/dist/{chunk-VDX2J7OX.js → chunk-KQAFEZQX.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-WEHSQBFR.js";
 import {
   encryptCapsuleFile
-} from "./chunk-DQEMWVMT.js";
+} from "./chunk-X7Y7WX73.js";
 import {
   CAPSULE_SCHEMA_VERSION,
   EXPORT_FORMAT
@@ -261,4 +261,4 @@ export {
   exportCapsule,
   isValidCapsuleSince
 };
-//# sourceMappingURL=chunk-VDX2J7OX.js.map
+//# sourceMappingURL=chunk-KQAFEZQX.js.map

package/dist/{chunk-4IGOLIWM.js → chunk-L63M2PE4.js}

@@ -1,6 +1,6 @@
 import {
   RECALL_DISCLOSURE_LEVELS
-} from "./chunk-WN2OXGGH.js";
+} from "./chunk-66YUOI53.js";
 
 // src/recall-navigate.ts
 var RECALL_NAV_LINK_TYPES = [
@@ -48,4 +48,4 @@ export {
   expandRecallNode,
   traverseRecallLink
 };
-//# sourceMappingURL=chunk-4IGOLIWM.js.map
+//# sourceMappingURL=chunk-L63M2PE4.js.map

package/dist/{chunk-BIANISES.js → chunk-LD22AAJI.js}

@@ -1,6 +1,6 @@
 import {
   runLocationSync
-} from "./chunk-AOGICQMH.js";
+} from "./chunk-PF7LQ22G.js";
 import {
   log
 } from "./chunk-3WCASNQZ.js";
@@ -58,4 +58,4 @@ export {
   LOCATION_SYNC_DEFAULT_INTERVAL_MS,
   startLocationAutoSync
 };
-//# sourceMappingURL=chunk-BIANISES.js.map
+//# sourceMappingURL=chunk-LD22AAJI.js.map

package/dist/chunk-LVTT5AUG.js

@@ -0,0 +1,79 @@
+import {
+  coerceBool,
+  coerceNumber
+} from "./chunk-PQVCH2AE.js";
+
+// src/recall-navigation-config.ts
+var DEFAULT_NAVIGATION_WINDOW_SNAPSHOTS = 3;
+var RECALL_NAVIGATION_CONFIG_DEFAULTS = {
+  enabled: true,
+  windowSnapshots: DEFAULT_NAVIGATION_WINDOW_SNAPSHOTS,
+  maxNeighbors: 10
+};
+function shouldRecordRecallAuthorityHistory(config) {
+  return config.recallMemoryHandles === true || config.recallNavigation?.enabled === true;
+}
+function parseFlag(src, key, fallback) {
+  const value = src[key];
+  if (value === void 0 || value === null) return fallback;
+  const coerced = coerceBool(value);
+  if (coerced === void 0) {
+    throw new Error(
+      `recallNavigation.${key} must be a boolean (or "true"/"false"/"1"/"0"); got ${JSON.stringify(value)}`
+    );
+  }
+  return coerced;
+}
+function parseBoundedInt(src, key, fallback, min, max) {
+  const value = src[key];
+  if (value === void 0 || value === null) return fallback;
+  const coerced = coerceNumber(value);
+  if (coerced === void 0 || !Number.isFinite(coerced) || !Number.isInteger(coerced)) {
+    throw new Error(
+      `recallNavigation.${key} must be an integer between ${min} and ${max}; got ${JSON.stringify(value)}`
+    );
+  }
+  if (coerced < min || coerced > max) {
+    throw new Error(
+      `recallNavigation.${key} must be an integer between ${min} and ${max}; got ${JSON.stringify(value)}`
+    );
+  }
+  return coerced;
+}
+function parseRecallNavigationConfig(raw) {
+  if (raw === void 0 || raw === null) return { ...RECALL_NAVIGATION_CONFIG_DEFAULTS };
+  if (typeof raw !== "object" || Array.isArray(raw)) {
+    throw new Error(`recallNavigation must be an object; got ${JSON.stringify(raw)}`);
+  }
+  const src = raw;
+  const { enabled: _enabled, windowSnapshots: _windowSnapshots, maxNeighbors: _maxNeighbors, ...unknown } = src;
+  const unknownKey = Object.keys(unknown)[0];
+  if (unknownKey !== void 0) {
+    throw new Error(`recallNavigation contains unknown key ${JSON.stringify(unknownKey)}`);
+  }
+  return {
+    enabled: parseFlag(src, "enabled", RECALL_NAVIGATION_CONFIG_DEFAULTS.enabled),
+    windowSnapshots: parseBoundedInt(
+      src,
+      "windowSnapshots",
+      RECALL_NAVIGATION_CONFIG_DEFAULTS.windowSnapshots,
+      1,
+      50
+    ),
+    maxNeighbors: parseBoundedInt(
+      src,
+      "maxNeighbors",
+      RECALL_NAVIGATION_CONFIG_DEFAULTS.maxNeighbors,
+      1,
+      50
+    )
+  };
+}
+
+export {
+  DEFAULT_NAVIGATION_WINDOW_SNAPSHOTS,
+  RECALL_NAVIGATION_CONFIG_DEFAULTS,
+  shouldRecordRecallAuthorityHistory,
+  parseRecallNavigationConfig
+};
+//# sourceMappingURL=chunk-LVTT5AUG.js.map

package/dist/chunk-LVTT5AUG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-navigation-config.ts"],"sourcesContent":["/**\n * Recall-navigation config (issue #1956) — the `recallNavigation` block.\n *\n * Parsed the same way `deepRecall` is: shape-validated, string-coercion\n * safe (§24), no silent clamping of documented values (§33). Navigation is\n * a read-only surface over already-served recall results, so it defaults\n * ON; the `conservative` preset pins `enabled: false`.\n */\n\nimport { coerceBool, coerceNumber } from \"./connectors/coerce.js\";\n\nexport interface RecallNavigationConfig {\n  /** Master switch. Default true (read-only, additive surface). */\n  enabled: boolean;\n  /**\n   * How many of the session's most recent recall snapshots an expandable\n   * or traversable id may come from. Default 3.\n   */\n  windowSnapshots: number;\n  /** Ceiling for a traverse/entity-neighbor limit override. Default 10. */\n  maxNeighbors: number;\n}\n\nexport interface RecallNavigationSettings {\n  recallNavigation: RecallNavigationConfig;\n}\n\nexport const DEFAULT_NAVIGATION_WINDOW_SNAPSHOTS = 3;\n\nexport const RECALL_NAVIGATION_CONFIG_DEFAULTS: RecallNavigationConfig = {\n  enabled: true,\n  windowSnapshots: DEFAULT_NAVIGATION_WINDOW_SNAPSHOTS,\n  maxNeighbors: 10,\n};\n\n/** Record served ids when display handles or navigation authority needs them. */\nexport function shouldRecordRecallAuthorityHistory(config: {\n  recallMemoryHandles?: boolean;\n  recallNavigation?: { enabled?: boolean };\n}): boolean {\n  return config.recallMemoryHandles === true || config.recallNavigation?.enabled === true;\n}\n\nfunction parseFlag(src: Record<string, unknown>, key: string, fallback: boolean): boolean {\n  const value = src[key];\n  if (value === undefined || value === null) return fallback;\n  const coerced = coerceBool(value);\n  if (coerced === undefined) {\n    throw new Error(\n      `recallNavigation.${key} must be a boolean (or \"true\"/\"false\"/\"1\"/\"0\"); got ${JSON.stringify(value)}`,\n    );\n  }\n  return coerced;\n}\n\nfunction parseBoundedInt(\n  src: Record<string, unknown>,\n  key: string,\n  fallback: number,\n  min: number,\n  max: number,\n): number {\n  const value = src[key];\n  if (value === undefined || value === null) return fallback;\n  const coerced = coerceNumber(value);\n  if (coerced === undefined || !Number.isFinite(coerced) || !Number.isInteger(coerced)) {\n    throw new Error(\n      `recallNavigation.${key} must be an integer between ${min} and ${max}; got ${JSON.stringify(value)}`,\n    );\n  }\n  if (coerced < min || coerced > max) {\n    throw new Error(\n      `recallNavigation.${key} must be an integer between ${min} and ${max}; got ${JSON.stringify(value)}`,\n    );\n  }\n  return coerced;\n}\n\nexport function parseRecallNavigationConfig(raw: unknown): RecallNavigationConfig {\n  if (raw === undefined || raw === null) return { ...RECALL_NAVIGATION_CONFIG_DEFAULTS };\n  if (typeof raw !== \"object\" || Array.isArray(raw)) {\n    throw new Error(`recallNavigation must be an object; got ${JSON.stringify(raw)}`);\n  }\n  const src = raw as Record<string, unknown>;\n  const { enabled: _enabled, windowSnapshots: _windowSnapshots, maxNeighbors: _maxNeighbors, ...unknown } = src;\n  const unknownKey = Object.keys(unknown)[0];\n  if (unknownKey !== undefined) {\n    throw new Error(`recallNavigation contains unknown key ${JSON.stringify(unknownKey)}`);\n  }\n  return {\n    enabled: parseFlag(src, \"enabled\", RECALL_NAVIGATION_CONFIG_DEFAULTS.enabled),\n    windowSnapshots: parseBoundedInt(\n      src,\n      \"windowSnapshots\",\n      RECALL_NAVIGATION_CONFIG_DEFAULTS.windowSnapshots,\n      1,\n      50,\n    ),\n    maxNeighbors: parseBoundedInt(\n      src,\n      \"maxNeighbors\",\n      RECALL_NAVIGATION_CONFIG_DEFAULTS.maxNeighbors,\n      1,\n      50,\n    ),\n  };\n}\n"],"mappings":";;;;;;AA2BO,IAAM,sCAAsC;AAE5C,IAAM,oCAA4D;AAAA,EACvE,SAAS;AAAA,EACT,iBAAiB;AAAA,EACjB,cAAc;AAChB;AAGO,SAAS,mCAAmC,QAGvC;AACV,SAAO,OAAO,wBAAwB,QAAQ,OAAO,kBAAkB,YAAY;AACrF;AAEA,SAAS,UAAU,KAA8B,KAAa,UAA4B;AACxF,QAAM,QAAQ,IAAI,GAAG;AACrB,MAAI,UAAU,UAAa,UAAU,KAAM,QAAO;AAClD,QAAM,UAAU,WAAW,KAAK;AAChC,MAAI,YAAY,QAAW;AACzB,UAAM,IAAI;AAAA,MACR,oBAAoB,GAAG,uDAAuD,KAAK,UAAU,KAAK,CAAC;AAAA,IACrG;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,gBACP,KACA,KACA,UACA,KACA,KACQ;AACR,QAAM,QAAQ,IAAI,GAAG;AACrB,MAAI,UAAU,UAAa,UAAU,KAAM,QAAO;AAClD,QAAM,UAAU,aAAa,KAAK;AAClC,MAAI,YAAY,UAAa,CAAC,OAAO,SAAS,OAAO,KAAK,CAAC,OAAO,UAAU,OAAO,GAAG;AACpF,UAAM,IAAI;AAAA,MACR,oBAAoB,GAAG,+BAA+B,GAAG,QAAQ,GAAG,SAAS,KAAK,UAAU,KAAK,CAAC;AAAA,IACpG;AAAA,EACF;AACA,MAAI,UAAU,OAAO,UAAU,KAAK;AAClC,UAAM,IAAI;AAAA,MACR,oBAAoB,GAAG,+BAA+B,GAAG,QAAQ,GAAG,SAAS,KAAK,UAAU,KAAK,CAAC;AAAA,IACpG;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,4BAA4B,KAAsC;AAChF,MAAI,QAAQ,UAAa,QAAQ,KAAM,QAAO,EAAE,GAAG,kCAAkC;AACrF,MAAI,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,GAAG;AACjD,UAAM,IAAI,MAAM,2CAA2C,KAAK,UAAU,GAAG,CAAC,EAAE;AAAA,EAClF;AACA,QAAM,MAAM;AACZ,QAAM,EAAE,SAAS,UAAU,iBAAiB,kBAAkB,cAAc,eAAe,GAAG,QAAQ,IAAI;AAC1G,QAAM,aAAa,OAAO,KAAK,OAAO,EAAE,CAAC;AACzC,MAAI,eAAe,QAAW;AAC5B,UAAM,IAAI,MAAM,yCAAyC,KAAK,UAAU,UAAU,CAAC,EAAE;AAAA,EACvF;AACA,SAAO;AAAA,IACL,SAAS,UAAU,KAAK,WAAW,kCAAkC,OAAO;AAAA,IAC5E,iBAAiB;AAAA,MACf;AAAA,MACA;AAAA,MACA,kCAAkC;AAAA,MAClC;AAAA,MACA;AAAA,IACF;AAAA,IACA,cAAc;AAAA,MACZ;AAAA,MACA;AAAA,MACA,kCAAkC;AAAA,MAClC;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/{chunk-RXYO6NA6.js → chunk-M6FKXOYV.js}

@@ -1,6 +1,6 @@
 import {
   parseFrontmatter
-} from "./chunk-I65KB36L.js";
+} from "./chunk-GMU7MAHS.js";
 import {
   activityDigestPath,
   isValidActivityDate
@@ -199,4 +199,4 @@ export {
   buildStandup,
   standupHelp
 };
-//# sourceMappingURL=chunk-RXYO6NA6.js.map
+//# sourceMappingURL=chunk-M6FKXOYV.js.map

package/dist/{chunk-LCVYO3ON.js → chunk-MOL7JK4F.js}

@@ -1,6 +1,6 @@
 import {
   StorageManager
-} from "./chunk-I65KB36L.js";
+} from "./chunk-GMU7MAHS.js";
 import {
   composeMemoryEnvelope
 } from "./chunk-GDYU6VF4.js";
@@ -546,4 +546,4 @@ export {
   setSemanticRulePromotionTestHooks,
   promoteSemanticRuleFromMemory
 };
-//# sourceMappingURL=chunk-LCVYO3ON.js.map
+//# sourceMappingURL=chunk-MOL7JK4F.js.map

package/dist/{chunk-VNQRRUNS.js → chunk-O6ZSWHVR.js}

@@ -25,8 +25,7 @@ function parseLocalLlmMaxContext(value) {
 function copyStringRecord(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
   const headers = {};
-  for (const key of Object.getOwnPropertyNames(value)) {
-    const headerValue = Reflect.get(value, key);
+  for (const [key, headerValue] of Object.entries(value)) {
     if (typeof headerValue === "string") headers[key] = headerValue;
   }
   return headers;
@@ -56,4 +55,4 @@ function parseLocalLlmConfig(cfg, localLlmApiKeyEnv, resolveEnvVars) {
 export {
   parseLocalLlmConfig
 };
-//# sourceMappingURL=chunk-VNQRRUNS.js.map
+//# sourceMappingURL=chunk-O6ZSWHVR.js.map

package/dist/chunk-O6ZSWHVR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/local-llm-config.ts"],"sourcesContent":["import { coerceNumber } from \"./connectors/coerce.js\";\nimport { parseBackgroundGeneration } from \"./background-generation-config.js\";\nimport type { BackgroundGenerationConfig } from \"./background-generation-config.js\";\nimport { readEnvVar } from \"./runtime/env.js\";\nimport { parseTaskLlmConfig } from \"./task-llm-config.js\";\nexport interface LocalLlmConfig {\n  // Local LLM Provider (v2.1)\n  localLlmEnabled: boolean;\n  localLlmUrl: string;\n  localLlmModel: string;\n  /** Optional API key for authenticated OpenAI-compatible endpoints. */\n  localLlmApiKey?: string;\n  /** Optional environment-variable name that supplies localLlmApiKey at runtime. */\n  localLlmApiKeyEnv?: string;\n  /** Additional headers for local/compatible endpoint requests. */\n  localLlmHeaders?: Record<string, string>;\n  /** If false, do not send Authorization header even when localLlmApiKey is set. */\n  localLlmAuthHeader: boolean;\n  localLlmFallback: boolean;\n  taskLlmFallback?: boolean;\n  /** Optional home directory override for local LLM helpers (LM Studio settings, CLI PATH). */\n  localLlmHomeDir?: string;\n  /** Optional absolute path to LMS CLI binary (preferred over auto-detection). */\n  localLmsCliPath?: string;\n  /** Optional bin directory prepended to PATH for LMS CLI execution. */\n  localLmsBinDir?: string;\n  /** Hard timeout for local LLM requests (ms). Legacy alias for the task-chain timeout when `taskLlmTimeoutMs` is absent. */\n  localLlmTimeoutMs: number;\n  /** Timeout for the gateway/task LLM chain (ms). */\n  taskLlmTimeoutMs?: number;\n  /** Max context window for local LLM (override auto-detection). Set lower if your LLM server defaults to smaller contexts. */\n  localLlmMaxContext?: number;\n}\n\nexport type LocalLlmParseResult = LocalLlmConfig & {\n  backgroundGeneration?: BackgroundGenerationConfig;\n};\n\n\nfunction parseLocalLlmMaxContext(value: unknown): number | undefined {\n  if (value === undefined || value === null) return undefined;\n  const coerced = coerceNumber(value);\n  if (\n    coerced === undefined ||\n    !Number.isFinite(coerced) ||\n    !Number.isInteger(coerced) ||\n    coerced < 1024\n  ) {\n    throw new Error(\n      `localLlmMaxContext must be an integer greater than or equal to 1024; got ${JSON.stringify(value)}`,\n    );\n  }\n  return coerced;\n}\n\nfunction copyStringRecord(value: unknown): Record<string, string> | undefined {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n  const headers: Record<string, string> = {};\n  for (const [key, headerValue] of Object.entries(value)) {\n    if (typeof headerValue === \"string\") headers[key] = headerValue;\n  }\n  return headers;\n}\n\nexport function parseLocalLlmConfig(\n  cfg: Record<string, unknown>,\n  localLlmApiKeyEnv: string | undefined,\n  resolveEnvVars: (value: string) => string,\n): LocalLlmParseResult {\n  const taskLlm = parseTaskLlmConfig(cfg);\n  return {\n    backgroundGeneration: parseBackgroundGeneration(cfg, resolveEnvVars),\n    localLlmEnabled: cfg.localLlmEnabled === true || cfg.localLlmEnabled === \"true\",\n    localLlmUrl:\n      typeof cfg.localLlmUrl === \"string\" && cfg.localLlmUrl.length > 0\n        ? cfg.localLlmUrl\n        : \"http://localhost:1234/v1\",\n    localLlmModel:\n      typeof cfg.localLlmModel === \"string\" && cfg.localLlmModel.length > 0\n        ? cfg.localLlmModel\n        : \"local-model\",\n    localLlmApiKey:\n      typeof cfg.localLlmApiKey === \"string\" && cfg.localLlmApiKey.length > 0\n        ? resolveEnvVars(cfg.localLlmApiKey)\n        : localLlmApiKeyEnv === undefined\n          ? undefined\n          : readEnvVar(localLlmApiKeyEnv),\n    localLlmApiKeyEnv,\n    localLlmHeaders: copyStringRecord(cfg.localLlmHeaders),\n    localLlmAuthHeader: cfg.localLlmAuthHeader !== false,\n    localLlmFallback: taskLlm.fallback,\n    taskLlmFallback: taskLlm.fallback,\n    localLlmHomeDir:\n      typeof cfg.localLlmHomeDir === \"string\" && cfg.localLlmHomeDir.length > 0\n        ? cfg.localLlmHomeDir\n        : undefined,\n    localLmsCliPath:\n      typeof cfg.localLmsCliPath === \"string\" && cfg.localLmsCliPath.length > 0\n        ? cfg.localLmsCliPath\n        : undefined,\n    localLmsBinDir:\n      typeof cfg.localLmsBinDir === \"string\" && cfg.localLmsBinDir.length > 0\n        ? cfg.localLmsBinDir\n        : undefined,\n    localLlmTimeoutMs: taskLlm.localTimeoutMs,\n    taskLlmTimeoutMs: taskLlm.timeoutMs,\n    localLlmMaxContext: parseLocalLlmMaxContext(cfg.localLlmMaxContext),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;AAuCA,SAAS,wBAAwB,OAAoC;AACnE,MAAI,UAAU,UAAa,UAAU,KAAM,QAAO;AAClD,QAAM,UAAU,aAAa,KAAK;AAClC,MACE,YAAY,UACZ,CAAC,OAAO,SAAS,OAAO,KACxB,CAAC,OAAO,UAAU,OAAO,KACzB,UAAU,MACV;AACA,UAAM,IAAI;AAAA,MACR,4EAA4E,KAAK,UAAU,KAAK,CAAC;AAAA,IACnG;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,iBAAiB,OAAoD;AAC5E,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,EAAG,QAAO;AACxE,QAAM,UAAkC,CAAC;AACzC,aAAW,CAAC,KAAK,WAAW,KAAK,OAAO,QAAQ,KAAK,GAAG;AACtD,QAAI,OAAO,gBAAgB,SAAU,SAAQ,GAAG,IAAI;AAAA,EACtD;AACA,SAAO;AACT;AAEO,SAAS,oBACd,KACA,mBACA,gBACqB;AACrB,QAAM,UAAU,mBAAmB,GAAG;AACtC,SAAO;AAAA,IACL,sBAAsB,0BAA0B,KAAK,cAAc;AAAA,IACnE,iBAAiB,IAAI,oBAAoB,QAAQ,IAAI,oBAAoB;AAAA,IACzE,aACE,OAAO,IAAI,gBAAgB,YAAY,IAAI,YAAY,SAAS,IAC5D,IAAI,cACJ;AAAA,IACN,eACE,OAAO,IAAI,kBAAkB,YAAY,IAAI,cAAc,SAAS,IAChE,IAAI,gBACJ;AAAA,IACN,gBACE,OAAO,IAAI,mBAAmB,YAAY,IAAI,eAAe,SAAS,IAClE,eAAe,IAAI,cAAc,IACjC,sBAAsB,SACpB,SACA,WAAW,iBAAiB;AAAA,IACpC;AAAA,IACA,iBAAiB,iBAAiB,IAAI,eAAe;AAAA,IACrD,oBAAoB,IAAI,uBAAuB;AAAA,IAC/C,kBAAkB,QAAQ;AAAA,IAC1B,iBAAiB,QAAQ;AAAA,IACzB,iBACE,OAAO,IAAI,oBAAoB,YAAY,IAAI,gBAAgB,SAAS,IACpE,IAAI,kBACJ;AAAA,IACN,iBACE,OAAO,IAAI,oBAAoB,YAAY,IAAI,gBAAgB,SAAS,IACpE,IAAI,kBACJ;AAAA,IACN,gBACE,OAAO,IAAI,mBAAmB,YAAY,IAAI,eAAe,SAAS,IAClE,IAAI,iBACJ;AAAA,IACN,mBAAmB,QAAQ;AAAA,IAC3B,kBAAkB,QAAQ;AAAA,IAC1B,oBAAoB,wBAAwB,IAAI,kBAAkB;AAAA,EACpE;AACF;","names":[]}

package/dist/chunk-OCX7OWOC.js

@@ -0,0 +1,95 @@
+import {
+  defineOperation
+} from "./chunk-3K64PLY3.js";
+import {
+  EngramAccessInputError
+} from "./chunk-2Z24E5W2.js";
+
+// src/recall-navigation-operations.ts
+import { z } from "zod";
+function stripNulls(data) {
+  if (data !== null && typeof data === "object" && !Array.isArray(data)) {
+    const obj = data;
+    const cleaned = {};
+    for (const [key, value] of Object.entries(obj)) {
+      if (value !== null) cleaned[key] = value;
+    }
+    return cleaned;
+  }
+  return data;
+}
+function strictSchema(shape) {
+  return z.preprocess(stripNulls, z.object(shape).passthrough());
+}
+var str = z.string().optional();
+function optStr(value) {
+  return typeof value === "string" ? value : void 0;
+}
+function optInt(value) {
+  if (typeof value === "number") return value;
+  if (typeof value === "string" && Number.isFinite(Number(value))) return Number(value);
+  return void 0;
+}
+function reqStr(value, field) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new EngramAccessInputError(`${field} is required`);
+  }
+  return value;
+}
+var baseShape = {
+  memoryId: z.string(),
+  sessionKey: z.string(),
+  namespace: str
+};
+defineOperation({
+  name: "memory_expand",
+  description: "Re-render one already-served recall result at a deeper disclosure level (chunk \u2192 section \u2192 raw).",
+  schema: strictSchema({ ...baseShape, disclosure: z.enum(["chunk", "section", "raw"]).optional() }),
+  handler: async (input, ctx) => {
+    const disclosure = optStr(input.disclosure);
+    return {
+      result: await ctx.service.recallNavigate({
+        action: "expand",
+        memoryId: reqStr(input.memoryId, "memoryId"),
+        sessionKey: reqStr(input.sessionKey, "sessionKey"),
+        ...disclosure === "chunk" || disclosure === "section" || disclosure === "raw" ? { disclosure } : {},
+        namespace: optStr(input.namespace),
+        authenticatedPrincipal: ctx.authenticatedPrincipal
+      })
+    };
+  }
+});
+defineOperation({
+  name: "memory_traverse",
+  description: "Follow typed frontmatter links from an already-served recall result; neighbors return as chunk-level summaries.",
+  schema: strictSchema({
+    ...baseShape,
+    relation: z.enum([
+      "supports",
+      "contradicts",
+      "elaborates",
+      "causes",
+      "caused_by",
+      "supersedes",
+      "follows",
+      "references",
+      "related"
+    ]).optional(),
+    limit: z.union([z.number(), z.string()]).optional()
+  }),
+  handler: async (input, ctx) => {
+    const relation = optStr(input.relation);
+    return {
+      result: await ctx.service.recallNavigate({
+        action: "traverse",
+        memoryId: reqStr(input.memoryId, "memoryId"),
+        sessionKey: reqStr(input.sessionKey, "sessionKey"),
+        ...relation !== void 0 ? { relation } : {},
+        limit: optInt(input.limit),
+        namespace: optStr(input.namespace),
+        authenticatedPrincipal: ctx.authenticatedPrincipal
+      })
+    };
+  }
+});
+//# sourceMappingURL=chunk-OCX7OWOC.js.map

package/dist/chunk-OCX7OWOC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-navigation-operations.ts"],"sourcesContent":["/**\n * Recall-navigation boundary operations (issue #1956).\n *\n * `memory_expand` / `memory_traverse` route MCP, HTTP, and CLI dispatch\n * through the shared validation + error-mapping layer (access-boundary.ts)\n * to the single `EngramAccessService.recallNavigate` implementation.\n * Sibling module so access-operations-batch.ts stays at its ceiling seam\n * (same layout as deep-recall's extraction).\n */\n\nimport { z } from \"zod\";\n\nimport { defineOperation } from \"./access-boundary.js\";\nimport { EngramAccessInputError } from \"./access-errors.js\";\n\nfunction stripNulls(data: unknown): unknown {\n  if (data !== null && typeof data === \"object\" && !Array.isArray(data)) {\n    const obj = data as Record<string, unknown>;\n    const cleaned: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(obj)) {\n      if (value !== null) cleaned[key] = value;\n    }\n    return cleaned;\n  }\n  return data;\n}\n\nfunction strictSchema<T extends z.ZodRawShape>(shape: T): z.ZodType<Record<string, unknown>> {\n  return z.preprocess(stripNulls, z.object(shape).passthrough()) as unknown as z.ZodType<Record<string, unknown>>;\n}\n\nconst str = z.string().optional();\n\nfunction optStr(value: unknown): string | undefined {\n  return typeof value === \"string\" ? value : undefined;\n}\n\nfunction optInt(value: unknown): number | undefined {\n  if (typeof value === \"number\") return value;\n  if (typeof value === \"string\" && Number.isFinite(Number(value))) return Number(value);\n  return undefined;\n}\n\nfunction reqStr(value: unknown, field: string): string {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new EngramAccessInputError(`${field} is required`);\n  }\n  return value;\n}\n\nconst baseShape = {\n  memoryId: z.string(),\n  sessionKey: z.string(),\n  namespace: str,\n};\n\ndefineOperation({\n  name: \"memory_expand\",\n  description: \"Re-render one already-served recall result at a deeper disclosure level (chunk → section → raw).\",\n  schema: strictSchema({ ...baseShape, disclosure: z.enum([\"chunk\", \"section\", \"raw\"]).optional() }),\n  handler: async (input, ctx) => {\n    const disclosure = optStr(input.disclosure);\n    return {\n      result: await ctx.service.recallNavigate({\n        action: \"expand\",\n        memoryId: reqStr(input.memoryId, \"memoryId\"),\n        sessionKey: reqStr(input.sessionKey, \"sessionKey\"),\n        ...(disclosure === \"chunk\" || disclosure === \"section\" || disclosure === \"raw\" ? { disclosure } : {}),\n        namespace: optStr(input.namespace),\n        authenticatedPrincipal: ctx.authenticatedPrincipal,\n      }),\n    };\n  },\n});\n\ndefineOperation({\n  name: \"memory_traverse\",\n  description:\n    \"Follow typed frontmatter links from an already-served recall result; neighbors return as chunk-level summaries.\",\n  schema: strictSchema({\n    ...baseShape,\n    relation: z\n      .enum([\n        \"supports\",\n        \"contradicts\",\n        \"elaborates\",\n        \"causes\",\n        \"caused_by\",\n        \"supersedes\",\n        \"follows\",\n        \"references\",\n        \"related\",\n      ])\n      .optional(),\n    limit: z.union([z.number(), z.string()]).optional(),\n  }),\n  handler: async (input, ctx) => {\n    const relation = optStr(input.relation);\n    return {\n      result: await ctx.service.recallNavigate({\n        action: \"traverse\",\n        memoryId: reqStr(input.memoryId, \"memoryId\"),\n        sessionKey: reqStr(input.sessionKey, \"sessionKey\"),\n        ...(relation !== undefined ? { relation } : {}),\n        limit: optInt(input.limit),\n        namespace: optStr(input.namespace),\n        authenticatedPrincipal: ctx.authenticatedPrincipal,\n      }),\n    };\n  },\n});\n"],"mappings":"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","names":[]}

package/dist/{chunk-HPMCKAET.js → chunk-OGAKUA7I.js}

@@ -1,6 +1,6 @@
 import {
   StorageManager
-} from "./chunk-I65KB36L.js";
+} from "./chunk-GMU7MAHS.js";
 import {
   normalizeEntityName
 } from "./chunk-YXZG5TVN.js";
@@ -957,4 +957,4 @@ export {
   resolveBriefingSaveDir,
   briefingFilename
 };
-//# sourceMappingURL=chunk-HPMCKAET.js.map
+//# sourceMappingURL=chunk-OGAKUA7I.js.map

package/dist/{chunk-AOGICQMH.js → chunk-PF7LQ22G.js}

@@ -1,9 +1,9 @@
 import {
   resolveDefaultNamespaceRoot
-} from "./chunk-CQ4BTPX6.js";
+} from "./chunk-3YQ7VLP3.js";
 import {
   StorageManager
-} from "./chunk-I65KB36L.js";
+} from "./chunk-GMU7MAHS.js";
 import {
   composeLocationDayBody,
   composeLocationDayMeta,
@@ -728,4 +728,4 @@ export {
   runLocationBackfill,
   runLocationCliCommand
 };
-//# sourceMappingURL=chunk-AOGICQMH.js.map
+//# sourceMappingURL=chunk-PF7LQ22G.js.map

package/dist/{chunk-AUSRUOMQ.js → chunk-PW4HTWXL.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-SOBJ6NEY.js";
 import {
   summarizeDisclosureTokens
-} from "./chunk-Q62GA5U2.js";
+} from "./chunk-VW5TGNJN.js";
 import {
   summarizeRetrievedMemoryProvenance
 } from "./chunk-I4WBNM3M.js";
@@ -610,4 +610,4 @@ export {
   renderRecallExplain,
   parseRecallExplainFormat
 };
-//# sourceMappingURL=chunk-AUSRUOMQ.js.map
+//# sourceMappingURL=chunk-PW4HTWXL.js.map

package/dist/{chunk-ZYRAY5FL.js → chunk-QCTXQ2HW.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-6ET2VII7.js";
 import {
   StorageManager
-} from "./chunk-I65KB36L.js";
+} from "./chunk-GMU7MAHS.js";
 import {
   parseContinuityImprovementLoops
 } from "./chunk-LDXUBPMO.js";
@@ -1283,4 +1283,4 @@ export {
   defaultTierMigrationCycleBudget,
   CompoundingEngine
 };
-//# sourceMappingURL=chunk-ZYRAY5FL.js.map
+//# sourceMappingURL=chunk-QCTXQ2HW.js.map

package/dist/chunk-QZ4U67KO.js

@@ -0,0 +1,98 @@
+import {
+  EngramAccessInputError
+} from "./chunk-2Z24E5W2.js";
+
+// src/recall-navigation-http-glue.ts
+var VALID_RELATIONS = [
+  "supports",
+  "contradicts",
+  "elaborates",
+  "causes",
+  "caused_by",
+  "supersedes",
+  "follows",
+  "references",
+  "related"
+];
+function optStr(value) {
+  return typeof value === "string" ? value : void 0;
+}
+function optInt(value) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  const parsed = typeof value === "string" ? Number(value) : value;
+  if (typeof parsed !== "number" || !Number.isInteger(parsed) || parsed < 1) {
+    throw new EngramAccessInputError("limit must be a positive integer");
+  }
+  return parsed;
+}
+async function respondNavigation(req, res, respondJson, readJsonBody, service, scopeFor, action) {
+  const body = await readJsonBody(req);
+  const memoryId = optStr(body.memoryId);
+  if (memoryId === void 0 || memoryId.trim().length === 0) {
+    respondJson(res, 400, { error: "invalid_request", detail: "memoryId is required" });
+    return;
+  }
+  const sessionKey = optStr(body.sessionKey);
+  if (sessionKey === void 0 || sessionKey.trim().length === 0) {
+    respondJson(res, 400, { error: "invalid_request", detail: "sessionKey is required" });
+    return;
+  }
+  let disclosure;
+  let relation;
+  if (action === "expand") {
+    const raw = optStr(body.disclosure);
+    if (raw !== void 0 && raw !== "chunk" && raw !== "section" && raw !== "raw") {
+      respondJson(res, 400, { error: "invalid_request", detail: "disclosure must be one of chunk, section, raw" });
+      return;
+    }
+    disclosure = raw;
+  } else {
+    relation = optStr(body.relation);
+    if (relation !== void 0 && !VALID_RELATIONS.includes(relation)) {
+      respondJson(
+        res,
+        400,
+        { error: "invalid_request", detail: `relation must be one of ${VALID_RELATIONS.join(", ")}` }
+      );
+      return;
+    }
+  }
+  let limit;
+  try {
+    limit = optInt(body.limit);
+  } catch (err) {
+    respondJson(res, 400, { error: "invalid_request", detail: err instanceof Error ? err.message : String(err) });
+    return;
+  }
+  const scope = scopeFor(optStr(body.namespace), sessionKey);
+  const result = await service.recallNavigate({
+    action,
+    memoryId,
+    sessionKey: scope.sessionKey ?? sessionKey,
+    ...disclosure !== void 0 ? { disclosure } : {},
+    ...relation !== void 0 ? { relation } : {},
+    ...limit !== void 0 ? { limit } : {},
+    namespace: scope.namespace,
+    authenticatedPrincipal: scope.authenticatedPrincipal
+  });
+  const { rendered: _rendered, ...payload } = result;
+  respondJson(res, 200, payload);
+}
+async function maybeRespondRecallNavigation(req, res, pathname, method, enforceTokenOp, respondJson, readJsonBody, service, scopeFor) {
+  if (method === "POST" && (pathname === "/engram/v1/memory/expand" || pathname === "/remnic/v1/memory/expand")) {
+    enforceTokenOp("memory_expand");
+    await respondNavigation(req, res, respondJson, readJsonBody, service, scopeFor, "expand");
+    return true;
+  }
+  if (method === "POST" && (pathname === "/engram/v1/memory/traverse" || pathname === "/remnic/v1/memory/traverse")) {
+    enforceTokenOp("memory_traverse");
+    await respondNavigation(req, res, respondJson, readJsonBody, service, scopeFor, "traverse");
+    return true;
+  }
+  return false;
+}
+
+export {
+  maybeRespondRecallNavigation
+};
+//# sourceMappingURL=chunk-QZ4U67KO.js.map

package/dist/chunk-QZ4U67KO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-navigation-http-glue.ts"],"sourcesContent":["/**\n * Recall-navigation HTTP glue (issue #1956) — route body lives here so\n * access-http.ts stays at its structural ceiling (same seam as\n * deep-recall-http-glue.ts).\n *\n * Input errors map to 400; everything else rethrows to the global 500\n * handler. Config gating (`recallNavigation.enabled`) lives in the service\n * and returns a typed `error: \"disabled\"` refusal — this module only\n * translates transport shape. Namespace/sessionKey resolution flows through\n * the caller-supplied `scopeFor` gate so a body-supplied namespace passes\n * the SAME effective-namespace allow-list as the query string (issue #1850\n * finding 2), and `authenticatedPrincipal` reaches the service so\n * authorization derives from the presenting principal, never the\n * client-supplied sessionKey.\n */\n\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\n\nimport { EngramAccessInputError } from \"./access-errors.js\";\nimport type { EngramAccessService } from \"./access-service.js\";\nimport type { NavigationAction } from \"./recall-navigation.js\";\n\ntype RespondJson = (res: ServerResponse, status: number, payload: unknown) => void;\ntype ReadJsonBody = (req: IncomingMessage) => Promise<unknown>;\n\ntype ScopeFor = (\n  bodyNamespace?: string,\n  bodySessionKey?: string,\n) => { namespace?: string; sessionKey?: string; authenticatedPrincipal?: string };\n\nconst VALID_RELATIONS = [\n  \"supports\",\n  \"contradicts\",\n  \"elaborates\",\n  \"causes\",\n  \"caused_by\",\n  \"supersedes\",\n  \"follows\",\n  \"references\",\n  \"related\",\n] as const;\n\nfunction optStr(value: unknown): string | undefined {\n  return typeof value === \"string\" ? value : undefined;\n}\n\nfunction optInt(value: unknown): number | undefined {\n  if (value === undefined || value === null || value === \"\") return undefined;\n  const parsed = typeof value === \"string\" ? Number(value) : value;\n  if (typeof parsed !== \"number\" || !Number.isInteger(parsed) || parsed < 1) {\n    throw new EngramAccessInputError(\"limit must be a positive integer\");\n  }\n  return parsed;\n}\n\nasync function respondNavigation(\n  req: IncomingMessage,\n  res: ServerResponse,\n  respondJson: RespondJson,\n  readJsonBody: ReadJsonBody,\n  service: EngramAccessService,\n  scopeFor: ScopeFor,\n  action: Extract<NavigationAction, \"expand\" | \"traverse\">,\n): Promise<void> {\n  const body = (await readJsonBody(req)) as Record<string, unknown>;\n  const memoryId = optStr(body.memoryId);\n  if (memoryId === undefined || memoryId.trim().length === 0) {\n    respondJson(res, 400, { error: \"invalid_request\", detail: \"memoryId is required\" });\n    return;\n  }\n  const sessionKey = optStr(body.sessionKey);\n  if (sessionKey === undefined || sessionKey.trim().length === 0) {\n    respondJson(res, 400, { error: \"invalid_request\", detail: \"sessionKey is required\" });\n    return;\n  }\n  let disclosure: \"chunk\" | \"section\" | \"raw\" | undefined;\n  let relation: string | undefined;\n  if (action === \"expand\") {\n    const raw = optStr(body.disclosure);\n    if (raw !== undefined && raw !== \"chunk\" && raw !== \"section\" && raw !== \"raw\") {\n      respondJson(res, 400, { error: \"invalid_request\", detail: \"disclosure must be one of chunk, section, raw\" });\n      return;\n    }\n    disclosure = raw;\n  } else {\n    relation = optStr(body.relation);\n    if (relation !== undefined && !(VALID_RELATIONS as readonly string[]).includes(relation)) {\n      respondJson(\n        res,\n        400,\n        { error: \"invalid_request\", detail: `relation must be one of ${VALID_RELATIONS.join(\", \")}` },\n      );\n      return;\n    }\n  }\n  let limit: number | undefined;\n  try {\n    limit = optInt(body.limit);\n  } catch (err) {\n    respondJson(res, 400, { error: \"invalid_request\", detail: err instanceof Error ? err.message : String(err) });\n    return;\n  }\n  const scope = scopeFor(optStr(body.namespace), sessionKey);\n  const result = await service.recallNavigate({\n    action,\n    memoryId,\n    sessionKey: scope.sessionKey ?? sessionKey,\n    ...(disclosure !== undefined ? { disclosure } : {}),\n    ...(relation !== undefined ? { relation } : {}),\n    ...(limit !== undefined ? { limit } : {}),\n    namespace: scope.namespace,\n    authenticatedPrincipal: scope.authenticatedPrincipal,\n  });\n  const { rendered: _rendered, ...payload } = result;\n  respondJson(res, 200, payload);\n}\n\nexport async function maybeRespondRecallNavigation(\n  req: IncomingMessage,\n  res: ServerResponse,\n  pathname: string,\n  method: string | undefined,\n  enforceTokenOp: (op: \"memory_expand\" | \"memory_traverse\") => void,\n  respondJson: RespondJson,\n  readJsonBody: ReadJsonBody,\n  service: EngramAccessService,\n  scopeFor: ScopeFor,\n): Promise<boolean> {\n  if (method === \"POST\" && (pathname === \"/engram/v1/memory/expand\" || pathname === \"/remnic/v1/memory/expand\")) {\n    enforceTokenOp(\"memory_expand\");\n    await respondNavigation(req, res, respondJson, readJsonBody, service, scopeFor, \"expand\");\n    return true;\n  }\n  if (method === \"POST\" && (pathname === \"/engram/v1/memory/traverse\" || pathname === \"/remnic/v1/memory/traverse\")) {\n    enforceTokenOp(\"memory_traverse\");\n    await respondNavigation(req, res, respondJson, readJsonBody, service, scopeFor, \"traverse\");\n    return true;\n  }\n  return false;\n}\n\n"],"mappings":"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","names":[]}

package/dist/{chunk-G3NTZZWT.js → chunk-R3H2AXO2.js}

@@ -1,6 +1,6 @@
 import {
   StorageManager
-} from "./chunk-I65KB36L.js";
+} from "./chunk-GMU7MAHS.js";
 import {
   getCachedRuleMemories,
   setCachedRuleMemories
@@ -119,4 +119,4 @@ export {
   compareVerifiedSemanticRuleResults,
   searchVerifiedSemanticRules
 };
-//# sourceMappingURL=chunk-G3NTZZWT.js.map
+//# sourceMappingURL=chunk-R3H2AXO2.js.map

package/dist/{chunk-HSJU6JFT.js → chunk-ROXDOKLM.js}

@@ -1,6 +1,9 @@
+import {
+  RECALL_NAVIGATION_MCP_TOOLS
+} from "./chunk-TE6S7KDF.js";
 import {
   MCP_READ_ONLY_TOOL_SUFFIXES
-} from "./chunk-EAARGPWI.js";
+} from "./chunk-F3TURDFG.js";
 import {
   EXTERNAL_WIKI_MCP_TOOLS
 } from "./chunk-A5KNZSNA.js";
@@ -34,19 +37,19 @@ import {
 } from "./chunk-AB3A7EFH.js";
 import {
   applyToolOutputSchemas
-} from "./chunk-QVSRE355.js";
+} from "./chunk-2AV75BJW.js";
 import {
   getOperation
-} from "./chunk-IUTYNDFS.js";
+} from "./chunk-3K64PLY3.js";
 import {
   WHO_KNOWS_MCP_TOOLS
-} from "./chunk-XJLTQTAO.js";
+} from "./chunk-D7UUB33A.js";
 import {
   PROMOTION_CANDIDATES_MCP_TOOLS
 } from "./chunk-VYCOJKSX.js";
 import {
   validateRequest
-} from "./chunk-ZOGKZ2XT.js";
+} from "./chunk-JUOJGZPV.js";
 import {
   SUPPORT_PASSPORT_SOURCE_MEMORY_ID_MAX_LENGTH
 } from "./chunk-PWPIERBM.js";
@@ -1764,6 +1767,8 @@ var MCP_MIGRATED_OPERATIONS = {
   ...SUPPORT_PASSPORT_MCP_MIGRATED_OPERATIONS,
   ...MCP_ADMIN_OPS_MIGRATED_OPERATIONS,
   "engram.deep_recall": "deep_recall",
+  "engram.memory_expand": "memory_expand",
+  "engram.memory_traverse": "memory_traverse",
   "engram.memory_chat": "chat_message"
 };
 var STRICT_MCP_SCHEMA_KEYS = {
@@ -2061,6 +2066,7 @@ var EngramMcpServer = class {
       ...LOCATION_MCP_TOOLS,
       ...STANDUP_MCP_TOOLS,
       ...DEEP_RECALL_MCP_TOOLS,
+      ...service.recallNavigationEnabled !== false ? RECALL_NAVIGATION_MCP_TOOLS : [],
       ...service.supportPassportEnabled ? SUPPORT_PASSPORT_MCP_TOOLS : [],
       {
         name: "engram.action_confidence",
@@ -3981,4 +3987,4 @@ export {
   MCP_MIGRATED_OPERATIONS,
   EngramMcpServer
 };
-//# sourceMappingURL=chunk-HSJU6JFT.js.map
+//# sourceMappingURL=chunk-ROXDOKLM.js.map