@falai/agent 3.4.5 → 4.0.0-alpha.1

package/dist/cjs/persistence/OpenSearchStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenSearchStore.d.ts","sourceRoot":"","sources":["../../../src/persistence/OpenSearchStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG1D,KAAK,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;AAEpC,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,MAAM,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;QAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IAC1C,MAAM,CAAC,MAAM,EAAE;QACb,KAAK,EAAE,MAAM,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IAC1C,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IACpG,OAAO,EAAE;QACP,MAAM,CAAC,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC;YAAE,IAAI,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE;gBAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;aAAE,CAAA;SAAE,GAAG,OAAO,CAAC;YAAE,IAAI,EAAE;gBAAE,YAAY,EAAE,OAAO,CAAA;aAAE,CAAA;SAAE,CAAC,CAAC;KAC/H,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,+GAA+G;IAC/G,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAOD,qBAAa,eAAe,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAE,sBAA2B;IAO1E,2FAA2F;IACrF,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAU5C,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAqC/D,aAAa;CAU5B"}

package/dist/cjs/persistence/OpenSearchStore.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * OpenSearch Store over the official client (Elasticsearch 7.x fits too).
+ *
+ * One document per session: `id`, `version`, `blob` (stored, not indexed),
+ * `createdAt`, `updatedAt`. A first save is an `index` with `op_type:
+ * 'create'`, and the 409 is the conflict; later saves are a scripted
+ * `update` that compares `version` and becomes a `noop` when it differs,
+ * so the check and the write happen together on the shard (3.x read, then
+ * wrote).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenSearchStore = void 0;
+const errors_js_1 = require("../types/errors.js");
+const sessionRow_js_1 = require("./sessionRow.js");
+/** Writes the new version only when the stored one is the expected one; otherwise a noop. */
+const CAS_SCRIPT = "if (ctx._source.version != params.expected) { ctx.op = 'noop' } " +
+    "else { ctx._source.version = params.version; ctx._source.blob = params.blob; ctx._source.updatedAt = params.updatedAt }";
+class OpenSearchStore {
+    constructor(client, options = {}) {
+        this.client = client;
+        this.index = options.indices?.sessions ?? "agent_sessions";
+        this.autoCreateIndices = options.autoCreateIndices ?? true;
+        this.refresh = options.refresh ?? false;
+    }
+    /** Create the index with its mappings when it is missing and `autoCreateIndices` is on. */
+    async initialize() {
+        if (!this.autoCreateIndices)
+            return;
+        const exists = await this.client.indices.exists({ index: this.index });
+        if (exists.body)
+            return;
+        await this.client.indices.create({
+            index: this.index,
+            body: {
+                mappings: {
+                    properties: {
+                        id: { type: "keyword" },
+                        version: { type: "integer" },
+                        blob: { type: "object", enabled: false },
+                        createdAt: { type: "date" },
+                        updatedAt: { type: "date" },
+                    },
+                },
+            },
+        });
+    }
+    async load(id) {
+        try {
+            const response = await this.client.get({ index: this.index, id });
+            return (0, sessionRow_js_1.readBlob)(response.body._source.blob, id);
+        }
+        catch (error) {
+            if (statusCodeOf(error) === 404)
+                return null;
+            throw error;
+        }
+    }
+    async save(session, expectedVersion) {
+        const next = expectedVersion + 1;
+        const blob = (0, sessionRow_js_1.toBlob)(session, next);
+        const now = new Date().toISOString();
+        if (expectedVersion === 0) {
+            try {
+                await this.client.index({
+                    index: this.index,
+                    id: session.id,
+                    op_type: "create",
+                    body: { id: session.id, version: next, blob, createdAt: now, updatedAt: now },
+                    refresh: this.refresh,
+                });
+            }
+            catch (error) {
+                if (statusCodeOf(error) !== 409)
+                    throw error;
+                throw new errors_js_1.SessionConflictError(session.id, 0, await this.storedVersion(session.id));
+            }
+            return blob;
+        }
+        try {
+            const response = await this.client.update({
+                index: this.index,
+                id: session.id,
+                retry_on_conflict: 3,
+                refresh: this.refresh,
+                body: {
+                    script: { lang: "painless", source: CAS_SCRIPT, params: { expected: expectedVersion, version: next, blob, updatedAt: now } },
+                },
+            });
+            if (response.body.result !== "noop")
+                return blob;
+        }
+        catch (error) {
+            const status = statusCodeOf(error);
+            if (status !== 404 && status !== 409)
+                throw error;
+        }
+        throw new errors_js_1.SessionConflictError(session.id, expectedVersion, await this.storedVersion(session.id));
+    }
+    async storedVersion(id) {
+        try {
+            const response = await this.client.get({ index: this.index, id });
+            const version = response.body._source.version;
+            return typeof version === "number" ? version : undefined;
+        }
+        catch (error) {
+            if (statusCodeOf(error) === 404)
+                return undefined;
+            throw error;
+        }
+    }
+}
+exports.OpenSearchStore = OpenSearchStore;
+/** The client's `ResponseError` carries the HTTP status as `statusCode`. */
+function statusCodeOf(error) {
+    return typeof error === "object" && error !== null && "statusCode" in error && typeof error.statusCode === "number"
+        ? error.statusCode
+        : undefined;
+}
+//# sourceMappingURL=OpenSearchStore.js.map

