foliko 1.0.0

package/src/core/framework.js

@@ -0,0 +1,255 @@
+/**
+ * Framework 核心容器
+ * 管理所有子系统，提供统一入口
+ */
+
+const path = require('path')
+const { EventEmitter } = require('../utils/event-emitter')
+const { PluginManager } = require('./plugin-manager')
+const { ToolRegistry } = require('./tool-registry')
+const { Agent } = require('./agent')
+
+// 添加框架目录的 node_modules 到全局搜索路径
+// 让项目插件能 require 框架内置的包（如 zod）
+const frameworkNodeModules = path.join(__dirname, '..', '..', 'node_modules')
+if (!module.paths.includes(frameworkNodeModules)) {
+  module.paths.unshift(frameworkNodeModules)
+}
+
+class Framework extends EventEmitter {
+  /**
+   * @param {Object} config - 配置
+   * @param {boolean} [config.debug=false] - 调试模式
+   */
+  constructor(config = {}) {
+    super()
+
+    this._debug = config.debug || false
+    this._ready = false
+    this._readyPromise = null
+    this._resolveReady = null
+
+    // 初始化子系统
+    this.toolRegistry = new ToolRegistry()
+    this.pluginManager = new PluginManager(this)
+
+    // Agent 管理
+    this._agents = []           // 所有创建的 agent
+    this._mainAgent = null      // 主 agent
+
+    // 事件转发
+    this.toolRegistry.on('tool:registered', (tool) => {
+      this.emit('tool:registered', tool)
+    })
+
+    this._registerBuiltinTools()
+  }
+
+  /**
+   * 注册插件（不加载）
+   * @param {Plugin|Object} plugin - 插件
+   */
+  registerPlugin(plugin) {
+    this.pluginManager.register(plugin)
+    return this
+  }
+
+  /**
+   * 加载并启动插件
+   * @param {Plugin|Object} plugin - 插件
+   */
+  async loadPlugin(plugin) {
+    await this.pluginManager.load(plugin)
+    return this
+  }
+
+  /**
+   * 卸载插件
+   * @param {string} name - 插件名称
+   */
+  async unloadPlugin(name) {
+    await this.pluginManager.unload(name)
+    return this
+  }
+
+  /**
+   * 重载单个插件
+   * @param {string} name - 插件名称
+   */
+  async reloadPlugin(name) {
+    await this.pluginManager.reload(name)
+    return this
+  }
+
+  /**
+   * 重载所有插件
+   */
+  async reloadAllPlugins() {
+    await this.pluginManager.reloadAll()
+    return this
+  }
+
+  /**
+   * 注册工具
+   * @param {Object} tool - 工具定义
+   */
+  registerTool(tool) {
+    this.toolRegistry.register(tool)
+    return this
+  }
+
+  /**
+   * 获取所有工具
+   * @returns {Array<Object>}
+   */
+  getTools() {
+    return this.toolRegistry.getAll()
+  }
+
+  /**
+   * 执行工具
+   * @param {string} name - 工具名称
+   * @param {Object} args - 参数
+   */
+  async executeTool(name, args) {
+    return this.toolRegistry.execute(name, args, this)
+  }
+
+  /**
+   * 创建 Agent
+   * @param {Object} config - Agent 配置
+   */
+  createAgent(config) {
+    // 如果配置了 AI 相关参数但没有 apiKey，尝试从 AI 插件获取
+    if (!config.apiKey) {
+      const aiPlugin = this.pluginManager.get('ai')
+      if (aiPlugin) {
+        config.apiKey = aiPlugin.config.apiKey
+        config.provider = config.provider || aiPlugin.config.provider
+        config.model = config.model || aiPlugin.config.model
+        config.baseURL = config.baseURL || aiPlugin.config.baseURL
+      }
+    }
+
+    const agent = new Agent(this, config)
+
+    // 跟踪 agent
+    this._agents.push(agent)
+    if (!this._mainAgent) {
+      this._mainAgent = agent
+    }
+
+    this.emit('agent:created', agent)
+    return agent
+  }
+
+  /**
+   * 获取 AI 插件
+   * @returns {Object|undefined}
+   */
+  getAIPlugin() {
+    return this.pluginManager.get('ai')
+  }
+
+  /**
+   * Bootstrap - 使用默认配置启动框架
+   * 自动加载 .agent/ 目录下的配置和所有默认插件
+   * @param {Object} config - 配置
+   * @param {string} [config.agentDir='.agent'] - Agent 配置目录
+   * @param {Object} [config.aiConfig] - AI 配置（可选，覆盖文件配置）
+   * @returns {Promise<Framework>}
+   */
+  async bootstrap(config = {}) {
+    const { bootstrapDefaults, DefaultPlugins, loadAgentConfig } = require('../../plugins/default-plugins')
+
+    // 先加载默认插件配置
+    const defaultsPlugin = new DefaultPlugins({
+      agentDir: config.agentDir || '.agent'
+    })
+
+    await this.loadPlugin(defaultsPlugin)
+
+    // 获取配置
+    const agentConfig = defaultsPlugin.getConfig()
+
+    // 如果提供了 AI 配置，覆盖文件配置
+    if (config.aiConfig) {
+      agentConfig.ai = { ...agentConfig.ai, ...config.aiConfig }
+    }
+
+    // 加载所有默认插件（传入已加载的配置避免重复加载）
+    await bootstrapDefaults(this, { _config: agentConfig, _skipConfigLoad: true })
+
+    this._setReady()
+    return this
+  }
+
+  /**
+   * 等待框架就绪
+   */
+  async ready() {
+    if (this._ready) {
+      return this
+    }
+
+    if (!this._readyPromise) {
+      this._readyPromise = new Promise((resolve) => {
+        this._resolveReady = resolve
+      })
+    }
+
+    await this._readyPromise
+    return this
+  }
+
+  /**
+   * 标记框架就绪
+   * @private
+   */
+  _setReady() {
+    this._ready = true
+    if (this._resolveReady) {
+      this._resolveReady(this)
+    }
+    this.emit('framework:ready', this)
+  }
+
+  /**
+   * 调试日志
+   * @private
+   */
+  _log(...args) {
+    if (this._debug) {
+      console.log('[Framework]', ...args)
+    }
+  }
+
+  /**
+   * 注册内置工具
+   * @private
+   */
+  _registerBuiltinTools() {
+    // 内置工具会在 Agent 创建时添加
+  }
+
+  /**
+   * 销毁框架
+   */
+  async destroy() {
+    // 卸载所有插件
+    const plugins = this.pluginManager.getAll()
+    for (const { name } of plugins) {
+      await this.pluginManager.unload(name)
+    }
+
+    // 清空工具
+    this.toolRegistry.clear()
+
+    // 清空事件
+    this.removeAllListeners()
+
+    this.emit('framework:destroyed')
+  }
+}
+
+module.exports = { Framework }

