condukt 0.1.0

package/dist/state/reducer.js

@@ -0,0 +1,223 @@
+"use strict";
+/**
+ * Pure projection reducer — folds ExecutionEvents into ExecutionProjection.
+ *
+ * Zero I/O. Exhaustive switch with `never` default. All updates are immutable.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEmptyProjection = createEmptyProjection;
+exports.reduce = reduce;
+exports.replayEvents = replayEvents;
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+function createEmptyProjection(id, flowId) {
+    return {
+        id,
+        flowId: flowId ?? '',
+        status: 'pending',
+        params: {},
+        graph: {
+            nodes: [],
+            edges: [],
+            activeNodes: [],
+            completedPath: [],
+        },
+        totalCost: 0,
+        metadata: {},
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function updateNode(state, nodeId, updater) {
+    const nodes = state.graph.nodes.map((n) => n.id === nodeId ? updater(n) : n);
+    // Recalculate activeNodes: nodes with status 'running' or 'gated'
+    const activeNodes = nodes
+        .filter((n) => n.status === 'running' || n.status === 'gated')
+        .map((n) => n.id);
+    return {
+        ...state,
+        graph: { ...state.graph, nodes, activeNodes },
+    };
+}
+function updateEdge(state, source, target, newState) {
+    const edges = state.graph.edges.map((e) => {
+        if (e.source === source && e.target === target) {
+            return { ...e, state: newState };
+        }
+        // Mark sibling edges from the same source as 'not_taken' if still 'default'
+        if (e.source === source && e.state === 'default') {
+            return { ...e, state: 'not_taken' };
+        }
+        return e;
+    });
+    return { ...state, graph: { ...state.graph, edges } };
+}
+// ---------------------------------------------------------------------------
+// Reducer
+// ---------------------------------------------------------------------------
+function reduce(state, event) {
+    switch (event.type) {
+        case 'run:started': {
+            const nodes = event.graph.nodes.map((n) => ({
+                id: n.id,
+                displayName: n.displayName,
+                nodeType: n.nodeType,
+                model: n.model,
+                status: 'pending',
+                attempt: 0,
+                output: n.output,
+            }));
+            const edges = event.graph.edges.map((e) => ({
+                source: e.source,
+                action: e.action,
+                target: e.target,
+                state: 'default',
+            }));
+            return {
+                ...state,
+                status: 'running',
+                flowId: event.flowId,
+                params: { ...event.params },
+                startedAt: event.ts,
+                graph: {
+                    nodes,
+                    edges,
+                    activeNodes: [],
+                    completedPath: [],
+                },
+            };
+        }
+        case 'run:completed':
+            return {
+                ...state,
+                status: event.status,
+                finishedAt: event.ts,
+            };
+        case 'run:resumed':
+            return {
+                ...state,
+                status: 'running',
+            };
+        case 'node:started':
+            return updateNode(state, event.nodeId, (n) => ({
+                ...n,
+                status: 'running',
+                startedAt: event.ts,
+                attempt: n.attempt + 1,
+            }));
+        case 'node:completed': {
+            // Don't overwrite 'skipped' status — gate rejection takes precedence over
+            // the scheduler's node:completed (which fires after the gate Promise resolves)
+            const existing = state.graph.nodes.find(n => n.id === event.nodeId);
+            if (existing?.status === 'skipped')
+                return state;
+            const updated = updateNode(state, event.nodeId, (n) => ({
+                ...n,
+                status: 'completed',
+                action: event.action,
+                finishedAt: event.ts,
+                elapsedMs: event.elapsedMs,
+            }));
+            return {
+                ...updated,
+                graph: {
+                    ...updated.graph,
+                    completedPath: [...updated.graph.completedPath, event.nodeId],
+                },
+            };
+        }
+        case 'node:failed':
+            return updateNode(state, event.nodeId, (n) => ({
+                ...n,
+                status: 'failed',
+                finishedAt: event.ts,
+                error: event.error,
+            }));
+        case 'node:killed':
+            return updateNode(state, event.nodeId, (n) => ({
+                ...n,
+                status: 'killed',
+                finishedAt: event.ts,
+            }));
+        case 'node:skipped':
+            return updateNode(state, event.nodeId, (n) => ({
+                ...n,
+                status: 'skipped',
+                finishedAt: event.ts,
+            }));
+        case 'node:gated':
+            return updateNode(state, event.nodeId, (n) => ({
+                ...n,
+                status: 'gated',
+                gateData: event.gateData,
+            }));
+        case 'gate:resolved': {
+            const resolvedStatus = event.resolution === 'rejected' ? 'skipped' : 'completed';
+            const updated = updateNode(state, event.nodeId, (n) => ({
+                ...n,
+                status: resolvedStatus,
+                action: event.resolution,
+                finishedAt: event.ts,
+            }));
+            // If not rejected, also add to completedPath
+            if (resolvedStatus === 'completed') {
+                return {
+                    ...updated,
+                    graph: {
+                        ...updated.graph,
+                        completedPath: [...updated.graph.completedPath, event.nodeId],
+                    },
+                };
+            }
+            return updated;
+        }
+        case 'node:retrying':
+            return updateNode(state, event.nodeId, (n) => ({
+                ...n,
+                status: 'retrying',
+                attempt: event.attempt,
+                error: undefined,
+                finishedAt: undefined,
+                elapsedMs: undefined,
+            }));
+        case 'edge:traversed':
+            return updateEdge(state, event.source, event.target, 'taken');
+        case 'artifact:written':
+            // Artifacts are stored separately — no projection change
+            return state;
+        case 'cost:recorded':
+            return {
+                ...state,
+                totalCost: state.totalCost + event.cost,
+            };
+        case 'metadata': {
+            // CR1: array merge semantics — arrays accumulate, scalars overwrite
+            const existing = state.metadata[event.key];
+            let merged;
+            if (Array.isArray(existing) && Array.isArray(event.value)) {
+                merged = [...existing, ...event.value];
+            }
+            else {
+                merged = event.value;
+            }
+            return {
+                ...state,
+                metadata: { ...state.metadata, [event.key]: merged },
+            };
+        }
+        default: {
+            // Exhaustiveness check — if this errors, a new event type was added without a case
+            const _exhaustive = event;
+            throw new Error(`Unhandled event type: ${_exhaustive.type}`);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Replay
+// ---------------------------------------------------------------------------
+function replayEvents(id, events) {
+    return events.reduce((state, event) => reduce(state, event), createEmptyProjection(id));
+}
+//# sourceMappingURL=reducer.js.map

package/dist/state/reducer.js.map

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

package/dist/state/state-runtime.d.ts

@@ -0,0 +1,30 @@
+/**
+ * StateRuntime — coordinates event flow, projection caching, and storage.
+ *
+ * Sits between the execution layer (which emits events) and the API layer
+ * (which serves projections). Uses a StorageEngine for persistence and
+ * an in-memory cache for fast reads.
+ */
+import type { StorageEngine, ExecutionProjection, OutputPage } from '../src/types';
+import type { ExecutionEvent, OutputEvent } from '../src/events';
+export declare class StateRuntime {
+    private readonly storage;
+    private readonly onEvent?;
+    private cache;
+    private locks;
+    constructor(storage: StorageEngine, onEvent?: ((event: ExecutionEvent) => void) | undefined);
+    handleEvent(event: ExecutionEvent): Promise<void>;
+    private _applyEvent;
+    handleOutput(event: OutputEvent): void;
+    writeArtifact(execId: string, nodeId: string, name: string, content: string): void;
+    getProjection(id: string): ExecutionProjection | null;
+    listExecutions(): ExecutionProjection[];
+    getNodeOutput(execId: string, nodeId: string, offset?: number, limit?: number): OutputPage;
+    getArtifact(execId: string, nodeId: string, name: string): string | null;
+    rebuildProjection(execId: string): ExecutionProjection;
+    /** R12a: Hydrate cache from storage. R12b: Mark running executions as crashed. */
+    recoverOnStartup(): void;
+    delete(execId: string): boolean;
+    shutdown(): void;
+}
+//# sourceMappingURL=state-runtime.d.ts.map

