@remnic/core 9.69.37 → 9.69.39

package/dist/{chunk-3SL52JKD.js → chunk-XVZA6VXC.js}

@@ -1,6 +1,3 @@
-import {
-  validateSpanOffsets
-} from "./chunk-QJ2AX6DU.js";
 import {
   sliceSpanText
 } from "./chunk-JE26AUX6.js";
@@ -8,6 +5,9 @@ import {
   stampSpanSource,
   verifySpanSource
 } from "./chunk-A6CXG5WI.js";
+import {
+  validateSpanOffsets
+} from "./chunk-QJ2AX6DU.js";
 import {
   log
 } from "./chunk-3WCASNQZ.js";
@@ -157,4 +157,4 @@ export {
   spanAgreesWithContent,
   applyExtractionSpanMaterialization
 };
-//# sourceMappingURL=chunk-3SL52JKD.js.map
+//# sourceMappingURL=chunk-XVZA6VXC.js.map

package/dist/chunk-YDVAM7S4.js

@@ -0,0 +1,221 @@
+import {
+  coerceBooleanLike
+} from "./chunk-PQVCH2AE.js";
+
+// src/recall-state-view.ts
+var DEFAULT_RECALL_STATE_VIEWS = false;
+var CHANGE_WORDS = ["switch", "switches", "switched", "switching", "change", "changes", "changed", "changing"];
+var CHANGE_PHRASE_RE = /\bwhen\s+did\b|\bused\s+to\b/;
+var CHANGE_WORD_RE = new RegExp(`\\b(?:${CHANGE_WORDS.join("|")})\\b`);
+var EVENT_POINTER_RE = /\b(?:before|after)\s+(?:the|a|an|this|that|these|those)\b/;
+function parseRecallStateViews(raw) {
+  return coerceBooleanLike(raw, "recallStateViews") === true;
+}
+function isChangeOrientedQuery(query) {
+  const lower = query.toLowerCase();
+  return CHANGE_PHRASE_RE.test(lower) || CHANGE_WORD_RE.test(lower) || EVENT_POINTER_RE.test(lower);
+}
+function shouldWidenSuperseded(successorId, candidateIds) {
+  return typeof successorId === "string" && successorId.length > 0 && candidateIds.has(successorId);
+}
+function formatSupersededPrefix(date, successorId) {
+  return `[superseded ${date} by ${successorId}]`;
+}
+function resultStateViewId(result) {
+  return result.id ?? result.docid ?? "";
+}
+function stateViewKey(namespace, id) {
+  return `${typeof namespace === "string" ? namespace : ""}\0${id}`;
+}
+function resultStateViewKey(result) {
+  const id = resultStateViewId(result);
+  return id ? stateViewKey(result.namespace, id) : "";
+}
+function stateViewIdFromKey(key) {
+  const sep = key.indexOf("\0");
+  return sep === -1 ? key : key.slice(sep + 1);
+}
+function buildSuccessorMap(results, chains) {
+  const byPred = /* @__PURE__ */ new Map();
+  const link = (predKey, succKey, overwrite) => {
+    if (!predKey || !succKey) return;
+    if (overwrite || !byPred.has(predKey)) byPred.set(predKey, succKey);
+  };
+  for (const chain of chains) {
+    if (chain.predecessorId && chain.successorId) {
+      link(
+        stateViewKey(chain.namespace, chain.predecessorId),
+        stateViewKey(chain.namespace, chain.successorId),
+        false
+      );
+    }
+  }
+  for (const result of results) {
+    const key = resultStateViewKey(result);
+    if (key && result.supersedes) {
+      link(stateViewKey(result.namespace, result.supersedes), key, false);
+    }
+  }
+  for (const result of results) {
+    const key = resultStateViewKey(result);
+    if (key && result.supersededBy) {
+      link(key, stateViewKey(result.namespace, result.supersededBy), true);
+    }
+  }
+  return byPred;
+}
+function successorLinkOf(result, byPred) {
+  const key = resultStateViewKey(result);
+  return {
+    superseded: result.status === "superseded" || Boolean(result.supersededBy) || byPred.has(key),
+    successorKey: result.supersededBy ? stateViewKey(result.namespace, result.supersededBy) : byPred.get(key)
+  };
+}
+function labelFor(key, result, byPred, admittedIds, asOfMs) {
+  const { successorKey } = successorLinkOf(result, byPred);
+  const isPred = shouldWidenSuperseded(successorKey, admittedIds);
+  let isSucc = false;
+  for (const [predId, succId] of byPred) {
+    if (succId === key && admittedIds.has(predId)) {
+      isSucc = true;
+      break;
+    }
+  }
+  if (isPred && isSucc) return "transition";
+  if (isPred) return "historical";
+  if (isSucc) return "current";
+  if (result.status === "superseded") {
+    return asOfMs === null ? "historical" : snapshotStateLabel(result, asOfMs);
+  }
+  return "current";
+}
+function snapshotStateLabel(result, asOfMs) {
+  const invalidAtMs = Date.parse(result.invalidAt ?? "");
+  const boundaryMs = Number.isFinite(invalidAtMs) ? invalidAtMs : Date.parse(result.supersededAt ?? "");
+  return Number.isFinite(boundaryMs) && boundaryMs <= asOfMs ? "historical" : "current";
+}
+function annotateStateView(results, query, chains, options = {}) {
+  const enabled = options.enabled === true;
+  if (!enabled || !isChangeOrientedQuery(query)) return results;
+  const asOfMs = typeof options.asOfMs === "number" && Number.isFinite(options.asOfMs) ? options.asOfMs : null;
+  const byPred = buildSuccessorMap(results, chains);
+  const candidateIds = /* @__PURE__ */ new Set();
+  for (const result of results) {
+    const key = resultStateViewKey(result);
+    if (key) candidateIds.add(key);
+  }
+  let admitted;
+  if (asOfMs !== null) {
+    admitted = results.slice();
+  } else {
+    admitted = [];
+    for (const result of results) {
+      const { superseded, successorKey } = successorLinkOf(result, byPred);
+      if (!superseded || shouldWidenSuperseded(successorKey, candidateIds)) {
+        admitted.push(result);
+      }
+    }
+    let admittedIds2 = new Set(admitted.map(resultStateViewKey).filter(Boolean));
+    for (let changed = true; changed; ) {
+      changed = false;
+      for (let i = admitted.length - 1; i >= 0; i -= 1) {
+        const row = admitted[i];
+        const { superseded, successorKey } = successorLinkOf(row, byPred);
+        if (superseded && !shouldWidenSuperseded(successorKey, admittedIds2)) {
+          admitted.splice(i, 1);
+          changed = true;
+        }
+      }
+      if (changed) admittedIds2 = new Set(admitted.map(resultStateViewKey).filter(Boolean));
+    }
+  }
+  const admittedIds = new Set(admitted.map(resultStateViewKey).filter(Boolean));
+  return admitted.map((result) => {
+    const key = resultStateViewKey(result);
+    const { successorKey } = successorLinkOf(result, byPred);
+    const stateLabel = labelFor(key, result, byPred, admittedIds, asOfMs);
+    if (result.supersededBy || !successorKey) return { ...result, stateLabel };
+    return { ...result, stateLabel, supersededBy: stateViewIdFromKey(successorKey) };
+  });
+}
+function reconcileStateViewPairs(results) {
+  const byPred = buildSuccessorMap(results, []);
+  let kept = results.slice();
+  for (let changed = true; changed; ) {
+    changed = false;
+    const keptKeys = new Set(kept.map(resultStateViewKey).filter(Boolean));
+    const next = [];
+    for (const row of kept) {
+      const { superseded, successorKey } = successorLinkOf(row, byPred);
+      if (superseded && !shouldWidenSuperseded(successorKey, keptKeys)) {
+        changed = true;
+        continue;
+      }
+      next.push(row);
+    }
+    if (changed) kept = next;
+  }
+  return kept;
+}
+function capStateViewPackets(ordered, limit) {
+  const safeLimit = typeof limit === "number" && Number.isFinite(limit) ? Math.max(0, Math.floor(limit)) : 0;
+  if (safeLimit === 0) return [];
+  if (ordered.length === 0) return [];
+  const byPred = buildSuccessorMap(ordered, []);
+  const parent = /* @__PURE__ */ new Map();
+  const root = (key) => {
+    let current = key;
+    for (; ; ) {
+      const up = parent.get(current);
+      if (up === void 0 || up === current) {
+        parent.set(current, current);
+        return current;
+      }
+      current = up;
+    }
+  };
+  const union = (a, b) => {
+    const ra = root(a);
+    const rb = root(b);
+    if (ra !== rb) parent.set(ra, rb);
+  };
+  const keys = [];
+  const keyToIndex = /* @__PURE__ */ new Map();
+  for (let i = 0; i < ordered.length; i += 1) {
+    const key = resultStateViewKey(ordered[i]) || `#idx${i}`;
+    keys.push(key);
+    if (!parent.has(key)) parent.set(key, key);
+    const first = keyToIndex.get(key);
+    if (first !== void 0) union(keys[first], key);
+    else keyToIndex.set(key, i);
+  }
+  for (const [predKey, succKey] of byPred) {
+    const predIdx = keyToIndex.get(predKey);
+    const succIdx = keyToIndex.get(succKey);
+    if (predIdx !== void 0 && succIdx !== void 0) union(keys[predIdx], keys[succIdx]);
+  }
+  const selectedRoots = /* @__PURE__ */ new Set();
+  for (let i = 0; i < ordered.length && selectedRoots.size < safeLimit; i += 1) {
+    selectedRoots.add(root(keys[i]));
+  }
+  const selected = [];
+  for (let i = 0; i < ordered.length; i += 1) {
+    if (selectedRoots.has(root(keys[i]))) selected.push(ordered[i]);
+  }
+  return selected;
+}
+
+export {
+  DEFAULT_RECALL_STATE_VIEWS,
+  parseRecallStateViews,
+  isChangeOrientedQuery,
+  shouldWidenSuperseded,
+  formatSupersededPrefix,
+  resultStateViewId,
+  stateViewKey,
+  resultStateViewKey,
+  annotateStateView,
+  reconcileStateViewPairs,
+  capStateViewPackets
+};
+//# sourceMappingURL=chunk-YDVAM7S4.js.map

