npm - @synergenius/flow-weaver - Versions diffs - 0.8.3 → 0.9.1 - Mend

@synergenius/flow-weaver 0.8.3 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (24) hide show

package/dist/annotation-generator.d.ts +6 -1
package/dist/annotation-generator.js +75 -24
package/dist/api/generate.d.ts +5 -0
package/dist/api/generate.js +8 -1
package/dist/api/validate.d.ts +5 -2
package/dist/api/validate.js +4 -4
package/dist/ast/types.d.ts +2 -0
package/dist/cli/commands/implement.d.ts +9 -0
package/dist/cli/commands/implement.js +96 -0
package/dist/cli/commands/status.d.ts +9 -0
package/dist/cli/commands/status.js +121 -0
package/dist/cli/flow-weaver.mjs +1067 -499
package/dist/cli/index.js +32 -0
package/dist/diagram/html-viewer.js +54 -18
package/dist/diagram/renderer.js +5 -4
package/dist/generator/unified.js +5 -1
package/dist/mcp/server.js +2 -0
package/dist/mcp/tools-model.d.ts +3 -0
package/dist/mcp/tools-model.js +253 -0
package/dist/utils/port-ordering.d.ts +5 -5
package/dist/utils/port-ordering.js +34 -41
package/dist/validator.d.ts +2 -0
package/dist/validator.js +41 -1
package/package.json +1 -1

package/dist/cli/flow-weaver.mjs CHANGED Viewed

