@remnic/plugin-openclaw 1.0.34 → 1.0.36

package/README.md

@@ -1,8 +1,8 @@
 # @remnic/plugin-openclaw
 
-OpenClaw plugin for Remnic memory. The package bundles the OpenClaw adapter plus the Remnic core runtime so it can run without a separate Remnic service; the adapter registers OpenClaw hooks/tools and delegates memory behavior to [`@remnic/core`](https://www.npmjs.com/package/@remnic/core).
+OpenClaw plugin for Remnic memory and context. The package bundles the OpenClaw adapter plus the Remnic core runtime so it can run without a separate Remnic service; the adapter registers OpenClaw hooks/tools and delegates memory behavior to [`@remnic/core`](https://www.npmjs.com/package/@remnic/core).
 
-Part of [Remnic](https://github.com/joshuaswarren/remnic), the universal memory layer for AI agents.
+Part of [Remnic](https://github.com/joshuaswarren/remnic), open-source memory and context for user-aware agents.
 
 ## Install
 
@@ -12,7 +12,7 @@ openclaw plugins install clawhub:@remnic/plugin-openclaw
 
 Or ask your OpenClaw agent:
 
-> Install the @remnic/plugin-openclaw plugin and configure it as my memory system.
+> Install the @remnic/plugin-openclaw ClawHub plugin and configure it as my memory system.
 
 ## Configure
 
@@ -86,7 +86,7 @@ This plugin hooks into the OpenClaw gateway lifecycle:
 - **`agent_end`** -- buffers the conversation turn for extraction
 - **`before_compaction`** / **`after_compaction`** -- saves checkpoints and triggers session reset on context compaction
 - **`before_reset`** -- bounded flush of the in-flight buffer before OpenClaw discards a session
-- **`commands.list`** -- exposes Remnic slash-command descriptors to the command palette
+- **`api.registerCommand()`** -- exposes Remnic slash-command descriptors to the command palette
 - **`session_start`** / **`session_end`** -- session lifecycle tracking
 - **`before_tool_call`** / **`after_tool_call`** -- tool usage observation for analytics
 - **`llm_output`** -- LLM token usage tracking
@@ -164,13 +164,62 @@ CI jobs that provision OpenClaw should use
 `npm run check:openclaw-sdk-surface:required` or pass
 `-- --require --package-root <path>` so a missing SDK fails instead of skipping.
 
-Last compatibility sweep: May 7, 2026. The SDK surface check passed against
+Last compatibility sweep: May 19, 2026. The SDK surface check passed against
 `openclaw@2026.5.3`, `openclaw@2026.5.3-1`, `openclaw@2026.5.4-beta.1`,
 `openclaw@2026.5.4-beta.2`, `openclaw@2026.5.4-beta.3`,
-`openclaw@2026.5.4`, `openclaw@2026.5.5`, and `openclaw@2026.5.6`.
+`openclaw@2026.5.4`, `openclaw@2026.5.5`, `openclaw@2026.5.6`,
+`openclaw@2026.5.16-beta.2`, `openclaw@2026.5.16-beta.3`, and
+`openclaw@2026.5.16-beta.4`. The May 19 sweep also checked the source SDK
+surface for `openclaw@2026.5.19-beta.1`, which covers the intervening
+`2026.5.16-beta.6`, `2026.5.16-beta.7`, and `2026.5.18-beta.1` release line
+for the Remnic adapter surfaces.
 Keep the peer range broad unless an upstream release removes a runtime surface
 Remnic actively uses.
 
+OpenClaw 2026.5.16 package-entry discovery prefers explicit built runtime
+entries for installed packages. The published Remnic adapter declares
+`openclaw.runtimeExtensions: ["./dist/index.js"]` alongside the existing
+extension entry, and its package install metadata advertises
+`openclaw.install.clawhubSpec: "clawhub:@remnic/plugin-openclaw"`,
+`openclaw.install.npmSpec: "@remnic/plugin-openclaw"`, and
+`openclaw.install.defaultChoice: "clawhub"`. That keeps OpenClaw setup,
+repair, and update flows ClawHub-first while preserving npm as the fallback
+install surface and `>=2026.5.16-beta.1` as the minimum supported host range.
+The manifest also declares `activation.onStartup: false`, leaves provider
+ownership to the host, exposes the optional plugin-mode OpenAI key through
+`providerAuthChoices`, and keeps `providerAuthEnvVars.openai` as compatibility
+metadata for OpenClaw's pre-runtime env-var auth probes.
+
+OpenClaw 2026.5.16-beta.3 keeps those install and auth ownership contracts
+intact. The sweep confirmed that Remnic still relies on host-owned gateway
+restart/reload behavior after plugin install changes, uses `gateway_stop`
+instead of the deprecated `deactivate` cleanup alias, and should not claim
+OpenAI `setup.providers` ownership because gateway/provider configuration
+remains host-owned.
+
+OpenClaw 2026.5.16-beta.4 treats `setup.providers[].id` as provider ownership
+metadata with globally unique ids. Remnic does not own the `openai` provider,
+so the canonical manifest keeps OpenAI API-key metadata on `providerAuthChoices`
+and the compatibility `providerAuthEnvVars.openai` surface instead of declaring
+`setup.providers`.
+
+OpenClaw 2026.5.16-beta.6 added `defineToolPlugin` and the authoring CLI for
+simple typed tool-only plugins. Remnic intentionally stays on `definePluginEntry`
+because the adapter owns mixed memory-slot hooks, lifecycle handlers, slash
+command metadata, public artifacts, and runtime tools rather than only static
+tools.
+
+OpenClaw 2026.5.16-beta.7 through 2026.5.19-beta.1 keep the Remnic-required
+plugin install, ClawHub fallback, manifest contract, hook, memory-slot, gateway
+LLM, and plugin security-scan surfaces compatible. Those newer OpenClaw hosts
+raise their runtime floor to Node.js `>=22.19.0`, but the Remnic adapter package
+keeps its broad host peer range so older advertised 2026.5.16 hosts do not
+select a package with an incompatible package-level engine gate. The manifest
+continues to avoid `setup.providers.openai`; OpenClaw still treats provider ids
+there as ownership metadata, while Remnic only advertises an optional
+plugin-mode OpenAI key through `providerAuthChoices` and the deprecated
+`providerAuthEnvVars.openai` compatibility probe.
+
 Native memory registrars are tracked separately in
 [`docs/plugins/openclaw-native-memory-registrars.md`](../../docs/plugins/openclaw-native-memory-registrars.md).
 That spike explains why Remnic currently uses `registerMemoryCapability()` as
@@ -254,7 +303,7 @@ private plugin state, transcript buffers, auth metadata, or artifact paths.
 | `session_start` / `session_end` hooks | Supported | 2026.3.22 |
 | `before_compaction` / `after_compaction` hooks | Supported | 2026.3.22 |
 | `before_reset` hook | Supported | 2026.4.10 |
-| `commands.list` runtime discovery | Supported | 2026.4.10 |
+| `api.registerCommand()` runtime discovery | Supported | 2026.5.16 |
 | `api.resetSession()` (compaction reset) | Supported | 2026.3.22 |
 | Checkpoint saves before compaction | Supported | 2026.3.22 |
 
@@ -285,8 +334,8 @@ registered as the `before_prompt_build` hook timeout on OpenClaw versions with
 per-hook timeout support. Raise it if first-turn recall is timing out during
 slow startup; older OpenClaw versions ignore the extra hook option safely.
 
-Session-scoped recall controls are exposed through OpenClaw's command
-discovery surface:
+Session-scoped recall controls are exposed through OpenClaw's
+`api.registerCommand()` surface when it is available:
 
 - `remnic off` / `remnic on`
 - `remnic status`
@@ -329,7 +378,7 @@ replays stay idempotent:
             "maxEntries": 500,
             "injectRecentCount": 3,
             "minIntervalMinutes": 120,
-            "narrativeModel": "gpt-5.2",
+            "narrativeModel": "gpt-5.5",
             "narrativePromptStyle": "reflective",
             "watchFile": true
           }

package/dist/{calibration-JD4AU7FB.js → calibration-RKL2LRW4.js}

@@ -1,15 +1,15 @@
 import {
   listJsonFiles
-} from "./chunk-5LE4HTVL.js";
+} from "./chunk-25J4PXDH.js";
 import {
   FallbackLlmClient
-} from "./chunk-7NUFIRM3.js";
+} from "./chunk-SWOYEQN2.js";
 import "./chunk-3A5ELHTT.js";
 import {
   log
 } from "./chunk-UFU5GGGA.js";
-import "./chunk-TDRJVMUP.js";
-import "./chunk-MLKGABMK.js";
+import "./chunk-EH4AXGRO.js";
+import "./chunk-I2KLQ2HA.js";
 
 // ../remnic-core/src/calibration.ts
 import { createHash } from "crypto";

package/dist/{capsule-cli-GBM3WPAM.js → capsule-cli-EHZPMXBC.js}

@@ -13,8 +13,8 @@ import {
   parseCapsuleSince,
   renderCapsuleInspect,
   renderCapsuleList
-} from "./chunk-LLUROTZJ.js";
-import "./chunk-MLKGABMK.js";
+} from "./chunk-QQXJODFL.js";
+import "./chunk-I2KLQ2HA.js";
 export {
   defaultCapsulesDir,
   parseCapsuleConflictMode,

package/dist/{capsule-crypto-K3IRTKRH.js → capsule-crypto-JS67OSWM.js}

@@ -3,12 +3,12 @@ import {
   decryptCapsuleFileInMemory,
   encryptCapsuleFile,
   isEncryptedCapsuleFile
-} from "./chunk-SSFTU6LP.js";
-import "./chunk-CXM7EBAO.js";
+} from "./chunk-ZS6VABML.js";
+import "./chunk-MXFJXUHC.js";
 import "./chunk-JZBOXOUC.js";
 import "./chunk-6IWEAUN6.js";
 import "./chunk-YGGGUTG3.js";
