agent-conveyor 0.1.0

package/dist/runtime/visual-diff.js

@@ -0,0 +1,234 @@
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { deflateSync, inflateSync } from "node:zlib";
+export class VisualDiffError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "VisualDiffError";
+    }
+}
+export function computeVisualDiffSync(options) {
+    if (!Number.isFinite(options.threshold) || options.threshold < 0 || options.threshold > 1) {
+        throw new VisualDiffError("--threshold must be between 0 and 1");
+    }
+    const reference = readPngRgba(options.referencePath);
+    const candidate = readPngRgba(options.candidatePath);
+    if (reference.width !== candidate.width || reference.height !== candidate.height) {
+        throw new VisualDiffError(`visual diff screenshots must have matching dimensions: reference=${reference.width}x${reference.height} candidate=${candidate.width}x${candidate.height}`);
+    }
+    const diffPixels = [];
+    let changedPixels = 0;
+    for (let index = 0; index < reference.pixels.length; index += 1) {
+        const referencePixel = reference.pixels[index];
+        const candidatePixel = candidate.pixels[index];
+        if (!referencePixel || !candidatePixel) {
+            throw new VisualDiffError("visual diff pixel buffers are inconsistent");
+        }
+        if (pixelsEqual(referencePixel, candidatePixel)) {
+            diffPixels.push([0, 0, 0, 0]);
+        }
+        else {
+            changedPixels += 1;
+            diffPixels.push([255, 0, 0, 255]);
+        }
+    }
+    const totalPixels = reference.width * reference.height;
+    const diffScore = totalPixels === 0 ? 0 : changedPixels / totalPixels;
+    if (options.diffOutput) {
+        writePngRgba(options.diffOutput, reference.width, reference.height, diffPixels);
+    }
+    const report = {
+        below_threshold: diffScore <= options.threshold,
+        candidate: options.candidatePath,
+        changed_pixels: changedPixels,
+        diff_image: options.diffOutput ?? null,
+        diff_score: diffScore,
+        reference: options.referencePath,
+        threshold: options.threshold,
+        total_pixels: totalPixels,
+        viewport: `${reference.width}x${reference.height}`,
+    };
+    if (options.reportOutput) {
+        mkdirSync(dirname(options.reportOutput), { recursive: true });
+        writeFileSync(options.reportOutput, `${JSON.stringify(sortJson(report), null, 2)}\n`);
+    }
+    return report;
+}
+function readPngRgba(path) {
+    let data;
+    try {
+        data = readFileSync(path);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new VisualDiffError(`unable to read visual diff PNG ${path}: ${message}`);
+    }
+    if (!data.subarray(0, 8).equals(Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]))) {
+        throw new VisualDiffError(`unsupported image format for visual diff: ${path} is not a PNG`);
+    }
+    let offset = 8;
+    let width = null;
+    let height = null;
+    let bitDepth = null;
+    let colorType = null;
+    const compressed = [];
+    while (offset < data.length) {
+        if (offset + 8 > data.length) {
+            throw new VisualDiffError(`invalid PNG: truncated chunk header in ${path}`);
+        }
+        const length = data.readUInt32BE(offset);
+        const kind = data.subarray(offset + 4, offset + 8).toString("ascii");
+        const payloadStart = offset + 8;
+        const payloadEnd = payloadStart + length;
+        if (payloadEnd + 4 > data.length) {
+            throw new VisualDiffError(`invalid PNG: truncated ${kind} chunk in ${path}`);
+        }
+        const payload = data.subarray(payloadStart, payloadEnd);
+        offset = payloadEnd + 4;
+        if (kind === "IHDR") {
+            width = payload.readUInt32BE(0);
+            height = payload.readUInt32BE(4);
+            bitDepth = payload.readUInt8(8);
+            colorType = payload.readUInt8(9);
+            const compression = payload.readUInt8(10);
+            const filterMethod = payload.readUInt8(11);
+            const interlace = payload.readUInt8(12);
+            if (bitDepth !== 8 || !new Set([2, 6]).has(colorType) || compression !== 0 || filterMethod !== 0 || interlace !== 0) {
+                throw new VisualDiffError("visual diff supports non-interlaced 8-bit RGB/RGBA PNG screenshots");
+            }
+        }
+        else if (kind === "IDAT") {
+            compressed.push(payload);
+        }
+        else if (kind === "IEND") {
+            break;
+        }
+    }
+    if (width === null || height === null || bitDepth === null || colorType === null) {
+        throw new VisualDiffError(`invalid PNG: missing IHDR in ${path}`);
+    }
+    if (width < 1 || height < 1) {
+        throw new VisualDiffError(`invalid PNG dimensions in ${path}: width and height must be positive`);
+    }
+    const channels = colorType === 6 ? 4 : 3;
+    const stride = width * channels;
+    let raw;
+    try {
+        raw = inflateSync(Buffer.concat(compressed));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new VisualDiffError(`invalid PNG compression in ${path}: ${message}`);
+    }
+    const expected = (stride + 1) * height;
+    if (raw.length !== expected) {
+        throw new VisualDiffError(`invalid PNG scanline length in ${path}`);
+    }
+    const rows = [];
+    let position = 0;
+    let previous = Buffer.alloc(stride);
+    for (let y = 0; y < height; y += 1) {
+        const filterType = raw.readUInt8(position);
+        position += 1;
+        const scanline = Buffer.from(raw.subarray(position, position + stride));
+        position += stride;
+        for (let index = 0; index < scanline.length; index += 1) {
+            const left = index >= channels ? scanline[index - channels] ?? 0 : 0;
+            const up = previous[index] ?? 0;
+            const upperLeft = index >= channels ? previous[index - channels] ?? 0 : 0;
+            let reconstructed;
+            if (filterType === 0) {
+                reconstructed = scanline[index] ?? 0;
+            }
+            else if (filterType === 1) {
+                reconstructed = (scanline[index] ?? 0) + left;
+            }
+            else if (filterType === 2) {
+                reconstructed = (scanline[index] ?? 0) + up;
+            }
+            else if (filterType === 3) {
+                reconstructed = (scanline[index] ?? 0) + Math.floor((left + up) / 2);
+            }
+            else if (filterType === 4) {
+                reconstructed = (scanline[index] ?? 0) + paeth(left, up, upperLeft);
+            }
+            else {
+                throw new VisualDiffError(`unsupported PNG filter type ${filterType} in ${path}`);
+            }
+            scanline[index] = reconstructed & 0xff;
+        }
+        previous = Buffer.from(scanline);
+        rows.push(previous);
+    }
+    const pixels = [];
+    for (const row of rows) {
+        for (let index = 0; index < row.length; index += channels) {
+            pixels.push([
+                row[index] ?? 0,
+                row[index + 1] ?? 0,
+                row[index + 2] ?? 0,
+                channels === 4 ? row[index + 3] ?? 0 : 255,
+            ]);
+        }
+    }
+    return { height, pixels, width };
+}
+export function writePngRgba(path, width, height, pixels) {
+    const rawRows = [];
+    for (let y = 0; y < height; y += 1) {
+        const rowPixels = pixels.slice(y * width, y * width + width);
+        rawRows.push(Buffer.concat([Buffer.from([0]), Buffer.concat(rowPixels.map((pixel) => Buffer.from(pixel)))]));
+    }
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, Buffer.concat([
+        Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]),
+        pngChunk("IHDR", Buffer.concat([uint32(width), uint32(height), Buffer.from([8, 6, 0, 0, 0])])),
+        pngChunk("IDAT", deflateSync(Buffer.concat(rawRows))),
+        pngChunk("IEND", Buffer.alloc(0)),
+    ]));
+}
+function pngChunk(kind, payload) {
+    const kindBuffer = Buffer.from(kind, "ascii");
+    const checksum = crc32(Buffer.concat([kindBuffer, payload]));
+    return Buffer.concat([uint32(payload.length), kindBuffer, payload, uint32(checksum)]);
+}
+function uint32(value) {
+    const buffer = Buffer.alloc(4);
+    buffer.writeUInt32BE(value >>> 0);
+    return buffer;
+}
+function paeth(a, b, c) {
+    const p = a + b - c;
+    const pa = Math.abs(p - a);
+    const pb = Math.abs(p - b);
+    const pc = Math.abs(p - c);
+    if (pa <= pb && pa <= pc) {
+        return a;
+    }
+    return pb <= pc ? b : c;
+}
+function pixelsEqual(left, right) {
+    return left[0] === right[0] && left[1] === right[1] && left[2] === right[2] && left[3] === right[3];
+}
+function crc32(buffer) {
+    let crc = 0xffffffff;
+    for (const byte of buffer) {
+        crc ^= byte;
+        for (let bit = 0; bit < 8; bit += 1) {
+            crc = (crc >>> 1) ^ (crc & 1 ? 0xedb88320 : 0);
+        }
+    }
+    return (crc ^ 0xffffffff) >>> 0;
+}
+function sortJson(value) {
+    if (Array.isArray(value)) {
+        return value.map(sortJson);
+    }
+    if (value !== null && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, child]) => [key, sortJson(child)]));
+    }
+    return value;
+}
+//# sourceMappingURL=visual-diff.js.map

