foliko 1.0.29 → 1.0.31

package/.claude/settings.local.json

@@ -72,7 +72,8 @@
       "Bash(node -c plugins/email.js && node -c plugins/default-plugins.js 2>&1)",
       "Bash(node -c plugins/email.js 2>&1)",
       "Bash(npm list:*)",
-      "Bash(node -e \"const {EmailPlugin} = require\\('./plugins/email'\\); const p = new EmailPlugin\\(\\); console.log\\('email plugin loaded ok'\\); console.log\\('enabled:', p.enabled\\); console.log\\('version:', p.version\\);\" 2>&1)"
+      "Bash(node -e \"const {EmailPlugin} = require\\('./plugins/email'\\); const p = new EmailPlugin\\(\\); console.log\\('email plugin loaded ok'\\); console.log\\('enabled:', p.enabled\\); console.log\\('version:', p.version\\);\" 2>&1)",
+      "Bash(cd D:/Code/vb-agent && node -e \"console.log\\('IMAP_HOST:', process.env.IMAP_HOST\\); console.log\\('IMAP_USER:', process.env.IMAP_USER\\); console.log\\('IMAP_PORT:', process.env.IMAP_PORT\\);\")"
     ]
   }
 }

package/SPEC.md

@@ -1,4 +1,4 @@
-# VB-Agent Framework 规划文档
+# Foliko Framework 规划文档
 
 ## 一、设计目标
 
@@ -11,7 +11,7 @@
 
 ```
 ┌─────────────────────────────────────────────────┐
-│                  VB-Agent Framework             │
+│                  Foliko Framework               │
 ├─────────────────────────────────────────────────┤
 │  Framework (容器层)                              │
 │  ├── pluginManager    - 插件加载/卸载/重载       │

package/cli/bin/foliko.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 /**
  * Foliko CLI 入口
  * Usage: foliko <command> [options]

package/docs/quick-reference.md

@@ -1,4 +1,4 @@
-# VB-Agent 快速参考
+# Foliko 快速参考
 
 ## 启动框架
 ```javascript

package/docs/user-manual.md

@@ -1,4 +1,4 @@
-# VB-Agent Framework 用户手册
+# Foliko Framework 用户手册
 
 > 简约的插件化 Agent 框架
 
@@ -20,7 +20,7 @@
 
 ## 1. 项目概述
 
-VB-Agent 是一个基于插件的 Agent 框架，具有以下特性：
+Foliko 是一个基于插件的 Agent 框架，具有以下特性：
 
 - **纯 JS 实现** - 无 TypeScript，简单易懂
 - **插件化架构** - 通过插件扩展功能
@@ -759,7 +759,7 @@ Agent: [获取插件开发指南后，按照指南创建插件]
 
 ### 6.4 内置技能
 
-- **foliko-dev** - VB-Agent 插件开发指南
+- **foliko-dev** - Foliko 插件开发指南
 - **api-patterns** - API 设计模式
 - **app-builder** - 应用程序构建
 - **architecture** - 架构设计
