@vortex-os/memory-extended 0.5.1

package/dist/mcp/server.js

@@ -0,0 +1,113 @@
+import { RECALL_TOOL_NAME, recallToolDefinition, runRecall } from "./recall-tool.js";
+import { GET_MEMORY_TOOL_NAME, LIST_MEMORIES_TOOL_NAME, getMemoryToolDefinition, listMemoriesToolDefinition, runGetMemory, runListMemories, } from "./memory-tools.js";
+import { SUGGEST_DOCUMENT_TOOL_NAME, WRITE_DOCUMENT_TOOL_NAME, DECLINE_DOCUMENT_TOOL_NAME, suggestDocumentToolDefinition, writeDocumentToolDefinition, declineDocumentToolDefinition, runSuggestDocument, runWriteDocument, runDeclineDocument, } from "./document-tools.js";
+/**
+ * The MCP SDK (`@modelcontextprotocol/sdk`) is an OPTIONAL dependency of
+ * memory-extended — only consumers who run the MCP server need it, exactly as
+ * `@huggingface/transformers` is optional for those who run the local embedder.
+ * So the SDK is loaded at runtime via dynamic import (a runtime-resolved
+ * specifier keeps tsc from requiring its types at build time), and the server
+ * is returned typed loosely. Hosts that never call this never pay for the SDK.
+ *
+ * Returns the connected-but-not-transported `Server` instance; the caller
+ * attaches a transport (stdio for slice 1) with `await server.connect(t)`.
+ */
+export async function createRecallServer(options) {
+    const sdk = await loadMcpSdk();
+    const server = new sdk.Server({ name: options.name ?? "vortex-mcp-recall", version: options.version ?? "0.1.0" }, { capabilities: { tools: {} } });
+    server.setRequestHandler(sdk.ListToolsRequestSchema, async () => ({
+        tools: [
+            recallToolDefinition,
+            listMemoriesToolDefinition,
+            getMemoryToolDefinition,
+            suggestDocumentToolDefinition,
+            writeDocumentToolDefinition,
+            declineDocumentToolDefinition,
+        ],
+    }));
+    server.setRequestHandler(sdk.CallToolRequestSchema, async (request) => {
+        const name = request.params.name;
+        const raw = (request.params.arguments ?? {});
+        const str = (v) => (typeof v === "string" ? v : undefined);
+        const num = (v) => (typeof v === "number" ? v : undefined);
+        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 });
+                return jsonResult({ query: result.query, count: result.hits.length, hits: result.hits });
+            }
+            if (name === LIST_MEMORIES_TOOL_NAME) {
+                const result = await runListMemories({ type: str(raw.type), tag: str(raw.tag), privacy: str(raw.privacy), limit: num(raw.limit) }, { dbPath: options.dbPath });
+                return jsonResult(result);
+            }
+            if (name === GET_MEMORY_TOOL_NAME) {
+                const result = await runGetMemory({ id: str(raw.id) ?? "" }, { dbPath: options.dbPath });
+                return jsonResult(result);
+            }
+            // ── document tools (slice 4): require dataDir ─────────────────────
+            if (name === SUGGEST_DOCUMENT_TOOL_NAME ||
+                name === WRITE_DOCUMENT_TOOL_NAME ||
+                name === DECLINE_DOCUMENT_TOOL_NAME) {
+                if (!options.dataDir) {
+                    return {
+                        content: [{ type: "text", text: `${name} unavailable: server started without a data dir` }],
+                        isError: true,
+                    };
+                }
+                const strArr = (v) => Array.isArray(v) ? v.filter((x) => typeof x === "string") : undefined;
+                const docArgs = {
+                    topic: str(raw.topic) ?? "",
+                    name: str(raw.name) ?? "",
+                    title: str(raw.title),
+                    content: str(raw.content) ?? "",
+                    description: str(raw.description),
+                    tags: strArr(raw.tags),
+                };
+                const deps = { cwd: options.dataDir };
+                if (name === SUGGEST_DOCUMENT_TOOL_NAME)
+                    return jsonResult(await runSuggestDocument(docArgs, deps));
+                if (name === WRITE_DOCUMENT_TOOL_NAME)
+                    return jsonResult(await runWriteDocument(docArgs, deps));
+                return jsonResult(await runDeclineDocument({ topic: docArgs.topic, name: docArgs.name }, deps));
+            }
+            return {
+                content: [{ type: "text", text: `Unknown tool: ${name}` }],
+                isError: true,
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `${name} failed: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+/** Wrap a structured payload as an MCP text-content result (pretty JSON). */
+function jsonResult(payload) {
+    return { content: [{ type: "text", text: JSON.stringify(payload, null, 2) }] };
+}
+async function loadMcpSdk() {
+    const serverSpecifier = "@modelcontextprotocol/sdk/server/index.js";
+    const typesSpecifier = "@modelcontextprotocol/sdk/types.js";
+    try {
+        const [serverMod, typesMod] = await Promise.all([
+            import(serverSpecifier),
+            import(typesSpecifier),
+        ]);
+        return {
+            Server: serverMod.Server,
+            ListToolsRequestSchema: typesMod
+                .ListToolsRequestSchema,
+            CallToolRequestSchema: typesMod
+                .CallToolRequestSchema,
+        };
+    }
+    catch (e) {
+        throw new Error(`createRecallServer: failed to load "@modelcontextprotocol/sdk". ` +
+            `It ships as an optional dependency of @vortex-os/memory-extended; if it is missing, ` +
+            `run \`npm install @modelcontextprotocol/sdk\`. Original error: ${e.message}`);
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/recall/engine.d.ts

