foliko 1.0.0

package/examples/basic.js

@@ -0,0 +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)

package/examples/bootstrap.js

@@ -0,0 +1,93 @@
+/**
+ * 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: 'VB-Agent',
+      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)
+
+  // 清理
+  await framework.destroy()
+  console.log('\n[Done]')
+}
+
+main().catch(console.error)

package/examples/mcp-example.js

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

@@ -0,0 +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)

package/examples/workflow.js

@@ -0,0 +1,158 @@
+/**
+ * 工作流示例
+ * 展示如何使用工作流引擎
+ */
+
+const { Framework } = require('../src')
+const { WorkflowPlugin } = require('../src/capabilities/workflow-engine')
+
+async function main() {
+  console.log('=== Workflow Example ===\n')
+
+  // 创建框架
+  const framework = new Framework({ debug: true })
+
+  // 加载工作流插件
+  await framework.loadPlugin(new WorkflowPlugin())
+
+  console.log('\n--- Testing Script Step ---')
+
+  // 直接执行工作流
+  const result1 = await framework.executeTool('execute_workflow', {
+    workflow: JSON.stringify({
+      steps: [
+        {
+          type: 'script',
+          name: 'Calculate',
+          script: `
+            const a = 10;
+            const b = 20;
+            context.variables.sum = a + b;
+            return a + b;
+          `
+        },
+        {
+          type: 'script',
+          name: 'Multiply',
+          script: `
+            const sum = context.variables.sum;
+            context.variables.product = sum * 2;
+            return sum * 2;
+          `
+        }
+      ]
+    }),
+    input: {}
+  })
+
+  console.log('Result:', result1)
+
+  console.log('\n--- Testing Loop Step ---')
+
+  const result2 = await framework.executeTool('execute_workflow', {
+    workflow: JSON.stringify({
+      steps: [
+        {
+          type: 'loop',
+          name: 'Loop 3 times',
+          maxIterations: 3,
+          loopVariable: 'i',
+          steps: [
+            {
+              type: 'script',
+              name: 'Log iteration',
+              script: `
+                console.log('Iteration ' + context.variables.i);
+                return context.variables.i;
+              `
+            }
+          ]
+        }
+      ]
+    }),
+    input: {}
+  })
+
+  console.log('Result:', result2)
+
+  console.log('\n--- Testing Condition Step ---')
+
+  const result3 = await framework.executeTool('execute_workflow', {
+    workflow: JSON.stringify({
+      steps: [
+        {
+          type: 'script',
+          name: 'Set value',
+          outputVariable: 'value',
+          script: `
+            context.variables.value = 15;
+            return 15;
+          `
+        },
+        {
+          type: 'condition',
+          name: 'Check value',
+          branches: [
+            {
+              name: 'Greater than 10',
+              condition: 'context.variables.value > 10',
+              steps: [
+                {
+                  type: 'script',
+                  name: 'Log greater',
+                  script: `console.log('Value is greater than 10'); return 'greater';`
+                }
+              ]
+            },
+            {
+              name: 'Less than or equal 10',
+              condition: 'context.variables.value <= 10',
+              steps: [
+                {
+                  type: 'script',
+                  name: 'Log less',
+                  script: `console.log('Value is less than or equal 10'); return 'less-or-equal';`
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    }),
+    input: {}
+  })
+
+  console.log('Result:', result3)
+
+  console.log('\n--- Testing Delay ---')
+
+  const startTime = Date.now()
+  const result4 = await framework.executeTool('execute_workflow', {
+    workflow: JSON.stringify({
+      steps: [
+        {
+          type: 'delay',
+          name: 'Wait 500ms',
+          delayMs: 500
+        },
+        {
+          type: 'script',
+          name: 'Check elapsed',
+          script: `
+            const elapsed = Date.now() - context.variables.startTime;
+            return { elapsed: elapsed, expected: 500 };
+          `
+        }
+      ]
+    }),
+    input: {}
+  })
+
+  console.log('Result:', result4)
+
+  // 清理
+  await framework.destroy()
+  console.log('\n[Done]')
+}
+
+main().catch(console.error)

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "foliko",
+  "version": "1.0.0",
+  "description": "简约的插件化 Agent 框架",
+  "main": "src/index.js",
+  "bin": {
+    "foliko": "./cli/bin/foliko.js"
+  },
+  "scripts": {
+    "start": "node examples/basic.js",
+    "chat": "node cli/bin/foliko.js chat",
+    "test": "echo \"No tests yet\""
+  },
+  "keywords": [
+    "agent",
+    "ai",
+    "framework",
+    "plugin"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@ai-sdk/anthropic": "^3.0.58",
+    "@ai-sdk/mcp": "^1.0.25",
+    "@ai-sdk/openai": "^3.0.41",
+    "@ai-sdk/openai-compatible": "^2.0.35",
+    "@anthropic-ai/sdk": "^0.39.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "ai": "^6.0.116",
+    "dotenv": "^17.3.1",
+    "marked": "^11.2.0",
+    "marked-terminal": "6",
+    "node-cron": "^4.2.1",
+    "zod": "^4.3.6"
+  }
+}

package/plugins/ai-plugin.js

@@ -0,0 +1,89 @@
+/**
+ * AI 插件
+ * 提供 AI 对话能力
+ */
+
+const { Plugin } = require('../src/core/plugin-base')
+const { createAI } = require('../src/core/provider')
+
+class AIPlugin extends Plugin {
+  constructor(config = {}) {
+    super()
+    this.name = 'ai'
+    this.version = '1.0.0'
+    this.description = 'AI 对话能力插件'
+    this.priority = 1  // 最先加载
+
+    this.config = {
+      provider: config.provider || 'deepseek',
+      model: config.model || 'deepseek-chat',
+      apiKey: config.apiKey,
+      baseURL: config.baseURL,
+      maxSteps: config.maxSteps || 20
+    }
+
+    this._aiClient = null
+    this._framework = null
+  }
+
+  install(framework) {
+    this._framework = framework
+    return this
+  }
+
+  start(framework) {
+    this._initAIClient()
+    return this
+  }
+
+  _initAIClient() {
+    if (!this.config.apiKey) {
+      console.warn('[AIPlugin] No API key provided, AI features disabled')
+      return
+    }
+
+    try {
+      const provider = createAI({
+        provider: this.config.provider,
+        model: this.config.model,
+        apiKey: this.config.apiKey,
+        baseURL: this.config.baseURL
+      })
+
+      // 创建模型实例
+      this._aiClient = provider(this.config.model)
+      console.log(`[AIPlugin] Initialized ${this.config.provider}/${this.config.model}`)
+    } catch (err) {
+      console.error('[AIPlugin] Failed to initialize AI client:', err.message)
+    }
+  }
+
+  /**
+   * 获取 AI 客户端
+   * @returns {Object} AI 模型客户端
+   */
+  getAIClient() {
+    return this._aiClient
+  }
+
+  /**
+   * 获取配置
+   * @returns {Object}
+   */
+  getConfig() {
+    return { ...this.config }
+  }
+
+  reload(framework) {
+    console.log('[AIPlugin] Reloading...')
+    this._framework = framework
+    this._initAIClient()
+  }
+
+  uninstall(framework) {
+    this._aiClient = null
+    this._framework = null
+  }
+}
+
+module.exports = { AIPlugin }