@particle-academy/fancy-flow 0.50.0 → 0.51.1

package/dist/engine.d.cts

@@ -1,12 +1,12 @@
-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';
+export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-COdAOFg2.cjs';
+import { F as FlowGraph, R as RunEvent, N as NodeExecutor } from './types-JFYjPJAG.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-JFYjPJAG.cjs';
+export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from './run-cohort-r-L8dMED.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-C6TMfiD_.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-3sPauVRT.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-VzgDApur.cjs';
+import { W as WorkflowResolver } from './capabilities-BYa5p5jw.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-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';
+export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-DJ7KYT6E.js';
+import { F as FlowGraph, R as RunEvent, N as NodeExecutor } from './types-JFYjPJAG.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-JFYjPJAG.js';
+export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from './run-cohort-BPIOpE8A.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-3RkSYrMi.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-s643U1Hi.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-B00VXLUp.js';
+import { W as WorkflowResolver } from './capabilities-COOXRiNL.js';
 import '@xyflow/react';
 import 'react';
 

package/dist/engine.js

@@ -1,8 +1,8 @@
-export { runCohort } from './chunk-DQJIU55F.js';
+export { runCohort } from './chunk-VUU3CDBT.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-XJMWMU4J.js';
-export { RunIdentity, defaultConfigFor, escapeSegment, getNodeKind, kindIds, listNodeKinds, registerNodeKind, resolveKindId, runFlow, validateConfig } from './chunk-XJMWMU4J.js';
+import { runFlow, getNodeKind, resolveNodePorts } from './chunk-4GO2CHAY.js';
+export { RunIdentity, defaultConfigFor, escapeSegment, getNodeKind, kindIds, listNodeKinds, registerNodeKind, resolveKindId, runFlow, validateConfig } from './chunk-4GO2CHAY.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-CrXFq6Eb.cjs';
+import { C as ConfigFieldRenderFn } from '../ConfigFieldRenderer-Bc9Txnql.cjs';
 import 'react';
-import '../types-7cXcSQlx.cjs';
+import '../types-JFYjPJAG.cjs';
 import '@xyflow/react';
