foliko 1.0.28 → 1.0.30

package/plugins/email.js

@@ -13,7 +13,18 @@ class EmailPlugin extends Plugin {
     this.version = '1.0.0'
     this.description = '邮件收发插件 - 支持读取和发送电子邮件'
     this.priority = 10
-    this.config = config
+    // 默认不启用，需要在 plugins.json 中设置 enabled: true
+    this.enabled = false
+    // IMAP ID 信息
+    this.config = {
+      ...config,
+      clientId: config.clientId || {
+        name: 'FolikoAgent',
+        version: '1.0.0',
+        vendor: 'Foliko',
+        supportEmail: config.imap?.user || 'unknown@example.com'
+      }
+    }
   }
 
   install(framework) {
@@ -105,9 +116,26 @@ class EmailPlugin extends Plugin {
         imap_port: z.number().optional().describe('IMAP端口'),
         imap_user: z.string().optional().describe('IMAP用户名'),
         imap_pass: z.string().optional().describe('IMAP密码'),
-        from_email: z.string().optional().describe('默认发件人地址')
+        from_email: z.string().optional().describe('默认发件人地址'),
+        client_id_name: z.string().optional().describe('IMAP客户端名称'),
+        client_id_version: z.string().optional().describe('IMAP客户端版本'),
+        client_id_vendor: z.string().optional().describe('IMAP客户端厂商'),
+        client_id_support_email: z.string().optional().describe('IMAP客户端支持邮箱')
       }),
       execute: async (args) => {
+        // 处理 clientId 字段
+        if (args.client_id_name || args.client_id_version || args.client_id_vendor || args.client_id_support_email) {
+          this.config.clientId = {
+            name: args.client_id_name || this.config.clientId?.name || 'FolikoAgent',
+            version: args.client_id_version || this.config.clientId?.version || '1.0.0',
+            vendor: args.client_id_vendor || this.config.clientId?.vendor || 'Foliko',
+            supportEmail: args.client_id_support_email || this.config.clientId?.supportEmail
+          }
+          delete args.client_id_name
+          delete args.client_id_version
+          delete args.client_id_vendor
+          delete args.client_id_support_email
+        }
         Object.assign(this.config, args)
         return {
           success: true,
@@ -163,7 +191,7 @@ class EmailPlugin extends Plugin {
 
   async _readEmails(args) {
     try {
-      const Imap = require('imap')
+      const Imap = require('imap-mkl')
       const { simpleParser } = require('mailparser')
 
       const imapConfig = {
@@ -172,7 +200,12 @@ class EmailPlugin extends Plugin {
         host: args.host || this.config.imap_host || process.env.IMAP_HOST,
         port: args.port || this.config.imap_port || 993,
         tls: true,
-        tlsOptions: { rejectUnauthorized: false }
+        tlsOptions: { rejectUnauthorized: false },
+        id: {
+          name: this.config.clientId?.name || 'FolikoAgent',
+          version: this.config.clientId?.version || '1.0.0',
+          vendor: this.config.clientId?.vendor || 'Foliko'
+        }
       }
 
       const box = args.box || 'INBOX'
@@ -197,7 +230,7 @@ class EmailPlugin extends Plugin {
 
   async _getUnreadCount(args) {
     try {
-      const Imap = require('imap')
+      const Imap = require('imap-mkl')
 
       const imapConfig = {
         user: args.user || this.config.imap_user || process.env.IMAP_USER,
@@ -205,7 +238,13 @@ class EmailPlugin extends Plugin {
         host: args.host || this.config.imap_host || process.env.IMAP_HOST,
         port: args.port || this.config.imap_port || 993,
         tls: true,
-        tlsOptions: { rejectUnauthorized: false }
+        tlsOptions: { rejectUnauthorized: false },
+        id: {
+          name: this.config.clientId?.name || 'FolikoAgent',
+          version: this.config.clientId?.version || '1.0.0',
+          vendor: this.config.clientId?.vendor || 'Foliko',
+          'support-email': this.config.clientId?.supportEmail || 'unknown@example.com'
+        }
       }
 
       const box = args.box || 'INBOX'
@@ -226,7 +265,7 @@ class EmailPlugin extends Plugin {
 
   async _markAsRead(args) {
     try {
-      const Imap = require('imap')
+      const Imap = require('imap-mkl')
 
       const imapConfig = {
         user: args.user || this.config.imap_user || process.env.IMAP_USER,
@@ -234,7 +273,13 @@ class EmailPlugin extends Plugin {
         host: args.host || this.config.imap_host || process.env.IMAP_HOST,
         port: args.port || this.config.imap_port || 993,
         tls: true,
-        tlsOptions: { rejectUnauthorized: false }
+        tlsOptions: { rejectUnauthorized: false },
+        id: {
+          name: this.config.clientId?.name || 'FolikoAgent',
+          version: this.config.clientId?.version || '1.0.0',
+          vendor: this.config.clientId?.vendor || 'Foliko',
+          'support-email': this.config.clientId?.supportEmail || 'unknown@example.com'
+        }
       }
 
       await this._markEmailAsRead(imapConfig, args.messageId)
@@ -253,13 +298,19 @@ class EmailPlugin extends Plugin {
 
   _fetchEmails(imapConfig, box, limit, unreadOnly, searchCriteria) {
     return new Promise((resolve, reject) => {
+      const Imap = require('imap-mkl')
+      const { simpleParser } = require('mailparser')
       const imap = new Imap(imapConfig)
       const emails = []
 
-      imap.once('ready', () => {
+      const cleanup = () => {
+        try { imap.end() } catch (e) {}
+      }
+
+      imap.on('ready', () => {
         imap.openBox(box, true, (err) => {
           if (err) {
-            imap.end()
+            cleanup()
             return reject(err)
           }
 
@@ -270,106 +321,125 @@ class EmailPlugin extends Plugin {
 
           imap.search(searchFilter, (err, results) => {
             if (err) {
-              imap.end()
+              cleanup()
               return reject(err)
             }
 
-            if (results.length === 0) {
-              imap.end()
+            if (!results || results.length === 0) {
+              cleanup()
               return resolve([])
             }
 
             const fetchIds = results.slice(-limit)
+            const f = imap.fetch(fetchIds, { bodies: '' })
 
-            const f = imap.fetch(fetchIds, {
-              bodies: 'HEADER.FIELDS (FROM TO SUBJECT DATE)',
-              struct: true
-            })
-
-            f.on('message', (msg, seqno) => {
-              const email = { seqno }
+            f.on('message', (msg) => {
+              const email = {}
 
               msg.on('body', (stream) => {
-                let buffer = ''
-                stream.on('data', chunk => buffer += chunk.toString('utf8'))
-                stream.once('end', () => {
-                  const headers = Imap.parseHeader(buffer)
-                  email.from = headers.from ? headers.from[0] : ''
-                  email.to = headers.to ? headers.to[0] : ''
-                  email.subject = headers.subject ? headers.subject[0] : ''
-                  email.date = headers.date ? headers.date[0] : ''
+                simpleParser(stream, (err, mail) => {
+                  if (err) {
+                    email.error = err.message
+                  } else {
+                    email.subject = mail.subject
+                    email.from = mail.from?.text || ''
+                    email.to = mail.to?.text || ''
+                    email.date = mail.date?.toISOString() || ''
+                    email.text = mail.text
+                    email.html = mail.html
+                    email.attachments = mail.attachments?.map(a => ({
+                      filename: a.filename,
+                      contentType: a.contentType
+                    })) || []
+                  }
                 })
               })
 
-              msg.once('attributes', (attrs) => {
+              msg.on('attributes', (attrs) => {
                 email.uid = attrs.uid
                 email.id = attrs.uid
                 email.flags = attrs.flags
               })
 
-              msg.once('end', () => {
+              msg.on('end', () => {
                 emails.push(email)
               })
             })
 
-            f.once('error', err => {
-              imap.end()
+            f.on('error', (err) => {
+              cleanup()
               reject(err)
             })
 
-            f.once('end', () => {
-              imap.end()
+            f.on('end', () => {
+              cleanup()
               resolve(emails)
             })
           })
         })
       })
 
-      imap.once('error', err => reject(err))
+      imap.on('error', (err) => reject(err))
+      imap.on('end', () => {})
+
       imap.connect()
     })
   }
 
   _fetchUnreadCount(imapConfig, box) {
     return new Promise((resolve, reject) => {
+      const Imap = require('imap-mkl')
       const imap = new Imap(imapConfig)
 
-      imap.once('ready', () => {
+      const cleanup = () => {
+        try { imap.end() } catch (e) {}
+      }
+
+      imap.on('ready', () => {
         imap.openBox(box, true, (err, box) => {
           if (err) {
-            imap.end()
+            cleanup()
             return reject(err)
           }
           const unreadCount = box.messages.unread
-          imap.end()
+          cleanup()
           resolve(unreadCount)
         })
       })
 
-      imap.once('error', err => reject(err))
+      imap.on('error', (err) => reject(err))
+      imap.on('end', () => {})
+
       imap.connect()
     })
   }
 
   _markEmailAsRead(imapConfig, messageId) {
     return new Promise((resolve, reject) => {
+      const Imap = require('imap-mkl')
       const imap = new Imap(imapConfig)
 
-      imap.once('ready', () => {
+      const cleanup = () => {
+        try { imap.end() } catch (e) {}
+      }
+
+      imap.on('ready', () => {
         imap.openBox('INBOX', true, (err) => {
           if (err) {
-            imap.end()
+            cleanup()
             return reject(err)
           }
           imap.addFlags(messageId, '\\Seen', (err) => {
-            imap.end()
+            cleanup()
             if (err) reject(err)
             else resolve()
           })
         })
       })
 
-      imap.once('error', err => reject(err))
+      imap.on('error', (err) => reject(err))
+      imap.on('end', () => {})
+
       imap.connect()
     })
   }

package/plugins/telegram-plugin.js

@@ -42,6 +42,7 @@ module.exports = function(Plugin) {
       this._bot = null
       this._sessionPlugin = null
       this._sessionDeleteHandler = null
+      this._sessionAgents = new Map()  // chatId -> Agent
     }
 
     install(framework) {
@@ -203,18 +204,22 @@ module.exports = function(Plugin) {
     _getSessionAgent(chatId) {
       console.log('[Telegram] _getSessionAgent called for chatId:', chatId)
 
-      // 直接从 Framework 获取主 agent
-      const agent = this._getMainAgent()
-      console.log('[Telegram] mainAgent:', !!agent, agent?.name)
-      if (!agent) {
-        console.log('[Telegram] ERROR: mainAgent is null!')
-        return null
+      // 检查缓存
+      if (this._sessionAgents.has(chatId)) {
+        const agent = this._sessionAgents.get(chatId)
+        const sessionId = `telegram_${chatId}`
+        console.log('[Telegram] Reusing cached session agent for chatId:', chatId)
+        return { agent, sessionId }
       }
 
+      // 创建新 agent
+      const agent = this._framework.createSessionAgent(`telegram_${chatId}`)
+      this._sessionAgents.set(chatId, agent)
+      console.log('[Telegram] Created new session agent for chatId:', chatId)
+
       // 使用 SessionPlugin 管理会话历史
       if (this._sessionPlugin) {
         const sessionId = `telegram_${chatId}`
-        // 确保会话存在（不会重复创建）
         this._sessionPlugin.getOrCreateSession(sessionId, {
           metadata: { platform: 'telegram', chatId }
         })
@@ -604,6 +609,12 @@ module.exports = function(Plugin) {
     }
 
     uninstall(framework) {
+      // 销毁所有 session agents
+      for (const agent of this._sessionAgents.values()) {
+        agent.destroy()
+      }
+      this._sessionAgents.clear()
+
       this.stopBot()
       if (this._sessionPlugin && this._sessionDeleteHandler) {
         this._sessionPlugin.off('session:deleted', this._sessionDeleteHandler)

package/plugins/weixin-plugin.js

@@ -32,6 +32,7 @@ module.exports = function(Plugin) {
       this._bot = null
       this._sessionPlugin = null
       this._sessionDeleteHandler = null
+      this._sessionAgents = new Map()  // userId -> Agent
       this._qrcodeTerminal = null
       this._origStderrWrite = null
       this._initialized = false
@@ -150,13 +151,18 @@ module.exports = function(Plugin) {
      * 使用 SessionPlugin 统一管理会话历史
      */
     _getSessionAgent(userId) {
-      // 直接从 Framework 获取主 agent
-      const agent = this._getMainAgent()
-      if (!agent) {
-        console.log('[WeChat] ERROR: mainAgent is null!')
-        return null
+      // 检查缓存
+      if (this._sessionAgents.has(userId)) {
+        const agent = this._sessionAgents.get(userId)
+        console.log('[WeChat] Reusing cached session agent for userId:', userId)
+        return { agent, sessionId: `weixin_${userId}` }
       }
 
+      // 创建新 agent
+      const agent = this._framework.createSessionAgent(`weixin_${userId}`)
+      this._sessionAgents.set(userId, agent)
+      console.log('[WeChat] Created new session agent for userId:', userId)
+
       // 使用 SessionPlugin 管理会话历史
       if (this._sessionPlugin) {
         const sessionId = `weixin_${userId}`
@@ -319,6 +325,12 @@ module.exports = function(Plugin) {
     }
 
     uninstall(framework) {
+      // 销毁所有 session agents
+      for (const agent of this._sessionAgents.values()) {
+        agent.destroy()
+      }
+      this._sessionAgents.clear()
+
       this.stopBot()
       if (this._sessionPlugin && this._sessionDeleteHandler) {
         this._sessionPlugin.off('session:deleted', this._sessionDeleteHandler)

package/skills/{vb-agent-dev → foliko-dev}/AGENTS.md

@@ -1,6 +1,6 @@
 # AGENTS.md
 
-This file provides guidance to AI coding agents on how to create plugins for the VB-Agent Framework system.
+This file provides guidance to AI coding agents on how to create plugins for the Foliko Framework system.
 
 ## Plugin File Location
 

package/src/core/framework.js

@@ -170,6 +170,34 @@ class Framework extends EventEmitter {
     return agent
   }
 
+  /**
+   * 为指定 session 创建独立的 Agent 实例
+   * @param {string} sessionId - session ID
+   * @param {Object} config - Agent 配置
+   */
+  createSessionAgent(sessionId, config = {}) {
+    const agentConfig = {
+      name: `session_${sessionId}`,
+      ...config
+    }
+
+    // 如果没有提供 AI 相关参数，从 AI 插件获取
+    if (!agentConfig.apiKey) {
+      const aiPlugin = this.pluginManager.get('ai')
+      if (aiPlugin) {
+        agentConfig.apiKey = aiPlugin.config.apiKey
+        agentConfig.provider = agentConfig.provider || aiPlugin.config.provider
+        agentConfig.model = agentConfig.model || aiPlugin.config.model
+        agentConfig.baseURL = agentConfig.baseURL || aiPlugin.config.baseURL
+      }
+    }
+
+    const agent = new Agent(this, agentConfig)
+    this._agents.push(agent)
+    this.emit('agent:created', agent)
+    return agent
+  }
+
   /**
    * 获取 AI 插件
    * @returns {Object|undefined}

package/src/executors/executor-base.js

@@ -1,58 +1,58 @@
-/**
- * Executor 基类
- * 执行器的基类，定义执行器接口
- */
-
-const { EventEmitter } = require('../utils/event-emitter')
-
-class ExecutorBase extends EventEmitter {
-  /**
-   * @param {string} name - 执行器名称
-   */
-  constructor(name) {
-    super()
-    this.name = name
-    this._enabled = true
-  }
-
-  /**
-   * 执行
-   * @param {Object} params - 执行参数
-   * @returns {Promise<any>}
-   */
-  async execute(params) {
-    throw new Error('execute() must be implemented')
-  }
-
-  /**
-   * 启用执行器
-   */
-  enable() {
-    this._enabled = true
-    return this
-  }
-
-  /**
-   * 禁用执行器
-   */
-  disable() {
-    this._enabled = false
-    return this
-  }
-
-  /**
-   * 是否启用
-   */
-  isEnabled() {
-    return this._enabled
-  }
-
-  /**
-   * 销毁
-   */
-  destroy() {
-    this.removeAllListeners()
-  }
-}
-
-module.exports = { ExecutorBase }
+/**
+ * Executor 基类
+ * 执行器的基类，定义执行器接口
+ */
+
+const { EventEmitter } = require('../utils/event-emitter')
+
+class ExecutorBase extends EventEmitter {
+  /**
+   * @param {string} name - 执行器名称
+   */
+  constructor(name) {
+    super()
+    this.name = name
+    this._enabled = true
+  }
+
+  /**
+   * 执行
+   * @param {Object} params - 执行参数
+   * @returns {Promise<any>}
+   */
+  async execute(params) {
+    throw new Error('execute() must be implemented')
+  }
+
+  /**
+   * 启用执行器
+   */
+  enable() {
+    this._enabled = true
+    return this
+  }
+
+  /**
+   * 禁用执行器
+   */
+  disable() {
+    this._enabled = false
+    return this
+  }
+
+  /**
+   * 是否启用
+   */
+  isEnabled() {
+    return this._enabled
+  }
+
+  /**
+   * 销毁
+   */
+  destroy() {
+    this.removeAllListeners()
+  }
+}
+
+module.exports = { ExecutorBase }

package/src/index.js

@@ -1,5 +1,5 @@
 /**
- * VB-Agent Framework
+ * Foliko Framework
  * 简约的插件化 Agent 框架
  */