@remnic/core 9.69.42 → 9.69.43

package/dist/proactive-contention.d.ts

@@ -1,5 +1,5 @@
-import { L as LocalLlmClient } from './local-llm-Bj-m01Ro.js';
-import { P as PluginConfig } from './types-B65IoepH.js';
+import { L as LocalLlmClient } from './local-llm-3-jtw52a.js';
+import { P as PluginConfig } from './types-Sps-lg5I.js';
 import './model-registry.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
@@ -10,6 +10,7 @@ import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './background-generation-config.js';
 import './deep-recall-config.js';
+import './recall-navigation-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';

package/dist/provenance.d.ts

@@ -1,4 +1,4 @@
-import { U as ProvenanceSource, ay as ProvenanceConfig, m as MemoryFrontmatter } from './types-B65IoepH.js';
+import { U as ProvenanceSource, ay as ProvenanceConfig, m as MemoryFrontmatter } from './types-Sps-lg5I.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -8,6 +8,7 @@ import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './background-generation-config.js';
 import './deep-recall-config.js';
+import './recall-navigation-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';

package/dist/{public-http-CjiSqxUx.d.ts → public-http-B55s59aR.d.ts}

@@ -1,5 +1,5 @@
 import { IncomingMessage, ServerResponse } from 'node:http';