package/dist/chunk-YDVAM7S4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-state-view.ts"],"sourcesContent":["/**\n * Recall state views (issue #1952).\n *\n * Config key: `recallStateViews` (default false). When false, annotateStateView\n * is identity: same array reference, no `stateLabel`. config.ts is at its\n * fileSizeGrandfather ceiling, so parseConfig wiring waits for a later PR.\n * Call `parseRecallStateViews` at the recall seam when that lands.\n *\n * Change-intent morphology lives here (do not grow intent.ts). A superseded\n * memory is admitted only when its successor is also in the candidate set.\n *\n * #2859 — chain identities are namespace-qualified (`namespace\\0id`): the\n * same id in two namespaces never cross-anchors. The reverse chain derives\n * from the successor's `supersedes` back-pointer when a predecessor lacks\n * `supersededBy`, and asOf snapshot labels use the temporal validity\n * boundary (predecessor `invalidAt` / successor `validAt`), not the\n * `supersededAt` write time.\n */\nimport { coerceBooleanLike } from \"./connectors/coerce.js\";\n\nexport type StateLabel = \"current\" | \"historical\" | \"transition\";\n\nexport interface StateViewChain {\n  predecessorId: string;\n  successorId: string;\n  supersededAt?: string;\n  /** #2859 — namespace scope; a chain link never crosses namespaces. */\n  namespace?: string;\n}\n\nexport interface StateViewResult {\n  id?: string;\n  docid?: string;\n  status?: string;\n  /** #2859 — namespace that owns this row; qualifies every chain identity. */\n  namespace?: string;\n  /** #2859 — back-pointer: id of the row this one replaced. */\n  supersedes?: string;\n  supersededBy?: string;\n  supersededAt?: string;\n  /** #2859 — fact validity start (frontmatter `valid_at`). */\n  validAt?: string;\n  /** #2859 — fact validity end (frontmatter `invalid_at`). */\n  invalidAt?: string;\n  stateLabel?: StateLabel;\n}\n\nexport const DEFAULT_RECALL_STATE_VIEWS = false;\n\nconst CHANGE_WORDS = [\"switch\", \"switches\", \"switched\", \"switching\", \"change\", \"changes\", \"changed\", \"changing\"];\n\n// Phrase matches are token-bounded: \"when Didi\" must not fire the\n// \"when did\" phrase, and \"confused to\" must not fire \"used to\".\nconst CHANGE_PHRASE_RE = /\\bwhen\\s+did\\b|\\bused\\s+to\\b/;\nconst CHANGE_WORD_RE = new RegExp(`\\\\b(?:${CHANGE_WORDS.join(\"|\")})\\\\b`);\n// Bare \"before\"/\"after\" are ordinary sequencing (\"before lunch\",\n// \"after install\"). They carry change intent only when they point at a\n// specific event through a determiner (\"before the move\", \"after the\n// cutover\").\nconst EVENT_POINTER_RE = /\\b(?:before|after)\\s+(?:the|a|an|this|that|these|those)\\b/;\n\nexport function parseRecallStateViews(raw: unknown): boolean {\n  return coerceBooleanLike(raw, \"recallStateViews\") === true;\n}\n\nexport function isChangeOrientedQuery(query: string): boolean {\n  const lower = query.toLowerCase();\n  return CHANGE_PHRASE_RE.test(lower) || CHANGE_WORD_RE.test(lower) || EVENT_POINTER_RE.test(lower);\n}\n\nexport function shouldWidenSuperseded(\n  successorId: string | undefined,\n  candidateIds: ReadonlySet<string>,\n): boolean {\n  return typeof successorId === \"string\" && successorId.length > 0 && candidateIds.has(successorId);\n}\n\nexport function formatSupersededPrefix(date: string, successorId: string): string {\n  return `[superseded ${date} by ${successorId}]`;\n}\n\nexport function resultStateViewId(result: StateViewResult): string {\n  return result.id ?? result.docid ?? \"\";\n}\n\n/**\n * #2859 — namespace-qualified chain identity. Namespace fanout can surface\n * the same id from two namespaces; every successor/admission match runs on\n * `namespace\\0id` keys so a row in one namespace can never anchor (or be\n * anchored by) an identically-named row in another.\n */\nexport function stateViewKey(namespace: string | undefined, id: string): string {\n  return `${typeof namespace === \"string\" ? namespace : \"\"}\\u0000${id}`;\n}\n\nexport function resultStateViewKey(result: StateViewResult): string {\n  const id = resultStateViewId(result);\n  return id ? stateViewKey(result.namespace, id) : \"\";\n}\n\n/** Inverse of {@link stateViewKey}: the id after the namespace separator. */\nfunction stateViewIdFromKey(key: string): string {\n  const sep = key.indexOf(\"\\u0000\");\n  return sep === -1 ? key : key.slice(sep + 1);\n}\n\n/**\n * predecessorKey → successorKey, namespace-qualified. Precedence: explicit\n * chains, then successor rows' `supersedes` back-pointers (#2859 — derives\n * the reverse chain when the predecessor lacks `supersededBy`), then the\n * predecessor's own `supersededBy` (authoritative when present).\n */\nfunction buildSuccessorMap(\n  results: readonly StateViewResult[],\n  chains: readonly StateViewChain[],\n): Map<string, string> {\n  const byPred = new Map<string, string>();\n  const link = (predKey: string, succKey: string, overwrite: boolean): void => {\n    if (!predKey || !succKey) return;\n    if (overwrite || !byPred.has(predKey)) byPred.set(predKey, succKey);\n  };\n  for (const chain of chains) {\n    if (chain.predecessorId && chain.successorId) {\n      link(\n        stateViewKey(chain.namespace, chain.predecessorId),\n        stateViewKey(chain.namespace, chain.successorId),\n        false,\n      );\n    }\n  }\n  for (const result of results) {\n    const key = resultStateViewKey(result);\n    if (key && result.supersedes) {\n      link(stateViewKey(result.namespace, result.supersedes), key, false);\n    }\n  }\n  for (const result of results) {\n    const key = resultStateViewKey(result);\n    if (key && result.supersededBy) {\n      link(key, stateViewKey(result.namespace, result.supersededBy), true);\n    }\n  }\n  return byPred;\n}\n\nfunction successorLinkOf(\n  result: StateViewResult,\n  byPred: ReadonlyMap<string, string>,\n): { superseded: boolean; successorKey: string | undefined } {\n  const key = resultStateViewKey(result);\n  return {\n    superseded:\n      result.status === \"superseded\" ||\n      Boolean(result.supersededBy) ||\n      byPred.has(key),\n    successorKey: result.supersededBy\n      ? stateViewKey(result.namespace, result.supersededBy)\n      : byPred.get(key),\n  };\n}\n\nfunction labelFor(\n  key: string,\n  result: StateViewResult,\n  byPred: Map<string, string>,\n  admittedIds: ReadonlySet<string>,\n  asOfMs: number | null,\n): StateLabel {\n  const { successorKey } = successorLinkOf(result, byPred);\n  const isPred = shouldWidenSuperseded(successorKey, admittedIds);\n  let isSucc = false;\n  for (const [predId, succId] of byPred) {\n    if (succId === key && admittedIds.has(predId)) {\n      isSucc = true;\n      break;\n    }\n  }\n  if (isPred && isSucc) return \"transition\";\n  if (isPred) return \"historical\";\n  if (isSucc) return \"current\";\n  if (result.status === \"superseded\") {\n    // #1952 asOf mode: the successor is legitimately absent under the\n    // historical pin (a linked successor takes the pair branches above).\n    // The row was the live fact at the snapshot when the temporal\n    // validity boundary postdates the pin (\"current\" relative to the\n    // snapshot); already replaced at the pin is \"historical\". #2859: the\n    // boundary is the fact's validity flip — `invalidAt` (the supersession\n    // pipeline sets it to the successor's valid_at) — not the\n    // `supersededAt` write time; legacy rows without a window fall back\n    // to supersededAt.\n    return asOfMs === null ? \"historical\" : snapshotStateLabel(result, asOfMs);\n  }\n  return \"current\";\n}\n\nfunction snapshotStateLabel(result: StateViewResult, asOfMs: number): StateLabel {\n  const invalidAtMs = Date.parse(result.invalidAt ?? \"\");\n  const boundaryMs = Number.isFinite(invalidAtMs)\n    ? invalidAtMs\n    : Date.parse(result.supersededAt ?? \"\");\n  return Number.isFinite(boundaryMs) && boundaryMs <= asOfMs ? \"historical\" : \"current\";\n}\n\nexport function annotateStateView<T extends StateViewResult>(\n  results: T[],\n  query: string,\n  chains: readonly StateViewChain[],\n  options: { enabled?: boolean; asOfMs?: number } = {},\n): T[] {\n  const enabled = options.enabled === true;\n  if (!enabled || !isChangeOrientedQuery(query)) return results;\n  // #1952 asOf mode: under a historical pin the pipeline's isValidAsOf\n  // gate already decided validity at the pinned instant, so a predecessor\n  // must not be discarded merely because its successor is absent under\n  // the same filter. A valid asOf result is never emptied here.\n  const asOfMs =\n    typeof options.asOfMs === \"number\" && Number.isFinite(options.asOfMs)\n      ? options.asOfMs\n      : null;\n\n  const byPred = buildSuccessorMap(results, chains);\n  const candidateIds = new Set<string>();\n  for (const result of results) {\n    const key = resultStateViewKey(result);\n    if (key) candidateIds.add(key);\n  }\n  let admitted: T[];\n  if (asOfMs !== null) {\n    admitted = results.slice();\n  } else {\n    admitted = [];\n    for (const result of results) {\n      const { superseded, successorKey } = successorLinkOf(result, byPred);\n      if (!superseded || shouldWidenSuperseded(successorKey, candidateIds)) {\n        admitted.push(result);\n      }\n    }\n\n    // #1952 contract: superseded never appears without its successor. A\n    // successor can itself be dropped (filtered elsewhere, or transitively\n    // orphaned), so reconcile to a fixpoint instead of trusting the first pass.\n    let admittedIds = new Set(admitted.map(resultStateViewKey).filter(Boolean));\n    for (let changed = true; changed; ) {\n      changed = false;\n      for (let i = admitted.length - 1; i >= 0; i -= 1) {\n        const row = admitted[i]!;\n        const { superseded, successorKey } = successorLinkOf(row, byPred);\n        if (superseded && !shouldWidenSuperseded(successorKey, admittedIds)) {\n          admitted.splice(i, 1);\n          changed = true;\n        }\n      }\n      if (changed) admittedIds = new Set(admitted.map(resultStateViewKey).filter(Boolean));\n    }\n  }\n\n  const admittedIds = new Set(admitted.map(resultStateViewKey).filter(Boolean));\n  return admitted.map((result) => {\n    const key = resultStateViewKey(result);\n    const { successorKey } = successorLinkOf(result, byPred);\n    const stateLabel = labelFor(key, result, byPred, admittedIds, asOfMs);\n    if (result.supersededBy || !successorKey) return { ...result, stateLabel };\n    return { ...result, stateLabel, supersededBy: stateViewIdFromKey(successorKey) };\n  });\n}\n\n/**\n * #2859 — drop superseded rows whose successor is not in the pool BEFORE\n * the user cap/MMR runs, so post-cap orphan removal can never underfill\n * the result set. Reconciles to a fixpoint (a dropped successor orphans\n * its own predecessors). Rows with no successor links pass through in\n * order. ponytail: repeated full-pool passes are O(n²) on one long chain;\n * recall pools stay small, memoize per-key if pools ever grow.\n */\nexport function reconcileStateViewPairs<T extends StateViewResult>(results: readonly T[]): T[] {\n  const byPred = buildSuccessorMap(results, []);\n  let kept = results.slice();\n  for (let changed = true; changed; ) {\n    changed = false;\n    const keptKeys = new Set(kept.map(resultStateViewKey).filter(Boolean));\n    const next: T[] = [];\n    for (const row of kept) {\n      const { superseded, successorKey } = successorLinkOf(row, byPred);\n      if (superseded && !shouldWidenSuperseded(successorKey, keptKeys)) {\n        changed = true;\n        continue;\n      }\n      next.push(row);\n    }\n    if (changed) kept = next;\n  }\n  return kept;\n}\n\n/**\n * #2859 — packet-counting cap. A predecessor/successor chain admitted\n * together is ONE complete evidence packet: it consumes a single slot of\n * the user cap, and the slice never splits a packet at the boundary (no\n * underfill from post-cap orphan removal). Rows keep their incoming\n * (MMR) order; packets are ordered by first appearance. Call\n * reconcileStateViewPairs first so orphans never consume a slot.\n */\nexport function capStateViewPackets<T extends StateViewResult>(\n  ordered: readonly T[],\n  limit: number,\n): T[] {\n  const safeLimit =\n    typeof limit === \"number\" && Number.isFinite(limit) ? Math.max(0, Math.floor(limit)) : 0;\n  if (safeLimit === 0) return [];\n  if (ordered.length === 0) return [];\n\n  const byPred = buildSuccessorMap(ordered, []);\n  // Union-find over row keys; blank-key rows become per-index singletons.\n  const parent = new Map<string, string>();\n  const root = (key: string): string => {\n    let current = key;\n    for (;;) {\n      const up = parent.get(current);\n      if (up === undefined || up === current) {\n        parent.set(current, current);\n        return current;\n      }\n      current = up;\n    }\n  };\n  const union = (a: string, b: string): void => {\n    const ra = root(a);\n    const rb = root(b);\n    if (ra !== rb) parent.set(ra, rb);\n  };\n  const keys: string[] = [];\n  const keyToIndex = new Map<string, number>();\n  for (let i = 0; i < ordered.length; i += 1) {\n    // ponytail: blank-key rows must stay distinct singletons; index-keyed.\n    const key = resultStateViewKey(ordered[i]!) || `#idx${i}`;\n    keys.push(key);\n    if (!parent.has(key)) parent.set(key, key);\n    const first = keyToIndex.get(key);\n    if (first !== undefined) union(keys[first]!, key);\n    else keyToIndex.set(key, i);\n  }\n  for (const [predKey, succKey] of byPred) {\n    const predIdx = keyToIndex.get(predKey);\n    const succIdx = keyToIndex.get(succKey);\n    if (predIdx !== undefined && succIdx !== undefined) union(keys[predIdx]!, keys[succIdx]!);\n  }\n  // Packets ordered by first appearance; admit whole packets until the cap.\n  const selectedRoots = new Set<string>();\n  for (let i = 0; i < ordered.length && selectedRoots.size < safeLimit; i += 1) {\n    selectedRoots.add(root(keys[i]!));\n  }\n  const selected: T[] = [];\n  for (let i = 0; i < ordered.length; i += 1) {\n    if (selectedRoots.has(root(keys[i]!))) selected.push(ordered[i]!);\n  }\n  return selected;\n}\n"],"mappings":"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","names":["admittedIds"]}

