@remnic/core 9.66.1 → 9.66.3

package/dist/recall-deep-budget.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Deep-recall budget clamp (issue #2332 leftover).
+ *
+ * Pure. Surfaces wait. 0 stays 0. Positive integers pass through.
+ * Negative, non-finite, and non-integer values throw.
+ */
+declare function clampDeepRecallBudget(n: number): number;
+
+export { clampDeepRecallBudget };

package/dist/recall-deep-budget.js

@@ -0,0 +1,15 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-deep-budget.ts
+function clampDeepRecallBudget(n) {
+  if (!Number.isFinite(n) || !Number.isInteger(n) || n < 0) {
+    throw new Error(
+      `deep recall budget must be a non-negative integer; got ${JSON.stringify(n)}`
+    );
+  }
+  return n;
+}
+export {
+  clampDeepRecallBudget
+};
+//# sourceMappingURL=recall-deep-budget.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-deep-budget.ts"],"sourcesContent":["/**\n * Deep-recall budget clamp (issue #2332 leftover).\n *\n * Pure. Surfaces wait. 0 stays 0. Positive integers pass through.\n * Negative, non-finite, and non-integer values throw.\n */\nexport function clampDeepRecallBudget(n: number): number {\n  if (!Number.isFinite(n) || !Number.isInteger(n) || n < 0) {\n    throw new Error(\n      `deep recall budget must be a non-negative integer; got ${JSON.stringify(n)}`,\n    );\n  }\n  return n;\n}\n"],"mappings":";;;AAMO,SAAS,sBAAsB,GAAmB;AACvD,MAAI,CAAC,OAAO,SAAS,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,KAAK,IAAI,GAAG;AACxD,UAAM,IAAI;AAAA,MACR,0DAA0D,KAAK,UAAU,CAAC,CAAC;AAAA,IAC7E;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/dist/recall-deep-expand.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Deep-recall one-shot expand gate (issue #2332 leftover).
+ *
+ * Pure. Surfaces wait. Already expanded or budget 0 refuse.
+ * Negative budget throws.
+ */
+declare function mayExpandOnce(input: {
+    alreadyExpanded: boolean;
+    budgetLeft: number;
+}): boolean;
+
+export { mayExpandOnce };

package/dist/recall-deep-expand.js

@@ -0,0 +1,17 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-deep-expand.ts
+function mayExpandOnce(input) {
+  if (input.budgetLeft < 0) {
+    throw new Error(
+      `deep recall expand budget must not be negative; got ${JSON.stringify(input.budgetLeft)}`
+    );
+  }
+  if (input.alreadyExpanded) return false;
+  if (input.budgetLeft === 0) return false;
+  return true;
+}
+export {
+  mayExpandOnce
+};
+//# sourceMappingURL=recall-deep-expand.js.map

package/dist/recall-deep-expand.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-deep-expand.ts"],"sourcesContent":["/**\n * Deep-recall one-shot expand gate (issue #2332 leftover).\n *\n * Pure. Surfaces wait. Already expanded or budget 0 refuse.\n * Negative budget throws.\n */\nexport function mayExpandOnce(input: {\n  alreadyExpanded: boolean;\n  budgetLeft: number;\n}): boolean {\n  if (input.budgetLeft < 0) {\n    throw new Error(\n      `deep recall expand budget must not be negative; got ${JSON.stringify(input.budgetLeft)}`,\n    );\n  }\n  if (input.alreadyExpanded) return false;\n  if (input.budgetLeft === 0) return false;\n  return true;\n}\n"],"mappings":";;;AAMO,SAAS,cAAc,OAGlB;AACV,MAAI,MAAM,aAAa,GAAG;AACxB,UAAM,IAAI;AAAA,MACR,uDAAuD,KAAK,UAAU,MAAM,UAAU,CAAC;AAAA,IACzF;AAAA,EACF;AACA,MAAI,MAAM,gBAAiB,QAAO;AAClC,MAAI,MAAM,eAAe,EAAG,QAAO;AACnC,SAAO;AACT;","names":[]}

package/dist/recall-deep-policy.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Parse a deep-recall policy name (issue #2332 leftover).
+ *
+ * Pure. Surfaces wait. Unknown or empty values fail closed.
+ */
+declare const DEEP_POLICY_NAMES: readonly ["stop", "expand-once"];
+type DeepPolicyName = (typeof DEEP_POLICY_NAMES)[number];
+type ParseDeepPolicyNameResult = {
+    ok: true;
+    policy: DeepPolicyName;
+} | {
+    ok: false;
+    error: "unknown_policy";
+};
+declare function parseDeepPolicyName(value: unknown): ParseDeepPolicyNameResult;
+
+export { DEEP_POLICY_NAMES, type DeepPolicyName, type ParseDeepPolicyNameResult, parseDeepPolicyName };

package/dist/recall-deep-policy.js

@@ -0,0 +1,18 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-deep-policy.ts
+var DEEP_POLICY_NAMES = ["stop", "expand-once"];
+function parseDeepPolicyName(value) {
+  if (typeof value !== "string" || value.length === 0) {
+    return { ok: false, error: "unknown_policy" };
+  }
+  if (!DEEP_POLICY_NAMES.includes(value)) {
+    return { ok: false, error: "unknown_policy" };
+  }
+  return { ok: true, policy: value };
+}
+export {
+  DEEP_POLICY_NAMES,
+  parseDeepPolicyName
+};
+//# sourceMappingURL=recall-deep-policy.js.map

package/dist/recall-deep-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-deep-policy.ts"],"sourcesContent":["/**\n * Parse a deep-recall policy name (issue #2332 leftover).\n *\n * Pure. Surfaces wait. Unknown or empty values fail closed.\n */\nexport const DEEP_POLICY_NAMES = [\"stop\", \"expand-once\"] as const;\n\nexport type DeepPolicyName = (typeof DEEP_POLICY_NAMES)[number];\n\nexport type ParseDeepPolicyNameResult =\n  | { ok: true; policy: DeepPolicyName }\n  | { ok: false; error: \"unknown_policy\" };\n\nexport function parseDeepPolicyName(value: unknown): ParseDeepPolicyNameResult {\n  if (typeof value !== \"string\" || value.length === 0) {\n    return { ok: false, error: \"unknown_policy\" };\n  }\n  if (!(DEEP_POLICY_NAMES as readonly string[]).includes(value)) {\n    return { ok: false, error: \"unknown_policy\" };\n  }\n  return { ok: true, policy: value as DeepPolicyName };\n}\n"],"mappings":";;;AAKO,IAAM,oBAAoB,CAAC,QAAQ,aAAa;AAQhD,SAAS,oBAAoB,OAA2C;AAC7E,MAAI,OAAO,UAAU,YAAY,MAAM,WAAW,GAAG;AACnD,WAAO,EAAE,IAAI,OAAO,OAAO,iBAAiB;AAAA,EAC9C;AACA,MAAI,CAAE,kBAAwC,SAAS,KAAK,GAAG;AAC7D,WAAO,EAAE,IAAI,OAAO,OAAO,iBAAiB;AAAA,EAC9C;AACA,SAAO,EAAE,IAAI,MAAM,QAAQ,MAAwB;AACrD;","names":[]}

package/dist/recall-deep-query.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Parse a deep-recall query (issue #2332 leftover).
+ *
+ * Pure. Surfaces wait. Trim. Empty is empty_query.
+ */
+type ParseDeepQueryResult = {
+    ok: true;
+    query: string;
+} | {
+    ok: false;
+    error: "empty_query";
+};
+declare function parseDeepQuery(value: string): ParseDeepQueryResult;
+
+export { type ParseDeepQueryResult, parseDeepQuery };

package/dist/recall-deep-query.js

@@ -0,0 +1,12 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-deep-query.ts
+function parseDeepQuery(value) {
+  const query = value.trim();
+  if (query.length === 0) return { ok: false, error: "empty_query" };
+  return { ok: true, query };
+}
+export {
+  parseDeepQuery
+};
+//# sourceMappingURL=recall-deep-query.js.map

package/dist/recall-deep-query.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-deep-query.ts"],"sourcesContent":["/**\n * Parse a deep-recall query (issue #2332 leftover).\n *\n * Pure. Surfaces wait. Trim. Empty is empty_query.\n */\n\nexport type ParseDeepQueryResult =\n  | { ok: true; query: string }\n  | { ok: false; error: \"empty_query\" };\n\nexport function parseDeepQuery(value: string): ParseDeepQueryResult {\n  const query = value.trim();\n  if (query.length === 0) return { ok: false, error: \"empty_query\" };\n  return { ok: true, query };\n}\n"],"mappings":";;;AAUO,SAAS,eAAe,OAAqC;AAClE,QAAM,QAAQ,MAAM,KAAK;AACzB,MAAI,MAAM,WAAW,EAAG,QAAO,EAAE,IAAI,OAAO,OAAO,cAAc;AACjE,SAAO,EAAE,IAAI,MAAM,MAAM;AAC3B;","names":[]}

package/dist/recall-deep-refine.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Deep-recall one-shot refine gate (issue #2332 leftover).
+ *
+ * Pure. Surfaces wait. Already refined or budget 0 refuse.
+ * Negative budget throws.
+ */
+declare function mayRefine(input: {
+    refined: boolean;
+    budgetLeft: number;
+}): boolean;
+
+export { mayRefine };

package/dist/recall-deep-refine.js

@@ -0,0 +1,17 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-deep-refine.ts
+function mayRefine(input) {
+  if (input.budgetLeft < 0) {
+    throw new Error(
+      `deep recall refine budget must not be negative; got ${JSON.stringify(input.budgetLeft)}`
+    );
+  }
+  if (input.refined) return false;
+  if (input.budgetLeft === 0) return false;
+  return true;
+}
+export {
+  mayRefine
+};
+//# sourceMappingURL=recall-deep-refine.js.map

package/dist/recall-deep-refine.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-deep-refine.ts"],"sourcesContent":["/**\n * Deep-recall one-shot refine gate (issue #2332 leftover).\n *\n * Pure. Surfaces wait. Already refined or budget 0 refuse.\n * Negative budget throws.\n */\nexport function mayRefine(input: {\n  refined: boolean;\n  budgetLeft: number;\n}): boolean {\n  if (input.budgetLeft < 0) {\n    throw new Error(\n      `deep recall refine budget must not be negative; got ${JSON.stringify(input.budgetLeft)}`,\n    );\n  }\n  if (input.refined) return false;\n  if (input.budgetLeft === 0) return false;\n  return true;\n}\n"],"mappings":";;;AAMO,SAAS,UAAU,OAGd;AACV,MAAI,MAAM,aAAa,GAAG;AACxB,UAAM,IAAI;AAAA,MACR,uDAAuD,KAAK,UAAU,MAAM,UAAU,CAAC;AAAA,IACzF;AAAA,EACF;AACA,MAAI,MAAM,QAAS,QAAO;AAC1B,MAAI,MAAM,eAAe,EAAG,QAAO;AACnC,SAAO;AACT;","names":[]}

package/dist/recall-deep-render.d.ts

@@ -0,0 +1,11 @@
+import { DeepRecallResult } from './recall-deep.js';
+
+/**
+ * Markdown renderer for a deep-recall trace (issue #2332 leftover).
+ *
+ * Deterministic. Surfaces wait. Empty working set prints (empty).
+ */
+
+declare function renderDeepRecallTrace(result: DeepRecallResult): string;
+
+export { renderDeepRecallTrace };

package/dist/recall-deep-render.js

@@ -0,0 +1,28 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-deep-render.ts
+function renderDeepRecallTrace(result) {
+  const last = result.trace[result.trace.length - 1];
+  const stop = !last ? "none" : last.budget <= 0 ? "budget exhausted" : last.action;
+  const steps = result.trace.length === 0 ? ["(empty)"] : result.trace.map((step, index) => {
+    const workingSet = step.workingSet.length === 0 ? "(empty)" : step.workingSet.join(", ");
+    const frontier = step.frontier.length === 0 ? "(empty)" : step.frontier.join(", ");
+    return `${index + 1}. ${step.action} budget=${step.budget} workingSet=${workingSet} frontier=${frontier}`;
+  });
+  return [
+    "# Deep recall",
+    "",
+    `- query: ${result.state.query}`,
+    `- budget: ${result.state.budget}`,
+    `- stop: ${stop}`,
+    "",
+    "## Steps",
+    "",
+    ...steps,
+    ""
+  ].join("\n");
+}
+export {
+  renderDeepRecallTrace
+};
+//# sourceMappingURL=recall-deep-render.js.map

package/dist/recall-deep-render.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-deep-render.ts"],"sourcesContent":["/**\n * Markdown renderer for a deep-recall trace (issue #2332 leftover).\n *\n * Deterministic. Surfaces wait. Empty working set prints (empty).\n */\n\nimport type { DeepRecallResult } from \"./recall-deep.js\";\n\nexport function renderDeepRecallTrace(result: DeepRecallResult): string {\n  const last = result.trace[result.trace.length - 1];\n  const stop = !last ? \"none\" : last.budget <= 0 ? \"budget exhausted\" : last.action;\n  const steps =\n    result.trace.length === 0\n      ? [\"(empty)\"]\n      : result.trace.map((step, index) => {\n          const workingSet = step.workingSet.length === 0 ? \"(empty)\" : step.workingSet.join(\", \");\n          const frontier = step.frontier.length === 0 ? \"(empty)\" : step.frontier.join(\", \");\n          return `${index + 1}. ${step.action} budget=${step.budget} workingSet=${workingSet} frontier=${frontier}`;\n        });\n  return [\n    \"# Deep recall\",\n    \"\",\n    `- query: ${result.state.query}`,\n    `- budget: ${result.state.budget}`,\n    `- stop: ${stop}`,\n    \"\",\n    \"## Steps\",\n    \"\",\n    ...steps,\n    \"\",\n  ].join(\"\\n\");\n}\n"],"mappings":";;;AAQO,SAAS,sBAAsB,QAAkC;AACtE,QAAM,OAAO,OAAO,MAAM,OAAO,MAAM,SAAS,CAAC;AACjD,QAAM,OAAO,CAAC,OAAO,SAAS,KAAK,UAAU,IAAI,qBAAqB,KAAK;AAC3E,QAAM,QACJ,OAAO,MAAM,WAAW,IACpB,CAAC,SAAS,IACV,OAAO,MAAM,IAAI,CAAC,MAAM,UAAU;AAChC,UAAM,aAAa,KAAK,WAAW,WAAW,IAAI,YAAY,KAAK,WAAW,KAAK,IAAI;AACvF,UAAM,WAAW,KAAK,SAAS,WAAW,IAAI,YAAY,KAAK,SAAS,KAAK,IAAI;AACjF,WAAO,GAAG,QAAQ,CAAC,KAAK,KAAK,MAAM,WAAW,KAAK,MAAM,eAAe,UAAU,aAAa,QAAQ;AAAA,EACzG,CAAC;AACP,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,YAAY,OAAO,MAAM,KAAK;AAAA,IAC9B,aAAa,OAAO,MAAM,MAAM;AAAA,IAChC,WAAW,IAAI;AAAA,IACf;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAG;AAAA,IACH;AAAA,EACF,EAAE,KAAK,IAAI;AACb;","names":[]}

