@runcore-sh/runcore 0.1.2

package/dist/llm/providers/openai.js.map

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

package/dist/llm/providers/openrouter.d.ts

@@ -0,0 +1,7 @@
+/**
+ * OpenRouter LLM provider for Core.
+ * Wraps the existing OpenRouter streaming + completion logic behind the LLMProvider interface.
+ */
+import type { LLMProvider } from "./types.js";
+export declare const openRouterProvider: LLMProvider;
+//# sourceMappingURL=openrouter.d.ts.map

package/dist/llm/providers/openrouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openrouter.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/openrouter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,YAAY,CAAC;AA4B7D,eAAO,MAAM,kBAAkB,EAAE,WAmJhC,CAAC"}

package/dist/llm/providers/openrouter.js

@@ -0,0 +1,158 @@
+/**
+ * OpenRouter LLM provider for Core.
+ * Wraps the existing OpenRouter streaming + completion logic behind the LLMProvider interface.
+ */
+import { classifyApiError } from "../errors.js";
+import { createLogger } from "../../utils/logger.js";
+import { resolveEnv, getInstanceName } from "../../instance.js";
+const log = createLogger("llm.provider.openrouter");
+const OPENROUTER_URL = "https://openrouter.ai/api/v1/chat/completions";
+const DEFAULT_CHAT_MODEL = "anthropic/claude-sonnet-4";
+const DEFAULT_UTILITY_MODEL = "meta-llama/llama-3.1-8b-instruct";
+function getApiKey() {
+    return process.env.OPENROUTER_API_KEY;
+}
+function formatMessages(messages) {
+    return messages.map((m) => ({ role: m.role, content: m.content }));
+}
+function headers(apiKey) {
+    return {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${apiKey}`,
+        "HTTP-Referer": "http://localhost:3577",
+        "X-Title": getInstanceName(),
+    };
+}
+export const openRouterProvider = {
+    name: "openrouter",
+    defaultChatModel: DEFAULT_CHAT_MODEL,
+    defaultUtilityModel: DEFAULT_UTILITY_MODEL,
+    async streamChat(options) {
+        const apiKey = getApiKey();
+        if (!apiKey) {
+            options.onError(new Error("OPENROUTER_API_KEY not set"));
+            return;
+        }
+        const model = options.model ?? process.env.OPENROUTER_MODEL ?? DEFAULT_CHAT_MODEL;
+        log.debug("Streaming chat request", {
+            model,
+            messageCount: options.messages.length,
+        });
+        let response;
+        try {
+            response = await fetch(OPENROUTER_URL, {
+                method: "POST",
+                headers: headers(apiKey),
+                body: JSON.stringify({
+                    model,
+                    messages: formatMessages(options.messages),
+                    stream: true,
+                }),
+                signal: options.signal,
+            });
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            log.error("Stream connection failed", { model, error: error.message });
+            options.onError(error);
+            return;
+        }
+        if (!response.ok) {
+            const text = await response.text().catch(() => "unknown error");
+            log.error("OpenRouter stream API error", {
+                status: response.status,
+                body: text,
+                model,
+            });
+            options.onError(classifyApiError("OpenRouter", response.status, text, model));
+            return;
+        }
+        const reader = response.body?.getReader();
+        if (!reader) {
+            options.onError(new Error("No response body"));
+            return;
+        }
+        const decoder = new TextDecoder();
+        let buffer = "";
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split("\n");
+                buffer = lines.pop() ?? "";
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (!trimmed || !trimmed.startsWith("data: "))
+                        continue;
+                    const data = trimmed.slice(6);
+                    if (data === "[DONE]") {
+                        options.onDone();
+                        return;
+                    }
+                    try {
+                        const parsed = JSON.parse(data);
+                        const delta = parsed.choices?.[0]?.delta?.content;
+                        if (delta)
+                            options.onToken(delta);
+                    }
+                    catch {
+                        // Skip malformed JSON lines
+                    }
+                }
+            }
+            options.onDone();
+        }
+        catch (err) {
+            if (options.signal?.aborted)
+                return;
+            options.onError(err instanceof Error ? err : new Error(String(err)));
+        }
+        finally {
+            reader.releaseLock();
+        }
+    },
+    async completeChat(messages, model, signal) {
+        const apiKey = getApiKey();
+        if (!apiKey)
+            throw new Error("OPENROUTER_API_KEY not set");
+        const resolvedModel = model ?? resolveEnv("EXTRACTION_MODEL") ?? DEFAULT_UTILITY_MODEL;
+        log.debug("Completion request", {
+            model: resolvedModel,
+            messageCount: messages.length,
+        });
+        const response = await fetch(OPENROUTER_URL, {
+            method: "POST",
+            headers: headers(apiKey),
+            body: JSON.stringify({
+                model: resolvedModel,
+                messages: formatMessages(messages),
+                stream: false,
+            }),
+            signal,
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => "unknown error");
+            log.error("OpenRouter API error", {
+                status: response.status,
+                body: text,
+                model: resolvedModel,
+            });
+            throw classifyApiError("OpenRouter", response.status, text, resolvedModel);
+        }
+        const data = (await response.json());
+        const content = data.choices?.[0]?.message?.content;
+        if (!content)
+            throw new Error("No content in OpenRouter response");
+        log.debug("Completion received", {
+            model: resolvedModel,
+            responseLength: content.length,
+        });
+        return content;
+    },
+    async isAvailable() {
+        return !!getApiKey();
+    },
+};
+//# sourceMappingURL=openrouter.js.map

package/dist/llm/providers/openrouter.js.map

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

package/dist/llm/providers/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * LLM provider abstraction types for Core.
+ * All providers implement LLMProvider to support both streaming and non-streaming completions.
+ */
+import type { ContextMessage } from "../../types.js";
+/** Supported LLM provider names. */
+export type ProviderName = "openrouter" | "anthropic" | "openai" | "ollama";
+/** Options for streaming chat completions. */
+export interface StreamOptions {
+    messages: ContextMessage[];
+    model?: string;
+    onToken: (token: string) => void;
+    onDone: () => void;
+    onError: (error: Error) => void;
+    signal?: AbortSignal;
+}
+/** Interface that all LLM providers must implement. */
+export interface LLMProvider {
+    readonly name: ProviderName;
+    readonly defaultChatModel: string;
+    readonly defaultUtilityModel: string;
+    /** Stream a chat completion, calling onToken/onDone/onError callbacks. */
+    streamChat(options: StreamOptions): Promise<void>;
+    /** Non-streaming chat completion. Returns the full assistant response. */
+    completeChat(messages: ContextMessage[], model?: string, signal?: AbortSignal): Promise<string>;
+    /** Check if the provider is available (API key set, service reachable, etc.). */
+    isAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/llm/providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/llm/providers/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,oCAAoC;AACpC,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5E,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IAErC,0EAA0E;IAC1E,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD,0EAA0E;IAC1E,YAAY,CACV,QAAQ,EAAE,cAAc,EAAE,EAC1B,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB,iFAAiF;IACjF,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC"}

package/dist/llm/providers/types.js

@@ -0,0 +1,6 @@
+/**
+ * LLM provider abstraction types for Core.
+ * All providers implement LLMProvider to support both streaming and non-streaming completions.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/llm/providers/types.js.map

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

package/dist/llm/retry.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Retry with exponential backoff for LLM provider calls.
+ * Retries only on recoverable (transient) errors: rate limits (429), server errors (5xx), timeouts.
+ * Non-recoverable errors (auth, billing, bad request) are thrown immediately.
+ */
+import type { StreamOptions } from "./providers/types.js";
+export interface RetryOptions {
+    /** Maximum number of retry attempts (default: 3). */
+    maxRetries?: number;
+    /** Initial delay in ms before first retry (default: 1000). */
+    baseDelayMs?: number;
+    /** Maximum delay cap in ms (default: 30000). */
+    maxDelayMs?: number;
+}
+/** Returns true if the error is worth retrying. */
+export declare function isRetryable(err: unknown): boolean;
+/**
+ * Execute an async function with retry on transient failures.
+ * Non-recoverable errors are thrown immediately without retry.
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, opts?: RetryOptions): Promise<T>;
+/**
+ * Retry wrapper for streaming LLM calls.
+ * Only retries when a retryable error occurs before any tokens have been emitted.
+ * Once tokens start flowing, errors propagate to the original onError callback
+ * to avoid sending duplicate tokens.
+ */
+export declare function withStreamRetry(streamFn: (options: StreamOptions) => Promise<void>, opts?: RetryOptions): (options: StreamOptions) => Promise<void>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/llm/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/llm/retry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAQD,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAoBjD;AAaD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,CAAC,CAAC,CAqCZ;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,EACnD,IAAI,CAAC,EAAE,YAAY,GAClB,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAyD3C"}

package/dist/llm/retry.js

@@ -0,0 +1,139 @@
+/**
+ * Retry with exponential backoff for LLM provider calls.
+ * Retries only on recoverable (transient) errors: rate limits (429), server errors (5xx), timeouts.
+ * Non-recoverable errors (auth, billing, bad request) are thrown immediately.
+ */
+import { LLMError } from "./errors.js";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("llm.retry");
+const DEFAULTS = {
+    maxRetries: 3,
+    baseDelayMs: 1000,
+    maxDelayMs: 30_000,
+};
+/** Returns true if the error is worth retrying. */
+export function isRetryable(err) {
+    // LLMError with recoverable flag (429, 5xx)
+    if (err instanceof LLMError)
+        return err.recoverable;
+    // Network errors / timeouts from fetch
+    if (err instanceof Error) {
+        const msg = err.message.toLowerCase();
+        return (msg.includes("timeout") ||
+            msg.includes("econnreset") ||
+            msg.includes("econnrefused") ||
+            msg.includes("fetch failed") ||
+            msg.includes("network") ||
+            msg.includes("socket hang up") ||
+            err.name === "TimeoutError" ||
+            err.name === "AbortError");
+    }
+    return false;
+}
+/** Delay with jitter: base * 2^attempt + random jitter. */
+function backoffDelay(attempt, baseMs, maxMs) {
+    const exponential = baseMs * Math.pow(2, attempt);
+    const jitter = Math.random() * baseMs;
+    return Math.min(exponential + jitter, maxMs);
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Execute an async function with retry on transient failures.
+ * Non-recoverable errors are thrown immediately without retry.
+ */
+export async function withRetry(fn, opts) {
+    const { maxRetries, baseDelayMs, maxDelayMs } = { ...DEFAULTS, ...opts };
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = err;
+            // Don't retry non-recoverable errors
+            if (!isRetryable(err))
+                throw err;
+            // Don't retry if we've exhausted attempts
+            if (attempt >= maxRetries) {
+                log.warn("All retry attempts exhausted", {
+                    attempts: attempt + 1,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+                break;
+            }
+            const delayMs = backoffDelay(attempt, baseDelayMs, maxDelayMs);
+            log.info("Retrying after transient failure", {
+                attempt: attempt + 1,
+                maxRetries,
+                delayMs: Math.round(delayMs),
+                error: err instanceof Error ? err.message : String(err),
+                statusCode: err instanceof LLMError ? err.statusCode : undefined,
+            });
+            await sleep(delayMs);
+        }
+    }
+    throw lastError;
+}
+/**
+ * Retry wrapper for streaming LLM calls.
+ * Only retries when a retryable error occurs before any tokens have been emitted.
+ * Once tokens start flowing, errors propagate to the original onError callback
+ * to avoid sending duplicate tokens.
+ */
+export function withStreamRetry(streamFn, opts) {
+    const { maxRetries, baseDelayMs, maxDelayMs } = { ...DEFAULTS, ...opts };
+    return (options) => {
+        let attempt = 0;
+        function tryStream() {
+            let tokensSent = false;
+            return new Promise((resolve) => {
+                const wrappedOptions = {
+                    ...options,
+                    onToken: (token) => {
+                        tokensSent = true;
+                        options.onToken(token);
+                    },
+                    onDone: () => {
+                        options.onDone();
+                        resolve();
+                    },
+                    onError: async (err) => {
+                        // Only retry if no tokens sent yet and error is retryable
+                        if (!tokensSent && attempt < maxRetries && isRetryable(err)) {
+                            attempt++;
+                            const delayMs = backoffDelay(attempt - 1, baseDelayMs, maxDelayMs);
+                            log.info("Retrying stream after transient failure", {
+                                attempt,
+                                maxRetries,
+                                delayMs: Math.round(delayMs),
+                                error: err.message,
+                                statusCode: err instanceof LLMError ? err.statusCode : undefined,
+                            });
+                            await sleep(delayMs);
+                            tryStream().then(resolve);
+                        }
+                        else {
+                            if (!tokensSent && attempt >= maxRetries) {
+                                log.warn("All stream retry attempts exhausted", {
+                                    attempts: attempt + 1,
+                                    error: err.message,
+                                });
+                            }
+                            options.onError(err);
+                            resolve();
+                        }
+                    },
+                };
+                streamFn(wrappedOptions).catch((err) => {
+                    // Handle rejected promise from streamFn (shouldn't normally happen
+                    // since providers catch internally, but be safe)
+                    wrappedOptions.onError(err instanceof Error ? err : new Error(String(err)));
+                });
+            });
+        }
+        return tryStream();
+    };
+}
+//# sourceMappingURL=retry.js.map

package/dist/llm/retry.js.map

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

package/dist/memory/file-backed.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Long-term memory backed by the brain/ file system (Personal Brain OS).
+ * Append-only JSONL: experiences (episodic), semantic.jsonl, procedural.jsonl.
+ * All memory files encrypted at rest when encryption key is available.
+ */
+import type { LongTermMemoryType, MemoryEntry } from "../types.js";
+import type { LongTermMemoryStore } from "./long-term.js";
+/**
+ * File-backed LTM: reads/writes brain/memory/*.jsonl.
+ * Append-only: add() only appends a line; never overwrites.
+ * All memory files encrypted at rest via brain-io.
+ */
+export declare class FileSystemLongTermMemory implements LongTermMemoryStore {
+    private readonly basePath;
+    private vectorIndex;
+    constructor(basePath: string, encryptionKey?: Buffer);
+    /** Initialize vector index: load embeddings, backfill missing entries. */
+    init(): Promise<void>;
+    private path;
+    private readLines;
+    /**
+     * Collect IDs that have been archived (lines with status:"archived").
+     * Then return only entries whose ID is not in that set.
+     */
+    private parseFile;
+    list(type?: LongTermMemoryType): Promise<MemoryEntry[]>;
+    add(entry: Omit<MemoryEntry, "id" | "createdAt">): Promise<MemoryEntry>;
+    get(id: string): Promise<MemoryEntry | null>;
+    delete(id: string): Promise<boolean>;
+    search(query: {
+        type?: LongTermMemoryType;
+        contentSubstring?: string;
+        meta?: Record<string, unknown>;
+    }): Promise<MemoryEntry[]>;
+}
+//# sourceMappingURL=file-backed.d.ts.map

package/dist/memory/file-backed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-backed.d.ts","sourceRoot":"","sources":["../../src/memory/file-backed.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAuB1D;;;;GAIG;AACH,qBAAa,wBAAyB,YAAW,mBAAmB;IAGtD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,WAAW,CAAc;gBAEJ,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM;IAUrE,0EAA0E;IACpE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,OAAO,CAAC,IAAI;YAIE,SAAS;IAIvB;;;OAGG;IACH,OAAO,CAAC,SAAS;IAiBX,IAAI,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAgBvD,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAmBvE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK5C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKpC,MAAM,CAAC,KAAK,EAAE;QAClB,IAAI,CAAC,EAAE,kBAAkB,CAAC;QAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAkD3B"}

package/dist/memory/file-backed.js

@@ -0,0 +1,178 @@
+/**
+ * Long-term memory backed by the brain/ file system (Personal Brain OS).
+ * Append-only JSONL: experiences (episodic), semantic.jsonl, procedural.jsonl.
+ * All memory files encrypted at rest when encryption key is available.
+ */
+import { join } from "node:path";
+import { VectorIndex } from "./vector-index.js";
+import { readBrainLines, appendBrainLine, ensureBrainJsonl } from "../lib/brain-io.js";
+import { setEncryptionKey, clearEncryptionKey } from "../lib/key-store.js";
+const TYPE_TO_FILE = {
+    episodic: "experiences.jsonl",
+    semantic: "semantic.jsonl",
+    procedural: "procedural.jsonl",
+};
+function generateId() {
+    return `mem_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 9)}`;
+}
+/** Ensure the memory directory and file exist; first line is schema if missing. */
+async function ensureFile(filePath, schema) {
+    await ensureBrainJsonl(filePath, JSON.stringify(schema));
+}
+/**
+ * File-backed LTM: reads/writes brain/memory/*.jsonl.
+ * Append-only: add() only appends a line; never overwrites.
+ * All memory files encrypted at rest via brain-io.
+ */
+export class FileSystemLongTermMemory {
+    basePath;
+    vectorIndex;
+    constructor(basePath, encryptionKey) {
+        this.basePath = basePath;
+        // Wire the key into the shared key-store so brain-io can use it.
+        if (encryptionKey) {
+            setEncryptionKey(encryptionKey);
+        }
+        else {
+            clearEncryptionKey();
+        }
+        this.vectorIndex = new VectorIndex(basePath);
+    }
+    /** Initialize vector index: load embeddings, backfill missing entries. */
+    async init() {
+        const allEntries = await this.list();
+        await this.vectorIndex.init(allEntries.map((e) => ({ id: e.id, content: e.content })));
+    }
+    path(file) {
+        return join(this.basePath, file);
+    }
+    async readLines(fileName) {
+        return readBrainLines(this.path(fileName));
+    }
+    /**
+     * Collect IDs that have been archived (lines with status:"archived").
+     * Then return only entries whose ID is not in that set.
+     */
+    parseFile(lines) {
+        const archived = new Set();
+        const entries = [];
+        for (const line of lines) {
+            try {
+                const obj = JSON.parse(line);
+                if (obj._schema)
+                    continue;
+                if (obj.status === "archived" && typeof obj.id === "string") {
+                    archived.add(obj.id);
+                    continue;
+                }
+                entries.push(obj);
+            }
+            catch {
+                continue;
+            }
+        }
+        return entries.filter((e) => !archived.has(e.id));
+    }
+    async list(type) {
+        if (type) {
+            const lines = await this.readLines(TYPE_TO_FILE[type]);
+            const entries = this.parseFile(lines);
+            return entries.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+        }
+        // Read all JSONL files in parallel instead of sequentially
+        const files = Object.values(TYPE_TO_FILE);
+        const allLines = await Promise.all(files.map((file) => this.readLines(file)));
+        const all = [];
+        for (const lines of allLines) {
+            all.push(...this.parseFile(lines));
+        }
+        return all.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+    }
+    async add(entry) {
+        const full = {
+            ...entry,
+            id: generateId(),
+            createdAt: new Date().toISOString(),
+        };
+        const file = TYPE_TO_FILE[entry.type];
+        const p = this.path(file);
+        await ensureFile(p, { _schema: entry.type, _version: "1.0" });
+        await appendBrainLine(p, JSON.stringify(full));
+        // Fire-and-forget vector embedding — never blocks writes
+        if (this.vectorIndex.available) {
+            this.vectorIndex.addEntry(full.id, full.content).catch(() => { });
+        }
+        return full;
+    }
+    async get(id) {
+        const all = await this.list();
+        return all.find((e) => e.id === id) ?? null;
+    }
+    async delete(id) {
+        // Append-only: we do not support delete (would require rewrite). Return false so caller knows.
+        return false;
+    }
+    async search(query) {
+        let list = await this.list(query.type);
+        // Keyword filtering (existing behavior)
+        let keywordResults = list;
+        if (query.contentSubstring) {
+            const terms = query.contentSubstring
+                .toLowerCase()
+                .split(/\s+/)
+                .filter((t) => t.length > 2);
+            if (terms.length > 0) {
+                keywordResults = list.filter((e) => e.content && terms.some((term) => e.content.toLowerCase().includes(term)));
+            }
+        }
+        if (query.meta && Object.keys(query.meta).length > 0) {
+            keywordResults = keywordResults.filter((e) => {
+                if (!e.meta)
+                    return false;
+                return Object.entries(query.meta).every(([k, v]) => e.meta[k] === v);
+            });
+        }
+        // If vector index unavailable or no text query, return keyword-only
+        if (!this.vectorIndex.available || !query.contentSubstring) {
+            return keywordResults.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+        }
+        // Vector search
+        try {
+            const vectorHits = await this.vectorIndex.searchByText(query.contentSubstring, 20);
+            // Build lookup for all entries by id
+            const entryMap = new Map(list.map((e) => [e.id, e]));
+            // Merge via Reciprocal Rank Fusion
+            const merged = mergeRRF(keywordResults, vectorHits, entryMap);
+            return merged;
+        }
+        catch {
+            // Vector search failed — fall back to keyword-only
+            return keywordResults.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+        }
+    }
+}
+/**
+ * Reciprocal Rank Fusion: merges keyword + vector results without score normalization.
+ * RRF_score(entry) = Σ 1/(k + rank)  where k=60
+ */
+function mergeRRF(keywordResults, vectorHits, entryMap) {
+    const k = 60;
+    const scores = new Map();
+    // Keyword ranks
+    for (let i = 0; i < keywordResults.length; i++) {
+        const id = keywordResults[i].id;
+        scores.set(id, (scores.get(id) ?? 0) + 1 / (k + i + 1));
+    }
+    // Vector ranks
+    for (let i = 0; i < vectorHits.length; i++) {
+        const id = vectorHits[i].id;
+        scores.set(id, (scores.get(id) ?? 0) + 1 / (k + i + 1));
+    }
+    // Sort by fused score descending
+    const ranked = Array.from(scores.entries())
+        .sort((a, b) => b[1] - a[1])
+        .map(([id]) => entryMap.get(id))
+        .filter((e) => e !== undefined);
+    return ranked;
+}
+//# sourceMappingURL=file-backed.js.map