package/dist/cjs/persistence/OpenSearchStore.js.map

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

package/dist/cjs/persistence/PostgresStore.d.ts

@@ -0,0 +1,41 @@
+/**
+ * PostgreSQL Store over a `pg` client or pool.
+ *
+ * One row per session: `id`, `version`, `blob` (the v4 session as JSONB),
+ * `created_at`, `updated_at`. The compare-and-swap is the statement itself:
+ * `INSERT … ON CONFLICT DO NOTHING` for a first save, `UPDATE … WHERE
+ * version = $n` after; no row back means someone else got there first.
+ *
+ * A 3.x `agent_sessions` table has different columns. Point `tables.sessions`
+ * at a fresh table; 3.x blobs move through `migrateSession` at the host's
+ * choke point, not through this table.
+ */
+import type { Session, Store } from "../types/session.js";
+export interface PgQueryResult<T = Record<string, unknown>> {
+    rows: T[];
+    rowCount?: number | null;
+}
+/** Matches `pg`'s Client and Pool. */
+export interface PgClient {
+    query<T = Record<string, unknown>>(sql: string, values?: unknown[]): Promise<PgQueryResult<T>>;
+    end(): Promise<void>;
+}
+export interface PostgresStoreOptions {
+    client: PgClient;
+    /** Table name. Default `agent_sessions`. */
+    tables?: {
+        sessions?: string;
+    };
+}
+export declare class PostgresStore<D = unknown> implements Store<D> {
+    private readonly client;
+    private readonly table;
+    constructor(options: PostgresStoreOptions);
+    /** Create the table when it is missing. */
+    initialize(): Promise<void>;
+    disconnect(): Promise<void>;
+    load(id: string): Promise<Session<D> | null>;
+    save(session: Session<D>, expectedVersion: number): Promise<Session<D>>;
+    private storedVersion;
+}
+//# sourceMappingURL=PostgresStore.d.ts.map

package/dist/cjs/persistence/PostgresStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresStore.d.ts","sourceRoot":"","sources":["../../../src/persistence/PostgresStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG1D,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxD,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,sCAAsC;AACtC,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/F,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,QAAQ,CAAC;IACjB,4CAA4C;IAC5C,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AAED,qBAAa,aAAa,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,EAAE,oBAAoB;IAKzC,2CAA2C;IACrC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAK5C,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAkB/D,aAAa;CAK5B"}

