@particle-academy/fancy-flow 0.56.0 → 0.58.0

package/dist/engine.d.cts

@@ -2,8 +2,8 @@ export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-2XsHBw
 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-CBRAUj-z.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';
+export { d as defaultConfigFor, g as getNodeKind, k as kindIds, l as listNodeKinds, r as registerNodeKind, a as resolveKindId, v as validateConfig } from './registry-1qhmRtvC.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-BLVpNNLN.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-BYa5p5jw.cjs';

package/dist/engine.d.ts

@@ -2,8 +2,8 @@ export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-D7AOCc
 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-C1nRh_mi.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';
+export { d as defaultConfigFor, g as getNodeKind, k as kindIds, l as listNodeKinds, r as registerNodeKind, a as resolveKindId, v as validateConfig } from './registry-D2qocEsY.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-CLSUZW8c.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-COOXRiNL.js';

package/dist/engine.js

@@ -1,8 +1,8 @@
-export { runCohort } from './chunk-KP4TBF3A.js';
+export { runCohort } from './chunk-A3TLZS5B.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-22OJOD4X.js';
-export { RunIdentity, defaultConfigFor, escapeSegment, getNodeKind, kindIds, listNodeKinds, registerNodeKind, resolveKindId, runFlow, validateConfig } from './chunk-22OJOD4X.js';
+import { runFlow, getNodeKind, resolveNodePorts } from './chunk-HBE4LVPX.js';
+export { RunIdentity, defaultConfigFor, escapeSegment, getNodeKind, kindIds, listNodeKinds, registerNodeKind, resolveKindId, runFlow, validateConfig } from './chunk-HBE4LVPX.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 { H as HumanFieldRenderers, C as ConfigFieldRenderFn } from '../HumanPrompt-CPl-Spmp.cjs';
+import { H as HumanFieldRenderers, C as ConfigFieldRenderFn } from '../HumanPrompt-DV5-xnDa.cjs';
 import 'react';
 import '../types-JFYjPJAG.cjs';
 import '@xyflow/react';