@@ -0,0 +1,38 @@
+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 { RecallParams, RecallResult } from "./types.js";
+/** Dependencies the recall engine needs the host to supply. */
+export interface RecallDeps {
+    readonly sqlite: MemorySqliteStore;
+    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
+     * that has not vectorized sessions still gets memory recall.
+     */
+    readonly sessionChunks?: SessionChunkStore;
+}
+/**
+ * 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).
+ *
+ * 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.
+ */
+export declare function recall(params: RecallParams, deps: RecallDeps): Promise<RecallResult>;
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +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"}

package/dist/recall/engine.js

@@ -0,0 +1,113 @@
+import { parseIntent } from "./intent.js";
+const DEFAULT_K = 5;
+const EXCERPT_CHARS = 280;
+/**
+ * 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).
+ *
+ * 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.
+ */
+export async function recall(params, deps) {
+    const { sqlite, vector, embed } = deps;
+    const k = params.k ?? DEFAULT_K;
+    const intent = parseIntent(params.query);
+    const corpusSize = vector.count(params.source);
+    let appliedFilters = {};
+    let ids;
+    let hardFilterCandidates = corpusSize;
+    let hardFilterDropped = false;
+    const hasFilters = hasAnyFilter(intent.filters);
+    if (hasFilters && !params.noHardFilter) {
+        const filtered = sqlite.query(intent.filters);
+        if (filtered.length < k) {
+            // Too narrow — drop it. Searching the full corpus is safer than
+            // excluding a relevant memory the guessed filter happened to miss.
+            hardFilterDropped = true;
+            hardFilterCandidates = corpusSize;
+        }
+        else {
+            appliedFilters = intent.filters;
+            ids = new Set(filtered.map((r) => r.id));
+            hardFilterCandidates = filtered.length;
+        }
+    }
+    const vectorHits = await vector.search(intent.semanticText, embed, {
+        k,
+        source: params.source,
+        ids,
+    });
+    const hits = [];
+    for (const vh of vectorHits) {
+        if (vh.source === "session-archive") {
+            const chunk = deps.sessionChunks?.getById(vh.id);
+            if (!chunk)
+                continue; // no session-chunk metadata (not hydratable) — skip
+            hits.push(toSessionHit(chunk, vh.score));
+            continue;
+        }
+        const row = sqlite.getById(vh.id);
+        if (!row)
+            continue; // vector exists but memory was deleted — drift; skip
+        hits.push(toHit(row, vh.source, vh.score));
+    }
+    return {
+        query: params.query,
+        intent,
+        stage: { appliedFilters, hardFilterCandidates, hardFilterDropped, corpusSize },
+        hits,
+    };
+}
+function hasAnyFilter(q) {
+    return Boolean((q.type && q.type.length) ||
+        (q.tags && q.tags.length) ||
+        (q.privacy && q.privacy.length) ||
+        q.updatedSinceMs !== undefined);
+}
+function toHit(row, source, score) {
+    return {
+        id: row.id,
+        source,
+        score,
+        name: row.name,
+        description: row.description,
+        type: row.type,
+        updated: row.updated,
+        tags: row.tags,
+        excerpt: excerpt(row.body),
+    };
+}
+function excerpt(body) {
+    const collapsed = body.replace(/\s+/g, " ").trim();
+    return collapsed.length <= EXCERPT_CHARS
+        ? collapsed
+        : `${collapsed.slice(0, EXCERPT_CHARS).trimEnd()}…`;
+}
+/** Hydrate a session-archive hit from its chunk metadata row. */
+function toSessionHit(chunk, score) {
+    const day = chunk.startedAt ? chunk.startedAt.slice(0, 10) : null;
+    return {
+        id: chunk.id,
+        source: "session-archive",
+        score,
+        name: `${chunk.host} session${day ? ` (${day})` : ""} · part ${chunk.chunkIdx + 1}`,
+        description: "",
+        type: "session",
+        updated: chunk.startedAt,
+        tags: [chunk.host],
+        excerpt: chunk.excerpt,
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/recall/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/recall/engine.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAgB1C,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAAoB,EAAE,IAAgB;IACjE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACvC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,SAAS,CAAC;IAChC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAE/C,IAAI,cAAc,GAAgB,EAAE,CAAC;IACrC,IAAI,GAAoC,CAAC;IACzC,IAAI,oBAAoB,GAAG,UAAU,CAAC;IACtC,IAAI,iBAAiB,GAAG,KAAK,CAAC;IAE9B,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,UAAU,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,gEAAgE;YAChE,mEAAmE;YACnE,iBAAiB,GAAG,IAAI,CAAC;YACzB,oBAAoB,GAAG,UAAU,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC;YAChC,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACzC,oBAAoB,GAAG,QAAQ,CAAC,MAAM,CAAC;QACzC,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,EAAE;QACjE,CAAC;QACD,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,GAAG;KACJ,CAAC,CAAC;IAEH,MAAM,IAAI,GAAgB,EAAE,CAAC;IAC7B,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;QAC5B,IAAI,EAAE,CAAC,MAAM,KAAK,iBAAiB,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACjD,IAAI,CAAC,KAAK;gBAAE,SAAS,CAAC,oDAAoD;YAC1E,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;YACzC,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG;YAAE,SAAS,CAAC,qDAAqD;QACzE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM;QACN,KAAK,EAAE,EAAE,cAAc,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,UAAU,EAAE;QAC9E,IAAI;KACL,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,CAAc;IAClC,OAAO,OAAO,CACZ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QACvB,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;QACzB,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QAC/B,CAAC,CAAC,cAAc,KAAK,SAAS,CACjC,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,GAAc,EAAE,MAA2B,EAAE,KAAa;IACvE,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,MAAM;QACN,KAAK;QACL,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,OAAO,SAAS,CAAC,MAAM,IAAI,aAAa;QACtC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC;AACxD,CAAC;AAED,iEAAiE;AACjE,SAAS,YAAY,CAAC,KAAsB,EAAE,KAAa;IACzD,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,MAAM,EAAE,iBAAiB;QACzB,KAAK;QACL,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,WAAW,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,WAAW,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE;QACnF,WAAW,EAAE,EAAE;QACf,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK,CAAC,SAAS;QACxB,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;AACJ,CAAC"}

package/dist/recall/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `recall` namespace — two-stage hybrid retrieval (Phase 11c, 2026-05-29).
+ *
+ * The module exports the *engine* and pure helpers; the `/recall` slash
+ * command is defined in the host plugin (`session-rituals`), mirroring how
+ * `/curate` is defined there over the `proactive-curator` module. This
+ * keeps the module free of any slash-commands dependency.
+ *
+ * Surfaces:
+ *  - {@link recall} — the engine. Returns structured {@link RecallResult}
+ *    data — the "callable tool surface" for ambient, in-conversation use
+ *    (the host phrases a hit as prose). Decision 5: the engine never
+ *    formats a report itself.
+ *  - {@link renderRecallHits} — optional compact list render for the
+ *    explicit `/recall` surface.
+ */
+export { recall } from "./engine.js";
+export type { RecallDeps } from "./engine.js";
+export { parseIntent } from "./intent.js";
+export { renderRecallHits } from "./render.js";
+export type { ParsedIntent, RecallHit, RecallParams, RecallResult, RecallStageInfo, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/recall/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EACV,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/recall/index.js

@@ -0,0 +1,20 @@
+/**
+ * `recall` namespace — two-stage hybrid retrieval (Phase 11c, 2026-05-29).
+ *
+ * The module exports the *engine* and pure helpers; the `/recall` slash
+ * command is defined in the host plugin (`session-rituals`), mirroring how
+ * `/curate` is defined there over the `proactive-curator` module. This
+ * keeps the module free of any slash-commands dependency.
+ *
+ * Surfaces:
+ *  - {@link recall} — the engine. Returns structured {@link RecallResult}
+ *    data — the "callable tool surface" for ambient, in-conversation use
+ *    (the host phrases a hit as prose). Decision 5: the engine never
+ *    formats a report itself.
+ *  - {@link renderRecallHits} — optional compact list render for the
+ *    explicit `/recall` surface.
+ */
+export { recall } from "./engine.js";
+export { parseIntent } from "./intent.js";
+export { renderRecallHits } from "./render.js";
+//# sourceMappingURL=index.js.map

package/dist/recall/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/recall/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/recall/intent.d.ts

@@ -0,0 +1,24 @@
+import type { ParsedIntent } from "./types.js";
+/**
+ * Parse obvious structured filters out of a natural-language query
+ * (operator decision 4 / 2026-05-29). Deliberately conservative — it only
+ * recognizes filters the user clearly intended, because the heavy lifting
+ * is the semantic stage, not this. Over-eager parsing would wrongly narrow
+ * the candidate set; the engine additionally drops the filter if it leaves
+ * too few candidates (see engine docs).
+ *
+ * Recognized today (rule-based, no LLM — that is a later slot):
+ *  - `type:feedback` / `type=feedback`           → type filter
+ *  - `tag:priming` / `#priming`                  → tag filter
+ *  - `2026-05` / `2026-05-12`                     → updatedSince that date
+ *  - Korean month `5월`                            → updatedSince that month
+ *    (current year) — only when no explicit ISO date was given
+ *
+ * Date parsing deliberately omits bare English month words: "may" / "march"
+ * collide with the modal verb and the imperative, and a wrong date filter
+ * is exactly the over-narrowing the operator flagged in decision 4. English
+ * callers use ISO dates (`2026-05`) for date intent. Everything recognized
+ * is stripped from the query to form `semanticText`, which gets embedded.
+ */
+export declare function parseIntent(query: string, now?: Date): ParsedIntent;
+//# sourceMappingURL=intent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../src/recall/intent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,YAAY,CAuD/E"}

package/dist/recall/intent.js

@@ -0,0 +1,95 @@
+/**
+ * Parse obvious structured filters out of a natural-language query
+ * (operator decision 4 / 2026-05-29). Deliberately conservative — it only
+ * recognizes filters the user clearly intended, because the heavy lifting
+ * is the semantic stage, not this. Over-eager parsing would wrongly narrow
+ * the candidate set; the engine additionally drops the filter if it leaves
+ * too few candidates (see engine docs).
+ *
+ * Recognized today (rule-based, no LLM — that is a later slot):
+ *  - `type:feedback` / `type=feedback`           → type filter
+ *  - `tag:priming` / `#priming`                  → tag filter
+ *  - `2026-05` / `2026-05-12`                     → updatedSince that date
+ *  - Korean month `5월`                            → updatedSince that month
+ *    (current year) — only when no explicit ISO date was given
+ *
+ * Date parsing deliberately omits bare English month words: "may" / "march"
+ * collide with the modal verb and the imperative, and a wrong date filter
+ * is exactly the over-narrowing the operator flagged in decision 4. English
+ * callers use ISO dates (`2026-05`) for date intent. Everything recognized
+ * is stripped from the query to form `semanticText`, which gets embedded.
+ */
+export function parseIntent(query, now = new Date()) {
+    const notes = [];
+    const types = [];
+    const tags = [];
+    let updatedSinceMs;
+    let remaining = query;
+    // key:value / key=value for type and tag (also #tag)
+    remaining = remaining.replace(/\b(type)[:=]("[^"]+"|\S+)/gi, (_m, _k, v) => {
+        const val = unquote(v);
+        types.push(val);
+        notes.push(`type=${val}`);
+        return " ";
+    });
+    remaining = remaining.replace(/\b(tag)[:=]("[^"]+"|\S+)/gi, (_m, _k, v) => {
+        const val = unquote(v);
+        tags.push(val);
+        notes.push(`tag=${val}`);
+        return " ";
+    });
+    remaining = remaining.replace(/(^|\s)#([\p{L}\p{N}_-]+)/gu, (_m, lead, v) => {
+        tags.push(v);
+        notes.push(`tag=${v}`);
+        return lead;
+    });
+    // Explicit ISO date (YYYY-MM-DD or YYYY-MM) takes precedence over month words.
+    const iso = remaining.match(/\b(\d{4})-(\d{2})(?:-(\d{2}))?\b/);
+    if (iso) {
+        const y = Number(iso[1]);
+        const mo = Number(iso[2]);
+        const d = iso[3] ? Number(iso[3]) : 1;
+        updatedSinceMs = Date.UTC(y, mo - 1, d);
+        notes.push(`updatedSince=${iso[0]}`);
+        remaining = remaining.replace(iso[0], " ");
+    }
+    else {
+        const monthIdx = matchMonth(remaining);
+        if (monthIdx) {
+            const y = now.getUTCFullYear();
+            updatedSinceMs = Date.UTC(y, monthIdx.index, 1);
+            notes.push(`updatedSince=${y}-${String(monthIdx.index + 1).padStart(2, "0")} (from "${monthIdx.token}")`);
+            remaining = remaining.replace(monthIdx.token, " ");
+        }
+    }
+    const filters = {};
+    if (types.length > 0)
+        filters.type = dedupe(types);
+    if (tags.length > 0)
+        filters.tags = dedupe(tags);
+    if (updatedSinceMs !== undefined)
+        filters.updatedSinceMs = updatedSinceMs;
+    return {
+        filters,
+        semanticText: remaining.replace(/\s+/g, " ").trim() || query.trim(),
+        notes,
+    };
+}
+function unquote(s) {
+    return s.replace(/^"(.*)"$/, "$1");
+}
+function dedupe(xs) {
+    return [...new Set(xs)];
+}
+/**
+ * Match a Korean `N월` month reference (1–12), not preceded by another
+ * digit so "15월" does not match "5월". Returns the 0-based month index and
+ * the matched token to strip.
+ */
+function matchMonth(s) {
+    const hit = s.match(/(?<!\d)(1[0-2]|[1-9])월/);
+    if (!hit)
+        return null;
+    return { index: Number(hit[1]) - 1, token: hit[0] };
+}
+//# sourceMappingURL=intent.js.map

