@chendpoc/pi-memory 0.1.13 → 0.2.0

package/dist/sidecar/server/vec/mmr.d.ts

@@ -0,0 +1,13 @@
+export type ScoredCandidate = {
+    chunkId: string;
+    content: string;
+    source: string;
+    timestamp: string;
+    distance: number;
+    embedding: Float32Array;
+};
+export declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;
+/** MMR re-ranking: λ defaults from retrieval config (see constants/retrieval.ts). */
+export declare function mmrSelect(queryEmbedding: Float32Array, candidates: ScoredCandidate[], limit: number, lambda?: number): ScoredCandidate[];
+export declare function distanceToRelevance(distance: number): number;
+//# sourceMappingURL=mmr.d.ts.map

package/dist/sidecar/server/vec/mmr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mmr.d.ts","sourceRoot":"","sources":["../../../../src/sidecar/server/vec/mmr.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,YAAY,CAAC;CACzB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAIzE;AAED,qFAAqF;AACrF,wBAAgB,SAAS,CACvB,cAAc,EAAE,YAAY,EAC5B,UAAU,EAAE,eAAe,EAAE,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,SAAa,GAClB,eAAe,EAAE,CA2BnB;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/sidecar/server/vec/mmr.js

@@ -0,0 +1,36 @@
+import { MMR_LAMBDA } from "../../../constants/retrieval.js";
+export function cosineSimilarity(a, b) {
+    let dot = 0;
+    for (let i = 0; i < a.length; i++)
+        dot += a[i] * b[i];
+    return dot;
+}
+/** MMR re-ranking: λ defaults from retrieval config (see constants/retrieval.ts). */
+export function mmrSelect(queryEmbedding, candidates, limit, lambda = MMR_LAMBDA) {
+    if (candidates.length === 0)
+        return [];
+    const selected = [];
+    const remaining = [...candidates];
+    while (selected.length < limit && remaining.length > 0) {
+        let bestIdx = 0;
+        let bestScore = -Infinity;
+        for (let i = 0; i < remaining.length; i++) {
+            const candidate = remaining[i];
+            const relevance = cosineSimilarity(queryEmbedding, candidate.embedding);
+            const maxSim = selected.length === 0
+                ? 0
+                : Math.max(...selected.map((s) => cosineSimilarity(candidate.embedding, s.embedding)));
+            const score = lambda * relevance - (1 - lambda) * maxSim;
+            if (score > bestScore) {
+                bestScore = score;
+                bestIdx = i;
+            }
+        }
+        selected.push(remaining.splice(bestIdx, 1)[0]);
+    }
+    return selected;
+}
+export function distanceToRelevance(distance) {
+    return Math.max(0, Math.min(1, 1 - distance));
+}
+//# sourceMappingURL=mmr.js.map

package/dist/sidecar/server/vec/mmr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mmr.js","sourceRoot":"","sources":["../../../../src/sidecar/server/vec/mmr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAW7D,MAAM,UAAU,gBAAgB,CAAC,CAAe,EAAE,CAAe;IAC/D,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,SAAS,CACvB,cAA4B,EAC5B,UAA6B,EAC7B,KAAa,EACb,MAAM,GAAG,UAAU;IAEnB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEvC,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,MAAM,SAAS,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;IAElC,OAAO,QAAQ,CAAC,MAAM,GAAG,KAAK,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvD,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,SAAS,GAAG,CAAC,QAAQ,CAAC;QAE1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAE,CAAC;YAChC,MAAM,SAAS,GAAG,gBAAgB,CAAC,cAAc,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;YACxE,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAClC,CAAC,CAAC,CAAC;gBACH,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACzF,MAAM,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;YACzD,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;gBACtB,SAAS,GAAG,KAAK,CAAC;gBAClB,OAAO,GAAG,CAAC,CAAC;YACd,CAAC;QACH,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/sidecar/server/vec/store.d.ts

