foliko 2.0.6 → 2.0.8

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/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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foliko",
-  "version": "2.0.6",
+  "version": "2.0.8",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "type": "commonjs",
@@ -67,6 +67,7 @@
     "ai": "^6.0.146",
     "chalk": "^5.6.2",
     "cli-highlight": "^2.1.11",
+    "croner": "^9.1.0",
     "crypto": "^1.0.1",
     "diff": "^9.0.0",
     "dotenv": "^17.3.1",
@@ -79,9 +80,7 @@
     "mailparser": "^3.7.2",
     "marked": "^11.2.0",
     "marked-terminal": "6",
-    "node-cron": "^4.2.1",
     "node-html-markdown": "^1.3.0",
-    "node-schedule": "^2.1.1",
     "node-telegram-bot-api": "^0.67.0",
     "nodemailer": "^6.10.0",
     "pino": "7",

package/plugins/core/scheduler/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+## 2.0.0
+
+### Breaking Changes
+
+- **依赖替换**：移除 `node-schedule` 和未使用的 `node-cron`；改用 [`croner`](https://github.com/Hexagon/croner) 作为唯一调度引擎
+  - 用户配置（`schedule_task` 工具入参）完全兼容，无需改动
+- **持久化文件 schema 微调**：`tasks.json` 新增 `timezone` 字段；旧的 `cronTask` / `timer` 字段不再写盘（之前存的是非序列化对象，无意义）
+  - 旧版 `tasks.json` 可被新代码读取（多余字段被忽略），无需手动迁移
+- **删除内部 API**：`_taskStats`、`_checkTasks`、`_startScheduler` 整段不再存在（之前是 no-op 或死代码）
+
+### 行为变更
+
+- **事件循环阻塞自愈**：`croner` 用绝对时间戳校验触发时间。即使主线程被 LLM 流式响应 / 磁盘 IO 阻塞几十秒，进程恢复后**会自动 catch-up 错过的触发**（`catch: true`）
+- **过期一次性任务补触发**：进程重启后，若一次性任务本应触发的时间点已过但在 24h 容忍期内，**立即补触发一次**；超过 24h 则丢弃并 warn
+- **cron 任务重叠保护**：若上次任务尚未执行完（`protect: true`），下一次触发被跳过，避免并发
+- **持久化原子化**：`saveTasks` 改为先写 `.tmp` 再 `rename`，崩溃中途不会留下半残 JSON
+- **持久化 debounce**：500ms 内的多次 mutation 合并成一次写盘，减少 IO
+
+### 新增
+
+- `timezone` 配置项（默认 `Asia/Shanghai`，可通过 `config.timezone` 或环境变量 `TZ` 覆盖）
+- `unref: true` 调度器不阻塞进程退出（避免 CLI 关闭后定时任务不退出）
+- `schedule_list` 工具输出新增 `nextRun`（croner 的 `nextRun()` getter）和 `timezone` 字段
+
+### 修复
+
+- 每次 LLM 模式 cron tick 都会 `createSubAgent`，长期运行会漏内存。现在 `_schedulerSubAgent` 单例复用
+- shell / 普通 任务的重复代码路径已合并，统一通过 `_executeTask` 分发
+- 调度失败时不再静默 warn（`croner` 是硬依赖，启动时 require 失败直接抛）