@particle-academy/fancy-flow 0.15.1 → 0.17.0

package/dist/index.cjs

@@ -217,6 +217,9 @@ var llmClient = null;
 function getLlmClient() {
   return llmClient;
 }
+function isResolutionFailure(value) {
+  return typeof value === "object" && value !== null && "reason" in value && value.reason !== void 0;
+}
 var workflowResolver = null;
 function getWorkflowResolver() {
   return workflowResolver;
@@ -465,7 +468,14 @@ var subflowExecutor = async (ctx) => {
       `subflow depth limit reached (${maxDepth}) at "${ref}" \u2014 a workflow is referencing itself, directly or through a chain.`
     );
   }
-  const child = await resolver(ref);
+  const pinned = config.version === void 0 || config.version === "" ? void 0 : Number(config.version);
+  if (pinned !== void 0 && !Number.isInteger(pinned)) {
+    ctx.abort(`subflow "${ref}" has a non-integer version pin (${String(config.version)}).`);
+  }
+  const resolved = await resolver(ref, pinned);
+  const child = isResolutionFailure(resolved) ? ctx.abort(
+    resolved.reason === "version-mismatch" ? resolved.message ?? `subflow "${ref}" is pinned to version ${pinned}, but the host has ${resolved.available ?? "a different version"}.` : resolved.message ?? `subflow could not resolve workflow "${ref}"`
+  ) : resolved;
   if (!child) ctx.abort(`subflow could not resolve workflow "${ref}"`);
   const mode = subflowMode(config);
   const streaming = mode === "stream" || mode === "both";
@@ -689,6 +699,12 @@ var KINDS = [
         placeholder: "onboarding-v2",
         description: "Reference resolved by the host's registerWorkflowResolver()."
       },
+      {
+        type: "number",
+        key: "version",
+        label: "Pin to version",
+        description: "Optional. Leave blank to always run the child's current version. Pinning fails the run loudly if the child has moved on \u2014 without it, someone edits the child and this flow silently runs different logic."
+      },
       {
         type: "select",
         key: "mode",
@@ -10779,6 +10795,8 @@ function JsonField({ value, onChange, rows }) {
 function NodeConfigPanel({
   node,
   onChange,
+  onDelete,
+  deleteLabel = "Delete node",
   header,
   renderCredentialField,
   renderDocumentField,
@@ -10800,7 +10818,21 @@ function NodeConfigPanel({
       /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "ff-panel__empty", children: [
         "Unknown kind: ",
         kindName
-      ] })
+      ] }),
+      onDelete && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "ff-panel__actions", children: /* @__PURE__ */ jsxRuntime.jsxs(
+        "button",
+        {
+          type: "button",
+          className: "ff-panel__delete",
+          "data-action": "delete-node",
+          onClick: () => onDelete(node),
+          title: "Delete this node (Del / Backspace)",
+          children: [
+            "\u2715 ",
+            deleteLabel
+          ]
+        }
+      ) })
     ] });
   }
   const setLabel = (label) => onChange({ ...node, data: { ...node.data, label } });
@@ -10866,7 +10898,21 @@ function NodeConfigPanel({
     issues.length > 0 && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "ff-panel__issues", children: issues.map((iss) => /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "ff-panel__issue", children: [
       "\u26A0 ",
       iss.message
-    ] }, iss.key)) })
+    ] }, iss.key)) }),
+    onDelete && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "ff-panel__actions", children: /* @__PURE__ */ jsxRuntime.jsxs(
+      "button",
+      {
+        type: "button",
+        className: "ff-panel__delete",
+        "data-action": "delete-node",
+        onClick: () => onDelete(node),
+        title: "Delete this node (Del / Backspace)",
+        children: [
+          "\u2715 ",
+          deleteLabel
+        ]
+      }
+    ) })
   ] });
 }
 function FlowRunControls({ running, onRun, onCancel, onReset, className, style: style2 }) {
@@ -11250,15 +11296,32 @@ function DefaultBody({ config, kind }) {
     ] })
   ] });
 }
