@particle-academy/fancy-flow 0.56.0 → 0.58.0

package/dist/durable.js

@@ -1,6 +1,6 @@
 import { truthy } from './chunk-BHM5HGXH.js';
 import { pauseForHuman, decodePause } from './chunk-UEOE6B52.js';
-import { getNodeKind, runFlow, resolveKindId, kindIds, RunIdentity } from './chunk-22OJOD4X.js';
+import { getNodeKind, runFlow, resolveKindId, kindIds, RunIdentity } from './chunk-HBE4LVPX.js';
 import './chunk-F5RPRB7A.js';
 import './chunk-USL4FMFU.js';
 

package/dist/engine.cjs

@@ -9304,6 +9304,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",
@@ -9332,6 +9334,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",
@@ -9519,6 +9527,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",
@@ -9582,6 +9592,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",
@@ -9628,6 +9640,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",
@@ -9647,6 +9665,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",
@@ -9665,6 +9688,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",
@@ -9764,6 +9790,8 @@ var KINDS = [
   },
   {
     name: "@particle-academy/variable",
+    // evaluates the expression in config.value
+    emits: "expression:value",
     aliases: ["variable", "@fancy/variable"],
     category: "data",
     label: "Variable",
@@ -9844,6 +9872,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"],
@@ -9982,6 +10015,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",
@@ -10003,6 +10041,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",
@@ -10019,6 +10059,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",
@@ -10044,6 +10090,8 @@ var KINDS = [
   // ───────────── Output ─────────────
   {
     name: "@particle-academy/output",
+    // returns its input unchanged
+    emits: "input",
     aliases: ["output", "@fancy/output"],
     category: "output",
     label: "Output",
@@ -10054,6 +10102,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",