@vortex-os/memory-extended 0.5.1 → 0.5.2

package/README.md

@@ -8,20 +8,20 @@ Extended memory layer for VortEX — an **opt-in add-on** that lives on top of `
 
 | Namespace | Purpose | Status |
 |---|---|---|
-| `sessionArchive` | Append-only JSONL log of agent sessions + SQLite metadata. Four first-party host adapters (Claude Code CLI, Codex CLI, Gemini CLI, Claude Desktop). | Phase 11b — **shipped (0.1.0)** |
-| `consolidate` | Post-session fact-extraction proposer — read past `sessionArchive` events, propose memory candidates, operator confirms. | Phase 11d — **shipped (0.1.0)** |
-| `sqlite` | Structured store derived from markdown memories — hard-filter queries (`byType` / `byTag` / `byPrivacy` / `updatedSince`), drift detection (log + skip, non-destructive). | Phase 11a — **shipped (0.2.0)**. Five operator decisions recorded in `docs/memory-extended-design.md`. |
-| `vector` | Dense retrieval over memories **and conversation sessions**. Default backend: **in-process brute-force cosine**; vectors in the shared `memory.sqlite`. Host-injected `EmbedFn` (multilingual local default). Sessions are vectorized at topic-chunk granularity via embedding-similarity segmentation. | Phase 11c — **shipped (0.3.0+)** |
-| `recall` | Two-stage hybrid retrieval **engine** (SQLite loose hard-filter → cosine rerank). Returns data, not a report. Hits carry `source` = `memory` \| `session-archive`. `/recall <query>` command lives in `session-rituals`. | Phase 11c — **shipped (0.3.0+)** |
-| `mcp` | MCP server for any MCP host (Claude Desktop, chatbots) over stdio: read tools (`recall`, `list_memories`, `get_memory`) + document tools (`suggest_document` → `write_document` / `decline_document`, a propose-then-write pair), plus a one-line `install` into the host config. Writes are gated behind an explicit second tool call. SDK is an optional dependency. Bin: `vortex-mcp-recall`. | **shipped (0.5.0+)** |
+| `sessionArchive` | Append-only JSONL log of agent sessions + SQLite metadata. Four first-party host adapters (Claude Code CLI, Codex CLI, Gemini CLI, Claude Desktop). | Shipped |
+| `consolidate` | Post-session fact-extraction proposer — read past `sessionArchive` events, propose memory candidates, operator confirms. | Shipped |
+| `sqlite` | Structured store derived from markdown memories — hard-filter queries (`byType` / `byTag` / `byPrivacy` / `updatedSince`), drift detection (log + skip, non-destructive). | Shipped |
+| `vector` | Dense retrieval over memories **and conversation sessions**. Default backend: **in-process brute-force cosine**; vectors in the shared `memory.sqlite`. Host-injected `EmbedFn` (multilingual local default). Sessions are vectorized at topic-chunk granularity via embedding-similarity segmentation. | Shipped |
+| `recall` | Two-stage hybrid retrieval **engine** (SQLite loose hard-filter → cosine rerank). Returns data, not a report. Hits carry `source` = `memory` \| `session-archive`. `/recall <query>` command lives in `session-rituals`. | Shipped |
+| `mcp` | MCP server for any MCP host (Claude Desktop, chatbots) over stdio: read tools (`recall`, `list_memories`, `get_memory`) + document tools (`suggest_document` → `write_document` / `decline_document`, a propose-then-write pair), plus a one-line `install` into the host config. Writes are gated behind an explicit second tool call. SDK is an optional dependency. Bin: `vortex-mcp-recall`. | Shipped |
 
-The companion module **`proactive-curator`** (shipped inside `@vortex-os/base`) handles the *in-session* counterpart to `consolidate` — live "this looks worth capturing" prompts during an ongoing conversation. `memory-extended/consolidate` reuses its `Proposal` / `LLMJudge` types via the base aggregate, so a single host UX renders both surfaces.
+The companion module **`proactive-curator`** (shipped inside `@vortex-os/base`) handles the *in-session* counterpart to `consolidate` — live "this looks worth capturing" prompts during an ongoing conversation. `memory-extended/consolidate` emits proposals shaped identically to `proactive-curator`'s `Proposal` / `LLMJudge` types (that small surface is **inlined** under `src/internal/`, not imported), so a single host UX renders both surfaces.
 
 ## What it is not
 
 - It does **not** replace `@vortex-os/base`'s `memorySystem`. The markdown layer remains the source of truth; this package adds *derived* indexes that can be deleted and regenerated at any time.
 - It does **not** write to `_memory/` directly. The `consolidate` namespace proposes; the operator confirms; writes go through `base`'s `memorySystem`.
-- It does **not** require all five namespaces to be present. Use what you need; drop the rest.
+- It does **not** require all of its namespaces to be present. Use what you need; drop the rest.
 
 ## Installation
 
@@ -31,7 +31,7 @@ npm install @vortex-os/memory-extended @vortex-os/base better-sqlite3
 npm install classic-level
 ```
 
