@remnic/core 9.69.42 → 9.69.44

package/dist/{chunk-IUTYNDFS.js → chunk-3K64PLY3.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-2WMXZYMS.js";
 import {
   applyBriefingLocationContext,
   daySummaryAutoOptions
@@ -277,10 +303,10 @@ import {
 } from "./chunk-VYCOJKSX.js";
 import {
   reapplyCategoryCoercion
-} from "./chunk-ZOGKZ2XT.js";
+} from "./chunk-JUOJGZPV.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-3K64PLY3.js.map