-import { f as EngramAccessService } from './access-service-DjG_e2cM.js';
+import { f as EngramAccessService } from './access-service-DxTTTg9O.js';
 
 declare const SUPPORT_PASSPORT_PUBLIC_HTTP_ROUTES: readonly [{
     readonly method: "GET";

package/dist/{qmd-CnxVjKrv.d.ts → qmd-DOLTPIQg.d.ts}

@@ -1,6 +1,6 @@
 import { QmdStatusReport } from './qmd-status.js';
 import { SearchBackend, SearchExecutionOptions, SearchQueryOptions } from './search/port.js';
-import { Q as QmdSearchResult, aU as QmdSearchExplain } from './types-B65IoepH.js';
+import { Q as QmdSearchResult, aU as QmdSearchExplain } from './types-Sps-lg5I.js';
 
 declare const QMD_PROBE_TIMEOUT_MS = 8000;
 declare const QMD_PROBE_RETRY_BACKOFF_MS: number[];

package/dist/qmd-preflight.d.ts

@@ -1,7 +1,7 @@
-export { a as QMD_PROBE_RETRY_BACKOFF_MS, b as QMD_PROBE_TIMEOUT_MS, c as QMD_SUPPORTED_VERSION, d as QmdProbeFailureKind, e as classifyProbeFailure, f as compareQmdVersions, g as getQmdPostInstallProbeTargets, p as parseQmdVersion, h as parseQmdVersionOutput, q as qmdVersionToString, r as resolveQmdCapabilities, s as shouldAutoUpgradeQmd, v as versionAtLeast } from './qmd-CnxVjKrv.js';
+export { a as QMD_PROBE_RETRY_BACKOFF_MS, b as QMD_PROBE_TIMEOUT_MS, c as QMD_SUPPORTED_VERSION, d as QmdProbeFailureKind, e as classifyProbeFailure, f as compareQmdVersions, g as getQmdPostInstallProbeTargets, p as parseQmdVersion, h as parseQmdVersionOutput, q as qmdVersionToString, r as resolveQmdCapabilities, s as shouldAutoUpgradeQmd, v as versionAtLeast } from './qmd-DOLTPIQg.js';
 import './qmd-status.js';
 import './search/port.js';
-import './types-B65IoepH.js';
+import './types-Sps-lg5I.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -11,6 +11,7 @@ import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './background-generation-config.js';
 import './deep-recall-config.js';
+import './recall-navigation-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';

package/dist/qmd-recall-cache.d.ts

@@ -1,4 +1,4 @@
-import { R as RecallPlanMode } from './types-B65IoepH.js';
+import { R as RecallPlanMode } from './types-Sps-lg5I.js';
 import { SearchQueryOptions } from './search/port.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
@@ -9,6 +9,7 @@ import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './background-generation-config.js';
 import './deep-recall-config.js';
+import './recall-navigation-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';

package/dist/qmd.d.ts

@@ -1,7 +1,7 @@
-export { c as QMD_SUPPORTED_VERSION, i as QmdCapabilities, j as QmdChunkStrategy, Q as QmdClient, k as QmdClientOptions, l as QmdDoctorReport, m as QmdSearchStrategy, n as QmdStructuredSearch, o as QmdStructuredSearchType, t as QmdSubprocessStrategy, u as QmdVersionStatus, w as QmdVersionTuple, x as buildDefaultStructuredSearches, f as compareQmdVersions, y as getQmdCommandName, g as getQmdPostInstallProbeTargets, z as parseQmdExplain, p as parseQmdVersion, h as parseQmdVersionOutput, A as releaseSharedDaemonSessionForTest, r as resolveQmdCapabilities, B as retainSharedDaemonSessionForTest, C as runCommandWithTimeoutForTest, D as sharedDaemonSessionCountForTest, s as shouldAutoUpgradeQmd, v as versionAtLeast } from './qmd-CnxVjKrv.js';
+export { c as QMD_SUPPORTED_VERSION, i as QmdCapabilities, j as QmdChunkStrategy, Q as QmdClient, k as QmdClientOptions, l as QmdDoctorReport, m as QmdSearchStrategy, n as QmdStructuredSearch, o as QmdStructuredSearchType, t as QmdSubprocessStrategy, u as QmdVersionStatus, w as QmdVersionTuple, x as buildDefaultStructuredSearches, f as compareQmdVersions, y as getQmdCommandName, g as getQmdPostInstallProbeTargets, z as parseQmdExplain, p as parseQmdVersion, h as parseQmdVersionOutput, A as releaseSharedDaemonSessionForTest, r as resolveQmdCapabilities, B as retainSharedDaemonSessionForTest, C as runCommandWithTimeoutForTest, D as sharedDaemonSessionCountForTest, s as shouldAutoUpgradeQmd, v as versionAtLeast } from './qmd-DOLTPIQg.js';
 export { QmdStatusReport, parseQmdStatusOutput } from './qmd-status.js';
 import './search/port.js';
-import './types-B65IoepH.js';
+import './types-Sps-lg5I.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -11,6 +11,7 @@ import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './background-generation-config.js';
 import './deep-recall-config.js';
+import './recall-navigation-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';

package/dist/recall-concurrency-config.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig } from './types-B65IoepH.js';
+import { P as PluginConfig } from './types-Sps-lg5I.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -8,6 +8,7 @@ import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './background-generation-config.js';
 import './deep-recall-config.js';
+import './recall-navigation-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';

package/dist/recall-disclosure-escalation.d.ts

@@ -1,4 +1,4 @@
-import { o as RecallDisclosure } from './types-B65IoepH.js';
+import { o as RecallDisclosure } from './types-Sps-lg5I.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -8,6 +8,7 @@ import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './background-generation-config.js';
 import './deep-recall-config.js';
+import './recall-navigation-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';

package/dist/recall-explain-renderer.d.ts

@@ -1,5 +1,5 @@
 import { LastRecallSnapshot } from './recall-state.js';
-import { b as RecallTierExplain } from './types-B65IoepH.js';
+import { b as RecallTierExplain } from './types-Sps-lg5I.js';
 import { RecallXraySnapshot } from './recall-xray.js';
 import './utils/serialize-mutations.js';
 import './search/port.js';
@@ -12,6 +12,7 @@ import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './background-generation-config.js';
 import './deep-recall-config.js';
+import './recall-navigation-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';

package/dist/recall-explain-renderer.js

@@ -5,10 +5,10 @@ import {
   toRecallExplainJson,
   toRecallExplainText,
   toRecallXraySnapshotFromLegacy
-} from "./chunk-AUSRUOMQ.js";
+} from "./chunk-PW4HTWXL.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-Q62GA5U2.js";
-import "./chunk-WN2OXGGH.js";
+import "./chunk-VW5TGNJN.js";
+import "./chunk-66YUOI53.js";
 import "./chunk-TOTT6S2V.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";

package/dist/recall-memory-map.d.ts

@@ -1,4 +1,4 @@
-import { Q as QmdSearchResult, M as MemoryFile } from './types-B65IoepH.js';
+import { Q as QmdSearchResult, M as MemoryFile } from './types-Sps-lg5I.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -8,6 +8,7 @@ import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './background-generation-config.js';
 import './deep-recall-config.js';
