foliko 1.0.73 → 1.0.75

package/examples/bootstrap.js

@@ -3,39 +3,46 @@
  * 使用 framework.bootstrap() 自动加载 .agent/ 目录配置
  */
 
-const { Framework } = require('../src')
-const { z } = require('zod')
+const { Framework } = require('../src');
+const { z } = require('zod');
 
 async function main() {
-  console.log('=== Bootstrap Example ===\n')
+  console.log('=== Bootstrap Example ===\n');
 
   // 创建框架
-  const framework = new Framework({ debug: true })
+  const framework = new Framework({ debug: true });
 
   // 使用 bootstrap 自动加载所有默认插件
   // 会自动检测 .agent/ 目录下的配置
   await framework.bootstrap({
-    agentDir: './.agent',  // 配置目录
-    aiConfig: {              // 可选：覆盖 AI 配置
+    agentDir: './.agent', // 配置目录
+    aiConfig: {
+      // 可选：覆盖 AI 配置
       provider: 'deepseek',
       model: 'deepseek-chat',
-      apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key'
-    }
-  })
+      apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key',
+    },
+  });
 
   // 注册 hello 工具（演示用）
   framework.registerTool({
     name: 'hello',
     description: '打招呼',
     inputSchema: z.object({
-      name: z.string().optional().describe('姓名')
+      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))
+    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({
@@ -44,15 +51,15 @@ async function main() {
     sharedPrompt: '工作目录: {{WORK_DIR}}\n用户名: {{USER_NAME}}\n当前时间: {{TIME}}',
     metadata: {
       projectName: 'Foliko',
-      version: '1.0.0'
-    }
-  })
+      version: '1.0.0',
+    },
+  });
 
-  console.log('\n--- Agent Context ---')
-  console.log(agent.systemPrompt)
+  console.log('\n--- Agent Context ---');
+  console.log(agent.systemPrompt);
 
   // 测试对话
-  console.log('\n--- AI Chat Test ---')
+  console.log('\n--- AI Chat Test ---');
   // try {
   //   const response = await agent.chat('帮我开发一个获取系统信息的插件')
   //   console.log('Agent:', response.message)
