yaml-flow 1.0.0

package/dist/stores/localStorage.js

@@ -0,0 +1,75 @@
+// src/stores/localStorage.ts
+var LocalStorageStore = class {
+  prefix;
+  constructor(options = {}) {
+    this.prefix = options.prefix ?? "yamlflow";
+    if (typeof localStorage === "undefined") {
+      throw new Error("LocalStorageStore requires localStorage (browser environment)");
+    }
+  }
+  runKey(runId) {
+    return `${this.prefix}:run:${runId}`;
+  }
+  dataKey(runId) {
+    return `${this.prefix}:data:${runId}`;
+  }
+  indexKey() {
+    return `${this.prefix}:runs`;
+  }
+  async saveRunState(runId, state) {
+    localStorage.setItem(this.runKey(runId), JSON.stringify(state));
+    const runs = await this.listRuns();
+    if (!runs.includes(runId)) {
+      runs.push(runId);
+      localStorage.setItem(this.indexKey(), JSON.stringify(runs));
+    }
+  }
+  async loadRunState(runId) {
+    const raw = localStorage.getItem(this.runKey(runId));
+    return raw ? JSON.parse(raw) : null;
+  }
+  async deleteRunState(runId) {
+    localStorage.removeItem(this.runKey(runId));
+    localStorage.removeItem(this.dataKey(runId));
+    const runs = await this.listRuns();
+    const filtered = runs.filter((id) => id !== runId);
+    localStorage.setItem(this.indexKey(), JSON.stringify(filtered));
+  }
+  async setData(runId, key, value) {
+    const allData = await this.getAllData(runId);
+    allData[key] = value;
+    localStorage.setItem(this.dataKey(runId), JSON.stringify(allData));
+  }
+  async getData(runId, key) {
+    const allData = await this.getAllData(runId);
+    return allData[key];
+  }
+  async getAllData(runId) {
+    const raw = localStorage.getItem(this.dataKey(runId));
+    return raw ? JSON.parse(raw) : {};
+  }
+  async clearData(runId) {
+    localStorage.removeItem(this.dataKey(runId));
+  }
+  async listRuns() {
+    const raw = localStorage.getItem(this.indexKey());
+    return raw ? JSON.parse(raw) : [];
+  }
+  /**
+   * Clear all flow data from localStorage
+   */
+  clearAll() {
+    const keysToRemove = [];
+    for (let i = 0; i < localStorage.length; i++) {
+      const key = localStorage.key(i);
+      if (key?.startsWith(this.prefix + ":")) {
+        keysToRemove.push(key);
+      }
+    }
+    keysToRemove.forEach((key) => localStorage.removeItem(key));
+  }
+};
+
+export { LocalStorageStore };
+//# sourceMappingURL=localStorage.js.map
+//# sourceMappingURL=localStorage.js.map

