foliko 1.0.28 → 1.0.30

package/examples/mcp-example.js

@@ -1,53 +1,53 @@
-/**
- * MCP 执行器示例
- * 展示如何连接 MCP 服务器
- */
-
-const { Framework } = require('../src')
-const { MCPExecutorPlugin } = require('../src/executors/mcp-executor')
-
-async function main() {
-  console.log('=== MCP Executor Example ===\n')
-
-  // 创建框架
-  const framework = new Framework({ debug: true })
-
-  // 创建 MCP 执行器插件
-  const mcpPlugin = new MCPExecutorPlugin({
-    servers: [
-      // 示例：添加一个 MCP 服务器
-      // {
-      //   name: 'example',
-      //   command: 'uvx',
-      //   args: ['example-mcp-server'],
-      //   env: {}
-      // }
-    ]
-  })
-
-  // 加载插件
-  await framework.loadPlugin(mcpPlugin)
-
-  // 列出服务器
-  console.log('\n--- MCP Servers ---')
-  const servers = mcpPlugin.getServers()
-  console.log('Servers:', servers)
-
-  // 列出所有 MCP 工具
-  console.log('\n--- MCP Tools ---')
-  const tools = framework.getTools().filter(t => t.name.startsWith('mcp_'))
-  console.log('MCP tools:', tools.map(t => t.name))
-
-  // 如果有配置的服务器，可以这样调用：
-  // const result = await framework.executeTool('mcp_call', {
-  //   server: 'example',
-  //   tool: 'tool_name',
-  //   args: { /* tool arguments */ }
-  // })
-
-  // 清理
-  await framework.destroy()
-  console.log('\n[Done]')
-}
-
-main().catch(console.error)
+/**
+ * MCP 执行器示例
+ * 展示如何连接 MCP 服务器
+ */
+
+const { Framework } = require('../src')
+const { MCPExecutorPlugin } = require('../src/executors/mcp-executor')
+
+async function main() {
+  console.log('=== MCP Executor Example ===\n')
+
+  // 创建框架
+  const framework = new Framework({ debug: true })
+
+  // 创建 MCP 执行器插件
+  const mcpPlugin = new MCPExecutorPlugin({
+    servers: [
+      // 示例：添加一个 MCP 服务器
+      // {
+      //   name: 'example',
+      //   command: 'uvx',
+      //   args: ['example-mcp-server'],
+      //   env: {}
+      // }
+    ]
+  })
+
+  // 加载插件
+  await framework.loadPlugin(mcpPlugin)
+
+  // 列出服务器
+  console.log('\n--- MCP Servers ---')
+  const servers = mcpPlugin.getServers()
+  console.log('Servers:', servers)
+
+  // 列出所有 MCP 工具
+  console.log('\n--- MCP Tools ---')
+  const tools = framework.getTools().filter(t => t.name.startsWith('mcp_'))
+  console.log('MCP tools:', tools.map(t => t.name))
+
+  // 如果有配置的服务器，可以这样调用：
+  // const result = await framework.executeTool('mcp_call', {
+  //   server: 'example',
+  //   tool: 'tool_name',
+  //   args: { /* tool arguments */ }
+  // })
+
+  // 清理
+  await framework.destroy()
+  console.log('\n[Done]')
+}
+
+main().catch(console.error)

package/examples/skill-example.js