package/dist/state/state-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-runtime.d.ts","sourceRoot":"","sources":["../../state/state-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,UAAU,EACX,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjE,qBAAa,YAAY;IAMrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAN3B,OAAO,CAAC,KAAK,CAA0C;IAEvD,OAAO,CAAC,KAAK,CAAoC;gBAG9B,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,GAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,aAAA;IAOtD,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvD,OAAO,CAAC,WAAW;IAsBnB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAMtC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAQlF,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAIrD,cAAc,IAAI,mBAAmB,EAAE;IAIvC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU;IAI1F,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQxE,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB;IAQtD,kFAAkF;IAClF,gBAAgB,IAAI,IAAI;IAmCxB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAK/B,QAAQ,IAAI,IAAI;CAUjB"}

package/dist/state/state-runtime.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * StateRuntime — coordinates event flow, projection caching, and storage.
+ *
+ * Sits between the execution layer (which emits events) and the API layer
+ * (which serves projections). Uses a StorageEngine for persistence and
+ * an in-memory cache for fast reads.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StateRuntime = void 0;
+const reducer_1 = require("./reducer");
+class StateRuntime {
+    storage;
+    onEvent;
+    cache = new Map();
+    // SYS-1: Per-execution async mutex — serializes events for each execution
+    locks = new Map();
+    constructor(storage, onEvent) {
+        this.storage = storage;
+        this.onEvent = onEvent;
+    }
+    // -------------------------------------------------------------------------
+    // Command handlers
+    // -------------------------------------------------------------------------
+    async handleEvent(event) {
+        const id = event.executionId;
+        // SYS-1: Serialize events per-execution via promise chain
+        const prev = this.locks.get(id) ?? Promise.resolve();
+        const next = prev.then(() => this._applyEvent(event));
+        this.locks.set(id, next.catch(() => { }));
+        await next;
+    }
+    _applyEvent(event) {
+        const id = event.executionId;
+        // 1. Append to event log
+        this.storage.appendEvent(id, event);
+        // 2. Get or create projection
+        let projection = this.cache.get(id) ?? (0, reducer_1.createEmptyProjection)(id);
+        // 3. Reduce
+        projection = (0, reducer_1.reduce)(projection, event);
+        // 4. Write projection
+        this.storage.writeProjection(id, projection);
+        // 5. Update cache
+        this.cache.set(id, projection);
+        // 6. Notify listeners
+        this.onEvent?.(event);
+    }
+    handleOutput(event) {
+        if (event.type === 'node:output') {
+            this.storage.appendOutput(event.executionId, event.nodeId, event.content);
+        }
+    }
+    writeArtifact(execId, nodeId, name, content) {
+        this.storage.writeArtifact(execId, nodeId, name, content);
+    }
+    // -------------------------------------------------------------------------
+    // Query handlers
+    // -------------------------------------------------------------------------
+    getProjection(id) {
+        return this.cache.get(id) ?? this.storage.readProjection(id);
+    }
+    listExecutions() {
+        return Array.from(this.cache.values());
+    }
+    getNodeOutput(execId, nodeId, offset, limit) {
+        return this.storage.readOutput(execId, nodeId, offset, limit);
+    }
+    getArtifact(execId, nodeId, name) {
+        return this.storage.readArtifact(execId, nodeId, name);
+    }
+    // -------------------------------------------------------------------------
+    // Recovery
+    // -------------------------------------------------------------------------
+    rebuildProjection(execId) {
+        const events = this.storage.readEvents(execId);
+        const projection = (0, reducer_1.replayEvents)(execId, events);
+        this.storage.writeProjection(execId, projection);
+        this.cache.set(execId, projection);
+        return projection;
+    }
+    /** R12a: Hydrate cache from storage. R12b: Mark running executions as crashed. */
+    recoverOnStartup() {
+        for (const id of this.storage.listExecutionIds()) {
+            // SYS-5: Replay from event log (source of truth), not disk projection
+            const events = this.storage.readEvents(id);
+            let projection;
+            if (events.length > 0) {
+                projection = (0, reducer_1.replayEvents)(id, events);
+            }
+            else {
+                // Fallback to disk projection if event log is empty (legacy data)
+                const diskProjection = this.storage.readProjection(id);
+                if (!diskProjection)
+                    continue;
+                projection = diskProjection;
+            }
+            if (projection.status === 'running') {
+                // R12b: Append crash event and update projection
+                const crashEvent = {
+                    type: 'run:completed',
+                    executionId: id,
+                    status: 'crashed',
+                    ts: Date.now(),
+                };
+                this.storage.appendEvent(id, crashEvent);
+                projection = (0, reducer_1.reduce)(projection, crashEvent);
+            }
+            this.storage.writeProjection(id, projection);
+            this.cache.set(id, projection);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Lifecycle
+    // -------------------------------------------------------------------------
+    delete(execId) {
+        this.cache.delete(execId);
+        return this.storage.delete(execId);
+    }
+    shutdown() {
+        for (const id of this.cache.keys()) {
+            const projection = this.cache.get(id);
+            if (projection) {
+                for (const node of projection.graph.nodes) {
+                    this.storage.closeOutput(id, node.id);
+                }
+            }
+        }
+    }
+}
+exports.StateRuntime = StateRuntime;
+//# sourceMappingURL=state-runtime.js.map

package/dist/state/state-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-runtime.js","sourceRoot":"","sources":["../../state/state-runtime.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAQH,uCAAwE;AAExE,MAAa,YAAY;IAMJ;IACA;IANX,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;IACvD,0EAA0E;IAClE,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAEjD,YACmB,OAAsB,EACtB,OAAyC;QADzC,YAAO,GAAP,OAAO,CAAe;QACtB,YAAO,GAAP,OAAO,CAAkC;IACzD,CAAC;IAEJ,4EAA4E;IAC5E,mBAAmB;IACnB,4EAA4E;IAE5E,KAAK,CAAC,WAAW,CAAC,KAAqB;QACrC,MAAM,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC;QAE7B,0DAA0D;QAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAqC,CAAC,CAAC,CAAC,CAAC;QAC5E,MAAM,IAAI,CAAC;IACb,CAAC;IAEO,WAAW,CAAC,KAAqB;QACvC,MAAM,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC;QAE7B,yBAAyB;QACzB,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAEpC,8BAA8B;QAC9B,IAAI,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAA,+BAAqB,EAAC,EAAE,CAAC,CAAC;QAEjE,YAAY;QACZ,UAAU,GAAG,IAAA,gBAAM,EAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAEvC,sBAAsB;QACtB,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAE7C,kBAAkB;QAClB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAE/B,sBAAsB;QACtB,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAED,YAAY,CAAC,KAAkB;QAC7B,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACjC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED,aAAa,CAAC,MAAc,EAAE,MAAc,EAAE,IAAY,EAAE,OAAe;QACzE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,4EAA4E;IAC5E,iBAAiB;IACjB,4EAA4E;IAE5E,aAAa,CAAC,EAAU;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,cAAc;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,aAAa,CAAC,MAAc,EAAE,MAAc,EAAE,MAAe,EAAE,KAAc;QAC3E,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAChE,CAAC;IAED,WAAW,CAAC,MAAc,EAAE,MAAc,EAAE,IAAY;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,4EAA4E;IAC5E,WAAW;IACX,4EAA4E;IAE5E,iBAAiB,CAAC,MAAc;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,IAAA,sBAAY,EAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACnC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,kFAAkF;IAClF,gBAAgB;QACd,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;YACjD,sEAAsE;YACtE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAC3C,IAAI,UAA+B,CAAC;YACpC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,UAAU,GAAG,IAAA,sBAAY,EAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,kEAAkE;gBAClE,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;gBACvD,IAAI,CAAC,cAAc;oBAAE,SAAS;gBAC9B,UAAU,GAAG,cAAc,CAAC;YAC9B,CAAC;YAED,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBACpC,iDAAiD;gBACjD,MAAM,UAAU,GAAmB;oBACjC,IAAI,EAAE,eAAe;oBACrB,WAAW,EAAE,EAAE;oBACf,MAAM,EAAE,SAAS;oBACjB,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;iBACf,CAAC;gBACF,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;gBACzC,UAAU,GAAG,IAAA,gBAAM,EAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAC9C,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;YAC7C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,YAAY;IACZ,4EAA4E;IAE5E,MAAM,CAAC,MAAc;QACnB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,QAAQ;QACN,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YACnC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACtC,IAAI,UAAU,EAAE,CAAC;gBACf,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;oBAC1C,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF;AA3ID,oCA2IC"}

package/dist/state/storage-memory.d.ts

@@ -0,0 +1,24 @@
+/**
+ * In-memory StorageEngine implementation — zero I/O, for tests.
+ */
+import type { StorageEngine, ExecutionProjection, OutputPage } from '../src/types';
+import type { ExecutionEvent } from '../src/events';
+export declare class MemoryStorage implements StorageEngine {
+    private events;
+    private projections;
+    private artifacts;
+    private outputs;
+    private closedOutputs;
+    appendEvent(execId: string, event: ExecutionEvent): void;
+    readEvents(execId: string): ExecutionEvent[];
+    writeProjection(execId: string, projection: ExecutionProjection): void;
+    readProjection(execId: string): ExecutionProjection | null;
+    writeArtifact(execId: string, nodeId: string, name: string, content: string): void;
+    readArtifact(execId: string, nodeId: string, name: string): string | null;
+    appendOutput(execId: string, nodeId: string, line: string): void;
+    readOutput(execId: string, nodeId: string, offset?: number, limit?: number): OutputPage;
+    closeOutput(execId: string, nodeId: string): void;
+    delete(execId: string): boolean;
+    listExecutionIds(): string[];
+}
+//# sourceMappingURL=storage-memory.d.ts.map

package/dist/state/storage-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-memory.d.ts","sourceRoot":"","sources":["../../state/storage-memory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,UAAU,EACX,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,qBAAa,aAAc,YAAW,aAAa;IACjD,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,WAAW,CAA0C;IAC7D,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,aAAa,CAAqB;IAE1C,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IAMxD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE;IAI5C,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,mBAAmB,GAAG,IAAI;IAItE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAI1D,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIlF,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIzE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAOhE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU;IAcvF,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIjD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAyB/B,gBAAgB,IAAI,MAAM,EAAE;CAQ7B"}

package/dist/state/storage-memory.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * In-memory StorageEngine implementation — zero I/O, for tests.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryStorage = void 0;
+class MemoryStorage {
+    events = new Map();
+    projections = new Map();
+    artifacts = new Map();
+    outputs = new Map();
+    closedOutputs = new Set();
+    appendEvent(execId, event) {
+        const arr = this.events.get(execId) ?? [];
+        arr.push(event);
+        this.events.set(execId, arr);
+    }
+    readEvents(execId) {
+        return [...(this.events.get(execId) ?? [])];
+    }
+    writeProjection(execId, projection) {
+        this.projections.set(execId, projection);
+    }
+    readProjection(execId) {
+        return this.projections.get(execId) ?? null;
+    }
+    writeArtifact(execId, nodeId, name, content) {
+        this.artifacts.set(`${execId}:${nodeId}:${name}`, content);
+    }
+    readArtifact(execId, nodeId, name) {
+        return this.artifacts.get(`${execId}:${nodeId}:${name}`) ?? null;
+    }
+    appendOutput(execId, nodeId, line) {
+        const key = `${execId}:${nodeId}`;
+        const arr = this.outputs.get(key) ?? [];
+        arr.push(line);
+        this.outputs.set(key, arr);
+    }
+    readOutput(execId, nodeId, offset, limit) {
+        const key = `${execId}:${nodeId}`;
+        const all = this.outputs.get(key) ?? [];
+        const start = offset ?? 0;
+        const end = limit != null ? start + limit : all.length;
+        const lines = all.slice(start, end);
+        return {
+            lines,
+            offset: start,
+            total: all.length,
+            hasMore: end < all.length,
+        };
+    }
+    closeOutput(execId, nodeId) {
+        this.closedOutputs.add(`${execId}:${nodeId}`);
+    }
+    delete(execId) {
+        let deleted = false;
+        if (this.events.delete(execId))
+            deleted = true;
+        if (this.projections.delete(execId))
+            deleted = true;
+        // Clean up artifacts and outputs with matching prefix
+        for (const key of this.artifacts.keys()) {
+            if (key.startsWith(`${execId}:`)) {
+                this.artifacts.delete(key);
+                deleted = true;
+            }
+        }
+        for (const key of this.outputs.keys()) {
+            if (key.startsWith(`${execId}:`)) {
+                this.outputs.delete(key);
+                deleted = true;
+            }
+        }
+        for (const key of this.closedOutputs) {
+            if (key.startsWith(`${execId}:`)) {
+                this.closedOutputs.delete(key);
+            }
+        }
+        return deleted;
+    }
+    listExecutionIds() {
+        // Union of all keys that have events or projections
+        const ids = new Set([
+            ...this.events.keys(),
+            ...this.projections.keys(),
+        ]);
+        return [...ids];
+    }
+}
+exports.MemoryStorage = MemoryStorage;
+//# sourceMappingURL=storage-memory.js.map

package/dist/state/storage-memory.js.map

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

package/dist/state/storage.d.ts

@@ -0,0 +1,29 @@
+/**
+ * File-based StorageEngine — JSONL event logs, atomic projection writes,
+ * per-node output files, flat artifact files.
+ *
+ * Directory structure:
+ *   {rootDir}/{execId}/events.jsonl
+ *   {rootDir}/{execId}/projection.json
+ *   {rootDir}/{execId}/artifacts/{nodeId}/{name}
+ *   {rootDir}/{execId}/output/{nodeId}.log
+ */
+import type { StorageEngine, ExecutionProjection, OutputPage } from '../src/types';
+import type { ExecutionEvent } from '../src/events';
+export declare class FileStorage implements StorageEngine {
+    private readonly rootDir;
+    constructor(rootDir: string);
+    private execDir;
+    appendEvent(execId: string, event: ExecutionEvent): void;
+    readEvents(execId: string): ExecutionEvent[];
+    writeProjection(execId: string, projection: ExecutionProjection): void;
+    readProjection(execId: string): ExecutionProjection | null;
+    writeArtifact(execId: string, nodeId: string, name: string, content: string): void;
+    readArtifact(execId: string, nodeId: string, name: string): string | null;
+    appendOutput(execId: string, nodeId: string, line: string): void;
+    readOutput(execId: string, nodeId: string, offset?: number, limit?: number): OutputPage;
+    closeOutput(_execId: string, _nodeId: string): void;
+    delete(execId: string): boolean;
+    listExecutionIds(): string[];
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/state/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../state/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,UAAU,EACX,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAmBpD,qBAAa,WAAY,YAAW,aAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAE5C,OAAO,CAAC,OAAO;IAIf,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IAOxD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE;IAiB5C,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,mBAAmB,GAAG,IAAI;IAStE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IAW1D,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAOlF,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMzE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAOhE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU;IAsBvF,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAInD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAO/B,gBAAgB,IAAI,MAAM,EAAE;CAO7B"}