-import "./chunk-MLKGABMK.js";
+import "./chunk-I2KLQ2HA.js";
 export {
   decryptCapsuleFile,
   decryptCapsuleFileInMemory,

package/dist/capsule-export-YPDWRB3C.js

@@ -0,0 +1,17 @@
+import {
+  exportCapsule,
+  isValidCapsuleSince
+} from "./chunk-3IHGISUN.js";
+import "./chunk-YKV4EFUI.js";
+import "./chunk-E4RM7637.js";
+import "./chunk-ZS6VABML.js";
+import "./chunk-4XDQ3KEC.js";
+import "./chunk-MXFJXUHC.js";
+import "./chunk-JZBOXOUC.js";
+import "./chunk-6IWEAUN6.js";
+import "./chunk-YGGGUTG3.js";
+import "./chunk-I2KLQ2HA.js";
+export {
+  exportCapsule,
+  isValidCapsuleSince
+};

package/dist/capsule-import-SWPOFG6F.js

@@ -0,0 +1,16 @@
+import {
+  importCapsule
+} from "./chunk-NNAN63QK.js";
+import "./chunk-YKV4EFUI.js";
+import "./chunk-E4RM7637.js";
+import "./chunk-ZS6VABML.js";
+import "./chunk-4XDQ3KEC.js";
+import "./chunk-MXFJXUHC.js";
+import "./chunk-JZBOXOUC.js";
+import "./chunk-6IWEAUN6.js";
+import "./chunk-QMUQV5NP.js";
+import "./chunk-YGGGUTG3.js";
+import "./chunk-I2KLQ2HA.js";
+export {
+  importCapsule
+};

package/dist/{capsule-merge-IWOQ34KL.js → capsule-merge-YXAF7ZJW.js}

@@ -1,18 +1,18 @@
-import {
-  parseExportBundle
-} from "./chunk-4LYQ4ONL.js";
 import {
   assertIsDirectoryNotSymlink,
   assertRealpathInsideRoot,
   fromPosixRelPath,
   isPathInsideRoot,
   sha256String
-} from "./chunk-NKVIN6RD.js";
-import "./chunk-EXDYWXMB.js";
+} from "./chunk-YKV4EFUI.js";
+import {
+  parseExportBundle
+} from "./chunk-E4RM7637.js";
+import "./chunk-4XDQ3KEC.js";
 import {
   createVersion
-} from "./chunk-6OJAU466.js";
-import "./chunk-MLKGABMK.js";
+} from "./chunk-QMUQV5NP.js";
+import "./chunk-I2KLQ2HA.js";
 
 // ../remnic-core/src/transfer/capsule-merge.ts
 import * as fsReadModule0 from "fs/promises";

