@remnic/core 9.69.42 → 9.69.43

package/dist/{chunk-K27INAPR.js → chunk-LUAQHDUI.js}

@@ -11,7 +11,7 @@ import {
 } from "./chunk-NHLLKEKK.js";
 import {
   parseConfig
-} from "./chunk-2UINSKQC.js";
+} from "./chunk-XIJHRQ4A.js";
 import {
   resolveObjectiveStateStoreDir,
   validateObjectiveStateSnapshot
@@ -268,4 +268,4 @@ export {
   recordResumeBundle,
   getResumeBundleStatus
 };
-//# sourceMappingURL=chunk-K27INAPR.js.map
+//# sourceMappingURL=chunk-LUAQHDUI.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-IUTYNDFS.js → chunk-LXMZM7LM.js}

@@ -8,7 +8,7 @@ import {
 } from "./chunk-MPC7TYTZ.js";
 import {
   importCapsule
-} from "./chunk-VVX5PZFS.js";
+} from "./chunk-ZHXSOMYH.js";
 import {
   isSharedContextWriteInputError
 } from "./chunk-IFBSZGW3.js";
@@ -38,10 +38,16 @@ import {
   computeWhoKnows,
   loadWhoKnowsEntities,
   validateWhoKnowsInput
-} from "./chunk-XJLTQTAO.js";
+} from "./chunk-D7UUB33A.js";
 import {
   WriteQuarantineStore
 } from "./chunk-PJSK6OJM.js";
+import {
+  trustResultFor
+} from "./chunk-GNVZQ5JN.js";
+import {
+  renderEpistemicHedge
+} from "./chunk-YN2UN7N3.js";
 import {
   getTrustZoneStoreStatus,
   isTrustZoneName,
@@ -51,12 +57,6 @@ import {
   seedTrustZoneDemoDataset,
   summarizeTrustZonePromotionReadiness
 } from "./chunk-ROBHL3GL.js";
-import {
-  trustResultFor
-} from "./chunk-GNVZQ5JN.js";
-import {
-  renderEpistemicHedge
-} from "./chunk-YN2UN7N3.js";
 import {
   summarizeHourlyStatus
 } from "./chunk-J2MGTGKC.js";
@@ -66,18 +66,38 @@ import {
 import {
   isSearchExcludedPath
 } from "./chunk-46FVFU7S.js";
+import {
+  renderNavigationResult
+} from "./chunk-KIW3OOZE.js";
+import {
+  DEFAULT_TRAVERSE_LIMIT,
+  selectTraverseNeighbors
+} from "./chunk-YE4JBZO5.js";
+import {
+  assertIdInNavigationWindow
+} from "./chunk-5KVT6G5U.js";
+import {
+  takeNavigateBudget
+} from "./chunk-VYDGHJIN.js";
+import {
+  planDisclosureStep
+} from "./chunk-AS2NOPDM.js";
+import {
+  parseNavigateLinkType
+} from "./chunk-7O5EW7KX.js";
 import {
   decideDisclosureEscalation
 } from "./chunk-H7XKCNR6.js";
 import {
   toRecallExplainJson
-} from "./chunk-AUSRUOMQ.js";
+} from "./chunk-PW4HTWXL.js";
 import {
-  estimateRecallTokens
-} from "./chunk-Q62GA5U2.js";
+  estimateRecallTokens,
+  summarizeDisclosureTokens
+} from "./chunk-VW5TGNJN.js";
 import {
   readAggregateExtractionWatermark
-} from "./chunk-WNPRRBOE.js";
+} from "./chunk-2HDLDBJW.js";
 import {
   ReplicaDivergenceMonitor
 } from "./chunk-CVILPI77.js";
@@ -98,7 +118,7 @@ import {
 } from "./chunk-HWLIMQE2.js";
 import {
   readProjectedHarmonicGraph
-} from "./chunk-OP722LOG.js";
+} from "./chunk-3254BYQV.js";
 import {
   wrapWorkLayerContext
 } from "./chunk-EI6V5UXY.js";
@@ -149,11 +169,11 @@ import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact,
   runMemoryGovernance
