@particle-academy/fancy-flow 0.76.0 → 0.77.1

package/dist/registry.cjs

@@ -925,6 +925,42 @@ 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 encodePause(signal) {
+  const { nodeId, awaiting, detail } = signal;
+  return PAUSE_PREFIX + JSON.stringify(detail === void 0 ? { nodeId, awaiting } : { nodeId, awaiting, detail });
+}
+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;
+}
+function isPause(reason) {
+  return decodePause(reason) !== null;
+}
+function pauseForHuman(ctx, awaiting, detail) {
+  return ctx.abort(encodePause({ nodeId: ctx.node.id, awaiting, detail }));
+}
+
 // src/registry/subflow.ts
 var DEFAULT_MAX_DEPTH = 8;
 function subflowMode(config) {
@@ -1006,7 +1042,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 };
@@ -1814,7 +1854,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" }],
@@ -2851,42 +2891,6 @@ function createConnectionValidator(getNodes, options = {}) {
     return compatible(outPort, inPort);
   };
 }
-
-// src/registry/pause.ts
-var PAUSE_PREFIX = "fancy-flow:pause:";
-var LEGACY_PAUSE_PREFIXES = [
-  ["awaiting-approval:", "approval"],
-  ["awaiting-input:", "input"]
-];
-function encodePause(signal) {
-  const { nodeId, awaiting, detail } = signal;
-  return PAUSE_PREFIX + JSON.stringify(detail === void 0 ? { nodeId, awaiting } : { nodeId, awaiting, detail });
-}
-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;
-}
-function isPause(reason) {
-  return decodePause(reason) !== null;
-}
-function pauseForHuman(ctx, awaiting, detail) {
-  return ctx.abort(encodePause({ nodeId: ctx.node.id, awaiting, detail }));
-}
 var adapter = null;
 var listeners2 = /* @__PURE__ */ new Set();
 function registerRichInputAdapter(next) {