@@ -63,50 +70,52 @@ async function main() {
   try {
     for await (const chunk of agent.chatStream('帮我开发一个获取系统信息的插件')) {
       if (chunk.type === 'text') {
-        process.stdout.write(chunk.text)
-      }else if (chunk?.type === 'tool-call') {
+        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')
+    console.log('\n');
   } catch (err) {
-    console.error('[Agent] Stream Error:', err.message)
+    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--- 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)
+  console.log('\n--- Built-in Tools Test ---');
+  const listResult = await framework.executeTool('list_plugins', {});
+  console.log('list_plugins:', listResult);
 
   // 测试 Web 插件 - 让 LLM 注册路由并测试
-  console.log('\n--- Web Plugin Test ---')
-  console.log('指示 LLM 注册一个 GET /test 路由...\n')
+  console.log('\n--- Web Plugin Test ---');
+  console.log('指示 LLM 注册一个 GET /test 路由...\n');
 
   try {
-    for await (const chunk of agent.chatStream('请帮我注册一个 GET 路由 /test，handler 写：return "1232432"。只调用工具不要解释。')) {
+    for await (const chunk of agent.chatStream(
+      '请帮我注册一个 GET 路由 /test，handler 写：return "1232432"。只调用工具不要解释。'
+    )) {
       if (chunk.type === 'text') {
-        process.stdout.write(chunk.text)
+        process.stdout.write(chunk.text);
       } else if (chunk?.type === 'tool-call') {
-        console.log(`\n[工具调用: ${chunk.toolName}]`)
+        console.log(`\n[工具调用: ${chunk.toolName}]`);
       } else if (chunk?.type === 'tool-result') {
-        console.log(`\n[工具结果] ${JSON.stringify(chunk.result).substring(0, 200)}...`)
+        console.log(`\n[工具结果] ${JSON.stringify(chunk.result).substring(0, 200)}...`);
       }
     }
-    console.log('\n')
+    console.log('\n');
   } catch (err) {
-    console.error('[Agent] Web Plugin Test Error:', err.message)
+    console.error('[Agent] Web Plugin Test Error:', err.message);
   }
 
   // 清理
-  await framework.destroy()
-  console.log('\n[Done]')
+  await framework.destroy();
+  console.log('\n[Done]');
 }
 
-main().catch(console.error)
+main().catch(console.error);

package/examples/mcp-example.js

@@ -1,53 +1,56 @@
-/**
- * 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

@@ -4,17 +4,17 @@
  * 支持多行输入：连续按两次回车结束输入
  */
 
-const { Framework } = require('../src')
-const readline = require('readline')
-require('dotenv').config()
+const { Framework } = require('../src');
+const readline = require('readline');
+require('dotenv').config();
 
 async function main() {
-  console.log('=== Foliko 持续聊天测试 ===\n')
-  console.log('输入消息与 Agent 对话，输入 exit 或 quit 退出')
-  console.log('多行输入：按两次回车结束，或输入 !! 立即结束\n')
+  console.log('=== Foliko 持续聊天测试 ===\n');
+  console.log('输入消息与 Agent 对话，输入 exit 或 quit 退出');
+  console.log('多行输入：按两次回车结束，或输入 !! 立即结束\n');
 
   // 创建框架
-  const framework = new Framework({ debug: false })
+  const framework = new Framework({ debug: false });
 
   // Bootstrap
   await framework.bootstrap({
@@ -22,12 +22,12 @@ async function main() {
     aiConfig: {
       provider: 'minimax',
       model: 'MiniMax-M2.7',
-      baseURL:'https://api.minimaxi.com/v1',
-      apiKey: process.env.MINIMAX_API_KEY
-    }
-  })
+      baseURL: 'https://api.minimaxi.com/v1',
+      apiKey: process.env.MINIMAX_API_KEY,
+    },
+  });
 
-  console.log('框架已就绪\n')
+  console.log('框架已就绪\n');
 
   // 创建 Agent
   const agent = framework.createAgent({
@@ -36,100 +36,102 @@ async function main() {
     sharedPrompt: '工作目录: {{WORK_DIR}}',
     metadata: {
       projectName: 'Foliko',
-      version: '1.0.0'
-    }
-  })
+      version: '1.0.0',
+    },
+  });
 
   // 创建命令行界面
   const rl = readline.createInterface({
     input: process.stdin,
-    output: process.stdout
-  })
+    output: process.stdout,
+  });
 
   // 多行输入函数
   const readMultiline = () => {
     return new Promise((resolve) => {
-      const lines = []
+      const lines = [];
 
       const question = () => {
         rl.question(lines.length === 0 ? '> ' : '- ', (input) => {
           // 输入 !! 立即结束
           if (input.trim() === '!!') {
-            const result = lines.join('\n').trim()
-            resolve(result)
-            return
+            const result = lines.join('\n').trim();
+            resolve(result);
+            return;
           }
           // 空行结束输入
           if (input.trim() === '') {
-            const result = lines.join('\n').trim()
-            resolve(result)
-            return
+            const result = lines.join('\n').trim();
+            resolve(result);
+            return;
           }
-          lines.push(input)
-          question()
-        })
-      }
-      question()
-    })
-  }
+          lines.push(input);
+          question();
+        });
+      };
+      question();
+    });
+  };
 
   // 提问函数
   const ask = async (question) => {
     try {
-      console.log('\n[Agent 思考中...]\n')
+      console.log('\n[Agent 思考中...]\n');
 
       // 使用流式响应
-      let fullResponse = ''
+      let fullResponse = '';
       for await (const chunk of agent.chatStream(question)) {
         if (chunk.type === 'text') {
-          process.stdout.write(chunk.text)
-          fullResponse += chunk.text
+          process.stdout.write(chunk.text);
+          fullResponse += chunk.text;
         } else if (chunk.type === 'tool-call') {
-          console.log('\n\n[工具调用]', chunk.toolName)
+          console.log('\n\n[工具调用]', chunk.toolName);
         } else if (chunk.type === 'tool-result') {
-          console.log('\n[工具结果]', JSON.stringify(chunk.result).substring(0, 100))
+          console.log('\n[工具结果]', JSON.stringify(chunk.result).substring(0, 100));
         } else if (chunk.type === 'error') {
-          console.error('\n[错误]', chunk.error)
+          console.error('\n[错误]', chunk.error);
         }
       }
 
-      console.log('\n')
-      return fullResponse
+      console.log('\n');
+      return fullResponse;
     } catch (err) {
-      console.error('\n[错误]', err.message)
-      return ''
+      console.error('\n[错误]', err.message);
+      return '';
     }
-  }
+  };
 
   // 欢迎消息
-  console.log('Agent: 你好！有什么可以帮助你的吗？\n')
+  console.log('Agent: 你好！有什么可以帮助你的吗？\n');
 
   // 初始任务：让 LLM 注册一个测试路由
-  console.log('\n[系统] 指示 Agent 注册一个 GET /test 路由，返回 "1232432"\n')
-  await ask('请帮我注册一个 GET 路由：\n- 路径：/test\n- 处理函数：return "1232432"\n\n注册完成后，用 web_request 工具测试访问这个路由，确认返回 "1232432"')
+  console.log('\n[系统] 指示 Agent 注册一个 GET /test 路由，返回 "1232432"\n');
+  await ask(
+    '请帮我注册一个 GET 路由：\n- 路径：/test\n- 处理函数：return "1232432"\n\n注册完成后，用 web_request 工具测试访问这个路由，确认返回 "1232432"'
+  );
 
-  console.log('\n--- 测试完成，现在你可以继续对话 ---\n')
+  console.log('\n--- 测试完成，现在你可以继续对话 ---\n');
 
   // 主循环
   const promptUser = async () => {
-    const input = await readMultiline()
-    const trimmed = input.trim()
+    const input = await readMultiline();
+    const trimmed = input.trim();
 
     if (trimmed.toLowerCase() === 'exit' || trimmed.toLowerCase() === 'quit') {
-      console.log('\n再见！')
-      await framework.destroy()
-      rl.close()
-      return
+      console.log('\n再见！');
+      await framework.destroy();
+      rl.close();
+      return;
     }
 
     if (trimmed) {
-      await ask(trimmed)
+      await ask(trimmed);
     }
 
-    promptUser()
-  }
+    promptUser();
+  };
 
-  promptUser()
+  promptUser();
 }
 
-main().catch(console.error)
+main().catch(console.error);