+import './recall-navigation-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';

package/dist/recall-navigate-access.d.ts

@@ -1,5 +1,5 @@
 import { RecallNavNode, RecallNavExpandResult, RecallNavTraverseResult } from './recall-navigate.js';
-import './types-B65IoepH.js';
+import './types-Sps-lg5I.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -9,6 +9,7 @@ import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './background-generation-config.js';
 import './deep-recall-config.js';
+import './recall-navigation-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';

package/dist/recall-navigate-access.js

@@ -1,8 +1,8 @@
 import {
   expandRecallNode,
   traverseRecallLink
-} from "./chunk-4IGOLIWM.js";
-import "./chunk-WN2OXGGH.js";
+} from "./chunk-L63M2PE4.js";
+import "./chunk-66YUOI53.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/recall-navigate-access.ts

package/dist/recall-navigate-budget.js

@@ -1,17 +1,7 @@
+import {
+  takeNavigateBudget
+} from "./chunk-VYDGHJIN.js";
 import "./chunk-PZ5AY32C.js";
-
-// src/recall-navigate-budget.ts
-function takeNavigateBudget(budget, cost) {
-  if (budget < 0 || cost < 0) {
-    throw new Error(
-      `navigate budget and cost must be non-negative; got budget=${JSON.stringify(budget)} cost=${JSON.stringify(cost)}`
-    );
-  }
-  if (budget === 0 || cost > budget) {
-    return { ok: false, error: "budget_exhausted" };
-  }
-  return { ok: true, remaining: budget - cost };
-}
 export {
   takeNavigateBudget
 };

package/dist/recall-navigate-budget.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/recall-navigate-budget.ts"],"sourcesContent":["/**\n * Recall navigation budget take (issue #1956 leftover).\n *\n * Pure. Surfaces wait. Budget 0 or cost above budget is exhausted.\n * Negative budget or cost throws.\n */\n\nexport type NavigateBudgetResult =\n  | { ok: true; remaining: number }\n  | { ok: false; error: \"budget_exhausted\" };\n\nexport function takeNavigateBudget(budget: number, cost: number): NavigateBudgetResult {\n  if (budget < 0 || cost < 0) {\n    throw new Error(\n      `navigate budget and cost must be non-negative; got budget=${JSON.stringify(budget)} cost=${JSON.stringify(cost)}`,\n    );\n  }\n  if (budget === 0 || cost > budget) {\n    return { ok: false, error: \"budget_exhausted\" };\n  }\n  return { ok: true, remaining: budget - cost };\n}\n"],"mappings":";;;AAWO,SAAS,mBAAmB,QAAgB,MAAoC;AACrF,MAAI,SAAS,KAAK,OAAO,GAAG;AAC1B,UAAM,IAAI;AAAA,MACR,6DAA6D,KAAK,UAAU,MAAM,CAAC,SAAS,KAAK,UAAU,IAAI,CAAC;AAAA,IAClH;AAAA,EACF;AACA,MAAI,WAAW,KAAK,OAAO,QAAQ;AACjC,WAAO,EAAE,IAAI,OAAO,OAAO,mBAAmB;AAAA,EAChD;AACA,SAAO,EAAE,IAAI,MAAM,WAAW,SAAS,KAAK;AAC9C;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/recall-navigate-disclosure.d.ts

@@ -1,4 +1,4 @@
-import { o as RecallDisclosure } from './types-B65IoepH.js';
+import { o as RecallDisclosure } from './types-Sps-lg5I.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -8,6 +8,7 @@ import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './background-generation-config.js';
 import './deep-recall-config.js';
+import './recall-navigation-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';

package/dist/recall-navigate-disclosure.js

@@ -1,28 +1,9 @@
 import {
-  RECALL_DISCLOSURE_LEVELS,
-  isRecallDisclosure
-} from "./chunk-WN2OXGGH.js";
+  disclosureRank,
+  planDisclosureStep
+} from "./chunk-AS2NOPDM.js";
+import "./chunk-66YUOI53.js";
 import "./chunk-PZ5AY32C.js";
