agim-cli 1.1.11 → 1.2.1

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

@@ -0,0 +1,47 @@
+export type BackendName = 'off' | 'local' | 'openai';
+export interface EmbeddingBackend {
+    readonly name: BackendName;
+    readonly ready: boolean;
+    readonly dims: number;
+    readonly modelId: string;
+    /** Generate embeddings for a batch of texts. Returns same-length array. */
+    embed(texts: string[]): Promise<Float32Array[]>;
+    /** Describe current state for the status endpoint. */
+    describe(): BackendStatus;
+}
+export interface BackendStatus {
+    backend: BackendName;
+    ready: boolean;
+    dims: number;
+    modelId: string;
+    lastError: string | null;
+    /** Local-only: model files present on disk. ready may still be false if
+     *  the in-process pipeline hasn't loaded them yet (post-restart warmup). */
+    downloaded?: boolean;
+    /** Backend-specific extra info (model file size, baseUrl, etc.) */
+    detail: Record<string, unknown>;
+}
+export declare function getActiveBackend(): EmbeddingBackend;
+/** Reset all backend singletons. Used by tests + when env changes via /api/env. */
+export declare function _resetVectorBackendsForTests(): void;
+export declare function getHybridWeight(): number;
+export declare function getBatchSize(): number;
+/** Triggers local-backend download. No-op for off / openai. */
+export declare function triggerLocalDownload(): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+/** Calls test() for openai; ensureReady() for local. */
+export declare function testActiveBackend(): Promise<{
+    ok: boolean;
+    dims?: number;
+    latencyMs?: number;
+    error?: string;
+}>;
+/** Float32Array <-> Buffer round-trip helpers for SQLite BLOB columns. */
+export declare function float32ToBuffer(arr: Float32Array): Buffer;
+export declare function bufferToFloat32(buf: Buffer): Float32Array;
+/** Cosine similarity for two normalized (unit-length) Float32Arrays.
+ *  All our backends normalize by default; this is just a dot product. */
+export declare function cosineSim(a: Float32Array, b: Float32Array): number;
+//# sourceMappingURL=memory-vector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-vector.d.ts","sourceRoot":"","sources":["../../src/core/memory-vector.ts"],"names":[],"mappings":"AA8BA,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,2EAA2E;IAC3E,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IAC/C,sDAAsD;IACtD,QAAQ,IAAI,aAAa,CAAA;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,CAAA;IACpB,KAAK,EAAE,OAAO,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB;gFAC4E;IAC5E,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAgSD,wBAAgB,gBAAgB,IAAI,gBAAgB,CAqBnD;AAED,mFAAmF;AACnF,wBAAgB,4BAA4B,IAAI,IAAI,CAGnD;AAED,wBAAgB,eAAe,IAAI,MAAM,CAIxC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAIrC;AAID,+DAA+D;AAC/D,wBAAsB,oBAAoB,IAAI,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CASrF;AAED,wDAAwD;AACxD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAerH;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAEzD;AACD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAOzD;AAED;yEACyE;AACzE,wBAAgB,SAAS,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAKlE"}

package/dist/core/memory-vector.js