package/dist/cjs/persistence/PostgresStore.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * PostgreSQL Store over a `pg` client or pool.
+ *
+ * One row per session: `id`, `version`, `blob` (the v4 session as JSONB),
+ * `created_at`, `updated_at`. The compare-and-swap is the statement itself:
+ * `INSERT … ON CONFLICT DO NOTHING` for a first save, `UPDATE … WHERE
+ * version = $n` after; no row back means someone else got there first.
+ *
+ * A 3.x `agent_sessions` table has different columns. Point `tables.sessions`
+ * at a fresh table; 3.x blobs move through `migrateSession` at the host's
+ * choke point, not through this table.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresStore = void 0;
+const errors_js_1 = require("../types/errors.js");
+const sessionRow_js_1 = require("./sessionRow.js");
+class PostgresStore {
+    constructor(options) {
+        this.client = options.client;
+        this.table = options.tables?.sessions ?? "agent_sessions";
+    }
+    /** Create the table when it is missing. */
+    async initialize() {
+        await this.client.query(`CREATE TABLE IF NOT EXISTS ${this.table} (
+        id VARCHAR(255) PRIMARY KEY,
+        version INTEGER NOT NULL,
+        blob JSONB NOT NULL,
+        created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+        updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+      )`);
+    }
+    async disconnect() {
+        await this.client.end();
+    }
+    async load(id) {
+        const { rows } = await this.client.query(`SELECT blob FROM ${this.table} WHERE id = $1`, [id]);
+        return rows.length > 0 ? (0, sessionRow_js_1.readBlob)(rows[0].blob, id) : null;
+    }
+    async save(session, expectedVersion) {
+        const next = expectedVersion + 1;
+        const blob = (0, sessionRow_js_1.toBlob)(session, next);
+        const json = JSON.stringify(blob);
+        const { rows } = expectedVersion === 0
+            ? await this.client.query(`INSERT INTO ${this.table} (id, version, blob) VALUES ($1, $2, $3) ON CONFLICT (id) DO NOTHING RETURNING version`, [session.id, next, json])
+            : await this.client.query(`UPDATE ${this.table} SET version = $2, blob = $3, updated_at = NOW() WHERE id = $1 AND version = $4 RETURNING version`, [session.id, next, json, expectedVersion]);
+        if (rows.length === 0)
+            throw new errors_js_1.SessionConflictError(session.id, expectedVersion, await this.storedVersion(session.id));
+        return blob;
+    }
+    async storedVersion(id) {
+        const { rows } = await this.client.query(`SELECT version FROM ${this.table} WHERE id = $1`, [id]);
+        const version = rows[0]?.version;
+        return typeof version === "number" ? version : undefined;
+    }
+}
+exports.PostgresStore = PostgresStore;
+//# sourceMappingURL=PostgresStore.js.map

package/dist/cjs/persistence/PostgresStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresStore.js","sourceRoot":"","sources":["../../../src/persistence/PostgresStore.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAEH,kDAA0D;AAE1D,mDAAmD;AAmBnD,MAAa,aAAa;IAIxB,YAAY,OAA6B;QACvC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,QAAQ,IAAI,gBAAgB,CAAC;IAC5D,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CACrB,8BAA8B,IAAI,CAAC,KAAK;;;;;;QAMtC,CACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAU;QACnB,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,IAAI,CAAC,KAAK,gBAAgB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/F,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAA,wBAAQ,EAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAmB,EAAE,eAAuB;QACrD,MAAM,IAAI,GAAG,eAAe,GAAG,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,IAAA,sBAAM,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,EAAE,IAAI,EAAE,GACZ,eAAe,KAAK,CAAC;YACnB,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CACrB,eAAe,IAAI,CAAC,KAAK,wFAAwF,EACjH,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CACzB;YACH,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CACrB,UAAU,IAAI,CAAC,KAAK,mGAAmG,EACvH,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,CAAC,CAC1C,CAAC;QACR,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,gCAAoB,CAAC,OAAO,CAAC,EAAE,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;QACzH,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,EAAU;QACpC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,IAAI,CAAC,KAAK,gBAAgB,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAClG,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;QACjC,OAAO,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,CAAC;CACF;AAtDD,sCAsDC"}

