@osolmaz/pi-workflows 0.12.1 → 0.13.0

package/dist/state/database.js

@@ -0,0 +1,287 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import Database from "better-sqlite3";
+import { canonicalJson, parseJson } from "./json.js";
+import { STATE_APPLICATION_ID, STATE_APP_VERSION, STATE_SCHEMA_DIGEST, STATE_SCHEMA_NAME, STATE_SCHEMA_SQL, STATE_SCHEMA_VERSION, } from "./schema.js";
+const DATABASE_FILE = "state.sqlite";
+const BUSY_TIMEOUT_MS = 5_000;
+const JOURNAL_SIZE_LIMIT = 64 * 1024 * 1024;
+const RESET_INSTRUCTION = "Pi Workflows durable state is incompatible. Move or remove the old workflow state, then create a new state.sqlite database.";
+let expectedShape;
+export function workflowStatePath(homeDir = os.homedir()) {
+    return path.join(homeDir, ".pi", "agent", "workflows", DATABASE_FILE);
+}
+export class StateDatabase {
+    filePath;
+    mode;
+    connection;
+    constructor(options = {}) {
+        this.filePath = path.resolve(options.filePath ?? workflowStatePath(options.homeDir));
+        this.mode = options.mode ?? "read-write";
+        const existed = fs.existsSync(this.filePath);
+        if (this.mode === "read-only" && !existed) {
+            throw new Error(`Pi Workflows state database does not exist: ${this.filePath}`);
+        }
+        if (!existed && this.mode === "read-write") {
+            if (options.checkLegacyState ?? options.filePath === undefined) {
+                assertNoLegacyState(this.filePath, options.homeDir ?? os.homedir());
+            }
+            fs.mkdirSync(path.dirname(this.filePath), { recursive: true, mode: 0o700 });
+            fs.chmodSync(path.dirname(this.filePath), 0o700);
+        }
+        this.connection = new Database(this.filePath, {
+            readonly: this.mode === "read-only",
+            fileMustExist: this.mode === "read-only",
+            timeout: BUSY_TIMEOUT_MS,
+        });
+        try {
+            this.configure(existed);
+            if (this.mode === "read-write") {
+                this.prepareSchema(!existed);
+            }
+            this.verifySchema();
+            if (this.mode === "read-only") {
+                this.connection.pragma("query_only = ON");
+            }
+            else {
+                fs.chmodSync(this.filePath, 0o600);
+            }
+        }
+        catch (error) {
+            this.connection.close();
+            throw error;
+        }
+    }
+    close() {
+        this.connection.close();
+    }
+    transaction(operation) {
+        if (this.mode === "read-only") {
+            throw new Error("Cannot mutate a read-only Pi Workflows database");
+        }
+        this.connection.exec("BEGIN IMMEDIATE");
+        try {
+            const result = operation();
+            this.connection.exec("COMMIT");
+            return result;
+        }
+        catch (error) {
+            if (this.connection.inTransaction) {
+                this.connection.exec("ROLLBACK");
+            }
+            throw error;
+        }
+    }
+    putJson(value, now = Date.now()) {
+        return this.putBlob(Buffer.from(canonicalJson(value), "utf8"), "application/json", now);
+    }
+    putText(value, now = Date.now()) {
+        return this.putBlob(Buffer.from(value, "utf8"), "text/plain", now);
+    }
+    putBlob(content, mediaType, now = Date.now()) {
+        if (this.mode === "read-only") {
+            throw new Error("Cannot write a blob through a read-only Pi Workflows database");
+        }
+        const hash = createHash("sha256").update(content).digest();
+        this.connection
+            .prepare(`INSERT INTO blobs(blob_hash, media_type, byte_length, content, created_at)
+         VALUES (?, ?, ?, ?, ?)
+         ON CONFLICT(blob_hash) DO NOTHING`)
+            .run(hash, mediaType, content.byteLength, content, now);
+        const stored = this.readBlob(hash);
+        if (stored === undefined ||
+            stored.mediaType !== mediaType ||
+            stored.byteLength !== content.byteLength ||
+            !stored.content.equals(content)) {
+            throw new Error("Content-addressed blob conflict");
+        }
+        return hash;
+    }
+    readBlob(hash) {
+        const row = this.connection
+            .prepare(`SELECT blob_hash AS blobHash, media_type AS mediaType,
+                byte_length AS byteLength, content
+         FROM blobs WHERE blob_hash = ?`)
+            .get(hash);
+        if (!isBlobRow(row)) {
+            return undefined;
+        }
+        return {
+            hash: row.blobHash,
+            mediaType: row.mediaType,
+            byteLength: row.byteLength,
+            content: row.content,
+        };
+    }
+    readJson(hash) {
+        const blob = this.readBlob(hash);
+        if (blob === undefined || blob.mediaType !== "application/json") {
+            throw new Error("JSON blob is missing or has the wrong media type");
+        }
+        return parseJson(blob.content.toString("utf8"));
+    }
+    integrityCheck() {
+        const result = this.connection.pragma("integrity_check", { simple: true });
+        if (result !== "ok") {
+            throw new Error(`Pi Workflows SQLite integrity check failed: ${String(result)}`);
+        }
+        const foreignKeys = this.connection.pragma("foreign_key_check");
+        if (!Array.isArray(foreignKeys) || foreignKeys.length !== 0) {
+            throw new Error("Pi Workflows SQLite foreign-key check failed");
+        }
+    }
+    async backup(destination) {
+        if (path.resolve(destination) === this.filePath) {
+            throw new Error("Backup destination must differ from the live database");
+        }
+        fs.mkdirSync(path.dirname(path.resolve(destination)), { recursive: true, mode: 0o700 });
+        this.integrityCheck();
+        await this.connection.backup(destination);
+        fs.chmodSync(destination, 0o600);
+        const backup = new StateDatabase({ filePath: destination, mode: "read-only" });
+        try {
+            backup.integrityCheck();
+        }
+        finally {
+            backup.close();
+        }
+    }
+    configure(existed) {
+        this.connection.pragma("foreign_keys = ON");
+        this.connection.pragma(`busy_timeout = ${BUSY_TIMEOUT_MS}`);
+        if (this.mode === "read-write") {
+            this.connection.pragma("journal_mode = WAL");
+            this.connection.pragma("synchronous = FULL");
+            this.connection.pragma("wal_autocheckpoint = 1000");
+            this.connection.pragma(`journal_size_limit = ${JOURNAL_SIZE_LIMIT}`);
+        }
+        else if (existed) {
+            this.connection.pragma("synchronous = FULL");
+        }
+    }
+    prepareSchema(allowInitialize) {
+        this.connection.exec("BEGIN EXCLUSIVE");
+        try {
+            const schema = this.connection
+                .prepare("SELECT 1 AS present FROM sqlite_master WHERE type = 'table' AND name = 'schema_meta'")
+                .get();
+            if (schema === undefined) {
+                if (!allowInitialize)
+                    throw new Error(RESET_INSTRUCTION);
+                this.initialize();
+            }
+            this.connection.exec("COMMIT");
+        }
+        catch (error) {
+            if (this.connection.inTransaction)
+                this.connection.exec("ROLLBACK");
+            throw error;
+        }
+    }
+    initialize() {
+        this.connection.exec(STATE_SCHEMA_SQL);
+        this.connection.pragma(`application_id = ${STATE_APPLICATION_ID}`);
+        this.connection.pragma(`user_version = ${STATE_SCHEMA_VERSION}`);
+        const now = Date.now();
+        this.connection
+            .prepare(`INSERT INTO schema_meta(
+           id, schema_name, schema_version, schema_digest, app_version, created_at, updated_at
+         ) VALUES (1, ?, ?, ?, ?, ?, ?)`)
+            .run(STATE_SCHEMA_NAME, STATE_SCHEMA_VERSION, STATE_SCHEMA_DIGEST, STATE_APP_VERSION, now, now);
+    }
+    verifySchema() {
+        const applicationId = this.connection.pragma("application_id", { simple: true });
+        const userVersion = this.connection.pragma("user_version", { simple: true });
+        if (applicationId !== STATE_APPLICATION_ID || userVersion !== STATE_SCHEMA_VERSION) {
+            throw new Error(RESET_INSTRUCTION);
+        }
+        const row = this.connection
+            .prepare(`SELECT schema_name AS schemaName, schema_version AS schemaVersion,
+                schema_digest AS schemaDigest, app_version AS appVersion
+         FROM schema_meta WHERE id = 1`)
+            .get();
+        if (!isSchemaMetaRow(row) ||
+            row.schemaName !== STATE_SCHEMA_NAME ||
+            row.schemaVersion !== STATE_SCHEMA_VERSION ||
+            !row.schemaDigest.equals(STATE_SCHEMA_DIGEST) ||
+            row.appVersion !== STATE_APP_VERSION) {
+            throw new Error(RESET_INSTRUCTION);
+        }
+        if (schemaShape(this.connection) !== expectedSchemaShape()) {
+            throw new Error(RESET_INSTRUCTION);
+        }
+    }
+}
+function expectedSchemaShape() {
+    if (expectedShape !== undefined) {
+        return expectedShape;
+    }
+    const database = new Database(":memory:");
+    try {
+        database.pragma("foreign_keys = ON");
+        database.exec(STATE_SCHEMA_SQL);
+        expectedShape = schemaShape(database);
+        return expectedShape;
+    }
+    finally {
+        database.close();
+    }
+}
+function schemaShape(database) {
+    const rows = database
+        .prepare(`SELECT type, name, tbl_name AS tableName, sql
+       FROM sqlite_schema
+       WHERE name NOT LIKE 'sqlite_%'
+       ORDER BY type, name`)
+        .all();
+    const normalized = [];
+    for (const row of rows) {
+        if (!isSchemaObjectRow(row)) {
+            throw new Error("Pi Workflows database contains an invalid schema object");
+        }
+        normalized.push(row);
+    }
+    return createHash("sha256").update(canonicalJson(normalized)).digest("hex");
+}
+function assertNoLegacyState(databasePath, homeDir) {
+    const root = path.dirname(databasePath);
+    const legacy = [
+        path.join(root, "runs"),
+        path.join(root, "decisions"),
+        path.join(root, "controllers"),
+    ];
+    const telegramState = path.join(homeDir, ".config", "pi-workflows", "telegram-state.sqlite");
+    if (legacy.some((candidate) => fs.existsSync(candidate)) || fs.existsSync(telegramState)) {
+        throw new Error(RESET_INSTRUCTION);
+    }
+}
+function isSchemaObjectRow(value) {
+    if (!isRecord(value))
+        return false;
+    return (typeof value.type === "string" &&
+        typeof value.name === "string" &&
+        typeof value.tableName === "string" &&
+        typeof value.sql === "string");
+}
+function isSchemaMetaRow(value) {
+    if (!isRecord(value))
+        return false;
+    return (typeof value.schemaName === "string" &&
+        typeof value.schemaVersion === "number" &&
+        Buffer.isBuffer(value.schemaDigest) &&
+        typeof value.appVersion === "string");
+}
+function isBlobRow(value) {
+    if (!isRecord(value))
+        return false;
+    return (Buffer.isBuffer(value.blobHash) &&
+        typeof value.mediaType === "string" &&
+        typeof value.byteLength === "number" &&
+        Buffer.isBuffer(value.content));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=database.js.map

package/dist/state/database.js.map

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

package/dist/state/index.d.ts

@@ -0,0 +1,4 @@
+export { StateDatabase, workflowStatePath, type BlobRecord, type OpenStateDatabaseOptions, type StateDatabaseMode, } from "./database.js";
+export { canonicalJson, parseJson, type JsonPrimitive, type JsonValue } from "./json.js";
+export { StateMutationStore, StaleResourceError, resourceIdFor, tokenHash, type ActorType, type LeaseClaim, type MutationActor, type MutationResult, type OwnerType, type ResourceType, type WritePermit, } from "./mutation.js";
+export { STATE_APPLICATION_ID, STATE_APP_VERSION, STATE_SCHEMA_DIGEST, STATE_SCHEMA_NAME, STATE_SCHEMA_SQL, STATE_SCHEMA_VERSION, } from "./schema.js";

package/dist/state/index.js

@@ -0,0 +1,5 @@
+export { StateDatabase, workflowStatePath, } from "./database.js";
+export { canonicalJson, parseJson } from "./json.js";
+export { StateMutationStore, StaleResourceError, resourceIdFor, tokenHash, } from "./mutation.js";
+export { STATE_APPLICATION_ID, STATE_APP_VERSION, STATE_SCHEMA_DIGEST, STATE_SCHEMA_NAME, STATE_SCHEMA_SQL, STATE_SCHEMA_VERSION, } from "./schema.js";
+//# sourceMappingURL=index.js.map

package/dist/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,iBAAiB,GAIlB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAsC,MAAM,WAAW,CAAC;AACzF,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,SAAS,GAQV,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAC"}

package/dist/state/json.d.ts

@@ -0,0 +1,6 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export declare function canonicalJson(value: unknown): string;
+export declare function parseJson(text: string): JsonValue;

package/dist/state/json.js

@@ -0,0 +1,38 @@
+export function canonicalJson(value) {
+    return JSON.stringify(normalizeJson(value));
+}
+export function parseJson(text) {
+    return normalizeJson(JSON.parse(text));
+}
+function normalizeJson(value) {
+    if (value === null || typeof value === "string" || typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new Error("JSON numbers must be finite");
+        }
+        return Object.is(value, -0) ? 0 : value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => normalizeJson(item));
+    }
+    if (typeof value === "object") {
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null) {
+            throw new Error("Only plain objects can be stored as canonical JSON");
+        }
+        const input = value;
+        const output = {};
+        for (const key of Object.keys(input).sort()) {
+            const item = input[key];
+            if (item === undefined) {
+                continue;
+            }
+            output[key] = normalizeJson(item);
+        }
+        return output;
+    }
+    throw new Error(`Unsupported JSON value type: ${typeof value}`);
+}
+//# sourceMappingURL=json.js.map

