@atom-workflow-agent/atom-executor 0.1.0

package/dist/attempt/process-atom-attempt-runner.js

@@ -0,0 +1,244 @@
+import { fork } from "node:child_process";
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { AtomWorkflowError, } from "@atom-workflow-agent/contracts";
+import { continueAtomAttempt, startAtomAttempt, } from "../lifecycle/lifecycle-driver.js";
+import { ATOM_WORKER_PROTOCOL_VERSION, } from "./atom-worker-protocol.js";
+const COOPERATIVE_ABORT_GRACE_MS = 1_000;
+const FORCE_KILL_GRACE_MS = 5_000;
+const OUTPUT_TAIL_LIMIT = 8 * 1024;
+/** Runs every execute/resume tick in a fresh owned Node.js process. */
+export class ProcessAtomAttemptRunner {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    start(input) {
+        const invoker = this.invoker(input);
+        return startAtomAttempt(input.definition, input.input, input.context, { ...input.lifecycle, invoker });
+    }
+    continue(input) {
+        const invoker = this.invoker(input);
+        return continueAtomAttempt(input.definition, input.input, input.context, input.snapshot, { ...input.lifecycle, invoker }, input.resume);
+    }
+    invoker(input) {
+        if (!input.executionSource) {
+            throw new AtomWorkflowError("ATOM_EXECUTION_SOURCE_REQUIRED", `Process execution requires a reloadable module source: ${input.definition.manifest.id}@${input.definition.manifest.version}`);
+        }
+        return {
+            execute: async (_definition, _value, _context) => this.runTick({ request: input, phase: "execute" }),
+            resume: async (_definition, _value, resumeInput, _context) => this.runTick({ request: input, phase: "resume", resumeInput }),
+        };
+    }
+    async runTick(input) {
+        const source = input.request.executionSource;
+        const context = input.request.context;
+        const workDirectory = await mkdtemp(join(tmpdir(), "atom-attempt-"));
+        const entry = workerEntryPath();
+        let stdout = "";
+        let stderr = "";
+        let settled = false;
+        let aborting = false;
+        let cooperativeTimer;
+        let forceTimer;
+        const child = fork(entry, [], {
+            cwd: context.cwd,
+            detached: process.platform !== "win32",
+            silent: true,
+            serialization: "advanced",
+            execArgv: [],
+            env: safeEnvironment(workDirectory, context.runtime.attemptId, this.options.environment),
+        });
+        const append = (previous, chunk) => {
+            const next = previous + chunk.toString();
+            return next.length <= OUTPUT_TAIL_LIMIT ? next : next.slice(-OUTPUT_TAIL_LIMIT);
+        };
+        const emitProcessOutput = (type, chunk) => {
+            const text = chunk.toString().slice(-4_096);
+            if (!text)
+                return;
+            this.options.onEvent?.({
+                schemaVersion: "1.0",
+                type,
+                timestamp: new Date().toISOString(),
+                attemptId: context.runtime.attemptId,
+                phase: input.phase,
+                data: { text },
+            });
+        };
+        child.stdout?.on("data", (chunk) => {
+            stdout = append(stdout, chunk);
+            emitProcessOutput("process.stdout", chunk);
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr = append(stderr, chunk);
+            emitProcessOutput("process.stderr", chunk);
+        });
+        const terminate = (reason) => {
+            if (aborting || settled)
+                return;
+            aborting = true;
+            send(child, { type: "abort", reason: reason instanceof Error ? reason.message : String(reason ?? "cancelled") });
+            cooperativeTimer = setTimeout(() => signalProcessTree(child, "SIGTERM"), COOPERATIVE_ABORT_GRACE_MS);
+            forceTimer = setTimeout(() => signalProcessTree(child, "SIGKILL"), COOPERATIVE_ABORT_GRACE_MS + FORCE_KILL_GRACE_MS);
+        };
+        const onAbort = () => terminate(context.signal.reason);
+        context.signal.addEventListener("abort", onAbort, { once: true });
+        if (context.signal.aborted)
+            terminate(context.signal.reason);
+        try {
+            return await new Promise((resolve, reject) => {
+                let terminal;
+                let terminalKind;
+                child.on("message", (raw) => {
+                    if (!raw || typeof raw !== "object" || !("type" in raw))
+                        return;
+                    const message = raw;
+                    if (message.type === "event") {
+                        this.options.onEvent?.(message.event);
+                        if (message.event.type === "atom.log")
+                            forwardLog(context, message.event.data);
+                        return;
+                    }
+                    if (message.type === "rpc") {
+                        if (aborting || terminalKind) {
+                            send(child, { type: "rpc.result", requestId: message.requestId, ok: false, error: serializedError(new AtomWorkflowError("ATOM_ATTEMPT_CLOSED", "Atom Attempt is no longer accepting service calls")) });
+                            return;
+                        }
+                        void handleRpc(context, message.request).then((value) => send(child, { type: "rpc.result", requestId: message.requestId, ok: true, value }), (error) => send(child, { type: "rpc.result", requestId: message.requestId, ok: false, error: serializedError(error) }));
+                        return;
+                    }
+                    if (message.type === "completed") {
+                        terminalKind = "completed";
+                        terminal = message.invocation;
+                    }
+                    else if (message.type === "failed") {
+                        terminalKind = "failed";
+                        terminal = message.error;
+                    }
+                });
+                child.once("error", (error) => reject(new AtomWorkflowError("ATOM_WORKER_SPAWN_FAILED", "Atom worker process failed to start", true, { cause: error })));
+                child.once("exit", (code, signal) => {
+                    settled = true;
+                    if (terminalKind === "completed") {
+                        resolve(terminal);
+                        return;
+                    }
+                    if (terminalKind === "failed") {
+                        reject(deserializeError(terminal));
+                        return;
+                    }
+                    if (context.signal.aborted) {
+                        const reason = context.signal.reason;
+                        reject(reason instanceof Error ? reason : new AtomWorkflowError("CANCELLED", "Atom worker was cancelled"));
+                        return;
+                    }
+                    const detail = [stderr.trim(), stdout.trim()].filter(Boolean).join("\n");
+                    reject(new AtomWorkflowError("ATOM_WORKER_EXITED", `Atom worker exited without a result${code === null ? "" : ` (code ${code})`}${signal ? ` (${signal})` : ""}${detail ? `: ${detail}` : ""}`, true));
+                });
+                send(child, {
+                    type: "run",
+                    request: {
+                        protocolVersion: ATOM_WORKER_PROTOCOL_VERSION,
+                        source,
+                        atom: { id: input.request.definition.manifest.id, version: input.request.definition.manifest.version },
+                        phase: input.phase,
+                        input: input.request.input,
+                        ...(input.resumeInput ? { resumeInput: input.resumeInput } : {}),
+                        context: {
+                            runtime: context.runtime,
+                            cwd: context.cwd,
+                            metadata: context.metadata,
+                            ...(context.decision ? { decision: context.decision } : {}),
+                        },
+                    },
+                });
+            });
+        }
+        finally {
+            settled = true;
+            context.signal.removeEventListener("abort", onAbort);
+            if (cooperativeTimer)
+                clearTimeout(cooperativeTimer);
+            if (forceTimer)
+                clearTimeout(forceTimer);
+            if (child.exitCode === null && child.signalCode === null)
+                signalProcessTree(child, "SIGTERM");
+            await rm(workDirectory, { recursive: true, force: true }).catch(() => undefined);
+        }
+    }
+}
+async function handleRpc(context, request) {
+    if (request.method === "artifacts.put")
+        return context.artifacts.put(request.input);
+    return context.artifacts.get(request.id);
+}
+function forwardLog(context, data) {
+    if (!data || typeof data !== "object" || Array.isArray(data))
+        return;
+    const record = data;
+    const level = typeof record.level === "string" ? record.level : "info";
+    const message = typeof record.message === "string" ? record.message : "Atom log";
+    const fields = record.fields && typeof record.fields === "object" && !Array.isArray(record.fields)
+        ? record.fields
+        : undefined;
+    if (level === "debug")
+        context.logger.debug(message, fields);
+    else if (level === "warn")
+        context.logger.warn(message, fields);
+    else if (level === "error")
+        context.logger.error(message, fields);
+    else
+        context.logger.info(message, fields);
+}
+function safeEnvironment(workDirectory, attemptId, overrides) {
+    const inherited = Object.fromEntries(Object.entries(process.env).filter(([key]) => key !== "NODE_OPTIONS" && key !== "NODE_PATH"));
+    return {
+        ...inherited,
+        ...overrides,
+        ATOM_WORKFLOW_ATTEMPT_ID: attemptId,
+        ATOM_WORKFLOW_TEMP_DIR: workDirectory,
+        TMPDIR: workDirectory,
+        TMP: workDirectory,
+        TEMP: workDirectory,
+    };
+}
+function workerEntryPath() {
+    const current = fileURLToPath(import.meta.url);
+    return join(dirname(current), "../worker/atom-worker-entry.mjs");
+}
+function send(child, message) {
+    if (!child.connected)
+        return;
+    child.send(message, () => undefined);
+}
+function signalProcessTree(child, signal) {
+    if (child.exitCode !== null || child.signalCode !== null)
+        return;
+    try {
+        if (process.platform !== "win32" && child.pid)
+            process.kill(-child.pid, signal);
+        else
+            child.kill(signal);
+    }
+    catch { /* process already exited */ }
+}
+function serializedError(error) {
+    const candidate = error instanceof Error ? error : undefined;
+    return {
+        name: candidate?.name ?? "Error",
+        code: typeof candidate?.code === "string" ? candidate.code : "ATOM_WORKER_SERVICE_FAILED",
+        message: candidate?.message ?? String(error),
+        retryable: candidate?.retryable === true,
+        ...(candidate?.details !== undefined ? { details: JSON.parse(JSON.stringify(candidate.details)) } : {}),
+        ...(candidate?.stack ? { stack: candidate.stack } : {}),
+    };
+}
+function deserializeError(error) {
+    return new AtomWorkflowError(error.code, error.message, error.retryable, {
+        cause: { workerErrorName: error.name, ...(error.details !== undefined ? { details: error.details } : {}), ...(error.stack ? { stack: error.stack } : {}) },
+    });
+}
+//# sourceMappingURL=process-atom-attempt-runner.js.map