package/dist/cjs/persistence/PrismaStore.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Prisma Store over a generated Prisma client.
+ *
+ * The model (default `agentSession`) needs five fields, renameable through
+ * `fieldMappings.sessions`:
+ *
+ * ```prisma
+ * model AgentSession {
+ *   id        String   @id
+ *   version   Int
+ *   blob      Json
+ *   createdAt DateTime @default(now())
+ *   updatedAt DateTime @updatedAt
+ * }
+ * ```
+ *
+ * A first save is `create`, and Prisma's unique violation (`P2002`) is the
+ * conflict; later saves are `updateMany` filtered on `{ id, version }`, and
+ * `count === 0` is the conflict. 3.x read, checked and wrote in three steps
+ * and tolerated a model without `version`; neither survives.
+ */
+import type { Session, Store } from "../types/session.js";
+/** The delegate a generated client exposes per model. */
+export interface PrismaSessionModel {
+    create(params: {
+        data: Record<string, unknown>;
+    }): Promise<Record<string, unknown>>;
+    findUnique(params: {
+        where: Record<string, unknown>;
+    }): Promise<Record<string, unknown> | null>;
+    updateMany(params: {
+        where: Record<string, unknown>;
+        data: Record<string, unknown>;
+    }): Promise<{
+        count: number;
+    }>;
+}
+/** Matches a generated Prisma client: model delegates by name, plus `$disconnect`. */
+export interface PrismaClient {
+    [model: string]: unknown;
+    $disconnect?: () => Promise<void>;
+}
+export type PrismaSessionField = "id" | "version" | "blob" | "createdAt" | "updatedAt";
+export interface PrismaStoreOptions {
+    prisma: PrismaClient;
+    /** Model name on the client. Default `agentSession`. */
+    tables?: {
+        sessions?: string;
+    };
+    /** Field names when the model uses other names. */
+    fieldMappings?: {
+        sessions?: Partial<Record<PrismaSessionField, string>>;
+    };
+}
+export declare class PrismaStore<D = unknown> implements Store<D> {
+    private readonly prisma;
+    private readonly model;
+    private readonly field;
+    constructor(options: PrismaStoreOptions);
+    disconnect(): Promise<void>;
+    load(id: string): Promise<Session<D> | null>;
+    save(session: Session<D>, expectedVersion: number): Promise<Session<D>>;
+    private storedVersion;
+}
+//# sourceMappingURL=PrismaStore.d.ts.map

package/dist/cjs/persistence/PrismaStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrismaStore.d.ts","sourceRoot":"","sources":["../../../src/persistence/PrismaStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG1D,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpF,UAAU,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAChG,UAAU,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnH;AAED,sFAAsF;AACtF,MAAM,WAAW,YAAY;IAC3B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC;AAEvF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,YAAY,CAAC;IACrB,wDAAwD;IACxD,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,mDAAmD;IACnD,aAAa,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAA;KAAE,CAAC;CAC5E;AAED,qBAAa,WAAW,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;gBAE/C,OAAO,EAAE,kBAAkB;IAqBjC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAK5C,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAwB/D,aAAa;CAK5B"}

