@sammorrowdrums/mcpi-session-backend-sqlite-node 0.85.0-bootstrap.0

package/CHANGELOG.md

@@ -0,0 +1,48 @@
+# Changelog
+
+## [Unreleased]
+
+### Breaking Changes
+
+- Renamed the public npm package from `@earendil-works/pi-session-backend-sqlite-node` to `@sammorrowdrums/mcpi-session-backend-sqlite-node`. This is separate from the storage-to-session-backend rename documented in 0.84.0. The new package explicitly publishes to the public npm registry and requires Node.js 22.19 or newer.
+
+## [0.84.2] - 2026-08-14
+
+## [0.84.1] - 2026-08-07
+
+### Added
+
+- Added the composable, parameterized `sql` template tag for SQLite queries.
+
+### Fixed
+
+- Fixed SQLite branch queries to apply filters, cursors, and limits in SQL; bounded log reads; and added covering indexes for session, record, branch, and fact queries ([#7727](https://github.com/earendil-works/pi/pull/7727) by [@cristinaponcela](https://github.com/cristinaponcela)).
+
+## [0.84.0] - 2026-08-06
+
+### Breaking Changes
+
+- Renamed the package from `@sammorrowdrums/mcpi-storage-sqlite-node` to `@sammorrowdrums/mcpi-session-backend-sqlite-node`.
+- Replaced the legacy SQLite session schema and repository with the v4 lane-based `SessionRepo` contract. Existing work-in-progress databases are not migrated.
+
+### Added
+
+- Added bounded active-branch queries, durable operation records, global facts, shared sequence allocation, session statistics, and fenced writer leases to the SQLite backend.
+
+### Fixed
+
+- Fixed SQLite session listings to avoid acquiring writer claims and include current session names, allowing inventory reads while sessions have active writers ([#7655](https://github.com/earendil-works/pi/pull/7655)).
+
+## [0.83.0] - 2026-07-29
+
+## [0.82.1] - 2026-07-25
+
+## [0.82.0] - 2026-07-24
+
+## [0.81.1] - 2026-07-21
+
+## [0.81.0] - 2026-07-21
+
+### Added
+
+- Added a Node.js SQLite storage backend for agent harness sessions, including migrations and materialized session views ([#6594](https://github.com/earendil-works/pi/pull/6594) by [@cristinaponcela](https://github.com/cristinaponcela)).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mario Zechner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,22 @@
+# @sammorrowdrums/mcpi-session-backend-sqlite-node
+
+Node sqlite session backend for `@sammorrowdrums/mcpi-agent-core` sessions. Provides the
+`node:sqlite` adapter (`SqliteDatabase` implementation), SQLite session repository,
+migrations, materialized views, and optional FTS search.
+
+```ts
+await using repository = new SqliteSessionRepository(options);
+const search = createSqliteSessionSearch(options);
+const session = await repository.create({ cwd });
+await session.appendMessage(message);
+
+const hits = [];
+for await (const hit of search.search("needle")) hits.push(hit);
+```
+
+The repository lazily owns one shared database connection. Search is an independent
+service over the same canonical database: repositories do not expose `search()`.
+The FTS table and triggers are created lazily on the first non-blank search; when
+FTS is first created, search performs a one-time rebuild from canonical entries.
+After that, SQLite triggers keep FTS in sync with canonical entry inserts, deletes,
+and payload updates.

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { DatabaseSync } from "node:sqlite";
+import type { SqliteDatabase, SqliteDatabaseFactory } from "./sqlite/types.ts";
+export declare function wrapNodeSqliteDatabase(db: DatabaseSync): SqliteDatabase;
+export declare function createNodeSqliteFactory(): SqliteDatabaseFactory;
+export * from "./sqlite/index.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAoC,MAAM,mBAAmB,CAAC;AAiGjH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,YAAY,GAAG,cAAc,CAEvE;AAED,wBAAgB,uBAAuB,IAAI,qBAAqB,CAM/D;AAGD,cAAc,mBAAmB,CAAC","sourcesContent":["import type { SQLInputValue } from \"node:sqlite\";\nimport { DatabaseSync } from \"node:sqlite\";\nimport { sql } from \"./sqlite/sql.ts\";\nimport type { SqliteDatabase, SqliteDatabaseFactory, SqliteRunResult, SqliteStatement } from \"./sqlite/types.ts\";\n\nfunction isNamedParameters(value: unknown): value is Record<string, SQLInputValue> {\n\tif (value === null || typeof value !== \"object\") return false;\n\tif (Array.isArray(value) || ArrayBuffer.isView(value)) return false;\n\treturn true;\n}\n\nfunction isAsyncResult(value: unknown): boolean {\n\treturn value !== null && (typeof value === \"object\" || typeof value === \"function\") && \"then\" in value;\n}\n\nclass NodeSqliteStatement implements SqliteStatement {\n\tprivate readonly statement: ReturnType<DatabaseSync[\"prepare\"]>;\n\n\tconstructor(statement: ReturnType<DatabaseSync[\"prepare\"]>) {\n\t\tthis.statement = statement;\n\t}\n\n\trun(...params: unknown[]): SqliteRunResult {\n\t\tconst [first, ...rest] = params;\n\t\tconst result = isNamedParameters(first)\n\t\t\t? this.statement.run(first, ...(rest as SQLInputValue[]))\n\t\t\t: this.statement.run(...(params as SQLInputValue[]));\n\t\treturn {\n\t\t\tchanges: Number(result.changes),\n\t\t\tlastInsertRowid: result.lastInsertRowid === undefined ? undefined : Number(result.lastInsertRowid),\n\t\t};\n\t}\n\n\tget<TRow extends object>(...params: unknown[]): TRow | undefined {\n\t\tconst [first, ...rest] = params;\n\t\treturn (\n\t\t\tisNamedParameters(first)\n\t\t\t\t? this.statement.get(first, ...(rest as SQLInputValue[]))\n\t\t\t\t: this.statement.get(...(params as SQLInputValue[]))\n\t\t) as TRow | undefined;\n\t}\n\n\tall<TRow extends object>(...params: unknown[]): TRow[] {\n\t\tconst [first, ...rest] = params;\n\t\treturn (\n\t\t\tisNamedParameters(first)\n\t\t\t\t? this.statement.all(first, ...(rest as SQLInputValue[]))\n\t\t\t\t: this.statement.all(...(params as SQLInputValue[]))\n\t\t) as TRow[];\n\t}\n\n\titerate<TRow extends object>(...params: unknown[]): Iterable<TRow> {\n\t\tconst [first, ...rest] = params;\n\t\treturn (\n\t\t\tisNamedParameters(first)\n\t\t\t\t? this.statement.iterate(first, ...(rest as SQLInputValue[]))\n\t\t\t\t: this.statement.iterate(...(params as SQLInputValue[]))\n\t\t) as Iterable<TRow>;\n\t}\n}\n\nclass NodeSqliteDatabase implements SqliteDatabase {\n\tprivate readonly db: DatabaseSync;\n\n\tconstructor(db: DatabaseSync) {\n\t\tthis.db = db;\n\t}\n\n\texec(sql: string): void {\n\t\tthis.db.exec(sql);\n\t}\n\n\tprepare(sql: string): SqliteStatement {\n\t\treturn new NodeSqliteStatement(this.db.prepare(sql));\n\t}\n\n\ttransaction<T>(fn: () => T): T {\n\t\tsql`BEGIN IMMEDIATE`.exec(this);\n\t\ttry {\n\t\t\tconst result = fn();\n\t\t\tif (isAsyncResult(result)) {\n\t\t\t\tthrow new TypeError(\"SQLite transaction callbacks must be synchronous\");\n\t\t\t}\n\t\t\tsql`COMMIT`.exec(this);\n\t\t\treturn result;\n\t\t} catch (error) {\n\t\t\ttry {\n\t\t\t\tsql`ROLLBACK`.exec(this);\n\t\t\t} catch {\n\t\t\t\t// Ignore rollback errors to rethrow original error.\n\t\t\t}\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tclose(): void {\n\t\tthis.db.close();\n\t}\n}\n\nexport function wrapNodeSqliteDatabase(db: DatabaseSync): SqliteDatabase {\n\treturn new NodeSqliteDatabase(db);\n}\n\nexport function createNodeSqliteFactory(): SqliteDatabaseFactory {\n\treturn {\n\t\tasync open(path: string): Promise<SqliteDatabase> {\n\t\t\treturn new NodeSqliteDatabase(new DatabaseSync(path));\n\t\t},\n\t};\n}\n\n// Re-export the SQLite session backend and types so this package is a complete node-sqlite backend.\nexport * from \"./sqlite/index.ts\";\n"]}

package/dist/index.js

@@ -0,0 +1,94 @@
+import { DatabaseSync } from "node:sqlite";
+import { sql } from "./sqlite/sql.js";
+function isNamedParameters(value) {
+    if (value === null || typeof value !== "object")
+        return false;
+    if (Array.isArray(value) || ArrayBuffer.isView(value))
+        return false;
+    return true;
+}
+function isAsyncResult(value) {
+    return value !== null && (typeof value === "object" || typeof value === "function") && "then" in value;
+}
+class NodeSqliteStatement {
+    statement;
+    constructor(statement) {
+        this.statement = statement;
+    }
+    run(...params) {
+        const [first, ...rest] = params;
+        const result = isNamedParameters(first)
+            ? this.statement.run(first, ...rest)
+            : this.statement.run(...params);
+        return {
+            changes: Number(result.changes),
+            lastInsertRowid: result.lastInsertRowid === undefined ? undefined : Number(result.lastInsertRowid),
+        };
+    }
+    get(...params) {
+        const [first, ...rest] = params;
+        return (isNamedParameters(first)
+            ? this.statement.get(first, ...rest)
+            : this.statement.get(...params));
+    }
+    all(...params) {
+        const [first, ...rest] = params;
+        return (isNamedParameters(first)
+            ? this.statement.all(first, ...rest)
+            : this.statement.all(...params));
+    }
+    iterate(...params) {
+        const [first, ...rest] = params;
+        return (isNamedParameters(first)
+            ? this.statement.iterate(first, ...rest)
+            : this.statement.iterate(...params));
+    }
+}
+class NodeSqliteDatabase {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    exec(sql) {
+        this.db.exec(sql);
+    }
+    prepare(sql) {
+        return new NodeSqliteStatement(this.db.prepare(sql));
+    }
+    transaction(fn) {
+        sql `BEGIN IMMEDIATE`.exec(this);
+        try {
+            const result = fn();
+            if (isAsyncResult(result)) {
+                throw new TypeError("SQLite transaction callbacks must be synchronous");
+            }
+            sql `COMMIT`.exec(this);
+            return result;
+        }
+        catch (error) {
+            try {
+                sql `ROLLBACK`.exec(this);
+            }
+            catch {
+                // Ignore rollback errors to rethrow original error.
+            }
+            throw error;
+        }
+    }
+    close() {
+        this.db.close();
+    }
+}
+export function wrapNodeSqliteDatabase(db) {
+    return new NodeSqliteDatabase(db);
+}
+export function createNodeSqliteFactory() {
+    return {
+        async open(path) {
+            return new NodeSqliteDatabase(new DatabaseSync(path));
+        },
+    };
+}
+// Re-export the SQLite session backend and types so this package is a complete node-sqlite backend.
+export * from "./sqlite/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SQLInputValue } from \"node:sqlite\";\nimport { DatabaseSync } from \"node:sqlite\";\nimport { sql } from \"./sqlite/sql.ts\";\nimport type { SqliteDatabase, SqliteDatabaseFactory, SqliteRunResult, SqliteStatement } from \"./sqlite/types.ts\";\n\nfunction isNamedParameters(value: unknown): value is Record<string, SQLInputValue> {\n\tif (value === null || typeof value !== \"object\") return false;\n\tif (Array.isArray(value) || ArrayBuffer.isView(value)) return false;\n\treturn true;\n}\n\nfunction isAsyncResult(value: unknown): boolean {\n\treturn value !== null && (typeof value === \"object\" || typeof value === \"function\") && \"then\" in value;\n}\n\nclass NodeSqliteStatement implements SqliteStatement {\n\tprivate readonly statement: ReturnType<DatabaseSync[\"prepare\"]>;\n\n\tconstructor(statement: ReturnType<DatabaseSync[\"prepare\"]>) {\n\t\tthis.statement = statement;\n\t}\n\n\trun(...params: unknown[]): SqliteRunResult {\n\t\tconst [first, ...rest] = params;\n\t\tconst result = isNamedParameters(first)\n\t\t\t? this.statement.run(first, ...(rest as SQLInputValue[]))\n\t\t\t: this.statement.run(...(params as SQLInputValue[]));\n\t\treturn {\n\t\t\tchanges: Number(result.changes),\n\t\t\tlastInsertRowid: result.lastInsertRowid === undefined ? undefined : Number(result.lastInsertRowid),\n\t\t};\n\t}\n\n\tget<TRow extends object>(...params: unknown[]): TRow | undefined {\n\t\tconst [first, ...rest] = params;\n\t\treturn (\n\t\t\tisNamedParameters(first)\n\t\t\t\t? this.statement.get(first, ...(rest as SQLInputValue[]))\n\t\t\t\t: this.statement.get(...(params as SQLInputValue[]))\n\t\t) as TRow | undefined;\n\t}\n\n\tall<TRow extends object>(...params: unknown[]): TRow[] {\n\t\tconst [first, ...rest] = params;\n\t\treturn (\n\t\t\tisNamedParameters(first)\n\t\t\t\t? this.statement.all(first, ...(rest as SQLInputValue[]))\n\t\t\t\t: this.statement.all(...(params as SQLInputValue[]))\n\t\t) as TRow[];\n\t}\n\n\titerate<TRow extends object>(...params: unknown[]): Iterable<TRow> {\n\t\tconst [first, ...rest] = params;\n\t\treturn (\n\t\t\tisNamedParameters(first)\n\t\t\t\t? this.statement.iterate(first, ...(rest as SQLInputValue[]))\n\t\t\t\t: this.statement.iterate(...(params as SQLInputValue[]))\n\t\t) as Iterable<TRow>;\n\t}\n}\n\nclass NodeSqliteDatabase implements SqliteDatabase {\n\tprivate readonly db: DatabaseSync;\n\n\tconstructor(db: DatabaseSync) {\n\t\tthis.db = db;\n\t}\n\n\texec(sql: string): void {\n\t\tthis.db.exec(sql);\n\t}\n\n\tprepare(sql: string): SqliteStatement {\n\t\treturn new NodeSqliteStatement(this.db.prepare(sql));\n\t}\n\n\ttransaction<T>(fn: () => T): T {\n\t\tsql`BEGIN IMMEDIATE`.exec(this);\n\t\ttry {\n\t\t\tconst result = fn();\n\t\t\tif (isAsyncResult(result)) {\n\t\t\t\tthrow new TypeError(\"SQLite transaction callbacks must be synchronous\");\n\t\t\t}\n\t\t\tsql`COMMIT`.exec(this);\n\t\t\treturn result;\n\t\t} catch (error) {\n\t\t\ttry {\n\t\t\t\tsql`ROLLBACK`.exec(this);\n\t\t\t} catch {\n\t\t\t\t// Ignore rollback errors to rethrow original error.\n\t\t\t}\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tclose(): void {\n\t\tthis.db.close();\n\t}\n}\n\nexport function wrapNodeSqliteDatabase(db: DatabaseSync): SqliteDatabase {\n\treturn new NodeSqliteDatabase(db);\n}\n\nexport function createNodeSqliteFactory(): SqliteDatabaseFactory {\n\treturn {\n\t\tasync open(path: string): Promise<SqliteDatabase> {\n\t\t\treturn new NodeSqliteDatabase(new DatabaseSync(path));\n\t\t},\n\t};\n}\n\n// Re-export the SQLite session backend and types so this package is a complete node-sqlite backend.\nexport * from \"./sqlite/index.ts\";\n"]}

package/dist/sqlite/branch-cache.d.ts

@@ -0,0 +1,6 @@
+import type { SqliteDatabase } from "./types.ts";
+export declare function deleteBranchCache(db: SqliteDatabase, sessionId: string): void;
+export declare function rebuildBranchCache(db: SqliteDatabase, sessionId: string): void;
+export declare function buildCachedBranch(db: SqliteDatabase, sessionId: string, leafId: string): void;
+export declare function appendEntryToBranchCache(db: SqliteDatabase, sessionId: string, entryId: string, entrySeq: number, entryType: string, customType: string | null, parentId: string | null): void;
+//# sourceMappingURL=branch-cache.d.ts.map

package/dist/sqlite/branch-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-cache.d.ts","sourceRoot":"","sources":["../../src/sqlite/branch-cache.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,QAGtE;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,QAUvE;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAqBtF;AAkBD,wBAAgB,wBAAwB,CACvC,EAAE,EAAE,cAAc,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,QAwBvB","sourcesContent":["import { SessionError } from \"@sammorrowdrums/mcpi-agent-core\";\nimport { uuidv7 } from \"@sammorrowdrums/mcpi-ai\";\nimport { sql } from \"./sql.ts\";\nimport {\n\tcopyBranchEntriesThroughSeq,\n\tdeleteBranchEntries,\n\tinsertBranchEntriesForPath,\n\tinsertBranchEntry,\n\treadBranchContainingEntry,\n} from \"./storage/branch-entries.ts\";\nimport { deleteBranchTips, insertBranchTip, readBranchTipBranchId, updateBranchTip } from \"./storage/branch-tips.ts\";\nimport type { SqliteDatabase } from \"./types.ts\";\n\nexport function deleteBranchCache(db: SqliteDatabase, sessionId: string) {\n\tdeleteBranchTips(db, sessionId);\n\tdeleteBranchEntries(db, sessionId);\n}\n\nexport function rebuildBranchCache(db: SqliteDatabase, sessionId: string) {\n\tconst tips = sql`SELECT leaf.id\n\t\tFROM entries AS leaf\n\t\tWHERE leaf.session_id = ${sessionId}\n\t\t\tAND NOT EXISTS (\n\t\t\t\tSELECT 1 FROM entries AS child WHERE child.session_id = leaf.session_id AND child.parent_id = leaf.id\n\t\t\t)\n\t\tORDER BY leaf.seq`.all<{ id: string }>(db);\n\tdeleteBranchCache(db, sessionId);\n\tfor (const tip of tips) buildCachedBranch(db, sessionId, tip.id);\n}\n\nexport function buildCachedBranch(db: SqliteDatabase, sessionId: string, leafId: string) {\n\tsql`SAVEPOINT build_branch_cache`.exec(db);\n\ttry {\n\t\tconst branchId = uuidv7();\n\t\tinsertBranchEntriesForPath(db, sessionId, branchId, leafId);\n\t\tinsertBranchTip(db, sessionId, leafId, branchId);\n\t\tsql`RELEASE SAVEPOINT build_branch_cache`.exec(db);\n\t} catch (error) {\n\t\ttry {\n\t\t\tsql`ROLLBACK TO SAVEPOINT build_branch_cache`.exec(db);\n\t\t\tsql`RELEASE SAVEPOINT build_branch_cache`.exec(db);\n\t\t} catch {\n\t\t\t// Preserve the original build failure.\n\t\t}\n\t\tif (error instanceof SessionError) throw error;\n\t\tthrow new SessionError(\n\t\t\t\"storage\",\n\t\t\t`Failed to build SQLite branch cache at entry ${leafId}`,\n\t\t\terror instanceof Error ? error : undefined,\n\t\t);\n\t}\n}\n\nfunction extendBranch(\n\tdb: SqliteDatabase,\n\tsessionId: string,\n\tbranchId: string,\n\tparentId: string,\n\tentryId: string,\n\tentrySeq: number,\n\tentryType: string,\n\tcustomType: string | null,\n) {\n\tinsertBranchEntry(db, sessionId, branchId, entryId, entrySeq, entryType, customType);\n\tif (!updateBranchTip(db, sessionId, branchId, parentId, entryId)) {\n\t\tthrow new SessionError(\"invalid_entry\", `Branch tip ${parentId} changed during append`);\n\t}\n}\n\nexport function appendEntryToBranchCache(\n\tdb: SqliteDatabase,\n\tsessionId: string,\n\tentryId: string,\n\tentrySeq: number,\n\tentryType: string,\n\tcustomType: string | null,\n\tparentId: string | null,\n) {\n\tif (parentId === null) {\n\t\tconst branchId = uuidv7();\n\t\tinsertBranchEntry(db, sessionId, branchId, entryId, entrySeq, entryType, customType);\n\t\tinsertBranchTip(db, sessionId, entryId, branchId);\n\t\treturn;\n\t}\n\n\tconst tipBranchId = readBranchTipBranchId(db, sessionId, parentId);\n\tif (tipBranchId !== undefined) {\n\t\textendBranch(db, sessionId, tipBranchId, parentId, entryId, entrySeq, entryType, customType);\n\t\treturn;\n\t}\n\n\tconst source = readBranchContainingEntry(db, sessionId, parentId);\n\tif (!source) {\n\t\tthrow new SessionError(\"invalid_entry\", `Branch cache has no branch containing parent entry ${parentId}`);\n\t}\n\n\tconst branchId = uuidv7();\n\tcopyBranchEntriesThroughSeq(db, sessionId, branchId, source.branchId, source.entrySeq);\n\tinsertBranchEntry(db, sessionId, branchId, entryId, entrySeq, entryType, customType);\n\tinsertBranchTip(db, sessionId, entryId, branchId);\n}\n"]}

package/dist/sqlite/branch-cache.js

@@ -0,0 +1,70 @@
+import { SessionError } from "@sammorrowdrums/mcpi-agent-core";
+import { uuidv7 } from "@sammorrowdrums/mcpi-ai";
+import { sql } from "./sql.js";
+import { copyBranchEntriesThroughSeq, deleteBranchEntries, insertBranchEntriesForPath, insertBranchEntry, readBranchContainingEntry, } from "./storage/branch-entries.js";
+import { deleteBranchTips, insertBranchTip, readBranchTipBranchId, updateBranchTip } from "./storage/branch-tips.js";
+export function deleteBranchCache(db, sessionId) {
+    deleteBranchTips(db, sessionId);
+    deleteBranchEntries(db, sessionId);
+}
+export function rebuildBranchCache(db, sessionId) {
+    const tips = sql `SELECT leaf.id
+		FROM entries AS leaf
+		WHERE leaf.session_id = ${sessionId}
+			AND NOT EXISTS (
+				SELECT 1 FROM entries AS child WHERE child.session_id = leaf.session_id AND child.parent_id = leaf.id
+			)
+		ORDER BY leaf.seq`.all(db);
+    deleteBranchCache(db, sessionId);
+    for (const tip of tips)
+        buildCachedBranch(db, sessionId, tip.id);
+}
+export function buildCachedBranch(db, sessionId, leafId) {
+    sql `SAVEPOINT build_branch_cache`.exec(db);
+    try {
+        const branchId = uuidv7();
+        insertBranchEntriesForPath(db, sessionId, branchId, leafId);
+        insertBranchTip(db, sessionId, leafId, branchId);
+        sql `RELEASE SAVEPOINT build_branch_cache`.exec(db);
+    }
+    catch (error) {
+        try {
+            sql `ROLLBACK TO SAVEPOINT build_branch_cache`.exec(db);
+            sql `RELEASE SAVEPOINT build_branch_cache`.exec(db);
+        }
+        catch {
+            // Preserve the original build failure.
+        }
+        if (error instanceof SessionError)
+            throw error;
+        throw new SessionError("storage", `Failed to build SQLite branch cache at entry ${leafId}`, error instanceof Error ? error : undefined);
+    }
+}
+function extendBranch(db, sessionId, branchId, parentId, entryId, entrySeq, entryType, customType) {
+    insertBranchEntry(db, sessionId, branchId, entryId, entrySeq, entryType, customType);
+    if (!updateBranchTip(db, sessionId, branchId, parentId, entryId)) {
+        throw new SessionError("invalid_entry", `Branch tip ${parentId} changed during append`);
+    }
+}
+export function appendEntryToBranchCache(db, sessionId, entryId, entrySeq, entryType, customType, parentId) {
+    if (parentId === null) {
+        const branchId = uuidv7();
+        insertBranchEntry(db, sessionId, branchId, entryId, entrySeq, entryType, customType);
+        insertBranchTip(db, sessionId, entryId, branchId);
+        return;
+    }
+    const tipBranchId = readBranchTipBranchId(db, sessionId, parentId);
+    if (tipBranchId !== undefined) {
+        extendBranch(db, sessionId, tipBranchId, parentId, entryId, entrySeq, entryType, customType);
+        return;
+    }
+    const source = readBranchContainingEntry(db, sessionId, parentId);
+    if (!source) {
+        throw new SessionError("invalid_entry", `Branch cache has no branch containing parent entry ${parentId}`);
+    }
+    const branchId = uuidv7();
+    copyBranchEntriesThroughSeq(db, sessionId, branchId, source.branchId, source.entrySeq);
+    insertBranchEntry(db, sessionId, branchId, entryId, entrySeq, entryType, customType);
+    insertBranchTip(db, sessionId, entryId, branchId);
+}
+//# sourceMappingURL=branch-cache.js.map

package/dist/sqlite/branch-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-cache.js","sourceRoot":"","sources":["../../src/sqlite/branch-cache.ts"],"names":[],"mappings":"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","sourcesContent":["import { SessionError } from \"@sammorrowdrums/mcpi-agent-core\";\nimport { uuidv7 } from \"@sammorrowdrums/mcpi-ai\";\nimport { sql } from \"./sql.ts\";\nimport {\n\tcopyBranchEntriesThroughSeq,\n\tdeleteBranchEntries,\n\tinsertBranchEntriesForPath,\n\tinsertBranchEntry,\n\treadBranchContainingEntry,\n} from \"./storage/branch-entries.ts\";\nimport { deleteBranchTips, insertBranchTip, readBranchTipBranchId, updateBranchTip } from \"./storage/branch-tips.ts\";\nimport type { SqliteDatabase } from \"./types.ts\";\n\nexport function deleteBranchCache(db: SqliteDatabase, sessionId: string) {\n\tdeleteBranchTips(db, sessionId);\n\tdeleteBranchEntries(db, sessionId);\n}\n\nexport function rebuildBranchCache(db: SqliteDatabase, sessionId: string) {\n\tconst tips = sql`SELECT leaf.id\n\t\tFROM entries AS leaf\n\t\tWHERE leaf.session_id = ${sessionId}\n\t\t\tAND NOT EXISTS (\n\t\t\t\tSELECT 1 FROM entries AS child WHERE child.session_id = leaf.session_id AND child.parent_id = leaf.id\n\t\t\t)\n\t\tORDER BY leaf.seq`.all<{ id: string }>(db);\n\tdeleteBranchCache(db, sessionId);\n\tfor (const tip of tips) buildCachedBranch(db, sessionId, tip.id);\n}\n\nexport function buildCachedBranch(db: SqliteDatabase, sessionId: string, leafId: string) {\n\tsql`SAVEPOINT build_branch_cache`.exec(db);\n\ttry {\n\t\tconst branchId = uuidv7();\n\t\tinsertBranchEntriesForPath(db, sessionId, branchId, leafId);\n\t\tinsertBranchTip(db, sessionId, leafId, branchId);\n\t\tsql`RELEASE SAVEPOINT build_branch_cache`.exec(db);\n\t} catch (error) {\n\t\ttry {\n\t\t\tsql`ROLLBACK TO SAVEPOINT build_branch_cache`.exec(db);\n\t\t\tsql`RELEASE SAVEPOINT build_branch_cache`.exec(db);\n\t\t} catch {\n\t\t\t// Preserve the original build failure.\n\t\t}\n\t\tif (error instanceof SessionError) throw error;\n\t\tthrow new SessionError(\n\t\t\t\"storage\",\n\t\t\t`Failed to build SQLite branch cache at entry ${leafId}`,\n\t\t\terror instanceof Error ? error : undefined,\n\t\t);\n\t}\n}\n\nfunction extendBranch(\n\tdb: SqliteDatabase,\n\tsessionId: string,\n\tbranchId: string,\n\tparentId: string,\n\tentryId: string,\n\tentrySeq: number,\n\tentryType: string,\n\tcustomType: string | null,\n) {\n\tinsertBranchEntry(db, sessionId, branchId, entryId, entrySeq, entryType, customType);\n\tif (!updateBranchTip(db, sessionId, branchId, parentId, entryId)) {\n\t\tthrow new SessionError(\"invalid_entry\", `Branch tip ${parentId} changed during append`);\n\t}\n}\n\nexport function appendEntryToBranchCache(\n\tdb: SqliteDatabase,\n\tsessionId: string,\n\tentryId: string,\n\tentrySeq: number,\n\tentryType: string,\n\tcustomType: string | null,\n\tparentId: string | null,\n) {\n\tif (parentId === null) {\n\t\tconst branchId = uuidv7();\n\t\tinsertBranchEntry(db, sessionId, branchId, entryId, entrySeq, entryType, customType);\n\t\tinsertBranchTip(db, sessionId, entryId, branchId);\n\t\treturn;\n\t}\n\n\tconst tipBranchId = readBranchTipBranchId(db, sessionId, parentId);\n\tif (tipBranchId !== undefined) {\n\t\textendBranch(db, sessionId, tipBranchId, parentId, entryId, entrySeq, entryType, customType);\n\t\treturn;\n\t}\n\n\tconst source = readBranchContainingEntry(db, sessionId, parentId);\n\tif (!source) {\n\t\tthrow new SessionError(\"invalid_entry\", `Branch cache has no branch containing parent entry ${parentId}`);\n\t}\n\n\tconst branchId = uuidv7();\n\tcopyBranchEntriesThroughSeq(db, sessionId, branchId, source.branchId, source.entrySeq);\n\tinsertBranchEntry(db, sessionId, branchId, entryId, entrySeq, entryType, customType);\n\tinsertBranchTip(db, sessionId, entryId, branchId);\n}\n"]}

