@particle-academy/fancy-flow 0.10.1 → 0.12.0

package/dist/registry.cjs

@@ -30,82 +30,82 @@ function resolveNodePorts(node, kind) {
     outputs: data?.outputs ?? resolvePortSpec(kind?.outputs, config)
   };
 }
-var adapter = null;
-var listeners = /* @__PURE__ */ new Set();
-function registerRichInputAdapter(next) {
-  adapter = next;
-  for (const l of listeners) l();
+
+// src/registry/capabilities.ts
+var llmClient = null;
+function registerLlmClient(client) {
+  llmClient = client;
   return () => {
-    if (adapter === next) {
-      adapter = null;
-      for (const l of listeners) l();
-    }
+    if (llmClient === client) llmClient = null;
   };
 }
-function getRichInputAdapter() {
-  return adapter;
+function getLlmClient() {
+  return llmClient;
 }
-function isRichInputEnabled() {
-  return adapter !== null && (adapter.renderDocument !== void 0 || adapter.renderEditor !== void 0);
+var workflowResolver = null;
+function registerWorkflowResolver(resolver) {
+  workflowResolver = resolver;
+  return () => {
+    if (workflowResolver === resolver) workflowResolver = null;
+  };
 }
-function onRichInputAdapterChanged(fn) {
-  listeners.add(fn);
-  return () => listeners.delete(fn);
+function getWorkflowResolver() {
+  return workflowResolver;
 }
-function RichInputPreview({ config }) {
-  const a = getRichInputAdapter();
-  const title = typeof config.title === "string" && config.title.trim() !== "" ? config.title : "Untitled step";
-  const doc = config.document;
-  if (!a || !a.renderDocument && !a.renderEditor) {
-    return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "ff-rich-preview", children: [
-      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ff-rich-preview__title", children: title }),
-      /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "ff-rich-preview__unavailable", children: [
-        "Add ",
-        /* @__PURE__ */ jsxRuntime.jsx("code", { children: "@particle-academy/fancy-cms-ui" }),
-        " +",
-        " ",
-        /* @__PURE__ */ jsxRuntime.jsx("code", { children: "@particle-academy/react-fancy" }),
-        ", then",
-        " ",
-        /* @__PURE__ */ jsxRuntime.jsx("code", { children: 'import "@particle-academy/fancy-flow/rich-input"' }),
-        "."
-      ] })
-    ] });
+function capabilityStatus() {
+  let documentReady = false;
+  try {
+    documentReady = Boolean(globalThis.__fancyFlowDocumentAdapter);
+  } catch {
+    documentReady = false;
   }
-  const body = doc === void 0 || doc === null ? /* @__PURE__ */ jsxRuntime.jsx("p", { className: "ff-rich-preview__unavailable", children: "Nothing authored yet." }) : a.renderDocument?.(doc) ?? null;
-  const Frame = a.FauxClient;
-  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "ff-rich-preview", children: [
-    /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ff-rich-preview__title", children: title }),
-    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "ff-rich-preview__frame", children: Frame ? /* @__PURE__ */ jsxRuntime.jsx(Frame, { ...a.frameProps ?? { variant: "browser" }, children: body }) : body })
-  ] });
+  return {
+    llm: llmClient !== null,
+    workflow_resolver: workflowResolver !== null,
+    document: documentReady
+  };
 }
 
 // src/registry/registry.ts
 var kinds = /* @__PURE__ */ new Map();
-var listeners2 = /* @__PURE__ */ new Set();
+var aliases = /* @__PURE__ */ new Map();
+var listeners = /* @__PURE__ */ new Set();
 function registerNodeKind(definition) {
   kinds.set(definition.name, definition);
+  for (const alias of definition.aliases ?? []) aliases.set(alias, definition.name);
   notify();
   return () => {
     if (kinds.get(definition.name) === definition) {
       kinds.delete(definition.name);
+      for (const alias of definition.aliases ?? []) {
+        if (aliases.get(alias) === definition.name) aliases.delete(alias);
+      }
       notify();
     }
   };
 }
+function resolveKindId(id2) {
+  if (kinds.has(id2)) return id2;
+  const canonical = aliases.get(id2);
+  return canonical && kinds.has(canonical) ? canonical : null;
+}
 function getNodeKind(name) {
-  return kinds.get(name) ?? null;
+  const canonical = resolveKindId(name);
+  return canonical ? kinds.get(canonical) ?? null : null;
+}
+function kindIds(kind) {
+  return [kind.name, ...kind.aliases ?? []];
 }
 function listNodeKinds(category) {
   const all = Array.from(kinds.values());
   return category ? all.filter((k) => k.category === category) : all;
 }
 function onNodeKindsChanged(listener) {
-  listeners2.add(listener);
-  return () => listeners2.delete(listener);
+  listeners.add(listener);
+  return () => listeners.delete(listener);
 }
 function notify() {
-  for (const l of listeners2) l();
+  for (const l of listeners) l();
 }
 function defaultConfigFor(kind) {
   const fromKind = kind.defaultConfig ? { ...kind.defaultConfig } : {};
@@ -219,6 +219,315 @@ function categoryAccent(category) {
   }
 }
 
