@elaraai/e3-core 0.0.2-beta.5 → 0.0.2-beta.51

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

@@ -0,0 +1,300 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * File-based implementation of ExecutionStateStore.
+ *
+ * Persists execution state to the workspace directory structure:
+ * - workspaces/{ws}/execution.beast2 - Current/last execution state (binary format)
+ * - workspaces/{ws}/execution-counter - Auto-increment counter
+ *
+ * Events are stored inline in the execution state (not as a separate file).
+ * This enables crash recovery and external monitoring of execution progress.
+ */
+import { promises as fs } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { encodeBeast2For, decodeBeast2For, some } from '@elaraai/east';
+import { DataflowExecutionStateType, } from '../types.js';
+// Create encoder/decoder for beast2 serialization
+const encode = encodeBeast2For(DataflowExecutionStateType);
+const decode = decodeBeast2For(DataflowExecutionStateType);
+/**
+ * File-based state store for local filesystem persistence.
+ *
+ * @remarks
+ * - Uses atomic writes (write to temp, then rename) for durability
+ * - State is stored in beast2 binary format for type safety
+ * - Events are stored inline in the execution state
+ * - Thread-safe for concurrent access within a single process (via file locking)
+ * - Suitable for local CLI and API server usage
+ */
+export class FileStateStore {
+    workspacesDir;
+    /**
+     * Create a new FileStateStore.
+     *
+     * @param workspacesDir - Path to the workspaces directory (e.g., repo/workspaces)
+     */
+    constructor(workspacesDir) {
+        this.workspacesDir = workspacesDir;
+    }
+    /**
+     * Get the path to a workspace's directory.
+     */
+    workspacePath(workspace) {
+        return join(this.workspacesDir, workspace);
+    }
+    /**
+     * Get the path to a workspace's execution state file.
+     */
+    statePath(workspace) {
+        return join(this.workspacePath(workspace), 'execution.beast2');
+    }
+    /**
+     * Get the path to a workspace's execution counter file.
+     */
+    counterPath(workspace) {
+        return join(this.workspacePath(workspace), 'execution-counter');
+    }
+    async create(state) {
+        const path = this.statePath(state.workspace);
+        // Check if execution already exists
+        const existing = await this.read(state.repo, state.workspace, state.id);
+        if (existing) {
+            throw new Error(`Execution ${state.id} already exists in workspace '${state.workspace}'`);
+        }
+        // Write state atomically using beast2 encoding
+        const data = encode(state);
+        await this.atomicWrite(path, data);
+    }
+    async read(repo, workspace, id) {
+        const path = this.statePath(workspace);
+        try {
+            const data = await fs.readFile(path);
+            const state = decode(data);
+            // Check if this is the requested execution
+            if (state.id !== id) {
+                return null;
+            }
+            // Verify repo matches (if stored)
+            if (state.repo && state.repo !== repo) {
+                return null;
+            }
+            return state;
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                return null;
+            }
+            throw err;
+        }
+    }
+    async readLatest(_repo, workspace) {
+        const path = this.statePath(workspace);
+        try {
+            const data = await fs.readFile(path);
+            return decode(data);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                return null;
+            }
+            throw err;
+        }
+    }
+    async update(state) {
+        const path = this.statePath(state.workspace);
+        // Guard: never overwrite 'cancelled' with a non-cancelled status
+        if (state.status !== 'cancelled') {
+            try {
+                const existing = await fs.readFile(path);
+                const current = decode(existing);
+                if (current.status === 'cancelled') {
+                    return;
+                }
+            }
+            catch (err) {
+                if (err.code !== 'ENOENT')
+                    throw err;
+            }
+        }
+        const data = encode(state);
+        await this.atomicWrite(path, data);
+    }
+    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 workspace '${workspace}'`);
+        }
+        const taskState = state.tasks.get(task);
+        if (!taskState) {
+            throw new Error(`Task '${task}' not found in execution ${executionId}`);
+        }
+        const mutableState = state;
+        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());
+        // Update counters based on status
+        if (status === 'completed' && details?.cached) {
+            mutableState.cached = state.cached + 1n;
+        }
+        else if (status === 'completed') {
+            mutableState.executed = state.executed + 1n;
+        }
+        else if (status === 'failed') {
+            mutableState.failed = state.failed + 1n;
+        }
+        else if (status === 'skipped') {
+            mutableState.skipped = state.skipped + 1n;
+        }
+        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 workspace '${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 workspace '${workspace}'`);
+        }
+        // Append event to inline events array (cast to mutable array)
+        state.events.push(event);
+        await this.update(state);
+    }
+    async getEventsSince(repo, workspace, executionId, sinceSeq) {
+        const state = await this.read(repo, workspace, executionId);
+        if (!state) {
+            return [];
+        }
+        // Filter events from inline array
+        const sinceSeqBigInt = BigInt(sinceSeq);
+        return state.events.filter(e => {
+            // Events are variants, so we access seq via e.value.seq
+            const seq = e.value.seq;
+            return seq > sinceSeqBigInt;
+        });
+    }
+    async nextExecutionId(_repo, workspace) {
+        const path = this.counterPath(workspace);
+        let current = 0;
+        try {
+            const data = await fs.readFile(path, 'utf-8');
+            current = parseInt(data.trim(), 10) || 0;
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT') {
+                throw err;
+            }
+        }
+        const next = current + 1;
+        await this.atomicWriteText(path, String(next));
+        return String(next);
+    }
+    async delete(_repo, workspace, executionId) {
+        // Only delete if the stored execution matches the requested ID
+        const state = await this.readLatest(_repo, workspace);
+        if (state && state.id === executionId) {
+            const statePath = this.statePath(workspace);
+            try {
+                await fs.unlink(statePath);
+            }
+            catch (err) {
+                if (err.code !== 'ENOENT') {
+                    throw err;
+                }
+            }
+        }
+    }
+    /**
+     * Check if an incomplete execution exists for a workspace.
+     *
+     * An execution is incomplete if its status is 'running'.
+     * This is used to detect crash recovery scenarios.
+     *
+     * @param repo - Repository identifier
+     * @param workspace - Workspace name
+     * @returns The incomplete execution if one exists, null otherwise
+     */
+    async getIncompleteExecution(repo, workspace) {
+        const state = await this.readLatest(repo, workspace);
+        if (state && state.status === 'running') {
+            return state;
+        }
+        return null;
+    }
+    /**
+     * Write a binary file atomically using temp file + rename.
+     */
+    async atomicWrite(path, content) {
+        const dir = dirname(path);
+        const tmpPath = join(dir, `.tmp-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        try {
+            await fs.mkdir(dir, { recursive: true });
+            await fs.writeFile(tmpPath, content);
+            await fs.rename(tmpPath, path);
+        }
+        catch (err) {
+            // Clean up temp file on failure
+            try {
+                await fs.unlink(tmpPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            throw err;
+        }
+    }
+    /**
+     * Write a text file atomically using temp file + rename.
+     */
+    async atomicWriteText(path, content) {
+        const dir = dirname(path);
+        const tmpPath = join(dir, `.tmp-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        try {
+            await fs.mkdir(dir, { recursive: true });
+            await fs.writeFile(tmpPath, content, 'utf-8');
+            await fs.rename(tmpPath, path);
+        }
+        catch (err) {
+            // Clean up temp file on failure
+            try {
+                await fs.unlink(tmpPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=FileStateStore.js.map

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

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

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

@@ -0,0 +1,42 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { ExecutionStateStore, TaskStatusDetails, ExecutionStatusDetails } from './interfaces.js';
+import type { DataflowExecutionState, ExecutionEvent, TaskStatus } from '../types.js';
+/**
+ * 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 declare class InMemoryStateStore implements ExecutionStateStore {
+    /** Map of "repo::workspace" -> execution ID -> state */
+    private states;
+    /** Map of "repo::workspace" -> next execution ID counter */
+    private counters;
+    private makeKey;
+    create(state: DataflowExecutionState): Promise<void>;
+    read(repo: string, workspace: string, id: string): Promise<DataflowExecutionState | null>;
+    readLatest(repo: string, workspace: string): Promise<DataflowExecutionState | null>;
+    update(state: DataflowExecutionState): Promise<void>;
+    updateTaskStatus(repo: string, workspace: string, executionId: string, task: string, status: TaskStatus, details?: TaskStatusDetails): Promise<void>;
+    updateStatus(repo: string, workspace: string, executionId: string, status: 'running' | 'completed' | 'failed' | 'cancelled', details?: ExecutionStatusDetails): Promise<void>;
+    recordEvent(repo: string, workspace: string, executionId: string, event: ExecutionEvent): Promise<void>;
+    getEventsSince(repo: string, workspace: string, executionId: string, sinceSeq: number): Promise<ExecutionEvent[]>;
+    nextExecutionId(repo: string, workspace: string): Promise<string>;
+    delete(repo: string, workspace: string, executionId: string): Promise<void>;
+    /**
+     * Clear all state (for testing).
+     */
+    clear(): void;
+    /**
+     * Deep clone execution state to prevent external mutation.
+     *
+     * Note: We use spread and some() to properly clone the branded option types.
+     */
+    private cloneState;
+}
+//# sourceMappingURL=InMemoryStateStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryStateStore.d.ts","sourceRoot":"","sources":["../../../../src/dataflow/state-store/InMemoryStateStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EACV,sBAAsB,EAEtB,cAAc,EACd,UAAU,EAEX,MAAM,aAAa,CAAC;AAKrB;;;;;;;GAOG;AACH,qBAAa,kBAAmB,YAAW,mBAAmB;IAC5D,wDAAwD;IACxD,OAAO,CAAC,MAAM,CAA0D;IAExE,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAA6B;IAE7C,OAAO,CAAC,OAAO;IAKT,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBpD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAYzF,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAwBnF,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBpD,gBAAgB,CACpB,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;IAwBV,YAAY,CAChB,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;IAyBV,WAAW,CACf,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,IAAI,CAAC;IAaV,cAAc,CAClB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,EAAE,CAAC;IActB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASjE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjF;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACH,OAAO,CAAC,UAAU;CA4CnB"}

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

@@ -0,0 +1,229 @@
+/**
+ * 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}`);
+        }
+        // Guard: never overwrite 'cancelled' with a non-cancelled status
+        if (state.status !== 'cancelled') {
+            const current = wsStates.get(state.id);
+            if (current.status === 'cancelled') {
+                return;
+            }
+        }
+        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()));
+        }
+        // Deep clone versionVectors (Map<string, Map<string, string>>)
+        const versionVectors = new Map();
+        for (const [k, v] of state.versionVectors) {
+            versionVectors.set(k, new Map(v));
+        }
+        return {
+            ...state,
+            startedAt: new Date(state.startedAt.getTime()),
+            completedAt,
+            graph,
+            tasks,
+            events: [...state.events],
+            versionVectors,
+            inputSnapshot: new Map(state.inputSnapshot),
+            taskOutputPaths: [...state.taskOutputPaths],
+        };
+    }
+}
+//# 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"}