-import '../types-3sPauVRT.cjs';
+import '../types-BLVpNNLN.cjs';
 import '../pause-9iT4tCEV.cjs';
 
 /**

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

@@ -1,8 +1,8 @@
-import { H as HumanFieldRenderers, C as ConfigFieldRenderFn } from '../HumanPrompt-DlJSFi3F.js';
+import { H as HumanFieldRenderers, C as ConfigFieldRenderFn } from '../HumanPrompt-Bw09OyS3.js';
 import 'react';
 import '../types-JFYjPJAG.js';
 import '@xyflow/react';
-import '../types-s643U1Hi.js';
+import '../types-CLSUZW8c.js';
 import '../pause-9iT4tCEV.js';
 
 /**

package/dist/index.cjs

@@ -11607,6 +11607,8 @@ var KINDS = [
   // ───────────── Triggers ─────────────
   {
     name: "@particle-academy/manual_trigger",
+    // returns the inputs it was started with
+    emits: "input",
     aliases: ["manual_trigger", "@fancy/manual_trigger"],
     category: "trigger",
     label: "Manual",
@@ -11635,6 +11637,12 @@ var KINDS = [
   },
   {
     name: "@particle-academy/schedule_trigger",
+    outputShape: [
+      { path: "cron", type: "string", description: "The cron expression that fired." },
+      { path: "timezone", type: "string", description: "The timezone it was evaluated in." }
+    ],
+    // merges its inputs into the TOP level beside cron/timezone
+    emits: "inputs-merged",
     aliases: ["schedule_trigger", "@fancy/schedule_trigger"],
     category: "trigger",
     label: "Schedule",
@@ -11822,6 +11830,8 @@ var KINDS = [
   // ───────────── Logic ─────────────
   {
     name: "@particle-academy/branch",
+    // returns its input on the chosen port
+    emits: "input",
     aliases: ["branch", "@fancy/branch"],
     category: "logic",
     label: "Branch",
@@ -11885,6 +11895,8 @@ var KINDS = [
   },
   {
     name: "@particle-academy/switch_case",
+    // returns its input on the chosen port
+    emits: "input",
     aliases: ["switch_case", "@fancy/switch_case"],
     category: "logic",
     label: "Switch",
@@ -11931,6 +11943,12 @@ var KINDS = [
   },
   {
     name: "@particle-academy/merge",
+    // `merge` mode unions every object input at the TOP level; `concat` builds
+    // a list instead, whose elements are not addressable as fields. So concat
+    // declares NOTHING rather than an empty list -- `[]` would claim "emits no
+    // fields" of a kind that emits a list, which is false and refuses every
+    // reference.
+    emits: (config) => (config?.mode ?? "merge") === "concat" ? null : "inputs-merged",
     aliases: ["merge", "@fancy/merge"],
     category: "logic",
     label: "Merge",
@@ -11950,6 +11968,11 @@ var KINDS = [
   },
   {
     name: "@particle-academy/wait",
+    outputShape: [
+      { path: "waited", type: "string", description: "Which wait mode ran." },
+      { path: "duration", type: "number", description: "How long it waited." },
+      { path: "input", type: "unknown", description: "The value that arrived, carried forward." }
+    ],
     aliases: ["wait", "@fancy/wait"],
     category: "logic",
     label: "Wait",
@@ -11968,6 +11991,9 @@ var KINDS = [
   },
   {
     name: "@particle-academy/transform",
+    // Two behaviours: the input unchanged when no expression is configured,
+    // else the shape that expression names. So the RELATION is config-dependent.
+    emits: (config) => (config?.expression ?? "") === "" ? "input" : "expression:expression",
     aliases: ["transform", "@fancy/transform"],
     category: "logic",
     label: "Transform",
@@ -12067,6 +12093,8 @@ var KINDS = [
   },
   {
     name: "@particle-academy/variable",
+    // evaluates the expression in config.value
+    emits: "expression:value",
     aliases: ["variable", "@fancy/variable"],
     category: "data",
     label: "Variable",
@@ -12147,6 +12175,11 @@ var KINDS = [
   },
   {
     name: "@particle-academy/llm_router",
+    outputShape: [
+      { path: "route", type: "string", description: "The port the model chose." },
+      { path: "reason", type: "string", description: "Why the model chose it." },
+      { path: "input", type: "unknown", description: "The value that arrived, carried forward." }
+    ],
     // Every id this node has ever shipped under keeps resolving — MOIC's saved
     // flows carry the bare `llm_branch`.
     aliases: ["llm_router", "llm_branch", "@fancy/llm_branch", "@fancy/llm_router"],
@@ -12285,6 +12318,11 @@ var KINDS = [
   },
   {
     name: "@particle-academy/webhook_out",
+    outputShape: [
+      { path: "sent", type: "boolean", description: "True once the request was made." },
+      { path: "status", type: "number", description: "HTTP status, when the transport reported one." },
+      { path: "response", type: "unknown", description: "The response body, when there was one." }
+    ],
     aliases: ["webhook_out", "@fancy/webhook_out"],
     category: "io",
     label: "Send Webhook",
@@ -12306,6 +12344,8 @@ var KINDS = [
   // ───────────── Human ─────────────
   {
     name: "@particle-academy/human_approval",
+    // returns its input on approved/denied
+    emits: "input",
     aliases: ["human_approval", "@fancy/human_approval"],
     pausesForHuman: "approval",
     category: "human",
@@ -12322,6 +12362,12 @@ var KINDS = [
   },
   {
     name: "@particle-academy/notify",
+    outputShape: [
+      { path: "sent", type: "boolean", description: "True once the message was handed to the channel." },
+      { path: "channel", type: "string", description: "The channel it went to." },
+      { path: "to", type: "string", description: "The recipient." },
+      { path: "message", type: "string", description: "The rendered message." }
+    ],
     aliases: ["notify", "@fancy/notify"],
     category: "human",
     label: "Notify",
@@ -12347,6 +12393,8 @@ var KINDS = [
   // ───────────── Output ─────────────
   {
     name: "@particle-academy/output",
+    // returns its input unchanged
+    emits: "input",
     aliases: ["output", "@fancy/output"],
     category: "output",
     label: "Output",
@@ -12357,6 +12405,10 @@ var KINDS = [
   },
   {
     name: "@particle-academy/log",
+    outputShape: [
+      { path: "logged", type: "string", description: "The message that was written." },
+      { path: "level", type: "string", description: "The level it was written at." }
+    ],
     aliases: ["log", "@fancy/log"],
     category: "output",
     label: "Log",