@runcore-sh/runcore 0.1.2

package/dist/memory/file-backed.js.map

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

package/dist/memory/index.d.ts

@@ -0,0 +1,7 @@
+export { InMemoryLongTermMemory } from "./long-term.js";
+export { FileSystemLongTermMemory } from "./file-backed.js";
+export { VectorIndex } from "./vector-index.js";
+export type { LongTermMemoryStore } from "./long-term.js";
+export { createWorkingMemory, updateWorkingMemory, formatWorkingMemoryForContext } from "./working.js";
+export { saveVisualMemory, hydrateVisualMemories, isVisualMemory, searchVisualMemories } from "./visual.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AACvG,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,6 @@
+export { InMemoryLongTermMemory } from "./long-term.js";
+export { FileSystemLongTermMemory } from "./file-backed.js";
+export { VectorIndex } from "./vector-index.js";
+export { createWorkingMemory, updateWorkingMemory, formatWorkingMemoryForContext } from "./working.js";
+export { saveVisualMemory, hydrateVisualMemories, isVisualMemory, searchVisualMemories } from "./visual.js";
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AACvG,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/memory/long-term.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Long-term memory: episodic, semantic, procedural (COALA-style).
+ * In-memory store; can be swapped for a persistent backend.
+ */
+import type { LongTermMemoryType, MemoryEntry } from "../types.js";
+export interface LongTermMemoryStore {
+    /** List all entries, optionally by type. */
+    list(type?: LongTermMemoryType): Promise<MemoryEntry[]>;
+    /** Add an entry; returns the created entry with id. */
+    add(entry: Omit<MemoryEntry, "id" | "createdAt">): Promise<MemoryEntry>;
+    /** Get by id. */
+    get(id: string): Promise<MemoryEntry | null>;
+    /** Delete by id. */
+    delete(id: string): Promise<boolean>;
+    /** Search by content or meta (simple substring/metadata filter). */
+    search(query: {
+        type?: LongTermMemoryType;
+        contentSubstring?: string;
+        meta?: Record<string, unknown>;
+    }): Promise<MemoryEntry[]>;
+}
+/**
+ * In-memory LTM implementation.
+ * Replace with a persistent store (e.g. vector DB for semantic search) as needed.
+ */
+export declare class InMemoryLongTermMemory implements LongTermMemoryStore {
+    private entries;
+    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=long-term.d.ts.map

package/dist/memory/long-term.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"long-term.d.ts","sourceRoot":"","sources":["../../src/memory/long-term.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,IAAI,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACxD,uDAAuD;IACvD,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACxE,iBAAiB;IACjB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC7C,oBAAoB;IACpB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,oEAAoE;IACpE,MAAM,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,kBAAkB,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CACjI;AAMD;;;GAGG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,OAAO,CAAC,OAAO,CAAuC;IAEhD,IAAI,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAMvD,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAUvE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAI5C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpC,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;CAsB3B"}

package/dist/memory/long-term.js

@@ -0,0 +1,58 @@
+/**
+ * Long-term memory: episodic, semantic, procedural (COALA-style).
+ * In-memory store; can be swapped for a persistent backend.
+ */
+function generateId() {
+    return `mem_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 9)}`;
+}
+/**
+ * In-memory LTM implementation.
+ * Replace with a persistent store (e.g. vector DB for semantic search) as needed.
+ */
+export class InMemoryLongTermMemory {
+    entries = new Map();
+    async list(type) {
+        let list = Array.from(this.entries.values());
+        if (type)
+            list = list.filter((e) => e.type === type);
+        return list.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(),
+        };
+        this.entries.set(full.id, full);
+        return full;
+    }
+    async get(id) {
+        return this.entries.get(id) ?? null;
+    }
+    async delete(id) {
+        return this.entries.delete(id);
+    }
+    async search(query) {
+        let list = Array.from(this.entries.values());
+        if (query.type)
+            list = list.filter((e) => e.type === query.type);
+        if (query.contentSubstring) {
+            const terms = query.contentSubstring
+                .toLowerCase()
+                .split(/\s+/)
+                .filter((t) => t.length > 2);
+            if (terms.length > 0) {
+                list = list.filter((e) => e.content && terms.some((term) => e.content.toLowerCase().includes(term)));
+            }
+        }
+        if (query.meta && Object.keys(query.meta).length > 0) {
+            list = list.filter((e) => {
+                if (!e.meta)
+                    return false;
+                return Object.entries(query.meta).every(([k, v]) => e.meta[k] === v);
+            });
+        }
+        return list.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+    }
+}
+//# sourceMappingURL=long-term.js.map

