foliko 1.1.93 → 2.0.0

package/examples/ambient-example.js

@@ -1,29 +1,27 @@
 /**
  * Ambient Agent Example
- * Demonstrates how to use the Ambient Agent plugin for autonomous monitoring and actions
+ * Demonstrates how to use the Ambient Agent plugin via the new facade
  */
 
-const { Framework } = require('../src/core/framework');
+const foliko = require('../src');
 
 async function main() {
   console.log('=== Ambient Agent Example ===\n');
 
-  // Create framework
-  const framework = new Framework({
-    debug: true,
-  });
-
   // Bootstrap with default plugins (including ambient)
-  await framework.bootstrap({
-    agentDir: './.foliko',
-    aiConfig: {
-      provider: 'deepseek',
-      model: 'deepseek-chat',
-      apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key',
+  const framework = await foliko.bootstrap({
+    _config: {
+      agentDir: './.foliko',
+      ai: {
+        provider: 'deepseek',
+        model: 'deepseek-chat',
+        apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key',
+      },
     },
   });
 
   console.log('\n=== Framework Ready ===\n');
+  console.log('Plugins:', framework.pluginManager.getNames());
 
   // Wait for plugins to start
   await new Promise((resolve) => setTimeout(resolve, 1000));
@@ -36,12 +34,10 @@ async function main() {
   }
 
   console.log('=== Ambient Plugin Tools Available ===');
-  const tools = framework.getTools();
-  const ambientTools = tools.filter((t) => t.name.startsWith('ambient_'));
+  const ambientTools = framework.getTools().filter((t) => t.name.startsWith('ambient_'));
   console.log('Ambient tools:', ambientTools.map((t) => t.name).join(', '));
 
-  console.log('\n=== Example 1: Create a Goal ===');
-  // Use ambient_goals to create a simple goal
+  console.log('\n=== Example: Create a Goal ===');
   const createResult = await framework.executeTool('ambient_goals', {
     action: 'create',
     title: 'Monitor System Health',
@@ -51,141 +47,28 @@ async function main() {
   });
   console.log('Create goal result:', JSON.stringify(createResult, null, 2));
 
-  console.log('\n=== Example 2: Create a Thinking Goal ===');
-  // Create a goal that triggers LLM thinking
-  const thinkGoal = await framework.executeTool('ambient_goals', {
-    action: 'create',
-    title: 'Periodic Reflection',
-    description: 'Regularly reflect on system state and suggest improvements',
-    priority: 5,
-    actions: [
-      { id: 'reflect_1', type: 'think', topic: 'System state review', mode: 'reflect', depth: 3 },
-    ],
-  });
-  console.log('Create thinking goal result:', JSON.stringify(thinkGoal, null, 2));
-
-  console.log('\n=== Example 3: List All Goals ===');
-  const listResult = await framework.executeTool('ambient_goals', {
-    action: 'list',
-  });
+  console.log('\n=== Example: List All Goals ===');
+  const listResult = await framework.executeTool('ambient_goals', { action: 'list' });
   console.log('Goals list:', JSON.stringify(listResult, null, 2));
 
-  console.log('\n=== Example 4: Get Ambient Status ===');
-  const statusResult = await framework.executeTool('ambient_status', {});
-  console.log('Status:', JSON.stringify(statusResult, null, 2));
-
-  console.log('\n=== Example 5: Store a Memory ===');
-  const storeResult = await framework.executeTool('ambient_remember', {
+  console.log('\n=== Example: Store and Retrieve Memories ===');
+  await framework.executeTool('ambient_remember', {
     action: 'store',
     content: 'Important: System check showed high CPU usage at 14:30',
     key: 'cpu_alert_1',
   });
-  console.log('Store memory result:', JSON.stringify(storeResult, null, 2));
-
-  console.log('\n=== Example 6: Retrieve Memories ===');
   const retrieveResult = await framework.executeTool('ambient_remember', {
     action: 'retrieve',
     limit: 5,
   });
-  console.log('Retrieve memories result:', JSON.stringify(retrieveResult, null, 2));
-
-  console.log('\n=== Example 7: Search Memories ===');
-  const searchResult = await framework.executeTool('ambient_remember', {
-    action: 'search',
-    query: 'CPU',
-  });
-  console.log('Search memories result:', JSON.stringify(searchResult, null, 2));
-
-  console.log('\n=== Example 8: Trigger Thinking ===');
-  const thinkResult = await framework.executeTool('ambient_think', {
-    mode: 'brainstorm',
-    topic: 'What improvements could be made to the current system?',
-    depth: 3,
-  });
-  console.log('Think result:', JSON.stringify(thinkResult, null, 2));
-
-  console.log('\n=== Example 9: Control Loop ===');
-  console.log('Pausing loop...');
-  const pauseResult = await framework.executeTool('ambient_control', {
-    action: 'pause',
-  });
-  console.log('Pause result:', JSON.stringify(pauseResult, null, 2));
-
-  await new Promise((resolve) => setTimeout(resolve, 1000));
-
-  console.log('Resuming loop...');
-  const resumeResult = await framework.executeTool('ambient_control', {
-    action: 'resume',
-  });
-  console.log('Resume result:', JSON.stringify(resumeResult, null, 2));
-
-  console.log('\n=== Example 10: Adjust Loop Settings ===');
-  const adjustResult = await framework.executeTool('ambient_control', {
-    action: 'adjust',
-    tickInterval: 10000, // 10 seconds
-    cooldownPeriod: 5000, // 5 seconds
-  });
-  console.log('Adjust result:', JSON.stringify(adjustResult, null, 2));
-
-  console.log('\n=== Example 11: Get Final Status ===');
-  const finalStatus = await framework.executeTool('ambient_status', {});
-  console.log('Final status:', JSON.stringify(finalStatus, null, 2));
-
-  console.log('\n=== Example 12: Activate a Pending Goal ===');
-  // First create a pending goal (without auto-activation conditions)
-  const newGoal = await framework.executeTool('ambient_goals', {
-    action: 'create',
-    title: 'Inactive Test Goal',
-    description: 'A goal that starts inactive',
-    priority: 3,
-    actions: [],
-  });
-  console.log('Created inactive goal:', newGoal.goal ? newGoal.goal.id : 'N/A');
-
-  if (newGoal.goal) {
-    console.log('Activating goal...');
-    const activateResult = await framework.executeTool('ambient_goals', {
-      action: 'activate',
-      goalId: newGoal.goal.id,
-    });
-    console.log('Activate result:', JSON.stringify(activateResult, null, 2));
-  }
-
-  console.log('\n=== Example 13: Update a Goal ===');
-  const goals = await framework.executeTool('ambient_goals', { action: 'list' });
-  if (goals.goals && goals.goals.length > 0) {
-    const goalToUpdate = goals.goals[0];
-    console.log(`Updating goal ${goalToUpdate.id}...`);
-    const updateResult = await framework.executeTool('ambient_goals', {
-      action: 'update',
-      goalId: goalToUpdate.id,
-      priority: 10,
-    });
-    console.log('Update result:', JSON.stringify(updateResult, null, 2));
-  }
-
-  console.log('\n=== Example 14: Delete a Goal ===');
-  const deleteGoal = await framework.executeTool('ambient_goals', {
-    action: 'create',
-    title: 'Goal to Delete',
-    description: 'This will be deleted',
-    priority: 1,
-  });
-  if (deleteGoal.goal) {
-    console.log(`Created goal to delete: ${deleteGoal.goal.id}`);
-    const deleteResult = await framework.executeTool('ambient_goals', {
-      action: 'delete',
-      goalId: deleteGoal.goal.id,
-    });
-    console.log('Delete result:', JSON.stringify(deleteResult, null, 2));
-  }
+  console.log('Memories:', JSON.stringify(retrieveResult, null, 2));
 
   console.log('\n=== All Examples Completed ===');
   console.log('Check .foliko/data/ambient/ for persisted data');
 
   // Cleanup
-  console.log('\nShutting down...');
-  await framework.destroy();
+  await foliko.destroy(framework);
+  console.log('\n[Done]');
 }
 
 main().catch((err) => {

package/examples/basic.js

@@ -1,39 +1,33 @@
 /**
  * 基础示例
- * 展示如何使用 Framework 和 Agent
+ * 展示如何使用新门面 API 创建 Framework 和 Agent
  */
 
-const { Framework } = require('../src');
-const AIPlugin = require('../plugins/ai-plugin');
+const foliko = require('../src');
 const { z } = require('zod');
 
 async function main() {
-  // 创建框架实例
-  const framework = new Framework({ debug: true });
+  // 方式一：使用 createApp 链式加载插件
+  const app = foliko.createApp({ debug: true });
+  await app.use(foliko.withAI({
+    provider: 'deepseek',
+    model: 'deepseek-chat',
+    apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key',
+  }));
+  const { bootstrap } = require('../src/framework/lifecycle');
+  await bootstrap(app, { _config: { ai: {} } });
 
-  // 加载 AI 插件
-  await framework.loadPlugin(
-    new AIPlugin({
-      provider: 'deepseek',
-      model: 'deepseek-chat',
-      apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key',
-    })
-  );
-
-  // 注册自定义工具（使用 inputSchema 格式）
-  framework.registerTool({
+  // 注册自定义工具
+  app.registerTool({
     name: 'hello',
     description: '打招呼工具',
     inputSchema: z.object({
       name: z.string().optional().describe('姓名'),
     }),
-    execute: async (args) => {
-      return `Hello, ${args.name || 'World'}!`;
-    },
+    execute: async (args) => `Hello, ${args.name || 'World'}!`,
   });
 
-  // 注册计算器工具
-  framework.registerTool({
+  app.registerTool({
     name: 'calculate',
     description: '简单的计算器',
     inputSchema: z.object({
@@ -41,7 +35,6 @@ async function main() {
     }),
     execute: async (args) => {
       try {
-        // 安全计算（仅支持基本运算）
         const result = Function(`"use strict"; return (${args.expression})`)();
         return { result };
       } catch (e) {
@@ -51,13 +44,10 @@ async function main() {
   });
 
   console.log('[Framework] Ready!');
-  console.log(
-    '[Tools]',
-    framework.getTools().map((t) => t.name)
-  );
+  console.log('[Tools]', app.getTools().map((t) => t.name));
 
   // 创建 Agent
-  const agent = framework.createAgent({
+  const agent = foliko.createAgent(app, {
     name: 'MyAgent',
     systemPrompt: '你是一个有帮助的助手。当需要计算时，使用 calculate 工具。',
   });
@@ -66,12 +56,11 @@ async function main() {
   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 对话示例
+  // AI 对话
   console.log('\n=== AI Chat Example ===');
   try {
     const response = await agent.chat('你好！');
@@ -80,35 +69,19 @@ async function main() {
     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);
-      }
+      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();
+  await foliko.destroy(app);
   console.log('\n[Done]');
 }
 

package/examples/bootstrap.js

@@ -1,31 +1,28 @@
 /**
  * Bootstrap 示例
- * 使用 framework.bootstrap() 自动加载 .foliko/ 目录配置
+ * 使用 foliko.bootstrap() 自动加载配置
  */
 
-const { Framework } = require('../src');
+const foliko = require('../src');
 const { z } = require('zod');
 
 async function main() {
   console.log('=== Bootstrap Example ===\n');
 
-  // 创建框架
-  const framework = new Framework({ debug: true });
-
-  // 使用 bootstrap 自动加载所有默认插件
-  // 会自动检测 .foliko/ 目录下的配置
-  await framework.bootstrap({
-    agentDir: './.foliko', // 配置目录
-    aiConfig: {
-      // 可选：覆盖 AI 配置
-      provider: 'deepseek',
-      model: 'deepseek-chat',
-      apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key',
+  // 使用新门面 bootstrap — 创建 Framework 并加载所有默认插件
+  const framework = await foliko.bootstrap({
+    _config: {
+      agentDir: './.foliko',
+      ai: {
+        provider: 'deepseek',
+        model: 'deepseek-chat',
+        apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key',
+      },
     },
   });
 
   // 注册 hello 工具（演示用）
-  framework.registerTool({
+  foliko.registerTool(framework, {
     name: 'hello',
     description: '打招呼',
     inputSchema: z.object({
@@ -37,84 +34,29 @@ async function main() {
   console.log('\n--- Framework Ready ---');
   console.log(
     'Plugins:',
-    framework.pluginManager.getAll().map((p) => p.name)
+    framework.pluginManager.getNames()
   );
   console.log(
     'Tools:',
     framework.getTools().map((t) => t.name)
   );
 
-  // 创建 Agent (支持 sharedPrompt 和 metadata)
-  const agent = framework.createAgent({
+  // 创建 Agent
+  const agent = foliko.createAgent(framework, {
     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();
+  await foliko.destroy(framework);
   console.log('\n[Done]');
 }
 

package/examples/mcp-example.js

@@ -1,55 +1,32 @@
 /**
  * MCP 执行器示例
- * 展示如何连接 MCP 服务器
  */
 
-const { Framework } = require('../src');
+const foliko = require('../src');
 const { MCPExecutorPlugin } = require('../src/executors/mcp-executor');
 
 async function main() {
   console.log('=== MCP Executor Example ===\n');
 
-  // 创建框架
-  const framework = new Framework({ debug: true });
+  const framework = foliko.createApp({ debug: true });
 
   // 创建 MCP 执行器插件
-  const mcpPlugin = new MCPExecutorPlugin({
-    servers: [
-      // 示例：添加一个 MCP 服务器
-      // {
-      //   name: 'example',
-      //   command: 'uvx',
-      //   args: ['example-mcp-server'],
-      //   env: {}
-      // }
-    ],
-  });
+  const mcpPlugin = new MCPExecutorPlugin({ servers: [] });
 
   // 加载插件
   await framework.loadPlugin(mcpPlugin);
 
   // 列出服务器
   console.log('\n--- MCP Servers ---');
-  const servers = mcpPlugin.getServers();
-  console.log('Servers:', servers);
+  console.log('Servers:', mcpPlugin.getServers());
 
   // 列出所有 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 */ }
-  // })
+  console.log('MCP tools:', tools.map((t) => t.name));
 
   // 清理
-  await framework.destroy();
+  await foliko.destroy(framework);
   console.log('\n[Done]');
 }
 

package/examples/skill-example.js

@@ -1,16 +1,14 @@
 /**
  * Skill 管理器示例
- * 展示如何加载和使用 Skill
  */
 
-const { Framework } = require('../src');
-const { SkillManagerPlugin } = require('../src/capabilities/skill-manager');
+const foliko = require('../src');
+const { SkillManagerPlugin } = require('../plugins/core/skill-manager');
 
 async function main() {
   console.log('=== Skill Manager Example ===\n');
 
-  // 创建框架
-  const framework = new Framework({ debug: true });
+  const framework = foliko.createApp({ debug: true });
 
   // 创建 skills 目录（如果没有）
   const fs = require('fs');
@@ -20,29 +18,18 @@ async function main() {
   }
 
   // 加载 Skill 管理器插件
-  const skillPlugin = new SkillManagerPlugin({
-    skillsDir: skillsDir,
-  });
-
-  await framework.loadPlugin(skillPlugin);
+  await framework.loadPlugin(new SkillManagerPlugin({ skillsDir }));
 
   // 列出所有加载的 skills
   console.log('\n--- Loaded Skills ---');
-  const skills = skillPlugin.getAllSkills();
+  const skills = framework.getPluginInstance('skill-manager').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();
+  await foliko.destroy(framework);
   console.log('\n[Done]');
 }