@sift-wiki/conductor 0.2.0-beta.1 → 0.2.0

package/dist/runtime/process.d.ts

@@ -1,4 +1,5 @@
 import { type ChildProcess, type SpawnOptions } from "node:child_process";
+import type { SafeProcessIdentity } from "./executionJournal.js";
 export type ProcessLogStream = "stdout" | "stderr";
 export type RunProcessInput = {
     command: string;
@@ -11,6 +12,7 @@ export type RunProcessInput = {
     outputLimitBytes: number;
     signal: AbortSignal;
     onLog(stream: ProcessLogStream, chunk: string): Promise<void>;
+    onStarted?: ((identity: SafeProcessIdentity) => Promise<void>) | undefined;
 };
 export type RunProcessResult = {
     exitCode: number | null;
@@ -23,5 +25,15 @@ export type RunProcessResult = {
 };
 export type RunProcess = (input: RunProcessInput) => Promise<RunProcessResult>;
 export type SpawnLike = (command: string, args: string[], options: SpawnOptions) => ChildProcess;
-export declare function createProcessRunner(spawn?: SpawnLike): RunProcess;
+export type ProcessTreeTerminator = (input: {
+    child: ChildProcess;
+    processGroupId: number | null;
+    signal: NodeJS.Signals;
+}) => void;
+export declare function createProcessRunner(spawn?: SpawnLike, terminate?: ProcessTreeTerminator, readStartMarker?: (pid: number) => Promise<string | undefined>): RunProcess;
 export declare const runChildProcess: RunProcess;
+export declare function processTreeTerminationCapability(platform?: NodeJS.Platform): {
+    supported: boolean;
+    mechanism: "process-group" | "taskkill-tree";
+};
+export declare function windowsTaskkillArgs(pid: number, signal: NodeJS.Signals): string[];

package/dist/runtime/process.js

@@ -1,10 +1,11 @@
-import { spawn as nodeSpawn } from "node:child_process";
+import { execFile, spawn as nodeSpawn, } from "node:child_process";
 import { Buffer } from "node:buffer";
-export function createProcessRunner(spawn = nodeSpawn) {
-    return (input) => runChildProcessWithSpawn(input, spawn);
+import { readProcessStartMarker } from "./runtimeLock.js";
+export function createProcessRunner(spawn = nodeSpawn, terminate = terminateProcessTree, readStartMarker = readProcessStartMarker) {
+    return (input) => runChildProcessWithSpawn(input, spawn, terminate, readStartMarker);
 }
 export const runChildProcess = createProcessRunner();
-async function runChildProcessWithSpawn(input, spawn) {
+async function runChildProcessWithSpawn(input, spawn, terminate, readStartMarker) {
     return new Promise((resolve, reject) => {
         const child = spawn(input.command, input.args, {
             cwd: input.cwd,
@@ -25,6 +26,7 @@ async function runChildProcessWithSpawn(input, spawn) {
         let logChain = Promise.resolve();
         let timeout;
         let killTimeout;
+        const startPromise = recordProcessIdentity(child, input, readStartMarker);
         const requestStop = (reason) => {
             if (closed) {
                 return;
@@ -32,12 +34,13 @@ async function runChildProcessWithSpawn(input, spawn) {
             if (reason === "timeout") {
                 timedOut = true;
             }
-            signalRunningProcess(child, processGroupId, "SIGTERM");
+            terminate({ child, processGroupId, signal: "SIGTERM" });
             killTimeout ??= setTimeout(() => {
-                signalRunningProcess(child, processGroupId, "SIGKILL");
+                terminate({ child, processGroupId, signal: "SIGKILL" });
             }, Math.max(1, input.graceMs));
         };
         const onAbort = () => requestStop("abort");
+        void startPromise.catch(() => requestStop("abort"));
         input.signal.addEventListener("abort", onAbort, { once: true });
         if (input.signal.aborted) {
             requestStop("abort");
@@ -69,7 +72,7 @@ async function runChildProcessWithSpawn(input, spawn) {
         child.on("close", (code, closeSignal) => {
             closed = true;
             cleanup();
-            void logChain.finally(() => {
+            void Promise.all([logChain, startPromise]).then(() => {
                 resolve({
                     exitCode: code,
                     signal: closeSignal,
@@ -79,7 +82,7 @@ async function runChildProcessWithSpawn(input, spawn) {
                     pid: child.pid ?? null,
                     startedAt,
                 });
-            });
+            }).catch(reject);
         });
         function cleanup() {
             input.signal.removeEventListener("abort", onAbort);
@@ -92,13 +95,22 @@ async function runChildProcessWithSpawn(input, spawn) {
         }
     });
 }
+async function recordProcessIdentity(child, input, readStartMarker) {
+    if (input.onStarted === undefined || child.pid === undefined || child.pid <= 0)
+        return;
+    const startMarker = await readStartMarker(child.pid);
+    if (startMarker === undefined)
+        return;
+    await input.onStarted({ pid: child.pid, startMarker });
+}
 function resolveProcessGroupId(child) {
     if (process.platform === "win32") {
         return null;
     }
     return typeof child.pid === "number" && child.pid > 0 ? child.pid : null;
 }
-function signalRunningProcess(child, processGroupId, signal) {
+function terminateProcessTree(input) {
+    const { child, processGroupId, signal } = input;
     if (process.platform !== "win32" && processGroupId !== null) {
         try {
             process.kill(-processGroupId, signal);
@@ -108,10 +120,28 @@ function signalRunningProcess(child, processGroupId, signal) {
             // Fall through to direct child signaling.
         }
     }
+    if (process.platform === "win32" && typeof child.pid === "number" && child.pid > 0) {
+        execFile("taskkill.exe", windowsTaskkillArgs(child.pid, signal), { windowsHide: true }, (error) => {
+            if (error !== null)
+                signalDirectChild(child, signal);
+        });
+        return;
+    }
+    signalDirectChild(child, signal);
+}
+function signalDirectChild(child, signal) {
     if (!child.killed) {
         child.kill(signal);
     }
 }
+export function processTreeTerminationCapability(platform = process.platform) {
+    return platform === "win32"
+        ? { supported: true, mechanism: "taskkill-tree" }
+        : { supported: true, mechanism: "process-group" };
+}
+export function windowsTaskkillArgs(pid, signal) {
+    return ["/PID", String(pid), "/T", ...(signal === "SIGKILL" ? ["/F"] : [])];
+}
 function chunkToString(chunk) {
     return Buffer.isBuffer(chunk) ? chunk.toString("utf8") : String(chunk);
 }

package/dist/runtime/process.js.map

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

package/dist/runtime/recoveryCoordinator.d.ts

@@ -0,0 +1,19 @@
+import type { LocalAgentAdapter } from "../adapters/types.js";
+import type { ConductorClient, ConductorWorkClient } from "../types.js";
+import type { DurableEventOutbox } from "./eventOutbox.js";
+import type { ExecutionJournalStore } from "./executionJournal.js";
+export type RecoverySummary = {
+    reconciledAttempts: number;
+    resumedAttempts: number;
+    closedAttempts: number;
+    canClaim: boolean;
+};
+export declare function reconcileUnfinishedAttempts(input: {
+    credential: string;
+    client: Pick<ConductorClient, "reconcileAttempt" | "appendRunEvent"> & Partial<Pick<ConductorClient, "acknowledgeCancellation">>;
+    workClient?: Pick<ConductorWorkClient, "setTaskDisposition"> | undefined;
+    journalStore: ExecutionJournalStore;
+    outbox: DurableEventOutbox;
+    adapters: LocalAgentAdapter[];
+    now?: (() => Date) | undefined;
+}): Promise<RecoverySummary>;

package/dist/runtime/recoveryCoordinator.js

@@ -0,0 +1,183 @@
+import { ConductorApiError } from "../conductorClient.js";
+export async function reconcileUnfinishedAttempts(input) {
+    const unfinished = await input.journalStore.listUnfinished();
+    if (unfinished.length === 0) {
+        return { reconciledAttempts: 0, resumedAttempts: 0, closedAttempts: 0, canClaim: true };
+    }
+    if (input.client.reconcileAttempt === undefined) {
+        throw new Error("Sift reconciliation is unavailable while unfinished fenced attempts exist.");
+    }
+    let resumedAttempts = 0;
+    let closedAttempts = 0;
+    let canClaim = true;
+    for (const entry of unfinished) {
+        const journal = await updateJournal(input, entry.journal, { phase: "recovering" });
+        const adapter = input.adapters.find((candidate) => candidate.localKey === journal.localKey);
+        const providerResumeSupported = adapter?.resumeSupport === "session";
+        const decision = await input.client.reconcileAttempt(input.credential, {
+            attemptId: journal.authority.attemptId,
+            leaseGeneration: journal.authority.leaseGeneration,
+            lastAcknowledgedClientSequence: journal.lastAcknowledgedClientSequence,
+            providerResumeSupported,
+            supervisedProcessRunning: false,
+            ...(journal.terminalResult === undefined
+                ? {}
+                : {
+                    terminalResult: {
+                        disposition: journal.terminalResult.status === "overtime"
+                            ? "failed"
+                            : journal.terminalResult.status,
+                        summary: { summary: journal.terminalResult.summary },
+                    },
+                }),
+        });
+        if (decision.decision === "resume") {
+            resumedAttempts += 1;
+            if (!providerResumeSupported && journal.terminalResult === undefined) {
+                await updateJournal(input, journal, {
+                    phase: "interrupted",
+                    interruptionReason: "Sift returned resume for a provider without verified safe resume support.",
+                });
+                canClaim = false;
+                continue;
+            }
+            const resumed = await applyResume(input, journal, { ...decision, decision: "resume" });
+            if (resumed.terminalResult === undefined)
+                canClaim = false;
+            continue;
+        }
+        if (decision.decision === "stop" && !isTerminalCanonicalStatus(decision.canonicalStatus)) {
+            if (decision.cancellationRequested) {
+                try {
+                    const settled = await settleCancellation(input, journal);
+                    await updateJournal(input, journal, {
+                        phase: "terminal",
+                        terminalResult: journal.terminalResult ?? {
+                            status: "cancelled",
+                            summary: settled.summary,
+                        },
+                        interruptionReason: "Canonical cancellation confirmed during recovery.",
+                    });
+                    await input.outbox.discardAttempt(journal.attemptId);
+                    closedAttempts += 1;
+                    continue;
+                }
+                catch (error) {
+                    canClaim = false;
+                    await updateJournal(input, journal, {
+                        phase: "recovering",
+                        interruptionReason: `Cancellation settlement remains pending: ${errorMessage(error)}`,
+                    });
+                    continue;
+                }
+            }
+            canClaim = false;
+            await updateJournal(input, journal, {
+                phase: "recovering",
+                interruptionReason: decision.reason ?? "Sift returned stop while canonical work remains nonterminal.",
+            });
+            continue;
+        }
+        await updateJournal(input, journal, decisionJournalUpdate(decision));
+        await input.outbox.discardAttempt(journal.attemptId);
+        closedAttempts += 1;
+    }
+    return {
+        reconciledAttempts: unfinished.length,
+        resumedAttempts,
+        closedAttempts,
+        canClaim,
+    };
+}
+async function settleCancellation(input, journal) {
+    const summary = journal.terminalResult?.status === "cancelled"
+        ? journal.terminalResult.summary
+        : "Stopped local execution after Sift cancellation during recovery.";
+    const options = {
+        authority: journal.authority,
+        idempotencyKey: journal.settlementIdempotencyKey ?? `recovery-cancel:${journal.attemptId}`,
+    };
+    if (journal.taskRecordId !== undefined) {
+        if (input.workClient === undefined) {
+            throw new Error("Task cancellation settlement client is unavailable.");
+        }
+        await input.workClient.setTaskDisposition(input.credential, journal.runId, journal.taskRecordId, "cancelled", { summary }, options);
+        return { summary };
+    }
+    if (input.client.acknowledgeCancellation === undefined) {
+        throw new Error("Run cancellation settlement client is unavailable.");
+    }
+    await input.client.acknowledgeCancellation(input.credential, journal.runId, { summary }, options);
+    return { summary };
+}
+function isTerminalCanonicalStatus(status) {
+    return status === "completed" || status === "failed" || status === "cancelled";
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : "Unknown cancellation settlement failure.";
+}
+async function applyResume(input, journal, decision) {
+    if (decision.authority === undefined) {
+        throw new Error("Resume reconciliation omitted refreshed authority.");
+    }
+    let next = await updateJournal(input, journal, {
+        authority: decision.authority,
+        lastAcknowledgedClientSequence: Math.max(journal.lastAcknowledgedClientSequence, decision.lastAcknowledgedClientSequence),
+        phase: "recovering",
+    });
+    await input.outbox.acknowledge(next.attemptId, next.lastAcknowledgedClientSequence);
+    for (const entry of await input.outbox.listAttempt(next.attemptId)) {
+        let response;
+        try {
+            response = await input.client.appendRunEvent(input.credential, next.runId, {
+                eventType: entry.event.eventType,
+                ...(entry.event.payload === undefined ? {} : { payload: entry.event.payload }),
+                ...(entry.event.occurredAt === undefined ? {} : { occurredAt: entry.event.occurredAt }),
+                clientEventId: entry.clientEventId,
+                clientSequence: entry.clientSequence,
+                authority: next.authority,
+            });
+        }
+        catch (error) {
+            if (error instanceof ConductorApiError && error.disposition === "retryable")
+                throw error;
+            throw error;
+        }
+        const acknowledged = acknowledgementSequence(response);
+        if (acknowledged === undefined) {
+            throw new Error("Fenced event delivery response omitted acknowledgedClientSequence.");
+        }
+        await input.outbox.acknowledge(next.attemptId, acknowledged);
+        next = await updateJournal(input, next, {
+            lastAcknowledgedClientSequence: Math.max(next.lastAcknowledgedClientSequence, acknowledged),
+        });
+    }
+    return next;
+}
+function decisionJournalUpdate(decision) {
+    switch (decision.decision) {
+        case "already_terminal":
+            return { phase: "terminal", interruptionReason: decision.reason ?? "Canonical run is already terminal." };
+        case "superseded":
+            return { phase: "superseded", interruptionReason: decision.reason ?? "Another attempt owns this work." };
+        case "stop":
+            return { phase: "interrupted", interruptionReason: decision.reason ?? "Sift instructed local execution to stop." };
+        case "retry_as_new_attempt":
+            return { phase: "interrupted", interruptionReason: decision.reason ?? "Retry requires a new fenced attempt." };
+        case "resume":
+            throw new Error("Resume decisions require refreshed authority handling.");
+    }
+}
+async function updateJournal(input, journal, update) {
+    const next = {
+        ...journal,
+        ...update,
+        updatedAt: (input.now ?? (() => new Date()))().toISOString(),
+    };
+    await input.journalStore.write(next);
+    return next;
+}
+function acknowledgementSequence(response) {
+    return response.acknowledgedClientSequence;
+}
+//# sourceMappingURL=recoveryCoordinator.js.map

package/dist/runtime/recoveryCoordinator.js.map

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

package/dist/runtime/runtimeLock.d.ts

@@ -0,0 +1,33 @@
+import { z } from "zod";
+declare const lockSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    identityKey: z.ZodString;
+    pid: z.ZodNumber;
+    processStartMarker: z.ZodString;
+    nonce: z.ZodString;
+    acquiredAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type RuntimeLockRecord = z.infer<typeof lockSchema>;
+export type RuntimeLockHandle = {
+    record: RuntimeLockRecord;
+    release(): Promise<void>;
+};
+export type RuntimeLockOptions = {
+    pid?: number | undefined;
+    now?: (() => Date) | undefined;
+    createNonce?: (() => string) | undefined;
+    readProcessStartMarker?: ((pid: number) => Promise<string | undefined>) | undefined;
+};
+export declare class RuntimeIdentityLock {
+    readonly path: string;
+    private readonly options;
+    constructor(path?: string, options?: RuntimeLockOptions);
+    acquire(identityKey: string): Promise<RuntimeLockHandle>;
+    private tryCreate;
+    private readExisting;
+    private recoverStaleLock;
+    private handle;
+}
+export declare function defaultRuntimeLockPath(env?: NodeJS.ProcessEnv): string;
+export declare function readProcessStartMarker(pid: number): Promise<string | undefined>;
+export {};

package/dist/runtime/runtimeLock.js

@@ -0,0 +1,140 @@
+import { randomUUID } from "node:crypto";
+import { execFile } from "node:child_process";
+import { chmod, mkdir, open, readFile, rename, rm } from "node:fs/promises";
+import path from "node:path";
+import { promisify } from "node:util";
+import { z } from "zod";
+import { defaultConfigPath } from "../config.js";
+import { isNodeError } from "./atomicFile.js";
+const execFileAsync = promisify(execFile);
+const lockSchema = z.object({
+    schemaVersion: z.literal(1),
+    identityKey: z.string().min(1).max(500),
+    pid: z.number().int().positive(),
+    processStartMarker: z.string().min(1).max(500),
+    nonce: z.string().min(1),
+    acquiredAt: z.iso.datetime(),
+}).strict();
+export class RuntimeIdentityLock {
+    path;
+    options;
+    constructor(path = defaultRuntimeLockPath(), options = {}) {
+        this.path = path;
+        this.options = options;
+    }
+    async acquire(identityKey) {
+        await mkdir(path.dirname(this.path), { recursive: true, mode: 0o700 });
+        await chmod(path.dirname(this.path), 0o700);
+        const pid = this.options.pid ?? process.pid;
+        const markerReader = this.options.readProcessStartMarker ?? readProcessStartMarker;
+        const processStartMarker = await markerReader(pid);
+        if (processStartMarker === undefined) {
+            throw new Error("Cannot establish a PID-reuse-safe runtime identity.");
+        }
+        const record = lockSchema.parse({
+            schemaVersion: 1,
+            identityKey,
+            pid,
+            processStartMarker,
+            nonce: (this.options.createNonce ?? randomUUID)(),
+            acquiredAt: (this.options.now ?? (() => new Date()))().toISOString(),
+        });
+        for (let attempt = 0; attempt < 3; attempt += 1) {
+            if (await this.tryCreate(record))
+                return this.handle(record);
+            const existing = await this.readExisting();
+            if (existing !== undefined && await sameLiveProcess(existing, markerReader)) {
+                throw new Error("Another Conductor runtime already owns this paired identity and state directory.");
+            }
+            await this.recoverStaleLock(existing);
+        }
+        throw new Error("Could not acquire the Conductor runtime identity lock.");
+    }
+    async tryCreate(record) {
+        try {
+            const handle = await open(this.path, "wx", 0o600);
+            try {
+                await handle.writeFile(`${JSON.stringify(record, null, 2)}\n`, "utf8");
+                await handle.sync();
+            }
+            finally {
+                await handle.close();
+            }
+            return true;
+        }
+        catch (error) {
+            if (isNodeError(error) && error.code === "EEXIST")
+                return false;
+            throw error;
+        }
+    }
+    async readExisting() {
+        try {
+            return lockSchema.parse(JSON.parse(await readFile(this.path, "utf8")));
+        }
+        catch (error) {
+            if (isNodeError(error) && error.code === "ENOENT")
+                return undefined;
+            if (error instanceof SyntaxError || error instanceof z.ZodError)
+                return undefined;
+            throw error;
+        }
+    }
+    async recoverStaleLock(existing) {
+        try {
+            await rename(this.path, `${this.path}.stale-${existing?.nonce ?? randomUUID()}`);
+        }
+        catch (error) {
+            if (!isNodeError(error) || error.code !== "ENOENT")
+                throw error;
+        }
+    }
+    handle(record) {
+        return {
+            record,
+            release: async () => {
+                const existing = await this.readExisting();
+                if (existing?.nonce === record.nonce)
+                    await rm(this.path, { force: true });
+            },
+        };
+    }
+}
+export function defaultRuntimeLockPath(env = process.env) {
+    return path.join(path.dirname(defaultConfigPath(env)), "runtime", "conductor.lock");
+}
+async function sameLiveProcess(record, markerReader) {
+    try {
+        process.kill(record.pid, 0);
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "EPERM")
+            return true;
+        return false;
+    }
+    return await markerReader(record.pid) === record.processStartMarker;
+}
+export async function readProcessStartMarker(pid) {
+    if (process.platform === "linux") {
+        try {
+            const stat = await readFile(`/proc/${String(pid)}/stat`, "utf8");
+            return stat.trim().split(/\s+/u)[21];
+        }
+        catch {
+            return undefined;
+        }
+    }
+    const command = process.platform === "win32" ? "powershell.exe" : "ps";
+    const args = process.platform === "win32"
+        ? ["-NoProfile", "-Command", `(Get-Process -Id ${String(pid)}).StartTime.ToUniversalTime().Ticks`]
+        : ["-o", "lstart=", "-p", String(pid)];
+    try {
+        const { stdout } = await execFileAsync(command, args, { timeout: 2_000 });
+        const marker = stdout.trim();
+        return marker.length === 0 ? undefined : marker;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=runtimeLock.js.map

package/dist/runtime/runtimeLock.js.map

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

package/dist/runtime/runtimeService.d.ts

@@ -1,4 +1,5 @@
 import type { DaemonOnceResult, RunDaemonOnceInput } from "../daemon.js";
+import type { RuntimeIdentityLock } from "./runtimeLock.js";
 export type RuntimeServiceState = "stopped" | "starting" | "running" | "stopping" | "failed";
 export type RuntimeServiceStatus = {
     state: RuntimeServiceState;
@@ -9,6 +10,7 @@ export type RuntimeServiceStatus = {
 };
 export declare class HeadlessRuntimeService {
     private readonly input;
+    private readonly runtimeLock?;
     private state;
     private startedAt;
     private stoppedAt;
@@ -16,7 +18,8 @@ export declare class HeadlessRuntimeService {
     private lastErrorMessage;
     private controller;
     private runPromise;
-    constructor(input: Omit<RunDaemonOnceInput, "signal">);
+    private lockHandle;
+    constructor(input: Omit<RunDaemonOnceInput, "signal">, runtimeLock?: RuntimeIdentityLock | undefined);
     status(): RuntimeServiceStatus;
     runOnce(): Promise<DaemonOnceResult>;
     start(): Promise<RuntimeServiceStatus>;
@@ -24,4 +27,6 @@ export declare class HeadlessRuntimeService {
     restart(): Promise<RuntimeServiceStatus>;
     waitUntilStopped(): Promise<RuntimeServiceStatus>;
     private runUntilStopped;
+    private acquireOwnership;
+    private releaseOwnership;
 }