@aman_asmuei/amem 0.19.0 → 0.20.0

package/dist/ann.d.ts

@@ -1,26 +0,0 @@
-export interface VectorSearchResult {
-    id: string;
-    similarity: number;
-}
-export declare class VectorIndex {
-    private dims;
-    private hnsw;
-    private labelToId;
-    private idToLabel;
-    private nextLabel;
-    private deletedLabels;
-    private capacity;
-    private entries;
-    constructor(dimensions: number);
-    private _initHnsw;
-    private _ensureCapacity;
-    add(id: string, embedding: Float32Array): void;
-    remove(id: string): void;
-    has(id: string): boolean;
-    size(): number;
-    search(query: Float32Array, k: number, minSimilarity?: number): VectorSearchResult[];
-    buildFrom(entries: Array<{
-        id: string;
-        embedding: Float32Array;
-    }>): void;
-}

package/dist/ann.js

@@ -1,155 +0,0 @@
-import { createRequire } from "node:module";
-import { cosineSimilarity } from "./embeddings.js";
-// Attempt to load hnswlib-node using createRequire (ESM-safe)
-let HierarchicalNSW = null;
-try {
-    const require = createRequire(import.meta.url);
-    const hnswlib = require("hnswlib-node");
-    HierarchicalNSW = hnswlib.HierarchicalNSW;
-}
-catch {
-    // hnswlib-node not available, will fall back to brute-force
-}
-export class VectorIndex {
-    dims;
-    // HNSW state
-    hnsw = null;
-    labelToId = new Map();
-    idToLabel = new Map();
-    nextLabel = 0;
-    deletedLabels = new Set();
-    capacity = 0;
-    // Brute-force fallback state
-    entries = new Map();
-    constructor(dimensions) {
-        this.dims = dimensions;
-        if (HierarchicalNSW) {
-            this._initHnsw(200);
-        }
-    }
-    _initHnsw(initialCapacity) {
-        const index = new HierarchicalNSW("cosine", this.dims);
-        index.initIndex(initialCapacity, 16, 200, 100);
-        this.hnsw = index;
-        this.capacity = initialCapacity;
-    }
-    _ensureCapacity(needed) {
-        if (needed > this.capacity) {
-            const newCapacity = Math.max(needed, this.capacity * 2);
-            this.hnsw.resizeIndex(newCapacity);
-            this.capacity = newCapacity;
-        }
-    }
-    add(id, embedding) {
-        if (this.hnsw) {
-            // If id already exists, mark old label deleted and reuse a new one
-            if (this.idToLabel.has(id)) {
-                const oldLabel = this.idToLabel.get(id);
-                try {
-                    this.hnsw.markDelete(oldLabel);
-                }
-                catch {
-                    // ignore if already deleted
-                }
-                this.deletedLabels.add(oldLabel);
-                this.labelToId.delete(oldLabel);
-            }
-            const label = this.nextLabel++;
-            this._ensureCapacity(label + 1);
-            this.hnsw.addPoint(Array.from(embedding), label);
-            this.labelToId.set(label, id);
-            this.idToLabel.set(id, label);
-        }
-        else {
-            this.entries.set(id, embedding);
-        }
-    }
-    remove(id) {
-        if (this.hnsw) {
-            if (!this.idToLabel.has(id))
-                return;
-            const label = this.idToLabel.get(id);
-            try {
-                this.hnsw.markDelete(label);
-            }
-            catch {
-                // ignore
-            }
-            this.deletedLabels.add(label);
-            this.labelToId.delete(label);
-            this.idToLabel.delete(id);
-        }
-        else {
-            this.entries.delete(id);
-        }
-    }
-    has(id) {
-        if (this.hnsw) {
-            return this.idToLabel.has(id);
-        }
-        return this.entries.has(id);
-    }
-    size() {
-        if (this.hnsw) {
-            return this.idToLabel.size;
-        }
-        return this.entries.size;
-    }
-    search(query, k, minSimilarity = 0.0) {
-        if (this.hnsw) {
-            const liveCount = this.idToLabel.size;
-            if (liveCount === 0)
-                return [];
-            // Over-request to compensate for tombstoned entries that HNSW may return
-            const totalLabels = this.nextLabel;
-            const actualK = Math.min(Math.max(k * 2, k + 10), totalLabels);
-            const { neighbors, distances } = this.hnsw.searchKnn(Array.from(query), actualK);
-            const results = [];
-            for (let i = 0; i < neighbors.length; i++) {
-                const label = neighbors[i];
-                const id = this.labelToId.get(label);
-                if (id === undefined)
-                    continue; // deleted tombstone
-                const similarity = 1 - distances[i];
-                if (similarity >= minSimilarity) {
-                    results.push({ id, similarity });
-                }
-            }
-            results.sort((a, b) => b.similarity - a.similarity);
-            return results.slice(0, k);
-        }
-        // Brute-force fallback
-        const results = [];
-        for (const [id, embedding] of this.entries) {
-            const similarity = cosineSimilarity(query, embedding);
-            if (similarity >= minSimilarity) {
-                results.push({ id, similarity });
-            }
-        }
-        results.sort((a, b) => b.similarity - a.similarity);
-        return results.slice(0, k);
-    }
-    buildFrom(entries) {
-        if (this.hnsw) {
-            // Re-init to clear tombstones and reset state
-            this._initHnsw(Math.max(entries.length, 200));
-            this.labelToId.clear();
-            this.idToLabel.clear();
-            this.nextLabel = 0;
-            this.deletedLabels.clear();
-            for (const entry of entries) {
-                const label = this.nextLabel++;
-                this.hnsw.addPoint(Array.from(entry.embedding), label);
-                this.labelToId.set(label, entry.id);
-                this.idToLabel.set(entry.id, label);
-            }
-        }
-        else {
-            this.entries.clear();
-            for (const entry of entries) {
-                this.entries.set(entry.id, entry.embedding);
-            }
-        }
-    }
-}
-//# sourceMappingURL=ann.js.map

