foliko 1.1.93 → 2.0.1

package/plugins/{web-plugin.js → io/web/index.js}

@@ -3,9 +3,9 @@
  * 支持 HTTP 服务、路由注册、Webhook（自动生成 /webhook/{id} 链接）
  */
 
-const { Plugin } = require('../src/core/plugin-base')
-const { logger } = require('../src/utils/logger')
-const { runInSandbox } = require('../src/utils/sandbox')
+const { Plugin } = require('../../../src/plugin/base')
+const { logger } = require('../../../src/common/logger')
+const { runInSandbox } = require('../../../src/utils/sandbox')
 const log = logger.child('Web')
 const { z } = require('zod')
 const { serve } = require('@hono/node-server')
@@ -13,9 +13,6 @@ const { Hono } = require('hono')
 const fs = require('fs')
 const path = require('path')
 
-// ============================================================================
-// WebStore - 持久化 Web 配置到 .foliko/data/web/
-// ============================================================================
 class WebStore {
   constructor(persistencePath) {
     this._persistencePath = persistencePath
@@ -61,43 +58,34 @@ class WebPlugin extends Plugin {
     this.description = 'Web 服务插件，支持 HTTP 服务、路由注册、Webhook'
     this.priority = 50
 
-    this.system = true 
+    this.system = true
 
-    // 服务器配置
     this._port = process.env.WEB_PORT || 3000
     this._host = process.env.WEB_HOST || '127.0.0.1'
-    this._baseUrl = process.env.WEB_BASE_URL || null  // 公网可访问的域名
+    this._baseUrl = process.env.WEB_BASE_URL || null
 
-    // 运行时状态
     this._server = null
     this._app = null
     this._framework = null
 
     this.tools = {}
 
-    // 数据存储（始终保持原始类型）
-    this._routes = []           // 路由列表
-    this._webhooks = new Map()  // webhook Map: id -> {id, path, prompt, sessionId}
-    this._statics = []          // 静态文件夹列表
+    this._routes = []
+    this._webhooks = new Map()
+    this._statics = []
 
-    // 持久化存储
     this._webStore = null
     this._persistencePath = config.persistencePath || '.foliko/data/web'
   }
 
-  // ==================== 生命周期 ====================
-
   install(framework) {
     this._framework = framework
     this._registerTools()
 
-    // 初始化持久化存储
     this._webStore = new WebStore(this._persistencePath)
 
-    // 加载已保存的配置
     this._loadPersistedConfig()
 
-    // 将 WEB_BASE_URL 注入到 framework 的元数据，供所有 agent 使用
     if (this._baseUrl && framework._mainAgent) {
       framework._mainAgent.setMetadata('WEB_BASE_URL', this._baseUrl)
     }
@@ -112,28 +100,20 @@ class WebPlugin extends Plugin {
   reload(framework) {
     this._framework = framework
 
-    // 重新初始化存储并加载配置
     this._webStore = new WebStore(this._persistencePath)
     this._loadPersistedConfig()
 
-    // 重新注入 WEB_BASE_URL
     if (this._baseUrl && framework._mainAgent) {
       framework._mainAgent.setMetadata('WEB_BASE_URL', this._baseUrl)
     }
   }
 
-  /**
-   * 加载持久化的配置并恢复路由/webhook/静态资源
-   */
   _loadPersistedConfig() {
     if (!this._webStore) return
 
     const config = this._webStore.loadConfig()
     if (!config) return
 
-    // log.info(` 加载 Web 配置...`)
-
-    // 恢复前先清空，避免 install -> reload 重复加载导致数据翻倍
     this._routes = []
     this._webhooks = new Map()
     this._statics = []
@@ -142,7 +122,6 @@ class WebPlugin extends Plugin {
     let hasWebhooks = false
     let hasStatics = false
 
-    // 恢复路由
     if (config.routes && Array.isArray(config.routes)) {
       for (const route of config.routes) {
         if (route.method && route.path && route.handler) {
@@ -153,12 +132,10 @@ class WebPlugin extends Plugin {
             description: route.description || ''
           })
           hasRoutes = true
-          // log.info(` 恢复路由: ${route.method} ${route.path}`)
         }
       }
     }
 
-    // 恢复 Webhooks
     if (config.webhooks && Array.isArray(config.webhooks)) {
       for (const webhook of config.webhooks) {
         if (webhook.id && webhook.path) {
@@ -169,12 +146,10 @@ class WebPlugin extends Plugin {
             awaitResponse: webhook.awaitResponse || false
           })
           hasWebhooks = true
-          // log.info(` 恢复 Webhook: ${webhook.path}`)
         }
       }
     }
 
-    // 恢复静态资源
     if (config.statics && Array.isArray(config.statics)) {
       for (const staticItem of config.statics) {
         if (staticItem.urlPath && staticItem.folder) {
@@ -184,23 +159,17 @@ class WebPlugin extends Plugin {
             options: staticItem.options || { dotfiles: 'ignore', index: 'index.html' }
           })
           hasStatics = true
-          // log.info(` 恢复静态资源: ${staticItem.urlPath} -> ${staticItem.folder}`)
         }
       }
     }
 
-    // 如果有恢复的路由/webhook/静态资源，自动启动服务器
     if ((hasRoutes || hasWebhooks || hasStatics) && !this._server) {
-      // log.info(` 恢复的 Web 配置需要启动服务器...`)
       this._startServer().catch(err => {
         log.error(` 自动启动服务器失败:`, err.message)
       })
     }
   }
 
-  /**
-   * 保存当前配置到持久化存储
-   */
   _saveConfig() {
     if (!this._webStore) return
 
@@ -232,10 +201,7 @@ class WebPlugin extends Plugin {
     this._framework = null
   }
 
-  // ==================== 工具注册 ====================
-
   _registerTools() {
-    // 启动 Web 服务
     this.tools.web_start = {
       name: 'web_start',
       description: '启动 Web 服务',
@@ -246,7 +212,6 @@ class WebPlugin extends Plugin {
       execute: async (args) => this._startServer(args.port, args.host)
     }
 
-    // 停止 Web 服务
     this.tools.web_stop = {
       name: 'web_stop',
       description: '停止 Web 服务',
@@ -254,7 +219,6 @@ class WebPlugin extends Plugin {
       execute: async () => this._stopServer()
     }
 
-    // 注册 HTTP 路由
     this.tools.web_register_route = {
       name: 'web_register_route',
       description: '注册 HTTP 路由',
@@ -272,7 +236,6 @@ class WebPlugin extends Plugin {
       execute: async (args) => this._registerRoute(args.method, args.path, args.handler, args.description)
     }
 
-    // 注册 Webhook（自动生成 /webhook/{id} 链接）
     this.tools.web_register_webhook = {
       name: 'web_register_webhook',
       description: '注册 Webhook，接收的数据会交给 LLM 处理。自动生成唯一 URL',
@@ -283,7 +246,6 @@ class WebPlugin extends Plugin {
       execute: async (args) => this._registerWebhook(args.prompt, args.awaitResponse)
     }
 
-    // 注册静态资源
     this.tools.web_register_static = {
       name: 'web_register_static',
       description: '注册静态资源文件夹',
@@ -298,7 +260,6 @@ class WebPlugin extends Plugin {
       execute: async (args) => this._registerStatic(args.urlPath, args.folder, args.options)
     }
 
-    // 列出所有路由
     this.tools.web_list_routes = {
       name: 'web_list_routes',
       description: '列出所有已注册的路由和 Webhook',
@@ -306,7 +267,6 @@ class WebPlugin extends Plugin {
       execute: async () => this._listRoutes()
     }
 
-    // 删除路由
     this.tools.web_delete_route = {
       name: 'web_delete_route',
       description: '删除已注册的 HTTP 路由',
@@ -317,7 +277,6 @@ class WebPlugin extends Plugin {
       execute: async (args) => this._deleteRoute(args.method, args.path)
     }
 
-    // 删除 Webhook
     this.tools.web_delete_webhook = {
       name: 'web_delete_webhook',
       description: '删除已注册的 Webhook',
@@ -327,7 +286,6 @@ class WebPlugin extends Plugin {
       execute: async (args) => this._deleteWebhook(args.id)
     }
 
-    // 删除静态资源
     this.tools.web_delete_static = {
       name: 'web_delete_static',
       description: '删除已注册的静态资源文件夹',
@@ -337,7 +295,6 @@ class WebPlugin extends Plugin {
       execute: async (args) => this._deleteStatic(args.urlPath)
     }
 
-    // 发送 HTTP 请求
     this.tools.web_request = {
       name: 'web_request',
       description: '发送 HTTP 请求',
@@ -351,8 +308,6 @@ class WebPlugin extends Plugin {
     }
   }
 
-  // ==================== 服务器控制 ====================
-
   async _startServer(port, host) {
     if (this._server) {
       return { success: true, message: 'Server already running', port: this._port }
@@ -371,14 +326,11 @@ class WebPlugin extends Plugin {
         hostname: this._host
       })
       const serverUrl = this._getUrl()
-      // log.info(` Server started on ${serverUrl}`)
       return {
         success: true,
         message: `Server started on ${serverUrl}`,
-        // port: this._port,
-        // host: this._host,
         host: serverUrl,
-        url:serverUrl,
+        url: serverUrl,
       }
     } catch (err) {
       this._server = null
@@ -397,17 +349,13 @@ class WebPlugin extends Plugin {
     this._server.close()
     this._server = null
     this._app = null
-    // log.info(' Server stopped')
     return { success: true, message: 'Server stopped' }
   }
 
-  // ==================== 中间件 ====================
-
   _setupMiddleware() {
     this._app.use('*', async (c) => {
       const pathname = c.req.path
 
-      // CORS 预检
       if (c.req.method === 'OPTIONS') {
         return c.text('', 200, {
           'Access-Control-Allow-Origin': '*',
@@ -416,7 +364,6 @@ class WebPlugin extends Plugin {
         })
       }
 
-      // 1. 静态文件
       const staticResult = this._serveStatic(pathname)
       if (staticResult) {
         if (staticResult.type === 'file') {
@@ -435,7 +382,6 @@ class WebPlugin extends Plugin {
         }
       }
 
-      // 2. Webhook（仅接受 POST）
       const webhook = this._webhooks.get(pathname)
       if (webhook) {
         if (c.req.method !== 'POST') {
@@ -445,20 +391,16 @@ class WebPlugin extends Plugin {
         return c.json(result)
       }
 
-      // 3. 路由（支持参数）
       for (const route of this._routes) {
         if (route.method === c.req.method && this._matchPath(route.path, pathname)) {
           return await this._handleRoute(c, route, pathname)
         }
       }
 
-      // 404
       return c.json({ success: false, error: 'Not Found', path: pathname }, 404)
     })
   }
 
-  // ==================== 请求处理 ====================
-
   async _handleRoute(c, route, pathname) {
     const params = this._extractParams(route.path, pathname)
     const query = this._parseQuery(c)
@@ -466,13 +408,10 @@ class WebPlugin extends Plugin {
 
     const context = { params, query, body }
 
-    // 构建 tools 代理对象，允许 handler 以函数方式直接调用工具
-    // 例如: const user = await tools.get_user({ id: 1 })
     const registry = this._framework.toolRegistry
     const tools = new Proxy({}, {
       get: (_, name) => {
         if (name === 'call') {
-          // 保留 call 方式作为后备
           return async (toolName, args) => registry.execute(toolName, args || {}, this._framework)
         }
         return async (args) => registry.execute(name, args || {}, this._framework)
@@ -494,11 +433,9 @@ class WebPlugin extends Plugin {
       timestamp: new Date().toISOString()
     }
 
-    // 从执行上下文获取 sessionId
     const ctx = this._framework.getExecutionContext()
     const sessionId = ctx?.sessionId || null
 
-    // 获取 Agent
     const agent = this._getAgent(sessionId)
     if (!agent) {
       log.error(' No agent available')
@@ -508,7 +445,6 @@ class WebPlugin extends Plugin {
     const prompt = webhook.prompt || '处理以下 webhook 数据，返回适当的响应：'
     const finalSessionId = sessionId || `web_${Date.now()}`
 
-    // 触发 webhook 接收事件（扁平化结构）
     this._framework.emit('webhook:received', {
       path: webhook.path,
       method: c.req.method,
@@ -517,19 +453,15 @@ class WebPlugin extends Plugin {
       timestamp: webhookData.timestamp
     })
 
-    // 使用子Agent处理 webhook
     const webhookAgent = this._framework.createSubAgent({
       name: 'webhook_handler',
       role: 'Webhook处理助手，专注于处理webhook数据并生成适当响应'
     })
 
     if (!webhook.awaitResponse) {
-      // 不等待，立即返回
       webhookAgent.chat(`${prompt}\n\n数据:\n${JSON.stringify(webhookData, null, 2)}`).then(result => {
         const responseText = result.message || ''
-        // log.info(` Webhook processed (${webhook.path}), LLM response (${responseText.length} chars)`)
 
-        // 添加到 session 历史
         if (sessionId) {
           const sessionPlugin = this._framework.pluginManager.get('session')
           if (sessionPlugin) {
@@ -538,7 +470,6 @@ class WebPlugin extends Plugin {
           }
         }
 
-        // 触发 webhook 处理完成事件
         this._framework.emit('webhook:processed', {
           path: webhook.path,
           method: c.req.method,
@@ -554,13 +485,10 @@ class WebPlugin extends Plugin {
       return { success: true, message: 'Webhook received, processing in background' }
     }
 
-    // 等待 LLM 处理完成
     try {
       const result = await webhookAgent.chat(`${prompt}\n\n数据:\n${JSON.stringify(webhookData, null, 2)}`)
       const responseText = result.message || result.text || ''
-      // log.info(` Webhook processed (${webhook.path}), LLM response (${responseText.length} chars)`)
 
-      // 添加到 session 历史
       if (sessionId) {
         const sessionPlugin = this._framework.pluginManager.get('session')
         if (sessionPlugin) {
@@ -569,7 +497,6 @@ class WebPlugin extends Plugin {
         }
       }
 
-      // 触发 webhook 处理完成事件
       this._framework.emit('webhook:processed', {
         path: webhook.path,
         method: c.req.method,
@@ -586,8 +513,6 @@ class WebPlugin extends Plugin {
     }
   }
 
-  // ==================== 路由注册 ====================
-
   async _registerRoute(method, path, handler, description) {
     if (!path.startsWith('/') || path.length < 2) {
       return { success: false, error: 'Invalid path format' }
@@ -605,10 +530,8 @@ class WebPlugin extends Plugin {
       this._routes.push(route)
     }
 
-    // 持久化保存
     this._saveConfig()
 
-    // log.info(` Route registered: ${method} ${path}`)
     return { success: true, message: `Route ${method} ${path} registered`, url: this._getUrl(path), route: { method, path, description } }
   }
 
@@ -617,7 +540,6 @@ class WebPlugin extends Plugin {
       await this._startServer()
     }
 
-    // 生成唯一 ID 和路径：/webhook/{id}
     const id = this._generateId()
     const webhookPath = `/webhook/${id}`
 
@@ -628,10 +550,8 @@ class WebPlugin extends Plugin {
       awaitResponse
     })
 
-    // 持久化保存
     this._saveConfig()
 
-    // log.info(` Webhook registered: ${webhookPath}`)
     return {
       success: true,
       message: `Webhook registered`,
@@ -658,10 +578,8 @@ class WebPlugin extends Plugin {
       }
     })
 
-    // 持久化保存
     this._saveConfig()
 
-    // log.info(` Static registered: ${normalizedPath} -> ${folder}`)
     return {
       success: true,
       message: `Static folder registered`,
@@ -689,7 +607,6 @@ class WebPlugin extends Plugin {
 
     this._routes.splice(index, 1)
     this._saveConfig()
-    // log.info(` Route deleted: ${method} ${path}`)
     return { success: true, message: `Route deleted: ${method} ${path}` }
   }
 
@@ -708,7 +625,6 @@ class WebPlugin extends Plugin {
 
     this._webhooks.delete(found)
     this._saveConfig()
-    // log.info(` Webhook deleted: ${found}`)
     return { success: true, message: `Webhook deleted: ${found}` }
   }
 
@@ -721,12 +637,9 @@ class WebPlugin extends Plugin {
 
     this._statics.splice(index, 1)
     this._saveConfig()
-    // log.info(` Static deleted: ${normalizedPath}`)
     return { success: true, message: `Static folder deleted: ${normalizedPath}` }
   }
 
-  // ==================== HTTP 客户端 ====================
-
   async _sendRequest(method, urlPath, body, headers) {
     if (!this._server) {
       return { success: false, error: 'Server not started' }
@@ -747,7 +660,7 @@ class WebPlugin extends Plugin {
       const response = await fetch(url, options)
       const text = await response.text()
       let parsed = text
-      try { parsed = JSON.parse(text) } catch { /* not JSON */ }
+      try { parsed = JSON.parse(text) } catch {}
 
       return { success: true, status: response.status, headers: Object.fromEntries(response.headers.entries()), body: parsed }
     } catch (err) {
@@ -755,8 +668,6 @@ class WebPlugin extends Plugin {
     }
   }
 
-  // ==================== 工具方法 ====================
-
   _matchPath(routePath, reqPath) {
     const routeParts = routePath.split('/').filter(Boolean)
     const reqParts = reqPath.split('/').filter(Boolean)
@@ -788,7 +699,6 @@ class WebPlugin extends Plugin {
   async _parseBody(c) {
     try {
       const rawText = await c.req.text()
-      // log.info(rawText)
       if (!rawText) return {}
       return JSON.parse(rawText)
     } catch (e) {
@@ -805,32 +715,23 @@ class WebPlugin extends Plugin {
 
   async _executeHandler(handlerCode, context, tools) {
     try {
-      // 辅助函数
       const helpers = {
-        // 基础工具
         echo: (val) => val,
         json: (val) => JSON.stringify(val),
         JSON: JSON,
-        // 日期时间
         Date: Date,
         now: () => Date.now(),
-        // 字符串
         Str: String,
-        // 编码
         btoa: (str) => Buffer.from(str).toString('base64'),
         atob: (str) => Buffer.from(str, 'base64').toString(),
-        // 格式化
         template: (str, vars) => str.replace(/\{\{(\w+)\}\}/g, (_, k) => vars[k] ?? `{{${k}}}`),
-        // 随机
         uuid: () => Math.random().toString(36).substring(2) + Date.now().toString(36),
-        // HTTP 请求（通过 fetch）
         fetch: async (url, options = {}) => {
           const { method = 'GET', headers = {}, body } = options
           const res = await fetch(url, { method, headers, body })
           return { status: res.status, headers: Object.fromEntries(res.headers), body: await res.text() }
         }
       }
-      // 使用沙箱执行用户代码，防止恶意代码执行
       return await runInSandbox(handlerCode, { context, tools, ...helpers }, { timeout: 10000 })
     } catch (err) {
       return { success: false, error: `Handler error: ${err.message}` }
@@ -843,7 +744,6 @@ class WebPlugin extends Plugin {
         const relativePath = pathname.substring(staticFolder.urlPath.length) || staticFolder.options.index
         const filePath = path.join(staticFolder.folder, relativePath)
 
-        // 安全检查
         if (!filePath.startsWith(staticFolder.folder)) {
           return { type: 'forbidden' }
         }
@@ -880,7 +780,6 @@ class WebPlugin extends Plugin {
   _getAgent(sessionId) {
     const finalSessionId = sessionId || `web_${Date.now()}`
 
-    // 尝试从对应平台插件获取 Agent
     const platformPrefixes = ['weixin_', 'telegram_', 'feishu_']
     for (const prefix of platformPrefixes) {
       if (finalSessionId.startsWith(prefix)) {
@@ -893,9 +792,8 @@ class WebPlugin extends Plugin {
       }
     }
 
-    // 返回主 Agent
     return this._framework._mainAgent || this._framework._agents?.[0]
   }
 }
 
-module.exports = WebPlugin
+module.exports = WebPlugin

package/plugins/memory/README.md

@@ -0,0 +1,13 @@
+# Memory Plugin
+
+四层记忆系统：工作记忆、短期记忆、长期记忆、核心记忆。
+
+## 依赖
+
+- core/storage (键值存储)
+
+## 能力
+
+- 对话历史摘要与压缩
+- 关键信息提取与持久化
+- 上下文增强 (prepareStep 集成)

package/plugins/{memory-plugin.js → memory/index.js}

@@ -3,14 +3,14 @@
  * 四层记忆系统：user, feedback, project, reference
  */
 
-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('Memory')
 const { z } = require('zod')
 const fs = require('fs')
 const path = require('path')
 const { EventEmitter } = require('events')
-const {cleanResponse} =require('../src/utils')
+const {cleanResponse} =require('../../src/utils')
 /**
  * 记忆类型常量
  */
@@ -972,20 +972,6 @@ class MemoryPlugin extends Plugin {
           }
         }
       }
-
-      // 批量处理错误
-      // if (this._pendingErrors.length > 0) {
-      //   const errors = this._pendingErrors.splice(0, 10) // 每次最多处理 10 条
-      //   log.debug(`Processing ${errors.length} pending errors`)
-
-      //   for (const errorData of errors) {
-      //     try {
-      //       await this._extractErrorLesson(errorData)
-      //     } catch (err) {
-      //       log.warn('Failed to extract error lesson:', err.message)
-      //     }
-      //   }
-      // }
     } finally {
       this._isExtracting = false
     }
@@ -1158,7 +1144,7 @@ ${prompt}`
             return parsed
           } catch (parseErr) {
             // JSON 解析失败，尝试清理不可见字符后重试
-            const cleaned = jsonStr.replace(/[\u0000-\u001F\u007F-\u009F\u200B-\u200F\u2028\u2029]/g, '')
+            const cleaned = jsonStr.replace(/[\x00-\x1f\x7f-\x9f\u200b-\u200f\u2028-\u2029]/g, '')
             try {
               const parsed = JSON.parse(cleaned)
               return parsed

package/plugins/messaging/email/README.md

@@ -0,0 +1,19 @@
+# Email Plugin
+
+SMTP/IMAP 邮件集成插件。
+
+## 配置
+
+通过 `config.email` 在 plugins.json 中配置：
+- `smtpHost` — SMTP 服务器地址
+- `smtpPort` — SMTP 端口
+- `imapHost` — IMAP 服务器地址
+- `imapPort` — IMAP 端口
+- `user` — 邮箱账号
+- `pass` — 邮箱密码
+
+## 能力
+
+- 发送邮件 (SMTP)
+- 接收/监控邮件 (IMAP idle)
+- 邮件回复、转发

package/plugins/{email → messaging/email}/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 log = logger.child('Email')
 const { z } = require('zod')
 const fs = require('fs')
@@ -75,7 +75,7 @@ class EmailPlugin extends Plugin {
 - attachments.content: Base64内容
 - attachments.cid: 嵌入式图片CID（HTML中用 <img src="cid:xxx"> 引用）`
     this.priority = 50
-    this.enabled = false
+    this.enabled = config.enabled === true
 
     this.tools={}
 

package/plugins/{feishu-plugin.js → messaging/feishu/index.js}

@@ -8,10 +8,10 @@
  * - allowedUsers: 允许的用户 openId 数组
  */
 
-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('Feishu')
-const {cleanResponse} =require('../src/utils')
+const {cleanResponse} =require('../../../src/utils')
 const removeMarkdown = require('remove-markdown');
 class FeishuPlugin extends Plugin {
   constructor(config = {}) {
@@ -20,7 +20,7 @@ class FeishuPlugin extends Plugin {
     this.version = '1.1.0'
     this.description = '飞书对话插件，使用 WebSocket 长连接接收消息'
     this.priority = 80
-    this.enabled = false
+    this.enabled = config.enabled === true
     this.systemPrompt = `你是一个飞书助手。回复内容不要使用markdown格式文本。
 
 **重要:** 子Agent 匹配规则必须遵守：