foliko 1.0.52 → 1.0.54

package/.claude/settings.local.json

@@ -125,7 +125,17 @@
       "Bash(node -c src/core/plugin-manager.js && node -c plugins/tools-plugin.js 2>&1)",
       "Bash(node -c plugins/default-plugins.js && node -c cli/src/commands/chat.js 2>&1)",
       "Bash(node -c plugins/telegram-plugin.js && node -c plugins/feishu-plugin.js && node -c plugins/weixin-plugin.js 2>&1)",
-      "Bash(node -c src/core/agent.js 2>&1)"
+      "Bash(node -c src/core/agent.js 2>&1)",
+      "Bash(cd D:/code/vb-agent && node examples/bootstrap.js 2>&1 | head -50)",
+      "Bash(node -c plugins/proactive-agent-plugin.js 2>&1)",
+      "Bash(node -c src/index.js && node -c examples/proactive-example.js && node -c examples/proactive-advanced.js && echo \"All syntax OK\")",
+      "Bash(node -c plugins/proactive-agent-plugin.js && node -c plugins/default-plugins.js && echo \"All OK\")",
+      "Bash(node examples/basic.js 2>&1 | head -50)",
+      "Bash(node examples/ambient-example.js 2>&1 | head -80)",
+      "Bash(ls -la .agent/data/ambient/ 2>/dev/null && cat .agent/data/ambient/*.json 2>/dev/null | head -50)",
+      "Bash(node examples/basic.js 2>&1 | head -30)",
+      "Bash(node examples/bootstrap.js 2>&1 | head -40)",
+      "Bash(node test-debug.js 2>&1)"
     ]
   }
 }

package/CLAUDE.md

@@ -0,0 +1,106 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+**Foliko** is a minimalist plugin-based Agent framework in pure JavaScript (no TypeScript). It provides a lightweight core with extensible plugins for AI conversation, tool execution, workflow automation, and more.
+
+## Commands
+
+```bash
+# Run basic example
+npm start
+
+# CLI chat mode
+npm run chat
+
+# Proactive agent examples
+npm run proactive
+npm run proactive:advanced
+
+# No test suite yet
+npm test
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────┐
+│                  Foliko Framework               │
+├─────────────────────────────────────────────────┤
+│  Framework (Container Layer)                    │
+│  ├── pluginManager    - Plugin lifecycle       │
+│  ├── toolRegistry    - Tool registration       │
+│  ├── skillManager    - Skill management        │
+│  └── eventEmitter    - Event bus               │
+├─────────────────────────────────────────────────┤
+│  Agent (Dialogue Layer)                         │
+│  ├── chat()           - Send messages          │
+│  ├── chatStream()     - Streaming responses    │
+│  ├── tools           - From Framework         │
+│  └── events          - Message/tool events    │
+└─────────────────────────────────────────────────┘
+```
+
+### Core Classes
+
+- **Framework** (`src/core/framework.js`) - Container managing plugins, tools, events, and agent creation
+- **Agent** (`src/core/agent.js`) - Handles conversation, tool calls, subAgent delegation, and message queuing
+- **Plugin** (`src/core/plugin-base.js`) - Base class with `install()`, `start()`, `reload()`, `uninstall()` lifecycle
+- **PluginManager** (`src/core/plugin-manager.js`) - Manages plugin loading, priority ordering, and hot reload
+- **ToolRegistry** (`src/core/tool-registry.js`) - Registers and executes tools with Zod schemas
+- **AgentChatHandler** (`src/core/agent-chat.js`) - Handles AI provider communication and tool call loops
+
+### Directory Structure
+
+```
+src/
+├── core/           # Framework, Agent, PluginManager, ToolRegistry
+├── capabilities/   # SkillManager, WorkflowEngine
+├── executors/      # MCPExecutor for MCP server integration
+└── utils/          # EventEmitter
+
+plugins/            # Built-in plugins (ai-plugin, tools-plugin, shell/python executors, session, scheduler, etc.)
+cli/bin/           # CLI entry point
+.agent/            # User configuration (plugins, skills, agents, mcp_config.json)
+examples/          # Usage examples
+```
+
+### Plugin System
+
+Plugins are registered via `framework.registerPlugin()` and loaded with `framework.loadPlugin()`. Each plugin:
+- Has a `name`, `version`, `description`, and `priority`
+- Implements `install(framework)` to register tools/events
+- Implements `start(framework)` after initialization
+- Can implement `reload(framework)` for hot reload
+- Can implement `uninstall(framework)` for cleanup
+
+### AI Integration
+
+Uses Vercel AI SDK (`ai` package) with support for multiple providers:
+- Anthropic, DeepSeek, MiniMax, OpenAI, OpenAI-Compatible
+
+Provider selection via `config.provider` and AI settings in `.agent/ai.json`.
+
+### Key Patterns
+
+1. **Context Isolation**: `framework.runWithContext(context, fn)` uses AsyncLocalStorage for true context isolation
+2. **Tool Execution**: Tools receive `(args, framework)` and return results; errors should be caught and returned as `{error: message}`
+3. **Event System**: Framework emits events like `framework:ready`, `plugin:loaded`, `agent:message`, `tool-call`
+4. **Hot Reload**: Manual only via `framework.reloadPlugin(name)` or `framework.reloadAllPlugins()` - no file watching
+
+### Built-in Plugins
+
+- **ai-plugin** - AI conversation via Vercel AI SDK
+- **tools-plugin** - Plugin management tools (list, reload, enable/disable)
+- **shell-executor-plugin** - Shell command execution
+- **python-executor-plugin** - Python code/script execution
+- **session-plugin** - Multi-session management
+- **scheduler-plugin** - Cron-based task scheduling
+- **subagent-plugin** - Child agent isolation
+- **email.js** - SMTP/IMAP email
+- **telegram-plugin.js** - Telegram bot integration
+- **audit-plugin.js** - Operation logging
+- **rules-plugin.js** - Permission/content rules
+- **storage-plugin.js** - Key-value persistence