package/dist/sqlite/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./migrations.ts";
+export { SqliteSessionRepository, type SqliteSessionRepositoryOptions, type SqliteWriterLeaseOptions, } from "./repo.ts";
+export * from "./search-backend.ts";
+export * from "./sql.ts";
+export type { SqliteDatabase, SqliteDatabaseFactory, SqliteRunResult, SqliteSessionCreateOptions, SqliteSessionListOptions, SqliteSessionMetadata, SqliteSessionRepositoryEnv, SqliteStatement, } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sqlite/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,OAAO,EACN,uBAAuB,EACvB,KAAK,8BAA8B,EACnC,KAAK,wBAAwB,GAC7B,MAAM,WAAW,CAAC;AACnB,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC;AACzB,YAAY,EACX,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,eAAe,GACf,MAAM,YAAY,CAAC","sourcesContent":["export * from \"./migrations.ts\";\nexport {\n\tSqliteSessionRepository,\n\ttype SqliteSessionRepositoryOptions,\n\ttype SqliteWriterLeaseOptions,\n} from \"./repo.ts\";\nexport * from \"./search-backend.ts\";\nexport * from \"./sql.ts\";\nexport type {\n\tSqliteDatabase,\n\tSqliteDatabaseFactory,\n\tSqliteRunResult,\n\tSqliteSessionCreateOptions,\n\tSqliteSessionListOptions,\n\tSqliteSessionMetadata,\n\tSqliteSessionRepositoryEnv,\n\tSqliteStatement,\n} from \"./types.ts\";\n"]}