-} from "./chunk-U26LB4WA.js";
+} from "./chunk-5AJZ7EUW.js";
 import {
   CorpusWatermarkCache,
   computeServiceCorpusCensus
-} from "./chunk-JMAP6L6Q.js";
+} from "./chunk-KDLOKVX7.js";
 import {
   CrossNamespaceBudget,
   toBudgetWarning
@@ -170,21 +190,21 @@ import {
   enqueuePassiveCorrectionNotification,
   parseBriefingFocus,
   parseBriefingWindow
-} from "./chunk-HPMCKAET.js";
+} from "./chunk-OGAKUA7I.js";
 import {
   parseEntityFile,
   parseFrontmatter,
   qmdCollectionPathParts,
   qmdResultPathCandidates,
   selfDeps
-} from "./chunk-I65KB36L.js";
+} from "./chunk-GMU7MAHS.js";
 import {
   namespaceCollectionName
-} from "./chunk-AIVRD66I.js";
+} from "./chunk-T3F2HWIG.js";
 import {
   DEFAULT_RECALL_DISCLOSURE,
   isRecallDisclosure
-} from "./chunk-WN2OXGGH.js";
+} from "./chunk-66YUOI53.js";
 import {
   normalizeProjectionPreview,
   normalizeProjectionTags
@@ -224,10 +244,16 @@ import {
 import {
   formatSupersededPrefix
 } from "./chunk-EH3HNCAM.js";
+import {
+  RECALL_NAVIGATION_CONFIG_DEFAULTS
+} from "./chunk-LVTT5AUG.js";
 import {
   ExtractionLivenessWarnThrottle,
   computeExtractionLivenessStatus
 } from "./chunk-3SG4FGDV.js";
+import {
+  resolveEffectiveDeepRecallConfig
+} from "./chunk-7RGX7BMF.js";
 import {
   buildProcedurePersistBody,
   normalizeProcedureSteps,
@@ -255,7 +281,7 @@ import {
 } from "./chunk-SYOIVK7K.js";
 import {
   splitCanonicalWriteRequest
-} from "./chunk-RSSLDMFX.js";
+} from "./chunk-YTV6J4T6.js";
 import {
   applyBriefingLocationContext,
   daySummaryAutoOptions
@@ -277,10 +303,10 @@ import {
 } from "./chunk-VYCOJKSX.js";
 import {
   reapplyCategoryCoercion
-} from "./chunk-ZOGKZ2XT.js";
+} from "./chunk-CRK6F6N3.js";
 import {
   exportCapsule
-} from "./chunk-VDX2J7OX.js";
+} from "./chunk-KQAFEZQX.js";
 import {
   evaluateActionConfidence
 } from "./chunk-Z2YFLXHU.js";
@@ -358,7 +384,9 @@ import {
 } from "./chunk-5GKPFL3S.js";
 import {
   buildHandleIndexForResults,
-  isHandleToken
+  isHandleToken,
+  parseIdOrHandle,
+  resolveHandle
 } from "./chunk-JAKIDQB2.js";
 import {
   OFFLINE_SYNC_SNAPSHOT_FORMAT,
@@ -3709,6 +3737,8 @@ var OPERATION_NAMES = [
   "meetings_get",
   "meetings_build",
   "deep_recall",
+  "memory_expand",
+  "memory_traverse",
   "standup",
   "action_confidence",
   "chatgpt_memory_inspector",
@@ -4453,6 +4483,237 @@ async function promoteMemory(options) {
   };
 }
 
+// src/recall-navigation.ts
+function toNavigationItem(summary, extras = {}) {
+  const item = {
+    memoryId: summary.id,
+    path: summary.path,
+    disclosure: summary.disclosure ?? "chunk",
+    estimatedTokens: estimateRecallTokens(summary.content ?? summary.preview),
+    preview: summary.preview
+  };
+  if (summary.content !== void 0) item.content = summary.content;
+  if (extras.linkType !== void 0) item.linkType = extras.linkType;
+  return item;
+}
+function applyBudget(request, extras) {
+  const kept = [];
+  let truncated = extras.truncated;
+  for (const item of extras.items) {
+    const candidate = [...kept, item];
+    const cost = structuredCost(request, extras, candidate, truncated);
+    if (!takeNavigateBudget(extras.budgetChars, cost).ok) {
+      if (kept.length === 0) {
+        const shrunk = shrinkItemToBudget(request, extras, item);
+        if (shrunk !== void 0) {
+          return finalizeBudget(request, extras, [shrunk], true);
+        }
+      }
+      truncated = true;
+      break;
+    }
+    kept.push(item);
+  }
+  return finalizeBudget(request, extras, kept, truncated);
+}
+function finalizeBudget(request, extras, items, truncated) {
+  let kept = items;
+  let flag = truncated;
+  let used = measuredUsed(request, extras, kept, flag);
+  while (used > extras.budgetChars && kept.length > 0) {
+    kept = kept.slice(0, -1);
+    flag = true;
+    used = measuredUsed(request, extras, kept, flag);
+  }
+  return { items: kept, truncated: flag, used };
+}
+function structuredBody(request, extras, items, truncated, used) {
+  return {
+    ok: true,
+    action: request.action,
+    memoryId: extras.memoryId,
+    namespace: extras.namespace,
+    items,
+    truncated,
+    budget: { chars: extras.budgetChars, used },
+    disclosureSpend: summarizeDisclosureTokens(
+      items.map((item) => ({ disclosure: item.disclosure, estimatedTokens: item.estimatedTokens }))
+    )
+  };
+}
+function structuredCost(request, extras, items, truncated, used = 0) {
+  return JSON.stringify(structuredBody(request, extras, items, truncated, used)).length;
+}
+function measuredUsed(request, extras, items, truncated) {
+  return structuredCost(request, extras, items, truncated, structuredCost(request, extras, items, truncated));
+}
+function shrinkItemToBudget(request, extras, item) {
+  let preview = item.preview;
+  let content = item.content ?? "";
+  const hasContent = item.content !== void 0;
+  while (preview.length > 0 || content.length > 0) {
+    const candidate = hasContent ? { ...item, preview, content } : { ...item, preview };
+    if (takeNavigateBudget(extras.budgetChars, structuredCost(request, extras, [candidate], true)).ok) {
+      return candidate;
+    }
+    if (content.length > 0) content = content.slice(0, Math.max(0, content.length - 16));
+    else preview = preview.slice(0, Math.max(0, preview.length - 16));
+  }
+  return void 0;
+}
+function errorResult(request, error, message) {
+  return { ok: false, action: request.action, error, message, rendered: renderNavigationResult({ ok: false, action: request.action, error, message }) };
+}
+function successResult(request, extras) {
+  const budgeted = applyBudget(request, extras);
+  const result = structuredBody(request, extras, budgeted.items, budgeted.truncated, budgeted.used);
+  return { ...result, rendered: renderNavigationResult(result) };
+}
+function resolveRequestedMemoryId(request, snapshots, windowSnapshots) {
+  const parsed = parseIdOrHandle(request.memoryId);
+  if (!parsed.isHandle) return { ok: true, memoryId: parsed.value };
+  const resolved = resolveHandle(
+    request.memoryId,
+    snapshots.map((memoryIds) => ({ memoryIds })),
+    windowSnapshots
+  );
+  if (resolved.ok) return { ok: true, memoryId: resolved.memoryId };
+  if (resolved.reason === "ambiguous") {
+    throw new EngramAccessInputError(
+      `Memory handle ${request.memoryId} is ambiguous in session ${request.sessionKey}: ${resolved.candidates.join(", ")}. Cite a unique memory id instead.`
+    );
+  }
+  return { ok: false };
+}
+function clampLimit(requested, ceiling) {
+  if (requested === void 0) return Math.min(DEFAULT_TRAVERSE_LIMIT, ceiling);
+  if (!Number.isInteger(requested) || requested < 1) {
+    throw new EngramAccessInputError(
+      `memory navigation: limit must be a positive integer; got ${JSON.stringify(requested)}`
+    );
+  }
+  return Math.min(requested, ceiling);
+}
+async function runRecallNavigation(deps, request) {
+  if (!deps.config.enabled) {
+    return errorResult(request, "disabled", "memory navigation is disabled; set recallNavigation.enabled");
+  }
+  const sessionKey = request.sessionKey?.trim() ?? "";
+  if (sessionKey.length === 0) {
+    throw new EngramAccessInputError(
+      "memory navigation requires a sessionKey: navigation authority is scoped to the session's recent recalls"
+    );
+  }
+  if (request.limit !== void 0) {
+    clampLimit(request.limit, deps.config.maxNeighbors);
+  }
+  const windowSnapshots = deps.config.windowSnapshots;
+  const servedIds = deps.recentServedIds(sessionKey, windowSnapshots);
+  const resolved = resolveRequestedMemoryId(request, servedIds, windowSnapshots);
+  if (!resolved.ok) {
+    return errorResult(
+      request,
+      "not_served",
+      `memory ${request.memoryId} was not served to session ${sessionKey} within the last ${windowSnapshots} recall snapshots; run recall first`
+    );
+  }
+  const authority = assertIdInNavigationWindow({
+    snapshots: servedIds.map((ids) => ({ servedIds: ids })),
+    memoryId: resolved.memoryId,
+    windowSnapshots
+  });
+  if (!authority.ok) {
+    return errorResult(
+      request,
+      "not_served",
+      `memory ${request.memoryId} was not served to session ${sessionKey} within the last ${windowSnapshots} recall snapshots; run recall first`
+    );
+  }
+  const memoryId = authority.memoryId;
+  const namespace = deps.resolveReadableNamespace(request.namespace, request.authenticatedPrincipal);
+  const storage = await deps.getStorage(namespace);
+  const memory = await storage.getMemoryById(memoryId);
+  if (!memory) {
+    return errorResult(
+      request,
+      "not_found",
+      `memory ${memoryId} was not found in namespace ${namespace}; navigation never crosses the resolved namespace`
+    );
+  }
+  if (request.action === "expand") {
+    const target = request.disclosure ?? "raw";
+    const step = planDisclosureStep({ from: "chunk", to: target });
+    if (!step.ok) {
+      const message = step.error === "unknown_level" ? `unknown disclosure level ${JSON.stringify(target)}; valid: chunk, section, raw` : `disclosure ${JSON.stringify(target)} is not deeper than the chunk level already served; expansion must go deeper (chunk \u2192 section \u2192 raw)`;
+      return errorResult(request, step.error, message);
+    }
+    const summary = shapeMemorySummary(memory, storage.dir, target);
+    return successResult(request, {
+      memoryId,
+      namespace,
+      items: [toNavigationItem(summary)],
+      truncated: false,
+      budgetChars: deps.recallBudgetChars
+    });
+  }
+  if (request.action === "traverse") {
+    if (request.relation !== void 0) {
+      const parsedRelation = parseNavigateLinkType(request.relation);
+      if (!parsedRelation.ok) {
+        return errorResult(
+          request,
+          "unknown_relation",
+          `unknown relation ${JSON.stringify(request.relation)}; valid: supports, contradicts, elaborates, causes, caused_by, supersedes, follows, references, related`
+        );
+      }
+    }
+    const links = (memory.frontmatter.links ?? []).map((link) => ({
+      targetId: link.targetId,
+      linkType: link.linkType
+    }));
+    const selection = selectTraverseNeighbors({
+      links,
+      relation: request.relation,
+      limit: clampLimit(request.limit, deps.config.maxNeighbors)
+    });
+    if (!selection.ok) {
+      return errorResult(request, selection.error, `traverse refused: ${selection.error}`);
+    }
+    const items = [];
+    for (const neighbor of selection.neighbors) {
+      const neighborMemory = await storage.getMemoryById(neighbor.targetId);
+      if (!neighborMemory) continue;
+      items.push(toNavigationItem(shapeMemorySummary(neighborMemory, storage.dir, "chunk"), { linkType: neighbor.linkType }));
+    }
+    return successResult(request, {
+      memoryId,
+      namespace,
+      items,
+      truncated: selection.truncated,
+      budgetChars: deps.recallBudgetChars
+    });
+  }
+  const entityRef = memory.frontmatter.entityRef?.trim();
+  if (!entityRef) {
+    return successResult(request, { memoryId, namespace, items: [], truncated: false, budgetChars: deps.recallBudgetChars });
+  }
+  const window = await storage.readMemoriesWindow();
+  const candidates = [];
+  for (const candidate of window.memories) {
+    if (candidate.frontmatter.id === memoryId) continue;
+    if (candidate.frontmatter.entityRef?.trim() !== entityRef) continue;
+    candidates.push(toNavigationItem(shapeMemorySummary(candidate, storage.dir, "chunk")));
+    if (candidates.length >= clampLimit(request.limit, deps.config.maxNeighbors)) break;
+  }
+  return successResult(request, {
+    memoryId,
+    namespace,
+    items: candidates,
+    truncated: false,
+    budgetChars: deps.recallBudgetChars
+  });
+}
+
 // src/procedural/library-maintenance.ts
 import path7 from "path";
 var MAINTENANCE_ACTOR = "procedure-library-maintenance";
@@ -14291,6 +14552,7 @@ var EngramAccessService = class extends SupportPassportAccessServiceBase {
     this.replicaDivergenceMonitor = new ReplicaDivergenceMonitor({ resolveSecretRef: options.resolveSecretRef });
     this.injectedSupportPassportGatewayRoute = options.supportPassportGatewayRoute ?? null;
     this.reviewDeckEnabled = options.reviewDeckEnabled === true;
+    this.recallNavigationEnabled = (orchestrator.config.recallNavigation ?? RECALL_NAVIGATION_CONFIG_DEFAULTS).enabled;
     const accessCaps = resolveAccessSetupCapabilities(orchestrator.config);
     this.budget = new CrossNamespaceBudget({
       enabled: accessCaps.recallCrossNamespaceBudget,
@@ -14331,6 +14593,7 @@ var EngramAccessService = class extends SupportPassportAccessServiceBase {
   replicaDivergenceMonitor;
   injectedSupportPassportGatewayRoute;
   reviewDeckEnabled;
+  recallNavigationEnabled;
   /** AccessObserveWriteSurface (access-service decomposition). Lazy; selfDeps live wiring. */
   _accessObserveWriteSurface;
   get accessObserveWriteSurface() {
@@ -15325,25 +15588,7 @@ var EngramAccessService = class extends SupportPassportAccessServiceBase {
     if (query.length === 0) {
       throw new EngramAccessInputError("deepRecall: query is required");
     }
-    let effective = cfg;
-    const requestedSteps = request.maxSteps;
-    if (requestedSteps !== void 0) {
-      if (typeof requestedSteps !== "number" || !Number.isInteger(requestedSteps) || requestedSteps < 0) {
-        throw new EngramAccessInputError("deepRecall: maxSteps must be a non-negative integer");
-      }
-      if (cfg.maxSteps <= 0) {
-        if (requestedSteps > 0) {
-          throw new EngramAccessInputError(
-            "deepRecall: the policy loop is disabled (deepRecall.maxSteps=0); maxSteps must be 0"
-          );
-        }
-      } else if (requestedSteps > cfg.maxSteps) {
-        throw new EngramAccessInputError(
-          `deepRecall: maxSteps ${requestedSteps} exceeds the configured ceiling ${cfg.maxSteps}`
-        );
-      }
-      effective = { ...cfg, maxSteps: requestedSteps };
-    }
+    const effective = resolveEffectiveDeepRecallConfig(cfg, request.maxSteps);
     const principal = request.authenticatedPrincipal?.trim() || resolvePrincipal(request.sessionKey, this.orchestrator.config);
     const resolvedNamespace = this.resolveReadableNamespace(request.namespace, principal);
     const storage = await this.orchestrator.getStorage(resolvedNamespace);
@@ -15395,6 +15640,10 @@ var EngramAccessService = class extends SupportPassportAccessServiceBase {
     );
     return { ...result, rendered: renderDeepRecallResult(result) };
   }
+  async recallNavigate(request) {
+    const principal = request.authenticatedPrincipal?.trim() || resolvePrincipal(request.sessionKey, this.orchestrator.config);
+    return runRecallNavigation({ config: this.orchestrator.config.recallNavigation ?? RECALL_NAVIGATION_CONFIG_DEFAULTS, recallBudgetChars: this.orchestrator.config.recallBudgetChars, recentServedIds: (sessionKey, depth) => this.orchestrator.handleHistory.recent(sessionKey, depth), resolveReadableNamespace: (ns, p) => this.resolveReadableNamespace(ns, p || void 0), getStorage: (namespace) => this.orchestrator.getStorage(namespace) }, { ...request, authenticatedPrincipal: (principal ?? "").length > 0 ? principal : void 0 });
+  }
   async recallXray(request) {
     return this.accessRecallSurface.recallXray(request);
   }
@@ -17918,6 +18167,7 @@ export {
   resolveNamespaceWritablePreflight,
   resolveAuthorizedNamespaceWritablePreflight,
   resolveQueryNamespaceWritablePreflight,
+  runRecallNavigation,
   runProcedureLibraryMaintenance,
   computeProcedureStats,
   formatProcedureStatsText,
@@ -17988,4 +18238,4 @@ export {
   EngramAccessService,
   AccessAdminOpsSurface
 };
-//# sourceMappingURL=chunk-IUTYNDFS.js.map
+//# sourceMappingURL=chunk-LXMZM7LM.js.map