@synergenius/flow-weaver 0.8.0 → 0.8.1

package/dist/built-in-nodes/wait-for-agent.js

@@ -15,6 +15,10 @@ export async function waitForAgent(execute, agentId, context, prompt) {
     if (mockResult !== undefined) {
         return { onSuccess: true, onFailure: false, agentResult: mockResult };
     }
+    // Mocks section exists but key not found — fail like waitForEvent/invokeWorkflow
+    if (mocks?.agents) {
+        return { onSuccess: false, onFailure: true, agentResult: {} };
+    }
     // 2. Check agent channel (set by executor for pause/resume)
     const channel = globalThis.__fw_agent_channel__;
     if (channel) {

package/dist/cli/flow-weaver.mjs

@@ -45439,7 +45439,7 @@ var AnnotationParser = class {
       const config2 = jsdocParser.parseNodeType(fn, warnings);
       if (!config2) {
         const jsdocText = fn.getJsDocs().map((d) => d.getFullText()).join("");
-        if (jsdocText.includes("@flowWeaver") && jsdocText.includes("nodeType")) {
+        if (jsdocText.includes("@flowWeaver nodeType")) {
           warnings.push(
             `Function "${fn.getName() || "anonymous"}" has @flowWeaver annotation but could not be parsed. Check for special characters (---) or malformed JSDoc syntax.`
           );
@@ -45650,7 +45650,7 @@ ${fn.getText()}` : fn.getText();
       const config2 = jsdocParser.parseWorkflow(fn, warnings);
       if (!config2) {
         const jsdocText = fn.getJsDocs().map((d) => d.getFullText()).join("");
-        if (jsdocText.includes("@flowWeaver") && jsdocText.includes("workflow")) {
+        if (jsdocText.includes("@flowWeaver workflow")) {
           warnings.push(
             `Function "${fn.getName() || "anonymous"}" has @flowWeaver annotation but could not be parsed. Check for special characters (---) or malformed JSDoc syntax.`
           );
@@ -45838,7 +45838,7 @@ ${fn.getText()}` : fn.getText();
       const config2 = jsdocParser.parsePattern(fn, warnings);
       if (!config2) {
         const jsdocText = fn.getJsDocs().map((d) => d.getFullText()).join("");
-        if (jsdocText.includes("@flowWeaver") && jsdocText.includes("pattern")) {
+        if (jsdocText.includes("@flowWeaver pattern")) {
           warnings.push(
             `Function "${fn.getName() || "anonymous"}" has @flowWeaver annotation but could not be parsed. Check for special characters (---) or malformed JSDoc syntax.`
           );
@@ -95127,7 +95127,7 @@ function displayInstalledPackage(pkg) {
 }
 
 // src/cli/index.ts
-var version2 = true ? "0.8.0" : "0.0.0-dev";
+var version2 = true ? "0.8.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({
@@ -95331,7 +95331,7 @@ patternCmd.command("extract <source-file>").description("Extract a pattern from
     process.exit(1);
   }
 });
-program2.command("run <input>").description("Execute a workflow file directly").option("-w, --workflow <name>", "Specific workflow name to run").option("--params <json>", "Input parameters as JSON string").option("--params-file <path>", "Path to JSON file with input parameters").option("-p, --production", "Production mode (no trace events)", false).option("-t, --trace", "Include execution trace events").option("-s, --stream", "Stream trace events in real-time").option("--json", "Output result as JSON", false).option("--timeout <ms>", "Execution timeout in milliseconds", parseInt).option("--mocks <json>", "Mock config for built-in nodes (events, invocations, fast) as JSON").option("--mocks-file <path>", "Path to JSON file with mock config for built-in nodes").action(async (input, options) => {
+program2.command("run <input>").description("Execute a workflow file directly").option("-w, --workflow <name>", "Specific workflow name to run").option("--params <json>", "Input parameters as JSON string").option("--params-file <path>", "Path to JSON file with input parameters").option("-p, --production", "Production mode (no trace events)", false).option("-t, --trace", "Include execution trace events").option("-s, --stream", "Stream trace events in real-time").option("--json", "Output result as JSON", false).option("--timeout <ms>", "Execution timeout in milliseconds", parseInt).option("--mocks <json>", "Mock config for built-in nodes (events, invocations, agents, fast) as JSON").option("--mocks-file <path>", "Path to JSON file with mock config for built-in nodes").action(async (input, options) => {
   try {
     await runCommand(input, options);
   } catch (error2) {

package/dist/cli/index.js

@@ -459,7 +459,7 @@ program
     .option('-s, --stream', 'Stream trace events in real-time')
     .option('--json', 'Output result as JSON', false)
     .option('--timeout <ms>', 'Execution timeout in milliseconds', parseInt)
-    .option('--mocks <json>', 'Mock config for built-in nodes (events, invocations, fast) as JSON')
+    .option('--mocks <json>', 'Mock config for built-in nodes (events, invocations, agents, fast) as JSON')
     .option('--mocks-file <path>', 'Path to JSON file with mock config for built-in nodes')
     .action(async (input, options) => {
     try {

package/dist/parser.js

@@ -594,7 +594,7 @@ export class AnnotationParser {
             const config = jsdocParser.parseNodeType(fn, warnings);
             if (!config) {
                 const jsdocText = fn.getJsDocs().map((d) => d.getFullText()).join('');
-                if (jsdocText.includes('@flowWeaver') && jsdocText.includes('nodeType')) {
+                if (jsdocText.includes('@flowWeaver nodeType')) {
                     warnings.push(`Function "${fn.getName() || 'anonymous'}" has @flowWeaver annotation but could not be parsed. ` +
                         `Check for special characters (---) or malformed JSDoc syntax.`);
                 }
@@ -818,7 +818,7 @@ export class AnnotationParser {
             const config = jsdocParser.parseWorkflow(fn, warnings);
             if (!config) {
                 const jsdocText = fn.getJsDocs().map((d) => d.getFullText()).join('');
-                if (jsdocText.includes('@flowWeaver') && jsdocText.includes('workflow')) {
+                if (jsdocText.includes('@flowWeaver workflow')) {
                     warnings.push(`Function "${fn.getName() || 'anonymous'}" has @flowWeaver annotation but could not be parsed. ` +
                         `Check for special characters (---) or malformed JSDoc syntax.`);
                 }
@@ -1007,7 +1007,7 @@ export class AnnotationParser {
             const config = jsdocParser.parsePattern(fn, warnings);
             if (!config) {
                 const jsdocText = fn.getJsDocs().map((d) => d.getFullText()).join('');
-                if (jsdocText.includes('@flowWeaver') && jsdocText.includes('pattern')) {
+                if (jsdocText.includes('@flowWeaver pattern')) {
                     warnings.push(`Function "${fn.getName() || 'anonymous'}" has @flowWeaver annotation but could not be parsed. ` +
                         `Check for special characters (---) or malformed JSDoc syntax.`);
                 }

package/docs/reference/built-in-nodes.md

@@ -127,6 +127,8 @@ interface FwMockConfig {
   events?: Record<string, object>;
   /** Mock invocation results keyed by functionId. Used by invokeWorkflow. */
   invocations?: Record<string, object>;
+  /** Mock agent results keyed by agentId. Used by waitForAgent. */
+  agents?: Record<string, object>;
   /** When true, delay nodes skip the real sleep (1ms instead of full duration). */
   fast?: boolean;
 }
@@ -156,6 +158,9 @@ flow-weaver run workflow.ts --mocks-file mocks.json
   },
   "invocations": {
     "my-service/payment-processor": { "transactionId": "tx-123", "success": true }
+  },
+  "agents": {
+    "human-reviewer": { "approved": true, "note": "Looks good" }
   }
 }
 ```
@@ -172,6 +177,9 @@ Set mocks on `globalThis` before running the workflow:
   },
   invocations: {
     'my-service/sub-workflow': { result: 'success' }
+  },
+  agents: {
+    'human-reviewer': { approved: true }
   }
 };
 

package/docs/reference/debugging.md

@@ -250,7 +250,7 @@ Scoped ports use direction inversion: scoped OUTPUTS = data parent sends to chil
 
 ## Mock System for Built-in Nodes
 
-When testing workflows that use `delay`, `waitForEvent`, or `invokeWorkflow`, use mocks to avoid real side effects:
+When testing workflows that use `delay`, `waitForEvent`, `invokeWorkflow`, or `waitForAgent`, use mocks to avoid real side effects:
 
 ```bash
 flow-weaver run workflow.ts --mocks '{"fast": true, "events": {"app/approved": {"status": "ok"}}}'
@@ -261,6 +261,9 @@ Mock config structure:
 - `fast: true` — Skip real sleep in `delay` nodes (1ms instead)
 - `events: { "event-name": data }` — Mock event data for `waitForEvent`
 - `invocations: { "function-id": result }` — Mock results for `invokeWorkflow`
+- `agents: { "agent-id": result }` — Mock results for `waitForAgent`
+
+Use `--timeout <ms>` as a safeguard when running workflows that may block on unresolved `waitForAgent` or `waitForEvent` nodes. In non-interactive environments (piped stdin), `waitForAgent` will fail fast with an error if no mock is provided.
 
 See `built-in-nodes` for full documentation on mock configuration and testing patterns.
 

package/package.json

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