@particle-academy/fancy-flow 0.43.2 → 0.45.0

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

@@ -1,8 +1,8 @@
-import { C as ConfigFieldRenderFn } from '../ConfigFieldRenderer-BHQDZer6.js';
+import { C as ConfigFieldRenderFn } from '../ConfigFieldRenderer-WqJr-td_.js';
 import 'react';
-import '../types-sOmpCitB.js';
+import '../types-CMSrWVYM.js';
 import '@xyflow/react';
-import '../types-JViq8reb.js';
+import '../types-D6ZSKBly.js';
 
 /**
  * Render a `json` config field as a react-fancy `JsonEditor`.

package/dist/index.cjs

@@ -11886,12 +11886,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",
@@ -11932,6 +11942,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" }
     ]
   },