@particle-academy/fancy-flow 0.15.1 → 0.16.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",