@caupulican/pi-adaptative 0.81.42 → 0.81.43

package/dist/core/memory/providers/transcript-recall-worker.js

@@ -0,0 +1,143 @@
+import { readdirSync, statSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { parentPort } from "node:worker_threads";
+import { getDefaultSessionDir, isAutoLearnSessionId, loadEntriesFromFile, } from "@caupulican/pi-agent-core/node";
+import { TranscriptIndex } from "../transcript-index.js";
+import { isTranscriptRecallWorkerRequest, TRANSCRIPT_RECALL_MAX_ERROR_CHARS, TRANSCRIPT_RECALL_MAX_HITS, TRANSCRIPT_RECALL_MAX_QUERY_CHARS, TRANSCRIPT_RECALL_MAX_SNIPPET_CHARS, } from "./transcript-recall-worker-protocol.js";
+const MAX_SESSIONS = 60;
+const MAX_DOC_CHARS = 8_000;
+const MAX_TOTAL_CHARS = 500_000;
+const MAX_FILE_BYTES = 8_000_000;
+const port = parentPort;
+if (!port)
+    throw new Error("transcript recall worker requires parentPort");
+const workerPort = port;
+let generation = -1;
+let index;
+function post(response) {
+    workerPort.postMessage(response);
+}
+workerPort.on("message", (value) => {
+    if (!isTranscriptRecallWorkerRequest(value))
+        return;
+    if (value.type === "shutdown") {
+        post({ type: "stopped", generation: value.generation });
+        workerPort.close();
+        return;
+    }
+    if (value.type === "initialize") {
+        generation = value.generation;
+        try {
+            index = new TranscriptIndex(buildDocs(value.sessionId, value.cwd, value.agentDir));
+            post({ type: "ready", generation, size: index.size });
+        }
+        catch (error) {
+            index = undefined;
+            post({
+                type: "failed",
+                generation,
+                error: (error instanceof Error ? error.message : String(error)).slice(0, TRANSCRIPT_RECALL_MAX_ERROR_CHARS),
+            });
+        }
+        return;
+    }
+    if (value.generation !== generation)
+        return;
+    const hits = index?.query(value.query.slice(0, TRANSCRIPT_RECALL_MAX_QUERY_CHARS), {
+        k: TRANSCRIPT_RECALL_MAX_HITS,
+        minScore: 0.34,
+        maxSnippetChars: TRANSCRIPT_RECALL_MAX_SNIPPET_CHARS,
+    }) ?? [];
+    post({ type: "result", generation, requestId: value.requestId, hits });
+});
+function buildDocs(currentSessionId, cwd, agentDir) {
+    const docs = [];
+    let dir;
+    try {
+        dir = getDefaultSessionDir(cwd, agentDir);
+    }
+    catch {
+        return docs;
+    }
+    let files;
+    try {
+        files = readdirSync(dir)
+            .filter((name) => name.endsWith(".jsonl"))
+            .map((name) => {
+            const path = join(dir, name);
+            let mtime = 0;
+            let size = 0;
+            try {
+                const metadata = statSync(path);
+                mtime = metadata.mtimeMs;
+                size = metadata.size;
+            }
+            catch { }
+            return { path, mtime, size };
+        })
+            .filter((file) => file.size > 0 && file.size <= MAX_FILE_BYTES)
+            .sort((left, right) => right.mtime - left.mtime)
+            .slice(0, MAX_SESSIONS);
+    }
+    catch {
+        return docs;
+    }
+    let total = 0;
+    for (const { path } of files) {
+        let entries;
+        try {
+            entries = loadEntriesFromFile(path);
+        }
+        catch {
+            continue;
+        }
+        const header = entries.find((entry) => entry.type === "session");
+        const sessionId = header?.id;
+        if (!sessionId || sessionId === currentSessionId || isAutoLearnSessionId(sessionId))
+            continue;
+        if (header.cwd && resolve(header.cwd) !== resolve(cwd))
+            continue;
+        const text = extractSessionText(entries, MAX_DOC_CHARS);
+        if (!text.trim())
+            continue;
+        docs.push({
+            sessionId: sessionId.slice(0, 256),
+            timestamp: typeof header.timestamp === "string" ? header.timestamp.slice(0, 128) : undefined,
+            text,
+        });
+        total += text.length;
+        if (total >= MAX_TOTAL_CHARS)
+            break;
+    }
+    return docs;
+}
+function extractSessionText(entries, maxChars) {
+    const parts = [];
+    let length = 0;
+    for (const entry of entries) {
+        if (entry.type !== "message")
+            continue;
+        const message = entry.message;
+        if (message.role !== "user" && message.role !== "assistant")
+            continue;
+        const content = message.content;
+        let text = "";
+        if (typeof content === "string") {
+            text = content;
+        }
+        else if (Array.isArray(content)) {
+            text = content
+                .map((block) => block && typeof block === "object" && "type" in block && block.type === "text" ? (block.text ?? "") : "")
+                .join(" ");
+        }
+        text = text.trim();
+        if (!text || text.includes('<memory_context source="transcript-recall"'))
+            continue;
+        parts.push(text);
+        length += text.length;
+        if (length >= maxChars)
+            break;
+    }
+    return parts.join("\n").slice(0, maxChars);
+}
+//# sourceMappingURL=transcript-recall-worker.js.map

package/dist/core/memory/providers/transcript-recall-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-recall-worker.js","sourceRoot":"","sources":["../../../../src/core/memory/providers/transcript-recall-worker.ts"],"names":[],"mappings":"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","sourcesContent":["import { readdirSync, statSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport { parentPort } from \"node:worker_threads\";\nimport {\n\ttype FileEntry,\n\tgetDefaultSessionDir,\n\tisAutoLearnSessionId,\n\tloadEntriesFromFile,\n} from \"@caupulican/pi-agent-core/node\";\nimport { type TranscriptDoc, TranscriptIndex } from \"../transcript-index.ts\";\nimport {\n\tisTranscriptRecallWorkerRequest,\n\tTRANSCRIPT_RECALL_MAX_ERROR_CHARS,\n\tTRANSCRIPT_RECALL_MAX_HITS,\n\tTRANSCRIPT_RECALL_MAX_QUERY_CHARS,\n\tTRANSCRIPT_RECALL_MAX_SNIPPET_CHARS,\n\ttype TranscriptRecallWorkerResponse,\n} from \"./transcript-recall-worker-protocol.ts\";\n\nconst MAX_SESSIONS = 60;\nconst MAX_DOC_CHARS = 8_000;\nconst MAX_TOTAL_CHARS = 500_000;\nconst MAX_FILE_BYTES = 8_000_000;\nconst port = parentPort;\nif (!port) throw new Error(\"transcript recall worker requires parentPort\");\nconst workerPort = port;\n\nlet generation = -1;\nlet index: TranscriptIndex | undefined;\n\nfunction post(response: TranscriptRecallWorkerResponse): void {\n\tworkerPort.postMessage(response);\n}\n\nworkerPort.on(\"message\", (value: unknown) => {\n\tif (!isTranscriptRecallWorkerRequest(value)) return;\n\tif (value.type === \"shutdown\") {\n\t\tpost({ type: \"stopped\", generation: value.generation });\n\t\tworkerPort.close();\n\t\treturn;\n\t}\n\tif (value.type === \"initialize\") {\n\t\tgeneration = value.generation;\n\t\ttry {\n\t\t\tindex = new TranscriptIndex(buildDocs(value.sessionId, value.cwd, value.agentDir));\n\t\t\tpost({ type: \"ready\", generation, size: index.size });\n\t\t} catch (error) {\n\t\t\tindex = undefined;\n\t\t\tpost({\n\t\t\t\ttype: \"failed\",\n\t\t\t\tgeneration,\n\t\t\t\terror: (error instanceof Error ? error.message : String(error)).slice(0, TRANSCRIPT_RECALL_MAX_ERROR_CHARS),\n\t\t\t});\n\t\t}\n\t\treturn;\n\t}\n\n\tif (value.generation !== generation) return;\n\tconst hits =\n\t\tindex?.query(value.query.slice(0, TRANSCRIPT_RECALL_MAX_QUERY_CHARS), {\n\t\t\tk: TRANSCRIPT_RECALL_MAX_HITS,\n\t\t\tminScore: 0.34,\n\t\t\tmaxSnippetChars: TRANSCRIPT_RECALL_MAX_SNIPPET_CHARS,\n\t\t}) ?? [];\n\tpost({ type: \"result\", generation, requestId: value.requestId, hits });\n});\n\nfunction buildDocs(currentSessionId: string, cwd: string, agentDir: string): TranscriptDoc[] {\n\tconst docs: TranscriptDoc[] = [];\n\tlet dir: string;\n\ttry {\n\t\tdir = getDefaultSessionDir(cwd, agentDir);\n\t} catch {\n\t\treturn docs;\n\t}\n\n\tlet files: Array<{ path: string; mtime: number }>;\n\ttry {\n\t\tfiles = readdirSync(dir)\n\t\t\t.filter((name) => name.endsWith(\".jsonl\"))\n\t\t\t.map((name) => {\n\t\t\t\tconst path = join(dir, name);\n\t\t\t\tlet mtime = 0;\n\t\t\t\tlet size = 0;\n\t\t\t\ttry {\n\t\t\t\t\tconst metadata = statSync(path);\n\t\t\t\t\tmtime = metadata.mtimeMs;\n\t\t\t\t\tsize = metadata.size;\n\t\t\t\t} catch {}\n\t\t\t\treturn { path, mtime, size };\n\t\t\t})\n\t\t\t.filter((file) => file.size > 0 && file.size <= MAX_FILE_BYTES)\n\t\t\t.sort((left, right) => right.mtime - left.mtime)\n\t\t\t.slice(0, MAX_SESSIONS);\n\t} catch {\n\t\treturn docs;\n\t}\n\n\tlet total = 0;\n\tfor (const { path } of files) {\n\t\tlet entries: FileEntry[];\n\t\ttry {\n\t\t\tentries = loadEntriesFromFile(path);\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\t\tconst header = entries.find(\n\t\t\t(entry): entry is Extract<FileEntry, { type: \"session\" }> => entry.type === \"session\",\n\t\t);\n\t\tconst sessionId = header?.id;\n\t\tif (!sessionId || sessionId === currentSessionId || isAutoLearnSessionId(sessionId)) continue;\n\t\tif (header.cwd && resolve(header.cwd) !== resolve(cwd)) continue;\n\n\t\tconst text = extractSessionText(entries, MAX_DOC_CHARS);\n\t\tif (!text.trim()) continue;\n\t\tdocs.push({\n\t\t\tsessionId: sessionId.slice(0, 256),\n\t\t\ttimestamp: typeof header.timestamp === \"string\" ? header.timestamp.slice(0, 128) : undefined,\n\t\t\ttext,\n\t\t});\n\t\ttotal += text.length;\n\t\tif (total >= MAX_TOTAL_CHARS) break;\n\t}\n\treturn docs;\n}\n\nfunction extractSessionText(entries: FileEntry[], maxChars: number): string {\n\tconst parts: string[] = [];\n\tlet length = 0;\n\tfor (const entry of entries) {\n\t\tif (entry.type !== \"message\") continue;\n\t\tconst message = entry.message;\n\t\tif (message.role !== \"user\" && message.role !== \"assistant\") continue;\n\t\tconst content = message.content;\n\t\tlet text = \"\";\n\t\tif (typeof content === \"string\") {\n\t\t\ttext = content;\n\t\t} else if (Array.isArray(content)) {\n\t\t\ttext = content\n\t\t\t\t.map((block) =>\n\t\t\t\t\tblock && typeof block === \"object\" && \"type\" in block && block.type === \"text\" ? (block.text ?? \"\") : \"\",\n\t\t\t\t)\n\t\t\t\t.join(\" \");\n\t\t}\n\t\ttext = text.trim();\n\t\tif (!text || text.includes('<memory_context source=\"transcript-recall\"')) continue;\n\t\tparts.push(text);\n\t\tlength += text.length;\n\t\tif (length >= maxChars) break;\n\t}\n\treturn parts.join(\"\\n\").slice(0, maxChars);\n}\n"]}