package/dist/recall-deep-step-count.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Deep-recall step-count parse (issue #2332 leftover).
+ *
+ * Pure. Surfaces wait. 0 is allowed. Negative or non-integer throws.
+ */
+declare function parseStepCount(value: unknown): number;
+
+export { parseStepCount };

package/dist/recall-deep-step-count.js

@@ -0,0 +1,15 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-deep-step-count.ts
+function parseStepCount(value) {
+  if (typeof value !== "number" || !Number.isFinite(value) || !Number.isInteger(value) || value < 0) {
+    throw new Error(
+      `deep recall step count must be a non-negative integer; got ${JSON.stringify(value)}`
+    );
+  }
+  return value;
+}
+export {
+  parseStepCount
+};
+//# sourceMappingURL=recall-deep-step-count.js.map

package/dist/recall-deep-step-count.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-deep-step-count.ts"],"sourcesContent":["/**\n * Deep-recall step-count parse (issue #2332 leftover).\n *\n * Pure. Surfaces wait. 0 is allowed. Negative or non-integer throws.\n */\nexport function parseStepCount(value: unknown): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value) || !Number.isInteger(value) || value < 0) {\n    throw new Error(\n      `deep recall step count must be a non-negative integer; got ${JSON.stringify(value)}`,\n    );\n  }\n  return value;\n}\n"],"mappings":";;;AAKO,SAAS,eAAe,OAAwB;AACrD,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,KAAK,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,GAAG;AACjG,UAAM,IAAI;AAAA,MACR,8DAA8D,KAAK,UAAU,KAAK,CAAC;AAAA,IACrF;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/dist/recall-deep-stop-reason.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Parse a deep-recall stop reason (issue #2332 leftover).
+ *
+ * Pure. Surfaces wait. Unknown or empty values fail closed.
+ */
+declare const DEEP_STOP_REASONS: readonly ["budget_exhausted", "policy_stop", "expand_once", "refine_done"];
+type DeepStopReason = (typeof DEEP_STOP_REASONS)[number];
+type ParseDeepStopReasonResult = {
+    ok: true;
+    reason: DeepStopReason;
+} | {
+    ok: false;
+    error: "unknown_reason";
+};
+declare function parseDeepStopReason(value: unknown): ParseDeepStopReasonResult;
+
+export { DEEP_STOP_REASONS, type DeepStopReason, type ParseDeepStopReasonResult, parseDeepStopReason };

package/dist/recall-deep-stop-reason.js

@@ -0,0 +1,23 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-deep-stop-reason.ts
+var DEEP_STOP_REASONS = [
+  "budget_exhausted",
+  "policy_stop",
+  "expand_once",
+  "refine_done"
+];
+function parseDeepStopReason(value) {
+  if (typeof value !== "string" || value.length === 0) {
+    return { ok: false, error: "unknown_reason" };
+  }
+  if (!DEEP_STOP_REASONS.includes(value)) {
+    return { ok: false, error: "unknown_reason" };
+  }
+  return { ok: true, reason: value };
+}
+export {
+  DEEP_STOP_REASONS,
+  parseDeepStopReason
+};
+//# sourceMappingURL=recall-deep-stop-reason.js.map

package/dist/recall-deep-stop-reason.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-deep-stop-reason.ts"],"sourcesContent":["/**\n * Parse a deep-recall stop reason (issue #2332 leftover).\n *\n * Pure. Surfaces wait. Unknown or empty values fail closed.\n */\nexport const DEEP_STOP_REASONS = [\n  \"budget_exhausted\",\n  \"policy_stop\",\n  \"expand_once\",\n  \"refine_done\",\n] as const;\n\nexport type DeepStopReason = (typeof DEEP_STOP_REASONS)[number];\n\nexport type ParseDeepStopReasonResult =\n  | { ok: true; reason: DeepStopReason }\n  | { ok: false; error: \"unknown_reason\" };\n\nexport function parseDeepStopReason(value: unknown): ParseDeepStopReasonResult {\n  if (typeof value !== \"string\" || value.length === 0) {\n    return { ok: false, error: \"unknown_reason\" };\n  }\n  if (!(DEEP_STOP_REASONS as readonly string[]).includes(value)) {\n    return { ok: false, error: \"unknown_reason\" };\n  }\n  return { ok: true, reason: value as DeepStopReason };\n}\n"],"mappings":";;;AAKO,IAAM,oBAAoB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAQO,SAAS,oBAAoB,OAA2C;AAC7E,MAAI,OAAO,UAAU,YAAY,MAAM,WAAW,GAAG;AACnD,WAAO,EAAE,IAAI,OAAO,OAAO,iBAAiB;AAAA,EAC9C;AACA,MAAI,CAAE,kBAAwC,SAAS,KAAK,GAAG;AAC7D,WAAO,EAAE,IAAI,OAAO,OAAO,iBAAiB;AAAA,EAC9C;AACA,SAAO,EAAE,IAAI,MAAM,QAAQ,MAAwB;AACrD;","names":[]}