package/dist/runtime/visual-diff.js.map

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

package/dist/state/database.d.ts

@@ -0,0 +1,21 @@
+import { DatabaseSync } from "node:sqlite";
+export interface DatabaseCheck {
+    name: string;
+    ok: boolean;
+    value?: number | string | null;
+    missing?: string[];
+    violations?: unknown[];
+}
+export interface DatabaseHealth {
+    checks: DatabaseCheck[];
+    ok: boolean;
+    schema_version: number | null;
+    user_version: number;
+}
+export declare class WorkerctlDatabaseError extends Error {
+    constructor(message: string);
+}
+export declare function openDatabaseSync(path?: string): DatabaseSync;
+export declare function configureConnectionSync(database: DatabaseSync): void;
+export declare function initializeDatabaseSync(database: DatabaseSync): void;
+export declare function databaseHealthSync(database: DatabaseSync): DatabaseHealth;

package/dist/state/database.js

@@ -0,0 +1,142 @@
+import { mkdirSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { dirname } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+import { defaultDbPath } from "./files.js";
+import { REQUIRED_INDEXES, REQUIRED_TABLES, REQUIRED_TRIGGERS, SCHEMA_VERSION, } from "./sqlite-contract.js";
+import { SCHEMA_V22_SQL } from "./schema-v22.js";
+export class WorkerctlDatabaseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "WorkerctlDatabaseError";
+    }
+}
+export function openDatabaseSync(path = defaultDbPath()) {
+    mkdirSync(dirname(path), { recursive: true });
+    const database = new DatabaseSync(path);
+    configureConnectionSync(database);
+    return database;
+}
+export function configureConnectionSync(database) {
+    database.exec("PRAGMA foreign_keys = ON");
+    database.exec("PRAGMA journal_mode = WAL");
+    database.exec("PRAGMA busy_timeout = 5000");
+    const foreignKeys = pragmaNumber(database, "foreign_keys");
+    if (foreignKeys !== 1) {
+        throw new WorkerctlDatabaseError("SQLite foreign key enforcement is not enabled");
+    }
+}
+export function initializeDatabaseSync(database) {
+    const userVersion = pragmaNumber(database, "user_version");
+    if (userVersion > SCHEMA_VERSION) {
+        throw new WorkerctlDatabaseError(`Database schema version ${userVersion} is newer than workerctl supports (${SCHEMA_VERSION})`);
+    }
+    if (userVersion === SCHEMA_VERSION) {
+        return;
+    }
+    if (userVersion !== 0 || hasUserTables(database)) {
+        delegateLegacyMigrationToPython(database, userVersion);
+        return;
+    }
+    database.exec(SCHEMA_V22_SQL);
+    const now = new Date().toISOString();
+    database.prepare("insert or ignore into schema_migrations(version, applied_at) values (?, ?)").run(SCHEMA_VERSION, now);
+    database.exec(`PRAGMA user_version = ${SCHEMA_VERSION}`);
+}
+function delegateLegacyMigrationToPython(database, userVersion) {
+    const path = databasePath(database);
+    if (!path) {
+        throw new WorkerctlDatabaseError(`Migrating existing schema version ${userVersion} requires a file-backed database`);
+    }
+    const script = `
+from pathlib import Path
+from workerctl import db
+conn = db.connect(Path(${JSON.stringify(path)}))
+try:
+    db.initialize_database(conn)
+finally:
+    conn.close()
+`;
+    const result = spawnSync("python3", ["-c", script], {
+        cwd: process.cwd(),
+        encoding: "utf8",
+    });
+    if (result.status !== 0) {
+        const detail = (result.stderr || result.stdout || "unknown migration error").trim();
+        throw new WorkerctlDatabaseError(`Python legacy migration failed: ${detail}`);
+    }
+    const migratedVersion = pragmaNumber(database, "user_version");
+    if (migratedVersion !== SCHEMA_VERSION) {
+        throw new WorkerctlDatabaseError(`Python legacy migration left schema version ${migratedVersion}; expected ${SCHEMA_VERSION}`);
+    }
+}
+export function databaseHealthSync(database) {
+    const foreignKeys = pragmaNumber(database, "foreign_keys");
+    const journalMode = pragmaValue(database, "journal_mode");
+    const busyTimeout = pragmaNumber(database, "busy_timeout");
+    const userVersion = pragmaNumber(database, "user_version");
+    const schemaVersion = database
+        .prepare("select max(version) as version from schema_migrations")
+        .get();
+    const tables = schemaNames(database, "table");
+    const indexes = schemaNames(database, "index");
+    const triggers = schemaNames(database, "trigger");
+    const violations = database.prepare(`
+    select "table", rowid, parent, fkid
+    from pragma_foreign_key_check
+  `).all();
+    const checks = [
+        { name: "foreign_keys", ok: foreignKeys === 1, value: foreignKeys },
+        { name: "journal_mode_wal", ok: String(journalMode).toLowerCase() === "wal", value: journalMode },
+        { name: "busy_timeout", ok: busyTimeout >= 5000, value: busyTimeout },
+        { name: "schema_version", ok: schemaVersion.version === SCHEMA_VERSION, value: schemaVersion.version },
+        { name: "user_version", ok: userVersion === SCHEMA_VERSION, value: userVersion },
+        { name: "required_tables", ok: isSubset(REQUIRED_TABLES, tables), missing: missing(REQUIRED_TABLES, tables) },
+        { name: "required_indexes", ok: isSubset(REQUIRED_INDEXES, indexes), missing: missing(REQUIRED_INDEXES, indexes) },
+        { name: "required_triggers", ok: isSubset(REQUIRED_TRIGGERS, triggers), missing: missing(REQUIRED_TRIGGERS, triggers) },
+        { name: "foreign_key_check", ok: violations.length === 0, violations },
+    ];
+    return {
+        checks,
+        ok: checks.every((check) => check.ok),
+        schema_version: schemaVersion.version,
+        user_version: userVersion,
+    };
+}
+function hasUserTables(database) {
+    const row = database.prepare(`
+    select count(*) as count
+    from sqlite_master
+    where type = 'table'
+      and name not like 'sqlite_%'
+  `).get();
+    return row.count > 0;
+}
+function schemaNames(database, type) {
+    const rows = database.prepare(`
+    select name
+    from sqlite_master
+    where type = ?
+      and name not like 'sqlite_%'
+  `).all(type);
+    return new Set(rows.map((row) => row.name));
+}
+function databasePath(database) {
+    const row = database.prepare("PRAGMA database_list").get();
+    return row.file || null;
+}
+function pragmaNumber(database, name) {
+    const value = pragmaValue(database, name);
+    return Number(value);
+}
+function pragmaValue(database, name) {
+    const row = database.prepare(`PRAGMA ${name}`).get();
+    return Object.values(row)[0];
+}
+function missing(required, actual) {
+    return [...required].filter((value) => !actual.has(value)).sort();
+}
+function isSubset(required, actual) {
+    return missing(required, actual).length === 0;
+}
+//# 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":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAiBjD,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAI,GAAG,aAAa,EAAE;IACrD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IACxC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAClC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAsB;IAC5D,QAAQ,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC1C,QAAQ,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC3C,QAAQ,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC3D,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,sBAAsB,CAAC,+CAA+C,CAAC,CAAC;IACpF,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAsB;IAC3D,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC3D,IAAI,WAAW,GAAG,cAAc,EAAE,CAAC;QACjC,MAAM,IAAI,sBAAsB,CAC9B,2BAA2B,WAAW,sCAAsC,cAAc,GAAG,CAC9F,CAAC;IACJ,CAAC;IACD,IAAI,WAAW,KAAK,cAAc,EAAE,CAAC;QACnC,OAAO;IACT,CAAC;IACD,IAAI,WAAW,KAAK,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjD,+BAA+B,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACvD,OAAO;IACT,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,CACd,4EAA4E,CAC7E,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,yBAAyB,cAAc,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,+BAA+B,CAAC,QAAsB,EAAE,WAAmB;IAClF,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,sBAAsB,CAC9B,qCAAqC,WAAW,kCAAkC,CACnF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG;;;yBAGQ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;;;;;CAK5C,CAAC;IACA,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE;QAClD,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,QAAQ,EAAE,MAAM;KACjB,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,yBAAyB,CAAC,CAAC,IAAI,EAAE,CAAC;QACpF,MAAM,IAAI,sBAAsB,CAAC,mCAAmC,MAAM,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,eAAe,GAAG,YAAY,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC/D,IAAI,eAAe,KAAK,cAAc,EAAE,CAAC;QACvC,MAAM,IAAI,sBAAsB,CAC9B,+CAA+C,eAAe,cAAc,cAAc,EAAE,CAC7F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAsB;IACvD,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC3D,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC3D,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC3D,MAAM,aAAa,GAAG,QAAQ;SAC3B,OAAO,CAAC,uDAAuD,CAAC;SAChE,GAAG,EAAgC,CAAC;IAEvC,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC;;;GAGnC,CAAC,CAAC,GAAG,EAAE,CAAC;IAET,MAAM,MAAM,GAAoB;QAC9B,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,WAAW,KAAK,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE;QACnE,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE;QACjG,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,WAAW,IAAI,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE;QACrE,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,aAAa,CAAC,OAAO,KAAK,cAAc,EAAE,KAAK,EAAE,aAAa,CAAC,OAAO,EAAE;QACtG,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,WAAW,KAAK,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE;QAChF,EAAE,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE;QAC7G,EAAE,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC,EAAE;QAClH,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,iBAAiB,EAAE,QAAQ,CAAC,EAAE;QACvH,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,UAAU,EAAE;KACvE,CAAC;IAEF,OAAO;QACL,MAAM;QACN,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,cAAc,EAAE,aAAa,CAAC,OAAO;QACrC,YAAY,EAAE,WAAW;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,QAAsB;IAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC;;;;;GAK5B,CAAC,CAAC,GAAG,EAAuB,CAAC;IAC9B,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,WAAW,CAAC,QAAsB,EAAE,IAAmC;IAC9E,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC;;;;;GAK7B,CAAC,CAAC,GAAG,CAAC,IAAI,CAA4B,CAAC;IACxC,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,YAAY,CAAC,QAAsB;IAC1C,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,GAAG,EAAuB,CAAC;IAChF,OAAO,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC;AAC1B,CAAC;AAED,SAAS,YAAY,CAAC,QAAsB,EAAE,IAAY;IACxD,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,WAAW,CAAC,QAAsB,EAAE,IAAY;IACvD,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,EAAqC,CAAC;IACxF,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,OAAO,CAAC,QAAqB,EAAE,MAAmB;IACzD,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACpE,CAAC;AAED,SAAS,QAAQ,CAAC,QAAqB,EAAE,MAAmB;IAC1D,OAAO,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AAChD,CAAC"}