package/dist/core/memory/providers/transcript-recall.d.ts

@@ -1,28 +1,39 @@
 /**
- * TranscriptRecallProvider — cross-session similarity recall (adaptive-agent design R3).
- *
- * A read-only CONTEXT memory provider: it indexes the most-recent past session transcripts (the JSONL
- * corpus) with a dependency-free token/Jaccard index ({@link TranscriptIndex}, reusing skill_audit's
- * tokenizer) and answers `prefetch(query)` with a small `<memory_context>` recall page of the most
- * relevant past snippets. The current session and auto-learn sessions are excluded. It never writes —
- * the file-store remains the write target; this is the recall corpus.
+ * Cross-session recall coordinator. One worker belongs to one provider/session generation; no
+ * process-global transcript index is shared across sessions.
  */
 import type { MemoryCapabilities, MemoryLifecycleContext, MemoryProvider } from "../memory-provider.ts";
+export interface TranscriptRecallProviderOptions {
+    workerSpecifier?: string | URL;
+    maxPendingQueries?: number;
+}
 export declare class TranscriptRecallProvider implements MemoryProvider {
     readonly name = "transcript-recall";
     readonly egress = "local";
-    private index;
-    private currentSessionId;
-    private cwd;
-    private agentDir;
+    private readonly workerSpecifier;
+    private readonly maxPendingQueries;
+    private worker;
+    private generation;
+    private requestId;
+    private ready;
+    private readyPromise;
+    private resolveReady;
+    private readonly pending;
+    constructor(options?: TranscriptRecallProviderOptions);
     isAvailable(): boolean;
     getCapabilities(): MemoryCapabilities;
     initialize(sessionId: string, ctx: MemoryLifecycleContext): Promise<void>;
     shutdown(): Promise<void>;
+    /** Event-driven readiness hook for tests and callers that can wait outside the foreground turn. */
+    waitUntilReady(): Promise<void>;
     /** GC manages the dynamic recall page so stale pages pack while the newest are kept. */
     getContextMarkers(): string[];
     prefetch(query: string): Promise<string>;
-    private ensureIndex;
-    private buildDocs;
+    private handleWorkerMessage;
+    private handleWorkerFailure;
+    private finishReady;
+    private finishQuery;
+    private finishQueriesFor;
+    private disposeWorker;
 }
 //# sourceMappingURL=transcript-recall.d.ts.map