package/dist/ann.js.map

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

package/dist/auto-relate.d.ts

@@ -1,14 +0,0 @@
-import type { AmemDatabase } from "./database.js";
-export interface AutoRelateOptions {
-    minSimilarity?: number;
-    maxRelations?: number;
-    maxCandidates?: number;
-}
-export interface AutoRelateResult {
-    created: number;
-    relations: Array<{
-        toId: string;
-        similarity: number;
-    }>;
-}
-export declare function autoRelateMemory(db: AmemDatabase, newMemoryId: string, options?: AutoRelateOptions): AutoRelateResult;

package/dist/auto-relate.js

@@ -1,47 +0,0 @@
-import { cosineSimilarity } from "./embeddings.js";
-export function autoRelateMemory(db, newMemoryId, options) {
-    const minSimilarity = options?.minSimilarity ?? 0.6;
-    const maxRelations = options?.maxRelations ?? 3;
-    const maxCandidates = options?.maxCandidates ?? 200;
-    const empty = { created: 0, relations: [] };
-    // 1. Get the new memory, return early if no embedding
-    const newMemory = db.getById(newMemoryId);
-    if (!newMemory?.embedding)
-        return empty;
-    // 2. Get recent memories with embeddings (up to maxCandidates)
-    const candidates = db.getRecentWithEmbeddings(maxCandidates);
-    // 3. Score each by cosine similarity, filter >= minSimilarity and < 0.95 (skip near-dupes)
-    const scored = [];
-    for (const mem of candidates) {
-        if (mem.id === newMemoryId)
-            continue;
-        if (!mem.embedding)
-            continue;
-        const sim = cosineSimilarity(newMemory.embedding, mem.embedding);
-        if (sim >= minSimilarity && sim < 0.95) {
-            scored.push({ id: mem.id, similarity: sim });
-        }
-    }
-    // 4. Sort descending, take top maxRelations
-    scored.sort((a, b) => b.similarity - a.similarity);
-    const top = scored.slice(0, maxRelations);
-    // 5. Check existing relations to avoid duplicates, then create edges
-    const existingRelations = db.getRelations(newMemoryId);
-    const existingTargets = new Set(existingRelations.map((r) => (r.fromId === newMemoryId ? r.toId : r.fromId)));
-    const created = [];
-    for (const candidate of top) {
-        if (existingTargets.has(candidate.id))
-            continue;
-        // 6. Create "related_to" edges with similarity as strength
-        try {
-            db.addRelation(newMemoryId, candidate.id, "related_to", candidate.similarity);
-            created.push({ toId: candidate.id, similarity: candidate.similarity });
-        }
-        catch {
-            // UNIQUE constraint may fire — safe to ignore
-        }
-    }
-    // 7. Return count and details
-    return { created: created.length, relations: created };
-}
-//# sourceMappingURL=auto-relate.js.map