package/dist/chunk-YFTNZMGR.js

@@ -0,0 +1,71 @@
+import {
+  isLoopbackHost
+} from "./chunk-C5C7IJ4Q.js";
+
+// src/background-generation-config.ts
+function stripTrailingSlashes(value) {
+  let end = value.length;
+  while (end > 0 && value.charCodeAt(end - 1) === 47) {
+    end -= 1;
+  }
+  return end === value.length ? value : value.slice(0, end);
+}
+function parseBackgroundEndpoint(value, keyName) {
+  const trimmed = stripTrailingSlashes(value.trim());
+  let parsed;
+  try {
+    parsed = new URL(trimmed);
+  } catch {
+    throw new Error(`${keyName} must be an absolute HTTP or HTTPS URL`);
+  }
+  if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
+    throw new Error(`${keyName} must use HTTP or HTTPS`);
+  }
+  if (parsed.protocol === "http:" && !isLoopbackHost(parsed.hostname)) {
+    throw new Error(`${keyName} must use HTTPS unless the host is loopback`);
+  }
+  if (parsed.username || parsed.password || parsed.search || parsed.hash) {
+    throw new Error(
+      `${keyName} must not include credentials, query parameters, or fragments`
+    );
+  }
+  return trimmed;
+}
+function parseBackgroundGenerationObject(raw, keyName) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+    throw new Error(`${keyName} must be an object`);
+  }
+  const record = raw;
+  const endpointRaw = record.endpoint;
+  if (typeof endpointRaw !== "string" || endpointRaw.trim().length === 0) {
+    throw new Error(`${keyName} must include an endpoint URL`);
+  }
+  const tokenRaw = record.token;
+  if (typeof tokenRaw !== "string" || tokenRaw.length === 0) {
+    throw new Error(`${keyName} must include a token`);
+  }
+  const timeoutRaw = record.timeoutSeconds;
+  let timeoutSeconds = 120;
+  if (timeoutRaw !== void 0) {
+    const parsed = typeof timeoutRaw === "number" ? timeoutRaw : Number(timeoutRaw);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+      throw new Error(`${keyName} timeoutSeconds must be a finite number > 0`);
+    }
+    timeoutSeconds = parsed;
+  }
+  return {
+    endpoint: parseBackgroundEndpoint(endpointRaw, `${keyName}.endpoint`),
+    token: tokenRaw,
+    timeoutSeconds
+  };
+}
+function parseBackgroundGeneration(cfg) {
+  const explicitRaw = cfg.backgroundGeneration;
+  if (explicitRaw === void 0 || explicitRaw === null) return void 0;
+  return parseBackgroundGenerationObject(explicitRaw, "backgroundGeneration");
+}
+
+export {
+  parseBackgroundGeneration
+};
+//# sourceMappingURL=chunk-YFTNZMGR.js.map