+var truncate = (s, n = 30) => s.length > n ? s.slice(0, n - 1) + "\u2026" : s;
+function itemLabel(item) {
+  if (item && typeof item === "object") {
+    const o = item;
+    const name = o.label ?? o.name ?? o.key ?? o.title ?? o.id;
+    if (typeof name === "string" && name) return name;
+    if (typeof name === "number") return String(name);
+    return "item";
+  }
+  return String(item ?? "");
+}
 function previewValue(v) {
-  if (typeof v === "string") return v.length > 30 ? v.slice(0, 27) + "\u2026" : v;
+  if (v === null || v === void 0) return "";
+  if (typeof v === "string") return truncate(v);
   if (typeof v === "number" || typeof v === "boolean") return String(v);
-  try {
-    const j = JSON.stringify(v);
-    return j.length > 30 ? j.slice(0, 27) + "\u2026" : j;
-  } catch {
-    return "[object]";
+  if (Array.isArray(v)) {
+    if (v.length === 0) return "none";
+    const names = v.slice(0, 3).map(itemLabel).filter(Boolean).join(", ");
+    const rest = v.length > 3 ? `, +${v.length - 3}` : "";
+    return names ? truncate(names + rest) : `${v.length} item${v.length === 1 ? "" : "s"}`;
+  }
+  if (typeof v === "object") {
+    const keys = Object.keys(v);
+    return keys.length === 0 ? "empty" : `${keys.length} field${keys.length === 1 ? "" : "s"}`;
   }
+  return "\u2026";
 }
 
 // src/registry/index.ts
@@ -11501,18 +11564,7 @@ function FlowEditorInner({
   const toolbar = slots.toolbar ? slots.toolbar(api) : /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
     startActions.map((a) => renderAction(a, api)),
     builtins.run !== false && /* @__PURE__ */ jsxRuntime.jsx(FlowRunControls, { running: api.running, onRun: api.run, onCancel: api.cancel, onReset: api.reset }),
-    (builtins.delete !== false || builtins.export !== false || builtins.import !== false) && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ff-editor__sep" }),
-    builtins.delete !== false && /* @__PURE__ */ jsxRuntime.jsx(
-      "button",
-      {
-        className: "ff-editor__btn",
-        "data-action": "delete",
-        onClick: api.deleteSelected,
-        disabled: api.selected === null,
-        title: "Delete the selected node (Del / Backspace)",
-        children: "\u2715 Delete"
-      }
-    ),
+    (builtins.export !== false || builtins.import !== false) && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "ff-editor__sep" }),
     builtins.export !== false && /* @__PURE__ */ jsxRuntime.jsx("button", { className: "ff-editor__btn", "data-action": "export", onClick: api.exportWorkflow, children: "\u2193 Export" }),
     builtins.import !== false && /* @__PURE__ */ jsxRuntime.jsx("button", { className: "ff-editor__btn", "data-action": "import", onClick: api.importWorkflow, children: "\u2191 Import" }),
     endActions.map((a) => renderAction(a, api)),
@@ -11643,7 +11695,15 @@ function FlowEditorInner({
       showFeed && (slots.feed ? slots.feed(api) : /* @__PURE__ */ jsxRuntime.jsx(FlowRunFeed, { entries: runner.feed, className: "ff-editor__feed" }))
     ] }),
     showPanel && (slots.panel ? slots.panel(api) : /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "ff-editor__panel-wrap", children: [
-      /* @__PURE__ */ jsxRuntime.jsx(NodeConfigPanel, { className: "ff-editor__panel", node: api.selected, onChange: api.updateNode }),
+      /* @__PURE__ */ jsxRuntime.jsx(
+        NodeConfigPanel,
+        {
+          className: "ff-editor__panel",
+          node: api.selected,
+          onChange: api.updateNode,
+          onDelete: builtins.delete === false ? void 0 : (n) => api.deleteNodes([n.id])
+        }
+      ),
       slots.panelFooter && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "ff-editor__panel-footer", children: slots.panelFooter(api) })
     ] }))
   ] });