@osolmaz/pi-workflows 0.14.0 → 0.15.1

package/dist/host/client.js.map

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

package/dist/host/controller-worker-entry.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare function runControllerWorker(): Promise<number>;

package/dist/host/controller-worker-entry.js

@@ -0,0 +1,244 @@
+#!/usr/bin/env node
+import { randomUUID } from "node:crypto";
+import { once } from "node:events";
+import { fileURLToPath } from "node:url";
+import { jsonFingerprint } from "../controllers/json.js";
+import { loadControllerFile } from "../controllers/loader.js";
+import { createResultHelpers } from "../controllers/results.js";
+import { parseJson } from "../state/json.js";
+import { errorMessage } from "../workflows/errors.js";
+import { CONTROLLER_WORKER_LAUNCH_SCHEMA, encodeControllerWorkerLine, parseControllerWorkerResponse, } from "./controller-worker-protocol.js";
+const STARTUP_ENV = "PI_WORKFLOWS_CONTROLLER_WORKER_LAUNCH";
+const MAX_FRAME_BYTES = 1024 * 1024;
+class ControllerWorkerTransport {
+    launch;
+    pending = new Map();
+    buffered = Buffer.alloc(0);
+    constructor(launch) {
+        this.launch = launch;
+        process.stdin.on("data", (chunk) => this.onData(chunk));
+        process.stdin.on("error", (error) => this.failAll(error));
+        process.stdin.resume();
+    }
+    async request(operation, payload) {
+        const message = {
+            schema: "pi-workflows.controller-worker-message.v1",
+            launchSchema: this.launch.schema,
+            messageId: randomUUID(),
+            workerEpoch: this.launch.workerEpoch,
+            generation: this.launch.generation,
+            operation,
+            payload,
+        };
+        const response = await this.send(message);
+        if (response.outcome !== "accepted") {
+            throw new Error(response.error ?? `Controller worker ${response.outcome}`);
+        }
+        return response.result;
+    }
+    close() {
+        process.stdin.pause();
+        process.stdin.removeAllListeners("data");
+        process.stdin.removeAllListeners("error");
+        this.failAll(new Error("Controller worker transport closed"));
+    }
+    async send(message) {
+        const response = new Promise((resolve, reject) => {
+            this.pending.set(message.messageId, { resolve, reject });
+        });
+        if (!process.stdout.write(encodeControllerWorkerLine(message))) {
+            await once(process.stdout, "drain");
+        }
+        return await response;
+    }
+    onData(chunk) {
+        this.buffered = Buffer.concat([this.buffered, chunk]);
+        if (this.buffered.byteLength > MAX_FRAME_BYTES && !this.buffered.includes(0x0a)) {
+            this.failAll(new Error("Controller worker response exceeds 1 MiB"));
+            return;
+        }
+        for (;;) {
+            const newline = this.buffered.indexOf(0x0a);
+            if (newline < 0)
+                return;
+            const frame = this.buffered.subarray(0, newline);
+            this.buffered = this.buffered.subarray(newline + 1);
+            if (frame.byteLength === 0)
+                continue;
+            try {
+                const response = parseControllerWorkerResponse(frame);
+                const pending = this.pending.get(response.messageId);
+                if (pending === undefined)
+                    throw new Error("Controller worker response is unexpected");
+                this.pending.delete(response.messageId);
+                pending.resolve(response);
+            }
+            catch (error) {
+                this.failAll(error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+    }
+    failAll(error) {
+        for (const pending of this.pending.values())
+            pending.reject(error);
+        this.pending.clear();
+    }
+}
+class HostedControllerEffects {
+    transport;
+    signal;
+    used = false;
+    constructor(transport, signal) {
+        this.transport = transport;
+        this.signal = signal;
+    }
+    async ensure(definition) {
+        if (this.used)
+            throw new Error("A reconciliation pass may ensure only one external effect");
+        this.used = true;
+        const reservation = await this.transport.request("effect.reserve", {
+            key: definition.key,
+            kind: definition.kind,
+            requestFingerprint: jsonFingerprint(definition.request),
+        });
+        if (["applied", "rejected", "indeterminate"].includes(reservation.record.state)) {
+            return reservation.record;
+        }
+        if (!reservation.created) {
+            const observation = await definition.observe(this.signal);
+            if (observation.state !== "not_applied") {
+                return await this.settleObservation(definition.key, observation);
+            }
+        }
+        let applied;
+        try {
+            applied = await definition.apply(this.signal);
+        }
+        catch (error) {
+            applied = { state: "indeterminate", error: boundedError(error) };
+        }
+        return await this.transport.request("effect.settle", {
+            key: definition.key,
+            state: applied.state,
+            ...(applied.state === "applied" && applied.externalRef !== undefined
+                ? { externalRef: applied.externalRef }
+                : {}),
+            ...(applied.state !== "applied" && applied.error !== undefined
+                ? { error: applied.error }
+                : {}),
+        });
+    }
+    async settleObservation(key, observation) {
+        return await this.transport.request("effect.settle", {
+            key,
+            state: observation.state === "applied" ? "applied" : "indeterminate",
+            ...(observation.state === "applied" && observation.externalRef !== undefined
+                ? { externalRef: observation.externalRef }
+                : {}),
+        });
+    }
+}
+class HostedControllerWorkflows {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    async ensure(request) {
+        return await this.transport.request("workflow.ensure", request);
+    }
+    async changeSettings(request) {
+        return await this.transport.request("workflow.changeSettings", request);
+    }
+    async queueFollowUp(request) {
+        return await this.transport.request("workflow.queueFollowUp", request);
+    }
+    async removeFollowUp(request) {
+        return await this.transport.request("workflow.removeFollowUp", request);
+    }
+}
+export async function runControllerWorker() {
+    const launch = readLaunchEnvelope();
+    const transport = new ControllerWorkerTransport(launch);
+    try {
+        const definition = await loadControllerFile(launch.definitionPath);
+        if (definition.name !== launch.controllerName) {
+            throw new Error(`Controller source name changed: expected ${launch.controllerName}, got ${definition.name}`);
+        }
+        await transport.request("worker.ready", {});
+        const abort = new AbortController();
+        const timeoutMs = definition.timeoutMs ?? launch.timeoutMs;
+        const timer = setTimeout(() => abort.abort(new Error(`Reconciliation timed out after ${timeoutMs}ms`)), timeoutMs);
+        try {
+            const context = {
+                signal: abort.signal,
+                effects: new HostedControllerEffects(transport, abort.signal),
+                workflows: new HostedControllerWorkflows(transport),
+                ...createResultHelpers(),
+            };
+            const result = await raceWithAbort(Promise.resolve(definition.reconcile(context, launch.resource)), abort.signal);
+            validateResult(result);
+            await transport.request("worker.finished", result);
+        }
+        catch (error) {
+            await transport.request("worker.failed", { error: boundedError(error) });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        return 0;
+    }
+    finally {
+        transport.close();
+    }
+}
+function readLaunchEnvelope() {
+    const encoded = process.env[STARTUP_ENV];
+    if (encoded === undefined)
+        throw new Error("Controller worker launch envelope is missing");
+    const value = parseJson(Buffer.from(encoded, "base64url").toString("utf8"));
+    if (typeof value !== "object" ||
+        value === null ||
+        Array.isArray(value) ||
+        value.schema !== CONTROLLER_WORKER_LAUNCH_SCHEMA) {
+        throw new Error("Controller worker launch envelope is invalid");
+    }
+    return value;
+}
+function validateResult(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new Error("Controller reconcile result must be an object");
+    }
+    const result = value;
+    if (result.kind !== "settled" && result.kind !== "requeue") {
+        throw new Error("Controller reconcile result kind is invalid");
+    }
+    if (result.afterMs !== undefined &&
+        (!Number.isSafeInteger(result.afterMs) || result.afterMs < 0)) {
+        throw new Error("Controller reconcile afterMs must be a non-negative safe integer");
+    }
+}
+function raceWithAbort(operation, signal) {
+    return new Promise((resolve, reject) => {
+        const onAbort = () => reject(signal.reason ?? new Error("Reconciliation aborted"));
+        signal.addEventListener("abort", onAbort, { once: true });
+        operation.then(resolve, reject).finally(() => signal.removeEventListener("abort", onAbort));
+        if (signal.aborted)
+            onAbort();
+    });
+}
+function boundedError(error) {
+    const message = errorMessage(error);
+    return message.length <= 8_192 ? message : `${message.slice(0, 8_192)}…`;
+}
+async function main() {
+    try {
+        process.exitCode = await runControllerWorker();
+    }
+    catch (error) {
+        process.stderr.write(`${errorMessage(error)}\n`);
+        process.exitCode = 1;
+    }
+}
+if (process.argv[1] === fileURLToPath(import.meta.url))
+    void main();
+//# sourceMappingURL=controller-worker-entry.js.map

package/dist/host/controller-worker-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-worker-entry.js","sourceRoot":"","sources":["../../src/host/controller-worker-entry.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAiBhE,OAAO,EAAE,SAAS,EAAkB,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,EAC1B,6BAA6B,GAK9B,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,GAAG,uCAAuC,CAAC;AAC5D,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpC,MAAM,yBAAyB;IAOA,MAAM;IANlB,OAAO,GAAG,IAAI,GAAG,EAG/B,CAAC;IACI,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,YAA6B,MAAsC;sBAAtC,MAAM;QACjC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1D,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,OAAO,CAAI,SAAoC,EAAE,OAAkB;QACvE,MAAM,OAAO,GAA4B;YACvC,MAAM,EAAE,2CAA2C;YACnD,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAChC,SAAS,EAAE,UAAU,EAAE;YACvB,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;YACpC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;YAClC,SAAS;YACT,OAAO;SACR,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,qBAAqB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,QAAQ,CAAC,MAAW,CAAC;IAC9B,CAAC;IAED,KAAK;QACH,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACzC,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC,CAAC;IAChE,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,OAAgC;QACjD,MAAM,QAAQ,GAAG,IAAI,OAAO,CAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACzE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,MAAM,QAAQ,CAAC;IACxB,CAAC;IAEO,MAAM,CAAC,KAAa;QAC1B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;QACtD,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,GAAG,eAAe,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAChF,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QACD,SAAS,CAAC;YACR,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,OAAO,GAAG,CAAC;gBAAE,OAAO;YACxB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACjD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YACpD,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC;gBAAE,SAAS;YACrC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,6BAA6B,CAAC,KAAK,CAAC,CAAC;gBACtD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;gBACrD,IAAI,OAAO,KAAK,SAAS;oBAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;gBACvF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;gBACxC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,OAAO,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,KAAY;QAC1B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF;AAED,MAAM,uBAAuB;IAIR,SAAS;IACT,MAAM;IAJjB,IAAI,GAAG,KAAK,CAAC;IAErB,YACmB,SAAoC,EACpC,MAAmB;yBADnB,SAAS;sBACT,MAAM;IACtB,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAW,UAAsC;QAC3D,IAAI,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC5F,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAC9C,gBAAgB,EAChB;YACE,GAAG,EAAE,UAAU,CAAC,GAAG;YACnB,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,kBAAkB,EAAE,eAAe,CAAC,UAAU,CAAC,OAAO,CAAC;SACxD,CACF,CAAC;QACF,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAChF,OAAO,WAAW,CAAC,MAAM,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1D,IAAI,WAAW,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;gBACxC,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QACD,IAAI,OAA0B,CAAC;QAC/B,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,GAAG,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACnE,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAe,eAAe,EAAE;YACjE,GAAG,EAAE,UAAU,CAAC,GAAG;YACnB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;gBAClE,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE;gBACtC,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;gBAC5D,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE;gBAC1B,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,GAAW,EACX,WAA8B;QAE9B,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAe,eAAe,EAAE;YACjE,GAAG;YACH,KAAK,EAAE,WAAW,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe;YACpE,GAAG,CAAC,WAAW,CAAC,KAAK,KAAK,SAAS,IAAI,WAAW,CAAC,WAAW,KAAK,SAAS;gBAC1E,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC,WAAW,EAAE;gBAC1C,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,yBAAyB;IACA,SAAS;IAAtC,YAA6B,SAAoC;yBAApC,SAAS;IAA8B,CAAC;IAErE,KAAK,CAAC,MAAM,CAAC,OAIZ;QACC,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CACjC,iBAAiB,EACjB,OAAoB,CACrB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,OAAwC;QAExC,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CACjC,yBAAyB,EACzB,OAA+B,CAChC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAuC;QACzD,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CACjC,wBAAwB,EACxB,OAA+B,CAChC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,OAAwC;QAExC,OAAO,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CACjC,yBAAyB,EACzB,OAA+B,CAChC,CAAC;IACJ,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,yBAAyB,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QACnE,IAAI,UAAU,CAAC,IAAI,KAAK,MAAM,CAAC,cAAc,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CACb,4CAA4C,MAAM,CAAC,cAAc,SAAS,UAAU,CAAC,IAAI,EAAE,CAC5F,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC;QAC3D,MAAM,KAAK,GAAG,UAAU,CACtB,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,kCAAkC,SAAS,IAAI,CAAC,CAAC,EAC7E,SAAS,CACV,CAAC;QACF,IAAI,CAAC;YACH,MAAM,OAAO,GAA8B;gBACzC,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,OAAO,EAAE,IAAI,uBAAuB,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC;gBAC7D,SAAS,EAAE,IAAI,yBAAyB,CAAC,SAAS,CAAC;gBACnD,GAAG,mBAAmB,EAAW;aAClC,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,aAAa,CAChC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,EAC/D,KAAK,CAAC,MAAM,CACb,CAAC;YACF,cAAc,CAAC,MAAM,CAAC,CAAC;YACvB,MAAM,SAAS,CAAC,OAAO,CAAC,iBAAiB,EAAE,MAA8B,CAAC,CAAC;QAC7E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,SAAS,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB;IACzB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC3F,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5E,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACnB,KAA8B,CAAC,MAAM,KAAK,+BAA+B,EAC1E,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,KAAkD,CAAC;AAC5D,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,MAAM,GAAG,KAA8C,CAAC;IAC9D,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,IACE,MAAM,CAAC,OAAO,KAAK,SAAS;QAC5B,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,IAAK,MAAM,CAAC,OAAkB,GAAG,CAAC,CAAC,EACzE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAI,SAAqB,EAAE,MAAmB;IAClE,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC;QACnF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAC5F,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC;AAC3E,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,OAAO,CAAC,QAAQ,GAAG,MAAM,mBAAmB,EAAE,CAAC;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC;IAAE,KAAK,IAAI,EAAE,CAAC"}

package/dist/host/controller-worker-protocol.d.ts

@@ -0,0 +1,36 @@
+import type { ControllerResource } from "../controllers/types.js";
+import { type JsonValue } from "../state/json.js";
+export declare const CONTROLLER_WORKER_LAUNCH_SCHEMA: "pi-workflows.controller-worker-launch.v1";
+export declare const CONTROLLER_WORKER_MESSAGE_SCHEMA: "pi-workflows.controller-worker-message.v1";
+export declare const CONTROLLER_WORKER_RESPONSE_SCHEMA: "pi-workflows.controller-worker-response.v1";
+export type ControllerWorkerLaunchEnvelope = {
+    schema: typeof CONTROLLER_WORKER_LAUNCH_SCHEMA;
+    workerEpoch: string;
+    hostEpoch: number;
+    generation: number;
+    projectPath: string;
+    definitionPath: string;
+    controllerName: string;
+    resource: ControllerResource;
+    timeoutMs: number;
+};
+export type ControllerWorkerOperation = "worker.ready" | "effect.reserve" | "effect.settle" | "workflow.ensure" | "workflow.changeSettings" | "workflow.queueFollowUp" | "workflow.removeFollowUp" | "worker.finished" | "worker.failed";
+export type ControllerWorkerMessage = {
+    schema: typeof CONTROLLER_WORKER_MESSAGE_SCHEMA;
+    launchSchema: typeof CONTROLLER_WORKER_LAUNCH_SCHEMA;
+    messageId: string;
+    workerEpoch: string;
+    generation: number;
+    operation: ControllerWorkerOperation;
+    payload: JsonValue;
+};
+export type ControllerWorkerResponse = {
+    schema: typeof CONTROLLER_WORKER_RESPONSE_SCHEMA;
+    messageId: string;
+    outcome: "accepted" | "rejected" | "claimLost";
+    result?: JsonValue;
+    error?: string;
+};
+export declare function encodeControllerWorkerLine(value: ControllerWorkerMessage | ControllerWorkerResponse): Buffer;
+export declare function parseControllerWorkerMessage(frame: Buffer): ControllerWorkerMessage;
+export declare function parseControllerWorkerResponse(frame: Buffer): ControllerWorkerResponse;

package/dist/host/controller-worker-protocol.js

@@ -0,0 +1,49 @@
+import { canonicalJson, parseJson } from "../state/json.js";
+export const CONTROLLER_WORKER_LAUNCH_SCHEMA = "pi-workflows.controller-worker-launch.v1";
+export const CONTROLLER_WORKER_MESSAGE_SCHEMA = "pi-workflows.controller-worker-message.v1";
+export const CONTROLLER_WORKER_RESPONSE_SCHEMA = "pi-workflows.controller-worker-response.v1";
+export function encodeControllerWorkerLine(value) {
+    return Buffer.from(`${canonicalJson(value)}\n`, "utf8");
+}
+export function parseControllerWorkerMessage(frame) {
+    const value = parseJson(frame.toString("utf8"));
+    if (!isRecord(value) || value.schema !== CONTROLLER_WORKER_MESSAGE_SCHEMA) {
+        throw new Error("Invalid controller worker message schema");
+    }
+    if (value.launchSchema !== CONTROLLER_WORKER_LAUNCH_SCHEMA ||
+        typeof value.messageId !== "string" ||
+        typeof value.workerEpoch !== "string" ||
+        !Number.isSafeInteger(value.generation) ||
+        typeof value.operation !== "string" ||
+        !OPERATIONS.has(value.operation) ||
+        !Object.hasOwn(value, "payload")) {
+        throw new Error("Invalid controller worker message");
+    }
+    return value;
+}
+export function parseControllerWorkerResponse(frame) {
+    const value = parseJson(frame.toString("utf8"));
+    if (!isRecord(value) || value.schema !== CONTROLLER_WORKER_RESPONSE_SCHEMA) {
+        throw new Error("Invalid controller worker response schema");
+    }
+    if (typeof value.messageId !== "string" ||
+        !["accepted", "rejected", "claimLost"].includes(String(value.outcome))) {
+        throw new Error("Invalid controller worker response");
+    }
+    return value;
+}
+const OPERATIONS = new Set([
+    "worker.ready",
+    "effect.reserve",
+    "effect.settle",
+    "workflow.ensure",
+    "workflow.changeSettings",
+    "workflow.queueFollowUp",
+    "workflow.removeFollowUp",
+    "worker.finished",
+    "worker.failed",
+]);
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=controller-worker-protocol.js.map

package/dist/host/controller-worker-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-worker-protocol.js","sourceRoot":"","sources":["../../src/host/controller-worker-protocol.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAkB,MAAM,kBAAkB,CAAC;AAE5E,MAAM,CAAC,MAAM,+BAA+B,GAAG,0CAAmD,CAAC;AACnG,MAAM,CAAC,MAAM,gCAAgC,GAC3C,2CAAoD,CAAC;AACvD,MAAM,CAAC,MAAM,iCAAiC,GAC5C,4CAAqD,CAAC;AA2CxD,MAAM,UAAU,0BAA0B,CACxC,KAAyD;IAEzD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,KAAa;IACxD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,gCAAgC,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,IACE,KAAK,CAAC,YAAY,KAAK,+BAA+B;QACtD,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;QACrC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC;QACvC,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,SAAsC,CAAC;QAC7D,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,EAChC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAAa;IACzD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,iCAAiC,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,IACE,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EACtE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,KAAiC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,GAAG,IAAI,GAAG,CAA4B;IACpD,cAAc;IACd,gBAAgB;IAChB,eAAe;IACf,iBAAiB;IACjB,yBAAyB;IACzB,wBAAwB;IACxB,yBAAyB;IACzB,iBAAiB;IACjB,eAAe;CAChB,CAAC,CAAC;AAEH,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/host/controller-worker-supervisor.d.ts

@@ -0,0 +1,21 @@
+import { type SupervisedWorkerResult } from "./child-worker-supervisor.js";
+import { type ControllerWorkerLaunchEnvelope, type ControllerWorkerMessage, type ControllerWorkerResponse } from "./controller-worker-protocol.js";
+import { HostProcessRegistry, type ProcessIdentity } from "./processes.js";
+import type { WorkerOutcome } from "./state.js";
+export declare class ControllerWorkerSupervisor {
+    readonly envelope: ControllerWorkerLaunchEnvelope;
+    private readonly options;
+    private readonly supervisor;
+    constructor(envelope: ControllerWorkerLaunchEnvelope, options: {
+        registry: HostProcessRegistry;
+        onMessage: (message: ControllerWorkerMessage) => Promise<ControllerWorkerResponse>;
+        env?: Record<string, string>;
+        startupTimeoutMs?: number;
+        workerEntryPath?: string;
+        onSpawn?: (identity: ProcessIdentity) => void;
+        onDiagnostic?: (message: string) => void;
+    });
+    start(): Promise<void>;
+    wait(): Promise<SupervisedWorkerResult>;
+    stop(outcome?: WorkerOutcome): Promise<void>;
+}

package/dist/host/controller-worker-supervisor.js

@@ -0,0 +1,54 @@
+import fs from "node:fs";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import { canonicalJson } from "../state/json.js";
+import { ChildWorkerSupervisor } from "./child-worker-supervisor.js";
+import { encodeControllerWorkerLine, parseControllerWorkerMessage, } from "./controller-worker-protocol.js";
+import { HostProcessRegistry } from "./processes.js";
+export class ControllerWorkerSupervisor {
+    envelope;
+    options;
+    supervisor;
+    constructor(envelope, options) {
+        this.envelope = envelope;
+        this.options = options;
+        this.supervisor = new ChildWorkerSupervisor({
+            label: "Controller worker",
+            registry: options.registry,
+            onMessage: options.onMessage,
+            parseMessage: parseControllerWorkerMessage,
+            encodeResponse: encodeControllerWorkerLine,
+            isReady: (message) => message.operation === "worker.ready",
+            isTerminal: (message) => message.operation === "worker.finished" || message.operation === "worker.failed",
+            ...(options.startupTimeoutMs === undefined
+                ? {}
+                : { startupTimeoutMs: options.startupTimeoutMs }),
+            ...(options.onSpawn === undefined ? {} : { onSpawn: options.onSpawn }),
+            ...(options.onDiagnostic === undefined ? {} : { onDiagnostic: options.onDiagnostic }),
+        });
+    }
+    async start() {
+        const builtEntry = fileURLToPath(new URL("./controller-worker-entry.js", import.meta.url));
+        const sourceEntry = fileURLToPath(new URL("./controller-worker-entry.ts", import.meta.url));
+        const workerEntry = this.options.workerEntryPath ?? builtEntry;
+        const args = this.options.workerEntryPath === undefined && !fs.existsSync(builtEntry)
+            ? ["--import", createRequire(import.meta.url).resolve("tsx"), sourceEntry]
+            : [workerEntry];
+        await this.supervisor.start({
+            args,
+            cwd: this.envelope.projectPath,
+            env: {
+                ...process.env,
+                ...this.options.env,
+                PI_WORKFLOWS_CONTROLLER_WORKER_LAUNCH: Buffer.from(canonicalJson(this.envelope)).toString("base64url"),
+            },
+        });
+    }
+    async wait() {
+        return await this.supervisor.wait();
+    }
+    async stop(outcome = "cancelled") {
+        await this.supervisor.stop(outcome);
+    }
+}
+//# sourceMappingURL=controller-worker-supervisor.js.map

package/dist/host/controller-worker-supervisor.js.map

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

package/dist/host/host-entry.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/host/host-entry.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { errorMessage } from "../workflows/errors.js";
+import { WorkflowHost } from "./runner.js";
+async function main() {
+    const databaseIndex = process.argv.indexOf("--database");
+    const databasePath = databaseIndex < 0 ? undefined : process.argv[databaseIndex + 1];
+    const host = new WorkflowHost({
+        ...(databasePath === undefined ? {} : { databasePath }),
+        onLog: (message) => process.stderr.write(`[pi-workflows host] ${message}\n`),
+    });
+    const shutdown = () => void host.stop();
+    process.once("SIGINT", shutdown);
+    process.once("SIGTERM", shutdown);
+    try {
+        await host.start();
+    }
+    catch (error) {
+        process.stderr.write(`${errorMessage(error)}\n`);
+        process.exitCode = 1;
+    }
+}
+void main();
+//# sourceMappingURL=host-entry.js.map

package/dist/host/host-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-entry.js","sourceRoot":"","sources":["../../src/host/host-entry.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;IACrF,MAAM,IAAI,GAAG,IAAI,YAAY,CAAC;QAC5B,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC;QACvD,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,OAAO,IAAI,CAAC;KAC7E,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,KAAK,IAAI,EAAE,CAAC"}

package/dist/host/processes.d.ts

@@ -1,24 +1,29 @@
+export type ProcessIdentity = {
+    pid: number;
+    startIdentity: string;
+};
 /**
- * Tracks headless child processes (spawned `pi --mode rpc` sessions) so a
- * killed host never leaves orphans working. Children spawn in their own
- * process group; the registry file lets a later host reap leftovers by
- * killing the whole group. The file lives next to the project store and is
- * only ever touched by one host at a time (the advisory lock ensures it).
+ * Tracks supervised process groups by PID and operating-system start identity.
+ * A later host kills a recorded process only when both values still match.
  */
 export declare class HostProcessRegistry {
     private readonly filePath;
-    private readonly pids;
+    private readonly processes;
     constructor(storeDir: string);
-    register(pid: number): void;
+    register(pid: number): ProcessIdentity;
     unregister(pid: number): void;
     get size(): number;
-    /** Kill every registered child's process group, escalating to SIGKILL. */
+    /** Kill one exact registered process group and remove its durable record. */
+    kill(pid: number): boolean;
+    /** Kill every process that still has its registered start identity. */
     killAll(): void;
-    /**
-     * Reap children recorded by a previous host that died without cleanup.
-     * Called once at host start, before the lock is taken.
-     */
+    /** Reap only exact stale process identities recorded by an older host. */
     reapOrphans(): number[];
     private readFile;
     private persist;
 }
+/** Return the operating-system parent PID for a live process. */
+export declare function processParentPid(pid: number): number | undefined;
+/** Return an operating-system process start value that fences PID reuse. */
+export declare function processStartIdentity(pid: number): string | undefined;
+export declare function matchesProcessIdentity(identity: ProcessIdentity): boolean;