package/dist/{causal-chain-WYN5QOPS.js → causal-chain-BVTOWZKC.js}

@@ -6,12 +6,12 @@ import {
   stitchCausalChain,
   validateCausalEdge,
   writeChainIndex
-} from "./chunk-SVSQAG6M.js";
-import "./chunk-WPINX4MF.js";
+} from "./chunk-KC7KSQR4.js";
+import "./chunk-3IKMUNW5.js";
 import "./chunk-3G7FAF6S.js";
-import "./chunk-5LE4HTVL.js";
+import "./chunk-25J4PXDH.js";
 import "./chunk-UFU5GGGA.js";
-import "./chunk-MLKGABMK.js";
+import "./chunk-I2KLQ2HA.js";
 export {
   makeEdgeId,
   readChainIndex,

package/dist/{causal-consolidation-DSLFN64P.js → causal-consolidation-DRPM2KOE.js}

@@ -1,38 +1,41 @@
 import {
   readChainIndex,
   resolveChainsDir
-} from "./chunk-SVSQAG6M.js";
+} from "./chunk-KC7KSQR4.js";
 import {
   buildExtensionsBlockForConsolidation,
   runPostConsolidationMaterialize
-} from "./chunk-NDZNURDM.js";
-import "./chunk-WPINX4MF.js";
+} from "./chunk-SEGEX7W4.js";
+import "./chunk-TH5FF5SC.js";
+import {
+  resolveCausalTrajectoryStoreDir
+} from "./chunk-3IKMUNW5.js";
 import {
   isRecord
 } from "./chunk-3G7FAF6S.js";
 import {
   listJsonFiles,
   readJsonFile
-} from "./chunk-5LE4HTVL.js";
+} from "./chunk-25J4PXDH.js";
 import {
   FallbackLlmClient
-} from "./chunk-7NUFIRM3.js";
+} from "./chunk-SWOYEQN2.js";
 import "./chunk-3A5ELHTT.js";
