@mnemo-mcp/core 1.0.0

package/dist/paths.d.ts

@@ -0,0 +1,12 @@
+export declare function resolveDataDir(override?: string): string;
+export type Paths = {
+    dataDir: string;
+    dbFile: string;
+    indexFile: string;
+    modelDir: string;
+    configFile: string;
+    logFile: string;
+};
+export declare function paths(dataDir: string): Paths;
+export declare function projectHashOf(absolutePath: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAIA,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED,MAAM,MAAM,KAAK,GAAG;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAS5C;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/dist/paths.js

@@ -0,0 +1,24 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { createHash } from 'node:crypto';
+export function resolveDataDir(override) {
+    if (override)
+        return override;
+    if (process.env.MNEMO_DATA_DIR)
+        return process.env.MNEMO_DATA_DIR;
+    return join(homedir(), '.mnemo');
+}
+export function paths(dataDir) {
+    return {
+        dataDir,
+        dbFile: join(dataDir, 'memory.db'),
+        indexFile: join(dataDir, 'hnsw.bin'),
+        modelDir: join(dataDir, 'model'),
+        configFile: join(dataDir, 'config.json'),
+        logFile: join(dataDir, 'mnemo.log'),
+    };
+}
+export function projectHashOf(absolutePath) {
+    return createHash('sha256').update(absolutePath).digest('hex').slice(0, 16);
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,cAAc,CAAC,QAAiB;IAC9C,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAClE,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC;AAWD,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,OAAO;QACL,OAAO;QACP,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC;QAClC,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;QACpC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC;QAChC,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC;QACxC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,YAAoB;IAChD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC9E,CAAC"}

package/dist/ranker.d.ts

@@ -0,0 +1,9 @@
+import type { MemoryRecord } from './types.js';
+export type RankerWeights = {
+    similarity: number;
+    recency: number;
+    access: number;
+};
+export declare const DEFAULT_WEIGHTS: RankerWeights;
+export declare function score(similarity: number, rec: MemoryRecord, weights?: RankerWeights, now?: number): number;
+//# sourceMappingURL=ranker.d.ts.map

package/dist/ranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranker.d.ts","sourceRoot":"","sources":["../src/ranker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,aAI7B,CAAC;AAKF,wBAAgB,KAAK,CACnB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,YAAY,EACjB,OAAO,GAAE,aAA+B,EACxC,GAAG,GAAE,MAAmB,GACvB,MAAM,CASR"}

package/dist/ranker.js

@@ -0,0 +1,16 @@
+export const DEFAULT_WEIGHTS = {
+    similarity: 0.7,
+    recency: 0.2,
+    access: 0.1,
+};
+const RECENCY_HALF_LIFE_DAYS = 30;
+const ACCESS_SATURATION = 20;
+export function score(similarity, rec, weights = DEFAULT_WEIGHTS, now = Date.now()) {
+    const ageDays = Math.max(0, (now - rec.lastAccessedAt) / 86400_000);
+    const recency = Math.exp(-ageDays / RECENCY_HALF_LIFE_DAYS);
+    const accessBoost = Math.min(1, rec.accessCount / ACCESS_SATURATION);
+    return (weights.similarity * similarity +
+        weights.recency * recency +
+        weights.access * accessBoost);
+}
+//# sourceMappingURL=ranker.js.map

package/dist/ranker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranker.js","sourceRoot":"","sources":["../src/ranker.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,eAAe,GAAkB;IAC5C,UAAU,EAAE,GAAG;IACf,OAAO,EAAE,GAAG;IACZ,MAAM,EAAE,GAAG;CACZ,CAAC;AAEF,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAClC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B,MAAM,UAAU,KAAK,CACnB,UAAkB,EAClB,GAAiB,EACjB,UAAyB,eAAe,EACxC,MAAc,IAAI,CAAC,GAAG,EAAE;IAExB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,cAAc,CAAC,GAAG,SAAS,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,GAAG,sBAAsB,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,WAAW,GAAG,iBAAiB,CAAC,CAAC;IACrE,OAAO,CACL,OAAO,CAAC,UAAU,GAAG,UAAU;QAC/B,OAAO,CAAC,OAAO,GAAG,OAAO;QACzB,OAAO,CAAC,MAAM,GAAG,WAAW,CAC7B,CAAC;AACJ,CAAC"}

package/dist/store.d.ts

@@ -0,0 +1,32 @@
+import type { MemoryRecord, MemoryScope, MemorySource, UpdateInput } from './types.js';
+export type StoreCounts = {
+    total: number;
+    byScope: Record<MemoryScope, number>;
+    expired: number;
+};
+export type StoreListFilter = {
+    scope?: MemoryScope;
+    projectHash?: string | null;
+    source?: MemorySource | MemorySource[];
+    tags?: string[];
+    limit?: number;
+    since?: number;
+    includeExpired?: boolean;
+};
+export declare class Store {
+    private db;
+    private path;
+    private constructor();
+    static open(path: string): Promise<Store>;
+    upsert(rec: MemoryRecord): Promise<void>;
+    update(id: string, fields: UpdateInput): Promise<MemoryRecord | null>;
+    get(id: string): Promise<MemoryRecord | null>;
+    delete(id: string): Promise<void>;
+    list(filter?: StoreListFilter): Promise<MemoryRecord[]>;
+    count(): Promise<StoreCounts>;
+    bumpAccess(id: string): Promise<void>;
+    flush(): Promise<void>;
+    close(): void;
+    private fromRow;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAqBvF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY,EAAE,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAsBF,qBAAa,KAAK;IAEd,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,IAAI;IAFd,OAAO;WAKM,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAwBzC,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BxC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAgBrE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAY7C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjC,IAAI,CAAC,MAAM,GAAE,eAAoB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAyC3D,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAkB7B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,OAAO;CAehB"}

package/dist/store.js

@@ -0,0 +1,223 @@
+import initSqlJs from 'sql.js';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS memories (
+  id TEXT PRIMARY KEY,
+  scope TEXT NOT NULL,
+  project_hash TEXT,
+  source TEXT NOT NULL,
+  content TEXT NOT NULL,
+  tags TEXT NOT NULL,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL,
+  access_count INTEGER NOT NULL DEFAULT 0,
+  last_accessed_at INTEGER NOT NULL,
+  expires_at INTEGER
+);
+CREATE INDEX IF NOT EXISTS idx_scope_project ON memories(scope, project_hash);
+CREATE INDEX IF NOT EXISTS idx_updated ON memories(updated_at);
+CREATE INDEX IF NOT EXISTS idx_expires ON memories(expires_at);
+`;
+let cachedSqlPromise = null;
+function loadSql() {
+    if (!cachedSqlPromise) {
+        const here = dirname(fileURLToPath(import.meta.url));
+        cachedSqlPromise = initSqlJs({
+            locateFile: (file) => {
+                const candidates = [
+                    join(here, '..', '..', '..', 'node_modules', 'sql.js', 'dist', file),
+                    join(here, '..', '..', 'node_modules', 'sql.js', 'dist', file),
+                    join(here, '..', 'node_modules', 'sql.js', 'dist', file),
+                ];
+                for (const c of candidates)
+                    if (existsSync(c))
+                        return c;
+                return file;
+            },
+        });
+    }
+    return cachedSqlPromise;
+}
+export class Store {
+    db;
+    path;
+    constructor(db, path) {
+        this.db = db;
+        this.path = path;
+    }
+    static async open(path) {
+        const SQL = (await loadSql());
+        let db;
+        let isFresh = false;
+        if (existsSync(path)) {
+            const bytes = await readFile(path);
+            db = new SQL.Database(new Uint8Array(bytes));
+        }
+        else {
+            await mkdir(dirname(path), { recursive: true });
+            db = new SQL.Database();
+            isFresh = true;
+        }
+        db.exec(SCHEMA);
+        // Best-effort migration for legacy dbs that predate expires_at:
+        try {
+            db.exec('ALTER TABLE memories ADD COLUMN expires_at INTEGER');
+        }
+        catch {
+            // column already exists — fine
+        }
+        const store = new Store(db, path);
+        if (isFresh)
+            await store.flush();
+        return store;
+    }
+    async upsert(rec) {
+        this.db.run(`INSERT INTO memories
+       (id, scope, project_hash, source, content, tags, created_at, updated_at, access_count, last_accessed_at, expires_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+       ON CONFLICT(id) DO UPDATE SET
+         scope=excluded.scope,
+         project_hash=excluded.project_hash,
+         source=excluded.source,
+         content=excluded.content,
+         tags=excluded.tags,
+         updated_at=excluded.updated_at,
+         expires_at=excluded.expires_at`, [
+            rec.id,
+            rec.scope,
+            rec.projectHash,
+            rec.source,
+            rec.content,
+            JSON.stringify(rec.tags),
+            rec.createdAt,
+            rec.updatedAt,
+            rec.accessCount,
+            rec.lastAccessedAt,
+            rec.expiresAt,
+        ]);
+        await this.flush();
+    }
+    async update(id, fields) {
+        const existing = await this.get(id);
+        if (!existing)
+            return null;
+        const next = {
+            ...existing,
+            content: fields.content ?? existing.content,
+            tags: fields.tags ?? existing.tags,
+            scope: fields.scope ?? existing.scope,
+            projectHash: fields.projectHash !== undefined ? fields.projectHash : existing.projectHash,
+            expiresAt: fields.expiresAt !== undefined ? fields.expiresAt : existing.expiresAt,
+            updatedAt: Date.now(),
+        };
+        await this.upsert(next);
+        return next;
+    }
+    async get(id) {
+        const stmt = this.db.prepare('SELECT * FROM memories WHERE id = ?');
+        stmt.bind([id]);
+        if (!stmt.step()) {
+            stmt.free();
+            return null;
+        }
+        const row = stmt.getAsObject();
+        stmt.free();
+        return this.fromRow(row);
+    }
+    async delete(id) {
+        this.db.run('DELETE FROM memories WHERE id = ?', [id]);
+        await this.flush();
+    }
+    async list(filter = {}) {
+        const where = [];
+        const args = [];
+        if (filter.scope) {
+            where.push('scope = ?');
+            args.push(filter.scope);
+        }
+        if (filter.projectHash !== undefined) {
+            if (filter.projectHash === null) {
+                where.push('project_hash IS NULL');
+            }
+            else {
+                where.push('project_hash = ?');
+                args.push(filter.projectHash);
+            }
+        }
+        if (filter.since) {
+            where.push('updated_at >= ?');
+            args.push(filter.since);
+        }
+        if (filter.source) {
+            const sources = Array.isArray(filter.source) ? filter.source : [filter.source];
+            where.push(`source IN (${sources.map(() => '?').join(',')})`);
+            args.push(...sources);
+        }
+        if (!filter.includeExpired) {
+            where.push('(expires_at IS NULL OR expires_at > ?)');
+            args.push(Date.now());
+        }
+        const sql = `SELECT * FROM memories ${where.length ? 'WHERE ' + where.join(' AND ') : ''} ORDER BY updated_at DESC ${filter.limit ? 'LIMIT ' + Number(filter.limit) : ''}`;
+        const stmt = this.db.prepare(sql);
+        if (args.length)
+            stmt.bind(args);
+        let rows = [];
+        while (stmt.step())
+            rows.push(this.fromRow(stmt.getAsObject()));
+        stmt.free();
+        if (filter.tags && filter.tags.length) {
+            const required = filter.tags;
+            rows = rows.filter(r => required.every(t => r.tags.includes(t)));
+        }
+        return rows;
+    }
+    async count() {
+        const stmt = this.db.prepare('SELECT scope, COUNT(*) as n FROM memories GROUP BY scope');
+        const byScope = { project: 0, global: 0 };
+        let total = 0;
+        while (stmt.step()) {
+            const row = stmt.getAsObject();
+            byScope[row.scope] = row.n;
+            total += row.n;
+        }
+        stmt.free();
+        const expStmt = this.db.prepare('SELECT COUNT(*) as n FROM memories WHERE expires_at IS NOT NULL AND expires_at <= ?');
+        expStmt.bind([Date.now()]);
+        let expired = 0;
+        if (expStmt.step())
+            expired = Number(expStmt.getAsObject().n);
+        expStmt.free();
+        return { total, byScope, expired };
+    }
+    async bumpAccess(id) {
+        const now = Date.now();
+        this.db.run('UPDATE memories SET access_count = access_count + 1, last_accessed_at = ? WHERE id = ?', [now, id]);
+        await this.flush();
+    }
+    async flush() {
+        const data = this.db.export();
+        await writeFile(this.path, Buffer.from(data));
+    }
+    close() {
+        this.db.close();
+    }
+    fromRow(row) {
+        return {
+            id: String(row.id),
+            scope: row.scope,
+            projectHash: row.project_hash ?? null,
+            source: row.source,
+            content: String(row.content),
+            tags: JSON.parse(String(row.tags ?? '[]')),
+            createdAt: Number(row.created_at),
+            updatedAt: Number(row.updated_at),
+            accessCount: Number(row.access_count),
+            lastAccessedAt: Number(row.last_accessed_at),
+            expiresAt: row.expires_at == null ? null : Number(row.expires_at),
+        };
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,99 @@
+export type MemoryScope = 'project' | 'global';
+export type MemorySource = 'manual' | 'auto-edit' | 'auto-task' | 'imported';
+export type MemoryRecord = {
+    id: string;
+    scope: MemoryScope;
+    projectHash: string | null;
+    source: MemorySource;
+    content: string;
+    tags: string[];
+    createdAt: number;
+    updatedAt: number;
+    accessCount: number;
+    lastAccessedAt: number;
+    /** Unix ms after which the memory should be considered expired and skipped from recall. null = never. */
+    expiresAt: number | null;
+};
+export type CaptureInput = {
+    content: string;
+    scope?: MemoryScope;
+    projectHash?: string | null;
+    source?: MemorySource;
+    tags?: string[];
+    /** Unix ms or null. Convenience helper: pass `Date.now() + ms` for relative TTL. */
+    expiresAt?: number | null;
+    /**
+     * Cosine-similarity threshold (0–1). If a candidate already exists with similarity ≥ this,
+     * Mnemo updates the existing record instead of inserting a duplicate. Default 0.95.
+     * Pass `0` to always insert.
+     */
+    dedupThreshold?: number;
+};
+export type RecallOpts = {
+    k?: number;
+    scope?: MemoryScope | 'all';
+    projectHash?: string | null;
+    minScore?: number;
+    /** Filter results to memories that have ALL of these tags. */
+    tags?: string[];
+    /** Filter results by source. */
+    source?: MemorySource | MemorySource[];
+    /** Only consider memories with `updatedAt >= since` (unix ms). */
+    since?: number;
+    /** Include expired memories in results. Default false. */
+    includeExpired?: boolean;
+};
+export type MemoryHit = {
+    record: MemoryRecord;
+    score: number;
+    similarity: number;
+};
+export type ListFilter = {
+    scope?: MemoryScope;
+    projectHash?: string | null;
+    tags?: string[];
+    source?: MemorySource | MemorySource[];
+    limit?: number;
+    since?: number;
+    includeExpired?: boolean;
+};
+export type UpdateInput = {
+    content?: string;
+    tags?: string[];
+    scope?: MemoryScope;
+    projectHash?: string | null;
+    expiresAt?: number | null;
+};
+export type PruneOpts = {
+    /** Drop memories whose `expiresAt` is in the past. Default true. */
+    expired?: boolean;
+    /** Drop memories with similarity ≥ this to a *more recently accessed* peer. Default 0.97. Set 0 to disable. */
+    duplicateThreshold?: number;
+    /** Drop memories with `accessCount` < this AND older than `staleAfterDays`. Default disabled (0). */
+    minAccessCount?: number;
+    staleAfterDays?: number;
+    /** When true, only return what would be pruned without deleting. */
+    dryRun?: boolean;
+};
+export type PruneResult = {
+    expired: MemoryRecord[];
+    duplicates: {
+        kept: MemoryRecord;
+        dropped: MemoryRecord;
+    }[];
+    stale: MemoryRecord[];
+    totalDeleted: number;
+};
+export type MnemoStats = {
+    totalMemories: number;
+    byScope: Record<MemoryScope, number>;
+    indexSize: number;
+    embeddingDimension: number;
+    storageBytes: number;
+    expired: number;
+};
+export type MnemoOpts = {
+    dataDir?: string;
+    embedderType?: 'onnx' | 'hash';
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/vector-index.d.ts

@@ -0,0 +1,31 @@
+export type VectorIndexOpts = {
+    path: string;
+    dimension: number;
+    maxElements?: number;
+    m?: number;
+    efConstruction?: number;
+};
+export type VectorHit = {
+    id: string;
+    similarity: number;
+};
+/**
+ * HNSW vector index with id-based lookup. Stores a label↔id mapping
+ * separately because hnswlib uses numeric labels.
+ */
+export declare class VectorIndex {
+    private hnsw;
+    private opts;
+    private nextLabel;
+    private idToLabel;
+    private labelToId;
+    private constructor();
+    private static mapPath;
+    static open(opts: VectorIndexOpts): Promise<VectorIndex>;
+    add(id: string, vector: Float32Array): Promise<void>;
+    remove(id: string): Promise<void>;
+    query(vector: Float32Array, k: number): Promise<VectorHit[]>;
+    size(): number;
+    save(): Promise<void>;
+}
+//# sourceMappingURL=vector-index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vector-index.d.ts","sourceRoot":"","sources":["../src/vector-index.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAOF;;;GAGG;AACH,qBAAa,WAAW;IAMpB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,IAAI;IANd,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,SAAS,CAA6B;IAE9C,OAAO;IAKP,OAAO,CAAC,MAAM,CAAC,OAAO;WAIT,IAAI,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IA6BxD,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjC,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAelE,IAAI,IAAI,MAAM;IAIR,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ5B"}

package/dist/vector-index.js

@@ -0,0 +1,98 @@
+import hnswlib from 'hnswlib-node';
+import { existsSync } from 'node:fs';
+const { HierarchicalNSW } = hnswlib;
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+/**
+ * HNSW vector index with id-based lookup. Stores a label↔id mapping
+ * separately because hnswlib uses numeric labels.
+ */
+export class VectorIndex {
+    hnsw;
+    opts;
+    nextLabel = 1;
+    idToLabel = new Map();
+    labelToId = new Map();
+    constructor(hnsw, opts) {
+        this.hnsw = hnsw;
+        this.opts = opts;
+    }
+    static mapPath(p) {
+        return `${p}.map.json`;
+    }
+    static async open(opts) {
+        const full = {
+            path: opts.path,
+            dimension: opts.dimension,
+            maxElements: opts.maxElements ?? 100_000,
+            m: opts.m ?? 16,
+            efConstruction: opts.efConstruction ?? 200,
+        };
+        const hnsw = new HierarchicalNSW('cosine', full.dimension);
+        if (existsSync(full.path)) {
+            hnsw.readIndexSync(full.path);
+        }
+        else {
+            await mkdir(dirname(full.path), { recursive: true });
+            hnsw.initIndex(full.maxElements, full.m, full.efConstruction);
+        }
+        hnsw.setEf(Math.max(50, full.m * 4));
+        const idx = new VectorIndex(hnsw, full);
+        if (existsSync(VectorIndex.mapPath(full.path))) {
+            const raw = await readFile(VectorIndex.mapPath(full.path), 'utf8');
+            const parsed = JSON.parse(raw);
+            idx.nextLabel = parsed.nextLabel;
+            for (const [id, label] of parsed.entries) {
+                idx.idToLabel.set(id, label);
+                idx.labelToId.set(label, id);
+            }
+        }
+        return idx;
+    }
+    async add(id, vector) {
+        if (vector.length !== this.opts.dimension) {
+            throw new Error(`vector dim ${vector.length} != index dim ${this.opts.dimension}`);
+        }
+        const existing = this.idToLabel.get(id);
+        const label = existing ?? this.nextLabel++;
+        this.hnsw.addPoint(Array.from(vector), label);
+        this.idToLabel.set(id, label);
+        this.labelToId.set(label, id);
+    }
+    async remove(id) {
+        const label = this.idToLabel.get(id);
+        if (label === undefined)
+            return;
+        this.hnsw.markDelete(label);
+        this.idToLabel.delete(id);
+        this.labelToId.delete(label);
+    }
+    async query(vector, k) {
+        if (this.size() === 0)
+            return [];
+        const got = this.hnsw.searchKnn(Array.from(vector), Math.min(k, this.size()));
+        const out = [];
+        for (let i = 0; i < got.neighbors.length; i++) {
+            const label = got.neighbors[i];
+            const id = this.labelToId.get(label);
+            if (!id)
+                continue;
+            // hnswlib returns cosine *distance* (1 - sim) for 'cosine' space.
+            const distance = got.distances[i];
+            out.push({ id, similarity: 1 - distance });
+        }
+        return out;
+    }
+    size() {
+        return this.idToLabel.size;
+    }
+    async save() {
+        this.hnsw.writeIndexSync(this.opts.path);
+        const map = {
+            entries: [...this.idToLabel.entries()],
+            nextLabel: this.nextLabel,
+        };
+        await writeFile(VectorIndex.mapPath(this.opts.path), JSON.stringify(map));
+    }
+}
+//# sourceMappingURL=vector-index.js.map

package/dist/vector-index.js.map

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