package/dist/core/memory/providers/transcript-recall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transcript-recall.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/providers/transcript-recall.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAaxG,qBAAa,wBAAyB,YAAW,cAAc;IAC9D,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,MAAM,WAAW;IAC1B,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,gBAAgB,CAAM;IAC9B,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,QAAQ,CAAM;IAEtB,WAAW,IAAI,OAAO,CAErB;IAED,eAAe,IAAI,kBAAkB,CAEpC;IAEK,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAK9E;IAEK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9B;IAED,wFAAwF;IACxF,iBAAiB,IAAI,MAAM,EAAE,CAE5B;IAEK,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB7C;IAED,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,SAAS;CAsDjB","sourcesContent":["/**\n * TranscriptRecallProvider — cross-session similarity recall (adaptive-agent design R3).\n *\n * A read-only CONTEXT memory provider: it indexes the most-recent past session transcripts (the JSONL\n * corpus) with a dependency-free token/Jaccard index ({@link TranscriptIndex}, reusing skill_audit's\n * tokenizer) and answers `prefetch(query)` with a small `<memory_context>` recall page of the most\n * relevant past snippets. The current session and auto-learn sessions are excluded. It never writes —\n * the file-store remains the write target; this is the recall corpus.\n */\n\nimport { readdirSync, statSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport {\n\ttype FileEntry,\n\tgetDefaultSessionDir,\n\tisAutoLearnSessionId,\n\tloadEntriesFromFile,\n} from \"@caupulican/pi-agent-core/node\";\nimport type { MemoryCapabilities, MemoryLifecycleContext, MemoryProvider } from \"../memory-provider.ts\";\nimport { type TranscriptDoc, TranscriptIndex } from \"../transcript-index.ts\";\n\n/** Most-recent past sessions to consider. */\nconst MAX_SESSIONS = 60;\n/** Per-session text cap (keeps the index light and snippets relevant). */\nconst MAX_DOC_CHARS = 8_000;\n/** Overall corpus cap across all docs. */\nconst MAX_TOTAL_CHARS = 500_000;\n/** Skip transcript files larger than this before parsing them, so a huge log can't block/bloat the\n * first recalled turn (Bug #9). Far above a normal session; only pathological logs exceed it. */\nconst MAX_FILE_BYTES = 8_000_000;\n\nexport class TranscriptRecallProvider implements MemoryProvider {\n\treadonly name = \"transcript-recall\";\n\treadonly egress = \"local\";\n\tprivate index: TranscriptIndex | undefined;\n\tprivate currentSessionId = \"\";\n\tprivate cwd = \"\";\n\tprivate agentDir = \"\";\n\n\tisAvailable(): boolean {\n\t\treturn true;\n\t}\n\n\tgetCapabilities(): MemoryCapabilities {\n\t\treturn { surfaces: [\"context\"] };\n\t}\n\n\tasync initialize(sessionId: string, ctx: MemoryLifecycleContext): Promise<void> {\n\t\tthis.currentSessionId = sessionId;\n\t\tthis.cwd = ctx.cwd;\n\t\tthis.agentDir = ctx.agentDir;\n\t\tthis.index = undefined; // built lazily on first prefetch\n\t}\n\n\tasync shutdown(): Promise<void> {\n\t\tthis.index = undefined;\n\t}\n\n\t/** GC manages the dynamic recall page so stale pages pack while the newest are kept. */\n\tgetContextMarkers(): string[] {\n\t\treturn [\"<memory_context\"];\n\t}\n\n\tasync prefetch(query: string): Promise<string> {\n\t\tif (!query.trim()) return \"\";\n\t\tlet index: TranscriptIndex;\n\t\ttry {\n\t\t\tindex = this.ensureIndex();\n\t\t} catch {\n\t\t\treturn \"\";\n\t\t}\n\t\tif (index.size === 0) return \"\";\n\t\t// minScore is a query-CONTAINMENT threshold (fraction of the query's tokens present in the doc),\n\t\t// not Jaccard — so it is length-independent and recalls relevant long sessions. ~1/3 of query\n\t\t// terms must appear before a session is considered relevant.\n\t\tconst hits = index.query(query, { k: 3, minScore: 0.34, maxSnippetChars: 600 });\n\t\tif (hits.length === 0) return \"\";\n\t\t// MemoryManager centrally source-labels and fences every provider's complete recall page. Keep\n\t\t// this provider output raw here so the built-in path is wrapped exactly once like extensions.\n\t\tconst body = hits.map((h) => `- (${h.timestamp ?? \"earlier session\"}) ${h.snippet}`).join(\"\\n\");\n\t\treturn `<memory_context source=\"transcript-recall\">\\nRelevant context recalled from past sessions (read-only reference, untrusted, may be stale):\\n${body}\\n</memory_context>`;\n\t}\n\n\tprivate ensureIndex(): TranscriptIndex {\n\t\tif (!this.index) {\n\t\t\tthis.index = new TranscriptIndex(this.buildDocs());\n\t\t}\n\t\treturn this.index;\n\t}\n\n\tprivate buildDocs(): TranscriptDoc[] {\n\t\tconst docs: TranscriptDoc[] = [];\n\t\tlet dir: string;\n\t\ttry {\n\t\t\tdir = getDefaultSessionDir(this.cwd, this.agentDir);\n\t\t} catch {\n\t\t\treturn docs;\n\t\t}\n\n\t\tlet files: Array<{ path: string; mtime: number }>;\n\t\ttry {\n\t\t\tfiles = readdirSync(dir)\n\t\t\t\t.filter((f) => f.endsWith(\".jsonl\"))\n\t\t\t\t.map((f) => {\n\t\t\t\t\tconst path = join(dir, f);\n\t\t\t\t\tlet mtime = 0;\n\t\t\t\t\tlet size = 0;\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst st = statSync(path);\n\t\t\t\t\t\tmtime = st.mtimeMs;\n\t\t\t\t\t\tsize = st.size;\n\t\t\t\t\t} catch {}\n\t\t\t\t\treturn { path, mtime, size };\n\t\t\t\t})\n\t\t\t\t.filter((f) => f.size > 0 && f.size <= MAX_FILE_BYTES) // skip oversize logs before parse (Bug #9)\n\t\t\t\t.sort((a, b) => b.mtime - a.mtime) // most-recent first\n\t\t\t\t.slice(0, MAX_SESSIONS);\n\t\t} catch {\n\t\t\treturn docs;\n\t\t}\n\n\t\tlet total = 0;\n\t\tfor (const { path } of files) {\n\t\t\tlet entries: FileEntry[];\n\t\t\ttry {\n\t\t\t\tentries = loadEntriesFromFile(path);\n\t\t\t} catch {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst header = entries.find((e): e is Extract<FileEntry, { type: \"session\" }> => e.type === \"session\");\n\t\t\tconst sessionId = header?.id;\n\t\t\tif (!sessionId || sessionId === this.currentSessionId || isAutoLearnSessionId(sessionId)) continue;\n\t\t\t// Privacy: only recall from sessions that ran in THIS working directory. A misplaced/copied\n\t\t\t// transcript with a different cwd must not leak across project boundaries (Bug #11).\n\t\t\tif (header?.cwd && resolve(header.cwd) !== resolve(this.cwd)) continue;\n\n\t\t\tconst text = extractSessionText(entries, MAX_DOC_CHARS);\n\t\t\tif (!text.trim()) continue;\n\t\t\tdocs.push({ sessionId, timestamp: header?.timestamp, text });\n\t\t\ttotal += text.length;\n\t\t\tif (total >= MAX_TOTAL_CHARS) break;\n\t\t}\n\t\treturn docs;\n\t}\n}\n\n/** Concatenate user+assistant text from a session's entries, capped to `maxChars`. */\nfunction extractSessionText(entries: FileEntry[], maxChars: number): string {\n\tconst parts: string[] = [];\n\tlet len = 0;\n\tfor (const entry of entries) {\n\t\tif (entry.type !== \"message\") continue;\n\t\tconst message = entry.message;\n\t\tif (message.role !== \"user\" && message.role !== \"assistant\") continue;\n\t\tconst content = message.content;\n\t\tlet text = \"\";\n\t\tif (typeof content === \"string\") {\n\t\t\ttext = content;\n\t\t} else if (Array.isArray(content)) {\n\t\t\ttext = content\n\t\t\t\t.map((b) => (b && typeof b === \"object\" && \"type\" in b && b.type === \"text\" ? (b.text ?? \"\") : \"\"))\n\t\t\t\t.join(\" \");\n\t\t}\n\t\ttext = text.trim();\n\t\tif (!text) continue;\n\t\t// Skip our own previously-injected recall pages so recalled snippets don't recirculate and\n\t\t// amplify across sessions (Bug #10).\n\t\tif (text.includes('<memory_context source=\"transcript-recall\"')) continue;\n\t\tparts.push(text);\n\t\tlen += text.length;\n\t\tif (len >= maxChars) break;\n\t}\n\treturn parts.join(\"\\n\").slice(0, maxChars);\n}\n"]}
+{"version":3,"file":"transcript-recall.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/providers/transcript-recall.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAkBxG,MAAM,WAAW,+BAA+B;IAC/C,eAAe,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAmBD,qBAAa,wBAAyB,YAAW,cAAc;IAC9D,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,MAAM,WAAW;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAe;IAC/C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAE3D,YAAY,OAAO,GAAE,+BAAoC,EAGxD;IAED,WAAW,IAAI,OAAO,CAErB;IAED,eAAe,IAAI,kBAAkB,CAEpC;IAEK,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B9E;IAEK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAG9B;IAED,mGAAmG;IAC7F,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpC;IAED,wFAAwF;IACxF,iBAAiB,IAAI,MAAM,EAAE,CAE5B;IAEK,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB7C;IAED,OAAO,CAAC,mBAAmB;IAyB3B,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,gBAAgB;YAMV,aAAa;CAa3B"}