-import "./chunk-ZXLYEVOP.js";
-import "./chunk-6OJAU466.js";
+import "./chunk-G3CZA4SD.js";
+import "./chunk-QMUQV5NP.js";
 import "./chunk-RKR6PTPA.js";
 import {
   log
 } from "./chunk-UFU5GGGA.js";
 import "./chunk-YGGGUTG3.js";
-import "./chunk-TDRJVMUP.js";
-import "./chunk-MLKGABMK.js";
+import "./chunk-EH4AXGRO.js";
+import "./chunk-I2KLQ2HA.js";
 
 // ../remnic-core/src/causal-consolidation.ts
 import { createHash } from "crypto";
 import path from "path";
 async function readAllTrajectories(memoryDir, causalTrajectoryStoreDir) {
-  const root = causalTrajectoryStoreDir ? path.join(memoryDir, causalTrajectoryStoreDir) : path.join(memoryDir, "state", "causal-trajectories");
+  const root = resolveCausalTrajectoryStoreDir(memoryDir, causalTrajectoryStoreDir);
   const trajectoriesDir = path.join(root, "trajectories");
   const files = await listJsonFiles(trajectoriesDir).catch(() => []);
   const results = [];

package/dist/{causal-retrieval-NZHQOZOE.js → causal-retrieval-XAP6QKHZ.js}

@@ -1,17 +1,16 @@
 import {
   readChainIndex,
   resolveChainsDir
-} from "./chunk-SVSQAG6M.js";
+} from "./chunk-KC7KSQR4.js";
 import {
   searchCausalTrajectories
-} from "./chunk-6UFI73TJ.js";
-import "./chunk-WPINX4MF.js";
+} from "./chunk-3IKMUNW5.js";
 import "./chunk-3G7FAF6S.js";