@@ -0,0 +1,30 @@
+import type { Embedder } from "../../../adapters/embed/types.js";
+import type { IndexDocument, MemoryEntry } from "../../protocol.js";
+export type StoredEmbeddingMeta = {
+    model: string;
+    provider: string;
+    dim: number;
+};
+export type ReindexOutcome = {
+    indexed: number;
+    indexGeneration: number;
+};
+export declare class VecStore {
+    private db;
+    constructor(dbPath: string);
+    private initSchema;
+    getStoredEmbeddingMeta(): StoredEmbeddingMeta | null;
+    embeddingMetaMatches(embedder: Embedder): boolean;
+    getIndexGeneration(): number;
+    getChunkCount(): number;
+    private clearChunksIfEmbeddingMismatch;
+    private bumpIndexGeneration;
+    private writeEmbeddingMeta;
+    reindex(documents: IndexDocument[]): Promise<ReindexOutcome>;
+    query(queryText: string, topK?: number): Promise<MemoryEntry[]>;
+    close(): void;
+}
+export declare function getVecStore(dbPath: string): VecStore;
+/** @internal test hook */
+export declare function resetVecStoreForTests(): void;
+//# sourceMappingURL=store.d.ts.map

package/dist/sidecar/server/vec/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../src/sidecar/server/vec/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAgBpE,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAUF,qBAAa,QAAQ;IACnB,OAAO,CAAC,EAAE,CAAoC;gBAElC,MAAM,EAAE,MAAM;IAO1B,OAAO,CAAC,UAAU;IAgBlB,sBAAsB,IAAI,mBAAmB,GAAG,IAAI;IAcpD,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAUjD,kBAAkB,IAAI,MAAM;IAK5B,aAAa,IAAI,MAAM;IAKvB,OAAO,CAAC,8BAA8B;IAKtC,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,kBAAkB;IASpB,OAAO,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IA8C5D,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA6CrE,KAAK,IAAI,IAAI;CAGd;AAID,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAOpD;AAED,0BAA0B;AAC1B,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C"}

package/dist/sidecar/server/vec/store.js

