@particle-academy/fancy-flow 0.13.0 → 0.15.0

package/dist/llm/vercel-ai.d.cts

@@ -1,6 +1,6 @@
 import { LanguageModel } from 'ai';
-import { L as LlmRouteRequest, a as LlmClient } from '../capabilities-D-V9Rxv1.cjs';
-import '../types-fc0fFKkf.cjs';
+import { L as LlmRouteRequest, a as LlmClient } from '../capabilities-BEbLqnJU.cjs';
+import '../types-sOmpCitB.cjs';
 import '@xyflow/react';
 
 /**

package/dist/llm/vercel-ai.d.ts

@@ -1,6 +1,6 @@
 import { LanguageModel } from 'ai';
-import { L as LlmRouteRequest, a as LlmClient } from '../capabilities-B6r1Snfj.js';
-import '../types-fc0fFKkf.js';
+import { L as LlmRouteRequest, a as LlmClient } from '../capabilities-CI3gw0C7.js';
+import '../types-sOmpCitB.js';
 import '@xyflow/react';
 
 /**

package/dist/pause-9iT4tCEV.d.cts

@@ -0,0 +1,96 @@
+/**
+ * The human-pause contract.
+ *
+ * A workflow that waits for a person is not an error, but it travels the same
+ * channel as one: the executor aborts, the engine records a reason string, and
+ * the durable runner decides whether that string meant "failed" or "waiting".
+ *
+ * That seam existed before this module, as two `str_starts_with` checks in the
+ * Laravel run job against constants owned by two BUILTIN executors. It worked,
+ * and it was invisible: a third-party human-input node had no way to announce
+ * that it pauses, and nothing stopped a refactor from removing the mechanism
+ * out from under published packages. Reported by the MOIC Suite consumer, who
+ * needed exactly that and had to reach for a private constant to get it.
+ *
+ * So the encoding is now public, typed, and versioned by prefix rather than
+ * implied. The wire format stays a plain string on purpose — it survives the
+ * existing abort → `RunResult.error` path unchanged, crosses a queue boundary,
+ * and decodes identically in PHP, none of which a thrown class would do.
+ *
+ * @see decodePause — the one function a durable runner needs.
+ */
+/**
+ * What the run is waiting for.
+ *
+ * `approval` and `input` are the shapes both runtimes ship. The type stays open
+ * because the whole point is that a marketplace node can define its own —
+ * a signature step, a payment confirmation, a review queue — and a runner that
+ * does not recognise one should report it rather than guess.
+ */
+type PauseAwaiting = "approval" | "input" | (string & {});
+/** A run halted, waiting for a person. */
+type PauseSignal = {
+    /** The node that paused — where a submission gets injected on resume. */
+    nodeId: string;
+    awaiting: PauseAwaiting;
+    /**
+     * Kind-supplied context for whoever renders the wait — a form schema, the
+     * question being asked, a diff to approve. Must be JSON-serializable: it
+     * crosses a queue boundary and, for durable runs, a database column.
+     */
+    detail?: unknown;
+};
+/** Marks a reason string as a pause rather than a failure. */
+declare const PAUSE_PREFIX = "fancy-flow:pause:";
+/**
+ * Reason prefixes shipped before this contract, kept decodable forever.
+ *
+ * These are what `DurableApprovalExecutor` and `DurableUserInputExecutor`
+ * emitted, and they are written into the `error` column of every run that
+ * paused under an older version. Dropping them would strand those runs
+ * mid-flight — a resume path that only works for new runs is not a resume path.
+ */
+declare const LEGACY_PAUSE_PREFIXES: ReadonlyArray<readonly [string, PauseAwaiting]>;
+/**
+ * Encode a pause as the reason string an executor aborts with.
+ *
+ * The payload is JSON rather than delimited fields because a node id may
+ * contain a colon, and a positional encoding that breaks on user data is the
+ * kind of bug that only shows up in someone else's graph.
+ */
+declare function encodePause(signal: PauseSignal): string;
+/**
+ * Decode a run's error reason into a pause, or null if it was a real failure.
+ *
+ * This is the whole contract from a runner's side: call it on `result.error`,
+ * and if it returns non-null, persist the run as waiting on `signal.nodeId`
+ * instead of failing it. Accepts the legacy prefixes, so a runner written
+ * against this handles runs that paused under an older version.
+ */
+declare function decodePause(reason: string | null | undefined): PauseSignal | null;
+/** True when a run's error reason is actually a pause. */
+declare function isPause(reason: string | null | undefined): boolean;
+/**
+ * Abort the current node as a pause.
+ *
+ * Called from inside an executor with its own context. Node authors should
+ * reach for this rather than hand-encoding a reason, so the format stays ours
+ * to change:
+ *
+ * ```ts
+ * const values = ctx.inputs.values;
+ * if (values === undefined) pauseForHuman(ctx, "input", { fields });
+ * return values;
+ * ```
+ *
+ * Note the `undefined` check — an empty submission (`{}`) is a real answer and
+ * must resume. Truthiness here pauses forever on an empty form.
+ */
+declare function pauseForHuman(ctx: {
+    node: {
+        id: string;
+    };
+    abort: (reason?: string) => never;
+}, awaiting: PauseAwaiting, detail?: unknown): never;
+
+export { LEGACY_PAUSE_PREFIXES as L, type PauseAwaiting as P, PAUSE_PREFIX as a, type PauseSignal as b, decodePause as d, encodePause as e, isPause as i, pauseForHuman as p };