package/dist/attempt/process-atom-attempt-runner.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./attempt/atom-attempt-runner.js";
+export * from "./attempt/atom-worker-protocol.js";
+export * from "./attempt/process-atom-attempt-runner.js";
+export * from "./lifecycle/lifecycle-driver.js";
+export * from "./resources/attempt-resource-manager.js";
+export * from "./timeout/timeout.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,0CAA0C,CAAC;AACzD,cAAc,iCAAiC,CAAC;AAChD,cAAc,yCAAyC,CAAC;AACxD,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./attempt/atom-attempt-runner.js";
+export * from "./attempt/atom-worker-protocol.js";
+export * from "./attempt/process-atom-attempt-runner.js";
+export * from "./lifecycle/lifecycle-driver.js";
+export * from "./resources/attempt-resource-manager.js";
+export * from "./timeout/timeout.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,0CAA0C,CAAC;AACzD,cAAc,iCAAiC,CAAC;AAChD,cAAc,yCAAyC,CAAC;AACxD,cAAc,sBAAsB,CAAC"}

package/dist/lifecycle/lifecycle-driver.d.ts

@@ -0,0 +1,68 @@
+import { type AtomHostTaskDeclaration, type AtomLifecycleResult, type AtomResume, type AtomSignalRequest, type AtomSignalResume, type AtomSucceededResult, type HostTaskRequest, type JsonValue } from "@atom-workflow-agent/contracts";
+import { type AtomDefinition, type AtomExecutionContext, type AtomResumeInput } from "@atom-workflow-agent/atom-sdk";
+export type AtomLifecycleTickPhase = "execute" | "resume";
+export type AtomLifecycleTickStatus = "running" | "awaiting_signal" | "awaiting_host" | "succeeded";
+export interface AtomLifecycleTickRecord {
+    readonly schemaVersion: "1.0";
+    readonly attemptId: string;
+    readonly tickIndex: number;
+    readonly phase: AtomLifecycleTickPhase;
+    readonly status: AtomLifecycleTickStatus;
+    readonly checkpoint?: JsonValue;
+    readonly checkpointHash?: string;
+}
+export interface PendingAtomSignal {
+    readonly signalId: string;
+    readonly request: AtomSignalRequest;
+}
+interface SnapshotBase {
+    readonly schemaVersion: "1.0";
+    readonly attemptId: string;
+    readonly checkpoint: JsonValue;
+    readonly ticks: readonly AtomLifecycleTickRecord[];
+}
+export interface RunningAtomAttemptSnapshot extends SnapshotBase {
+    readonly state: "running";
+    readonly nextPollAfterMs?: number;
+}
+export interface AwaitingSignalAtomAttemptSnapshot extends SnapshotBase {
+    readonly state: "awaiting_signal";
+    readonly pendingSignal: PendingAtomSignal;
+}
+export interface AwaitingHostAtomAttemptSnapshot extends SnapshotBase {
+    readonly state: "awaiting_host";
+    readonly hostTask: HostTaskRequest;
+}
+export interface SucceededAtomAttemptSnapshot extends SnapshotBase {
+    readonly state: "succeeded";
+    readonly completion: AtomSucceededResult<JsonValue>;
+}
+export type AtomAttemptLifecycleSnapshot = RunningAtomAttemptSnapshot | AwaitingSignalAtomAttemptSnapshot | AwaitingHostAtomAttemptSnapshot | SucceededAtomAttemptSnapshot;
+export interface AtomLifecycleDriverOptions {
+    readonly maxLifecycleTicks: number;
+    /** Executes one lifecycle tick. Production callers may use a process-backed invoker. */
+    readonly invoker?: AtomLifecycleInvoker;
+    readonly persistTick?: (record: AtomLifecycleTickRecord) => void | Promise<void>;
+    readonly resolveSignal?: (signal: PendingAtomSignal) => AtomSignalResume | Promise<AtomSignalResume>;
+    readonly issueHostTask?: (declaration: AtomHostTaskDeclaration) => HostTaskRequest | Promise<HostTaskRequest>;
+    readonly resolveHost?: (task: HostTaskRequest) => AtomResume | Promise<AtomResume>;
+}
+type RuntimeAtomDefinition = AtomDefinition<unknown, JsonValue>;
+export type AtomLifecycleInvocationResult = {
+    readonly kind: "output";
+    readonly output: unknown;
+} | {
+    readonly kind: "transition";
+    readonly result: AtomLifecycleResult<JsonValue, JsonValue>;
+};
+export interface AtomLifecycleInvoker {
+    execute(definition: RuntimeAtomDefinition, input: unknown, context: AtomExecutionContext): Promise<AtomLifecycleInvocationResult>;
+    resume(definition: RuntimeAtomDefinition, input: unknown, resumeInput: AtomResumeInput, context: AtomExecutionContext): Promise<AtomLifecycleInvocationResult>;
+}
+export declare const inProcessAtomLifecycleInvoker: AtomLifecycleInvoker;
+export declare function hashAtomCheckpoint(value: JsonValue): string;
+export declare function startAtomAttempt(definition: RuntimeAtomDefinition, input: unknown, context: AtomExecutionContext, options: AtomLifecycleDriverOptions): Promise<AtomAttemptLifecycleSnapshot>;
+export declare function continueAtomAttempt(definition: RuntimeAtomDefinition, input: unknown, context: AtomExecutionContext, snapshot: RunningAtomAttemptSnapshot | AwaitingSignalAtomAttemptSnapshot | AwaitingHostAtomAttemptSnapshot, options: AtomLifecycleDriverOptions, resume?: AtomResume): Promise<AtomAttemptLifecycleSnapshot>;
+export declare function driveAtomAttempt(definition: RuntimeAtomDefinition, input: unknown, context: AtomExecutionContext, options: AtomLifecycleDriverOptions): Promise<AtomAttemptLifecycleSnapshot>;
+export {};
+//# sourceMappingURL=lifecycle-driver.d.ts.map