@@ -0,0 +1,179 @@
+import { createRequire } from "node:module";
+import { ensureDirSync, pathDirname } from "../../../utils/fs.js";
+import { readRetrievalConfig } from "../../../config/retrieval.js";
+import { getEmbedder } from "./embedder.js";
+import { cosineSimilarity, distanceToRelevance, mmrSelect } from "./mmr.js";
+const require = createRequire(import.meta.url);
+function embeddingToBlob(embedding) {
+    return Buffer.from(embedding.buffer, embedding.byteOffset, embedding.byteLength);
+}
+function blobToEmbedding(blob) {
+    return new Float32Array(blob.buffer, blob.byteOffset, blob.byteLength / 4);
+}
+export class VecStore {
+    db;
+    constructor(dbPath) {
+        ensureDirSync(pathDirname(dbPath));
+        const Database = require("better-sqlite3");
+        this.db = new Database(dbPath);
+        this.initSchema();
+    }
+    initSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS meta (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS memory_chunks (
+        chunk_id TEXT PRIMARY KEY,
+        content TEXT NOT NULL,
+        source TEXT NOT NULL,
+        timestamp TEXT NOT NULL,
+        embedding BLOB NOT NULL
+      );
+    `);
+    }
+    getStoredEmbeddingMeta() {
+        const read = (key) => this.db.prepare("SELECT value FROM meta WHERE key = ?").pluck().get(key);
+        const model = read("embedding_model");
+        const provider = read("embedding_provider");
+        const dimRaw = read("embedding_dim");
+        if (!model || !provider || !dimRaw)
+            return null;
+        const dim = Number.parseInt(dimRaw, 10);
+        if (!Number.isFinite(dim))
+            return null;
+        return { model, provider, dim };
+    }
+    embeddingMetaMatches(embedder) {
+        const stored = this.getStoredEmbeddingMeta();
+        if (!stored)
+            return true;
+        return (stored.model === embedder.model &&
+            stored.provider === embedder.provider &&
+            stored.dim === embedder.dim);
+    }
+    getIndexGeneration() {
+        const raw = this.db.prepare("SELECT value FROM meta WHERE key = 'index_generation'").pluck().get();
+        return Number(raw ?? "0");
+    }
+    getChunkCount() {
+        const row = this.db.prepare("SELECT COUNT(*) AS count FROM memory_chunks").get();
+        return row.count;
+    }
+    clearChunksIfEmbeddingMismatch(embedder) {
+        if (this.embeddingMetaMatches(embedder))
+            return;
+        this.db.prepare("DELETE FROM memory_chunks").run();
+    }
+    bumpIndexGeneration() {
+        const generation = this.getIndexGeneration() + 1;
+        this.db
+            .prepare("INSERT INTO meta(key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value")
+            .run("index_generation", String(generation));
+        return generation;
+    }
+    writeEmbeddingMeta(embedder) {
+        const upsert = this.db.prepare("INSERT INTO meta(key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value");
+        upsert.run("embedding_model", embedder.model);
+        upsert.run("embedding_provider", embedder.provider);
+        upsert.run("embedding_dim", String(embedder.dim));
+    }
+    async reindex(documents) {
+        const embedder = getEmbedder();
+        this.clearChunksIfEmbeddingMismatch(embedder);
+        if (documents.length === 0) {
+            const indexGeneration = this.getIndexGeneration();
+            this.writeEmbeddingMeta(embedder);
+            return { indexed: 0, indexGeneration };
+        }
+        const embeddings = await embedder.embedBatch(documents.map((doc) => doc.content));
+        const sync = this.db.transaction((docs, vectors) => {
+            const incomingIds = new Set(docs.map((doc) => doc.id));
+            const existing = this.db.prepare("SELECT chunk_id FROM memory_chunks").all();
+            const deleteChunk = this.db.prepare("DELETE FROM memory_chunks WHERE chunk_id = ?");
+            for (const row of existing) {
+                if (!incomingIds.has(row.chunk_id)) {
+                    deleteChunk.run(row.chunk_id);
+                }
+            }
+            const upsert = this.db.prepare(`
+        INSERT INTO memory_chunks(chunk_id, content, source, timestamp, embedding)
+        VALUES (?, ?, ?, ?, ?)
+        ON CONFLICT(chunk_id) DO UPDATE SET
+          content = excluded.content,
+          source = excluded.source,
+          timestamp = excluded.timestamp,
+          embedding = excluded.embedding
+      `);
+            for (let i = 0; i < docs.length; i++) {
+                const doc = docs[i];
+                upsert.run(doc.id, doc.content, doc.source, doc.timestamp, embeddingToBlob(vectors[i]));
+            }
+            const indexGeneration = this.bumpIndexGeneration();
+            this.writeEmbeddingMeta(embedder);
+            return { indexed: docs.length, indexGeneration };
+        });
+        return sync(documents, embeddings);
+    }
+    async query(queryText, topK) {
+        const retrieval = readRetrievalConfig();
+        const limit = topK ?? retrieval.topK;
+        const embedder = getEmbedder();
+        this.clearChunksIfEmbeddingMismatch(embedder);
+        const queryEmbedding = await embedder.embed(queryText);
+        const rows = this.db
+            .prepare("SELECT chunk_id, content, source, timestamp, embedding FROM memory_chunks")
+            .all();
+        if (rows.length === 0)
+            return [];
+        const candidates = [];
+        for (const row of rows) {
+            const embedding = blobToEmbedding(row.embedding);
+            if (embedding.length !== queryEmbedding.length)
+                continue;
+            const similarity = cosineSimilarity(queryEmbedding, embedding);
+            if (similarity < retrieval.minRelevance)
+                continue;
+            candidates.push({
+                chunkId: row.chunk_id,
+                content: row.content,
+                source: row.source,
+                timestamp: row.timestamp,
+                distance: 1 - similarity,
+                embedding,
+            });
+        }
+        if (candidates.length === 0)
+            return [];
+        candidates.sort((a, b) => a.distance - b.distance);
+        const poolSize = Math.min(limit * retrieval.candidatePoolMultiplier, candidates.length);
+        const pool = candidates.slice(0, poolSize);
+        const selected = mmrSelect(queryEmbedding, pool, limit, retrieval.mmrLambda);
+        return selected.map((item) => ({
+            content: item.content,
+            source: item.source,
+            timestamp: item.timestamp,
+            relevance: distanceToRelevance(item.distance),
+        }));
+    }
+    close() {
+        this.db.close();
+    }
+}
+const stores = new Map();
+export function getVecStore(dbPath) {
+    let store = stores.get(dbPath);
+    if (!store) {
+        store = new VecStore(dbPath);
+        stores.set(dbPath, store);
+    }
+    return store;
+}
+/** @internal test hook */
+export function resetVecStoreForTests() {
+    for (const store of stores.values())
+        store.close();
+    stores.clear();
+}
+//# sourceMappingURL=store.js.map

package/dist/sidecar/server/vec/store.js.map

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

package/dist/sidecar/sidecarManager.d.ts

@@ -0,0 +1,10 @@
+export { resolveSidecarEntry } from "./paths.js";
+export type SidecarOpts = {
+    entry?: string;
+    socketPath: string;
+    dbPath: string;
+};
+/** 上层唯一入口：确保 sidecar 在跑（attach 或 spawn） */
+export declare function ensureSidecarRunning(opts: SidecarOpts): Promise<void>;
+export declare function stopSidecar(): Promise<void>;
+//# sourceMappingURL=sidecarManager.d.ts.map

package/dist/sidecar/sidecarManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecarManager.d.ts","sourceRoot":"","sources":["../../src/sidecar/sidecarManager.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAMjD,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,2CAA2C;AAC3C,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB3E;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAEjD"}

package/dist/sidecar/sidecarManager.js

@@ -0,0 +1,111 @@
+// Agent 侧：connect-or-create、spawn lock、execa 生命周期
+import { readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { execa } from "execa";
+import { SIDECAR_SPAWN_LOCK_FILE } from "../constants/paths.js";
+import { SIDECAR_FORCE_KILL_DELAY_MS, SIDECAR_SPAWN_LOCK_STALE_MS, SIDECAR_START_TIMEOUT_MS, } from "../constants/timing.js";
+import { ensureDirSync, joinPath, pathDirname, pathExists } from "../utils/fs.js";
+import { nowMs } from "../utils/time.js";
+import { ping } from "./client.js";
+import { resolveSidecarEntry } from "./paths.js";
+import { canConnect, waitUntilReady } from "./utils.js";
+export { resolveSidecarEntry } from "./paths.js";
+const START_TIMEOUT_MS = SIDECAR_START_TIMEOUT_MS;
+let instance;
+/** 上层唯一入口：确保 sidecar 在跑（attach 或 spawn） */
+export async function ensureSidecarRunning(opts) {
+    const resolved = { ...opts, entry: opts.entry ?? resolveSidecarEntry() };
+    ensureDirSync(pathDirname(resolved.socketPath));
+    if (await canConnect(resolved.socketPath))
+        return;
+    if (!acquireSpawnLock(resolved.socketPath)) {
+        await waitUntilReady(() => canConnect(resolved.socketPath), START_TIMEOUT_MS);
+        return;
+    }
+    try {
+        if (await canConnect(resolved.socketPath))
+            return;
+        await getInstance().spawn(resolved);
+    }
+    finally {
+        releaseSpawnLock(resolved.socketPath);
+    }
+}
+export async function stopSidecar() {
+    await getInstance().stop();
+}
+function getInstance() {
+    instance ??= new SidecarManager();
+    return instance;
+}
+class SidecarManager {
+    child;
+    async spawn(opts) {
+        if (await ping(opts.socketPath))
+            return;
+        this.child = execa(process.execPath, [opts.entry, "--socket", opts.socketPath, "--db", opts.dbPath], {
+            stdio: "ignore",
+            cleanup: true,
+            forceKillAfterDelay: SIDECAR_FORCE_KILL_DELAY_MS,
+        });
+        this.child.catch(() => { });
+        await waitUntilReady(() => ping(opts.socketPath), START_TIMEOUT_MS);
+    }
+    async stop() {
+        this.child?.kill("SIGTERM");
+        await this.child;
+        this.child = undefined;
+    }
+}
+function spawnLockPath(socketPath) {
+    return joinPath(pathDirname(socketPath), SIDECAR_SPAWN_LOCK_FILE);
+}
+function acquireSpawnLock(socketPath) {
+    const lockPath = spawnLockPath(socketPath);
+    for (let i = 0; i < 5; i++) {
+        try {
+            writeFileSync(lockPath, `${process.pid}\n${nowMs()}\n`, { flag: "wx" });
+            return true;
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+            if (isLockStale(lockPath)) {
+                try {
+                    unlinkSync(lockPath);
+                }
+                catch { }
+                continue;
+            }
+            return false;
+        }
+    }
+    return false;
+}
+function isLockStale(lockPath) {
+    if (!pathExists(lockPath))
+        return false;
+    try {
+        const [pidLine = "", tsLine = "0"] = readFileSync(lockPath, "utf8").trim().split("\n");
+        const pid = Number.parseInt(pidLine, 10);
+        const ts = Number.parseInt(tsLine, 10);
+        if (Number.isFinite(pid)) {
+            try {
+                process.kill(pid, 0);
+            }
+            catch {
+                return true;
+            }
+        }
+        return !Number.isFinite(ts) || nowMs() - ts > SIDECAR_SPAWN_LOCK_STALE_MS;
+    }
+    catch {
+        return true;
+    }
+}
+function releaseSpawnLock(socketPath) {
+    try {
+        unlinkSync(spawnLockPath(socketPath));
+    }
+    catch { }
+}
+//# sourceMappingURL=sidecarManager.js.map

package/dist/sidecar/sidecarManager.js.map

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

package/dist/sidecar/utils.d.ts

@@ -0,0 +1,3 @@
+export declare function waitUntilReady(predicate: () => Promise<boolean>, timeout: number): Promise<void>;
+export declare function canConnect(socketPath: string): Promise<boolean>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/sidecar/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/sidecar/utils.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAa9F;AAEH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU/D"}

package/dist/sidecar/utils.js

@@ -0,0 +1,27 @@
+import net from "node:net";
+export function waitUntilReady(predicate, timeout) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new Error(`Timeout waiting for predicate after ${timeout}ms`));
+        }, timeout);
+        const interval = setInterval(async () => {
+            if (await predicate()) {
+                clearInterval(interval);
+                clearTimeout(timer);
+                resolve();
+            }
+        }, 100);
+    });
+}
+export function canConnect(socketPath) {
+    return new Promise((resolve) => {
+        const socket = net.connect(socketPath);
+        socket.on("connect", () => {
+            resolve(true);
+        });
+        socket.on("error", () => {
+            resolve(false);
+        });
+    });
+}
+//# sourceMappingURL=utils.js.map

package/dist/sidecar/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/sidecar/utils.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAE3B,MAAM,UAAU,cAAc,CAAC,SAAiC,EAAE,OAAe;IAC7E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,IAAI,KAAK,CAAC,uCAAuC,OAAO,IAAI,CAAC,CAAC,CAAC;QACxE,CAAC,EAAE,OAAO,CAAC,CAAC;QACZ,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;YACtC,IAAI,MAAM,SAAS,EAAE,EAAE,CAAC;gBACtB,aAAa,CAAC,QAAQ,CAAC,CAAC;gBACxB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,EAAE,GAAG,CAAC,CAAC;IACV,CAAC,CAAC,CAAC;AACL,CAAC;AAEH,MAAM,UAAU,UAAU,CAAC,UAAkB;IAC3C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACvC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACxB,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/store/backend.d.ts

@@ -0,0 +1,12 @@
+export declare class MarkdownMemoryBackend {
+    private readonly memoryFile;
+    constructor(memoryFile: string);
+    ensureAgentDir(): Promise<void>;
+    readText(path: string): Promise<string>;
+    writeText(path: string, content: string): Promise<void>;
+    listAutoFiles(agentDir: string): Promise<string[]>;
+    autoFilePath(agentDir: string, fileName: string): string;
+    deleteAutoFile(path: string): Promise<void>;
+    withMemoryLock<T>(fn: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=backend.d.ts.map

package/dist/store/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/store/backend.ts"],"names":[],"mappings":"AAoBA,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,MAAM;IAEzC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKxD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIlD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAiB1D"}

package/dist/store/backend.js

@@ -0,0 +1,47 @@
+import lockfile from "proper-lockfile";
+import { MEMORY_LOCK_MAX_TIMEOUT_MS, MEMORY_LOCK_MIN_TIMEOUT_MS, MEMORY_LOCK_RETRIES, } from "../constants/timing.js";
+import { ensureDir, ensureFile, joinPath, listDir, pathDirname, readText, removeFile, writeText, } from "../utils/fs.js";
+import { isAutoOverflowFile } from "./paths.js";
+export class MarkdownMemoryBackend {
+    memoryFile;
+    constructor(memoryFile) {
+        this.memoryFile = memoryFile;
+    }
+    async ensureAgentDir() {
+        await ensureDir(pathDirname(this.memoryFile));
+    }
+    async readText(path) {
+        return readText(path);
+    }
+    async writeText(path, content) {
+        await writeText(path, content);
+    }
+    async listAutoFiles(agentDir) {
+        const names = await listDir(agentDir);
+        return names.filter(isAutoOverflowFile).sort();
+    }
+    autoFilePath(agentDir, fileName) {
+        return joinPath(agentDir, fileName);
+    }
+    async deleteAutoFile(path) {
+        await removeFile(path);
+    }
+    async withMemoryLock(fn) {
+        await this.ensureAgentDir();
+        await ensureFile(this.memoryFile);
+        const release = await lockfile.lock(this.memoryFile, {
+            retries: {
+                retries: MEMORY_LOCK_RETRIES,
+                minTimeout: MEMORY_LOCK_MIN_TIMEOUT_MS,
+                maxTimeout: MEMORY_LOCK_MAX_TIMEOUT_MS,
+            },
+        });
+        try {
+            return await fn();
+        }
+        finally {
+            await release();
+        }
+    }
+}
+//# sourceMappingURL=backend.js.map

package/dist/store/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../src/store/backend.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AAEvC,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,OAAO,EACP,WAAW,EACX,QAAQ,EACR,UAAU,EACV,SAAS,GACV,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,OAAO,qBAAqB;IACH;IAA7B,YAA6B,UAAkB;QAAlB,eAAU,GAAV,UAAU,CAAQ;IAAG,CAAC;IAEnD,KAAK,CAAC,cAAc;QAClB,MAAM,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,OAAe;QAC3C,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAAgB;QAClC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtC,OAAO,KAAK,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,CAAC;IAED,YAAY,CAAC,QAAgB,EAAE,QAAgB;QAC7C,OAAO,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAAY;QAC/B,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,cAAc,CAAI,EAAoB;QAC1C,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC5B,MAAM,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAElC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;YACnD,OAAO,EAAE;gBACP,OAAO,EAAE,mBAAmB;gBAC5B,UAAU,EAAE,0BAA0B;gBACtC,UAAU,EAAE,0BAA0B;aACvC;SACF,CAAC,CAAC;QACH,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;CACF"}

package/dist/store/index.d.ts

@@ -0,0 +1,6 @@
+export { MemoryStore, createMemoryStore } from "./memoryStore.js";
+export { MarkdownMemoryBackend } from "./backend.js";
+export { getAgentPaths, resolveAgentDir } from "./paths.js";
+export * from "./types.js";
+export * from "../constants/memory.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5D,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC"}

package/dist/store/index.js

@@ -0,0 +1,6 @@
+export { MemoryStore, createMemoryStore } from "./memoryStore.js";
+export { MarkdownMemoryBackend } from "./backend.js";
+export { getAgentPaths, resolveAgentDir } from "./paths.js";
+export * from "./types.js";
+export * from "../constants/memory.js";
+//# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC5D,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC"}

package/dist/store/indexChunks.d.ts

@@ -0,0 +1,9 @@
+import type { IndexDocument } from "../sidecar/protocol.js";
+import type { ChunkingConfig } from "../config/chunking.js";
+import type { ParsedEntry } from "./types.js";
+/**
+ * Split long text on paragraph / line / sentence boundaries, then hard-wrap at maxChars.
+ */
+export declare function splitTextByMaxChars(text: string, maxChars: number): string[];
+export declare function buildIndexDocuments(entries: ParsedEntry[], chunking: ChunkingConfig): IndexDocument[];
+//# sourceMappingURL=indexChunks.d.ts.map

package/dist/store/indexChunks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexChunks.d.ts","sourceRoot":"","sources":["../../src/store/indexChunks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAiB,WAAW,EAAE,MAAM,YAAY,CAAC;AAM7D;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CA2C5E;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EAAE,EACtB,QAAQ,EAAE,cAAc,GACvB,aAAa,EAAE,CA2BjB"}