@particle-academy/fancy-flow 0.13.0 → 0.14.0

package/dist/index.js

@@ -1,7 +1,7 @@
 import { useFlowState, useFlowRun, applyStatusesToNodes } from './chunk-MFMRTRPO.js';
 export { applyStatusesToNodes, useFlowRun, useFlowState } from './chunk-MFMRTRPO.js';
-import { buildNodeTypes, registerBuiltinKinds } from './chunk-WEZJFMLV.js';
-export { BUILTIN_KINDS, RegistryNode, buildNodeTypes, registerBuiltinKinds } from './chunk-WEZJFMLV.js';
+import { buildNodeTypes, registerBuiltinKinds } from './chunk-7U3EP4Q5.js';
+export { BUILTIN_KINDS, RegistryNode, buildNodeTypes, registerBuiltinKinds } from './chunk-7U3EP4Q5.js';
 import { ReactFlowProvider, useReactFlow, addEdge, applyEdgeChanges, applyNodeChanges, Position, Handle, index, BackgroundVariant, Background, Controls, MiniMap } from './chunk-NF6NPY5N.js';
 export { runFlow } from './chunk-L4AX73Q6.js';
 import { workflowToBlob, importWorkflow, exportWorkflow } from './chunk-D6W5FMCT.js';

package/dist/registry/index.d.cts

@@ -98,7 +98,7 @@ declare function declaredRoutes(config: Record<string, unknown>): LlmRoute[];
  * route, and always loudly.
  */
 declare function resolveFallbackPort(routes: LlmRoute[], fallbackEnabled: boolean): string;
-declare const llmBranchExecutor: NodeExecutor;
+declare const llmRouterExecutor: NodeExecutor;
 
 /**
  * Rich user input — the injection point.
@@ -230,4 +230,4 @@ declare const BUILTIN_KINDS: NodeKindDefinition[];
  */
 declare function buildNodeTypes(): NodeTypes;
 
-export { BUILTIN_KINDS, DEFAULT_MAX_DEPTH, LlmRoute, NodeKindDefinition, PortSpec, RegistryNode, type RichInputAdapter, RichInputPreview, type SubflowMode, buildNodeTypes, categoryAccent, declaredRoutes, defaultConfigFor, getNodeKind, getRichInputAdapter, isRichInputEnabled, kindIds, listNodeKinds, llmBranchExecutor, nodeConfig, onNodeKindsChanged, onRichInputAdapterChanged, registerBuiltinKinds, registerNodeKind, registerRichInputAdapter, resolveFallbackPort, resolveKindId, resolveNodePorts, resolvePortSpec, subflowExecutor, subflowMode, subflowPorts, validateConfig };
+export { BUILTIN_KINDS, DEFAULT_MAX_DEPTH, LlmRoute, NodeKindDefinition, PortSpec, RegistryNode, type RichInputAdapter, RichInputPreview, type SubflowMode, buildNodeTypes, categoryAccent, declaredRoutes, defaultConfigFor, getNodeKind, getRichInputAdapter, isRichInputEnabled, kindIds, listNodeKinds, llmRouterExecutor as llmBranchExecutor, llmRouterExecutor, nodeConfig, onNodeKindsChanged, onRichInputAdapterChanged, registerBuiltinKinds, registerNodeKind, registerRichInputAdapter, resolveFallbackPort, resolveKindId, resolveNodePorts, resolvePortSpec, subflowExecutor, subflowMode, subflowPorts, validateConfig };

package/dist/registry/index.d.ts

@@ -98,7 +98,7 @@ declare function declaredRoutes(config: Record<string, unknown>): LlmRoute[];
  * route, and always loudly.
  */
 declare function resolveFallbackPort(routes: LlmRoute[], fallbackEnabled: boolean): string;
-declare const llmBranchExecutor: NodeExecutor;
+declare const llmRouterExecutor: NodeExecutor;
 
 /**
  * Rich user input — the injection point.
@@ -230,4 +230,4 @@ declare const BUILTIN_KINDS: NodeKindDefinition[];
  */
 declare function buildNodeTypes(): NodeTypes;
 
-export { BUILTIN_KINDS, DEFAULT_MAX_DEPTH, LlmRoute, NodeKindDefinition, PortSpec, RegistryNode, type RichInputAdapter, RichInputPreview, type SubflowMode, buildNodeTypes, categoryAccent, declaredRoutes, defaultConfigFor, getNodeKind, getRichInputAdapter, isRichInputEnabled, kindIds, listNodeKinds, llmBranchExecutor, nodeConfig, onNodeKindsChanged, onRichInputAdapterChanged, registerBuiltinKinds, registerNodeKind, registerRichInputAdapter, resolveFallbackPort, resolveKindId, resolveNodePorts, resolvePortSpec, subflowExecutor, subflowMode, subflowPorts, validateConfig };
+export { BUILTIN_KINDS, DEFAULT_MAX_DEPTH, LlmRoute, NodeKindDefinition, PortSpec, RegistryNode, type RichInputAdapter, RichInputPreview, type SubflowMode, buildNodeTypes, categoryAccent, declaredRoutes, defaultConfigFor, getNodeKind, getRichInputAdapter, isRichInputEnabled, kindIds, listNodeKinds, llmRouterExecutor as llmBranchExecutor, llmRouterExecutor, nodeConfig, onNodeKindsChanged, onRichInputAdapterChanged, registerBuiltinKinds, registerNodeKind, registerRichInputAdapter, resolveFallbackPort, resolveKindId, resolveNodePorts, resolvePortSpec, subflowExecutor, subflowMode, subflowPorts, validateConfig };

package/dist/registry.cjs

@@ -431,7 +431,7 @@ var subflowExecutor = async (ctx) => {
   return { __port: "out", value: result.outputs };
 };
 
-// src/registry/llm-branch.ts
+// src/registry/llm-router.ts
 function declaredRoutes(config) {
   const raw = config.routes;
   if (!Array.isArray(raw)) return [];
@@ -441,11 +441,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();
   if (!client) {
@@ -471,7 +471,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;
@@ -9734,10 +9734,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",
@@ -9761,7 +9764,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."
+      }
     ]
   },
   {
@@ -9851,12 +9904,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."
       }
     ]
   },
@@ -9906,7 +9982,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" }
     ]
@@ -9948,13 +10032,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.",
@@ -9966,7 +10069,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",
@@ -10063,7 +10166,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" }
     ]
@@ -10077,7 +10190,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 }}" }
     ]
   },
@@ -10183,7 +10303,8 @@ exports.getWorkflowResolver = getWorkflowResolver;
 exports.isRichInputEnabled = isRichInputEnabled;
 exports.kindIds = kindIds;
 exports.listNodeKinds = listNodeKinds;
-exports.llmBranchExecutor = llmBranchExecutor;
+exports.llmBranchExecutor = llmRouterExecutor;
+exports.llmRouterExecutor = llmRouterExecutor;
 exports.nodeConfig = nodeConfig;
 exports.onNodeKindsChanged = onNodeKindsChanged;
 exports.onRichInputAdapterChanged = onRichInputAdapterChanged;