foliko 1.0.0

package/src/index.js

@@ -0,0 +1,37 @@
+/**
+ * VB-Agent Framework
+ * 简约的插件化 Agent 框架
+ */
+
+const {
+  Framework,
+  Agent,
+  Plugin,
+  PluginManager,
+  ToolRegistry,
+  EventEmitter
+} = require('./core')
+
+const {
+  SkillManagerPlugin,
+  WorkflowPlugin
+} = require('./capabilities')
+
+const {
+  MCPExecutorPlugin
+} = require('./executors/mcp-executor')
+
+module.exports = {
+  // 核心
+  Framework,
+  Agent,
+  Plugin,
+  PluginManager,
+  ToolRegistry,
+  EventEmitter,
+
+  // 能力插件
+  SkillManagerPlugin,
+  WorkflowPlugin,
+  MCPExecutorPlugin
+}

package/src/utils/event-emitter.js

@@ -0,0 +1,97 @@
+/**
+ * EventEmitter 事件发射器
+ * 简单的事件总线实现
+ */
+
+class EventEmitter {
+  constructor() {
+    this._events = new Map()
+  }
+
+  /**
+   * 监听事件
+   * @param {string} event - 事件名
+   * @param {Function} handler - 处理函数
+   * @returns {this}
+   */
+  on(event, handler) {
+    if (!this._events.has(event)) {
+      this._events.set(event, new Set())
+    }
+    this._events.get(event).add(handler)
+    return this
+  }
+
+  /**
+   * 监听一次性事件
+   * @param {string} event - 事件名
+   * @param {Function} handler - 处理函数
+   * @returns {this}
+   */
+  once(event, handler) {
+    const wrapper = (...args) => {
+      handler(...args)
+      this.off(event, wrapper)
+    }
+    return this.on(event, wrapper)
+  }
+
+  /**
+   * 取消监听
+   * @param {string} event - 事件名
+   * @param {Function} handler - 处理函数
+   * @returns {this}
+   */
+  off(event, handler) {
+    const handlers = this._events.get(event)
+    if (handlers) {
+      handlers.delete(handler)
+    }
+    return this
+  }
+
+  /**
+   * 触发事件
+   * @param {string} event - 事件名
+   * @param {...any} args - 参数
+   * @returns {this}
+   */
+  emit(event, ...args) {
+    const handlers = this._events.get(event)
+    if (handlers) {
+      for (const handler of handlers) {
+        try {
+          handler(...args)
+        } catch (err) {
+          console.error(`[EventEmitter] Error in handler for '${event}':`, err)
+        }
+      }
+    }
+    return this
+  }
+
+  /**
+   * 移除所有监听器
+   * @param {string} [event] - 可选，指定事件名
+   * @returns {this}
+   */
+  removeAllListeners(event) {
+    if (event) {
+      this._events.delete(event)
+    } else {
+      this._events.clear()
+    }
+    return this
+  }
+
+  /**
+   * 获取监听器数量
+   * @param {string} event - 事件名
+   * @returns {number}
+   */
+  listenerCount(event) {
+    return this._events.get(event)?.size || 0
+  }
+}
+
+module.exports = { EventEmitter }

package/test-chat.js

@@ -0,0 +1,129 @@
+/**
+ * 持续聊天测试
+ * 运行后可以在终端输入消息与 Agent 对话
+ * 支持多行输入：连续按两次回车结束输入
+ */
+
+const { Framework } = require('./src')
+const readline = require('readline')
+require('dotenv').config()
+
+async function main() {
+  console.log('=== VB-Agent 持续聊天测试 ===\n')
+  console.log('输入消息与 Agent 对话，输入 exit 或 quit 退出')
+  console.log('多行输入：按两次回车结束，或输入 !! 立即结束\n')
+
+  // 创建框架
+  const framework = new Framework({ debug: false })
+
+  // Bootstrap
+  await framework.bootstrap({
+    agentDir: './.agent',
+    aiConfig: {
+      provider: 'minimax',
+      model: 'MiniMax-M2.7',
+      baseURL:'https://api.minimaxi.com/v1',
+      apiKey: process.env.MINIMAX_API_KEY
+    }
+  })
+
+  console.log('框架已就绪\n')
+
+  // 创建 Agent
+  const agent = framework.createAgent({
+    name: 'TestAgent',
+    systemPrompt: '你是一个有帮助的助手，擅长回答问题和执行任务。',
+    sharedPrompt: '工作目录: {{WORK_DIR}}',
+    metadata: {
+      projectName: 'VB-Agent',
+      version: '1.0.0'
+    }
+  })
+
+  // 创建命令行界面
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  })
+
+  // 多行输入函数
+  const readMultiline = () => {
+    return new Promise((resolve) => {
+      const lines = []
+
+      const question = () => {
+        rl.question(lines.length === 0 ? 'You: ' : '> ', (input) => {
+          // 输入 !! 立即结束
+          if (input.trim() === '!!') {
+            const result = lines.join('\n').trim()
+            resolve(result)
+            return
+          }
+          // 空行结束输入
+          if (input.trim() === '') {
+            const result = lines.join('\n').trim()
+            resolve(result)
+            return
+          }
+          lines.push(input)
+          question()
+        })
+      }
+      question()
+    })
+  }
+
+  // 提问函数
+  const ask = async (question) => {
+    try {
+      console.log('\n[Agent 思考中...]\n')
+
+      // 使用流式响应
+      let fullResponse = ''
+      for await (const chunk of agent.chatStream(question)) {
+        if (chunk.type === 'text') {
+          process.stdout.write(chunk.text)
+          fullResponse += chunk.text
+        } else if (chunk.type === 'tool-call') {
+          console.log('\n\n[工具调用]', chunk.toolName)
+        } else if (chunk.type === 'tool-result') {
+          console.log('\n[工具结果]', JSON.stringify(chunk.result).substring(0, 100))
+        } else if (chunk.type === 'error') {
+          console.error('\n[错误]', chunk.error)
+        }
+      }
+
+      console.log('\n')
+      return fullResponse
+    } catch (err) {
+      console.error('\n[错误]', err.message)
+      return ''
+    }
+  }
+
+  // 欢迎消息
+  console.log('Agent: 你好！有什么可以帮助你的吗？\n')
+
+  // 主循环
+  const promptUser = async () => {
+    const input = await readMultiline()
+    const trimmed = input.trim()
+
+    if (trimmed.toLowerCase() === 'exit' || trimmed.toLowerCase() === 'quit') {
+      console.log('\n再见！')
+      await framework.destroy()
+      rl.close()
+      return
+    }
+
+    if (trimmed) {
+      await ask(trimmed)
+    }
+
+    promptUser()
+  }
+
+  promptUser()
+}
+
+main().catch(console.error)

package/test-mcp.js

@@ -0,0 +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)
+  })

package/test-reload.js

@@ -0,0 +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)
+  })