package/src/core/index.js

@@ -0,0 +1,19 @@
+/**
+ * 核心模块统一导出
+ */
+
+const { Framework } = require('./framework')
+const { Agent } = require('./agent')
+const { Plugin } = require('./plugin-base')
+const { PluginManager } = require('./plugin-manager')
+const { ToolRegistry } = require('./tool-registry')
+const { EventEmitter } = require('../utils/event-emitter')
+
+module.exports = {
+  Framework,
+  Agent,
+  Plugin,
+  PluginManager,
+  ToolRegistry,
+  EventEmitter
+}

package/src/core/plugin-base.js

@@ -0,0 +1,205 @@
+/**
+ * Plugin 基类
+ * 所有插件的基类
+ */
+
+class Plugin {
+  /**
+   * 插件名称
+   * @type {string}
+   */
+  name = 'unnamed-plugin'
+
+  /**
+   * 插件版本
+   * @type {string}
+   */
+  version = '1.0.0'
+
+  /**
+   * 插件描述
+   * @type {string}
+   */
+  description = ''
+
+  /**
+   * 插件优先级，数值越小越先加载
+   * @type {number}
+   */
+  priority = 100
+
+  /**
+   * 子Agent配置数组 - 配置后自动注册子Agent
+   * 格式: [{ name: 'xxx', role: '角色', tools: {...}, parentTools: [...] }]
+   * @type {Array}
+   */
+  agents = []
+
+  _framework = null
+  _subAgents = []
+
+  /**
+   * 安装插件 - 注册工具/事件等
+   * @param {Framework} framework - 框架实例
+   */
+  install(framework) {
+    this._framework = framework
+    return this
+  }
+
+  /**
+   * 启动插件 - 初始化完成后的启动
+   * @param {Framework} framework - 框架实例
+   */
+  start(framework) {
+    // 自动注册配置的子Agent
+    this._autoRegisterSubAgents()
+    return this
+  }
+
+  /**
+   * 自动注册子Agent（根据 this.agents 配置）
+   * @private
+   */
+  _autoRegisterSubAgents() {
+    // 确定要注册的agent配置
+    const agentsToRegister = this._deferredSubAgents || this.agents
+    if (!agentsToRegister || !Array.isArray(agentsToRegister) || agentsToRegister.length === 0) {
+      return
+    }
+
+    // 获取父Agent
+    const parentAgent = this._getParentAgent()
+
+    if (!parentAgent) {
+      // 没有父Agent，推迟到框架准备好时再注册
+      if (!this._deferredSubAgents) {
+        console.log(`[Plugin:${this.name}] No parent agent found, deferring subagent registration`)
+        this._deferredSubAgents = agentsToRegister
+        // 监听框架准备好事件
+        if (this._framework) {
+          this._framework.once('framework:ready', () => {
+            // 延迟注册，确保主Agent已创建
+            setTimeout(() => this._autoRegisterSubAgents(), 100)
+          })
+        }
+      }
+      return
+    }
+
+    // 有父Agent了，清除延迟标记
+    this._deferredSubAgents = null
+
+    for (const agentConfig of agentsToRegister) {
+      try {
+        const plugin = this.registerSubAgent(agentConfig)
+        this._subAgents.push(plugin)
+      } catch (err) {
+        console.error(`[Plugin:${this.name}] Failed to register subagent ${agentConfig.name}:`, err.message)
+      }
+    }
+  }
+
+  /**
+   * 获取父Agent
+   * @private
+   */
+  _getParentAgent() {
+    if (!this._framework) return null
+    if (this._framework._mainAgent) return this._framework._mainAgent
+    const agents = this._framework._agents || []
+    return agents.length > 0 ? agents[agents.length - 1] : null
+  }
+
+  /**
+   * 注册子Agent
+   * @param {Object} config - 子Agent配置
+   * @param {string} config.name - 子Agent名称
+   * @param {string} config.role - 子Agent角色
+   * @param {string} [config.description] - 子Agent描述
+   * @param {Object} [config.tools] - 自定义工具 { name: toolDef }
+   * @param {string[]} [config.parentTools] - 从父Agent继承的工具名称
+   * @returns {SubAgentPlugin} 注册的子Agent插件实例
+   */
+  registerSubAgent(config) {
+    if (!this._framework) {
+      throw new Error('Plugin not installed, call install(framework) first')
+    }
+
+    // 动态导入避免循环依赖
+    const { SubAgentPlugin } = require('../../plugins/subagent-plugin')
+
+    const plugin = new SubAgentPlugin({
+      ...config,
+      // 确保子Agent能获取父Agent
+      _parentAgentGetter: () => {
+        // 尝试获取主Agent
+        if (this._framework._mainAgent) {
+          return this._framework._mainAgent
+        }
+        const agents = this._framework._agents || []
+        return agents.length > 0 ? agents[agents.length - 1] : null
+      }
+    })
+
+    plugin.install(this._framework)
+    plugin.start(this._framework)
+
+    console.log(`[Plugin:${this.name}] Registered subagent: ${config.name}`)
+    return plugin
+  }
+
+  /**
+   * 热重载插件 - 手动调用重载时执行
+   * @param {Framework} framework - 框架实例
+   */
+  reload(framework) {
+    this._framework = framework
+    // 清除之前的延迟注册
+    this._deferredSubAgents = null
+    // 重新注册子Agent
+    this._autoRegisterSubAgents()
+  }
+
+  /**
+   * 卸载插件 - 清理资源
+   * @param {Framework} framework - 框架实例
+   */
+  uninstall(framework) {
+    // 销毁所有子Agent
+    for (const plugin of this._subAgents) {
+      try {
+        plugin.uninstall(framework)
+      } catch (err) {
+        console.error(`[Plugin:${this.name}] Failed to uninstall subagent:`, err.message)
+      }
+    }
+    this._subAgents = []
+    this._framework = null
+  }
+
+  /**
+   * 获取插件信息
+   * @returns {Object}
+   */
+  getInfo() {
+    return {
+      name: this.name,
+      version: this.version,
+      description: this.description,
+      priority: this.priority
+    }
+  }
+}
+
+/**
+ * 内置插件类型常量
+ */
+const PluginType = {
+  AI: 'ai',
+  TOOLS: 'tools',
+  EXECUTOR: 'executor',
+  CAPABILITY: 'capability'
+}
+
+module.exports = { Plugin, PluginType }