foliko 2.0.7 → 2.0.9

package/.claude/settings.local.json

@@ -238,7 +238,8 @@
       "Bash(cmd //c \"D:\\\\\\\\tmp\\\\\\\\run-diag3.bat\")",
       "Bash(npm start *)",
       "Bash(xxd)",
-      "Bash(python fix_ext2.py)"
+      "Bash(python fix_ext2.py)",
+      "Bash(npx vitest *)"
     ]
   }
 }

package/.editorconfig

@@ -1,56 +1,56 @@
-# EditorConfig is awesome: https://EditorConfig.org
-
-# top-most EditorConfig file
-root = true
-
-# 代码文件
-[*]
-charset = utf-8
-end_of_line = lf
-insert_final_newline = true
-trim_trailing_whitespace = true
-
-# JavaScript / Node.js
-[*.{js,jsx,mjs,cjs}]
-indent_style = space
-indent_size = 2
-
-# TypeScript
-[*.{ts,tsx}]
-indent_style = space
-indent_size = 2
-
-# JSON
-[*.json]
-indent_style = space
-indent_size = 2
-
-# YAML
-[*.{yaml,yml}]
-indent_style = space
-indent_size = 2
-
-# Markdown
-[*.md]
-trim_trailing_whitespace = false
-indent_style = space
-indent_size = 2
-
-# Shell
-[*.sh]
-indent_style = space
-indent_size = 2
-
-# PowerShell
-[*.ps1]
-indent_style = space
-indent_size = 4
-
-# Dockerfile
-[Dockerfile]
-indent_style = space
-indent_size = 4
-
-# Makefile
-[Makefile]
-indent_style = tab
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# 代码文件
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+# JavaScript / Node.js
+[*.{js,jsx,mjs,cjs}]
+indent_style = space
+indent_size = 2
+
+# TypeScript
+[*.{ts,tsx}]
+indent_style = space
+indent_size = 2
+
+# JSON
+[*.json]
+indent_style = space
+indent_size = 2
+
+# YAML
+[*.{yaml,yml}]
+indent_style = space
+indent_size = 2
+
+# Markdown
+[*.md]
+trim_trailing_whitespace = false
+indent_style = space
+indent_size = 2
+
+# Shell
+[*.sh]
+indent_style = space
+indent_size = 2
+
+# PowerShell
+[*.ps1]
+indent_style = space
+indent_size = 4
+
+# Dockerfile
+[Dockerfile]
+indent_style = space
+indent_size = 4
+
+# Makefile
+[Makefile]
+indent_style = tab

package/.lintstagedrc

@@ -1,7 +1,7 @@
-{
-  "*.{js,jsx,ts,tsx}": ["prettier --write", "git add"],
-  "*.{json,yaml,yml}": ["prettier --write", "git add"],
-  "*.{md,mdx}": ["prettier --write", "git add"],
-  "*.{css,scss,less}": ["prettier --write", "git add"],
-  "*.{html,svg}": ["prettier --write", "git add"]
-}
+{
+  "*.{js,jsx,ts,tsx}": ["prettier --write", "git add"],
+  "*.{json,yaml,yml}": ["prettier --write", "git add"],
+  "*.{md,mdx}": ["prettier --write", "git add"],
+  "*.{css,scss,less}": ["prettier --write", "git add"],
+  "*.{html,svg}": ["prettier --write", "git add"]
+}

package/.prettierignore

@@ -1,29 +1,29 @@
-# 依赖
-node_modules/
-pnpm-lock.yaml
-yarn.lock
-package-lock.json
-
-# 构建输出
-dist/
-build/
-out/
-
-# 插件目录（第三方代码）
-plugins/
-
-# 测试报告
-reports/
-test_report.md
-
-# 配置文件（不需要格式化）
-.env
-.env.example
-
-# 静态资源
-images/
-audio/
-public/
-
-# 锁文件
-*.lock
+# 依赖
+node_modules/
+pnpm-lock.yaml
+yarn.lock
+package-lock.json
+
+# 构建输出
+dist/
+build/
+out/
+
+# 插件目录（第三方代码）
+plugins/
+
+# 测试报告
+reports/
+test_report.md
+
+# 配置文件（不需要格式化）
+.env
+.env.example
+
+# 静态资源
+images/
+audio/
+public/
+
+# 锁文件
+*.lock

package/.prettierrc

@@ -1,11 +1,11 @@
-{
-  "semi": true,
-  "singleQuote": true,
-  "tabWidth": 2,
-  "trailingComma": "es5",
-  "printWidth": 100,
-  "bracketSpacing": true,
-  "arrowParens": "always",
-  "endOfLine": "lf",
-  "plugins": []
-}
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "printWidth": 100,
+  "bracketSpacing": true,
+  "arrowParens": "always",
+  "endOfLine": "lf",
+  "plugins": []
+}