package/dist/auto-relate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"auto-relate.js","sourceRoot":"","sources":["../src/auto-relate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAanD,MAAM,UAAU,gBAAgB,CAC9B,EAAgB,EAChB,WAAmB,EACnB,OAA2B;IAE3B,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,GAAG,CAAC;IACpD,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,GAAG,CAAC;IAEpD,MAAM,KAAK,GAAqB,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAE9D,sDAAsD;IACtD,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1C,IAAI,CAAC,SAAS,EAAE,SAAS;QAAE,OAAO,KAAK,CAAC;IAExC,+DAA+D;IAC/D,MAAM,UAAU,GAAG,EAAE,CAAC,uBAAuB,CAAC,aAAa,CAAC,CAAC;IAE7D,2FAA2F;IAC3F,MAAM,MAAM,GAA8C,EAAE,CAAC;IAC7D,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,IAAI,GAAG,CAAC,EAAE,KAAK,WAAW;YAAE,SAAS;QACrC,IAAI,CAAC,GAAG,CAAC,SAAS;YAAE,SAAS;QAC7B,MAAM,GAAG,GAAG,gBAAgB,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;QACjE,IAAI,GAAG,IAAI,aAAa,IAAI,GAAG,GAAG,IAAI,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;IAE1C,qEAAqE;IACrE,MAAM,iBAAiB,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,eAAe,GAAG,IAAI,GAAG,CAC7B,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAC7E,CAAC;IAEF,MAAM,OAAO,GAAgD,EAAE,CAAC;IAChE,KAAK,MAAM,SAAS,IAAI,GAAG,EAAE,CAAC;QAC5B,IAAI,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAAE,SAAS;QAChD,2DAA2D;QAC3D,IAAI,CAAC;YACH,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE,YAAY,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;YAC9E,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;QAChD,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AACzD,CAAC"}

package/dist/config.d.ts

@@ -1,51 +0,0 @@
-export interface AmemConfig {
-    embeddingModel: string;
-    embeddingDimensions: number;
-    embeddingCacheSize: number;
-    retrieval: {
-        semanticWeight: number;
-        ftsWeight: number;
-        graphWeight: number;
-        temporalWeight: number;
-        maxCandidates: number;
-        rerankerEnabled: boolean;
-        rerankerTopK: number;
-    };
-    consolidation: {
-        maxStaleDays: number;
-        minConfidence: number;
-        minAccessCount: number;
-        enableDecay: boolean;
-        decayFactor: number;
-    };
-    privacy: {
-        enablePrivateTags: boolean;
-        redactPatterns: string[];
-    };
-    hooks: {
-        enabled: boolean;
-        captureToolUse: boolean;
-        captureSessionEnd: boolean;
-        autoExtractInterval: number;
-    };
-    tiers: {
-        coreMaxTokens: number;
-        workingMaxTokens: number;
-    };
-    team: {
-        enabled: boolean;
-        syncPath: string | null;
-        syncInterval: number;
-        userId: string | null;
-    };
-}
-export declare function getConfigPath(): string;
-export declare function loadConfig(): AmemConfig;
-export declare function saveConfig(config: Partial<AmemConfig>): void;
-export declare function getDefaultConfig(): AmemConfig;
-export declare function resetConfigCache(): void;
-/**
- * Strip <private>...</private> tags and redact patterns from content before storage.
- * Returns cleaned content, or null if the entire content is private.
- */
-export declare function sanitizeContent(content: string, config?: AmemConfig): string | null;

package/dist/config.js

