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

package/dist/src/dataflow/steps.js

@@ -0,0 +1,528 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Step functions for resumable dataflow execution.
+ *
+ * Each step function represents a single unit of work that can be:
+ * - Called locally in a loop (LocalOrchestrator)
+ * - Invoked as a Lambda handler (Step Functions orchestration)
+ *
+ * Step functions are designed to be:
+ * - Small and focused (one step = one Lambda invocation)
+ * - Deterministic where possible (pure functions marked as such)
+ * - Idempotent for retries
+ */
+import { variant, some, none } from '@elaraai/east';
+import { dataflowGetGraph, dataflowGetReadyTasks, dataflowGetDependentsToSkip, dataflowResolveInputHashes, dataflowCheckCache, } from '../dataflow.js';
+import { workspaceGetDatasetHash, workspaceSetDatasetByHash, } from '../trees.js';
+/**
+ * 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 async function stepInitialize(storage, repo, workspace, executionId, options = {}) {
+    const concurrency = options.concurrency ?? 4;
+    const force = options.force ?? false;
+    const filter = options.filter ?? null;
+    // Build the dependency graph
+    const graph = await dataflowGetGraph(storage, repo, workspace);
+    // Validate filter
+    if (filter !== null) {
+        const taskExists = graph.tasks.some(t => t.name === filter);
+        if (!taskExists) {
+            // Import here to avoid circular dependency
+            const { TaskNotFoundError } = await import('../errors.js');
+            throw new TaskNotFoundError(filter);
+        }
+    }
+    // Initialize task states
+    const tasks = new Map();
+    for (const task of graph.tasks) {
+        tasks.set(task.name, {
+            name: task.name,
+            status: 'pending',
+            cached: none,
+            outputHash: none,
+            error: none,
+            exitCode: none,
+            startedAt: none,
+            completedAt: none,
+            duration: none,
+        });
+    }
+    // Create initial state
+    const state = {
+        id: executionId,
+        repo,
+        workspace,
+        startedAt: new Date(),
+        concurrency: BigInt(concurrency),
+        force,
+        filter: filter !== null ? some(filter) : none,
+        graph: some(graph),
+        graphHash: none,
+        tasks,
+        executed: 0n,
+        cached: 0n,
+        failed: 0n,
+        skipped: 0n,
+        status: 'running',
+        completedAt: none,
+        error: none,
+        events: [],
+        eventSeq: 0n,
+    };
+    // Find initially ready tasks
+    const readyTasks = stepGetReady(state);
+    // Update task states to 'ready' (cast to mutable)
+    for (const taskName of readyTasks) {
+        const taskState = tasks.get(taskName);
+        if (taskState) {
+            taskState.status = 'ready';
+        }
+    }
+    return { state, readyTasks };
+}
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Get the graph from state, throwing if not available.
+ *
+ * For cloud execution, the graph may be stored separately and loaded
+ * via graphHash. This helper ensures the graph is present before use.
+ */
+function getGraph(state) {
+    if (state.graph.type !== 'some') {
+        throw new Error('Execution state has no graph. For cloud execution, load the graph using graphHash before calling step functions.');
+    }
+    return state.graph.value;
+}
+// =============================================================================
+// Pure Step Functions
+// =============================================================================
+/**
+ * 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 function stepGetReady(state) {
+    const completedTasks = new Set();
+    for (const [name, taskState] of state.tasks) {
+        if (taskState.status === 'completed') {
+            completedTasks.add(name);
+        }
+    }
+    // Get ready tasks from graph
+    const graphReady = dataflowGetReadyTasks(getGraph(state), completedTasks);
+    // Get filter value (handle Option type)
+    const filterValue = state.filter.type === 'some' ? state.filter.value : null;
+    // Filter by state and filter option
+    return graphReady.filter(taskName => {
+        const taskState = state.tasks.get(taskName);
+        if (!taskState)
+            return false;
+        // Skip tasks that are already being processed
+        if (taskState.status !== 'pending' && taskState.status !== 'ready') {
+            return false;
+        }
+        // Apply task filter
+        if (filterValue !== null && taskName !== filterValue) {
+            return false;
+        }
+        return true;
+    });
+}
+/**
+ * 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 function stepIsComplete(state) {
+    const filterValue = state.filter.type === 'some' ? state.filter.value : null;
+    for (const taskState of state.tasks.values()) {
+        // Check if any task is still in a non-terminal state
+        if (taskState.status === 'pending' ||
+            taskState.status === 'ready' ||
+            taskState.status === 'in_progress') {
+            // If in progress, not complete
+            if (taskState.status === 'in_progress') {
+                return false;
+            }
+            // If pending or ready, check if it can ever become ready
+            // A task is stuck if it has unmet dependencies that failed/skipped
+            const task = getGraph(state).tasks.find(t => t.name === taskState.name);
+            if (task) {
+                const hasUnmetDeps = task.dependsOn.some(dep => {
+                    const depState = state.tasks.get(dep);
+                    return depState && (depState.status === 'failed' || depState.status === 'skipped');
+                });
+                // If it's stuck due to failed deps, it should have been skipped
+                // If not stuck, we're not complete
+                if (!hasUnmetDeps) {
+                    // Check if it passes the filter
+                    if (filterValue !== null && taskState.name !== filterValue) {
+                        continue; // Filtered out, doesn't affect completion
+                    }
+                    return false;
+                }
+            }
+        }
+    }
+    return true;
+}
+// =============================================================================
+// Async Step Functions (I/O operations)
+// =============================================================================
+/**
+ * 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 async function stepPrepareTask(storage, state, taskName) {
+    const graph = getGraph(state);
+    const task = graph.tasks.find(t => t.name === taskName);
+    if (!task) {
+        throw new Error(`Task '${taskName}' not found in graph`);
+    }
+    // Resolve input hashes
+    const inputHashes = await dataflowResolveInputHashes(storage, state.repo, state.workspace, task);
+    // Check for null inputs (unassigned)
+    const validInputHashes = [];
+    for (const hash of inputHashes) {
+        if (hash === null) {
+            throw new Error(`Task '${taskName}' has unassigned input`);
+        }
+        validInputHashes.push(hash);
+    }
+    // Check cache if not forcing re-execution
+    let cachedOutputHash = null;
+    if (!state.force) {
+        cachedOutputHash = await dataflowCheckCache(storage, state.repo, task.hash, validInputHashes);
+        // Also verify the workspace output matches the cached output
+        if (cachedOutputHash !== null) {
+            const { parsePathString } = await import('../dataflow.js');
+            const outputPath = parsePathString(task.output);
+            const { refType, hash: wsOutputHash } = await workspaceGetDatasetHash(storage, state.repo, state.workspace, outputPath);
+            if (refType !== 'value' || wsOutputHash !== cachedOutputHash) {
+                // Workspace output doesn't match cached output, need to re-execute
+                cachedOutputHash = null;
+            }
+        }
+    }
+    return {
+        task: taskName,
+        taskHash: task.hash,
+        inputHashes: validInputHashes,
+        outputPath: task.output,
+        cachedOutputHash,
+    };
+}
+// =============================================================================
+// State Mutation Step Functions
+// =============================================================================
+/**
+ * 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 function stepTaskStarted(state, taskName) {
+    const taskState = state.tasks.get(taskName);
+    if (!taskState) {
+        throw new Error(`Task '${taskName}' not found in state`);
+    }
+    const now = new Date();
+    taskState.status = 'in_progress';
+    taskState.startedAt = some(now);
+    const mutableState = state;
+    mutableState.eventSeq = state.eventSeq + 1n;
+    const event = variant('task_started', {
+        seq: mutableState.eventSeq,
+        timestamp: now,
+        task: taskName,
+    });
+    mutableState.events.push(event);
+    return event;
+}
+/**
+ * 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 function stepTaskCompleted(state, taskName, outputHash, cached, duration) {
+    const taskState = state.tasks.get(taskName);
+    if (!taskState) {
+        throw new Error(`Task '${taskName}' not found in state`);
+    }
+    const now = new Date();
+    const mutableState = state;
+    taskState.status = 'completed';
+    taskState.cached = some(cached);
+    taskState.outputHash = some(outputHash);
+    taskState.completedAt = some(now);
+    taskState.duration = some(BigInt(duration));
+    // Update counters
+    if (cached) {
+        mutableState.cached = state.cached + 1n;
+    }
+    else {
+        mutableState.executed = state.executed + 1n;
+    }
+    // Find newly ready tasks
+    const newlyReady = stepGetReady(state);
+    for (const name of newlyReady) {
+        const ts = state.tasks.get(name);
+        if (ts && ts.status === 'pending') {
+            ts.status = 'ready';
+        }
+    }
+    mutableState.eventSeq = state.eventSeq + 1n;
+    const event = variant('task_completed', {
+        seq: mutableState.eventSeq,
+        timestamp: now,
+        task: taskName,
+        cached,
+        outputHash,
+        duration: BigInt(duration),
+    });
+    mutableState.events.push(event);
+    return { result: { newlyReady }, event };
+}
+/**
+ * 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 function stepTaskFailed(state, taskName, error, exitCode, duration) {
+    const taskState = state.tasks.get(taskName);
+    if (!taskState) {
+        throw new Error(`Task '${taskName}' not found in state`);
+    }
+    const now = new Date();
+    const mutableState = state;
+    taskState.status = 'failed';
+    taskState.error = error !== undefined ? some(error) : none;
+    taskState.exitCode = exitCode !== undefined ? some(BigInt(exitCode)) : none;
+    taskState.completedAt = some(now);
+    taskState.duration = some(BigInt(duration));
+    // Update counters
+    mutableState.failed = state.failed + 1n;
+    // Get filter value (handle Option type)
+    const filterValue = state.filter.type === 'some' ? state.filter.value : null;
+    // Find tasks to skip (transitive dependents)
+    const completedSet = new Set();
+    const skippedSet = new Set();
+    for (const [name, ts] of state.tasks) {
+        if (ts.status === 'completed')
+            completedSet.add(name);
+        if (ts.status === 'skipped')
+            skippedSet.add(name);
+    }
+    const toSkip = dataflowGetDependentsToSkip(getGraph(state), taskName, completedSet, skippedSet).filter(name => {
+        // Also exclude in-progress tasks and apply filter
+        const ts = state.tasks.get(name);
+        if (!ts || ts.status === 'in_progress')
+            return false;
+        if (filterValue !== null && name !== filterValue)
+            return false;
+        return true;
+    });
+    mutableState.eventSeq = state.eventSeq + 1n;
+    const event = variant('task_failed', {
+        seq: mutableState.eventSeq,
+        timestamp: now,
+        task: taskName,
+        error: error !== undefined ? some(error) : none,
+        exitCode: exitCode !== undefined ? some(BigInt(exitCode)) : none,
+        duration: BigInt(duration),
+    });
+    mutableState.events.push(event);
+    return { result: { toSkip }, event };
+}
+/**
+ * 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 function stepTasksSkipped(state, taskNames, cause) {
+    const events = [];
+    const now = new Date();
+    const mutableState = state;
+    for (const taskName of taskNames) {
+        const taskState = state.tasks.get(taskName);
+        if (!taskState)
+            continue;
+        taskState.status = 'skipped';
+        taskState.completedAt = some(now);
+        taskState.duration = some(0n);
+        mutableState.skipped = mutableState.skipped + 1n;
+        mutableState.eventSeq = mutableState.eventSeq + 1n;
+        const event = variant('task_skipped', {
+            seq: mutableState.eventSeq,
+            timestamp: now,
+            task: taskName,
+            cause,
+        });
+        mutableState.events.push(event);
+        events.push(event);
+    }
+    return events;
+}
+/**
+ * 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 function stepFinalize(state) {
+    const now = new Date();
+    const startTime = state.startedAt.getTime();
+    const duration = Date.now() - startTime;
+    const mutableState = state;
+    // Determine success
+    const success = state.failed === 0n;
+    // Update state
+    mutableState.status = success ? 'completed' : 'failed';
+    mutableState.completedAt = some(now);
+    mutableState.eventSeq = state.eventSeq + 1n;
+    const event = variant('execution_completed', {
+        seq: mutableState.eventSeq,
+        timestamp: now,
+        success,
+        executed: state.executed,
+        cached: state.cached,
+        failed: state.failed,
+        skipped: state.skipped,
+        duration: BigInt(duration),
+    });
+    mutableState.events.push(event);
+    const result = {
+        success,
+        executed: Number(state.executed),
+        cached: Number(state.cached),
+        failed: Number(state.failed),
+        skipped: Number(state.skipped),
+        duration,
+    };
+    return { result, event };
+}
+/**
+ * Cancel the execution.
+ *
+ * @param state - Execution state to mutate
+ * @param reason - Reason for cancellation
+ * @returns Event to record
+ */
+export function stepCancel(state, reason) {
+    const now = new Date();
+    const mutableState = state;
+    mutableState.status = 'cancelled';
+    mutableState.completedAt = some(now);
+    mutableState.error = some(reason ?? 'Execution was cancelled');
+    mutableState.eventSeq = state.eventSeq + 1n;
+    const event = variant('execution_cancelled', {
+        seq: mutableState.eventSeq,
+        timestamp: now,
+        reason: reason !== undefined ? some(reason) : none,
+    });
+    mutableState.events.push(event);
+    return event;
+}
+// =============================================================================
+// Tree Update Step Function
+// =============================================================================
+/**
+ * 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 async function stepApplyTreeUpdate(storage, repo, workspace, outputPathStr, outputHash) {
+    const { parsePathString } = await import('../dataflow.js');
+    const outputPath = parsePathString(outputPathStr);
+    // Write the output to the workspace tree
+    const newRootHash = await workspaceSetDatasetByHash(storage, repo, workspace, outputPath, outputHash);
+    return { newRootHash };
+}
+//# sourceMappingURL=steps.js.map

package/dist/src/dataflow/steps.js.map

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

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

@@ -0,0 +1,116 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Resumable dataflow execution types.
+ *
+ * These types support both local and cloud execution by separating
+ * execution state from orchestration. The state can be persisted to
+ * a file (local) or DynamoDB (cloud) and resumed after interruption.
+ *
+ * Types are derived from EastType definitions in @elaraai/e3-types using
+ * ValueTypeOf for proper branded variant/option support.
+ */
+import { type ValueTypeOf } from '@elaraai/east';
+import { TaskStateType, DataflowGraphTaskType, DataflowGraphType, ExecutionEventType, DataflowExecutionStateType } from '@elaraai/e3-types';
+export { TaskStateType, DataflowGraphTaskType, DataflowGraphType, ExecutionEventType, DataflowExecutionStateType, } from '@elaraai/e3-types';
+export type { DataflowExecutionStatus, TaskStatus } from '@elaraai/e3-types';
+/**
+ * Task state information.
+ */
+export type TaskState = ValueTypeOf<typeof TaskStateType>;
+/**
+ * Task in the dataflow graph.
+ */
+export type DataflowGraphTask = ValueTypeOf<typeof DataflowGraphTaskType>;
+/**
+ * Dataflow dependency graph.
+ */
+export type DataflowGraph = ValueTypeOf<typeof DataflowGraphType>;
+/**
+ * Execution event (discriminated union via VariantType).
+ */
+export type ExecutionEvent = ValueTypeOf<typeof ExecutionEventType>;
+/**
+ * Dataflow execution state.
+ */
+export type DataflowExecutionState = ValueTypeOf<typeof DataflowExecutionStateType>;
+/**
+ * Result of stepInitialize.
+ */
+export interface InitializeResult {
+    /** The initialized execution state */
+    state: DataflowExecutionState;
+    /** Tasks that are immediately ready (no dependencies) */
+    readyTasks: string[];
+}
+/**
+ * Result of stepPrepareTask - information needed to execute a task.
+ */
+export interface PrepareTaskResult {
+    /** Task name */
+    task: string;
+    /** Task object hash */
+    taskHash: string;
+    /** Input dataset hashes (in order) */
+    inputHashes: string[];
+    /** Output path string */
+    outputPath: string;
+    /** Cached output hash if available (skip execution) */
+    cachedOutputHash: string | null;
+}
+/**
+ * Result of a task execution (returned by TaskRunner).
+ */
+export interface TaskExecuteResult {
+    /** Final state */
+    state: 'success' | 'failed' | 'error';
+    /** Whether the result was served from cache */
+    cached: boolean;
+    /** Output hash (if state is 'success') */
+    outputHash?: string;
+    /** Exit code (if state is 'failed') */
+    exitCode?: number;
+    /** Error message (if state is 'error') */
+    error?: string;
+}
+/**
+ * Result of stepTaskCompleted.
+ */
+export interface TaskCompletedResult {
+    /** Tasks that became ready after this completion */
+    newlyReady: string[];
+}
+/**
+ * Result of stepTaskFailed.
+ */
+export interface TaskFailedResult {
+    /** Tasks that should be skipped due to this failure */
+    toSkip: string[];
+}
+/**
+ * Result of stepFinalize.
+ */
+export interface FinalizeResult {
+    /** Overall success - true if all tasks completed successfully */
+    success: boolean;
+    /** Number of tasks executed (not from cache) */
+    executed: number;
+    /** Number of tasks served from cache */
+    cached: number;
+    /** Number of tasks that failed */
+    failed: number;
+    /** Number of tasks skipped due to upstream failure */
+    skipped: number;
+    /** Total duration in milliseconds */
+    duration: number;
+}
+/**
+ * Result of stepApplyTreeUpdate.
+ */
+export interface TreeUpdateResult {
+    /** The new workspace root hash after the update */
+    newRootHash: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/dataflow/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC3B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAM7E;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,WAAW,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAMpF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,yDAAyD;IACzD,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kBAAkB;IAClB,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtC,+CAA+C;IAC/C,MAAM,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/src/dataflow/types.js

@@ -0,0 +1,7 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+// Re-export EastType schemas for serialization
+export { TaskStateType, DataflowGraphTaskType, DataflowGraphType, ExecutionEventType, DataflowExecutionStateType, } from '@elaraai/e3-types';
+//# sourceMappingURL=types.js.map

package/dist/src/dataflow/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/dataflow/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsBH,+CAA+C;AAC/C,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC"}