package/dist/chunk-YFTNZMGR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/background-generation-config.ts"],"sourcesContent":["import { isLoopbackHost } from \"./runtime/http-transport.js\";\n\nexport interface BackgroundGenerationConfig {\n  /** Full chat-completions URL. Never used as the global OpenAI base URL. */\n  endpoint: string;\n  /** Loopback bearer from the generated client file. */\n  token: string;\n  timeoutSeconds: number;\n}\n\nfunction stripTrailingSlashes(value: string): string {\n  let end = value.length;\n  while (end > 0 && value.charCodeAt(end - 1) === 47) {\n    end -= 1;\n  }\n  return end === value.length ? value : value.slice(0, end);\n}\n\nfunction parseBackgroundEndpoint(value: string, keyName: string): string {\n  const trimmed = stripTrailingSlashes(value.trim());\n  let parsed: URL;\n  try {\n    parsed = new URL(trimmed);\n  } catch {\n    throw new Error(`${keyName} must be an absolute HTTP or HTTPS URL`);\n  }\n  if (parsed.protocol !== \"https:\" && parsed.protocol !== \"http:\") {\n    throw new Error(`${keyName} must use HTTP or HTTPS`);\n  }\n  if (parsed.protocol === \"http:\" && !isLoopbackHost(parsed.hostname)) {\n    throw new Error(`${keyName} must use HTTPS unless the host is loopback`);\n  }\n  if (parsed.username || parsed.password || parsed.search || parsed.hash) {\n    throw new Error(\n      `${keyName} must not include credentials, query parameters, or fragments`,\n    );\n  }\n  return trimmed;\n}\n\nfunction parseBackgroundGenerationObject(\n  raw: unknown,\n  keyName: string,\n): BackgroundGenerationConfig {\n  if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) {\n    throw new Error(`${keyName} must be an object`);\n  }\n  const record = raw as Record<string, unknown>;\n  const endpointRaw = record.endpoint;\n  if (typeof endpointRaw !== \"string\" || endpointRaw.trim().length === 0) {\n    throw new Error(`${keyName} must include an endpoint URL`);\n  }\n  const tokenRaw = record.token;\n  if (typeof tokenRaw !== \"string\" || tokenRaw.length === 0) {\n    throw new Error(`${keyName} must include a token`);\n  }\n  const timeoutRaw = record.timeoutSeconds;\n  let timeoutSeconds = 120;\n  if (timeoutRaw !== undefined) {\n    const parsed = typeof timeoutRaw === \"number\" ? timeoutRaw : Number(timeoutRaw);\n    if (!Number.isFinite(parsed) || parsed <= 0) {\n      throw new Error(`${keyName} timeoutSeconds must be a finite number > 0`);\n    }\n    timeoutSeconds = parsed;\n  }\n  return {\n    endpoint: parseBackgroundEndpoint(endpointRaw, `${keyName}.endpoint`),\n    token: tokenRaw,\n    timeoutSeconds,\n  };\n}\n\nexport function parseBackgroundGeneration(\n  cfg: Record<string, unknown>,\n): BackgroundGenerationConfig | undefined {\n  const explicitRaw = cfg.backgroundGeneration;\n  if (explicitRaw === undefined || explicitRaw === null) return undefined;\n  return parseBackgroundGenerationObject(explicitRaw, \"backgroundGeneration\");\n}\n"],"mappings":";;;;;AAUA,SAAS,qBAAqB,OAAuB;AACnD,MAAI,MAAM,MAAM;AAChB,SAAO,MAAM,KAAK,MAAM,WAAW,MAAM,CAAC,MAAM,IAAI;AAClD,WAAO;AAAA,EACT;AACA,SAAO,QAAQ,MAAM,SAAS,QAAQ,MAAM,MAAM,GAAG,GAAG;AAC1D;AAEA,SAAS,wBAAwB,OAAe,SAAyB;AACvE,QAAM,UAAU,qBAAqB,MAAM,KAAK,CAAC;AACjD,MAAI;AACJ,MAAI;AACF,aAAS,IAAI,IAAI,OAAO;AAAA,EAC1B,QAAQ;AACN,UAAM,IAAI,MAAM,GAAG,OAAO,wCAAwC;AAAA,EACpE;AACA,MAAI,OAAO,aAAa,YAAY,OAAO,aAAa,SAAS;AAC/D,UAAM,IAAI,MAAM,GAAG,OAAO,yBAAyB;AAAA,EACrD;AACA,MAAI,OAAO,aAAa,WAAW,CAAC,eAAe,OAAO,QAAQ,GAAG;AACnE,UAAM,IAAI,MAAM,GAAG,OAAO,6CAA6C;AAAA,EACzE;AACA,MAAI,OAAO,YAAY,OAAO,YAAY,OAAO,UAAU,OAAO,MAAM;AACtE,UAAM,IAAI;AAAA,MACR,GAAG,OAAO;AAAA,IACZ;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,gCACP,KACA,SAC4B;AAC5B,MAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,GAAG;AACzD,UAAM,IAAI,MAAM,GAAG,OAAO,oBAAoB;AAAA,EAChD;AACA,QAAM,SAAS;AACf,QAAM,cAAc,OAAO;AAC3B,MAAI,OAAO,gBAAgB,YAAY,YAAY,KAAK,EAAE,WAAW,GAAG;AACtE,UAAM,IAAI,MAAM,GAAG,OAAO,+BAA+B;AAAA,EAC3D;AACA,QAAM,WAAW,OAAO;AACxB,MAAI,OAAO,aAAa,YAAY,SAAS,WAAW,GAAG;AACzD,UAAM,IAAI,MAAM,GAAG,OAAO,uBAAuB;AAAA,EACnD;AACA,QAAM,aAAa,OAAO;AAC1B,MAAI,iBAAiB;AACrB,MAAI,eAAe,QAAW;AAC5B,UAAM,SAAS,OAAO,eAAe,WAAW,aAAa,OAAO,UAAU;AAC9E,QAAI,CAAC,OAAO,SAAS,MAAM,KAAK,UAAU,GAAG;AAC3C,YAAM,IAAI,MAAM,GAAG,OAAO,6CAA6C;AAAA,IACzE;AACA,qBAAiB;AAAA,EACnB;AACA,SAAO;AAAA,IACL,UAAU,wBAAwB,aAAa,GAAG,OAAO,WAAW;AAAA,IACpE,OAAO;AAAA,IACP;AAAA,EACF;AACF;AAEO,SAAS,0BACd,KACwC;AACxC,QAAM,cAAc,IAAI;AACxB,MAAI,gBAAgB,UAAa,gBAAgB,KAAM,QAAO;AAC9D,SAAO,gCAAgC,aAAa,sBAAsB;AAC5E;","names":[]}

