@atom-workflow-agent/workflow-engine 0.1.0

package/dist/store/local-execution-run-store.js

@@ -0,0 +1,143 @@
+import { appendFile, mkdir, readdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { cloneSnapshot } from "./runtime-snapshot.js";
+import { runStoragePaths } from "./execution-run-storage-layout.js";
+import { LocalWorkflowStore } from "./local-workflow-store.js";
+const TERMINAL = new Set(["succeeded", "failed", "cancelled", "unknown_outcome"]);
+async function writeAtomic(path, content) {
+    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+    const temporary = `${path}.${process.pid}.${Date.now()}.tmp`;
+    await writeFile(temporary, content, { encoding: "utf8", mode: 0o600 });
+    await rename(temporary, path);
+}
+const writeJson = (path, value) => writeAtomic(path, `${JSON.stringify(value, null, 2)}\n`);
+async function readEvents(path) {
+    try {
+        return (await readFile(path, "utf8")).split("\n").filter(Boolean).map((line) => JSON.parse(line));
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+}
+function summary(snapshot) {
+    const active = new Set(["ready", "running", "retry_wait", "awaiting_signal", "awaiting_host"]);
+    return {
+        schemaVersion: "2.0", runId: snapshot.run.runId, goal: snapshot.run.goal, status: snapshot.run.status,
+        ...(snapshot.run.planId ? { planId: snapshot.run.planId } : {}),
+        workflowRevisionId: snapshot.revision.workflowRevisionId,
+        workflow: { name: snapshot.revision.workflowSpec.name, nodeCount: snapshot.ir.nodes.length, irHash: snapshot.ir.hash },
+        currentNodes: snapshot.nodeRuns.filter((node) => active.has(node.status)).map((node) => ({ nodeId: node.nodeId, activationId: node.activationId, status: node.status })),
+        pending: { signals: snapshot.signals.filter((signal) => signal.status === "waiting").length, hostTasks: snapshot.hostTasks.filter((task) => task.status === "waiting").length },
+        artifactCount: snapshot.artifacts.length,
+        ...(snapshot.run.outputs ? { outputs: snapshot.run.outputs } : {}), ...(snapshot.run.error ? { error: snapshot.run.error } : {}),
+        createdAt: snapshot.run.createdAt, ...(snapshot.run.startedAt ? { startedAt: snapshot.run.startedAt } : {}), updatedAt: snapshot.run.updatedAt,
+        ...(snapshot.run.endedAt ? { endedAt: snapshot.run.endedAt } : {}),
+    };
+}
+/** Execution-only Store. Planning and immutable Workflow definitions live in independent stores. */
+export class LocalRunStore {
+    rootDirectory;
+    workflows;
+    locks = new Map();
+    constructor(rootDirectory, workflows = new LocalWorkflowStore(rootDirectory)) {
+        this.rootDirectory = rootDirectory;
+        this.workflows = workflows;
+    }
+    async create(snapshot) { if (await this.tryLoad(snapshot.run.runId))
+        throw new Error(`Run already exists: ${snapshot.run.runId}`); await this.save(snapshot); }
+    async load(runId) { const value = await this.tryLoad(runId); if (!value)
+        throw new Error(`Run not found: ${runId}`); return value; }
+    async tryLoad(runId) {
+        try {
+            const document = JSON.parse(await readFile(runStoragePaths(this.rootDirectory, runId).checkpoint, "utf8"));
+            const workflow = await this.workflows.loadRevision(document.workflowRevisionId);
+            const { storageVersion: _storageVersion, workflowRevisionId: _revisionId, ...checkpoint } = document;
+            return { ...checkpoint, resumeDeliveries: checkpoint.resumeDeliveries ?? [], revision: workflow.revision, ir: workflow.ir, events: [] };
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return undefined;
+            throw error;
+        }
+    }
+    async save(snapshot) { await this.exclusive(snapshot.run.runId, async () => this.write(snapshot)); }
+    async update(runId, updater) {
+        let committed;
+        await this.exclusive(runId, async () => { committed = cloneSnapshot(await updater(cloneSnapshot(await this.load(runId)))); await this.write(committed); });
+        return committed;
+    }
+    async list() {
+        try {
+            const entries = await readdir(join(this.rootDirectory, "runs"), { withFileTypes: true });
+            const values = await Promise.all(entries.filter((entry) => entry.isDirectory()).map((entry) => this.tryLoad(entry.name).catch(() => undefined)));
+            return values.filter((item) => item !== undefined).sort((a, b) => a.run.createdAt.localeCompare(b.run.createdAt));
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return [];
+            throw error;
+        }
+    }
+    async listSummaries() {
+        try {
+            const entries = await readdir(join(this.rootDirectory, "runs"), { withFileTypes: true });
+            const values = await Promise.all(entries.filter((entry) => entry.isDirectory()).map(async (entry) => {
+                try {
+                    return JSON.parse(await readFile(join(this.rootDirectory, "runs", entry.name, "summary.json"), "utf8"));
+                }
+                catch {
+                    return undefined;
+                }
+            }));
+            return values.filter((item) => item !== undefined).sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return [];
+            throw error;
+        }
+    }
+    async listNonTerminal() { return (await this.list()).filter((snapshot) => !TERMINAL.has(snapshot.run.status)); }
+    async loadSummary(runId) { try {
+        return JSON.parse(await readFile(runStoragePaths(this.rootDirectory, runId).summary, "utf8"));
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return undefined;
+        throw error;
+    } }
+    async loadTimeline(runId) { return readEvents(runStoragePaths(this.rootDirectory, runId).events); }
+    async write(snapshot) {
+        const paths = runStoragePaths(this.rootDirectory, snapshot.run.runId);
+        const existing = await readEvents(paths.events);
+        const lastSequence = existing.at(-1)?.sequence ?? -1;
+        const added = snapshot.events.filter((event) => event.sequence > lastSequence).sort((a, b) => a.sequence - b.sequence);
+        if (added.length) {
+            await mkdir(dirname(paths.events), { recursive: true, mode: 0o700 });
+            await appendFile(paths.events, `${added.map((event) => JSON.stringify(event)).join("\n")}\n`, { encoding: "utf8", mode: 0o600 });
+        }
+        const { revision: _revision, ir: _ir, events: _events, ...rest } = snapshot;
+        const checkpoint = { ...rest, storageVersion: "2.0", workflowRevisionId: snapshot.revision.workflowRevisionId };
+        await writeJson(paths.checkpoint, checkpoint);
+        await writeJson(paths.summary, summary(snapshot));
+    }
+    async exclusive(runId, operation) {
+        const previous = this.locks.get(runId) ?? Promise.resolve();
+        let release;
+        const current = new Promise((resolve) => { release = resolve; });
+        const chained = previous.then(() => current);
+        this.locks.set(runId, chained);
+        await previous;
+        try {
+            await operation();
+        }
+        finally {
+            release();
+            if (this.locks.get(runId) === chained)
+                this.locks.delete(runId);
+        }
+    }
+}
+//# sourceMappingURL=local-execution-run-store.js.map

package/dist/store/local-execution-run-store.js.map

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

package/dist/store/local-workflow-store.d.ts

@@ -0,0 +1,22 @@
+import { type WorkflowDefinition, type WorkflowIR, type WorkflowRevision } from "@atom-workflow-agent/contracts";
+export interface StoredWorkflowRevision {
+    readonly schemaVersion: "1.0";
+    readonly revision: WorkflowRevision;
+    readonly ir: WorkflowIR;
+}
+export declare class LocalWorkflowStore {
+    readonly rootDirectory: string;
+    private readonly locks;
+    constructor(rootDirectory: string);
+    save(document: StoredWorkflowRevision): Promise<WorkflowDefinition>;
+    loadRevision(workflowRevisionId: string): Promise<StoredWorkflowRevision>;
+    inspect(workflowId: string): Promise<{
+        readonly definition: WorkflowDefinition;
+        readonly revisions: readonly WorkflowRevision[];
+    }>;
+    list(): Promise<readonly WorkflowDefinition[]>;
+    /** Resolve a user-facing name, Workflow id, exact Revision id, or name@revision. */
+    resolve(reference: string): Promise<StoredWorkflowRevision>;
+    private exclusive;
+}
+//# sourceMappingURL=local-workflow-store.d.ts.map

package/dist/store/local-workflow-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-workflow-store.d.ts","sourceRoot":"","sources":["../../src/store/local-workflow-store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuE,KAAK,kBAAkB,EAAE,KAAK,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGtL,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;CACzB;AAiBD,qBAAa,kBAAkB;IAEjB,QAAQ,CAAC,aAAa,EAAE,MAAM;IAD1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;gBACrC,aAAa,EAAE,MAAM;IAEpC,IAAI,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6BnE,YAAY,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAezE,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAA;KAAE,CAAC;IAYlI,IAAI,IAAI,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC;IAWpD,oFAAoF;IAC9E,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;YAcnD,SAAS;CAUxB"}

package/dist/store/local-workflow-store.js

@@ -0,0 +1,145 @@
+import { mkdir, readdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { AtomWorkflowError, WorkflowDefinitionSchema, WorkflowRevisionSchema } from "@atom-workflow-agent/contracts";
+import { workflowStoragePaths } from "./workflow-storage-layout.js";
+async function writeJson(path, value) {
+    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+    const temporary = `${path}.${process.pid}.${Date.now()}.tmp`;
+    await writeFile(temporary, `${JSON.stringify(value, null, 2)}\n`, { encoding: "utf8", mode: 0o600 });
+    await rename(temporary, path);
+}
+function deepFreeze(value) {
+    if (value !== null && typeof value === "object" && !Object.isFrozen(value)) {
+        Object.freeze(value);
+        for (const nested of Object.values(value))
+            deepFreeze(nested);
+    }
+    return value;
+}
+export class LocalWorkflowStore {
+    rootDirectory;
+    locks = new Map();
+    constructor(rootDirectory) {
+        this.rootDirectory = rootDirectory;
+    }
+    async save(document) {
+        const revision = WorkflowRevisionSchema.parse(document.revision);
+        if (revision.workflowIrHash !== document.ir.hash)
+            throw new AtomWorkflowError("WORKFLOW_REVISION_IR_HASH_MISMATCH", "WorkflowRevision does not match its frozen IR");
+        return this.exclusive(revision.workflowId, async () => {
+            const paths = workflowStoragePaths(this.rootDirectory, revision.workflowId, revision.workflowRevisionId);
+            let definition;
+            try {
+                definition = WorkflowDefinitionSchema.parse(JSON.parse(await readFile(paths.definition, "utf8")));
+            }
+            catch (error) {
+                if (error.code !== "ENOENT")
+                    throw error;
+            }
+            if (definition?.revisionIds.includes(revision.workflowRevisionId)) {
+                const existing = await this.loadRevision(revision.workflowRevisionId);
+                if (existing.revision.workflowSpecHash !== revision.workflowSpecHash)
+                    throw new AtomWorkflowError("WORKFLOW_REVISION_CONFLICT", `Revision already exists with different content: ${revision.workflowRevisionId}`);
+                return definition;
+            }
+            const now = revision.createdAt;
+            const next = WorkflowDefinitionSchema.parse({
+                schemaVersion: "1.0",
+                workflowId: revision.workflowId,
+                name: revision.workflowSpec.name,
+                latestRevisionId: revision.workflowRevisionId,
+                revisionIds: [...(definition?.revisionIds ?? []), revision.workflowRevisionId],
+                createdAt: definition?.createdAt ?? now,
+                updatedAt: now,
+            });
+            await writeJson(paths.revision, { schemaVersion: "1.0", revision, ir: document.ir });
+            await writeJson(paths.definition, next);
+            return next;
+        });
+    }
+    async loadRevision(workflowRevisionId) {
+        const marker = ":revision:";
+        const index = workflowRevisionId.lastIndexOf(marker);
+        if (index < 1)
+            throw new AtomWorkflowError("WORKFLOW_REVISION_ID_INVALID", `Invalid Workflow Revision id: ${workflowRevisionId}`);
+        const workflowId = workflowRevisionId.slice(0, index);
+        const path = workflowStoragePaths(this.rootDirectory, workflowId, workflowRevisionId).revision;
+        try {
+            const document = JSON.parse(await readFile(path, "utf8"));
+            return { schemaVersion: "1.0", revision: WorkflowRevisionSchema.parse(document.revision), ir: deepFreeze(document.ir) };
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                throw new AtomWorkflowError("WORKFLOW_REVISION_NOT_FOUND", `Workflow Revision not found: ${workflowRevisionId}`);
+            throw error;
+        }
+    }
+    async inspect(workflowId) {
+        const paths = workflowStoragePaths(this.rootDirectory, workflowId);
+        try {
+            const definition = WorkflowDefinitionSchema.parse(JSON.parse(await readFile(paths.definition, "utf8")));
+            const revisions = await Promise.all(definition.revisionIds.map(async (id) => (await this.loadRevision(id)).revision));
+            return { definition, revisions };
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                throw new AtomWorkflowError("WORKFLOW_NOT_FOUND", `Workflow not found: ${workflowId}`);
+            throw error;
+        }
+    }
+    async list() {
+        try {
+            const entries = await readdir(join(this.rootDirectory, "workflows"), { withFileTypes: true });
+            const definitions = await Promise.all(entries.filter((entry) => entry.isDirectory()).map(async (entry) => {
+                try {
+                    return WorkflowDefinitionSchema.parse(JSON.parse(await readFile(join(this.rootDirectory, "workflows", entry.name, "definition.json"), "utf8")));
+                }
+                catch {
+                    return undefined;
+                }
+            }));
+            return definitions.filter((item) => item !== undefined).sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return [];
+            throw error;
+        }
+    }
+    /** Resolve a user-facing name, Workflow id, exact Revision id, or name@revision. */
+    async resolve(reference) {
+        if (reference.includes(":revision:"))
+            return this.loadRevision(reference);
+        const revisionMatch = /^(.*)@(\d+)$/.exec(reference);
+        const identity = revisionMatch?.[1] ?? reference;
+        const definitions = (await this.list()).filter((item) => item.workflowId === identity || item.name === identity);
+        if (definitions.length === 0)
+            throw new AtomWorkflowError("WORKFLOW_NOT_FOUND", `Workflow not found: ${identity}`);
+        if (definitions.length > 1)
+            throw new AtomWorkflowError("WORKFLOW_REFERENCE_AMBIGUOUS", `Workflow reference matches multiple definitions: ${identity}`);
+        const definition = definitions[0];
+        if (!revisionMatch)
+            return this.loadRevision(definition.latestRevisionId);
+        const revisionId = `${definition.workflowId}:revision:${Number(revisionMatch[2])}`;
+        if (!definition.revisionIds.includes(revisionId))
+            throw new AtomWorkflowError("WORKFLOW_REVISION_NOT_FOUND", `Workflow Revision not found: ${reference}`);
+        return this.loadRevision(revisionId);
+    }
+    async exclusive(workflowId, operation) {
+        const previous = this.locks.get(workflowId) ?? Promise.resolve();
+        let release;
+        const current = new Promise((resolve) => { release = resolve; });
+        const chained = previous.then(() => current);
+        this.locks.set(workflowId, chained);
+        await previous;
+        try {
+            return await operation();
+        }
+        finally {
+            release();
+            if (this.locks.get(workflowId) === chained)
+                this.locks.delete(workflowId);
+        }
+    }
+}
+//# sourceMappingURL=local-workflow-store.js.map

package/dist/store/local-workflow-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-workflow-store.js","sourceRoot":"","sources":["../../src/store/local-workflow-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,sBAAsB,EAAmE,MAAM,gCAAgC,CAAC;AACtL,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAQpE,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,KAAc;IACnD,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC;IAC7D,MAAM,SAAS,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACrG,MAAM,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,UAAU,CAAI,KAAQ;IAC7B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3E,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrB,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,KAAgC,CAAC;YAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,OAAO,kBAAkB;IAER;IADJ,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC1D,YAAqB,aAAqB;QAArB,kBAAa,GAAb,aAAa,CAAQ;IAAG,CAAC;IAE9C,KAAK,CAAC,IAAI,CAAC,QAAgC;QACzC,MAAM,QAAQ,GAAG,sBAAsB,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACjE,IAAI,QAAQ,CAAC,cAAc,KAAK,QAAQ,CAAC,EAAE,CAAC,IAAI;YAAE,MAAM,IAAI,iBAAiB,CAAC,oCAAoC,EAAE,+CAA+C,CAAC,CAAC;QACrK,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE;YACpD,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;YACzG,IAAI,UAA0C,CAAC;YAC/C,IAAI,CAAC;gBAAC,UAAU,GAAG,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;YAAC,CAAC;YAC1G,OAAO,KAAK,EAAE,CAAC;gBAAC,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;oBAAE,MAAM,KAAK,CAAC;YAAC,CAAC;YACtF,IAAI,UAAU,EAAE,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBAClE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;gBACtE,IAAI,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,KAAK,QAAQ,CAAC,gBAAgB;oBAAE,MAAM,IAAI,iBAAiB,CAAC,4BAA4B,EAAE,mDAAmD,QAAQ,CAAC,kBAAkB,EAAE,CAAC,CAAC;gBAClN,OAAO,UAAU,CAAC;YACpB,CAAC;YACD,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC;YAC/B,MAAM,IAAI,GAAG,wBAAwB,CAAC,KAAK,CAAC;gBAC1C,aAAa,EAAE,KAAK;gBACpB,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,IAAI;gBAChC,gBAAgB,EAAE,QAAQ,CAAC,kBAAkB;gBAC7C,WAAW,EAAE,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC;gBAC9E,SAAS,EAAE,UAAU,EAAE,SAAS,IAAI,GAAG;gBACvC,SAAS,EAAE,GAAG;aACf,CAAC,CAAC;YACH,MAAM,SAAS,CAAC,KAAK,CAAC,QAAS,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAmC,CAAC,CAAC;YACvH,MAAM,SAAS,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YACxC,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,kBAA0B;QAC3C,MAAM,MAAM,GAAG,YAAY,CAAC;QAC5B,MAAM,KAAK,GAAG,kBAAkB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACrD,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM,IAAI,iBAAiB,CAAC,8BAA8B,EAAE,iCAAiC,kBAAkB,EAAE,CAAC,CAAC;QAClI,MAAM,UAAU,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,EAAE,kBAAkB,CAAC,CAAC,QAAS,CAAC;QAChG,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAA2B,CAAC;YACpF,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,sBAAsB,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1H,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,IAAI,iBAAiB,CAAC,6BAA6B,EAAE,gCAAgC,kBAAkB,EAAE,CAAC,CAAC;YACzK,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAkB;QAC9B,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QACnE,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;YACxG,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;YACtH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,IAAI,iBAAiB,CAAC,oBAAoB,EAAE,uBAAuB,UAAU,EAAE,CAAC,CAAC;YAC/I,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9F,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gBACvG,IAAI,CAAC;oBAAC,OAAO,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;gBAAC,CAAC;gBACxJ,MAAM,CAAC;oBAAC,OAAO,SAAS,CAAC;gBAAC,CAAC;YAC7B,CAAC,CAAC,CAAC,CAAC;YACJ,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAA8B,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7I,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,EAAE,CAAC;YAAC,MAAM,KAAK,CAAC;QAAC,CAAC;IACrG,CAAC;IAED,oFAAoF;IACpF,KAAK,CAAC,OAAO,CAAC,SAAiB;QAC7B,IAAI,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC;YAAE,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1E,MAAM,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;QACjD,MAAM,WAAW,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QACjH,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,iBAAiB,CAAC,oBAAoB,EAAE,uBAAuB,QAAQ,EAAE,CAAC,CAAC;QACnH,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,iBAAiB,CAAC,8BAA8B,EAAE,oDAAoD,QAAQ,EAAE,CAAC,CAAC;QACxJ,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAE,CAAC;QACnC,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;QAC1E,MAAM,UAAU,GAAG,GAAG,UAAU,CAAC,UAAU,aAAa,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnF,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC;YAAE,MAAM,IAAI,iBAAiB,CAAC,6BAA6B,EAAE,gCAAgC,SAAS,EAAE,CAAC,CAAC;QAC1J,OAAO,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAEO,KAAK,CAAC,SAAS,CAAI,UAAkB,EAAE,SAA2B;QACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACjE,IAAI,OAAoB,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACpC,MAAM,QAAQ,CAAC;QACf,IAAI,CAAC;YAAC,OAAO,MAAM,SAAS,EAAE,CAAC;QAAC,CAAC;gBACzB,CAAC;YAAC,OAAO,EAAE,CAAC;YAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,OAAO;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAAC,CAAC;IACnG,CAAC;CACF"}

package/dist/store/runtime-snapshot.d.ts

@@ -0,0 +1,56 @@
+import type { ArtifactRecord, HostTaskRecord, JsonValue, ResourceLeaseRecord, ResumeDeliveryRecord, RuntimeEvent, SignalRecord, WorkflowAttempt, WorkflowIR, WorkflowNodeRunRecord, WorkflowRevision, WorkflowRun } from "@atom-workflow-agent/contracts";
+export interface PendingEdgeActivation {
+    readonly edgeId: string;
+    readonly targetNodeId: string;
+    readonly overlay: Readonly<Record<string, JsonValue>>;
+    readonly mapRunId?: string;
+    readonly mapItem?: JsonValue;
+    readonly mapIndex?: number;
+    readonly controlLineage: readonly string[];
+}
+export interface DecisionRecord {
+    readonly activationId: string;
+    readonly nodeId: string;
+    readonly selectedBranch: string;
+    readonly matched: boolean;
+    readonly edgeId: string;
+    readonly selectedAt: string;
+}
+export interface MapRunRecord {
+    readonly mapRunId: string;
+    readonly mapNodeId: string;
+    readonly activationId: string;
+    readonly status: "running" | "succeeded" | "failed";
+    readonly items: readonly JsonValue[];
+    readonly nextIndex: number;
+    readonly activeIndices: readonly number[];
+    readonly completedIndices: readonly number[];
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly endedAt?: string;
+}
+/** One atomically persisted scheduler checkpoint. */
+export interface RuntimeSnapshot {
+    readonly schemaVersion: "1.0";
+    readonly run: WorkflowRun;
+    readonly revision: WorkflowRevision;
+    readonly ir: WorkflowIR;
+    readonly nodeRuns: readonly WorkflowNodeRunRecord[];
+    readonly attempts: readonly WorkflowAttempt[];
+    readonly artifacts: readonly ArtifactRecord[];
+    readonly signals: readonly SignalRecord[];
+    readonly hostTasks: readonly HostTaskRecord[];
+    readonly resumeDeliveries: readonly ResumeDeliveryRecord[];
+    readonly resourceLeases: readonly ResourceLeaseRecord[];
+    readonly events: readonly RuntimeEvent[];
+    /** Monotonic sequence. events contains only the not-yet-flushed batch. */
+    readonly eventSequence: number;
+    readonly transitionCount: number;
+    readonly edgeTraversals: Readonly<Record<string, number>>;
+    readonly activationCounts: Readonly<Record<string, number>>;
+    readonly pendingEdges: readonly PendingEdgeActivation[];
+    readonly decisions: readonly DecisionRecord[];
+    readonly mapRuns: readonly MapRunRecord[];
+}
+export declare function cloneSnapshot(snapshot: RuntimeSnapshot): RuntimeSnapshot;
+//# sourceMappingURL=runtime-snapshot.d.ts.map

package/dist/store/runtime-snapshot.d.ts.map

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

package/dist/store/runtime-snapshot.js

@@ -0,0 +1,4 @@
+export function cloneSnapshot(snapshot) {
+    return JSON.parse(JSON.stringify(snapshot));
+}
+//# sourceMappingURL=runtime-snapshot.js.map

package/dist/store/runtime-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-snapshot.js","sourceRoot":"","sources":["../../src/store/runtime-snapshot.ts"],"names":[],"mappings":"AAsEA,MAAM,UAAU,aAAa,CAAC,QAAyB;IACrD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAoB,CAAC;AACjE,CAAC"}

package/dist/store/workflow-storage-layout.d.ts

@@ -0,0 +1,7 @@
+export declare function workflowStoragePaths(root: string, workflowId: string, revisionId?: string): {
+    revision?: string;
+    directory: string;
+    definition: string;
+    revisions: string;
+};
+//# sourceMappingURL=workflow-storage-layout.d.ts.map

package/dist/store/workflow-storage-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-storage-layout.d.ts","sourceRoot":"","sources":["../../src/store/workflow-storage-layout.ts"],"names":[],"mappings":"AASA,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;;;;;EAQzF"}

package/dist/store/workflow-storage-layout.js

@@ -0,0 +1,18 @@
+import { createHash } from "node:crypto";
+import { join } from "node:path";
+function safe(value) {
+    const normalized = value.normalize("NFKD").replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 120);
+    if (!normalized || normalized === "." || normalized === "..")
+        return createHash("sha256").update(value).digest("hex").slice(0, 16);
+    return normalized === value ? normalized : `${normalized}--${createHash("sha256").update(value).digest("hex").slice(0, 12)}`;
+}
+export function workflowStoragePaths(root, workflowId, revisionId) {
+    const directory = join(root, "workflows", safe(workflowId));
+    return {
+        directory,
+        definition: join(directory, "definition.json"),
+        revisions: join(directory, "revisions"),
+        ...(revisionId ? { revision: join(directory, "revisions", `${safe(revisionId)}.json`) } : {}),
+    };
+}
+//# sourceMappingURL=workflow-storage-layout.js.map

package/dist/store/workflow-storage-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-storage-layout.js","sourceRoot":"","sources":["../../src/store/workflow-storage-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,SAAS,IAAI,CAAC,KAAa;IACzB,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACnH,IAAI,CAAC,UAAU,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnI,OAAO,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,KAAK,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAC/H,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,UAAkB,EAAE,UAAmB;IACxF,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAC5D,OAAO;QACL,SAAS;QACT,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC;QAC9C,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC;QACvC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9F,CAAC;AACJ,CAAC"}

package/dist/topology/workflow-topology.d.ts

@@ -0,0 +1,4 @@
+import type { WorkflowIR, WorkflowRevision, WorkflowTopologyView } from "@atom-workflow-agent/contracts";
+export declare function projectWorkflowTopology(revision: WorkflowRevision, ir: WorkflowIR): WorkflowTopologyView;
+export declare function renderWorkflowTopology(view: WorkflowTopologyView): string;
+//# sourceMappingURL=workflow-topology.d.ts.map

package/dist/topology/workflow-topology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-topology.d.ts","sourceRoot":"","sources":["../../src/topology/workflow-topology.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,UAAU,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAoBpH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,EAAE,EAAE,UAAU,GAAG,oBAAoB,CAmCxG;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAUzE"}

package/dist/topology/workflow-topology.js

@@ -0,0 +1,76 @@
+function collectReferences(value, path, found) {
+    if (Array.isArray(value))
+        return value.forEach((item, index) => collectReferences(item, `${path}[${index}]`, found));
+    if (value === null || typeof value !== "object")
+        return;
+    if (Object.keys(value).length === 1 && typeof value.$ref === "string") {
+        found.push({ path, reference: value.$ref });
+        return;
+    }
+    for (const [key, item] of Object.entries(value))
+        collectReferences(item, `${path}.${key}`, found);
+}
+function sourceOf(reference) {
+    if (reference.startsWith("workflow.inputs"))
+        return "$workflow";
+    if (reference.startsWith("map.item") || reference === "map.index")
+        return "$map";
+    const dependency = /^dependencies\.([a-z][a-z0-9-]*)\./.exec(reference);
+    const historical = /^nodes\.([a-z][a-z0-9-]*)\./.exec(reference);
+    return dependency?.[1] ?? historical?.[1] ?? "$runtime";
+}
+export function projectWorkflowTopology(revision, ir) {
+    const dataEdges = [];
+    for (const node of ir.nodes) {
+        const references = [];
+        if (node.kind === "atom") {
+            collectReferences(node.input, "$.input", references);
+        }
+        else if (node.kind === "switch")
+            collectReferences(node.select, "$.select", references);
+        else if (node.kind === "map")
+            collectReferences(node.items, "$.items", references);
+        for (const reference of references)
+            dataEdges.push({ source: sourceOf(reference.reference), target: node.id, targetPath: reference.path, reference: reference.reference });
+    }
+    for (const edge of ir.control.edges) {
+        const references = [];
+        collectReferences(edge.with, `$.controlEdges.${edge.id}.with`, references);
+        for (const target of edge.targets)
+            for (const reference of references)
+                dataEdges.push({ source: reference.reference.startsWith("node.output") ? edge.sourceNodeId : sourceOf(reference.reference), target, targetPath: reference.path, reference: reference.reference });
+    }
+    for (const [name, reference] of Object.entries(ir.outputs))
+        dataEdges.push({ source: sourceOf(reference.$ref), target: `$output:${name}`, targetPath: `$.outputs.${name}`, reference: reference.$ref });
+    return {
+        schemaVersion: "1.0",
+        workflowRevisionId: revision.workflowRevisionId,
+        irHash: ir.hash,
+        nodes: ir.nodes.map((node) => ({ id: node.id, kind: node.kind, ...(node.kind === "atom" ? { atom: node.atom.key } : {}), ...(node.mapScope ? { mapScope: node.mapScope } : {}) })).sort((a, b) => a.id.localeCompare(b.id)),
+        controlEdges: ir.control.edges.map((edge) => ({
+            id: edge.id, source: edge.sourceNodeId, targets: [...edge.targets], kind: edge.kind,
+            ...(edge.branchId ? { branch: edge.branchId } : {}), ...(edge.terminal ? { terminal: edge.terminal } : {}),
+            backEdge: edge.backEdge, ...(edge.maxTraversals ? { maxTraversals: edge.maxTraversals } : {}),
+        })).sort((a, b) => a.id.localeCompare(b.id)),
+        dataEdges: dataEdges.sort((a, b) => a.target.localeCompare(b.target) || a.targetPath.localeCompare(b.targetPath) || a.source.localeCompare(b.source)),
+        groups: {
+            entries: [...ir.control.entry],
+            forks: [...ir.readiness.forks].sort((a, b) => a.edgeId.localeCompare(b.edgeId)).map((item) => ({ edgeId: item.edgeId, targets: [...item.targets] })),
+            joins: [...ir.readiness.joins].sort((a, b) => a.nodeId.localeCompare(b.nodeId)).map((item) => ({ nodeId: item.nodeId, dependencies: [...item.dependencies] })),
+            maps: ir.nodes.filter((node) => node.kind === "map").map((node) => ({ nodeId: node.id, maxItems: node.maxItems, maxConcurrency: node.maxConcurrency, bodyNodeIds: [...node.bodyNodeIds] })).sort((a, b) => a.nodeId.localeCompare(b.nodeId)),
+            switches: ir.nodes.filter((node) => node.kind === "switch").map((node) => ({ nodeId: node.id, cases: [...node.caseIds], hasDefault: ir.control.edges.some((edge) => edge.sourceNodeId === node.id && edge.kind === "switch-default") })).sort((a, b) => a.nodeId.localeCompare(b.nodeId)),
+        },
+    };
+}
+export function renderWorkflowTopology(view) {
+    const lines = [`Workflow ${view.workflowRevisionId}`, `entry: ${view.groups.entries.join(", ")}`];
+    for (const node of view.nodes) {
+        const outgoing = view.controlEdges.filter((edge) => edge.source === node.id).map((edge) => {
+            const target = edge.terminal ?? edge.targets.join(",");
+            return `${edge.branch ? `[${edge.branch}] ` : ""}${target}${edge.backEdge ? ` ↩≤${edge.maxTraversals ?? "policy"}` : ""}`;
+        });
+        lines.push(`${node.id} (${node.kind}${node.atom ? `: ${node.atom}` : ""})${outgoing.length ? ` -> ${outgoing.join(" | ")}` : ""}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=workflow-topology.js.map

package/dist/topology/workflow-topology.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@atom-workflow-agent/workflow-engine",
+  "version": "0.1.0",
+  "description": "Durable execution of frozen workflow revisions.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/joekbits/atom-workflow-agent.git",
+    "directory": "packages/workflow-engine"
+  },
+  "homepage": "https://github.com/joekbits/atom-workflow-agent/tree/main/packages/workflow-engine#readme",
+  "bugs": {
+    "url": "https://github.com/joekbits/atom-workflow-agent/issues"
+  },
+  "keywords": [
+    "workflow",
+    "durable-execution",
+    "runtime"
+  ],
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "README.zh-CN.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "zod": "^4.0.0",
+    "@atom-workflow-agent/atom-catalog": "0.1.0",
+    "@atom-workflow-agent/atom-executor": "0.1.0",
+    "@atom-workflow-agent/atom-sdk": "0.1.0",
+    "@atom-workflow-agent/contracts": "0.1.0"
+  },
+  "devDependencies": {
+    "@atom-workflow-agent/workflow-compiler": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}