package/dist/lifecycle/lifecycle-driver.d.ts.map

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

package/dist/lifecycle/lifecycle-driver.js

@@ -0,0 +1,141 @@
+import { createHash } from "node:crypto";
+import { AtomWorkflowError, validateAtomHostResume, validateAtomLifecycleResult, validateAtomSignalResume, } from "@atom-workflow-agent/contracts";
+import { isAtomTransition, } from "@atom-workflow-agent/atom-sdk";
+const IN_PROCESS_ATOM_LIFECYCLE_INVOKER = {
+    async execute(definition, input, context) {
+        const raw = await definition.execute(input, context);
+        return isAtomTransition(raw)
+            ? { kind: "transition", result: raw.result }
+            : { kind: "output", output: raw };
+    },
+    async resume(definition, input, resumeInput, context) {
+        if (!definition.resume)
+            fail("ATOM_RESUME_UNAVAILABLE", "Atom cannot continue because resume() is unavailable");
+        const raw = await definition.resume(input, resumeInput, context);
+        return isAtomTransition(raw)
+            ? { kind: "transition", result: raw.result }
+            : { kind: "output", output: raw };
+    },
+};
+export const inProcessAtomLifecycleInvoker = Object.freeze(IN_PROCESS_ATOM_LIFECYCLE_INVOKER);
+function canonicalize(value) {
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    if (value !== null && typeof value === "object")
+        return Object.fromEntries(Object.entries(value).sort(([a], [b]) => a.localeCompare(b)).map(([key, nested]) => [key, canonicalize(nested)]));
+    return value;
+}
+function roundTrip(value) { return JSON.parse(JSON.stringify(value)); }
+export function hashAtomCheckpoint(value) {
+    return `sha256:${createHash("sha256").update(JSON.stringify(canonicalize(value))).digest("hex")}`;
+}
+function fail(code, message, details) {
+    throw new AtomWorkflowError(code, message, false, details === undefined ? undefined : { cause: details });
+}
+function ensureTickBudget(ticks, options) {
+    if (!Number.isInteger(options.maxLifecycleTicks) || options.maxLifecycleTicks < 1)
+        fail("ATOM_LIFECYCLE_POLICY_INVALID", "maxLifecycleTicks must be a positive integer");
+    if (ticks.length >= options.maxLifecycleTicks)
+        fail("ATOM_LIFECYCLE_TICK_BUDGET_EXHAUSTED", `Atom Attempt exhausted ${options.maxLifecycleTicks} lifecycle ticks`);
+}
+async function appendTick(attemptId, ticks, phase, status, checkpoint, options) {
+    const record = Object.freeze({
+        schemaVersion: "1.0", attemptId, tickIndex: ticks.length, phase, status,
+        ...(checkpoint !== undefined ? { checkpoint: roundTrip(checkpoint), checkpointHash: hashAtomCheckpoint(checkpoint) } : {}),
+    });
+    await options.persistTick?.(record);
+    return Object.freeze([...ticks, record]);
+}
+function normalizeResult(invocation) {
+    if (invocation.kind === "transition")
+        return invocation.result;
+    return { schemaVersion: "1.0", status: "succeeded", output: invocation.output, artifacts: [] };
+}
+async function consumeResult(definition, context, previousCheckpoint, ticks, phase, invocation, options) {
+    const attemptId = context.runtime.attemptId;
+    const validation = validateAtomLifecycleResult(definition.manifest, normalizeResult(invocation));
+    if (!validation.success)
+        fail("ATOM_LIFECYCLE_RESULT_INVALID", "Atom returned an invalid output or transition", validation.errors);
+    const result = validation.data;
+    if (result.status === "succeeded") {
+        const nextTicks = await appendTick(attemptId, ticks, phase, "succeeded", undefined, options);
+        return Object.freeze({ schemaVersion: "1.0", attemptId, state: "succeeded", checkpoint: roundTrip(previousCheckpoint), completion: Object.freeze({ ...result, artifacts: Object.freeze([...(result.artifacts ?? [])]) }), ticks: nextTicks });
+    }
+    const checkpoint = roundTrip(result.checkpoint);
+    const nextTicks = await appendTick(attemptId, ticks, phase, result.status, checkpoint, options);
+    if (result.status === "awaiting_host") {
+        if (!definition.resume)
+            fail("ATOM_RESUME_UNAVAILABLE", "Atom returned waitForHost() but does not define resume()");
+        if (!options.issueHostTask)
+            fail("HOST_TASK_ISSUER_REQUIRED", "waitForHost() requires a Runtime HostTask issuer");
+        const hostTask = await options.issueHostTask(result.task);
+        if (hostTask.attemptId !== attemptId || hostTask.workflowRevisionId !== context.runtime.workflowRevisionId || hostTask.nodeId !== context.runtime.nodeId)
+            fail("HOST_TASK_CONTEXT_MISMATCH", "Issued HostTask does not belong to the active Atom Attempt");
+        return Object.freeze({ schemaVersion: "1.0", attemptId, state: "awaiting_host", checkpoint, hostTask, ticks: nextTicks });
+    }
+    if (result.status === "awaiting_signal") {
+        if (!definition.resume)
+            fail("ATOM_RESUME_UNAVAILABLE", "Atom returned waitForSignal() but does not define resume()");
+        return Object.freeze({ schemaVersion: "1.0", attemptId, state: "awaiting_signal", checkpoint, pendingSignal: Object.freeze({ signalId: `${attemptId}:signal:${nextTicks.length - 1}`, request: result.signal }), ticks: nextTicks });
+    }
+    if (!definition.resume)
+        fail("ATOM_RESUME_UNAVAILABLE", "Atom returned continue() but does not define resume()");
+    return Object.freeze({ schemaVersion: "1.0", attemptId, state: "running", checkpoint, ...(result.nextPollAfterMs !== undefined ? { nextPollAfterMs: result.nextPollAfterMs } : {}), ticks: nextTicks });
+}
+export async function startAtomAttempt(definition, input, context, options) {
+    ensureTickBudget([], options);
+    const invoker = options.invoker ?? inProcessAtomLifecycleInvoker;
+    return consumeResult(definition, context, null, Object.freeze([]), "execute", await invoker.execute(definition, input, context), options);
+}
+export async function continueAtomAttempt(definition, input, context, snapshot, options, resume) {
+    if (snapshot.attemptId !== context.runtime.attemptId)
+        fail("ATOM_ATTEMPT_ID_MISMATCH", "Snapshot belongs to another Attempt");
+    if (!definition.resume)
+        fail("ATOM_RESUME_UNAVAILABLE", "Atom cannot continue because resume() is unavailable");
+    let resumeInput;
+    if (snapshot.state === "awaiting_signal") {
+        if (!resume || resume.kind !== "signal")
+            fail("ATOM_SIGNAL_RESUME_REQUIRED", "An awaiting Atom requires a Signal resume payload");
+        if (resume.signalId !== snapshot.pendingSignal.signalId)
+            fail("ATOM_SIGNAL_ID_MISMATCH", "Signal resume was issued for another pending Signal");
+        const validation = validateAtomSignalResume(snapshot.pendingSignal.request, resume);
+        if (!validation.success)
+            fail("ATOM_SIGNAL_RESUME_INVALID", "Signal resume failed validation", validation.errors);
+        resumeInput = { type: "signal", value: validation.data.response, checkpoint: snapshot.checkpoint };
+    }
+    else if (snapshot.state === "awaiting_host") {
+        if (!resume || resume.kind !== "host")
+            fail("ATOM_HOST_RESUME_REQUIRED", "An awaiting Atom requires a HostTask result");
+        const validation = validateAtomHostResume(definition.manifest, snapshot.hostTask.hostTaskId, snapshot.hostTask.continuation.token, resume, snapshot.hostTask.expected.outputSchema);
+        if (!validation.success)
+            fail("ATOM_HOST_RESUME_INVALID", "HostTask result failed validation", validation.errors);
+        resumeInput = { type: "host", value: validation.data.result.output, artifacts: validation.data.result.artifacts, summary: validation.data.result.summary, checkpoint: snapshot.checkpoint };
+    }
+    else {
+        if (resume)
+            fail("ATOM_RESUME_UNEXPECTED", "A running Atom Attempt cannot consume an external resume payload");
+        resumeInput = { type: "timer", checkpoint: snapshot.checkpoint };
+    }
+    ensureTickBudget(snapshot.ticks, options);
+    const invoker = options.invoker ?? inProcessAtomLifecycleInvoker;
+    return consumeResult(definition, context, snapshot.checkpoint, snapshot.ticks, "resume", await invoker.resume(definition, input, resumeInput, context), options);
+}
+export async function driveAtomAttempt(definition, input, context, options) {
+    let snapshot = await startAtomAttempt(definition, input, context, options);
+    while (snapshot.state !== "succeeded") {
+        if (snapshot.state === "awaiting_signal") {
+            if (!options.resolveSignal)
+                return snapshot;
+            snapshot = await continueAtomAttempt(definition, input, context, snapshot, options, await options.resolveSignal(snapshot.pendingSignal));
+        }
+        else if (snapshot.state === "awaiting_host") {
+            if (!options.resolveHost)
+                return snapshot;
+            snapshot = await continueAtomAttempt(definition, input, context, snapshot, options, await options.resolveHost(snapshot.hostTask));
+        }
+        else
+            snapshot = await continueAtomAttempt(definition, input, context, snapshot, options);
+    }
+    return snapshot;
+}
+//# sourceMappingURL=lifecycle-driver.js.map

