yaml-flow 1.0.0 → 2.0.0

package/dist/step-machine/index.cjs

@@ -0,0 +1,513 @@
+'use strict';
+
+// src/step-machine/reducer.ts
+function applyStepResult(flow, state, stepName, stepResult) {
+  const stepConfig = flow.steps[stepName];
+  if (!stepConfig) {
+    throw new Error(`Step "${stepName}" not found in flow configuration`);
+  }
+  if (stepResult.result === "failure" && stepConfig.retry) {
+    const retryCount = state.retryCounts[stepName] ?? 0;
+    if (retryCount < stepConfig.retry.max_attempts) {
+      return {
+        newState: {
+          ...state,
+          retryCounts: {
+            ...state.retryCounts,
+            [stepName]: retryCount + 1
+          },
+          updatedAt: Date.now()
+        },
+        nextStep: stepName,
+        isTerminal: false,
+        isCircuitBroken: false,
+        shouldRetry: true
+      };
+    }
+  }
+  const nextStep = stepConfig.transitions[stepResult.result];
+  if (!nextStep) {
+    throw new Error(
+      `No transition defined for result "${stepResult.result}" in step "${stepName}"`
+    );
+  }
+  const isTerminal = !!flow.terminal_states[nextStep];
+  return {
+    newState: {
+      ...state,
+      currentStep: nextStep,
+      stepHistory: [...state.stepHistory, stepName],
+      retryCounts: {
+        ...state.retryCounts,
+        [stepName]: 0
+      },
+      updatedAt: Date.now()
+    },
+    nextStep,
+    isTerminal,
+    isCircuitBroken: false,
+    shouldRetry: false
+  };
+}
+function checkCircuitBreaker(flow, state, stepName) {
+  const stepConfig = flow.steps[stepName];
+  if (!stepConfig?.circuit_breaker) {
+    return {
+      broken: false,
+      newState: {
+        ...state,
+        iterationCounts: {
+          ...state.iterationCounts,
+          [stepName]: (state.iterationCounts[stepName] ?? 0) + 1
+        },
+        updatedAt: Date.now()
+      }
+    };
+  }
+  const count = state.iterationCounts[stepName] ?? 0;
+  if (count >= stepConfig.circuit_breaker.max_iterations) {
+    return {
+      broken: true,
+      redirectStep: stepConfig.circuit_breaker.on_open,
+      newState: {
+        ...state,
+        currentStep: stepConfig.circuit_breaker.on_open,
+        updatedAt: Date.now()
+      }
+    };
+  }
+  return {
+    broken: false,
+    newState: {
+      ...state,
+      iterationCounts: {
+        ...state.iterationCounts,
+        [stepName]: count + 1
+      },
+      updatedAt: Date.now()
+    }
+  };
+}
+function computeStepInput(flow, stepName, allData) {
+  const stepConfig = flow.steps[stepName];
+  if (!stepConfig) {
+    throw new Error(`Step "${stepName}" not found`);
+  }
+  if (stepConfig.expects_data) {
+    const input = {};
+    for (const key of stepConfig.expects_data) {
+      input[key] = allData[key];
+    }
+    return input;
+  }
+  return { ...allData };
+}
+function extractReturnData(returnArtifacts, allData) {
+  if (returnArtifacts === false || returnArtifacts === void 0) {
+    return {};
+  }
+  if (typeof returnArtifacts === "string") {
+    return { [returnArtifacts]: allData[returnArtifacts] };
+  }
+  if (Array.isArray(returnArtifacts)) {
+    const result = {};
+    for (const key of returnArtifacts) {
+      result[key] = allData[key];
+    }
+    return result;
+  }
+  return {};
+}
+function createInitialState(flow, runId) {
+  const now = Date.now();
+  return {
+    runId,
+    flowId: flow.id ?? "unnamed",
+    currentStep: flow.settings.start_step,
+    status: "running",
+    stepHistory: [],
+    iterationCounts: {},
+    retryCounts: {},
+    startedAt: now,
+    updatedAt: now
+  };
+}
+
+// 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();
+  }
+};
+
+// src/step-machine/StepMachine.ts
+function generateRunId() {
+  if (typeof crypto !== "undefined" && crypto.randomUUID) {
+    return crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+var StepMachine = class {
+  flow;
+  handlers;
+  store;
+  components;
+  options;
+  listeners = /* @__PURE__ */ new Map();
+  aborted = false;
+  constructor(flow, handlers, options = {}) {
+    this.flow = flow;
+    this.handlers = new Map(Object.entries(handlers));
+    this.store = options.store ?? new MemoryStore();
+    this.components = options.components ?? {};
+    this.options = options;
+    if (options.signal) {
+      options.signal.addEventListener("abort", () => {
+        this.aborted = true;
+      });
+    }
+    this.validateFlow();
+  }
+  validateFlow() {
+    const { settings, steps, terminal_states } = this.flow;
+    if (!settings?.start_step) {
+      throw new Error("Flow must have settings.start_step defined");
+    }
+    if (!steps || Object.keys(steps).length === 0) {
+      throw new Error("Flow must have at least one step defined");
+    }
+    if (!terminal_states || Object.keys(terminal_states).length === 0) {
+      throw new Error("Flow must have at least one terminal_state defined");
+    }
+    if (!steps[settings.start_step] && !terminal_states[settings.start_step]) {
+      throw new Error(`Start step "${settings.start_step}" not found`);
+    }
+    for (const [stepName, stepConfig] of Object.entries(steps)) {
+      for (const [result, target] of Object.entries(stepConfig.transitions)) {
+        if (!steps[target] && !terminal_states[target]) {
+          throw new Error(
+            `Step "${stepName}" transition "${result}" points to unknown step "${target}"`
+          );
+        }
+      }
+    }
+  }
+  on(eventType, listener) {
+    if (!this.listeners.has(eventType)) {
+      this.listeners.set(eventType, /* @__PURE__ */ new Set());
+    }
+    this.listeners.get(eventType).add(listener);
+  }
+  off(eventType, listener) {
+    this.listeners.get(eventType)?.delete(listener);
+  }
+  emit(event) {
+    const typeListeners = this.listeners.get(event.type);
+    if (typeListeners) {
+      for (const listener of typeListeners) {
+        try {
+          listener(event);
+        } catch {
+        }
+      }
+    }
+  }
+  sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+  async run(initialData) {
+    const runId = generateRunId();
+    let runState = createInitialState(this.flow, runId);
+    await this.store.saveRunState(runId, runState);
+    if (initialData) {
+      for (const [key, value] of Object.entries(initialData)) {
+        await this.store.setData(runId, key, value);
+      }
+    }
+    this.emit({
+      type: "flow:start",
+      runId,
+      timestamp: runState.startedAt,
+      data: { initialData: initialData ?? {} }
+    });
+    try {
+      return await this.executeLoop(runId, runState);
+    } catch (error) {
+      const err = error instanceof Error ? error : new Error(String(error));
+      this.emit({ type: "flow:error", runId, timestamp: Date.now(), data: { error: err.message } });
+      this.options.onError?.(err);
+      runState = { ...runState, status: "failed", updatedAt: Date.now() };
+      await this.store.saveRunState(runId, runState);
+      return {
+        runId,
+        status: "failed",
+        data: await this.store.getAllData(runId),
+        finalStep: runState.currentStep,
+        stepHistory: runState.stepHistory,
+        durationMs: Date.now() - runState.startedAt,
+        error: err
+      };
+    }
+  }
+  async resume(runId) {
+    const runState = await this.store.loadRunState(runId);
+    if (!runState) throw new Error(`No run found with ID: ${runId}`);
+    if (runState.status === "completed" || runState.status === "failed") {
+      throw new Error(`Cannot resume a ${runState.status} run`);
+    }
+    const updated = { ...runState, status: "running", pausedAt: void 0, updatedAt: Date.now() };
+    await this.store.saveRunState(runId, updated);
+    this.emit({ type: "flow:resumed", runId, timestamp: Date.now(), data: { currentStep: updated.currentStep } });
+    return this.executeLoop(runId, updated);
+  }
+  async pause(runId) {
+    const runState = await this.store.loadRunState(runId);
+    if (!runState) throw new Error(`No run found with ID: ${runId}`);
+    const updated = { ...runState, status: "paused", pausedAt: Date.now(), updatedAt: Date.now() };
+    await this.store.saveRunState(runId, updated);
+    this.emit({ type: "flow:paused", runId, timestamp: Date.now(), data: { currentStep: updated.currentStep } });
+  }
+  async executeLoop(runId, runState) {
+    const maxSteps = this.flow.settings.max_total_steps ?? 100;
+    const timeoutMs = this.flow.settings.timeout_ms;
+    let current = runState;
+    let iterations = 0;
+    while (iterations < maxSteps) {
+      if (this.aborted) {
+        current = { ...current, status: "cancelled", updatedAt: Date.now() };
+        await this.store.saveRunState(runId, current);
+        return { runId, status: "cancelled", data: await this.store.getAllData(runId), finalStep: current.currentStep, stepHistory: current.stepHistory, durationMs: Date.now() - current.startedAt };
+      }
+      if (timeoutMs && Date.now() - current.startedAt > timeoutMs) {
+        current = { ...current, status: "completed", updatedAt: Date.now() };
+        await this.store.saveRunState(runId, current);
+        return { runId, status: "timeout", intent: "timeout", data: await this.store.getAllData(runId), finalStep: current.currentStep, stepHistory: current.stepHistory, durationMs: Date.now() - current.startedAt };
+      }
+      const stepName = current.currentStep;
+      const terminalState = this.flow.terminal_states[stepName];
+      if (terminalState) {
+        current = { ...current, status: "completed", updatedAt: Date.now() };
+        await this.store.saveRunState(runId, current);
+        const allData2 = await this.store.getAllData(runId);
+        const result = {
+          runId,
+          status: "completed",
+          intent: terminalState.return_intent,
+          data: extractReturnData(terminalState.return_artifacts, allData2),
+          finalStep: stepName,
+          stepHistory: current.stepHistory,
+          durationMs: Date.now() - current.startedAt
+        };
+        this.emit({ type: "flow:complete", runId, timestamp: Date.now(), data: { ...result } });
+        this.options.onComplete?.(result);
+        return result;
+      }
+      const cbResult = checkCircuitBreaker(this.flow, current, stepName);
+      if (cbResult.broken) {
+        current = cbResult.newState;
+        await this.store.saveRunState(runId, current);
+        iterations++;
+        continue;
+      }
+      current = cbResult.newState;
+      const allData = await this.store.getAllData(runId);
+      const input = computeStepInput(this.flow, stepName, allData);
+      const context = {
+        runId,
+        stepName,
+        components: this.components,
+        store: this.store,
+        signal: this.options.signal,
+        emit: (event, data) => {
+          this.emit({ type: "step:complete", runId, timestamp: Date.now(), data: { event, payload: data } });
+        }
+      };
+      this.emit({ type: "step:start", runId, timestamp: Date.now(), data: { step: stepName, input } });
+      let stepResult;
+      try {
+        const handler = this.handlers.get(stepName);
+        if (!handler) throw new Error(`No handler registered for step "${stepName}"`);
+        stepResult = await handler(input, context);
+      } catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        this.emit({ type: "step:error", runId, timestamp: Date.now(), data: { step: stepName, error: err.message } });
+        stepResult = { result: "failure", data: { error: err.message } };
+      }
+      if (stepResult.data) {
+        for (const [key, value] of Object.entries(stepResult.data)) {
+          await this.store.setData(runId, key, value);
+        }
+      }
+      this.emit({ type: "step:complete", runId, timestamp: Date.now(), data: { step: stepName, result: stepResult.result } });
+      this.options.onStep?.(stepName, stepResult);
+      const reducerResult = applyStepResult(this.flow, current, stepName, stepResult);
+      current = reducerResult.newState;
+      if (reducerResult.shouldRetry) {
+        await this.store.saveRunState(runId, current);
+        const stepConfig = this.flow.steps[stepName];
+        if (stepConfig.retry?.delay_ms) {
+          const retryCount = current.retryCounts[stepName] ?? 0;
+          const delay = stepConfig.retry.backoff_multiplier ? stepConfig.retry.delay_ms * Math.pow(stepConfig.retry.backoff_multiplier, retryCount - 1) : stepConfig.retry.delay_ms;
+          await this.sleep(delay);
+        }
+        iterations++;
+        continue;
+      }
+      await this.store.saveRunState(runId, current);
+      this.emit({ type: "transition", runId, timestamp: Date.now(), data: { from: stepName, to: current.currentStep, result: stepResult.result } });
+      this.options.onTransition?.(stepName, current.currentStep);
+      iterations++;
+    }
+    current = { ...current, status: "completed", updatedAt: Date.now() };
+    await this.store.saveRunState(runId, current);
+    return { runId, status: "max_iterations", intent: "max_iterations", data: await this.store.getAllData(runId), finalStep: current.currentStep, stepHistory: current.stepHistory, durationMs: Date.now() - current.startedAt };
+  }
+};
+function createStepMachine(flow, handlers, options) {
+  return new StepMachine(flow, handlers, options);
+}
+
+// src/step-machine/loader.ts
+async function parseStepFlowYaml(yamlString) {
+  const yaml = await import('yaml');
+  return yaml.parse(yamlString);
+}
+async function loadStepFlowFromUrl(url) {
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(`Failed to load flow from ${url}: ${response.statusText}`);
+  }
+  const contentType = response.headers.get("content-type") ?? "";
+  const text = await response.text();
+  if (contentType.includes("json") || url.endsWith(".json")) {
+    return JSON.parse(text);
+  }
+  return parseStepFlowYaml(text);
+}
+async function loadStepFlowFromFile(filePath) {
+  const fs = await import('fs/promises');
+  const text = await fs.readFile(filePath, "utf-8");
+  if (filePath.endsWith(".json")) {
+    return JSON.parse(text);
+  }
+  return parseStepFlowYaml(text);
+}
+function validateStepFlowConfig(flow) {
+  const errors = [];
+  if (!flow || typeof flow !== "object") {
+    return ["Flow must be an object"];
+  }
+  const f = flow;
+  if (!f.settings || typeof f.settings !== "object") {
+    errors.push('Flow must have a "settings" object');
+  } else {
+    const settings = f.settings;
+    if (typeof settings.start_step !== "string") {
+      errors.push("settings.start_step must be a string");
+    }
+  }
+  if (!f.steps || typeof f.steps !== "object") {
+    errors.push('Flow must have a "steps" object');
+  } else {
+    const steps = f.steps;
+    for (const [stepName, stepConfig] of Object.entries(steps)) {
+      if (!stepConfig || typeof stepConfig !== "object") {
+        errors.push(`Step "${stepName}" must be an object`);
+        continue;
+      }
+      const step = stepConfig;
+      if (!step.transitions || typeof step.transitions !== "object") {
+        errors.push(`Step "${stepName}" must have a "transitions" object`);
+      }
+    }
+  }
+  if (!f.terminal_states || typeof f.terminal_states !== "object") {
+    errors.push('Flow must have a "terminal_states" object');
+  } else {
+    const terminals = f.terminal_states;
+    for (const [name, config] of Object.entries(terminals)) {
+      if (!config || typeof config !== "object") {
+        errors.push(`Terminal state "${name}" must be an object`);
+        continue;
+      }
+      const terminal = config;
+      if (typeof terminal.return_intent !== "string") {
+        errors.push(`Terminal state "${name}" must have a "return_intent" string`);
+      }
+    }
+  }
+  return errors;
+}
+async function loadStepFlow(source) {
+  let flow;
+  if (typeof source === "string") {
+    if (source.startsWith("http://") || source.startsWith("https://")) {
+      flow = await loadStepFlowFromUrl(source);
+    } else if (source.includes("{")) {
+      flow = JSON.parse(source);
+    } else {
+      flow = await loadStepFlowFromFile(source);
+    }
+  } else {
+    flow = source;
+  }
+  const errors = validateStepFlowConfig(flow);
+  if (errors.length > 0) {
+    throw new Error(`Invalid step flow configuration:
+- ${errors.join("\n- ")}`);
+  }
+  return flow;
+}
+
+exports.StepMachine = StepMachine;
+exports.applyStepResult = applyStepResult;
+exports.checkCircuitBreaker = checkCircuitBreaker;
+exports.computeStepInput = computeStepInput;
+exports.createInitialState = createInitialState;
+exports.createStepMachine = createStepMachine;
+exports.extractReturnData = extractReturnData;
+exports.loadStepFlow = loadStepFlow;
+exports.parseStepFlowYaml = parseStepFlowYaml;
+exports.validateStepFlowConfig = validateStepFlowConfig;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/step-machine/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/step-machine/reducer.ts","../../src/stores/memory.ts","../../src/step-machine/StepMachine.ts","../../src/step-machine/loader.ts"],"names":["allData"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Step Machine Reducer — Pure Functions\n *\n * currentState + stepResult → newState\n * No I/O, no side effects, deterministic.\n */\n\nimport type {\n  StepFlowConfig,\n  StepMachineState,\n  StepResult,\n  StepReducerResult,\n} from './types.js';\n\n/**\n * Apply a step result to the current state and compute the next state.\n * Pure function: no side effects.\n */\nexport function applyStepResult(\n  flow: StepFlowConfig,\n  state: StepMachineState,\n  stepName: string,\n  stepResult: StepResult\n): StepReducerResult {\n  const stepConfig = flow.steps[stepName];\n\n  if (!stepConfig) {\n    throw new Error(`Step \"${stepName}\" not found in flow configuration`);\n  }\n\n  // Check retry\n  if (stepResult.result === 'failure' && stepConfig.retry) {\n    const retryCount = state.retryCounts[stepName] ?? 0;\n    if (retryCount < stepConfig.retry.max_attempts) {\n      return {\n        newState: {\n          ...state,\n          retryCounts: {\n            ...state.retryCounts,\n            [stepName]: retryCount + 1,\n          },\n          updatedAt: Date.now(),\n        },\n        nextStep: stepName,\n        isTerminal: false,\n        isCircuitBroken: false,\n        shouldRetry: true,\n      };\n    }\n  }\n\n  // Find transition\n  const nextStep = stepConfig.transitions[stepResult.result];\n  if (!nextStep) {\n    throw new Error(\n      `No transition defined for result \"${stepResult.result}\" in step \"${stepName}\"`\n    );\n  }\n\n  // Check if next is terminal\n  const isTerminal = !!flow.terminal_states[nextStep];\n\n  return {\n    newState: {\n      ...state,\n      currentStep: nextStep,\n      stepHistory: [...state.stepHistory, stepName],\n      retryCounts: {\n        ...state.retryCounts,\n        [stepName]: 0,\n      },\n      updatedAt: Date.now(),\n    },\n    nextStep,\n    isTerminal,\n    isCircuitBroken: false,\n    shouldRetry: false,\n  };\n}\n\n/**\n * Check circuit breaker for a step. Returns the redirected step if broken.\n * Pure function.\n */\nexport function checkCircuitBreaker(\n  flow: StepFlowConfig,\n  state: StepMachineState,\n  stepName: string\n): { broken: boolean; redirectStep?: string; newState: StepMachineState } {\n  const stepConfig = flow.steps[stepName];\n  if (!stepConfig?.circuit_breaker) {\n    return {\n      broken: false,\n      newState: {\n        ...state,\n        iterationCounts: {\n          ...state.iterationCounts,\n          [stepName]: (state.iterationCounts[stepName] ?? 0) + 1,\n        },\n        updatedAt: Date.now(),\n      },\n    };\n  }\n\n  const count = state.iterationCounts[stepName] ?? 0;\n  if (count >= stepConfig.circuit_breaker.max_iterations) {\n    return {\n      broken: true,\n      redirectStep: stepConfig.circuit_breaker.on_open,\n      newState: {\n        ...state,\n        currentStep: stepConfig.circuit_breaker.on_open,\n        updatedAt: Date.now(),\n      },\n    };\n  }\n\n  return {\n    broken: false,\n    newState: {\n      ...state,\n      iterationCounts: {\n        ...state.iterationCounts,\n        [stepName]: count + 1,\n      },\n      updatedAt: Date.now(),\n    },\n  };\n}\n\n/**\n * Compute what a step needs as input. Pure function.\n */\nexport function computeStepInput(\n  flow: StepFlowConfig,\n  stepName: string,\n  allData: Record<string, unknown>\n): Record<string, unknown> {\n  const stepConfig = flow.steps[stepName];\n  if (!stepConfig) {\n    throw new Error(`Step \"${stepName}\" not found`);\n  }\n\n  if (stepConfig.expects_data) {\n    const input: Record<string, unknown> = {};\n    for (const key of stepConfig.expects_data) {\n      input[key] = allData[key];\n    }\n    return input;\n  }\n\n  // If no expects_data, pass all data\n  return { ...allData };\n}\n\n/**\n * Extract return data from terminal state. Pure function.\n */\nexport function extractReturnData(\n  returnArtifacts: string | string[] | false | undefined,\n  allData: Record<string, unknown>\n): Record<string, unknown> {\n  if (returnArtifacts === false || returnArtifacts === undefined) {\n    return {};\n  }\n\n  if (typeof returnArtifacts === 'string') {\n    return { [returnArtifacts]: allData[returnArtifacts] };\n  }\n\n  if (Array.isArray(returnArtifacts)) {\n    const result: Record<string, unknown> = {};\n    for (const key of returnArtifacts) {\n      result[key] = allData[key];\n    }\n    return result;\n  }\n\n  return {};\n}\n\n/**\n * Create initial state for a new run. Pure function.\n */\nexport function createInitialState(\n  flow: StepFlowConfig,\n  runId: string\n): StepMachineState {\n  const now = Date.now();\n  return {\n    runId,\n    flowId: flow.id ?? 'unnamed',\n    currentStep: flow.settings.start_step,\n    status: 'running',\n    stepHistory: [],\n    iterationCounts: {},\n    retryCounts: {},\n    startedAt: now,\n    updatedAt: now,\n  };\n}\n","/**\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 { StepMachineStore, StepMachineState } from '../step-machine/types.js';\n\nexport class MemoryStore implements StepMachineStore {\n  private runs: Map<string, StepMachineState> = new Map();\n  private data: Map<string, Record<string, unknown>> = new Map();\n\n  async saveRunState(runId: string, state: StepMachineState): Promise<void> {\n    this.runs.set(runId, { ...state });\n  }\n\n  async loadRunState(runId: string): Promise<StepMachineState | 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","/**\n * Step Machine — Convenience Driver Class\n *\n * Wraps the pure reducer with a run loop and store I/O.\n * This is the framework layer. The reducer is the pure core.\n */\n\nimport type {\n  StepFlowConfig,\n  StepMachineStore,\n  StepMachineResult,\n  StepHandler,\n  StepContext,\n  StepResult,\n  StepMachineState,\n  StepMachineOptions,\n  StepEvent,\n  StepEventType,\n  StepEventListener,\n} from './types.js';\nimport {\n  applyStepResult,\n  checkCircuitBreaker,\n  computeStepInput,\n  extractReturnData,\n  createInitialState,\n} from './reducer.js';\nimport { MemoryStore } from '../stores/memory.js';\n\nfunction generateRunId(): string {\n  if (typeof crypto !== 'undefined' && crypto.randomUUID) {\n    return crypto.randomUUID();\n  }\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === 'x' ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\nexport class StepMachine {\n  private flow: StepFlowConfig;\n  private handlers: Map<string, StepHandler>;\n  private store: StepMachineStore;\n  private components: Record<string, unknown>;\n  private options: StepMachineOptions;\n  private listeners: Map<StepEventType, Set<StepEventListener>> = new Map();\n  private aborted = false;\n\n  constructor(\n    flow: StepFlowConfig,\n    handlers: Record<string, StepHandler>,\n    options: StepMachineOptions = {}\n  ) {\n    this.flow = flow;\n    this.handlers = new Map(Object.entries(handlers));\n    this.store = options.store ?? new MemoryStore();\n    this.components = options.components ?? {};\n    this.options = options;\n\n    if (options.signal) {\n      options.signal.addEventListener('abort', () => {\n        this.aborted = true;\n      });\n    }\n\n    this.validateFlow();\n  }\n\n  private validateFlow(): void {\n    const { settings, steps, terminal_states } = this.flow;\n\n    if (!settings?.start_step) {\n      throw new Error('Flow must have settings.start_step defined');\n    }\n    if (!steps || Object.keys(steps).length === 0) {\n      throw new Error('Flow must have at least one step defined');\n    }\n    if (!terminal_states || Object.keys(terminal_states).length === 0) {\n      throw new Error('Flow must have at least one terminal_state defined');\n    }\n    if (!steps[settings.start_step] && !terminal_states[settings.start_step]) {\n      throw new Error(`Start step \"${settings.start_step}\" not found`);\n    }\n    for (const [stepName, stepConfig] of Object.entries(steps)) {\n      for (const [result, target] of Object.entries(stepConfig.transitions)) {\n        if (!steps[target] && !terminal_states[target]) {\n          throw new Error(\n            `Step \"${stepName}\" transition \"${result}\" points to unknown step \"${target}\"`\n          );\n        }\n      }\n    }\n  }\n\n  on(eventType: StepEventType, listener: StepEventListener): void {\n    if (!this.listeners.has(eventType)) {\n      this.listeners.set(eventType, new Set());\n    }\n    this.listeners.get(eventType)!.add(listener);\n  }\n\n  off(eventType: StepEventType, listener: StepEventListener): void {\n    this.listeners.get(eventType)?.delete(listener);\n  }\n\n  private emit(event: StepEvent): void {\n    const typeListeners = this.listeners.get(event.type);\n    if (typeListeners) {\n      for (const listener of typeListeners) {\n        try { listener(event); } catch { /* swallow listener errors */ }\n      }\n    }\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise(resolve => setTimeout(resolve, ms));\n  }\n\n  async run(initialData?: Record<string, unknown>): Promise<StepMachineResult> {\n    const runId = generateRunId();\n    let runState = createInitialState(this.flow, runId);\n\n    await this.store.saveRunState(runId, runState);\n\n    if (initialData) {\n      for (const [key, value] of Object.entries(initialData)) {\n        await this.store.setData(runId, key, value);\n      }\n    }\n\n    this.emit({\n      type: 'flow:start',\n      runId,\n      timestamp: runState.startedAt,\n      data: { initialData: initialData ?? {} },\n    });\n\n    try {\n      return await this.executeLoop(runId, runState);\n    } catch (error) {\n      const err = error instanceof Error ? error : new Error(String(error));\n      this.emit({ type: 'flow:error', runId, timestamp: Date.now(), data: { error: err.message } });\n      this.options.onError?.(err);\n\n      runState = { ...runState, status: 'failed', updatedAt: Date.now() };\n      await this.store.saveRunState(runId, runState);\n\n      return {\n        runId,\n        status: 'failed',\n        data: await this.store.getAllData(runId),\n        finalStep: runState.currentStep,\n        stepHistory: runState.stepHistory,\n        durationMs: Date.now() - runState.startedAt,\n        error: err,\n      };\n    }\n  }\n\n  async resume(runId: string): Promise<StepMachineResult> {\n    const runState = await this.store.loadRunState(runId);\n    if (!runState) throw new Error(`No run found with ID: ${runId}`);\n    if (runState.status === 'completed' || runState.status === 'failed') {\n      throw new Error(`Cannot resume a ${runState.status} run`);\n    }\n\n    const updated: StepMachineState = { ...runState, status: 'running', pausedAt: undefined, updatedAt: Date.now() };\n    await this.store.saveRunState(runId, updated);\n    this.emit({ type: 'flow:resumed', runId, timestamp: Date.now(), data: { currentStep: updated.currentStep } });\n\n    return this.executeLoop(runId, updated);\n  }\n\n  async pause(runId: string): Promise<void> {\n    const runState = await this.store.loadRunState(runId);\n    if (!runState) throw new Error(`No run found with ID: ${runId}`);\n\n    const updated: StepMachineState = { ...runState, status: 'paused', pausedAt: Date.now(), updatedAt: Date.now() };\n    await this.store.saveRunState(runId, updated);\n    this.emit({ type: 'flow:paused', runId, timestamp: Date.now(), data: { currentStep: updated.currentStep } });\n  }\n\n  private async executeLoop(runId: string, runState: StepMachineState): Promise<StepMachineResult> {\n    const maxSteps = this.flow.settings.max_total_steps ?? 100;\n    const timeoutMs = this.flow.settings.timeout_ms;\n    let current = runState;\n    let iterations = 0;\n\n    while (iterations < maxSteps) {\n      if (this.aborted) {\n        current = { ...current, status: 'cancelled', updatedAt: Date.now() };\n        await this.store.saveRunState(runId, current);\n        return { runId, status: 'cancelled', data: await this.store.getAllData(runId), finalStep: current.currentStep, stepHistory: current.stepHistory, durationMs: Date.now() - current.startedAt };\n      }\n\n      if (timeoutMs && Date.now() - current.startedAt > timeoutMs) {\n        current = { ...current, status: 'completed', updatedAt: Date.now() };\n        await this.store.saveRunState(runId, current);\n        return { runId, status: 'timeout', intent: 'timeout', data: await this.store.getAllData(runId), finalStep: current.currentStep, stepHistory: current.stepHistory, durationMs: Date.now() - current.startedAt };\n      }\n\n      const stepName = current.currentStep;\n\n      // Terminal state check\n      const terminalState = this.flow.terminal_states[stepName];\n      if (terminalState) {\n        current = { ...current, status: 'completed', updatedAt: Date.now() };\n        await this.store.saveRunState(runId, current);\n        const allData = await this.store.getAllData(runId);\n        const result: StepMachineResult = {\n          runId, status: 'completed', intent: terminalState.return_intent,\n          data: extractReturnData(terminalState.return_artifacts, allData),\n          finalStep: stepName, stepHistory: current.stepHistory, durationMs: Date.now() - current.startedAt,\n        };\n        this.emit({ type: 'flow:complete', runId, timestamp: Date.now(), data: { ...result } });\n        this.options.onComplete?.(result);\n        return result;\n      }\n\n      // Circuit breaker (pure)\n      const cbResult = checkCircuitBreaker(this.flow, current, stepName);\n      if (cbResult.broken) {\n        current = cbResult.newState;\n        await this.store.saveRunState(runId, current);\n        iterations++;\n        continue;\n      }\n      current = cbResult.newState;\n\n      // Execute step handler (impure — localized)\n      const allData = await this.store.getAllData(runId);\n      const input = computeStepInput(this.flow, stepName, allData);\n      const context: StepContext = {\n        runId, stepName, components: this.components, store: this.store,\n        signal: this.options.signal,\n        emit: (event: string, data: unknown) => {\n          this.emit({ type: 'step:complete' as StepEventType, runId, timestamp: Date.now(), data: { event, payload: data } });\n        },\n      };\n\n      this.emit({ type: 'step:start', runId, timestamp: Date.now(), data: { step: stepName, input } });\n\n      let stepResult: StepResult;\n      try {\n        const handler = this.handlers.get(stepName);\n        if (!handler) throw new Error(`No handler registered for step \"${stepName}\"`);\n        stepResult = await handler(input, context);\n      } catch (error) {\n        const err = error instanceof Error ? error : new Error(String(error));\n        this.emit({ type: 'step:error', runId, timestamp: Date.now(), data: { step: stepName, error: err.message } });\n        stepResult = { result: 'failure', data: { error: err.message } };\n      }\n\n      // Store produced data\n      if (stepResult.data) {\n        for (const [key, value] of Object.entries(stepResult.data)) {\n          await this.store.setData(runId, key, value);\n        }\n      }\n\n      this.emit({ type: 'step:complete', runId, timestamp: Date.now(), data: { step: stepName, result: stepResult.result } });\n      this.options.onStep?.(stepName, stepResult);\n\n      // Apply step result (pure reducer)\n      const reducerResult = applyStepResult(this.flow, current, stepName, stepResult);\n      current = reducerResult.newState;\n\n      if (reducerResult.shouldRetry) {\n        await this.store.saveRunState(runId, current);\n        const stepConfig = this.flow.steps[stepName];\n        if (stepConfig.retry?.delay_ms) {\n          const retryCount = current.retryCounts[stepName] ?? 0;\n          const delay = stepConfig.retry.backoff_multiplier\n            ? stepConfig.retry.delay_ms * Math.pow(stepConfig.retry.backoff_multiplier, retryCount - 1)\n            : stepConfig.retry.delay_ms;\n          await this.sleep(delay);\n        }\n        iterations++;\n        continue;\n      }\n\n      await this.store.saveRunState(runId, current);\n      this.emit({ type: 'transition', runId, timestamp: Date.now(), data: { from: stepName, to: current.currentStep, result: stepResult.result } });\n      this.options.onTransition?.(stepName, current.currentStep);\n      iterations++;\n    }\n\n    // Max iterations\n    current = { ...current, status: 'completed', updatedAt: Date.now() };\n    await this.store.saveRunState(runId, current);\n    return { runId, status: 'max_iterations', intent: 'max_iterations', data: await this.store.getAllData(runId), finalStep: current.currentStep, stepHistory: current.stepHistory, durationMs: Date.now() - current.startedAt };\n  }\n}\n\n/** Convenience factory */\nexport function createStepMachine(\n  flow: StepFlowConfig,\n  handlers: Record<string, StepHandler>,\n  options?: StepMachineOptions\n): StepMachine {\n  return new StepMachine(flow, handlers, options);\n}\n","/**\n * Step Machine — Loader\n *\n * Utilities for loading and validating step-machine flow configurations.\n */\n\nimport type { StepFlowConfig } from './types.js';\n\nexport async function parseStepFlowYaml(yamlString: string): Promise<StepFlowConfig> {\n  const yaml = await import('yaml');\n  return yaml.parse(yamlString) as StepFlowConfig;\n}\n\nexport async function loadStepFlowFromUrl(url: string): Promise<StepFlowConfig> {\n  const response = await fetch(url);\n  if (!response.ok) {\n    throw new Error(`Failed to load flow from ${url}: ${response.statusText}`);\n  }\n  const contentType = response.headers.get('content-type') ?? '';\n  const text = await response.text();\n  if (contentType.includes('json') || url.endsWith('.json')) {\n    return JSON.parse(text) as StepFlowConfig;\n  }\n  return parseStepFlowYaml(text);\n}\n\nexport async function loadStepFlowFromFile(filePath: string): Promise<StepFlowConfig> {\n  const fs = await import('fs/promises');\n  const text = await fs.readFile(filePath, 'utf-8');\n  if (filePath.endsWith('.json')) {\n    return JSON.parse(text) as StepFlowConfig;\n  }\n  return parseStepFlowYaml(text);\n}\n\nexport function validateStepFlowConfig(flow: unknown): string[] {\n  const errors: string[] = [];\n  if (!flow || typeof flow !== 'object') {\n    return ['Flow must be an object'];\n  }\n  const f = flow as Record<string, unknown>;\n\n  if (!f.settings || typeof f.settings !== 'object') {\n    errors.push('Flow must have a \"settings\" object');\n  } else {\n    const settings = f.settings as Record<string, unknown>;\n    if (typeof settings.start_step !== 'string') {\n      errors.push('settings.start_step must be a string');\n    }\n  }\n\n  if (!f.steps || typeof f.steps !== 'object') {\n    errors.push('Flow must have a \"steps\" object');\n  } else {\n    const steps = f.steps as Record<string, unknown>;\n    for (const [stepName, stepConfig] of Object.entries(steps)) {\n      if (!stepConfig || typeof stepConfig !== 'object') {\n        errors.push(`Step \"${stepName}\" must be an object`);\n        continue;\n      }\n      const step = stepConfig as Record<string, unknown>;\n      if (!step.transitions || typeof step.transitions !== 'object') {\n        errors.push(`Step \"${stepName}\" must have a \"transitions\" object`);\n      }\n    }\n  }\n\n  if (!f.terminal_states || typeof f.terminal_states !== 'object') {\n    errors.push('Flow must have a \"terminal_states\" object');\n  } else {\n    const terminals = f.terminal_states as Record<string, unknown>;\n    for (const [name, config] of Object.entries(terminals)) {\n      if (!config || typeof config !== 'object') {\n        errors.push(`Terminal state \"${name}\" must be an object`);\n        continue;\n      }\n      const terminal = config as Record<string, unknown>;\n      if (typeof terminal.return_intent !== 'string') {\n        errors.push(`Terminal state \"${name}\" must have a \"return_intent\" string`);\n      }\n    }\n  }\n\n  return errors;\n}\n\nexport async function loadStepFlow(source: string | StepFlowConfig): Promise<StepFlowConfig> {\n  let flow: StepFlowConfig;\n  if (typeof source === 'string') {\n    if (source.startsWith('http://') || source.startsWith('https://')) {\n      flow = await loadStepFlowFromUrl(source);\n    } else if (source.includes('{')) {\n      flow = JSON.parse(source);\n    } else {\n      flow = await loadStepFlowFromFile(source);\n    }\n  } else {\n    flow = source;\n  }\n  const errors = validateStepFlowConfig(flow);\n  if (errors.length > 0) {\n    throw new Error(`Invalid step flow configuration:\\n- ${errors.join('\\n- ')}`);\n  }\n  return flow;\n}\n"]}