package/Dockerfile

@@ -49,7 +49,7 @@ ENV PATH="/root/.local/bin:$PATH"
 WORKDIR /app
 
 # 全局安装 foliko CLI
-RUN npm install -g foliko
+# RUN npm install -g foliko
 
 # 暴露端口
 # 3000: Web 服务端口
@@ -60,4 +60,4 @@ ENV NODE_ENV=production
 
 
 # 默认命令：运行聊天界面
-CMD ["foliko", "chat"]
+# CMD ["foliko", "chat"]

package/cli/src/index.js

@@ -4,14 +4,16 @@
 
 const { chatCommand } = require('./commands/chat')
 const { listCommand } = require('./commands/list')
-
+const fs = require('fs');
+const path = require('path');
 /**
  * CLI 主入口
  */
 async function cli() {
   const args = process.argv.slice(2)
   const command = args[0] || 'chat'
-
+  const packageJsonPath = path.join(__dirname, '../../package.json');
+  
   switch (command) {
     case 'chat':
       await chatCommand(args.slice(1))
@@ -31,7 +33,8 @@ async function cli() {
     case 'version':
     case '--version':
     case '-v':
-      console.log('foliko v1.0.0')
+      const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+      console.log(`${packageJson.name} v${packageJson.version}`)
       break
 
     default:

package/cli/src/ui/chat-ui.js

@@ -147,7 +147,7 @@ class ChatUI {
       const renderState = { inThink: false, inCodeBlock: false }
 
       console.log(colored('● ', GREEN))
-      console.log()
+      // console.log()
 
       const runWithContext = this.agent.framework?.runWithContext.bind(this.agent.framework)
       const { sessionId } = this

package/examples/ambient-example.js

@@ -0,0 +1,196 @@
+/**
+ * Ambient Agent Example
+ * Demonstrates how to use the Ambient Agent plugin for autonomous monitoring and actions
+ */
+
+const { Framework } = require('../src/core/framework')
+
+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: './.agent',
+    aiConfig: {
+      provider: 'deepseek',
+      model: 'deepseek-chat',
+      apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key'
+    }
+  })
+
+  console.log('\n=== Framework Ready ===\n')
+
+  // Wait for plugins to start
+  await new Promise(resolve => setTimeout(resolve, 1000))
+
+  // Check if ambient plugin is loaded
+  const ambientPlugin = framework.pluginManager.get('ambient')
+  if (!ambientPlugin) {
+    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('\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))
+
+  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('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', {
+    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('\n=== All Examples Completed ===')
+  console.log('Check .agent/data/ambient/ for persisted data')
+
+  // Cleanup
+  console.log('\nShutting down...')
+  await framework.destroy()
+}
+
+main().catch(err => {
+  console.error('Example error:', err)
+  process.exit(1)
+})

package/examples/basic.js

@@ -1,110 +1,110 @@
-/**
- * 基础示例
- * 展示如何使用 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)