package/dist/pause-9iT4tCEV.d.ts

@@ -0,0 +1,96 @@
+/**
+ * The human-pause contract.
+ *
+ * A workflow that waits for a person is not an error, but it travels the same
+ * channel as one: the executor aborts, the engine records a reason string, and
+ * the durable runner decides whether that string meant "failed" or "waiting".
+ *
+ * That seam existed before this module, as two `str_starts_with` checks in the
+ * Laravel run job against constants owned by two BUILTIN executors. It worked,
+ * and it was invisible: a third-party human-input node had no way to announce
+ * that it pauses, and nothing stopped a refactor from removing the mechanism
+ * out from under published packages. Reported by the MOIC Suite consumer, who
+ * needed exactly that and had to reach for a private constant to get it.
+ *
+ * So the encoding is now public, typed, and versioned by prefix rather than
+ * implied. The wire format stays a plain string on purpose — it survives the
+ * existing abort → `RunResult.error` path unchanged, crosses a queue boundary,
+ * and decodes identically in PHP, none of which a thrown class would do.
+ *
+ * @see decodePause — the one function a durable runner needs.
+ */
+/**
+ * What the run is waiting for.
+ *
+ * `approval` and `input` are the shapes both runtimes ship. The type stays open
+ * because the whole point is that a marketplace node can define its own —
+ * a signature step, a payment confirmation, a review queue — and a runner that
+ * does not recognise one should report it rather than guess.
+ */
+type PauseAwaiting = "approval" | "input" | (string & {});
+/** A run halted, waiting for a person. */
+type PauseSignal = {
+    /** The node that paused — where a submission gets injected on resume. */
+    nodeId: string;
+    awaiting: PauseAwaiting;
+    /**
+     * Kind-supplied context for whoever renders the wait — a form schema, the
+     * question being asked, a diff to approve. Must be JSON-serializable: it
+     * crosses a queue boundary and, for durable runs, a database column.
+     */
+    detail?: unknown;
+};
+/** Marks a reason string as a pause rather than a failure. */
+declare const PAUSE_PREFIX = "fancy-flow:pause:";
+/**
+ * Reason prefixes shipped before this contract, kept decodable forever.
+ *
+ * These are what `DurableApprovalExecutor` and `DurableUserInputExecutor`
+ * emitted, and they are written into the `error` column of every run that
+ * paused under an older version. Dropping them would strand those runs
+ * mid-flight — a resume path that only works for new runs is not a resume path.
+ */
+declare const LEGACY_PAUSE_PREFIXES: ReadonlyArray<readonly [string, PauseAwaiting]>;
+/**
+ * Encode a pause as the reason string an executor aborts with.
+ *
+ * The payload is JSON rather than delimited fields because a node id may
+ * contain a colon, and a positional encoding that breaks on user data is the
+ * kind of bug that only shows up in someone else's graph.
+ */
+declare function encodePause(signal: PauseSignal): string;
+/**
+ * Decode a run's error reason into a pause, or null if it was a real failure.
+ *
+ * This is the whole contract from a runner's side: call it on `result.error`,
+ * and if it returns non-null, persist the run as waiting on `signal.nodeId`
+ * instead of failing it. Accepts the legacy prefixes, so a runner written
+ * against this handles runs that paused under an older version.
+ */
+declare function decodePause(reason: string | null | undefined): PauseSignal | null;
+/** True when a run's error reason is actually a pause. */
+declare function isPause(reason: string | null | undefined): boolean;
+/**
+ * Abort the current node as a pause.
+ *
+ * Called from inside an executor with its own context. Node authors should
+ * reach for this rather than hand-encoding a reason, so the format stays ours
+ * to change:
+ *
+ * ```ts
+ * const values = ctx.inputs.values;
+ * if (values === undefined) pauseForHuman(ctx, "input", { fields });
+ * return values;
+ * ```
+ *
+ * Note the `undefined` check — an empty submission (`{}`) is a real answer and
+ * must resume. Truthiness here pauses forever on an empty form.
+ */
+declare function pauseForHuman(ctx: {
+    node: {
+        id: string;
+    };
+    abort: (reason?: string) => never;
+}, awaiting: PauseAwaiting, detail?: unknown): never;
+
+export { LEGACY_PAUSE_PREFIXES as L, type PauseAwaiting as P, PAUSE_PREFIX as a, type PauseSignal as b, decodePause as d, encodePause as e, isPause as i, pauseForHuman as p };