package/dist/recall-deep-stop.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Deep-recall stop predicate (issue #2332 leftover).
+ *
+ * Pure. Surfaces wait. Budget 0, stop policy, and expand-once after
+ * one expansion halt. Unknown policy throws.
+ */
+declare const DEEP_RECALL_STOP_POLICIES: readonly ["stop", "expand-once"];
+type DeepRecallStopPolicy = (typeof DEEP_RECALL_STOP_POLICIES)[number];
+interface DeepRecallStopInput {
+    budgetLeft: number;
+    policy: string;
+    alreadyExpanded?: boolean;
+}
+declare function isDeepRecallStopPolicy(value: unknown): value is DeepRecallStopPolicy;
+declare function shouldStopDeepRecall(input: DeepRecallStopInput): boolean;
+
+export { DEEP_RECALL_STOP_POLICIES, type DeepRecallStopInput, type DeepRecallStopPolicy, isDeepRecallStopPolicy, shouldStopDeepRecall };

package/dist/recall-deep-stop.js

@@ -0,0 +1,23 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-deep-stop.ts
+var DEEP_RECALL_STOP_POLICIES = ["stop", "expand-once"];
+function isDeepRecallStopPolicy(value) {
+  return typeof value === "string" && DEEP_RECALL_STOP_POLICIES.includes(value);
+}
+function shouldStopDeepRecall(input) {
+  if (!isDeepRecallStopPolicy(input.policy)) {
+    throw new Error(
+      `unknown deep recall stop policy: ${JSON.stringify(input.policy)}. Valid: ${DEEP_RECALL_STOP_POLICIES.join(", ")}`
+    );
+  }
+  if (input.budgetLeft <= 0) return true;
+  if (input.policy === "stop") return true;
+  return input.alreadyExpanded === true;
+}
+export {
+  DEEP_RECALL_STOP_POLICIES,
+  isDeepRecallStopPolicy,
+  shouldStopDeepRecall
+};
+//# sourceMappingURL=recall-deep-stop.js.map

package/dist/recall-deep-stop.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-deep-stop.ts"],"sourcesContent":["/**\n * Deep-recall stop predicate (issue #2332 leftover).\n *\n * Pure. Surfaces wait. Budget 0, stop policy, and expand-once after\n * one expansion halt. Unknown policy throws.\n */\n\nexport const DEEP_RECALL_STOP_POLICIES = [\"stop\", \"expand-once\"] as const;\n\nexport type DeepRecallStopPolicy = (typeof DEEP_RECALL_STOP_POLICIES)[number];\n\nexport interface DeepRecallStopInput {\n  budgetLeft: number;\n  policy: string;\n  alreadyExpanded?: boolean;\n}\n\nexport function isDeepRecallStopPolicy(value: unknown): value is DeepRecallStopPolicy {\n  return typeof value === \"string\" && (DEEP_RECALL_STOP_POLICIES as readonly string[]).includes(value);\n}\n\nexport function shouldStopDeepRecall(input: DeepRecallStopInput): boolean {\n  if (!isDeepRecallStopPolicy(input.policy)) {\n    throw new Error(\n      `unknown deep recall stop policy: ${JSON.stringify(input.policy)}. Valid: ${DEEP_RECALL_STOP_POLICIES.join(\", \")}`,\n    );\n  }\n  if (input.budgetLeft <= 0) return true;\n  if (input.policy === \"stop\") return true;\n  return input.alreadyExpanded === true;\n}\n"],"mappings":";;;AAOO,IAAM,4BAA4B,CAAC,QAAQ,aAAa;AAUxD,SAAS,uBAAuB,OAA+C;AACpF,SAAO,OAAO,UAAU,YAAa,0BAAgD,SAAS,KAAK;AACrG;AAEO,SAAS,qBAAqB,OAAqC;AACxE,MAAI,CAAC,uBAAuB,MAAM,MAAM,GAAG;AACzC,UAAM,IAAI;AAAA,MACR,oCAAoC,KAAK,UAAU,MAAM,MAAM,CAAC,YAAY,0BAA0B,KAAK,IAAI,CAAC;AAAA,IAClH;AAAA,EACF;AACA,MAAI,MAAM,cAAc,EAAG,QAAO;AAClC,MAAI,MAAM,WAAW,OAAQ,QAAO;AACpC,SAAO,MAAM,oBAAoB;AACnC;","names":[]}

