@particle-academy/fancy-flow 0.76.0 → 0.77.1

package/dist/runtime.js

@@ -1,7 +1,7 @@
-export { applyOutputsToNodes, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState } from './chunk-ZKAPSUTL.js';
-export { runCohort } from './chunk-G4GKDJG5.js';
+export { applyOutputsToNodes, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState } from './chunk-2VI24UPB.js';
+export { runCohort } from './chunk-CQAMEPPI.js';
 import './chunk-OWENS2H5.js';
-export { RunIdentity, escapeSegment, runFlow } from './chunk-V2657EQG.js';
+export { RunIdentity, escapeSegment, runFlow } from './chunk-EEIWAIXW.js';
 import './chunk-2QXKDLGT.js';
 //# sourceMappingURL=runtime.js.map
 //# sourceMappingURL=runtime.js.map

package/dist/schema.cjs

@@ -865,6 +865,32 @@ function announce(onEvent, node, phase) {
   onEvent({ type: "node-message", nodeId: node.id, phase, message });
 }
 
+// src/registry/pause.ts
+var PAUSE_PREFIX = "fancy-flow:pause:";
+var LEGACY_PAUSE_PREFIXES = [
+  ["awaiting-approval:", "approval"],
+  ["awaiting-input:", "input"]
+];
+function decodePause(reason) {
+  if (typeof reason !== "string") return null;
+  if (reason.startsWith(PAUSE_PREFIX)) {
+    const body = reason.slice(PAUSE_PREFIX.length);
+    try {
+      const parsed = JSON.parse(body);
+      if (typeof parsed?.nodeId !== "string" || typeof parsed?.awaiting !== "string") return null;
+      return "detail" in parsed ? { nodeId: parsed.nodeId, awaiting: parsed.awaiting, detail: parsed.detail } : { nodeId: parsed.nodeId, awaiting: parsed.awaiting };
+    } catch {
+      return null;
+    }
+  }
+  for (const [prefix, awaiting] of LEGACY_PAUSE_PREFIXES) {
+    if (reason.startsWith(prefix)) {
+      return { nodeId: reason.slice(prefix.length), awaiting };
+    }
+  }
+  return null;
+}
+
 // src/registry/subflow.ts
 var DEFAULT_MAX_DEPTH = 8;
 function subflowMode(config) {
@@ -946,7 +972,11 @@ var subflowExecutor = async (ctx) => {
     }
   );
   if (!result.ok) {
-    ctx.abort(`subflow "${ref}" failed: ${result.error ?? "unknown error"}`);
+    const reason = result.error ?? "unknown error";
+    if (decodePause(reason)) {
+      ctx.abort(reason);
+    }
+    ctx.abort(`subflow "${ref}" failed: ${reason}`);
   }
   if (mode === "stream") {
     return { __port: "stream", value: result.outputs };
@@ -1754,7 +1784,7 @@ var KINDS = [
     executor: forEachExecutor,
     category: "logic",
     label: "For Each",
-    description: "Iterate over a list, emitting each item on `item`.",
+    description: "Publishes the resolved list and its size on BOTH `item` and `done`. Fan-out as DATA, not as jobs -- nothing runs per item.",
     icon: "\u21BB",
     inputs: [{ id: "in" }],
     outputs: [{ id: "item", label: "item" }, { id: "done", label: "done" }],