package/dist/stores/localStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stores/localStorage.ts"],"names":[],"mappings":"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","file":"localStorage.js","sourcesContent":["/**\n * yaml-flow - LocalStorage Store\n * \n * Browser localStorage-based store implementation.\n * Data persists across page reloads but is limited to ~5MB per origin.\n */\n\nimport type { FlowStore, RunState } from '../core/types.js';\n\nexport interface LocalStorageStoreOptions {\n  /** Key prefix for namespacing (default: 'yamlflow') */\n  prefix?: string;\n}\n\nexport class LocalStorageStore implements FlowStore {\n  private prefix: string;\n\n  constructor(options: LocalStorageStoreOptions = {}) {\n    this.prefix = options.prefix ?? 'yamlflow';\n    \n    // Ensure localStorage is available\n    if (typeof localStorage === 'undefined') {\n      throw new Error('LocalStorageStore requires localStorage (browser environment)');\n    }\n  }\n\n  private runKey(runId: string): string {\n    return `${this.prefix}:run:${runId}`;\n  }\n\n  private dataKey(runId: string): string {\n    return `${this.prefix}:data:${runId}`;\n  }\n\n  private indexKey(): string {\n    return `${this.prefix}:runs`;\n  }\n\n  async saveRunState(runId: string, state: RunState): Promise<void> {\n    localStorage.setItem(this.runKey(runId), JSON.stringify(state));\n    \n    // Update run index\n    const runs = await this.listRuns();\n    if (!runs.includes(runId)) {\n      runs.push(runId);\n      localStorage.setItem(this.indexKey(), JSON.stringify(runs));\n    }\n  }\n\n  async loadRunState(runId: string): Promise<RunState | null> {\n    const raw = localStorage.getItem(this.runKey(runId));\n    return raw ? JSON.parse(raw) : null;\n  }\n\n  async deleteRunState(runId: string): Promise<void> {\n    localStorage.removeItem(this.runKey(runId));\n    localStorage.removeItem(this.dataKey(runId));\n    \n    // Update run index\n    const runs = await this.listRuns();\n    const filtered = runs.filter(id => id !== runId);\n    localStorage.setItem(this.indexKey(), JSON.stringify(filtered));\n  }\n\n  async setData(runId: string, key: string, value: unknown): Promise<void> {\n    const allData = await this.getAllData(runId);\n    allData[key] = value;\n    localStorage.setItem(this.dataKey(runId), JSON.stringify(allData));\n  }\n\n  async getData(runId: string, key: string): Promise<unknown> {\n    const allData = await this.getAllData(runId);\n    return allData[key];\n  }\n\n  async getAllData(runId: string): Promise<Record<string, unknown>> {\n    const raw = localStorage.getItem(this.dataKey(runId));\n    return raw ? JSON.parse(raw) : {};\n  }\n\n  async clearData(runId: string): Promise<void> {\n    localStorage.removeItem(this.dataKey(runId));\n  }\n\n  async listRuns(): Promise<string[]> {\n    const raw = localStorage.getItem(this.indexKey());\n    return raw ? JSON.parse(raw) : [];\n  }\n\n  /**\n   * Clear all flow data from localStorage\n   */\n  clearAll(): void {\n    const keysToRemove: string[] = [];\n    \n    for (let i = 0; i < localStorage.length; i++) {\n      const key = localStorage.key(i);\n      if (key?.startsWith(this.prefix + ':')) {\n        keysToRemove.push(key);\n      }\n    }\n    \n    keysToRemove.forEach(key => localStorage.removeItem(key));\n  }\n}\n"]}

package/dist/stores/memory.cjs

@@ -0,0 +1,48 @@
+'use strict';
+
+// src/stores/memory.ts
+var MemoryStore = class {
+  runs = /* @__PURE__ */ new Map();
+  data = /* @__PURE__ */ new Map();
+  async saveRunState(runId, state) {
+    this.runs.set(runId, { ...state });
+  }
+  async loadRunState(runId) {
+    const state = this.runs.get(runId);
+    return state ? { ...state } : null;
+  }
+  async deleteRunState(runId) {
+    this.runs.delete(runId);
+    this.data.delete(runId);
+  }
+  async setData(runId, key, value) {
+    if (!this.data.has(runId)) {
+      this.data.set(runId, {});
+    }
+    const runData = this.data.get(runId);
+    runData[key] = value;
+  }
+  async getData(runId, key) {
+    return this.data.get(runId)?.[key];
+  }
+  async getAllData(runId) {
+    return { ...this.data.get(runId) ?? {} };
+  }
+  async clearData(runId) {
+    this.data.delete(runId);
+  }
+  async listRuns() {
+    return Array.from(this.runs.keys());
+  }
+  /**
+   * Clear all data (useful for testing)
+   */
+  clear() {
+    this.runs.clear();
+    this.data.clear();
+  }
+};
+
+exports.MemoryStore = MemoryStore;
+//# sourceMappingURL=memory.cjs.map
+//# sourceMappingURL=memory.cjs.map

package/dist/stores/memory.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stores/memory.ts"],"names":[],"mappings":";;;AASO,IAAM,cAAN,MAAuC;AAAA,EACpC,IAAA,uBAAkC,GAAA,EAAI;AAAA,EACtC,IAAA,uBAAiD,GAAA,EAAI;AAAA,EAE7D,MAAM,YAAA,CAAa,KAAA,EAAe,KAAA,EAAgC;AAChE,IAAA,IAAA,CAAK,KAAK,GAAA,CAAI,KAAA,EAAO,EAAE,GAAG,OAAO,CAAA;AAAA,EACnC;AAAA,EAEA,MAAM,aAAa,KAAA,EAAyC;AAC1D,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA;AACjC,IAAA,OAAO,KAAA,GAAQ,EAAE,GAAG,KAAA,EAAM,GAAI,IAAA;AAAA,EAChC;AAAA,EAEA,MAAM,eAAe,KAAA,EAA8B;AACjD,IAAA,IAAA,CAAK,IAAA,CAAK,OAAO,KAAK,CAAA;AACtB,IAAA,IAAA,CAAK,IAAA,CAAK,OAAO,KAAK,CAAA;AAAA,EACxB;AAAA,EAEA,MAAM,OAAA,CAAQ,KAAA,EAAe,GAAA,EAAa,KAAA,EAA+B;AACvE,IAAA,IAAI,CAAC,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA,EAAG;AACzB,MAAA,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,KAAA,EAAO,EAAE,CAAA;AAAA,IACzB;AACA,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA;AACnC,IAAA,OAAA,CAAQ,GAAG,CAAA,GAAI,KAAA;AAAA,EACjB;AAAA,EAEA,MAAM,OAAA,CAAQ,KAAA,EAAe,GAAA,EAA+B;AAC1D,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,KAAK,IAAI,GAAG,CAAA;AAAA,EACnC;AAAA,EAEA,MAAM,WAAW,KAAA,EAAiD;AAChE,IAAA,OAAO,EAAE,GAAI,IAAA,CAAK,IAAA,CAAK,IAAI,KAAK,CAAA,IAAK,EAAC,EAAG;AAAA,EAC3C;AAAA,EAEA,MAAM,UAAU,KAAA,EAA8B;AAC5C,IAAA,IAAA,CAAK,IAAA,CAAK,OAAO,KAAK,CAAA;AAAA,EACxB;AAAA,EAEA,MAAM,QAAA,GAA8B;AAClC,IAAA,OAAO,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,IAAA,CAAK,MAAM,CAAA;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA,EAKA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,KAAK,KAAA,EAAM;AAChB,IAAA,IAAA,CAAK,KAAK,KAAA,EAAM;AAAA,EAClB;AACF","file":"memory.cjs","sourcesContent":["/**\n * yaml-flow - Memory Store\n * \n * In-memory store implementation. Works in both browser and Node.js.\n * Data is lost when the process exits - use for testing or short-lived flows.\n */\n\nimport type { FlowStore, RunState } from '../core/types.js';\n\nexport class MemoryStore implements FlowStore {\n  private runs: Map<string, RunState> = new Map();\n  private data: Map<string, Record<string, unknown>> = new Map();\n\n  async saveRunState(runId: string, state: RunState): Promise<void> {\n    this.runs.set(runId, { ...state });\n  }\n\n  async loadRunState(runId: string): Promise<RunState | null> {\n    const state = this.runs.get(runId);\n    return state ? { ...state } : null;\n  }\n\n  async deleteRunState(runId: string): Promise<void> {\n    this.runs.delete(runId);\n    this.data.delete(runId);\n  }\n\n  async setData(runId: string, key: string, value: unknown): Promise<void> {\n    if (!this.data.has(runId)) {\n      this.data.set(runId, {});\n    }\n    const runData = this.data.get(runId)!;\n    runData[key] = value;\n  }\n\n  async getData(runId: string, key: string): Promise<unknown> {\n    return this.data.get(runId)?.[key];\n  }\n\n  async getAllData(runId: string): Promise<Record<string, unknown>> {\n    return { ...(this.data.get(runId) ?? {}) };\n  }\n\n  async clearData(runId: string): Promise<void> {\n    this.data.delete(runId);\n  }\n\n  async listRuns(): Promise<string[]> {\n    return Array.from(this.runs.keys());\n  }\n\n  /**\n   * Clear all data (useful for testing)\n   */\n  clear(): void {\n    this.runs.clear();\n    this.data.clear();\n  }\n}\n"]}

package/dist/stores/memory.d.cts

@@ -0,0 +1,27 @@
+import { f as FlowStore, g as RunState } from '../types-BoWndaAJ.cjs';
+
+/**
+ * yaml-flow - Memory Store
+ *
+ * In-memory store implementation. Works in both browser and Node.js.
+ * Data is lost when the process exits - use for testing or short-lived flows.
+ */
+
+declare class MemoryStore implements FlowStore {
+    private runs;
+    private data;
+    saveRunState(runId: string, state: RunState): Promise<void>;
+    loadRunState(runId: string): Promise<RunState | null>;
+    deleteRunState(runId: string): Promise<void>;
+    setData(runId: string, key: string, value: unknown): Promise<void>;
+    getData(runId: string, key: string): Promise<unknown>;
+    getAllData(runId: string): Promise<Record<string, unknown>>;
+    clearData(runId: string): Promise<void>;
+    listRuns(): Promise<string[]>;
+    /**
+     * Clear all data (useful for testing)
+     */
+    clear(): void;
+}
+
+export { MemoryStore };

package/dist/stores/memory.d.ts

@@ -0,0 +1,27 @@
+import { f as FlowStore, g as RunState } from '../types-BoWndaAJ.js';
+
+/**
+ * yaml-flow - Memory Store
+ *
+ * In-memory store implementation. Works in both browser and Node.js.
+ * Data is lost when the process exits - use for testing or short-lived flows.
+ */
+
+declare class MemoryStore implements FlowStore {
+    private runs;
+    private data;
+    saveRunState(runId: string, state: RunState): Promise<void>;
+    loadRunState(runId: string): Promise<RunState | null>;
+    deleteRunState(runId: string): Promise<void>;
+    setData(runId: string, key: string, value: unknown): Promise<void>;
+    getData(runId: string, key: string): Promise<unknown>;
+    getAllData(runId: string): Promise<Record<string, unknown>>;
+    clearData(runId: string): Promise<void>;
+    listRuns(): Promise<string[]>;
+    /**
+     * Clear all data (useful for testing)
+     */
+    clear(): void;
+}
+
+export { MemoryStore };

package/dist/stores/memory.js

@@ -0,0 +1,46 @@
+// src/stores/memory.ts
+var MemoryStore = class {
+  runs = /* @__PURE__ */ new Map();
+  data = /* @__PURE__ */ new Map();
+  async saveRunState(runId, state) {
+    this.runs.set(runId, { ...state });
+  }
+  async loadRunState(runId) {
+    const state = this.runs.get(runId);
+    return state ? { ...state } : null;
+  }
+  async deleteRunState(runId) {
+    this.runs.delete(runId);
+    this.data.delete(runId);
+  }
+  async setData(runId, key, value) {
+    if (!this.data.has(runId)) {
+      this.data.set(runId, {});
+    }
+    const runData = this.data.get(runId);
+    runData[key] = value;
+  }
+  async getData(runId, key) {
+    return this.data.get(runId)?.[key];
+  }
+  async getAllData(runId) {
+    return { ...this.data.get(runId) ?? {} };
+  }
+  async clearData(runId) {
+    this.data.delete(runId);
+  }
+  async listRuns() {
+    return Array.from(this.runs.keys());
+  }
+  /**
+   * Clear all data (useful for testing)
+   */
+  clear() {
+    this.runs.clear();
+    this.data.clear();
+  }
+};
+
+export { MemoryStore };
+//# sourceMappingURL=memory.js.map
+//# sourceMappingURL=memory.js.map

package/dist/stores/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/stores/memory.ts"],"names":[],"mappings":";AASO,IAAM,cAAN,MAAuC;AAAA,EACpC,IAAA,uBAAkC,GAAA,EAAI;AAAA,EACtC,IAAA,uBAAiD,GAAA,EAAI;AAAA,EAE7D,MAAM,YAAA,CAAa,KAAA,EAAe,KAAA,EAAgC;AAChE,IAAA,IAAA,CAAK,KAAK,GAAA,CAAI,KAAA,EAAO,EAAE,GAAG,OAAO,CAAA;AAAA,EACnC;AAAA,EAEA,MAAM,aAAa,KAAA,EAAyC;AAC1D,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA;AACjC,IAAA,OAAO,KAAA,GAAQ,EAAE,GAAG,KAAA,EAAM,GAAI,IAAA;AAAA,EAChC;AAAA,EAEA,MAAM,eAAe,KAAA,EAA8B;AACjD,IAAA,IAAA,CAAK,IAAA,CAAK,OAAO,KAAK,CAAA;AACtB,IAAA,IAAA,CAAK,IAAA,CAAK,OAAO,KAAK,CAAA;AAAA,EACxB;AAAA,EAEA,MAAM,OAAA,CAAQ,KAAA,EAAe,GAAA,EAAa,KAAA,EAA+B;AACvE,IAAA,IAAI,CAAC,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA,EAAG;AACzB,MAAA,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,KAAA,EAAO,EAAE,CAAA;AAAA,IACzB;AACA,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA;AACnC,IAAA,OAAA,CAAQ,GAAG,CAAA,GAAI,KAAA;AAAA,EACjB;AAAA,EAEA,MAAM,OAAA,CAAQ,KAAA,EAAe,GAAA,EAA+B;AAC1D,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,KAAK,IAAI,GAAG,CAAA;AAAA,EACnC;AAAA,EAEA,MAAM,WAAW,KAAA,EAAiD;AAChE,IAAA,OAAO,EAAE,GAAI,IAAA,CAAK,IAAA,CAAK,IAAI,KAAK,CAAA,IAAK,EAAC,EAAG;AAAA,EAC3C;AAAA,EAEA,MAAM,UAAU,KAAA,EAA8B;AAC5C,IAAA,IAAA,CAAK,IAAA,CAAK,OAAO,KAAK,CAAA;AAAA,EACxB;AAAA,EAEA,MAAM,QAAA,GAA8B;AAClC,IAAA,OAAO,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,IAAA,CAAK,MAAM,CAAA;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA,EAKA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,KAAK,KAAA,EAAM;AAChB,IAAA,IAAA,CAAK,KAAK,KAAA,EAAM;AAAA,EAClB;AACF","file":"memory.js","sourcesContent":["/**\n * yaml-flow - Memory Store\n * \n * In-memory store implementation. Works in both browser and Node.js.\n * Data is lost when the process exits - use for testing or short-lived flows.\n */\n\nimport type { FlowStore, RunState } from '../core/types.js';\n\nexport class MemoryStore implements FlowStore {\n  private runs: Map<string, RunState> = new Map();\n  private data: Map<string, Record<string, unknown>> = new Map();\n\n  async saveRunState(runId: string, state: RunState): Promise<void> {\n    this.runs.set(runId, { ...state });\n  }\n\n  async loadRunState(runId: string): Promise<RunState | null> {\n    const state = this.runs.get(runId);\n    return state ? { ...state } : null;\n  }\n\n  async deleteRunState(runId: string): Promise<void> {\n    this.runs.delete(runId);\n    this.data.delete(runId);\n  }\n\n  async setData(runId: string, key: string, value: unknown): Promise<void> {\n    if (!this.data.has(runId)) {\n      this.data.set(runId, {});\n    }\n    const runData = this.data.get(runId)!;\n    runData[key] = value;\n  }\n\n  async getData(runId: string, key: string): Promise<unknown> {\n    return this.data.get(runId)?.[key];\n  }\n\n  async getAllData(runId: string): Promise<Record<string, unknown>> {\n    return { ...(this.data.get(runId) ?? {}) };\n  }\n\n  async clearData(runId: string): Promise<void> {\n    this.data.delete(runId);\n  }\n\n  async listRuns(): Promise<string[]> {\n    return Array.from(this.runs.keys());\n  }\n\n  /**\n   * Clear all data (useful for testing)\n   */\n  clear(): void {\n    this.runs.clear();\n    this.data.clear();\n  }\n}\n"]}

package/dist/types-BoWndaAJ.d.cts

@@ -0,0 +1,237 @@
+/**
+ * yaml-flow - Core Types
+ *
+ * All type definitions for the workflow engine.
+ */
+/**
+ * Root flow configuration - maps to YAML file structure
+ */
+interface FlowConfig {
+    /** Optional flow identifier */
+    id?: string;
+    /** Flow settings */
+    settings: FlowSettings;
+    /** Step definitions */
+    steps: Record<string, StepConfig>;
+    /** Terminal state definitions */
+    terminal_states: Record<string, TerminalStateConfig>;
+}
+/**
+ * Flow-level settings
+ */
+interface FlowSettings {
+    /** Step to start execution from */
+    start_step: string;
+    /** Maximum steps before forced termination (default: 100) */
+    max_total_steps?: number;
+    /** Flow timeout in milliseconds (optional) */
+    timeout_ms?: number;
+}
+/**
+ * Individual step configuration
+ */
+interface StepConfig {
+    /** Human-readable description */
+    description?: string;
+    /** Data keys this step expects as input */
+    expects_data?: string[];
+    /** Data keys this step produces as output */
+    produces_data?: string[];
+    /** Transition mapping: result -> next step name */
+    transitions: Record<string, string>;
+    /** Retry configuration for failures */
+    retry?: RetryConfig;
+    /** Circuit breaker for loops */
+    circuit_breaker?: CircuitBreakerConfig;
+}
+/**
+ * Retry configuration for step failures
+ */
+interface RetryConfig {
+    /** Maximum retry attempts */
+    max_attempts: number;
+    /** Delay between retries in ms */
+    delay_ms?: number;
+    /** Backoff multiplier (e.g., 2 for exponential) */
+    backoff_multiplier?: number;
+}
+/**
+ * Circuit breaker configuration
+ */
+interface CircuitBreakerConfig {
+    /** Maximum iterations before circuit opens */
+    max_iterations: number;
+    /** Step to transition to when circuit opens */
+    on_open: string;
+}
+/**
+ * Terminal state configuration
+ */
+interface TerminalStateConfig {
+    /** Human-readable description */
+    description?: string;
+    /** Intent/status to return (e.g., 'success', 'error', 'cancelled') */
+    return_intent: string;
+    /** Data key(s) to include in result, or false to exclude */
+    return_artifacts?: string | string[] | false;
+    /** Data keys this terminal state expects */
+    expects_data?: string[];
+}
+/**
+ * Step handler function signature
+ */
+type StepHandler = (input: StepInput, context: StepContext) => StepResult | Promise<StepResult>;
+/**
+ * Input passed to step handlers
+ */
+interface StepInput {
+    /** Data from previous steps based on expects_data */
+    [key: string]: unknown;
+}
+/**
+ * Context available to step handlers
+ */
+interface StepContext {
+    /** Run identifier */
+    runId: string;
+    /** Current step name */
+    stepName: string;
+    /** Injected components (DB, API clients, etc.) */
+    components: Record<string, unknown>;
+    /** Store instance for direct access if needed */
+    store: FlowStore;
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
+    /** Emit events for UI updates */
+    emit: (event: string, data: unknown) => void;
+}
+/**
+ * Result returned from step handlers
+ */
+interface StepResult {
+    /** Result key for transition routing (e.g., 'success', 'failure', 'retry') */
+    result: string;
+    /** Data to merge into flow state (must match produces_data) */
+    data?: Record<string, unknown>;
+}
+/**
+ * Engine configuration options
+ */
+interface EngineOptions {
+    /** Persistence store (default: MemoryStore) */
+    store?: FlowStore;
+    /** Injected components available to handlers */
+    components?: Record<string, unknown>;
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
+    /** Callback on each step execution */
+    onStep?: (stepName: string, result: StepResult) => void;
+    /** Callback on step transition */
+    onTransition?: (from: string, to: string) => void;
+    /** Callback on flow completion */
+    onComplete?: (result: FlowResult) => void;
+    /** Callback on flow error */
+    onError?: (error: Error) => void;
+}
+/**
+ * Final result of flow execution
+ */
+interface FlowResult {
+    /** Run identifier */
+    runId: string;
+    /** Completion status */
+    status: 'completed' | 'failed' | 'cancelled' | 'timeout' | 'max_iterations';
+    /** Return intent from terminal state */
+    intent?: string;
+    /** Returned artifacts/data */
+    data: Record<string, unknown>;
+    /** Final step name */
+    finalStep: string;
+    /** Steps executed (in order) */
+    stepHistory: string[];
+    /** Total execution time in ms */
+    durationMs: number;
+    /** Error if failed */
+    error?: Error;
+}
+/**
+ * Pluggable store interface for persistence
+ */
+interface FlowStore {
+    /**
+     * Save run state
+     */
+    saveRunState(runId: string, state: RunState): Promise<void>;
+    /**
+     * Load run state
+     */
+    loadRunState(runId: string): Promise<RunState | null>;
+    /**
+     * Delete run state
+     */
+    deleteRunState(runId: string): Promise<void>;
+    /**
+     * Set a data value for a run
+     */
+    setData(runId: string, key: string, value: unknown): Promise<void>;
+    /**
+     * Get a data value for a run
+     */
+    getData(runId: string, key: string): Promise<unknown>;
+    /**
+     * Get all data for a run
+     */
+    getAllData(runId: string): Promise<Record<string, unknown>>;
+    /**
+     * Clear all data for a run
+     */
+    clearData(runId: string): Promise<void>;
+    /**
+     * List all active run IDs (optional - for management)
+     */
+    listRuns?(): Promise<string[]>;
+}
+/**
+ * Persisted run state
+ */
+interface RunState {
+    /** Run identifier */
+    runId: string;
+    /** Flow identifier */
+    flowId: string;
+    /** Current step name */
+    currentStep: string;
+    /** Execution status */
+    status: 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
+    /** Ordered list of executed steps */
+    stepHistory: string[];
+    /** Iteration count per step (for circuit breakers) */
+    iterationCounts: Record<string, number>;
+    /** Retry counts per step */
+    retryCounts: Record<string, number>;
+    /** Timestamp when run started (ms since epoch) */
+    startedAt: number;
+    /** Timestamp of last update (ms since epoch) */
+    updatedAt: number;
+    /** Timestamp when paused (if applicable) */
+    pausedAt?: number;
+}
+/**
+ * Event types emitted by the engine
+ */
+type FlowEventType = 'step:start' | 'step:complete' | 'step:error' | 'transition' | 'flow:start' | 'flow:complete' | 'flow:error' | 'flow:paused' | 'flow:resumed';
+/**
+ * Event payload structure
+ */
+interface FlowEvent {
+    type: FlowEventType;
+    runId: string;
+    timestamp: number;
+    data: Record<string, unknown>;
+}
+/**
+ * Event listener function
+ */
+type FlowEventListener = (event: FlowEvent) => void;
+
+export type { CircuitBreakerConfig as C, EngineOptions as E, FlowConfig as F, RetryConfig as R, StepConfig as S, TerminalStateConfig as T, FlowEvent as a, FlowEventListener as b, FlowEventType as c, FlowResult as d, FlowSettings as e, FlowStore as f, RunState as g, StepContext as h, StepHandler as i, StepInput as j, StepResult as k };