package/dist/state/files.d.ts

@@ -0,0 +1,38 @@
+export declare class WorkerctlStateError extends Error {
+    constructor(message: string);
+}
+export declare function stateRoot(options?: {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}): string;
+export declare function validateWorkerName(name: string): void;
+export declare function workerDir(name: string, options?: {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}): string;
+export declare function configPath(name: string, options?: {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}): string;
+export declare function statusPath(name: string, options?: {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}): string;
+export declare function eventsPath(name: string, options?: {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}): string;
+export declare function transcriptPath(name: string, options?: {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}): string;
+export declare function captureMetaPath(name: string, options?: {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}): string;
+export declare function defaultDbPath(options?: {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}): string;
+export declare function loadJsonSync<T>(path: string, defaultValue: T): T;
+export declare function writeJsonSync(path: string, payload: unknown): void;

package/dist/state/files.js

@@ -0,0 +1,73 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+const STATE_ROOT_DIR = ".codex-workers";
+export class WorkerctlStateError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "WorkerctlStateError";
+    }
+}
+export function stateRoot(options = {}) {
+    const env = options.env ?? process.env;
+    if (env.WORKERCTL_STATE_ROOT) {
+        return env.WORKERCTL_STATE_ROOT;
+    }
+    return join(options.cwd ?? process.cwd(), STATE_ROOT_DIR);
+}
+export function validateWorkerName(name) {
+    if (!name || !/^[A-Za-z0-9_-]+$/.test(name)) {
+        throw new WorkerctlStateError("Worker names may contain only letters, numbers, hyphens, and underscores.");
+    }
+}
+export function workerDir(name, options = {}) {
+    validateWorkerName(name);
+    return join(stateRoot(options), name);
+}
+export function configPath(name, options = {}) {
+    return join(workerDir(name, options), "config.json");
+}
+export function statusPath(name, options = {}) {
+    return join(workerDir(name, options), "status.json");
+}
+export function eventsPath(name, options = {}) {
+    return join(workerDir(name, options), "events.jsonl");
+}
+export function transcriptPath(name, options = {}) {
+    return join(workerDir(name, options), "transcript.txt");
+}
+export function captureMetaPath(name, options = {}) {
+    return join(workerDir(name, options), "capture-meta.json");
+}
+export function defaultDbPath(options = {}) {
+    return join(stateRoot(options), "workerctl.db");
+}
+export function loadJsonSync(path, defaultValue) {
+    if (!existsSync(path)) {
+        return defaultValue;
+    }
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new WorkerctlStateError(`Invalid JSON in ${path}: ${error.message}`);
+        }
+        throw error;
+    }
+}
+export function writeJsonSync(path, payload) {
+    mkdirSync(join(path, ".."), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(sortJson(payload), null, 2)}\n`);
+}
+function sortJson(value) {
+    if (Array.isArray(value)) {
+        return value.map(sortJson);
+    }
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, child]) => [key, sortJson(child)]));
+    }
+    return value;
+}
+//# sourceMappingURL=files.js.map

package/dist/state/files.js.map

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

package/dist/state/schema-v22.d.ts

@@ -0,0 +1 @@
+export declare const SCHEMA_V22_SQL: string;