package/dist/sqlite/index.js

@@ -0,0 +1,5 @@
+export * from "./migrations.js";
+export { SqliteSessionRepository, } from "./repo.js";
+export * from "./search-backend.js";
+export * from "./sql.js";
+//# sourceMappingURL=index.js.map

package/dist/sqlite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sqlite/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,OAAO,EACN,uBAAuB,GAGvB,MAAM,WAAW,CAAC;AACnB,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC","sourcesContent":["export * from \"./migrations.ts\";\nexport {\n\tSqliteSessionRepository,\n\ttype SqliteSessionRepositoryOptions,\n\ttype SqliteWriterLeaseOptions,\n} from \"./repo.ts\";\nexport * from \"./search-backend.ts\";\nexport * from \"./sql.ts\";\nexport type {\n\tSqliteDatabase,\n\tSqliteDatabaseFactory,\n\tSqliteRunResult,\n\tSqliteSessionCreateOptions,\n\tSqliteSessionListOptions,\n\tSqliteSessionMetadata,\n\tSqliteSessionRepositoryEnv,\n\tSqliteStatement,\n} from \"./types.ts\";\n"]}

package/dist/sqlite/migrations/001_initial.sql

@@ -0,0 +1,122 @@
+CREATE TABLE IF NOT EXISTS sessions (
+	id TEXT PRIMARY KEY,
+	created_at INTEGER NOT NULL,
+	cwd TEXT NOT NULL,
+	parent_session_id TEXT NULL,
+	metadata TEXT NULL
+) WITHOUT ROWID;
+
+CREATE INDEX IF NOT EXISTS idx_sessions_created_at ON sessions(created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_sessions_cwd_created_at ON sessions(cwd, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS entries (
+	session_id TEXT NOT NULL,
+	seq INTEGER NOT NULL,
+	id TEXT NOT NULL,
+	parent_id TEXT NULL,
+	type TEXT NOT NULL,
+	timestamp INTEGER NOT NULL,
+	payload TEXT NOT NULL,
+	PRIMARY KEY (session_id, id),
+	UNIQUE (session_id, seq)
+);
+
+CREATE INDEX IF NOT EXISTS idx_entries_session_parent ON entries(session_id, parent_id);
+CREATE INDEX IF NOT EXISTS idx_entries_session_type_seq ON entries(session_id, type, seq);
+
+CREATE TABLE IF NOT EXISTS session_sequences (
+	session_id TEXT PRIMARY KEY,
+	next_seq INTEGER NOT NULL
+) WITHOUT ROWID;
+
+CREATE TABLE IF NOT EXISTS session_stats (
+	session_id TEXT PRIMARY KEY,
+	message_count INTEGER NOT NULL,
+	cached_tokens REAL NOT NULL,
+	uncached_tokens REAL NOT NULL,
+	total_tokens REAL NOT NULL,
+	cost_total REAL NOT NULL
+) WITHOUT ROWID;
+
+-- Derived branch cache. Parent links in entries remain canonical; this cache
+-- exists only to make branch scans cheap.
+CREATE TABLE IF NOT EXISTS branch_entries (
+	session_id TEXT NOT NULL,
+	branch_id TEXT NOT NULL,
+	entry_id TEXT NOT NULL,
+	entry_seq INTEGER NOT NULL,
+	entry_type TEXT NULL,
+	custom_type TEXT NULL,
+	PRIMARY KEY (session_id, branch_id, entry_id)
+) WITHOUT ROWID;
+
+CREATE INDEX IF NOT EXISTS idx_branch_entries_session_branch_seq ON branch_entries(session_id, branch_id, entry_seq);
+CREATE INDEX IF NOT EXISTS idx_branch_entries_session_entry ON branch_entries(session_id, entry_id, branch_id, entry_seq);
+CREATE INDEX IF NOT EXISTS idx_branch_entries_session_branch_type_seq ON branch_entries(session_id, branch_id, entry_type, entry_seq);
+CREATE INDEX IF NOT EXISTS idx_branch_entries_session_branch_custom_seq ON branch_entries(session_id, branch_id, custom_type, entry_seq);
+
+CREATE TABLE IF NOT EXISTS lanes (
+	session_id TEXT NOT NULL,
+	lane TEXT NOT NULL,
+	leaf_id TEXT NULL,
+	open_operation_id TEXT NULL,
+	PRIMARY KEY (session_id, lane)
+) WITHOUT ROWID;
+
+CREATE TABLE IF NOT EXISTS records (
+	session_id TEXT NOT NULL,
+	seq INTEGER NOT NULL,
+	id TEXT NOT NULL,
+	lane TEXT NOT NULL,
+	run_id TEXT NULL,
+	type TEXT NOT NULL,
+	op_kind TEXT NULL,
+	timestamp INTEGER NOT NULL,
+	payload TEXT NOT NULL,
+	PRIMARY KEY (session_id, id),
+	UNIQUE (session_id, seq)
+) WITHOUT ROWID;
+
+CREATE INDEX IF NOT EXISTS idx_records_session_lane_seq ON records(session_id, lane, seq);
+CREATE INDEX IF NOT EXISTS idx_records_session_type_seq ON records(session_id, type, seq);
+CREATE INDEX IF NOT EXISTS idx_records_session_type_op_kind_seq ON records(session_id, type, op_kind, seq);
+CREATE INDEX IF NOT EXISTS idx_records_session_lane_type_seq ON records(session_id, lane, type, seq);
+CREATE INDEX IF NOT EXISTS idx_records_session_lane_type_op_kind_seq ON records(session_id, lane, type, op_kind, seq);
+CREATE INDEX IF NOT EXISTS idx_records_session_run_id_seq ON records(session_id, run_id, seq);
+
+CREATE TABLE IF NOT EXISTS lane_moves (
+	session_id TEXT NOT NULL,
+	seq INTEGER NOT NULL,
+	lane TEXT NOT NULL,
+	leaf_id TEXT NULL,
+	PRIMARY KEY (session_id, seq)
+) WITHOUT ROWID;
+
+
+CREATE TABLE IF NOT EXISTS facts (
+	session_id TEXT NOT NULL,
+	seq INTEGER NOT NULL,
+	kind TEXT NOT NULL,
+	key TEXT NULL,
+	value TEXT NULL,
+	PRIMARY KEY (session_id, seq)
+) WITHOUT ROWID;
+
+CREATE INDEX IF NOT EXISTS idx_facts_session_kind_key_seq ON facts(session_id, kind, key, seq);
+
+CREATE TABLE IF NOT EXISTS branch_tips (
+	session_id TEXT NOT NULL,
+	branch_id TEXT NOT NULL,
+	tip_id TEXT NOT NULL,
+	PRIMARY KEY (session_id, tip_id),
+	UNIQUE (session_id, branch_id)
+) WITHOUT ROWID;
+
+-- Per-session writer claim. The fence prevents an expired owner from writing
+-- after a new owner takes over the session.
+CREATE TABLE IF NOT EXISTS writer_leases (
+	session_id TEXT PRIMARY KEY,
+	owner_id TEXT NOT NULL,
+	fence INTEGER NOT NULL,
+	expires_at_ms INTEGER NOT NULL
+) WITHOUT ROWID;

package/dist/sqlite/migrations.d.ts

@@ -0,0 +1,9 @@
+import type { SqliteDatabase } from "./types.ts";
+export interface SqliteMigration {
+    id: string;
+    order: number;
+    sql: string;
+}
+export declare function loadMigrations(): Promise<SqliteMigration[]>;
+export declare function applyMigrations(db: SqliteDatabase): Promise<void>;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/sqlite/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/sqlite/migrations.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACZ;AAMD,wBAAsB,cAAc,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAQjE;AAWD,wBAAsB,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAcvE","sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { fileURLToPath } from \"node:url\";\nimport { sql } from \"./sql.ts\";\nimport type { SqliteDatabase } from \"./types.ts\";\n\nexport interface SqliteMigration {\n\tid: string;\n\torder: number;\n\tsql: string;\n}\n\nasync function loadMigrationSql(relativePath: string): Promise<string> {\n\treturn readFile(fileURLToPath(new URL(relativePath, import.meta.url)), \"utf8\");\n}\n\nexport async function loadMigrations(): Promise<SqliteMigration[]> {\n\treturn [\n\t\t{\n\t\t\tid: \"001_initial.sql\",\n\t\t\torder: 1,\n\t\t\tsql: await loadMigrationSql(\"./migrations/001_initial.sql\"),\n\t\t},\n\t];\n}\n\nfunction ensureMigrationsTable(db: SqliteDatabase): void {\n\tsql`\nCREATE TABLE IF NOT EXISTS migrations (\n\tid TEXT PRIMARY KEY,\n\tapplied_at TEXT NOT NULL\n);\n`.exec(db);\n}\n\nexport async function applyMigrations(db: SqliteDatabase): Promise<void> {\n\tensureMigrationsTable(db);\n\tconst migrations = await loadMigrations();\n\tconst appliedRows = sql`SELECT id FROM migrations ORDER BY applied_at, id`.all<{ id: string }>(db);\n\tconst applied = new Set(appliedRows.map((row) => row.id));\n\n\tfor (const migration of migrations) {\n\t\tif (applied.has(migration.id)) continue;\n\t\tdb.transaction(() => {\n\t\t\tdb.exec(migration.sql);\n\t\t\tsql`INSERT INTO migrations (id, applied_at) VALUES (${migration.id}, ${new Date().toISOString()})`.run(db);\n\t\t});\n\t\tapplied.add(migration.id);\n\t}\n}\n"]}

