@particle-academy/fancy-flow 0.11.0 → 0.13.0

package/dist/index.cjs

@@ -212,6 +212,299 @@ function RichInputPreview({ config }) {
   ] });
 }
 
+// src/registry/capabilities.ts
+var llmClient = null;
+function getLlmClient() {
+  return llmClient;
+}
+var workflowResolver = null;
+function getWorkflowResolver() {
+  return workflowResolver;
+}
+
+// src/registry/llm-branch.ts
+function declaredRoutes(config) {
+  const raw = config.routes;
+  if (!Array.isArray(raw)) return [];
+  return raw.map((r) => ({ port: String(r?.port ?? "").trim(), description: r?.description })).filter((r) => r.port !== "");
+}
+function resolveFallbackPort(routes, fallbackEnabled) {
+  if (fallbackEnabled) return "fallback";
+  return routes[0]?.port ?? "out";
+}
+var llmBranchExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const routes = declaredRoutes(config);
+  if (routes.length === 0) {
+    ctx.abort("llm_branch has no routes configured");
+  }
+  const client = getLlmClient();
+  {
+    ctx.abort(
+      "No LLM client registered. Call registerLlmClient() with your provider adapter \u2014 fancy-flow ships the routing, not the model call."
+    );
+  }
+  const fallbackEnabled = config.fallback !== false;
+  const choice = await client.chooseRoute({
+    system: typeof config.system === "string" ? config.system : void 0,
+    prompt: String(config.prompt ?? ctx.inputs ?? ""),
+    routes,
+    provider: typeof config.provider === "string" ? config.provider : void 0,
+    model: typeof config.model === "string" ? config.model : void 0,
+    credential: typeof config.credential === "string" ? config.credential : void 0
+  });
+  const offered = new Set(routes.map((r) => r.port));
+  let port = choice?.port ?? "";
+  let reason = choice?.reason;
+  if (!offered.has(port)) {
+    const safe = resolveFallbackPort(routes, fallbackEnabled);
+    ctx.emit({
+      type: "log",
+      nodeId: ctx.node.id,
+      level: "warn",
+      message: `llm_branch: model returned "${port || "(nothing)"}", which is not a declared route. Routing to "${safe}".`
+    });
+    reason = reason ?? `unrecognised route "${port}"`;
+    port = safe;
+  }
+  return { __port: port, value: { route: port, reason, input: ctx.inputs } };
+};
+
+// src/registry/ports.ts
+function resolvePortSpec(spec, config) {
+  if (spec === void 0) return void 0;
+  if (typeof spec !== "function") return spec;
+  try {
+    const resolved = spec(config);
+    return Array.isArray(resolved) ? resolved : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function nodeConfig(node) {
+  return node.data?.config ?? {};
+}
+function resolveNodePorts(node, kind) {
+  const config = nodeConfig(node);
+  const data = node.data;
+  return {
+    inputs: data?.inputs ?? resolvePortSpec(kind?.inputs, config),
+    outputs: data?.outputs ?? resolvePortSpec(kind?.outputs, config)
+  };
+}
+
+// src/runtime/run-flow.ts
+async function runFlow(graph, executors, onEvent = () => {
+}, options = {}) {
+  const { signal, initialInputs = {}, timeoutMs, depth = 0 } = options;
+  const outputs = {};
+  const portValues = /* @__PURE__ */ new Map();
+  const completed = /* @__PURE__ */ new Set();
+  const errors = [];
+  const order = topoSort(graph);
+  if (order === null) {
+    const msg = "Cycle detected in flow graph \u2014 aborting.";
+    onEvent({ type: "run-error", error: msg });
+    return { ok: false, outputs, error: msg };
+  }
+  const incomingByNode = indexIncoming(graph.edges);
+  const timer2 = timeoutMs ? setTimeout(() => errors.push(`Run timed out after ${timeoutMs}ms`), timeoutMs) : null;
+  onEvent({ type: "run-start" });
+  try {
+    for (const node of order) {
+      if (signal?.aborted) throw new Error("aborted");
+      if (errors.length) break;
+      const incoming = incomingByNode.get(node.id) ?? [];
+      if (incoming.length > 0) {
+        const anyActive = incoming.some((e) => portValues.has(`${e.source}:${e.sourceHandle ?? "out"}`));
+        if (!anyActive) {
+          onEvent({ type: "node-status", nodeId: node.id, status: "idle", text: "skipped" });
+          continue;
+        }
+      }
+      if (node.type === "note") {
+        onEvent({ type: "node-status", nodeId: node.id, status: "idle", text: "annotation" });
+        continue;
+      }
+      onEvent({ type: "node-status", nodeId: node.id, status: "running" });
+      const inputs = collectInputs(node, incoming, portValues, initialInputs);
+      const exec = pickExecutor(executors, node);
+      if (!exec) {
+        const msg = `No executor registered for kind=${node.type}`;
+        errors.push(msg);
+        onEvent({ type: "node-status", nodeId: node.id, status: "error", text: msg });
+        onEvent({ type: "log", nodeId: node.id, level: "error", message: msg });
+        break;
+      }
+      try {
+        const result = await Promise.resolve(
+          exec({
+            node,
+            inputs,
+            abort: (reason) => {
+              throw new Error(reason ?? "aborted");
+            },
+            emit: onEvent,
+            depth
+          })
+        );
+        outputs[node.id] = result;
+        const activated = activatedPorts(node, result);
+        for (const portId of activated.ports) {
+          portValues.set(`${node.id}:${portId}`, activated.value);
+          onEvent({ type: "node-output", nodeId: node.id, portId, value: activated.value });
+        }
+        completed.add(node.id);
+        onEvent({ type: "node-status", nodeId: node.id, status: "done" });
+      } catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        errors.push(msg);
+        onEvent({ type: "node-status", nodeId: node.id, status: "error", text: msg });
+        onEvent({ type: "log", nodeId: node.id, level: "error", message: msg });
+        break;
+      }
+    }
+  } finally {
+    if (timer2) clearTimeout(timer2);
+  }
+  const ok = errors.length === 0;
+  onEvent({ type: "run-end", ok });
+  return ok ? { ok, outputs } : { ok, outputs, error: errors[0] };
+}
+function indexIncoming(edges) {
+  const map = /* @__PURE__ */ new Map();
+  for (const e of edges) {
+    const list = map.get(e.target) ?? [];
+    list.push(e);
+    map.set(e.target, list);
+  }
+  return map;
+}
+function topoSort(graph) {
+  const inDegree = /* @__PURE__ */ new Map();
+  for (const n of graph.nodes) inDegree.set(n.id, 0);
+  for (const e of graph.edges) inDegree.set(e.target, (inDegree.get(e.target) ?? 0) + 1);
+  const queue = [];
+  for (const [id2, d] of inDegree) if (d === 0) queue.push(id2);
+  const ordered = [];
+  while (queue.length) {
+    const id2 = queue.shift();
+    ordered.push(id2);
+    for (const e of graph.edges) {
+      if (e.source !== id2) continue;
+      const next = (inDegree.get(e.target) ?? 0) - 1;
+      inDegree.set(e.target, next);
+      if (next === 0) queue.push(e.target);
+    }
+  }
+  if (ordered.length !== graph.nodes.length) return null;
+  const byId = new Map(graph.nodes.map((n) => [n.id, n]));
+  return ordered.map((id2) => byId.get(id2)).filter(Boolean);
+}
+function collectInputs(node, incoming, portValues, initial) {
+  const inputs = { ...initial[node.id] ?? {} };
+  for (const e of incoming) {
+    const portId = e.targetHandle ?? "in";
+    const val = portValues.get(`${e.source}:${e.sourceHandle ?? "out"}`);
+    inputs[portId] = val;
+  }
+  return inputs;
+}
+function pickExecutor(executors, node) {
+  if (executors[node.id]) return executors[node.id];
+  if (node.type && executors[node.type]) return executors[node.type];
+  const kind = node.type ? getNodeKind(node.type) : null;
+  if (kind) {
+    for (const id2 of kindIds(kind)) {
+      if (executors[id2]) return executors[id2];
+    }
+  }
+  return executors["*"];
+}
+function activatedPorts(node, result) {
+  if (result && typeof result === "object") {
+    const r = result;
+    if (typeof r.__port === "string") {
+      return { ports: [r.__port], value: r.value };
+    }
+    if (typeof r.branch === "string") {
+      return { ports: [r.branch], value: r.value ?? r };
+    }
+  }
+  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 };
+}
+
+// src/registry/subflow.ts
+var DEFAULT_MAX_DEPTH = 8;
+function subflowMode(config) {
+  const mode = config.mode;
+  return mode === "stream" || mode === "both" ? mode : "output";
+}
+function subflowPorts(config) {
+  const mode = subflowMode(config);
+  const ports = [{ id: "out", label: "result" }];
+  if (mode === "stream" || mode === "both") ports.unshift({ id: "stream", label: "stream" });
+  return ports;
+}
+var subflowExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const ref = String(config.workflow ?? "").trim();
+  if (!ref) ctx.abort("subflow has no workflow reference configured");
+  const resolver = getWorkflowResolver();
+  {
+    ctx.abort(
+      "No workflow resolver registered. Call registerWorkflowResolver() so subflow can find the workflow it references."
+    );
+  }
+  const maxDepth = Number.isFinite(config.maxDepth) ? Number(config.maxDepth) : DEFAULT_MAX_DEPTH;
+  const depth = ctx.depth ?? 0;
+  if (depth + 1 > maxDepth) {
+    ctx.abort(
+      `subflow depth limit reached (${maxDepth}) at "${ref}" \u2014 a workflow is referencing itself, directly or through a chain.`
+    );
+  }
+  const child = await resolver(ref);
+  if (!child) ctx.abort(`subflow could not resolve workflow "${ref}"`);
+  const mode = subflowMode(config);
+  const streaming = mode === "stream" || mode === "both";
+  const forward = (event) => {
+    if (!streaming) return;
+    const detail = event.type === "node-status" ? `${event.nodeId} ${event.status}` : event.type === "run-end" ? `finished (${event.ok ? "ok" : "failed"})` : event.type;
+    ctx.emit({
+      type: "log",
+      nodeId: ctx.node.id,
+      level: "info",
+      message: `[${ref}] ${detail}`
+    });
+  };
+  const result = await runFlow(
+    child,
+    config.executors ?? {},
+    forward,
+    {
+      initialInputs: config.inputs ?? {
+        // With no explicit mapping, hand the parent's inputs to the child's
+        // entry points — the obvious default, and it makes the simple case
+        // require no configuration at all.
+        __parent: ctx.inputs
+      },
+      depth: depth + 1
+    }
+  );
+  if (!result.ok) {
+    ctx.abort(`subflow "${ref}" failed: ${result.error ?? "unknown error"}`);
+  }
+  if (mode === "stream") {
+    return { __port: "stream", value: result.outputs };
+  }
+  if (mode === "both") {
+    return result.outputs;
+  }
+  return { __port: "out", value: result.outputs };
+};
+
 // src/registry/builtin.ts
 function casePorts(cases) {
   const byPort = /* @__PURE__ */ new Map();
@@ -258,8 +551,8 @@ var HTTP_METHODS = [
 var KINDS = [
   // ───────────── Triggers ─────────────
   {
-    name: "@fancy/manual_trigger",
-    aliases: ["manual_trigger"],
+    name: "@particle-academy/manual_trigger",
+    aliases: ["manual_trigger", "@fancy/manual_trigger"],
     category: "trigger",
     label: "Manual",
     description: "Entry point fired when the user clicks Run.",
@@ -268,8 +561,8 @@ var KINDS = [
     outputs: [{ id: "out" }]
   },
   {
-    name: "@fancy/webhook_trigger",
-    aliases: ["webhook_trigger"],
+    name: "@particle-academy/webhook_trigger",
+    aliases: ["webhook_trigger", "@fancy/webhook_trigger"],
     category: "trigger",
     label: "Webhook",
     description: "Triggered by an inbound HTTP request to a host-provided URL.",
@@ -286,8 +579,8 @@ var KINDS = [
     ]
   },
   {
-    name: "@fancy/schedule_trigger",
-    aliases: ["schedule_trigger"],
+    name: "@particle-academy/schedule_trigger",
+    aliases: ["schedule_trigger", "@fancy/schedule_trigger"],
     category: "trigger",
     label: "Schedule",
     description: "Fires on a cron schedule (host-implemented).",
@@ -307,8 +600,8 @@ var KINDS = [
     ]
   },
   {
-    name: "@fancy/user_input",
-    aliases: ["user_input"],
+    name: "@particle-academy/user_input",
+    aliases: ["user_input", "@fancy/user_input"],
     category: "human",
     label: "User Input",
     description: "Pause the flow until the user submits the configured form.",
@@ -348,8 +641,8 @@ var KINDS = [
     ]
   },
   {
-    name: "@fancy/rich_user_input",
-    aliases: ["rich_user_input"],
+    name: "@particle-academy/rich_user_input",
+    aliases: ["rich_user_input", "@fancy/rich_user_input"],
     category: "human",
     label: "Rich User Input",
     description: "Pause the flow on a fully authored page \u2014 content, required reading, multi-section forms.",
@@ -372,10 +665,61 @@ var KINDS = [
     // what the person hitting this step will actually see.
     renderBody: (ctx) => ReactExports.createElement(RichInputPreview, { config: ctx.config ?? {} })
   },
+  {
+    name: "@particle-academy/subflow",
+    aliases: ["subflow", "@fancy/subflow"],
+    category: "logic",
+    label: "SubFlow",
+    description: "Run another workflow and bring its result \u2014 or its live progress \u2014 back into this one.",
+    icon: "\u29C9",
+    inputs: [{ id: "in" }],
+    // The stream port only exists when something actually streams.
+    outputs: (config) => subflowPorts(config ?? {}),
+    // Core, not marketplace: it runs a child graph through this same engine and
+    // needs nothing from outside except where workflows live.
+    executor: subflowExecutor,
+    configSchema: [
+      {
+        type: "text",
+        key: "workflow",
+        label: "Workflow",
+        required: true,
+        placeholder: "onboarding-v2",
+        description: "Reference resolved by the host's registerWorkflowResolver()."
+      },
+      {
+        type: "select",
+        key: "mode",
+        label: "Return",
+        default: "output",
+        options: [
+          { value: "output", label: "Output when it finishes" },
+          { value: "stream", label: "Stream progress as it runs" },
+          { value: "both", label: "Both \u2014 stream, then output" }
+        ],
+        description: "Streaming adds a second port so a parent can show progress instead of a spinner."
+      },
+      {
+        type: "json",
+        key: "inputs",
+        label: "Input mapping",
+        description: "Entry-point inputs for the child run. Omit to pass this node's inputs straight through."
+      },
+      {
+        type: "number",
+        key: "maxDepth",
+        label: "Max nesting depth",
+        default: DEFAULT_MAX_DEPTH,
+        min: 1,
+        max: 32,
+        description: "Guards against a workflow referencing itself."
+      }
+    ]
+  },
   // ───────────── Logic ─────────────
   {
-    name: "@fancy/branch",
-    aliases: ["branch"],
+    name: "@particle-academy/branch",
+    aliases: ["branch", "@fancy/branch"],
     category: "logic",
     label: "Branch",
     description: "Multi-way branch on a condition or value.",
@@ -387,8 +731,8 @@ var KINDS = [
     ]
   },
   {
-    name: "@fancy/switch_case",
-    aliases: ["switch_case"],
+    name: "@particle-academy/switch_case",
+    aliases: ["switch_case", "@fancy/switch_case"],
     category: "logic",
     label: "Switch",
     description: "Route to one of N labelled outputs based on a key.",
@@ -415,8 +759,8 @@ var KINDS = [
     ]
   },
   {
-    name: "@fancy/for_each",
-    aliases: ["for_each"],
+    name: "@particle-academy/for_each",
+    aliases: ["for_each", "@fancy/for_each"],
     category: "logic",
     label: "For Each",
     description: "Iterate over a list, emitting each item on `item`.",
@@ -429,8 +773,8 @@ var KINDS = [
     ]
   },
   {
-    name: "@fancy/merge",
-    aliases: ["merge"],
+    name: "@particle-academy/merge",
+    aliases: ["merge", "@fancy/merge"],
     category: "logic",
     label: "Merge",
     description: "Combine multiple inputs into one object or array.",
@@ -448,8 +792,8 @@ var KINDS = [
     ]
   },
   {
-    name: "@fancy/wait",
-    aliases: ["wait"],
+    name: "@particle-academy/wait",
+    aliases: ["wait", "@fancy/wait"],
     category: "logic",
     label: "Wait",
     description: "Sleep or wait for an external event.",
@@ -466,8 +810,8 @@ var KINDS = [
     ]
   },
   {
-    name: "@fancy/transform",
-    aliases: ["transform"],
+    name: "@particle-academy/transform",
+    aliases: ["transform", "@fancy/transform"],
     category: "logic",
     label: "Transform",
     description: "Reshape data with an expression.",
@@ -484,8 +828,8 @@ var KINDS = [
   },
   // ───────────── Data ─────────────
   {
-    name: "@fancy/memory_store",
-    aliases: ["memory_store"],
+    name: "@particle-academy/memory_store",
+    aliases: ["memory_store", "@fancy/memory_store"],
     category: "data",
     label: "Memory Store",
     description: "Read or write per-conversation memory.",
@@ -505,8 +849,8 @@ var KINDS = [
     ]
   },
   {
-    name: "@fancy/data_store",
-    aliases: ["data_store"],
+    name: "@particle-academy/data_store",
+    aliases: ["data_store", "@fancy/data_store"],
     category: "data",
     label: "Data Store",
     description: "Key-value or table read/write against a host store.",
@@ -534,8 +878,8 @@ var KINDS = [
     ]
   },
   {
-    name: "@fancy/variable",
-    aliases: ["variable"],
+    name: "@particle-academy/variable",
+    aliases: ["variable", "@fancy/variable"],
     category: "data",
     label: "Variable",
     description: "Workflow-scoped value used by other nodes.",
@@ -547,8 +891,8 @@ var KINDS = [
   },
   // ───────────── AI ─────────────
   {
-    name: "@fancy/llm_call",
-    aliases: ["llm_call"],
+    name: "@particle-academy/llm_call",
+    aliases: ["llm_call", "@fancy/llm_call"],
     category: "ai",
     label: "LLM Call",
     description: "Send a prompt + context to a model and receive a response.",
@@ -575,8 +919,8 @@ var KINDS = [
     ]
   },
   {
-    name: "@fancy/llm_branch",
-    aliases: ["llm_branch"],
+    name: "@particle-academy/llm_branch",
+    aliases: ["llm_branch", "@fancy/llm_branch"],
     category: "ai",
     label: "LLM Router",
     description: "Let a model choose which route the flow takes.",
@@ -585,6 +929,10 @@ var KINDS = [
     // Each declared route is a port. The executor returns `{ __port: id }`
     // (or `Port.only(id)` on the PHP runtime) to pick one.
     outputs: (config) => routePorts(config?.routes, config?.fallback),
+    // A shuttle, not an engine: it carries the routes out to whatever LLM
+    // client the host registered and carries the choice back. No provider SDK
+    // reaches core, so this stays a builtin without adding a dependency.
+    executor: llmBranchExecutor,
     configSchema: [
       {
         type: "textarea",
@@ -646,8 +994,8 @@ var KINDS = [
     ]
   },
   {
-    name: "@fancy/tool_use",
-    aliases: ["tool_use"],
+    name: "@particle-academy/tool_use",
+    aliases: ["tool_use", "@fancy/tool_use"],
     category: "ai",
     label: "Tool Use",
     description: "Hand control to a host-registered tool by name.",
@@ -658,8 +1006,8 @@ var KINDS = [
     ]
   },
   {
-    name: "@fancy/embed_search",
-    aliases: ["embed_search"],
+    name: "@particle-academy/embed_search",
+    aliases: ["embed_search", "@fancy/embed_search"],
     category: "ai",
     label: "Embed & Search",
     description: "Embed a query and search a vector store.",
@@ -672,8 +1020,8 @@ var KINDS = [
   },
   // ───────────── IO ─────────────
   {
-    name: "@fancy/api_request",
-    aliases: ["api_request"],
+    name: "@particle-academy/api_request",
+    aliases: ["api_request", "@fancy/api_request"],
     category: "io",
     label: "API Request",
     description: "HTTP request to any URL.",
@@ -687,8 +1035,8 @@ var KINDS = [
     ]
   },
   {
-    name: "@fancy/webhook_out",
-    aliases: ["webhook_out"],
+    name: "@particle-academy/webhook_out",
+    aliases: ["webhook_out", "@fancy/webhook_out"],
     category: "io",
     label: "Send Webhook",
     description: "POST a payload to a configured URL.",
@@ -701,8 +1049,8 @@ var KINDS = [
   },
   // ───────────── Human ─────────────
   {
-    name: "@fancy/human_approval",
-    aliases: ["human_approval"],
+    name: "@particle-academy/human_approval",
+    aliases: ["human_approval", "@fancy/human_approval"],
     category: "human",
     label: "Human Approval",
     description: "Pause until a human approves or denies.",
@@ -716,8 +1064,8 @@ var KINDS = [
     ]
   },
   {
-    name: "@fancy/notify",
-    aliases: ["notify"],
+    name: "@particle-academy/notify",
+    aliases: ["notify", "@fancy/notify"],
     category: "human",
     label: "Notify",
     description: "Send a message via Slack / email / SMS / etc.",
@@ -741,8 +1089,8 @@ var KINDS = [
   },
   // ───────────── Output ─────────────
   {
-    name: "@fancy/output",
-    aliases: ["output"],
+    name: "@particle-academy/output",
+    aliases: ["output", "@fancy/output"],
     category: "output",
     label: "Output",
     description: "Terminal node \u2014 captures the workflow's result.",
@@ -751,8 +1099,8 @@ var KINDS = [
     outputs: []
   },
   {
-    name: "@fancy/log",
-    aliases: ["log"],
+    name: "@particle-academy/log",
+    aliases: ["log", "@fancy/log"],
     category: "output",
     label: "Log",
     description: "Send to the run feed.",
@@ -10435,173 +10783,6 @@ function useFlowState(initial) {
   const toGraph = ReactExports.useCallback(() => ({ nodes, edges }), [nodes, edges]);
   return { nodes, edges, setNodes, setEdges, onNodesChange, onEdgesChange, onConnect, toGraph };
 }
-
-// src/registry/ports.ts
-function resolvePortSpec(spec, config) {
-  if (spec === void 0) return void 0;
-  if (typeof spec !== "function") return spec;
-  try {
-    const resolved = spec(config);
-    return Array.isArray(resolved) ? resolved : void 0;
-  } catch {
-    return void 0;
-  }
-}
-function nodeConfig(node) {
-  return node.data?.config ?? {};
-}
-function resolveNodePorts(node, kind) {
-  const config = nodeConfig(node);
-  const data = node.data;
-  return {
-    inputs: data?.inputs ?? resolvePortSpec(kind?.inputs, config),
-    outputs: data?.outputs ?? resolvePortSpec(kind?.outputs, config)
-  };
-}
-
-// src/runtime/run-flow.ts
-async function runFlow(graph, executors, onEvent = () => {
-}, options = {}) {
-  const { signal, initialInputs = {}, timeoutMs } = options;
-  const outputs = {};
-  const portValues = /* @__PURE__ */ new Map();
-  const completed = /* @__PURE__ */ new Set();
-  const errors = [];
-  const order = topoSort(graph);
-  if (order === null) {
-    const msg = "Cycle detected in flow graph \u2014 aborting.";
-    onEvent({ type: "run-error", error: msg });
-    return { ok: false, outputs, error: msg };
-  }
-  const incomingByNode = indexIncoming(graph.edges);
-  const timer2 = timeoutMs ? setTimeout(() => errors.push(`Run timed out after ${timeoutMs}ms`), timeoutMs) : null;
-  onEvent({ type: "run-start" });
-  try {
-    for (const node of order) {
-      if (signal?.aborted) throw new Error("aborted");
-      if (errors.length) break;
-      const incoming = incomingByNode.get(node.id) ?? [];
-      if (incoming.length > 0) {
-        const anyActive = incoming.some((e) => portValues.has(`${e.source}:${e.sourceHandle ?? "out"}`));
-        if (!anyActive) {
-          onEvent({ type: "node-status", nodeId: node.id, status: "idle", text: "skipped" });
-          continue;
-        }
-      }
-      if (node.type === "note") {
-        onEvent({ type: "node-status", nodeId: node.id, status: "idle", text: "annotation" });
-        continue;
-      }
-      onEvent({ type: "node-status", nodeId: node.id, status: "running" });
-      const inputs = collectInputs(node, incoming, portValues, initialInputs);
-      const exec = pickExecutor(executors, node);
-      if (!exec) {
-        const msg = `No executor registered for kind=${node.type}`;
-        errors.push(msg);
-        onEvent({ type: "node-status", nodeId: node.id, status: "error", text: msg });
-        onEvent({ type: "log", nodeId: node.id, level: "error", message: msg });
-        break;
-      }
-      try {
-        const result = await Promise.resolve(
-          exec({
-            node,
-            inputs,
-            abort: (reason) => {
-              throw new Error(reason ?? "aborted");
-            },
-            emit: onEvent
-          })
-        );
-        outputs[node.id] = result;
-        const activated = activatedPorts(node, result);
-        for (const portId of activated.ports) {
-          portValues.set(`${node.id}:${portId}`, activated.value);
-          onEvent({ type: "node-output", nodeId: node.id, portId, value: activated.value });
-        }
-        completed.add(node.id);
-        onEvent({ type: "node-status", nodeId: node.id, status: "done" });
-      } catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
-        errors.push(msg);
-        onEvent({ type: "node-status", nodeId: node.id, status: "error", text: msg });
-        onEvent({ type: "log", nodeId: node.id, level: "error", message: msg });
-        break;
-      }
-    }
-  } finally {
-    if (timer2) clearTimeout(timer2);
-  }
-  const ok = errors.length === 0;
-  onEvent({ type: "run-end", ok });
-  return ok ? { ok, outputs } : { ok, outputs, error: errors[0] };
-}
-function indexIncoming(edges) {
-  const map = /* @__PURE__ */ new Map();
-  for (const e of edges) {
-    const list = map.get(e.target) ?? [];
-    list.push(e);
-    map.set(e.target, list);
-  }
-  return map;
-}
-function topoSort(graph) {
-  const inDegree = /* @__PURE__ */ new Map();
-  for (const n of graph.nodes) inDegree.set(n.id, 0);
-  for (const e of graph.edges) inDegree.set(e.target, (inDegree.get(e.target) ?? 0) + 1);
-  const queue = [];
-  for (const [id2, d] of inDegree) if (d === 0) queue.push(id2);
-  const ordered = [];
-  while (queue.length) {
-    const id2 = queue.shift();
-    ordered.push(id2);
-    for (const e of graph.edges) {
-      if (e.source !== id2) continue;
-      const next = (inDegree.get(e.target) ?? 0) - 1;
-      inDegree.set(e.target, next);
-      if (next === 0) queue.push(e.target);
-    }
-  }
-  if (ordered.length !== graph.nodes.length) return null;
-  const byId = new Map(graph.nodes.map((n) => [n.id, n]));
-  return ordered.map((id2) => byId.get(id2)).filter(Boolean);
-}
-function collectInputs(node, incoming, portValues, initial) {
-  const inputs = { ...initial[node.id] ?? {} };
-  for (const e of incoming) {
-    const portId = e.targetHandle ?? "in";
-    const val = portValues.get(`${e.source}:${e.sourceHandle ?? "out"}`);
-    inputs[portId] = val;
-  }
-  return inputs;
-}
-function pickExecutor(executors, node) {
-  if (executors[node.id]) return executors[node.id];
-  if (node.type && executors[node.type]) return executors[node.type];
-  const kind = node.type ? getNodeKind(node.type) : null;
-  if (kind) {
-    for (const id2 of kindIds(kind)) {
-      if (executors[id2]) return executors[id2];
-    }
-  }
-  return executors["*"];
-}
-function activatedPorts(node, result) {
-  if (result && typeof result === "object") {
-    const r = result;
-    if (typeof r.__port === "string") {
-      return { ports: [r.__port], value: r.value };
-    }
-    if (typeof r.branch === "string") {
-      return { ports: [r.branch], value: r.value ?? r };
-    }
-  }
-  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 };
-}
-
-// src/runtime/use-flow-run.ts
 function useFlowRun({ maxFeed = 200 } = {}) {
   const [statuses, setStatuses] = ReactExports.useState({});
   const [statusText, setStatusText] = ReactExports.useState({});