@particle-academy/fancy-flow 0.75.0 → 0.77.0

package/dist/screens.js

@@ -1,10 +1,9 @@
-import { FlowViewer } from './chunk-2H5H2DDP.js';
-export { FlowViewer } from './chunk-2H5H2DDP.js';
-import './chunk-4BPCA3ZO.js';
+import { FlowViewer } from './chunk-44VXYZ4M.js';
+export { FlowViewer } from './chunk-44VXYZ4M.js';
+import './chunk-66JAEWPP.js';
 import './chunk-F5RPRB7A.js';
 import './chunk-OWENS2H5.js';
-import './chunk-UEOE6B52.js';
-import './chunk-W7DMO3H7.js';
+import './chunk-YNKOEQLI.js';
 import './chunk-2QXKDLGT.js';
 import { registerSchemaComponents } from '@particle-academy/fancy-screens';
 

package/dist/screens.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/screens.ts"],"names":[],"mappings":";;;;;;;;;;AAwBO,SAAS,kBAAA,GAA2B;AACzC,EAAA,wBAAA,CAAyB;AAAA,IACvB;AAAA,GACD,CAAA;AACH","file":"screens.js","sourcesContent":["// /screens subpath — the ONLY module that imports fancy-screens (optional\n// peer). Keeps the base `.` import graph free of it, so an app that never\n// touches fancy-screens never pays for it.\nimport { registerSchemaComponents } from \"@particle-academy/fancy-screens\";\nimport type { ComponentType } from \"react\";\nimport { FlowViewer } from \"./components/FlowViewer\";\n\n/**\n * Register fancy-flow's components with fancy-screens, so an agent-emitted\n * `ScreenSchema` can place a workflow in a page:\n *\n * ```json\n * { \"type\": \"FlowViewer\", \"props\": { \"graph\": { \"nodes\": [], \"edges\": [] } } }\n * ```\n *\n * Call once at host startup.\n *\n * **Only the VIEWER is registered, deliberately.** A schema is JSON an agent\n * emits, and `FlowEditor` needs executors, run handlers and controlled state\n * that cannot be expressed as JSON props — registering it would let an agent\n * emit an editor that renders but does nothing, which is worse than not\n * offering it. The viewer is complete from props alone, which is exactly what\n * makes it schema-safe.\n */\nexport function registerFlowSchema(): void {\n  registerSchemaComponents({\n    FlowViewer: FlowViewer as unknown as ComponentType<Record<string, unknown>>,\n  });\n}\n\nexport { FlowViewer } from \"./components/FlowViewer\";\nexport type { FlowViewerProps, FlowViewerClassNames, FlowNodeStatus } from \"./components/FlowViewer\";\n"]}
+{"version":3,"sources":["../src/screens.ts"],"names":[],"mappings":";;;;;;;;;AAwBO,SAAS,kBAAA,GAA2B;AACzC,EAAA,wBAAA,CAAyB;AAAA,IACvB;AAAA,GACD,CAAA;AACH","file":"screens.js","sourcesContent":["// /screens subpath — the ONLY module that imports fancy-screens (optional\n// peer). Keeps the base `.` import graph free of it, so an app that never\n// touches fancy-screens never pays for it.\nimport { registerSchemaComponents } from \"@particle-academy/fancy-screens\";\nimport type { ComponentType } from \"react\";\nimport { FlowViewer } from \"./components/FlowViewer\";\n\n/**\n * Register fancy-flow's components with fancy-screens, so an agent-emitted\n * `ScreenSchema` can place a workflow in a page:\n *\n * ```json\n * { \"type\": \"FlowViewer\", \"props\": { \"graph\": { \"nodes\": [], \"edges\": [] } } }\n * ```\n *\n * Call once at host startup.\n *\n * **Only the VIEWER is registered, deliberately.** A schema is JSON an agent\n * emits, and `FlowEditor` needs executors, run handlers and controlled state\n * that cannot be expressed as JSON props — registering it would let an agent\n * emit an editor that renders but does nothing, which is worse than not\n * offering it. The viewer is complete from props alone, which is exactly what\n * makes it schema-safe.\n */\nexport function registerFlowSchema(): void {\n  registerSchemaComponents({\n    FlowViewer: FlowViewer as unknown as ComponentType<Record<string, unknown>>,\n  });\n}\n\nexport { FlowViewer } from \"./components/FlowViewer\";\nexport type { FlowViewerProps, FlowViewerClassNames, FlowNodeStatus } from \"./components/FlowViewer\";\n"]}

package/dist/ux.cjs

@@ -528,8 +528,9 @@ function possiblePortIds(node) {
   if (!kind) return ["out"];
   const config = nodeConfig(node);
   const representative = typeof kind.outputs === "function" && !configDeclaresPorts(kind.name, config);
-  const ids = (resolvePortSpec(kind.outputs, representative ? defaultConfigFor(kind) : config) ?? []).map((p) => p.id);
-  return ids.length > 0 ? ids : ["out"];
+  const resolved = resolvePortSpec(kind.outputs, representative ? defaultConfigFor(kind) : config);
+  if (resolved === void 0) return ["out"];
+  return resolved.map((p) => p.id);
 }
 function configDeclaresPorts(kindName, config) {
   const bare = kindName.startsWith("@") ? kindName.slice(kindName.lastIndexOf("/") + 1) : kindName;
@@ -855,7 +856,7 @@ function activatedPorts(node, result) {
   }
   const kind = getNodeKind(node.data?.kind ?? node.type ?? "") ?? void 0;
   const declared = resolveNodePorts(node, kind).outputs?.map((p) => p.id);
-  return { ports: declared?.length ? declared : ["out"], value: result };
+  return { ports: declared ?? ["out"], value: result };
 }
 function portValueOf(activated, portId) {
   return activated.values && Object.prototype.hasOwnProperty.call(activated.values, portId) ? activated.values[portId] : activated.value;
@@ -869,6 +870,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) {
@@ -950,7 +977,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 };