package/dist/sqlite/migrations.js

@@ -0,0 +1,39 @@
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { sql } from "./sql.js";
+async function loadMigrationSql(relativePath) {
+    return readFile(fileURLToPath(new URL(relativePath, import.meta.url)), "utf8");
+}
+export async function loadMigrations() {
+    return [
+        {
+            id: "001_initial.sql",
+            order: 1,
+            sql: await loadMigrationSql("./migrations/001_initial.sql"),
+        },
+    ];
+}
+function ensureMigrationsTable(db) {
+    sql `
+CREATE TABLE IF NOT EXISTS migrations (
+	id TEXT PRIMARY KEY,
+	applied_at TEXT NOT NULL
+);
+`.exec(db);
+}
+export async function applyMigrations(db) {
+    ensureMigrationsTable(db);
+    const migrations = await loadMigrations();
+    const appliedRows = sql `SELECT id FROM migrations ORDER BY applied_at, id`.all(db);
+    const applied = new Set(appliedRows.map((row) => row.id));
+    for (const migration of migrations) {
+        if (applied.has(migration.id))
+            continue;
+        db.transaction(() => {
+            db.exec(migration.sql);
+            sql `INSERT INTO migrations (id, applied_at) VALUES (${migration.id}, ${new Date().toISOString()})`.run(db);
+        });
+        applied.add(migration.id);
+    }
+}
+//# sourceMappingURL=migrations.js.map

