@particle-academy/fancy-flow 0.43.2 → 0.44.0

package/dist/index.js

@@ -1,10 +1,10 @@
-import { removeNodes, removeEdges, cloneSubgraph, alignNodes, distributeNodes, reconnectEdge, assignToLane, removeFromLane, duplicateNode, setEdgeLabel, FlowCanvas } from './chunk-T3VQX3XB.js';
-export { ActionNode, DecisionNode, FlowCanvas, FlowViewer, NodeShell, OutputNode, SubgraphNode, TriggerNode, alignNodes, cloneSubgraph, defaultNodeTypes, distributeNodes, reconnectEdge } from './chunk-T3VQX3XB.js';
+import { removeNodes, removeEdges, cloneSubgraph, alignNodes, distributeNodes, reconnectEdge, assignToLane, removeFromLane, duplicateNode, setEdgeLabel, FlowCanvas } from './chunk-DHUFUDEX.js';
+export { ActionNode, DecisionNode, FlowCanvas, FlowViewer, NodeShell, OutputNode, SubgraphNode, TriggerNode, alignNodes, cloneSubgraph, defaultNodeTypes, distributeNodes, reconnectEdge } from './chunk-DHUFUDEX.js';
 import { useFlowState, useFlowRun, useFlowHistory, applyOutputsToNodes, applyStatusesToNodes } from './chunk-A6RFLGWV.js';
 export { applyOutputsToNodes, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState } from './chunk-A6RFLGWV.js';
 export { runCohort } from './chunk-QZTGV3ZL.js';
-import { buildNodeTypes, FlowEditorProvider, registerBuiltinKinds } from './chunk-55KQS3LK.js';
-export { ANY_PORT_TYPE, BUILTIN_KINDS, LaneNode, NoteNode, RegistryNode, buildNodeTypes, createConnectionValidator, defaultPortCompatibility, registerBuiltinKinds, useFlowEditor, useFlowEditorOptional } from './chunk-55KQS3LK.js';
+import { buildNodeTypes, FlowEditorProvider, registerBuiltinKinds } from './chunk-WBXGZVLB.js';
+export { ANY_PORT_TYPE, BUILTIN_KINDS, LaneNode, NoteNode, RegistryNode, buildNodeTypes, createConnectionValidator, defaultPortCompatibility, registerBuiltinKinds, useFlowEditor, useFlowEditorOptional } from './chunk-WBXGZVLB.js';
 import { ReactFlowProvider, useReactFlow, addEdge, applyEdgeChanges, applyNodeChanges, Position, Handle } from './chunk-OWENS2H5.js';
 export { LEGACY_PAUSE_PREFIXES, PAUSE_PREFIX, decodePause, encodePause, isPause, pauseForHuman } from './chunk-UEOE6B52.js';
 import './chunk-USL4FMFU.js';

package/dist/registry.cjs

@@ -10371,12 +10371,22 @@ var KINDS = [
   // ───────────── AI ─────────────
   {
     name: "@particle-academy/llm_call",
-    // LlmClient::complete() -> array{text:string,usage?:array,raw?:mixed}
-    outputShape: [
-      { path: "text", type: "string", description: "The model's completion." },
-      { path: "usage", type: "object", description: "Token counts, when the provider reports them." },
-      { path: "raw", type: "unknown", description: "The provider's untouched response." }
-    ],
+    // LlmClient::complete() -> array{text:string,data?:mixed,usage?:array,raw?:mixed}
+    //
+    // A FUNCTION of config, because `data` exists only when this node was asked
+    // for a schema. Declaring it statically would offer `{{ $json.data }}` on
+    // every llm_call in the kit, including the ones that emit nothing of the
+    // sort — and a suggestion that resolves to null at runtime is worse than no
+    // suggestion, since the picker is exactly what gave the author confidence.
+    outputShape: (config) => {
+      const asked = config?.response_schema != null && config.response_schema !== "" && !(Array.isArray(config.response_schema) && config.response_schema.length === 0);
+      return [
+        { path: "text", type: "string", description: "The model's completion." },
+        ...asked ? [{ path: "data", type: "unknown", description: "The parsed, schema-checked result." }] : [],
+        { path: "usage", type: "object", description: "Token counts, when the provider reports them." },
+        { path: "raw", type: "unknown", description: "The provider's untouched response." }
+      ];
+    },
     aliases: ["llm_call", "@fancy/llm_call"],
     category: "ai",
     label: "LLM Call",
@@ -10417,6 +10427,12 @@ var KINDS = [
           }
         ]
       },
+      {
+        type: "json",
+        key: "response_schema",
+        label: "Response schema",
+        description: "Optional JSON Schema. When set, the runtime asks the provider for schema-valid JSON and the node emits the parsed value as `data` \u2014 reference it as {{ $json.data }}. A response that cannot be parsed or does not match FAILS the node rather than passing an empty value downstream."
+      },
       { type: "credential", key: "credential", label: "API credential", credentialType: "llm_credential" }
     ]
   },