package/dist/lifecycle/lifecycle-driver.js.map

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

package/dist/resources/attempt-resource-manager.d.ts

@@ -0,0 +1,12 @@
+import type { ManagedAtomResource, AttemptResourceManager } from "@atom-workflow-agent/atom-sdk";
+export declare class ManagedAttemptResources implements AttemptResourceManager {
+    private readonly onRegister?;
+    private readonly onRelease?;
+    readonly scope: "attempt";
+    private readonly resources;
+    private disposed;
+    constructor(onRegister?: ((resource: ManagedAtomResource) => void) | undefined, onRelease?: ((resource: ManagedAtomResource) => void) | undefined);
+    register(resource: ManagedAtomResource): void;
+    disposeAll(reason: Parameters<AttemptResourceManager["disposeAll"]>[0]): Promise<void>;
+}
+//# sourceMappingURL=attempt-resource-manager.d.ts.map

package/dist/resources/attempt-resource-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt-resource-manager.d.ts","sourceRoot":"","sources":["../../src/resources/attempt-resource-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEjG,qBAAa,uBAAwB,YAAW,sBAAsB;IAMlE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAN7B,QAAQ,CAAC,KAAK,EAAG,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IACpE,OAAO,CAAC,QAAQ,CAAS;gBAGN,UAAU,CAAC,GAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,aAAA,EACpD,SAAS,CAAC,GAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,aAAA;IAGtE,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAOvC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAW7F"}

