foliko 1.0.73 → 1.0.75

package/examples/ambient-example.js

@@ -3,15 +3,15 @@
  * Demonstrates how to use the Ambient Agent plugin for autonomous monitoring and actions
  */
 
-const { Framework } = require('../src/core/framework')
+const { Framework } = require('../src/core/framework');
 
 async function main() {
-  console.log('=== Ambient Agent Example ===\n')
+  console.log('=== Ambient Agent Example ===\n');
 
   // Create framework
   const framework = new Framework({
-    debug: true
-  })
+    debug: true,
+  });
 
   // Bootstrap with default plugins (including ambient)
   await framework.bootstrap({
@@ -19,41 +19,39 @@ async function main() {
     aiConfig: {
       provider: 'deepseek',
       model: 'deepseek-chat',
-      apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key'
-    }
-  })
+      apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key',
+    },
+  });
 
-  console.log('\n=== Framework Ready ===\n')
+  console.log('\n=== Framework Ready ===\n');
 
   // Wait for plugins to start
-  await new Promise(resolve => setTimeout(resolve, 1000))
+  await new Promise((resolve) => setTimeout(resolve, 1000));
 
   // Check if ambient plugin is loaded
-  const ambientPlugin = framework.pluginManager.get('ambient')
+  const ambientPlugin = framework.pluginManager.get('ambient');
   if (!ambientPlugin) {
-    console.error('Ambient plugin not loaded!')
-    return
+    console.error('Ambient plugin not loaded!');
+    return;
   }
 
-  console.log('=== Ambient Plugin Tools Available ===')
-  const tools = framework.getTools()
-  const ambientTools = tools.filter(t => t.name.startsWith('ambient_'))
-  console.log('Ambient tools:', ambientTools.map(t => t.name).join(', '))
+  console.log('=== Ambient Plugin Tools Available ===');
+  const tools = framework.getTools();
+  const ambientTools = tools.filter((t) => t.name.startsWith('ambient_'));
+  console.log('Ambient tools:', ambientTools.map((t) => t.name).join(', '));
 
-  console.log('\n=== Example 1: Create a Goal ===')
+  console.log('\n=== Example 1: Create a Goal ===');
   // Use ambient_goals to create a simple goal
   const createResult = await framework.executeTool('ambient_goals', {
     action: 'create',
     title: 'Monitor System Health',
     description: 'Periodically check system information and alert on issues',
     priority: 8,
-    actions: [
-      { id: 'check_1', type: 'tool', name: 'system_info', args: {} }
-    ]
-  })
-  console.log('Create goal result:', JSON.stringify(createResult, null, 2))
+    actions: [{ id: 'check_1', type: 'tool', name: 'system_info', args: {} }],
+  });
+  console.log('Create goal result:', JSON.stringify(createResult, null, 2));
 
-  console.log('\n=== Example 2: Create a Thinking Goal ===')
+  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',
@@ -61,136 +59,136 @@ async function main() {
     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))
+      { 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 ===')
+  console.log('\n=== Example 3: List All Goals ===');
   const listResult = await framework.executeTool('ambient_goals', {
-    action: 'list'
-  })
-  console.log('Goals list:', JSON.stringify(listResult, null, 2))
+    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 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 ===')
+  console.log('\n=== Example 5: Store a Memory ===');
   const storeResult = 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))
+    key: 'cpu_alert_1',
+  });
+  console.log('Store memory result:', JSON.stringify(storeResult, null, 2));
 
-  console.log('\n=== Example 6: Retrieve Memories ===')
+  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))
+    limit: 5,
+  });
+  console.log('Retrieve memories result:', JSON.stringify(retrieveResult, null, 2));
 
-  console.log('\n=== Example 7: Search Memories ===')
+  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))
+    query: 'CPU',
+  });
+  console.log('Search memories result:', JSON.stringify(searchResult, null, 2));
 
-  console.log('\n=== Example 8: Trigger Thinking ===')
+  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))
+    depth: 3,
+  });
+  console.log('Think result:', JSON.stringify(thinkResult, null, 2));
 
-  console.log('\n=== Example 9: Control Loop ===')
-  console.log('Pausing loop...')
+  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))
+    action: 'pause',
+  });
+  console.log('Pause result:', JSON.stringify(pauseResult, null, 2));
 
-  await new Promise(resolve => setTimeout(resolve, 1000))
+  await new Promise((resolve) => setTimeout(resolve, 1000));
 
-  console.log('Resuming loop...')
+  console.log('Resuming loop...');
   const resumeResult = await framework.executeTool('ambient_control', {
-    action: 'resume'
-  })
-  console.log('Resume result:', JSON.stringify(resumeResult, null, 2))
+    action: 'resume',
+  });
+  console.log('Resume result:', JSON.stringify(resumeResult, null, 2));
 
-  console.log('\n=== Example 10: Adjust Loop Settings ===')
+  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))
+    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 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 ===')
+  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')
+    actions: [],
+  });
+  console.log('Created inactive goal:', newGoal.goal ? newGoal.goal.id : 'N/A');
 
   if (newGoal.goal) {
-    console.log('Activating 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))
+      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' })
+  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 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))
+      priority: 10,
+    });
+    console.log('Update result:', JSON.stringify(updateResult, null, 2));
   }
 
