@synergenius/flow-weaver 0.21.20 → 0.21.22

package/dist/api/generate-in-place.js

@@ -8,7 +8,7 @@
  * - Function body (between markers)
  */
 import { bodyGenerator } from '../body-generator.js';
-import { generateInlineRuntime, generateInlineDebugClient } from './inline-runtime.js';
+import { generateInlineRuntime } from './inline-runtime.js';
 import { isExecutePort, isSuccessPort, isFailurePort, isControlFlowPort } from '../constants.js';
 import { generateJSDocPortTag, assignPortOrders, generateNodeInstanceTag, } from '../annotation-generator.js';
 import { shouldWorkflowBeAsync } from '../generator/async-detection.js';
@@ -112,9 +112,11 @@ export function generateInPlace(sourceCode, ast, options = {}) {
     }
     // Step 5: Detect async from node composition + source signature
     // If any node is async, force async (even if source isn't marked async)
+    // In dev mode (!production), always force async so the debugger can pause execution
+    // at breakpoints (sendStatusChangedEvent must be awaited).
     const nodesRequireAsync = shouldWorkflowBeAsync(ast, ast.nodeTypes);
     const sourceIsAsync = detectFunctionIsAsync(result, ast.functionName);
-    const forceAsync = nodesRequireAsync;
+    const forceAsync = nodesRequireAsync || !production;
     const isAsync = forceAsync || sourceIsAsync;
     // Add async keyword to source if nodes or debug hooks require it
     const asyncSigResult = ensureAsyncKeyword(result, ast.functionName, forceAsync);
@@ -158,19 +160,11 @@ function generateRuntimeSection(functionName, production, moduleFormat = 'esm',
             lines.push(`import type { TDebugger } from '${externalRuntimePath}';`);
             // Declare __flowWeaverDebugger__ so body code can reference it
             lines.push('declare const __flowWeaverDebugger__: TDebugger | undefined;');
-            // Include inline debug client (createFlowWeaverDebugClient is not exported from runtime)
-            lines.push('');
-            lines.push(generateInlineDebugClient(moduleFormat));
         }
     }
     else {
         // Inline runtime: embed all types and classes directly
         lines.push(generateInlineRuntime(production));
-        // Add debug client (dev mode only)
-        if (!production) {
-            lines.push('');
-            lines.push(generateInlineDebugClient(moduleFormat));
-        }
     }
     return lines.join('\n');
 }

package/dist/api/generate.js

@@ -3,7 +3,7 @@ import { extractExitPorts, extractStartPorts, hasBranching } from '../ast/workfl
 import { isExecutePort } from '../constants.js';
 import { mapToTypeScript } from '../type-mappings.js';
 import { SourceMapGenerator } from 'source-map';
-import { generateInlineRuntime, generateInlineDebugClient, stripTypeScript } from './inline-runtime.js';
+import { generateInlineRuntime, stripTypeScript } from './inline-runtime.js';
 import { validateWorkflowAsync } from '../generator/async-detection.js';
 import { extractTypeDeclarationsFromFile } from './extract-types.js';
 import * as path from 'node:path';
@@ -100,13 +100,6 @@ export function generateCode(ast, options) {
                 ? `const { TDebugger } = require('${externalRuntimePath}');`
                 : `import type { TDebugger } from '${externalRuntimePath}';`);
             addLine();
-            // Include inline debug client (createFlowWeaverDebugClient is not exported from runtime)
-            const inlineDebugClient = generateInlineDebugClient(moduleFormat);
-            const debugClientLines = inlineDebugClient.split('\n');
-            debugClientLines.forEach((line) => {
-                lines.push(line);
-                addLine();
-            });
         }
         lines.push('');
         addLine();
@@ -121,15 +114,6 @@ export function generateCode(ast, options) {
         });
         lines.push('');
         addLine();
-        // Include inline debug client (dev mode only)
-        if (!production) {
-            const inlineDebugClient = generateInlineDebugClient(moduleFormat);
-            const debugClientLines = inlineDebugClient.split('\n');
-            debugClientLines.forEach((line) => {
-                lines.push(line);
-                addLine();
-            });
-        }
     }
     // Extract and include type declarations from source file (interfaces, type aliases)
     if (ast.sourceFile) {
@@ -374,7 +358,8 @@ export function generateCode(ast, options) {
         }
     }
     // Generate conditional async keyword and export keyword based on module format