package/dist/step-machine/index.d.cts

@@ -0,0 +1,77 @@
+import { e as StepFlowConfig, g as StepHandler, i as StepMachineOptions, d as StepEventType, c as StepEventListener, j as StepMachineResult, k as StepMachineState, n as StepResult, m as StepReducerResult } from '../types-FZ_eyErS.cjs';
+export { C as CircuitBreakerConfig, R as RetryConfig, S as StepConfig, a as StepContext, b as StepEvent, f as StepFlowSettings, h as StepInput, l as StepMachineStore, T as TerminalStateConfig } from '../types-FZ_eyErS.cjs';
+
+/**
+ * Step Machine — Convenience Driver Class
+ *
+ * Wraps the pure reducer with a run loop and store I/O.
+ * This is the framework layer. The reducer is the pure core.
+ */
+
+declare class StepMachine {
+    private flow;
+    private handlers;
+    private store;
+    private components;
+    private options;
+    private listeners;
+    private aborted;
+    constructor(flow: StepFlowConfig, handlers: Record<string, StepHandler>, options?: StepMachineOptions);
+    private validateFlow;
+    on(eventType: StepEventType, listener: StepEventListener): void;
+    off(eventType: StepEventType, listener: StepEventListener): void;
+    private emit;
+    private sleep;
+    run(initialData?: Record<string, unknown>): Promise<StepMachineResult>;
+    resume(runId: string): Promise<StepMachineResult>;
+    pause(runId: string): Promise<void>;
+    private executeLoop;
+}
+/** Convenience factory */
+declare function createStepMachine(flow: StepFlowConfig, handlers: Record<string, StepHandler>, options?: StepMachineOptions): StepMachine;
+
+/**
+ * Step Machine Reducer — Pure Functions
+ *
+ * currentState + stepResult → newState
+ * No I/O, no side effects, deterministic.
+ */
+
+/**
+ * Apply a step result to the current state and compute the next state.
+ * Pure function: no side effects.
+ */
+declare function applyStepResult(flow: StepFlowConfig, state: StepMachineState, stepName: string, stepResult: StepResult): StepReducerResult;
+/**
+ * Check circuit breaker for a step. Returns the redirected step if broken.
+ * Pure function.
+ */
+declare function checkCircuitBreaker(flow: StepFlowConfig, state: StepMachineState, stepName: string): {
+    broken: boolean;
+    redirectStep?: string;
+    newState: StepMachineState;
+};
+/**
+ * Compute what a step needs as input. Pure function.
+ */
+declare function computeStepInput(flow: StepFlowConfig, stepName: string, allData: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Extract return data from terminal state. Pure function.
+ */
+declare function extractReturnData(returnArtifacts: string | string[] | false | undefined, allData: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Create initial state for a new run. Pure function.
+ */
+declare function createInitialState(flow: StepFlowConfig, runId: string): StepMachineState;
+
+/**
+ * Step Machine — Loader
+ *
+ * Utilities for loading and validating step-machine flow configurations.
+ */
+
+declare function parseStepFlowYaml(yamlString: string): Promise<StepFlowConfig>;
+declare function validateStepFlowConfig(flow: unknown): string[];
+declare function loadStepFlow(source: string | StepFlowConfig): Promise<StepFlowConfig>;
+
+export { StepEventListener, StepEventType, StepFlowConfig, StepHandler, StepMachine, StepMachineOptions, StepMachineResult, StepMachineState, StepReducerResult, StepResult, applyStepResult, checkCircuitBreaker, computeStepInput, createInitialState, createStepMachine, extractReturnData, loadStepFlow, parseStepFlowYaml, validateStepFlowConfig };