package/dist/core/memory/providers/transcript-recall.js

@@ -1,32 +1,35 @@
 /**
- * TranscriptRecallProvider — cross-session similarity recall (adaptive-agent design R3).
- *
- * A read-only CONTEXT memory provider: it indexes the most-recent past session transcripts (the JSONL
- * corpus) with a dependency-free token/Jaccard index ({@link TranscriptIndex}, reusing skill_audit's
- * tokenizer) and answers `prefetch(query)` with a small `<memory_context>` recall page of the most
- * relevant past snippets. The current session and auto-learn sessions are excluded. It never writes —
- * the file-store remains the write target; this is the recall corpus.
+ * Cross-session recall coordinator. One worker belongs to one provider/session generation; no
+ * process-global transcript index is shared across sessions.
  */
-import { readdirSync, statSync } from "node:fs";
-import { join, resolve } from "node:path";
-import { getDefaultSessionDir, isAutoLearnSessionId, loadEntriesFromFile, } from "@caupulican/pi-agent-core/node";
-import { TranscriptIndex } from "../transcript-index.js";
-/** Most-recent past sessions to consider. */
-const MAX_SESSIONS = 60;
-/** Per-session text cap (keeps the index light and snippets relevant). */
-const MAX_DOC_CHARS = 8_000;
-/** Overall corpus cap across all docs. */
-const MAX_TOTAL_CHARS = 500_000;
-/** Skip transcript files larger than this before parsing them, so a huge log can't block/bloat the
- * first recalled turn (Bug #9). Far above a normal session; only pathological logs exceed it. */
-const MAX_FILE_BYTES = 8_000_000;
+import { Worker } from "node:worker_threads";
+import { isTranscriptRecallWorkerResponse, TRANSCRIPT_RECALL_MAX_QUERY_CHARS, } from "./transcript-recall-worker-protocol.js";
+const DEFAULT_MAX_PENDING_QUERIES = 8;
+const QUERY_TIMEOUT_MS = 1_000;
+function createDefaultWorkerSpecifier() {
+    if (typeof process.versions.bun === "string") {
+        return "./src/core/memory/providers/transcript-recall-worker.ts";
+    }
+    const isTypeScriptRuntime = import.meta.url.endsWith(".ts");
+    return new URL(isTypeScriptRuntime ? "./transcript-recall-worker.ts" : "./transcript-recall-worker.js", import.meta.url);
+}
+function formatRecallPage(hits) {
+    if (hits.length === 0)
+        return "";
+    const body = hits.map((hit) => `- (${hit.timestamp ?? "earlier session"}) ${hit.snippet}`).join("\n");
+    return `<memory_context source="transcript-recall">\nRelevant context recalled from past sessions (read-only reference, untrusted, may be stale):\n${body}\n</memory_context>`;
+}
 export class TranscriptRecallProvider {
-    name = "transcript-recall";
-    egress = "local";
-    index;
-    currentSessionId = "";
-    cwd = "";
-    agentDir = "";
+    constructor(options = {}) {
+        this.name = "transcript-recall";
+        this.egress = "local";
+        this.generation = 0;
+        this.requestId = 0;
+        this.ready = false;
+        this.pending = new Map();
+        this.workerSpecifier = options.workerSpecifier ?? createDefaultWorkerSpecifier();
+        this.maxPendingQueries = Math.max(1, Math.trunc(options.maxPendingQueries ?? DEFAULT_MAX_PENDING_QUERIES));
+    }
     isAvailable() {
         return true;
     }
@@ -34,139 +37,138 @@ export class TranscriptRecallProvider {
         return { surfaces: ["context"] };
     }
     async initialize(sessionId, ctx) {
-        this.currentSessionId = sessionId;
-        this.cwd = ctx.cwd;
-        this.agentDir = ctx.agentDir;
-        this.index = undefined; // built lazily on first prefetch
+        await this.disposeWorker();
+        const generation = ++this.generation;
+        this.ready = false;
+        this.readyPromise = new Promise((resolve) => {
+            this.resolveReady = resolve;
+        });
+        let worker;
+        try {
+            worker = new Worker(this.workerSpecifier);
+        }
+        catch {
+            this.finishReady();
+            return;
+        }
+        worker.unref();
+        this.worker = worker;
+        worker.on("message", (message) => this.handleWorkerMessage(worker, generation, message));
+        worker.on("error", () => this.handleWorkerFailure(worker, generation));
+        worker.on("exit", () => this.handleWorkerFailure(worker, generation));
+        try {
+            worker.postMessage({
+                type: "initialize",
+                generation,
+                sessionId,
+                agentDir: ctx.agentDir,
+                cwd: ctx.cwd,
+            });
+        }
+        catch {
+            this.handleWorkerFailure(worker, generation);
+        }
     }
     async shutdown() {
-        this.index = undefined;
+        this.generation += 1;
+        await this.disposeWorker();
+    }
+    /** Event-driven readiness hook for tests and callers that can wait outside the foreground turn. */
+    async waitUntilReady() {
+        await this.readyPromise;
     }
     /** GC manages the dynamic recall page so stale pages pack while the newest are kept. */
     getContextMarkers() {
         return ["<memory_context"];
     }
     async prefetch(query) {
-        if (!query.trim())
-            return "";
-        let index;
-        try {
-            index = this.ensureIndex();
-        }
-        catch {
+        const normalizedQuery = query.trim().slice(0, TRANSCRIPT_RECALL_MAX_QUERY_CHARS);
+        const worker = this.worker;
+        if (!normalizedQuery || !worker || !this.ready || this.pending.size >= this.maxPendingQueries)
             return "";
-        }
-        if (index.size === 0)
-            return "";
-        // minScore is a query-CONTAINMENT threshold (fraction of the query's tokens present in the doc),
-        // not Jaccard — so it is length-independent and recalls relevant long sessions. ~1/3 of query
-        // terms must appear before a session is considered relevant.
-        const hits = index.query(query, { k: 3, minScore: 0.34, maxSnippetChars: 600 });
-        if (hits.length === 0)
-            return "";
-        // MemoryManager centrally source-labels and fences every provider's complete recall page. Keep
-        // this provider output raw here so the built-in path is wrapped exactly once like extensions.
-        const body = hits.map((h) => `- (${h.timestamp ?? "earlier session"}) ${h.snippet}`).join("\n");
-        return `<memory_context source="transcript-recall">\nRelevant context recalled from past sessions (read-only reference, untrusted, may be stale):\n${body}\n</memory_context>`;
-    }
-    ensureIndex() {
-        if (!this.index) {
-            this.index = new TranscriptIndex(this.buildDocs());
-        }
-        return this.index;
-    }
-    buildDocs() {
-        const docs = [];
-        let dir;
-        try {
-            dir = getDefaultSessionDir(this.cwd, this.agentDir);
-        }
-        catch {
-            return docs;
-        }
-        let files;
-        try {
-            files = readdirSync(dir)
-                .filter((f) => f.endsWith(".jsonl"))
-                .map((f) => {
-                const path = join(dir, f);
-                let mtime = 0;
-                let size = 0;
-                try {
-                    const st = statSync(path);
-                    mtime = st.mtimeMs;
-                    size = st.size;
-                }
-                catch { }
-                return { path, mtime, size };
-            })
-                .filter((f) => f.size > 0 && f.size <= MAX_FILE_BYTES) // skip oversize logs before parse (Bug #9)
-                .sort((a, b) => b.mtime - a.mtime) // most-recent first
-                .slice(0, MAX_SESSIONS);
-        }
-        catch {
-            return docs;
-        }
-        let total = 0;
-        for (const { path } of files) {
-            let entries;
+        const generation = this.generation;
+        const requestId = this.requestId++;
+        return new Promise((resolve) => {
+            const timeout = setTimeout(() => this.finishQuery(requestId, ""), QUERY_TIMEOUT_MS);
+            timeout.unref();
+            this.pending.set(requestId, { worker, generation, resolve, timeout });
             try {
-                entries = loadEntriesFromFile(path);
+                worker.postMessage({ type: "query", generation, requestId, query: normalizedQuery });
             }
             catch {
-                continue;
+                this.finishQuery(requestId, "");
             }
-            const header = entries.find((e) => e.type === "session");
-            const sessionId = header?.id;
-            if (!sessionId || sessionId === this.currentSessionId || isAutoLearnSessionId(sessionId))
-                continue;
-            // Privacy: only recall from sessions that ran in THIS working directory. A misplaced/copied
-            // transcript with a different cwd must not leak across project boundaries (Bug #11).
-            if (header?.cwd && resolve(header.cwd) !== resolve(this.cwd))
-                continue;
-            const text = extractSessionText(entries, MAX_DOC_CHARS);
-            if (!text.trim())
-                continue;
-            docs.push({ sessionId, timestamp: header?.timestamp, text });
-            total += text.length;
-            if (total >= MAX_TOTAL_CHARS)
+        });
+    }
+    handleWorkerMessage(worker, generation, value) {
+        if (this.worker !== worker || this.generation !== generation || !isTranscriptRecallWorkerResponse(value)) {
+            return;
+        }
+        const message = value;
+        if (message.generation !== generation)
+            return;
+        switch (message.type) {
+            case "ready":
+                this.ready = true;
+                this.finishReady();
+                break;
+            case "result": {
+                const pending = this.pending.get(message.requestId);
+                if (!pending || pending.worker !== worker || pending.generation !== generation)
+                    return;
+                this.finishQuery(message.requestId, formatRecallPage(message.hits));
+                break;
+            }
+            case "failed":
+                this.handleWorkerFailure(worker, generation);
+                break;
+            case "stopped":
                 break;
         }
-        return docs;
     }
-}
-/** Concatenate user+assistant text from a session's entries, capped to `maxChars`. */
-function extractSessionText(entries, maxChars) {
-    const parts = [];
-    let len = 0;
-    for (const entry of entries) {
-        if (entry.type !== "message")
-            continue;
-        const message = entry.message;
-        if (message.role !== "user" && message.role !== "assistant")
-            continue;
-        const content = message.content;
-        let text = "";
-        if (typeof content === "string") {
-            text = content;
+    handleWorkerFailure(worker, generation) {
+        if (this.worker !== worker || this.generation !== generation)
+            return;
+        this.worker = undefined;
+        this.ready = false;
+        this.finishReady();
+        this.finishQueriesFor(worker);
+        void worker.terminate().catch(() => undefined);
+    }
+    finishReady() {
+        const resolve = this.resolveReady;
+        this.resolveReady = undefined;
+        resolve?.();
+    }
+    finishQuery(requestId, text) {
+        const pending = this.pending.get(requestId);
+        if (!pending)
+            return;
+        this.pending.delete(requestId);
+        clearTimeout(pending.timeout);
+        pending.resolve(text);
+    }
+    finishQueriesFor(worker) {
+        for (const [requestId, pending] of this.pending) {
+            if (pending.worker === worker)
+                this.finishQuery(requestId, "");
         }
-        else if (Array.isArray(content)) {
-            text = content
-                .map((b) => (b && typeof b === "object" && "type" in b && b.type === "text" ? (b.text ?? "") : ""))
-                .join(" ");
+    }
+    async disposeWorker() {
+        const worker = this.worker;
+        this.worker = undefined;
+        this.ready = false;
+        this.finishReady();
+        if (worker)
+            this.finishQueriesFor(worker);
+        this.readyPromise = undefined;
+        if (!worker)
+            return;
+        try {
+            worker.postMessage({ type: "shutdown", generation: this.generation });
         }
-        text = text.trim();
-        if (!text)
-            continue;
-        // Skip our own previously-injected recall pages so recalled snippets don't recirculate and
-        // amplify across sessions (Bug #10).
-        if (text.includes('<memory_context source="transcript-recall"'))
-            continue;
-        parts.push(text);
-        len += text.length;
-        if (len >= maxChars)
-            break;
+        catch { }
+        await worker.terminate().catch(() => undefined);
     }
-    return parts.join("\n").slice(0, maxChars);
 }
 //# sourceMappingURL=transcript-recall.js.map

package/dist/core/memory/providers/transcript-recall.js.map

@@ -1 +1 @@
-{"version":3,"file":"transcript-recall.js","sourceRoot":"","sources":["../../../../src/core/memory/providers/transcript-recall.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * TranscriptRecallProvider — cross-session similarity recall (adaptive-agent design R3).\n *\n * A read-only CONTEXT memory provider: it indexes the most-recent past session transcripts (the JSONL\n * corpus) with a dependency-free token/Jaccard index ({@link TranscriptIndex}, reusing skill_audit's\n * tokenizer) and answers `prefetch(query)` with a small `<memory_context>` recall page of the most\n * relevant past snippets. The current session and auto-learn sessions are excluded. It never writes —\n * the file-store remains the write target; this is the recall corpus.\n */\n\nimport { readdirSync, statSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport {\n\ttype FileEntry,\n\tgetDefaultSessionDir,\n\tisAutoLearnSessionId,\n\tloadEntriesFromFile,\n} from \"@caupulican/pi-agent-core/node\";\nimport type { MemoryCapabilities, MemoryLifecycleContext, MemoryProvider } from \"../memory-provider.ts\";\nimport { type TranscriptDoc, TranscriptIndex } from \"../transcript-index.ts\";\n\n/** Most-recent past sessions to consider. */\nconst MAX_SESSIONS = 60;\n/** Per-session text cap (keeps the index light and snippets relevant). */\nconst MAX_DOC_CHARS = 8_000;\n/** Overall corpus cap across all docs. */\nconst MAX_TOTAL_CHARS = 500_000;\n/** Skip transcript files larger than this before parsing them, so a huge log can't block/bloat the\n * first recalled turn (Bug #9). Far above a normal session; only pathological logs exceed it. */\nconst MAX_FILE_BYTES = 8_000_000;\n\nexport class TranscriptRecallProvider implements MemoryProvider {\n\treadonly name = \"transcript-recall\";\n\treadonly egress = \"local\";\n\tprivate index: TranscriptIndex | undefined;\n\tprivate currentSessionId = \"\";\n\tprivate cwd = \"\";\n\tprivate agentDir = \"\";\n\n\tisAvailable(): boolean {\n\t\treturn true;\n\t}\n\n\tgetCapabilities(): MemoryCapabilities {\n\t\treturn { surfaces: [\"context\"] };\n\t}\n\n\tasync initialize(sessionId: string, ctx: MemoryLifecycleContext): Promise<void> {\n\t\tthis.currentSessionId = sessionId;\n\t\tthis.cwd = ctx.cwd;\n\t\tthis.agentDir = ctx.agentDir;\n\t\tthis.index = undefined; // built lazily on first prefetch\n\t}\n\n\tasync shutdown(): Promise<void> {\n\t\tthis.index = undefined;\n\t}\n\n\t/** GC manages the dynamic recall page so stale pages pack while the newest are kept. */\n\tgetContextMarkers(): string[] {\n\t\treturn [\"<memory_context\"];\n\t}\n\n\tasync prefetch(query: string): Promise<string> {\n\t\tif (!query.trim()) return \"\";\n\t\tlet index: TranscriptIndex;\n\t\ttry {\n\t\t\tindex = this.ensureIndex();\n\t\t} catch {\n\t\t\treturn \"\";\n\t\t}\n\t\tif (index.size === 0) return \"\";\n\t\t// minScore is a query-CONTAINMENT threshold (fraction of the query's tokens present in the doc),\n\t\t// not Jaccard — so it is length-independent and recalls relevant long sessions. ~1/3 of query\n\t\t// terms must appear before a session is considered relevant.\n\t\tconst hits = index.query(query, { k: 3, minScore: 0.34, maxSnippetChars: 600 });\n\t\tif (hits.length === 0) return \"\";\n\t\t// MemoryManager centrally source-labels and fences every provider's complete recall page. Keep\n\t\t// this provider output raw here so the built-in path is wrapped exactly once like extensions.\n\t\tconst body = hits.map((h) => `- (${h.timestamp ?? \"earlier session\"}) ${h.snippet}`).join(\"\\n\");\n\t\treturn `<memory_context source=\"transcript-recall\">\\nRelevant context recalled from past sessions (read-only reference, untrusted, may be stale):\\n${body}\\n</memory_context>`;\n\t}\n\n\tprivate ensureIndex(): TranscriptIndex {\n\t\tif (!this.index) {\n\t\t\tthis.index = new TranscriptIndex(this.buildDocs());\n\t\t}\n\t\treturn this.index;\n\t}\n\n\tprivate buildDocs(): TranscriptDoc[] {\n\t\tconst docs: TranscriptDoc[] = [];\n\t\tlet dir: string;\n\t\ttry {\n\t\t\tdir = getDefaultSessionDir(this.cwd, this.agentDir);\n\t\t} catch {\n\t\t\treturn docs;\n\t\t}\n\n\t\tlet files: Array<{ path: string; mtime: number }>;\n\t\ttry {\n\t\t\tfiles = readdirSync(dir)\n\t\t\t\t.filter((f) => f.endsWith(\".jsonl\"))\n\t\t\t\t.map((f) => {\n\t\t\t\t\tconst path = join(dir, f);\n\t\t\t\t\tlet mtime = 0;\n\t\t\t\t\tlet size = 0;\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst st = statSync(path);\n\t\t\t\t\t\tmtime = st.mtimeMs;\n\t\t\t\t\t\tsize = st.size;\n\t\t\t\t\t} catch {}\n\t\t\t\t\treturn { path, mtime, size };\n\t\t\t\t})\n\t\t\t\t.filter((f) => f.size > 0 && f.size <= MAX_FILE_BYTES) // skip oversize logs before parse (Bug #9)\n\t\t\t\t.sort((a, b) => b.mtime - a.mtime) // most-recent first\n\t\t\t\t.slice(0, MAX_SESSIONS);\n\t\t} catch {\n\t\t\treturn docs;\n\t\t}\n\n\t\tlet total = 0;\n\t\tfor (const { path } of files) {\n\t\t\tlet entries: FileEntry[];\n\t\t\ttry {\n\t\t\t\tentries = loadEntriesFromFile(path);\n\t\t\t} catch {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst header = entries.find((e): e is Extract<FileEntry, { type: \"session\" }> => e.type === \"session\");\n\t\t\tconst sessionId = header?.id;\n\t\t\tif (!sessionId || sessionId === this.currentSessionId || isAutoLearnSessionId(sessionId)) continue;\n\t\t\t// Privacy: only recall from sessions that ran in THIS working directory. A misplaced/copied\n\t\t\t// transcript with a different cwd must not leak across project boundaries (Bug #11).\n\t\t\tif (header?.cwd && resolve(header.cwd) !== resolve(this.cwd)) continue;\n\n\t\t\tconst text = extractSessionText(entries, MAX_DOC_CHARS);\n\t\t\tif (!text.trim()) continue;\n\t\t\tdocs.push({ sessionId, timestamp: header?.timestamp, text });\n\t\t\ttotal += text.length;\n\t\t\tif (total >= MAX_TOTAL_CHARS) break;\n\t\t}\n\t\treturn docs;\n\t}\n}\n\n/** Concatenate user+assistant text from a session's entries, capped to `maxChars`. */\nfunction extractSessionText(entries: FileEntry[], maxChars: number): string {\n\tconst parts: string[] = [];\n\tlet len = 0;\n\tfor (const entry of entries) {\n\t\tif (entry.type !== \"message\") continue;\n\t\tconst message = entry.message;\n\t\tif (message.role !== \"user\" && message.role !== \"assistant\") continue;\n\t\tconst content = message.content;\n\t\tlet text = \"\";\n\t\tif (typeof content === \"string\") {\n\t\t\ttext = content;\n\t\t} else if (Array.isArray(content)) {\n\t\t\ttext = content\n\t\t\t\t.map((b) => (b && typeof b === \"object\" && \"type\" in b && b.type === \"text\" ? (b.text ?? \"\") : \"\"))\n\t\t\t\t.join(\" \");\n\t\t}\n\t\ttext = text.trim();\n\t\tif (!text) continue;\n\t\t// Skip our own previously-injected recall pages so recalled snippets don't recirculate and\n\t\t// amplify across sessions (Bug #10).\n\t\tif (text.includes('<memory_context source=\"transcript-recall\"')) continue;\n\t\tparts.push(text);\n\t\tlen += text.length;\n\t\tif (len >= maxChars) break;\n\t}\n\treturn parts.join(\"\\n\").slice(0, maxChars);\n}\n"]}
+{"version":3,"file":"transcript-recall.js","sourceRoot":"","sources":["../../../../src/core/memory/providers/transcript-recall.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Cross-session recall coordinator. One worker belongs to one provider/session generation; no\n * process-global transcript index is shared across sessions.\n */\n\nimport { Worker } from \"node:worker_threads\";\nimport type { MemoryCapabilities, MemoryLifecycleContext, MemoryProvider } from \"../memory-provider.ts\";\nimport type { RecallHit } from \"../transcript-index.ts\";\nimport {\n\tisTranscriptRecallWorkerResponse,\n\tTRANSCRIPT_RECALL_MAX_QUERY_CHARS,\n\ttype TranscriptRecallWorkerResponse,\n} from \"./transcript-recall-worker-protocol.ts\";\n\nconst DEFAULT_MAX_PENDING_QUERIES = 8;\nconst QUERY_TIMEOUT_MS = 1_000;\n\ninterface PendingQuery {\n\tworker: Worker;\n\tgeneration: number;\n\tresolve: (text: string) => void;\n\ttimeout: NodeJS.Timeout;\n}\n\nexport interface TranscriptRecallProviderOptions {\n\tworkerSpecifier?: string | URL;\n\tmaxPendingQueries?: number;\n}\n\nfunction createDefaultWorkerSpecifier(): string | URL {\n\tif (typeof process.versions.bun === \"string\") {\n\t\treturn \"./src/core/memory/providers/transcript-recall-worker.ts\";\n\t}\n\tconst isTypeScriptRuntime = import.meta.url.endsWith(\".ts\");\n\treturn new URL(\n\t\tisTypeScriptRuntime ? \"./transcript-recall-worker.ts\" : \"./transcript-recall-worker.js\",\n\t\timport.meta.url,\n\t);\n}\n\nfunction formatRecallPage(hits: readonly RecallHit[]): string {\n\tif (hits.length === 0) return \"\";\n\tconst body = hits.map((hit) => `- (${hit.timestamp ?? \"earlier session\"}) ${hit.snippet}`).join(\"\\n\");\n\treturn `<memory_context source=\"transcript-recall\">\\nRelevant context recalled from past sessions (read-only reference, untrusted, may be stale):\\n${body}\\n</memory_context>`;\n}\n\nexport class TranscriptRecallProvider implements MemoryProvider {\n\treadonly name = \"transcript-recall\";\n\treadonly egress = \"local\";\n\tprivate readonly workerSpecifier: string | URL;\n\tprivate readonly maxPendingQueries: number;\n\tprivate worker: Worker | undefined;\n\tprivate generation = 0;\n\tprivate requestId = 0;\n\tprivate ready = false;\n\tprivate readyPromise: Promise<void> | undefined;\n\tprivate resolveReady: (() => void) | undefined;\n\tprivate readonly pending = new Map<number, PendingQuery>();\n\n\tconstructor(options: TranscriptRecallProviderOptions = {}) {\n\t\tthis.workerSpecifier = options.workerSpecifier ?? createDefaultWorkerSpecifier();\n\t\tthis.maxPendingQueries = Math.max(1, Math.trunc(options.maxPendingQueries ?? DEFAULT_MAX_PENDING_QUERIES));\n\t}\n\n\tisAvailable(): boolean {\n\t\treturn true;\n\t}\n\n\tgetCapabilities(): MemoryCapabilities {\n\t\treturn { surfaces: [\"context\"] };\n\t}\n\n\tasync initialize(sessionId: string, ctx: MemoryLifecycleContext): Promise<void> {\n\t\tawait this.disposeWorker();\n\t\tconst generation = ++this.generation;\n\t\tthis.ready = false;\n\t\tthis.readyPromise = new Promise((resolve) => {\n\t\t\tthis.resolveReady = resolve;\n\t\t});\n\n\t\tlet worker: Worker;\n\t\ttry {\n\t\t\tworker = new Worker(this.workerSpecifier);\n\t\t} catch {\n\t\t\tthis.finishReady();\n\t\t\treturn;\n\t\t}\n\t\tworker.unref();\n\t\tthis.worker = worker;\n\t\tworker.on(\"message\", (message: unknown) => this.handleWorkerMessage(worker, generation, message));\n\t\tworker.on(\"error\", () => this.handleWorkerFailure(worker, generation));\n\t\tworker.on(\"exit\", () => this.handleWorkerFailure(worker, generation));\n\t\ttry {\n\t\t\tworker.postMessage({\n\t\t\t\ttype: \"initialize\",\n\t\t\t\tgeneration,\n\t\t\t\tsessionId,\n\t\t\t\tagentDir: ctx.agentDir,\n\t\t\t\tcwd: ctx.cwd,\n\t\t\t});\n\t\t} catch {\n\t\t\tthis.handleWorkerFailure(worker, generation);\n\t\t}\n\t}\n\n\tasync shutdown(): Promise<void> {\n\t\tthis.generation += 1;\n\t\tawait this.disposeWorker();\n\t}\n\n\t/** Event-driven readiness hook for tests and callers that can wait outside the foreground turn. */\n\tasync waitUntilReady(): Promise<void> {\n\t\tawait this.readyPromise;\n\t}\n\n\t/** GC manages the dynamic recall page so stale pages pack while the newest are kept. */\n\tgetContextMarkers(): string[] {\n\t\treturn [\"<memory_context\"];\n\t}\n\n\tasync prefetch(query: string): Promise<string> {\n\t\tconst normalizedQuery = query.trim().slice(0, TRANSCRIPT_RECALL_MAX_QUERY_CHARS);\n\t\tconst worker = this.worker;\n\t\tif (!normalizedQuery || !worker || !this.ready || this.pending.size >= this.maxPendingQueries) return \"\";\n\n\t\tconst generation = this.generation;\n\t\tconst requestId = this.requestId++;\n\t\treturn new Promise((resolve) => {\n\t\t\tconst timeout = setTimeout(() => this.finishQuery(requestId, \"\"), QUERY_TIMEOUT_MS);\n\t\t\ttimeout.unref();\n\t\t\tthis.pending.set(requestId, { worker, generation, resolve, timeout });\n\t\t\ttry {\n\t\t\t\tworker.postMessage({ type: \"query\", generation, requestId, query: normalizedQuery });\n\t\t\t} catch {\n\t\t\t\tthis.finishQuery(requestId, \"\");\n\t\t\t}\n\t\t});\n\t}\n\n\tprivate handleWorkerMessage(worker: Worker, generation: number, value: unknown): void {\n\t\tif (this.worker !== worker || this.generation !== generation || !isTranscriptRecallWorkerResponse(value)) {\n\t\t\treturn;\n\t\t}\n\t\tconst message: TranscriptRecallWorkerResponse = value;\n\t\tif (message.generation !== generation) return;\n\t\tswitch (message.type) {\n\t\t\tcase \"ready\":\n\t\t\t\tthis.ready = true;\n\t\t\t\tthis.finishReady();\n\t\t\t\tbreak;\n\t\t\tcase \"result\": {\n\t\t\t\tconst pending = this.pending.get(message.requestId);\n\t\t\t\tif (!pending || pending.worker !== worker || pending.generation !== generation) return;\n\t\t\t\tthis.finishQuery(message.requestId, formatRecallPage(message.hits));\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"failed\":\n\t\t\t\tthis.handleWorkerFailure(worker, generation);\n\t\t\t\tbreak;\n\t\t\tcase \"stopped\":\n\t\t\t\tbreak;\n\t\t}\n\t}\n\n\tprivate handleWorkerFailure(worker: Worker, generation: number): void {\n\t\tif (this.worker !== worker || this.generation !== generation) return;\n\t\tthis.worker = undefined;\n\t\tthis.ready = false;\n\t\tthis.finishReady();\n\t\tthis.finishQueriesFor(worker);\n\t\tvoid worker.terminate().catch(() => undefined);\n\t}\n\n\tprivate finishReady(): void {\n\t\tconst resolve = this.resolveReady;\n\t\tthis.resolveReady = undefined;\n\t\tresolve?.();\n\t}\n\n\tprivate finishQuery(requestId: number, text: string): void {\n\t\tconst pending = this.pending.get(requestId);\n\t\tif (!pending) return;\n\t\tthis.pending.delete(requestId);\n\t\tclearTimeout(pending.timeout);\n\t\tpending.resolve(text);\n\t}\n\n\tprivate finishQueriesFor(worker: Worker): void {\n\t\tfor (const [requestId, pending] of this.pending) {\n\t\t\tif (pending.worker === worker) this.finishQuery(requestId, \"\");\n\t\t}\n\t}\n\n\tprivate async disposeWorker(): Promise<void> {\n\t\tconst worker = this.worker;\n\t\tthis.worker = undefined;\n\t\tthis.ready = false;\n\t\tthis.finishReady();\n\t\tif (worker) this.finishQueriesFor(worker);\n\t\tthis.readyPromise = undefined;\n\t\tif (!worker) return;\n\t\ttry {\n\t\t\tworker.postMessage({ type: \"shutdown\", generation: this.generation });\n\t\t} catch {}\n\t\tawait worker.terminate().catch(() => undefined);\n\t}\n}\n"]}