-    const asyncKeyword = shouldBeAsync ? 'async ' : '';
+    // In dev mode, always async so the debugger can pause at breakpoints
+    const asyncKeyword = (shouldBeAsync || !production) ? 'async ' : '';
     const exportKeyword = generateFunctionExportKeyword(moduleFormat);
     lines.push(`${exportKeyword}${asyncKeyword}function ${ast.functionName}(`);
     addLine();
@@ -488,8 +473,8 @@ function generateWorkflowFunction(workflow, production, allWorkflows, generatedW
     // Generate function signature
     const startPorts = extractStartPorts(workflow);
     const exitPorts = extractExitPorts(workflow);
-    const asyncKeyword = shouldBeAsync ? 'async ' : '';
-    lines.push(`${asyncKeyword}function ${workflow.functionName}(`);
+    const asyncKeyword2 = (shouldBeAsync || !production) ? 'async ' : '';
+    lines.push(`${asyncKeyword2}function ${workflow.functionName}(`);
     // STEP Port Architecture: execute is first parameter
     lines.push(`  execute: boolean = true,`);
     // Collect param names and types for destructuring

package/dist/api/inline-runtime.d.ts

@@ -18,14 +18,6 @@ export declare function stripTypeScript(code: string): string;
  */
 export declare function generateInlineRuntime(production: boolean, exportClasses?: boolean, outputFormat?: TOutputFormat): string;
 import type { TModuleFormat } from '../ast/types.js';
-/**
- * Generates inline WebSocket debug client for auto-detection from env var
- * Only included in development mode builds
- *
- * @param moduleFormat - The module format to use for imports ('esm' or 'cjs')
- * @param outputFormat - Output format: 'typescript' (default) or 'javascript' (strips types)
- */
-export declare function generateInlineDebugClient(moduleFormat?: TModuleFormat, outputFormat?: TOutputFormat): string;
 /**
  * Generates a standalone runtime module file for multi-workflow bundles.
  * This exports all runtime types and classes so individual workflow files can import them.

package/dist/api/inline-runtime.js

@@ -100,7 +100,7 @@ export function generateInlineRuntime(production, exportClasses = false, outputF
         lines.push('  | TWorkflowCompletedEvent;');
         lines.push('');
         lines.push(`${exportKeyword}type TDebugger = {`);
-        lines.push('  sendEvent: (event: TEvent) => void;');
+        lines.push('  sendEvent: (event: TEvent) => void | Promise<void>;');
         lines.push('  innerFlowInvocation: boolean;');
         lines.push('  sessionId?: string;');
         lines.push('};');
@@ -303,12 +303,13 @@ export function generateInlineRuntime(production, exportClasses = false, outputF
     lines.push('  }');
     lines.push('');
     // createScope
-    lines.push('  createScope(_parentNodeName: string, _parentIndex: number, _scopeName: string, cleanScope: boolean = false): GeneratedExecutionContext {');
+    lines.push('  createScope(_parentNodeName: string, _parentIndex: number, _scopeName: string, cleanScope: boolean = false, isAsyncOverride?: boolean): GeneratedExecutionContext {');
+    lines.push('    const effectiveIsAsync = isAsyncOverride !== undefined ? isAsyncOverride : this.isAsync;');
     if (production) {
-        lines.push('    const scopedContext = new GeneratedExecutionContext(this.isAsync, this.abortSignal);');
+        lines.push('    const scopedContext = new GeneratedExecutionContext(effectiveIsAsync, this.abortSignal);');
     }
     else {
-        lines.push('    const scopedContext = new GeneratedExecutionContext(this.isAsync, this.flowWeaverDebugger, this.abortSignal);');
+        lines.push('    const scopedContext = new GeneratedExecutionContext(effectiveIsAsync, this.flowWeaverDebugger, this.abortSignal);');
     }
     lines.push('    // For per-port function scopes (cleanScope=true), start with empty variables');
     lines.push('    // For node-level scopes (cleanScope=false), inherit parent variables');
@@ -371,16 +372,16 @@ export function generateInlineRuntime(production, exportClasses = false, outputF
     lines.push('');
     // Debug event methods (only in development mode)
     if (!production) {
-        lines.push('  sendStatusChangedEvent(args: {');
+        lines.push('  async sendStatusChangedEvent(args: {');
         lines.push('    nodeTypeName: string;');
         lines.push('    id: string;');
         lines.push('    scope?: string;');
         lines.push('    side?: "start" | "exit";');
         lines.push('    executionIndex: number;');
         lines.push('    status: TStatusType;');
-        lines.push('  }): void {');
+        lines.push('  }): Promise<void> {');
         lines.push('    if (this.flowWeaverDebugger) {');
-        lines.push('      this.flowWeaverDebugger.sendEvent({');
+        lines.push('      await this.flowWeaverDebugger.sendEvent({');
         lines.push('        type: "STATUS_CHANGED",');
         lines.push('        ...args,');
         lines.push('        innerFlowInvocation: this.flowWeaverDebugger.innerFlowInvocation,');
@@ -388,12 +389,12 @@ export function generateInlineRuntime(production, exportClasses = false, outputF
         lines.push('    }');
         lines.push('  }');
         lines.push('');
-        lines.push('  private sendVariableSetEvent(args: {');
+        lines.push('  private async sendVariableSetEvent(args: {');
         lines.push('    identifier: TVariableIdentification;');
         lines.push('    value: unknown;');
-        lines.push('  }): void {');
+        lines.push('  }): Promise<void> {');
         lines.push('    if (this.flowWeaverDebugger) {');
-        lines.push('      this.flowWeaverDebugger.sendEvent({');
+        lines.push('      await this.flowWeaverDebugger.sendEvent({');
         lines.push('        type: "VARIABLE_SET",');
         lines.push('        ...args,');
         lines.push('        innerFlowInvocation: this.flowWeaverDebugger.innerFlowInvocation,');
@@ -401,16 +402,16 @@ export function generateInlineRuntime(production, exportClasses = false, outputF
         lines.push('    }');
         lines.push('  }');
         lines.push('');
-        lines.push('  sendLogErrorEvent(args: {');
+        lines.push('  async sendLogErrorEvent(args: {');
         lines.push('    nodeTypeName: string;');
         lines.push('    id: string;');
         lines.push('    scope?: string;');
         lines.push('    side?: "start" | "exit";');
         lines.push('    executionIndex: number;');
         lines.push('    error: string;');
-        lines.push('  }): void {');
+        lines.push('  }): Promise<void> {');
         lines.push('    if (this.flowWeaverDebugger) {');
-        lines.push('      this.flowWeaverDebugger.sendEvent({');
+        lines.push('      await this.flowWeaverDebugger.sendEvent({');
         lines.push('        type: "LOG_ERROR",');
         lines.push('        ...args,');
         lines.push('        innerFlowInvocation: this.flowWeaverDebugger.innerFlowInvocation,');
@@ -418,13 +419,13 @@ export function generateInlineRuntime(production, exportClasses = false, outputF
         lines.push('    }');
         lines.push('  }');
         lines.push('');
-        lines.push('  sendWorkflowCompletedEvent(args: {');
+        lines.push('  async sendWorkflowCompletedEvent(args: {');
         lines.push('    executionIndex: number;');
         lines.push('    status: "SUCCEEDED" | "FAILED" | "CANCELLED";');
         lines.push('    result?: unknown;');
-        lines.push('  }): void {');
+        lines.push('  }): Promise<void> {');
         lines.push('    if (this.flowWeaverDebugger) {');
-        lines.push('      this.flowWeaverDebugger.sendEvent({');
+        lines.push('      await this.flowWeaverDebugger.sendEvent({');
         lines.push('        type: "WORKFLOW_COMPLETED",');
         lines.push('        ...args,');
         lines.push('        innerFlowInvocation: this.flowWeaverDebugger.innerFlowInvocation,');
@@ -490,92 +491,6 @@ export function generateInlineRuntime(production, exportClasses = false, outputF
     }
     return output;
 }
-/**
- * Generates inline WebSocket debug client for auto-detection from env var
- * Only included in development mode builds
- *
- * @param moduleFormat - The module format to use for imports ('esm' or 'cjs')
- * @param outputFormat - Output format: 'typescript' (default) or 'javascript' (strips types)
- */
-export function generateInlineDebugClient(moduleFormat = 'esm', outputFormat = 'typescript') {
-    const lines = [];
-    lines.push('// ============================================================================');
-    lines.push('// Inline Debug Client (auto-created from FLOW_WEAVER_DEBUG env var)');
-    lines.push('// ============================================================================');
-    lines.push('');
-    lines.push('/* eslint-disable @typescript-eslint/no-explicit-any, no-console */');
-    lines.push('function createFlowWeaverDebugClient(url: string, workflowExportName: string): any {');
-    lines.push('  let ws: any = null;');
-    lines.push('  let connected = false;');
-    lines.push('  let queue: string[] = [];');
-    lines.push('  const sessionId = Math.random().toString(36).substring(2, 15);');
-    lines.push('');
-    lines.push('  const connect = async () => {');
-    lines.push('    try {');
-    lines.push("      // Node.js environment - dynamically load 'ws' package");
-    // Generate format-appropriate import for 'ws' package
-    if (moduleFormat === 'cjs') {
-        // CommonJS: use require() directly
-        lines.push("      const wsModule = require('ws');");
-    }
-    else {
-        // ESM: use dynamic import
-        lines.push("      const wsModule = await import('ws');");
-    }
-    lines.push('      const WS: any = wsModule.default || wsModule;');
-    lines.push('      ws = new WS(url);');
-    lines.push('');
-    lines.push("      ws.on('open', () => {");
-    lines.push('        connected = true;');
-    lines.push('        // Send connect message');
-    lines.push('        ws.send(JSON.stringify({');
-    lines.push("          type: 'connect',");
-    lines.push('          sessionId,');
-    lines.push('          workflowExportName,');
-    lines.push('          clientInfo: {');
-    lines.push('            platform: process.platform,');
-    lines.push('            nodeVersion: process.version,');
-    lines.push('            pid: process.pid');
-    lines.push('          }');
-    lines.push('        }));');
-    lines.push('');
-    lines.push('        // Flush queued events');
-    lines.push('        while (queue.length > 0) {');
-    lines.push('          const msg = queue.shift();');
-    lines.push('          if (ws.readyState === 1) ws.send(msg);');
-    lines.push('        }');
-    lines.push('      });');
-    lines.push('');
-    lines.push("      ws.on('error', () => { connected = false; });");
-    lines.push("      ws.on('close', () => { connected = false; });");
-    lines.push('    } catch (err: unknown) {');
-    lines.push("      // Silently fail if 'ws' package not available");
-    lines.push("      console.warn('[Flow Weaver] Debug client failed to connect:', err instanceof Error ? err.message : String(err));");
-    lines.push('    }');
-    lines.push('  };');
-    lines.push('');
-    lines.push('  return {');
-    lines.push('    sendEvent: (event: unknown) => {');
-    lines.push("      const message = JSON.stringify({ type: 'event', sessionId, event });");
-    lines.push('      if (!ws) connect().catch(() => {});');
-    lines.push('      if (connected && ws.readyState === 1) {');
-    lines.push('        ws.send(message);');
-    lines.push('      } else {');
-    lines.push('        queue.push(message);');
-    lines.push('      }');
-    lines.push('    },');
-    lines.push('    innerFlowInvocation: false,');
-    lines.push('    sessionId');
-    lines.push('  };');
-    lines.push('}');
-    lines.push('/* eslint-enable @typescript-eslint/no-explicit-any, no-console */');
-    lines.push('');
-    const output = lines.join('\n');
-    if (outputFormat === 'javascript') {
-        return stripTypeScript(output);
-    }
-    return output;
-}
 /**
  * Generates a standalone runtime module file for multi-workflow bundles.
  * This exports all runtime types and classes so individual workflow files can import them.
@@ -595,14 +510,6 @@ export function generateStandaloneRuntimeModule(production, moduleFormat = 'esm'
     const inlineRuntime = generateInlineRuntime(production, true);
     lines.push(inlineRuntime);
     lines.push('');
-    // Include debug client in development mode
-    if (!production) {
-        const debugClient = generateInlineDebugClient(moduleFormat);
-        // Add export to the createFlowWeaverDebugClient function
-        const exportedDebugClient = debugClient.replace('function createFlowWeaverDebugClient', 'export function createFlowWeaverDebugClient');
-        lines.push(exportedDebugClient);
-        lines.push('');
-    }
     if (moduleFormat === 'cjs') {
         // CommonJS exports
         lines.push('// ============================================================================');
@@ -610,9 +517,6 @@ export function generateStandaloneRuntimeModule(production, moduleFormat = 'esm'
         lines.push('// ============================================================================');
         lines.push('');
         const exports = ['GeneratedExecutionContext', 'CancellationError'];
-        if (!production) {
-            exports.push('createFlowWeaverDebugClient', 'TDebugger');
-        }
         lines.push(`module.exports = { ${exports.join(', ')} };`);
     }
     // For ESM, exports are added via 'export' keyword in the generated code