foliko 1.1.93 → 2.0.1

package/examples/workflow.js

@@ -3,21 +3,18 @@
  * 展示如何使用工作流引擎
  */
 
-const { Framework } = require('../src');
-const { WorkflowPlugin } = require('../src/capabilities/workflow-engine');
+const foliko = require('../src');
+const { WorkflowPlugin } = require('../plugins/core/workflow');
 
 async function main() {
   console.log('=== Workflow Example ===\n');
 
-  // 创建框架
-  const framework = new Framework({ debug: true });
+  const framework = foliko.createApp({ debug: true });
 
   // 加载工作流插件
   await framework.loadPlugin(new WorkflowPlugin());
 
   console.log('\n--- Testing Script Step ---');
-
-  // 直接执行工作流
   const result1 = await framework.executeTool('execute_workflow', {
     workflow: JSON.stringify({
       steps: [
@@ -44,11 +41,9 @@ async function main() {
     }),
     input: {},
   });
-
   console.log('Result:', result1);
 
   console.log('\n--- Testing Loop Step ---');
-
   const result2 = await framework.executeTool('execute_workflow', {
     workflow: JSON.stringify({
       steps: [
@@ -61,10 +56,7 @@ async function main() {
             {
               type: 'script',
               name: 'Log iteration',
-              script: `
-                console.log('Iteration ' + context.variables.i);
-                return context.variables.i;
-              `,
+              script: `console.log('Iteration ' + context.variables.i); return context.variables.i;`,
             },
           ],
         },
@@ -72,11 +64,9 @@ async function main() {
     }),
     input: {},
   });
-
   console.log('Result:', result2);
 
   console.log('\n--- Testing Condition Step ---');
-
   const result3 = await framework.executeTool('execute_workflow', {
     workflow: JSON.stringify({
       steps: [
@@ -84,10 +74,7 @@ async function main() {
           type: 'script',
           name: 'Set value',
           outputVariable: 'value',
-          script: `
-            context.variables.value = 15;
-            return 15;
-          `,
+          script: `context.variables.value = 15; return 15;`,
         },
         {
           type: 'condition',
@@ -97,22 +84,14 @@ async function main() {
               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';`,
-                },
+                { 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';`,
-                },
+                { type: 'script', name: 'Log less', script: `console.log('Value is less than or equal 10'); return 'less-or-equal';` },
               ],
             },
           ],
@@ -121,37 +100,10 @@ async function main() {
     }),
     input: {},
   });
-
   console.log('Result:', result3);
 
-  console.log('\n--- Testing Delay ---');
-
-  const startTime = Date.now();
-  const result4 = await framework.executeTool('execute_workflow', {
-    workflow: JSON.stringify({
-      steps: [
-        {
-          type: 'delay',
-          name: 'Wait 500ms',
-          delayMs: 500,
-        },
-        {
-          type: 'script',
-          name: 'Check elapsed',
-          script: `
-            const elapsed = Date.now() - context.variables.startTime;
-            return { elapsed: elapsed, expected: 500 };
-          `,
-        },
-      ],
-    }),
-    input: {},
-  });
-
-  console.log('Result:', result4);
-
   // 清理
-  await framework.destroy();
+  await foliko.destroy(framework);
   console.log('\n[Done]');
 }
 

package/package.json

@@ -1,19 +1,22 @@
 {
   "name": "foliko",
-  "version": "1.1.93",
+  "version": "2.0.1",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "type": "commonjs",
   "bin": {
-    "foliko": "./cli/bin/foliko.js"
+    "foliko": "./src/cli/bin.js"
   },
   "scripts": {
     "start": "node examples/basic.js",
-    "chat": "node cli/bin/foliko.js chat",
+    "chat": "node src/cli/bin.js chat",
+    "chat:old": "node src/cli/bin.js chat --old",
     "dev": "node --watch examples/basic.js",
     "lint": "echo \"No linter configured\"",
     "format": "prettier --write \"**/*.{js,jsx,ts,tsx,json,yaml,yml,md,css,html}\"",
     "format:check": "prettier --check \"**/*.{js,jsx,ts,tsx,json,yaml,yml,md,css,html}\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "prepare": "husky"
   },
   "lint-staged": {
@@ -90,6 +93,7 @@
   "devDependencies": {
     "husky": "^9.1.7",
     "lint-staged": "^16.4.0",
-    "prettier": "^3.8.1"
+    "prettier": "^3.8.1",
+    "vitest": "^4.1.9"
   }
 }

package/plugins/README.md

@@ -0,0 +1,49 @@
+# Foliko 内置插件
+
+插件按职能分组：
+
+## `core/` 核心插件
+- **ai** - AI 对话能力
+- **default** - 默认插件加载与 bootstrap 配置
+- **tool-manager** - 工具管理
+- **plugin-manager** - 远程插件管理
+- **session** - 多会话管理
+- **sub-agent** - 子 Agent 管理
+- **coordinator** - Coordinator 模式
+- **scheduler** - 定时任务调度
+- **skill-manager** - 技能管理
+- **workflow** - 工作流引擎
+- **mcp** - MCP 协议集成
+- **storage** - 键值存储
+- **audit** - 审计日志
+- **rules** - 权限/内容规则
+- **think** - 主动思考
+
+## `executors/` 执行器
+- **shell** - Shell 命令执行
+- **python** - Python 代码/脚本执行
+- **extension** - 扩展插件执行器
+- **data-splitter** - 大数据自动分拆
+
+## `io/` 输入输出
+- **file-system** - 文件系统操作
+- **web** - HTTP 服务与 Webhook
+
+## `messaging/` 消息集成
+- **email** - SMTP/IMAP 邮件
+- **telegram** - Telegram 机器人
+- **qq** - QQ 机器人
+- **weixin** - 微信机器人
+- **feishu** - 飞书机器人
+
+## `memory/` 记忆
+- **memory-plugin** - 四层记忆系统
+
+## `ambient/` Ambient Agent
+- **ambient-agent** - 持续后台运行
+
+## `install/` 安装
+- **install-plugin** - npm 包自动安装
+
+## `trading/` 交易
+- **gate-trading** - Gate.io API 交易

package/plugins/{ambient-agent → ambient}/EventWatcher.js

@@ -2,7 +2,7 @@
  * EventWatcher - 订阅框架事件，筛选相关事件
  */
 
-const { logger } = require('../../src/utils/logger')
+const { logger } = require('../../src/common/logger')
 const { DefaultEvents } = require('./constants')
 
 const log = logger.child('Ambient:EventWatcher')

package/plugins/{ambient-agent → ambient}/ExplorerLoop.js

@@ -2,9 +2,9 @@
  * ExplorerLoop - 主自主循环，决定并执行操作
  */
 
-const { Plugin } = require('../../src/core/plugin-base')
-const { logger } = require('../../src/utils/logger')
-const { StepExecutor } = require('../../src/capabilities/workflow-engine')
+const { Plugin } = require('../../src/plugin/base')
+const { logger } = require('../../src/common/logger')
+const { StepExecutor } = require('../../plugins/core/workflow')
 const { SystemPrompts, ThinkModePrompts, FreeThinkPrompts } = require('./constants')
 
 const log = logger.child('Ambient:ExplorerLoop')

package/plugins/{ambient-agent → ambient}/GoalManager.js

@@ -2,9 +2,9 @@
  * GoalManager - 管理目标及其生命周期状态
  */
 
-const { logger } = require('../../src/utils/logger')
+const { logger } = require('../../src/common/logger')
 const { GoalState } = require('./constants')
-const { generateId } = require('../../src/utils/id')
+const { generateId } = require('../../src/common/id')
 
 const log = logger.child('Ambient:GoalManager')
 

package/plugins/ambient/README.md

@@ -0,0 +1,14 @@
+# Ambient Agent
+
+主动式后台 Agent，持续观察环境、设定目标、自主思考和执行。
+
+## 依赖
+
+- core/ai (AI 对话能力)
+- core/workflow (工作流引擎)
+- core/storage (键值存储)
+
+## 配置
+
+可通过 `config.ambient` 在 plugins.json 中配置：
+- `persistencePath` — 持久化路径，默认 `.foliko/data/ambient`

package/plugins/{ambient-agent → ambient}/Reflector.js

@@ -2,7 +2,7 @@
  * Reflector - 评估操作结果，更新目标状态
  */
 
-const { logger } = require('../../src/utils/logger')
+const { logger } = require('../../src/common/logger')
 
 const log = logger.child('Ambient:Reflector')
 

package/plugins/{ambient-agent → ambient}/StateStore.js

@@ -4,7 +4,7 @@
 
 const fs = require('fs')
 const path = require('path')
-const { logger } = require('../../src/utils/logger')
+const { logger } = require('../../src/common/logger')
 
 const log = logger.child('Ambient:StateStore')
 

package/plugins/{ambient-agent → ambient}/index.js

@@ -3,8 +3,8 @@
  * 持续后台运行的智能代理，监控事件并主动执行操作
  */
 
-const { Plugin } = require('../../src/core/plugin-base')
-const { logger } = require('../../src/utils/logger')
+const { Plugin } = require('../../src/plugin/base')
+const { logger } = require('../../src/common/logger')
 const { z } = require('zod')
 
 // 导入子模块

package/plugins/{ai-plugin.js → core/ai/index.js}

@@ -3,10 +3,10 @@
  * 提供 AI 对话能力
  */
 
-const { Plugin } = require('../src/core/plugin-base')
-const { logger } = require('../src/utils/logger')
+const { Plugin } = require('../../../src/plugin/base')
+const { logger } = require('../../../src/common/logger')
 const log = logger.child('AIPlugin')
-const { createAI } = require('../src/core/provider')
+const { LLMProvider } = require('../../../src/llm/provider')
 
 class AIPlugin extends Plugin {
   constructor(config = {}) {
@@ -14,8 +14,8 @@ class AIPlugin extends Plugin {
     this.name = 'ai'
     this.version = '1.0.0'
     this.description = 'AI 对话能力插件'
-    this.priority = 1  // 最先加载
-    this.system = true 
+    this.priority = 1
+    this.system = true
 
     this.config = {
       provider: config.provider || 'deepseek',
@@ -23,9 +23,10 @@ class AIPlugin extends Plugin {
       apiKey: config.apiKey,
       baseURL: config.baseURL,
       maxSteps: config.maxSteps || 20,
-      maxOutputTokens:config.maxOutputTokens||parseInt(process.env.MAX_OUTPUT_TOKENS)||8192
+      maxOutputTokens: config.maxOutputTokens || parseInt(process.env.MAX_OUTPUT_TOKENS) || 8192,
     }
 
+    this._llmProvider = null
     this._aiClient = null
     this._framework = null
   }
@@ -37,63 +38,46 @@ class AIPlugin extends Plugin {
   }
 
   start(framework) {
-    // AI client 已在 install 中初始化
     return this
   }
 
   _initAIClient() {
-
     if (!this.config.apiKey) {
       log.warn(' No API key provided, AI features disabled')
       return
     }
     try {
-      const provider = createAI({
-        provider: this.config.provider,
-        model: this.config.model,
-        apiKey: this.config.apiKey,
-        baseURL: this.config.baseURL
-      })
-
-      // 创建模型实例
-      this._aiClient = provider(this.config.model)
-      //log.info(` Initialized ${this.config.provider}/${this.config.model}`)
+      this._llmProvider = new LLMProvider(this.config)
+      this._aiClient = this._llmProvider.createModel()
     } catch (err) {
       log.error(' Failed to initialize AI client:', err.message)
     }
   }
 
-  /**
-   * 获取 AI 客户端
-   * @returns {Object} AI 模型客户端
-   */
   getAIClient() {
     return this._aiClient
   }
 
-  /**
-   * 获取配置
-   * @returns {Object}
-   */
+  getLLMProvider() {
+    return this._llmProvider
+  }
+
   getConfig() {
     return { ...this.config }
   }
 
   reload(framework) {
-    //log.info(' Reloading...')
     this._framework = framework
     this._initAIClient()
-
-    // 刷新所有已有 Agent 的 AI client
     for (const agent of framework._agents || []) {
       if (agent._chatHandler) {
         agent._chatHandler.setAIClient(this._aiClient)
-        //log.info(` Refreshed AI client for agent: ${agent.name}`)
       }
     }
   }
 
   uninstall(framework) {
+    this._llmProvider = null
     this._aiClient = null
     this._framework = null
   }

package/plugins/{audit-plugin.js → core/audit/index.js}

@@ -4,8 +4,8 @@
  * 基于 Pino 日志系统
  */
 
-const { Plugin } = require('../src/core/plugin-base')
-const { logger } = require('../src/utils/logger')
+const { Plugin } = require('../../../src/plugin/base')
+const { logger } = require('../../../src/common/logger')
 const { z } = require('zod')
 const path = require('path')
 const fs = require('fs')
@@ -30,29 +30,22 @@ class AuditPlugin extends Plugin {
     this._logIdCounter = 0
     this._auditLogger = null
     this._auditLogFile = null
-    this._queryLogs = [] // 内存缓存用于查询
+    this._queryLogs = []
     this._initAuditLogger()
   }
 
-  /**
-   * 初始化审计日志器
-   */
   _initAuditLogger() {
     const pino = require('pino')
 
-    // 确保目录存在
     if (!fs.existsSync(this.config.logDir)) {
       fs.mkdirSync(this.config.logDir, { recursive: true })
     }
 
-    // 审计日志文件名
     const date = new Date().toISOString().split('T')[0]
     this._auditLogFile = path.join(this.config.logDir, `audit-${date}.jsonl`)
 
-    // 创建文件写入流
     const fileStream = fs.createWriteStream(this._auditLogFile, { flags: 'a' })
 
-    // 创建专门的审计 logger
     this._auditLogger = pino({
       name: 'audit',
       level: 'info',
@@ -66,7 +59,6 @@ class AuditPlugin extends Plugin {
   install(framework) {
     this._framework = framework
 
-    // 监听框架事件
     framework.on('tool:call', (data) => this._log('tool_call', data))
     framework.on('tool-call', (data) => this._log('tool_call', data))
     framework.on('tool:result', (data) => this._log('tool_result', data))
@@ -77,7 +69,6 @@ class AuditPlugin extends Plugin {
   }
 
   start(framework) {
-    // 注册审计查询工具
     framework.registerTool({
       name: 'audit_query',
       description: '查询审计日志',
@@ -146,9 +137,6 @@ class AuditPlugin extends Plugin {
     return this
   }
 
-  /**
-   * 记录日志
-   */
   _log(type, data) {
     const log = {
       id: ++this._logIdCounter,
@@ -157,7 +145,6 @@ class AuditPlugin extends Plugin {
       timestamp: new Date().toISOString()
     }
 
-    // 写入审计日志文件
     if (this._auditLogger) {
       this._auditLogger.info({
         auditId: log.id,
@@ -166,10 +153,8 @@ class AuditPlugin extends Plugin {
       }, 'audit event')
     }
 
-    // 缓存到内存用于查询
     this._queryLogs.push(log)
 
-    // 限制缓存数量
     if (this._queryLogs.length > this.config.maxLogs) {
       this._queryLogs = this._queryLogs.slice(-this.config.maxLogs)
     }
@@ -177,9 +162,6 @@ class AuditPlugin extends Plugin {
     return log
   }
 
-  /**
-   * 获取统计信息
-   */
   getStats() {
     const counts = {}
     for (const log of this._queryLogs) {
@@ -196,18 +178,13 @@ class AuditPlugin extends Plugin {
     }
   }
 
-  /**
-   * 导出日志
-   */
   exportLogs(options = {}) {
     let logs = [...this._queryLogs]
 
-    // 按类型过滤
     if (options.type) {
       logs = logs.filter(log => log.type === options.type)
     }
 
-    // 按日期过滤
     if (options.startDate) {
       const start = new Date(options.startDate)
       logs = logs.filter(log => new Date(log.timestamp) >= start)
@@ -221,9 +198,6 @@ class AuditPlugin extends Plugin {
     return { logs }
   }
 
-  /**
-   * 手动记录日志
-   */
   log(type, data) {
     return this._log(type, data)
   }
@@ -235,7 +209,6 @@ class AuditPlugin extends Plugin {
   uninstall(framework) {
     this._queryLogs = []
     if (this._auditLogger) {
-      // 关闭文件流
     }
     this._auditLogger = null
     this._framework = null

package/plugins/{coordinator-plugin.js → core/coordinator/index.js}

@@ -7,9 +7,9 @@
  * - list_workers: 列出Worker
  */
 
-const { Plugin } = require('../src/core/plugin-base');
+const { Plugin } = require('../../../src/plugin/base');
 const { z } = require('zod');
-const { logger } = require('../src/utils/logger');
+const { logger } = require('../../../src/common/logger');
 
 const log = logger.child('CoordinatorPlugin');
 
@@ -33,24 +33,17 @@ class CoordinatorPlugin extends Plugin {
   start(framework) {
     this._framework = framework;
 
-    // 初始化CoordinatorManager（如果尚未初始化）
     if (!framework._coordinatorManager) {
-      // framework.initCoordinatorManager 会创建并设置
     }
 
-    // 获取主Agent作为默认的Coordinator
     const mainAgent = framework._mainAgent;
     if (mainAgent) {
-      // 初始化CoordinatorManager并传入coordinatorAgent
       framework.initCoordinatorManager(mainAgent);
 
-      // 注册Coordinator工具到主Agent
       this.registerTools(mainAgent);
 
-      // 注册系统提示词部分，让Agent知道如何使用Coordinator模式
       this._registerCoordinatorPrompt(mainAgent);
 
-      // 监听Worker事件用于生成通知
       this._setupWorkerEventListeners(framework);
 
       log.debug(' Coordinator plugin initialized with main agent');
@@ -59,10 +52,6 @@ class CoordinatorPlugin extends Plugin {
     return this;
   }
 
-  /**
-   * 注册Coordinator模式提示词到Agent
-   * @private
-   */
   _registerCoordinatorPrompt(agent) {
     if (!agent || typeof agent.registerPromptPart !== 'function' || !this.enabled) {
       return;
@@ -91,45 +80,28 @@ class CoordinatorPlugin extends Plugin {
 `);
   }
 
-  /**
-   * 设置Worker事件监听器
-   * @private
-   */
   _setupWorkerEventListeners(framework) {
     const coordinatorManager = framework.getCoordinatorManager();
     if (!coordinatorManager) return;
 
-    // 监听Worker完成事件
     coordinatorManager.on('worker:completed', (data) => {
-      // 通知会被发送到Coordinator Agent的事件队列
       framework.emit('coordinator:worker-completed', data);
     });
 
-    // 监听Worker错误事件
     coordinatorManager.on('worker:error', (data) => {
       framework.emit('coordinator:worker-error', data);
     });
 
-    // 监听Worker停止事件
     coordinatorManager.on('worker:stopped', (data) => {
       framework.emit('coordinator:worker-stopped', data);
     });
   }
 
-  /**
-   * 设置Coordinator Agent
-   * @param {Agent} agent - Coordinator Agent实例
-   */
   setCoordinatorAgent(agent) {
     this._coordinatorAgent = agent;
   }
 
-  /**
-   * 注册Coordinator工具到指定Agent
-   * @param {Agent} agent - Agent实例
-   */
   registerTools(agent) {
-    // spawn_worker - 创建Worker
     agent.registerTool({
       name: 'spawn_worker',
       description: '创建一个独立的Worker Agent来执行任务。默认会等待Worker完成后再返回结果。',
@@ -151,7 +123,7 @@ class CoordinatorPlugin extends Plugin {
             task: args.task,
             systemPrompt: args.system_prompt,
             tools: args.tools,
-            waitForCompletion: true, // 默认等待Worker完成
+            waitForCompletion: true,
           });
 
           return {
@@ -171,7 +143,6 @@ class CoordinatorPlugin extends Plugin {
       },
     });
 
-    // send_message_to_worker - 继续Worker
     agent.registerTool({
       name: 'send_message_to_worker',
       description: '向指定的Worker发送消息，继续其执行',
@@ -198,7 +169,6 @@ class CoordinatorPlugin extends Plugin {
       },
     });
 
-    // stop_worker - 停止Worker
     agent.registerTool({
       name: 'stop_worker',
       description: '停止指定的Worker',
@@ -224,7 +194,6 @@ class CoordinatorPlugin extends Plugin {
       },
     });
 
-    // list_workers - 列出Worker
     agent.registerTool({
       name: 'list_workers',
       description: '列出所有活跃的Worker',
@@ -244,7 +213,6 @@ class CoordinatorPlugin extends Plugin {
       },
     });
 
-    // get_worker - 获取Worker详情
     agent.registerTool({
       name: 'get_worker',
       description: '获取指定Worker的详细信息',