@@ -906,7 +906,7 @@ const agent = framework.createAgent({
 
 ## 10. 事件系统
 
-VB-Agent 基于 EventEmitter，提供完整的事件系统。
+Foliko 基于 EventEmitter，提供完整的事件系统。
 
 ### 10.1 事件基础
 

package/examples/basic.js

@@ -1,110 +1,110 @@
-/**
- * 基础示例
- * 展示如何使用 Framework 和 Agent
- */
-
-const { Framework } = require('../src')
-const { AIPlugin } = require('../plugins/ai-plugin')
-const { z } = require('zod')
-
-async function main() {
-  // 创建框架实例
-  const framework = new Framework({ debug: true })
-
-  // 加载 AI 插件
-  await framework.loadPlugin(new AIPlugin({
-    provider: 'deepseek',
-    model: 'deepseek-chat',
-    apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key'
-  }))
-
-  // 注册自定义工具（使用 inputSchema 格式）
-  framework.registerTool({
-    name: 'hello',
-    description: '打招呼工具',
-    inputSchema: z.object({
-      name: z.string().optional().describe('姓名')
-    }),
-    execute: async (args) => {
-      return `Hello, ${args.name || 'World'}!`
-    }
-  })
-
-  // 注册计算器工具
-  framework.registerTool({
-    name: 'calculate',
-    description: '简单的计算器',
-    inputSchema: z.object({
-      expression: z.string().describe('数学表达式，如 2+3*4')
-    }),
-    execute: async (args) => {
-      try {
-        // 安全计算（仅支持基本运算）
-        const result = Function(`"use strict"; return (${args.expression})`)()
-        return { result }
-      } catch (e) {
-        return { error: e.message }
-      }
-    }
-  })
-
-  console.log('[Framework] Ready!')
-  console.log('[Tools]', framework.getTools().map(t => t.name))
-
-  // 创建 Agent
-  const agent = framework.createAgent({
-    name: 'MyAgent',
-    systemPrompt: '你是一个有帮助的助手。当需要计算时，使用 calculate 工具。'
-  })
-
-  // 监听事件
-  agent.on('tool-call', (tool) => {
-    console.log('[Agent] Tool call:', tool.name, tool.args)
-  })
-
-  agent.on('tool-result', (result) => {
-    console.log('[Agent] Tool result:', result.name, result.result)
-  })
-
-  // AI 对话示例
-  console.log('\n=== AI Chat Example ===')
-  try {
-    const response = await agent.chat('你好！')
-    console.log('[Agent] Response:', response.message)
-  } catch (err) {
-    console.error('[Agent] Error:', err.message)
-  }
-
-  // 使用工具的对话示例
-  console.log('\n=== AI Chat with Tool Call ===')
-  try {
-    const response = await agent.chat('请帮我计算 (15 + 25) * 2 等于多少？')
-    console.log('[Agent] Response:', response.message)
-  } catch (err) {
-    console.error('[Agent] Error:', err.message)
-  }
-
-  // 流式对话示例
-  console.log('\n=== Streaming Chat ===')
-  try {
-    for await (const chunk of agent.chatStream('请用中文介绍一下你自己')) {
-      if (chunk.type === 'text') {
-        process.stdout.write(chunk.text)
-      }
-    }
-    console.log('\n')
-  } catch (err) {
-    console.error('[Agent] Stream Error:', err.message)
-  }
-
-  // 热重载示例
-  console.log('\n=== Hot Reload ===')
-  await framework.reloadPlugin('ai')
-  console.log('AI plugin reloaded!')
-
-  // 清理
-  await framework.destroy()
-  console.log('\n[Done]')
-}
-
-main().catch(console.error)
+/**
+ * 基础示例
+ * 展示如何使用 Framework 和 Agent
+ */
+
+const { Framework } = require('../src')
+const { AIPlugin } = require('../plugins/ai-plugin')
+const { z } = require('zod')
+
+async function main() {
+  // 创建框架实例
+  const framework = new Framework({ debug: true })
+
+  // 加载 AI 插件
+  await framework.loadPlugin(new AIPlugin({
+    provider: 'deepseek',
+    model: 'deepseek-chat',
+    apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key'
+  }))
+
+  // 注册自定义工具（使用 inputSchema 格式）
+  framework.registerTool({
+    name: 'hello',
+    description: '打招呼工具',
+    inputSchema: z.object({
+      name: z.string().optional().describe('姓名')
+    }),
+    execute: async (args) => {
+      return `Hello, ${args.name || 'World'}!`
+    }
+  })
+
+  // 注册计算器工具
+  framework.registerTool({
+    name: 'calculate',
+    description: '简单的计算器',
+    inputSchema: z.object({
+      expression: z.string().describe('数学表达式，如 2+3*4')
+    }),
+    execute: async (args) => {
+      try {
+        // 安全计算（仅支持基本运算）
+        const result = Function(`"use strict"; return (${args.expression})`)()
+        return { result }
+      } catch (e) {
+        return { error: e.message }
+      }
+    }
+  })
+
+  console.log('[Framework] Ready!')
+  console.log('[Tools]', framework.getTools().map(t => t.name))
+
+  // 创建 Agent
+  const agent = framework.createAgent({
+    name: 'MyAgent',
+    systemPrompt: '你是一个有帮助的助手。当需要计算时，使用 calculate 工具。'
+  })
+
+  // 监听事件
+  agent.on('tool-call', (tool) => {
+    console.log('[Agent] Tool call:', tool.name, tool.args)
+  })
+
+  agent.on('tool-result', (result) => {
+    console.log('[Agent] Tool result:', result.name, result.result)
+  })
+
+  // AI 对话示例
+  console.log('\n=== AI Chat Example ===')
+  try {
+    const response = await agent.chat('你好！')
+    console.log('[Agent] Response:', response.message)
+  } catch (err) {
+    console.error('[Agent] Error:', err.message)
+  }
+
+  // 使用工具的对话示例
+  console.log('\n=== AI Chat with Tool Call ===')
+  try {
+    const response = await agent.chat('请帮我计算 (15 + 25) * 2 等于多少？')
+    console.log('[Agent] Response:', response.message)
+  } catch (err) {
+    console.error('[Agent] Error:', err.message)
+  }
+
+  // 流式对话示例
+  console.log('\n=== Streaming Chat ===')
+  try {
+    for await (const chunk of agent.chatStream('请用中文介绍一下你自己')) {
+      if (chunk.type === 'text') {
+        process.stdout.write(chunk.text)
+      }
+    }
+    console.log('\n')
+  } catch (err) {
+    console.error('[Agent] Stream Error:', err.message)
+  }
+
+  // 热重载示例
+  console.log('\n=== Hot Reload ===')
+  await framework.reloadPlugin('ai')
+  console.log('AI plugin reloaded!')
+
+  // 清理
+  await framework.destroy()
+  console.log('\n[Done]')
+}
+
+main().catch(console.error)

package/examples/bootstrap.js

@@ -1,93 +1,93 @@
-/**
- * Bootstrap 示例
- * 使用 framework.bootstrap() 自动加载 .agent/ 目录配置
- */
-
-const { Framework } = require('../src')
-const { z } = require('zod')
-
-async function main() {
-  console.log('=== Bootstrap Example ===\n')
-
-  // 创建框架
-  const framework = new Framework({ debug: true })
-
-  // 使用 bootstrap 自动加载所有默认插件
-  // 会自动检测 .agent/ 目录下的配置
-  await framework.bootstrap({
-    agentDir: './.agent',  // 配置目录
-    aiConfig: {              // 可选：覆盖 AI 配置
-      provider: 'deepseek',
-      model: 'deepseek-chat',
-      apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key'
-    }
-  })
-
-  // 注册 hello 工具（演示用）
-  framework.registerTool({
-    name: 'hello',
-    description: '打招呼',
-    inputSchema: z.object({
-      name: z.string().optional().describe('姓名')
-    }),
-    execute: async (args) => `Hello, ${args.name || 'World'}!`
-  })
-
-  console.log('\n--- Framework Ready ---')
-  console.log('Plugins:', framework.pluginManager.getAll().map(p => p.name))
-  console.log('Tools:', framework.getTools().map(t => t.name))
-
-  // 创建 Agent (支持 sharedPrompt 和 metadata)
-  const agent = framework.createAgent({
-    name: 'MyAgent',
-    systemPrompt: '你是一个有帮助的助手。',
-    sharedPrompt: '工作目录: {{WORK_DIR}}\n用户名: {{USER_NAME}}\n当前时间: {{TIME}}',
-    metadata: {
-      projectName: 'VB-Agent',
-      version: '1.0.0'
-    }
-  })
-
-  console.log('\n--- Agent Context ---')
-  console.log(agent.systemPrompt)
-
-  // 测试对话
-  console.log('\n--- AI Chat Test ---')
-  // try {
-  //   const response = await agent.chat('帮我开发一个获取系统信息的插件')
-  //   console.log('Agent:', response.message)
-  // } catch (err) {
-  //   console.error('Chat error:', err.message)
-  // }
-
-  try {
-    for await (const chunk of agent.chatStream('帮我开发一个获取系统信息的插件')) {
-      if (chunk.type === 'text') {
-        process.stdout.write(chunk.text)
-      }else if (chunk?.type === 'tool-call') {
-        console.log(`\n[工具调用: ${chunk.toolName}]`);
-      } else if (chunk?.type === 'tool-result') {
-        console.log(`\n[工具结果: ${chunk.toolName}]`);
-      }
-    }
-    console.log('\n')
-  } catch (err) {
-    console.error('[Agent] Stream Error:', err.message)
-  }
-
-  // 测试工具调用
-  console.log('\n--- Tool Call Test ---')
-  const result = await framework.executeTool('hello', { name: 'Bootstrap' })
-  console.log('Tool result:', result)
-
-  // 测试内置工具
-  console.log('\n--- Built-in Tools Test ---')
-  const listResult = await framework.executeTool('list_plugins', {})
-  console.log('list_plugins:', listResult)
-
-  // 清理
-  await framework.destroy()
-  console.log('\n[Done]')
-}
-
-main().catch(console.error)
+/**
+ * Bootstrap 示例
+ * 使用 framework.bootstrap() 自动加载 .agent/ 目录配置
+ */
+
+const { Framework } = require('../src')
+const { z } = require('zod')
+
+async function main() {
+  console.log('=== Bootstrap Example ===\n')
+
+  // 创建框架
+  const framework = new Framework({ debug: true })
+
+  // 使用 bootstrap 自动加载所有默认插件
+  // 会自动检测 .agent/ 目录下的配置
+  await framework.bootstrap({
+    agentDir: './.agent',  // 配置目录
+    aiConfig: {              // 可选：覆盖 AI 配置
+      provider: 'deepseek',
+      model: 'deepseek-chat',
+      apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key'
+    }
+  })
+
+  // 注册 hello 工具（演示用）
+  framework.registerTool({
+    name: 'hello',
+    description: '打招呼',
+    inputSchema: z.object({
+      name: z.string().optional().describe('姓名')
+    }),
+    execute: async (args) => `Hello, ${args.name || 'World'}!`
+  })
+
+  console.log('\n--- Framework Ready ---')
+  console.log('Plugins:', framework.pluginManager.getAll().map(p => p.name))
+  console.log('Tools:', framework.getTools().map(t => t.name))
+
+  // 创建 Agent (支持 sharedPrompt 和 metadata)
+  const agent = framework.createAgent({
+    name: 'MyAgent',
+    systemPrompt: '你是一个有帮助的助手。',
+    sharedPrompt: '工作目录: {{WORK_DIR}}\n用户名: {{USER_NAME}}\n当前时间: {{TIME}}',
+    metadata: {
+      projectName: 'Foliko',
+      version: '1.0.0'
+    }
+  })
+
+  console.log('\n--- Agent Context ---')
+  console.log(agent.systemPrompt)
+
+  // 测试对话
+  console.log('\n--- AI Chat Test ---')
+  // try {
+  //   const response = await agent.chat('帮我开发一个获取系统信息的插件')
+  //   console.log('Agent:', response.message)
+  // } catch (err) {
+  //   console.error('Chat error:', err.message)
+  // }
+
+  try {
+    for await (const chunk of agent.chatStream('帮我开发一个获取系统信息的插件')) {
+      if (chunk.type === 'text') {
+        process.stdout.write(chunk.text)
+      }else if (chunk?.type === 'tool-call') {
+        console.log(`\n[工具调用: ${chunk.toolName}]`);
+      } else if (chunk?.type === 'tool-result') {
+        console.log(`\n[工具结果: ${chunk.toolName}]`);
+      }
+    }
+    console.log('\n')
+  } catch (err) {
+    console.error('[Agent] Stream Error:', err.message)
+  }
+
+  // 测试工具调用
+  console.log('\n--- Tool Call Test ---')
+  const result = await framework.executeTool('hello', { name: 'Bootstrap' })
+  console.log('Tool result:', result)
+
+  // 测试内置工具
+  console.log('\n--- Built-in Tools Test ---')
+  const listResult = await framework.executeTool('list_plugins', {})
+  console.log('list_plugins:', listResult)
+
+  // 清理
+  await framework.destroy()
+  console.log('\n[Done]')
+}
+
+main().catch(console.error)

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)