@sema-agent/core 1.279.0

package/dist/stores/file/tool-result-store.js

@@ -0,0 +1,44 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { ensureDir, sanitizePathComponent, writeThenLink } from "./fs-atomic.js";
+export class FileToolResultStore {
+    dir;
+    constructor(root) {
+        this.dir = join(root, "tool-results");
+        ensureDir(this.dir);
+    }
+    pathFor(ref) {
+        return join(this.dir, `${sanitizePathComponent(ref)}.txt`);
+    }
+    put(ref, content) {
+        try {
+            writeThenLink(this.pathFor(ref), content);
+        }
+        catch (err) {
+            if (err.code === "EEXIST")
+                return;
+            throw err;
+        }
+    }
+    get(ref, opts) {
+        let full;
+        try {
+            full = readFileSync(this.pathFor(ref), "utf8");
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                return undefined;
+            if (err instanceof Error && err.message.startsWith("file store: unsafe path component"))
+                return undefined;
+            throw err;
+        }
+        const offset = Math.min(full.length, Math.max(0, intOr(opts?.offset, 0)));
+        const limit = opts?.limit != null ? Math.max(0, intOr(opts.limit, 0)) : undefined;
+        const content = limit != null ? full.slice(offset, offset + limit) : full.slice(offset);
+        return { content, offset, totalChars: full.length };
+    }
+}
+function intOr(x, fallback) {
+    return Number.isFinite(x) ? Math.floor(x) : fallback;
+}
+//# sourceMappingURL=tool-result-store.js.map

package/dist/stores/file/tool-result-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-store.js","sourceRoot":"","sources":["../../../src/stores/file/tool-result-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAajF,MAAM,OAAO,mBAAmB;IACb,GAAG,CAAS;IAE7B,YAAY,IAAY;QACtB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QACtC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAEO,OAAO,CAAC,GAAW;QAEzB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7D,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,OAAe;QAC9B,IAAI,CAAC;YAGH,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO;YAC7D,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,IAA0C;QACzD,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAEvE,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,mCAAmC,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC1G,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAClF,MAAM,OAAO,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACxF,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IACtD,CAAC;CACF;AAGD,SAAS,KAAK,CAAC,CAAqB,EAAE,QAAgB;IACpD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACjE,CAAC"}

package/dist/stores/file/workflow-journal-store.d.ts

@@ -0,0 +1,17 @@
+import { type WorkflowJournalEntry, type WorkflowJournalStore } from "../../core/workflow-journal-store.js";
+export declare const MAX_JOURNAL_RESULT_BYTES: number;
+export declare function oversizeJournalResult(serialized: string): boolean;
+export declare class FileWorkflowJournalStore implements WorkflowJournalStore {
+    private readonly fsyncEnabled;
+    private readonly dir;
+    private readonly fds;
+    private readonly scopes;
+    constructor(root: string, fsyncEnabled?: boolean);
+    private pathFor;
+    private replay;
+    append(runId: string, scope: string, entry: WorkflowJournalEntry): Promise<void>;
+    load(runId: string, scope: string): Promise<WorkflowJournalEntry[]>;
+    deleteByRun(runId: string): Promise<number>;
+    dispose(): void;
+}
+//# sourceMappingURL=workflow-journal-store.d.ts.map

package/dist/stores/file/workflow-journal-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-journal-store.d.ts","sourceRoot":"","sources":["../../../src/stores/file/workflow-journal-store.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAkB,KAAK,oBAAoB,EAAE,KAAK,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAgB5H,eAAO,MAAM,wBAAwB,QAAkB,CAAC;AAGxD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEjE;AASD,qBAAa,wBAAyB,YAAW,oBAAoB;IAQzC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAPvD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA6B;IAIjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;gBAExC,IAAI,EAAE,MAAM,EAAmB,YAAY,UAAO;IAK9D,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,MAAM;IA6BR,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBhF,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAOnE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAcjD,OAAO,IAAI,IAAI;CAMhB"}

