72flow-nodejs 1.0.0 → 1.0.3

package/README.md

@@ -1,24 +1,24 @@
 # 72flow-nodejs
 
+[![NPM Version](https://img.shields.io/npm/v/72flow-nodejs.svg)](https://www.npmjs.com/package/72flow-nodejs)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
 [![TypeScript](https://img.shields.io/badge/TypeScript-6.x-blue)](https://www.typescriptlang.org/)
 [![Node.js](https://img.shields.io/badge/Node.js-18%2B-green)](https://nodejs.org/)
 
-72flow 工作流编排引擎的 **Node.js / TypeScript** 实现，支持在浏览器和 Node.js 双环境中运行，与 Java 后端引擎保持行为一致。
+**72flow-nodejs** 是 72flow 工作流编排引擎的轻量级 JavaScript 实现。它旨在提供一个与 Java 后端行为完全一致的、可在浏览器和 Node.js 环境中无缝运行的流程执行核心。
 
 ---
 
-## 特性
+## 核心特性
 
-- ✅ **多节点类型**：START、END、SCRIPT、DECISION、CONDITION、PARALLEL、LOOP、API、LLM
-- ✅ **浏览器 & Node.js 双运行时**：无需修改代码，同一套引擎在两端行为一致
-- ✅ **并行分支**：`PARALLEL` 节点自动并发触发分支，汇聚后继续执行
-- ✅ **条件分支**：`DECISION` / `CONDITION` 节点支持 JavaScript 表达式路由
-- ✅ **循环执行**：`LOOP` 节点支持数组/次数迭代，内联同步执行循环体
-- ✅ **LLM 集成**：内置 OpenAI / Qwen / Claude / Ollama 兼容接口
-- ✅ **事件系统**：引擎发射 `node.starting`、`node.completed`、`node.failed` 等事件
-- ✅ **X6 格式解析**：内置 `@antv/x6` 画布 JSON 格式解析器，直接对接前端图形编辑器
-- ✅ **ESM + CJS 双格式产物**：兼容各种打包场景
+- 🚀 **极轻量**：无重度依赖，压缩后产物极小。
+- ✅ **全能力节点**：支持 START、END、SCRIPT、DECISION、CONDITION、PARALLEL、LOOP、API、LLM 等 9 种核心节点。
+- ✅ **双运行时**：天然支持现代浏览器与 Node.js 18+ 环境。
+- ✅ **精准输出**：END 节点支持根据 `sourceCode` 路由特定节点的产物作为流程结果。
+- ✅ **脚本捕获**：SCRIPT 节点支持捕获显式 `return` 的值。
+- ✅ **X6 友好**：内置对 `@antv/x6` 导出的图形 JSON 的原生解析支持。
+- ✅ **事件驱动**：完整的生命周期钩子（starting, completed, failed）。
+- ✅ **零配置 LLM**：内置对 OpenAI 协议大模型的支持。
 
 ---
 
@@ -147,8 +147,8 @@ const result = await new FlowEngine().execute(flowDefinition, {});
 | 节点类型    | 说明                                             | 关键配置字段                                     |
 |-------------|--------------------------------------------------|-------------------------------------------------|
 | `START`     | 流程起始节点                                     | —                                               |
-| `END`       | 流程结束节点，输出所有变量                        | —                                               |
-| `SCRIPT`    | 执行 JavaScript 脚本，可读写流程变量              | `config.script`（字符串）                        |
+| `END`       | 流程结束周期。支持精准提取指定节点产物            | `config.outputResult.sourceCode`                |
+| `SCRIPT`    | 执行 JavaScript 脚本。支持 `scriptResult` 返回值   | `config.script.scriptCode`                      |
 | `DECISION`  | 运行脚本计算返回值，与出边 `condition` 字段匹配   | `config.decision.scriptCode`                    |
 | `CONDITION` | 对每条出边独立求值布尔表达式                       | `config.condition.scriptCode`                   |
 | `PARALLEL`  | 并发触发所有出边分支，需配合 `convergeMap` 使用   | `convergeMap` (流程定义级)                       |

package/dist/index.cjs

@@ -75,6 +75,8 @@ var FlowContext = class {
   nodeOutputs = {};
   convergeStates = /* @__PURE__ */ new Map();
   traces = [];
+  onStreamHandler;
+  streamingMode = false;
   constructor(executionId, definition, variables) {
     this.executionId = executionId;
     this.definition = definition;
@@ -82,6 +84,12 @@ var FlowContext = class {
     this.startTime = Date.now();
     this.buildIndex();
   }
+  setStreamingMode(enabled) {
+    this.streamingMode = enabled;
+  }
+  isStreamingEnabled() {
+    return this.streamingMode;
+  }
   /** 构造时预建索引，所有后续查询均为 O(1) */
   buildIndex() {
     for (const node of this.definition.nodes) {
@@ -202,6 +210,7 @@ var FlowContext = class {
       }
     }
     const durationMs = endTime - startTime;
+    const durationNs = durationMs * 1e6;
     this.traces.push({
       nodeId,
       code: node?.code ?? nodeId,
@@ -209,10 +218,19 @@ var FlowContext = class {
       startTime,
       endTime,
       duration: durationMs,
-      durationNs: durationMs * 1e6,
+      durationNs,
       // 毫秒 → 纳秒，与 Java 对齐
       data: output
     });
+    this.emitStream("__node_event__", {
+      type: "completed",
+      nodeId,
+      output,
+      startTime,
+      endTime,
+      duration: durationMs,
+      durationNs
+    });
   }
   fail(nodeId, error, startTime) {
     const endTime = Date.now();
@@ -253,6 +271,16 @@ var FlowContext = class {
   getLoopBodyPath(loopStartNodeId) {
     return this.definition.loopBodyPaths?.[loopStartNodeId] ?? [];
   }
+  /** 设置流式消息处理器（内部由 FlowEngine 调用以向外广播） */
+  setStreamHandler(handler) {
+    this.onStreamHandler = handler;
+  }
+  /** 发射流式消息块（由执行器调用） */
+  emitStream(nodeId, chunk) {
+    if (this.onStreamHandler) {
+      this.onStreamHandler(nodeId, chunk);
+    }
+  }
 };
 
 // src/support/logger.ts
@@ -321,6 +349,18 @@ var StartExecutor = class {
 };
 var EndExecutor = class {
   static execute(node, context) {
+    const cfg = node.config;
+    const sourceNodeCode = cfg?.outputResult?.sourceCode || cfg?.sourceCode || cfg?.end?.sourceCode;
+    if (sourceNodeCode) {
+      const allOutputs = context.getNodeOutputs();
+      const targetOutput = allOutputs[sourceNodeCode];
+      if (targetOutput !== void 0) {
+        log2.info(`END \u8282\u70B9 [${node.id}] \u5339\u914D\u5230 sourceCode=${sourceNodeCode}\uFF0C\u8FD4\u56DE\u6307\u5B9A\u8282\u70B9\u8F93\u51FA`);
+        return { success: true, data: targetOutput };
+      } else {
+        log2.warn(`END \u8282\u70B9 [${node.id}] sourceCode=${sourceNodeCode} \u672A\u627E\u5230\u76EE\u6807\u8282\u70B9\u8F93\u51FA\uFF0C\u56DE\u9000\u5230\u5168\u91CF\u53D8\u91CF`);
+      }
+    }
     return { success: true, data: context.getVariables() };
   }
 };
@@ -328,7 +368,7 @@ var ScriptExecutor = class {
   static execute(node, context) {
     const cfg = node.config;
     const scriptCfg = cfg?.script ?? {};
-    const scriptCode = typeof scriptCfg === "string" ? scriptCfg : scriptCfg?.scriptCode ?? scriptCfg?.code;
+    const scriptCode = typeof scriptCfg === "string" ? scriptCfg : scriptCfg?.scriptCode ?? scriptCfg?.code ?? cfg?.scriptCode ?? cfg?.code;
     const scriptType = String(scriptCfg?.scriptType ?? "javascript").toLowerCase();
     if (scriptType === "groovy") {
       log2.warn(`SCRIPT \u8282\u70B9 [${node.id}] \u4F7F\u7528 Groovy \u8BED\u6CD5\uFF0C\u6D4F\u89C8\u5668\u5F15\u64CE\u4E0D\u652F\u6301\uFF0C\u8BF7\u5207\u6362\u5230 Java \u6267\u884C\u6A21\u5F0F`);
@@ -358,11 +398,15 @@ var ScriptExecutor = class {
         // with(){} 需要 has 返回 true
       });
       const fn = new Function("__vars", `with(__vars) { ${scriptCode} }`);
-      fn(proxy);
+      const scriptResult = fn(proxy);
       for (const [k, v] of Object.entries(writes)) {
         context.setVariable(k, v);
       }
-      return { success: true, data: Object.keys(writes).length > 0 ? writes : null };
+      const resultData = { ...writes };
+      if (scriptResult !== void 0) {
+        resultData.scriptResult = scriptResult;
+      }
+      return { success: true, data: Object.keys(resultData).length > 0 ? resultData : null };
     } catch (e) {
       log2.error(`SCRIPT \u8282\u70B9 [${node.id}] \u6267\u884C\u5931\u8D25: ${e.message}`);
       return { success: false, message: e.message };
@@ -700,22 +744,59 @@ var LlmExecutor = class _LlmExecutor {
           "Content-Type": "application/json",
           "Authorization": `Bearer ${apiKey}`
         },
-        body: JSON.stringify({ model, messages, temperature, max_tokens: maxTokens })
+        body: JSON.stringify({
+          model,
+          messages,
+          temperature,
+          max_tokens: maxTokens,
+          stream: true
+          // 强制开启流式以支持吐字效果
+        })
       });
       if (!response.ok) {
         const err = await response.json().catch(() => ({ error: { message: response.statusText } }));
         return { success: false, message: `LLM \u8C03\u7528\u5931\u8D25: ${err?.error?.message ?? response.status}` };
       }
-      const data = await response.json();
-      const content = data.choices?.[0]?.message?.content ?? "";
-      const usage = data.usage ?? {};
+      const reader = response.body?.getReader();
+      const decoder = new TextDecoder();
+      let fullContent = "";
+      let modelId = model;
+      if (reader) {
+        while (true) {
+          const { done, value } = await reader.read();
+          if (done) break;
+          const chunk = decoder.decode(value);
+          const lines = chunk.split("\n");
+          for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed || !trimmed.startsWith("data: ")) continue;
+            const dataStr = trimmed.slice(6);
+            if (dataStr === "[DONE]") break;
+            try {
+              const json = JSON.parse(dataStr);
+              const delta = json.choices?.[0]?.delta?.content ?? "";
+              if (delta) {
+                fullContent += delta;
+                context.emitStream(node.id, { delta, fullContent });
+              }
+              if (json.model) modelId = json.model;
+            } catch (e) {
+            }
+          }
+        }
+      } else {
+        const data = await response.json();
+        fullContent = data.choices?.[0]?.message?.content ?? "";
+        modelId = data.model ?? model;
+      }
       return {
         success: true,
         data: {
-          llmResponse: content,
-          model: data.model ?? model,
-          inputTokens: usage.prompt_tokens ?? 0,
-          outputTokens: usage.completion_tokens ?? 0
+          llmResponse: fullContent,
+          model: modelId,
+          inputTokens: 0,
+          // 流式协议通常不包含实时 usage，需后期计算或忽略
+          outputTokens: 0
         }
       };
     } catch (e) {
@@ -783,10 +864,25 @@ var FlowEngine = class extends SimpleEmitter {
     super();
   }
   // ─── 公开入口 ────────────────────────────────────────────
-  async execute(definition, variables = {}) {
+  async execute(definition, variables = {}, options = {}) {
     const executionId = `exec-${Math.random().toString(36).slice(2, 10)}`;
     const context = new FlowContext(executionId, definition, variables);
+    if (options.stream !== void 0) {
+      context.setStreamingMode(options.stream);
+    }
     this.activeContexts.set(executionId, context);
+    context.setStreamHandler((nodeId, chunk) => {
+      if (nodeId === "__node_event__") {
+        const { type, ...payload } = chunk;
+        if (type === "completed") {
+          this.emit("node.completed", payload);
+        } else if (type === "failed") {
+          this.emit("node.failed", payload);
+        }
+      } else {
+        this.emit("node.stream", { executionId, nodeId, chunk });
+      }
+    });
     return new Promise((resolve) => {
       this.once(`flow.finished.${executionId}`, () => {
         this.activeContexts.delete(executionId);
@@ -914,10 +1010,12 @@ var FlowEngine = class extends SimpleEmitter {
   }
   // ─── 结果构建 ─────────────────────────────────────────
   buildResult(context) {
-    const outputs = context.getNodeOutputs();
-    const endOutput = Object.entries(outputs).find(
-      ([k]) => String(context.getNode(k)?.type ?? k).toUpperCase() === "END" || (k.startsWith("END") || k.startsWith("end"))
-    )?.[1];
+    const traces = context.getTraces();
+    const endTrace = [...traces].reverse().find((t) => {
+      const node = context.getNode(t.nodeId);
+      return (node?.type?.toUpperCase() === "END" || t.code?.startsWith("END")) && t.status === "COMPLETED" /* COMPLETED */;
+    });
+    const endOutput = endTrace ? endTrace.data : void 0;
     return {
       executionId: context.getExecutionId(),
       status: context.getStatus(),
@@ -996,6 +1094,11 @@ var X6Parser = class {
       cfg.api = this.normalizeApiField(cfg.api, "params");
       cfg.api = this.normalizeApiField(cfg.api, "headers");
     }
+    if (type === "SCRIPT") {
+      if (!cfg.script && cfg.scriptCode) {
+        cfg.script = { scriptCode: cfg.scriptCode, scriptType: cfg.scriptType ?? "javascript" };
+      }
+    }
     return cfg;
   }
   normalizeApiField(api, field) {

package/dist/index.d.cts

@@ -137,7 +137,11 @@ declare class FlowContext {
     private nodeOutputs;
     private convergeStates;
     private traces;
+    private onStreamHandler?;
+    private streamingMode;
     constructor(executionId: string, definition: FlowDefinition, variables: Record<string, any>);
+    setStreamingMode(enabled: boolean): void;
+    isStreamingEnabled(): boolean;
     /** 构造时预建索引，所有后续查询均为 O(1) */
     private buildIndex;
     getExecutionId(): string;
@@ -175,6 +179,10 @@ declare class FlowContext {
     tryConverge(nodeId: string, fromNodeId: string): boolean;
     /** 获取 LOOP_START 节点的循环体路径（来自解析器预计算的 loopBodyPaths） */
     getLoopBodyPath(loopStartNodeId: string): string[];
+    /** 设置流式消息处理器（内部由 FlowEngine 调用以向外广播） */
+    setStreamHandler(handler: (nodeId: string, chunk: any) => void): void;
+    /** 发射流式消息块（由执行器调用） */
+    emitStream(nodeId: string, chunk: any): void;
 }
 
 type EventHandler = (...args: any[]) => void;
@@ -188,7 +196,9 @@ declare class SimpleEmitter {
 declare class FlowEngine extends SimpleEmitter {
     private activeContexts;
     constructor();
-    execute(definition: FlowDefinition, variables?: Record<string, any>): Promise<FlowResult>;
+    execute(definition: FlowDefinition, variables?: Record<string, any>, options?: {
+        stream?: boolean;
+    }): Promise<FlowResult>;
     private scheduleNode;
     private runNode;
     /**

package/dist/index.d.ts

@@ -137,7 +137,11 @@ declare class FlowContext {
     private nodeOutputs;
     private convergeStates;
     private traces;
+    private onStreamHandler?;
+    private streamingMode;
     constructor(executionId: string, definition: FlowDefinition, variables: Record<string, any>);
+    setStreamingMode(enabled: boolean): void;
+    isStreamingEnabled(): boolean;
     /** 构造时预建索引，所有后续查询均为 O(1) */
     private buildIndex;
     getExecutionId(): string;
@@ -175,6 +179,10 @@ declare class FlowContext {
     tryConverge(nodeId: string, fromNodeId: string): boolean;
     /** 获取 LOOP_START 节点的循环体路径（来自解析器预计算的 loopBodyPaths） */
     getLoopBodyPath(loopStartNodeId: string): string[];
+    /** 设置流式消息处理器（内部由 FlowEngine 调用以向外广播） */
+    setStreamHandler(handler: (nodeId: string, chunk: any) => void): void;
+    /** 发射流式消息块（由执行器调用） */
+    emitStream(nodeId: string, chunk: any): void;
 }
 
 type EventHandler = (...args: any[]) => void;
@@ -188,7 +196,9 @@ declare class SimpleEmitter {
 declare class FlowEngine extends SimpleEmitter {
     private activeContexts;
     constructor();
-    execute(definition: FlowDefinition, variables?: Record<string, any>): Promise<FlowResult>;
+    execute(definition: FlowDefinition, variables?: Record<string, any>, options?: {
+        stream?: boolean;
+    }): Promise<FlowResult>;
     private scheduleNode;
     private runNode;
     /**

package/dist/index.js

@@ -42,6 +42,8 @@ var FlowContext = class {
   nodeOutputs = {};
   convergeStates = /* @__PURE__ */ new Map();
   traces = [];
+  onStreamHandler;
+  streamingMode = false;
   constructor(executionId, definition, variables) {
     this.executionId = executionId;
     this.definition = definition;
@@ -49,6 +51,12 @@ var FlowContext = class {
     this.startTime = Date.now();
     this.buildIndex();
   }
+  setStreamingMode(enabled) {
+    this.streamingMode = enabled;
+  }
+  isStreamingEnabled() {
+    return this.streamingMode;
+  }
   /** 构造时预建索引，所有后续查询均为 O(1) */
   buildIndex() {
     for (const node of this.definition.nodes) {
@@ -169,6 +177,7 @@ var FlowContext = class {
       }
     }
     const durationMs = endTime - startTime;
+    const durationNs = durationMs * 1e6;
     this.traces.push({
       nodeId,
       code: node?.code ?? nodeId,
@@ -176,10 +185,19 @@ var FlowContext = class {
       startTime,
       endTime,
       duration: durationMs,
-      durationNs: durationMs * 1e6,
+      durationNs,
       // 毫秒 → 纳秒，与 Java 对齐
       data: output
     });
+    this.emitStream("__node_event__", {
+      type: "completed",
+      nodeId,
+      output,
+      startTime,
+      endTime,
+      duration: durationMs,
+      durationNs
+    });
   }
   fail(nodeId, error, startTime) {
     const endTime = Date.now();
@@ -220,6 +238,16 @@ var FlowContext = class {
   getLoopBodyPath(loopStartNodeId) {
     return this.definition.loopBodyPaths?.[loopStartNodeId] ?? [];
   }
+  /** 设置流式消息处理器（内部由 FlowEngine 调用以向外广播） */
+  setStreamHandler(handler) {
+    this.onStreamHandler = handler;
+  }
+  /** 发射流式消息块（由执行器调用） */
+  emitStream(nodeId, chunk) {
+    if (this.onStreamHandler) {
+      this.onStreamHandler(nodeId, chunk);
+    }
+  }
 };
 
 // src/support/logger.ts
@@ -288,6 +316,18 @@ var StartExecutor = class {
 };
 var EndExecutor = class {
   static execute(node, context) {
+    const cfg = node.config;
+    const sourceNodeCode = cfg?.outputResult?.sourceCode || cfg?.sourceCode || cfg?.end?.sourceCode;
+    if (sourceNodeCode) {
+      const allOutputs = context.getNodeOutputs();
+      const targetOutput = allOutputs[sourceNodeCode];
+      if (targetOutput !== void 0) {
+        log2.info(`END \u8282\u70B9 [${node.id}] \u5339\u914D\u5230 sourceCode=${sourceNodeCode}\uFF0C\u8FD4\u56DE\u6307\u5B9A\u8282\u70B9\u8F93\u51FA`);
+        return { success: true, data: targetOutput };
+      } else {
+        log2.warn(`END \u8282\u70B9 [${node.id}] sourceCode=${sourceNodeCode} \u672A\u627E\u5230\u76EE\u6807\u8282\u70B9\u8F93\u51FA\uFF0C\u56DE\u9000\u5230\u5168\u91CF\u53D8\u91CF`);
+      }
+    }
     return { success: true, data: context.getVariables() };
   }
 };
@@ -295,7 +335,7 @@ var ScriptExecutor = class {
   static execute(node, context) {
     const cfg = node.config;
     const scriptCfg = cfg?.script ?? {};
-    const scriptCode = typeof scriptCfg === "string" ? scriptCfg : scriptCfg?.scriptCode ?? scriptCfg?.code;
+    const scriptCode = typeof scriptCfg === "string" ? scriptCfg : scriptCfg?.scriptCode ?? scriptCfg?.code ?? cfg?.scriptCode ?? cfg?.code;
     const scriptType = String(scriptCfg?.scriptType ?? "javascript").toLowerCase();
     if (scriptType === "groovy") {
       log2.warn(`SCRIPT \u8282\u70B9 [${node.id}] \u4F7F\u7528 Groovy \u8BED\u6CD5\uFF0C\u6D4F\u89C8\u5668\u5F15\u64CE\u4E0D\u652F\u6301\uFF0C\u8BF7\u5207\u6362\u5230 Java \u6267\u884C\u6A21\u5F0F`);
@@ -325,11 +365,15 @@ var ScriptExecutor = class {
         // with(){} 需要 has 返回 true
       });
       const fn = new Function("__vars", `with(__vars) { ${scriptCode} }`);
-      fn(proxy);
+      const scriptResult = fn(proxy);
       for (const [k, v] of Object.entries(writes)) {
         context.setVariable(k, v);
       }
-      return { success: true, data: Object.keys(writes).length > 0 ? writes : null };
+      const resultData = { ...writes };
+      if (scriptResult !== void 0) {
+        resultData.scriptResult = scriptResult;
+      }
+      return { success: true, data: Object.keys(resultData).length > 0 ? resultData : null };
     } catch (e) {
       log2.error(`SCRIPT \u8282\u70B9 [${node.id}] \u6267\u884C\u5931\u8D25: ${e.message}`);
       return { success: false, message: e.message };
@@ -667,22 +711,59 @@ var LlmExecutor = class _LlmExecutor {
           "Content-Type": "application/json",
           "Authorization": `Bearer ${apiKey}`
         },
-        body: JSON.stringify({ model, messages, temperature, max_tokens: maxTokens })
+        body: JSON.stringify({
+          model,
+          messages,
+          temperature,
+          max_tokens: maxTokens,
+          stream: true
+          // 强制开启流式以支持吐字效果
+        })
       });
       if (!response.ok) {
         const err = await response.json().catch(() => ({ error: { message: response.statusText } }));
         return { success: false, message: `LLM \u8C03\u7528\u5931\u8D25: ${err?.error?.message ?? response.status}` };
       }
-      const data = await response.json();
-      const content = data.choices?.[0]?.message?.content ?? "";
-      const usage = data.usage ?? {};
+      const reader = response.body?.getReader();
+      const decoder = new TextDecoder();
+      let fullContent = "";
+      let modelId = model;
+      if (reader) {
+        while (true) {
+          const { done, value } = await reader.read();
+          if (done) break;
+          const chunk = decoder.decode(value);
+          const lines = chunk.split("\n");
+          for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed || !trimmed.startsWith("data: ")) continue;
+            const dataStr = trimmed.slice(6);
+            if (dataStr === "[DONE]") break;
+            try {
+              const json = JSON.parse(dataStr);
+              const delta = json.choices?.[0]?.delta?.content ?? "";
+              if (delta) {
+                fullContent += delta;
+                context.emitStream(node.id, { delta, fullContent });
+              }
+              if (json.model) modelId = json.model;
+            } catch (e) {
+            }
+          }
+        }
+      } else {
+        const data = await response.json();
+        fullContent = data.choices?.[0]?.message?.content ?? "";
+        modelId = data.model ?? model;
+      }
       return {
         success: true,
         data: {
-          llmResponse: content,
-          model: data.model ?? model,
-          inputTokens: usage.prompt_tokens ?? 0,
-          outputTokens: usage.completion_tokens ?? 0
+          llmResponse: fullContent,
+          model: modelId,
+          inputTokens: 0,
+          // 流式协议通常不包含实时 usage，需后期计算或忽略
+          outputTokens: 0
         }
       };
     } catch (e) {
@@ -750,10 +831,25 @@ var FlowEngine = class extends SimpleEmitter {
     super();
   }
   // ─── 公开入口 ────────────────────────────────────────────
-  async execute(definition, variables = {}) {
+  async execute(definition, variables = {}, options = {}) {
     const executionId = `exec-${Math.random().toString(36).slice(2, 10)}`;
     const context = new FlowContext(executionId, definition, variables);
+    if (options.stream !== void 0) {
+      context.setStreamingMode(options.stream);
+    }
     this.activeContexts.set(executionId, context);
+    context.setStreamHandler((nodeId, chunk) => {
+      if (nodeId === "__node_event__") {
+        const { type, ...payload } = chunk;
+        if (type === "completed") {
+          this.emit("node.completed", payload);
+        } else if (type === "failed") {
+          this.emit("node.failed", payload);
+        }
+      } else {
+        this.emit("node.stream", { executionId, nodeId, chunk });
+      }
+    });
     return new Promise((resolve) => {
       this.once(`flow.finished.${executionId}`, () => {
         this.activeContexts.delete(executionId);
@@ -881,10 +977,12 @@ var FlowEngine = class extends SimpleEmitter {
   }
   // ─── 结果构建 ─────────────────────────────────────────
   buildResult(context) {
-    const outputs = context.getNodeOutputs();
-    const endOutput = Object.entries(outputs).find(
-      ([k]) => String(context.getNode(k)?.type ?? k).toUpperCase() === "END" || (k.startsWith("END") || k.startsWith("end"))
-    )?.[1];
+    const traces = context.getTraces();
+    const endTrace = [...traces].reverse().find((t) => {
+      const node = context.getNode(t.nodeId);
+      return (node?.type?.toUpperCase() === "END" || t.code?.startsWith("END")) && t.status === "COMPLETED" /* COMPLETED */;
+    });
+    const endOutput = endTrace ? endTrace.data : void 0;
     return {
       executionId: context.getExecutionId(),
       status: context.getStatus(),
@@ -963,6 +1061,11 @@ var X6Parser = class {
       cfg.api = this.normalizeApiField(cfg.api, "params");
       cfg.api = this.normalizeApiField(cfg.api, "headers");
     }
+    if (type === "SCRIPT") {
+      if (!cfg.script && cfg.scriptCode) {
+        cfg.script = { scriptCode: cfg.scriptCode, scriptType: cfg.scriptType ?? "javascript" };
+      }
+    }
     return cfg;
   }
   normalizeApiField(api, field) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "72flow-nodejs",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "Node.js / browser implementation of the 72flow orchestration engine",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -52,4 +52,3 @@
     "lodash-es": "^4.18.1"
   }
 }
-