@@ -1,49 +1,49 @@
-/**
- * Skill 管理器示例
- * 展示如何加载和使用 Skill
- */
-
-const { Framework } = require('../src')
-const { SkillManagerPlugin } = require('../src/capabilities/skill-manager')
-
-async function main() {
-  console.log('=== Skill Manager Example ===\n')
-
-  // 创建框架
-  const framework = new Framework({ debug: true })
-
-  // 创建 skills 目录（如果没有）
-  const fs = require('fs')
-  const skillsDir = './skills'
-  if (!fs.existsSync(skillsDir)) {
-    fs.mkdirSync(skillsDir, { recursive: true })
-  }
-
-  // 加载 Skill 管理器插件
-  const skillPlugin = new SkillManagerPlugin({
-    skillsDir: skillsDir
-  })
-
-  await framework.loadPlugin(skillPlugin)
-
-  // 列出所有加载的 skills
-  console.log('\n--- Loaded Skills ---')
-  const skills = skillPlugin.getAllSkills()
-  console.log(`Found ${skills.length} skills:`)
-  for (const skill of skills) {
-    console.log(`  - ${skill.name}: ${skill.metadata.description}`)
-  }
-
-  // 获取单个 skill
-  if (skillPlugin.hasSkill('hello-skill')) {
-    console.log('\n--- Hello Skill ---')
-    const helloSkill = skillPlugin.getSkill('hello-skill')
-    console.log('Content preview:', helloSkill.content.substring(0, 100) + '...')
-  }
-
-  // 清理
-  await framework.destroy()
-  console.log('\n[Done]')
-}
-
-main().catch(console.error)
+/**
+ * Skill 管理器示例
+ * 展示如何加载和使用 Skill
+ */
+
+const { Framework } = require('../src')
+const { SkillManagerPlugin } = require('../src/capabilities/skill-manager')
+
+async function main() {
+  console.log('=== Skill Manager Example ===\n')
+
+  // 创建框架
+  const framework = new Framework({ debug: true })
+
+  // 创建 skills 目录（如果没有）
+  const fs = require('fs')
+  const skillsDir = './skills'
+  if (!fs.existsSync(skillsDir)) {
+    fs.mkdirSync(skillsDir, { recursive: true })
+  }
+
+  // 加载 Skill 管理器插件
+  const skillPlugin = new SkillManagerPlugin({
+    skillsDir: skillsDir
+  })
+
+  await framework.loadPlugin(skillPlugin)
+
+  // 列出所有加载的 skills
+  console.log('\n--- Loaded Skills ---')
+  const skills = skillPlugin.getAllSkills()
+  console.log(`Found ${skills.length} skills:`)
+  for (const skill of skills) {
+    console.log(`  - ${skill.name}: ${skill.metadata.description}`)
+  }
+
+  // 获取单个 skill
+  if (skillPlugin.hasSkill('hello-skill')) {
+    console.log('\n--- Hello Skill ---')
+    const helloSkill = skillPlugin.getSkill('hello-skill')
+    console.log('Content preview:', helloSkill.content.substring(0, 100) + '...')
+  }
+
+  // 清理
+  await framework.destroy()
+  console.log('\n[Done]')
+}
+
+main().catch(console.error)

package/examples/test-chat.js

@@ -9,7 +9,7 @@ const readline = require('readline')
 require('dotenv').config()
 
 async function main() {
-  console.log('=== VB-Agent 持续聊天测试 ===\n')
+  console.log('=== Foliko 持续聊天测试 ===\n')
   console.log('输入消息与 Agent 对话，输入 exit 或 quit 退出')
   console.log('多行输入：按两次回车结束，或输入 !! 立即结束\n')
 
@@ -35,7 +35,7 @@ async function main() {
     systemPrompt: '你是一个有帮助的助手，擅长回答问题和执行任务。',
     sharedPrompt: '工作目录: {{WORK_DIR}}',
     metadata: {
-      projectName: 'VB-Agent',
+      projectName: 'Foliko',
       version: '1.0.0'
     }
   })

package/examples/test-mcp.js