package/dist/{chunk-VELCIWJZ.js → chunk-YKREX63Z.js}

@@ -2,9 +2,10 @@ import {
   annotateStateView,
   isChangeOrientedQuery,
   parseRecallStateViews,
-  resultStateViewId,
-  shouldWidenSuperseded
-} from "./chunk-255PC37A.js";
+  resultStateViewKey,
+  shouldWidenSuperseded,
+  stateViewKey
+} from "./chunk-YDVAM7S4.js";
 
 // src/recall-state-view-widen.ts
 function widenRecallStateViews(results, query, config, pool = [], stateViewActive, asOfMs) {
@@ -13,19 +14,27 @@ function widenRecallStateViews(results, query, config, pool = [], stateViewActiv
   if (!enabled || !isChangeOrientedQuery(query)) return results;
   const asOfActive = typeof asOfMs === "number" && Number.isFinite(asOfMs);
   const candidateIds = /* @__PURE__ */ new Set();
+  const supersedesAnchors = /* @__PURE__ */ new Set();
   for (const result of results) {
-    const id = resultStateViewId(result);
-    if (id) candidateIds.add(id);
+    const key = resultStateViewKey(result);
+    if (!key) continue;
+    candidateIds.add(key);
+    if (result.supersedes) {
+      supersedesAnchors.add(stateViewKey(result.namespace, result.supersedes));
+    }
   }
   const seen = new Set(candidateIds);
   const extra = [];
   if (!asOfActive) {
     for (const item of pool) {
-      const id = resultStateViewId(item);
-      if (!id || seen.has(id)) continue;
-      if (!shouldWidenSuperseded(item.supersededBy, candidateIds)) continue;
+      const key = resultStateViewKey(item);
+      if (!key || seen.has(key)) continue;
+      const successorKey = item.supersededBy ? stateViewKey(item.namespace, item.supersededBy) : void 0;
+      if (!shouldWidenSuperseded(successorKey, candidateIds) && !supersedesAnchors.has(key)) {
+        continue;
+      }
       extra.push(item);
-      seen.add(id);
+      seen.add(key);
     }
   }
   return annotateStateView(extra.length > 0 ? results.concat(extra) : results, query, [], {
@@ -37,4 +46,4 @@ function widenRecallStateViews(results, query, config, pool = [], stateViewActiv
 export {
   widenRecallStateViews
 };
-//# sourceMappingURL=chunk-VELCIWJZ.js.map
+//# sourceMappingURL=chunk-YKREX63Z.js.map

package/dist/chunk-YKREX63Z.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recall-state-view-widen.ts"],"sourcesContent":["/**\n * Recall state-view widening (issue #1952).\n *\n * When recallStateViews is on and the query is change-oriented, admit a\n * superseded memory only if its successor is already in the candidate set.\n * Flag off / non-change queries are identity.\n */\nimport {\n  annotateStateView,\n  isChangeOrientedQuery,\n  parseRecallStateViews,\n  resultStateViewKey,\n  shouldWidenSuperseded,\n  stateViewKey,\n  type StateViewResult,\n} from \"./recall-state-view.js\";\n\nexport function widenRecallStateViews<T extends StateViewResult>(\n  results: T[],\n  query: string,\n  config: unknown,\n  pool: readonly T[] = [],\n  /**\n   * #1952 — per-request effective flag (per-call `stateView` OR config,\n   * gated on change intent), computed once at recall entry and threaded\n   * through. When `true` it wins over the config read so a per-call\n   * override survives a global `false` at the inject seam. Callers that\n   * omit it keep the legacy config-only behavior.\n   */\n  stateViewActive?: boolean,\n  /**\n   * #1952 — historical recall pin (epoch ms). When set, the pool is\n   * never widened (pool rows did not survive the asOf validity filter,\n   * so pulling a not-yet-valid successor into a historical snapshot\n   * would be wrong) and annotation runs in asOf mode: a predecessor is\n   * kept and labeled relative to the snapshot without requiring its\n   * successor.\n   */\n  asOfMs?: number,\n): T[] {\n  const raw =\n    typeof config === \"object\" && config !== null && \"recallStateViews\" in config\n      ? config.recallStateViews\n      : undefined;\n  const enabled = stateViewActive === true || parseRecallStateViews(raw);\n  if (!enabled || !isChangeOrientedQuery(query)) return results;\n  const asOfActive = typeof asOfMs === \"number\" && Number.isFinite(asOfMs);\n\n  // #2859: matches are namespace-qualified, and a successor's `supersedes`\n  // back-pointer anchors its predecessor even when the predecessor's own\n  // `supersededBy` is absent.\n  const candidateIds = new Set<string>();\n  const supersedesAnchors = new Set<string>();\n  for (const result of results) {\n    const key = resultStateViewKey(result);\n    if (!key) continue;\n    candidateIds.add(key);\n    if (result.supersedes) {\n      supersedesAnchors.add(stateViewKey(result.namespace, result.supersedes));\n    }\n  }\n\n  const seen = new Set(candidateIds);\n  const extra: T[] = [];\n  if (!asOfActive) {\n    for (const item of pool) {\n      const key = resultStateViewKey(item);\n      if (!key || seen.has(key)) continue;\n      const successorKey = item.supersededBy\n        ? stateViewKey(item.namespace, item.supersededBy)\n        : undefined;\n      if (!shouldWidenSuperseded(successorKey, candidateIds) && !supersedesAnchors.has(key)) {\n        continue;\n      }\n      extra.push(item);\n      seen.add(key);\n    }\n  }\n\n  return annotateStateView(extra.length > 0 ? results.concat(extra) : results, query, [], {\n    enabled: true,\n    ...(asOfActive ? { asOfMs } : {}),\n  });\n}\n"],"mappings":";;;;;;;;;;AAiBO,SAAS,sBACd,SACA,OACA,QACA,OAAqB,CAAC,GAQtB,iBASA,QACK;AACL,QAAM,MACJ,OAAO,WAAW,YAAY,WAAW,QAAQ,sBAAsB,SACnE,OAAO,mBACP;AACN,QAAM,UAAU,oBAAoB,QAAQ,sBAAsB,GAAG;AACrE,MAAI,CAAC,WAAW,CAAC,sBAAsB,KAAK,EAAG,QAAO;AACtD,QAAM,aAAa,OAAO,WAAW,YAAY,OAAO,SAAS,MAAM;AAKvE,QAAM,eAAe,oBAAI,IAAY;AACrC,QAAM,oBAAoB,oBAAI,IAAY;AAC1C,aAAW,UAAU,SAAS;AAC5B,UAAM,MAAM,mBAAmB,MAAM;AACrC,QAAI,CAAC,IAAK;AACV,iBAAa,IAAI,GAAG;AACpB,QAAI,OAAO,YAAY;AACrB,wBAAkB,IAAI,aAAa,OAAO,WAAW,OAAO,UAAU,CAAC;AAAA,IACzE;AAAA,EACF;AAEA,QAAM,OAAO,IAAI,IAAI,YAAY;AACjC,QAAM,QAAa,CAAC;AACpB,MAAI,CAAC,YAAY;AACf,eAAW,QAAQ,MAAM;AACvB,YAAM,MAAM,mBAAmB,IAAI;AACnC,UAAI,CAAC,OAAO,KAAK,IAAI,GAAG,EAAG;AAC3B,YAAM,eAAe,KAAK,eACtB,aAAa,KAAK,WAAW,KAAK,YAAY,IAC9C;AACJ,UAAI,CAAC,sBAAsB,cAAc,YAAY,KAAK,CAAC,kBAAkB,IAAI,GAAG,GAAG;AACrF;AAAA,MACF;AACA,YAAM,KAAK,IAAI;AACf,WAAK,IAAI,GAAG;AAAA,IACd;AAAA,EACF;AAEA,SAAO,kBAAkB,MAAM,SAAS,IAAI,QAAQ,OAAO,KAAK,IAAI,SAAS,OAAO,CAAC,GAAG;AAAA,IACtF,SAAS;AAAA,IACT,GAAI,aAAa,EAAE,OAAO,IAAI,CAAC;AAAA,EACjC,CAAC;AACH;","names":[]}

package/dist/{chunk-BLHX5FQW.js → chunk-YUW66UAH.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-BOADKFN4.js";
 import {
   gatewayTaskChainOptions
-} from "./chunk-YEN4TREG.js";
+} from "./chunk-LQNRVPTV.js";
 import {
   normalizeProcedureSteps
 } from "./chunk-QDW3E4RD.js";
@@ -491,4 +491,4 @@ export {
   createVerdictCache,
   createDeferCountMap
 };
-//# sourceMappingURL=chunk-BLHX5FQW.js.map
+//# sourceMappingURL=chunk-YUW66UAH.js.map

package/dist/{chunk-DOQLHCSS.js → chunk-ZBW7A667.js}

@@ -1,7 +1,7 @@
 import {
   SupportPassportError,
   getOperation
-} from "./chunk-JLXWRQNR.js";
+} from "./chunk-UZEHHXYC.js";
 import {
   abortError,
   isAbortError
@@ -499,4 +499,4 @@ export {
   buildSupportPassportPublicRequestHandler,
   composeSupportPassportExternalRequestHandlers
 };
-//# sourceMappingURL=chunk-DOQLHCSS.js.map
+//# sourceMappingURL=chunk-ZBW7A667.js.map

package/dist/{chunk-4DPDIOVA.js → chunk-ZEGL7YCC.js}

@@ -1,6 +1,6 @@
 import {
   isRecallDisclosure
-} from "./chunk-RN3MVLW3.js";
+} from "./chunk-IYKZJVL5.js";
 import {
   estimateTokenCount
 } from "./chunk-TOTT6S2V.js";
@@ -306,4 +306,4 @@ export {
   RecallXrayBuilder,
   summarizeDisclosureTokens
 };
-//# sourceMappingURL=chunk-4DPDIOVA.js.map
+//# sourceMappingURL=chunk-ZEGL7YCC.js.map

package/dist/{chunk-VVX5PZFS.js → chunk-ZHXSOMYH.js}

@@ -19,7 +19,7 @@ import {
 import {
   decryptCapsuleFileInMemory,
   isEncryptedCapsuleFile
-} from "./chunk-DQEMWVMT.js";
+} from "./chunk-X7Y7WX73.js";
 import {
   assertIsDirectoryNotSymlink,
   assertRealpathInsideRoot,
@@ -294,4 +294,4 @@ function mintForkId(capsuleId, originalId, now) {
 export {
   importCapsule
 };
-//# sourceMappingURL=chunk-VVX5PZFS.js.map
+//# sourceMappingURL=chunk-ZHXSOMYH.js.map

package/dist/{chunk-GCBIXUPT.js → chunk-ZMWSYUUL.js}

@@ -5,7 +5,7 @@ import {
 } from "./chunk-TBBDFYXW.js";
 import {
   hasLiveSupportPassportCard
-} from "./chunk-PWPIERBM.js";
+} from "./chunk-37CAEC7E.js";
 
 // src/tier-routing.ts
 function requiresHotTier(memory) {
@@ -80,4 +80,4 @@ export {
   computeTierValueScore,
   decideTierTransition
 };
-//# sourceMappingURL=chunk-GCBIXUPT.js.map
+//# sourceMappingURL=chunk-ZMWSYUUL.js.map

package/dist/{chunk-X2QPKLPL.js → chunk-ZZUVBZL2.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-PJKTFXE2.js";
 import {
   isSupportPassportPrivateMemory
-} from "./chunk-PWPIERBM.js";
+} from "./chunk-37CAEC7E.js";
 import {
   isHandleToken
 } from "./chunk-JAKIDQB2.js";
@@ -189,4 +189,4 @@ export {
   recallForActiveMemory,
   getMemoryForActiveMemory
 };
-//# sourceMappingURL=chunk-X2QPKLPL.js.map
+//# sourceMappingURL=chunk-ZZUVBZL2.js.map

package/dist/{cli-1mzd5TM4.d.ts → cli-DGq0MNpO.d.ts}

@@ -1,16 +1,16 @@
 import { CompoundingPromotionReport } from './compounding/engine.js';
 import { ConversationIndexBackendInspection } from './conversation-index/backend.js';
 import { MigrateObservationsResult } from './maintenance/migrate-observations.js';
-import { M as MemoryFile, m as MemoryFrontmatter, x as MemoryStatus, ac as BehaviorSignalEvent, Q as QmdSearchResult, ah as BulkImportResult, am as MemoryActionEvent, K as MemoryLifecycleEvent } from './types-48sPkWB0.js';
-import { C as ConversationIndexCoordinator, T as TierMigrationCoordinator, O as Orchestrator } from './orchestrator-DBUX-aAM.js';
-import { S as StorageManager } from './storage-Cbll3-Tk.js';
+import { M as MemoryFile, m as MemoryFrontmatter, x as MemoryStatus, ac as BehaviorSignalEvent, Q as QmdSearchResult, ah as BulkImportResult, am as MemoryActionEvent, K as MemoryLifecycleEvent } from './types-Cyr32ABj.js';
+import { C as ConversationIndexCoordinator, T as TierMigrationCoordinator, O as Orchestrator } from './orchestrator-ComHLm49.js';
+import { S as StorageManager } from './storage-wvX01lht.js';
 import { TrustZoneDemoSeedResult, TrustZoneName, TrustZonePromotionResult, TrustZoneStoreStatus } from './trust-zones.js';
-import { f as EngramAccessService } from './access-service-DwHC7lcV.js';
+import { f as EngramAccessService } from './access-service-MY4bsr_Q.js';
 import { Writable, Readable } from 'node:stream';
 import { ResolveSecretRefFn } from './resolve-auth-token.js';
 import { CausalTrajectoryStoreStatus } from './causal-trajectory.js';
 import { C as ConnectorRunResult, a as ConnectorsOutputFormat } from './connectors-cli-2iaQ5tX2.js';
-import { P as ProcessBatchFn } from './pipeline-BqgcOk1Z.js';
+import { P as ProcessBatchFn } from './pipeline-CiYcqqhl.js';
 import { RuntimePolicyValues } from './policy-runtime.js';
 import { MemoryGovernanceRunResult, MemoryGovernanceSummary, MemoryGovernanceMetrics, MemoryGovernanceQualityScore, MemoryGovernanceReviewQueueEntry, MemoryGovernanceAppliedAction, MemoryGovernanceTransitionReport, MemoryGovernanceManifest, MemoryGovernanceRestoreManifest, RestoreMemoryGovernanceRunResult } from './maintenance/memory-governance.js';
 import { RebuildMemoryProjectionResult, RepairMemoryProjectionResult, VerifyMemoryProjectionResult } from './maintenance/rebuild-memory-projection.js';

package/dist/cli-fallback.d.ts

@@ -37,16 +37,18 @@ type CodexCliFallbackRunner = (request: CodexCliFallbackRequest) => Promise<Code
  * claimed the seam, so explicit registrations always win.
  */
 declare function isCodexCliFallbackRunnerRegistered(): boolean;
+/** Current process-local Codex CLI runner, if any. */
+declare function getCodexCliFallbackRunnerForProcess(): CodexCliFallbackRunner | undefined;
 /**
  * Registers the process-local Codex CLI transport. Core itself stays free of
  * child_process here; hosts and benchmark runtimes opt in, and the
  * codex-subscription module registers a subprocess runner on demand.
  */
 declare function setCodexCliFallbackRunnerForProcess(runner: CodexCliFallbackRunner | undefined): () => void;
-declare function callCodexCliFallback(config: CodexCliFallbackConfig, modelId: string, messages: CodexCliFallbackMessage[], options?: CodexCliFallbackOptions): Promise<CodexCliFallbackResult>;
+declare function callCodexCliFallback(config: CodexCliFallbackConfig, modelId: string, messages: CodexCliFallbackMessage[], options?: CodexCliFallbackOptions, runner?: CodexCliFallbackRunner | undefined): Promise<CodexCliFallbackResult>;
 declare function normalizeCodexCliTimeoutMs(value: unknown): number;
 declare const __codexCliFallbackTestHooks: {
     setRunCodexCliForTest: typeof setCodexCliFallbackRunnerForProcess;
 };
 
-export { type CodexCliFallbackConfig, type CodexCliFallbackMessage, type CodexCliFallbackOptions, type CodexCliFallbackRequest, type CodexCliFallbackResult, type CodexCliFallbackRunner, __codexCliFallbackTestHooks, callCodexCliFallback, isCodexCliFallbackRunnerRegistered, normalizeCodexCliTimeoutMs, setCodexCliFallbackRunnerForProcess };
+export { type CodexCliFallbackConfig, type CodexCliFallbackMessage, type CodexCliFallbackOptions, type CodexCliFallbackRequest, type CodexCliFallbackResult, type CodexCliFallbackRunner, __codexCliFallbackTestHooks, callCodexCliFallback, getCodexCliFallbackRunnerForProcess, isCodexCliFallbackRunnerRegistered, normalizeCodexCliTimeoutMs, setCodexCliFallbackRunnerForProcess };

package/dist/cli-fallback.js

@@ -1,14 +1,16 @@
 import {
   __codexCliFallbackTestHooks,
   callCodexCliFallback,
+  getCodexCliFallbackRunnerForProcess,
   isCodexCliFallbackRunnerRegistered,
   normalizeCodexCliTimeoutMs,
   setCodexCliFallbackRunnerForProcess
-} from "./chunk-65RENJGB.js";
+} from "./chunk-E2AWJ7KQ.js";
 import "./chunk-PZ5AY32C.js";
 export {
   __codexCliFallbackTestHooks,
   callCodexCliFallback,
+  getCodexCliFallbackRunnerForProcess,
   isCodexCliFallbackRunnerRegistered,
   normalizeCodexCliTimeoutMs,
   setCodexCliFallbackRunnerForProcess