package/dist/recall/intent.js.map

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

package/dist/recall/render.d.ts

@@ -0,0 +1,11 @@
+import type { RecallResult } from "./types.js";
+/**
+ * Render hits as a compact text list — for the *explicit* `/recall` surface
+ * or any host that wants a report. Ambient, in-conversation use should
+ * *not* call this; it should read the structured hits and phrase them
+ * naturally (operator decision 5). Offered as a convenience, not the
+ * mandatory output path. Pure function of the result — no slash-commands
+ * dependency, so it stays inside the module.
+ */
+export declare function renderRecallHits(result: RecallResult): string;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/recall/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1D;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAO7D"}

package/dist/recall/render.js

@@ -0,0 +1,23 @@
+/**
+ * Render hits as a compact text list — for the *explicit* `/recall` surface
+ * or any host that wants a report. Ambient, in-conversation use should
+ * *not* call this; it should read the structured hits and phrase them
+ * naturally (operator decision 5). Offered as a convenience, not the
+ * mandatory output path. Pure function of the result — no slash-commands
+ * dependency, so it stays inside the module.
+ */
+export function renderRecallHits(result) {
+    if (result.hits.length === 0) {
+        return `No memories matched "${result.query}".`;
+    }
+    const lines = result.hits.map((h, i) => formatHit(h, i + 1));
+    const header = `${result.hits.length} match${result.hits.length === 1 ? "" : "es"} for "${result.query}":`;
+    return [header, ...lines].join("\n");
+}
+function formatHit(h, rank) {
+    const pct = `${Math.round(h.score * 100)}%`;
+    const when = h.updated ? ` · ${h.updated}` : "";
+    const tags = h.tags.length ? ` · #${h.tags.slice(0, 4).join(" #")}` : "";
+    return `${rank}. [${pct}] ${h.name} (${h.type}${when})${tags}\n   ${h.description || h.excerpt}`;
+}
+//# sourceMappingURL=render.js.map