package/dist/registry/index.d.cts

@@ -1,8 +1,9 @@
-import { a as NodeKindDefinition, P as PortSpec } from '../types-H60tQAxr.cjs';
-export { C as ConfigField, b as CredentialConfigField, D as DocumentConfigField, E as ExpressionConfigField, J as JsonConfigField, K as KeyValueConfigField, N as NodeCategory, c as NumberConfigField, R as RenderBodyContext, d as RepeaterConfigField, e as RepeaterRowField, S as SelectConfigField, f as SwitchConfigField, T as TextConfigField, g as TextareaConfigField } from '../types-H60tQAxr.cjs';
-import { a as FlowNode, P as PortDescriptor, N as NodeExecutor } from '../types-fc0fFKkf.cjs';
-import { b as LlmRoute } from '../capabilities-D-V9Rxv1.cjs';
-export { C as CapabilityId, a as LlmClient, c as LlmRouteChoice, L as LlmRouteRequest, W as WorkflowResolver, d as capabilityStatus, g as getLlmClient, e as getWorkflowResolver, r as registerLlmClient, f as registerWorkflowResolver } from '../capabilities-D-V9Rxv1.cjs';
+import { a as NodeKindDefinition, P as PortSpec } from '../types-D_jOR3Z2.cjs';
+export { C as ConfigField, b as CredentialConfigField, D as DocumentConfigField, E as ExpressionConfigField, J as JsonConfigField, K as KeyValueConfigField, N as NodeCategory, c as NumberConfigField, R as RenderBodyContext, d as RepeaterConfigField, e as RepeaterRowField, S as SelectConfigField, f as SwitchConfigField, T as TextConfigField, g as TextareaConfigField } from '../types-D_jOR3Z2.cjs';
+import { b as FlowNode, P as PortDescriptor, N as NodeExecutor } from '../types-sOmpCitB.cjs';
+import { b as LlmRoute } from '../capabilities-BEbLqnJU.cjs';
+export { C as CapabilityId, a as LlmClient, c as LlmRouteChoice, L as LlmRouteRequest, W as WorkflowResolver, d as capabilityStatus, g as getLlmClient, e as getWorkflowResolver, r as registerLlmClient, f as registerWorkflowResolver } from '../capabilities-BEbLqnJU.cjs';
+export { L as LEGACY_PAUSE_PREFIXES, a as PAUSE_PREFIX, P as PauseAwaiting, b as PauseSignal, d as decodePause, e as encodePause, i as isPause, p as pauseForHuman } from '../pause-9iT4tCEV.cjs';
 import * as react from 'react';
 import { ComponentType, ReactNode } from 'react';
 import { NodeProps, NodeTypes } from '@xyflow/react';
@@ -98,7 +99,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 +231,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