@@ -1,79 +1,79 @@
-/**
- * MCP 插件测试脚本
- */
-
-const { Framework } = require('../src')
-const { MCPExecutorPlugin } = require('../src/executors/mcp-executor')
-
-async function test() {
-  console.log('=== MCP Plugin Test ===\n')
-
-  console.log('1. Creating framework...')
-  const framework = new Framework({ debug: true })
-
-  console.log('2. Creating MCP plugin with fetch server...')
-  const mcpPlugin = new MCPExecutorPlugin({
-    servers: [
-      {
-        name: 'fetch',
-        command: 'uvx',
-        args: ['mcp-server-fetch']
-      }
-    ]
-  })
-
-  console.log('3. Loading MCP plugin...')
-  await framework.loadPlugin(mcpPlugin)
-
-  console.log('4. Starting framework...')
-  await framework.pluginManager.startAll()
-
-  // 等待 MCP 服务器连接
-  console.log('\n5. Waiting for MCP connection...')
-  await new Promise(resolve => setTimeout(resolve, 2000))
-
-  console.log('\n6. Listing MCP servers...')
-  const servers = mcpPlugin.getServers()
-  console.log('Servers:', JSON.stringify(servers, null, 2))
-
-  console.log('\n7. Listing MCP tools...')
-  const mcpTools = framework.getTools().filter(t => t.name.startsWith('mcp_'))
-  console.log('MCP Tools:', mcpTools.map(t => t.name))
-
-  if (mcpTools.length > 0) {
-    console.log('\n8. Testing mcp_list_servers...')
-    const listResult = await framework.executeTool('mcp_list_servers', {})
-    console.log('List Servers Result:', JSON.stringify(listResult, null, 2))
-
-    console.log('\n9. Testing mcp_tool_schema...')
-    const schemaResult = await framework.executeTool('mcp_tool_schema', {
-      server: 'fetch',
-      tool: 'fetch'
-    })
-    console.log('Tool Schema:', JSON.stringify(schemaResult, null, 2))
-
-    console.log('\n10. Testing mcp_call (fetch a webpage)...')
-    const callResult = await framework.executeTool('mcp_call', {
-      server: 'fetch',
-      tool: 'fetch',
-      args_json: JSON.stringify({ url: 'https://httpbin.org/get' })
-    })
-    console.log('Fetch Result (truncated):', JSON.stringify(callResult, null, 2).substring(0, 500) + '...')
-  }
-
-  console.log('\n11. Destroying framework...')
-  await framework.destroy()
-
-  console.log('\n=== Test Complete ===')
-}
-
-test()
-  .then(() => {
-    console.log('\n✓ Test completed successfully')
-    process.exit(0)
-  })
-  .catch(err => {
-    console.error('\n✗ Test failed:', err.message)
-    console.error(err.stack)
-    process.exit(1)
-  })
+/**
+ * MCP 插件测试脚本
+ */
+
+const { Framework } = require('../src')
+const { MCPExecutorPlugin } = require('../src/executors/mcp-executor')
+
+async function test() {
+  console.log('=== MCP Plugin Test ===\n')
+
+  console.log('1. Creating framework...')
+  const framework = new Framework({ debug: true })
+
+  console.log('2. Creating MCP plugin with fetch server...')
+  const mcpPlugin = new MCPExecutorPlugin({
+    servers: [
+      {
+        name: 'fetch',
+        command: 'uvx',
+        args: ['mcp-server-fetch']
+      }
+    ]
+  })
+
+  console.log('3. Loading MCP plugin...')
+  await framework.loadPlugin(mcpPlugin)
+
+  console.log('4. Starting framework...')
+  await framework.pluginManager.startAll()
+
+  // 等待 MCP 服务器连接
+  console.log('\n5. Waiting for MCP connection...')
+  await new Promise(resolve => setTimeout(resolve, 2000))
+
+  console.log('\n6. Listing MCP servers...')
+  const servers = mcpPlugin.getServers()
+  console.log('Servers:', JSON.stringify(servers, null, 2))
+
+  console.log('\n7. Listing MCP tools...')
+  const mcpTools = framework.getTools().filter(t => t.name.startsWith('mcp_'))
+  console.log('MCP Tools:', mcpTools.map(t => t.name))
+
+  if (mcpTools.length > 0) {
+    console.log('\n8. Testing mcp_list_servers...')
+    const listResult = await framework.executeTool('mcp_list_servers', {})
+    console.log('List Servers Result:', JSON.stringify(listResult, null, 2))
+
+    console.log('\n9. Testing mcp_tool_schema...')
+    const schemaResult = await framework.executeTool('mcp_tool_schema', {
+      server: 'fetch',
+      tool: 'fetch'
+    })
+    console.log('Tool Schema:', JSON.stringify(schemaResult, null, 2))
+
+    console.log('\n10. Testing mcp_call (fetch a webpage)...')
+    const callResult = await framework.executeTool('mcp_call', {
+      server: 'fetch',
+      tool: 'fetch',
+      args_json: JSON.stringify({ url: 'https://httpbin.org/get' })
+    })
+    console.log('Fetch Result (truncated):', JSON.stringify(callResult, null, 2).substring(0, 500) + '...')
+  }
+
+  console.log('\n11. Destroying framework...')
+  await framework.destroy()
+
+  console.log('\n=== Test Complete ===')
+}
+
+test()
+  .then(() => {
+    console.log('\n✓ Test completed successfully')
+    process.exit(0)
+  })
+  .catch(err => {
+    console.error('\n✗ Test failed:', err.message)
+    console.error(err.stack)
+    process.exit(1)
+  })

package/examples/test-reload.js