package/dist/memory/long-term.js.map

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

package/dist/memory/vector-index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Vector embedding index backed by Ollama (nomic-embed-text).
+ * Stores embeddings in brain/memory/embeddings.jsonl (append-only).
+ * Supports transparent encryption at rest when an encryption key is provided.
+ * Pure TypeScript cosine similarity — no external vector DB.
+ */
+export declare class VectorIndex {
+    private vectors;
+    private filePath;
+    available: boolean;
+    private lastAvailCheck;
+    private lastAvailResult;
+    private consecutiveFailures;
+    private circuitOpenUntil;
+    private static readonly AVAIL_CACHE_MS;
+    private static readonly CIRCUIT_BREAKER_FAILURES;
+    private static readonly CIRCUIT_BREAKER_COOLDOWN_MS;
+    constructor(basePath: string, _encryptionKey?: Buffer);
+    /** Load existing embeddings from disk; backfill missing entries in background. */
+    init(allEntries?: Array<{
+        id: string;
+        content: string;
+    }>): Promise<void>;
+    /** Check whether Ollama is reachable. Cached for 30s with circuit breaker. */
+    isAvailable(): Promise<boolean>;
+    private recordFailure;
+    /** Embed a single text via Ollama. Returns Float32Array (768-dim). */
+    embed(text: string): Promise<Float32Array>;
+    /** Embed a batch of texts. Returns array of Float32Array. */
+    private embedBatch;
+    /** Add a single entry: embed and persist. */
+    addEntry(id: string, content: string): Promise<void>;
+    /** Batch-embed entries missing vectors (migration/backfill). */
+    backfill(entries: Array<{
+        id: string;
+        content: string;
+    }>): Promise<void>;
+    /** Check if an entry has an embedding. */
+    has(id: string): boolean;
+    /** Search by pre-computed query vector. Returns ranked IDs with scores. */
+    search(queryVec: Float32Array, topN: number): Array<{
+        id: string;
+        score: number;
+    }>;
+    /** Convenience: embed query text then search. */
+    searchByText(query: string, topN: number): Promise<Array<{
+        id: string;
+        score: number;
+    }>>;
+    /** Load embeddings.jsonl into memory. */
+    private loadFromDisk;
+    /** Append a single embedding line to the JSONL file. */
+    private appendLine;
+}
+//# sourceMappingURL=vector-index.d.ts.map

package/dist/memory/vector-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-index.d.ts","sourceRoot":"","sources":["../../src/memory/vector-index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,QAAQ,CAAS;IACzB,SAAS,UAAS;IAGlB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAU;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAK;IACrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,2BAA2B,CAAiB;gBAExD,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM;IAMrD,kFAAkF;IAC5E,IAAI,CACR,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAClD,OAAO,CAAC,IAAI,CAAC;IAuBhB,8EAA8E;IACxE,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAmCrC,OAAO,CAAC,aAAa;IAQrB,sEAAsE;IAChE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAchD,6DAA6D;YAC/C,UAAU;IAcxB,6CAA6C;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1D,gEAAgE;IAC1D,QAAQ,CACZ,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAC9C,OAAO,CAAC,IAAI,CAAC;IA8BhB,0CAA0C;IAC1C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,2EAA2E;IAC3E,MAAM,CACJ,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,MAAM,GACX,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAYvC,iDAAiD;IAC3C,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAKhD,yCAAyC;YAC3B,YAAY;IAkB1B,wDAAwD;YAC1C,UAAU;CAGzB"}

package/dist/memory/vector-index.js

