@particle-academy/fancy-flow 0.71.0 → 0.72.1

package/dist/engine.d.cts

@@ -1,7 +1,7 @@
-export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-B_8hgO5_.cjs';
+export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-pW0PllaZ.cjs';
 import { F as FlowGraph, R as RunEvent, N as NodeExecutor, W as WorkflowResolver, a as FlowNode } from './types-B-Syk9-M.cjs';
 export { A as ActionNodeData, B as BaseNodeData, D as DecisionNodeData, E as ExecutorRegistry, e as FlowEdge, f as FlowNodeData, g as FlowNodeKind, h as NodeRunStatus, i as NoteNodeData, O as OutputNodeData, P as PortDescriptor, c as RunIdentity, d as RunIdentityJson, S as SubgraphNodeData, j as TriggerNodeData, k as escapeSegment } from './types-B-Syk9-M.cjs';
-export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from './run-cohort-DL9JzzPU.cjs';
+export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from './run-cohort-DNpPa0mq.cjs';
 export { K as KindSchemaOverlay, a as KindSchemaOverlayResult, b as applyKindSchemaOverlay, c as clearKindSchemaOverlays, d as defaultConfigFor, g as getNodeKind, k as kindIds, l as listNodeKinds, r as registerNodeKind, e as resolveKindId, u as unregisterNodeKind, v as validateConfig } from './registry-B6SiTaLZ.cjs';
 export { b as CapabilityRequirement, C as ConfigField, E as EmitsRelation, M as ManifestProblem, c as ManifestValidation, d as NODE_MANIFEST_SCHEMA_VERSION, a as NodeCategory, N as NodeKindDefinition, e as NodePackageManifest, f as NodeRuntimeId, g as NodeRuntimeSpec, O as OutputField, h as OutputShape, P as PortSpec, S as SideEffects, i as checkCapabilities, j as checkRuntimeSupport, s as satisfiesRange, v as validateNodeManifest } from './types-BdkXxjFh.cjs';
 export { E as EvaluateOptions, a as ExprContext, b as ExprValue, R as Resolution, U as UnresolvedPathError, c as UnresolvedPolicy, e as evaluateConfig, d as evaluateExpression, r as resolvePath, t as text, f as truthy, g as tryResolvePath } from './expr-BfXDrs4H.cjs';

package/dist/engine.d.ts

@@ -1,7 +1,7 @@
-export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-CxEGBOxd.js';
+export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-BLP9rXfO.js';
 import { F as FlowGraph, R as RunEvent, N as NodeExecutor, W as WorkflowResolver, a as FlowNode } from './types-B-Syk9-M.js';
 export { A as ActionNodeData, B as BaseNodeData, D as DecisionNodeData, E as ExecutorRegistry, e as FlowEdge, f as FlowNodeData, g as FlowNodeKind, h as NodeRunStatus, i as NoteNodeData, O as OutputNodeData, P as PortDescriptor, c as RunIdentity, d as RunIdentityJson, S as SubgraphNodeData, j as TriggerNodeData, k as escapeSegment } from './types-B-Syk9-M.js';
-export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from './run-cohort-CjUBWg6X.js';
+export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from './run-cohort-rgT_FX3V.js';
 export { K as KindSchemaOverlay, a as KindSchemaOverlayResult, b as applyKindSchemaOverlay, c as clearKindSchemaOverlays, d as defaultConfigFor, g as getNodeKind, k as kindIds, l as listNodeKinds, r as registerNodeKind, e as resolveKindId, u as unregisterNodeKind, v as validateConfig } from './registry-JUcN_xWK.js';
 export { b as CapabilityRequirement, C as ConfigField, E as EmitsRelation, M as ManifestProblem, c as ManifestValidation, d as NODE_MANIFEST_SCHEMA_VERSION, a as NodeCategory, N as NodeKindDefinition, e as NodePackageManifest, f as NodeRuntimeId, g as NodeRuntimeSpec, O as OutputField, h as OutputShape, P as PortSpec, S as SideEffects, i as checkCapabilities, j as checkRuntimeSupport, s as satisfiesRange, v as validateNodeManifest } from './types-CbekKMMO.js';
 export { E as EvaluateOptions, a as ExprContext, b as ExprValue, R as Resolution, U as UnresolvedPathError, c as UnresolvedPolicy, e as evaluateConfig, d as evaluateExpression, r as resolvePath, t as text, f as truthy, g as tryResolvePath } from './expr-BfXDrs4H.js';