package/dist/recall/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/recall/render.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACnD,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,wBAAwB,MAAM,CAAC,KAAK,IAAI,CAAC;IAClD,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,SAAS,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,MAAM,CAAC,KAAK,IAAI,CAAC;IAC3G,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,SAAS,CAAC,CAAY,EAAE,IAAY;IAC3C,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC;IAC5C,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,OAAO,GAAG,IAAI,MAAM,GAAG,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,GAAG,IAAI,IAAI,IAAI,QAAQ,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACnG,CAAC"}

package/dist/recall/types.d.ts

@@ -0,0 +1,72 @@
+import type { MemoryQuery } from "../sqlite/types.js";
+import type { VectorSource } from "../vector/types.js";
+/**
+ * `recall` namespace types — two-stage hybrid retrieval over memories
+ * (Phase 11c, 2026-05-29).
+ *
+ * Design intent (operator decision 5): the engine returns *data*, not a
+ * formatted report. The same hits feed two surfaces — an explicit
+ * `/recall` command (which may render a compact list) and ambient,
+ * in-conversation use where the host weaves a hit into natural prose
+ * ("you designed something similar in project A a few days ago — reuse
+ * it?"). The engine deliberately does not decide which; it hands back
+ * structured hits and lets the host phrase them.
+ */
+/** Filters parsed out of a natural-language query (loose, regex-based). */
+export interface ParsedIntent {
+    /** SQLite hard-filter derived from the query, if any obvious filters were found. */
+    readonly filters: MemoryQuery;
+    /** The query with recognized filter tokens stripped — used for embedding. */
+    readonly semanticText: string;
+    /** Human-readable note of what was parsed (diagnostics / transparency). */
+    readonly notes: readonly string[];
+}
+/** One recall result. Carries enough for both a list render and prose phrasing. */
+export interface RecallHit {
+    readonly id: string;
+    readonly source: VectorSource;
+    /** Cosine similarity to the query (1 = identical direction). */
+    readonly score: number;
+    readonly name: string;
+    readonly description: string;
+    readonly type: string;
+    readonly updated: string | null;
+    readonly tags: readonly string[];
+    /** A short body excerpt (first ~280 chars, whitespace-collapsed). */
+    readonly excerpt: string;
+}
+/** Inputs to a recall run. */
+export interface RecallParams {
+    /** Natural-language query. */
+    readonly query: string;
+    /** Max hits. Default 5. */
+    readonly k?: number;
+    /** Restrict to one corpus. Omit to search all (currently only `memory`). */
+    readonly source?: VectorSource;
+    /**
+     * Force-disable the SQLite hard-filter even when intent parsing finds
+     * filters. Default behavior keeps the filter *loose* (see engine docs):
+     * if the filter would leave fewer than `k` candidates, it is dropped and
+     * the semantic stage runs over the full corpus instead.
+     */
+    readonly noHardFilter?: boolean;
+}
+/** What the two-stage pipeline actually did — surfaced for transparency. */
+export interface RecallStageInfo {
+    /** Filters applied as a hard pre-filter (empty if none / dropped). */
+    readonly appliedFilters: MemoryQuery;
+    /** Candidate count after the hard-filter stage (before semantic rerank). */
+    readonly hardFilterCandidates: number;
+    /** Whether the hard-filter was dropped for being too narrow. */
+    readonly hardFilterDropped: boolean;
+    /** Total vectors in the searched corpus. */
+    readonly corpusSize: number;
+}
+/** Result of a recall run — structured data, never a pre-rendered report. */
+export interface RecallResult {
+    readonly query: string;
+    readonly intent: ParsedIntent;
+    readonly stage: RecallStageInfo;
+    readonly hits: readonly RecallHit[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/recall/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;;GAWG;AAEH,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,oFAAoF;IACpF,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,mFAAmF;AACnF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,8BAA8B;AAC9B,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,4EAA4E;IAC5E,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,gEAAgE;IAChE,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,CAAC;CACrC"}

package/dist/recall/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/recall/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/recall/types.ts"],"names":[],"mappings":""}

package/dist/sessionArchive/adapters/claude-code.d.ts

@@ -0,0 +1,3 @@
+import type { TranscriptAdapter } from "../types.js";
+export declare const claudeCodeAdapter: TranscriptAdapter;
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/sessionArchive/adapters/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../src/sessionArchive/adapters/claude-code.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAIV,iBAAiB,EAGlB,MAAM,aAAa,CAAC;AAoCrB,eAAO,MAAM,iBAAiB,EAAE,iBA4C/B,CAAC"}