@spinabot/brigade 0.1.2 → 1.0.1

package/dist/storage/local/memory-store.js

@@ -0,0 +1,258 @@
+// src/storage/local/memory-store.ts
+//
+// LocalMemoryStore — filesystem-mode wrapper around `agents/memory/*`.
+// Implements `MemoryStore`.
+//
+// Scope (additive, PR11):
+//   ✓ listFacts / writeFact / searchFacts / markFactsAccessed /
+//     setFactsLifecycle / countActiveFacts  — wrap FactStore directly
+//   ✓ searchNotes / readNote / notesStatus  — wrap FileMemoryStore directly
+//   ✓ getExtractCursor                     — wrap extract.ts:getCursor
+//   ✓ setExtractCursor                     — inline tmp+rename (writer is private upstream)
+//   ✓ getConsolidateLastRunAt              — read consolidate-state.json inline
+//   ✓ markConsolidateRunAt                 — wrap consolidate.ts:markConsolidationRun
+//   ✗ findSimilar                          — stub; embed-on-write ships in
+//                                            both modes, so real hybrid recall
+//                                            lives in FactStore.searchHybrid
+//   ✗ decay                                — needs a sweep helper upstream
+//   ✗ subscribe                            — no-op (filesystem mode reads on demand)
+//
+// All on-disk semantics (dedup-on-write, supersede archive, origin filter,
+// atomic whole-file rewrite) live in the wrapped FactStore; the adapter
+// is a typed seam, not a behavioural change.
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { FactStore, } from "../../agents/memory/records.js";
+import { FileMemoryStore } from "../../agents/memory/storage.js";
+import { getCursor } from "../../agents/memory/extract.js";
+import { resolveAgentWorkspaceDir, DEFAULT_AGENT_ID } from "../../config/paths.js";
+import { watchFile } from "./file-watcher.js";
+import { NotImplementedYet } from "../store.js";
+/** Resolve the active agent's workspace dir. Memory operations are scoped to
+ *  a single workspace today; multi-agent fan-out reads via the agent kernel
+ *  pass an explicit workspaceDir through the existing call sites. */
+function activeWorkspaceDir() {
+    return resolveAgentWorkspaceDir(DEFAULT_AGENT_ID);
+}
+function activeFactStore() {
+    return new FactStore(activeWorkspaceDir());
+}
+function activeMemoryStore() {
+    return new FileMemoryStore(activeWorkspaceDir());
+}
+export class LocalMemoryStore {
+    _stateDir;
+    // `_stateDir` is retained for parity with the other local stores, but path
+    // resolution here intentionally flows through the global `resolveStateDir()`
+    // (via `activeWorkspaceDir()` → `resolveAgentWorkspaceDir`) so memory ops
+    // land in the same workspace the rest of the runtime reads from.
+    constructor(_stateDir) {
+        this._stateDir = _stateDir;
+    }
+    async listFacts(filter) {
+        const records = activeFactStore().list(filter);
+        return records;
+    }
+    async writeFact(fact) {
+        const record = activeFactStore().write(fact);
+        return record;
+    }
+    async searchFacts(query, opts) {
+        const result = activeFactStore().recall(query, {
+            ...(opts.limit !== undefined ? { limit: opts.limit } : {}),
+            ...(opts.markAccessed !== undefined ? { markAccessed: opts.markAccessed } : {}),
+            ...(opts.origin !== undefined ? { origin: opts.origin } : {}),
+        });
+        return result;
+    }
+    async markFactsAccessed(memoryIds) {
+        activeFactStore().markAccessed(memoryIds);
+    }
+    async setFactsLifecycle(memoryIds, lifecycle) {
+        activeFactStore().setLifecycle(memoryIds, lifecycle);
+    }
+    async countActiveFacts() {
+        const all = activeFactStore().readAll();
+        return all.filter((r) => r.lifecycle === "active").length;
+    }
+    async findSimilar(_text, _scope, _k) {
+        // Intentionally a stub. Embed-on-write now ships in BOTH modes, so
+        // records carry `.embedding` and real vector/hybrid recall is available
+        // via `FactStore.searchHybrid` (BM25 ⊕ vector). This adapter method
+        // could become a thin wrapper over that for parity, but until a caller
+        // needs the typed-seam entry point we throw rather than silently degrade
+        // to substring search (callers wanting recall should use `searchFacts`
+        // or the FactStore hybrid lane directly).
+        throw new NotImplementedYet("memory.findSimilar (use FactStore.searchHybrid for vector/hybrid recall)");
+    }
+    async searchNotes(query, opts) {
+        const results = await activeMemoryStore().search(query, opts);
+        return results;
+    }
+    async readNote(relPath, opts) {
+        return activeMemoryStore().read(relPath, opts);
+    }
+    async notesStatus() {
+        return activeMemoryStore().status();
+    }
+    async getExtractCursor(sessionId) {
+        // Asymmetry with setExtractCursor is intentional: the getter flows
+        // through getCursor() (which branches on the runtime context), while the
+        // setter writes the cursor file inline because its writer is private
+        // upstream. Plain filesystem mode reads/writes the same local file.
+        return getCursor(activeWorkspaceDir(), sessionId);
+    }
+    async setExtractCursor(sessionId, processedCount) {
+        // `writeCursor` is private upstream; mirror its tmp+rename semantics
+        // inline so we don't need to widen the module's surface for this PR.
+        const dir = activeWorkspaceDir();
+        const cursorFile = path.join(dir, "memory", ".dreams", "extract-cursor.json");
+        let payload = {
+            version: 1,
+            cursors: {},
+        };
+        try {
+            const raw = fs.readFileSync(cursorFile, "utf8");
+            const parsed = JSON.parse(raw);
+            if (parsed && typeof parsed === "object" && typeof parsed.cursors === "object") {
+                payload = {
+                    version: 1,
+                    cursors: { ...(parsed.cursors ?? {}) },
+                };
+            }
+        }
+        catch {
+            // Fresh / missing / unparseable — proceed with the empty payload.
+        }
+        payload.cursors[sessionId] = processedCount;
+        fs.mkdirSync(path.dirname(cursorFile), { recursive: true });
+        const tmp = `${cursorFile}.tmp-${process.pid}-${Date.now()}`;
+        fs.writeFileSync(tmp, JSON.stringify(payload), "utf8");
+        fs.renameSync(tmp, cursorFile);
+    }
+    async getConsolidateLastRunAt() {
+        const file = path.join(activeWorkspaceDir(), "memory", ".dreams", "consolidate-state.json");
+        try {
+            const parsed = JSON.parse(fs.readFileSync(file, "utf8"));
+            return typeof parsed.lastRunAt === "number" ? parsed.lastRunAt : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async markConsolidateRunAt(at) {
+        // Disk-direct, NOT via markConsolidationRun — that helper branches on
+        // the global runtime context and would write to convex when this store
+        // is a migrate TARGET while the operator is still in convex mode. The
+        // LocalMemoryStore impl must always stamp the local file (mirrors the
+        // inline read in getConsolidateLastRunAt).
+        const file = path.join(activeWorkspaceDir(), "memory", ".dreams", "consolidate-state.json");
+        try {
+            fs.mkdirSync(path.dirname(file), { recursive: true });
+            const tmp = `${file}.tmp-${process.pid}-${Date.now()}`;
+            fs.writeFileSync(tmp, JSON.stringify({ lastRunAt: at }), "utf8");
+            fs.renameSync(tmp, file);
+        }
+        catch {
+            /* best-effort — a missed stamp just reruns consolidation sooner */
+        }
+    }
+    async decay(_now) {
+        // The decay sweep lives in the agent-loop background tick today
+        // (calls FactStore.setLifecycle in a batch per the per-tier
+        // thresholds). Exposing it as a single store-level operation needs
+        // a sweep helper upstream; PR11 leaves it stubbed so callers fall
+        // back to the existing post-turn path.
+        throw new NotImplementedYet("memory.decay (needs upstream sweep helper)");
+    }
+    subscribe(_scope, cb) {
+        // Watch facts.jsonl with the standard 500 ms debounce. Filesystem
+        // mode doesn't surface per-record deltas — we emit a coarse "facts
+        // changed" payload carrying the new active count, which is enough
+        // for the recall + dashboard call sites to know they need to re-read.
+        // Convex mode (PR16) will swap this for a per-row live query.
+        const dir = activeWorkspaceDir();
+        const factsFile = path.join(dir, "memory", "facts.jsonl");
+        return watchFile(factsFile, () => {
+            try {
+                const store = activeFactStore();
+                const all = store.readAll();
+                const activeCount = all.filter((r) => r.lifecycle === "active").length;
+                cb({
+                    kind: "facts-changed",
+                    activeCount,
+                    totalCount: all.length,
+                });
+            }
+            catch {
+                // Mid-write or missing file — skip.
+            }
+        });
+    }
+    // Raw per-record surface — DISK-DIRECT on purpose. FactStore.readAll /
+    // writeAll branch on the global runtime context (convex cache vs disk),
+    // which is wrong when this store is a MIGRATE TARGET while the operator is
+    // still in convex mode (target=local must land on disk, not the cache).
+    // These three always touch the local JSONL, matching the LocalMemoryStore
+    // contract. In plain filesystem mode this is identical to FactStore.readAll.
+    factsFilePath(workspaceId) {
+        return path.join(resolveAgentWorkspaceDir(workspaceId), "memory", "facts.jsonl");
+    }
+    readFactsFromDisk(workspaceId) {
+        let raw;
+        try {
+            raw = fs.readFileSync(this.factsFilePath(workspaceId), "utf8");
+        }
+        catch {
+            return [];
+        }
+        const out = [];
+        for (const line of raw.split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const rec = JSON.parse(trimmed);
+                if (typeof rec.memoryId === "string" && typeof rec.content === "string") {
+                    out.push(rec);
+                }
+            }
+            catch {
+                // Skip a corrupt line rather than failing the whole read.
+            }
+        }
+        return out;
+    }
+    writeFactsToDisk(workspaceId, records) {
+        const file = this.factsFilePath(workspaceId);
+        fs.mkdirSync(path.dirname(file), { recursive: true });
+        const body = records.map((r) => JSON.stringify(r)).join("\n") + (records.length > 0 ? "\n" : "");
+        const tmp = `${file}.tmp-${process.pid}-${Date.now()}`;
+        fs.writeFileSync(tmp, body, "utf8");
+        fs.renameSync(tmp, file);
+    }
+    async listAllFactRecordsRaw(workspaceId) {
+        return this.readFactsFromDisk(workspaceId);
+    }
+    async upsertFactRecordRaw(workspaceId, record) {
+        // Upsert by memoryId — idempotent so a re-run of `store migrate`
+        // reconciles rather than duplicating.
+        const id = record.memoryId;
+        if (!id)
+            return;
+        const all = this.readFactsFromDisk(workspaceId);
+        const idx = all.findIndex((r) => r.memoryId === id);
+        if (idx >= 0)
+            all[idx] = record;
+        else
+            all.push(record);
+        this.writeFactsToDisk(workspaceId, all);
+    }
+    async deleteFactRecordRaw(workspaceId, memoryId) {
+        const all = this.readFactsFromDisk(workspaceId);
+        const next = all.filter((r) => r.memoryId !== memoryId);
+        if (next.length !== all.length)
+            this.writeFactsToDisk(workspaceId, next);
+    }
+}
+//# sourceMappingURL=memory-store.js.map

package/dist/storage/local/memory-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.js","sourceRoot":"","sources":["../../../src/storage/local/memory-store.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,EAAE;AACF,uEAAuE;AACvE,4BAA4B;AAC5B,EAAE;AACF,0BAA0B;AAC1B,gEAAgE;AAChE,sEAAsE;AACtE,4EAA4E;AAC5E,uEAAuE;AACvE,4FAA4F;AAC5F,gFAAgF;AAChF,sFAAsF;AACtF,2EAA2E;AAC3E,+EAA+E;AAC/E,6EAA6E;AAC7E,2EAA2E;AAC3E,qFAAqF;AACrF,EAAE;AACF,2EAA2E;AAC3E,wEAAwE;AACxE,6CAA6C;AAE7C,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EACN,SAAS,GAKT,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAahD;;qEAEqE;AACrE,SAAS,kBAAkB;IAC1B,OAAO,wBAAwB,CAAC,gBAAgB,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,eAAe;IACvB,OAAO,IAAI,SAAS,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,iBAAiB;IACzB,OAAO,IAAI,eAAe,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,OAAO,gBAAgB;IAKC;IAJ7B,2EAA2E;IAC3E,6EAA6E;IAC7E,0EAA0E;IAC1E,iEAAiE;IACjE,YAA6B,SAAiB;QAAjB,cAAS,GAAT,SAAS,CAAQ;IAAG,CAAC;IAElD,KAAK,CAAC,SAAS,CAAC,MAAkB;QACjC,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC,IAAI,CAAC,MAA4B,CAAC,CAAC;QACrE,OAAO,OAAoC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAa;QAC5B,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC,KAAK,CAAC,IAAkC,CAAC,CAAC;QAC3E,OAAO,MAAiC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,WAAW,CAChB,KAAa,EACb,IAA6E;QAE7E,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;YAC9C,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/E,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAoC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3F,CAAC,CAAC;QACH,OAAO,MAA4D,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,SAAmB;QAC1C,eAAe,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,SAAmB,EAAE,SAA0B;QACtE,eAAe,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,gBAAgB;QACrB,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC,OAAO,EAA4B,CAAC;QAClE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,WAAW,CAChB,KAAa,EACb,MAAa,EACb,EAAW;QAEX,mEAAmE;QACnE,wEAAwE;QACxE,oEAAoE;QACpE,uEAAuE;QACvE,yEAAyE;QACzE,uEAAuE;QACvE,0CAA0C;QAC1C,MAAM,IAAI,iBAAiB,CAAC,0EAA0E,CAAC,CAAC;IACzG,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,IAAa;QAC7C,MAAM,OAAO,GAAG,MAAM,iBAAiB,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,IAAa,CAAC,CAAC;QACvE,OAAO,OAA+B,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,IAAa;QAC5C,OAAO,iBAAiB,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,IAAa,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,WAAW;QAChB,OAAO,iBAAiB,EAAE,CAAC,MAAM,EAAE,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,SAAiB;QACvC,mEAAmE;QACnE,yEAAyE;QACzE,qEAAqE;QACrE,oEAAoE;QACpE,OAAO,SAAS,CAAC,kBAAkB,EAAE,EAAE,SAAS,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,SAAiB,EAAE,cAAsB;QAC/D,qEAAqE;QACrE,qEAAqE;QACrE,MAAM,GAAG,GAAG,kBAAkB,EAAE,CAAC;QACjC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAAC;QAC9E,IAAI,OAAO,GAAyD;YACnE,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,EAAE;SACX,CAAC;QACF,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;YAC1D,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAChF,OAAO,GAAG;oBACT,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,EAA4B;iBAChE,CAAC;YACH,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,kEAAkE;QACnE,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,cAAc,CAAC;QAC5C,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,GAAG,UAAU,QAAQ,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC7D,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;QACvD,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,uBAAuB;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CACrB,kBAAkB,EAAE,EACpB,QAAQ,EACR,SAAS,EACT,wBAAwB,CACxB,CAAC;QACF,IAAI,CAAC;YACJ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAA2B,CAAC;YACnF,OAAO,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5E,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,SAAS,CAAC;QAClB,CAAC;IACF,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,EAAU;QACpC,sEAAsE;QACtE,uEAAuE;QACvE,sEAAsE;QACtE,sEAAsE;QACtE,2CAA2C;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CACrB,kBAAkB,EAAE,EACpB,QAAQ,EACR,SAAS,EACT,wBAAwB,CACxB,CAAC;QACF,IAAI,CAAC;YACJ,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,MAAM,GAAG,GAAG,GAAG,IAAI,QAAQ,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YACvD,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;YACjE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACR,mEAAmE;QACpE,CAAC;IACF,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAa;QACxB,gEAAgE;QAChE,4DAA4D;QAC5D,mEAAmE;QACnE,kEAAkE;QAClE,uCAAuC;QACvC,MAAM,IAAI,iBAAiB,CAAC,4CAA4C,CAAC,CAAC;IAC3E,CAAC;IAED,SAAS,CAAC,MAAa,EAAE,EAAgC;QACxD,kEAAkE;QAClE,mEAAmE;QACnE,kEAAkE;QAClE,sEAAsE;QACtE,8DAA8D;QAC9D,MAAM,GAAG,GAAG,kBAAkB,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC1D,OAAO,SAAS,CAAC,SAAS,EAAE,GAAG,EAAE;YAChC,IAAI,CAAC;gBACJ,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;gBAChC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC5B,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;gBACvE,EAAE,CAAC;oBACF,IAAI,EAAE,eAAe;oBACrB,WAAW;oBACX,UAAU,EAAE,GAAG,CAAC,MAAM;iBACI,CAAC,CAAC;YAC9B,CAAC;YAAC,MAAM,CAAC;gBACR,oCAAoC;YACrC,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,uEAAuE;IACvE,wEAAwE;IACxE,2EAA2E;IAC3E,wEAAwE;IACxE,0EAA0E;IAC1E,6EAA6E;IAErE,aAAa,CAAC,WAAmB;QACxC,OAAO,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAClF,CAAC;IAEO,iBAAiB,CAAC,WAAmB;QAC5C,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACJ,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,EAAE,CAAC;QACX,CAAC;QACD,MAAM,GAAG,GAAmB,EAAE,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,IAAI,CAAC;gBACJ,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAA8C,CAAC;gBAC7E,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBACzE,GAAG,CAAC,IAAI,CAAC,GAA8B,CAAC,CAAC;gBAC1C,CAAC;YACF,CAAC;YAAC,MAAM,CAAC;gBACR,0DAA0D;YAC3D,CAAC;QACF,CAAC;QACD,OAAO,GAAG,CAAC;IACZ,CAAC;IAEO,gBAAgB,CAAC,WAAmB,EAAE,OAAuB;QACpE,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QAC7C,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,IAAI,GACT,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACrF,MAAM,GAAG,GAAG,GAAG,IAAI,QAAQ,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACvD,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACpC,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,WAAmB;QAC9C,OAAO,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,WAAmB,EAAE,MAAoB;QAClE,iEAAiE;QACjE,sCAAsC;QACtC,MAAM,EAAE,GAAI,MAAgC,CAAC,QAAQ,CAAC;QACtD,IAAI,CAAC,EAAE;YAAE,OAAO;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAA2B,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC;QAC/E,IAAI,GAAG,IAAI,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;;YAC3B,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtB,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,WAAmB,EAAE,QAAgB;QAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAA2B,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QACnF,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM;YAAE,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC1E,CAAC;CACD"}

package/dist/storage/local/message-store.d.ts

@@ -0,0 +1,27 @@
+import type { MessageStore, PiTranscriptRecord, RepairReport, SystemEvent, Unsub } from "../store.js";
+export declare class LocalMessageStore implements MessageStore {
+    private readonly _stateDir;
+    constructor(_stateDir: string);
+    appendRecord(agentId: string, sessionId: string, record: PiTranscriptRecord): Promise<void>;
+    appendRecordsBatch(agentId: string, sessionId: string, records: PiTranscriptRecord[]): Promise<void>;
+    replaceTranscript(agentId: string, sessionId: string, records: PiTranscriptRecord[]): Promise<void>;
+    readTranscript(agentId: string, sessionId: string, opts?: {
+        limit?: number;
+        tailBytes?: number;
+    }): Promise<PiTranscriptRecord[]>;
+    hasBootstrapDelivered(agentId: string, sessionId: string): Promise<boolean>;
+    markBootstrapDelivered(agentId: string, sessionId: string): Promise<void>;
+    deleteTranscript(agentId: string, sessionId: string): Promise<void>;
+    repairIfNeeded(agentId: string, sessionId: string): Promise<RepairReport>;
+    withWriteLock<T>(agentId: string, sessionId: string, fn: () => Promise<T>, opts?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<T>;
+    subscribe(sessionId: string, cb: (msg: PiTranscriptRecord) => void): Unsub;
+    inboxEnqueue(sessionKey: string, event: SystemEvent): Promise<boolean>;
+    inboxDrain(sessionKey: string): Promise<SystemEvent[]>;
+    inboxConsumePrefix(sessionKey: string, prefix: readonly SystemEvent[]): Promise<SystemEvent[]>;
+    inboxPeek(sessionKey: string): Promise<SystemEvent[]>;
+    inboxHasEvents(sessionKey: string): Promise<boolean>;
+}
+//# sourceMappingURL=message-store.d.ts.map

package/dist/storage/local/message-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-store.d.ts","sourceRoot":"","sources":["../../../src/storage/local/message-store.ts"],"names":[],"mappings":"AA0EA,OAAO,KAAK,EACX,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,KAAK,EACL,MAAM,aAAa,CAAC;AAmCrB,qBAAa,iBAAkB,YAAW,YAAY;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM;IAExC,YAAY,CACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,kBAAkB,GACxB,OAAO,CAAC,IAAI,CAAC;IA6BV,kBAAkB,CACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kBAAkB,EAAE,GAC3B,OAAO,CAAC,IAAI,CAAC;IAYV,iBAAiB,CACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kBAAkB,EAAE,GAC3B,OAAO,CAAC,IAAI,CAAC;IAWV,cAAc,CACnB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAM1B,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3E,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzE,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWnE,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAMzE,aAAa,CAAC,CAAC,EACpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjD,OAAO,CAAC,CAAC,CAAC;IAkBb,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAAG,KAAK;IAoCpE,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBtE,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKtD,kBAAkB,CACvB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,WAAW,EAAE,GAC5B,OAAO,CAAC,WAAW,EAAE,CAAC;IAKnB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKrD,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAG1D"}

package/dist/storage/local/message-store.js

@@ -0,0 +1,253 @@
+// src/storage/local/message-store.ts
+//
+// LocalMessageStore — filesystem-mode wrapper around Pi SDK's
+// `SessionManager` (transcript JSONL) + `src/sessions/{bootstrap-marker,
+// session-file-repair, session-write-lock, transcript-reader}.ts` + the
+// in-process `src/agents/session-inbox.ts` queue. Implements `MessageStore`.
+//
+// PR14 design notes (judged across two parallel proposals + adversarial
+// review — see `project_brigade_phase_2_user_flow` memory):
+//
+//   • `appendRecord` dispatches by `record.type`:
+//     - "custom"  → SessionManager.open(path).appendCustomEntry(...) so
+//                   Pi mints a valid `id` via generateId(byId) and the
+//                   parentId tree stays intact.
+//     - anything else → throws NotImplementedYet. Today the ONLY caller
+//                       of `MessageStore.appendRecord` is the bootstrap-
+//                       marker path (custom records); broader writes
+//                       still go through agent-loop's own SessionManager
+//                       handle. Convex mode (PR16) gets the full surface.
+//
+//   • `withWriteLock` uses the CROSS-PROCESS file lock from session-write-
+//     lock.ts (`acquireSessionWriteLock`) — NOT the sessions.json sync
+//     mutex. Two locks, two domains. The sync mutex covers sessions.json
+//     read-modify-write; this one covers the per-session JSONL transcript.
+//
+//   • `readTranscript` goes through the new shared
+//     `src/sessions/transcript-reader.ts` helper so callers never have to
+//     re-open a SessionManager just to read history (re-open re-parses
+//     the whole JSONL — see judge risk #2).
+//
+//   • `subscribe(sessionId, cb)` watches the per-session JSONL with a
+//     byte cursor + truncation-resync (Pi rewrites the file on V1→V2
+//     migration + createBranchedSession — judge risk #3). The agentId
+//     needed to resolve the on-disk path is recovered by walking
+//     `<stateDir>/agents/*/sessions/<sessionId>.jsonl` lazily on first
+//     fire.
+//
+//   • Inbox methods delegate verbatim to `agents/session-inbox.ts` — the
+//     in-process Map is THE source of truth + the env-gated disk mirror
+//     handles persistence. We must NOT bypass it (cross-process consumers
+//     in agent-loop expect the same Map).
+import { existsSync, readdirSync, statSync } from "node:fs";
+import * as fsAsync from "node:fs/promises";
+import path from "node:path";
+import { SessionManager } from "@mariozechner/pi-coding-agent";
+import { consumeSystemEventEntries, drainSystemEventEntries, enqueueSystemEvent, hasSystemEvents, peekSystemEventEntries, } from "../../agents/session-inbox.js";
+import { hasDeliveredBootstrapToSession, markBootstrapDeliveredToSession, } from "../../sessions/bootstrap-marker.js";
+import { repairSessionFileIfNeeded } from "../../sessions/session-file-repair.js";
+import { acquireSessionWriteLock } from "../../sessions/session-write-lock.js";
+import { readTranscriptRecords, tailTranscriptSince, } from "../../sessions/transcript-reader.js";
+import { resolveAgentDir, resolveSessionTranscriptPath, resolveStateDir, } from "../../config/paths.js";
+import { NotImplementedYet } from "../store.js";
+import { watchFile } from "./file-watcher.js";
+/** Lazy walker for `<stateDir>/agents/<id>/sessions/<sessionId>.jsonl`. Used
+ *  by `subscribe(sessionId, cb)` which doesn't get an agentId. Process-
+ *  scoped cache so repeat lookups are O(1). */
+const SESSION_AGENT_CACHE = new Map();
+function findAgentIdForSessionId(sessionId) {
+    const cached = SESSION_AGENT_CACHE.get(sessionId);
+    if (cached)
+        return cached;
+    const agentsRoot = path.join(resolveStateDir(), "agents");
+    let agentNames;
+    try {
+        agentNames = readdirSync(agentsRoot);
+    }
+    catch {
+        return undefined;
+    }
+    for (const agentId of agentNames) {
+        const transcript = path.join(resolveAgentDir(agentId), "sessions", `${sessionId}.jsonl`);
+        try {
+            if (statSync(transcript).isFile()) {
+                SESSION_AGENT_CACHE.set(sessionId, agentId);
+                return agentId;
+            }
+        }
+        catch {
+            // Skip — not the right agent.
+        }
+    }
+    return undefined;
+}
+export class LocalMessageStore {
+    _stateDir;
+    constructor(_stateDir) {
+        this._stateDir = _stateDir;
+    }
+    async appendRecord(agentId, sessionId, record) {
+        // PR14 supports ONLY the `custom` record type. The interface signature
+        // invites future caller shapes (full Pi entries from cron / channel
+        // inbound paths) — those land when their PRs need them. Pi's
+        // `SessionManager.open` mints a valid id/parentId pair which a raw
+        // fs.appendFile cannot fabricate without re-parsing the file.
+        if (record.type !== "custom") {
+            throw new NotImplementedYet(`messages.appendRecord type=${String(record.type)} ` +
+                "(only 'custom' is wired in PR14 — see message-store.ts header)");
+        }
+        const customType = record.customType;
+        if (typeof customType !== "string" || customType.length === 0) {
+            throw new Error("messages.appendRecord: custom record requires `customType`");
+        }
+        const data = record.data;
+        const transcriptPath = resolveSessionTranscriptPath(agentId, sessionId);
+        const sm = SessionManager.open(transcriptPath);
+        if (typeof sm.appendCustomEntry !== "function") {
+            throw new Error("messages.appendRecord: Pi SessionManager.appendCustomEntry is unavailable — pin pi-coding-agent to 0.73.x or compatible");
+        }
+        sm.appendCustomEntry(customType, data);
+    }
+    async appendRecordsBatch(agentId, sessionId, records) {
+        // Filesystem mode never uses the batch path — Pi's SessionManager owns
+        // the JSONL and appends inline. Realise as raw line appends for the
+        // migrate engine's benefit only.
+        const transcriptPath = resolveSessionTranscriptPath(agentId, sessionId);
+        const lines = records.map((r) => `${JSON.stringify(r)}\n`).join("");
+        const { appendFileSync, mkdirSync } = await import("node:fs");
+        const { dirname } = await import("node:path");
+        mkdirSync(dirname(transcriptPath), { recursive: true });
+        appendFileSync(transcriptPath, lines, "utf8");
+    }
+    async replaceTranscript(agentId, sessionId, records) {
+        const transcriptPath = resolveSessionTranscriptPath(agentId, sessionId);
+        const body = records.map((r) => `${JSON.stringify(r)}\n`).join("");
+        const { mkdirSync, renameSync, writeFileSync } = await import("node:fs");
+        const { dirname } = await import("node:path");
+        mkdirSync(dirname(transcriptPath), { recursive: true });
+        const tmp = `${transcriptPath}.tmp-${process.pid}-${Date.now().toString(36)}`;
+        writeFileSync(tmp, body, "utf8");
+        renameSync(tmp, transcriptPath);
+    }
+    async readTranscript(agentId, sessionId, opts) {
+        const transcriptPath = resolveSessionTranscriptPath(agentId, sessionId);
+        const rows = readTranscriptRecords(transcriptPath, opts ?? {});
+        return rows;
+    }
+    async hasBootstrapDelivered(agentId, sessionId) {
+        const transcriptPath = resolveSessionTranscriptPath(agentId, sessionId);
+        return hasDeliveredBootstrapToSession(transcriptPath);
+    }
+    async markBootstrapDelivered(agentId, sessionId) {
+        // Bootstrap delivery happens at most once per session lifetime, so the
+        // SessionManager re-open here is fine (judge risk #2 — once-per-session
+        // cost is acceptable). Production callers inside agent-loop pass their
+        // own SessionManager directly to `markBootstrapDeliveredToSession`; the
+        // adapter exists for paths that DON'T already hold a handle (cron
+        // follow-ups, channel re-entry flows).
+        const transcriptPath = resolveSessionTranscriptPath(agentId, sessionId);
+        const sm = SessionManager.open(transcriptPath);
+        markBootstrapDeliveredToSession(sm);
+    }
+    async deleteTranscript(agentId, sessionId) {
+        const transcriptPath = resolveSessionTranscriptPath(agentId, sessionId);
+        try {
+            await fsAsync.rm(transcriptPath, { force: true });
+        }
+        catch {
+            // Match existing call-site behaviour (`session-reaper.ts:111`,
+            // `subagent-runner.ts:203`) — best-effort delete, missing file is
+            // not an error.
+        }
+    }
+    async repairIfNeeded(agentId, sessionId) {
+        const transcriptPath = resolveSessionTranscriptPath(agentId, sessionId);
+        const report = await repairSessionFileIfNeeded({ sessionFile: transcriptPath });
+        return report;
+    }
+    async withWriteLock(agentId, sessionId, fn, opts) {
+        const transcriptPath = resolveSessionTranscriptPath(agentId, sessionId);
+        const lock = await acquireSessionWriteLock({
+            sessionFile: transcriptPath,
+            ...(opts?.timeoutMs !== undefined ? { timeoutMs: opts.timeoutMs } : {}),
+            ...(opts?.signal !== undefined ? { signal: opts.signal } : {}),
+        });
+        try {
+            return await fn();
+        }
+        finally {
+            try {
+                await lock.release();
+            }
+            catch {
+                // Idempotent release; stale-steal cleans up if this errors.
+            }
+        }
+    }
+    subscribe(sessionId, cb) {
+        const agentId = findAgentIdForSessionId(sessionId);
+        if (!agentId) {
+            // Transcript doesn't exist yet; nothing to watch. Return a no-op
+            // unsub so callers stay compositional. (Re-subscribing after
+            // SessionManager.open creates the file works on the next call.)
+            return () => undefined;
+        }
+        const transcriptPath = resolveSessionTranscriptPath(agentId, sessionId);
+        let cursor = 0;
+        try {
+            cursor = existsSync(transcriptPath) ? statSync(transcriptPath).size : 0;
+        }
+        catch {
+            cursor = 0;
+        }
+        return watchFile(transcriptPath, () => {
+            // `tailTranscriptSince` handles truncation by resetting the cursor
+            // to 0 — Pi rewrites the JSONL on V1→V2 migration and on
+            // `createBranchedSession`, so a naive lastSize-only tracker would
+            // miss the new contents (judge risk #3).
+            const { records, newCursor } = tailTranscriptSince(transcriptPath, cursor);
+            cursor = newCursor;
+            for (const row of records) {
+                try {
+                    cb(row);
+                }
+                catch {
+                    // One bad subscriber doesn't poison the rest of the batch.
+                }
+            }
+        });
+    }
+    // ---------------------------------------------------------------------
+    // Inbox (system-events JSONL via in-process queue + env-gated disk mirror)
+    // ---------------------------------------------------------------------
+    async inboxEnqueue(sessionKey, event) {
+        const e = event;
+        const text = typeof e.text === "string" ? e.text : "";
+        if (!text)
+            return false;
+        return enqueueSystemEvent(text, {
+            sessionKey,
+            ...(e.contextKey !== undefined ? { contextKey: e.contextKey ?? undefined } : {}),
+            ...(e.deliveryContext !== undefined
+                ? { deliveryContext: e.deliveryContext }
+                : {}),
+            ...(e.trusted !== undefined ? { trusted: e.trusted } : {}),
+        });
+    }
+    async inboxDrain(sessionKey) {
+        const events = drainSystemEventEntries(sessionKey);
+        return events;
+    }
+    async inboxConsumePrefix(sessionKey, prefix) {
+        const consumed = consumeSystemEventEntries(sessionKey, prefix);
+        return consumed;
+    }
+    async inboxPeek(sessionKey) {
+        const events = peekSystemEventEntries(sessionKey);
+        return events;
+    }
+    async inboxHasEvents(sessionKey) {
+        return hasSystemEvents(sessionKey);
+    }
+}
+//# sourceMappingURL=message-store.js.map

package/dist/storage/local/message-store.js.map

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

package/dist/storage/local/org-store.d.ts

@@ -0,0 +1,39 @@
+import type { OrgDeriveAuditEntry, OrgStore } from "../store.js";
+export declare class LocalOrgStore implements OrgStore {
+    private readonly _stateDir;
+    constructor(_stateDir: string);
+    appendDeriveAudit(entry: OrgDeriveAuditEntry): Promise<void>;
+    listDeriveAudit(filter?: {
+        since?: string;
+        limit?: number;
+    }): Promise<OrgDeriveAuditEntry[]>;
+    getChartImage(hash: string): Promise<{
+        bytes: Uint8Array;
+        width: number;
+        height: number;
+        mimeType: "image/png";
+        mtimeMs: number;
+    } | undefined>;
+    putChartImage(hash: string, bytes: Uint8Array, _meta: {
+        width: number;
+        height: number;
+        themeId: string;
+        themeName: string;
+        mimeType: "image/png";
+    }): Promise<{
+        locator: string;
+    }>;
+    deleteChartImage(hash: string): Promise<void>;
+    listChartImages(): Promise<Array<{
+        hash: string;
+        mtimeMs: number;
+        bytes: number;
+    }>>;
+    markChartTransient(locator: string): void;
+    consumeChartTransient(locator: string): boolean;
+    gcChartImages(opts?: {
+        maxAgeMs?: number;
+        maxFiles?: number;
+    }): Promise<void>;
+}
+//# sourceMappingURL=org-store.d.ts.map

package/dist/storage/local/org-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-store.d.ts","sourceRoot":"","sources":["../../../src/storage/local/org-store.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAUjE,qBAAa,aAAc,YAAW,QAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM;IAExC,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5D,eAAe,CACpB,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACzC,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA0B3B,aAAa,CAClB,IAAI,EAAE,MAAM,GACV,OAAO,CACP;QACA,KAAK,EAAE,UAAU,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,WAAW,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;KACf,GACD,SAAS,CACX;IAuBK,aAAa,CAClB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,WAAW,CAAC;KACtB,GACC,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAczB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7C,eAAe,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAuBzF,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIzC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIzC,aAAa,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAMnF"}