package/dist/stores/file/workflow-journal-store.js

@@ -0,0 +1,104 @@
+import { closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, unlinkSync, writeSync } from "node:fs";
+import { join } from "node:path";
+import { callKeyOrdinal } from "../../core/workflow-journal-store.js";
+import { sanitizePathComponent } from "./fs-atomic.js";
+export const MAX_JOURNAL_RESULT_BYTES = 5 * 1024 * 1024;
+export function oversizeJournalResult(serialized) {
+    return Buffer.byteLength(serialized, "utf8") > MAX_JOURNAL_RESULT_BYTES;
+}
+export class FileWorkflowJournalStore {
+    fsyncEnabled;
+    dir;
+    fds = new Map();
+    scopes = new Map();
+    constructor(root, fsyncEnabled = true) {
+        this.fsyncEnabled = fsyncEnabled;
+        this.dir = join(root, "workflow-journal");
+        mkdirSync(this.dir, { recursive: true, mode: 0o700 });
+    }
+    pathFor(runId) {
+        return join(this.dir, `${sanitizePathComponent(runId)}.jsonl`);
+    }
+    replay(runId) {
+        let path;
+        try {
+            path = this.pathFor(runId);
+        }
+        catch {
+            return undefined;
+        }
+        if (!existsSync(path))
+            return undefined;
+        let scope;
+        const byOrdinal = new Map();
+        for (const line of readFileSync(path, "utf8").split("\n")) {
+            if (!line.trim())
+                continue;
+            let rec;
+            try {
+                rec = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            if (typeof rec.callKey !== "string" || typeof rec.scope !== "string")
+                continue;
+            scope = scope ?? rec.scope;
+            if (rec.scope !== scope)
+                continue;
+            byOrdinal.set(rec.ordinal, { callKey: rec.callKey, result: rec.result });
+        }
+        return scope === undefined ? undefined : { scope, byOrdinal };
+    }
+    async append(runId, scope, entry) {
+        const serialized = JSON.stringify(entry.result);
+        if (oversizeJournalResult(serialized))
+            return;
+        const committed = this.scopes.get(runId) ?? this.replay(runId)?.scope;
+        if (committed !== undefined && committed !== scope) {
+            throw new Error(`workflow journal: runId ${runId} already recorded under a different scope`);
+        }
+        this.scopes.set(runId, committed ?? scope);
+        let fd = this.fds.get(runId);
+        if (fd === undefined) {
+            fd = openSync(this.pathFor(runId), "a", 0o600);
+            this.fds.set(runId, fd);
+        }
+        const line = { scope, ordinal: callKeyOrdinal(entry.callKey), callKey: entry.callKey, result: entry.result };
+        writeSync(fd, `${JSON.stringify(line)}\n`);
+        if (this.fsyncEnabled)
+            fsyncSync(fd);
+    }
+    async load(runId, scope) {
+        const rec = this.replay(runId);
+        if (!rec || rec.scope !== scope)
+            return [];
+        return [...rec.byOrdinal.entries()].sort((a, b) => a[0] - b[0]).map(([, e]) => e);
+    }
+    async deleteByRun(runId) {
+        const fd = this.fds.get(runId);
+        if (fd !== undefined) {
+            try {
+                closeSync(fd);
+            }
+            catch { }
+            this.fds.delete(runId);
+        }
+        this.scopes.delete(runId);
+        const path = this.pathFor(runId);
+        if (!existsSync(path))
+            return 0;
+        unlinkSync(path);
+        return 1;
+    }
+    dispose() {
+        for (const fd of this.fds.values()) {
+            try {
+                closeSync(fd);
+            }
+            catch { }
+        }
+        this.fds.clear();
+    }
+}
+//# sourceMappingURL=workflow-journal-store.js.map

package/dist/stores/file/workflow-journal-store.js.map

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

package/dist/stores/file/workflow-run-store.d.ts

@@ -0,0 +1,41 @@
+import { type WorkflowRunStore, type WorkflowRunSummary } from "../../core/workflow-run-store.js";
+import type { WorkflowRun, WorkflowRunStatus } from "../../orchestration/workflow.js";
+export interface FileWorkflowRunStoreOptions {
+    fsync?: boolean;
+    compactEvery?: number;
+}
+export declare class FileWorkflowRunStore implements WorkflowRunStore {
+    private readonly dir;
+    private readonly tmpDir;
+    private readonly ledgerPath;
+    private readonly snapshotPath;
+    private readonly fsyncEnabled;
+    private readonly compactEvery;
+    private readonly runs;
+    private readonly locks;
+    private ledgerEvents;
+    private log;
+    constructor(root: string, opts?: FileWorkflowRunStoreOptions);
+    private replay;
+    private applyEvent;
+    private withLock;
+    private commit;
+    put(id: string, run: WorkflowRun): Promise<void>;
+    get(id: string): Promise<WorkflowRun | null>;
+    update(id: string, scope: string, run: WorkflowRun, expect?: {
+        rev: number;
+    }): Promise<boolean>;
+    listByScope(scope: string, opts?: {
+        status?: WorkflowRunStatus;
+        limit?: number;
+    }): Promise<WorkflowRunSummary[]>;
+    reap(scope: string, now: number, opts?: {
+        maxAgeMs?: number;
+        keep?: number;
+    }): Promise<number>;
+    private compact;
+    compactNow(): void;
+    get size(): number;
+    close(): void;
+}
+//# sourceMappingURL=workflow-run-store.d.ts.map

package/dist/stores/file/workflow-run-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-run-store.d.ts","sourceRoot":"","sources":["../../../src/stores/file/workflow-run-store.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AA6BtF,MAAM,WAAW,2BAA2B;IAE1C,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAGtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkC;IAEvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAE7D,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,GAAG,CAAY;gBAEX,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,2BAAgC;IAchE,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,MAAM;IAOR,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAahD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK5C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAqB/F,WAAW,CACf,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,iBAAiB,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACpD,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAU1B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAwCpG,OAAO,CAAC,OAAO;IAUf,UAAU,IAAI,IAAI;IAKlB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAGD,KAAK,IAAI,IAAI;CAGd"}

package/dist/stores/file/workflow-run-store.js

@@ -0,0 +1,147 @@
+import { join } from "node:path";
+import { WorkflowRunStoreError, isTerminalWorkflowStatus, summarizeWorkflowRun, } from "../../core/workflow-run-store.js";
+import { AppendLog, atomicWriteFile, ensureDir, readJsonlRecords } from "./fs-atomic.js";
+export class FileWorkflowRunStore {
+    dir;
+    tmpDir;
+    ledgerPath;
+    snapshotPath;
+    fsyncEnabled;
+    compactEvery;
+    runs = new Map();
+    locks = new Map();
+    ledgerEvents = 0;
+    log;
+    constructor(root, opts = {}) {
+        this.dir = join(root, "workflow-runs");
+        this.tmpDir = join(root, "tmp");
+        this.ledgerPath = join(this.dir, "runs.jsonl");
+        this.snapshotPath = join(this.dir, "runs.snapshot.jsonl");
+        this.fsyncEnabled = opts.fsync !== false;
+        this.compactEvery = opts.compactEvery ?? 1000;
+        ensureDir(this.dir);
+        ensureDir(this.tmpDir);
+        this.replay();
+        this.log = new AppendLog(this.ledgerPath);
+    }
+    replay() {
+        for (const snap of readJsonlRecords(this.snapshotPath)) {
+            this.runs.set(snap.id, snap);
+        }
+        const events = readJsonlRecords(this.ledgerPath);
+        this.ledgerEvents = events.length;
+        for (const ev of events)
+            this.applyEvent(ev);
+    }
+    applyEvent(ev) {
+        if (ev.t === "delete") {
+            this.runs.delete(ev.id);
+            return;
+        }
+        this.runs.set(ev.id, ev.run);
+    }
+    withLock(id, fn) {
+        const prev = this.locks.get(id) ?? Promise.resolve();
+        const run = prev.then(() => fn(), () => fn());
+        const tail = run.then(() => { }, () => { });
+        this.locks.set(id, tail);
+        void tail.then(() => {
+            if (this.locks.get(id) === tail)
+                this.locks.delete(id);
+        });
+        return run;
+    }
+    commit(ev, fsync) {
+        this.log.append(ev, fsync);
+        this.applyEvent(ev);
+        this.ledgerEvents++;
+        if (this.ledgerEvents >= this.compactEvery)
+            this.compact();
+    }
+    async put(id, run) {
+        return this.withLock(id, () => {
+            if (this.runs.has(id)) {
+                throw new WorkflowRunStoreError("workflow_run.already_exists", `workflow run id already exists`);
+            }
+            const stored = structuredClone(run);
+            stored.id = id;
+            stored.rev = run.rev ?? 0;
+            this.commit({ t: "put", id, run: stored }, this.fsyncEnabled);
+        });
+    }
+    async get(id) {
+        const run = this.runs.get(id);
+        return run ? structuredClone(run) : null;
+    }
+    async update(id, scope, run, expect) {
+        return this.withLock(id, () => {
+            const cur = this.runs.get(id);
+            if (!cur || cur.scope !== scope) {
+                return false;
+            }
+            if (expect !== undefined && (cur.rev ?? 0) !== expect.rev) {
+                return false;
+            }
+            const next = structuredClone(run);
+            next.id = id;
+            next.scope = scope;
+            next.rev = (cur.rev ?? 0) + 1;
+            this.commit({ t: "update", id, run: next }, this.fsyncEnabled);
+            return true;
+        });
+    }
+    async listByScope(scope, opts) {
+        const rows = [...this.runs.values()].filter((r) => r.scope === scope && (opts?.status === undefined || r.status === opts.status));
+        rows.sort((a, b) => b.createdAt - a.createdAt);
+        const limited = opts?.limit !== undefined ? rows.slice(0, Math.max(0, opts.limit)) : rows;
+        return limited.map(summarizeWorkflowRun);
+    }
+    async reap(scope, now, opts) {
+        if (opts?.maxAgeMs === undefined && opts?.keep === undefined)
+            return 0;
+        const terminal = [...this.runs.values()].filter((r) => r.scope === scope && isTerminalWorkflowStatus(r.status));
+        terminal.sort((a, b) => b.createdAt - a.createdAt);
+        const doomed = [];
+        for (let i = 0; i < terminal.length; i++) {
+            const r = terminal[i];
+            const tooOld = opts.maxAgeMs !== undefined && (r.endedAt ?? r.createdAt) < now - opts.maxAgeMs;
+            const overKeep = opts.keep !== undefined && i >= opts.keep;
+            if (tooOld || overKeep)
+                doomed.push({ id: r.id, byAge: tooOld });
+        }
+        let n = 0;
+        for (const { id, byAge } of doomed) {
+            const deleted = await this.withLock(id, () => {
+                const live = this.runs.get(id);
+                if (!live || live.scope !== scope || !isTerminalWorkflowStatus(live.status))
+                    return false;
+                if (byAge && opts.maxAgeMs !== undefined && (live.endedAt ?? live.createdAt) >= now - opts.maxAgeMs) {
+                    return false;
+                }
+                this.commit({ t: "delete", id }, this.fsyncEnabled);
+                return true;
+            });
+            if (deleted)
+                n++;
+        }
+        return n;
+    }
+    compact() {
+        const lines = [...this.runs.values()].map((r) => JSON.stringify(r)).join("\n");
+        atomicWriteFile(this.tmpDir, this.snapshotPath, lines.length ? `${lines}\n` : "");
+        this.log.close();
+        atomicWriteFile(this.tmpDir, this.ledgerPath, "");
+        this.log = new AppendLog(this.ledgerPath);
+        this.ledgerEvents = 0;
+    }
+    compactNow() {
+        this.compact();
+    }
+    get size() {
+        return this.runs.size;
+    }
+    close() {
+        this.log.close();
+    }
+}
+//# sourceMappingURL=workflow-run-store.js.map

package/dist/stores/file/workflow-run-store.js.map

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

package/dist/stores/pg.d.ts

@@ -0,0 +1,96 @@
+import { Session } from "../internal/harness.js";
+import type { SessionMetadata, SessionRepo } from "../internal/harness.js";
+import { type Checkpoint, type CheckpointStore, type CheckpointSummary, type CheckpointToken, type ReopenReason, type ResolveExpectation, type ResumeOutcome } from "../core/checkpoint-store.js";
+import { type MemoryNoteHeader, type MemoryNoteRecord, type MemoryStore, type MemoryVectorMode, type ScoredMemory, type StructuredNoteInput } from "../core/memory.js";
+import type { ToolResultSlice, ToolResultStore } from "../core/tool-result-store.js";
+export interface PgQueryResult {
+    rows: Array<Record<string, unknown>>;
+}
+export type PgQueryFn = (text: string, params?: unknown[]) => Promise<PgQueryResult>;
+export declare const PG_AGENT_TABLES: {
+    readonly sessions: "agent_sessions";
+    readonly sessionEntries: "agent_session_entries";
+    readonly checkpoints: "agent_checkpoints";
+    readonly memory: "agent_memory";
+    readonly memoryCursor: "agent_memory_cursor";
+    readonly toolResults: "agent_tool_results";
+};
+export interface PgAgentSchemaOptions {
+    memoryVector?: {
+        dimensions: number;
+        pgvector?: boolean;
+    };
+}
+export declare function ensurePgAgentSchema(query: PgQueryFn, opts?: PgAgentSchemaOptions): Promise<void>;
+export declare function isUniqueViolation(err: unknown): boolean;
+export declare class PgSessionRepo implements SessionRepo {
+    private readonly query;
+    constructor(query: PgQueryFn);
+    private load;
+    create(options?: {
+        id?: string;
+    }): Promise<Session>;
+    open(metadata: SessionMetadata): Promise<Session>;
+    list(): Promise<SessionMetadata[]>;
+    delete(metadata: SessionMetadata): Promise<void>;
+    fork(sourceMetadata: SessionMetadata, options?: {
+        entryId?: string;
+        position?: "before" | "at";
+        id?: string;
+    }): Promise<Session>;
+}
+export declare class PgCheckpointStore implements CheckpointStore {
+    private readonly query;
+    constructor(query: PgQueryFn);
+    put(token: CheckpointToken, cp: Checkpoint): Promise<void>;
+    get(token: CheckpointToken): Promise<Checkpoint | null>;
+    resolve(token: CheckpointToken, scope: string, outcome: ResumeOutcome, expect?: ResolveExpectation): Promise<boolean>;
+    reopen(token: CheckpointToken, scope: string, reason: ReopenReason): Promise<boolean>;
+    setPendingSteer(token: CheckpointToken, scope: string, steer: {
+        text: string;
+        trusted: boolean;
+    }): Promise<boolean>;
+    expire(token: CheckpointToken, scope: string): Promise<boolean>;
+    reap(scope: string, cutoff: number): Promise<number>;
+    listByScope(scope: string): Promise<CheckpointSummary[]>;
+}
+export declare class PgToolResultStore implements ToolResultStore {
+    private readonly query;
+    constructor(query: PgQueryFn);
+    put(ref: string, content: string): Promise<void>;
+    get(ref: string, opts?: {
+        offset?: number;
+        limit?: number;
+    }): Promise<ToolResultSlice | undefined>;
+}
+export interface PgEmbedder {
+    embed(text: string): Promise<number[]>;
+    dimensions: number;
+}
+export interface PgMemoryStoreOptions {
+    embedder?: PgEmbedder;
+    pgvectorSql?: boolean;
+}
+export declare class PgMemoryStore implements MemoryStore {
+    private readonly query;
+    private readonly embedder?;
+    private readonly pgvectorSql;
+    get vectorMode(): MemoryVectorMode;
+    constructor(query: PgQueryFn, opts?: PgMemoryStoreOptions);
+    private embeddingParam;
+    read(scope: string): Promise<string | null>;
+    append(scope: string, note: string): Promise<string | void>;
+    appendStructured(scope: string, note: StructuredNoteInput): Promise<string>;
+    private insert;
+    clear(scope: string): Promise<void>;
+    getConsolidationCursor(scope: string): Promise<string | undefined>;
+    setConsolidationCursor(scope: string, cursor: string): Promise<void>;
+    search(scope: string, query: string, limit?: number): Promise<string[]>;
+    searchScored(scope: string, query: string, limit?: number): Promise<ScoredMemory[]>;
+    update(scope: string, id: string, text: string): Promise<void>;
+    delete(scope: string, id: string): Promise<void>;
+    listStructuredNotes(scope: string): Promise<MemoryNoteHeader[]>;
+    getByIds(scope: string, ids: string[]): Promise<MemoryNoteRecord[]>;
+    private toHeader;
+}
+//# sourceMappingURL=pg.d.ts.map

package/dist/stores/pg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg.d.ts","sourceRoot":"","sources":["../../src/stores/pg.ts"],"names":[],"mappings":"AA0BA,OAAO,EAEL,OAAO,EAIR,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EAGZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EAEvB,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACzB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAIrF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtC;AAMD,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAGrF,eAAO,MAAM,eAAe;;;;;;;CAQlB,CAAC;AAGX,MAAM,WAAW,oBAAoB;IAUnC,YAAY,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3D;AAOD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkF1G;AAKD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAMvD;AA2ED,qBAAa,aAAc,YAAW,WAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,SAAS;YAE/B,IAAI;IA2BZ,MAAM,CAAC,OAAO,GAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBvD,IAAI,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAcjD,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAWlC,MAAM,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAahD,IAAI,CACR,cAAc,EAAE,eAAe,EAC/B,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAO,GAC1E,OAAO,CAAC,OAAO,CAAC;CA2BpB;AAQD,qBAAa,iBAAkB,YAAW,eAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,SAAS;IAEvC,GAAG,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB1D,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAsBvD,OAAO,CACX,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,aAAa,EACtB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,OAAO,CAAC;IA2Bb,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBrF,eAAe,CACnB,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GACxC,OAAO,CAAC,OAAO,CAAC;IAoBb,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW/D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUpD,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAmB/D;AAQD,qBAAa,iBAAkB,YAAW,eAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,SAAS;IAEvC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;CAUzG;AAGD,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,oBAAoB;IAMnC,QAAQ,CAAC,EAAE,UAAU,CAAC;IAatB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAsCD,qBAAa,aAAc,YAAW,WAAW;IAW7C,OAAO,CAAC,QAAQ,CAAC,KAAK;IAVxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IAItC,IAAI,UAAU,IAAI,gBAAgB,CAEjC;gBAGkB,KAAK,EAAE,SAAS,EACjC,IAAI,GAAE,oBAAyB;YASnB,cAAc;IAatB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAS3C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAM3D,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;YAanE,MAAM;IAwBd,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnC,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAUlE,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAqBnE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA4C/E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB9D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAS/D,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAazE,OAAO,CAAC,QAAQ;CAUjB"}