-import "./chunk-5LE4HTVL.js";
+import "./chunk-25J4PXDH.js";
 import {
   log
 } from "./chunk-UFU5GGGA.js";
-import "./chunk-MLKGABMK.js";
+import "./chunk-I2KLQ2HA.js";
 
 // ../remnic-core/src/causal-retrieval.ts
 function walkUpstream(seedId, index, maxDepth, counterfactualBoost) {

package/dist/{causal-trajectory-graph-VBPE2WPM.js → causal-trajectory-graph-ZWQWZ7N5.js}

@@ -1,7 +1,7 @@
 import {
   appendEdge
-} from "./chunk-3GUF7RQI.js";
-import "./chunk-MLKGABMK.js";
+} from "./chunk-IO5WWY6A.js";
+import "./chunk-I2KLQ2HA.js";
 
 // ../remnic-core/src/causal-trajectory-graph.ts
 function causalTrajectoryGraphNodeId(trajectoryId, stage) {

package/dist/{chunk-5LE4HTVL.js → chunk-25J4PXDH.js}

@@ -20,29 +20,11 @@ async function listJsonFiles(dir) {
     return [];
   }
 }
-async function listNamedFiles(dir, fileName) {
-  try {
-    const entries = await readdir(dir, { withFileTypes: true });
-    const out = [];
-    for (const entry of entries) {
-      const fullPath = path.join(dir, entry.name);
-      if (entry.isDirectory()) {
-        out.push(...await listNamedFiles(fullPath, fileName));
-      } else if (entry.isFile() && entry.name === fileName) {
-        out.push(fullPath);
-      }
-    }
-    return out.sort();
-  } catch {
-    return [];
-  }
-}
 async function readJsonFile(filePath) {
   return JSON.parse(await fileReader(filePath, "utf8"));
 }
 
 export {
   listJsonFiles,
-  listNamedFiles,
   readJsonFile
 };

package/dist/{chunk-FGTYFLL5.js → chunk-3IHGISUN.js}

@@ -1,18 +1,18 @@
-import {
-  CAPSULE_ID_PATTERN,
-  CapsuleBlockSchema,
-  ExportBundleV2Schema,
-  ExportManifestV2Schema
-} from "./chunk-4LYQ4ONL.js";
 import {
   listFilesRecursive,
   sha256File,
   toPosixRelPath,
   writeJsonFile
-} from "./chunk-NKVIN6RD.js";
+} from "./chunk-YKV4EFUI.js";
+import {
+  CAPSULE_ID_PATTERN,
+  CapsuleBlockSchema,
+  ExportBundleV2Schema,
+  ExportManifestV2Schema
+} from "./chunk-E4RM7637.js";
 import {
   encryptCapsuleFile
-} from "./chunk-SSFTU6LP.js";
+} from "./chunk-ZS6VABML.js";
 
 // ../remnic-core/src/transfer/capsule-export.ts
 import * as fsReadModule0 from "fs/promises";
@@ -20,27 +20,33 @@ const mkdir = fsReadModule0.mkdir;
 const fileReader = fsReadModule0["re"+"ad"+"Fi"+"le"];
 const stat = fsReadModule0.stat;
 const writeFile = fsReadModule0.writeFile;