package/dist/engine.js

@@ -1,9 +1,9 @@
-export { runCohort } from './chunk-D2OBU3CE.js';
+export { runCohort } from './chunk-K7KO3UJ3.js';
 import { decodePause } from './chunk-UEOE6B52.js';
 export { LEGACY_PAUSE_PREFIXES, PAUSE_PREFIX, decodePause, encodePause, isPause, pauseForHuman } from './chunk-UEOE6B52.js';
-export { checkGraphConnectivity, mayFloat } from './chunk-KQCX6KN7.js';
-import { runFlow, getNodeKind, resolveNodePorts } from './chunk-EVGSL2EM.js';
-export { RunIdentity, UnresolvedPathError, applyKindSchemaOverlay, clearKindSchemaOverlays, defaultConfigFor, escapeSegment, evaluateConfig, evaluateExpression, getNodeKind, kindIds, listNodeKinds, registerNodeKind, resolveKindId, resolvePath, runFlow, text, truthy, tryResolvePath, unregisterNodeKind, validateConfig } from './chunk-EVGSL2EM.js';
+export { checkGraphConnectivity, mayFloat } from './chunk-VAF2SWTC.js';
+import { runFlow, getNodeKind, resolveNodePorts } from './chunk-EX34GCKK.js';
+export { RunIdentity, UnresolvedPathError, applyKindSchemaOverlay, clearKindSchemaOverlays, defaultConfigFor, escapeSegment, evaluateConfig, evaluateExpression, getNodeKind, kindIds, listNodeKinds, registerNodeKind, resolveKindId, resolvePath, runFlow, text, truthy, tryResolvePath, unregisterNodeKind, validateConfig } from './chunk-EX34GCKK.js';
 import { isResolutionFailure, registerLlmClient, registerWorkflowResolver } from './chunk-2QXKDLGT.js';
 
 // src/marketplace/manifest.ts

package/dist/index.cjs

@@ -1899,70 +1899,6 @@ function resolveNodePorts(node, kind) {
   };
 }
 