-
-// src/recall-navigate-disclosure.ts
-function disclosureRank(level) {
-  const index = RECALL_DISCLOSURE_LEVELS.indexOf(level);
-  if (index < 0) {
-    throw new RangeError(
-      `unknown disclosure level ${JSON.stringify(level)}; expected one of ${RECALL_DISCLOSURE_LEVELS.join(", ")}`
-    );
-  }
-  return index;
-}
-function planDisclosureStep(input) {
-  if (!isRecallDisclosure(input.from) || !isRecallDisclosure(input.to)) {
-    return { ok: false, error: "unknown_level" };
-  }
-  const fromRank = disclosureRank(input.from);
-  const toRank = disclosureRank(input.to);
-  if (toRank <= fromRank) return { ok: false, error: "not_deeper" };
-  return { ok: true, from: input.from, to: input.to, steps: toRank - fromRank };
-}
 export {
   disclosureRank,
   planDisclosureStep

package/dist/recall-navigate-disclosure.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/recall-navigate-disclosure.ts"],"sourcesContent":["/**\n * Disclosure-step planning for recall navigation (issue #1956).\n *\n * The ladder itself is NOT redefined here: `types.ts` designates\n * `RECALL_DISCLOSURE_LEVELS` the single source of truth and forbids\n * hard-coding disclosure strings elsewhere, so a second copy could drift out\n * of agreement with recall validation and rendering. This module only adds\n * the rule that an expansion must go strictly deeper, so a caller cannot\n * re-pay recall budget for output it already holds. Pure — no I/O.\n */\n\nimport {\n  isRecallDisclosure,\n  RECALL_DISCLOSURE_LEVELS,\n  type RecallDisclosure,\n} from \"./types.js\";\n\nexport type DisclosureStepResult =\n  | { ok: true; from: RecallDisclosure; to: RecallDisclosure; steps: number }\n  | { ok: false; error: \"unknown_level\" | \"not_deeper\" };\n\n/** Index in the canonical shallow-to-deep ladder. Throws for a non-level. */\nexport function disclosureRank(level: string): number {\n  const index = (RECALL_DISCLOSURE_LEVELS as readonly string[]).indexOf(level);\n  if (index < 0) {\n    throw new RangeError(\n      `unknown disclosure level ${JSON.stringify(level)}; expected one of ${RECALL_DISCLOSURE_LEVELS.join(\", \")}`,\n    );\n  }\n  return index;\n}\n\n/**\n * Plan one expansion. A bad level from an agent is a typed refusal rather\n * than a throw; equal or shallower targets are `not_deeper`.\n */\nexport function planDisclosureStep(input: { from: string; to: string }): DisclosureStepResult {\n  if (!isRecallDisclosure(input.from) || !isRecallDisclosure(input.to)) {\n    return { ok: false, error: \"unknown_level\" };\n  }\n  const fromRank = disclosureRank(input.from);\n  const toRank = disclosureRank(input.to);\n  if (toRank <= fromRank) return { ok: false, error: \"not_deeper\" };\n  return { ok: true, from: input.from, to: input.to, steps: toRank - fromRank };\n}\n"],"mappings":";;;;;;;AAsBO,SAAS,eAAe,OAAuB;AACpD,QAAM,QAAS,yBAA+C,QAAQ,KAAK;AAC3E,MAAI,QAAQ,GAAG;AACb,UAAM,IAAI;AAAA,MACR,4BAA4B,KAAK,UAAU,KAAK,CAAC,qBAAqB,yBAAyB,KAAK,IAAI,CAAC;AAAA,IAC3G;AAAA,EACF;AACA,SAAO;AACT;AAMO,SAAS,mBAAmB,OAA2D;AAC5F,MAAI,CAAC,mBAAmB,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,GAAG;AACpE,WAAO,EAAE,IAAI,OAAO,OAAO,gBAAgB;AAAA,EAC7C;AACA,QAAM,WAAW,eAAe,MAAM,IAAI;AAC1C,QAAM,SAAS,eAAe,MAAM,EAAE;AACtC,MAAI,UAAU,SAAU,QAAO,EAAE,IAAI,OAAO,OAAO,aAAa;AAChE,SAAO,EAAE,IAAI,MAAM,MAAM,MAAM,MAAM,IAAI,MAAM,IAAI,OAAO,SAAS,SAAS;AAC9E;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/recall-navigate-traverse.js

