@particle-academy/fancy-flow 0.48.0 → 0.49.0

package/dist/runtime.js

@@ -1,6 +1,6 @@
-export { applyOutputsToNodes, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState } from './chunk-E6T3FZZP.js';
-export { runCohort } from './chunk-7DTUZUTB.js';
-export { RunIdentity, escapeSegment, runFlow } from './chunk-MJ3A3TAI.js';
+export { applyOutputsToNodes, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState } from './chunk-UL3DGSSG.js';
+export { runCohort } from './chunk-VUL7CUFW.js';
+export { RunIdentity, escapeSegment, runFlow } from './chunk-6FP3F5YR.js';
 import './chunk-F5RPRB7A.js';
 import './chunk-USL4FMFU.js';
 //# sourceMappingURL=runtime.js.map

package/dist/schema/index.d.cts

@@ -1,4 +1,4 @@
-import { P as PortDescriptor, F as FlowGraph } from '../types-Jx1TwehV.cjs';
+import { P as PortDescriptor, F as FlowGraph } from '../types-7cXcSQlx.cjs';
 import '@xyflow/react';
 
 /** Schema version. Bump on breaking shape changes; add migrations as needed. */
@@ -39,6 +39,14 @@ type WorkflowSchemaNode = {
     };
     label?: string;
     description?: string;
+    /**
+     * Announced to a person just before / just after this node runs. Omitted
+     * entirely when unset, so a graph of ordinary plumbing nodes does not carry
+     * a pair of empty keys per node and every diff of a saved graph stays
+     * readable.
+     */
+    startingMsg?: string;
+    stoppingMsg?: string;
     config?: Record<string, unknown>;
     /**
      * Resolved ports, written on export.

package/dist/schema/index.d.ts

@@ -1,4 +1,4 @@
-import { P as PortDescriptor, F as FlowGraph } from '../types-Jx1TwehV.js';
+import { P as PortDescriptor, F as FlowGraph } from '../types-7cXcSQlx.js';
 import '@xyflow/react';
 
 /** Schema version. Bump on breaking shape changes; add migrations as needed. */
@@ -39,6 +39,14 @@ type WorkflowSchemaNode = {
     };
     label?: string;
     description?: string;
+    /**
+     * Announced to a person just before / just after this node runs. Omitted
+     * entirely when unset, so a graph of ordinary plumbing nodes does not carry
+     * a pair of empty keys per node and every diff of a saved graph stays
+     * readable.
+     */
+    startingMsg?: string;
+    stoppingMsg?: string;
     config?: Record<string, unknown>;
     /**
      * Resolved ports, written on export.

package/dist/schema.cjs

@@ -9281,6 +9281,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) {
@@ -9299,6 +9300,7 @@ async function runFlow(graph, executors, onEvent = () => {
               throw new Error(reason ?? "aborted");
             },
             emit: onEvent,
+            executors,
             depth,
             run
           })
@@ -9311,6 +9313,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);
@@ -9369,7 +9372,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];
@@ -9391,6 +9397,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/registry/subflow.ts
 var DEFAULT_MAX_DEPTH = 8;
@@ -9444,7 +9458,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 ?? {
@@ -10504,6 +10521,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,
@@ -10576,6 +10595,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.