@osolmaz/pi-workflows 0.14.0 → 0.15.1

package/dist/host/processes.js

@@ -1,103 +1,207 @@
+import { execFileSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 /**
- * 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 class HostProcessRegistry {
     filePath;
-    pids = new Set();
+    processes = new Map();
     constructor(storeDir) {
         this.filePath = path.join(storeDir, "host.children.json");
     }
     register(pid) {
-        this.pids.add(pid);
+        const startIdentity = processStartIdentity(pid);
+        if (startIdentity === undefined) {
+            throw new Error(`Cannot attest supervised process start identity: ${pid}`);
+        }
+        const identity = { pid, startIdentity };
+        this.processes.set(pid, identity);
         this.persist();
+        return identity;
     }
     unregister(pid) {
-        this.pids.delete(pid);
+        this.processes.delete(pid);
         this.persist();
     }
     get size() {
-        return this.pids.size;
+        return this.processes.size;
+    }
+    /** Kill one exact registered process group and remove its durable record. */
+    kill(pid) {
+        const identity = this.processes.get(pid);
+        if (identity === undefined)
+            return false;
+        if (matchesProcessIdentity(identity)) {
+            killProcessGroup(identity.pid, "SIGTERM");
+            if (matchesProcessIdentity(identity))
+                killProcessGroup(identity.pid, "SIGKILL");
+        }
+        this.processes.delete(pid);
+        this.persist();
+        return true;
     }
-    /** Kill every registered child's process group, escalating to SIGKILL. */
+    /** Kill every process that still has its registered start identity. */
     killAll() {
-        for (const pid of this.pids) {
-            killProcessGroup(pid, "SIGTERM");
+        for (const identity of this.processes.values()) {
+            if (matchesProcessIdentity(identity))
+                killProcessGroup(identity.pid, "SIGTERM");
         }
-        for (const pid of this.pids) {
-            killProcessGroup(pid, "SIGKILL");
+        for (const identity of this.processes.values()) {
+            if (matchesProcessIdentity(identity))
+                killProcessGroup(identity.pid, "SIGKILL");
         }
-        this.pids.clear();
+        this.processes.clear();
         this.persist();
     }
-    /**
-     * 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() {
         const recorded = this.readFile();
         const reaped = [];
         const stillAlive = [];
-        for (const pid of recorded) {
-            if (isAlive(pid)) {
-                killProcessGroup(pid, "SIGKILL");
-                reaped.push(pid);
-                if (isAlive(pid)) {
-                    // A group kill that left the leader alive stays registered so a
-                    // later start tries again instead of forgetting it.
-                    stillAlive.push(pid);
-                }
-            }
-        }
-        this.pids.clear();
-        for (const pid of stillAlive) {
-            this.pids.add(pid);
+        for (const identity of recorded) {
+            if (!matchesProcessIdentity(identity))
+                continue;
+            killProcessGroup(identity.pid, "SIGKILL");
+            reaped.push(identity.pid);
+            if (matchesProcessIdentity(identity))
+                stillAlive.push(identity);
         }
+        this.processes.clear();
+        for (const identity of stillAlive)
+            this.processes.set(identity.pid, identity);
         this.persist();
         return reaped;
     }
     readFile() {
         try {
             const parsed = JSON.parse(fs.readFileSync(this.filePath, "utf8"));
-            if (!Array.isArray(parsed)) {
+            if (!isRegistryFile(parsed))
                 return [];
-            }
-            return parsed.filter((pid) => Number.isSafeInteger(pid) && pid > 0);
+            return parsed.processes;
         }
         catch {
             return [];
         }
     }
     persist() {
+        fs.mkdirSync(path.dirname(this.filePath), { recursive: true, mode: 0o700 });
+        const file = {
+            schema: "pi-workflows.process-registry.v1",
+            processes: [...this.processes.values()].sort((left, right) => left.pid - right.pid),
+        };
+        const temporary = `${this.filePath}.${process.pid}.tmp`;
+        fs.writeFileSync(temporary, `${JSON.stringify(file)}\n`, { encoding: "utf8", mode: 0o600 });
+        fs.renameSync(temporary, this.filePath);
+        fs.chmodSync(this.filePath, 0o600);
+    }
+}
+/** Return the operating-system parent PID for a live process. */
+export function processParentPid(pid) {
+    if (!Number.isSafeInteger(pid) || pid <= 0)
+        return undefined;
+    if (process.platform === "linux") {
         try {
-            fs.mkdirSync(path.dirname(this.filePath), { recursive: true, mode: 0o700 });
-            // Write exactly the live set. Unioning with the previous file would
-            // resurrect exited pids, and a later host reaping them could kill an
-            // unrelated process group that reused one.
-            fs.writeFileSync(this.filePath, `${JSON.stringify([...this.pids])}\n`, {
-                encoding: "utf8",
-                mode: 0o600,
-            });
+            const fields = linuxStatFields(pid);
+            const parentPid = Number(fields[1]);
+            return Number.isSafeInteger(parentPid) && parentPid > 0 ? parentPid : undefined;
         }
         catch {
-            // Registry bookkeeping is best-effort; orphan reaping is the backstop.
+            return undefined;
         }
     }
+    if (process.platform === "win32") {
+        try {
+            const parentPid = Number(execFileSync("powershell.exe", [
+                "-NoProfile",
+                "-NonInteractive",
+                "-Command",
+                `(Get-CimInstance Win32_Process -Filter "ProcessId = ${pid}").ParentProcessId`,
+            ], { encoding: "utf8", timeout: 2_000, windowsHide: true }).trim());
+            return Number.isSafeInteger(parentPid) && parentPid > 0 ? parentPid : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    try {
+        const parentPid = Number(execFileSync("ps", ["-o", "ppid=", "-p", String(pid)], {
+            encoding: "utf8",
+            timeout: 2_000,
+        }).trim());
+        return Number.isSafeInteger(parentPid) && parentPid > 0 ? parentPid : undefined;
+    }
+    catch {
+        return undefined;
+    }
 }
-function isAlive(pid) {
+/** Return an operating-system process start value that fences PID reuse. */
+export function processStartIdentity(pid) {
+    if (!Number.isSafeInteger(pid) || pid <= 0)
+        return undefined;
+    if (process.platform === "linux") {
+        try {
+            const startTicks = linuxStatFields(pid)[19];
+            if (startTicks !== undefined)
+                return `linux-proc-start:${startTicks}`;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    if (process.platform === "win32") {
+        try {
+            const ticks = execFileSync("powershell.exe", [
+                "-NoProfile",
+                "-NonInteractive",
+                "-Command",
+                `(Get-Process -Id ${pid} -ErrorAction Stop).StartTime.ToUniversalTime().Ticks`,
+            ], { encoding: "utf8", timeout: 2_000, windowsHide: true }).trim();
+            return ticks.length === 0 ? undefined : `windows-start-ticks:${ticks}`;
+        }
+        catch {
+            return undefined;
+        }
+    }
     try {
-        process.kill(pid, 0);
-        return true;
+        const started = execFileSync("ps", ["-o", "lstart=", "-p", String(pid)], {
+            encoding: "utf8",
+            timeout: 2_000,
+        }).trim();
+        return started.length === 0 ? undefined : `${process.platform}-ps-start:${started}`;
     }
     catch {
-        return false;
+        return undefined;
     }
 }
+function linuxStatFields(pid) {
+    const stat = fs.readFileSync(`/proc/${pid}/stat`, "utf8");
+    const commandEnd = stat.lastIndexOf(")");
+    if (commandEnd < 0)
+        throw new Error(`Linux process stat is invalid: ${pid}`);
+    return stat
+        .slice(commandEnd + 2)
+        .trim()
+        .split(/\s+/);
+}
+export function matchesProcessIdentity(identity) {
+    return processStartIdentity(identity.pid) === identity.startIdentity;
+}
+function isRegistryFile(value) {
+    if (!isRecord(value) || value.schema !== "pi-workflows.process-registry.v1")
+        return false;
+    if (!Array.isArray(value.processes))
+        return false;
+    return value.processes.every((entry) => isRecord(entry) &&
+        Number.isSafeInteger(entry.pid) &&
+        entry.pid > 0 &&
+        typeof entry.startIdentity === "string" &&
+        entry.startIdentity.length > 0);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function killProcessGroup(pid, signal) {
     try {
         process.kill(-pid, signal);
@@ -107,7 +211,7 @@ function killProcessGroup(pid, signal) {
             process.kill(pid, signal);
         }
         catch {
-            // Already gone.
+            // The exact process has already exited.
         }
     }
 }

package/dist/host/processes.js.map

@@ -1 +1 @@
-{"version":3,"file":"processes.js","sourceRoot":"","sources":["../../src/host/processes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"processes.js","sourceRoot":"","sources":["../../src/host/processes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAY7B;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IACb,QAAQ,CAAS;IACjB,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEhE,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;IAC5D,CAAC;IAED,QAAQ,CAAC,GAAW;QAClB,MAAM,aAAa,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,oDAAoD,GAAG,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,MAAM,QAAQ,GAAG,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC;QACxC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;IAED,6EAA6E;IAC7E,IAAI,CAAC,GAAW;QACd,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACzC,IAAI,sBAAsB,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC1C,IAAI,sBAAsB,CAAC,QAAQ,CAAC;gBAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAClF,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uEAAuE;IACvE,OAAO;QACL,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,IAAI,sBAAsB,CAAC,QAAQ,CAAC;gBAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAClF,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,IAAI,sBAAsB,CAAC,QAAQ,CAAC;gBAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAClF,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,0EAA0E;IAC1E,WAAW;QACT,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAsB,EAAE,CAAC;QACzC,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC;gBAAE,SAAS;YAChD,gBAAgB,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,sBAAsB,CAAC,QAAQ,CAAC;gBAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,KAAK,MAAM,QAAQ,IAAI,UAAU;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC9E,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,QAAQ;QACd,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAY,CAAC;YAC7E,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;gBAAE,OAAO,EAAE,CAAC;YACvC,OAAO,MAAM,CAAC,SAAS,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,OAAO;QACb,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5E,MAAM,IAAI,GAAwB;YAChC,MAAM,EAAE,kCAAkC;YAC1C,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;SACpF,CAAC;QACF,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;QACxD,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5F,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;CACF;AAED,iEAAiE;AACjE,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7D,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;YACpC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,OAAO,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QAClF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,CACtB,YAAY,CACV,gBAAgB,EAChB;gBACE,YAAY;gBACZ,iBAAiB;gBACjB,UAAU;gBACV,uDAAuD,GAAG,oBAAoB;aAC/E,EACD,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CACxD,CAAC,IAAI,EAAE,CACT,CAAC;YACF,OAAO,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QAClF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,CACtB,YAAY,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE;YACrD,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,KAAK;SACf,CAAC,CAAC,IAAI,EAAE,CACV,CAAC;QACF,OAAO,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAClF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7D,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;YAC5C,IAAI,UAAU,KAAK,SAAS;gBAAE,OAAO,oBAAoB,UAAU,EAAE,CAAC;QACxE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,YAAY,CACxB,gBAAgB,EAChB;gBACE,YAAY;gBACZ,iBAAiB;gBACjB,UAAU;gBACV,oBAAoB,GAAG,uDAAuD;aAC/E,EACD,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CACxD,CAAC,IAAI,EAAE,CAAC;YACT,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,uBAAuB,KAAK,EAAE,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE;YACvE,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,KAAK;SACf,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,aAAa,OAAO,EAAE,CAAC;IACtF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,UAAU,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,GAAG,EAAE,CAAC,CAAC;IAC7E,OAAO,IAAI;SACR,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;SACrB,IAAI,EAAE;SACN,KAAK,CAAC,KAAK,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAyB;IAC9D,OAAO,oBAAoB,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,aAAa,CAAC;AACvE,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,kCAAkC;QAAE,OAAO,KAAK,CAAC;IAC1F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IAClD,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,CAC1B,CAAC,KAAK,EAAE,EAAE,CACR,QAAQ,CAAC,KAAK,CAAC;QACf,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC;QAC9B,KAAK,CAAC,GAAc,GAAG,CAAC;QACzB,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ;QACvC,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CACjC,CAAC;AACJ,CAAC;AAED,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;AAED,SAAS,gBAAgB,CAAC,GAAW,EAAE,MAAsB;IAC3D,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,wCAAwC;QAC1C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/host/protocol.d.ts

@@ -0,0 +1,38 @@
+import { type JsonValue } from "../state/json.js";
+export declare const HOST_PROTOCOL_VERSION = 1;
+export declare const HOST_REQUEST_SCHEMA: "pi-workflows.host-request.v1";
+export declare const HOST_RESPONSE_SCHEMA: "pi-workflows.host-response.v1";
+export declare const MAX_PROTOCOL_MESSAGE_BYTES: number;
+export declare const HOST_OPERATIONS: readonly ["run.start", "run.pause", "run.resume", "run.cancel", "run.status", "run.list", "checkpoint.answer", "decision.answer", "interaction.submit", "interaction.update", "notification.claim", "notification.deliver", "turn.claim", "turn.resolve", "controller.list", "controller.get", "controller.apply", "controller.reconcile", "controller.delete", "host.status", "host.stop"];
+export type HostOperation = (typeof HOST_OPERATIONS)[number];
+export type HostOutcome = "accepted" | "adopted" | "rejected" | "conflict" | "notFound" | "claimLost" | "unavailable";
+export type HostRequest = {
+    schema: typeof HOST_REQUEST_SCHEMA;
+    requestId: string;
+    clientId: string;
+    operation: HostOperation;
+    idempotencyKey: string;
+    runId?: string;
+    expectedRevision?: number;
+    payload: JsonValue;
+};
+export type HostResponse = {
+    schema: typeof HOST_RESPONSE_SCHEMA;
+    requestId: string;
+    outcome: HostOutcome;
+    revision?: number;
+    receipt?: JsonValue;
+    error?: string;
+};
+export declare class HostProtocolError extends Error {
+    constructor(message: string);
+}
+export declare function encodeProtocolLine(message: HostRequest | HostResponse): Buffer;
+export declare function parseHostRequest(line: string | Buffer): HostRequest;
+export declare function parseHostResponse(line: string | Buffer): HostResponse;
+export declare function requestFingerprint(request: HostRequest): Buffer;
+export declare function hostSocketPath(databasePath: string): string;
+export declare class NdjsonFrameDecoder {
+    private buffered;
+    push(chunk: Buffer): Buffer[];
+}

package/dist/host/protocol.js

@@ -0,0 +1,156 @@
+import { createHash } from "node:crypto";
+import path from "node:path";
+import { canonicalJson, parseJson } from "../state/json.js";
+export const HOST_PROTOCOL_VERSION = 1;
+export const HOST_REQUEST_SCHEMA = "pi-workflows.host-request.v1";
+export const HOST_RESPONSE_SCHEMA = "pi-workflows.host-response.v1";
+export const MAX_PROTOCOL_MESSAGE_BYTES = 1024 * 1024;
+export const HOST_OPERATIONS = [
+    "run.start",
+    "run.pause",
+    "run.resume",
+    "run.cancel",
+    "run.status",
+    "run.list",
+    "checkpoint.answer",
+    "decision.answer",
+    "interaction.submit",
+    "interaction.update",
+    "notification.claim",
+    "notification.deliver",
+    "turn.claim",
+    "turn.resolve",
+    "controller.list",
+    "controller.get",
+    "controller.apply",
+    "controller.reconcile",
+    "controller.delete",
+    "host.status",
+    "host.stop",
+];
+export class HostProtocolError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "HostProtocolError";
+    }
+}
+export function encodeProtocolLine(message) {
+    const encoded = Buffer.from(`${canonicalJson(message)}\n`, "utf8");
+    if (encoded.byteLength > MAX_PROTOCOL_MESSAGE_BYTES) {
+        throw new HostProtocolError("Host protocol message exceeds 1 MiB");
+    }
+    return encoded;
+}
+export function parseHostRequest(line) {
+    const value = parseProtocolValue(line);
+    if (value.schema !== HOST_REQUEST_SCHEMA)
+        throw new HostProtocolError("Invalid host request schema");
+    requireOpaqueId(value.requestId, "requestId");
+    requireOpaqueId(value.clientId, "clientId");
+    requireOpaqueId(value.idempotencyKey, "idempotencyKey");
+    if (!HOST_OPERATIONS.includes(value.operation)) {
+        throw new HostProtocolError("Invalid host request operation");
+    }
+    if (value.runId !== undefined)
+        requireOpaqueId(value.runId, "runId");
+    if (value.expectedRevision !== undefined &&
+        (!Number.isSafeInteger(value.expectedRevision) || value.expectedRevision < 0)) {
+        throw new HostProtocolError("Host request expectedRevision must be a non-negative integer");
+    }
+    if (!Object.hasOwn(value, "payload"))
+        throw new HostProtocolError("Host request payload is required");
+    canonicalJson(value.payload);
+    return value;
+}
+export function parseHostResponse(line) {
+    const value = parseProtocolValue(line);
+    if (value.schema !== HOST_RESPONSE_SCHEMA) {
+        throw new HostProtocolError("Invalid host response schema");
+    }
+    requireOpaqueId(value.requestId, "requestId");
+    const outcomes = [
+        "accepted",
+        "adopted",
+        "rejected",
+        "conflict",
+        "notFound",
+        "claimLost",
+        "unavailable",
+    ];
+    if (!outcomes.includes(value.outcome)) {
+        throw new HostProtocolError("Invalid host response outcome");
+    }
+    if (value.revision !== undefined &&
+        (!Number.isSafeInteger(value.revision) || value.revision < 0)) {
+        throw new HostProtocolError("Host response revision must be a non-negative integer");
+    }
+    if (value.error !== undefined && typeof value.error !== "string") {
+        throw new HostProtocolError("Host response error must be text");
+    }
+    if (value.receipt !== undefined)
+        canonicalJson(value.receipt);
+    return value;
+}
+export function requestFingerprint(request) {
+    return createHash("sha256").update(canonicalJson(request)).digest();
+}
+export function hostSocketPath(databasePath) {
+    const stateDirectory = path.dirname(path.resolve(databasePath));
+    if (process.platform === "win32") {
+        const suffix = createHash("sha256").update(stateDirectory).digest("hex").slice(0, 24);
+        return `\\\\.\\pipe\\pi-workflows-${suffix}`;
+    }
+    return path.join(stateDirectory, "host", "host.sock");
+}
+export class NdjsonFrameDecoder {
+    buffered = Buffer.alloc(0);
+    push(chunk) {
+        this.buffered = Buffer.concat([this.buffered, chunk]);
+        if (this.buffered.byteLength > MAX_PROTOCOL_MESSAGE_BYTES && !this.buffered.includes(0x0a)) {
+            throw new HostProtocolError("Host protocol message exceeds 1 MiB");
+        }
+        const frames = [];
+        for (;;) {
+            const newline = this.buffered.indexOf(0x0a);
+            if (newline < 0)
+                break;
+            const frame = this.buffered.subarray(0, newline);
+            this.buffered = this.buffered.subarray(newline + 1);
+            if (frame.byteLength === 0)
+                continue;
+            if (frame.byteLength + 1 > MAX_PROTOCOL_MESSAGE_BYTES) {
+                throw new HostProtocolError("Host protocol message exceeds 1 MiB");
+            }
+            frames.push(frame);
+        }
+        return frames;
+    }
+}
+function parseProtocolValue(line) {
+    const buffer = Buffer.isBuffer(line) ? line : Buffer.from(line, "utf8");
+    if (buffer.byteLength + 1 > MAX_PROTOCOL_MESSAGE_BYTES) {
+        throw new HostProtocolError("Host protocol message exceeds 1 MiB");
+    }
+    let value;
+    try {
+        value = parseJson(buffer.toString("utf8"));
+    }
+    catch {
+        throw new HostProtocolError("Host protocol message is not valid canonical JSON");
+    }
+    if (!isRecord(value))
+        throw new HostProtocolError("Host protocol message must be an object");
+    if (canonicalJson(value) !== buffer.toString("utf8")) {
+        throw new HostProtocolError("Host protocol message must use canonical JSON");
+    }
+    return value;
+}
+function requireOpaqueId(value, field) {
+    if (typeof value !== "string" || value.length === 0 || value.length > 256) {
+        throw new HostProtocolError(`Host request ${field} must be nonempty text of at most 256 bytes`);
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=protocol.js.map

package/dist/host/protocol.js.map

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

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

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import { type JsonValue } from "../state/json.js";
+export type ResolvedWorkflowLaunch = {
+    schema: "pi-workflows.resolved-launch.v1";
+    workflowName: string;
+    workflowSourceRef: string;
+    workflowSource: JsonValue;
+    definitionDigest: string;
+    definitionSnapshot: JsonValue;
+};
+export type ResolvedControllerInitialization = {
+    schema: "pi-workflows.resolved-controller-initialization.v1";
+    controllerName: string;
+    controllerPath: string;
+    sourceHash: string;
+    initialStatus: JsonValue;
+};
+export type ResolvedSettingsChange = {
+    schema: "pi-workflows.resolved-settings-change.v1";
+    definitionDigest: string;
+    patch: JsonValue;
+    settings: JsonValue;
+    paths: JsonValue;
+};
+type ResolverRequest = {
+    schema: "pi-workflows.resolve-request.v1";
+    cwd: string;
+    workflowRef: string;
+};
+type SettingsValidationRequest = {
+    schema: "pi-workflows.settings-validation-request.v1";
+    cwd: string;
+    workflowRef: string;
+    definitionDigest: string;
+    mountPath: string;
+    current: JsonValue;
+    patch: JsonValue;
+    actorId: string;
+};
+type ControllerInitializationRequest = {
+    schema: "pi-workflows.controller-initialization-request.v1";
+    cwd: string;
+    controllerName: string;
+    spec: JsonValue;
+};
+export declare function resolveWorkflowLaunch(request: ResolverRequest): Promise<ResolvedWorkflowLaunch>;
+export declare function resolveControllerInitialization(request: ControllerInitializationRequest): Promise<ResolvedControllerInitialization>;
+export declare function resolveSettingsChange(request: SettingsValidationRequest): Promise<ResolvedSettingsChange>;
+export {};