@@ -1,42 +1,9 @@
 import {
-  parseNavigateLinkType
-} from "./chunk-7O5EW7KX.js";
+  DEFAULT_TRAVERSE_LIMIT,
+  selectTraverseNeighbors
+} from "./chunk-YE4JBZO5.js";
+import "./chunk-7O5EW7KX.js";
 import "./chunk-PZ5AY32C.js";
-
-// src/recall-navigate-traverse.ts
-var DEFAULT_TRAVERSE_LIMIT = 10;
-function selectTraverseNeighbors(input) {
-  const limit = input.limit ?? DEFAULT_TRAVERSE_LIMIT;
-  if (!Number.isFinite(limit) || !Number.isInteger(limit) || limit < 1) {
-    return { ok: false, error: "invalid_limit" };
-  }
-  if (input.relation !== void 0 && !parseNavigateLinkType(input.relation).ok) {
-    return { ok: false, error: "unknown_relation" };
-  }
-  const kept = [];
-  for (const link of input.links) {
-    if (!parseNavigateLinkType(link.linkType).ok) continue;
-    if (input.relation !== void 0 && link.linkType !== input.relation) continue;
-    if (typeof link.targetId !== "string" || link.targetId.trim() === "" || link.targetId.trim() !== link.targetId) {
-      continue;
-    }
-    kept.push({ targetId: link.targetId, linkType: link.linkType });
-  }
-  kept.sort((a, b) => {
-    if (a.linkType !== b.linkType) return a.linkType < b.linkType ? -1 : 1;
-    if (a.targetId !== b.targetId) return a.targetId < b.targetId ? -1 : 1;
-    return 0;
-  });
-  const seen = /* @__PURE__ */ new Set();
-  const deduped = [];
-  for (const link of kept) {
-    if (seen.has(link.targetId)) continue;
-    seen.add(link.targetId);
-    deduped.push(link);
-  }
-  const truncated = deduped.length > limit;
-  return { ok: true, neighbors: truncated ? deduped.slice(0, limit) : deduped, truncated };
-}
 export {
   DEFAULT_TRAVERSE_LIMIT,
   selectTraverseNeighbors

package/dist/recall-navigate-traverse.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/recall-navigate-traverse.ts"],"sourcesContent":["/**\n * Recall navigation traverse selection (issue #1956).\n *\n * Pure selection step for `traverseLinks(id, relation?, limit)`: given a\n * recalled memory's links, pick which neighbors a traverse would visit.\n * Internal; surfaces wire it in a later slice.\n */\nimport { parseNavigateLinkType } from \"./recall-navigate-link.js\";\n\nexport const DEFAULT_TRAVERSE_LIMIT = 10;\n\nexport interface TraverseNeighbor {\n  targetId: string;\n  linkType: string;\n}\n\nexport type TraverseSelectionResult =\n  | { ok: true; neighbors: TraverseNeighbor[]; truncated: boolean }\n  | { ok: false; error: \"unknown_relation\" | \"invalid_limit\" };\n\nexport function selectTraverseNeighbors(input: {\n  links: readonly TraverseNeighbor[];\n  /** Optional relation filter; omitted means every known relation. */\n  relation?: string;\n  limit?: number;\n}): TraverseSelectionResult {\n  const limit = input.limit ?? DEFAULT_TRAVERSE_LIMIT;\n  if (!Number.isFinite(limit) || !Number.isInteger(limit) || limit < 1) {\n    return { ok: false, error: \"invalid_limit\" };\n  }\n  if (input.relation !== undefined && !parseNavigateLinkType(input.relation).ok) {\n    return { ok: false, error: \"unknown_relation\" };\n  }\n\n  const kept: TraverseNeighbor[] = [];\n  // Asymmetry is intentional: a bad request (unknown relation, invalid\n  // limit) is refused, but bad stored data is skipped — stored data may\n  // predate a type or carry a malformed id, and one bad row must not fail\n  // the whole traverse. A targetId that is not a non-blank string, including\n  // undefined/null and whitespace-only, is malformed and skipped. Padded ids\n  // are NOT trimmed into validity: an id is an exact identity, and guessing\n  // the intended target is worse than skipping the row.\n  for (const link of input.links) {\n    if (!parseNavigateLinkType(link.linkType).ok) continue;\n    if (input.relation !== undefined && link.linkType !== input.relation) continue;\n    if (typeof link.targetId !== \"string\" || link.targetId.trim() === \"\" || link.targetId.trim() !== link.targetId) {\n      continue;\n    }\n    kept.push({ targetId: link.targetId, linkType: link.linkType });\n  }\n\n  // Sort BEFORE deduplicating: first-occurrence dedup on an unsorted list\n  // lets input order decide which relation survives for a target that is\n  // linked under two types, and after the cap is applied, which target is\n  // returned at all. Sorting first makes the survivor deterministic\n  // (smallest linkType wins the tie).\n  kept.sort((a, b) => {\n    if (a.linkType !== b.linkType) return a.linkType < b.linkType ? -1 : 1;\n    if (a.targetId !== b.targetId) return a.targetId < b.targetId ? -1 : 1;\n    return 0;\n  });\n\n  const seen = new Set<string>();\n  const deduped: TraverseNeighbor[] = [];\n  for (const link of kept) {\n    if (seen.has(link.targetId)) continue;\n    seen.add(link.targetId);\n    deduped.push(link);\n  }\n\n  const truncated = deduped.length > limit;\n  return { ok: true, neighbors: truncated ? deduped.slice(0, limit) : deduped, truncated };\n}\n"],"mappings":";;;;;;AASO,IAAM,yBAAyB;AAW/B,SAAS,wBAAwB,OAKZ;AAC1B,QAAM,QAAQ,MAAM,SAAS;AAC7B,MAAI,CAAC,OAAO,SAAS,KAAK,KAAK,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,GAAG;AACpE,WAAO,EAAE,IAAI,OAAO,OAAO,gBAAgB;AAAA,EAC7C;AACA,MAAI,MAAM,aAAa,UAAa,CAAC,sBAAsB,MAAM,QAAQ,EAAE,IAAI;AAC7E,WAAO,EAAE,IAAI,OAAO,OAAO,mBAAmB;AAAA,EAChD;AAEA,QAAM,OAA2B,CAAC;AAQlC,aAAW,QAAQ,MAAM,OAAO;AAC9B,QAAI,CAAC,sBAAsB,KAAK,QAAQ,EAAE,GAAI;AAC9C,QAAI,MAAM,aAAa,UAAa,KAAK,aAAa,MAAM,SAAU;AACtE,QAAI,OAAO,KAAK,aAAa,YAAY,KAAK,SAAS,KAAK,MAAM,MAAM,KAAK,SAAS,KAAK,MAAM,KAAK,UAAU;AAC9G;AAAA,IACF;AACA,SAAK,KAAK,EAAE,UAAU,KAAK,UAAU,UAAU,KAAK,SAAS,CAAC;AAAA,EAChE;AAOA,OAAK,KAAK,CAAC,GAAG,MAAM;AAClB,QAAI,EAAE,aAAa,EAAE,SAAU,QAAO,EAAE,WAAW,EAAE,WAAW,KAAK;AACrE,QAAI,EAAE,aAAa,EAAE,SAAU,QAAO,EAAE,WAAW,EAAE,WAAW,KAAK;AACrE,WAAO;AAAA,EACT,CAAC;AAED,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,UAA8B,CAAC;AACrC,aAAW,QAAQ,MAAM;AACvB,QAAI,KAAK,IAAI,KAAK,QAAQ,EAAG;AAC7B,SAAK,IAAI,KAAK,QAAQ;AACtB,YAAQ,KAAK,IAAI;AAAA,EACnB;AAEA,QAAM,YAAY,QAAQ,SAAS;AACnC,SAAO,EAAE,IAAI,MAAM,WAAW,YAAY,QAAQ,MAAM,GAAG,KAAK,IAAI,SAAS,UAAU;AACzF;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/recall-navigate-window.js