@@ -1,61 +1,61 @@
-/**
- * MCP mcp_reload 功能测试
- */
-
-const { Framework } = require('../src')
-const { MCPExecutorPlugin } = require('../src/executors/mcp-executor')
-const fs = require('fs')
-const path = require('path')
-
-async function test() {
-  console.log('=== Testing mcp_reload ===\n')
-  
-  // 创建框架
-  const framework = new Framework({ debug: true })
-  
-  // 创建 MCP 插件
-  const mcpPlugin = new MCPExecutorPlugin({
-    servers: [
-      { name: 'fetch', command: 'uvx', args: ['mcp-server-fetch'] }
-    ]
-  })
-  
-  // 加载并启动
-  await framework.loadPlugin(mcpPlugin)
-  await framework.pluginManager.startAll()
-  
-  // 等待连接
-  await new Promise(r => setTimeout(r, 2000))
-  
-  console.log('\n1. 初始服务器列表:')
-  const initialServers = mcpPlugin.getServers()
-  console.log(JSON.stringify(initialServers, null, 2))
-  
-  // 测试 mcp_reload
-  console.log('\n2. 调用 mcp_reload...')
-  const result = await framework.executeTool('mcp_reload', {})
-  console.log('mcp_reload 结果:')
-  console.log(JSON.stringify(result, null, 2))
-  
-  // 检查配置
-  console.log('\n3. 当前配置文件:')
-  const configPath = path.resolve('.agent/mcp_config.json')
-  if (fs.existsSync(configPath)) {
-    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'))
-    console.log(JSON.stringify(config, null, 2))
-  } else {
-    console.log('配置文件不存在: ' + configPath)
-  }
-  
-  // 清理
-  await framework.destroy()
-  
-  console.log('\n=== 测试完成 ===')
-}
-
-test()
-  .then(() => process.exit(0))
-  .catch(err => {
-    console.error('测试失败:', err)
-    process.exit(1)
-  })
+/**
+ * MCP mcp_reload 功能测试
+ */
+
+const { Framework } = require('../src')
+const { MCPExecutorPlugin } = require('../src/executors/mcp-executor')
+const fs = require('fs')
+const path = require('path')
+
+async function test() {
+  console.log('=== Testing mcp_reload ===\n')
+  
+  // 创建框架
+  const framework = new Framework({ debug: true })
+  
+  // 创建 MCP 插件
+  const mcpPlugin = new MCPExecutorPlugin({
+    servers: [
+      { name: 'fetch', command: 'uvx', args: ['mcp-server-fetch'] }
+    ]
+  })
+  
+  // 加载并启动
+  await framework.loadPlugin(mcpPlugin)
+  await framework.pluginManager.startAll()
+  
+  // 等待连接
+  await new Promise(r => setTimeout(r, 2000))
+  
+  console.log('\n1. 初始服务器列表:')
+  const initialServers = mcpPlugin.getServers()
+  console.log(JSON.stringify(initialServers, null, 2))
+  
+  // 测试 mcp_reload
+  console.log('\n2. 调用 mcp_reload...')
+  const result = await framework.executeTool('mcp_reload', {})
+  console.log('mcp_reload 结果:')
+  console.log(JSON.stringify(result, null, 2))
+  
+  // 检查配置
+  console.log('\n3. 当前配置文件:')
+  const configPath = path.resolve('.agent/mcp_config.json')
+  if (fs.existsSync(configPath)) {
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'))
+    console.log(JSON.stringify(config, null, 2))
+  } else {
+    console.log('配置文件不存在: ' + configPath)
+  }
+  
+  // 清理
+  await framework.destroy()
+  
+  console.log('\n=== 测试完成 ===')
+}
+
+test()
+  .then(() => process.exit(0))
+  .catch(err => {
+    console.error('测试失败:', err)
+    process.exit(1)
+  })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foliko",
-  "version": "1.0.28",
+  "version": "1.0.30",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "bin": {
@@ -30,6 +30,7 @@
     "ai": "^6.0.116",
     "dotenv": "^17.3.1",
     "imap": "^0.8.19",
+    "imap-mkl": "^1.0.2",
     "mailparser": "^3.7.2",
     "marked": "^11.2.0",
     "marked-terminal": "6",

package/plugins/default-plugins.js

@@ -79,7 +79,7 @@ function loadAgentConfig(agentDir = '.agent') {
     }
   }
 
-  // 加载 plugins.json (支持 telegram, weixin 等插件配置)
+  // 加载 plugins.json (支持 telegram, weixin, email 等插件配置)
   const pluginsFile = path.join(resolvedDir, 'plugins.json')
   if (fs.existsSync(pluginsFile)) {
     try {
@@ -93,6 +93,10 @@ function loadAgentConfig(agentDir = '.agent') {
       if (pluginsConfig.weixin) {
         config.weixin = pluginsConfig.weixin
       }
+      // email 配置
+      if (pluginsConfig.email) {
+        config.email = pluginsConfig.email
+      }
     } catch (err) {
       console.error(`[AgentConfig] Failed to load plugins.json:`, err.message)
     }
@@ -420,7 +424,26 @@ async function bootstrapDefaults(framework, config = {}) {
     }
   }
 
-  // 12.8 SubAgent 管理器
+  // 12.8 Email 插件（默认禁用，需要在 plugins.json 中设置 enabled: true）
+  if (shouldLoad('email')) {
+    try {
+      const { Plugin } = require('../src/core/plugin-base')
+      const { EmailPlugin } = require('./email')
+      // 支持两种格式：email.smtp 或 email.config.smtp
+      const emailData = agentConfig.email || {}
+      const emailCfg = emailData.config || {}
+      const emailConfig = {
+        smtp: emailCfg.smtp || emailData.smtp || {},
+        imap: emailCfg.imap || emailData.imap || {},
+        clientId: emailCfg.clientId || emailData.clientId
+      }
+      await framework.loadPlugin(new EmailPlugin(emailConfig))
+    } catch (err) {
+      console.warn('[Bootstrap] Email Plugin not available:', err.message)
+    }
+  }
+
+  // 12.9 SubAgent 管理器
   if (shouldLoad('subagent-manager')) {
     try {
       const { SubAgentManagerPlugin } = require('./subagent-plugin')