@particle-academy/fancy-flow 0.48.0 → 0.49.0

package/dist/registry.js

@@ -1,6 +1,6 @@
-export { ANY_PORT_TYPE, RegistryNode, buildNodeTypes, createConnectionValidator, defaultPortCompatibility } from './chunk-DRRZEAYB.js';
+export { ANY_PORT_TYPE, RegistryNode, buildNodeTypes, createConnectionValidator, defaultPortCompatibility } from './chunk-6XKR65XM.js';
 export { LEGACY_PAUSE_PREFIXES, PAUSE_PREFIX, decodePause, encodePause, isPause, pauseForHuman } from './chunk-UEOE6B52.js';
-export { BUILTIN_KINDS, DEFAULT_MAX_DEPTH, categoryAccent, clearNodeKindOverrides, declaredRoutes, defaultConfigFor, ensureBuiltinKinds, getNodeKind, kindIds, listNodeKinds, llmRouterExecutor as llmBranchExecutor, llmRouterExecutor, nodeConfig, onNodeKindsChanged, overrideNodeKind, registerBuiltinKinds, registerNodeKind, resolveFallbackPort, resolveKindId, resolveNodePorts, resolvePortSpec, subflowExecutor, subflowMode, subflowPorts, validateConfig } from './chunk-MJ3A3TAI.js';
+export { BUILTIN_KINDS, DEFAULT_MAX_DEPTH, categoryAccent, clearNodeKindOverrides, declaredRoutes, defaultConfigFor, ensureBuiltinKinds, getNodeKind, kindIds, listNodeKinds, llmRouterExecutor as llmBranchExecutor, llmRouterExecutor, nodeConfig, onNodeKindsChanged, overrideNodeKind, registerBuiltinKinds, registerNodeKind, resolveFallbackPort, resolveKindId, resolveNodePorts, resolvePortSpec, subflowExecutor, subflowMode, subflowPorts, validateConfig } from './chunk-6FP3F5YR.js';
 export { RichInputPreview, getRichInputAdapter, isRichInputEnabled, onRichInputAdapterChanged, registerRichInputAdapter } from './chunk-F5RPRB7A.js';
 export { capabilityStatus, getLlmClient, getWorkflowResolver, isResolutionFailure, registerLlmClient, registerWorkflowResolver } from './chunk-USL4FMFU.js';
 //# sourceMappingURL=registry.js.map

package/dist/{run-cohort-DdPPowJ3.d.cts → run-cohort-DYCL8Qv6.d.cts}

@@ -1,5 +1,5 @@
-import { F as FlowGraph, E as ExecutorRegistry, R as RunEvent } from './types-Jx1TwehV.cjs';
-import { R as RunOptions, a as RunResult } from './run-flow-1KiXhy59.cjs';
+import { F as FlowGraph, E as ExecutorRegistry, R as RunEvent } from './types-7cXcSQlx.cjs';
+import { R as RunOptions, a as RunResult } from './run-flow-B24QUO1H.cjs';
 
 /**
  * How the flows one trigger fired should treat each other.

package/dist/{run-cohort-Cyeny2Uu.d.ts → run-cohort-VX4JG21l.d.ts}

@@ -1,5 +1,5 @@
-import { F as FlowGraph, E as ExecutorRegistry, R as RunEvent } from './types-Jx1TwehV.js';
-import { R as RunOptions, a as RunResult } from './run-flow-CQvTDBYk.js';
+import { F as FlowGraph, E as ExecutorRegistry, R as RunEvent } from './types-7cXcSQlx.js';
+import { R as RunOptions, a as RunResult } from './run-flow-DPUPAWk6.js';
 
 /**
  * How the flows one trigger fired should treat each other.

package/dist/{run-flow-1KiXhy59.d.cts → run-flow-B24QUO1H.d.cts}

@@ -1,4 +1,4 @@
-import { b as RunIdentity, c as RunIdentityJson, F as FlowGraph, E as ExecutorRegistry, R as RunEvent } from './types-Jx1TwehV.cjs';
+import { b as RunIdentity, c as RunIdentityJson, F as FlowGraph, E as ExecutorRegistry, R as RunEvent } from './types-7cXcSQlx.cjs';
 
 type RunOptions = {
     /** Stop the run after this many ms. Default: no timeout. */

package/dist/{run-flow-CQvTDBYk.d.ts → run-flow-DPUPAWk6.d.ts}