-`@vortex-os/base` is a required peer dependency — `consolidate` reuses the `proactiveCurator` namespace it exposes for `Proposal` / `LLMJudge` types. `better-sqlite3` is required for the SQLite metadata layer. `classic-level` is optional — required only when the Claude Desktop adapter is registered.
+`@vortex-os/base` is a required peer because this package is an **add-on layered onto a base instance** — it expects a base-scaffolded `data/` layout alongside it, not because its code imports base. (memory-extended is self-contained: its only runtime dependency is `yaml`; the `proactive-curator` types `consolidate` mirrors are inlined under `src/internal/`.) `better-sqlite3` is required for the SQLite metadata layer. `classic-level` is optional — required only when the Claude Desktop adapter is registered.
 
 The local embedder (`@huggingface/transformers`) is an **optional dependency** — it installs automatically with this package; nothing to fetch by hand. The default model is **`Xenova/multilingual-e5-small`** (384-dim, 50+ languages incl. Korean, 512-token input, ~470 MB) — a retrieval-tuned multilingual model that downloads once on first `vector`/`recall` use and is cached. It is *asymmetric*: a `"query: "` prefix is applied to search text and `"passage: "` to indexed text automatically (the store passes the right `kind`). To use a *symmetric* model instead (e.g. `Xenova/all-MiniLM-L6-v2`, ~90 MB) pass `{ model: "...", prefixes: null }`. To skip the local model entirely, pass your own `EmbedFn` (e.g. an OpenAI/Voyage adapter).
 
@@ -70,7 +70,7 @@ await rebuildFromMemoryDir(store, "./data/_memory");
 
 // Four hard-filter helpers.
 const rules = store.byType("feedback");
-const koreanRules = store.byTag("korean");
+const taggedRules = store.byTag("onboarding");
 const visiblePublic = store.byPrivacy("public");
 const fresh = store.updatedSince("2026-05-01");
 
@@ -89,7 +89,7 @@ console.log(`drifted ${report.drifted.length}/${report.rowsScanned}`);
 store.close();
 ```
 
-The sqlite file lives under `data/_indexes/` (gitignored). Markdown remains the source of truth — the sqlite index is derived and rebuildable. See the operator decision table in [`docs/memory-extended-design.md`](../../docs/memory-extended-design.md#sqlite-namespace) for the rationale.
+The sqlite file lives under `data/_indexes/` (gitignored). Markdown remains the source of truth — the sqlite index is derived and rebuildable. See the operator decision table in [`docs/memory-extended-design.md`](https://github.com/vortex-os-project/vortex/blob/main/docs/memory-extended-design.md#sqlite-namespace) for the rationale.
 
 ## Quick usage — `vector` + `recall`
 
@@ -108,7 +108,7 @@ await vector.rebuild(sqlite, embed);                  // → { indexed, skipped,
 
 // The engine returns DATA — list it, or phrase one hit in conversation.
 const result = await recall(
-  { query: "tone feedback from 5월", k: 5 },          // intent: type/tag/Korean-month parsed loosely
+  { query: "tone feedback from last May", k: 5 },     // intent: type/tag/month parsed loosely
   { sqlite, vector, embed },
 );
 console.log(renderRecallHits(result));                // optional compact list render
@@ -117,7 +117,7 @@ vector.close();
 sqlite.close();
 ```
 