package/dist/sqlite/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/sqlite/migrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAS/B,KAAK,UAAU,gBAAgB,CAAC,YAAoB,EAAmB;IACtE,OAAO,QAAQ,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAAA,CAC/E;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,GAA+B;IAClE,OAAO;QACN;YACC,EAAE,EAAE,iBAAiB;YACrB,KAAK,EAAE,CAAC;YACR,GAAG,EAAE,MAAM,gBAAgB,CAAC,8BAA8B,CAAC;SAC3D;KACD,CAAC;AAAA,CACF;AAED,SAAS,qBAAqB,CAAC,EAAkB,EAAQ;IACxD,GAAG,CAAA;;;;;CAKH,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAAA,CACV;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EAAkB,EAAiB;IACxE,qBAAqB,CAAC,EAAE,CAAC,CAAC;IAC1B,MAAM,UAAU,GAAG,MAAM,cAAc,EAAE,CAAC;IAC1C,MAAM,WAAW,GAAG,GAAG,CAAA,mDAAmD,CAAC,GAAG,CAAiB,EAAE,CAAC,CAAC;IACnG,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAE1D,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAAE,SAAS;QACxC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;YACpB,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACvB,GAAG,CAAA,mDAAmD,SAAS,CAAC,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAAA,CAC3G,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;AAAA,CACD","sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport { fileURLToPath } from \"node:url\";\nimport { sql } from \"./sql.ts\";\nimport type { SqliteDatabase } from \"./types.ts\";\n\nexport interface SqliteMigration {\n\tid: string;\n\torder: number;\n\tsql: string;\n}\n\nasync function loadMigrationSql(relativePath: string): Promise<string> {\n\treturn readFile(fileURLToPath(new URL(relativePath, import.meta.url)), \"utf8\");\n}\n\nexport async function loadMigrations(): Promise<SqliteMigration[]> {\n\treturn [\n\t\t{\n\t\t\tid: \"001_initial.sql\",\n\t\t\torder: 1,\n\t\t\tsql: await loadMigrationSql(\"./migrations/001_initial.sql\"),\n\t\t},\n\t];\n}\n\nfunction ensureMigrationsTable(db: SqliteDatabase): void {\n\tsql`\nCREATE TABLE IF NOT EXISTS migrations (\n\tid TEXT PRIMARY KEY,\n\tapplied_at TEXT NOT NULL\n);\n`.exec(db);\n}\n\nexport async function applyMigrations(db: SqliteDatabase): Promise<void> {\n\tensureMigrationsTable(db);\n\tconst migrations = await loadMigrations();\n\tconst appliedRows = sql`SELECT id FROM migrations ORDER BY applied_at, id`.all<{ id: string }>(db);\n\tconst applied = new Set(appliedRows.map((row) => row.id));\n\n\tfor (const migration of migrations) {\n\t\tif (applied.has(migration.id)) continue;\n\t\tdb.transaction(() => {\n\t\t\tdb.exec(migration.sql);\n\t\t\tsql`INSERT INTO migrations (id, applied_at) VALUES (${migration.id}, ${new Date().toISOString()})`.run(db);\n\t\t});\n\t\tapplied.add(migration.id);\n\t}\n}\n"]}

