72flow-nodejs 1.0.2 → 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
@@ -716,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) {
@@ -799,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);

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
@@ -683,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) {
@@ -766,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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "72flow-nodejs",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Node.js / browser implementation of the 72flow orchestration engine",
   "type": "module",
   "main": "./dist/index.cjs",