@@ -1,4 +1,4 @@
-import { b as RunIdentity, c as RunIdentityJson, F as FlowGraph, E as ExecutorRegistry, R as RunEvent } from './types-Jx1TwehV.js';
+import { b as RunIdentity, c as RunIdentityJson, F as FlowGraph, E as ExecutorRegistry, R as RunEvent } from './types-7cXcSQlx.js';
 
 type RunOptions = {
     /** Stop the run after this many ms. Default: no timeout. */

package/dist/runtime/index.d.cts

@@ -1,14 +1,20 @@
-import { a as RunResult, R as RunOptions } from '../run-flow-1KiXhy59.cjs';
-export { r as runFlow } from '../run-flow-1KiXhy59.cjs';
-import { g as NodeRunStatus, F as FlowGraph, E as ExecutorRegistry, a as FlowNode, d as FlowEdge } from '../types-Jx1TwehV.cjs';
-export { b as RunIdentity, c as RunIdentityJson, i as escapeSegment } from '../types-Jx1TwehV.cjs';
-export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from '../run-cohort-DdPPowJ3.cjs';
+import { a as RunResult, R as RunOptions } from '../run-flow-B24QUO1H.cjs';
+export { r as runFlow } from '../run-flow-B24QUO1H.cjs';
+import { g as NodeRunStatus, F as FlowGraph, E as ExecutorRegistry, a as FlowNode, d as FlowEdge } from '../types-7cXcSQlx.cjs';
+export { b as RunIdentity, c as RunIdentityJson, i as escapeSegment } from '../types-7cXcSQlx.cjs';
+export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from '../run-cohort-DYCL8Qv6.cjs';
 import { NodeChange, EdgeChange, Connection } from '@xyflow/react';
 
 type FlowRunFeedEntry = {
     id: string;
     at: number;
-    level: "info" | "warn" | "error" | "status";
+    /**
+     * `message` is a node's own human-facing announcement (`startingMsg` /
+     * `stoppingMsg`), kept distinct from `status` and `info` so a progress UI can
+     * show ONLY the narration. Folded in with diagnostics it would be unfindable,
+     * which is the same as not having it.
+     */
+    level: "info" | "warn" | "error" | "status" | "message";
     text: string;
     nodeId?: string;
     detail?: unknown;
@@ -20,6 +26,12 @@ type UseFlowRunReturn = {
     statusText: Record<string, string | undefined>;
     /** Latest computed output value per node (for reactive kinds). */
     outputs: Record<string, unknown>;
+    /**
+     * Latest status message per nodeId, from the node's own `startingMsg` /
+     * `stoppingMsg`. Undefined for the nodes that declared none, which is most
+     * of them by design.
+     */
+    nodeMessages: Record<string, string | undefined>;
     /** Live event log (capped to last N). */
     feed: FlowRunFeedEntry[];
     /** Whether a run is currently in progress. */

package/dist/runtime/index.d.ts

@@ -1,14 +1,20 @@
-import { a as RunResult, R as RunOptions } from '../run-flow-CQvTDBYk.js';
-export { r as runFlow } from '../run-flow-CQvTDBYk.js';
-import { g as NodeRunStatus, F as FlowGraph, E as ExecutorRegistry, a as FlowNode, d as FlowEdge } from '../types-Jx1TwehV.js';
-export { b as RunIdentity, c as RunIdentityJson, i as escapeSegment } from '../types-Jx1TwehV.js';
-export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from '../run-cohort-Cyeny2Uu.js';
+import { a as RunResult, R as RunOptions } from '../run-flow-DPUPAWk6.js';
+export { r as runFlow } from '../run-flow-DPUPAWk6.js';
+import { g as NodeRunStatus, F as FlowGraph, E as ExecutorRegistry, a as FlowNode, d as FlowEdge } from '../types-7cXcSQlx.js';
+export { b as RunIdentity, c as RunIdentityJson, i as escapeSegment } from '../types-7cXcSQlx.js';
+export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from '../run-cohort-VX4JG21l.js';
 import { NodeChange, EdgeChange, Connection } from '@xyflow/react';
 
 type FlowRunFeedEntry = {
     id: string;
     at: number;
-    level: "info" | "warn" | "error" | "status";
+    /**
+     * `message` is a node's own human-facing announcement (`startingMsg` /
+     * `stoppingMsg`), kept distinct from `status` and `info` so a progress UI can
+     * show ONLY the narration. Folded in with diagnostics it would be unfindable,
+     * which is the same as not having it.
+     */
+    level: "info" | "warn" | "error" | "status" | "message";
     text: string;
     nodeId?: string;
     detail?: unknown;
@@ -20,6 +26,12 @@ type UseFlowRunReturn = {
     statusText: Record<string, string | undefined>;
     /** Latest computed output value per node (for reactive kinds). */
     outputs: Record<string, unknown>;
+    /**
+     * Latest status message per nodeId, from the node's own `startingMsg` /
+     * `stoppingMsg`. Undefined for the nodes that declared none, which is most
+     * of them by design.
+     */
+    nodeMessages: Record<string, string | undefined>;
     /** Live event log (capped to last N). */
     feed: FlowRunFeedEntry[];
     /** Whether a run is currently in progress. */

package/dist/runtime.cjs

@@ -9145,7 +9145,10 @@ var subflowExecutor = async (ctx) => {
   };
   const result = await runFlow(
     child,
-    config.executors ?? {},
+    // Inherit the parent's registry, then let the graph layer its own on top.
+    // The inherited half is the fix; the layered half keeps a graph that
+    // deliberately hands its child extra or different executors working.
+    { ...ctx.executors ?? {}, ...config.executors ?? {} },
     forward,
     {
       initialInputs: config.inputs ?? {
@@ -10276,6 +10279,7 @@ async function runFlow(graph, executors, onEvent = () => {
         continue;
       }
       onEvent({ type: "node-status", nodeId: node.id, status: "running" });
+      announce(onEvent, node, "start");
       const inputs = collectInputs(node, incoming, portValues, initialInputs);
       const exec = pickExecutor(executors, node);
       if (!exec) {
@@ -10294,6 +10298,7 @@ async function runFlow(graph, executors, onEvent = () => {
               throw new Error(reason ?? "aborted");
             },
             emit: onEvent,
+            executors,
             depth,
             run
           })
@@ -10306,6 +10311,7 @@ async function runFlow(graph, executors, onEvent = () => {
         }
         completed.add(node.id);
         onEvent({ type: "node-status", nodeId: node.id, status: "done" });
+        announce(onEvent, node, "end");
       } catch (e) {
         const msg = e instanceof Error ? e.message : String(e);
         errors.push(msg);
@@ -10364,7 +10370,10 @@ function collectInputs(node, incoming, portValues, initial) {
 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;
+  const declared = node.data?.kind;
+  const kindName = typeof declared === "string" && declared !== "" ? declared : node.type;
+  if (kindName && kindName !== node.type && executors[kindName]) return executors[kindName];
+  const kind = kindName ? getNodeKind(kindName) : null;
   if (kind) {
     for (const id2 of kindIds(kind)) {
       if (executors[id2]) return executors[id2];
@@ -10386,6 +10395,14 @@ function activatedPorts(node, result) {
   const declared = resolveNodePorts(node, kind).outputs?.map((p) => p.id);
   return { ports: declared?.length ? declared : ["out"], value: result };
 }
+function announce(onEvent, node, phase) {
+  const data = node.data;
+  const raw = phase === "start" ? data?.startingMsg : data?.stoppingMsg;
+  if (typeof raw !== "string") return;
+  const message = raw.trim();
+  if (message === "") return;
+  onEvent({ type: "node-message", nodeId: node.id, phase, message });
+}
 
 // src/runtime/run-cohort.ts
 async function runCohort(flows, executors, onEvent = () => {
@@ -10434,6 +10451,7 @@ function errorText(error) {
 function useFlowRun({ maxFeed = 200 } = {}) {
   const [statuses, setStatuses] = ReactExports.useState({});
   const [statusText, setStatusText] = ReactExports.useState({});
+  const [nodeMessages, setNodeMessages] = ReactExports.useState({});
   const [outputs, setOutputs] = ReactExports.useState({});
   const [feed, setFeed] = ReactExports.useState([]);
   const [running, setRunning] = ReactExports.useState(false);
@@ -10447,6 +10465,10 @@ function useFlowRun({ maxFeed = 200 } = {}) {
           setStatusText((t) => ({ ...t, [e.nodeId]: e.text }));
           appendFeed({ level: "status", text: `${e.nodeId} \u2192 ${e.status}${e.text ? ` (${e.text})` : ""}`, nodeId: e.nodeId });
           break;
+        case "node-message":
+          setNodeMessages((m) => ({ ...m, [e.nodeId]: e.message }));
+          appendFeed({ level: "message", text: e.message, nodeId: e.nodeId });
+          break;
         case "node-output":
           setOutputs((o) => ({ ...o, [e.nodeId]: e.value }));
           appendFeed({ level: "info", text: `${e.nodeId}.${e.portId} = ${preview(e.value)}`, nodeId: e.nodeId, detail: e.value });
@@ -10506,7 +10528,7 @@ function useFlowRun({ maxFeed = 200 } = {}) {
     setFeed([]);
     setLastResult(null);
   }, []);
-  return { statuses, statusText, outputs, feed, running, lastResult, run, cancel, reset };
+  return { statuses, statusText, nodeMessages, outputs, feed, running, lastResult, run, cancel, reset };
 }
 function applyOutputsToNodes(nodes, outputs) {
   return nodes.map((n) => {