@synergenius/flow-weaver 0.20.2 → 0.20.4

package/dist/api/validate.js

@@ -38,6 +38,23 @@ export function validateWorkflow(ast, options) {
             }
         }
     }
+    // Filter warnings from additional rules through per-instance suppressWarnings
+    // (core validator already filters its own warnings, but agent/registry rules
+    // run after the core validator and need the same treatment)
+    const suppressMap = new Map();
+    for (const inst of ast.instances) {
+        if (inst.config?.suppressWarnings?.length) {
+            suppressMap.set(inst.id, new Set(inst.config.suppressWarnings));
+        }
+    }
+    if (suppressMap.size > 0) {
+        result.warnings = result.warnings.filter((w) => {
+            if (!w.node)
+                return true;
+            const codes = suppressMap.get(w.node);
+            return !codes || !codes.has(w.code);
+        });
+    }
     // Re-evaluate validity
     result.valid = result.errors.length === 0;
     return result;

package/dist/cli/flow-weaver.mjs

@@ -9671,7 +9671,7 @@ var VERSION;
 var init_generated_version = __esm({
   "src/generated-version.ts"() {
     "use strict";
-    VERSION = "0.20.2";
+    VERSION = "0.20.4";
   }
 });
 
@@ -34482,7 +34482,7 @@ var init_jsdoc_parser = __esm({
         } else if (func) {
           const returnType = func.getReturnType();
           const returnTypeText = returnType.getText();
-          const fieldMatch = returnTypeText.match(new RegExp(`${name}\\s*:\\s*([^;},]+)`));
+          const fieldMatch = returnTypeText.match(new RegExp(`${name}\\??\\s*:\\s*([^;},]+)`));
           if (fieldMatch) {
             type2 = inferDataTypeFromTS(fieldMatch[1].trim());
           } else {
@@ -34527,7 +34527,7 @@ var init_jsdoc_parser = __esm({
             const paramTypeText = paramType.getText();
             const isCatchAllRecord = /^Record<string,\s*(never|any|unknown)>$/.test(paramTypeText) || paramTypeText === "{}" || /^\{\s*\[[\w]+:\s*string\]:\s*(never|any|unknown);\s*\}$/.test(paramTypeText);
             if (!isCatchAllRecord) {
-              const fieldMatch = paramTypeText.match(new RegExp(`${name}\\s*:\\s*([^;},]+)`));
+              const fieldMatch = paramTypeText.match(new RegExp(`${name}\\??\\s*:\\s*([^;},]+)`));
               if (fieldMatch) {
                 type2 = inferDataTypeFromTS(fieldMatch[1].trim());
               } else {
@@ -39988,6 +39988,19 @@ function validateWorkflow(ast, options) {
       }
     }
   }
+  const suppressMap = /* @__PURE__ */ new Map();
+  for (const inst of ast.instances) {
+    if (inst.config?.suppressWarnings?.length) {
+      suppressMap.set(inst.id, new Set(inst.config.suppressWarnings));
+    }
+  }
+  if (suppressMap.size > 0) {
+    result.warnings = result.warnings.filter((w) => {
+      if (!w.node) return true;
+      const codes = suppressMap.get(w.node);
+      return !codes || !codes.has(w.code);
+    });
+  }
   result.valid = result.errors.length === 0;
   return result;
 }
@@ -46215,12 +46228,13 @@ function outputResult(data: any): { result: any } {
 
 /**
  * @flowWeaver workflow
- * @node validator validateData [position: -300 0]
- * @node transformer transformData [position: 0 0]
- * @node outputter outputResult [position: 300 0]
+ * @node validator validateData [position: -300 0] [color: "green"] [icon: "verified"] [suppress: "UNUSED_OUTPUT_PORT"]
+ * @node transformer transformData [position: 0 0] [color: "blue"] [icon: "sync"]
+ * @node outputter outputResult [position: 300 0] [color: "cyan"] [icon: "inventory"]
  * @position Start -600 0
  * @position Exit 600 0
  * @path Start -> validator -> transformer -> outputter -> Exit
+ * @connect outputter.result -> Exit.result
  * @connect validator.onFailure -> Exit.onFailure
  * @connect validator.error -> Exit.error
  * @param execute [order:0] - Execute
@@ -46260,9 +46274,11 @@ function ${name}(${inputPortName}: any): { ${outputPortName}: any } {
   });
   const spacing = 300;
   const startX = -(nodeNames.length * (spacing / 2) + spacing / 2);
+  const stepColors = ["green", "blue", "cyan", "orange", "purple", "teal", "pink", "yellow"];
   const nodeAnnotations = nodeNames.map((name, i) => {
     const x = startX + (i + 1) * spacing;
-    return ` * @node step${i} ${name} [position: ${x} 0]`;
+    const color = stepColors[i % stepColors.length];
+    return ` * @node step${i} ${name} [position: ${x} 0] [color: "${color}"] [icon: "settings"]`;
   }).join("\n");
   const positionAnnotations = [
     ` * @position Start ${startX} 0`,
@@ -46460,9 +46476,9 @@ function aggregateResults(
 
 /**
  * @flowWeaver workflow
- * @node iterator forEachItem [size: 300 200] [position: -90 0]
- * @node processor processItem iterator.processItem [position: 90 0]
- * @node aggregator aggregateResults [position: 270 0]
+ * @node iterator forEachItem [position: -90 0] [color: "purple"] [icon: "repeat"]
+ * @node processor processItem iterator.processItem [color: "blue"] [icon: "settings"]
+ * @node aggregator aggregateResults [position: 270 0] [color: "teal"] [icon: "inventory"]
  * @position Start -450 0
  * @position Exit 450 0
  * @connect Start.execute -> iterator.execute
@@ -46600,9 +46616,9 @@ function handleFailure(
 
 /**
  * @flowWeaver workflow
- * @node router evaluateCondition [position: -180 0]
- * @node successHandler handleSuccess [position: 90 -90]
- * @node failureHandler handleFailure [position: 90 90]
+ * @node router evaluateCondition [position: -180 0] [color: "orange"] [icon: "altRoute"] [suppress: "UNUSED_OUTPUT_PORT"]
+ * @node successHandler handleSuccess [position: 90 -90] [color: "green"] [icon: "checkCircle"]
+ * @node failureHandler handleFailure [position: 90 90] [color: "red"] [icon: "error"]
  * @position Start -450 0
  * @position Exit 360 0
  * @connect Start.execute -> router.execute
@@ -47267,9 +47283,9 @@ async function executeTools(
  * AI Agent that uses tools to accomplish tasks
  *
  * @flowWeaver workflow
- * @node loop agentLoop [size: 450 350] [position: -180 0]
- * @node llm callLLM loop.iteration [position: -40 100]
- * @node tools executeTools loop.iteration [position: 120 200]
+ * @node loop agentLoop [position: -180 0] [color: "purple"] [icon: "smartToy"]
+ * @node llm callLLM loop.iteration [color: "blue"] [icon: "psychology"]
+ * @node tools executeTools loop.iteration [color: "orange"] [icon: "build"] [suppress: "AGENT_UNGUARDED_TOOL_EXECUTOR"]
  * @position Start -450 0
  * @position Exit 360 0
  * @connect Start.execute -> loop.execute
@@ -47561,25 +47577,25 @@ async function act(
  * ReAct Agent \u2014 iterative Thought\u2192Action\u2192Observation loop
  *
  * @flowWeaver workflow
- * @node loop reactLoop [size: 450 250] [position: -150 0]
- * @node thinking think loop.step [position: -80 30]
- * @node acting act loop.step [position: 130 30]
+ * @node loop reactLoop [position: -150 0] [color: "purple"] [icon: "psychology"]
+ * @node thinking think loop.step [color: "blue"] [icon: "autoAwesome"]
+ * @node acting act loop.step [color: "orange"] [icon: "bolt"]
  * @position Start -400 0
  * @position Exit 350 0
  * @connect Start.execute -> loop.execute
  * @connect Start.task -> loop.task
- * @connect loop.start -> thinking.execute
- * @connect loop.messages -> thinking.messages
+ * @connect loop.start:step -> thinking.execute
+ * @connect loop.messages:step -> thinking.messages
  * @connect thinking.onSuccess -> acting.execute
  * @connect thinking.action -> acting.action
  * @connect thinking.actionInput -> acting.actionInput
- * @connect thinking.thought -> loop.thought
- * @connect thinking.action -> loop.action
- * @connect thinking.actionInput -> loop.actionInput
- * @connect thinking.onFailure -> loop.failure
- * @connect acting.observation -> loop.observation
- * @connect acting.onSuccess -> loop.success
- * @connect acting.onFailure -> loop.failure
+ * @connect thinking.thought -> loop.thought:step
+ * @connect thinking.action -> loop.action:step
+ * @connect thinking.actionInput -> loop.actionInput:step
+ * @connect thinking.onFailure -> loop.failure:step
+ * @connect acting.observation -> loop.observation:step
+ * @connect acting.onSuccess -> loop.success:step
+ * @connect acting.onFailure -> loop.failure:step
  * @connect loop.onSuccess -> Exit.onSuccess
  * @connect loop.onFailure -> Exit.onFailure
  * @connect loop.answer -> Exit.answer
@@ -47655,7 +47671,7 @@ const documentStore: Document[] = [
  * @flowWeaver nodeType
  * @label Retrieve
  * @input query [order:1] - Search query
- * @input topK [order:2] - Number of results (default 3)
+ * @input [topK] [order:2] - Number of results (default 3)
  * @input execute [order:0] - Execute
  * @output documents [order:2] - Retrieved documents
  * @output context [order:3] - Combined document text
@@ -47754,8 +47770,8 @@ Answer:\`;
  * RAG Pipeline for knowledge-based Q&A
  *
  * @flowWeaver workflow
- * @node retriever retrieve [position: -50 0]
- * @node generator generate [position: 200 0]
+ * @node retriever retrieve [position: -50 0] [color: "teal"] [icon: "search"] [suppress: "UNUSED_OUTPUT_PORT"]
+ * @node generator generate [position: 200 0] [color: "purple"] [icon: "autoAwesome"]
  * @position Start -300 0
  * @position Exit 400 0
  * @connect Start.execute -> retriever.execute
@@ -47836,7 +47852,7 @@ Be concise but friendly. Remember context from earlier in the conversation.\`;
  * @flowWeaver nodeType
  * @label Memory
  * @input conversationId [order:1] - Conversation identifier
- * @input newMessage [order:2] - Message to add
+ * @input [newMessage] [order:2] - Message to add
  * @input [maxHistory=50] [order:3] - Max messages to retain
  * @input execute [order:0] - Execute
  * @output history [order:2] - Conversation history
@@ -47924,9 +47940,9 @@ async function chat(
  * Stateful chat with conversation memory
  *
  * @flowWeaver workflow
- * @node mem memory [position: -150 0]
- * @node respond chat [position: 50 0]
- * @node saveMem memory [position: 250 0]
+ * @node mem memory [position: -150 0] [color: "teal"] [icon: "database"]
+ * @node respond chat [position: 50 0] [color: "purple"] [icon: "campaign"] [suppress: "AGENT_LLM_NO_FALLBACK"]
+ * @node saveMem memory [position: 250 0] [color: "teal"] [icon: "database"] [suppress: "UNUSED_OUTPUT_PORT"]
  * @position Start -350 0
  * @position Exit 450 0
  * @connect Start.execute -> mem.execute
@@ -47937,6 +47953,7 @@ async function chat(
  * @connect Start.conversationId -> saveMem.conversationId
  * @connect respond.responseMessage -> saveMem.newMessage
  * @connect respond.onSuccess -> saveMem.execute
+ * @connect respond.onFailure -> Exit.onFailure
  * @connect respond.response -> Exit.response
  * @connect saveMem.onSuccess -> Exit.onSuccess
  * @param execute [order:0] - Execute
@@ -48032,9 +48049,9 @@ function combineData(dataA: any, dataB: any): { aggregated: any } {
 
 /**
  * @flowWeaver workflow
- * @node sourceA fetchSourceA [position: -180 -90]
- * @node sourceB fetchSourceB [position: -180 90]
- * @node combiner combineData [position: 90 0]
+ * @node sourceA fetchSourceA [position: -180 -90] [color: "blue"] [icon: "download"]
+ * @node sourceB fetchSourceB [position: -180 90] [color: "blue"] [icon: "download"]
+ * @node combiner combineData [position: 90 0] [color: "purple"] [icon: "callMerge"]
  * @position Start -450 0
  * @position Exit 360 0
  * @connect Start.execute -> sourceA.execute
@@ -48186,9 +48203,9 @@ function formatResponse(
 
 /**
  * @flowWeaver workflow
- * @node validator validateRequest [position: -180 0]
- * @node processor processPayload [position: 90 -60]
- * @node responder formatResponse [position: 270 0]
+ * @node validator validateRequest [position: -180 0] [color: "green"] [icon: "verified"]
+ * @node processor processPayload [position: 90 -60] [color: "blue"] [icon: "settings"]
+ * @node responder formatResponse [position: 270 0] [color: "cyan"] [icon: "send"]
  * @position Start -450 0
  * @position Exit 450 0
  * @connect Start.execute -> validator.execute
@@ -48330,8 +48347,8 @@ function tryOperation(
 
 /**
  * @flowWeaver workflow
- * @node loop retryLoop [size: 300 200] [position: -90 0]
- * @node tryOp tryOperation loop.attempt [position: 90 0]
+ * @node loop retryLoop [position: -90 0] [color: "orange"] [icon: "refresh"]
+ * @node tryOp tryOperation loop.attempt [color: "blue"] [icon: "playArrow"]
  * @position Start -450 0
  * @position Exit 360 0
  * @connect Start.execute -> loop.execute
@@ -106693,7 +106710,7 @@ function displayInstalledPackage(pkg) {
 // src/cli/index.ts
 init_logger();
 init_error_utils();
-var version2 = true ? "0.20.2" : "0.0.0-dev";
+var version2 = true ? "0.20.4" : "0.0.0-dev";
 var program2 = new Command();
 program2.name("flow-weaver").description("Flow Weaver Annotations - Compile and validate workflow files").option("-v, --version", "Output the current version").option("--no-color", "Disable colors").option("--color", "Force colors").on("option:version", () => {
   logger.banner(version2);

package/dist/cli/templates/workflows/aggregator.js

@@ -68,9 +68,9 @@ function combineData(dataA: any, dataB: any): { aggregated: any } {
 
 /**
  * @flowWeaver workflow
- * @node sourceA fetchSourceA [position: -180 -90]
- * @node sourceB fetchSourceB [position: -180 90]
- * @node combiner combineData [position: 90 0]
+ * @node sourceA fetchSourceA [position: -180 -90] [color: "blue"] [icon: "download"]
+ * @node sourceB fetchSourceB [position: -180 90] [color: "blue"] [icon: "download"]
+ * @node combiner combineData [position: 90 0] [color: "purple"] [icon: "callMerge"]
  * @position Start -450 0
  * @position Exit 360 0
  * @connect Start.execute -> sourceA.execute

package/dist/cli/templates/workflows/ai-agent.js

@@ -283,9 +283,9 @@ async function executeTools(
  * AI Agent that uses tools to accomplish tasks
  *
  * @flowWeaver workflow
- * @node loop agentLoop [size: 450 350] [position: -180 0]
- * @node llm callLLM loop.iteration [position: -40 100]
- * @node tools executeTools loop.iteration [position: 120 200]
+ * @node loop agentLoop [position: -180 0] [color: "purple"] [icon: "smartToy"]
+ * @node llm callLLM loop.iteration [color: "blue"] [icon: "psychology"]
+ * @node tools executeTools loop.iteration [color: "orange"] [icon: "build"] [suppress: "AGENT_UNGUARDED_TOOL_EXECUTOR"]
  * @position Start -450 0
  * @position Exit 360 0
  * @connect Start.execute -> loop.execute

package/dist/cli/templates/workflows/ai-chat.js

@@ -39,7 +39,7 @@ Be concise but friendly. Remember context from earlier in the conversation.\`;
  * @flowWeaver nodeType
  * @label Memory
  * @input conversationId [order:1] - Conversation identifier
- * @input newMessage [order:2] - Message to add
+ * @input [newMessage] [order:2] - Message to add
  * @input [maxHistory=50] [order:3] - Max messages to retain
  * @input execute [order:0] - Execute
  * @output history [order:2] - Conversation history
@@ -127,9 +127,9 @@ async function chat(
  * Stateful chat with conversation memory
  *
  * @flowWeaver workflow
- * @node mem memory [position: -150 0]
- * @node respond chat [position: 50 0]
- * @node saveMem memory [position: 250 0]
+ * @node mem memory [position: -150 0] [color: "teal"] [icon: "database"]
+ * @node respond chat [position: 50 0] [color: "purple"] [icon: "campaign"] [suppress: "AGENT_LLM_NO_FALLBACK"]
+ * @node saveMem memory [position: 250 0] [color: "teal"] [icon: "database"] [suppress: "UNUSED_OUTPUT_PORT"]
  * @position Start -350 0
  * @position Exit 450 0
  * @connect Start.execute -> mem.execute
@@ -140,6 +140,7 @@ async function chat(
  * @connect Start.conversationId -> saveMem.conversationId
  * @connect respond.responseMessage -> saveMem.newMessage
  * @connect respond.onSuccess -> saveMem.execute
+ * @connect respond.onFailure -> Exit.onFailure
  * @connect respond.response -> Exit.response
  * @connect saveMem.onSuccess -> Exit.onSuccess
  * @param execute [order:0] - Execute

package/dist/cli/templates/workflows/ai-rag.js

@@ -46,7 +46,7 @@ const documentStore: Document[] = [
  * @flowWeaver nodeType
  * @label Retrieve
  * @input query [order:1] - Search query
- * @input topK [order:2] - Number of results (default 3)
+ * @input [topK] [order:2] - Number of results (default 3)
  * @input execute [order:0] - Execute
  * @output documents [order:2] - Retrieved documents
  * @output context [order:3] - Combined document text
@@ -145,8 +145,8 @@ Answer:\`;
  * RAG Pipeline for knowledge-based Q&A
  *
  * @flowWeaver workflow
- * @node retriever retrieve [position: -50 0]
- * @node generator generate [position: 200 0]
+ * @node retriever retrieve [position: -50 0] [color: "teal"] [icon: "search"] [suppress: "UNUSED_OUTPUT_PORT"]
+ * @node generator generate [position: 200 0] [color: "purple"] [icon: "autoAwesome"]
  * @position Start -300 0
  * @position Exit 400 0
  * @connect Start.execute -> retriever.execute

package/dist/cli/templates/workflows/ai-react.js

@@ -247,25 +247,25 @@ async function act(
  * ReAct Agent — iterative Thought→Action→Observation loop
  *
  * @flowWeaver workflow
- * @node loop reactLoop [size: 450 250] [position: -150 0]
- * @node thinking think loop.step [position: -80 30]
- * @node acting act loop.step [position: 130 30]
+ * @node loop reactLoop [position: -150 0] [color: "purple"] [icon: "psychology"]
+ * @node thinking think loop.step [color: "blue"] [icon: "autoAwesome"]
+ * @node acting act loop.step [color: "orange"] [icon: "bolt"]
  * @position Start -400 0
  * @position Exit 350 0
  * @connect Start.execute -> loop.execute
  * @connect Start.task -> loop.task
- * @connect loop.start -> thinking.execute
- * @connect loop.messages -> thinking.messages
+ * @connect loop.start:step -> thinking.execute
+ * @connect loop.messages:step -> thinking.messages
  * @connect thinking.onSuccess -> acting.execute
  * @connect thinking.action -> acting.action
  * @connect thinking.actionInput -> acting.actionInput
- * @connect thinking.thought -> loop.thought
- * @connect thinking.action -> loop.action
- * @connect thinking.actionInput -> loop.actionInput
- * @connect thinking.onFailure -> loop.failure
- * @connect acting.observation -> loop.observation
- * @connect acting.onSuccess -> loop.success
- * @connect acting.onFailure -> loop.failure
+ * @connect thinking.thought -> loop.thought:step
+ * @connect thinking.action -> loop.action:step
+ * @connect thinking.actionInput -> loop.actionInput:step
+ * @connect thinking.onFailure -> loop.failure:step
+ * @connect acting.observation -> loop.observation:step
+ * @connect acting.onSuccess -> loop.success:step
+ * @connect acting.onFailure -> loop.failure:step
  * @connect loop.onSuccess -> Exit.onSuccess
  * @connect loop.onFailure -> Exit.onFailure
  * @connect loop.answer -> Exit.answer

package/dist/cli/templates/workflows/conditional.js

@@ -105,9 +105,9 @@ function handleFailure(
 
 /**
  * @flowWeaver workflow
- * @node router evaluateCondition [position: -180 0]
- * @node successHandler handleSuccess [position: 90 -90]
- * @node failureHandler handleFailure [position: 90 90]
+ * @node router evaluateCondition [position: -180 0] [color: "orange"] [icon: "altRoute"] [suppress: "UNUSED_OUTPUT_PORT"]
+ * @node successHandler handleSuccess [position: 90 -90] [color: "green"] [icon: "checkCircle"]
+ * @node failureHandler handleFailure [position: 90 90] [color: "red"] [icon: "error"]
  * @position Start -450 0
  * @position Exit 360 0
  * @connect Start.execute -> router.execute

package/dist/cli/templates/workflows/error-handler.js

@@ -105,8 +105,8 @@ function tryOperation(
 
 /**
  * @flowWeaver workflow
- * @node loop retryLoop [size: 300 200] [position: -90 0]
- * @node tryOp tryOperation loop.attempt [position: 90 0]
+ * @node loop retryLoop [position: -90 0] [color: "orange"] [icon: "refresh"]
+ * @node tryOp tryOperation loop.attempt [color: "blue"] [icon: "playArrow"]
  * @position Start -450 0
  * @position Exit 360 0
  * @connect Start.execute -> loop.execute

package/dist/cli/templates/workflows/foreach.js

@@ -101,9 +101,9 @@ function aggregateResults(
 
 /**
  * @flowWeaver workflow
- * @node iterator forEachItem [size: 300 200] [position: -90 0]
- * @node processor processItem iterator.processItem [position: 90 0]
- * @node aggregator aggregateResults [position: 270 0]
+ * @node iterator forEachItem [position: -90 0] [color: "purple"] [icon: "repeat"]
+ * @node processor processItem iterator.processItem [color: "blue"] [icon: "settings"]
+ * @node aggregator aggregateResults [position: 270 0] [color: "teal"] [icon: "inventory"]
  * @position Start -450 0
  * @position Exit 450 0
  * @connect Start.execute -> iterator.execute

package/dist/cli/templates/workflows/sequential.js

@@ -87,12 +87,13 @@ function outputResult(data: any): { result: any } {
 
 /**
  * @flowWeaver workflow
- * @node validator validateData [position: -300 0]
- * @node transformer transformData [position: 0 0]
- * @node outputter outputResult [position: 300 0]
+ * @node validator validateData [position: -300 0] [color: "green"] [icon: "verified"] [suppress: "UNUSED_OUTPUT_PORT"]
+ * @node transformer transformData [position: 0 0] [color: "blue"] [icon: "sync"]
+ * @node outputter outputResult [position: 300 0] [color: "cyan"] [icon: "inventory"]
  * @position Start -600 0
  * @position Exit 600 0
  * @path Start -> validator -> transformer -> outputter -> Exit
+ * @connect outputter.result -> Exit.result
  * @connect validator.onFailure -> Exit.onFailure
  * @connect validator.error -> Exit.error
  * @param execute [order:0] - Execute
@@ -134,9 +135,11 @@ function ${name}(${inputPortName}: any): { ${outputPortName}: any } {
     // Generate workflow annotations
     const spacing = 300;
     const startX = -(nodeNames.length * (spacing / 2) + spacing / 2);
+    const stepColors = ['green', 'blue', 'cyan', 'orange', 'purple', 'teal', 'pink', 'yellow'];
     const nodeAnnotations = nodeNames.map((name, i) => {
         const x = startX + (i + 1) * spacing;
-        return ` * @node step${i} ${name} [position: ${x} 0]`;
+        const color = stepColors[i % stepColors.length];
+        return ` * @node step${i} ${name} [position: ${x} 0] [color: "${color}"] [icon: "settings"]`;
     }).join('\n');
     const positionAnnotations = [
         ` * @position Start ${startX} 0`,

package/dist/cli/templates/workflows/webhook.js

@@ -120,9 +120,9 @@ function formatResponse(
 
 /**
  * @flowWeaver workflow
- * @node validator validateRequest [position: -180 0]
- * @node processor processPayload [position: 90 -60]
- * @node responder formatResponse [position: 270 0]
+ * @node validator validateRequest [position: -180 0] [color: "green"] [icon: "verified"]
+ * @node processor processPayload [position: 90 -60] [color: "blue"] [icon: "settings"]
+ * @node responder formatResponse [position: 270 0] [color: "cyan"] [icon: "send"]
  * @position Start -450 0
  * @position Exit 450 0
  * @connect Start.execute -> validator.execute

package/dist/generated-version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.20.2";
+export declare const VERSION = "0.20.4";
 //# sourceMappingURL=generated-version.d.ts.map

package/dist/generated-version.js

@@ -1,3 +1,3 @@
 // Auto-generated by scripts/generate-version.ts — do not edit manually
-export const VERSION = '0.20.2';
+export const VERSION = '0.20.4';
 //# sourceMappingURL=generated-version.js.map

package/dist/jsdoc-parser.js

@@ -740,7 +740,7 @@ export class JSDocParser {
         else if (func) {
             const returnType = func.getReturnType();
             const returnTypeText = returnType.getText();
-            const fieldMatch = returnTypeText.match(new RegExp(`${name}\\s*:\\s*([^;},]+)`));
+            const fieldMatch = returnTypeText.match(new RegExp(`${name}\\??\\s*:\\s*([^;},]+)`));
             if (fieldMatch) {
                 type = inferDataTypeFromTS(fieldMatch[1].trim());
             }
@@ -795,7 +795,7 @@ export class JSDocParser {
                     paramTypeText === '{}' ||
                     /^\{\s*\[[\w]+:\s*string\]:\s*(never|any|unknown);\s*\}$/.test(paramTypeText));
                 if (!isCatchAllRecord) {
-                    const fieldMatch = paramTypeText.match(new RegExp(`${name}\\s*:\\s*([^;},]+)`));
+                    const fieldMatch = paramTypeText.match(new RegExp(`${name}\\??\\s*:\\s*([^;},]+)`));
                     if (fieldMatch) {
                         type = inferDataTypeFromTS(fieldMatch[1].trim());
                     }

package/docs/reference/cli-reference.md

@@ -538,6 +538,7 @@ flow-weaver modify setLabel --file <path> --nodeId <id> --label <text>
 
 Sets the display label for a node instance.
 
+
 **Examples:**
 ```bash
 flow-weaver modify addNode --file workflow.ts --nodeId validator --nodeType validateInput

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synergenius/flow-weaver",
-  "version": "0.20.2",
+  "version": "0.20.4",
   "description": "Deterministic workflow compiler for AI agents. Compiles to standalone TypeScript, no runtime dependencies.",
   "private": false,
   "type": "module",