package/dist/recall-deep-working-set.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Empty-set guard for a deep-recall working set (issue #2332 leftover).
+ *
+ * null, undefined, and [] are empty. A non-array throws. Any other array is not empty.
+ */
+/** True when the working set is absent or has no items. */
+declare function isEmptyWorkingSet(items: unknown): boolean;
+
+export { isEmptyWorkingSet };

package/dist/recall-deep-working-set.js

@@ -0,0 +1,14 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-deep-working-set.ts
+function isEmptyWorkingSet(items) {
+  if (items == null) return true;
+  if (!Array.isArray(items)) {
+    throw new TypeError("items must be an array");
+  }
+  return items.length === 0;
+}
+export {
+  isEmptyWorkingSet
+};
+//# sourceMappingURL=recall-deep-working-set.js.map

package/dist/recall-deep-working-set.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-deep-working-set.ts"],"sourcesContent":["/**\n * Empty-set guard for a deep-recall working set (issue #2332 leftover).\n *\n * null, undefined, and [] are empty. A non-array throws. Any other array is not empty.\n */\n\n/** True when the working set is absent or has no items. */\nexport function isEmptyWorkingSet(items: unknown): boolean {\n  if (items == null) return true;\n  if (!Array.isArray(items)) {\n    throw new TypeError(\"items must be an array\");\n  }\n  return items.length === 0;\n}\n"],"mappings":";;;AAOO,SAAS,kBAAkB,OAAyB;AACzD,MAAI,SAAS,KAAM,QAAO;AAC1B,MAAI,CAAC,MAAM,QAAQ,KAAK,GAAG;AACzB,UAAM,IAAI,UAAU,wBAAwB;AAAA,EAC9C;AACA,SAAO,MAAM,WAAW;AAC1B;","names":[]}

package/dist/recall-deep.js

@@ -1,77 +1,10 @@
+import {
+  DEEP_RECALL_ACTIONS,
+  isDeepRecallAction,
+  runDeepRecall,
+  runDeepRecallStep
+} from "./chunk-Q3SHEAXR.js";
 import "./chunk-PZ5AY32C.js";
-
-// src/recall-deep.ts
-var DEEP_RECALL_ACTIONS = ["refine", "expand", "stop"];
-function isDeepRecallAction(value) {
-  return typeof value === "string" && DEEP_RECALL_ACTIONS.includes(value);
-}
-function snapshot(state) {
-  return {
-    query: state.query,
-    workingSet: [...state.workingSet],
-    frontier: [...state.frontier],
-    budget: state.budget
-  };
-}
-function runDeepRecallStep(state, action) {
-  if (!isDeepRecallAction(action)) {
-    throw new Error(
-      `unknown deep recall action: ${JSON.stringify(action)}. Valid: ${DEEP_RECALL_ACTIONS.join(", ")}`
-    );
-  }
-  if (!Number.isFinite(state.budget) || state.budget <= 0 || action === "stop") {
-    const stopped = snapshot(state);
-    return {
-      state: stopped,
-      step: {
-        action: "stop",
-        budget: stopped.budget,
-        workingSet: stopped.workingSet,
-        frontier: stopped.frontier
-      }
-    };
-  }
-  const next = snapshot(state);
-  next.budget = state.budget - 1;
-  if (action === "expand") {
-    const [head, ...rest] = next.frontier;
-    if (head !== void 0 && !next.workingSet.includes(head)) {
-      next.workingSet = [...next.workingSet, head];
-    }
-    next.frontier = rest;
-  }
-  return {
-    state: next,
-    step: {
-      action,
-      budget: next.budget,
-      workingSet: next.workingSet,
-      frontier: next.frontier
-    }
-  };
-}
-function runDeepRecall(state, policy) {
-  const trace = [];
-  let current = snapshot(state);
-  while (true) {
-    if (!Number.isFinite(current.budget) || current.budget <= 0) {
-      const stopped = snapshot(current);
-      trace.push({
-        action: "stop",
-        budget: stopped.budget,
-        workingSet: stopped.workingSet,
-        frontier: stopped.frontier
-      });
-      return { state: stopped, trace };
-    }
-    const stepped = runDeepRecallStep(current, policy(current));
-    trace.push(stepped.step);
-    current = stepped.state;
-    if (stepped.step.action === "stop") {
-      return { state: current, trace };
-    }
-  }
-}
 export {
   DEEP_RECALL_ACTIONS,
   isDeepRecallAction,

package/dist/recall-deep.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/recall-deep.ts"],"sourcesContent":["/**\n * Budgeted REFINE/EXPAND/STOP loop (issue #2332 first slice).\n *\n * Pure state stepper. Policy is injected. No LLM, no orchestrator recall,\n * no IO. Surfaces and parseConfig wait for a later PR — config.ts is at\n * its fileSizeGrandfather ceiling.\n *\n * Budget 0 stops without calling the policy. Unknown actions throw.\n */\nexport const DEEP_RECALL_ACTIONS = [\"refine\", \"expand\", \"stop\"] as const;\n\nexport type DeepRecallAction = (typeof DEEP_RECALL_ACTIONS)[number];\n\nexport interface DeepRecallState {\n  query: string;\n  workingSet: readonly string[];\n  frontier: readonly string[];\n  budget: number;\n}\n\nexport interface DeepRecallTraceStep {\n  action: DeepRecallAction;\n  budget: number;\n  workingSet: readonly string[];\n  frontier: readonly string[];\n}\n\nexport interface DeepRecallStepResult {\n  state: DeepRecallState;\n  step: DeepRecallTraceStep;\n}\n\nexport interface DeepRecallResult {\n  state: DeepRecallState;\n  trace: readonly DeepRecallTraceStep[];\n}\n\nexport type DeepRecallPolicy = (state: DeepRecallState) => string;\n\nexport function isDeepRecallAction(value: unknown): value is DeepRecallAction {\n  return typeof value === \"string\" && (DEEP_RECALL_ACTIONS as readonly string[]).includes(value);\n}\n\nfunction snapshot(state: DeepRecallState): DeepRecallState {\n  return {\n    query: state.query,\n    workingSet: [...state.workingSet],\n    frontier: [...state.frontier],\n    budget: state.budget,\n  };\n}\n\nexport function runDeepRecallStep(state: DeepRecallState, action: string): DeepRecallStepResult {\n  if (!isDeepRecallAction(action)) {\n    throw new Error(\n      `unknown deep recall action: ${JSON.stringify(action)}. Valid: ${DEEP_RECALL_ACTIONS.join(\", \")}`,\n    );\n  }\n  if (!Number.isFinite(state.budget) || state.budget <= 0 || action === \"stop\") {\n    const stopped = snapshot(state);\n    return {\n      state: stopped,\n      step: {\n        action: \"stop\",\n        budget: stopped.budget,\n        workingSet: stopped.workingSet,\n        frontier: stopped.frontier,\n      },\n    };\n  }\n\n  const next = snapshot(state);\n  next.budget = state.budget - 1;\n  if (action === \"expand\") {\n    const [head, ...rest] = next.frontier;\n    if (head !== undefined && !next.workingSet.includes(head)) {\n      next.workingSet = [...next.workingSet, head];\n    }\n    next.frontier = rest;\n  }\n  return {\n    state: next,\n    step: {\n      action,\n      budget: next.budget,\n      workingSet: next.workingSet,\n      frontier: next.frontier,\n    },\n  };\n}\n\nexport function runDeepRecall(state: DeepRecallState, policy: DeepRecallPolicy): DeepRecallResult {\n  const trace: DeepRecallTraceStep[] = [];\n  let current = snapshot(state);\n  while (true) {\n    if (!Number.isFinite(current.budget) || current.budget <= 0) {\n      const stopped = snapshot(current);\n      trace.push({\n        action: \"stop\",\n        budget: stopped.budget,\n        workingSet: stopped.workingSet,\n        frontier: stopped.frontier,\n      });\n      return { state: stopped, trace };\n    }\n    const stepped = runDeepRecallStep(current, policy(current));\n    trace.push(stepped.step);\n    current = stepped.state;\n    if (stepped.step.action === \"stop\") {\n      return { state: current, trace };\n    }\n  }\n}\n"],"mappings":";;;AASO,IAAM,sBAAsB,CAAC,UAAU,UAAU,MAAM;AA8BvD,SAAS,mBAAmB,OAA2C;AAC5E,SAAO,OAAO,UAAU,YAAa,oBAA0C,SAAS,KAAK;AAC/F;AAEA,SAAS,SAAS,OAAyC;AACzD,SAAO;AAAA,IACL,OAAO,MAAM;AAAA,IACb,YAAY,CAAC,GAAG,MAAM,UAAU;AAAA,IAChC,UAAU,CAAC,GAAG,MAAM,QAAQ;AAAA,IAC5B,QAAQ,MAAM;AAAA,EAChB;AACF;AAEO,SAAS,kBAAkB,OAAwB,QAAsC;AAC9F,MAAI,CAAC,mBAAmB,MAAM,GAAG;AAC/B,UAAM,IAAI;AAAA,MACR,+BAA+B,KAAK,UAAU,MAAM,CAAC,YAAY,oBAAoB,KAAK,IAAI,CAAC;AAAA,IACjG;AAAA,EACF;AACA,MAAI,CAAC,OAAO,SAAS,MAAM,MAAM,KAAK,MAAM,UAAU,KAAK,WAAW,QAAQ;AAC5E,UAAM,UAAU,SAAS,KAAK;AAC9B,WAAO;AAAA,MACL,OAAO;AAAA,MACP,MAAM;AAAA,QACJ,QAAQ;AAAA,QACR,QAAQ,QAAQ;AAAA,QAChB,YAAY,QAAQ;AAAA,QACpB,UAAU,QAAQ;AAAA,MACpB;AAAA,IACF;AAAA,EACF;AAEA,QAAM,OAAO,SAAS,KAAK;AAC3B,OAAK,SAAS,MAAM,SAAS;AAC7B,MAAI,WAAW,UAAU;AACvB,UAAM,CAAC,MAAM,GAAG,IAAI,IAAI,KAAK;AAC7B,QAAI,SAAS,UAAa,CAAC,KAAK,WAAW,SAAS,IAAI,GAAG;AACzD,WAAK,aAAa,CAAC,GAAG,KAAK,YAAY,IAAI;AAAA,IAC7C;AACA,SAAK,WAAW;AAAA,EAClB;AACA,SAAO;AAAA,IACL,OAAO;AAAA,IACP,MAAM;AAAA,MACJ;AAAA,MACA,QAAQ,KAAK;AAAA,MACb,YAAY,KAAK;AAAA,MACjB,UAAU,KAAK;AAAA,IACjB;AAAA,EACF;AACF;AAEO,SAAS,cAAc,OAAwB,QAA4C;AAChG,QAAM,QAA+B,CAAC;AACtC,MAAI,UAAU,SAAS,KAAK;AAC5B,SAAO,MAAM;AACX,QAAI,CAAC,OAAO,SAAS,QAAQ,MAAM,KAAK,QAAQ,UAAU,GAAG;AAC3D,YAAM,UAAU,SAAS,OAAO;AAChC,YAAM,KAAK;AAAA,QACT,QAAQ;AAAA,QACR,QAAQ,QAAQ;AAAA,QAChB,YAAY,QAAQ;AAAA,QACpB,UAAU,QAAQ;AAAA,MACpB,CAAC;AACD,aAAO,EAAE,OAAO,SAAS,MAAM;AAAA,IACjC;AACA,UAAM,UAAU,kBAAkB,SAAS,OAAO,OAAO,CAAC;AAC1D,UAAM,KAAK,QAAQ,IAAI;AACvB,cAAU,QAAQ;AAClB,QAAI,QAAQ,KAAK,WAAW,QAAQ;AAClC,aAAO,EAAE,OAAO,SAAS,MAAM;AAAA,IACjC;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -0,0 +1,39 @@
+import { RecallNavNode, RecallNavExpandResult, RecallNavTraverseResult } from './recall-navigate.js';
+import './types-CIpfYz1I.js';
+import './message-parts/index.js';
+import './bounded-jsonl-state.js';
+import './operator-doctor-types.js';
+import './external-wiki-config.js';
+import './contradiction-config.js';
+import './graph-path-scoring-config.js';
+import './causal-trajectory.js';
+import './objective-state.js';
+import './active-context-config.js';
+import './types-continuity.js';
+
+/**
+ * Recall navigation access wrapper (issue #1956 leftover slice).
+ *
+ * Validates the request, gates the budget, and delegates to the pure
+ * helpers in recall-navigate.ts. Never calls orchestrator.recall — the
+ * caller supplies the node for `nodeId`.
+ */
+
+type RecallNavigateAccessAction = "expand" | "traverse";
+interface RecallNavigateAccessRequest {
+    action: string;
+    nodeId: string;
+    budget: number;
+    node?: RecallNavNode;
+    linkType?: string;
+}
+type RecallNavigateAccessResult = {
+    ok: true;
+    result: RecallNavExpandResult | RecallNavTraverseResult;
+} | {
+    ok: false;
+    error: "budget_exhausted" | "unknown_action" | "node_not_found";
+};
+declare function runRecallNavigateAccess(request: RecallNavigateAccessRequest): RecallNavigateAccessResult;
+
+export { type RecallNavigateAccessAction, type RecallNavigateAccessRequest, type RecallNavigateAccessResult, runRecallNavigateAccess };

package/dist/recall-navigate-access.js

@@ -0,0 +1,31 @@
+import {
+  expandRecallNode,
+  traverseRecallLink
+} from "./chunk-MAG6M3B6.js";
+import "./chunk-XXW32OL7.js";
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-navigate-access.ts
+function runRecallNavigateAccess(request) {
+  if (request.action !== "expand" && request.action !== "traverse") {
+    return { ok: false, error: "unknown_action" };
+  }
+  if (!Number.isFinite(request.budget) || request.budget <= 0) {
+    return { ok: false, error: "budget_exhausted" };
+  }
+  const node = request.node;
+  if (node === void 0 || node.id !== request.nodeId) {
+    return { ok: false, error: "node_not_found" };
+  }
+  if (request.action === "expand") {
+    return { ok: true, result: expandRecallNode(node, { budget: request.budget }) };
+  }
+  return {
+    ok: true,
+    result: traverseRecallLink(node, request.linkType ?? "", { budget: request.budget })
+  };
+}
+export {
+  runRecallNavigateAccess
+};
+//# sourceMappingURL=recall-navigate-access.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-navigate-access.ts"],"sourcesContent":["/**\n * Recall navigation access wrapper (issue #1956 leftover slice).\n *\n * Validates the request, gates the budget, and delegates to the pure\n * helpers in recall-navigate.ts. Never calls orchestrator.recall — the\n * caller supplies the node for `nodeId`.\n */\nimport {\n  expandRecallNode,\n  traverseRecallLink,\n  type RecallNavExpandResult,\n  type RecallNavNode,\n  type RecallNavTraverseResult,\n} from \"./recall-navigate.js\";\n\nexport type RecallNavigateAccessAction = \"expand\" | \"traverse\";\n\nexport interface RecallNavigateAccessRequest {\n  action: string;\n  nodeId: string;\n  budget: number;\n  node?: RecallNavNode;\n  linkType?: string;\n}\n\nexport type RecallNavigateAccessResult =\n  | { ok: true; result: RecallNavExpandResult | RecallNavTraverseResult }\n  | { ok: false; error: \"budget_exhausted\" | \"unknown_action\" | \"node_not_found\" };\n\nexport function runRecallNavigateAccess(request: RecallNavigateAccessRequest): RecallNavigateAccessResult {\n  if (request.action !== \"expand\" && request.action !== \"traverse\") {\n    return { ok: false, error: \"unknown_action\" };\n  }\n  if (!Number.isFinite(request.budget) || request.budget <= 0) {\n    return { ok: false, error: \"budget_exhausted\" };\n  }\n  const node = request.node;\n  if (node === undefined || node.id !== request.nodeId) {\n    return { ok: false, error: \"node_not_found\" };\n  }\n  if (request.action === \"expand\") {\n    return { ok: true, result: expandRecallNode(node, { budget: request.budget }) };\n  }\n  return {\n    ok: true,\n    result: traverseRecallLink(node, request.linkType ?? \"\", { budget: request.budget }),\n  };\n}\n"],"mappings":";;;;;;;;AA6BO,SAAS,wBAAwB,SAAkE;AACxG,MAAI,QAAQ,WAAW,YAAY,QAAQ,WAAW,YAAY;AAChE,WAAO,EAAE,IAAI,OAAO,OAAO,iBAAiB;AAAA,EAC9C;AACA,MAAI,CAAC,OAAO,SAAS,QAAQ,MAAM,KAAK,QAAQ,UAAU,GAAG;AAC3D,WAAO,EAAE,IAAI,OAAO,OAAO,mBAAmB;AAAA,EAChD;AACA,QAAM,OAAO,QAAQ;AACrB,MAAI,SAAS,UAAa,KAAK,OAAO,QAAQ,QAAQ;AACpD,WAAO,EAAE,IAAI,OAAO,OAAO,iBAAiB;AAAA,EAC9C;AACA,MAAI,QAAQ,WAAW,UAAU;AAC/B,WAAO,EAAE,IAAI,MAAM,QAAQ,iBAAiB,MAAM,EAAE,QAAQ,QAAQ,OAAO,CAAC,EAAE;AAAA,EAChF;AACA,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,QAAQ,mBAAmB,MAAM,QAAQ,YAAY,IAAI,EAAE,QAAQ,QAAQ,OAAO,CAAC;AAAA,EACrF;AACF;","names":[]}

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

@@ -0,0 +1,17 @@
+/**
+ * Recall navigation action parse (issue #1956 leftover).
+ *
+ * Pure. Surfaces wait. Unknown or empty is unknown_action.
+ */
+declare const NAVIGATE_ACTIONS: readonly ["expand", "traverse"];
+type NavigateAction = (typeof NAVIGATE_ACTIONS)[number];
+type ParseNavigateActionResult = {
+    ok: true;
+    action: NavigateAction;
+} | {
+    ok: false;
+    error: "unknown_action";
+};
+declare function parseNavigateAction(value: string): ParseNavigateActionResult;
+
+export { type NavigateAction, type ParseNavigateActionResult, parseNavigateAction };

package/dist/recall-navigate-action.js

@@ -0,0 +1,14 @@
+import "./chunk-PZ5AY32C.js";
+
+// src/recall-navigate-action.ts
+var NAVIGATE_ACTIONS = ["expand", "traverse"];
+function parseNavigateAction(value) {
+  if (NAVIGATE_ACTIONS.includes(value)) {
+    return { ok: true, action: value };
+  }
+  return { ok: false, error: "unknown_action" };
+}
+export {
+  parseNavigateAction
+};
+//# sourceMappingURL=recall-navigate-action.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-navigate-action.ts"],"sourcesContent":["/**\n * Recall navigation action parse (issue #1956 leftover).\n *\n * Pure. Surfaces wait. Unknown or empty is unknown_action.\n */\n\nconst NAVIGATE_ACTIONS = [\"expand\", \"traverse\"] as const;\n\nexport type NavigateAction = (typeof NAVIGATE_ACTIONS)[number];\n\nexport type ParseNavigateActionResult =\n  | { ok: true; action: NavigateAction }\n  | { ok: false; error: \"unknown_action\" };\n\nexport function parseNavigateAction(value: string): ParseNavigateActionResult {\n  if ((NAVIGATE_ACTIONS as readonly string[]).includes(value)) {\n    return { ok: true, action: value as NavigateAction };\n  }\n  return { ok: false, error: \"unknown_action\" };\n}\n"],"mappings":";;;AAMA,IAAM,mBAAmB,CAAC,UAAU,UAAU;AAQvC,SAAS,oBAAoB,OAA0C;AAC5E,MAAK,iBAAuC,SAAS,KAAK,GAAG;AAC3D,WAAO,EAAE,IAAI,MAAM,QAAQ,MAAwB;AAAA,EACrD;AACA,SAAO,EAAE,IAAI,OAAO,OAAO,iBAAiB;AAC9C;","names":[]}

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

@@ -0,0 +1,16 @@
+/**
+ * Recall navigation budget take (issue #1956 leftover).
+ *
+ * Pure. Surfaces wait. Budget 0 or cost above budget is exhausted.
+ * Negative budget or cost throws.
+ */
+type NavigateBudgetResult = {
+    ok: true;
+    remaining: number;
+} | {
+    ok: false;
+    error: "budget_exhausted";
+};
+declare function takeNavigateBudget(budget: number, cost: number): NavigateBudgetResult;
+
+export { type NavigateBudgetResult, takeNavigateBudget };

package/dist/recall-navigate-budget.js

@@ -0,0 +1,18 @@
+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
+};
+//# sourceMappingURL=recall-navigate-budget.js.map