package/dist/cjs/persistence/PrismaStore.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Prisma Store over a generated Prisma client.
+ *
+ * The model (default `agentSession`) needs five fields, renameable through
+ * `fieldMappings.sessions`:
+ *
+ * ```prisma
+ * model AgentSession {
+ *   id        String   @id
+ *   version   Int
+ *   blob      Json
+ *   createdAt DateTime @default(now())
+ *   updatedAt DateTime @updatedAt
+ * }
+ * ```
+ *
+ * A first save is `create`, and Prisma's unique violation (`P2002`) is the
+ * conflict; later saves are `updateMany` filtered on `{ id, version }`, and
+ * `count === 0` is the conflict. 3.x read, checked and wrote in three steps
+ * and tolerated a model without `version`; neither survives.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrismaStore = void 0;
+const json_js_1 = require("../utils/json.js");
+const errors_js_1 = require("../types/errors.js");
+const sessionRow_js_1 = require("./sessionRow.js");
+class PrismaStore {
+    constructor(options) {
+        const name = options.tables?.sessions ?? "agentSession";
+        const model = options.prisma[name];
+        if (!isSessionModel(model)) {
+            throw new TypeError(`[TypeError] PrismaStore cannot use model "${name}": the client has no such delegate with create, findUnique and updateMany. ` +
+                `Add the model to schema.prisma and run prisma generate, or pass tables.sessions with its name.`);
+        }
+        this.prisma = options.prisma;
+        this.model = model;
+        const custom = options.fieldMappings?.sessions ?? {};
+        this.field = {
+            id: custom.id ?? "id",
+            version: custom.version ?? "version",
+            blob: custom.blob ?? "blob",
+            createdAt: custom.createdAt ?? "createdAt",
+            updatedAt: custom.updatedAt ?? "updatedAt",
+        };
+    }
+    async disconnect() {
+        await this.prisma.$disconnect?.();
+    }
+    async load(id) {
+        const row = await this.model.findUnique({ where: { [this.field.id]: id } });
+        return row ? (0, sessionRow_js_1.readBlob)(row[this.field.blob], id) : null;
+    }
+    async save(session, expectedVersion) {
+        const next = expectedVersion + 1;
+        const blob = (0, sessionRow_js_1.toBlob)(session, next);
+        const now = new Date();
+        const { field } = this;
+        if (expectedVersion === 0) {
+            try {
+                await this.model.create({
+                    data: { [field.id]: session.id, [field.version]: next, [field.blob]: blob, [field.createdAt]: now, [field.updatedAt]: now },
+                });
+            }
+            catch (error) {
+                if (!isUniqueViolation(error))
+                    throw error;
+                throw new errors_js_1.SessionConflictError(session.id, 0, await this.storedVersion(session.id));
+            }
+            return blob;
+        }
+        const { count } = await this.model.updateMany({
+            where: { [field.id]: session.id, [field.version]: expectedVersion },
+            data: { [field.version]: next, [field.blob]: blob, [field.updatedAt]: now },
+        });
+        if (count === 0)
+            throw new errors_js_1.SessionConflictError(session.id, expectedVersion, await this.storedVersion(session.id));
+        return blob;
+    }
+    async storedVersion(id) {
+        const row = await this.model.findUnique({ where: { [this.field.id]: id } });
+        const version = row?.[this.field.version];
+        return typeof version === "number" ? version : undefined;
+    }
+}
+exports.PrismaStore = PrismaStore;
+function isSessionModel(value) {
+    return ((0, json_js_1.isRecord)(value) &&
+        typeof value.create === "function" &&
+        typeof value.findUnique === "function" &&
+        typeof value.updateMany === "function");
+}
+/** Prisma's `PrismaClientKnownRequestError` for a unique constraint hit. */
+const isUniqueViolation = (error) => (0, json_js_1.isRecord)(error) && error.code === "P2002";
+//# sourceMappingURL=PrismaStore.js.map

package/dist/cjs/persistence/PrismaStore.js.map

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

