@particle-academy/fancy-flow 0.48.0 → 0.49.0

package/dist/engine.d.cts

@@ -1,12 +1,12 @@
-export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-1KiXhy59.cjs';
-import { F as FlowGraph, R as RunEvent, N as NodeExecutor } from './types-Jx1TwehV.cjs';
-export { A as ActionNodeData, B as BaseNodeData, D as DecisionNodeData, E as ExecutorRegistry, d as FlowEdge, a as FlowNode, e as FlowNodeData, f as FlowNodeKind, g as NodeRunStatus, h as NoteNodeData, O as OutputNodeData, P as PortDescriptor, b as RunIdentity, c as RunIdentityJson, S as SubgraphNodeData, T as TriggerNodeData, 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';
-export { d as defaultConfigFor, g as getNodeKind, k as kindIds, l as listNodeKinds, r as registerNodeKind, a as resolveKindId, v as validateConfig } from './registry-BnnifM-t.cjs';
-export { b as CapabilityRequirement, C as ConfigField, 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-BO8TgI2M.cjs';
+export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-B24QUO1H.cjs';
+import { F as FlowGraph, R as RunEvent, N as NodeExecutor } from './types-7cXcSQlx.cjs';
+export { A as ActionNodeData, B as BaseNodeData, D as DecisionNodeData, E as ExecutorRegistry, d as FlowEdge, a as FlowNode, e as FlowNodeData, f as FlowNodeKind, g as NodeRunStatus, h as NoteNodeData, O as OutputNodeData, P as PortDescriptor, b as RunIdentity, c as RunIdentityJson, S as SubgraphNodeData, T as TriggerNodeData, 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';
+export { d as defaultConfigFor, g as getNodeKind, k as kindIds, l as listNodeKinds, r as registerNodeKind, a as resolveKindId, v as validateConfig } from './registry-DQh7ZmnM.cjs';
+export { b as CapabilityRequirement, C as ConfigField, 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-BtMOnb9I.cjs';
 import { P as PauseAwaiting } from './pause-9iT4tCEV.cjs';
 export { L as LEGACY_PAUSE_PREFIXES, a as PAUSE_PREFIX, b as PauseSignal, d as decodePause, e as encodePause, i as isPause, p as pauseForHuman } from './pause-9iT4tCEV.cjs';
-import { W as WorkflowResolver } from './capabilities-Dmd26aAs.cjs';
+import { W as WorkflowResolver } from './capabilities-VzgDApur.cjs';
 import '@xyflow/react';
 import 'react';
 

package/dist/engine.d.ts

@@ -1,12 +1,12 @@
-export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-CQvTDBYk.js';
-import { F as FlowGraph, R as RunEvent, N as NodeExecutor } from './types-Jx1TwehV.js';
-export { A as ActionNodeData, B as BaseNodeData, D as DecisionNodeData, E as ExecutorRegistry, d as FlowEdge, a as FlowNode, e as FlowNodeData, f as FlowNodeKind, g as NodeRunStatus, h as NoteNodeData, O as OutputNodeData, P as PortDescriptor, b as RunIdentity, c as RunIdentityJson, S as SubgraphNodeData, T as TriggerNodeData, 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';
-export { d as defaultConfigFor, g as getNodeKind, k as kindIds, l as listNodeKinds, r as registerNodeKind, a as resolveKindId, v as validateConfig } from './registry-DpARG95T.js';
-export { b as CapabilityRequirement, C as ConfigField, 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-DJAmfiJC.js';
+export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-DPUPAWk6.js';
+import { F as FlowGraph, R as RunEvent, N as NodeExecutor } from './types-7cXcSQlx.js';
+export { A as ActionNodeData, B as BaseNodeData, D as DecisionNodeData, E as ExecutorRegistry, d as FlowEdge, a as FlowNode, e as FlowNodeData, f as FlowNodeKind, g as NodeRunStatus, h as NoteNodeData, O as OutputNodeData, P as PortDescriptor, b as RunIdentity, c as RunIdentityJson, S as SubgraphNodeData, T as TriggerNodeData, 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';
+export { d as defaultConfigFor, g as getNodeKind, k as kindIds, l as listNodeKinds, r as registerNodeKind, a as resolveKindId, v as validateConfig } from './registry-6cB5wCv6.js';
+export { b as CapabilityRequirement, C as ConfigField, 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-CDgIIj4c.js';
 import { P as PauseAwaiting } from './pause-9iT4tCEV.js';
 export { L as LEGACY_PAUSE_PREFIXES, a as PAUSE_PREFIX, b as PauseSignal, d as decodePause, e as encodePause, i as isPause, p as pauseForHuman } from './pause-9iT4tCEV.js';
-import { W as WorkflowResolver } from './capabilities-DMUhnyZD.js';
+import { W as WorkflowResolver } from './capabilities-B00VXLUp.js';
 import '@xyflow/react';
 import 'react';
 

package/dist/engine.js

@@ -1,8 +1,8 @@
-export { runCohort } from './chunk-7DTUZUTB.js';
+export { runCohort } from './chunk-VUL7CUFW.js';
 import { decodePause } from './chunk-UEOE6B52.js';
 export { LEGACY_PAUSE_PREFIXES, PAUSE_PREFIX, decodePause, encodePause, isPause, pauseForHuman } from './chunk-UEOE6B52.js';
-import { runFlow, getNodeKind, resolveNodePorts } from './chunk-MJ3A3TAI.js';
-export { RunIdentity, defaultConfigFor, escapeSegment, getNodeKind, kindIds, listNodeKinds, registerNodeKind, resolveKindId, runFlow, validateConfig } from './chunk-MJ3A3TAI.js';
+import { runFlow, getNodeKind, resolveNodePorts } from './chunk-6FP3F5YR.js';
+export { RunIdentity, defaultConfigFor, escapeSegment, getNodeKind, kindIds, listNodeKinds, registerNodeKind, resolveKindId, runFlow, validateConfig } from './chunk-6FP3F5YR.js';
 import './chunk-F5RPRB7A.js';
 import { isResolutionFailure, registerLlmClient, registerWorkflowResolver } from './chunk-USL4FMFU.js';
 

package/dist/fields/react-fancy.d.cts

@@ -1,8 +1,8 @@
-import { C as ConfigFieldRenderFn } from '../ConfigFieldRenderer-NuDjtun1.cjs';
+import { C as ConfigFieldRenderFn } from '../ConfigFieldRenderer-CrXFq6Eb.cjs';
 import 'react';
-import '../types-Jx1TwehV.cjs';
+import '../types-7cXcSQlx.cjs';
 import '@xyflow/react';
-import '../types-BO8TgI2M.cjs';
+import '../types-BtMOnb9I.cjs';
 import '../pause-9iT4tCEV.cjs';
 
 /**

package/dist/fields/react-fancy.d.ts

@@ -1,8 +1,8 @@
-import { C as ConfigFieldRenderFn } from '../ConfigFieldRenderer-DrD2-Qml.js';
+import { C as ConfigFieldRenderFn } from '../ConfigFieldRenderer-u3nYHovX.js';
 import 'react';
-import '../types-Jx1TwehV.js';
+import '../types-7cXcSQlx.js';
 import '@xyflow/react';
-import '../types-DJAmfiJC.js';
+import '../types-CDgIIj4c.js';
 import '../pause-9iT4tCEV.js';
 
 /**

package/dist/index.cjs

@@ -11153,6 +11153,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) {
@@ -11171,6 +11172,7 @@ async function runFlow(graph, executors, onEvent = () => {
               throw new Error(reason ?? "aborted");
             },
             emit: onEvent,
+            executors,
             depth,
             run
           })
@@ -11183,6 +11185,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);
@@ -11241,7 +11244,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];
@@ -11263,6 +11269,14 @@ function activatedPorts(node, result) {
   const declared = resolveNodePorts(node, kind).outputs?.map((p2) => p2.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/registry/subflow.ts
 var DEFAULT_MAX_DEPTH = 8;
@@ -11316,7 +11330,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 ?? {
@@ -13701,6 +13718,7 @@ function NodeConfigPanel({
   }
   const setLabel = (label) => onChange({ ...node, data: { ...node.data, label } });
   const setDescription = (description) => onChange({ ...node, data: { ...node.data, description } });
+  const setStatusMsg = (key, value) => onChange({ ...node, data: { ...node.data, [key]: value } });
   const setConfigValue = (key, value) => onChange({ ...node, data: { ...node.data, config: { ...config, [key]: value } } });
   const issues = validateConfig(kind, config);
   const adapter2 = getRichInputAdapter();
@@ -13743,6 +13761,36 @@ function NodeConfigPanel({
         }
       )
     ] }),
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "ff-panel__field", children: [
+      /* @__PURE__ */ jsxRuntime.jsx("label", { className: "ff-panel__label", htmlFor: fieldId("startingMsg"), children: "Message when it starts" }),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "input",
+        {
+          id: fieldId("startingMsg"),
+          "data-ff-field": "startingMsg",
+          className: "ff-panel__input",
+          value: node.data.startingMsg ?? "",
+          onChange: (e) => setStatusMsg("startingMsg", e.target.value),
+          placeholder: "e.g. Starting the deep analysis"
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx("p", { className: "ff-panel__hint", children: "Announced just before this node runs. Leave blank to say nothing." })
+    ] }),
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "ff-panel__field", children: [
+      /* @__PURE__ */ jsxRuntime.jsx("label", { className: "ff-panel__label", htmlFor: fieldId("stoppingMsg"), children: "Message when it finishes" }),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        "input",
+        {
+          id: fieldId("stoppingMsg"),
+          "data-ff-field": "stoppingMsg",
+          className: "ff-panel__input",
+          value: node.data.stoppingMsg ?? "",
+          onChange: (e) => setStatusMsg("stoppingMsg", e.target.value),
+          placeholder: "e.g. Analysis complete"
+        }
+      ),
+      /* @__PURE__ */ jsxRuntime.jsx("p", { className: "ff-panel__hint", children: "Announced only if the node succeeds \u2014 never after a failure." })
+    ] }),
     kind.renderPanel ? kind.renderPanel({
       config,
       onChange: (next) => onChange({ ...node, data: { ...node.data, config: next } }),
@@ -13952,6 +14000,7 @@ function useFlowHistory(flow) {
 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);
@@ -13965,6 +14014,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 });
@@ -14024,7 +14077,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) => {
@@ -14078,6 +14131,8 @@ function toSchemaNode(n) {
     position: { x: n.position.x, y: n.position.y },
     label: data.label,
     description: data.description,
+    ...typeof data.startingMsg === "string" && data.startingMsg !== "" ? { startingMsg: data.startingMsg } : {},
+    ...typeof data.stoppingMsg === "string" && data.stoppingMsg !== "" ? { stoppingMsg: data.stoppingMsg } : {},
     config: data.config,
     inputs: ports.inputs,
     outputs: ports.outputs,
@@ -14150,6 +14205,8 @@ function importWorkflow(schema, options = {}) {
         kind: kindId,
         label: n.label ?? kind?.label ?? n.kind,
         description: n.description,
+        ...n.startingMsg ? { startingMsg: n.startingMsg } : {},
+        ...n.stoppingMsg ? { stoppingMsg: n.stoppingMsg } : {},
         config,
         // Carry serialized ports back onto the node so a round-trip is stable
         // and an unknown kind still routes the way the document described.