-import path from "path";
+import path2 from "path";
 import { gzipSync } from "zlib";
 
 // ../remnic-core/src/transfer/constants.ts
 var EXPORT_FORMAT = "openclaw-engram-export";
-var EXPORT_SCHEMA_VERSION = 1;
 var CAPSULE_SCHEMA_VERSION = 2;
 
-// ../remnic-core/src/transfer/capsule-export.ts
-var DEFAULT_EXCLUDE_DIRS = /* @__PURE__ */ new Set([
+// ../remnic-core/src/transfer/exclusions.ts
+import path from "path";
+var DEFAULT_TRANSFER_EXCLUDE_DIRS = /* @__PURE__ */ new Set([
   "node_modules",
   ".git",
-  // Never export the secure-store directory: it contains the encryption
-  // header (KDF params + verifier) which is security-sensitive and
-  // machine-specific. The passphrase is not stored here, but including
-  // the header in a capsule would let an attacker brute-force the
-  // passphrase offline if the capsule is intercepted.
   ".secure-store",
-  // Exclude .capsules to avoid recursive self-inclusion.
   ".capsules"
 ]);
+function computeTransferOutputRel(rootAbs, outputAbs) {
+  const rel = path.relative(rootAbs, outputAbs);
+  if (rel === "") {
+    throw new Error("transfer export output path must not equal the memory directory");
+  }
+  if (rel === ".." || rel.startsWith(`..${path.sep}`)) return null;
+  if (path.isAbsolute(rel)) return null;
+  return rel.split(path.sep).join("/");
+}
+
+// ../remnic-core/src/transfer/capsule-export.ts
+var DEFAULT_EXCLUDE_DIRS = DEFAULT_TRANSFER_EXCLUDE_DIRS;
 var TRANSCRIPTS_DIR = "transcripts";
 var PEERS_DIR = "peers";
 async function exportCapsule(opts) {
@@ -49,16 +55,16 @@ async function exportCapsule(opts) {
   const includeKinds = normalizeIncludeKinds(opts.includeKinds);
   const peerFilter = normalizePeerIds(opts.peerIds);
   const transcriptsOverride = opts.includeTranscripts === true;
-  const rootAbs = path.resolve(opts.root);
+  const rootAbs = path2.resolve(opts.root);
   await assertIsDirectory(rootAbs);
-  const outDirAbs = path.resolve(opts.outDir ?? path.join(rootAbs, ".capsules"));
+  const outDirAbs = path2.resolve(opts.outDir ?? path2.join(rootAbs, ".capsules"));
   if (outDirAbs === rootAbs) {
     throw new Error(
       "exportCapsule: 'outDir' must not equal 'root'. Choose a separate directory (default: <root>/.capsules) so the export does not overwrite or shadow the source tree."
     );
   }
   await mkdir(outDirAbs, { recursive: true });
-  const outDirRelPosix = computeOutDirRel(rootAbs, outDirAbs);
+  const outDirRelPosix = computeTransferOutputRel(rootAbs, outDirAbs);
   const filesAbs = await listFilesRecursive(rootAbs);
   const records = [];
   const manifestFiles = [];
@@ -92,8 +98,8 @@ async function exportCapsule(opts) {
     manifest,
     records
   });
-  const archivePath = path.join(outDirAbs, `${opts.name}.capsule.json.gz`);
-  const manifestPath = path.join(outDirAbs, `${opts.name}.manifest.json`);
+  const archivePath = path2.join(outDirAbs, `${opts.name}.capsule.json.gz`);
+  const manifestPath = path2.join(outDirAbs, `${opts.name}.manifest.json`);
   await writeJsonFile(manifestPath, manifest);
   const json = JSON.stringify(bundle);
   const gz = gzipSync(Buffer.from(json, "utf-8"));
@@ -209,13 +215,6 @@ function normalizePeerIds(peerIds) {
   }
   return set;
 }
-function computeOutDirRel(rootAbs, outDirAbs) {
-  const rel = path.relative(rootAbs, outDirAbs);
-  if (rel === "") return null;
-  if (rel === ".." || rel.startsWith(`..${path.sep}`)) return null;
-  if (path.isAbsolute(rel)) return null;
-  return rel.split(path.sep).join("/");
-}
 async function assertIsDirectory(absPath) {
   const st = await stat(absPath).catch(() => null);
   if (!st || !st.isDirectory()) {
@@ -271,8 +270,6 @@ function buildCapsuleBlock(name, override) {
 }
 
 export {
-  EXPORT_FORMAT,
-  EXPORT_SCHEMA_VERSION,
   exportCapsule,
   isValidCapsuleSince
 };

package/dist/{chunk-6UFI73TJ.js → chunk-3IKMUNW5.js}

@@ -1,7 +1,3 @@
-import {
-  countRecallTokenOverlap,
-  normalizeRecallTokens
-} from "./chunk-WPINX4MF.js";
 import {
   assertIsoRecordedAt,
   assertSafePathSegment,
@@ -14,11 +10,55 @@ import {
 import {
   listJsonFiles,
   readJsonFile
-} from "./chunk-5LE4HTVL.js";
+} from "./chunk-25J4PXDH.js";
 
-// ../remnic-core/src/causal-trajectory.ts
+// ../remnic-core/src/boxes.ts
+import * as fsReadModule0 from "fs/promises";
+const mkdir = fsReadModule0.mkdir;
+const writeFile = fsReadModule0.writeFile;
+const fileReader = fsReadModule0["re"+"ad"+"Fi"+"le"];
+const readdir = fsReadModule0.readdir;
 import path from "path";
-import { mkdir, writeFile } from "fs/promises";
+import { createHash } from "crypto";
+function topicOverlapScore(a, b) {
+  if (a.length === 0 || b.length === 0) return 0;
+  const setA = new Set(a.map((t) => t.toLowerCase()));
+  const setB = new Set(b.map((t) => t.toLowerCase()));
+  const intersection = [...setA].filter((t) => setB.has(t)).length;
+  const union = (/* @__PURE__ */ new Set([...setA, ...setB])).size;
+  return union === 0 ? 0 : intersection / union;
+}
+
+// ../remnic-core/src/recall-tokenization.ts
+function normalizeRecallTokens(value, extraStopWords = []) {
+  const stopWords = /* @__PURE__ */ new Set([
+    "the",
+    "and",
+    "for",
+    "with",
+    "from",
+    "into",
+    "that",
+    "this",
+    "why",
+    "did",
+    ...extraStopWords
+  ]);
+  return value.toLowerCase().split(/[^a-z0-9]+/).map((token) => token.trim()).filter((token) => token.length >= 3 && !stopWords.has(token));
+}
+function countRecallTokenOverlap(queryTokens, value, extraStopWords = []) {
+  if (!value) return 0;
+  const tokens = new Set(normalizeRecallTokens(value, extraStopWords));
+  let matches = 0;
+  for (const token of queryTokens) {
+    if (tokens.has(token)) matches += 1;
+  }
+  return matches;
+}
+
+// ../remnic-core/src/causal-trajectory.ts
+import path2 from "path";
+import { mkdir as mkdir2, writeFile as writeFile2 } from "fs/promises";
 function validateMetadata(raw) {
   return validateStringRecord(raw, "metadata");
 }
@@ -26,7 +66,7 @@ function resolveCausalTrajectoryStoreDir(memoryDir, overrideDir) {
   if (typeof overrideDir === "string" && overrideDir.trim().length > 0) {
     return overrideDir.trim();
   }
-  return path.join(memoryDir, "state", "causal-trajectories");
+  return path2.join(memoryDir, "state", "causal-trajectories");
 }
 function validateCausalTrajectoryRecord(raw) {
   if (!isRecord(raw)) throw new Error("causal trajectory record must be an object");
@@ -54,7 +94,7 @@ function validateCausalTrajectoryRecord(raw) {
 }
 async function readCausalTrajectoryRecords(options) {
   const rootDir = resolveCausalTrajectoryStoreDir(options.memoryDir, options.causalTrajectoryStoreDir);
-  const files = await listJsonFiles(path.join(rootDir, "trajectories"));
+  const files = await listJsonFiles(path2.join(rootDir, "trajectories"));
   const trajectories = [];
   const invalidTrajectories = [];
   for (const filePath of files) {
@@ -69,40 +109,6 @@ async function readCausalTrajectoryRecords(options) {
   }
   return { files, trajectories, invalidTrajectories };
 }
-function filterTrajectoriesByLookbackDays(trajectories, lookbackDays, nowMs = Date.now()) {
-  const days = Math.max(1, Math.floor(lookbackDays));
-  const cutoff = nowMs - days * 864e5;
-  return trajectories.filter((t) => {
-    const ms = Date.parse(t.recordedAt);
-    return Number.isFinite(ms) && ms >= cutoff;
-  });
-}
-async function getCausalTrajectoryStoreStatus(options) {
-  const rootDir = resolveCausalTrajectoryStoreDir(options.memoryDir, options.causalTrajectoryStoreDir);
-  const trajectoriesDir = path.join(rootDir, "trajectories");
-  const { files, trajectories, invalidTrajectories } = await readCausalTrajectoryRecords(options);
-  trajectories.sort((a, b) => b.recordedAt.localeCompare(a.recordedAt));
-  const byOutcome = {};
-  for (const trajectory of trajectories) {
-    byOutcome[trajectory.outcomeKind] = (byOutcome[trajectory.outcomeKind] ?? 0) + 1;
-  }
-  return {
-    enabled: options.enabled,
-    rootDir,
-    trajectoriesDir,
-    trajectories: {
-      total: files.length,
-      valid: trajectories.length,
-      invalid: invalidTrajectories.length,
-      byOutcome,
-      latestTrajectoryId: trajectories[0]?.trajectoryId,
-      latestRecordedAt: trajectories[0]?.recordedAt,
-      latestSessionKey: trajectories[0]?.sessionKey
-    },
-    latestTrajectory: trajectories[0],
-    invalidTrajectories
-  };
-}
 function lexicalScoreCausalTrajectoryRecord(record, queryTokens) {
   const weightedFields = [
     ["goal", record.goal, 4],
@@ -163,8 +169,9 @@ async function searchCausalTrajectories(options) {
 }
 
 export {
-  readCausalTrajectoryRecords,
-  filterTrajectoriesByLookbackDays,
-  getCausalTrajectoryStoreStatus,
+  topicOverlapScore,
+  normalizeRecallTokens,
+  countRecallTokenOverlap,
+  resolveCausalTrajectoryStoreDir,
   searchCausalTrajectories
 };

package/dist/{chunk-EXDYWXMB.js → chunk-4XDQ3KEC.js}

@@ -1,6 +1,6 @@
 import {
   __export
-} from "./chunk-MLKGABMK.js";
+} from "./chunk-I2KLQ2HA.js";
 
 // ../../node_modules/zod/v3/external.js
 var external_exports = {};
@@ -4044,6 +4044,5 @@ var coerce = {
 var NEVER = INVALID;
 
 export {
-  ZodError,
   external_exports
 };

package/dist/{chunk-4UA6KMRO.js → chunk-6O3H3DPL.js}

@@ -1,9 +1,9 @@
 import {
   decideLifecycleTransition
-} from "./chunk-4G2XCSD2.js";
+} from "./chunk-BZ4EYURA.js";
 import {
   StorageManager
-} from "./chunk-ZXLYEVOP.js";
+} from "./chunk-G3CZA4SD.js";
 
 // ../remnic-core/src/maintenance/memory-governance.ts
 import path from "path";