package/dist/cjs/persistence/RedisStore.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Redis Store over an ioredis-shaped client.
+ *
+ * One hash per session at `${keyPrefix}session:${id}` with the fields
+ * `version`, `blob` (the v4 session as JSON text), `createdAt`, `updatedAt`.
+ * The compare-and-swap is one Lua script, so two writers on a shared client
+ * cannot interleave between the read and the write (3.x checked, then set;
+ * WATCH/MULTI would not do either, since WATCH is per connection).
+ */
+import type { Session, Store } from "../types/session.js";
+/** Matches ioredis. node-redis users wrap `eval` to this positional form. */
+export interface RedisClient {
+    hgetall(key: string): Promise<Record<string, string>>;
+    eval(script: string, numKeys: number, ...args: (string | number)[]): Promise<unknown>;
+    quit(): Promise<string>;
+}
+export interface RedisStoreOptions {
+    redis: RedisClient;
+    /** Prefix of every key. Default `agent:`. */
+    keyPrefix?: string;
+    /** Seconds a session lives after its last save; `0` keeps it forever. Default 7 days. */
+    sessionTTL?: number;
+}
+export declare class RedisStore<D = unknown> implements Store<D> {
+    private readonly redis;
+    private readonly keyPrefix;
+    private readonly ttl;
+    constructor(options: RedisStoreOptions);
+    disconnect(): Promise<void>;
+    load(id: string): Promise<Session<D> | null>;
+    save(session: Session<D>, expectedVersion: number): Promise<Session<D>>;
+    private key;
+}
+//# sourceMappingURL=RedisStore.d.ts.map

package/dist/cjs/persistence/RedisStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisStore.d.ts","sourceRoot":"","sources":["../../../src/persistence/RedisStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG1D,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtF,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,WAAW,CAAC;IACnB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAoBD,qBAAa,UAAU,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,OAAO,EAAE,iBAAiB;IAMhC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAM5C,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAkB7E,OAAO,CAAC,GAAG;CAGZ"}

package/dist/cjs/persistence/RedisStore.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * Redis Store over an ioredis-shaped client.
+ *
+ * One hash per session at `${keyPrefix}session:${id}` with the fields
+ * `version`, `blob` (the v4 session as JSON text), `createdAt`, `updatedAt`.
+ * The compare-and-swap is one Lua script, so two writers on a shared client
+ * cannot interleave between the read and the write (3.x checked, then set;
+ * WATCH/MULTI would not do either, since WATCH is per connection).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisStore = void 0;
+const errors_js_1 = require("../types/errors.js");
+const sessionRow_js_1 = require("./sessionRow.js");
+/**
+ * KEYS[1] the session hash; ARGV: expected version, next version, blob, now, ttl.
+ * Returns nil on success, the stored version on a conflict, `missing` when
+ * the hash is gone.
+ */
+const CAS_SCRIPT = `
+local current = redis.call('HGET', KEYS[1], 'version')
+if ARGV[1] == '0' then
+  if current then return current end
+elseif current ~= ARGV[1] then
+  return current or 'missing'
+end
+redis.call('HSET', KEYS[1], 'version', ARGV[2], 'blob', ARGV[3], 'updatedAt', ARGV[4])
+redis.call('HSETNX', KEYS[1], 'createdAt', ARGV[4])
+if tonumber(ARGV[5]) > 0 then redis.call('EXPIRE', KEYS[1], ARGV[5]) end
+return nil
+`;
+class RedisStore {
+    constructor(options) {
+        this.redis = options.redis;
+        this.keyPrefix = options.keyPrefix ?? "agent:";
+        this.ttl = options.sessionTTL ?? 7 * 24 * 60 * 60;
+    }
+    async disconnect() {
+        await this.redis.quit();
+    }
+    async load(id) {
+        const row = await this.redis.hgetall(this.key(id));
+        if (Object.keys(row).length === 0)
+            return null;
+        return (0, sessionRow_js_1.readBlob)(row.blob, id);
+    }
+    async save(session, expectedVersion) {
+        const next = expectedVersion + 1;
+        const blob = (0, sessionRow_js_1.toBlob)(session, next);
+        const result = await this.redis.eval(CAS_SCRIPT, 1, this.key(session.id), String(expectedVersion), String(next), JSON.stringify(blob), new Date().toISOString(), String(this.ttl));
+        if (result === null || result === undefined)
+            return blob;
+        const actual = typeof result === "string" && result !== "missing" ? Number(result) : undefined;
+        throw new errors_js_1.SessionConflictError(session.id, expectedVersion, actual);
+    }
+    key(id) {
+        return `${this.keyPrefix}session:${id}`;
+    }
+}
+exports.RedisStore = RedisStore;
+//# sourceMappingURL=RedisStore.js.map