@@ -1,30 +1,8 @@
+import {
+  DEFAULT_NAVIGATION_WINDOW_SNAPSHOTS,
+  assertIdInNavigationWindow
+} from "./chunk-5KVT6G5U.js";
 import "./chunk-PZ5AY32C.js";
-
-// src/recall-navigate-window.ts
-var DEFAULT_NAVIGATION_WINDOW_SNAPSHOTS = 3;
-function assertIdInNavigationWindow(input) {
-  const windowSnapshots = input.windowSnapshots ?? DEFAULT_NAVIGATION_WINDOW_SNAPSHOTS;
-  if (!Number.isInteger(windowSnapshots) || windowSnapshots < 1) {
-    throw new RangeError(
-      `windowSnapshots must be a positive integer; got ${JSON.stringify(windowSnapshots)}`
-    );
-  }
-  if (typeof input.memoryId !== "string" || input.memoryId.trim() === "") {
-    return { ok: false, error: "empty_id" };
-  }
-  const wanted = input.memoryId.trim();
-  for (const snapshot of input.snapshots.slice(0, windowSnapshots)) {
-    if (!snapshot || !Array.isArray(snapshot.servedIds)) {
-      continue;
-    }
-    for (const served of snapshot.servedIds) {
-      if (typeof served === "string" && served.trim() === wanted) {
-        return { ok: true, memoryId: wanted };
-      }
-    }
-  }
-  return { ok: false, error: "not_served" };
-}
 export {
   DEFAULT_NAVIGATION_WINDOW_SNAPSHOTS,
   assertIdInNavigationWindow

package/dist/recall-navigate-window.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/recall-navigate-window.ts"],"sourcesContent":["/**\n * Recall navigation window authority (issue #1956).\n *\n * Pure. An expandable id must have been served by one of the session's\n * last `windowSnapshots` recall snapshots, ordered newest first. Unknown\n * or foreign ids are rejected, not reinterpreted (pattern 39).\n */\n\nexport const DEFAULT_NAVIGATION_WINDOW_SNAPSHOTS = 3;\n\n/** Ids served by one recall snapshot, newest snapshot first when passed in. */\nexport interface NavigationSnapshot {\n  servedIds: readonly string[];\n}\n\nexport type NavigationAuthorityResult =\n  | { ok: true; memoryId: string }\n  | { ok: false; error: \"empty_id\" | \"not_served\" };\n\nexport function assertIdInNavigationWindow(input: {\n  snapshots: readonly NavigationSnapshot[];\n  memoryId: unknown;\n  windowSnapshots?: number;\n}): NavigationAuthorityResult {\n  const windowSnapshots = input.windowSnapshots ?? DEFAULT_NAVIGATION_WINDOW_SNAPSHOTS;\n  if (!Number.isInteger(windowSnapshots) || windowSnapshots < 1) {\n    throw new RangeError(\n      `windowSnapshots must be a positive integer; got ${JSON.stringify(windowSnapshots)}`,\n    );\n  }\n  if (typeof input.memoryId !== \"string\" || input.memoryId.trim() === \"\") {\n    return { ok: false, error: \"empty_id\" };\n  }\n  const wanted = input.memoryId.trim();\n  for (const snapshot of input.snapshots.slice(0, windowSnapshots)) {\n    // A malformed entry (missing or non-array servedIds) was still a real\n    // recall turn: it consumes a window slot but contributes no ids.\n    if (!snapshot || !Array.isArray(snapshot.servedIds)) {\n      continue;\n    }\n    for (const served of snapshot.servedIds) {\n      if (typeof served === \"string\" && served.trim() === wanted) {\n        return { ok: true, memoryId: wanted };\n      }\n    }\n  }\n  return { ok: false, error: \"not_served\" };\n}\n"],"mappings":";;;AAQO,IAAM,sCAAsC;AAW5C,SAAS,2BAA2B,OAIb;AAC5B,QAAM,kBAAkB,MAAM,mBAAmB;AACjD,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,kBAAkB,GAAG;AAC7D,UAAM,IAAI;AAAA,MACR,mDAAmD,KAAK,UAAU,eAAe,CAAC;AAAA,IACpF;AAAA,EACF;AACA,MAAI,OAAO,MAAM,aAAa,YAAY,MAAM,SAAS,KAAK,MAAM,IAAI;AACtE,WAAO,EAAE,IAAI,OAAO,OAAO,WAAW;AAAA,EACxC;AACA,QAAM,SAAS,MAAM,SAAS,KAAK;AACnC,aAAW,YAAY,MAAM,UAAU,MAAM,GAAG,eAAe,GAAG;AAGhE,QAAI,CAAC,YAAY,CAAC,MAAM,QAAQ,SAAS,SAAS,GAAG;AACnD;AAAA,IACF;AACA,eAAW,UAAU,SAAS,WAAW;AACvC,UAAI,OAAO,WAAW,YAAY,OAAO,KAAK,MAAM,QAAQ;AAC1D,eAAO,EAAE,IAAI,MAAM,UAAU,OAAO;AAAA,MACtC;AAAA,IACF;AAAA,EACF;AACA,SAAO,EAAE,IAAI,OAAO,OAAO,aAAa;AAC1C;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/recall-navigate.d.ts

@@ -1,4 +1,4 @@
-import { o as RecallDisclosure } from './types-B65IoepH.js';
+import { o as RecallDisclosure } from './types-Sps-lg5I.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
@@ -8,6 +8,7 @@ import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './background-generation-config.js';
 import './deep-recall-config.js';
+import './recall-navigation-config.js';
 import './causal-trajectory.js';
 import './objective-state.js';
 import './active-context-config.js';

package/dist/recall-navigate.js

@@ -3,8 +3,8 @@ import {
   expandRecallNode,
   isRecallNavLinkType,
   traverseRecallLink
-} from "./chunk-4IGOLIWM.js";
-import "./chunk-WN2OXGGH.js";
+} from "./chunk-L63M2PE4.js";
+import "./chunk-66YUOI53.js";
 import "./chunk-PZ5AY32C.js";
 export {
   RECALL_NAV_LINK_TYPES,

package/dist/recall-navigation-config.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Recall-navigation config (issue #1956) — the `recallNavigation` block.
+ *
+ * Parsed the same way `deepRecall` is: shape-validated, string-coercion
+ * safe (§24), no silent clamping of documented values (§33). Navigation is
+ * a read-only surface over already-served recall results, so it defaults
+ * ON; the `conservative` preset pins `enabled: false`.
+ */
+interface RecallNavigationConfig {
+    /** Master switch. Default true (read-only, additive surface). */
+    enabled: boolean;
+    /**
+     * How many of the session's most recent recall snapshots an expandable
+     * or traversable id may come from. Default 3.
+     */
+    windowSnapshots: number;
+    /** Ceiling for a traverse/entity-neighbor limit override. Default 10. */
+    maxNeighbors: number;
+}
+interface RecallNavigationSettings {
+    recallNavigation: RecallNavigationConfig;
+}
+declare const DEFAULT_NAVIGATION_WINDOW_SNAPSHOTS = 3;
+declare const RECALL_NAVIGATION_CONFIG_DEFAULTS: RecallNavigationConfig;
+/** Record served ids when display handles or navigation authority needs them. */
+declare function shouldRecordRecallAuthorityHistory(config: {
+    recallMemoryHandles?: boolean;
+    recallNavigation?: {
+        enabled?: boolean;
+    };
+}): boolean;
+declare function parseRecallNavigationConfig(raw: unknown): RecallNavigationConfig;
+
+export { DEFAULT_NAVIGATION_WINDOW_SNAPSHOTS, RECALL_NAVIGATION_CONFIG_DEFAULTS, type RecallNavigationConfig, type RecallNavigationSettings, parseRecallNavigationConfig, shouldRecordRecallAuthorityHistory };

package/dist/recall-navigation-config.js

@@ -0,0 +1,16 @@
+import {
+  DEFAULT_NAVIGATION_WINDOW_SNAPSHOTS,
+  RECALL_NAVIGATION_CONFIG_DEFAULTS,
+  parseRecallNavigationConfig,
+  shouldRecordRecallAuthorityHistory
+} from "./chunk-LVTT5AUG.js";
+import "./chunk-PQVCH2AE.js";
+import "./chunk-3WCASNQZ.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  DEFAULT_NAVIGATION_WINDOW_SNAPSHOTS,
+  RECALL_NAVIGATION_CONFIG_DEFAULTS,
+  parseRecallNavigationConfig,
+  shouldRecordRecallAuthorityHistory
+};
+//# sourceMappingURL=recall-navigation-config.js.map

package/dist/recall-navigation-config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}