@@ -1,8 +1,9 @@
-import { a as NodeKindDefinition, P as PortSpec } from '../types-CnnKPnpt.js';
-export { C as ConfigField, b as CredentialConfigField, D as DocumentConfigField, E as ExpressionConfigField, J as JsonConfigField, K as KeyValueConfigField, N as NodeCategory, c as NumberConfigField, R as RenderBodyContext, d as RepeaterConfigField, e as RepeaterRowField, S as SelectConfigField, f as SwitchConfigField, T as TextConfigField, g as TextareaConfigField } from '../types-CnnKPnpt.js';
-import { a as FlowNode, P as PortDescriptor, N as NodeExecutor } from '../types-fc0fFKkf.js';
-import { b as LlmRoute } from '../capabilities-B6r1Snfj.js';
-export { C as CapabilityId, a as LlmClient, c as LlmRouteChoice, L as LlmRouteRequest, W as WorkflowResolver, d as capabilityStatus, g as getLlmClient, e as getWorkflowResolver, r as registerLlmClient, f as registerWorkflowResolver } from '../capabilities-B6r1Snfj.js';
+import { a as NodeKindDefinition, P as PortSpec } from '../types-NerkPtHS.js';
+export { C as ConfigField, b as CredentialConfigField, D as DocumentConfigField, E as ExpressionConfigField, J as JsonConfigField, K as KeyValueConfigField, N as NodeCategory, c as NumberConfigField, R as RenderBodyContext, d as RepeaterConfigField, e as RepeaterRowField, S as SelectConfigField, f as SwitchConfigField, T as TextConfigField, g as TextareaConfigField } from '../types-NerkPtHS.js';
+import { b as FlowNode, P as PortDescriptor, N as NodeExecutor } from '../types-sOmpCitB.js';
+import { b as LlmRoute } from '../capabilities-CI3gw0C7.js';
+export { C as CapabilityId, a as LlmClient, c as LlmRouteChoice, L as LlmRouteRequest, W as WorkflowResolver, d as capabilityStatus, g as getLlmClient, e as getWorkflowResolver, r as registerLlmClient, f as registerWorkflowResolver } from '../capabilities-CI3gw0C7.js';
+export { L as LEGACY_PAUSE_PREFIXES, a as PAUSE_PREFIX, P as PauseAwaiting, b as PauseSignal, d as decodePause, e as encodePause, i as isPause, p as pauseForHuman } from '../pause-9iT4tCEV.js';
 import * as react from 'react';
 import { ComponentType, ReactNode } from 'react';
 import { NodeProps, NodeTypes } from '@xyflow/react';
@@ -98,7 +99,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 +231,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

@@ -66,6 +66,42 @@ function capabilityStatus() {
   };
 }
 
+// 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 }));
+}
+
 // src/registry/registry.ts
 var kinds = /* @__PURE__ */ new Map();
 var aliases = /* @__PURE__ */ new Map();
@@ -431,7 +467,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 +477,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 +507,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;
@@ -9636,6 +9672,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.",
@@ -9677,6 +9714,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.",
@@ -9734,10 +9772,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 +9802,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 +9942,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 +10020,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 +10070,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 +10107,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 +10204,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 +10228,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 }}" }
     ]
   },
@@ -10085,6 +10243,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.",
@@ -10169,24 +10328,31 @@ function buildNodeTypes() {
 
 exports.BUILTIN_KINDS = BUILTIN_KINDS;
 exports.DEFAULT_MAX_DEPTH = DEFAULT_MAX_DEPTH;
+exports.LEGACY_PAUSE_PREFIXES = LEGACY_PAUSE_PREFIXES;
+exports.PAUSE_PREFIX = PAUSE_PREFIX;
 exports.RegistryNode = RegistryNode;
 exports.RichInputPreview = RichInputPreview;
 exports.buildNodeTypes = buildNodeTypes;
 exports.capabilityStatus = capabilityStatus;
 exports.categoryAccent = categoryAccent;
 exports.declaredRoutes = declaredRoutes;
+exports.decodePause = decodePause;
 exports.defaultConfigFor = defaultConfigFor;
+exports.encodePause = encodePause;
 exports.getLlmClient = getLlmClient;
 exports.getNodeKind = getNodeKind;
 exports.getRichInputAdapter = getRichInputAdapter;
 exports.getWorkflowResolver = getWorkflowResolver;
+exports.isPause = isPause;
 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;
+exports.pauseForHuman = pauseForHuman;
 exports.registerBuiltinKinds = registerBuiltinKinds;
 exports.registerLlmClient = registerLlmClient;
 exports.registerNodeKind = registerNodeKind;