package/dist/cjs/persistence/RedisStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisStore.js","sourceRoot":"","sources":["../../../src/persistence/RedisStore.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,kDAA0D;AAE1D,mDAAmD;AAiBnD;;;;GAIG;AACH,MAAM,UAAU,GAAG;;;;;;;;;;;CAWlB,CAAC;AAEF,MAAa,UAAU;IAKrB,YAAY,OAA0B;QACpC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,QAAQ,CAAC;QAC/C,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAU;QACnB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACnD,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC/C,OAAO,IAAA,wBAAQ,EAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAmB,EAAE,eAAuB;QACrD,MAAM,IAAI,GAAG,eAAe,GAAG,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,IAAA,sBAAM,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAClC,UAAU,EACV,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EACpB,MAAM,CAAC,eAAe,CAAC,EACvB,MAAM,CAAC,IAAI,CAAC,EACZ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EACpB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EACxB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CACjB,CAAC;QACF,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACzD,MAAM,MAAM,GAAG,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/F,MAAM,IAAI,gCAAoB,CAAC,OAAO,CAAC,EAAE,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;IAEO,GAAG,CAAC,EAAU;QACpB,OAAO,GAAG,IAAI,CAAC,SAAS,WAAW,EAAE,EAAE,CAAC;IAC1C,CAAC;CACF;AA1CD,gCA0CC"}

package/dist/cjs/persistence/SQLiteStore.d.ts

@@ -0,0 +1,45 @@
+/**
+ * SQLite Store over a better-sqlite3-shaped database (bun:sqlite fits too).
+ *
+ * One row per session: `id`, `version`, `blob` (the v4 session as JSON text),
+ * `created_at`, `updated_at`. The compare-and-swap is the statement itself:
+ * `INSERT OR IGNORE` for a first save, `UPDATE … WHERE version = ?` after,
+ * and `changes === 0` means someone else got there first.
+ *
+ * A 3.x `agent_sessions` table has different columns. Point `tables.sessions`
+ * at a fresh table; 3.x blobs move through `migrateSession` at the host's
+ * choke point, not through this table.
+ */
+import type { Session, Store } from "../types/session.js";
+/** Matches better-sqlite3 and bun:sqlite statements. */
+export interface SqliteStatement {
+    run(...params: unknown[]): {
+        changes: number;
+    };
+    get(...params: unknown[]): unknown;
+}
+/** Matches better-sqlite3 and bun:sqlite databases. */
+export interface SqliteDatabase {
+    prepare(sql: string): SqliteStatement;
+    exec(sql: string): unknown;
+    close(): void;
+}
+export interface SQLiteStoreOptions {
+    db: SqliteDatabase;
+    /** Table name. Default `agent_sessions`. */
+    tables?: {
+        sessions?: string;
+    };
+}
+export declare class SQLiteStore<D = unknown> implements Store<D> {
+    private readonly db;
+    private readonly table;
+    constructor(options: SQLiteStoreOptions);
+    /** Create the table when it is missing. */
+    initialize(): Promise<void>;
+    disconnect(): Promise<void>;
+    load(id: string): Promise<Session<D> | null>;
+    save(session: Session<D>, expectedVersion: number): Promise<Session<D>>;
+    private storedVersion;
+}
+//# sourceMappingURL=SQLiteStore.d.ts.map

