@elaraai/e3-core 0.0.2-beta.3 → 0.0.2-beta.30

package/dist/src/dataflow/state-store/InMemoryStateStore.js

@@ -0,0 +1,214 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * In-memory implementation of ExecutionStateStore.
+ *
+ * Useful for testing and simple cases where persistence is not required.
+ * State is lost when the process exits.
+ */
+import { some } from '@elaraai/east';
+/**
+ * In-memory state store for testing and simple use cases.
+ *
+ * @remarks
+ * - Thread-safe for concurrent access within a single process
+ * - State is lost on process exit
+ * - No durability guarantees
+ */
+export class InMemoryStateStore {
+    /** Map of "repo::workspace" -> execution ID -> state */
+    states = new Map();
+    /** Map of "repo::workspace" -> next execution ID counter */
+    counters = new Map();
+    makeKey(repo, workspace) {
+        return `${repo}::${workspace}`;
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async create(state) {
+        const key = this.makeKey(state.repo, state.workspace);
+        if (!this.states.has(key)) {
+            this.states.set(key, new Map());
+        }
+        const wsStates = this.states.get(key);
+        if (wsStates.has(state.id)) {
+            throw new Error(`Execution ${state.id} already exists in ${key}`);
+        }
+        // Deep clone to prevent external mutation
+        wsStates.set(state.id, this.cloneState(state));
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async read(repo, workspace, id) {
+        const key = this.makeKey(repo, workspace);
+        const wsStates = this.states.get(key);
+        if (!wsStates)
+            return null;
+        const state = wsStates.get(id);
+        if (!state)
+            return null;
+        return this.cloneState(state);
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async readLatest(repo, workspace) {
+        const key = this.makeKey(repo, workspace);
+        const wsStates = this.states.get(key);
+        if (!wsStates || wsStates.size === 0)
+            return null;
+        // Find the highest execution ID (assuming numeric string IDs)
+        let latestId = null;
+        let latestNum = -1;
+        for (const id of wsStates.keys()) {
+            const num = parseInt(id, 10);
+            if (!isNaN(num) && num > latestNum) {
+                latestNum = num;
+                latestId = id;
+            }
+            else if (latestId === null) {
+                // Fallback for non-numeric IDs: just take the first one
+                latestId = id;
+            }
+        }
+        if (latestId === null)
+            return null;
+        return this.cloneState(wsStates.get(latestId));
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async update(state) {
+        const key = this.makeKey(state.repo, state.workspace);
+        const wsStates = this.states.get(key);
+        if (!wsStates || !wsStates.has(state.id)) {
+            throw new Error(`Execution ${state.id} not found in ${key}`);
+        }
+        wsStates.set(state.id, this.cloneState(state));
+    }
+    async updateTaskStatus(repo, workspace, executionId, task, status, details) {
+        const state = await this.read(repo, workspace, executionId);
+        if (!state) {
+            throw new Error(`Execution ${executionId} not found in ${repo}::${workspace}`);
+        }
+        const taskState = state.tasks.get(task);
+        if (!taskState) {
+            throw new Error(`Task '${task}' not found in execution ${executionId}`);
+        }
+        taskState.status = status;
+        if (details) {
+            if (details.cached !== undefined)
+                taskState.cached = some(details.cached);
+            if (details.outputHash !== undefined)
+                taskState.outputHash = some(details.outputHash);
+            if (details.error !== undefined)
+                taskState.error = some(details.error);
+            if (details.exitCode !== undefined)
+                taskState.exitCode = some(BigInt(details.exitCode));
+            if (details.duration !== undefined)
+                taskState.duration = some(BigInt(details.duration));
+        }
+        taskState.completedAt = some(new Date());
+        await this.update(state);
+    }
+    async updateStatus(repo, workspace, executionId, status, details) {
+        const state = await this.read(repo, workspace, executionId);
+        if (!state) {
+            throw new Error(`Execution ${executionId} not found in ${repo}::${workspace}`);
+        }
+        const mutableState = state;
+        mutableState.status = status;
+        if (status !== 'running') {
+            mutableState.completedAt = some(new Date());
+        }
+        if (details?.error) {
+            mutableState.error = some(details.error);
+        }
+        if (details?.summary) {
+            mutableState.executed = BigInt(details.summary.executed);
+            mutableState.cached = BigInt(details.summary.cached);
+            mutableState.failed = BigInt(details.summary.failed);
+            mutableState.skipped = BigInt(details.summary.skipped);
+        }
+        await this.update(state);
+    }
+    async recordEvent(repo, workspace, executionId, event) {
+        const state = await this.read(repo, workspace, executionId);
+        if (!state) {
+            throw new Error(`Execution ${executionId} not found in ${repo}::${workspace}`);
+        }
+        // Append event to inline events array (cast to mutable array)
+        state.events.push(event);
+        await this.update(state);
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async getEventsSince(repo, workspace, executionId, sinceSeq) {
+        const key = this.makeKey(repo, workspace);
+        const wsStates = this.states.get(key);
+        if (!wsStates)
+            return [];
+        const state = wsStates.get(executionId);
+        if (!state)
+            return [];
+        // Filter events from inline array
+        const sinceSeqBigInt = BigInt(sinceSeq);
+        return state.events.filter(e => e.value.seq > sinceSeqBigInt);
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async nextExecutionId(repo, workspace) {
+        const key = this.makeKey(repo, workspace);
+        const current = this.counters.get(key) ?? 0;
+        const next = current + 1;
+        this.counters.set(key, next);
+        return String(next);
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async delete(repo, workspace, executionId) {
+        const key = this.makeKey(repo, workspace);
+        const wsStates = this.states.get(key);
+        if (wsStates) {
+            wsStates.delete(executionId);
+        }
+    }
+    /**
+     * Clear all state (for testing).
+     */
+    clear() {
+        this.states.clear();
+        this.counters.clear();
+    }
+    /**
+     * Deep clone execution state to prevent external mutation.
+     *
+     * Note: We use spread and some() to properly clone the branded option types.
+     */
+    cloneState(state) {
+        const tasks = new Map();
+        for (const [name, taskState] of state.tasks) {
+            // Shallow clone is sufficient since we use some() for options
+            tasks.set(name, { ...taskState });
+        }
+        // Clone graph if present
+        let graph = state.graph;
+        if (state.graph.type === 'some') {
+            const graphValue = {
+                tasks: state.graph.value.tasks.map(t => ({
+                    ...t,
+                    inputs: [...t.inputs],
+                    dependsOn: [...t.dependsOn],
+                })),
+            };
+            graph = some(graphValue);
+        }
+        // Clone completedAt if present
+        let completedAt = state.completedAt;
+        if (state.completedAt.type === 'some') {
+            completedAt = some(new Date(state.completedAt.value.getTime()));
+        }
+        return {
+            ...state,
+            startedAt: new Date(state.startedAt.getTime()),
+            completedAt,
+            graph,
+            tasks,
+            events: [...state.events],
+        };
+    }
+}
+//# sourceMappingURL=InMemoryStateStore.js.map

package/dist/src/dataflow/state-store/InMemoryStateStore.js.map

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

package/dist/src/dataflow/state-store/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * State store implementations for dataflow execution.
+ *
+ * @packageDocumentation
+ */
+export * from './interfaces.js';
+export * from './InMemoryStateStore.js';
+export * from './FileStateStore.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/dataflow/state-store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/dataflow/state-store/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC"}

package/dist/src/dataflow/state-store/index.js

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * State store implementations for dataflow execution.
+ *
+ * @packageDocumentation
+ */
+export * from './interfaces.js';
+export * from './InMemoryStateStore.js';
+export * from './FileStateStore.js';
+//# sourceMappingURL=index.js.map

package/dist/src/dataflow/state-store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/dataflow/state-store/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC"}

package/dist/src/dataflow/state-store/interfaces.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * State store interface for dataflow execution.
+ *
+ * Abstracts the persistence of execution state, enabling:
+ * - InMemoryStateStore: For testing and simple cases
+ * - FileStateStore: Local filesystem persistence (workspace/execution.beast2)
+ * - DynamoDBStateStore: Cloud execution (in e3-aws)
+ */
+import type { DataflowExecutionState, ExecutionEvent, TaskStatus } from '../types.js';
+/**
+ * Details for task status updates.
+ */
+export interface TaskStatusDetails {
+    /** Whether the result was from cache */
+    cached?: boolean;
+    /** Output hash (for completed tasks) */
+    outputHash?: string;
+    /** Error message (for failed tasks) */
+    error?: string;
+    /** Exit code (for failed tasks) */
+    exitCode?: number;
+    /** Duration in milliseconds */
+    duration?: number;
+}
+/**
+ * Details for execution status updates.
+ */
+export interface ExecutionStatusDetails {
+    /** Error message (for failed executions) */
+    error?: string;
+    /** Summary counts */
+    summary?: {
+        executed: number;
+        cached: number;
+        failed: number;
+        skipped: number;
+    };
+}
+/**
+ * Interface for persisting and retrieving execution state.
+ *
+ * Implementations must be thread-safe for concurrent access within a process.
+ * For distributed execution (cloud), implementations should use optimistic
+ * concurrency control (e.g., DynamoDB conditional writes).
+ *
+ * @remarks
+ * All methods take repo and workspace parameters because cloud storage
+ * (DynamoDB) needs both to identify an execution uniquely across repositories.
+ */
+export interface ExecutionStateStore {
+    /**
+     * Create a new execution state.
+     *
+     * @param state - The initial execution state (contains repo and workspace)
+     * @throws If an execution with the same ID already exists
+     */
+    create(state: DataflowExecutionState): Promise<void>;
+    /**
+     * Read an execution state by ID.
+     *
+     * @param repo - Repository identifier
+     * @param workspace - Workspace name
+     * @param id - Execution ID
+     * @returns The execution state, or null if not found
+     */
+    read(repo: string, workspace: string, id: string): Promise<DataflowExecutionState | null>;
+    /**
+     * Read the most recent execution for a workspace.
+     *
+     * @param repo - Repository identifier
+     * @param workspace - Workspace name
+     * @returns The most recent execution state, or null if none exists
+     */
+    readLatest(repo: string, workspace: string): Promise<DataflowExecutionState | null>;
+    /**
+     * Update the entire execution state.
+     *
+     * This is used for bulk updates after a sequence of step functions.
+     * Implementations may optimize by only writing changed fields.
+     *
+     * @param state - The updated execution state (contains repo and workspace)
+     */
+    update(state: DataflowExecutionState): Promise<void>;
+    /**
+     * Update a task's status within an execution.
+     *
+     * This is a convenience method for updating a single task without
+     * reading and writing the entire state.
+     *
+     * @param repo - Repository identifier
+     * @param workspace - Workspace name
+     * @param executionId - Execution ID
+     * @param task - Task name
+     * @param status - New status
+     * @param details - Additional details (output hash, error, etc.)
+     */
+    updateTaskStatus(repo: string, workspace: string, executionId: string, task: string, status: TaskStatus, details?: TaskStatusDetails): Promise<void>;
+    /**
+     * Update the execution's overall status.
+     *
+     * @param repo - Repository identifier
+     * @param workspace - Workspace name
+     * @param executionId - Execution ID
+     * @param status - New status ('running' | 'completed' | 'failed' | 'cancelled')
+     * @param details - Additional details (error message, summary)
+     */
+    updateStatus(repo: string, workspace: string, executionId: string, status: 'running' | 'completed' | 'failed' | 'cancelled', details?: ExecutionStatusDetails): Promise<void>;
+    /**
+     * Record an event for an execution.
+     *
+     * Events are used for monitoring and debugging. They are append-only
+     * and can be read with getEventsSince().
+     *
+     * @param repo - Repository identifier
+     * @param workspace - Workspace name
+     * @param executionId - Execution ID
+     * @param event - The event to record
+     */
+    recordEvent(repo: string, workspace: string, executionId: string, event: ExecutionEvent): Promise<void>;
+    /**
+     * Get events for an execution since a given sequence number.
+     *
+     * Used for polling/watching execution progress.
+     *
+     * @param repo - Repository identifier
+     * @param workspace - Workspace name
+     * @param executionId - Execution ID
+     * @param sinceSeq - Only return events with seq > sinceSeq
+     * @returns Array of events in sequence order
+     */
+    getEventsSince(repo: string, workspace: string, executionId: string, sinceSeq: number): Promise<ExecutionEvent[]>;
+    /**
+     * Get the next execution ID for a workspace.
+     *
+     * For local storage, returns auto-incrementing string IDs ("1", "2", ...).
+     * For cloud storage, may return UUIDs or other unique identifiers.
+     *
+     * @param repo - Repository identifier
+     * @param workspace - Workspace name
+     * @returns The next execution ID as a string
+     */
+    nextExecutionId(repo: string, workspace: string): Promise<string>;
+    /**
+     * Delete an execution state.
+     *
+     * Used for cleanup after execution completion or for removing
+     * abandoned executions.
+     *
+     * @param repo - Repository identifier
+     * @param workspace - Workspace name
+     * @param executionId - Execution ID
+     */
+    delete(repo: string, workspace: string, executionId: string): Promise<void>;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/src/dataflow/state-store/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../../src/dataflow/state-store/interfaces.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,cAAc,EACd,UAAU,EACX,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,OAAO,CAAC,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;;;;;;OAOG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAE1F;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAEpF;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;;;;;;;;;;;OAYG;IACH,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;OAQG;IACH,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,EACxD,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;;;OAUG;IACH,WAAW,CACT,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;;;OAUG;IACH,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE7B;;;;;;;;;OASG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAElE;;;;;;;;;OASG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E"}

package/dist/src/dataflow/state-store/interfaces.js

@@ -0,0 +1,6 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+export {};
+//# sourceMappingURL=interfaces.js.map

package/dist/src/dataflow/state-store/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../src/dataflow/state-store/interfaces.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/dataflow/steps.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { StorageBackend } from '../storage/interfaces.js';
+import type { DataflowExecutionState, InitializeResult, PrepareTaskResult, TaskCompletedResult, TaskFailedResult, FinalizeResult, TreeUpdateResult, ExecutionEvent } from './types.js';
+/**
+ * Options for initializing a dataflow execution.
+ */
+export interface StepInitializeOptions {
+    /** Maximum concurrent task executions (default: 4) */
+    concurrency?: number;
+    /** Force re-execution even if cached (default: false) */
+    force?: boolean;
+    /** Filter to run only specific task(s) by exact name */
+    filter?: string;
+}
+/**
+ * Initialize a new dataflow execution.
+ *
+ * Builds the dependency graph and creates the initial execution state.
+ * This is an async operation because it reads workspace and package state.
+ *
+ * @param storage - Storage backend
+ * @param repo - Repository identifier
+ * @param workspace - Workspace name
+ * @param executionId - Unique execution ID
+ * @param options - Execution options
+ * @returns Initial state and ready tasks
+ *
+ * @throws {WorkspaceNotFoundError} If workspace doesn't exist
+ * @throws {WorkspaceNotDeployedError} If workspace has no package deployed
+ * @throws {TaskNotFoundError} If filter specifies a task that doesn't exist
+ */
+export declare function stepInitialize(storage: StorageBackend, repo: string, workspace: string, executionId: string, options?: StepInitializeOptions): Promise<InitializeResult>;
+/**
+ * Get tasks that are ready to execute.
+ *
+ * A task is ready when:
+ * 1. All tasks it depends on have completed (not just started)
+ * 2. It passes the filter (if any)
+ * 3. It is not already completed, in-progress, failed, or skipped
+ *
+ * This is a pure function - it only reads state.
+ *
+ * @param state - Current execution state
+ * @returns Array of task names that are ready to execute
+ */
+export declare function stepGetReady(state: DataflowExecutionState): string[];
+/**
+ * Check if the execution is complete.
+ *
+ * An execution is complete when:
+ * - All tasks are in a terminal state (completed, failed, skipped)
+ * - Or there are no more ready tasks and no tasks in progress
+ *
+ * This is a pure function - it only reads state.
+ *
+ * @param state - Current execution state
+ * @returns True if execution is complete
+ */
+export declare function stepIsComplete(state: DataflowExecutionState): boolean;
+/**
+ * Prepare a task for execution by resolving inputs and checking cache.
+ *
+ * This async operation:
+ * 1. Resolves input hashes from current workspace state
+ * 2. Checks if there's a valid cached execution
+ *
+ * @param storage - Storage backend
+ * @param state - Current execution state
+ * @param taskName - Name of the task to prepare
+ * @returns Preparation result with input hashes and cache status
+ */
+export declare function stepPrepareTask(storage: StorageBackend, state: DataflowExecutionState, taskName: string): Promise<PrepareTaskResult>;
+/**
+ * Mark a task as started (in-progress).
+ *
+ * Mutates the execution state to record that a task has begun execution.
+ *
+ * @param state - Execution state to mutate
+ * @param taskName - Name of the task
+ * @returns Event to record
+ */
+export declare function stepTaskStarted(state: DataflowExecutionState, taskName: string): ExecutionEvent;
+/**
+ * Mark a task as completed successfully.
+ *
+ * Mutates the execution state and returns the newly ready tasks.
+ *
+ * @param state - Execution state to mutate
+ * @param taskName - Name of the task
+ * @param outputHash - Hash of the output dataset
+ * @param cached - Whether the result was from cache
+ * @param duration - Execution duration in milliseconds
+ * @returns Result with newly ready tasks and event
+ */
+export declare function stepTaskCompleted(state: DataflowExecutionState, taskName: string, outputHash: string, cached: boolean, duration: number): {
+    result: TaskCompletedResult;
+    event: ExecutionEvent;
+};
+/**
+ * Mark a task as failed.
+ *
+ * Mutates the execution state and returns tasks that should be skipped.
+ *
+ * @param state - Execution state to mutate
+ * @param taskName - Name of the failed task
+ * @param error - Error message (optional)
+ * @param exitCode - Exit code if process failed (optional)
+ * @param duration - Execution duration in milliseconds
+ * @returns Result with tasks to skip and event
+ */
+export declare function stepTaskFailed(state: DataflowExecutionState, taskName: string, error: string | undefined, exitCode: number | undefined, duration: number): {
+    result: TaskFailedResult;
+    event: ExecutionEvent;
+};
+/**
+ * Mark tasks as skipped due to upstream failure.
+ *
+ * @param state - Execution state to mutate
+ * @param taskNames - Names of tasks to skip
+ * @param cause - Name of the task that caused the skip
+ * @returns Array of events to record
+ */
+export declare function stepTasksSkipped(state: DataflowExecutionState, taskNames: string[], cause: string): ExecutionEvent[];
+/**
+ * Finalize the execution and return the result.
+ *
+ * Mutates the execution state to mark it as completed or failed.
+ *
+ * @param state - Execution state to mutate
+ * @returns Final result
+ */
+export declare function stepFinalize(state: DataflowExecutionState): {
+    result: FinalizeResult;
+    event: ExecutionEvent;
+};
+/**
+ * Cancel the execution.
+ *
+ * @param state - Execution state to mutate
+ * @param reason - Reason for cancellation
+ * @returns Event to record
+ */
+export declare function stepCancel(state: DataflowExecutionState, reason?: string): ExecutionEvent;
+/**
+ * Apply a task's output to the workspace tree.
+ *
+ * This step function handles workspace tree updates, which must be serialized
+ * to prevent lost-update race conditions when multiple tasks complete
+ * concurrently.
+ *
+ * For local execution, the LocalOrchestrator handles this internally with
+ * an AsyncMutex. For cloud execution (e.g., AWS Step Functions), this should
+ * be called in a dedicated "ApplyTreeUpdates" state that processes updates
+ * serially.
+ *
+ * @param storage - Storage backend
+ * @param repo - Repository identifier
+ * @param workspace - Workspace name
+ * @param outputPathStr - Output path as a keypath string (e.g., ".results.data")
+ * @param outputHash - Hash of the output dataset to write
+ * @returns Result with the new workspace root hash
+ *
+ * @remarks
+ * Tree updates must be serialized to prevent race conditions:
+ * - Two tasks complete concurrently, both read the same workspace root
+ * - Both compute new roots with their outputs
+ * - One write overwrites the other, losing the first task's output
+ *
+ * Cloud implementations should use a dedicated serialization mechanism
+ * (e.g., a single Lambda invocation per update, or DynamoDB transactions).
+ */
+export declare function stepApplyTreeUpdate(storage: StorageBackend, repo: string, workspace: string, outputPathStr: string, outputHash: string): Promise<TreeUpdateResult>;
+//# sourceMappingURL=steps.d.ts.map

package/dist/src/dataflow/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../../src/dataflow/steps.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAa/D,OAAO,KAAK,EACV,sBAAsB,EAEtB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACf,MAAM,YAAY,CAAC;AASpB;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,gBAAgB,CAAC,CAqE3B;AAyBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,EAAE,CA+BpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAqCrE;AAMD;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,sBAAsB,EAC7B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,iBAAiB,CAAC,CA0D5B;AAMD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,sBAAsB,EAC7B,QAAQ,EAAE,MAAM,GACf,cAAc,CAmBhB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,sBAAsB,EAC7B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,MAAM,GACf;IAAE,MAAM,EAAE,mBAAmB,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CA2CxD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,sBAAsB,EAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,MAAM,GACf;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAsDrD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,sBAAsB,EAC7B,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,EAAE,MAAM,GACZ,cAAc,EAAE,CA2BlB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,sBAAsB,GAAG;IAC3D,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,cAAc,CAAC;CACvB,CAoCA;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,sBAAsB,EAC7B,MAAM,CAAC,EAAE,MAAM,GACd,cAAc,CAgBhB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,CAAC,CAc3B"}