-  console.log('\n=== Example 14: Delete a Goal ===')
+  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
-  })
+    priority: 1,
+  });
   if (deleteGoal.goal) {
-    console.log(`Created goal to delete: ${deleteGoal.goal.id}`)
+    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))
+      goalId: deleteGoal.goal.id,
+    });
+    console.log('Delete result:', JSON.stringify(deleteResult, null, 2));
   }
 
-  console.log('\n=== All Examples Completed ===')
-  console.log('Check .agent/data/ambient/ for persisted data')
+  console.log('\n=== All Examples Completed ===');
+  console.log('Check .agent/data/ambient/ for persisted data');
 
   // Cleanup
-  console.log('\nShutting down...')
-  await framework.destroy()
+  console.log('\nShutting down...');
+  await framework.destroy();
 }
 
-main().catch(err => {
-  console.error('Example error:', err)
-  process.exit(1)
-})
+main().catch((err) => {
+  console.error('Example error:', err);
+  process.exit(1);
+});

package/examples/basic.js

@@ -1,110 +1,115 @@
-/**
- * 基础示例
- * 展示如何使用 Framework 和 Agent
- */
-
-const { Framework } = require('../src')
-const { AIPlugin } = require('../plugins/ai-plugin')
-const { z } = require('zod')
-
-async function main() {
-  // 创建框架实例
-  const framework = new Framework({ debug: true })
-
-  // 加载 AI 插件
-  await framework.loadPlugin(new AIPlugin({
-    provider: 'deepseek',
-    model: 'deepseek-chat',
-    apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key'
-  }))
-
-  // 注册自定义工具（使用 inputSchema 格式）
-  framework.registerTool({
-    name: 'hello',
-    description: '打招呼工具',
-    inputSchema: z.object({
-      name: z.string().optional().describe('姓名')
-    }),
-    execute: async (args) => {
-      return `Hello, ${args.name || 'World'}!`
-    }
-  })
-
-  // 注册计算器工具
-  framework.registerTool({
-    name: 'calculate',
-    description: '简单的计算器',
-    inputSchema: z.object({
-      expression: z.string().describe('数学表达式，如 2+3*4')
-    }),
-    execute: async (args) => {
-      try {
-        // 安全计算（仅支持基本运算）
-        const result = Function(`"use strict"; return (${args.expression})`)()
-        return { result }
-      } catch (e) {
-        return { error: e.message }
-      }
-    }
-  })
-
-  console.log('[Framework] Ready!')
-  console.log('[Tools]', framework.getTools().map(t => t.name))
-
-  // 创建 Agent
-  const agent = framework.createAgent({
-    name: 'MyAgent',
-    systemPrompt: '你是一个有帮助的助手。当需要计算时，使用 calculate 工具。'
-  })
-
-  // 监听事件
-  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 对话示例
-  console.log('\n=== AI Chat Example ===')
-  try {
-    const response = await agent.chat('你好！')
-    console.log('[Agent] Response:', response.message)
-  } catch (err) {
-    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)
-      }
-    }
-    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()
-  console.log('\n[Done]')
-}
-
-main().catch(console.error)
+/**
+ * 基础示例
+ * 展示如何使用 Framework 和 Agent
+ */
+
+const { Framework } = require('../src');
+const { AIPlugin } = require('../plugins/ai-plugin');
+const { z } = require('zod');
+
+async function main() {
+  // 创建框架实例
+  const framework = new Framework({ debug: true });
+
+  // 加载 AI 插件
+  await framework.loadPlugin(
+    new AIPlugin({
+      provider: 'deepseek',
+      model: 'deepseek-chat',
+      apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key',
+    })
+  );
+
+  // 注册自定义工具（使用 inputSchema 格式）
+  framework.registerTool({
+    name: 'hello',
+    description: '打招呼工具',
+    inputSchema: z.object({
+      name: z.string().optional().describe('姓名'),
+    }),
+    execute: async (args) => {
+      return `Hello, ${args.name || 'World'}!`;
+    },
+  });
+
+  // 注册计算器工具
+  framework.registerTool({
+    name: 'calculate',
+    description: '简单的计算器',
+    inputSchema: z.object({
+      expression: z.string().describe('数学表达式，如 2+3*4'),
+    }),
+    execute: async (args) => {
+      try {
+        // 安全计算（仅支持基本运算）
+        const result = Function(`"use strict"; return (${args.expression})`)();
+        return { result };
+      } catch (e) {
+        return { error: e.message };
+      }
+    },
+  });
+
+  console.log('[Framework] Ready!');
+  console.log(
+    '[Tools]',
+    framework.getTools().map((t) => t.name)
+  );
+
+  // 创建 Agent
+  const agent = framework.createAgent({
+    name: 'MyAgent',
+    systemPrompt: '你是一个有帮助的助手。当需要计算时，使用 calculate 工具。',
+  });
+
+  // 监听事件
+  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 对话示例
+  console.log('\n=== AI Chat Example ===');
+  try {
+    const response = await agent.chat('你好！');
+    console.log('[Agent] Response:', response.message);
+  } catch (err) {
+    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);
+      }
+    }
+    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();
+  console.log('\n[Done]');
+}
+
+main().catch(console.error);