+// 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();
+  if (!resolver) {
+    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/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();
+  if (!client) {
+    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 } };
+};
+var adapter = null;
+var listeners2 = /* @__PURE__ */ new Set();
+function registerRichInputAdapter(next) {
+  adapter = next;
+  for (const l of listeners2) l();
+  return () => {
+    if (adapter === next) {
+      adapter = null;
+      for (const l of listeners2) l();
+    }
+  };
+}
+function getRichInputAdapter() {
+  return adapter;
+}
+function isRichInputEnabled() {
+  return adapter !== null && (adapter.renderDocument !== void 0 || adapter.renderEditor !== void 0);
+}
+function onRichInputAdapterChanged(fn) {
+  listeners2.add(fn);
+  return () => listeners2.delete(fn);
+}
+function RichInputPreview({ config }) {
+  const a = getRichInputAdapter();
+  const title = typeof config.title === "string" && config.title.trim() !== "" ? config.title : "Untitled step";
+  const doc = config.document;
+  if (!a || !a.renderDocument && !a.renderEditor) {
+    return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "ff-rich-preview", children: [
+      /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ff-rich-preview__title", children: title }),
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "ff-rich-preview__unavailable", children: [
+        "Add ",
+        /* @__PURE__ */ jsxRuntime.jsx("code", { children: "@particle-academy/fancy-cms-ui" }),
+        " +",
+        " ",
+        /* @__PURE__ */ jsxRuntime.jsx("code", { children: "@particle-academy/react-fancy" }),
+        ", then",
+        " ",
+        /* @__PURE__ */ jsxRuntime.jsx("code", { children: 'import "@particle-academy/fancy-flow/rich-input"' }),
+        "."
+      ] })
+    ] });
+  }
+  const body = doc === void 0 || doc === null ? /* @__PURE__ */ jsxRuntime.jsx("p", { className: "ff-rich-preview__unavailable", children: "Nothing authored yet." }) : a.renderDocument?.(doc) ?? null;
+  const Frame = a.FauxClient;
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "ff-rich-preview", children: [
+    /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ff-rich-preview__title", children: title }),
+    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "ff-rich-preview__frame", children: Frame ? /* @__PURE__ */ jsxRuntime.jsx(Frame, { ...a.frameProps ?? { variant: "browser" }, children: body }) : body })
+  ] });
+}
+
 // node_modules/classcat/index.js
 function cc(names) {
   if (typeof names === "string" || typeof names === "number") return "" + names;
@@ -9276,7 +9585,8 @@ var HTTP_METHODS = [
 var KINDS = [
   // ───────────── Triggers ─────────────
   {
-    name: "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.",
@@ -9285,7 +9595,8 @@ var KINDS = [
     outputs: [{ id: "out" }]
   },
   {
-    name: "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.",
@@ -9302,7 +9613,8 @@ var KINDS = [
     ]
   },
   {
-    name: "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).",
@@ -9322,7 +9634,8 @@ var KINDS = [
     ]
   },
   {
-    name: "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.",
@@ -9362,7 +9675,8 @@ var KINDS = [
     ]
   },
   {
-    name: "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.",
@@ -9385,9 +9699,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: "branch",
+    name: "@particle-academy/branch",
+    aliases: ["branch", "@fancy/branch"],
     category: "logic",
     label: "Branch",
     description: "Multi-way branch on a condition or value.",
@@ -9399,7 +9765,8 @@ var KINDS = [
     ]
   },
   {
-    name: "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.",
@@ -9426,7 +9793,8 @@ var KINDS = [
     ]
   },
   {
-    name: "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`.",
@@ -9439,7 +9807,8 @@ var KINDS = [
     ]
   },
   {
-    name: "merge",
+    name: "@particle-academy/merge",
+    aliases: ["merge", "@fancy/merge"],
     category: "logic",
     label: "Merge",
     description: "Combine multiple inputs into one object or array.",
@@ -9457,7 +9826,8 @@ var KINDS = [
     ]
   },
   {
-    name: "wait",
+    name: "@particle-academy/wait",
+    aliases: ["wait", "@fancy/wait"],
     category: "logic",
     label: "Wait",
     description: "Sleep or wait for an external event.",
@@ -9474,7 +9844,8 @@ var KINDS = [
     ]
   },
   {
-    name: "transform",
+    name: "@particle-academy/transform",
+    aliases: ["transform", "@fancy/transform"],
     category: "logic",
     label: "Transform",
     description: "Reshape data with an expression.",
@@ -9491,7 +9862,8 @@ var KINDS = [
   },
   // ───────────── Data ─────────────
   {
-    name: "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.",
@@ -9511,7 +9883,8 @@ var KINDS = [
     ]
   },
   {
-    name: "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.",
@@ -9539,7 +9912,8 @@ var KINDS = [
     ]
   },
   {
-    name: "variable",
+    name: "@particle-academy/variable",
+    aliases: ["variable", "@fancy/variable"],
     category: "data",
     label: "Variable",
     description: "Workflow-scoped value used by other nodes.",
@@ -9551,7 +9925,8 @@ var KINDS = [
   },
   // ───────────── AI ─────────────
   {
-    name: "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.",
@@ -9578,7 +9953,8 @@ var KINDS = [
     ]
   },
   {
-    name: "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.",
@@ -9587,6 +9963,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",
@@ -9648,7 +10028,8 @@ var KINDS = [
     ]
   },
   {
-    name: "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.",
@@ -9659,7 +10040,8 @@ var KINDS = [
     ]
   },
   {
-    name: "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.",
@@ -9672,7 +10054,8 @@ var KINDS = [
   },
   // ───────────── IO ─────────────
   {
-    name: "api_request",
+    name: "@particle-academy/api_request",
+    aliases: ["api_request", "@fancy/api_request"],
     category: "io",
     label: "API Request",
     description: "HTTP request to any URL.",
@@ -9686,7 +10069,8 @@ var KINDS = [
     ]
   },
   {
-    name: "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.",
@@ -9699,7 +10083,8 @@ var KINDS = [
   },
   // ───────────── Human ─────────────
   {
-    name: "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.",
@@ -9713,7 +10098,8 @@ var KINDS = [
     ]
   },
   {
-    name: "notify",
+    name: "@particle-academy/notify",
+    aliases: ["notify", "@fancy/notify"],
     category: "human",
     label: "Notify",
     description: "Send a message via Slack / email / SMS / etc.",
@@ -9737,7 +10123,8 @@ var KINDS = [
   },
   // ───────────── Output ─────────────
   {
-    name: "output",
+    name: "@particle-academy/output",
+    aliases: ["output", "@fancy/output"],
     category: "output",
     label: "Output",
     description: "Terminal node \u2014 captures the workflow's result.",
@@ -9746,7 +10133,8 @@ var KINDS = [
     outputs: []
   },
   {
-    name: "log",
+    name: "@particle-academy/log",
+    aliases: ["log", "@fancy/log"],
     category: "output",
     label: "Log",
     description: "Send to the run feed.",
@@ -9773,28 +10161,44 @@ var BUILTIN_KINDS = KINDS;
 // src/registry/index.ts
 function buildNodeTypes() {
   const map = {};
-  for (const k of listNodeKinds()) map[k.name] = RegistryNode;
+  for (const k of listNodeKinds()) {
+    for (const id2 of kindIds(k)) map[id2] = RegistryNode;
+  }
   return map;
 }
 
 exports.BUILTIN_KINDS = BUILTIN_KINDS;
+exports.DEFAULT_MAX_DEPTH = DEFAULT_MAX_DEPTH;
 exports.RegistryNode = RegistryNode;
 exports.RichInputPreview = RichInputPreview;
 exports.buildNodeTypes = buildNodeTypes;
+exports.capabilityStatus = capabilityStatus;
 exports.categoryAccent = categoryAccent;
+exports.declaredRoutes = declaredRoutes;
 exports.defaultConfigFor = defaultConfigFor;
+exports.getLlmClient = getLlmClient;
 exports.getNodeKind = getNodeKind;
 exports.getRichInputAdapter = getRichInputAdapter;
+exports.getWorkflowResolver = getWorkflowResolver;
 exports.isRichInputEnabled = isRichInputEnabled;
+exports.kindIds = kindIds;
 exports.listNodeKinds = listNodeKinds;
+exports.llmBranchExecutor = llmBranchExecutor;
 exports.nodeConfig = nodeConfig;
 exports.onNodeKindsChanged = onNodeKindsChanged;
 exports.onRichInputAdapterChanged = onRichInputAdapterChanged;
 exports.registerBuiltinKinds = registerBuiltinKinds;
+exports.registerLlmClient = registerLlmClient;
 exports.registerNodeKind = registerNodeKind;
 exports.registerRichInputAdapter = registerRichInputAdapter;
+exports.registerWorkflowResolver = registerWorkflowResolver;
+exports.resolveFallbackPort = resolveFallbackPort;
+exports.resolveKindId = resolveKindId;
 exports.resolveNodePorts = resolveNodePorts;
 exports.resolvePortSpec = resolvePortSpec;
+exports.subflowExecutor = subflowExecutor;
+exports.subflowMode = subflowMode;
+exports.subflowPorts = subflowPorts;
 exports.validateConfig = validateConfig;
 //# sourceMappingURL=registry.cjs.map
 //# sourceMappingURL=registry.cjs.map