-// src/expressions/variables.ts
-var ROOT = "$json";
-function expr(path) {
-  return `{{ ${path} }}`;
-}
-function outputFieldsFor(node) {
-  const kindName = node.data?.kind ?? node.type;
-  if (!kindName) return [];
-  const kind = getNodeKind(kindName);
-  const shape = kind?.outputShape;
-  if (!shape) return [];
-  if (typeof shape === "function") {
-    try {
-      const config = node.data?.config ?? {};
-      return shape(config) ?? [];
-    } catch {
-      return [];
-    }
-  }
-  return shape;
-}
-function baseVariables() {
-  return [
-    { expression: expr(ROOT), path: ROOT, type: "unknown", description: "The whole incoming value." }
-  ];
-}
-function availableVariables(graph, nodeId) {
-  const out = baseVariables();
-  const seen = /* @__PURE__ */ new Set([ROOT]);
-  const byId = new Map(graph.nodes.map((n) => [n.id, n]));
-  const upstreamIds = graph.edges.filter((e) => e.target === nodeId).map((e) => e.source);
-  for (const id2 of upstreamIds) {
-    if (id2 === nodeId) continue;
-    const upstream = byId.get(id2);
-    if (!upstream) continue;
-    const kindName = upstream.data?.kind ?? upstream.type;
-    const label = upstream.data?.label ?? (kindName ? getNodeKind(kindName)?.label : void 0);
-    for (const field of outputFieldsFor(upstream)) {
-      const path = `${ROOT}.${field.path}`;
-      if (seen.has(path)) continue;
-      seen.add(path);
-      out.push({
-        expression: expr(path),
-        path,
-        type: field.type,
-        description: field.description,
-        source: label
-      });
-    }
-  }
-  return out;
-}
-function describeExpressionGrammar() {
-  return {
-    forms: [
-      { syntax: "{{ $json }}", meaning: "The whole value arriving on this node's input." },
-      { syntax: "{{ $json.field }}", meaning: "One key of that value. Dot-paths nest: $json.user.email." },
-      { syntax: "{{ $input.field }}", meaning: "An alias for $json \u2014 the same value, either spelling." },
-      { syntax: "{{ in }}", meaning: "The input by its context key, rather than through the alias." }
-    ],
-    note: "Dot-paths only \u2014 no arithmetic, comparisons or function calls; anything else resolves to nothing. A field that is exactly one expression keeps the resolved value's type; mixed text interpolates as a string. fancy-flow's own runFlow does not interpolate: it hands config to your executor verbatim, and the fancy-flow-php runtime is what resolves these."
-  };
-}
-
 // src/runtime/run-identity.ts
 function escapeSegment(value) {
   return value.replace(/%/g, "%25").replace(/\//g, "%2F").replace(/#/g, "%23");
@@ -2306,6 +2242,127 @@ function specForLane(lane) {
   };
 }
 
+// src/expressions/variables.ts
+var ROOT = "$json";
+function expr(path) {
+  return `{{ ${path} }}`;
+}
+function outputFieldsFor(node) {
+  const kindName = node.data?.kind ?? node.type;
+  if (!kindName) return [];
+  const kind = getNodeKind(kindName);
+  const shape = kind?.outputShape;
+  if (!shape) return [];
+  if (typeof shape === "function") {
+    try {
+      const config = node.data?.config ?? {};
+      return shape(config) ?? [];
+    } catch {
+      return [];
+    }
+  }
+  return shape;
+}
+function baseVariables() {
+  return [
+    { expression: expr(ROOT), path: ROOT, type: "unknown", description: "The whole incoming value." }
+  ];
+}
+function availableVariables(graph, nodeId) {
+  const out = baseVariables();
+  const seen = /* @__PURE__ */ new Set([ROOT]);
+  const byId = new Map(graph.nodes.map((n) => [n.id, n]));
+  const upstreamIds = graph.edges.filter((e) => e.target === nodeId).map((e) => e.source);
+  for (const id2 of upstreamIds) {
+    if (id2 === nodeId) continue;
+    const upstream = byId.get(id2);
+    if (!upstream) continue;
+    const kindName = upstream.data?.kind ?? upstream.type;
+    const label = upstream.data?.label ?? (kindName ? getNodeKind(kindName)?.label : void 0);
+    for (const field of outputFieldsFor(upstream)) {
+      const path = `${ROOT}.${field.path}`;
+      if (seen.has(path)) continue;
+      seen.add(path);
+      out.push({
+        expression: expr(path),
+        path,
+        type: field.type,
+        description: field.description,
+        source: label
+      });
+    }
+  }
+  return out;
+}
+function describeExpressionGrammar() {
+  return {
+    forms: [
+      { syntax: "{{ $json }}", meaning: "The whole value arriving on this node's input." },
+      { syntax: "{{ $json.field }}", meaning: "One key of that value. Dot-paths nest: $json.user.email." },
+      { syntax: "{{ $input.field }}", meaning: "An alias for $json \u2014 the same value, either spelling." },
+      { syntax: "{{ in }}", meaning: "The input by its context key, rather than through the alias." }
+    ],
+    note: "Dot-paths only \u2014 no arithmetic, comparisons or function calls; anything else resolves to nothing. A field that is exactly one expression keeps the resolved value's type; mixed text interpolates as a string. fancy-flow's own runFlow does not interpolate: it hands config to your executor verbatim, and the fancy-flow-php runtime is what resolves these."
+  };
+}
+
+// src/runtime/undelivered-edges.ts
+function undeliveredEdgeWarnings(target, incoming, portValues, completed, nodesById) {
+  const events = [];
+  for (const e of incoming) {
+    const handle = e.sourceHandle ?? "out";
+    if (portValues.has(`${e.source}:${handle}`) || !completed.has(e.source)) continue;
+    if (possiblePortIds(nodesById.get(e.source)).includes(handle)) continue;
+    events.push({
+      type: "log",
+      nodeId: target.id,
+      level: "warn",
+      message: undeliveredEdgeMessage(e, target, portValues, nodesById),
+      detail: { edge: e.id, source: e.source, sourceHandle: handle }
+    });
+  }
+  return events;
+}
+function possiblePortIds(node) {
+  if (!node) return ["out"];
+  const own = node.data?.outputs;
+  if (Array.isArray(own)) return own.map((p2) => p2.id);
+  const kind = getNodeKind(node.data?.kind ?? node.type ?? "");
+  if (!kind) return ["out"];
+  const config = nodeConfig(node);
+  const representative = typeof kind.outputs === "function" && !configDeclaresPorts(kind.name, config);
+  const ids = (resolvePortSpec(kind.outputs, representative ? defaultConfigFor(kind) : config) ?? []).map((p2) => p2.id);
+  return ids.length > 0 ? ids : ["out"];
+}
+function configDeclaresPorts(kindName, config) {
+  const bare = kindName.startsWith("@") ? kindName.slice(kindName.lastIndexOf("/") + 1) : kindName;
+  if (bare === "switch_case") {
+    const cases = config.cases;
+    return !!cases && typeof cases === "object" && Object.values(cases).some((port) => typeof port === "string" && port !== "");
+  }
+  if (bare === "llm_router") {
+    const routes = config.routes;
+    return Array.isArray(routes) && routes.some((route) => route?.port != null && route.port !== "");
+  }
+  return true;
+}
+function undeliveredEdgeMessage(edge, target, portValues, nodesById) {
+  const handle = edge.sourceHandle ?? "out";
+  const prefix = `${edge.source}:`;
+  const available = [];
+  for (const key of portValues.keys()) {
+    if (key.startsWith(prefix)) available.push(key.slice(prefix.length));
+  }
+  let message = `Edge ${edge.id} reads port "${handle}" from node ${edge.source}, which never publishes it \u2014 nothing would reach ${target.id} at run time.`;
+  if (available.length > 0) message += ` Available: ${available.join(", ")}.`;
+  const source = nodesById.get(edge.source);
+  if (source && outputFieldsFor(source).some((field) => field?.path === handle)) {
+    message += ` Note: "${handle}" is a FIELD this node emits, not a port \u2014 read it downstream as {{ in.${handle} }} rather than naming it as a source handle.`;
+  }
+  if (edge.sourceHandle != null) message += " Leave sourceHandle off to read the node's output.";
+  return message;
+}
+
 // src/runtime/workflow-props.ts
 function typeOf(value) {
   if (value === null) return "null";
@@ -2364,7 +2421,7 @@ function resolveWorkflowProps(declared, passed) {
 // src/runtime/run-flow.ts
 async function runFlow(graph, executors, onEvent = () => {
 }, options = {}) {
-  const { signal, initialInputs = {}, timeoutMs, depth = 0, resumeOutputs = {}, entryNodes } = options;
+  const { signal, initialInputs = {}, timeoutMs, depth = 0, resumeOutputs = {}, entryNodes, nodeExecutors } = options;
   const run = options.run === void 0 ? void 0 : RunIdentity.from(options.run);
   const outputs = {};
   const portValues = /* @__PURE__ */ new Map();
@@ -2427,17 +2484,8 @@ async function runFlow(graph, executors, onEvent = () => {
         onEvent({ type: "node-status", nodeId: node.id, status: "idle", text: "skipped" });
         continue;
       }
-      for (const e of incoming) {
-        const handle = e.sourceHandle ?? "out";
-        if (portValues.has(`${e.source}:${handle}`) || !completed.has(e.source)) continue;
-        if (possiblePortIds(nodesById.get(e.source)).includes(handle)) continue;
-        onEvent({
-          type: "log",
-          nodeId: node.id,
-          level: "warn",
-          message: undeliveredEdgeMessage(e, node, portValues, nodesById),
-          detail: { edge: e.id, source: e.source, sourceHandle: handle }
-        });
+      for (const warning of undeliveredEdgeWarnings(node, incoming, portValues, completed, nodesById)) {
+        onEvent(warning);
       }
       if (incoming.length > 0) {
         const anyActive = incoming.some((e) => portValues.has(`${e.source}:${e.sourceHandle ?? "out"}`));
@@ -2461,7 +2509,7 @@ async function runFlow(graph, executors, onEvent = () => {
       onEvent({ type: "node-status", nodeId: node.id, status: "running" });
       announce(onEvent, node, "start");
       const inputs = collectInputs(node, incoming, portValues, initialInputs, props, declaresProps);
-      const exec = pickExecutor(executors, node);
+      const exec = pickExecutor(executors, node, nodeExecutors);
       if (!exec) {
         const tried = executorLookupIds(node);
         const msg = `No executor registered for kind=${node.type} \u2014 tried ${tried.map((id2) => `"${id2}"`).join(", ")}. Key your registry by one of those.`;
@@ -2581,7 +2629,9 @@ function executorLookupIds(node) {
   ids.push("*");
   return [...new Set(ids)];
 }
-function pickExecutor(executors, node) {
+function pickExecutor(executors, node, nodeExecutors) {
+  const pinned = nodeExecutors && Object.prototype.hasOwnProperty.call(nodeExecutors, node.id) ? nodeExecutors[node.id] : void 0;
+  if (pinned) return pinned;
   for (const id2 of executorLookupIds(node)) {
     if (executors[id2]) return executors[id2];
   }
@@ -2601,45 +2651,6 @@ function activatedPorts(node, result) {
   const declared = resolveNodePorts(node, kind).outputs?.map((p2) => p2.id);
   return { ports: declared?.length ? declared : ["out"], value: result };
 }
-function possiblePortIds(node) {
-  if (!node) return ["out"];
-  const own = node.data?.outputs;
-  if (Array.isArray(own)) return own.map((p2) => p2.id);
-  const kind = getNodeKind(node.data?.kind ?? node.type ?? "");
-  if (!kind) return ["out"];
-  const config = nodeConfig(node);
-  const representative = typeof kind.outputs === "function" && !configDeclaresPorts(kind.name, config);
-  const ids = (resolvePortSpec(kind.outputs, representative ? defaultConfigFor(kind) : config) ?? []).map((p2) => p2.id);
-  return ids.length > 0 ? ids : ["out"];
-}
-function configDeclaresPorts(kindName, config) {
-  const bare = kindName.startsWith("@") ? kindName.slice(kindName.lastIndexOf("/") + 1) : kindName;
-  if (bare === "switch_case") {
-    const cases = config.cases;
-    return !!cases && typeof cases === "object" && Object.values(cases).some((port) => typeof port === "string" && port !== "");
-  }
-  if (bare === "llm_router") {
-    const routes = config.routes;
-    return Array.isArray(routes) && routes.some((route) => route?.port != null && route.port !== "");
-  }
-  return true;
-}
-function undeliveredEdgeMessage(edge, target, portValues, nodesById) {
-  const handle = edge.sourceHandle ?? "out";
-  const prefix = `${edge.source}:`;
-  const available = [];
-  for (const key of portValues.keys()) {
-    if (key.startsWith(prefix)) available.push(key.slice(prefix.length));
-  }
-  let message = `Edge ${edge.id} reads port "${handle}" from node ${edge.source}, which never publishes it \u2014 nothing would reach ${target.id} at run time.`;
-  if (available.length > 0) message += ` Available: ${available.join(", ")}.`;
-  const source = nodesById.get(edge.source);
-  if (source && outputFieldsFor(source).some((field) => field?.path === handle)) {
-    message += ` Note: "${handle}" is a FIELD this node emits, not a port \u2014 read it downstream as {{ in.${handle} }} rather than naming it as a source handle.`;
-  }
-  if (edge.sourceHandle != null) message += " Leave sourceHandle off to read the node's output.";
-  return message;
-}
 function announce(onEvent, node, phase) {
   const data = node.data;
   const raw = phase === "start" ? data?.startingMsg : data?.stoppingMsg;