@@ -1,130 +0,0 @@
-import path from "node:path";
-import os from "node:os";
-import fs from "node:fs";
-const DEFAULT_CONFIG = {
-    embeddingModel: "Xenova/bge-small-en-v1.5",
-    embeddingDimensions: 384,
-    embeddingCacheSize: 128,
-    retrieval: {
-        semanticWeight: 0.4,
-        ftsWeight: 0.3,
-        graphWeight: 0.15,
-        temporalWeight: 0.15,
-        maxCandidates: 50000,
-        rerankerEnabled: false,
-        rerankerTopK: 20,
-    },
-    consolidation: {
-        maxStaleDays: 60,
-        minConfidence: 0.3,
-        minAccessCount: 2,
-        enableDecay: false,
-        decayFactor: 0.95,
-    },
-    privacy: {
-        enablePrivateTags: true,
-        redactPatterns: [
-            "(?:api[_-]?key|secret|token|password|passwd|credential)\\s*[:=]\\s*['\"]?[A-Za-z0-9_\\-\\.]{8,}",
-        ],
-    },
-    hooks: {
-        enabled: true,
-        captureToolUse: true,
-        captureSessionEnd: true,
-        autoExtractInterval: 0,
-    },
-    tiers: {
-        coreMaxTokens: 500,
-        workingMaxTokens: 2000,
-    },
-    team: {
-        enabled: false,
-        syncPath: null,
-        syncInterval: 30,
-        userId: null,
-    },
-};
-let loadedConfig = null;
-export function getConfigPath() {
-    const amemDir = process.env.AMEM_DIR || path.join(os.homedir(), ".amem");
-    return path.join(amemDir, "config.json");
-}
-export function loadConfig() {
-    if (loadedConfig)
-        return loadedConfig;
-    const configPath = getConfigPath();
-    try {
-        if (fs.existsSync(configPath)) {
-            const raw = fs.readFileSync(configPath, "utf-8").trim();
-            if (raw) {
-                const userConfig = JSON.parse(raw);
-                loadedConfig = deepMerge(DEFAULT_CONFIG, userConfig);
-                return loadedConfig;
-            }
-        }
-    }
-    catch (error) {
-        console.error("[amem] Failed to load config, using defaults:", error instanceof Error ? error.message : String(error));
-    }
-    loadedConfig = { ...DEFAULT_CONFIG };
-    return loadedConfig;
-}
-export function saveConfig(config) {
-    const configPath = getConfigPath();
-    const dir = path.dirname(configPath);
-    fs.mkdirSync(dir, { recursive: true });
-    // Merge with existing config
-    const existing = loadConfig();
-    const merged = deepMerge(existing, config);
-    fs.writeFileSync(configPath, JSON.stringify(merged, null, 2) + "\n");
-    loadedConfig = merged;
-}
-export function getDefaultConfig() {
-    return { ...DEFAULT_CONFIG };
-}
-export function resetConfigCache() {
-    loadedConfig = null;
-}
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-function deepMerge(base, override) {
-    const result = { ...base };
-    for (const key of Object.keys(override)) {
-        const val = override[key];
-        if (val !== undefined && val !== null) {
-            if (typeof val === "object" && !Array.isArray(val) && typeof result[key] === "object" && !Array.isArray(result[key])) {
-                result[key] = deepMerge(result[key], val);
-            }
-            else {
-                result[key] = val;
-            }
-        }
-    }
-    return result;
-}
-// ── Privacy helpers ─────────────────────────────────────
-/**
- * Strip <private>...</private> tags and redact patterns from content before storage.
- * Returns cleaned content, or null if the entire content is private.
- */
-export function sanitizeContent(content, config) {
-    const cfg = config ?? loadConfig();
-    if (!cfg.privacy.enablePrivateTags)
-        return content;
-    // Strip <private>...</private> blocks
-    let cleaned = content.replace(/<private>[\s\S]*?<\/private>/gi, "[REDACTED]");
-    // If entire content was private, return null (don't store)
-    if (cleaned.trim() === "[REDACTED]" || cleaned.trim() === "")
-        return null;
-    // Apply regex redaction patterns
-    for (const pattern of cfg.privacy.redactPatterns) {
-        try {
-            const regex = new RegExp(pattern, "g");
-            cleaned = cleaned.replace(regex, "[REDACTED]");
-        }
-        catch {
-            // Invalid regex pattern — skip
-        }
-    }
-    return cleaned;
-}
-//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AAyDzB,MAAM,cAAc,GAAe;IACjC,cAAc,EAAE,0BAA0B;IAC1C,mBAAmB,EAAE,GAAG;IACxB,kBAAkB,EAAE,GAAG;IAEvB,SAAS,EAAE;QACT,cAAc,EAAE,GAAG;QACnB,SAAS,EAAE,GAAG;QACd,WAAW,EAAE,IAAI;QACjB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;QACpB,eAAe,EAAE,KAAK;QACtB,YAAY,EAAE,EAAE;KACjB;IAED,aAAa,EAAE;QACb,YAAY,EAAE,EAAE;QAChB,aAAa,EAAE,GAAG;QAClB,cAAc,EAAE,CAAC;QACjB,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,IAAI;KAClB;IAED,OAAO,EAAE;QACP,iBAAiB,EAAE,IAAI;QACvB,cAAc,EAAE;YACd,iGAAiG;SAClG;KACF;IAED,KAAK,EAAE;QACL,OAAO,EAAE,IAAI;QACb,cAAc,EAAE,IAAI;QACpB,iBAAiB,EAAE,IAAI;QACvB,mBAAmB,EAAE,CAAC;KACvB;IAED,KAAK,EAAE;QACL,aAAa,EAAE,GAAG;QAClB,gBAAgB,EAAE,IAAI;KACvB;IAED,IAAI,EAAE;QACJ,OAAO,EAAE,KAAK;QACd,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,EAAE;QAChB,MAAM,EAAE,IAAI;KACb;CACF,CAAC;AAEF,IAAI,YAAY,GAAsB,IAAI,CAAC;AAE3C,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IAEtC,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YACxD,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwB,CAAC;gBAC1D,YAAY,GAAG,SAAS,CAAC,cAAc,EAAE,UAAU,CAAe,CAAC;gBACnE,OAAO,YAAY,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,+CAA+C,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACzH,CAAC;IAED,YAAY,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC;IACrC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAA2B;IACpD,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvC,6BAA6B;IAC7B,MAAM,QAAQ,GAAG,UAAU,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAe,CAAC;IACzD,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACrE,YAAY,GAAG,MAAM,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC;AAED,8DAA8D;AAC9D,SAAS,SAAS,CAAC,IAAS,EAAE,QAAa;IACzC,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACtC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACrH,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;YAC5C,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2DAA2D;AAE3D;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,MAAmB;IAClE,MAAM,GAAG,GAAG,MAAM,IAAI,UAAU,EAAE,CAAC;IAEnC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB;QAAE,OAAO,OAAO,CAAC;IAEnD,sCAAsC;IACtC,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,gCAAgC,EAAE,YAAY,CAAC,CAAC;IAE9E,2DAA2D;IAC3D,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,YAAY,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAE1E,iCAAiC;IACjC,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QACjD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACvC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/database.d.ts