@@ -0,0 +1,207 @@
+/**
+ * Vector embedding index backed by Ollama (nomic-embed-text).
+ * Stores embeddings in brain/memory/embeddings.jsonl (append-only).
+ * Supports transparent encryption at rest when an encryption key is provided.
+ * Pure TypeScript cosine similarity — no external vector DB.
+ */
+import { join } from "node:path";
+import { createLogger } from "../utils/logger.js";
+import { readBrainLines, appendBrainLine } from "../lib/brain-io.js";
+const log = createLogger("vector-index");
+const OLLAMA_URL = "http://localhost:11434";
+const MODEL = "nomic-embed-text";
+const BATCH_SIZE = 10;
+const EMBEDDINGS_FILE = "embeddings.jsonl";
+export class VectorIndex {
+    vectors = new Map();
+    filePath;
+    available = false;
+    // Availability caching + circuit breaker
+    lastAvailCheck = 0;
+    lastAvailResult = false;
+    consecutiveFailures = 0;
+    circuitOpenUntil = 0;
+    static AVAIL_CACHE_MS = 30_000; // 30s cache
+    static CIRCUIT_BREAKER_FAILURES = 3;
+    static CIRCUIT_BREAKER_COOLDOWN_MS = 5 * 60 * 1000; // 5 min
+    constructor(basePath, _encryptionKey) {
+        // Encryption key param kept for API compat but encryption is now
+        // handled centrally by brain-io using the key-store.
+        this.filePath = join(basePath, EMBEDDINGS_FILE);
+    }
+    /** Load existing embeddings from disk; backfill missing entries in background. */
+    async init(allEntries) {
+        await this.loadFromDisk();
+        // Check Ollama reachability (1s timeout to avoid blocking startup)
+        this.available = await this.isAvailable();
+        if (!this.available) {
+            log.info("Ollama unreachable, running keyword-only");
+            return;
+        }
+        // Fire-and-forget backfill — never block startup for embedding generation
+        if (allEntries && allEntries.length > 0) {
+            const missing = allEntries.filter((e) => !this.vectors.has(e.id));
+            if (missing.length > 0) {
+                this.backfill(missing).catch((err) => {
+                    log.error("Background backfill failed", {
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                });
+            }
+        }
+    }
+    /** Check whether Ollama is reachable. Cached for 30s with circuit breaker. */
+    async isAvailable() {
+        const now = Date.now();
+        // Circuit breaker: if open, return false without checking
+        if (now < this.circuitOpenUntil)
+            return false;
+        // Return cached result if still fresh
+        if (now - this.lastAvailCheck < VectorIndex.AVAIL_CACHE_MS) {
+            return this.lastAvailResult;
+        }
+        try {
+            const res = await fetch(`${OLLAMA_URL}/api/tags`, {
+                signal: AbortSignal.timeout(1000),
+            });
+            this.lastAvailCheck = now;
+            this.lastAvailResult = res.ok;
+            if (res.ok) {
+                // Reset circuit breaker on success
+                if (this.consecutiveFailures > 0) {
+                    log.info("Ollama connectivity restored");
+                }
+                this.consecutiveFailures = 0;
+            }
+            else {
+                this.recordFailure(now);
+            }
+            return res.ok;
+        }
+        catch {
+            this.lastAvailCheck = now;
+            this.lastAvailResult = false;
+            this.recordFailure(now);
+            return false;
+        }
+    }
+    recordFailure(now) {
+        this.consecutiveFailures++;
+        if (this.consecutiveFailures >= VectorIndex.CIRCUIT_BREAKER_FAILURES) {
+            this.circuitOpenUntil = now + VectorIndex.CIRCUIT_BREAKER_COOLDOWN_MS;
+            log.warn(`Vector index circuit breaker open: ${this.consecutiveFailures} consecutive failures — disabled for ${VectorIndex.CIRCUIT_BREAKER_COOLDOWN_MS / 1000}s`);
+        }
+    }
+    /** Embed a single text via Ollama. Returns Float32Array (768-dim). */
+    async embed(text) {
+        const res = await fetch(`${OLLAMA_URL}/api/embed`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ model: MODEL, input: text }),
+            signal: AbortSignal.timeout(10000),
+        });
+        if (!res.ok) {
+            throw new Error(`Ollama embed failed: ${res.status}`);
+        }
+        const data = (await res.json());
+        return new Float32Array(data.embeddings[0]);
+    }
+    /** Embed a batch of texts. Returns array of Float32Array. */
+    async embedBatch(texts) {
+        const res = await fetch(`${OLLAMA_URL}/api/embed`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ model: MODEL, input: texts }),
+            signal: AbortSignal.timeout(30000),
+        });
+        if (!res.ok) {
+            throw new Error(`Ollama batch embed failed: ${res.status}`);
+        }
+        const data = (await res.json());
+        return data.embeddings.map((v) => new Float32Array(v));
+    }
+    /** Add a single entry: embed and persist. */
+    async addEntry(id, content) {
+        const vec = await this.embed(content);
+        this.vectors.set(id, vec);
+        await this.appendLine({ id, v: Array.from(vec) });
+    }
+    /** Batch-embed entries missing vectors (migration/backfill). */
+    async backfill(entries) {
+        const start = Date.now();
+        let count = 0;
+        for (let i = 0; i < entries.length; i += BATCH_SIZE) {
+            const batch = entries.slice(i, i + BATCH_SIZE);
+            const texts = batch.map((e) => e.content);
+            try {
+                const vecs = await this.embedBatch(texts);
+                for (let j = 0; j < batch.length; j++) {
+                    this.vectors.set(batch[j].id, vecs[j]);
+                    await appendBrainLine(this.filePath, JSON.stringify({ id: batch[j].id, v: Array.from(vecs[j]) }));
+                }
+                count += batch.length;
+            }
+            catch (err) {
+                log.error(`Backfill batch failed at offset ${i}`, { error: err instanceof Error ? err.message : String(err) });
+                break;
+            }
+        }
+        const elapsed = ((Date.now() - start) / 1000).toFixed(1);
+        log.info(`Backfilled ${count}/${entries.length} entries (${elapsed}s)`);
+    }
+    /** Check if an entry has an embedding. */
+    has(id) {
+        return this.vectors.has(id);
+    }
+    /** Search by pre-computed query vector. Returns ranked IDs with scores. */
+    search(queryVec, topN) {
+        const results = [];
+        for (const [id, vec] of this.vectors) {
+            const score = cosine(queryVec, vec);
+            results.push({ id, score });
+        }
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, topN);
+    }
+    /** Convenience: embed query text then search. */
+    async searchByText(query, topN) {
+        const queryVec = await this.embed(query);
+        return this.search(queryVec, topN);
+    }
+    /** Load embeddings.jsonl into memory. */
+    async loadFromDisk() {
+        const lines = await readBrainLines(this.filePath);
+        if (lines.length === 0)
+            return;
+        for (const line of lines) {
+            try {
+                const entry = JSON.parse(line);
+                if (entry.id && entry.v) {
+                    this.vectors.set(entry.id, new Float32Array(entry.v));
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        log.info(`Loaded ${this.vectors.size} embeddings from disk`);
+    }
+    /** Append a single embedding line to the JSONL file. */
+    async appendLine(entry) {
+        await appendBrainLine(this.filePath, JSON.stringify(entry));
+    }
+}
+/** Cosine similarity between two vectors. */
+function cosine(a, b) {
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+//# sourceMappingURL=vector-index.js.map

package/dist/memory/vector-index.js.map

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

package/dist/memory/visual.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Visual memory — persist images to FileManager + LTM with searchable descriptions.
+ * On retrieval, re-injects actual image data into LLM context as multimodal blocks.
+ */
+import type { MemoryEntry } from "../types.js";
+import type { ProviderName } from "../llm/providers/types.js";
+import type { FileEntry } from "../files/types.js";
+export interface VisualMemorySaveOptions {
+    imageData: string;
+    mimeType: string;
+    userContext: string;
+    provider: ProviderName;
+    model?: string;
+    maxImageBytes?: number;
+}
+export interface VisualMemorySaveResult {
+    ok: boolean;
+    fileEntry?: FileEntry;
+    description?: string;
+    error?: string;
+}
+export interface HydratedVisualMemory {
+    entry: MemoryEntry;
+    description: string;
+    dataUri: string;
+    sizeBytes: number;
+}
+/** Check if a memory entry is a visual memory (has fileId + source marker). */
+export declare function isVisualMemory(entry: MemoryEntry): boolean;
+/**
+ * Persist an image to FileManager and create a searchable episodic memory.
+ * Fire-and-forget safe — never throws, returns { ok: false } on failure.
+ */
+export declare function saveVisualMemory(opts: VisualMemorySaveOptions): Promise<VisualMemorySaveResult>;
+/**
+ * Re-hydrate visual memory entries with actual image data for LLM injection.
+ * Entries should already be relevance-sorted (from LTM search).
+ * Returns empty array on any failure — never throws.
+ */
+export declare function hydrateVisualMemories(entries: MemoryEntry[], maxImages?: number): Promise<HydratedVisualMemory[]>;
+/**
+ * Search LTM specifically for visual memory entries.
+ * Used as a fallback when the generic Brain.retrieve() didn't surface any
+ * visual memories (they got crowded out by other episodic entries).
+ *
+ * Two-pass strategy:
+ *  1. Try keyword match (user query) + meta filter — finds visuals relevant to what the user asked
+ *  2. If nothing, fetch ALL visual memories sorted by recency — ensures we always surface something
+ *
+ * Returns entries sorted by recency (newest first).
+ */
+export declare function searchVisualMemories(query: string, max?: number): Promise<MemoryEntry[]>;
+//# sourceMappingURL=visual.d.ts.map

package/dist/memory/visual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual.d.ts","sourceRoot":"","sources":["../../src/memory/visual.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAQnD,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAwBD,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAK1D;AAID;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,sBAAsB,CAAC,CA4EjC;AAoDD;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,WAAW,EAAE,EACtB,SAAS,GAAE,MAAU,GACpB,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAmCjC;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,MAAU,GACd,OAAO,CAAC,WAAW,EAAE,CAAC,CAyBxB"}