package/dist/sqlite/repo.d.ts

@@ -0,0 +1,41 @@
+import { type ForkOptions, Session, type SessionRepo as SessionRepository } from "@sammorrowdrums/mcpi-agent-core";
+import type { SqliteDatabaseFactory, SqliteSessionCreateOptions, SqliteSessionListOptions, SqliteSessionMetadata, SqliteSessionRepositoryEnv } from "./types.ts";
+export interface SqliteWriterLeaseOptions {
+    /** Time without a successful heartbeat before another writer may take over. Default: 30 seconds. */
+    ttlMs?: number;
+    /** Idle heartbeat cadence. Default: 10 seconds. Must be less than ttlMs. */
+    heartbeatIntervalMs?: number;
+}
+export interface SqliteSessionRepositoryOptions {
+    env: SqliteSessionRepositoryEnv;
+    sqlite: SqliteDatabaseFactory;
+    databasePath: string;
+    writerLease?: SqliteWriterLeaseOptions;
+}
+export declare class SqliteSessionRepository implements SessionRepository<SqliteSessionMetadata, SqliteSessionCreateOptions, SqliteSessionListOptions>, AsyncDisposable {
+    private databasePath;
+    private database;
+    private databasePromise;
+    private readonly operations;
+    private readonly activeStorages;
+    private readonly options;
+    private readonly leaseOptions;
+    constructor(options: SqliteSessionRepositoryOptions);
+    private releaseStoragesForSession;
+    private sessionFromLease;
+    private claimSession;
+    create(options: SqliteSessionCreateOptions): Promise<Session<SqliteSessionMetadata>>;
+    open(metadata: SqliteSessionMetadata): Promise<Session<SqliteSessionMetadata>>;
+    /** Rebuilds this session's private branch-read cache from canonical entry parent links. */
+    repairBranchCache(metadata: SqliteSessionMetadata): Promise<void>;
+    /** Reads the session catalog without acquiring or renewing per-session writer leases. */
+    list(options?: SqliteSessionListOptions): Promise<SqliteSessionMetadata[]>;
+    delete(metadata: SqliteSessionMetadata): Promise<void>;
+    fork(source: SqliteSessionMetadata, options: ForkOptions & SqliteSessionCreateOptions): Promise<Session<SqliteSessionMetadata>>;
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+    private getDatabasePath;
+    private getDatabase;
+    private openDatabase;
+}
+//# sourceMappingURL=repo.d.ts.map