@synergenius/flow-weaver 0.32.2 → 0.33.1

package/README.md

@@ -58,6 +58,8 @@ Breaking changes may still occur between minor versions during beta. Pin your ve
 
 **Extensible pack system:** Node types, deploy targets, CLI commands, and MCP tools are contributed by npm packages. Install community packs or build and publish your own.
 
+**OpenClaw integration:** Use Flow Weaver inside [OpenClaw](https://openclaw.ai) with the native plugin. Build deterministic workflows through conversation. [Plugin](https://clawhub.ai/plugins/%40synergenius%2Fflow-weaver-openclaw) | [npm](https://www.npmjs.com/package/@synergenius/flow-weaver-openclaw) 🦞
+
 ## Quick Start
 
 ```bash

package/dist/api/compile.d.ts

@@ -21,6 +21,8 @@ export interface CompileOptions {
     write?: boolean;
     /** Whether to save AST alongside the generated file (default: false) */
     saveAST?: boolean;
+    /** Validation mode: 'draft' suppresses STUB_NODE errors */
+    validationMode?: 'strict' | 'draft';
 }
 /**
  * Result of workflow compilation

package/dist/api/compile.js

@@ -38,7 +38,8 @@ export async function compileWorkflow(filePath, options = {}) {
     }
     // Validate before generating
     const { validateWorkflow } = await import('./validate.js');
-    const validationResult = validateWorkflow(parseResult.ast);
+    const validationMode = options.validationMode;
+    const validationResult = validateWorkflow(parseResult.ast, validationMode ? { mode: validationMode } : undefined);
     if (validationResult.errors.length > 0) {
         const errorMessages = validationResult.errors.map((e) => typeof e === 'string' ? e : e.message);
         throw new Error(`Validation errors:\n${errorMessages.join('\n')}`);

package/dist/chevrotain-parser/path-parser.d.ts

@@ -5,8 +5,10 @@
  *
  * Syntax:
  *   @path Start -> validator:ok -> classifier -> urgencyRouter:fail -> escalate -> Exit
+ *   @path Start -> A -> C -> Exit, Start -> B -> C
  *
- * Steps separated by ->, each is NodeName optionally followed by :ok or :fail
+ * Steps separated by ->, each is NodeName optionally followed by :ok or :fail.
+ * Multiple paths can be comma-separated within a single @path tag.
  */
 export interface PathStep {
     node: string;
@@ -17,10 +19,12 @@ export interface PathParseResult {
     steps: PathStep[];
 }
 /**
- * Parse a @path line and return structured result.
+ * Parse a @path line and return structured results.
+ * Supports comma-separated parallel paths in a single @path tag:
+ *   @path Start -> A -> C -> Exit, Start -> B -> C
  * Returns null if the line is not a valid @path declaration.
  */
-export declare function parsePathLine(input: string, warnings: string[]): PathParseResult | null;
+export declare function parsePathLine(input: string, warnings: string[]): PathParseResult[] | null;
 /**
  * Get serialized grammar for documentation/diagram generation.
  */

package/dist/chevrotain-parser/path-parser.js

@@ -5,11 +5,13 @@
  *
  * Syntax:
  *   @path Start -> validator:ok -> classifier -> urgencyRouter:fail -> escalate -> Exit
+ *   @path Start -> A -> C -> Exit, Start -> B -> C
  *
- * Steps separated by ->, each is NodeName optionally followed by :ok or :fail
+ * Steps separated by ->, each is NodeName optionally followed by :ok or :fail.
+ * Multiple paths can be comma-separated within a single @path tag.
  */
 import { CstParser } from 'chevrotain';
-import { JSDocLexer, PathTag, Identifier, Arrow, Colon, allTokens, } from './tokens.js';
+import { JSDocLexer, PathTag, Identifier, Arrow, Colon, Comma, allTokens, } from './tokens.js';
 // =============================================================================
 // Parser Definition
 // =============================================================================
@@ -18,9 +20,17 @@ class PathParser extends CstParser {
         super(allTokens);
         this.performSelfAnalysis();
     }
-    // Entry rule: @path pathStep (Arrow pathStep)+
+    // Entry rule: @path pathSequence (Comma pathSequence)*
     pathLine = this.RULE('pathLine', () => {
         this.CONSUME(PathTag);
+        this.SUBRULE(this.pathSequence, { LABEL: 'firstSequence' });
+        this.MANY(() => {
+            this.CONSUME(Comma);
+            this.SUBRULE2(this.pathSequence, { LABEL: 'nextSequence' });
+        });
+    });
+    // pathSequence: pathStep (Arrow pathStep)+
+    pathSequence = this.RULE('pathSequence', () => {
         this.SUBRULE(this.pathStep, { LABEL: 'firstStep' });
         this.AT_LEAST_ONE(() => {
             this.CONSUME(Arrow);
@@ -54,6 +64,16 @@ class PathVisitor extends BaseVisitor {
         this.warnings = warnings;
     }
     pathLine(ctx) {
+        const results = [];
+        results.push(this.pathSequence(ctx.firstSequence[0].children));
+        if (ctx.nextSequence) {
+            for (const seqCst of ctx.nextSequence) {
+                results.push(this.pathSequence(seqCst.children));
+            }
+        }
+        return results;
+    }
+    pathSequence(ctx) {
         const steps = [];
         steps.push(this.pathStep(ctx.firstStep[0].children));
         for (const stepCst of ctx.nextStep) {
@@ -81,7 +101,9 @@ const visitorInstance = new PathVisitor();
 // Public API
 // =============================================================================
 /**
- * Parse a @path line and return structured result.
+ * Parse a @path line and return structured results.
+ * Supports comma-separated parallel paths in a single @path tag:
+ *   @path Start -> A -> C -> Exit, Start -> B -> C
  * Returns null if the line is not a valid @path declaration.
  */
 export function parsePathLine(input, warnings) {