@particle-academy/fancy-flow 0.13.0 → 0.15.0

package/dist/index.cjs

@@ -222,7 +222,7 @@ function getWorkflowResolver() {
   return workflowResolver;
 }
 
-// src/registry/llm-branch.ts
+// src/registry/llm-router.ts
 function declaredRoutes(config) {
   const raw = config.routes;
   if (!Array.isArray(raw)) return [];
@@ -232,11 +232,11 @@ function resolveFallbackPort(routes, fallbackEnabled) {
   if (fallbackEnabled) return "fallback";
   return routes[0]?.port ?? "out";
 }
-var llmBranchExecutor = async (ctx) => {
+var llmRouterExecutor = async (ctx) => {
   const config = ctx.node.data?.config ?? {};
   const routes = declaredRoutes(config);
   if (routes.length === 0) {
-    ctx.abort("llm_branch has no routes configured");
+    ctx.abort("llm_router has no routes configured");
   }
   const client = getLlmClient();
   {
@@ -262,7 +262,7 @@ var llmBranchExecutor = async (ctx) => {
       type: "log",
       nodeId: ctx.node.id,
       level: "warn",
-      message: `llm_branch: model returned "${port || "(nothing)"}", which is not a declared route. Routing to "${safe}".`
+      message: `llm_router: model returned "${port || "(nothing)"}", which is not a declared route. Routing to "${safe}".`
     });
     reason = reason ?? `unrecognised route "${port}"`;
     port = safe;
@@ -602,6 +602,7 @@ var KINDS = [
   {
     name: "@particle-academy/user_input",
     aliases: ["user_input", "@fancy/user_input"],
+    pausesForHuman: "input",
     category: "human",
     label: "User Input",
     description: "Pause the flow until the user submits the configured form.",
@@ -643,6 +644,7 @@ var KINDS = [
   {
     name: "@particle-academy/rich_user_input",
     aliases: ["rich_user_input", "@fancy/rich_user_input"],
+    pausesForHuman: "input",
     category: "human",
     label: "Rich User Input",
     description: "Pause the flow on a fully authored page \u2014 content, required reading, multi-section forms.",
@@ -700,10 +702,13 @@ var KINDS = [
         description: "Streaming adds a second port so a parent can show progress instead of a spinner."
       },
       {
-        type: "json",
+        type: "keyvalue",
         key: "inputs",
         label: "Input mapping",
-        description: "Entry-point inputs for the child run. Omit to pass this node's inputs straight through."
+        description: "Values handed to the child's entry points. Omit to pass this node's inputs straight through.",
+        keyLabel: "Name",
+        valueLabel: "Value",
+        addLabel: "Add input"
       },
       {
         type: "number",
@@ -727,7 +732,57 @@ var KINDS = [
     inputs: [{ id: "in" }],
     outputs: [{ id: "true", label: "true" }, { id: "false", label: "false" }],
     configSchema: [
-      { type: "expression", key: "condition", label: "Condition", example: "{{ $json.active }}", required: true }
+      {
+        type: "select",
+        key: "match",
+        label: "Match",
+        default: "all",
+        options: [
+          { value: "all", label: "All conditions (AND)" },
+          { value: "any", label: "Any condition (OR)" }
+        ]
+      },
+      {
+        type: "repeater",
+        key: "conditions",
+        label: "Conditions",
+        description: "Routes to `true` when these match, otherwise `false`.",
+        titleKey: "left",
+        addLabel: "Add condition",
+        minItems: 1,
+        fields: [
+          { type: "expression", key: "left", label: "Value", example: "{{ $json.status }}", required: true },
+          {
+            type: "select",
+            key: "operator",
+            label: "Is",
+            default: "eq",
+            options: [
+              { value: "eq", label: "equal to" },
+              { value: "neq", label: "not equal to" },
+              { value: "contains", label: "contains" },
+              { value: "not_contains", label: "does not contain" },
+              { value: "gt", label: "greater than" },
+              { value: "gte", label: "greater than or equal to" },
+              { value: "lt", label: "less than" },
+              { value: "lte", label: "less than or equal to" },
+              { value: "truthy", label: "true" },
+              { value: "falsy", label: "false" },
+              { value: "empty", label: "empty" },
+              { value: "not_empty", label: "not empty" }
+            ]
+          },
+          { type: "text", key: "right", label: "Compared to", placeholder: "active" }
+        ],
+        default: [{ left: "", operator: "eq", right: "" }]
+      },
+      {
+        type: "expression",
+        key: "condition",
+        label: "Raw expression (advanced)",
+        example: "{{ $json.active && $json.score > 10 }}",
+        description: "Escape hatch for logic the builder can't express. Overrides the conditions above when set."
+      }
     ]
   },
   {
@@ -817,12 +872,35 @@ var KINDS = [
     description: "Reshape data with an expression.",
     icon: "\u0192",
     configSchema: [
+      {
+        type: "select",
+        key: "mode",
+        label: "Build the output",
+        default: "fields",
+        options: [
+          { value: "fields", label: "Field by field" },
+          { value: "expression", label: "One expression" }
+        ]
+      },
+      {
+        type: "repeater",
+        key: "fields",
+        label: "Output fields",
+        description: "Each row becomes a key on the result.",
+        titleKey: "key",
+        addLabel: "Add field",
+        fields: [
+          { type: "text", key: "key", label: "Key", required: true, placeholder: "name" },
+          { type: "expression", key: "value", label: "Value", example: "{{ $json.first }}", required: true }
+        ],
+        default: [{ key: "", value: "" }]
+      },
       {
         type: "expression",
         key: "expression",
-        label: "Expression",
+        label: "Expression (advanced)",
         example: "{{ { id: $json.id, name: $json.first + ' ' + $json.last } }}",
-        required: true
+        description: "Used when the mode above is set to one expression."
       }
     ]
   },
@@ -872,7 +950,15 @@ var KINDS = [
       },
       { type: "text", key: "table", label: "Table / collection", required: true },
       { type: "text", key: "key", label: "Key" },
-      { type: "json", key: "where", label: "Where (JSON)", description: "For query/list operations." },
+      {
+        type: "keyvalue",
+        key: "where",
+        label: "Where",
+        description: "Field/value pairs to match. For query and list operations.",
+        keyLabel: "Field",
+        valueLabel: "Equals",
+        addLabel: "Add filter"
+      },
       { type: "expression", key: "value", label: "Value (set only)", example: "{{ $json }}" },
       { type: "credential", key: "store", label: "Data store", credentialType: "data_store" }
     ]
@@ -914,13 +1000,32 @@ var KINDS = [
       { type: "expression", key: "prompt", label: "User prompt", example: "{{ $json.question }}", required: true },
       { type: "number", key: "temperature", label: "Temperature", min: 0, max: 2, step: 0.1, default: 0.7 },
       { type: "number", key: "max_tokens", label: "Max tokens", min: 1, max: 8192, default: 1024 },
-      { type: "json", key: "tools", label: "Tools (JSON)", description: "Optional Anthropic-style tool definitions." },
+      {
+        type: "repeater",
+        key: "tools",
+        label: "Tools",
+        description: "Tools the model may call.",
+        titleKey: "name",
+        addLabel: "Add tool",
+        fields: [
+          { type: "text", key: "name", label: "Name", required: true, placeholder: "search_index" },
+          { type: "text", key: "description", label: "When to use it" },
+          {
+            type: "json",
+            key: "input_schema",
+            label: "Input schema",
+            description: "JSON Schema for the tool's arguments."
+          }
+        ]
+      },
       { type: "credential", key: "credential", label: "API credential", credentialType: "llm_credential" }
     ]
   },
   {
-    name: "@particle-academy/llm_branch",
-    aliases: ["llm_branch", "@fancy/llm_branch"],
+    name: "@particle-academy/llm_router",
+    // Every id this node has ever shipped under keeps resolving — MOIC's saved
+    // flows carry the bare `llm_branch`.
+    aliases: ["llm_router", "llm_branch", "@fancy/llm_branch", "@fancy/llm_router"],
     category: "ai",
     label: "LLM Router",
     description: "Let a model choose which route the flow takes.",
@@ -932,7 +1037,7 @@ var KINDS = [
     // 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,
+    executor: llmRouterExecutor,
     configSchema: [
       {
         type: "textarea",
@@ -1029,7 +1134,17 @@ var KINDS = [
     configSchema: [
       ...HTTP_METHODS,
       { type: "text", key: "url", label: "URL", placeholder: "https://api.example.com/...", required: true },
-      { type: "json", key: "headers", label: "Headers", default: { "content-type": "application/json" } },
+      {
+        type: "keyvalue",
+        key: "headers",
+        label: "Headers",
+        keyLabel: "Header",
+        valueLabel: "Value",
+        keyPlaceholder: "content-type",
+        valuePlaceholder: "application/json",
+        addLabel: "Add header",
+        default: { "content-type": "application/json" }
+      },
       { type: "json", key: "body", label: "Body" },
       { type: "credential", key: "auth", label: "Auth", credentialType: "api_credential" }
     ]
@@ -1043,7 +1158,14 @@ var KINDS = [
     icon: "\u2197",
     configSchema: [
       { type: "text", key: "url", label: "URL", required: true },
-      { type: "json", key: "headers", label: "Headers" },
+      {
+        type: "keyvalue",
+        key: "headers",
+        label: "Headers",
+        keyLabel: "Header",
+        valueLabel: "Value",
+        addLabel: "Add header"
+      },
       { type: "expression", key: "payload", label: "Payload", required: true, example: "{{ $json }}" }
     ]
   },
@@ -1051,6 +1173,7 @@ var KINDS = [
   {
     name: "@particle-academy/human_approval",
     aliases: ["human_approval", "@fancy/human_approval"],
+    pausesForHuman: "approval",
     category: "human",
     label: "Human Approval",
     description: "Pause until a human approves or denies.",
@@ -10988,6 +11111,42 @@ function importWorkflow(schema, options = {}) {
 function workflowToBlob(schema) {
   return new Blob([JSON.stringify(schema, null, 2)], { type: "application/json" });
 }
+
+// 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 }));
+}
 function RegistryNodeInner(props) {
   const kindName = props.data.kind ?? props.type;
   const kind = ReactExports.useMemo(() => getNodeKind(kindName), [kindName]);
@@ -11639,12 +11798,14 @@ exports.FlowCanvas = FlowCanvas;
 exports.FlowEditor = FlowEditor;
 exports.FlowRunControls = FlowRunControls;
 exports.FlowRunFeed = FlowRunFeed;
+exports.LEGACY_PAUSE_PREFIXES = LEGACY_PAUSE_PREFIXES;
 exports.NodeConfigPanel = NodeConfigPanel;
 exports.NodePalette = NodePalette;
 exports.NodePort = NodePort;
 exports.NodeShell = NodeShell;
 exports.NoteNode = NoteNode;
 exports.OutputNode = OutputNode2;
+exports.PAUSE_PREFIX = PAUSE_PREFIX;
 exports.RegistryNode = RegistryNode;
 exports.RichInputPreview = RichInputPreview;
 exports.SubgraphNode = SubgraphNode;
@@ -11654,18 +11815,22 @@ exports.WORKFLOW_SCHEMA_VERSION = WORKFLOW_SCHEMA_VERSION;
 exports.applyStatusesToNodes = applyStatusesToNodes;
 exports.buildNodeTypes = buildNodeTypes;
 exports.categoryAccent = categoryAccent;
+exports.decodePause = decodePause;
 exports.defaultConfigFor = defaultConfigFor;
 exports.defaultNodeTypes = defaultNodeTypes;
 exports.defineNode = defineNode;
+exports.encodePause = encodePause;
 exports.exportWorkflow = exportWorkflow;
 exports.getNodeKind = getNodeKind;
 exports.getRichInputAdapter = getRichInputAdapter;
 exports.importWorkflow = importWorkflow;
+exports.isPause = isPause;
 exports.isRichInputEnabled = isRichInputEnabled;
 exports.listNodeKinds = listNodeKinds;
 exports.onNodeKindsChanged = onNodeKindsChanged;
 exports.onRichInputAdapterChanged = onRichInputAdapterChanged;
 exports.paletteDropHandlers = paletteDropHandlers;
+exports.pauseForHuman = pauseForHuman;
 exports.registerBuiltinKinds = registerBuiltinKinds;
 exports.registerNodeKind = registerNodeKind;
 exports.registerRichInputAdapter = registerRichInputAdapter;