@tessar/sqlite 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,55 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @tessar/sqlite
+
+SQLite persistence for Tessar's state and checkpoint contracts, using Node's
+built-in SQLite API. Requires Node 24.14 or newer.
+
+```sh
+npm install @tessar/core @tessar/sqlite
+```
+
+```ts
+import { SqliteStoragePlugin } from "@tessar/sqlite";
+
+const storage = new SqliteStoragePlugin({ filename: "./state.db" });
+// Include storage in new Controller({ id, agent, plugins: [storage, ...] }).
+```
+
+Core owns state/checkpoint behavior; this plugin supplies physical persistence.
+Choose the backend before Controller initialization. Scope filters bind queries
+to application-selected metadata; applications own authentication and authorization.
+
+Node's SQLite API is experimental. This backend uses synchronous database
+operations and is a reference implementation, not a server throughput claim.
+
+This is an early 0.x release. See the
+[repository](https://github.com/hphucdev-04/tessar) for usage and contracts.
+
+## Schema v2
+
+Initialization transactionally migrates v1 databases, preserving checkpoint IDs,
+historical message/trace views, plugin snapshots, leases and commit receipts.
+Inconsistent source data (including nonempty legacy `plugin_states` projections
+or receipts without their original staged batches) aborts and rolls back. There
+is no automatic reset or lossy fallback. No Sessions are invented for old threads.
+
+Messages and trace records have revision intervals instead of one copy per
+checkpoint. Public checkpoints still hydrate complete logical history. Successful
+publication removes staging; receipt fingerprints continue rejecting a changed
+payload with the same commit ID. Session selection writes use transactional CAS.
+There is no `agents` table.
+
+History and record pages use bounded SQL queries and indexed parent/date/ID
+columns. Arbitrary scalar scope keys are bound JSON predicates and may require
+scanning candidates; there is no automatic index per scope key. SQLite uses
+synchronous operations, so large writes can still block the Node event loop.
+
+Delete remains soft. Purge is explicit, guarded by ownership and retained fork
+lineage, and never removes plugin-owned tables. Plugins needing independent job
+claims or scheduling indexes own their database/schema and migrations; the core
+state API exposes JSON state, not raw SQL access.
+
+Lease fencing counters survive purge. A stale lease cannot regain ownership when
+the same thread ID and owner token are reused. Publication checks ownership again
+before committing; an expired lease rolls back the complete publication.
+
+See [the database map](../../SQLITE-STATE.md) for tables and actual fixture rows.

package/dist/backend.d.ts

@@ -0,0 +1,5 @@
+import { type StorageBackend } from "@tessar/core";
+export interface SqliteStorageOptions {
+    filename: string;
+}
+export declare function createSqliteBackend(options: SqliteStorageOptions): Promise<StorageBackend>;

package/dist/backend.js

@@ -0,0 +1,277 @@
+import { DatabaseSync } from "node:sqlite";
+import { canonicalJson, buildThreadInfo, recordBinding, validateSession, commitFingerprint, validateBatch, fail, immutable, matchesScope, } from "@tessar/core";
+import { initializeSchema, recordTables } from "./schema.js";
+import { sqlPage, scopePredicate, historyPage, checkpointPage, } from "./queries.js";
+import { readVersions, writeVersions, writeCheckpoint, hydrateCheckpoint, } from "./versions.js";
+import { databaseNow, assertOwnership, createOwnership, transaction, } from "./ownership.js";
+export async function createSqliteBackend(options) {
+    const db = new DatabaseSync(options.filename);
+    try {
+        await initializeSchema(db);
+    }
+    catch (error) {
+        db.close();
+        throw error;
+    }
+    let closed = false;
+    const getJson = (sql, ...values) => {
+        const row = db.prepare(sql).get(...values);
+        return row ? immutable(JSON.parse(row.body)) : null;
+    };
+    const head = (id) => getJson("SELECT body FROM threads WHERE id=?", id);
+    const checkpointRow = (id) => db
+        .prepare("SELECT thread_id,revision,body FROM checkpoints WHERE id=?")
+        .get(id);
+    const records = (kind, threadId, cp) => {
+        const row = checkpointRow(cp ?? head(threadId)?.currentCheckpointId ?? "");
+        return row && row.thread_id === threadId
+            ? readVersions(db, kind, threadId, row.revision)
+            : [];
+    };
+    const ownerKey = (key) => canonicalJson([key.ownerType, key.ownerId, key.pluginId, key.namespace]);
+    return {
+        sessions: {
+            get: async (id, query = {}) => {
+                const row = getJson("SELECT body FROM sessions WHERE id=?", id);
+                return row && matchesScope(row.scope, query.scope) ? row : null;
+            },
+            page: async (query) => {
+                const scope = scopePredicate(query.scope);
+                return sqlPage(db, "sessions", "agent_id=? AND " + scope.sql, [query.agentId, ...scope.values], query, canonicalJson({ agentId: query.agentId, scope: query.scope ?? {} }), "created_at");
+            },
+            compareAndSet: async (value, expected) => transaction(db, () => {
+                const old = getJson("SELECT body FROM sessions WHERE id=?", value.id);
+                validateSession(value, old, expected, value.selectedThreadId ? head(value.selectedThreadId) : null);
+                db.prepare("INSERT INTO sessions VALUES(?,?,?,?,?,?,?) ON CONFLICT(id) DO UPDATE SET selected_thread_id=excluded.selected_thread_id,revision=excluded.revision,updated_at=excluded.updated_at,body=excluded.body").run(value.id, value.agentId, value.selectedThreadId, value.revision, value.createdAt, value.updatedAt, canonicalJson(value));
+            }),
+        },
+        id: "sqlite",
+        capabilities: {
+            durable: true,
+            atomicPublish: true,
+            coordination: "multi-process",
+        },
+        threads: {
+            purge: async (id, query = {}) => transaction(db, () => {
+                const info = head(id);
+                if (!info || !matchesScope(info.scope, query.scope))
+                    fail("ThreadNotFound", "Thread does not match query");
+                if (!info.deleted)
+                    fail("ThreadNotDeleted", "Soft-delete the thread before purging");
+                if (info.activeStreamId ||
+                    db
+                        .prepare("SELECT 1 FROM leases WHERE thread_id=? AND expires_at>?")
+                        .get(id, databaseNow(db)))
+                    fail("ThreadBusy", "Thread has active execution or ownership");
+                if (db
+                    .prepare("SELECT 1 FROM threads WHERE json_extract(body,'$.parentThreadId')=? OR json_extract(body,'$.sourceCheckpointId') IN (SELECT id FROM checkpoints WHERE thread_id=?) LIMIT 1")
+                    .get(id, id))
+                    fail("ThreadReferenced", "Retained fork references this thread");
+                for (const table of [
+                    ...recordTables,
+                    "messages",
+                    "checkpoints",
+                    "commits",
+                ])
+                    db.prepare("DELETE FROM " + table + " WHERE thread_id=?").run(id);
+                db.prepare("DELETE FROM staging WHERE json_extract(body,'$.threadId')=?").run(id);
+                db.prepare("DELETE FROM threads WHERE id=?").run(id);
+            }),
+            page: async (query) => {
+                const scope = scopePredicate(query.scope);
+                return sqlPage(db, "threads", "deleted=0 AND " + scope.sql, scope.values, query, canonicalJson(query.scope ?? {}), "created_at");
+            },
+            get: async (id, options) => {
+                const value = head(id);
+                return value && (!value.deleted || options?.includeDeleted)
+                    ? value
+                    : null;
+            },
+            list: async (query) => db.prepare("SELECT body FROM threads").all()
+                .map((r) => immutable(JSON.parse(r.body)))
+                .filter((r) => !r.deleted && matchesScope(r.scope, query?.scope)),
+        },
+        checkpoints: {
+            page: async (threadId, options) => checkpointPage(db, threadId, options),
+            history: async (threadId, options, query) => historyPage(db, threadId, options, query),
+            get: async (id) => checkpointRow(id)
+                ? hydrateCheckpoint(db, checkpointRow(id).body)
+                : null,
+            list: async (threadId) => db
+                .prepare("SELECT body FROM checkpoints WHERE thread_id=? ORDER BY revision")
+                .all(threadId).map((r) => hydrateCheckpoint(db, r.body)),
+        },
+        executions: {
+            page: async (kind, threadId, query) => {
+                if (!recordTables.includes(kind))
+                    fail("InvalidConfiguration", "Unknown record kind");
+                const cp = checkpointRow(query.atCheckpointId ?? head(threadId)?.currentCheckpointId ?? "");
+                if (!cp || cp.thread_id !== threadId)
+                    fail("CheckpointNotFound", "No checkpoint for records");
+                const values = [
+                    threadId,
+                    cp.revision,
+                    cp.revision,
+                ];
+                let where = "thread_id=? AND from_revision<=? AND (to_revision IS NULL OR ?<to_revision)";
+                for (const [field, column] of [
+                    ["streamId", "stream_id"],
+                    ["turnId", "turn_id"],
+                    ["status", "status"],
+                ])
+                    if (query[field] !== undefined) {
+                        where += " AND " + column + "=?";
+                        values.push(query[field]);
+                    }
+                return sqlPage(db, kind, where, values, query, recordBinding(kind, threadId, query), "sort_date");
+            },
+            get: async (kind, id, query) => {
+                if (!recordTables.includes(kind))
+                    fail("InvalidConfiguration", "Unknown record kind");
+                if (query?.threadId)
+                    return (records(kind, query.threadId, query.atCheckpointId).find((r) => r.id === id) ?? null);
+                if (query?.atCheckpointId) {
+                    const row = checkpointRow(query.atCheckpointId);
+                    return (row
+                        ? (records(kind, row.thread_id, query.atCheckpointId).find((r) => r.id === id) ?? null)
+                        : null);
+                }
+                return getJson("SELECT r.body FROM " +
+                    kind +
+                    " r JOIN threads t ON r.thread_id=t.id WHERE r.id=? AND r.to_revision IS NULL AND t.deleted=0", id);
+            },
+            listRecords: async (kind, threadId, query) => records(kind, threadId, query?.atCheckpointId),
+        },
+        ownedState: {
+            get: async (key) => getJson("SELECT body FROM owned_states WHERE owner_key=?", ownerKey(key)),
+            compareAndSet: async (state, expected) => transaction(db, () => {
+                if (!["agent", "session"].includes(state.ownerType))
+                    fail("InvalidConfiguration", "Execution state must use checkpoints");
+                const key = ownerKey(state), old = getJson("SELECT body FROM owned_states WHERE owner_key=?", key);
+                if ((old?.revision ?? 0) !== expected ||
+                    state.revision !== expected + 1)
+                    fail("CommitConflict", "Owned state revision changed");
+                db.prepare("INSERT INTO owned_states VALUES(?,?,?) ON CONFLICT(owner_key) DO UPDATE SET revision=excluded.revision,body=excluded.body").run(key, state.revision, canonicalJson(state));
+            }),
+        },
+        ownership: createOwnership(db),
+        commits: {
+            stage: async (batch) => {
+                validateBatch(batch);
+                const fingerprint = await commitFingerprint(batch);
+                transaction(db, () => {
+                    const published = db
+                        .prepare("SELECT fingerprint FROM commits WHERE id=?")
+                        .get(batch.commitId);
+                    if (published) {
+                        if (published.fingerprint !== fingerprint)
+                            fail("CommitConflict", "commitId payload mismatch");
+                        return;
+                    }
+                    const old = getJson("SELECT body FROM staging WHERE id=?", batch.commitId);
+                    if (old && canonicalJson(old) !== canonicalJson(batch))
+                        fail("CommitConflict", "commitId payload mismatch");
+                    if (!old)
+                        db.prepare("INSERT INTO staging VALUES(?,?,?)").run(batch.commitId, canonicalJson(batch), fingerprint);
+                });
+            },
+            lookupCommit: async (id) => getJson("SELECT body FROM commits WHERE id=?", id),
+            publish: async (request) => transaction(db, () => {
+                const prior = getJson("SELECT body FROM commits WHERE id=?", request.commitId);
+                if (prior) {
+                    if (prior.threadId !== request.threadId ||
+                        prior.revision !== request.expectedRevision + 1)
+                        fail("CommitConflict", "Commit request mismatch");
+                    return prior;
+                }
+                if (request.lease.threadId !== request.threadId)
+                    fail("OwnershipLost", "Lease belongs to another thread");
+                assertOwnership(db, request.lease);
+                const batch = getJson("SELECT body FROM staging WHERE id=?", request.commitId);
+                if (!batch ||
+                    batch.threadId !== request.threadId ||
+                    batch.expectedRevision !== request.expectedRevision)
+                    fail("CommitConflict", "Missing staged batch");
+                if (batch.lineage) {
+                    const parent = head(batch.lineage.parentThreadId);
+                    if (!parent ||
+                        parent.deleted ||
+                        checkpointRow(batch.lineage.sourceCheckpointId)?.thread_id !==
+                            parent.id)
+                        fail("ThreadNotFound", "Fork source is no longer available");
+                }
+                const old = head(batch.threadId), cp = batch.checkpoint;
+                if ((old?.revision ?? 0) !== batch.expectedRevision ||
+                    old?.deleted ||
+                    cp.parentCheckpointId !== (old?.currentCheckpointId ?? null))
+                    fail("CommitConflict", "Head changed");
+                if (checkpointRow(cp.id))
+                    fail("CommitConflict", "Checkpoint ID already exists");
+                const merged = new Map();
+                for (const kind of recordTables)
+                    for (const data of records(kind, batch.threadId))
+                        merged.set(kind + ":" + data.id, {
+                            kind,
+                            id: data.id,
+                            threadId: batch.threadId,
+                            data,
+                        });
+                for (const entry of batch.records)
+                    merged.set(entry.kind + ":" + entry.id, entry);
+                if (cp.execution && !merged.has("streams:" + cp.execution.streamId))
+                    fail("CommitConflict", "Missing stream reference");
+                if (cp.execution?.pendingInterruptId &&
+                    !merged.has("interrupts:" + cp.execution.pendingInterruptId))
+                    fail("CommitConflict", "Missing interrupt reference");
+                writeCheckpoint(db, cp);
+                for (const kind of recordTables)
+                    writeVersions(db, kind, cp.threadId, cp.revision, batch.records
+                        .filter((entry) => entry.kind === kind)
+                        .map((entry) => ({
+                        id: entry.id,
+                        body: canonicalJson(entry.data),
+                    })));
+                const stream = cp.execution
+                    ? merged.get("streams:" + cp.execution.streamId)
+                        ?.data
+                    : null;
+                const info = buildThreadInfo(batch, old, stream);
+                db.prepare("INSERT INTO threads VALUES(?,?,?,?) ON CONFLICT(id) DO UPDATE SET body=excluded.body,created_at=excluded.created_at,deleted=excluded.deleted").run(info.id, canonicalJson(info), info.createdAt, Number(info.deleted));
+                if (info.deleted) {
+                    const selections = db
+                        .prepare("SELECT body FROM sessions WHERE selected_thread_id=?")
+                        .all(info.id);
+                    for (const row of selections) {
+                        const session = JSON.parse(String(row.body));
+                        const next = {
+                            ...session,
+                            selectedThreadId: null,
+                            revision: session.revision + 1,
+                            updatedAt: cp.createdAt,
+                        };
+                        db.prepare("UPDATE sessions SET selected_thread_id=NULL,revision=?,updated_at=?,body=? WHERE id=?").run(next.revision, next.updatedAt, canonicalJson(next), next.id);
+                    }
+                }
+                const receipt = {
+                    commitId: batch.commitId,
+                    threadId: batch.threadId,
+                    revision: cp.revision,
+                    checkpointId: cp.id,
+                };
+                db.prepare("INSERT INTO commits VALUES(?,?,?,?)").run(batch.commitId, canonicalJson(receipt), String(db
+                    .prepare("SELECT fingerprint FROM staging WHERE id=?")
+                    .get(batch.commitId).fingerprint), cp.threadId);
+                db.prepare("DELETE FROM staging WHERE id=?").run(batch.commitId);
+                assertOwnership(db, request.lease);
+                return receipt;
+            }),
+        },
+        close: async () => {
+            if (!closed) {
+                closed = true;
+                db.close();
+            }
+        },
+    };
+}
+//# sourceMappingURL=backend.js.map

package/dist/backend.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./backend.js";
+import type { Plugin, PluginContext } from "@tessar/core";
+import { type SqliteStorageOptions } from "./backend.js";
+export declare class SqliteStoragePlugin implements Plugin {
+    private readonly options;
+    readonly id = "storage.sqlite";
+    constructor(options: SqliteStorageOptions);
+    setup(tessar: PluginContext): Promise<void>;
+}

package/dist/index.js

@@ -0,0 +1,20 @@
+export * from "./backend.js";
+import { createSqliteBackend } from "./backend.js";
+export class SqliteStoragePlugin {
+    options;
+    id = "storage.sqlite";
+    constructor(options) {
+        this.options = options;
+    }
+    async setup(tessar) {
+        const backend = await createSqliteBackend(this.options);
+        try {
+            tessar.storage.register(backend);
+        }
+        catch (error) {
+            await backend.close().catch(() => { });
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAE7B,OAAO,EAAE,mBAAmB,EAA6B,MAAM,cAAc,CAAC;AAC9E,MAAM,OAAO,mBAAmB;IAED,OAAO;IAD3B,EAAE,GAAG,gBAAgB,CAAC;IAC/B,YAA6B,OAA6B;uBAA7B,OAAO;IAAyB,CAAC;IAC9D,KAAK,CAAC,KAAK,CAAC,MAAqB;QAC/B,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACtC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/migration.d.ts

@@ -0,0 +1,3 @@
+import type { DatabaseSync } from "node:sqlite";
+/** Called inside initialization's write transaction. No async work while locked. */
+export declare function migrateV1(db: DatabaseSync, createSchema: (db: DatabaseSync) => void): void;

package/dist/migration.js

@@ -0,0 +1,67 @@
+import { createHash } from "node:crypto";
+import { canonicalJson, validateBatch, } from "@tessar/core";
+import { recordTables, writeCheckpoint, writeVersions } from "./versions.js";
+/** Called inside initialization's write transaction. No async work while locked. */
+export function migrateV1(db, createSchema) {
+    if (Number(db.prepare("SELECT count(*) n FROM plugin_states").get().n))
+        throw Error("Migration refuses nonempty legacy plugin_states; export and reconcile custom records first");
+    const tables = [
+        "threads",
+        "checkpoints",
+        "messages",
+        ...recordTables,
+        "plugin_states",
+        "staging",
+        "commits",
+        "leases",
+        "owned_states",
+    ];
+    for (const table of tables)
+        db.exec(`ALTER TABLE ${table} RENAME TO _v1_${table}`);
+    createSchema(db);
+    for (const row of db.prepare("SELECT body FROM _v1_threads").iterate()) {
+        const head = JSON.parse(String(row.body));
+        db.prepare("INSERT INTO threads VALUES(?,?,?,?)").run(head.id, canonicalJson(head), head.createdAt, Number(head.deleted));
+    }
+    for (const row of db
+        .prepare("SELECT body FROM _v1_checkpoints ORDER BY thread_id,revision")
+        .iterate()) {
+        const cp = JSON.parse(String(row.body));
+        writeCheckpoint(db, cp);
+        for (const kind of recordTables) {
+            const entries = db
+                .prepare(`SELECT id,body FROM _v1_${kind} WHERE thread_id=? AND checkpoint_id=?`)
+                .all(cp.threadId, cp.id);
+            writeVersions(db, kind, cp.threadId, cp.revision, entries.map((entry) => ({
+                id: entry.id,
+                body: canonicalJson(JSON.parse(entry.body)),
+            })), true);
+        }
+    }
+    for (const row of db.prepare("SELECT id,body FROM _v1_staging").iterate()) {
+        const batch = JSON.parse(String(row.body));
+        validateBatch(batch);
+        const body = canonicalJson(batch), fingerprint = createHash("sha256").update(body).digest("hex");
+        const receipt = db
+            .prepare("SELECT body FROM _v1_commits WHERE id=?")
+            .get(String(row.id));
+        if (receipt) {
+            const value = JSON.parse(String(receipt.body));
+            if (value.threadId !== batch.threadId ||
+                value.checkpointId !== batch.checkpoint.id ||
+                value.revision !== batch.checkpoint.revision)
+                throw Error("Migration found inconsistent commit receipt");
+            db.prepare("INSERT INTO commits VALUES(?,?,?,?)").run(String(row.id), canonicalJson(value), fingerprint, batch.threadId);
+        }
+        else
+            db.prepare("INSERT INTO staging VALUES(?,?,?)").run(String(row.id), body, fingerprint);
+    }
+    if (db.prepare("SELECT id FROM _v1_commits EXCEPT SELECT id FROM commits").get())
+        throw Error("Migration found a receipt without its original staged payload");
+    db.exec("INSERT INTO leases SELECT * FROM _v1_leases; INSERT INTO owned_states SELECT * FROM _v1_owned_states;");
+    if (db.prepare("PRAGMA foreign_key_check").get())
+        throw Error("Migration found invalid foreign keys");
+    for (const table of tables.toReversed())
+        db.exec(`DROP TABLE _v1_${table}`);
+}
+//# sourceMappingURL=migration.js.map

package/dist/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.js","sourceRoot":"","sources":["../src/migration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,aAAa,EACb,aAAa,GAId,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE7E,oFAAoF;AACpF,MAAM,UAAU,SAAS,CACvB,EAAgB,EAChB,YAAwC;IAExC,IAAI,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC,GAAG,EAAG,CAAC,CAAC,CAAC;QACrE,MAAM,KAAK,CACT,4FAA4F,CAC7F,CAAC;IACJ,MAAM,MAAM,GAAG;QACb,SAAS;QACT,aAAa;QACb,UAAU;QACV,GAAG,YAAY;QACf,eAAe;QACf,SAAS;QACT,SAAS;QACT,QAAQ;QACR,cAAc;KACf,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,MAAM;QACxB,EAAE,CAAC,IAAI,CAAC,eAAe,KAAK,kBAAkB,KAAK,EAAE,CAAC,CAAC;IACzD,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QACvE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAe,CAAC;QACxD,EAAE,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC,GAAG,CACnD,IAAI,CAAC,EAAE,EACP,aAAa,CAAC,IAAI,CAAC,EACnB,IAAI,CAAC,SAAS,EACd,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CACrB,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,EAAE;SACjB,OAAO,CAAC,8DAA8D,CAAC;SACvE,OAAO,EAAE,EAAE,CAAC;QACb,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAe,CAAC;QACtD,eAAe,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACxB,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,EAAE;iBACf,OAAO,CACN,2BAA2B,IAAI,wCAAwC,CACxE;iBACA,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAmC,CAAC;YAC7D,aAAa,CACX,EAAE,EACF,IAAI,EACJ,EAAE,CAAC,QAAQ,EACX,EAAE,CAAC,QAAQ,EACX,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACtB,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;aAC5C,CAAC,CAAC,EACH,IAAI,CACL,CAAC;QACJ,CAAC;IACH,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAgB,CAAC;QAC1D,aAAa,CAAC,KAAK,CAAC,CAAC;QACrB,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,EAC/B,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,EAAE;aACf,OAAO,CAAC,yCAAyC,CAAC;aAClD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACvB,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YAC/C,IACE,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ;gBACjC,KAAK,CAAC,YAAY,KAAK,KAAK,CAAC,UAAU,CAAC,EAAE;gBAC1C,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,UAAU,CAAC,QAAQ;gBAE5C,MAAM,KAAK,CAAC,6CAA6C,CAAC,CAAC;YAC7D,EAAE,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAC,GAAG,CACnD,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EACd,aAAa,CAAC,KAAK,CAAC,EACpB,WAAW,EACX,KAAK,CAAC,QAAQ,CACf,CAAC;QACJ,CAAC;;YACC,EAAE,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,GAAG,CACjD,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EACd,IAAI,EACJ,WAAW,CACZ,CAAC;IACN,CAAC;IACD,IACE,EAAE,CAAC,OAAO,CAAC,0DAA0D,CAAC,CAAC,GAAG,EAAE;QAE5E,MAAM,KAAK,CACT,+DAA+D,CAChE,CAAC;IACJ,EAAE,CAAC,IAAI,CACL,uGAAuG,CACxG,CAAC;IACF,IAAI,EAAE,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC,GAAG,EAAE;QAC9C,MAAM,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACtD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,UAAU,EAAE;QAAE,EAAE,CAAC,IAAI,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;AAC9E,CAAC"}

package/dist/ownership.d.ts

@@ -0,0 +1,6 @@
+import type { DatabaseSync } from "node:sqlite";
+import { type Lease, type OwnershipPort } from "@tessar/core";
+export declare function databaseNow(db: DatabaseSync): number;
+export declare function transaction<T>(db: DatabaseSync, action: () => T): T;
+export declare function assertOwnership(db: DatabaseSync, lease: Lease): void;
+export declare function createOwnership(db: DatabaseSync): OwnershipPort;

package/dist/ownership.js

@@ -0,0 +1,67 @@
+import { fail } from "@tessar/core";
+export function databaseNow(db) {
+    return db
+        .prepare("SELECT CAST((julianday('now') - 2440587.5)*86400000 AS INTEGER) AS now")
+        .get().now;
+}
+export function transaction(db, action) {
+    db.exec("BEGIN IMMEDIATE");
+    try {
+        const result = action();
+        db.exec("COMMIT");
+        return result;
+    }
+    catch (error) {
+        db.exec("ROLLBACK");
+        throw error;
+    }
+}
+export function assertOwnership(db, lease) {
+    const row = db
+        .prepare("SELECT * FROM leases WHERE thread_id=?")
+        .get(lease.threadId);
+    if (!row ||
+        row.owner_token !== lease.ownerToken ||
+        row.fencing_token !== lease.fencingToken ||
+        row.expires_at <= databaseNow(db))
+        fail("OwnershipLost", "Lease no longer owns thread");
+}
+const toLease = (row) => ({
+    threadId: row.thread_id,
+    ownerToken: row.owner_token,
+    fencingToken: row.fencing_token,
+    expiresAt: new Date(row.expires_at).toISOString(),
+});
+export function createOwnership(db) {
+    return {
+        acquire: async (request) => transaction(db, () => {
+            if (!Number.isFinite(request.ttlMs) || request.ttlMs <= 0)
+                fail("InvalidConfiguration", "Invalid lease duration");
+            const previous = db
+                .prepare("SELECT * FROM leases WHERE thread_id=?")
+                .get(request.threadId), now = databaseNow(db);
+            if (previous && previous.expires_at > now)
+                fail("OwnerActive", "Thread has active owner");
+            const row = {
+                thread_id: request.threadId,
+                owner_token: request.ownerToken,
+                fencing_token: (previous?.fencing_token ?? 0) + 1,
+                expires_at: now + request.ttlMs,
+            };
+            db.prepare("INSERT INTO leases VALUES(?,?,?,?) ON CONFLICT(thread_id) DO UPDATE SET owner_token=excluded.owner_token,fencing_token=excluded.fencing_token,expires_at=excluded.expires_at").run(row.thread_id, row.owner_token, row.fencing_token, row.expires_at);
+            return toLease(row);
+        }),
+        renew: async (lease, ttlMs) => transaction(db, () => {
+            assertOwnership(db, lease);
+            if (!Number.isFinite(ttlMs) || ttlMs <= 0)
+                fail("InvalidConfiguration", "Invalid lease duration");
+            const expires = databaseNow(db) + ttlMs;
+            db.prepare("UPDATE leases SET expires_at=? WHERE thread_id=?").run(expires, lease.threadId);
+            return { ...lease, expiresAt: new Date(expires).toISOString() };
+        }),
+        release: async (lease) => {
+            db.prepare("UPDATE leases SET expires_at=0 WHERE thread_id=? AND owner_token=? AND fencing_token=?").run(lease.threadId, lease.ownerToken, lease.fencingToken);
+        },
+    };
+}
+//# sourceMappingURL=ownership.js.map

package/dist/ownership.js.map

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

package/dist/queries.d.ts

@@ -0,0 +1,10 @@
+import type { DatabaseSync, SQLInputValue } from "node:sqlite";
+import { type PageOptions, type Page, type Scope, type HistoryOptions, type HistoryDataPage, type StateQuery, type CheckpointInfo } from "@tessar/core";
+/** Values and keys are parameters, including keys containing JSON-path punctuation. */
+export declare function scopePredicate(scope?: Scope, column?: string): {
+    sql: string;
+    values: SQLInputValue[];
+};
+export declare function sqlPage<T>(db: DatabaseSync, table: string, where: string, values: SQLInputValue[], options: PageOptions, binding: string, dateColumn: string, map?: (row: Record<string, any>) => T, columns?: string): Page<T>;
+export declare function historyPage(db: DatabaseSync, id: string, options: HistoryOptions, query?: StateQuery): HistoryDataPage;
+export declare function checkpointPage(db: DatabaseSync, threadId: string, options: PageOptions): Page<CheckpointInfo>;

package/dist/queries.js

@@ -0,0 +1,76 @@
+import { normalizeScope, canonicalJson, immutable, fail, pageAfter, limitOf, encodeCursor, historyCursor, matchesScope, } from "@tessar/core";
+/** Values and keys are parameters, including keys containing JSON-path punctuation. */
+export function scopePredicate(scope = {}, column = "body") {
+    normalizeScope(scope);
+    const values = [];
+    const parts = Object.entries(scope).map(([key, value]) => {
+        values.push(key);
+        if (typeof value === "boolean") {
+            values.push(value ? "true" : "false");
+            return `EXISTS(SELECT 1 FROM json_each(json_extract(${column},'$.scope')) s WHERE s.key=? AND s.type=?)`;
+        }
+        values.push(value);
+        return `EXISTS(SELECT 1 FROM json_each(json_extract(${column},'$.scope')) s WHERE s.key=? AND s.type ${typeof value === "number" ? "IN ('integer','real')" : "='text'"} AND s.value=?)`;
+    });
+    return { sql: parts.length ? parts.join(" AND ") : "1", values };
+}
+export function sqlPage(db, table, where, values, options, binding, dateColumn, map = (row) => immutable(JSON.parse(row.body)), columns = "*") {
+    const after = pageAfter(options, binding), limit = limitOf(options.limit);
+    const filter = after
+        ? ` AND (${dateColumn}>? OR (${dateColumn}=? AND id COLLATE BINARY>?))`
+        : "";
+    const rows = db
+        .prepare(`SELECT ${columns},${dateColumn} AS page_date FROM ${table} WHERE ${where}${filter} ORDER BY ${dateColumn},id COLLATE BINARY LIMIT ?`)
+        .all(...values, ...(after ? [after[0], after[0], after[1]] : []), limit + 1);
+    const selected = rows.slice(0, limit), last = selected.at(-1);
+    return {
+        items: selected.map(map),
+        nextCursor: rows.length > limit
+            ? encodeCursor({ v: 2, binding, after: [last.page_date, last.id] })
+            : null,
+    };
+}
+export function historyPage(db, id, options, query = {}) {
+    const row = db
+        .prepare("SELECT body FROM threads WHERE id=? AND deleted=0")
+        .get(id);
+    const head = row ? JSON.parse(String(row.body)) : null;
+    if (!head || !matchesScope(head.scope, query.scope))
+        fail("ThreadNotFound", "Thread does not match query");
+    const { binding, cursor } = historyCursor(id, options, query), limit = limitOf(options.limit);
+    const cp = db
+        .prepare("SELECT id,revision,message_count FROM checkpoints WHERE thread_id=? AND id=?")
+        .get(id, cursor?.checkpointId ??
+        options.atCheckpointId ??
+        head.currentCheckpointId);
+    if (!cp)
+        fail("CheckpointNotFound", "No checkpoint for history");
+    const end = cursor?.end ?? Number(cp.message_count);
+    if (end > Number(cp.message_count))
+        fail("InvalidCursor", "Invalid history position");
+    const begin = Math.max(0, end - limit), revision = Number(cp.revision);
+    const items = db
+        .prepare("SELECT body FROM messages WHERE thread_id=? AND position>=? AND position<? AND from_revision<=? AND (to_revision IS NULL OR ?<to_revision) ORDER BY position LIMIT ?")
+        .all(id, begin, end, revision, revision, limit)
+        .map((row) => immutable(JSON.parse(String(row.body))));
+    return {
+        items,
+        checkpointId: String(cp.id),
+        revision,
+        nextCursor: begin
+            ? encodeCursor({ v: 1, binding, checkpointId: cp.id, end: begin })
+            : null,
+    };
+}
+export function checkpointPage(db, threadId, options) {
+    return sqlPage(db, "checkpoints", "thread_id=?", [threadId], options, "checkpoints:" + threadId, "created_at", (row) => ({
+        id: row.id,
+        threadId,
+        revision: row.revision,
+        createdAt: row.created_at,
+        cause: row.cause,
+        forkable: !!row.forkable,
+        unsafeReason: row.unsafe_reason,
+    }), "id,revision,created_at,cause,forkable,unsafe_reason");
+}
+//# sourceMappingURL=queries.js.map

package/dist/queries.js.map

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

package/dist/schema.d.ts

@@ -0,0 +1,5 @@
+import type { DatabaseSync } from "node:sqlite";
+import { recordTables } from "./versions.js";
+export { recordTables };
+export declare function initializeSchema(db: DatabaseSync): Promise<void>;
+export declare function createSchema(db: DatabaseSync): void;

package/dist/schema.js

@@ -0,0 +1,66 @@
+import { setTimeout } from "node:timers/promises";
+import { migrateV1 } from "./migration.js";
+import { recordTables } from "./versions.js";
+import { fail } from "@tessar/core";
+export { recordTables };
+export async function initializeSchema(db) {
+    db.exec("PRAGMA busy_timeout=5000; PRAGMA foreign_keys=ON;");
+    const deadline = Date.now() + 5000;
+    for (;;) {
+        try {
+            db.exec("PRAGMA journal_mode=WAL;");
+            break;
+        }
+        catch (error) {
+            // SQLite can return BUSY immediately while concurrent connections enable WAL.
+            if (![5, 6].includes(error.errcode ?? 0) ||
+                Date.now() >= deadline)
+                throw error;
+            await setTimeout(10);
+        }
+    }
+    db.exec("BEGIN IMMEDIATE");
+    try {
+        const version = Number(db.prepare("PRAGMA user_version").get().user_version);
+        if (![0, 1, 2].includes(version))
+            fail("InvalidConfiguration", "Unsupported SQLite schema version");
+        if (version === 1)
+            migrateV1(db, createSchema);
+        else
+            createSchema(db);
+        db.exec("PRAGMA user_version=2; COMMIT");
+    }
+    catch (error) {
+        db.exec("ROLLBACK");
+        throw error;
+    }
+}
+export function createSchema(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS threads(id TEXT PRIMARY KEY,body TEXT NOT NULL,created_at TEXT NOT NULL,deleted INTEGER NOT NULL);
+    CREATE TABLE IF NOT EXISTS checkpoints(id TEXT PRIMARY KEY,thread_id TEXT NOT NULL REFERENCES threads(id) DEFERRABLE INITIALLY DEFERRED,revision INTEGER NOT NULL,created_at TEXT NOT NULL,cause TEXT NOT NULL,message_count INTEGER NOT NULL,forkable INTEGER NOT NULL,unsafe_reason TEXT,body TEXT NOT NULL,UNIQUE(thread_id,revision));
+    CREATE INDEX IF NOT EXISTS checkpoints_page ON checkpoints(thread_id,created_at,id);
+    CREATE INDEX IF NOT EXISTS threads_page ON threads(deleted,created_at,id);
+    CREATE TABLE IF NOT EXISTS staging(id TEXT PRIMARY KEY,body TEXT NOT NULL,fingerprint TEXT NOT NULL);
+    CREATE TABLE IF NOT EXISTS commits(id TEXT PRIMARY KEY,body TEXT NOT NULL,fingerprint TEXT NOT NULL,thread_id TEXT NOT NULL REFERENCES threads(id));
+    CREATE INDEX IF NOT EXISTS commits_thread ON commits(thread_id);
+    CREATE TABLE IF NOT EXISTS leases(thread_id TEXT PRIMARY KEY,owner_token TEXT NOT NULL,fencing_token INTEGER NOT NULL,expires_at INTEGER NOT NULL);
+    CREATE TABLE IF NOT EXISTS owned_states(owner_key TEXT PRIMARY KEY,revision INTEGER NOT NULL,body TEXT NOT NULL);
+    CREATE TABLE IF NOT EXISTS sessions(id TEXT PRIMARY KEY,agent_id TEXT NOT NULL,selected_thread_id TEXT REFERENCES threads(id),revision INTEGER NOT NULL,created_at TEXT NOT NULL,updated_at TEXT NOT NULL,body TEXT NOT NULL);
+    CREATE INDEX IF NOT EXISTS sessions_page ON sessions(agent_id,created_at,id);
+    CREATE INDEX IF NOT EXISTS sessions_thread ON sessions(selected_thread_id);
+  `);
+    for (const table of ["messages", ...recordTables]) {
+        db.exec(`CREATE TABLE IF NOT EXISTS ${table}(
+      thread_id TEXT NOT NULL REFERENCES threads(id) DEFERRABLE INITIALLY DEFERRED,id TEXT NOT NULL,
+      from_revision INTEGER NOT NULL,to_revision INTEGER,position INTEGER,stream_id TEXT,turn_id TEXT,status TEXT,sort_date TEXT NOT NULL,body TEXT NOT NULL,
+      PRIMARY KEY(thread_id,id,from_revision), CHECK(to_revision IS NULL OR to_revision>from_revision));
+      CREATE UNIQUE INDEX IF NOT EXISTS ${table}_current ON ${table}(thread_id,id) WHERE to_revision IS NULL;
+      CREATE INDEX IF NOT EXISTS ${table}_page ON ${table}(thread_id,sort_date,id,from_revision);
+      CREATE INDEX IF NOT EXISTS ${table}_stream ON ${table}(thread_id,stream_id,sort_date,id);
+      CREATE INDEX IF NOT EXISTS ${table}_turn ON ${table}(thread_id,turn_id,sort_date,id);
+    `);
+    }
+    db.exec("CREATE INDEX IF NOT EXISTS messages_history ON messages(thread_id,position,from_revision)");
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,CAAC;AACxB,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EAAgB;IACrD,EAAE,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IACnC,SAAS,CAAC;QACR,IAAI,CAAC;YACH,EAAE,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;YACpC,MAAM;QACR,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,8EAA8E;YAC9E,IACE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAE,KAA8B,CAAC,OAAO,IAAI,CAAC,CAAC;gBAC9D,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ;gBAEtB,MAAM,KAAK,CAAC;YACd,MAAM,UAAU,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CACpB,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,GAAG,EAAG,CAAC,YAAY,CACtD,CAAC;QACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YAC9B,IAAI,CAAC,sBAAsB,EAAE,mCAAmC,CAAC,CAAC;QACpE,IAAI,OAAO,KAAK,CAAC;YAAE,SAAS,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;;YAC1C,YAAY,CAAC,EAAE,CAAC,CAAC;QACtB,EAAE,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAgB;IAC3C,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;GAaP,CAAC,CAAC;IACH,KAAK,MAAM,KAAK,IAAI,CAAC,UAAU,EAAE,GAAG,YAAY,CAAC,EAAE,CAAC;QAClD,EAAE,CAAC,IAAI,CAAC,8BAA8B,KAAK;;;;0CAIL,KAAK,eAAe,KAAK;mCAChC,KAAK,YAAY,KAAK;mCACtB,KAAK,cAAc,KAAK;mCACxB,KAAK,YAAY,KAAK;KACpD,CAAC,CAAC;IACL,CAAC;IACD,EAAE,CAAC,IAAI,CACL,2FAA2F,CAC5F,CAAC;AACJ,CAAC"}

package/dist/versions.d.ts

@@ -0,0 +1,14 @@
+import type { DatabaseSync } from "node:sqlite";
+import { type Checkpoint, type RecordKind } from "@tessar/core";
+export declare const recordTables: readonly ["streams", "turns", "model_attempts", "tool_executions", "interrupts"];
+export type VersionTable = RecordKind | "messages";
+type VersionInput = {
+    id: string;
+    body: string;
+    position?: number;
+};
+export declare function writeVersions(db: DatabaseSync, table: VersionTable, threadId: string, revision: number, entries: readonly VersionInput[], replace?: boolean): void;
+export declare function readVersions<T>(db: DatabaseSync, table: VersionTable, threadId: string, revision: number): T[];
+export declare function writeCheckpoint(db: DatabaseSync, cp: Checkpoint): void;
+export declare function hydrateCheckpoint(db: DatabaseSync, body: string): Checkpoint;
+export {};

package/dist/versions.js

@@ -0,0 +1,54 @@
+import { canonicalJson, immutable, checkpointSafety, } from "@tessar/core";
+export const recordTables = [
+    "streams",
+    "turns",
+    "model_attempts",
+    "tool_executions",
+    "interrupts",
+];
+export function writeVersions(db, table, threadId, revision, entries, replace = false) {
+    const current = new Map(db
+        .prepare(`SELECT id,body,position FROM ${table} WHERE thread_id=? AND to_revision IS NULL`)
+        .all(threadId).map((row) => [row.id, row]));
+    for (const entry of entries) {
+        const old = current.get(entry.id);
+        current.delete(entry.id);
+        if (old &&
+            old.body === entry.body &&
+            old.position === (entry.position ?? null))
+            continue;
+        if (old)
+            db.prepare(`UPDATE ${table} SET to_revision=? WHERE thread_id=? AND id=? AND to_revision IS NULL`).run(revision, threadId, entry.id);
+        const value = JSON.parse(entry.body);
+        db.prepare(`INSERT INTO ${table}(thread_id,id,from_revision,to_revision,position,stream_id,turn_id,status,sort_date,body) VALUES(?,?,?,NULL,?,?,?,?,?,?)`).run(threadId, entry.id, revision, entry.position ?? null, value.streamId ?? null, value.turnId ?? null, value.status ?? null, value.createdAt ?? value.startedAt ?? "", entry.body);
+    }
+    if (replace)
+        for (const id of current.keys())
+            db.prepare(`UPDATE ${table} SET to_revision=? WHERE thread_id=? AND id=? AND to_revision IS NULL`).run(revision, threadId, id);
+}
+export function readVersions(db, table, threadId, revision) {
+    return db
+        .prepare(`SELECT body FROM ${table} WHERE thread_id=? AND from_revision<=? AND (to_revision IS NULL OR ?<to_revision) ORDER BY ${table === "messages" ? "position" : "sort_date,id COLLATE BINARY"}`)
+        .all(threadId, revision, revision).map((row) => immutable(JSON.parse(row.body)));
+}
+export function writeCheckpoint(db, cp) {
+    writeVersions(db, "messages", cp.threadId, cp.revision, cp.state.messages.map((message, position) => ({
+        id: message.id,
+        position,
+        body: canonicalJson(message),
+    })), true);
+    const { messages, ...state } = cp.state;
+    const safety = checkpointSafety(cp);
+    db.prepare("INSERT INTO checkpoints(id,thread_id,revision,created_at,cause,message_count,forkable,unsafe_reason,body) VALUES(?,?,?,?,?,?,?,?,?)").run(cp.id, cp.threadId, cp.revision, cp.createdAt, cp.cause, messages.length, Number(safety.forkable), safety.unsafeReason, canonicalJson({ ...cp, state }));
+}
+export function hydrateCheckpoint(db, body) {
+    const cp = JSON.parse(body);
+    return immutable({
+        ...cp,
+        state: {
+            ...cp.state,
+            messages: readVersions(db, "messages", cp.threadId, cp.revision),
+        },
+    });
+}
+//# sourceMappingURL=versions.js.map

package/dist/versions.js.map

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

package/package.json

@@ -1,6 +1,34 @@
 {
   "name": "@tessar/sqlite",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "SQLite persistence for Tessar state and checkpoints using Node's built-in SQLite API.",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=24.14.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hphucdev-04/tessar.git",
+    "directory": "packages/sqlite"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@tessar/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  }
 }