package/dist/state/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/state/json.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC1C,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAkB,CAAC;QAChE,IAAI,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,KAAK,GAAG,KAAgC,CAAC;QAC/C,MAAM,MAAM,GAAiC,EAAE,CAAC;QAChD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,SAAS;YACX,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,gCAAgC,OAAO,KAAK,EAAE,CAAC,CAAC;AAClE,CAAC"}

package/dist/state/mutation.d.ts

@@ -0,0 +1,57 @@
+import { StateDatabase } from "./database.js";
+export type ResourceType = "run" | "session" | "decision" | "controller" | "effect" | "channel" | "notification" | "turn_intent";
+export type ActorType = "session" | "host" | "controller" | "channel" | "human" | "policy" | "control" | "system";
+export type OwnerType = "session" | "host" | "controller" | "channel" | "system";
+export type MutationActor = {
+    type: ActorType;
+    id?: string;
+};
+export type LeaseClaim = {
+    resourceId: string;
+    ownerType: OwnerType;
+    ownerId: string;
+    token: string;
+    generation: number;
+    expiresAt: number;
+    resourceRevision: number;
+};
+export type WritePermit = {
+    resourceId: string;
+    operation: string;
+    actor: MutationActor;
+    expectedRevision: number;
+    lease?: LeaseClaim;
+};
+export type MutationResult<T> = {
+    value: T;
+    revision: number;
+    eventId: string;
+};
+export declare class StaleResourceError extends Error {
+    constructor(message: string);
+}
+export declare class StateMutationStore {
+    readonly state: StateDatabase;
+    constructor(state: StateDatabase);
+    ensureResource(type: ResourceType, aggregateKey: string, now?: number): string;
+    claim(options: {
+        resourceId: string;
+        ownerType: OwnerType;
+        ownerId: string;
+        expectedRevision: number;
+        leaseMs: number;
+        now?: number;
+    }): LeaseClaim | undefined;
+    renew(claim: LeaseClaim, expectedRevision: number, leaseMs: number, now?: number): LeaseClaim;
+    release(claim: LeaseClaim, expectedRevision: number, now?: number): number;
+    mutate<T>(permit: WritePermit, eventType: string, apply: (context: {
+        database: StateDatabase;
+        nextRevision: number;
+        now: number;
+    }) => T, options?: {
+        payload?: unknown;
+        now?: number;
+    }): MutationResult<T>;
+}
+export declare function resourceIdFor(type: ResourceType, aggregateKey: string): string;
+export declare function tokenHash(token: string): Buffer;