foliko 1.0.74 → 1.0.76

package/examples/bootstrap.js

@@ -1,112 +1,121 @@
-/**
- * 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)
-
-  // 测试 Web 插件 - 让 LLM 注册路由并测试
-  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"。只调用工具不要解释。')) {
-      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[工具结果] ${JSON.stringify(chunk.result).substring(0, 200)}...`)
-      }
-    }
-    console.log('\n')
-  } catch (err) {
-    console.error('[Agent] Web Plugin Test Error:', err.message)
-  }
-
-  // 清理
-  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);
+
+  // 测试 Web 插件 - 让 LLM 注册路由并测试
+  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"。只调用工具不要解释。'
+    )) {
+      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[工具结果] ${JSON.stringify(chunk.result).substring(0, 200)}...`);
+      }
+    }
+    console.log('\n');
+  } catch (err) {
+    console.error('[Agent] Web Plugin Test Error:', err.message);
+  }
+
+  // 清理
+  await framework.destroy();
+  console.log('\n[Done]');
+}
+
+main().catch(console.error);

package/examples/mcp-example.js

@@ -3,14 +3,14 @@
  * 展示如何连接 MCP 服务器
  */
 
-const { Framework } = require('../src')
-const { MCPExecutorPlugin } = require('../src/executors/mcp-executor')
+const { Framework } = require('../src');
+const { MCPExecutorPlugin } = require('../src/executors/mcp-executor');
 
 async function main() {
-  console.log('=== MCP Executor Example ===\n')
+  console.log('=== MCP Executor Example ===\n');
 
   // 创建框架
-  const framework = new Framework({ debug: true })
+  const framework = new Framework({ debug: true });
 
   // 创建 MCP 执行器插件
   const mcpPlugin = new MCPExecutorPlugin({
@@ -22,21 +22,24 @@ async function main() {
       //   args: ['example-mcp-server'],
       //   env: {}
       // }
-    ]
-  })
+    ],
+  });
 
   // 加载插件
-  await framework.loadPlugin(mcpPlugin)
+  await framework.loadPlugin(mcpPlugin);
 
   // 列出服务器
-  console.log('\n--- MCP Servers ---')
-  const servers = mcpPlugin.getServers()
-  console.log('Servers:', servers)
+  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))
+  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', {
@@ -46,8 +49,8 @@ async function main() {
   // })
 
   // 清理
-  await framework.destroy()
-  console.log('\n[Done]')
+  await framework.destroy();
+  console.log('\n[Done]');
 }
 
-main().catch(console.error)
+main().catch(console.error);

package/examples/skill-example.js

@@ -3,47 +3,47 @@
  * 展示如何加载和使用 Skill
  */
 
-const { Framework } = require('../src')
-const { SkillManagerPlugin } = require('../src/capabilities/skill-manager')
+const { Framework } = require('../src');
+const { SkillManagerPlugin } = require('../src/capabilities/skill-manager');
 
 async function main() {
-  console.log('=== Skill Manager Example ===\n')
+  console.log('=== Skill Manager Example ===\n');
 
   // 创建框架
-  const framework = new Framework({ debug: true })
+  const framework = new Framework({ debug: true });
 
   // 创建 skills 目录（如果没有）
-  const fs = require('fs')
-  const skillsDir = './skills'
+  const fs = require('fs');
+  const skillsDir = './skills';
   if (!fs.existsSync(skillsDir)) {
-    fs.mkdirSync(skillsDir, { recursive: true })
+    fs.mkdirSync(skillsDir, { recursive: true });
   }
 
   // 加载 Skill 管理器插件
   const skillPlugin = new SkillManagerPlugin({
-    skillsDir: skillsDir
-  })
+    skillsDir: skillsDir,
+  });
 
-  await framework.loadPlugin(skillPlugin)
+  await framework.loadPlugin(skillPlugin);
 
   // 列出所有加载的 skills
-  console.log('\n--- Loaded Skills ---')
-  const skills = skillPlugin.getAllSkills()
-  console.log(`Found ${skills.length} 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}`)
+    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) + '...')
+    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]')
+  await framework.destroy();
+  console.log('\n[Done]');
 }
 
-main().catch(console.error)
+main().catch(console.error);

package/examples/test-chat.js

@@ -1,135 +1,137 @@
-/**
- * 持续聊天测试
- * 运行后可以在终端输入消息与 Agent 对话
- * 支持多行输入：连续按两次回车结束输入
- */
-
-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')
-
-  // 创建框架
-  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: 'Foliko',
-      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 ? '> ' : '- ', (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')
-
-  // 初始任务：让 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--- 测试完成，现在你可以继续对话 ---\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)
+/**
+ * 持续聊天测试
+ * 运行后可以在终端输入消息与 Agent 对话
+ * 支持多行输入：连续按两次回车结束输入
+ */
+
+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');
+
+  // 创建框架
+  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: 'Foliko',
+      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 ? '> ' : '- ', (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');
+
+  // 初始任务：让 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--- 测试完成，现在你可以继续对话 ---\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);