@remnic/core 9.69.41 → 9.69.43

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

@@ -11,7 +11,7 @@ import {
 } from "./chunk-NHLLKEKK.js";
 import {
   parseConfig
-} from "./chunk-MCMS4VUK.js";
+} from "./chunk-XIJHRQ4A.js";
 import {
   resolveObjectiveStateStoreDir,
   validateObjectiveStateSnapshot
@@ -268,4 +268,4 @@ export {
   recordResumeBundle,
   getResumeBundleStatus
 };
-//# sourceMappingURL=chunk-A4OIJYCV.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":[]}