package/dist/cjs/persistence/SQLiteStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SQLiteStore.d.ts","sourceRoot":"","sources":["../../../src/persistence/SQLiteStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG1D,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;CACpC;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;IACtC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,cAAc,CAAC;IACnB,4CAA4C;IAC5C,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AAED,qBAAa,WAAW,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAiB;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,EAAE,kBAAkB;IAKvC,2CAA2C;IAC3C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAQ5C,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAqBvE,OAAO,CAAC,aAAa;CAKtB"}

package/dist/cjs/persistence/SQLiteStore.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * SQLite Store over a better-sqlite3-shaped database (bun:sqlite fits too).
+ *
+ * One row per session: `id`, `version`, `blob` (the v4 session as JSON text),
+ * `created_at`, `updated_at`. The compare-and-swap is the statement itself:
+ * `INSERT OR IGNORE` for a first save, `UPDATE … WHERE version = ?` after,
+ * and `changes === 0` means someone else got there first.
+ *
+ * A 3.x `agent_sessions` table has different columns. Point `tables.sessions`
+ * at a fresh table; 3.x blobs move through `migrateSession` at the host's
+ * choke point, not through this table.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SQLiteStore = void 0;
+const errors_js_1 = require("../types/errors.js");
+const sessionRow_js_1 = require("./sessionRow.js");
+class SQLiteStore {
+    constructor(options) {
+        this.db = options.db;
+        this.table = options.tables?.sessions ?? "agent_sessions";
+    }
+    /** Create the table when it is missing. */
+    initialize() {
+        return (0, sessionRow_js_1.asPromise)(() => {
+            this.db.exec(`CREATE TABLE IF NOT EXISTS ${this.table} (
+          id TEXT PRIMARY KEY,
+          version INTEGER NOT NULL,
+          blob TEXT NOT NULL,
+          created_at TEXT NOT NULL,
+          updated_at TEXT NOT NULL
+        )`);
+        });
+    }
+    disconnect() {
+        return (0, sessionRow_js_1.asPromise)(() => this.db.close());
+    }
+    load(id) {
+        return (0, sessionRow_js_1.asPromise)(() => {
+            const row = this.db.prepare(`SELECT blob FROM ${this.table} WHERE id = ?`).get(id);
+            if (row === undefined || row === null)
+                return null;
+            return (0, sessionRow_js_1.readBlob)(column(row, "blob"), id);
+        });
+    }
+    save(session, expectedVersion) {
+        return (0, sessionRow_js_1.asPromise)(() => {
+            const next = expectedVersion + 1;
+            const blob = (0, sessionRow_js_1.toBlob)(session, next);
+            const json = JSON.stringify(blob);
+            const now = new Date().toISOString();
+            const result = expectedVersion === 0
+                ? this.db
+                    .prepare(`INSERT OR IGNORE INTO ${this.table} (id, version, blob, created_at, updated_at) VALUES (?, ?, ?, ?, ?)`)
+                    .run(session.id, next, json, now, now)
+                : this.db
+                    .prepare(`UPDATE ${this.table} SET version = ?, blob = ?, updated_at = ? WHERE id = ? AND version = ?`)
+                    .run(next, json, now, session.id, expectedVersion);
+            if (result.changes === 0)
+                throw new errors_js_1.SessionConflictError(session.id, expectedVersion, this.storedVersion(session.id));
+            return blob;
+        });
+    }
+    storedVersion(id) {
+        const row = this.db.prepare(`SELECT version FROM ${this.table} WHERE id = ?`).get(id);
+        const version = row === undefined || row === null ? undefined : column(row, "version");
+        return typeof version === "number" ? version : undefined;
+    }
+}
+exports.SQLiteStore = SQLiteStore;
+function column(row, name) {
+    return typeof row === "object" && row !== null && name in row ? row[name] : undefined;
+}
+//# sourceMappingURL=SQLiteStore.js.map