@@ -1,165 +0,0 @@
-import type { Memory, MemoryTypeValue } from "./memory.js";
-export interface MemoryInput {
-    content: string;
-    type: MemoryTypeValue;
-    tags: string[];
-    confidence: number;
-    source: string;
-    embedding: Float32Array | null;
-    scope: string;
-    validFrom?: number;
-    validUntil?: number;
-    tier?: string;
-}
-export interface SessionSummary {
-    id: string;
-    sessionId: string;
-    summary: string;
-    keyDecisions: string[];
-    keyCorrections: string[];
-    memoriesExtracted: number;
-    project: string;
-    createdAt: number;
-}
-export interface MemoryStats {
-    total: number;
-    byType: Record<string, number>;
-}
-export interface LogEntry {
-    id: string;
-    sessionId: string;
-    role: "user" | "assistant" | "system";
-    content: string;
-    timestamp: number;
-    project: string;
-    metadata: Record<string, unknown>;
-}
-export interface LogEntryInput {
-    sessionId: string;
-    role: "user" | "assistant" | "system";
-    content: string;
-    project: string;
-    metadata?: Record<string, unknown>;
-}
-export interface MemoryVersion {
-    versionId: string;
-    memoryId: string;
-    content: string;
-    confidence: number;
-    editedAt: number;
-    reason: string;
-}
-export interface MemoryRelation {
-    id: string;
-    fromId: string;
-    toId: string;
-    relationshipType: string;
-    strength: number;
-    createdAt: number;
-    validFrom?: number | null;
-    validUntil?: number | null;
-}
-export interface PatchInput {
-    field: "content" | "confidence" | "tags" | "type";
-    value: string | number | string[];
-    reason: string;
-    skipSnapshot?: boolean;
-}
-export interface KnowledgeGap {
-    id: string;
-    queryPattern: string;
-    hitCount: number;
-    avgConfidence: number;
-    avgResults: number;
-    firstSeen: number;
-    lastSeen: number;
-    resolved: boolean;
-}
-export interface AmemDatabase {
-    insertMemory(input: MemoryInput): string;
-    findByContentHash(content: string): Memory | null;
-    getById(id: string): Memory | null;
-    searchByType(type: MemoryTypeValue): Memory[];
-    searchByTag(tag: string): Memory[];
-    getAllWithEmbeddings(): Memory[];
-    getRecentWithEmbeddings(limit: number): Memory[];
-    getAll(): Memory[];
-    updateConfidence(id: string, confidence: number): void;
-    updateEmbedding(id: string, embedding: Float32Array): void;
-    touchAccess(id: string): void;
-    deleteMemory(id: string): void;
-    getStats(): MemoryStats;
-    searchByScope(scope: string): Memory[];
-    getAllForProject(project: string): Memory[];
-    listTables(): string[];
-    close(): void;
-    appendLog(entry: LogEntryInput): string;
-    getLogBySession(sessionId: string): LogEntry[];
-    searchLog(query: string, limit?: number): LogEntry[];
-    getRecentLog(limit: number, project?: string): LogEntry[];
-    deleteLogBefore(timestamp: number): number;
-    getLogCount(): number;
-    snapshotVersion(memoryId: string, reason: string): void;
-    getVersionHistory(memoryId: string): MemoryVersion[];
-    patchMemory(id: string, patch: PatchInput): boolean;
-    addRelation(fromId: string, toId: string, type: string, strength?: number): string;
-    getRelations(memoryId: string): MemoryRelation[];
-    removeRelation(relationId: string): void;
-    getRelatedMemories(memoryId: string): Memory[];
-    getMemoriesByDateRange(from: number, to: number): Memory[];
-    getMemoriesSince(timestamp: number): Memory[];
-    fullTextSearch(query: string, limit?: number, scopeProject?: string): Memory[];
-    insertReminder(content: string, dueAt: number | null, scope: string): string;
-    listReminders(includeCompleted?: boolean, scope?: string): Array<{
-        id: string;
-        content: string;
-        dueAt: number | null;
-        completed: boolean;
-        createdAt: number;
-        scope: string;
-    }>;
-    checkReminders(): Array<{
-        id: string;
-        content: string;
-        dueAt: number | null;
-        status: "overdue" | "today" | "upcoming";
-        scope: string;
-    }>;
-    completeReminder(id: string): boolean;
-    getConfidenceStats(): {
-        high: number;
-        medium: number;
-        low: number;
-    };
-    getEmbeddingCount(): number;
-    transaction(fn: () => void): void;
-    resolveId(partialId: string): string | null;
-    resolveReminderId(partialId: string): string | null;
-    getAllRelations(): MemoryRelation[];
-    expireMemory(id: string, timestamp?: number): void;
-    getValidMemories(asOf?: number): Memory[];
-    updateTier(id: string, tier: string): void;
-    getByTier(tier: string, scope?: string): Memory[];
-    insertSummary(input: {
-        sessionId: string;
-        summary: string;
-        keyDecisions: string[];
-        keyCorrections: string[];
-        memoriesExtracted: number;
-        project: string;
-    }): string;
-    getSummaryBySession(sessionId: string): SessionSummary | null;
-    getRecentSummaries(project: string, limit?: number): SessionSummary[];
-    expireRelation(relationId: string, timestamp?: number): void;
-    getValidRelations(asOf?: number): MemoryRelation[];
-    insertSynthesisLineage(synthesisId: string, sourceIds: string[]): void;
-    getSynthesisSources(synthesisId: string): string[];
-    hasAnySynthesis(sourceIds: string[]): boolean;
-    upsertKnowledgeGap(queryPattern: string, avgConfidence: number, resultCount: number): string;
-    getActiveKnowledgeGaps(limit?: number): KnowledgeGap[];
-    resolveKnowledgeGap(id: string): void;
-    bumpUtilityScore(id: string): void;
-    getReflectionMeta(key: string): string | null;
-    setReflectionMeta(key: string, value: string): void;
-}
-export declare function createDatabase(dbPath: string): AmemDatabase;