@@ -935,8 +935,8 @@ var require_command = __commonJS({
   "node_modules/commander/lib/command.js"(exports2) {
     var EventEmitter2 = __require("events").EventEmitter;
     var childProcess = __require("child_process");
-    var path39 = __require("path");
-    var fs38 = __require("fs");
+    var path42 = __require("path");
+    var fs41 = __require("fs");
     var process6 = __require("process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -1759,10 +1759,10 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path39.resolve(baseDir, baseName);
-          if (fs38.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path39.extname(baseName))) return void 0;
-          const foundExt = sourceExt.find((ext2) => fs38.existsSync(`${localBin}${ext2}`));
+          const localBin = path42.resolve(baseDir, baseName);
+          if (fs41.existsSync(localBin)) return localBin;
+          if (sourceExt.includes(path42.extname(baseName))) return void 0;
+          const foundExt = sourceExt.find((ext2) => fs41.existsSync(`${localBin}${ext2}`));
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
         }
@@ -1773,23 +1773,23 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs38.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs41.realpathSync(this._scriptPath);
           } catch (err) {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path39.resolve(path39.dirname(resolvedScriptPath), executableDir);
+          executableDir = path42.resolve(path42.dirname(resolvedScriptPath), executableDir);
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path39.basename(this._scriptPath, path39.extname(this._scriptPath));
+            const legacyName = path42.basename(this._scriptPath, path42.extname(this._scriptPath));
             if (legacyName !== this._name) {
               localFile = findFile(executableDir, `${legacyName}-${subcommand._name}`);
             }
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path39.extname(executableFile));
+        launchWithNode = sourceExt.includes(path42.extname(executableFile));
         let proc2;
         if (process6.platform !== "win32") {
           if (launchWithNode) {
@@ -2572,7 +2572,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path39.basename(filename, path39.extname(filename));
+        this._name = path42.basename(filename, path42.extname(filename));
         return this;
       }
       /**
@@ -2586,9 +2586,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {string|null|Command}
        */
-      executableDir(path40) {
-        if (path40 === void 0) return this._executableDir;
-        this._executableDir = path40;
+      executableDir(path43) {
+        if (path43 === void 0) return this._executableDir;
+        this._executableDir = path43;
         return this;
       }
       /**
@@ -6458,10 +6458,10 @@ var init_esm3 = __esm({
        * Return a void Promise that resolves once the stream ends.
        */
       async promise() {
-        return new Promise((resolve28, reject2) => {
+        return new Promise((resolve31, reject2) => {
           this.on(DESTROYED, () => reject2(new Error("stream destroyed")));
           this.on("error", (er) => reject2(er));
-          this.on("end", () => resolve28());
+          this.on("end", () => resolve31());
         });
       }
       /**
@@ -6485,7 +6485,7 @@ var init_esm3 = __esm({
             return Promise.resolve({ done: false, value: res });
           if (this[EOF])
             return stop();
-          let resolve28;
+          let resolve31;
           let reject2;
           const onerr = (er) => {
             this.off("data", ondata);
@@ -6499,19 +6499,19 @@ var init_esm3 = __esm({
             this.off("end", onend);
             this.off(DESTROYED, ondestroy);
             this.pause();
-            resolve28({ value: value2, done: !!this[EOF] });
+            resolve31({ value: value2, done: !!this[EOF] });
           };
           const onend = () => {
             this.off("error", onerr);
             this.off("data", ondata);
             this.off(DESTROYED, ondestroy);
             stop();
-            resolve28({ done: true, value: void 0 });
+            resolve31({ done: true, value: void 0 });
           };
           const ondestroy = () => onerr(new Error("stream destroyed"));
           return new Promise((res2, rej) => {
             reject2 = rej;
-            resolve28 = res2;
+            resolve31 = res2;
             this.once(DESTROYED, ondestroy);
             this.once("error", onerr);
             this.once("end", onend);
@@ -6886,12 +6886,12 @@ var init_esm4 = __esm({
       /**
        * Get the Path object referenced by the string path, resolved from this Path
        */
-      resolve(path39) {
-        if (!path39) {
+      resolve(path42) {
+        if (!path42) {
           return this;
         }
-        const rootPath = this.getRootString(path39);
-        const dir = path39.substring(rootPath.length);
+        const rootPath = this.getRootString(path42);
+        const dir = path42.substring(rootPath.length);
         const dirParts = dir.split(this.splitSep);
         const result = rootPath ? this.getRoot(rootPath).#resolveParts(dirParts) : this.#resolveParts(dirParts);
         return result;
@@ -7495,9 +7495,9 @@ var init_esm4 = __esm({
         if (this.#asyncReaddirInFlight) {
           await this.#asyncReaddirInFlight;
         } else {
-          let resolve28 = () => {
+          let resolve31 = () => {
           };
-          this.#asyncReaddirInFlight = new Promise((res) => resolve28 = res);
+          this.#asyncReaddirInFlight = new Promise((res) => resolve31 = res);
           try {
             for (const e of await this.#fs.promises.readdir(fullpath, {
               withFileTypes: true
@@ -7510,7 +7510,7 @@ var init_esm4 = __esm({
             children.provisional = 0;
           }
           this.#asyncReaddirInFlight = void 0;
-          resolve28();
+          resolve31();
         }
         return children.slice(0, children.provisional);
       }
@@ -7643,8 +7643,8 @@ var init_esm4 = __esm({
       /**
        * @internal
        */
-      getRootString(path39) {
-        return win32.parse(path39).root;
+      getRootString(path42) {
+        return win32.parse(path42).root;
       }
       /**
        * @internal
@@ -7690,8 +7690,8 @@ var init_esm4 = __esm({
       /**
        * @internal
        */
-      getRootString(path39) {
-        return path39.startsWith("/") ? "/" : "";
+      getRootString(path42) {
+        return path42.startsWith("/") ? "/" : "";
       }
       /**
        * @internal
@@ -7740,8 +7740,8 @@ var init_esm4 = __esm({
        *
        * @internal
        */
-      constructor(cwd = process.cwd(), pathImpl, sep2, { nocase, childrenCacheSize = 16 * 1024, fs: fs38 = defaultFS } = {}) {
-        this.#fs = fsFromOption(fs38);
+      constructor(cwd = process.cwd(), pathImpl, sep2, { nocase, childrenCacheSize = 16 * 1024, fs: fs41 = defaultFS } = {}) {
+        this.#fs = fsFromOption(fs41);
         if (cwd instanceof URL || cwd.startsWith("file://")) {
           cwd = fileURLToPath(cwd);
         }
@@ -7780,11 +7780,11 @@ var init_esm4 = __esm({
       /**
        * Get the depth of a provided path, string, or the cwd
        */
-      depth(path39 = this.cwd) {
-        if (typeof path39 === "string") {
-          path39 = this.cwd.resolve(path39);
+      depth(path42 = this.cwd) {
+        if (typeof path42 === "string") {
+          path42 = this.cwd.resolve(path42);
         }
-        return path39.depth();
+        return path42.depth();
       }
       /**
        * Return the cache of child entries.  Exposed so subclasses can create
@@ -8271,9 +8271,9 @@ var init_esm4 = __esm({
         process6();
         return results;
       }
-      chdir(path39 = this.cwd) {
+      chdir(path42 = this.cwd) {
         const oldCwd = this.cwd;
-        this.cwd = typeof path39 === "string" ? this.cwd.resolve(path39) : path39;
+        this.cwd = typeof path42 === "string" ? this.cwd.resolve(path42) : path42;
         this.cwd[setAsCwd](oldCwd);
       }
     };
@@ -8299,8 +8299,8 @@ var init_esm4 = __esm({
       /**
        * @internal
        */
-      newRoot(fs38) {
-        return new PathWin32(this.rootPath, IFDIR, void 0, this.roots, this.nocase, this.childrenCache(), { fs: fs38 });
+      newRoot(fs41) {
+        return new PathWin32(this.rootPath, IFDIR, void 0, this.roots, this.nocase, this.childrenCache(), { fs: fs41 });
       }
       /**
        * Return true if the provided path string is an absolute path
@@ -8328,8 +8328,8 @@ var init_esm4 = __esm({
       /**
        * @internal
        */
-      newRoot(fs38) {
-        return new PathPosix(this.rootPath, IFDIR, void 0, this.roots, this.nocase, this.childrenCache(), { fs: fs38 });
+      newRoot(fs41) {
+        return new PathPosix(this.rootPath, IFDIR, void 0, this.roots, this.nocase, this.childrenCache(), { fs: fs41 });
       }
       /**
        * Return true if the provided path string is an absolute path
@@ -8648,8 +8648,8 @@ var init_processor = __esm({
       }
       // match, absolute, ifdir
       entries() {
-        return [...this.store.entries()].map(([path39, n]) => [
-          path39,
+        return [...this.store.entries()].map(([path42, n]) => [
+          path42,
           !!(n & 2),
           !!(n & 1)
         ]);
@@ -8862,9 +8862,9 @@ var init_walker = __esm({
       signal;
       maxDepth;
       includeChildMatches;
-      constructor(patterns, path39, opts) {
+      constructor(patterns, path42, opts) {
         this.patterns = patterns;
-        this.path = path39;
+        this.path = path42;
         this.opts = opts;
         this.#sep = !opts.posix && opts.platform === "win32" ? "\\" : "/";
         this.includeChildMatches = opts.includeChildMatches !== false;
@@ -8883,11 +8883,11 @@ var init_walker = __esm({
           });
         }
       }
-      #ignored(path39) {
-        return this.seen.has(path39) || !!this.#ignore?.ignored?.(path39);
+      #ignored(path42) {
+        return this.seen.has(path42) || !!this.#ignore?.ignored?.(path42);
       }
-      #childrenIgnored(path39) {
-        return !!this.#ignore?.childrenIgnored?.(path39);
+      #childrenIgnored(path42) {
+        return !!this.#ignore?.childrenIgnored?.(path42);
       }
       // backpressure mechanism
       pause() {
@@ -9102,8 +9102,8 @@ var init_walker = __esm({
     };
     GlobWalker = class extends GlobUtil {
       matches = /* @__PURE__ */ new Set();
-      constructor(patterns, path39, opts) {
-        super(patterns, path39, opts);
+      constructor(patterns, path42, opts) {
+        super(patterns, path42, opts);
       }
       matchEmit(e) {
         this.matches.add(e);
@@ -9140,8 +9140,8 @@ var init_walker = __esm({
     };
     GlobStream = class extends GlobUtil {
       results;
-      constructor(patterns, path39, opts) {
-        super(patterns, path39, opts);
+      constructor(patterns, path42, opts) {
+        super(patterns, path42, opts);
         this.results = new Minipass({
           signal: this.signal,
           objectMode: true
@@ -10352,17 +10352,17 @@ var require_binary_search = __commonJS({
 var require_read_wasm = __commonJS({
   "node_modules/source-map/lib/read-wasm.js"(exports2, module2) {
     "use strict";
-    var fs38 = __require("fs");
-    var path39 = __require("path");
+    var fs41 = __require("fs");
+    var path42 = __require("path");
     module2.exports = function readWasm() {
-      return new Promise((resolve28, reject2) => {
-        const wasmPath = path39.join(__dirname, "mappings.wasm");
-        fs38.readFile(wasmPath, null, (error2, data) => {
+      return new Promise((resolve31, reject2) => {
+        const wasmPath = path42.join(__dirname, "mappings.wasm");
+        fs41.readFile(wasmPath, null, (error2, data) => {
           if (error2) {
             reject2(error2);
             return;
           }
-          resolve28(data.buffer);
+          resolve31(data.buffer);
         });
       });
     };
@@ -11888,12 +11888,14 @@ var init_validator = __esm({
       MISSING_START_CONNECTION: `${DOCS_BASE}/concepts#start-and-exit`,
       MISSING_EXIT_CONNECTION: `${DOCS_BASE}/concepts#start-and-exit`,
       INFERRED_NODE_TYPE: `${DOCS_BASE}/node-conversion`,
-      DUPLICATE_CONNECTION: `${DOCS_BASE}/concepts#connections`
+      DUPLICATE_CONNECTION: `${DOCS_BASE}/concepts#connections`,
+      STUB_NODE: `${DOCS_BASE}/model-driven#stub-nodes`
     };
     WorkflowValidator = class {
       errors = [];
       warnings = [];
       strictMode = false;
+      draftMode = false;
       /** Look up instance sourceLocation by instance ID */
       getInstanceLocation(workflow, instanceId) {
         const instance = workflow.instances.find((inst) => inst.id === instanceId);
@@ -11938,6 +11940,7 @@ var init_validator = __esm({
         this.errors = [];
         this.warnings = [];
         this.strictMode = options?.strictMode ?? false;
+        this.draftMode = options?.mode === "draft";
         const nodeTypeMap = /* @__PURE__ */ new Map();
         workflow.nodeTypes.forEach((nodeType) => {
           nodeTypeMap.set(nodeType.functionName, nodeType);
@@ -11971,7 +11974,7 @@ var init_validator = __esm({
         });
         workflow.instances.forEach((instance) => {
           const nodeType = workflow.nodeTypes.find((nt) => nt.name === instance.nodeType || nt.functionName === instance.nodeType);
-          if (nodeType?.inferred) {
+          if (nodeType?.inferred && nodeType.variant !== "STUB") {
             this.warnings.push({
               type: "warning",
               code: "INFERRED_NODE_TYPE",
@@ -11981,6 +11984,18 @@ var init_validator = __esm({
             });
           }
         });
+        workflow.instances.forEach((instance) => {
+          const nodeType = workflow.nodeTypes.find((nt) => nt.name === instance.nodeType || nt.functionName === instance.nodeType);
+          if (nodeType?.variant === "STUB") {
+            this.errors.push({
+              type: "error",
+              code: "STUB_NODE",
+              message: `Node "${instance.id}" uses stub type "${instance.nodeType}" which has no implementation. Use draft mode to validate structure, or implement the node.`,
+              node: instance.id,
+              location: instance.sourceLocation
+            });
+          }
+        });
         this.validateStructure(workflow);
         this.validateDuplicateNodeNames(workflow);
         this.validateMutableBindings(workflow);
@@ -12017,6 +12032,30 @@ var init_validator = __esm({
             return true;
           });
         }
+        if (this.draftMode) {
+          const stubTypeNames = new Set(
+            workflow.nodeTypes.filter((nt) => nt.variant === "STUB").map((nt) => nt.functionName)
+          );
+          workflow.nodeTypes.filter((nt) => nt.variant === "STUB").forEach((nt) => {
+            stubTypeNames.add(nt.name);
+          });
+          const stubInstanceIds = new Set(
+            workflow.instances.filter((inst) => stubTypeNames.has(inst.nodeType)).map((inst) => inst.id)
+          );
+          const promoted = [];
+          this.errors = this.errors.filter((err) => {
+            if (err.code === "STUB_NODE") {
+              promoted.push({ ...err, type: "warning" });
+              return false;
+            }
+            if (err.code === "MISSING_REQUIRED_INPUT" && err.node && stubInstanceIds.has(err.node)) {
+              promoted.push({ ...err, type: "warning" });
+              return false;
+            }
+            return true;
+          });
+          this.warnings.push(...promoted);
+        }
         for (const diag of [...this.errors, ...this.warnings]) {
           if (!diag.docUrl && ERROR_DOC_URLS[diag.code]) {
             diag.docUrl = ERROR_DOC_URLS[diag.code];
@@ -12589,13 +12628,13 @@ Add '@param ${fromPort}' to the workflow JSDoc and include it in the params obje
           connections.filter((c) => c.from.node === c.to.node).map((c) => c.from.node)
         );
         const nonSelfLoopConnections = connections.filter((c) => c.from.node !== c.to.node);
-        const dfs = (nodeName, path39) => {
+        const dfs = (nodeName, path42) => {
           if (recursionStack.has(nodeName)) {
             if (selfLoopNodes.has(nodeName)) {
               return false;
             }
-            const cycleStart = path39.indexOf(nodeName);
-            const cyclePath = [...path39.slice(cycleStart), nodeName];
+            const cycleStart = path42.indexOf(nodeName);
+            const cyclePath = [...path42.slice(cycleStart), nodeName];
             const cycleNodes = cyclePath.slice(0, -1);
             const sortedCycle = [...cycleNodes].sort();
             const cycleKey = sortedCycle.join(",");
@@ -12617,7 +12656,7 @@ Add '@param ${fromPort}' to the workflow JSDoc and include it in the params obje
             return false;
           }
           recursionStack.add(nodeName);
-          const newPath = [...path39, nodeName];
+          const newPath = [...path42, nodeName];
           const instance = instances.find((n) => n.id === nodeName);
           if (!instance) {
             recursionStack.delete(nodeName);
@@ -13288,9 +13327,9 @@ var validate_exports = {};
 __export(validate_exports, {
   validateWorkflow: () => validateWorkflow
 });
-function validateWorkflow(ast, customRules) {
-  const result = validator.validate(ast);
-  const allRules = [...getAgentValidationRules(), ...customRules || []];
+function validateWorkflow(ast, options) {
+  const result = validator.validate(ast, { mode: options?.mode });
+  const allRules = [...getAgentValidationRules(), ...options?.customRules || []];
   for (const rule of allRules) {
     const ruleResults = rule.validate(ast);
     for (const err of ruleResults) {
@@ -13351,15 +13390,15 @@ async function loadAST(filePath) {
 async function saveASTAlongside(ast) {
   const sourceFile = ast.sourceFile;
   const dir = path6.dirname(sourceFile);
-  const basename17 = path6.basename(sourceFile, path6.extname(sourceFile));
-  const astFile = path6.join(dir, `${basename17}.ast.json`);
+  const basename18 = path6.basename(sourceFile, path6.extname(sourceFile));
+  const astFile = path6.join(dir, `${basename18}.ast.json`);
   await saveAST(ast, astFile);
   return astFile;
 }
 async function loadASTAlongside(sourceFile) {
   const dir = path6.dirname(sourceFile);
-  const basename17 = path6.basename(sourceFile, path6.extname(sourceFile));
-  const astFile = path6.join(dir, `${basename17}.ast.json`);
+  const basename18 = path6.basename(sourceFile, path6.extname(sourceFile));
+  const astFile = path6.join(dir, `${basename18}.ast.json`);
   return loadAST(astFile);
 }
 var init_serialization_node = __esm({
@@ -14827,15 +14866,15 @@ var require_route = __commonJS({
       };
     }
     function wrapConversion(toModel, graph) {
-      const path39 = [graph[toModel].parent, toModel];
+      const path42 = [graph[toModel].parent, toModel];
       let fn = conversions[graph[toModel].parent][toModel];
       let cur = graph[toModel].parent;
       while (graph[cur].parent) {
-        path39.unshift(graph[cur].parent);
+        path42.unshift(graph[cur].parent);
         fn = link(conversions[graph[cur].parent][cur], fn);
         cur = graph[cur].parent;
       }
-      fn.conversion = path39;
+      fn.conversion = path42;
       return fn;
     }
     module2.exports = function(fromModel) {
@@ -15316,7 +15355,7 @@ var require_lib4 = __commonJS({
 // node_modules/xmlhttprequest-ssl/lib/XMLHttpRequest.js
 var require_XMLHttpRequest = __commonJS({
   "node_modules/xmlhttprequest-ssl/lib/XMLHttpRequest.js"(exports2, module2) {
-    var fs38 = __require("fs");
+    var fs41 = __require("fs");
     var Url = __require("url");
     var spawn2 = __require("child_process").spawn;
     module2.exports = XMLHttpRequest3;
@@ -15474,7 +15513,7 @@ var require_XMLHttpRequest = __commonJS({
             throw new Error("XMLHttpRequest: Only GET method is supported");
           }
           if (settings.async) {
-            fs38.readFile(unescape(url2.pathname), function(error2, data2) {
+            fs41.readFile(unescape(url2.pathname), function(error2, data2) {
               if (error2) {
                 self2.handleError(error2, error2.errno || -1);
               } else {
@@ -15486,7 +15525,7 @@ var require_XMLHttpRequest = __commonJS({
             });
           } else {
             try {
-              this.response = fs38.readFileSync(unescape(url2.pathname));
+              this.response = fs41.readFileSync(unescape(url2.pathname));
               this.responseText = this.response.toString("utf8");
               this.status = 200;
               setState(self2.DONE);
@@ -15612,15 +15651,15 @@ var require_XMLHttpRequest = __commonJS({
         } else {
           var contentFile = ".node-xmlhttprequest-content-" + process.pid;
           var syncFile = ".node-xmlhttprequest-sync-" + process.pid;
-          fs38.writeFileSync(syncFile, "", "utf8");
+          fs41.writeFileSync(syncFile, "", "utf8");
           var execString = "var http = require('http'), https = require('https'), fs = require('fs');var doRequest = http" + (ssl ? "s" : "") + ".request;var options = " + JSON.stringify(options) + ";var responseText = '';var responseData = Buffer.alloc(0);var req = doRequest(options, function(response) {response.on('data', function(chunk) {  var data = Buffer.from(chunk);  responseText += data.toString('utf8');  responseData = Buffer.concat([responseData, data]);});response.on('end', function() {fs.writeFileSync('" + contentFile + "', JSON.stringify({err: null, data: {statusCode: response.statusCode, headers: response.headers, text: responseText, data: responseData.toString('base64')}}), 'utf8');fs.unlinkSync('" + syncFile + "');});response.on('error', function(error) {fs.writeFileSync('" + contentFile + "', 'NODE-XMLHTTPREQUEST-ERROR:' + JSON.stringify(error), 'utf8');fs.unlinkSync('" + syncFile + "');});}).on('error', function(error) {fs.writeFileSync('" + contentFile + "', 'NODE-XMLHTTPREQUEST-ERROR:' + JSON.stringify(error), 'utf8');fs.unlinkSync('" + syncFile + "');});" + (data ? "req.write('" + JSON.stringify(data).slice(1, -1).replace(/'/g, "\\'") + "');" : "") + "req.end();";
           var syncProc = spawn2(process.argv[0], ["-e", execString]);
           var statusText;
-          while (fs38.existsSync(syncFile)) {
+          while (fs41.existsSync(syncFile)) {
           }
-          self2.responseText = fs38.readFileSync(contentFile, "utf8");
+          self2.responseText = fs41.readFileSync(contentFile, "utf8");
           syncProc.stdin.end();
-          fs38.unlinkSync(contentFile);
+          fs41.unlinkSync(contentFile);
           if (self2.responseText.match(/^NODE-XMLHTTPREQUEST-ERROR:/)) {
             var errorObj = JSON.parse(self2.responseText.replace(/^NODE-XMLHTTPREQUEST-ERROR:/, ""));
             self2.handleError(errorObj, 503);
@@ -23000,7 +23039,7 @@ var require_compile = __commonJS({
       const schOrFunc = root2.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve28.call(this, root2, ref);
+      let _sch = resolve31.call(this, root2, ref);
       if (_sch === void 0) {
         const schema2 = (_a = root2.localRefs) === null || _a === void 0 ? void 0 : _a[ref];
         const { schemaId } = this.opts;
@@ -23027,7 +23066,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve28(root2, ref) {
+    function resolve31(root2, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -23242,8 +23281,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path39) {
-      let input = path39;
+    function removeDotSegments(path42) {
+      let input = path42;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -23442,8 +23481,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path39, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path39 && path39 !== "/" ? path39 : void 0;
+        const [path42, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path42 && path42 !== "/" ? path42 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -23602,7 +23641,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve28(baseURI, relativeURI, options) {
+    function resolve31(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const resolved = resolveComponent(parse7(baseURI, schemelessOptions), parse7(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
@@ -23829,7 +23868,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize: normalize2,
-      resolve: resolve28,
+      resolve: resolve31,
       resolveComponent,
       equal,
       serialize,
@@ -26805,12 +26844,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f;
     };
-    function addFormats(ajv, list, fs38, exportName) {
+    function addFormats(ajv, list, fs41, exportName) {
       var _a;
       var _b;
       (_a = (_b = ajv.opts.code).formats) !== null && _a !== void 0 ? _a : _b.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
       for (const f of list)
-        ajv.addFormat(f, fs38[f]);
+        ajv.addFormat(f, fs41[f]);
     }
     module2.exports = exports2 = formatsPlugin;
     Object.defineProperty(exports2, "__esModule", { value: true });
@@ -29220,7 +29259,11 @@ function generateNodeCallWithContext(instance, nodeType, workflow, _availableVar
   });
   const resultVar = `${safeId}Result`;
   const awaitKeyword = nodeType.isAsync ? "await " : "";
-  if (nodeType.variant === "COERCION") {
+  if (nodeType.variant === "STUB") {
+    lines.push(
+      `${indent}  throw new Error('Node "${instanceId}" uses stub type "${functionName}" which has no implementation.');`
+    );
+  } else if (nodeType.variant === "COERCION") {
     const coerceExprMap = {
       __fw_toString: "String",
       __fw_toNumber: "Number",
@@ -30034,8 +30077,16 @@ function generateCode(ast, options) {
     moduleFormat = "esm",
     externalRuntimePath,
     constants = [],
-    externalNodeTypes = {}
+    externalNodeTypes = {},
+    generateStubs = false
   } = options || {};
+  const stubNodeTypes = ast.nodeTypes.filter((nt) => nt.variant === "STUB");
+  if (stubNodeTypes.length > 0 && !generateStubs) {
+    const stubNames = stubNodeTypes.map((nt) => nt.functionName).join(", ");
+    throw new Error(
+      `Cannot generate code: workflow has ${stubNodeTypes.length} stub node(s) without implementation: ${stubNames}. Implement them or pass { generateStubs: true } to emit placeholder throws.`
+    );
+  }
   const { shouldBeAsync, warning } = validateWorkflowAsync(ast, ast.nodeTypes);
   if (warning && !production) {
     console.warn(warning);
@@ -30472,9 +30523,9 @@ function shouldUseStepTag(portName, port) {
 // src/sugar-optimizer.ts
 init_constants();
-function validatePathMacro(path39, connections, instances) {
+function validatePathMacro(path42, connections, instances) {
   const instanceIds = new Set(instances.map((inst) => inst.id));
-  for (const step of path39.steps) {
+  for (const step of path42.steps) {
     if (step.node === "Start" || step.node === "Exit") continue;
     if (!instanceIds.has(step.node)) return false;
   }
@@ -30484,9 +30535,9 @@ function validatePathMacro(path39, connections, instances) {
       connKeys.add(`${conn.from.node}.${conn.from.port}->${conn.to.node}.${conn.to.port}`);
     }
   }
-  for (let i = 0; i < path39.steps.length - 1; i++) {
-    const current2 = path39.steps[i];
-    const next = path39.steps[i + 1];
+  for (let i = 0; i < path42.steps.length - 1; i++) {
+    const current2 = path42.steps[i];
+    const next = path42.steps[i + 1];
     const route = current2.route || "ok";
     let expectedKey;
     if (current2.node === "Start") {
@@ -30590,12 +30641,12 @@ function detectSugarPatterns(connections, instances, existingMacros, nodeTypes,
   }
   const candidateRoutes = [];
   const MAX_ROUTES = 20;
-  function dfs(node, path39, visited) {
+  function dfs(node, path42, visited) {
     if (candidateRoutes.length >= MAX_ROUTES) return;
     if (node === "Exit") {
-      path39.push({ node: "Exit" });
-      candidateRoutes.push([...path39]);
-      path39.pop();
+      path42.push({ node: "Exit" });
+      candidateRoutes.push([...path42]);
+      path42.pop();
       return;
     }
     if (visited.has(node)) return;
@@ -30607,15 +30658,15 @@ function detectSugarPatterns(connections, instances, existingMacros, nodeTypes,
     }
     if (edges.ok && !coveredByExistingMacro.has(edges.ok === "Exit" ? "" : edges.ok)) {
       const step = node === "Start" ? { node: "Start" } : { node };
-      path39.push(step);
-      dfs(edges.ok, path39, visited);
-      path39.pop();
+      path42.push(step);
+      dfs(edges.ok, path42, visited);
+      path42.pop();
     }
     if (edges.fail && !coveredByExistingMacro.has(edges.fail === "Exit" ? "" : edges.fail)) {
       const step = { node, route: "fail" };
-      path39.push(step);
-      dfs(edges.fail, path39, visited);
-      path39.pop();
+      path42.push(step);
+      dfs(edges.fail, path42, visited);
+      path42.pop();
     }
     visited.delete(node);
   }
@@ -30770,6 +30821,9 @@ var AnnotationGenerator = class {
       if (nodeType.variant === "COERCION") {
         return;
       }
+      if (nodeType.variant === "STUB" && nodeType.inferred) {
+        return;
+      }
       lines.push(
         ...this.generateNodeTypeAnnotation(
           nodeType,
@@ -30799,7 +30853,12 @@ var AnnotationGenerator = class {
       }
       lines.push(` *`);
     }
-    lines.push(" * @flowWeaver nodeType");
+    const isStub = nodeType.variant === "STUB";
+    if (isStub || nodeType.expression) {
+      lines.push(" * @flowWeaver node");
+    } else {
+      lines.push(" * @flowWeaver nodeType");
+    }
     if (includeMetadata && nodeType.label) {
       lines.push(` * @label ${nodeType.label}`);
     }
@@ -30856,24 +30915,7 @@ var AnnotationGenerator = class {
     return `{ ${props.join(", ")} }`;
   }
   generateFunctionSignature(nodeType) {
-    const lines = [];
-    const params = ["execute: boolean"];
-    Object.entries(nodeType.inputs).forEach(([name, port]) => {
-      if (isExecutePort(name)) return;
-      const optional2 = port.optional ? "?" : "";
-      const defaultVal = port.default !== void 0 ? ` = ${JSON.stringify(port.default)}` : "";
-      params.push(`${name}${optional2}: ${this.mapDataTypeToTS(port.dataType)}${defaultVal}`);
-    });
-    const returns = ["onSuccess: boolean", "onFailure: boolean"];
-    Object.entries(nodeType.outputs).forEach(([name, port]) => {
-      if (isSuccessPort(name) || isFailurePort(name)) return;
-      returns.push(`${name}: ${this.mapDataTypeToTS(port.dataType)}`);
-    });
-    lines.push(`function ${nodeType.functionName}(${params.join(", ")}) {`);
-    lines.push(`  if (!execute) return { onSuccess: false, onFailure: false };`);
-    lines.push(`  return { onSuccess: true, onFailure: false };`);
-    lines.push(`}`);
-    return lines;
+    return generateFunctionSignature(nodeType);
   }
   generateWorkflowAnnotation(workflow, indent, includeComments, skipParamReturns = false) {
     const lines = [];
@@ -31030,6 +31072,10 @@ var AnnotationGenerator = class {
   }
   generateWorkflowFunctionSignature(workflow) {
     const lines = [];
+    if (workflow.stub) {
+      lines.push(`export const ${workflow.functionName} = 'flowWeaver:draft';`);
+      return lines;
+    }
     const startPorts = workflow.startPorts || {};
     const exitPorts = workflow.exitPorts || {};
     const params = [];
@@ -31213,6 +31259,51 @@ function generateNodeInstanceTag(instance) {
   }
   return ` * @node ${instance.id} ${instance.nodeType}${parent}${labelAttr}${portOrderAttr}${portLabelAttr}${exprAttr}${pullExecutionAttr}${minimizedAttr}${colorAttr}${iconAttr}${tagsAttr}${sizeAttr}${positionAttr}`;
 }
+function generateFunctionSignature(nodeType) {
+  const lines = [];
+  const isStub = nodeType.variant === "STUB";
+  const isExpression = isStub || nodeType.expression;
+  if (isExpression) {
+    const params = [];
+    Object.entries(nodeType.inputs).forEach(([name, port]) => {
+      if (isExecutePort(name)) return;
+      const optional2 = port.optional ? "?" : "";
+      params.push(`${name}${optional2}: ${mapToTypeScript(port.dataType)}`);
+    });
+    const returns = [];
+    Object.entries(nodeType.outputs).forEach(([name, port]) => {
+      if (isSuccessPort(name) || isFailurePort(name)) return;
+      returns.push(`${name}: ${mapToTypeScript(port.dataType)}`);
+    });
+    const returnType = returns.length === 1 ? mapToTypeScript(Object.entries(nodeType.outputs).find(([n]) => !isSuccessPort(n) && !isFailurePort(n))?.[1].dataType || "ANY") : `{ ${returns.join("; ")} }`;
+    if (isStub) {
+      lines.push(`declare function ${nodeType.functionName}(${params.join(", ")}): ${returnType};`);
+    } else {
+      lines.push(`function ${nodeType.functionName}(${params.join(", ")}): ${returnType} {`);
+      lines.push(`  // TODO: implement`);
+      lines.push(`  throw new Error('Not implemented');`);
+      lines.push(`}`);
+    }
+  } else {
+    const params = ["execute: boolean"];
+    Object.entries(nodeType.inputs).forEach(([name, port]) => {
+      if (isExecutePort(name)) return;
+      const optional2 = port.optional ? "?" : "";
+      const defaultVal = port.default !== void 0 ? ` = ${JSON.stringify(port.default)}` : "";
+      params.push(`${name}${optional2}: ${mapToTypeScript(port.dataType)}${defaultVal}`);
+    });
+    const returns = ["onSuccess: boolean", "onFailure: boolean"];
+    Object.entries(nodeType.outputs).forEach(([name, port]) => {
+      if (isSuccessPort(name) || isFailurePort(name)) return;
+      returns.push(`${name}: ${mapToTypeScript(port.dataType)}`);
+    });
+    lines.push(`function ${nodeType.functionName}(${params.join(", ")}) {`);
+    lines.push(`  if (!execute) return { onSuccess: false, onFailure: false };`);
+    lines.push(`  return { onSuccess: true, onFailure: false };`);
+    lines.push(`}`);
+  }
+  return lines;
+}
 var annotationGenerator = new AnnotationGenerator();
 // src/api/generate-in-place.ts
@@ -33444,19 +33535,19 @@ function toKey(value2) {
 var toKey_default = toKey;
 // node_modules/lodash-es/_baseGet.js
-function baseGet(object3, path39) {
-  path39 = castPath_default(path39, object3);
-  var index = 0, length = path39.length;
+function baseGet(object3, path42) {
+  path42 = castPath_default(path42, object3);
+  var index = 0, length = path42.length;
   while (object3 != null && index < length) {
-    object3 = object3[toKey_default(path39[index++])];
+    object3 = object3[toKey_default(path42[index++])];
   }
   return index && index == length ? object3 : void 0;
 }
 var baseGet_default = baseGet;
 // node_modules/lodash-es/get.js
-function get(object3, path39, defaultValue) {
-  var result = object3 == null ? void 0 : baseGet_default(object3, path39);
+function get(object3, path42, defaultValue) {
+  var result = object3 == null ? void 0 : baseGet_default(object3, path42);
   return result === void 0 ? defaultValue : result;
 }
 var get_default = get;
@@ -34368,11 +34459,11 @@ function baseHasIn(object3, key) {
 var baseHasIn_default = baseHasIn;
 // node_modules/lodash-es/_hasPath.js
-function hasPath(object3, path39, hasFunc) {
-  path39 = castPath_default(path39, object3);
-  var index = -1, length = path39.length, result = false;
+function hasPath(object3, path42, hasFunc) {
+  path42 = castPath_default(path42, object3);
+  var index = -1, length = path42.length, result = false;
   while (++index < length) {
-    var key = toKey_default(path39[index]);
+    var key = toKey_default(path42[index]);
     if (!(result = object3 != null && hasFunc(object3, key))) {
       break;
     }
@@ -34387,21 +34478,21 @@ function hasPath(object3, path39, hasFunc) {
 var hasPath_default = hasPath;
 // node_modules/lodash-es/hasIn.js
-function hasIn(object3, path39) {
-  return object3 != null && hasPath_default(object3, path39, baseHasIn_default);
+function hasIn(object3, path42) {
+  return object3 != null && hasPath_default(object3, path42, baseHasIn_default);
 }
 var hasIn_default = hasIn;
 // node_modules/lodash-es/_baseMatchesProperty.js
 var COMPARE_PARTIAL_FLAG6 = 1;
 var COMPARE_UNORDERED_FLAG4 = 2;
-function baseMatchesProperty(path39, srcValue) {
-  if (isKey_default(path39) && isStrictComparable_default(srcValue)) {
-    return matchesStrictComparable_default(toKey_default(path39), srcValue);
+function baseMatchesProperty(path42, srcValue) {
+  if (isKey_default(path42) && isStrictComparable_default(srcValue)) {
+    return matchesStrictComparable_default(toKey_default(path42), srcValue);
   }
   return function(object3) {
-    var objValue = get_default(object3, path39);
-    return objValue === void 0 && objValue === srcValue ? hasIn_default(object3, path39) : baseIsEqual_default(srcValue, objValue, COMPARE_PARTIAL_FLAG6 | COMPARE_UNORDERED_FLAG4);
+    var objValue = get_default(object3, path42);
+    return objValue === void 0 && objValue === srcValue ? hasIn_default(object3, path42) : baseIsEqual_default(srcValue, objValue, COMPARE_PARTIAL_FLAG6 | COMPARE_UNORDERED_FLAG4);
   };
 }
 var baseMatchesProperty_default = baseMatchesProperty;
@@ -34415,16 +34506,16 @@ function baseProperty(key) {
 var baseProperty_default = baseProperty;
 // node_modules/lodash-es/_basePropertyDeep.js
-function basePropertyDeep(path39) {
+function basePropertyDeep(path42) {
   return function(object3) {
-    return baseGet_default(object3, path39);
+    return baseGet_default(object3, path42);
   };
 }
 var basePropertyDeep_default = basePropertyDeep;
 // node_modules/lodash-es/property.js
-function property(path39) {
-  return isKey_default(path39) ? baseProperty_default(toKey_default(path39)) : basePropertyDeep_default(path39);
+function property(path42) {
+  return isKey_default(path42) ? baseProperty_default(toKey_default(path42)) : basePropertyDeep_default(path42);
 }
 var property_default = property;
@@ -34792,8 +34883,8 @@ function baseHas(object3, key) {
 var baseHas_default = baseHas;
 // node_modules/lodash-es/has.js
-function has(object3, path39) {
-  return object3 != null && hasPath_default(object3, path39, baseHas_default);
+function has(object3, path42) {
+  return object3 != null && hasPath_default(object3, path42, baseHas_default);
 }
 var has_default = has;
@@ -34916,14 +35007,14 @@ function negate(predicate) {
 var negate_default = negate;
 // node_modules/lodash-es/_baseSet.js
-function baseSet(object3, path39, value2, customizer) {
+function baseSet(object3, path42, value2, customizer) {
   if (!isObject_default(object3)) {
     return object3;
   }
-  path39 = castPath_default(path39, object3);
-  var index = -1, length = path39.length, lastIndex = length - 1, nested = object3;
+  path42 = castPath_default(path42, object3);
+  var index = -1, length = path42.length, lastIndex = length - 1, nested = object3;
   while (nested != null && ++index < length) {
-    var key = toKey_default(path39[index]), newValue = value2;
+    var key = toKey_default(path42[index]), newValue = value2;
     if (key === "__proto__" || key === "constructor" || key === "prototype") {
       return object3;
     }
@@ -34931,7 +35022,7 @@ function baseSet(object3, path39, value2, customizer) {
       var objValue = nested[key];
       newValue = customizer ? customizer(objValue, key, nested) : void 0;
       if (newValue === void 0) {
-        newValue = isObject_default(objValue) ? objValue : isIndex_default(path39[index + 1]) ? [] : {};
+        newValue = isObject_default(objValue) ? objValue : isIndex_default(path42[index + 1]) ? [] : {};
       }
     }
     assignValue_default(nested, key, newValue);
@@ -34945,9 +35036,9 @@ var baseSet_default = baseSet;
 function basePickBy(object3, paths, predicate) {
   var index = -1, length = paths.length, result = {};
   while (++index < length) {
-    var path39 = paths[index], value2 = baseGet_default(object3, path39);
-    if (predicate(value2, path39)) {
-      baseSet_default(result, castPath_default(path39, object3), value2);
+    var path42 = paths[index], value2 = baseGet_default(object3, path42);
+    if (predicate(value2, path42)) {
+      baseSet_default(result, castPath_default(path42, object3), value2);
     }
   }
   return result;
@@ -34963,8 +35054,8 @@ function pickBy(object3, predicate) {
     return [prop];
   });
   predicate = baseIteratee_default(predicate);
-  return basePickBy_default(object3, props, function(value2, path39) {
-    return predicate(value2, path39[0]);
+  return basePickBy_default(object3, props, function(value2, path42) {
+    return predicate(value2, path42[0]);
   });
 }
 var pickBy_default = pickBy;
@@ -37463,12 +37554,12 @@ function assignCategoriesMapProp(tokenTypes) {
     singleAssignCategoriesToksMap([], currTokType);
   });
 }
-function singleAssignCategoriesToksMap(path39, nextNode) {
-  forEach_default(path39, (pathNode) => {
+function singleAssignCategoriesToksMap(path42, nextNode) {
+  forEach_default(path42, (pathNode) => {
     nextNode.categoryMatchesMap[pathNode.tokenTypeIdx] = true;
   });
   forEach_default(nextNode.CATEGORIES, (nextCategory) => {
-    const newPath = path39.concat(nextNode);
+    const newPath = path42.concat(nextNode);
     if (!includes_default(newPath, nextCategory)) {
       singleAssignCategoriesToksMap(newPath, nextCategory);
     }
@@ -38312,10 +38403,10 @@ var GastRefResolverVisitor = class extends GAstVisitor {
 // node_modules/chevrotain/lib/src/parse/grammar/interpreter.js
 var AbstractNextPossibleTokensWalker = class extends RestWalker {
-  constructor(topProd, path39) {
+  constructor(topProd, path42) {
     super();
     this.topProd = topProd;
-    this.path = path39;
+    this.path = path42;
     this.possibleTokTypes = [];
     this.nextProductionName = "";
     this.nextProductionOccurrence = 0;
@@ -38359,9 +38450,9 @@ var AbstractNextPossibleTokensWalker = class extends RestWalker {
   }
 };
 var NextAfterTokenWalker = class extends AbstractNextPossibleTokensWalker {
-  constructor(topProd, path39) {
-    super(topProd, path39);
-    this.path = path39;
+  constructor(topProd, path42) {
+    super(topProd, path42);
+    this.path = path42;
     this.nextTerminalName = "";
     this.nextTerminalOccurrence = 0;
     this.nextTerminalName = this.path.lastTok.name;
@@ -38957,10 +39048,10 @@ function initializeArrayOfArrays(size) {
   }
   return result;
 }
-function pathToHashKeys(path39) {
+function pathToHashKeys(path42) {
   let keys2 = [""];
-  for (let i = 0; i < path39.length; i++) {
-    const tokType = path39[i];
+  for (let i = 0; i < path42.length; i++) {
+    const tokType = path42[i];
     const longerKeys = [];
     for (let j = 0; j < keys2.length; j++) {
       const currShorterKey = keys2[j];
@@ -39199,7 +39290,7 @@ function validateRuleIsOverridden(ruleName, definedRulesNames, className) {
   }
   return errors2;
 }
-function validateNoLeftRecursion(topRule, currRule, errMsgProvider, path39 = []) {
+function validateNoLeftRecursion(topRule, currRule, errMsgProvider, path42 = []) {
   const errors2 = [];
   const nextNonTerminals = getFirstNoneTerminal(currRule.definition);
   if (isEmpty_default(nextNonTerminals)) {
@@ -39211,15 +39302,15 @@ function validateNoLeftRecursion(topRule, currRule, errMsgProvider, path39 = [])
       errors2.push({
         message: errMsgProvider.buildLeftRecursionError({
           topLevelRule: topRule,
-          leftRecursionPath: path39
+          leftRecursionPath: path42
         }),
         type: ParserDefinitionErrorType.LEFT_RECURSION,
         ruleName
       });
     }
-    const validNextSteps = difference_default(nextNonTerminals, path39.concat([topRule]));
+    const validNextSteps = difference_default(nextNonTerminals, path42.concat([topRule]));
     const errorsFromNextSteps = flatMap_default(validNextSteps, (currRefRule) => {
-      const newPath = clone_default(path39);
+      const newPath = clone_default(path42);
       newPath.push(currRefRule);
       return validateNoLeftRecursion(topRule, currRefRule, errMsgProvider, newPath);
     });
@@ -44734,38 +44825,39 @@ function assignImplicitPortOrders(ports) {
     scopeGroups.get(scopeKey).push([portName, portDef]);
   }
   for (const [scope, portsInScope] of scopeGroups.entries()) {
+    let nextSlot2 = function(from) {
+      while (occupied.has(from)) from++;
+      occupied.add(from);
+      return from;
+    };
+    var nextSlot = nextSlot2;
     const isScoped = scope !== void 0;
-    const mandatoryPorts = portsInScope.filter(([name]) => isMandatoryPort(name, isScoped));
-    const regularPorts = portsInScope.filter(([name]) => !isMandatoryPort(name, isScoped));
-    let minRegularExplicitOrder = Infinity;
-    for (const [, portDef] of regularPorts) {
+    const occupied = /* @__PURE__ */ new Set();
+    for (const [, portDef] of portsInScope) {
       const order = portDef.metadata?.order;
       if (typeof order === "number") {
-        minRegularExplicitOrder = Math.min(minRegularExplicitOrder, order);
+        occupied.add(order);
       }
     }
-    let mandatoryStartOrder = 0;
-    if (minRegularExplicitOrder !== Infinity && minRegularExplicitOrder === 0) {
-      const regularPortsWithOrder0 = regularPorts.filter(([, p]) => p.metadata?.order === 0);
-      mandatoryStartOrder = regularPortsWithOrder0.length;
-    }
-    let currentMandatoryOrder = mandatoryStartOrder;
-    for (const [, portDef] of mandatoryPorts) {
-      if (portDef.metadata?.order === void 0) {
-        if (!portDef.metadata) {
-          portDef.metadata = {};
-        }
-        portDef.metadata.order = currentMandatoryOrder++;
-      }
+    const mandatoryNeedOrder = portsInScope.filter(
+      ([name, def]) => isMandatoryPort(name, isScoped) && def.metadata?.order === void 0
+    );
+    const regularNeedOrder = portsInScope.filter(
+      ([name, def]) => !isMandatoryPort(name, isScoped) && def.metadata?.order === void 0
+    );
+    let slot = -mandatoryNeedOrder.length;
+    for (const [, portDef] of mandatoryNeedOrder) {
+      if (!portDef.metadata) portDef.metadata = {};
+      slot = nextSlot2(slot);
+      portDef.metadata.order = slot;
+      slot++;
     }
-    let currentRegularOrder = currentMandatoryOrder;
-    for (const [, portDef] of regularPorts) {
-      if (portDef.metadata?.order === void 0) {
-        if (!portDef.metadata) {
-          portDef.metadata = {};
-        }
-        portDef.metadata.order = currentRegularOrder++;
-      }
+    slot = Math.max(slot, 0);
+    for (const [, portDef] of regularNeedOrder) {
+      if (!portDef.metadata) portDef.metadata = {};
+      slot = nextSlot2(slot);
+      portDef.metadata.order = slot;
+      slot++;
     }
   }
 }
@@ -47065,8 +47157,8 @@ ${errorMessages.join("\n")}`);
 }
 function getDefaultOutputFile(sourceFile) {
   const dir = path7.dirname(sourceFile);
-  const basename17 = path7.basename(sourceFile, ".ts");
-  return path7.join(dir, `${basename17}.generated.ts`);
+  const basename18 = path7.basename(sourceFile, ".ts");
+  return path7.join(dir, `${basename18}.generated.ts`);
 }
 // src/api/index.ts
@@ -47341,7 +47433,7 @@ function processResult(result, scope) {
   }
   return result !== NOTHING ? result : void 0;
 }
-function finalize(rootScope, value2, path39) {
+function finalize(rootScope, value2, path42) {
   if (isFrozen(value2))
     return value2;
   const useStrictIteration = rootScope.immer_.shouldUseStrictIteration();
@@ -47349,7 +47441,7 @@ function finalize(rootScope, value2, path39) {
   if (!state) {
     each(
       value2,
-      (key, childValue) => finalizeProperty(rootScope, state, value2, key, childValue, path39),
+      (key, childValue) => finalizeProperty(rootScope, state, value2, key, childValue, path42),
       useStrictIteration
     );
     return value2;
@@ -47379,16 +47471,16 @@ function finalize(rootScope, value2, path39) {
         result,
         key,
         childValue,
-        path39,
+        path42,
         isSet22
       ),
       useStrictIteration
     );
     maybeFreeze(rootScope, result, false);
-    if (path39 && rootScope.patches_) {
+    if (path42 && rootScope.patches_) {
       getPlugin("Patches").generatePatches_(
         state,
-        path39,
+        path42,
         rootScope.patches_,
         rootScope.inversePatches_
       );
@@ -47410,9 +47502,9 @@ function finalizeProperty(rootScope, parentState, targetObject, prop, childValue
   if (process.env.NODE_ENV !== "production" && childValue === targetObject)
     die(5);
   if (isDraft(childValue)) {
-    const path39 = rootPath && parentState && parentState.type_ !== 3 && // Set objects are atomic since they have no keys.
+    const path42 = rootPath && parentState && parentState.type_ !== 3 && // Set objects are atomic since they have no keys.
     !has2(parentState.assigned_, prop) ? rootPath.concat(prop) : void 0;
-    const res = finalize(rootScope, childValue, path39);
+    const res = finalize(rootScope, childValue, path42);
     set(targetObject, prop, res);
     if (isDraft(res)) {
       rootScope.canAutoFreeze_ = false;
@@ -58273,17 +58365,17 @@ function buildAdjacency(ast) {
 function enumeratePaths(ast) {
   const { fromStart, toExit, edges } = buildAdjacency(ast);
   const paths = [];
-  function dfs(current2, path39, visited) {
+  function dfs(current2, path42, visited) {
     if (toExit.has(current2)) {
-      paths.push([...path39, "Exit"]);
+      paths.push([...path42, "Exit"]);
     }
     const targets = edges.get(current2) || [];
     for (const next of targets) {
       if (!visited.has(next)) {
         visited.add(next);
-        path39.push(next);
-        dfs(next, path39, visited);
-        path39.pop();
+        path42.push(next);
+        dfs(next, path42, visited);
+        path42.pop();
         visited.delete(next);
       }
     }
@@ -58297,22 +58389,22 @@ function enumeratePaths(ast) {
 function buildGraph(ast) {
   const { fromStart, toExit, edges } = buildAdjacency(ast);
   const lines = [];
-  function dfs(current2, path39, visited) {
+  function dfs(current2, path42, visited) {
     if (toExit.has(current2)) {
-      lines.push([...path39, "Exit"].join(" -> "));
+      lines.push([...path42, "Exit"].join(" -> "));
     }
     const targets = edges.get(current2) || [];
     for (const next of targets) {
       if (!visited.has(next)) {
         visited.add(next);
-        path39.push(next);
-        dfs(next, path39, visited);
-        path39.pop();
+        path42.push(next);
+        dfs(next, path42, visited);
+        path42.pop();
         visited.delete(next);
       }
     }
     if (targets.length === 0 && !toExit.has(current2)) {
-      lines.push(path39.join(" -> "));
+      lines.push(path42.join(" -> "));
     }
   }
   fromStart.forEach((startNode) => {
@@ -59223,14 +59315,14 @@ function waypointsToSvgPath(waypoints, cornerRadius) {
       radii[i + 1] *= scale;
     }
   }
-  let path39 = `M ${waypoints[0][0]},${waypoints[0][1]}`;
+  let path42 = `M ${waypoints[0][0]},${waypoints[0][1]}`;
   for (let i = 1; i < waypoints.length - 1; i++) {
     const prev = waypoints[i - 1];
     const curr = waypoints[i];
     const next = waypoints[i + 1];
     const r = radii[i];
     if (r < 2) {
-      path39 += ` L ${curr[0]},${curr[1]}`;
+      path42 += ` L ${curr[0]},${curr[1]}`;
       continue;
     }
     const dPrev = [prev[0] - curr[0], prev[1] - curr[1]];
@@ -59243,12 +59335,12 @@ function waypointsToSvgPath(waypoints, cornerRadius) {
     const arcEnd = [curr[0] + uNext[0] * r, curr[1] + uNext[1] * r];
     const cross = dPrev[0] * dNext[1] - dPrev[1] * dNext[0];
     const sweep = cross > 0 ? 0 : 1;
-    path39 += ` L ${arcStart[0]},${arcStart[1]}`;
-    path39 += ` A ${r} ${r} 0 0 ${sweep} ${arcEnd[0]},${arcEnd[1]}`;
+    path42 += ` L ${arcStart[0]},${arcStart[1]}`;
+    path42 += ` A ${r} ${r} 0 0 ${sweep} ${arcEnd[0]},${arcEnd[1]}`;
   }
   const last2 = waypoints[waypoints.length - 1];
-  path39 += ` L ${last2[0]},${last2[1]}`;
-  return path39;
+  path42 += ` L ${last2[0]},${last2[1]}`;
+  return path42;
 }
 function computeWaypoints(from, to, nodeBoxes, sourceNodeId, targetNodeId, padding, exitStub, entryStub, allocator) {
   const isSelfConnection = sourceNodeId === targetNodeId;
@@ -59395,7 +59487,7 @@ function calculateOrthogonalPath(from, to, nodeBoxes, sourceNodeId, targetNodeId
 }
 function calculateOrthogonalPathSafe(from, to, nodeBoxes, sourceNodeId, targetNodeId, options, allocator) {
   try {
-    const path39 = calculateOrthogonalPath(
+    const path42 = calculateOrthogonalPath(
       from,
       to,
       nodeBoxes,
@@ -59404,8 +59496,8 @@ function calculateOrthogonalPathSafe(from, to, nodeBoxes, sourceNodeId, targetNo
       options,
       allocator
     );
-    if (!path39 || path39.length < 5) return null;
-    return path39;
+    if (!path42 || path42.length < 5) return null;
+    return path42;
   } catch {
     return null;
   }
@@ -59600,13 +59692,13 @@ function computeConnectionPath(sx, sy, tx, ty) {
   const deUy = deY / deLen;
   const [cx, cy] = quadCurveControl(bx, by, dx, dy, -deUx, -deUy);
   const [fx, fy] = quadCurveControl(gx, gy, ex, ey, deUx, deUy);
-  let path39 = `M ${cx},${cy} M ${ax},${ay}`;
-  path39 += ` L ${bx},${by}`;
-  path39 += ` Q ${cx},${cy} ${dx},${dy}`;
-  path39 += ` L ${ex},${ey}`;
-  path39 += ` Q ${fx},${fy} ${gx},${gy}`;
-  path39 += ` L ${hx},${hy}`;
-  return path39;
+  let path42 = `M ${cx},${cy} M ${ax},${ay}`;
+  path42 += ` L ${bx},${by}`;
+  path42 += ` Q ${cx},${cy} ${dx},${dy}`;
+  path42 += ` L ${ex},${ey}`;
+  path42 += ` Q ${fx},${fy} ${gx},${gy}`;
+  path42 += ` L ${hx},${hy}`;
+  return path42;
 }
 function orderedPorts(ports, direction) {
   const cloned = {};
@@ -59894,7 +59986,7 @@ function finalizeScopePositions(parentNode, ast, theme = "dark") {
 function buildConnection(fromNode, fromPort, toNode, toPort, sourcePort, targetPort, theme = "dark") {
   const sourceColor = getPortColor(sourcePort.dataType, sourcePort.isFailure, theme);
   const targetColor = getPortColor(targetPort.dataType, targetPort.isFailure, theme);
-  const path39 = computeConnectionPath(sourcePort.cx, sourcePort.cy, targetPort.cx, targetPort.cy);
+  const path42 = computeConnectionPath(sourcePort.cx, sourcePort.cy, targetPort.cx, targetPort.cy);
   return {
     fromNode,
     fromPort,
@@ -59903,7 +59995,7 @@ function buildConnection(fromNode, fromPort, toNode, toPort, sourcePort, targetP
     sourceColor,
     targetColor,
     isStepConnection: sourcePort.dataType === "STEP",
-    path: path39
+    path: path42
   };
 }
 function portsColumnHeight(count) {
@@ -60294,7 +60386,7 @@ function buildDiagramGraph(ast, options = {}) {
     const dy = ty - sy;
     const distance = Math.sqrt(dx * dx + dy * dy);
     const useCurve = forceCurveSet.has(pc);
-    let path39;
+    let path42;
     if (!useCurve && distance > ORTHOGONAL_DISTANCE_THRESHOLD) {
       const orthoPath = calculateOrthogonalPathSafe(
         [sx, sy],
@@ -60305,9 +60397,9 @@ function buildDiagramGraph(ast, options = {}) {
         { fromPortIndex: pc.fromPortIndex, toPortIndex: pc.toPortIndex },
         allocator
       );
-      path39 = orthoPath ?? computeConnectionPath(sx, sy, tx, ty);
+      path42 = orthoPath ?? computeConnectionPath(sx, sy, tx, ty);
     } else {
-      path39 = computeConnectionPath(sx, sy, tx, ty);
+      path42 = computeConnectionPath(sx, sy, tx, ty);
     }
     const sourceColor = getPortColor(pc.sourcePort.dataType, pc.sourcePort.isFailure, themeName);
     const targetColor = getPortColor(pc.targetPort.dataType, pc.targetPort.isFailure, themeName);
@@ -60319,7 +60411,7 @@ function buildDiagramGraph(ast, options = {}) {
       sourceColor,
       targetColor,
       isStepConnection: pc.sourcePort.dataType === "STEP",
-      path: path39
+      path: path42
     });
   }
   for (const node of nodes) {
@@ -60392,12 +60484,12 @@ function resolveDefaultIcon(nt) {
   if (nt.variant === "WORKFLOW" || nt.variant === "IMPORTED_WORKFLOW") return "flow";
   return "code";
 }
-function pathExtent(path39) {
+function pathExtent(path42) {
   let minX = Infinity, minY = Infinity;
   let maxX = -Infinity, maxY = -Infinity;
   const pattern = /(-?[\d.]+),(-?[\d.]+)/g;
   let m;
-  while ((m = pattern.exec(path39)) !== null) {
+  while ((m = pattern.exec(path42)) !== null) {
     const x = parseFloat(m[1]);
     const y = parseFloat(m[2]);
     minX = Math.min(minX, x);
@@ -60501,7 +60593,7 @@ function renderSVG(graph, options = {}) {
 function renderConnection(parts2, conn, gradIndex) {
   const dashAttr = conn.isStepConnection ? "" : ' stroke-dasharray="8 4"';
   parts2.push(
-    `  <path d="${conn.path}" fill="none" stroke="url(#conn-grad-${gradIndex})" stroke-width="3"${dashAttr} stroke-linecap="round" data-source="${escapeXml(conn.fromNode)}.${escapeXml(conn.fromPort)}" data-target="${escapeXml(conn.toNode)}.${escapeXml(conn.toPort)}"/>`
+    `  <path d="${conn.path}" fill="none" stroke="url(#conn-grad-${gradIndex})" stroke-width="3"${dashAttr} stroke-linecap="round" data-source="${escapeXml(conn.fromNode)}.${escapeXml(conn.fromPort)}:output" data-target="${escapeXml(conn.toNode)}.${escapeXml(conn.toPort)}:input"/>`
   );
 }
 function renderScopeConnection(parts2, conn, allConnections) {
@@ -60509,7 +60601,7 @@ function renderScopeConnection(parts2, conn, allConnections) {
   if (gradIndex < 0) return;
   const dashAttr = conn.isStepConnection ? "" : ' stroke-dasharray="8 4"';
   parts2.push(
-    `    <path d="${conn.path}" fill="none" stroke="url(#conn-grad-${gradIndex})" stroke-width="2.5"${dashAttr} stroke-linecap="round" data-source="${escapeXml(conn.fromNode)}.${escapeXml(conn.fromPort)}" data-target="${escapeXml(conn.toNode)}.${escapeXml(conn.toPort)}"/>`
+    `    <path d="${conn.path}" fill="none" stroke="url(#conn-grad-${gradIndex})" stroke-width="2.5"${dashAttr} stroke-linecap="round" data-source="${escapeXml(conn.fromNode)}.${escapeXml(conn.fromPort)}:output" data-target="${escapeXml(conn.toNode)}.${escapeXml(conn.toPort)}:input"/>`
   );
 }
 function renderNodeBody(parts2, node, theme, indent) {
@@ -60590,7 +60682,7 @@ function renderPortDots(parts2, nodeId, inputs, outputs, themeName) {
     const color = getPortColor(port.dataType, port.isFailure, themeName);
     const ringColor = getPortRingColor(port.dataType, port.isFailure, themeName);
     const dir = port.direction === "INPUT" ? "input" : "output";
-    parts2.push(`    <circle cx="${port.cx}" cy="${port.cy}" r="${PORT_RADIUS}" fill="${color}" stroke="${ringColor}" stroke-width="2" data-port-id="${escapeXml(nodeId)}.${escapeXml(port.name)}" data-direction="${dir}"/>`);
+    parts2.push(`    <circle cx="${port.cx}" cy="${port.cy}" r="${PORT_RADIUS}" fill="${color}" stroke="${ringColor}" stroke-width="2" data-port-id="${escapeXml(nodeId)}.${escapeXml(port.name)}:${dir}" data-direction="${dir}"/>`);
   }
 }
 function renderPortLabels(parts2, nodeId, inputs, outputs, theme, themeName) {
@@ -60598,7 +60690,8 @@ function renderPortLabels(parts2, nodeId, inputs, outputs, theme, themeName) {
     const color = getPortColor(port.dataType, port.isFailure, themeName);
     const isInput = port.direction === "INPUT";
     const abbrev = TYPE_ABBREVIATIONS[port.dataType] ?? port.dataType;
-    const portId = `${escapeXml(nodeId)}.${escapeXml(port.name)}`;
+    const dir = isInput ? "input" : "output";
+    const portId = `${escapeXml(nodeId)}.${escapeXml(port.name)}:${dir}`;
     const portLabel = port.label;
     const typeWidth = measureText(abbrev);
     const labelWidth = measureText(portLabel);
@@ -60892,43 +60985,79 @@ body.node-active .connections path.dimmed { opacity: 0.15; }
     else if (e.key === 'Escape') deselectNode();
   });
-  // ---- Port label visibility via JS (since CSS sibling selectors can't reach .labels group) ----
-  var labelEls = content.querySelectorAll('.labels g[data-port-label]');
-  var nodeEls = content.querySelectorAll('.nodes g[data-node-id]');
+  // ---- Port label visibility ----
+  var labelMap = {};
+  content.querySelectorAll('.labels g[data-port-label]').forEach(function(lbl) {
+    labelMap[lbl.getAttribute('data-port-label')] = lbl;
+  });
-  function showLabelsFor(id) {
-    labelEls.forEach(function(lbl) {
-      var portId = lbl.getAttribute('data-port-label') || '';
-      if (portId.indexOf(id + '.') === 0) {
-        lbl.style.opacity = '1';
-        lbl.style.pointerEvents = 'auto';
-      }
+  // Build adjacency: portId \u2192 array of connected portIds
+  var portConnections = {};
+  content.querySelectorAll('.connections path').forEach(function(p) {
+    var src = p.getAttribute('data-source');
+    var tgt = p.getAttribute('data-target');
+    if (!src || !tgt) return;
+    if (!portConnections[src]) portConnections[src] = [];
+    if (!portConnections[tgt]) portConnections[tgt] = [];
+    portConnections[src].push(tgt);
+    portConnections[tgt].push(src);
+  });
+  var allLabelIds = Object.keys(labelMap);
+  var hoveredPort = null;
+  function showLabel(id) { var l = labelMap[id]; if (l) { l.style.opacity = '1'; l.style.pointerEvents = 'auto'; } }
+  function hideLabel(id) { var l = labelMap[id]; if (l) { l.style.opacity = '0'; l.style.pointerEvents = 'none'; } }
+  function showLabelsFor(nodeId) {
+    allLabelIds.forEach(function(id) {
+      if (id.indexOf(nodeId + '.') === 0) showLabel(id);
     });
   }
-  function hideLabelsFor(id) {
-    labelEls.forEach(function(lbl) {
-      var portId = lbl.getAttribute('data-port-label') || '';
-      if (portId.indexOf(id + '.') === 0) {
-        lbl.style.opacity = '0';
-        lbl.style.pointerEvents = 'none';
-      }
+  function hideLabelsFor(nodeId) {
+    allLabelIds.forEach(function(id) {
+      if (id.indexOf(nodeId + '.') === 0) hideLabel(id);
     });
   }
+  // Node hover: show all port labels for the hovered node
+  var nodeEls = content.querySelectorAll('.nodes g[data-node-id]');
   nodeEls.forEach(function(nodeG) {
     var nodeId = nodeG.getAttribute('data-node-id');
     var parentNodeG = nodeG.parentElement ? nodeG.parentElement.closest('g[data-node-id]') : null;
     var parentId = parentNodeG ? parentNodeG.getAttribute('data-node-id') : null;
     nodeG.addEventListener('mouseenter', function() {
+      if (hoveredPort) return; // port hover takes priority
       if (parentId) hideLabelsFor(parentId);
       showLabelsFor(nodeId);
     });
     nodeG.addEventListener('mouseleave', function() {
+      if (hoveredPort) return;
       hideLabelsFor(nodeId);
       if (parentId) showLabelsFor(parentId);
     });
   });
+  // Port hover: show this port's label + all connected port labels
+  content.querySelectorAll('[data-port-id]').forEach(function(portEl) {
+    var portId = portEl.getAttribute('data-port-id');
+    var nodeId = portId.split('.')[0];
+    var peers = (portConnections[portId] || []).concat(portId);
+    portEl.addEventListener('mouseenter', function() {
+      hoveredPort = portId;
+      // Hide all labels for this node first, then show only the relevant ones
+      hideLabelsFor(nodeId);
+      peers.forEach(showLabel);
+    });
+    portEl.addEventListener('mouseleave', function() {
+      hoveredPort = null;
+      peers.forEach(hideLabel);
+      // Restore all labels for the node since we're still inside it
+      showLabelsFor(nodeId);
+    });
+  });
   // ---- Click to inspect node ----
   function deselectNode() {
     selectedNodeId = null;
@@ -60955,7 +61084,7 @@ body.node-active .connections path.dimmed { opacity: 0.15; }
     ports.forEach(function(p) {
       var id = p.getAttribute('data-port-id');
       var dir = p.getAttribute('data-direction');
-      var name = id.split('.').slice(1).join('.');
+      var name = id.split('.').slice(1).join('.').replace(/:(?:input|output)$/, '');
       if (dir === 'input') inputs.push(name);
       else outputs.push(name);
     });
@@ -63442,13 +63571,13 @@ var PromisePolyfill = class extends Promise {
   // Available starting from Node 22
   // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers
   static withResolver() {
-    let resolve28;
+    let resolve31;
     let reject2;
     const promise = new Promise((res, rej) => {
-      resolve28 = res;
+      resolve31 = res;
       reject2 = rej;
     });
-    return { promise, resolve: resolve28, reject: reject2 };
+    return { promise, resolve: resolve31, reject: reject2 };
   }
 };
@@ -63482,7 +63611,7 @@ function createPrompt(view) {
       output
     });
     const screen = new ScreenManager(rl);
-    const { promise, resolve: resolve28, reject: reject2 } = PromisePolyfill.withResolver();
+    const { promise, resolve: resolve31, reject: reject2 } = PromisePolyfill.withResolver();
     const cancel = () => reject2(new CancelPromptError());
     if (signal) {
       const abort = () => reject2(new AbortPromptError({ cause: signal.reason }));
@@ -63509,7 +63638,7 @@ function createPrompt(view) {
       cycle(() => {
         try {
           const nextView = view(config2, (value2) => {
-            setImmediate(() => resolve28(value2));
+            setImmediate(() => resolve31(value2));
           });
           if (nextView === void 0) {
             const callerFilename = callSites[1]?.getFileName();
@@ -64090,13 +64219,13 @@ var PromisePolyfill2 = class extends Promise {
   // Available starting from Node 22
   // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers
   static withResolver() {
-    let resolve28;
+    let resolve31;
     let reject2;
     const promise = new Promise((res, rej) => {
-      resolve28 = res;
+      resolve31 = res;
       reject2 = rej;
     });
-    return { promise, resolve: resolve28, reject: reject2 };
+    return { promise, resolve: resolve31, reject: reject2 };
   }
 };
@@ -64130,7 +64259,7 @@ function createPrompt2(view) {
       output
     });
     const screen = new ScreenManager2(rl);
-    const { promise, resolve: resolve28, reject: reject2 } = PromisePolyfill2.withResolver();
+    const { promise, resolve: resolve31, reject: reject2 } = PromisePolyfill2.withResolver();
     const cancel = () => reject2(new CancelPromptError2());
     if (signal) {
       const abort = () => reject2(new AbortPromptError2({ cause: signal.reason }));
@@ -64157,7 +64286,7 @@ function createPrompt2(view) {
       cycle(() => {
         try {
           const nextView = view(config2, (value2) => {
-            setImmediate(() => resolve28(value2));
+            setImmediate(() => resolve31(value2));
           });
           if (nextView === void 0) {
             const callerFilename = callSites[1]?.getFileName();
@@ -64709,13 +64838,13 @@ var PromisePolyfill3 = class extends Promise {
   // Available starting from Node 22
   // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers
   static withResolver() {
-    let resolve28;
+    let resolve31;
     let reject2;
     const promise = new Promise((res, rej) => {
-      resolve28 = res;
+      resolve31 = res;
       reject2 = rej;
     });
-    return { promise, resolve: resolve28, reject: reject2 };
+    return { promise, resolve: resolve31, reject: reject2 };
   }
 };
@@ -64749,7 +64878,7 @@ function createPrompt3(view) {
       output
     });
     const screen = new ScreenManager3(rl);
-    const { promise, resolve: resolve28, reject: reject2 } = PromisePolyfill3.withResolver();
+    const { promise, resolve: resolve31, reject: reject2 } = PromisePolyfill3.withResolver();
     const cancel = () => reject2(new CancelPromptError3());
     if (signal) {
       const abort = () => reject2(new AbortPromptError3({ cause: signal.reason }));
@@ -64776,7 +64905,7 @@ function createPrompt3(view) {
       cycle(() => {
         try {
           const nextView = view(config2, (value2) => {
-            setImmediate(() => resolve28(value2));
+            setImmediate(() => resolve31(value2));
           });
           if (nextView === void 0) {
             const callerFilename = callSites[1]?.getFileName();
@@ -67275,12 +67404,12 @@ function parse4(str2) {
   uri.queryKey = queryKey(uri, uri["query"]);
   return uri;
 }
-function pathNames(obj, path39) {
-  const regx = /\/{2,9}/g, names = path39.replace(regx, "/").split("/");
-  if (path39.slice(0, 1) == "/" || path39.length === 0) {
+function pathNames(obj, path42) {
+  const regx = /\/{2,9}/g, names = path42.replace(regx, "/").split("/");
+  if (path42.slice(0, 1) == "/" || path42.length === 0) {
     names.splice(0, 1);
   }
-  if (path39.slice(-1) == "/") {
+  if (path42.slice(-1) == "/") {
     names.splice(names.length - 1, 1);
   }
   return names;
@@ -67898,7 +68027,7 @@ var protocol2 = Socket.protocol;
 // node_modules/socket.io-client/build/esm-debug/url.js
 var import_debug7 = __toESM(require_src(), 1);
 var debug7 = (0, import_debug7.default)("socket.io-client:url");
-function url(uri, path39 = "", loc) {
+function url(uri, path42 = "", loc) {
   let obj = uri;
   loc = loc || typeof location !== "undefined" && location;
   if (null == uri)
@@ -67932,7 +68061,7 @@ function url(uri, path39 = "", loc) {
   obj.path = obj.path || "/";
   const ipv62 = obj.host.indexOf(":") !== -1;
   const host = ipv62 ? "[" + obj.host + "]" : obj.host;
-  obj.id = obj.protocol + "://" + host + ":" + obj.port + path39;
+  obj.id = obj.protocol + "://" + host + ":" + obj.port + path42;
   obj.href = obj.protocol + "://" + host + (loc && loc.port === obj.port ? "" : ":" + obj.port);
   return obj;
 }
@@ -68584,9 +68713,9 @@ var Socket2 = class extends import_component_emitter5.Emitter {
    * @return a Promise that will be fulfilled when the server acknowledges the event
    */
   emitWithAck(ev, ...args) {
-    return new Promise((resolve28, reject2) => {
+    return new Promise((resolve31, reject2) => {
       const fn = (arg1, arg2) => {
-        return arg1 ? reject2(arg1) : resolve28(arg2);
+        return arg1 ? reject2(arg1) : resolve31(arg2);
       };
       fn.withError = true;
       args.push(fn);
@@ -69559,8 +69688,8 @@ function lookup(uri, opts) {
   const parsed = url(uri, opts.path || "/socket.io");
   const source = parsed.source;
   const id = parsed.id;
-  const path39 = parsed.path;
-  const sameNamespace = cache[id] && path39 in cache[id]["nsps"];
+  const path42 = parsed.path;
+  const sameNamespace = cache[id] && path42 in cache[id]["nsps"];
   const newConnection = opts.forceNew || opts["force new connection"] || false === opts.multiplex || sameNamespace;
   let io;
   if (newConnection) {
@@ -70104,8 +70233,8 @@ function getErrorMap() {
 // node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path39, errorMaps, issueData } = params;
-  const fullPath = [...path39, ...issueData.path || []];
+  const { data, path: path42, errorMaps, issueData } = params;
+  const fullPath = [...path42, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -70221,11 +70350,11 @@ var errorUtil;
 // node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value2, path39, key) {
+  constructor(parent, value2, path42, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value2;
-    this._path = path39;
+    this._path = path42;
     this._key = key;
   }
   get path() {
@@ -73862,10 +73991,10 @@ function assignProp(target, prop, value2) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path39) {
-  if (!path39)
+function getElementAtPath(obj, path42) {
+  if (!path42)
     return obj;
-  return path39.reduce((acc, key) => acc?.[key], obj);
+  return path42.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys2 = Object.keys(promisesObj);
@@ -74185,11 +74314,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path39, issues) {
+function prefixIssues(path42, issues) {
   return issues.map((iss) => {
     var _a;
     (_a = iss).path ?? (_a.path = []);
-    iss.path.unshift(path39);
+    iss.path.unshift(path42);
     return iss;
   });
 }
@@ -81698,7 +81827,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve28) => setTimeout(resolve28, pollInterval));
+        await new Promise((resolve31) => setTimeout(resolve31, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error2) {
@@ -81715,7 +81844,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve28, reject2) => {
+    return new Promise((resolve31, reject2) => {
       const earlyReject = (error2) => {
         reject2(error2);
       };
@@ -81793,7 +81922,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject2(parseResult.error);
           } else {
-            resolve28(parseResult.data);
+            resolve31(parseResult.data);
           }
         } catch (error2) {
           reject2(error2);
@@ -82054,12 +82183,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve28, reject2) => {
+    return new Promise((resolve31, reject2) => {
       if (signal.aborted) {
         reject2(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve28, interval);
+      const timeoutId = setTimeout(resolve31, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject2(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -83018,7 +83147,7 @@ var McpServer = class {
     let task = createTaskResult.task;
     const pollInterval = task.pollInterval ?? 5e3;
     while (task.status !== "completed" && task.status !== "failed" && task.status !== "cancelled") {
-      await new Promise((resolve28) => setTimeout(resolve28, pollInterval));
+      await new Promise((resolve31) => setTimeout(resolve31, pollInterval));
       const updatedTask = await extra.taskStore.getTask(taskId);
       if (!updatedTask) {
         throw new McpError(ErrorCode.InternalError, `Task ${taskId} not found during polling`);
@@ -83661,12 +83790,12 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve28) => {
+    return new Promise((resolve31) => {
       const json2 = serializeMessage(message);
       if (this._stdout.write(json2)) {
-        resolve28();
+        resolve31();
       } else {
-        this._stdout.once("drain", resolve28);
+        this._stdout.once("drain", resolve31);
       }
     });
   }
@@ -83880,17 +84009,17 @@ var EditorConnection = class {
       return { requestId: "", success: false, error: "Not connected" };
     }
     const requestId = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-    return new Promise((resolve28) => {
+    return new Promise((resolve31) => {
       const handler = (data) => {
         if (data.requestId === requestId) {
           clearTimeout(timeout);
           this.socket.off("fw:ack", handler);
-          resolve28(data);
+          resolve31(data);
         }
       };
       const timeout = setTimeout(() => {
         this.socket.off("fw:ack", handler);
-        resolve28({ requestId, success: false, error: "Timeout" });
+        resolve31({ requestId, success: false, error: "Timeout" });
       }, this.ackTimeout);
       this.socket.on("fw:ack", handler);
       this.socket.emit("integration:command", { requestId, action, params });
@@ -83907,17 +84036,17 @@ var EditorConnection = class {
       return { requestId: "", success: false, error: "Not connected" };
     }
     const requestId = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-    return new Promise((resolve28) => {
+    return new Promise((resolve31) => {
       const handler = (data) => {
         if (data.requestId === requestId) {
           clearTimeout(timeout);
           this.socket.off("fw:ack", handler);
-          resolve28(data);
+          resolve31(data);
         }
       };
       const timeout = setTimeout(() => {
         this.socket.off("fw:ack", handler);
-        resolve28({ requestId, success: false, error: "Timeout" });
+        resolve31({ requestId, success: false, error: "Timeout" });
       }, this.ackTimeout);
       this.socket.on("fw:ack", handler);
       this.socket.emit("integration:batch", { requestId, commands });
@@ -83945,11 +84074,11 @@ function defaultRegistrationDeps() {
         return { stdout: "", exitCode: 1 };
       }
     },
-    prompt: (question) => new Promise((resolve28) => {
+    prompt: (question) => new Promise((resolve31) => {
       const rl = readline8.createInterface({ input: process.stdin, output: process.stderr });
       rl.question(question, (answer) => {
         rl.close();
-        resolve28(answer.trim().toLowerCase());
+        resolve31(answer.trim().toLowerCase());
       });
     }),
     log: (msg) => process.stderr.write(msg + "\n"),
@@ -84066,8 +84195,8 @@ var AgentChannel = class {
    */
   async request(agentRequest) {
     this._pauseResolve?.(agentRequest);
-    return new Promise((resolve28, reject2) => {
-      this._resolve = resolve28;
+    return new Promise((resolve31, reject2) => {
+      this._resolve = resolve31;
       this._reject = reject2;
     });
   }
@@ -84097,8 +84226,8 @@ var AgentChannel = class {
     this._pausePromise = this._createPausePromise();
   }
   _createPausePromise() {
-    return new Promise((resolve28) => {
-      this._pauseResolve = resolve28;
+    return new Promise((resolve31) => {
+      this._pauseResolve = resolve31;
     });
   }
 };
@@ -84650,8 +84779,8 @@ ${parseResult.errors.join("\n")}`);
           });
           const outputFile = filePath.replace(/\.ts$/, ".inngest.ts");
           if (args.write !== false) {
-            const fs38 = await import("fs");
-            fs38.writeFileSync(outputFile, code, "utf8");
+            const fs41 = await import("fs");
+            fs41.writeFileSync(outputFile, code, "utf8");
           }
           return makeToolResult({
             target: "inngest",
@@ -86081,8 +86210,8 @@ var OpenAPIGenerator = class {
     doc.paths["/health"] = this.generateHealthEndpoint();
     doc.paths["/workflows"] = this.generateListEndpoint();
     for (const endpoint of endpoints) {
-      const path39 = options.basePath ? `${options.basePath}${endpoint.path}` : endpoint.path;
-      doc.paths[path39] = this.generateWorkflowEndpoint(endpoint);
+      const path42 = options.basePath ? `${options.basePath}${endpoint.path}` : endpoint.path;
+      doc.paths[path42] = this.generateWorkflowEndpoint(endpoint);
     }
     return doc;
   }
@@ -86459,8 +86588,8 @@ var BaseExportTarget = class {
    * Get relative import path for the workflow
    */
   getWorkflowImport(workflowFile) {
-    const basename17 = path24.basename(workflowFile, path24.extname(workflowFile));
-    return `./${basename17}.js`;
+    const basename18 = path24.basename(workflowFile, path24.extname(workflowFile));
+    return `./${basename18}.js`;
   }
   /**
    * Generate OpenAPI spec for node types as HTTP endpoints
@@ -91973,6 +92102,249 @@ function registerDocsTools(mcp) {
   );
 }
+// src/mcp/tools-model.ts
+import * as fs28 from "fs";
+import * as path31 from "path";
+var stepSchema = external_exports.object({
+  name: external_exports.string().describe("Function name for this node"),
+  description: external_exports.string().optional().describe("Brief description of what this node does"),
+  inputs: external_exports.record(external_exports.string()).describe('Input ports as { portName: dataType } (e.g. { email: "STRING" })'),
+  outputs: external_exports.record(external_exports.string()).describe("Output ports as { portName: dataType }")
+});
+function findDeclareFunction(source, functionName) {
+  const lines = source.split("\n");
+  const startPattern = new RegExp(`^(\\s*)declare\\s+function\\s+${escapeRegex2(functionName)}\\s*\\(`);
+  for (let i = 0; i < lines.length; i++) {
+    const m = lines[i].match(startPattern);
+    if (!m) continue;
+    const indent = m[1] || "";
+    let accumulated = lines[i];
+    let j = i;
+    while (!accumulated.trimEnd().endsWith(";") && j < lines.length - 1) {
+      j++;
+      accumulated += "\n" + lines[j];
+    }
+    return { match: accumulated, indent };
+  }
+  return null;
+}
+function registerModelTools(mcp) {
+  mcp.tool(
+    "fw_create_model",
+    "Create a new stub workflow model from a structured description. Generates a TypeScript file with declare function stubs and workflow annotations. The model can be validated structurally before any node is implemented.",
+    {
+      name: external_exports.string().describe("Workflow name (used as export name)"),
+      description: external_exports.string().optional().describe("Workflow description"),
+      steps: external_exports.array(stepSchema).min(1).describe("Node definitions in execution order"),
+      flow: external_exports.string().describe('Execution path, e.g. "Start -> validateEmail -> checkUserExists -> Exit"'),
+      filePath: external_exports.string().describe("Output file path")
+    },
+    async (args) => {
+      try {
+        const outputPath = path31.resolve(args.filePath);
+        const lines = [];
+        for (const step of args.steps) {
+          lines.push("/** @flowWeaver node */");
+          const params = Object.entries(step.inputs).map(([name, type2]) => `${name}: ${mapTypeToTS(type2)}`).join(", ");
+          const outputEntries = Object.entries(step.outputs);
+          const returnType = outputEntries.length === 1 ? mapTypeToTS(outputEntries[0][1]) : `{ ${outputEntries.map(([name, type2]) => `${name}: ${mapTypeToTS(type2)}`).join("; ")} }`;
+          lines.push(`declare function ${step.name}(${params}): ${returnType};`);
+          lines.push("");
+        }
+        const flowSteps = args.flow.split("->").map((s) => s.trim()).filter(Boolean);
+        const nodeAnnotations = args.steps.map((step) => `@node ${step.name} ${step.name}`);
+        const pathAnnotation = `@path ${flowSteps.join(" -> ")}`;
+        const jsdocLines = ["/**"];
+        if (args.description) {
+          jsdocLines.push(` * ${args.description}`);
+          jsdocLines.push(" *");
+        }
+        jsdocLines.push(" * @flowWeaver workflow @autoConnect");
+        for (const nodeAnn of nodeAnnotations) {
+          jsdocLines.push(` * ${nodeAnn}`);
+        }
+        jsdocLines.push(` * ${pathAnnotation}`);
+        jsdocLines.push(" */");
+        jsdocLines.push(`export const ${args.name} = 'flowWeaver:draft';`);
+        lines.push(...jsdocLines);
+        lines.push("");
+        const content = lines.join("\n");
+        const dir = path31.dirname(outputPath);
+        if (!fs28.existsSync(dir)) {
+          fs28.mkdirSync(dir, { recursive: true });
+        }
+        fs28.writeFileSync(outputPath, content, "utf8");
+        return makeToolResult({
+          filePath: outputPath,
+          workflowName: args.name,
+          stubCount: args.steps.length,
+          nodes: args.steps.map((s) => s.name)
+        });
+      } catch (err) {
+        return makeErrorResult(
+          "CREATE_MODEL_ERROR",
+          `fw_create_model failed: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    }
+  );
+  mcp.tool(
+    "fw_workflow_status",
+    "Report implementation progress for a workflow \u2014 which nodes are stubs, which are implemented, and whether the graph structure is valid.",
+    {
+      filePath: external_exports.string().describe("Path to the workflow file"),
+      workflowName: external_exports.string().optional().describe("Specific workflow name if file has multiple")
+    },
+    async (args) => {
+      try {
+        const filePath = path31.resolve(args.filePath);
+        const parseResult = await parseWorkflow(filePath, { workflowName: args.workflowName });
+        if (parseResult.errors.length > 0) {
+          return makeErrorResult("PARSE_ERROR", `Parse errors:
+${parseResult.errors.join("\n")}`);
+        }
+        const ast = parseResult.ast;
+        const instanceTypeMap = /* @__PURE__ */ new Map();
+        for (const nt of ast.nodeTypes) {
+          instanceTypeMap.set(nt.name, nt);
+          if (nt.functionName !== nt.name) {
+            instanceTypeMap.set(nt.functionName, nt);
+          }
+        }
+        const nodes = [];
+        const seen = /* @__PURE__ */ new Set();
+        for (const instance of ast.instances) {
+          const nt = instanceTypeMap.get(instance.nodeType);
+          if (!nt || seen.has(nt.functionName)) continue;
+          seen.add(nt.functionName);
+          const inputs = {};
+          const outputs = {};
+          for (const [name, port] of Object.entries(nt.inputs)) {
+            if (name === "execute") continue;
+            inputs[name] = port.dataType;
+          }
+          for (const [name, port] of Object.entries(nt.outputs)) {
+            if (name === "onSuccess" || name === "onFailure") continue;
+            outputs[name] = port.dataType;
+          }
+          nodes.push({
+            name: nt.functionName,
+            status: nt.variant === "STUB" ? "stub" : "implemented",
+            inputs,
+            outputs
+          });
+        }
+        const implemented = nodes.filter((n) => n.status === "implemented").length;
+        const total = nodes.length;
+        const validation = validateWorkflow(ast, { mode: "draft" });
+        const structuralErrors = validation.errors.filter((e) => e.code !== "STUB_NODE").map((e) => ({ message: e.message, code: e.code, node: e.node }));
+        return makeToolResult({
+          workflowName: ast.name,
+          implemented,
+          total,
+          percentage: total > 0 ? Math.round(implemented / total * 100) : 100,
+          nodes,
+          structurallyValid: structuralErrors.length === 0,
+          structuralErrors
+        });
+      } catch (err) {
+        return makeErrorResult(
+          "STATUS_ERROR",
+          `fw_workflow_status failed: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    }
+  );
+  mcp.tool(
+    "fw_implement_node",
+    "Replace a stub node (declare function) with a real function skeleton, or write a provided implementation directly. Preserves existing JSDoc annotations.",
+    {
+      filePath: external_exports.string().describe("Path to the workflow file"),
+      nodeName: external_exports.string().describe("Function name of the stub node to implement"),
+      implementation: external_exports.string().optional().describe("Full function body to write. If omitted, generates a skeleton."),
+      workflowName: external_exports.string().optional().describe("Specific workflow name")
+    },
+    async (args) => {
+      try {
+        const filePath = path31.resolve(args.filePath);
+        if (!fs28.existsSync(filePath)) {
+          return makeErrorResult("FILE_NOT_FOUND", `File not found: ${args.filePath}`);
+        }
+        const parseResult = await parseWorkflow(filePath, { workflowName: args.workflowName });
+        if (parseResult.errors.length > 0) {
+          return makeErrorResult("PARSE_ERROR", `Parse errors:
+${parseResult.errors.join("\n")}`);
+        }
+        const ast = parseResult.ast;
+        const stubNt = ast.nodeTypes.find(
+          (nt) => nt.variant === "STUB" && (nt.functionName === args.nodeName || nt.name === args.nodeName)
+        );
+        if (!stubNt) {
+          const existing = ast.nodeTypes.find(
+            (nt) => nt.functionName === args.nodeName || nt.name === args.nodeName
+          );
+          if (existing) {
+            return makeErrorResult("ALREADY_IMPLEMENTED", `Node "${args.nodeName}" is already implemented.`);
+          }
+          const stubs = ast.nodeTypes.filter((nt) => nt.variant === "STUB").map((nt) => nt.functionName);
+          return makeErrorResult(
+            "NODE_NOT_FOUND",
+            `Stub "${args.nodeName}" not found. Available stubs: ${stubs.join(", ") || "none"}`
+          );
+        }
+        const source = fs28.readFileSync(filePath, "utf8");
+        const found = findDeclareFunction(source, stubNt.functionName);
+        if (!found) {
+          return makeErrorResult(
+            "SOURCE_MISMATCH",
+            `Could not find "declare function ${stubNt.functionName}" in source file.`
+          );
+        }
+        let replacement;
+        if (args.implementation) {
+          replacement = args.implementation.split("\n").map((line) => found.indent + line).join("\n");
+        } else {
+          const implementedType = { ...stubNt, variant: "FUNCTION" };
+          const signatureLines = generateFunctionSignature(implementedType);
+          replacement = signatureLines.map((line) => found.indent + line).join("\n");
+        }
+        const updated = source.replace(found.match, replacement);
+        fs28.writeFileSync(filePath, updated, "utf8");
+        return makeToolResult({
+          nodeName: stubNt.functionName,
+          filePath,
+          action: args.implementation ? "implemented" : "scaffolded"
+        });
+      } catch (err) {
+        return makeErrorResult(
+          "IMPLEMENT_ERROR",
+          `fw_implement_node failed: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    }
+  );
+}
+function mapTypeToTS(dataType) {
+  const upper = dataType.toUpperCase();
+  switch (upper) {
+    case "STRING":
+      return "string";
+    case "NUMBER":
+      return "number";
+    case "BOOLEAN":
+      return "boolean";
+    case "OBJECT":
+      return "Record<string, unknown>";
+    case "ARRAY":
+      return "unknown[]";
+    default:
+      return "unknown";
+  }
+}
+function escapeRegex2(str2) {
+  return str2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 // src/mcp/resources.ts
 function registerResources(mcp, connection, buffer) {
   mcp.resource(
@@ -92076,6 +92448,7 @@ async function startMcpServer(options) {
   registerMarketplaceTools(mcp);
   registerDiagramTools(mcp);
   registerDocsTools(mcp);
+  registerModelTools(mcp);
   registerResources(mcp, connection, buffer);
   if (!options._testDeps && options.stdio) {
     const transport = new StdioServerTransport();
@@ -92107,20 +92480,20 @@ async function sendCommand(serverUrl, action, params) {
     transports: ["websocket", "polling"]
   });
   try {
-    await new Promise((resolve28, reject2) => {
-      socket.on("connect", () => resolve28());
+    await new Promise((resolve31, reject2) => {
+      socket.on("connect", () => resolve31());
       socket.on("connect_error", (err) => reject2(err));
       setTimeout(() => reject2(new Error("Connection timeout")), ACK_TIMEOUT);
     });
     const requestId = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-    const result = await new Promise((resolve28) => {
+    const result = await new Promise((resolve31) => {
       const timeout = setTimeout(() => {
-        resolve28({ requestId, success: false, error: "Timeout" });
+        resolve31({ requestId, success: false, error: "Timeout" });
       }, ACK_TIMEOUT);
       socket.on("fw:ack", (data) => {
         if (data.requestId === requestId) {
           clearTimeout(timeout);
-          resolve28(data);
+          resolve31(data);
         }
       });
       socket.emit("integration:command", { requestId, action, params });
@@ -92150,20 +92523,20 @@ async function sendBatch(serverUrl, commands) {
     transports: ["websocket", "polling"]
   });
   try {
-    await new Promise((resolve28, reject2) => {
-      socket.on("connect", () => resolve28());
+    await new Promise((resolve31, reject2) => {
+      socket.on("connect", () => resolve31());
       socket.on("connect_error", (err) => reject2(err));
       setTimeout(() => reject2(new Error("Connection timeout")), ACK_TIMEOUT);
     });
     const requestId = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-    const result = await new Promise((resolve28) => {
+    const result = await new Promise((resolve31) => {
       const timeout = setTimeout(() => {
-        resolve28({ requestId, success: false, error: "Timeout" });
+        resolve31({ requestId, success: false, error: "Timeout" });
       }, ACK_TIMEOUT);
       socket.on("fw:ack", (data) => {
         if (data.requestId === requestId) {
           clearTimeout(timeout);
-          resolve28(data);
+          resolve31(data);
         }
       });
       socket.emit("integration:batch", { requestId, commands });
@@ -92217,7 +92590,7 @@ async function uiBatch(json2, options) {
 }
 // src/cli/commands/grammar.ts
-import * as fs28 from "fs";
+import * as fs29 from "fs";
 async function grammarCommand(options = {}) {
   const { format = "html", output } = options;
   try {
@@ -92236,7 +92609,7 @@ async function grammarCommand(options = {}) {
       content = generateGrammarDiagrams();
     }
     if (output) {
-      fs28.writeFileSync(output, content, "utf-8");
+      fs29.writeFileSync(output, content, "utf-8");
       logger.success(`Grammar written to ${output}`);
     } else {
       process.stdout.write(content);
@@ -92248,12 +92621,12 @@ async function grammarCommand(options = {}) {
 }
 // src/cli/commands/run.ts
-import * as path31 from "path";
-import * as fs29 from "fs";
+import * as path32 from "path";
+import * as fs30 from "fs";
 import * as readline9 from "readline";
 async function runCommand(input, options) {
-  const filePath = path31.resolve(input);
-  if (!fs29.existsSync(filePath)) {
+  const filePath = path32.resolve(input);
+  if (!fs30.existsSync(filePath)) {
     throw new Error(`File not found: ${filePath}`);
   }
   let params = {};
@@ -92264,12 +92637,12 @@ async function runCommand(input, options) {
       throw new Error(`Invalid JSON in --params: ${options.params}`);
     }
   } else if (options.paramsFile) {
-    const paramsFilePath = path31.resolve(options.paramsFile);
-    if (!fs29.existsSync(paramsFilePath)) {
+    const paramsFilePath = path32.resolve(options.paramsFile);
+    if (!fs30.existsSync(paramsFilePath)) {
       throw new Error(`Params file not found: ${paramsFilePath}`);
     }
     try {
-      const content = fs29.readFileSync(paramsFilePath, "utf8");
+      const content = fs30.readFileSync(paramsFilePath, "utf8");
       params = JSON.parse(content);
     } catch {
       throw new Error(`Failed to parse params file: ${options.paramsFile}`);
@@ -92283,12 +92656,12 @@ async function runCommand(input, options) {
       throw new Error(`Invalid JSON in --mocks: ${options.mocks}`);
     }
   } else if (options.mocksFile) {
-    const mocksFilePath = path31.resolve(options.mocksFile);
-    if (!fs29.existsSync(mocksFilePath)) {
+    const mocksFilePath = path32.resolve(options.mocksFile);
+    if (!fs30.existsSync(mocksFilePath)) {
       throw new Error(`Mocks file not found: ${mocksFilePath}`);
     }
     try {
-      const content = fs29.readFileSync(mocksFilePath, "utf8");
+      const content = fs30.readFileSync(mocksFilePath, "utf8");
       mocks = JSON.parse(content);
     } catch {
       throw new Error(`Failed to parse mocks file: ${options.mocksFile}`);
@@ -92481,7 +92854,7 @@ async function validateMockConfig(mocks, filePath, workflowName) {
   }
 }
 function promptForInput(question) {
-  return new Promise((resolve28) => {
+  return new Promise((resolve31) => {
     const rl = readline9.createInterface({
       input: process.stdin,
       output: process.stderr
@@ -92489,18 +92862,18 @@ function promptForInput(question) {
     });
     rl.question(question, (answer) => {
       rl.close();
-      resolve28(answer.trim());
+      resolve31(answer.trim());
     });
   });
 }
 // src/cli/commands/serve.ts
-import * as path32 from "path";
-import * as fs31 from "fs";
+import * as path33 from "path";
+import * as fs32 from "fs";
 // src/server/workflow-registry.ts
 init_esm5();
-import * as fs30 from "fs";
+import * as fs31 from "fs";
 var WorkflowRegistry = class {
   constructor(workflowDir, options = {}) {
     this.workflowDir = workflowDir;
@@ -92535,7 +92908,7 @@ var WorkflowRegistry = class {
     this.endpoints.clear();
     for (const file of files) {
       try {
-        const content = fs30.readFileSync(file, "utf8");
+        const content = fs31.readFileSync(file, "utf8");
         if (!content.includes("@flowWeaver")) {
           continue;
         }
@@ -92927,11 +93300,11 @@ var WebhookServer = class {
 // src/cli/commands/serve.ts
 async function serveCommand(dir, options) {
-  const workflowDir = path32.resolve(dir || ".");
-  if (!fs31.existsSync(workflowDir)) {
+  const workflowDir = path33.resolve(dir || ".");
+  if (!fs32.existsSync(workflowDir)) {
     throw new Error(`Directory not found: ${workflowDir}`);
   }
-  if (!fs31.statSync(workflowDir).isDirectory()) {
+  if (!fs32.statSync(workflowDir).isDirectory()) {
     throw new Error(`Not a directory: ${workflowDir}`);
   }
   const port = options.port ?? 3e3;
@@ -92974,8 +93347,8 @@ async function serveCommand(dir, options) {
 }
 // src/export/index.ts
-import * as path33 from "path";
-import * as fs32 from "fs";
+import * as path34 from "path";
+import * as fs33 from "fs";
 import * as os2 from "os";
 import { fileURLToPath as fileURLToPath5 } from "url";
@@ -93150,12 +93523,12 @@ Outputs:
 // src/export/index.ts
 var __filename = fileURLToPath5(import.meta.url);
-var __dirname2 = path33.dirname(__filename);
+var __dirname2 = path34.dirname(__filename);
 async function exportMultiWorkflow(options) {
-  const inputPath = path33.resolve(options.input);
-  const outputDir = path33.resolve(options.output);
+  const inputPath = path34.resolve(options.input);
+  const outputDir = path34.resolve(options.output);
   const isDryRun = options.dryRun ?? false;
-  if (!fs32.existsSync(inputPath)) {
+  if (!fs33.existsSync(inputPath)) {
     throw new Error(`Input file not found: ${inputPath}`);
   }
   const parser3 = new AnnotationParser();
@@ -93173,22 +93546,22 @@ async function exportMultiWorkflow(options) {
       throw new Error(`None of the requested workflows found. Available: ${available}`);
     }
   }
-  const workDir = isDryRun ? path33.join(os2.tmpdir(), `fw-export-multi-dryrun-${Date.now()}`) : outputDir;
-  fs32.mkdirSync(workDir, { recursive: true });
-  fs32.mkdirSync(path33.join(workDir, "workflows"), { recursive: true });
-  fs32.mkdirSync(path33.join(workDir, "runtime"), { recursive: true });
+  const workDir = isDryRun ? path34.join(os2.tmpdir(), `fw-export-multi-dryrun-${Date.now()}`) : outputDir;
+  fs33.mkdirSync(workDir, { recursive: true });
+  fs33.mkdirSync(path34.join(workDir, "workflows"), { recursive: true });
+  fs33.mkdirSync(path34.join(workDir, "runtime"), { recursive: true });
   const compiledWorkflows = [];
   try {
     for (const workflow of selectedWorkflows) {
-      const workflowOutputPath = path33.join(workDir, "workflows", `${workflow.name}.ts`);
-      fs32.copyFileSync(inputPath, workflowOutputPath);
+      const workflowOutputPath = path34.join(workDir, "workflows", `${workflow.name}.ts`);
+      fs33.copyFileSync(inputPath, workflowOutputPath);
       await compileWorkflow(workflowOutputPath, {
         write: true,
         inPlace: true,
         parse: { workflowName: workflow.functionName },
         generate: { production: options.production ?? true }
       });
-      const compiledCode = fs32.readFileSync(workflowOutputPath, "utf8");
+      const compiledCode = fs33.readFileSync(workflowOutputPath, "utf8");
       compiledWorkflows.push({
         name: workflow.name,
         functionName: workflow.functionName,
@@ -93196,24 +93569,24 @@ async function exportMultiWorkflow(options) {
         code: compiledCode
       });
     }
-    const runtimeDir = path33.join(workDir, "runtime");
-    const libraryRuntimeDir = path33.resolve(__dirname2, "../runtime");
+    const runtimeDir = path34.join(workDir, "runtime");
+    const libraryRuntimeDir = path34.resolve(__dirname2, "../runtime");
     const runtimeFiles = ["function-registry.ts", "parameter-resolver.ts", "builtin-functions.ts"];
     for (const file of runtimeFiles) {
-      const srcPath = path33.join(libraryRuntimeDir, file);
-      const destPath = path33.join(runtimeDir, file);
-      if (fs32.existsSync(srcPath)) {
-        fs32.copyFileSync(srcPath, destPath);
+      const srcPath = path34.join(libraryRuntimeDir, file);
+      const destPath = path34.join(runtimeDir, file);
+      if (fs33.existsSync(srcPath)) {
+        fs33.copyFileSync(srcPath, destPath);
       }
     }
     const result = generateMultiHandler(options.target, compiledWorkflows, workDir, options);
     if (!isDryRun) {
       for (const file of result.files) {
-        const dirPath = path33.dirname(file.path);
-        if (!fs32.existsSync(dirPath)) {
-          fs32.mkdirSync(dirPath, { recursive: true });
+        const dirPath = path34.dirname(file.path);
+        if (!fs33.existsSync(dirPath)) {
+          fs33.mkdirSync(dirPath, { recursive: true });
         }
-        fs32.writeFileSync(file.path, file.content);
+        fs33.writeFileSync(file.path, file.content);
       }
     }
     return {
@@ -93226,7 +93599,7 @@ async function exportMultiWorkflow(options) {
   } finally {
     if (isDryRun) {
       try {
-        fs32.rmSync(workDir, { recursive: true, force: true });
+        fs33.rmSync(workDir, { recursive: true, force: true });
       } catch {
       }
     }
@@ -93234,28 +93607,28 @@ async function exportMultiWorkflow(options) {
 }
 function generateMultiHandler(target, workflows, outputDir, options) {
   const files = [];
-  const serviceName = path33.basename(options.input, path33.extname(options.input)) + "-service";
+  const serviceName = path34.basename(options.input, path34.extname(options.input)) + "-service";
   const workflowImports = workflows.map((w) => `import { ${w.functionName} } from './workflows/${w.name}.js';`).join("\n");
   const workflowEntries = workflows.map((w) => `  '${w.name}': ${w.functionName},`).join("\n");
   const openApiSpec = generateMultiWorkflowOpenAPI(workflows, serviceName);
   switch (target) {
     case "lambda":
       files.push({
-        path: path33.join(outputDir, "handler.ts"),
+        path: path34.join(outputDir, "handler.ts"),
         content: generateLambdaMultiHandler(workflowImports, workflowEntries, serviceName)
       });
       files.push({
-        path: path33.join(outputDir, "openapi.ts"),
+        path: path34.join(outputDir, "openapi.ts"),
         content: `// Generated OpenAPI specification
 export const openApiSpec = ${JSON.stringify(openApiSpec, null, 2)};
 `
       });
       files.push({
-        path: path33.join(outputDir, "template.yaml"),
+        path: path34.join(outputDir, "template.yaml"),
         content: generateLambdaSAMMultiTemplate(serviceName, workflows.length)
       });
       files.push({
-        path: path33.join(outputDir, "package.json"),
+        path: path34.join(outputDir, "package.json"),
         content: JSON.stringify(
           {
             name: `fw-${serviceName}`,
@@ -93276,7 +93649,7 @@ export const openApiSpec = ${JSON.stringify(openApiSpec, null, 2)};
         )
       });
       files.push({
-        path: path33.join(outputDir, "tsconfig.json"),
+        path: path34.join(outputDir, "tsconfig.json"),
         content: JSON.stringify(
           {
             compilerOptions: {
@@ -93297,17 +93670,17 @@ export const openApiSpec = ${JSON.stringify(openApiSpec, null, 2)};
       break;
     case "vercel":
       files.push({
-        path: path33.join(outputDir, "api", "[workflow].ts"),
+        path: path34.join(outputDir, "api", "[workflow].ts"),
         content: generateVercelMultiHandler(workflowImports, workflowEntries, serviceName)
       });
       files.push({
-        path: path33.join(outputDir, "openapi.ts"),
+        path: path34.join(outputDir, "openapi.ts"),
         content: `// Generated OpenAPI specification
 export const openApiSpec = ${JSON.stringify(openApiSpec, null, 2)};
 `
       });
       files.push({
-        path: path33.join(outputDir, "vercel.json"),
+        path: path34.join(outputDir, "vercel.json"),
         content: JSON.stringify(
           {
             functions: {
@@ -93324,17 +93697,17 @@ export const openApiSpec = ${JSON.stringify(openApiSpec, null, 2)};
       break;
     case "cloudflare":
       files.push({
-        path: path33.join(outputDir, "index.ts"),
+        path: path34.join(outputDir, "index.ts"),
         content: generateCloudflareMultiHandler(workflowImports, workflowEntries, serviceName)
       });
       files.push({
-        path: path33.join(outputDir, "openapi.ts"),
+        path: path34.join(outputDir, "openapi.ts"),
         content: `// Generated OpenAPI specification
 export const openApiSpec = ${JSON.stringify(openApiSpec, null, 2)};
 `
       });
       files.push({
-        path: path33.join(outputDir, "wrangler.toml"),
+        path: path34.join(outputDir, "wrangler.toml"),
         content: `name = "${serviceName}"
 main = "dist/index.js"
 compatibility_date = "2024-01-01"
@@ -93344,7 +93717,7 @@ command = "npm run build"
 `
       });
       files.push({
-        path: path33.join(outputDir, "package.json"),
+        path: path34.join(outputDir, "package.json"),
         content: JSON.stringify(
           {
             name: `fw-${serviceName}`,
@@ -93366,7 +93739,7 @@ command = "npm run build"
         )
       });
       files.push({
-        path: path33.join(outputDir, "tsconfig.json"),
+        path: path34.join(outputDir, "tsconfig.json"),
         content: JSON.stringify(
           {
             compilerOptions: {
@@ -93387,17 +93760,17 @@ command = "npm run build"
       break;
     case "inngest":
       files.push({
-        path: path33.join(outputDir, "handler.ts"),
+        path: path34.join(outputDir, "handler.ts"),
         content: generateInngestMultiHandler(workflowImports, workflowEntries, serviceName, workflows)
       });
       files.push({
-        path: path33.join(outputDir, "openapi.ts"),
+        path: path34.join(outputDir, "openapi.ts"),
         content: `// Generated OpenAPI specification
 export const openApiSpec = ${JSON.stringify(openApiSpec, null, 2)};
 `
       });
       files.push({
-        path: path33.join(outputDir, "package.json"),
+        path: path34.join(outputDir, "package.json"),
         content: JSON.stringify(
           {
             name: `fw-${serviceName}`,
@@ -93423,7 +93796,7 @@ export const openApiSpec = ${JSON.stringify(openApiSpec, null, 2)};
         )
       });
       files.push({
-        path: path33.join(outputDir, "tsconfig.json"),
+        path: path34.join(outputDir, "tsconfig.json"),
         content: JSON.stringify(
           {
             compilerOptions: {
@@ -93879,10 +94252,10 @@ async function exportWorkflow(options) {
   if (options.multi) {
     return exportMultiWorkflow(options);
   }
-  const inputPath = path33.resolve(options.input);
-  const outputDir = path33.resolve(options.output);
+  const inputPath = path34.resolve(options.input);
+  const outputDir = path34.resolve(options.output);
   const isDryRun = options.dryRun ?? false;
-  if (!fs32.existsSync(inputPath)) {
+  if (!fs33.existsSync(inputPath)) {
     throw new Error(`Input file not found: ${inputPath}`);
   }
   const parser3 = new AnnotationParser();
@@ -93897,8 +94270,8 @@ async function exportWorkflow(options) {
     const available = parseResult.workflows.map((w) => w.name).join(", ");
     throw new Error(`Workflow "${options.workflow}" not found. Available: ${available}`);
   }
-  const workDir = isDryRun ? path33.join(os2.tmpdir(), `fw-export-dryrun-${Date.now()}`) : outputDir;
-  fs32.mkdirSync(workDir, { recursive: true });
+  const workDir = isDryRun ? path34.join(os2.tmpdir(), `fw-export-dryrun-${Date.now()}`) : outputDir;
+  fs33.mkdirSync(workDir, { recursive: true });
   let compiledContent;
   let compiledPath;
   try {
@@ -93908,11 +94281,11 @@ async function exportWorkflow(options) {
       workDir,
       options.production
     );
-    compiledContent = fs32.readFileSync(compiledPath, "utf8");
+    compiledContent = fs33.readFileSync(compiledPath, "utf8");
   } finally {
     if (isDryRun) {
       try {
-        fs32.rmSync(workDir, { recursive: true, force: true });
+        fs33.rmSync(workDir, { recursive: true, force: true });
       } catch {
       }
     }
@@ -93927,8 +94300,8 @@ async function exportWorkflow(options) {
     handler = generateHandler(options.target, compiledPath, workflow.functionName);
   }
   const handlerFileName = getHandlerFileName(options.target, workflow.name);
-  const handlerPath = path33.join(outputDir, handlerFileName);
-  const workflowOutputPath = path33.join(outputDir, "workflow.ts");
+  const handlerPath = path34.join(outputDir, handlerFileName);
+  const workflowOutputPath = path34.join(outputDir, "workflow.ts");
   const configFiles = generateConfigFiles(
     options.target,
     workflow.name,
@@ -93936,16 +94309,16 @@ async function exportWorkflow(options) {
     workflow.description
   );
   if (!isDryRun) {
-    fs32.mkdirSync(outputDir, { recursive: true });
-    const handlerDir = path33.dirname(handlerPath);
-    if (!fs32.existsSync(handlerDir)) {
-      fs32.mkdirSync(handlerDir, { recursive: true });
+    fs33.mkdirSync(outputDir, { recursive: true });
+    const handlerDir = path34.dirname(handlerPath);
+    if (!fs33.existsSync(handlerDir)) {
+      fs33.mkdirSync(handlerDir, { recursive: true });
     }
-    fs32.writeFileSync(handlerPath, handler);
+    fs33.writeFileSync(handlerPath, handler);
     for (const file of configFiles) {
-      fs32.writeFileSync(file.path, file.content);
+      fs33.writeFileSync(file.path, file.content);
     }
-    fs32.writeFileSync(workflowOutputPath, compiledContent);
+    fs33.writeFileSync(workflowOutputPath, compiledContent);
   }
   const files = [
     { path: handlerPath, content: handler },
@@ -93960,8 +94333,8 @@ async function exportWorkflow(options) {
   };
 }
 async function compileToOutput(inputPath, functionName, outputDir, production) {
-  const outputPath = path33.join(outputDir, "workflow.ts");
-  fs32.copyFileSync(inputPath, outputPath);
+  const outputPath = path34.join(outputDir, "workflow.ts");
+  fs33.copyFileSync(inputPath, outputPath);
   await compileWorkflow(outputPath, {
     write: true,
     inPlace: true,
@@ -93972,7 +94345,7 @@ async function compileToOutput(inputPath, functionName, outputDir, production) {
 }
 function generateHandler(target, workflowPath, functionName) {
   const template = getTemplate(target);
-  const relativePath = target === "vercel" ? `../${path33.basename(workflowPath).replace(".ts", ".js")}` : `./${path33.basename(workflowPath).replace(".ts", ".js")}`;
+  const relativePath = target === "vercel" ? `../${path34.basename(workflowPath).replace(".ts", ".js")}` : `./${path34.basename(workflowPath).replace(".ts", ".js")}`;
   return template.replace("{{GENERATED_HEADER}}", getGeneratedBranding().header(`export --target ${target}`)).replace("{{WORKFLOW_IMPORT}}", `import { ${functionName} } from '${relativePath}';`).replace(/\{\{FUNCTION_NAME\}\}/g, functionName).replace("{{MAX_DURATION}}", "60");
 }
 function getTemplate(target) {
@@ -94004,14 +94377,14 @@ function generateConfigFiles(target, workflowName, outputDir, description) {
   switch (target) {
     case "lambda":
       files.push({
-        path: path33.join(outputDir, "template.yaml"),
+        path: path34.join(outputDir, "template.yaml"),
         content: SAM_TEMPLATE2.replace(/\{\{WORKFLOW_NAME\}\}/g, workflowName).replace(
           "{{WORKFLOW_DESCRIPTION}}",
           description || `Flow Weaver workflow: ${workflowName}`
         ).replace(/\{\{WORKFLOW_PATH\}\}/g, workflowName)
       });
       files.push({
-        path: path33.join(outputDir, "package.json"),
+        path: path34.join(outputDir, "package.json"),
         content: JSON.stringify(
           {
             name: `fw-${workflowName}`,
@@ -94032,7 +94405,7 @@ function generateConfigFiles(target, workflowName, outputDir, description) {
         )
       });
       files.push({
-        path: path33.join(outputDir, "tsconfig.json"),
+        path: path34.join(outputDir, "tsconfig.json"),
         content: JSON.stringify(
           {
             compilerOptions: {
@@ -94053,7 +94426,7 @@ function generateConfigFiles(target, workflowName, outputDir, description) {
       break;
     case "vercel":
       files.push({
-        path: path33.join(outputDir, "vercel.json"),
+        path: path34.join(outputDir, "vercel.json"),
         content: JSON.stringify(
           {
             functions: {
@@ -94070,7 +94443,7 @@ function generateConfigFiles(target, workflowName, outputDir, description) {
       break;
     case "cloudflare":
       files.push({
-        path: path33.join(outputDir, "wrangler.toml"),
+        path: path34.join(outputDir, "wrangler.toml"),
         content: `name = "${workflowName}"
 main = "dist/index.js"
 compatibility_date = "2024-01-01"
@@ -94080,7 +94453,7 @@ command = "npm run build"
 `
       });
       files.push({
-        path: path33.join(outputDir, "package.json"),
+        path: path34.join(outputDir, "package.json"),
         content: JSON.stringify(
           {
             name: `fw-${workflowName}`,
@@ -94102,7 +94475,7 @@ command = "npm run build"
         )
       });
       files.push({
-        path: path33.join(outputDir, "tsconfig.json"),
+        path: path34.join(outputDir, "tsconfig.json"),
         content: JSON.stringify(
           {
             compilerOptions: {
@@ -94123,7 +94496,7 @@ command = "npm run build"
       break;
     case "inngest":
       files.push({
-        path: path33.join(outputDir, "package.json"),
+        path: path34.join(outputDir, "package.json"),
         content: JSON.stringify(
           {
             name: `fw-${workflowName}`,
@@ -94147,7 +94520,7 @@ command = "npm run build"
         )
       });
       files.push({
-        path: path33.join(outputDir, "tsconfig.json"),
+        path: path34.join(outputDir, "tsconfig.json"),
         content: JSON.stringify(
           {
             compilerOptions: {
@@ -94299,14 +94672,14 @@ async function exportCommand(input, options) {
 }
 // src/cli/commands/openapi.ts
-import * as path34 from "path";
-import * as fs33 from "fs";
+import * as path35 from "path";
+import * as fs34 from "fs";
 async function openapiCommand(dir, options) {
-  const workflowDir = path34.resolve(dir);
-  if (!fs33.existsSync(workflowDir)) {
+  const workflowDir = path35.resolve(dir);
+  if (!fs34.existsSync(workflowDir)) {
     throw new Error(`Directory not found: ${workflowDir}`);
   }
-  if (!fs33.statSync(workflowDir).isDirectory()) {
+  if (!fs34.statSync(workflowDir).isDirectory()) {
     throw new Error(`Not a directory: ${workflowDir}`);
   }
   const registry2 = new WorkflowRegistry(workflowDir);
@@ -94325,8 +94698,8 @@ async function openapiCommand(dir, options) {
   const format = options.format || "json";
   const spec = format === "yaml" ? generateOpenAPIYaml(endpoints, generatorOptions) : generateOpenAPIJson(endpoints, generatorOptions);
   if (options.output) {
-    const outputPath = path34.resolve(options.output);
-    fs33.writeFileSync(outputPath, spec);
+    const outputPath = path35.resolve(options.output);
+    fs34.writeFileSync(outputPath, spec);
     logger.success(`OpenAPI specification written to ${outputPath}`);
   } else {
     process.stdout.write(spec + "\n");
@@ -94334,8 +94707,8 @@ async function openapiCommand(dir, options) {
 }
 // src/cli/commands/plugin.ts
-import * as fs34 from "fs";
-import * as path35 from "path";
+import * as fs35 from "fs";
+import * as path36 from "path";
 var PLUGIN_NAME_RE = /^[a-zA-Z0-9][-a-zA-Z0-9_.]*$/;
 var VALID_AREAS = ["sidebar", "main", "toolbar", "modal", "panel"];
 function validatePluginName(name) {
@@ -94462,18 +94835,18 @@ async function pluginInitCommand(name, options) {
     }
     return;
   }
-  const targetDir = path35.resolve("plugins", name);
+  const targetDir = path36.resolve("plugins", name);
   const filesCreated = [];
   const filesSkipped = [];
   for (const [relativePath, content] of Object.entries(files)) {
-    const absPath = path35.join(targetDir, relativePath);
-    const dir = path35.dirname(absPath);
-    fs34.mkdirSync(dir, { recursive: true });
-    if (fs34.existsSync(absPath) && !force) {
+    const absPath = path36.join(targetDir, relativePath);
+    const dir = path36.dirname(absPath);
+    fs35.mkdirSync(dir, { recursive: true });
+    if (fs35.existsSync(absPath) && !force) {
       filesSkipped.push(relativePath);
       continue;
     }
-    fs34.writeFileSync(absPath, content, "utf8");
+    fs35.writeFileSync(absPath, content, "utf8");
     filesCreated.push(relativePath);
   }
   logger.section("Plugin scaffolded");
@@ -94492,8 +94865,8 @@ async function pluginInitCommand(name, options) {
 // src/cli/commands/migrate.ts
 init_esm5();
-import * as fs35 from "fs";
-import * as path36 from "path";
+import * as fs36 from "fs";
+import * as path37 from "path";
 async function migrateCommand(globPattern, options = {}) {
   const { dryRun = false, diff = false } = options;
   const files = globSync(globPattern, { ignore: ["**/node_modules/**", "**/*.generated.ts"] });
@@ -94509,9 +94882,9 @@ async function migrateCommand(globPattern, options = {}) {
   let skippedCount = 0;
   let errorCount = 0;
   for (const file of files) {
-    const filePath = path36.resolve(file);
+    const filePath = path37.resolve(file);
     try {
-      const sourceCode = fs35.readFileSync(filePath, "utf8");
+      const sourceCode = fs36.readFileSync(filePath, "utf8");
       const parseResult = await parseWorkflow(filePath);
       if (parseResult.errors.length > 0) {
         logger.error(`  ${file}: parse errors \u2014 skipping`);
@@ -94544,7 +94917,7 @@ ${file}:`);
         migratedCount++;
         continue;
       }
-      fs35.writeFileSync(filePath, genResult.code, "utf8");
+      fs36.writeFileSync(filePath, genResult.code, "utf8");
       logger.success(`  ${file}: migrated`);
       migratedCount++;
     } catch (error2) {
@@ -94676,21 +95049,21 @@ async function changelogCommand(options = {}) {
 // src/cli/commands/strip.ts
 init_esm5();
-import * as fs36 from "fs";
-import * as path37 from "path";
+import * as fs37 from "fs";
+import * as path38 from "path";
 async function stripCommand(input, options = {}) {
   const { output, dryRun = false, verbose = false } = options;
   let pattern = input;
   try {
-    if (fs36.existsSync(input) && fs36.statSync(input).isDirectory()) {
-      pattern = path37.join(input, "**/*.ts");
+    if (fs37.existsSync(input) && fs37.statSync(input).isDirectory()) {
+      pattern = path38.join(input, "**/*.ts");
     }
   } catch {
   }
   const allFiles = await glob(pattern, { absolute: true });
   const files = allFiles.filter((f) => {
     try {
-      return fs36.statSync(f).isFile();
+      return fs37.statSync(f).isFile();
     } catch {
       return false;
     }
@@ -94702,28 +95075,28 @@ async function stripCommand(input, options = {}) {
   let stripped = 0;
   let skipped = 0;
   for (const filePath of files) {
-    const content = fs36.readFileSync(filePath, "utf-8");
+    const content = fs37.readFileSync(filePath, "utf-8");
     if (!hasInPlaceMarkers(content)) {
       skipped++;
       if (verbose) {
-        logger.info(`Skipped (no markers): ${path37.relative(process.cwd(), filePath)}`);
+        logger.info(`Skipped (no markers): ${path38.relative(process.cwd(), filePath)}`);
       }
       continue;
     }
     const result = stripGeneratedSections(content);
     if (dryRun) {
-      logger.info(`Would strip: ${path37.relative(process.cwd(), filePath)}`);
+      logger.info(`Would strip: ${path38.relative(process.cwd(), filePath)}`);
       stripped++;
       continue;
     }
-    const outPath = output ? path37.join(path37.resolve(output), path37.basename(filePath)) : filePath;
+    const outPath = output ? path38.join(path38.resolve(output), path38.basename(filePath)) : filePath;
     if (output) {
-      fs36.mkdirSync(path37.dirname(outPath), { recursive: true });
+      fs37.mkdirSync(path38.dirname(outPath), { recursive: true });
     }
-    fs36.writeFileSync(outPath, result);
+    fs37.writeFileSync(outPath, result);
     stripped++;
     if (verbose) {
-      logger.success(`Stripped: ${path37.relative(process.cwd(), outPath)}`);
+      logger.success(`Stripped: ${path38.relative(process.cwd(), outPath)}`);
     }
   }
   logger.success(`${stripped} file${stripped !== 1 ? "s" : ""} stripped, ${skipped} skipped`);
@@ -94802,9 +95175,188 @@ async function docsSearchCommand(query, options) {
   logger.newline();
 }
+// src/cli/commands/status.ts
+import * as fs38 from "fs";
+import * as path39 from "path";
+init_validator();
+function formatPortList(ports) {
+  return Object.entries(ports).filter(([name]) => name !== "execute" && name !== "onSuccess" && name !== "onFailure").map(([name, port]) => `${name}(${port.dataType.toLowerCase()})`);
+}
+async function statusCommand(input, options = {}) {
+  const { workflowName, json: json2 = false } = options;
+  try {
+    const filePath = path39.resolve(input);
+    if (!fs38.existsSync(filePath)) {
+      if (json2) {
+        console.log(JSON.stringify({ error: `File not found: ${input}` }));
+      } else {
+        logger.error(`File not found: ${input}`);
+      }
+      process.exit(1);
+    }
+    const parseResult = await parseWorkflow(filePath, { workflowName });
+    if (parseResult.errors.length > 0) {
+      if (json2) {
+        console.log(JSON.stringify({ error: `Parse errors: ${parseResult.errors.join(", ")}` }));
+      } else {
+        logger.error("Parse errors:");
+        parseResult.errors.forEach((e) => logger.error(`  ${e}`));
+      }
+      process.exit(1);
+    }
+    const ast = parseResult.ast;
+    const instanceTypeMap = /* @__PURE__ */ new Map();
+    for (const nt of ast.nodeTypes) {
+      instanceTypeMap.set(nt.name, nt);
+      if (nt.functionName !== nt.name) {
+        instanceTypeMap.set(nt.functionName, nt);
+      }
+    }
+    const nodes = [];
+    const seen = /* @__PURE__ */ new Set();
+    for (const instance of ast.instances) {
+      const nt = instanceTypeMap.get(instance.nodeType);
+      if (!nt || seen.has(nt.functionName)) continue;
+      seen.add(nt.functionName);
+      nodes.push({
+        name: nt.functionName,
+        status: nt.variant === "STUB" ? "STUB" : "OK",
+        inputs: formatPortList(nt.inputs),
+        outputs: formatPortList(nt.outputs)
+      });
+    }
+    const implemented = nodes.filter((n) => n.status === "OK").length;
+    const total = nodes.length;
+    const validation = validator.validate(ast, { mode: "draft" });
+    const structuralErrors = validation.errors.filter((e) => e.code !== "STUB_NODE").map((e) => e.message);
+    const result = {
+      name: ast.name,
+      implemented,
+      total,
+      nodes,
+      structurallyValid: structuralErrors.length === 0,
+      structuralErrors
+    };
+    if (json2) {
+      console.log(JSON.stringify(result, null, 2));
+    } else {
+      logger.section(`${ast.name}: ${implemented}/${total} nodes implemented`);
+      logger.newline();
+      const maxNameLen = Math.max(...nodes.map((n) => n.name.length), 0);
+      for (const node of nodes) {
+        const tag = node.status === "STUB" ? "[STUB]" : "[OK]  ";
+        const paddedName = node.name.padEnd(maxNameLen);
+        const inputStr = node.inputs.length > 0 ? `inputs: ${node.inputs.join(", ")}` : "";
+        const outputStr = node.outputs.length > 0 ? `outputs: ${node.outputs.join(", ")}` : "";
+        const arrow = inputStr && outputStr ? " \u2192 " : "";
+        const portsStr = `${inputStr}${arrow}${outputStr}`;
+        if (node.status === "STUB") {
+          logger.warn(`  ${paddedName}  ${tag}  ${portsStr}`);
+        } else {
+          logger.success(`  ${paddedName}  ${tag}  ${portsStr}`);
+        }
+      }
+      if (structuralErrors.length > 0) {
+        logger.newline();
+        logger.error(`Structural errors (${structuralErrors.length}):`);
+        structuralErrors.forEach((e) => logger.error(`  - ${e}`));
+      } else {
+        logger.newline();
+        logger.success("Graph structure is valid.");
+      }
+    }
+  } catch (error2) {
+    if (json2) {
+      console.log(JSON.stringify({ error: getErrorMessage(error2) }));
+    } else {
+      logger.error(`Status failed: ${getErrorMessage(error2)}`);
+    }
+    process.exit(1);
+  }
+}
+// src/cli/commands/implement.ts
+import * as fs39 from "fs";
+import * as path40 from "path";
+function findDeclareFunction2(source, functionName) {
+  const lines = source.split("\n");
+  const escaped = functionName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const startPattern = new RegExp(`^(\\s*)declare\\s+function\\s+${escaped}\\s*\\(`);
+  for (let i = 0; i < lines.length; i++) {
+    const m = lines[i].match(startPattern);
+    if (!m) continue;
+    const indent = m[1] || "";
+    let accumulated = lines[i];
+    let j = i;
+    while (!accumulated.trimEnd().endsWith(";") && j < lines.length - 1) {
+      j++;
+      accumulated += "\n" + lines[j];
+    }
+    return { match: accumulated, indent };
+  }
+  return null;
+}
+async function implementCommand(input, nodeName, options = {}) {
+  const { workflowName, preview = false } = options;
+  try {
+    const filePath = path40.resolve(input);
+    if (!fs39.existsSync(filePath)) {
+      logger.error(`File not found: ${input}`);
+      process.exit(1);
+    }
+    const parseResult = await parseWorkflow(filePath, { workflowName });
+    if (parseResult.errors.length > 0) {
+      logger.error("Parse errors:");
+      parseResult.errors.forEach((e) => logger.error(`  ${e}`));
+      process.exit(1);
+    }
+    const ast = parseResult.ast;
+    const stubNodeType = ast.nodeTypes.find(
+      (nt) => nt.variant === "STUB" && (nt.functionName === nodeName || nt.name === nodeName)
+    );
+    if (!stubNodeType) {
+      const existingNt = ast.nodeTypes.find(
+        (nt) => nt.functionName === nodeName || nt.name === nodeName
+      );
+      if (existingNt) {
+        logger.warn(`Node "${nodeName}" is already implemented.`);
+        process.exit(0);
+      }
+      const available = ast.nodeTypes.filter((nt) => nt.variant === "STUB").map((nt) => nt.functionName);
+      if (available.length === 0) {
+        logger.error("No stub nodes found in this workflow.");
+      } else {
+        logger.error(`Stub node "${nodeName}" not found. Available stubs: ${available.join(", ")}`);
+      }
+      process.exit(1);
+    }
+    const source = fs39.readFileSync(filePath, "utf8");
+    const found = findDeclareFunction2(source, stubNodeType.functionName);
+    if (!found) {
+      logger.error(`Could not find "declare function ${stubNodeType.functionName}" in source file.`);
+      process.exit(1);
+    }
+    const implementedType = { ...stubNodeType, variant: "FUNCTION" };
+    const signatureLines = generateFunctionSignature(implementedType);
+    const replacement = signatureLines.map((line) => found.indent + line).join("\n");
+    if (preview) {
+      logger.section(`Preview: ${stubNodeType.functionName}`);
+      logger.newline();
+      console.log(replacement);
+    } else {
+      const updated = source.replace(found.match, replacement);
+      fs39.writeFileSync(filePath, updated, "utf8");
+      logger.success(`Implemented ${stubNodeType.functionName} in ${path40.basename(filePath)}`);
+    }
+  } catch (error2) {
+    logger.error(`Implement failed: ${getErrorMessage(error2)}`);
+    process.exit(1);
+  }
+}
 // src/cli/commands/market.ts
-import * as fs37 from "fs";
-import * as path38 from "path";
+import * as fs40 from "fs";
+import * as path41 from "path";
 import { execSync as execSync6 } from "child_process";
 async function marketInitCommand(name, options = {}) {
   if (!name.startsWith("flowweaver-pack-")) {
@@ -94812,11 +95364,11 @@ async function marketInitCommand(name, options = {}) {
     logger.warn(`Name should follow "flowweaver-pack-*" convention, using "${suggested}"`);
     name = suggested;
   }
-  const targetDir = path38.resolve(name);
-  if (fs37.existsSync(targetDir)) {
-    const stat = fs37.statSync(targetDir);
+  const targetDir = path41.resolve(name);
+  if (fs40.existsSync(targetDir)) {
+    const stat = fs40.statSync(targetDir);
     if (stat.isDirectory()) {
-      const contents = fs37.readdirSync(targetDir);
+      const contents = fs40.readdirSync(targetDir);
       if (contents.length > 0) {
         logger.error(`Directory "${name}" already exists and is not empty`);
         process.exit(1);
@@ -94831,13 +95383,13 @@ async function marketInitCommand(name, options = {}) {
   logger.newline();
   const dirs = [
     targetDir,
-    path38.join(targetDir, "src"),
-    path38.join(targetDir, "src", "node-types"),
-    path38.join(targetDir, "src", "workflows"),
-    path38.join(targetDir, "src", "patterns")
+    path41.join(targetDir, "src"),
+    path41.join(targetDir, "src", "node-types"),
+    path41.join(targetDir, "src", "workflows"),
+    path41.join(targetDir, "src", "patterns")
   ];
   for (const dir of dirs) {
-    fs37.mkdirSync(dir, { recursive: true });
+    fs40.mkdirSync(dir, { recursive: true });
   }
   const shortName = name.replace(/^flowweaver-pack-/, "");
   const pkg = {
@@ -94868,8 +95420,8 @@ async function marketInitCommand(name, options = {}) {
     },
     files: ["dist", "flowweaver.manifest.json", "README.md", "LICENSE"]
   };
-  fs37.writeFileSync(
-    path38.join(targetDir, "package.json"),
+  fs40.writeFileSync(
+    path41.join(targetDir, "package.json"),
     JSON.stringify(pkg, null, 2) + "\n"
   );
   const tsconfig = {
@@ -94887,8 +95439,8 @@ async function marketInitCommand(name, options = {}) {
     include: ["src"],
     exclude: ["node_modules", "dist"]
   };
-  fs37.writeFileSync(
-    path38.join(targetDir, "tsconfig.json"),
+  fs40.writeFileSync(
+    path41.join(targetDir, "tsconfig.json"),
     JSON.stringify(tsconfig, null, 2) + "\n"
   );
   const sampleNodeType = `/**
@@ -94906,21 +95458,21 @@ export function sample(execute: () => void, data: string): { result: string } {
   return { result: data.toUpperCase() };
 }
 `;
-  fs37.writeFileSync(path38.join(targetDir, "src", "node-types", "sample.ts"), sampleNodeType);
-  fs37.writeFileSync(
-    path38.join(targetDir, "src", "node-types", "index.ts"),
+  fs40.writeFileSync(path41.join(targetDir, "src", "node-types", "sample.ts"), sampleNodeType);
+  fs40.writeFileSync(
+    path41.join(targetDir, "src", "node-types", "index.ts"),
     "export { sample } from './sample.js';\n"
   );
-  fs37.writeFileSync(
-    path38.join(targetDir, "src", "workflows", "index.ts"),
+  fs40.writeFileSync(
+    path41.join(targetDir, "src", "workflows", "index.ts"),
     "// Export workflows here\n"
   );
-  fs37.writeFileSync(
-    path38.join(targetDir, "src", "patterns", "index.ts"),
+  fs40.writeFileSync(
+    path41.join(targetDir, "src", "patterns", "index.ts"),
     "// Export patterns here\n"
   );
-  fs37.writeFileSync(
-    path38.join(targetDir, "src", "index.ts"),
+  fs40.writeFileSync(
+    path41.join(targetDir, "src", "index.ts"),
     [
       "export * from './node-types/index.js';",
       "export * from './workflows/index.js';",
@@ -94953,9 +95505,9 @@ npm run pack    # Generate flowweaver.manifest.json
 npm publish     # Publish to npm
 \`\`\`
 `;
-  fs37.writeFileSync(path38.join(targetDir, "README.md"), readme);
-  fs37.writeFileSync(
-    path38.join(targetDir, ".gitignore"),
+  fs40.writeFileSync(path41.join(targetDir, "README.md"), readme);
+  fs40.writeFileSync(
+    path41.join(targetDir, ".gitignore"),
     ["node_modules", "dist", "*.tgz", ""].join("\n")
   );
   logger.success("Created package.json");
@@ -94975,7 +95527,7 @@ npm publish     # Publish to npm
   logger.newline();
 }
 async function marketPackCommand(directory, options = {}) {
-  const dir = path38.resolve(directory ?? ".");
+  const dir = path41.resolve(directory ?? ".");
   const { json: json2 = false, verbose = false } = options;
   if (!json2) {
     logger.section("Packing Marketplace Package");
@@ -95014,21 +95566,21 @@ async function marketPackCommand(directory, options = {}) {
   }
   const outPath = writeManifest(dir, manifest);
   logger.newline();
-  logger.success(`Manifest written to ${path38.relative(dir, outPath)}`);
+  logger.success(`Manifest written to ${path41.relative(dir, outPath)}`);
   if (warnings.length > 0) {
     logger.warn(`${warnings.length} warning(s) \u2014 consider fixing before publishing`);
   }
   logger.newline();
 }
 async function marketPublishCommand(directory, options = {}) {
-  const dir = path38.resolve(directory ?? ".");
+  const dir = path41.resolve(directory ?? ".");
   const { dryRun = false, tag } = options;
   logger.section("Publishing Marketplace Package");
   await marketPackCommand(dir, { json: false });
-  if (!fs37.existsSync(path38.join(dir, "LICENSE"))) {
+  if (!fs40.existsSync(path41.join(dir, "LICENSE"))) {
     logger.warn("LICENSE file not found \u2014 consider adding one");
   }
-  const pkg = JSON.parse(fs37.readFileSync(path38.join(dir, "package.json"), "utf-8"));
+  const pkg = JSON.parse(fs40.readFileSync(path41.join(dir, "package.json"), "utf-8"));
   logger.info(`Publishing ${pkg.name}@${pkg.version}`);
   const npmArgs = ["publish"];
   if (dryRun) npmArgs.push("--dry-run");
@@ -95063,7 +95615,7 @@ async function marketInstallCommand(packageSpec, options = {}) {
     process.exit(1);
   }
   const packageName = resolvePackageName2(packageSpec);
-  const manifest = readManifest(path38.join(process.cwd(), "node_modules", packageName));
+  const manifest = readManifest(path41.join(process.cwd(), "node_modules", packageName));
   if (json2) {
     console.log(JSON.stringify({
       success: true,
@@ -95147,7 +95699,7 @@ async function marketListCommand(options = {}) {
 }
 function resolvePackageName2(spec) {
   if (spec.endsWith(".tgz") || spec.endsWith(".tar.gz")) {
-    const base = path38.basename(spec, spec.endsWith(".tar.gz") ? ".tar.gz" : ".tgz");
+    const base = path41.basename(spec, spec.endsWith(".tar.gz") ? ".tar.gz" : ".tgz");
     const match2 = base.match(/^(.+)-\d+\.\d+\.\d+/);
     return match2 ? match2[1] : base;
   }
@@ -95196,7 +95748,7 @@ function displayInstalledPackage(pkg) {
 }
 // src/cli/index.ts
-var version2 = true ? "0.8.3" : "0.0.0-dev";
+var version2 = true ? "0.9.1" : "0.0.0-dev";
 var program2 = new Command();
 program2.name("flow-weaver").description("Flow Weaver Annotations - Compile and validate workflow files").version(version2, "-v, --version", "Output the current version");
 program2.configureOutput({
@@ -95465,6 +96017,22 @@ program2.command("migrate <glob>").description("Migrate workflow files to curren
     process.exit(1);
   }
 });
+program2.command("status <input>").description("Report implementation progress for stub workflows").option("-w, --workflow-name <name>", "Specific workflow name").option("--json", "Output as JSON", false).action(async (input, options) => {
+  try {
+    await statusCommand(input, options);
+  } catch (error2) {
+    logger.error(`Command failed: ${getErrorMessage(error2)}`);
+    process.exit(1);
+  }
+});
+program2.command("implement <input> <node>").description("Replace a stub node with a real function skeleton").option("-w, --workflow-name <name>", "Specific workflow name").option("-p, --preview", "Preview the generated code without writing", false).action(async (input, node, options) => {
+  try {
+    await implementCommand(input, node, options);
+  } catch (error2) {
+    logger.error(`Command failed: ${getErrorMessage(error2)}`);
+    process.exit(1);
+  }
+});
 program2.command("changelog").description("Generate changelog from git history, categorized by file path").option("--last-tag", "From last git tag to HEAD", false).option("--since <date>", 'Date-based range (e.g., "2024-01-01")').option("-r, --range <range>", 'Custom git range (e.g., "v0.1.0..HEAD")').action(async (options) => {
   try {
     await changelogCommand(options);