@@ -0,0 +1,386 @@
+// memory-vector — embedding backend abstraction for the long-term memory
+// hybrid retrieval pipeline.
+//
+// Three backends, all behind one tiny interface:
+//
+//   OffBackend       — default. `ready=false`, every call no-ops. Zero
+//                      import cost; @xenova/transformers stays unloaded.
+//   LocalBgeBackend  — lazy-loads @xenova/transformers + a Hugging Face
+//                      model (default Xenova/bge-base-zh-v1.5). First use
+//                      triggers a ~250MB CDN download; afterwards stays in
+//                      memory + CPU inference (~50ms/batch).
+//   OpenAIBackend    — POSTs to {baseUrl}/embeddings; compatible with any
+//                      OpenAI-format service (Azure, Ollama, 智谱, etc).
+//                      All requests wrapped in AbortSignal.timeout to never
+//                      block the page when the network is bad.
+//
+// The active backend is selected by IMHUB_MEMORY_VECTOR_BACKEND
+// (off | local | openai). Status / download / test endpoints in
+// web/server.ts read from `getActiveBackend()` to drive the UI.
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { logger as rootLogger } from './logger.js';
+import { AGIM_HOME } from './agim-paths.js';
+const log = rootLogger.child({ component: 'memory-vector' });
+const HTTP_TIMEOUT_MS = 10_000;
+const BATCH_TIMEOUT_MS = 30_000;
+// ─── OffBackend ──────────────────────────────────────────────────────
+class OffBackend {
+    name = 'off';
+    ready = false;
+    dims = 0;
+    modelId = '';
+    async embed() { return []; }
+    describe() {
+        return {
+            backend: 'off', ready: false, dims: 0, modelId: '',
+            lastError: null,
+            detail: { hint: 'set IMHUB_MEMORY_VECTOR_BACKEND=local|openai to enable' },
+        };
+    }
+}
+class LocalBgeBackend {
+    name = 'local';
+    modelId;
+    dims = 0;
+    // populated after first successful pipeline load
+    extractor = null;
+    loadPromise = null;
+    lastError = null;
+    // Per-process download progress (UI polls /api/memory/vector/status).
+    progress = {
+        phase: 'idle', filesDone: 0, filesTotal: 0, bytesDone: 0, bytesTotal: 0,
+        startedAt: null, finishedAt: null, error: null,
+    };
+    constructor(modelId) {
+        this.modelId = modelId;
+        // Auto-warm: if the model is already on disk from a previous run,
+        // load it in the background so `ready` flips to true within seconds.
+        // Without this, the backend stays "not ready" after every restart
+        // until the user clicks 📥 download / 🧪 test, AND saveFact silently
+        // skips embedding writes in the meantime.
+        if (this.isDownloaded()) {
+            void this.ensureReady().catch((err) => {
+                log.warn({
+                    event: 'vector.local.autowarm_failed', modelId: this.modelId,
+                    err: err instanceof Error ? err.message : String(err),
+                });
+            });
+        }
+    }
+    /** Cheap check: are model files on disk? Used to flip the UI's
+     *  "downloaded but loading" hint and to gate auto-warm. */
+    isDownloaded() {
+        try {
+            const onnx = join(AGIM_HOME, 'cache', 'transformers', this.modelId, 'onnx', 'model_quantized.onnx');
+            return existsSync(onnx);
+        }
+        catch {
+            return false;
+        }
+    }
+    get ready() {
+        return this.extractor !== null && this.dims > 0;
+    }
+    /**
+     * Idempotent: returns the same promise on concurrent calls. Triggers the
+     * @xenova/transformers dynamic import + model download (CDN) + pipeline
+     * load. UI calls /api/memory/vector/download which calls this with
+     * forceDownload=true on the very first run.
+     */
+    async ensureReady() {
+        if (this.ready)
+            return;
+        if (this.loadPromise)
+            return this.loadPromise;
+        this.loadPromise = this._load().catch((err) => {
+            this.lastError = err instanceof Error ? err.message : String(err);
+            this.progress.phase = 'failed';
+            this.progress.error = this.lastError;
+            this.progress.finishedAt = Date.now();
+            // Reset so a follow-up download attempt can retry.
+            this.loadPromise = null;
+            throw err;
+        });
+        return this.loadPromise;
+    }
+    async _load() {
+        log.info({ event: 'vector.local.load_start', modelId: this.modelId });
+        this.progress.phase = 'downloading';
+        this.progress.startedAt = Date.now();
+        this.progress.error = null;
+        // Dynamic import so the runtime cost is only paid when the backend is on.
+        // @xenova/transformers is in optionalDependencies (skipped on CI install
+        // to avoid a large ONNX postinstall hang); ts-ignore needed so tsc
+        // doesn't error when the module isn't on disk at build time.
+        // @ts-ignore -- optional dep, may not be installed at build time
+        const tf = await import('@xenova/transformers');
+        // Cache to ~/.agim/cache/transformers so we don't sprinkle files all
+        // over $HOME. allowLocalModels stays default (true) — cached models
+        // load offline after first download.
+        try {
+            tf.env.cacheDir = join(AGIM_HOME, 'cache', 'transformers');
+        }
+        catch (e) {
+            log.debug({ event: 'vector.local.cachedir_set_failed', err: String(e) });
+        }
+        // progress_callback fires for each file: { status, name, file, loaded, total, progress }
+        const progressCallback = (info) => {
+            try {
+                if (info.status === 'progress') {
+                    this.progress.bytesTotal = Math.max(this.progress.bytesTotal, Number(info.total) || 0);
+                    this.progress.bytesDone = Number(info.loaded) || this.progress.bytesDone;
+                }
+                else if (info.status === 'done') {
+                    this.progress.filesDone += 1;
+                }
+                else if (info.status === 'initiate') {
+                    this.progress.filesTotal += 1;
+                }
+            }
+            catch { /* noop */ }
+        };
+        const extractor = await tf.pipeline('feature-extraction', this.modelId, {
+            quantized: true,
+            progress_callback: progressCallback,
+        });
+        // Probe dims with a 1-char input.
+        const probeOutput = await extractor('hi', { pooling: 'mean', normalize: true });
+        const data = probeOutput.data;
+        if (!data || data.length === 0)
+            throw new Error('embedding model returned empty output');
+        this.dims = data.length;
+        this.extractor = extractor;
+        this.progress.phase = 'ready';
+        this.progress.finishedAt = Date.now();
+        log.info({ event: 'vector.local.ready', dims: this.dims, modelId: this.modelId });
+    }
+    async embed(texts) {
+        if (!this.ready) {
+            // Don't auto-trigger download from embed() — user has to opt in via
+            // /api/memory/vector/download. Silent no-op keeps writes fast.
+            return texts.map(() => new Float32Array(0));
+        }
+        const out = [];
+        for (const t of texts) {
+            const trimmed = t.length > 4000 ? t.slice(0, 4000) : t;
+            const result = await this.extractor(trimmed, { pooling: 'mean', normalize: true });
+            out.push(new Float32Array(result.data));
+        }
+        return out;
+    }
+    getProgress() { return { ...this.progress }; }
+    describe() {
+        return {
+            backend: 'local', ready: this.ready, dims: this.dims,
+            modelId: this.modelId,
+            lastError: this.lastError,
+            downloaded: this.isDownloaded(),
+            detail: { progress: this.getProgress() },
+        };
+    }
+}
+// ─── OpenAIBackend ───────────────────────────────────────────────────
+class OpenAIBackend {
+    name = 'openai';
+    modelId;
+    baseUrl;
+    apiKey;
+    dims = 0; // probed on first successful embed; 0 until then
+    ready = false; // becomes true after first successful embed (key + URL work)
+    lastError = null;
+    constructor(baseUrl, modelId, apiKey) {
+        this.baseUrl = baseUrl.replace(/\/$/, '');
+        this.modelId = modelId;
+        this.apiKey = apiKey;
+    }
+    async embed(texts) {
+        if (!this.apiKey) {
+            this.lastError = 'API key not configured';
+            return texts.map(() => new Float32Array(0));
+        }
+        if (texts.length === 0)
+            return [];
+        try {
+            const ctrl = new AbortController();
+            const t = setTimeout(() => ctrl.abort(), BATCH_TIMEOUT_MS);
+            const res = await fetch(`${this.baseUrl}/embeddings`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify({ model: this.modelId, input: texts }),
+                signal: ctrl.signal,
+            }).finally(() => clearTimeout(t));
+            if (!res.ok) {
+                const body = await res.text().catch(() => '');
+                throw new Error(`HTTP ${res.status}: ${body.slice(0, 200)}`);
+            }
+            const json = await res.json();
+            if (!Array.isArray(json.data))
+                throw new Error('response missing data[]');
+            const out = json.data.map((d) => new Float32Array(d.embedding));
+            if (out.length > 0 && out[0].length > 0) {
+                this.dims = out[0].length;
+                this.ready = true;
+                this.lastError = null;
+            }
+            return out;
+        }
+        catch (err) {
+            this.lastError = err instanceof Error ? err.message : String(err);
+            this.ready = false;
+            log.warn({ event: 'vector.openai.embed_failed', err: this.lastError });
+            return texts.map(() => new Float32Array(0));
+        }
+    }
+    /** Lightweight probe used by /api/memory/vector/test. */
+    async test() {
+        const start = Date.now();
+        try {
+            const ctrl = new AbortController();
+            const t = setTimeout(() => ctrl.abort(), HTTP_TIMEOUT_MS);
+            const res = await fetch(`${this.baseUrl}/embeddings`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify({ model: this.modelId, input: ['ping'] }),
+                signal: ctrl.signal,
+            }).finally(() => clearTimeout(t));
+            const latencyMs = Date.now() - start;
+            if (!res.ok) {
+                const body = await res.text().catch(() => '');
+                return { ok: false, error: `HTTP ${res.status}: ${body.slice(0, 200)}`, latencyMs };
+            }
+            const json = await res.json();
+            const emb = json.data?.[0]?.embedding;
+            if (!Array.isArray(emb))
+                return { ok: false, error: 'response missing embedding', latencyMs };
+            this.dims = emb.length;
+            this.ready = true;
+            this.lastError = null;
+            return { ok: true, dims: emb.length, latencyMs };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            const isTimeout = /aborted|timeout/i.test(msg);
+            return { ok: false, error: isTimeout ? `timed out after ${HTTP_TIMEOUT_MS}ms` : msg, latencyMs: Date.now() - start };
+        }
+    }
+    describe() {
+        return {
+            backend: 'openai', ready: this.ready, dims: this.dims,
+            modelId: this.modelId, lastError: this.lastError,
+            detail: { baseUrl: this.baseUrl, hasKey: !!this.apiKey },
+        };
+    }
+}
+// ─── factory + singletons ────────────────────────────────────────────
+const off = new OffBackend();
+let localSingleton = null;
+let openaiSingleton = null;
+function readBackendName() {
+    const v = (process.env.IMHUB_MEMORY_VECTOR_BACKEND || 'off').toLowerCase();
+    return v === 'local' || v === 'openai' ? v : 'off';
+}
+export function getActiveBackend() {
+    const which = readBackendName();
+    if (which === 'off')
+        return off;
+    if (which === 'local') {
+        const modelId = process.env.IMHUB_MEMORY_VECTOR_LOCAL_MODEL || 'Xenova/bge-base-zh-v1.5';
+        if (!localSingleton || localSingleton.modelId !== modelId) {
+            localSingleton = new LocalBgeBackend(modelId);
+        }
+        return localSingleton;
+    }
+    // openai
+    const baseUrl = process.env.IMHUB_MEMORY_VECTOR_OPENAI_BASE_URL || 'https://api.openai.com/v1';
+    const modelId = process.env.IMHUB_MEMORY_VECTOR_OPENAI_MODEL || 'text-embedding-3-small';
+    const apiKey = process.env.IMHUB_MEMORY_VECTOR_OPENAI_API_KEY || '';
+    if (!openaiSingleton
+        || openaiSingleton.baseUrl !== baseUrl.replace(/\/$/, '')
+        || openaiSingleton.modelId !== modelId
+        || openaiSingleton.apiKey !== apiKey) {
+        openaiSingleton = new OpenAIBackend(baseUrl, modelId, apiKey);
+    }
+    return openaiSingleton;
+}
+/** Reset all backend singletons. Used by tests + when env changes via /api/env. */
+export function _resetVectorBackendsForTests() {
+    localSingleton = null;
+    openaiSingleton = null;
+}
+export function getHybridWeight() {
+    const raw = parseFloat(process.env.IMHUB_MEMORY_VECTOR_HYBRID_WEIGHT || '0.5');
+    if (!Number.isFinite(raw))
+        return 0.5;
+    return Math.max(0, Math.min(1, raw));
+}
+export function getBatchSize() {
+    const raw = parseInt(process.env.IMHUB_MEMORY_VECTOR_BATCH_SIZE || '32', 10);
+    if (!Number.isFinite(raw) || raw < 1)
+        return 32;
+    return Math.min(raw, 128);
+}
+// ─── helpers exposed for memory.ts + endpoints ───────────────────────
+/** Triggers local-backend download. No-op for off / openai. */
+export async function triggerLocalDownload() {
+    const b = getActiveBackend();
+    if (b.name !== 'local')
+        return { ok: false, error: `backend is ${b.name}, not local` };
+    try {
+        await b.ensureReady();
+        return { ok: true };
+    }
+    catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+/** Calls test() for openai; ensureReady() for local. */
+export async function testActiveBackend() {
+    const b = getActiveBackend();
+    if (b.name === 'off')
+        return { ok: false, error: 'backend is off' };
+    if (b.name === 'openai')
+        return b.test();
+    // local
+    try {
+        const start = Date.now();
+        await b.ensureReady();
+        const vec = await b.embed(['ping']);
+        const latencyMs = Date.now() - start;
+        if (vec[0]?.length > 0)
+            return { ok: true, dims: vec[0].length, latencyMs };
+        return { ok: false, error: 'embed returned empty vector', latencyMs };
+    }
+    catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+/** Float32Array <-> Buffer round-trip helpers for SQLite BLOB columns. */
+export function float32ToBuffer(arr) {
+    return Buffer.from(arr.buffer, arr.byteOffset, arr.byteLength);
+}
+export function bufferToFloat32(buf) {
+    // Float32Array requires the underlying ArrayBuffer offset to be 4-byte
+    // aligned. better-sqlite3 returns BLOBs from a shared pool with arbitrary
+    // byteOffset, so we copy into a fresh ArrayBuffer first.
+    const copy = new ArrayBuffer(buf.byteLength);
+    new Uint8Array(copy).set(buf);
+    return new Float32Array(copy);
+}
+/** Cosine similarity for two normalized (unit-length) Float32Arrays.
+ *  All our backends normalize by default; this is just a dot product. */
+export function cosineSim(a, b) {
+    if (a.length !== b.length || a.length === 0)
+        return 0;
+    let s = 0;
+    for (let i = 0; i < a.length; i++)
+        s += a[i] * b[i];
+    return s;
+}
+//# sourceMappingURL=memory-vector.js.map

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

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

package/dist/core/memory.d.ts

@@ -0,0 +1,140 @@
+export type FactCategory = 'fact' | 'preference' | 'goal' | 'history' | 'profile';
+export interface Fact {
+    id: number;
+    user_key: string;
+    what: string;
+    who: string;
+    when_text: string;
+    where_label: string;
+    why: string;
+    category: FactCategory;
+    confidence: number;
+    last_referenced_at: number;
+    source: string;
+    created_at: number;
+}
+export interface SaveFactInput {
+    user_key: string;
+    what: string;
+    who?: string;
+    when_text?: string;
+    where_label?: string;
+    why?: string;
+    category?: FactCategory;
+    confidence?: number;
+    source?: string;
+}
+export declare function userKey(platform: string, userId: string): string;
+export declare function saveFact(input: SaveFactInput): number | null;
+export declare function deleteFact(id: number, user_key: string): boolean;
+export interface QueryOpts {
+    user_key: string;
+    query?: string;
+    category?: FactCategory;
+    k?: number;
+}
+export interface QueryResult {
+    facts: Fact[];
+    matched: number;
+}
+/**
+ * Hybrid retrieval. v1.5 first cut uses FTS5 + recency boost; v1.6 will
+ * layer in sqlite-vss dense vectors and rerank.
+ *
+ *  - Empty query → most-recent N facts.
+ *  - With query → FTS5 MATCH, sorted by FTS5's bm25() with a recency tie-
+ *    breaker (newer first).
+ *
+ * Side effect: bumps `last_referenced_at` for returned rows so weak /
+ * unused facts can be retired by future consolidation.
+ */
+export declare function queryFacts(opts: QueryOpts): QueryResult;
+/**
+ * v1.6 — async hybrid retrieval. When a vector backend is ready, run FTS5
+ * + vector top-K in parallel, fuse with reciprocal-rank-fusion, and return
+ * the merged top-K. Falls back to plain queryFacts when backend is off or
+ * the embedding model isn't loaded.
+ *
+ * Use this from memory-rpc.handleMemoryOp('query') so MCP callers get
+ * better recall automatically without changing the call site.
+ */
+export declare function queryFactsHybrid(opts: QueryOpts): Promise<QueryResult>;
+/** v1.6 — backfill embeddings for facts that don't have one (e.g. existed
+ *  before vector backend was enabled). Returns counts; safe to call again.
+ *  Stops early on backend errors (returns partial). */
+export declare function backfillEmbeddings(opts: {
+    user_key?: string;
+    batchSize?: number;
+    maxRows?: number;
+}): Promise<{
+    processed: number;
+    succeeded: number;
+    failed: number;
+    errored?: string;
+}>;
+export interface VectorCoverage {
+    total: number;
+    withEmbedding: number;
+    withDifferentModel: number;
+}
+export declare function getVectorCoverage(user_key?: string): VectorCoverage;
+/** Clear all embedding fields for a user (or all). Useful when switching
+ *  backends — embeddings from different models can't be compared. */
+export declare function clearEmbeddings(user_key?: string): number;
+export declare function listRecentFacts(user_key: string, limit?: number): Fact[];
+export declare function countFacts(user_key: string): number;
+export interface PersonaProfile {
+    user_key: string;
+    summary: string;
+    updated_at: number;
+}
+export declare function getPersona(user_key: string): PersonaProfile | null;
+export declare function upsertPersona(user_key: string, summary: string): boolean;
+export interface UserSummary {
+    user_key: string;
+    fact_count: number;
+    oldest_fact_at: number | null;
+    newest_fact_at: number | null;
+    has_persona: boolean;
+    persona_updated_at: number | null;
+}
+/** Enumerate every user_key the memory system has touched, with quick stats.
+ *  Used by /api/memory/users to populate the admin selector. */
+export declare function listUsers(): UserSummary[];
+export interface FactPage {
+    total: number;
+    limit: number;
+    offset: number;
+    facts: Fact[];
+}
+/** Paged fact listing with optional filters. Mirrors queryFacts but adds
+ *  offset + total count for table pagination. */
+export declare function listFacts(opts: {
+    user_key: string;
+    query?: string;
+    category?: FactCategory;
+    limit?: number;
+    offset?: number;
+}): FactPage;
+/** Bulk delete by user + optional filters. Returns row count actually deleted.
+ *  Defaults are intentionally inert ({user_key} alone deletes ALL facts for
+ *  that user) — caller must explicitly opt in to clear-all by passing
+ *  confirm_clear: true. Otherwise needs at least one filter. */
+export declare function bulkDeleteFacts(opts: {
+    user_key: string;
+    ids?: number[];
+    category?: FactCategory;
+    max_confidence?: number;
+    confirm_clear?: boolean;
+}): number;
+export declare function deletePersona(user_key: string): boolean;
+/** Full export: persona + all facts for one user, JSON-safe shape. */
+export declare function exportUserMemory(user_key: string): {
+    user_key: string;
+    persona: PersonaProfile | null;
+    facts: Fact[];
+    exported_at: string;
+};
+export declare function closeMemoryDb(): void;
+export declare const MEMORY_DB_PATH: string;
+//# sourceMappingURL=memory.d.ts.map

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

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