foliko 1.0.29 → 1.0.30

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)

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)
+  })