package/Dockerfile

@@ -1,63 +1,63 @@
-# ========== Foliko - 插件化 Agent 框架 ==========
-# 基于 Node.js 20 LTS
-
-FROM node:25-slim
-
-# 安装无头浏览器（Chromium）和构建工具
-RUN apt-get update && apt-get install -y --no-install-recommends \
-    build-essential \
-    python3 \
-    python3-pip \
-    curl \
-    git \
-    wget \
-    gnupg \
-    # Chromium 及依赖
-    chromium \
-    chromium-sandbox \
-    libnss3 \
-    libatk1.0-0 \
-    libatk-bridge2.0-0 \
-    libcups2 \
-    libdrm2 \
-    libxkbcommon0 \
-    libxcomposite1 \
-    libxdamage1 \
-    libxfixes3 \
-    libxrandr2 \
-    libgbm1 \
-    libasound2 \
-    libpango-1.0-0 \
-    libpangocairo-1.0-0 \
-    libgtk-3-0 \
-    fonts-liberation \
-    xdg-utils \
-    && rm -rf /var/lib/apt/lists/* \
-    && ln -sf /usr/bin/python3 /usr/bin/python \
-    && ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
-
-# 设置 Chromium 环境变量（无头模式运行）
-ENV PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium
-ENV PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true
-ENV CHROME_BIN=/usr/bin/chromium
-
-# 安装 uv（快速的 Python 包管理器）
-RUN curl -LsSf https://astral.sh/uv/install.sh | sh
-ENV PATH="/root/.local/bin:$PATH"
-
-# 设置工作目录
-WORKDIR /app
-
-# 全局安装 foliko CLI
-# RUN npm install -g foliko
-
-# 暴露端口
-# 3000: Web 服务端口
-EXPOSE 3000
-
-# 环境变量（可以在 docker-compose 或运行时覆盖）
-ENV NODE_ENV=production
-
-
-# 默认命令：运行聊天界面
-# CMD ["foliko", "chat"]
+# ========== Foliko - 插件化 Agent 框架 ==========
+# 基于 Node.js 20 LTS
+
+FROM node:25-slim
+
+# 安装无头浏览器（Chromium）和构建工具
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    python3 \
+    python3-pip \
+    curl \
+    git \
+    wget \
+    gnupg \
+    # Chromium 及依赖
+    chromium \
+    chromium-sandbox \
+    libnss3 \
+    libatk1.0-0 \
+    libatk-bridge2.0-0 \
+    libcups2 \
+    libdrm2 \
+    libxkbcommon0 \
+    libxcomposite1 \
+    libxdamage1 \
+    libxfixes3 \
+    libxrandr2 \
+    libgbm1 \
+    libasound2 \
+    libpango-1.0-0 \
+    libpangocairo-1.0-0 \
+    libgtk-3-0 \
+    fonts-liberation \
+    xdg-utils \
+    && rm -rf /var/lib/apt/lists/* \
+    && ln -sf /usr/bin/python3 /usr/bin/python \
+    && ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
+
+# 设置 Chromium 环境变量（无头模式运行）
+ENV PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium
+ENV PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true
+ENV CHROME_BIN=/usr/bin/chromium
+
+# 安装 uv（快速的 Python 包管理器）
+RUN curl -LsSf https://astral.sh/uv/install.sh | sh
+ENV PATH="/root/.local/bin:$PATH"
+
+# 设置工作目录
+WORKDIR /app
+
+# 全局安装 foliko CLI
+# RUN npm install -g foliko
+
+# 暴露端口
+# 3000: Web 服务端口
+EXPOSE 3000
+
+# 环境变量（可以在 docker-compose 或运行时覆盖）
+ENV NODE_ENV=production
+
+
+# 默认命令：运行聊天界面
+# CMD ["foliko", "chat"]

package/docs/public-api.md

@@ -718,13 +718,13 @@ framework.workflows.list();
 
 // 获取单个工作流定义
 framework.workflows.get('my-workflow');
-// { name, description, steps: [...], type }
+// { flow, version, stages: [...], description }
 
 // 检查工作流是否存在
 framework.workflows.has('my-workflow');  // true/false
 
-// 获取工作流引擎（用于创建步骤）
-framework.workflows.getEngine();  // WorkflowEngine 实例
+// 获取工作流引擎（v2 FlowEngine 实例，实际执行路径）
+framework.workflows.getEngine();
 ```
 
 #### 执行工作流

package/examples/workflow.js

@@ -1,106 +1,111 @@
 /**
- * 工作流示例
- * 展示如何使用工作流引擎
+ * 工作流示例（v2 格式）
+ * 展示如何使用工作流引擎的 JSON / JS / 内联 schema 三种入口
  */
 
 const foliko = require('../src');
 const { WorkflowPlugin } = require('../plugins/core/workflow');
 
 async function main() {
-  console.log('=== Workflow Example ===\n');
+  console.log('=== Workflow v2 Example ===\n');
 
   const framework = foliko.createApp({ debug: true });
 
   // 加载工作流插件
   await framework.loadPlugin(new WorkflowPlugin());
 
-  console.log('\n--- Testing Script Step ---');
+  // --------------------------------------------------------------
+  // 示例 1：内联 JSON（v2 schema: stages + action: "script"）
+  // --------------------------------------------------------------
+  console.log('\n--- Example 1: action:script stages ---');
   const result1 = await framework.executeTool('execute_workflow', {
     workflow: JSON.stringify({
-      steps: [
+      flow: 'calc',
+      version: '2.0',
+      description: '两个 script stage 顺序执行，结果通过 $.data 串联',
+      stages: [
         {
-          type: 'script',
-          name: 'Calculate',
-          script: `
-            const a = 10;
-            const b = 20;
-            context.variables.sum = a + b;
-            return a + b;
-          `,
+          name: 'sum',
+          action: 'script',
+          script: '$.data.sum = 10 + 20; return $.data.sum;',
         },
         {
-          type: 'script',
-          name: 'Multiply',
-          script: `
-            const sum = context.variables.sum;
-            context.variables.product = sum * 2;
-            return sum * 2;
-          `,
+          name: 'double',
+          action: 'script',
+          script: 'const sum = $.data.sum; $.data.product = sum * 2; return $.data.product;',
         },
       ],
     }),
     input: {},
   });
-  console.log('Result:', result1);
+  console.log('Result:', JSON.stringify(result1, null, 2));
 
-  console.log('\n--- Testing Loop Step ---');
+  // --------------------------------------------------------------
+  // 示例 2：each 循环（v2 schema: each + as + stages）
+  // --------------------------------------------------------------
+  console.log('\n--- Example 2: each loop ---');
   const result2 = await framework.executeTool('execute_workflow', {
     workflow: JSON.stringify({
-      steps: [
+      flow: 'loop-demo',
+      version: '2.0',
+      input: { items: ['a', 'b', 'c'] },
+      stages: [
         {
-          type: 'loop',
-          name: 'Loop 3 times',
-          maxIterations: 3,
-          loopVariable: 'i',
-          steps: [
+          name: 'process-items',
+          each: '{{input.items}}',
+          as: 'item',
+          index: 'i',
+          stages: [
             {
-              type: 'script',
-              name: 'Log iteration',
-              script: `console.log('Iteration ' + context.variables.i); return context.variables.i;`,
+              name: 'log',
+              action: 'script',
+              script: 'return `iter ${$.data.i} = ${$.data.item}`;',
             },
           ],
         },
       ],
     }),
-    input: {},
+    input: { items: ['a', 'b', 'c'] },
   });
-  console.log('Result:', result2);
+  console.log('Result:', JSON.stringify(result2, null, 2));
 
-  console.log('\n--- Testing Condition Step ---');
+  // --------------------------------------------------------------
+  // 示例 3：choice 分支（v2 schema: choice[] + default + 同级 stages）
+  // --------------------------------------------------------------
+  console.log('\n--- Example 3: choice routing ---');
   const result3 = await framework.executeTool('execute_workflow', {
     workflow: JSON.stringify({
-      steps: [
+      flow: 'route-by-value',
+      version: '2.0',
+      stages: [
         {
-          type: 'script',
-          name: 'Set value',
-          outputVariable: 'value',
-          script: `context.variables.value = 15; return 15;`,
+          name: 'set-value',
+          action: 'script',
+          script: '$.data.value = 15; return $.data.value;',
         },
         {
-          type: 'condition',
-          name: 'Check value',
-          branches: [
-            {
-              name: 'Greater than 10',
-              condition: 'context.variables.value > 10',
-              steps: [
-                { type: 'script', name: 'Log greater', script: `console.log('Value is greater than 10'); return 'greater';` },
-              ],
-            },
-            {
-              name: 'Less than or equal 10',
-              condition: 'context.variables.value <= 10',
-              steps: [
-                { type: 'script', name: 'Log less', script: `console.log('Value is less than or equal 10'); return 'less-or-equal';` },
-              ],
-            },
+          name: 'classify',
+          choice: [
+            { when: '$.data.value > 10', do: 'big' },
+            { when: '$.data.value <= 10', do: 'small' },
           ],
+          default: 'big',
+        },
+        {
+          name: 'big',
+          action: 'script',
+          script: 'return "value is greater than 10";',
+        },
+        {
+          name: 'small',
+          action: 'script',
+          script: 'return "value is less than or equal to 10";',
         },
       ],
     }),
     input: {},
   });
-  console.log('Result:', result3);
+  console.log('Result:', JSON.stringify(result3, null, 2));
 
   // 清理
   await foliko.destroy(framework);