-The vector index shares the same `memory.sqlite` (a `memory_vectors` table) — one file, one rebuild path. The `/recall <query>` slash command wraps this engine; register it via `createRitualRegistry({ recall: { embed } })` in `@vortex-os/session-rituals`. The engine returns structured hits rather than a report so the host can either render a list or weave a hit into conversation (operator decision 5). See [`docs/memory-extended-design.md`](../../docs/memory-extended-design.md#vector-namespace) for the backend/embedder rationale.
+The vector index shares the same `memory.sqlite` (a `memory_vectors` table) — one file, one rebuild path. The `/recall <query>` slash command wraps this engine; register it via `createRitualRegistry({ recall: { embed } })` in `@vortex-os/session-rituals`. The engine returns structured hits rather than a report so the host can either render a list or weave a hit into conversation (operator decision 5). See [`docs/memory-extended-design.md`](https://github.com/vortex-os-project/vortex/blob/main/docs/memory-extended-design.md#vector-namespace) for the backend/embedder rationale.
 
 **Conversation sessions** are searchable too. `vector.rebuildSessions(sessionArchiveStore, embed)` vectorizes each archived session and stores chunks under `source: "session-archive"` plus a `session_chunks` metadata row for hydration. Run `npx rebuild-memory-vector --sessions`. `recall` then returns session hits alongside memory hits (pass a `SessionChunkStore` as `sessionChunks` to hydrate them; without it session hits are skipped). Filter to one corpus with `/recall <q> --source session-archive`.
 
@@ -238,7 +238,7 @@ The consolidator queries recently-ingested sessions from `sessionArchive`, asks
 
 ## Design documents
 
-- [`docs/memory-extended-design.md`](../../docs/memory-extended-design.md) — cluster overview, sub-phase breakdown, industry pattern alignment
-- [`docs/transcript-adapter-design.md`](../../docs/transcript-adapter-design.md) — `sessionArchive` adapter interface, per-host schema mapping, on-disk storage, SQLite schema, lock-handling UX
-- [`docs/proactive-curator-design.md`](../../docs/proactive-curator-design.md) — in-session counterpart (separate module)
-- [`docs/architecture.md`](../../docs/architecture.md#multi-layer-memory-architecture) — multi-layer memory architecture, source-of-truth policy
+- [`docs/memory-extended-design.md`](https://github.com/vortex-os-project/vortex/blob/main/docs/memory-extended-design.md) — cluster overview, sub-phase breakdown, industry pattern alignment
+- [`docs/transcript-adapter-design.md`](https://github.com/vortex-os-project/vortex/blob/main/docs/transcript-adapter-design.md) — `sessionArchive` adapter interface, per-host schema mapping, on-disk storage, SQLite schema, lock-handling UX
+- [`docs/proactive-curator-design.md`](https://github.com/vortex-os-project/vortex/blob/main/docs/proactive-curator-design.md) — in-session counterpart (separate module)
+- [`docs/architecture.md`](https://github.com/vortex-os-project/vortex/blob/main/docs/architecture.md#multi-layer-memory-architecture) — multi-layer memory architecture, source-of-truth policy

package/dist/mcp/recall-tool.d.ts

@@ -1,4 +1,4 @@
-import type { RecallResult } from "../recall/types.js";
+import type { RecallResult, RecallMode } from "../recall/types.js";
 import type { EmbedFn, VectorSource } from "../vector/types.js";
 export declare const RECALL_TOOL_NAME = "recall";
 /**
@@ -21,6 +21,11 @@ export declare const recallToolDefinition: {
                 type: string;
                 description: string;
             };
+            mode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
             source: {
                 type: string;
                 enum: string[];
@@ -33,6 +38,7 @@ export declare const recallToolDefinition: {
 export interface RunRecallArgs {
     readonly query: string;
     readonly k?: number;
+    readonly mode?: RecallMode;
     readonly source?: VectorSource;
     readonly noHardFilter?: boolean;
 }
@@ -41,6 +47,12 @@ export interface RunRecallDeps {
     readonly embed: EmbedFn;
     /** Absolute path to the memory SQLite index (e.g. <dataDir>/_indexes/memory.sqlite). */
     readonly dbPath: string;
+    /**
+     * Instance data dir, for locating the session archive (keyword session lane).
+     * If omitted, it is inferred as the grandparent of `dbPath` (the
+     * `<dataDir>/_indexes/memory.sqlite` convention); pass it when `dbPath` is custom.
+     */
+    readonly dataDir?: string;
     readonly defaultK?: number;
 }
 /**

package/dist/mcp/recall-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recall-tool.d.ts","sourceRoot":"","sources":["../../src/mcp/recall-tool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKhE,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;CAmBhC,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AASD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAoB/F"}
+{"version":3,"file":"recall-tool.d.ts","sourceRoot":"","sources":["../../src/mcp/recall-tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMhE,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyBhC,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AASD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAyC/F"}

package/dist/mcp/recall-tool.js

@@ -1,7 +1,9 @@
+import { dirname } from "node:path";
 import { recall as recallEngine } from "../recall/engine.js";
 import { MemorySqliteStore } from "../sqlite/store.js";
 import { MemoryVectorStore } from "../vector/store.js";
 import { SessionChunkStore } from "../vector/session.js";
+import { SessionArchiveStore } from "../sessionArchive/index.js";
 export const RECALL_TOOL_NAME = "recall";
 /**
  * MCP tool descriptor for `recall`, as plain JSON (no MCP SDK types at build
@@ -11,7 +13,7 @@ export const RECALL_TOOL_NAME = "recall";
  */
 export const recallToolDefinition = {
     name: RECALL_TOOL_NAME,
-    description: "Semantic search over the user's VortEX memory (markdown frontmatter memories + session archive). " +
+    description: "Hybrid keyword + semantic search over the user's VortEX memory (markdown frontmatter memories + session archive). " +
         "Returns structured hits: score, name, description, type, tags, and a short excerpt. " +
         "Use it to recall prior context, decisions, preferences, or facts the user has stored.",
     inputSchema: {
@@ -19,6 +21,11 @@ export const recallToolDefinition = {
         properties: {
             query: { type: "string", description: "Natural-language search query." },
             k: { type: "number", description: "Maximum number of hits to return (default 5)." },
+            mode: {
+                type: "string",
+                enum: ["keyword", "semantic", "hybrid"],
+                description: "Search mode. 'keyword' for exact terms / error codes / file names / identifiers; 'semantic' for concepts / topics; 'hybrid' (default) runs both and fuses.",
+            },
             source: {
                 type: "string",
                 enum: ["memory", "session-archive"],
@@ -45,16 +52,38 @@ export async function runRecall(args, deps) {
         return EMPTY_RESULT;
     }
     const k = args.k && args.k > 0 ? args.k : deps.defaultK ?? 5;
-    const sqlStore = new MemorySqliteStore(deps.dbPath);
-    const vecStore = new MemoryVectorStore({ db: deps.dbPath });
-    const chunkStore = new SessionChunkStore(deps.dbPath);
+    // Construct stores INSIDE the try so a later constructor throwing still lets the
+    // finally close whichever handles were already opened (Codex F5).
+    let sqlStore;
+    let vecStore;
+    let chunkStore;
+    let archive;
     try {
-        return await recallEngine({ query, k, source: args.source, noHardFilter: args.noHardFilter }, { sqlite: sqlStore, vector: vecStore, embed: deps.embed, sessionChunks: chunkStore });
+        sqlStore = new MemorySqliteStore(deps.dbPath);
+        vecStore = new MemoryVectorStore({ db: deps.dbPath });
+        chunkStore = new SessionChunkStore(deps.dbPath);
+        // The keyword session lane reads the archive's events_fts. dbPath is
+        // <dataDir>/_indexes/memory.sqlite, so the dataDir is two levels up.
+        // Best-effort: without it, the session keyword lane is silently skipped.
+        try {
+            archive = new SessionArchiveStore(deps.dataDir ?? dirname(dirname(deps.dbPath)));
+        }
+        catch {
+            archive = undefined;
+        }
+        return await recallEngine({ query, k, mode: args.mode, source: args.source, noHardFilter: args.noHardFilter }, {
+            sqlite: sqlStore,
+            vector: vecStore,
+            embed: deps.embed,
+            sessionChunks: chunkStore,
+            sessionArchive: archive,
+        });
     }
     finally {
-        chunkStore.close();
-        vecStore.close();
-        sqlStore.close();
+        archive?.close();
+        chunkStore?.close();
+        vecStore?.close();
+        sqlStore?.close();
     }
 }
 //# sourceMappingURL=recall-tool.js.map

package/dist/mcp/recall-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"recall-tool.js","sourceRoot":"","sources":["../../src/mcp/recall-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAG7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,mGAAmG;QACnG,sFAAsF;QACtF,uFAAuF;IACzF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;YACxE,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+CAA+C,EAAE;YACnF,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,iBAAiB,CAAC;gBACnC,WAAW,EAAE,wDAAwD;aACtE;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;CACF,CAAC;AAiBF,MAAM,YAAY,GAAiB;IACjC,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,aAAa,CAAC,EAAE;IACjE,KAAK,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,oBAAoB,EAAE,CAAC,EAAE,iBAAiB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE;IAC/F,IAAI,EAAE,EAAE;CACT,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAmB,EAAE,IAAmB;IACtE,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;IAE7D,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,CAAC;QACH,OAAO,MAAM,YAAY,CACvB,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,EAClE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,CACrF,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,UAAU,CAAC,KAAK,EAAE,CAAC;QACnB,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjB,QAAQ,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;AACH,CAAC"}
+{"version":3,"file":"recall-tool.js","sourceRoot":"","sources":["../../src/mcp/recall-tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAsBlD,MAAM,WAAW,mBAAmB;IAClC,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC;IAC9E,OAAO,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC,CA6FD"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAsBlD,MAAM,WAAW,mBAAmB;IAClC,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC;IAC9E,OAAO,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC,CAiGD"}

package/dist/mcp/server.js

@@ -33,7 +33,10 @@ export async function createRecallServer(options) {
         try {
             if (name === RECALL_TOOL_NAME) {
                 const source = raw.source === "memory" || raw.source === "session-archive" ? raw.source : undefined;
-                const result = await runRecall({ query: str(raw.query) ?? "", k: num(raw.k), source }, { embed: options.embed, dbPath: options.dbPath, defaultK: options.defaultK });
+                const mode = raw.mode === "keyword" || raw.mode === "semantic" || raw.mode === "hybrid"
+                    ? raw.mode
+                    : undefined;
+                const result = await runRecall({ query: str(raw.query) ?? "", k: num(raw.k), mode, source }, { embed: options.embed, dbPath: options.dbPath, dataDir: options.dataDir, defaultK: options.defaultK });
                 return jsonResult({ query: result.query, count: result.hits.length, hits: result.hits });
             }
             if (name === LIST_MEMORIES_TOOL_NAME) {

package/dist/mcp/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}

package/dist/recall/engine.d.ts

@@ -2,6 +2,7 @@ import type { MemorySqliteStore } from "../sqlite/store.js";
 import type { MemoryVectorStore } from "../vector/store.js";
 import type { EmbedFn } from "../vector/types.js";
 import type { SessionChunkStore } from "../vector/session.js";
+import type { SessionArchiveStore } from "../sessionArchive/index.js";
 import type { RecallParams, RecallResult } from "./types.js";
 /** Dependencies the recall engine needs the host to supply. */
 export interface RecallDeps {
@@ -9,30 +10,31 @@ export interface RecallDeps {
     readonly vector: MemoryVectorStore;
     readonly embed: EmbedFn;
     /**
-     * Optional — hydrates `session-archive` hits with timestamp + excerpt.
-     * Without it, session hits are dropped (graceful degradation), so a host
+     * Hydrates session-archive SEMANTIC hits (vector → chunk metadata). Without
+     * it the session semantic lane is skipped (graceful degradation), so a host
      * that has not vectorized sessions still gets memory recall.
      */
     readonly sessionChunks?: SessionChunkStore;
+    /**
+     * Enables the session KEYWORD lane (`searchEvents`). Without it the session
+     * keyword lane is skipped — the same graceful-degradation precedent.
+     */
+    readonly sessionArchive?: SessionArchiveStore;
 }
 /**
- * Two-stage hybrid recall (operator decision 5 / 2026-05-29). Returns
- * structured {@link RecallResult} data — never a pre-rendered report. The
- * caller decides whether to list the hits (explicit `/recall`) or phrase
- * one in conversation (ambient use).
+ * Hybrid recall (P3). Branches on `mode`:
+ *  - `semantic` — the original cosine pipeline (memory hard-filter → vector
+ *    rerank), unchanged in behavior.
+ *  - `keyword`  — FTS5 over memories + session events.
+ *  - `hybrid` (default) — both lanes, fused by Reciprocal Rank Fusion.
  *
- * Pipeline:
- *  1. **Parse intent** — pull obvious filters (type / tag / date) out of the
- *     query (regex, no LLM).
- *  2. **Hard filter (loose)** — if filters were found, restrict candidates
- *     via SQLite. *But* if that leaves fewer than `k` candidates, the
- *     filter is dropped and the semantic stage runs over the whole corpus.
- *     This is the safeguard against the over-narrowing risk: a guessed
- *     filter never costs you a relevant-but-unfiltered memory.
- *  3. **Semantic rerank** — embed the (filter-stripped) query text and ask
- *     the vector store for the closest candidates.
- *  4. **Hydrate** — join vector hits back to their memory rows for name,
- *     description, tags, and a body excerpt.
+ * Returns structured {@link RecallResult} data — never a pre-rendered report.
+ * The memory hard-filter (parsed type/tag/date) constrains the MEMORY lanes
+ * only; session lanes filter by their own semantics (§12 R8). Session hits fuse
+ * at the SESSION level — the semantic lane is de-duped to one best chunk per
+ * session before ranking (§13). The tool_result keyword downweight applies in
+ * `hybrid` only (§12 R6). `score` stays cosine for any semantically-matched
+ * hit; a keyword-only hit gets `1/(1+rank)` (§12 R7).
  */
 export declare function recall(params: RecallParams, deps: RecallDeps): Promise<RecallResult>;
 //# sourceMappingURL=engine.d.ts.map

package/dist/recall/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/recall/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAmB,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,OAAO,KAAK,EAAa,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAExE,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC;CAC5C;AAKD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAmD1F"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/recall/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAmB,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAqB,MAAM,4BAA4B,CAAC;AAWzF,OAAO,KAAK,EAAyB,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEpF,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAC3C;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,mBAAmB,CAAC;CAC/C;AAwBD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAoL1F"}