package/dist/resources/attempt-resource-manager.js

@@ -0,0 +1,33 @@
+export class ManagedAttemptResources {
+    onRegister;
+    onRelease;
+    scope = "attempt";
+    resources = new Map();
+    disposed = false;
+    constructor(onRegister, onRelease) {
+        this.onRegister = onRegister;
+        this.onRelease = onRelease;
+    }
+    register(resource) {
+        if (this.disposed)
+            throw new Error("Attempt resources are already disposed");
+        if (this.resources.has(resource.id))
+            throw new Error(`Duplicate Attempt resource: ${resource.id}`);
+        this.resources.set(resource.id, resource);
+        this.onRegister?.(resource);
+    }
+    async disposeAll(reason) {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        const resources = [...this.resources.values()].reverse();
+        const results = await Promise.allSettled(resources.map((resource) => resource.dispose(reason)));
+        for (const resource of resources)
+            this.onRelease?.(resource);
+        const failures = results.filter((result) => result.status === "rejected");
+        if (failures.length > 0) {
+            throw new AggregateError(failures.map((failure) => failure.reason), "Attempt resource cleanup failed");
+        }
+    }
+}
+//# sourceMappingURL=attempt-resource-manager.js.map

package/dist/resources/attempt-resource-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt-resource-manager.js","sourceRoot":"","sources":["../../src/resources/attempt-resource-manager.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,uBAAuB;IAMf;IACA;IANV,KAAK,GAAG,SAAkB,CAAC;IACnB,SAAS,GAAG,IAAI,GAAG,EAA+B,CAAC;IAC5D,QAAQ,GAAG,KAAK,CAAC;IAEzB,YACmB,UAAoD,EACpD,SAAmD;QADnD,eAAU,GAAV,UAAU,CAA0C;QACpD,cAAS,GAAT,SAAS,CAA0C;IACnE,CAAC;IAEJ,QAAQ,CAAC,QAA6B;QACpC,IAAI,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC7E,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QACnG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAA2D;QAC1E,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QACzD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAChG,KAAK,MAAM,QAAQ,IAAI,SAAS;YAAE,IAAI,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,CAAC;QAC7D,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAmC,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;QAC3G,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,iCAAiC,CAAC,CAAC;QACzG,CAAC;IACH,CAAC;CACF"}