-import '../types-BtMOnb9I.cjs';
+import '../types-3sPauVRT.cjs';
 import '../pause-9iT4tCEV.cjs';
 
 /**

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

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

package/dist/index.cjs

@@ -11098,6 +11098,61 @@ var RunIdentity = class _RunIdentity {
   }
 };
 
+// src/runtime/workflow-props.ts
+function typeOf(value) {
+  if (value === null) return "null";
+  if (Array.isArray(value)) return "array";
+  return typeof value;
+}
+function resolveWorkflowProps(declared, passed) {
+  const inputs = declared ?? [];
+  const given = passed ?? {};
+  const byName = new Map(inputs.map((input) => [input.name, input]));
+  for (const name of Object.keys(given)) {
+    if (!byName.has(name)) {
+      const known = inputs.map((input) => input.name);
+      const suffix = known.length === 0 ? "this workflow declares no inputs" : `known inputs: ${known.join(", ")}`;
+      return {
+        ok: false,
+        code: "unknown_input",
+        error: `Unknown workflow input "${name}" \u2014 ${suffix}.`
+      };
+    }
+  }
+  const resolved = {};
+  for (const input of inputs) {
+    const supplied = Object.prototype.hasOwnProperty.call(given, input.name);
+    const hasDefault = Object.prototype.hasOwnProperty.call(input, "default");
+    if (!supplied) {
+      if (hasDefault) {
+        resolved[input.name] = input.default;
+        continue;
+      }
+      if (input.required) {
+        return {
+          ok: false,
+          code: "missing_required",
+          error: `Missing required workflow input "${input.name}"${input.type ? ` (${input.type})` : ""}.`
+        };
+      }
+      continue;
+    }
+    const value = given[input.name];
+    if (input.type !== void 0) {
+      const actual = typeOf(value);
+      if (actual !== input.type) {
+        return {
+          ok: false,
+          code: "type_mismatch",
+          error: `Workflow input "${input.name}" expects ${input.type}, got ${actual}.`
+        };
+      }
+    }
+    resolved[input.name] = value;
+  }
+  return { ok: true, props: resolved };
+}
+
 // src/runtime/run-flow.ts
 async function runFlow(graph, executors, onEvent = () => {
 }, options = {}) {
@@ -11113,6 +11168,13 @@ async function runFlow(graph, executors, onEvent = () => {
     onEvent({ type: "run-error", error: msg });
     return { ok: false, outputs, error: msg };
   }
+  const propsCheck = resolveWorkflowProps(graph.inputs, options.props);
+  if (!propsCheck.ok) {
+    onEvent({ type: "run-error", error: propsCheck.error });
+    return { ok: false, outputs, error: propsCheck.error };
+  }
+  const props = propsCheck.props;
+  const declaresProps = (graph.inputs?.length ?? 0) > 0;
   const incomingByNode = indexIncoming(graph.edges);
   const timer2 = timeoutMs ? setTimeout(() => errors.push(`Run timed out after ${timeoutMs}ms`), timeoutMs) : null;
   onEvent({ type: "run-start" });
@@ -11154,10 +11216,11 @@ 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);
+      const inputs = collectInputs(node, incoming, portValues, initialInputs, props, declaresProps);
       const exec = pickExecutor(executors, node);
       if (!exec) {
-        const msg = `No executor registered for kind=${node.type}`;
+        const tried = executorLookupIds(node);
+        const msg = `No executor registered for kind=${node.type} \u2014 tried ${tried.map((id2) => `"${id2}"`).join(", ")} and the wildcard "*". Key your registry by one of those.`;
         errors.push(msg);
         onEvent({ type: "node-status", nodeId: node.id, status: "error", text: msg });
         onEvent({ type: "log", nodeId: node.id, level: "error", message: msg });
@@ -11231,8 +11294,13 @@ function topoSort(graph) {
   const byId = new Map(graph.nodes.map((n) => [n.id, n]));
   return ordered.map((id2) => byId.get(id2)).filter(Boolean);
 }
-function collectInputs(node, incoming, portValues, initial) {
+function collectInputs(node, incoming, portValues, initial, props, declaresProps) {
   const inputs = { ...initial[node.id] ?? {} };
+  if (incoming.length === 0) {
+    for (const [name, value] of Object.entries(props)) {
+      if (!(name in inputs)) inputs[name] = value;
+    }
+  }
   for (const e of incoming) {
     const portId = e.targetHandle ?? "in";
     const key = `${e.source}:${e.sourceHandle ?? "out"}`;
@@ -11242,16 +11310,31 @@ function collectInputs(node, incoming, portValues, initial) {
       inputs[e.source] = portValues.get(key);
     }
   }
+  if (declaresProps) inputs.$props = props;
   return inputs;
 }
+function executorLookupIds(node) {
+  const ids = [node.id];
+  if (node.type) ids.push(node.type);
+  const declared = node.data?.kind;
+  const kindName = typeof declared === "string" && declared !== "" ? declared : node.type;
+  if (kindName && kindName !== node.type) ids.push(kindName);
+  for (const name of [kindName, node.type]) {
+    const kind = name ? getNodeKind(name) : null;
+    if (!kind) continue;
+    for (const id2 of kindIds(kind)) ids.push(id2);
+  }
+  return [...new Set(ids)];
+}
 function pickExecutor(executors, node) {
   if (executors[node.id]) return executors[node.id];
   if (node.type && executors[node.type]) return executors[node.type];
   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 name of [kindName, node.type]) {
+    const kind = name ? getNodeKind(name) : null;
+    if (!kind) continue;
     for (const id2 of kindIds(kind)) {
       if (executors[id2]) return executors[id2];
     }
@@ -14116,6 +14199,9 @@ function exportWorkflow(graph, metadata, view) {
     $schema: WORKFLOW_SCHEMA_URL,
     version: WORKFLOW_SCHEMA_VERSION,
     metadata: metadata ? { ...metadata, updatedAt: Date.now() } : void 0,
+    // Round-trips, or a saved workflow silently forgets its own contract and
+    // every caller's props become "unknown input" on the next load.
+    ...graph.inputs && graph.inputs.length > 0 ? { inputs: graph.inputs } : {},
     graph: {
       nodes: graph.nodes.map(toSchemaNode),
       edges: graph.edges.map(toSchemaEdge)
@@ -14238,7 +14324,18 @@ function importWorkflow(schema, options = {}) {
     };
   }).filter((e) => e !== null);
   const ok = issues.every((i) => i.level !== "error");
-  return { ok, graph: { nodes, edges }, issues };
+  const declaredInputs = Array.isArray(s.inputs) ? s.inputs.filter(
+    (input) => input !== null && typeof input === "object" && typeof input.name === "string"
+  ) : void 0;
+  return {
+    ok,
+    graph: {
+      nodes,
+      edges,
+      ...declaredInputs && declaredInputs.length > 0 ? { inputs: declaredInputs } : {}
+    },
+    issues
+  };
 }
 function workflowToBlob(schema) {
   return new Blob([JSON.stringify(schema, null, 2)], { type: "application/json" });