package/dist/timeout/timeout.d.ts

@@ -0,0 +1,2 @@
+export declare function withTimeout<T>(operation: (signal: AbortSignal) => Promise<T>, timeoutMs: number | null, parentSignal?: AbortSignal): Promise<T>;
+//# sourceMappingURL=timeout.d.ts.map

package/dist/timeout/timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.d.ts","sourceRoot":"","sources":["../../src/timeout/timeout.ts"],"names":[],"mappings":"AAEA,wBAAsB,WAAW,CAAC,CAAC,EACjC,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9C,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,YAAY,CAAC,EAAE,WAAW,GACzB,OAAO,CAAC,CAAC,CAAC,CAkCZ"}

package/dist/timeout/timeout.js

@@ -0,0 +1,39 @@
+import { AtomWorkflowError } from "@atom-workflow-agent/contracts";
+export async function withTimeout(operation, timeoutMs, parentSignal) {
+    if (parentSignal?.aborted) {
+        const reason = parentSignal.reason;
+        throw reason instanceof AtomWorkflowError
+            ? reason
+            : new AtomWorkflowError("CANCELLED", "Operation cancelled", false, reason instanceof Error ? { cause: reason } : undefined);
+    }
+    const controller = new AbortController();
+    const onParentAbort = () => {
+        const reason = parentSignal?.reason;
+        controller.abort(reason instanceof AtomWorkflowError ? reason : new AtomWorkflowError("CANCELLED", "Operation cancelled", false, reason instanceof Error ? { cause: reason } : undefined));
+    };
+    parentSignal?.addEventListener("abort", onParentAbort, { once: true });
+    const timer = timeoutMs === null
+        ? undefined
+        : setTimeout(() => controller.abort(new AtomWorkflowError("TIMEOUT", `Timed out after ${timeoutMs}ms`, true)), timeoutMs);
+    try {
+        const aborted = new Promise((_, reject) => {
+            const rejectFromAbort = () => {
+                const reason = controller.signal.reason;
+                reject(reason instanceof Error ? reason : new AtomWorkflowError("CANCELLED", "Operation cancelled"));
+            };
+            controller.signal.addEventListener("abort", rejectFromAbort, { once: true });
+            if (controller.signal.aborted)
+                rejectFromAbort();
+        });
+        return await Promise.race([
+            operation(controller.signal),
+            aborted,
+        ]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+        parentSignal?.removeEventListener("abort", onParentAbort);
+    }
+}
+//# sourceMappingURL=timeout.js.map