foliko 1.1.93 → 2.0.1

package/src/core/framework.js

@@ -1,1422 +0,0 @@
-/**
- * Framework 核心容器
- * 管理所有子系统，提供统一入口
- */
-
-const path = require('path');
-const os = require('os');
-const { AsyncLocalStorage } = require('async_hooks');
-const { EventEmitter } = require('../utils/event-emitter');
-const { PluginManager } = require('./plugin-manager');
-const { ToolRegistry } = require('./tool-registry');
-const { Agent } = require('./agent');
-const { Subagent } = require('./subagent');
-const { SubAgentConfigManager } = require('./sub-agent-config');
-const { ContextManager } = require('./context-manager');
-const { SessionManager } = require('./session-manager');
-const { CoordinatorManager } = require('./coordinator-manager');
-const { Logger, LOG_LEVELS } = require('../utils/logger');
-const { AGENT_DIR, HOME_AGENT_DIR_NAME, SYSTEM_PLUGINS } = require('./constants');
-// 创建一个连接到 Framework 的 logger
-function createFrameworkLogger(framework) {
-  const logger = new Logger({ namespace: 'foliko' });
-  const state = { silent: false };
-
-  // 获取当前有效的级别（优先用全局级别）
-  const getLevel = () => Logger.globalLevel ?? logger._level ?? LOG_LEVELS.INFO;
-
-  // 日志级别配置表，消除 4×2 重复代码
-  const LEVEL_CONFIG = [
-    ['info', LOG_LEVELS.INFO, 'INFO'],
-    ['warn', LOG_LEVELS.WARN, 'WARN'],
-    ['error', LOG_LEVELS.ERROR, 'ERROR'],
-    ['debug', LOG_LEVELS.DEBUG, 'DEBUG'],
-  ];
-
-  // 通用日志拦截包装器
-  function wrapLogMethod(targetLogger, originalMethod, levelThreshold, levelName) {
-    return (...args) => {
-      const lvl = getLevel();
-      if (lvl <= levelThreshold) {
-        if (!state.silent) originalMethod(...args);
-        framework.emit('log', { level: levelName, message: args.join(' '), namespace: targetLogger.namespace });
-      }
-    };
-  }
-
-  // 包装所有级别
-  const originals = {};
-  for (const [name] of LEVEL_CONFIG) {
-    originals[name] = logger[name].bind(logger);
-  }
-  for (const [name, threshold, label] of LEVEL_CONFIG) {
-    logger[name] = wrapLogMethod(logger, originals[name], threshold, label);
-  }
-
-  // 拦截 child 方法
-  const originalChild = logger.child.bind(logger);
-  logger.child = (...args) => {
-    const childLogger = originalChild(...args);
-    const childOriginals = {};
-    for (const [name] of LEVEL_CONFIG) {
-      childOriginals[name] = childLogger[name].bind(childLogger);
-    }
-    for (const [name, threshold, label] of LEVEL_CONFIG) {
-      childLogger[name] = wrapLogMethod(childLogger, childOriginals[name], threshold, label);
-    }
-    return childLogger;
-  };
-
-  // 暴露 setGlobalLogLevel 方法
-  logger.setGlobalLogLevel = (level) => { Logger.globalLevel = level; };
-
-  // 暴露 setSilent 方法
-  logger.setSilent = (v) => { state.silent = v; };
-
-  return logger;
-}
-
-// 添加框架目录的 node_modules 到全局搜索路径
-// 让项目插件能 require 框架内置的包（如 zod）
-const frameworkNodeModules = path.join(__dirname, '..', '..', 'node_modules');
-if (!module.paths.includes(frameworkNodeModules)) {
-  module.paths.unshift(frameworkNodeModules);
-}
-
-// 现有的 AsyncLocalStorage（保持向后兼容）
-const asyncLocalStorage = new AsyncLocalStorage();
-
-// 新增：两层 AsyncLocalStorage
-const requestStorage = new AsyncLocalStorage(); // Request 级别
-const sessionStorage = new AsyncLocalStorage(); // Session 级别
-
-class Framework extends EventEmitter {
-  /**
-   * @param {Object} config - 配置
-   * @param {boolean} [config.debug=false] - 调试模式
-   * @param {boolean} [config.silent=false] - 是否静默（不输出日志）
-   * @param {string} [config.cwd] - 初始工作目录（默认 process.cwd()，可后续用 setCwd 切换）
-   * @param {string} [config.agentDir='.foliko'] - 项目级 Agent 目录名
-   * @param {string} [config.homeAgentDir] - 用户级 Agent 目录（默认 ~/.foliko，可被 FOLIKO_HOME 环境变量覆盖）
-   */
-  constructor(config = {}) {
-    super();
-    this._silent=config.silent||false;
-    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
-
-    // 保存 toolRegistry 监听器引用，用于清理
-    this._toolRegistryListeners = [];
-
-    // 子代理配置管理器
-    this._subAgentConfigManager = null;
-
-    // 执行上下文（工具调用时可用）
-    this._executionContext = null;
-
-    // ========== 分层上下文系统 ==========
-    // Context 管理器
-    this._contextManager = new ContextManager(this);
-
-    // SessionContext 缓存（轻量管理，不依赖 ContextManager）
-    this._sessionContexts = new Map(); // sessionId → SessionManager
-
-    // Session 存储配置（JSONL 格式）
-    this._sessionStorageConfig = {
-      baseDir: '.foliko/sessions',
-    };
-
-    // 工作目录与 Agent 目录
-    this._cwd = config.cwd || process.cwd();
-    this._agentDir = config.agentDir || AGENT_DIR;
-    this._homeAgentDir =
-      config.homeAgentDir ||
-      process.env.FOLIKO_HOME ||
-      path.join(os.homedir(), HOME_AGENT_DIR_NAME);
-    this._changingCwd = false;
-
-    // 注册 logger 到 framework
-    this.logger = createFrameworkLogger(this);
-
-    // Coordinator管理器（用于Coordinator模式）
-    this._coordinatorManager = null;
-
-    // 事件转发 - ToolRegistry 事件
-    const toolRegisteredHandler = (tool) => {
-      this.emit('tool:registered', tool);
-    };
-    const toolCallHandler = (data) => {
-      this.emit('tool:call', data);
-      // 兼容连字符格式
-      this.emit('tool-call', data);
-    };
-    const toolResultHandler = (data) => {
-      this.emit('tool:result', data);
-    };
-    const toolErrorHandler = (data) => {
-      this.emit('tool:error', data);
-    };
-    this.toolRegistry.on('tool:registered', toolRegisteredHandler);
-    this.toolRegistry.on('tool:call', toolCallHandler);
-    this.toolRegistry.on('tool:result', toolResultHandler);
-    this.toolRegistry.on('tool:error', toolErrorHandler);
-    this._toolRegistryListeners = [
-      { event: 'tool:registered', handler: toolRegisteredHandler },
-      { event: 'tool:call', handler: toolCallHandler },
-      { event: 'tool:result', handler: toolResultHandler },
-      { event: 'tool:error', handler: toolErrorHandler },
-    ];
-
-    // 事件转发 - Agent 事件
-    this._setupAgentEventForwarding();
-
-    this._registerBuiltinTools();
-  }
-
-  /**
-   * 设置 Agent 事件转发
-   * @private
-   */
-  _setupAgentEventForwarding() {
-    // 保存 agent 创建时的转发监听器引用，用于清理
-    this._agentForwardingListeners = new Map();
-    // 监听 agent:created 事件，为新创建的 Agent 设置事件转发
-    this.on('agent:created', (agent) => {
-      // 转发 Agent 的 tool-call/result/error 事件
-      const toolCallHandler = (data) => {
-        this.emit('tool:call', data);
-      };
-      const toolResultHandler = (data) => {
-        this.emit('tool:result', data);
-      };
-      const toolErrorHandler = (data) => {
-        this.emit('tool:error', data);
-      };
-      const messageHandler = (msg) => {
-        this.emit('agent:message', msg);
-      };
-      agent.on('tool-call', toolCallHandler);
-      agent.on('tool-result', toolResultHandler);
-      agent.on('tool-error', toolErrorHandler);
-      agent.on('message', messageHandler);
-      // 保存引用用于后续清理
-      this._agentForwardingListeners.set(agent, {
-        toolCallHandler,
-        toolResultHandler,
-        toolErrorHandler,
-        messageHandler,
-      });
-    });
-  }
-
-  /**
-   * 从 AI 插件合并配置到目标配置对象
-   * @param {Object} target - 目标配置对象
-   * @private
-   */
-  _mergeAIConfig(target) {
-    if (target.apiKey) return target; // 已有 apiKey 不需要合并
-
-    const aiPlugin = this.pluginManager.get('ai');
-    if (!aiPlugin) return target;
-
-    const defaults = {
-      apiKey: aiPlugin.config.apiKey,
-      provider: aiPlugin.config.provider,
-      model: aiPlugin.config.model,
-      baseURL: aiPlugin.config.baseURL,
-      providerOptions: aiPlugin.config.providerOptions || {},
-    };
-
-    return {
-      ...target,
-      apiKey: target.apiKey || defaults.apiKey,
-      provider: target.provider || defaults.provider,
-      model: target.model || defaults.model,
-      baseURL: target.baseURL || defaults.baseURL,
-      providerOptions: target.providerOptions || defaults.providerOptions,
-    };
-  }
-
-  /**
-   * 注册插件（不加载）
-   * @param {Plugin|Object} plugin - 插件
-   */
-  registerPlugin(plugin) {
-    this.pluginManager.register(plugin);
-    return this;
-  }
-
-  /**
-   * 注册 LLM Provider
-   * @param {string} name - Provider 名称
-   * @param {Object} config - Provider 配置
-   */
-  registerProvider(name, config) {
-    const { registerProvider } = require('./provider');
-    registerProvider(name, config);
-    return this;
-  }
-
-  /**
-   * 获取 Provider Registry
-   */
-  getProviderRegistry() {
-    const { getProviderRegistry } = require('./provider');
-    return getProviderRegistry();
-  }
-
-  /**
-   * 注册 CLI 命令
-   * @param {string} name - 命令名称
-   * @param {Function} handler - 命令处理函数
-   * @param {string} description - 命令描述
-   * @param {Function} [getArgumentCompletions] - 自动补全函数
-   */
-  registerCommand(name, handler, description, getArgumentCompletions) {
-    const { getCommandRegistry } = require('./command-registry');
-    const registry = getCommandRegistry();
-    registry.registerCommand(name, handler, description, getArgumentCompletions);
-    return this;
-  }
-
-  /**
-   * 获取 CommandRegistry
-   */
-  getCommandRegistry() {
-    const { getCommandRegistry } = require('./command-registry');
-    return getCommandRegistry();
-  }
-
-  /**
-   * 创建 UI 扩展上下文
-   * @param {string} pluginName - 插件名称
-   * @param {Object} chatUI - ChatUI 实例
-   * @returns {ExtensionUIContext}
-   */
-  createUIContext(pluginName, chatUI) {
-    const { ExtensionUIContext } = require('./ui-extension-context');
-    if (!this._uiExtensions) {
-      this._uiExtensions = new Map();
-    }
-    const ctx = new ExtensionUIContext(chatUI, pluginName);
-    this._uiExtensions.set(pluginName, ctx);
-    return ctx;
-  }
-
-  /**
-   * 获取 UI 扩展上下文
-   */
-  getUIContext(pluginName) {
-    return this._uiExtensions?.get(pluginName) || null;
-  }
-
-  /**
-   * 加载并启动插件）
-   * @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 {string} name - 插件名称
-   */
-  async enablePlugin(name) {
-    await this.pluginManager.enable(name);
-    return this;
-  }
-
-  /**
-   * 禁用插件
-   * @param {string} name - 插件名称
-   */
-  async disablePlugin(name) {
-    await this.pluginManager.disable(name);
-    return this;
-  }
-
-  /**
-   * 更新插件配置
-   * @param {string} name - 插件名称
-   * @param {Object} config - 新配置
-   */
-  updatePluginConfig(name, config) {
-    return this.pluginManager.updatePluginConfig(name, config);
-  }
-
-  /**
-   * 注册工具
-   * @param {Object} tool - 工具定义
-   */
-  registerTool(tool) {
-    this.toolRegistry.register(tool);
-    return this;
-  }
-
-  /**
-   * 获取所有工具）
-   * @returns {Array<Object>}
-   */
-  getTools() {
-    return this.toolRegistry.getAll();
-  }
-
-  // ============================================================================
-  // 公开 API — 减少外部直接访问私有属性
-  // ============================================================================
-
-  /**
-   * 获取主 Agent
-   * @returns {Agent|null}
-   */
-  getMainAgent() {
-    return this._mainAgent;
-  }
-
-  /**
-   * 获取主 Agent 的 System Prompt
-   * @returns {string}
-   */
-  getSystemPrompt() {
-    if (this._mainAgent) {
-      return this._mainAgent._buildSystemPrompt();
-    }
-    return '';
-  }
-
-  /**
-   * 获取插件实例（安全访问）
-   * @param {string} name - 插件名称
-   * @returns {Object|null}
-   */
-  getPluginInstance(name) {
-    const entry = this.pluginManager.get(name);
-    return entry || null;
-  }
-
-  /**
-   * 获取所有 Agent 列表
-   * @returns {Array<Agent>}
-   */
-  getAgents() {
-    return [...this._agents];
-  }
-
-  /**
-   * 获取所有 SessionContext 的 ID 列表
-   * @returns {string[]}
-   */
-  listSessionContexts() {
-    return Array.from(this._sessionContexts.keys());
-  }
-
-  // ============================================================================
-  // 事件描述注册（供 Ambient Agent 使用）
-  // ============================================================================
-
-  /**
-   * 注册事件描述
-   * @param {string} eventType - 事件类型，如 'tool:result'
-   * @param {string} description - 事件描述
-   * @param {Object} schema - 事件参数 Schema（可选）
-   */
-  registerEventDescription(eventType, description, schema = null) {
-    this.pluginManager.registerEventDescription(eventType, description, schema);
-    return this;
-  }
-
-  /**
-   * 获取所有已注册的事件描述
-   * @returns {Map<string, Object>} 事件描述 Map
-   */
-  getEventDescriptions() {
-    return this.pluginManager.getEventDescriptions();
-  }
-
-  /**
-   * 获取单个事件描述
-   * @param {string} eventType - 事件类型
-   * @returns {Object|null} 事件描述
-   */
-  getEventDescription(eventType) {
-    return this.pluginManager.getEventDescription(eventType);
-  }
-
-  /**
-   * 执行工具
-   * @param {string} name - 工具名称
-   * @param {Object} args - 参数
-   */
-  async executeTool(name, args) {
-    return this.toolRegistry.execute(name, args, this);
-  }
-
-  /**
-   * 在上下文中执行函数（支持并行处理，自动隔离 session）
-   * @param {Object} context - 执行上下文 { sessionId, ... }
-   * @param {Function} fn - 要执行的异步函数
-   * @returns {Promise}
-   */
-  runWithContext(context, fn) {
-    return asyncLocalStorage.run(context, fn);
-  }
-
-  /**
-   * 获取当前执行上下文（在 runWithContext 内部调用）
-   * @returns {Object|null}
-   */
-  getExecutionContext() {
-    return asyncLocalStorage.getStore() || null;
-  }
-
-  /**
-   * @deprecated 使用 runWithContext 代替
-   */
-  setExecutionContext() {}
-
-  /**
-   * @deprecated 使用 runWithContext 代替
-   */
-  clearExecutionContext() {}
-
-  // ============================================================================
-  // 分层上下文系统 - Session Context
-  // ============================================================================
-
-  /**
-   * 获取或创建 SessionManager
-   * @param {string} sessionId - 会话 ID
-   * @param {Object} options - 配置选项
-   * @returns {SessionManager}
-   */
-  getOrCreateSessionContext(sessionId, options = {}) {
-    if (!sessionId) {
-      return null;
-    }
-
-    // 先检查内存缓存
-    let manager = this._sessionContexts.get(sessionId);
-    if (manager) {
-      return manager;
-    }
-
-    // 获取工作目录
-    const cwd = options.cwd || this._cwd;
-    const sessionDir = path.join(cwd, '.foliko', 'sessions');
-
-    // 获取或创建 session file path
-    const sessionFile = options.sessionFile || path.join(sessionDir, `${sessionId}.jsonl`);
-
-    // 尝试打开已存在的 session
-    try {
-      if (require('fs').existsSync(sessionFile)) {
-        manager = SessionManager.open(sessionFile, sessionDir, cwd);
-      }
-    } catch (err) {
-      // 文件损坏或不存在，创建新的
-    }
-
-    if (!manager) {
-      // 创建新的 SessionManager
-      manager = new SessionManager(cwd, sessionDir, sessionFile, true);
-    }
-
-    this._sessionContexts.set(sessionId, manager);
-    this.emit('session:context-created', { sessionId, manager });
-    return manager;
-  }
-
-  /**
-   * 异步加载 SessionManager（如果存在）
-   * @param {string} sessionId
-   * @param {Object} options
-   * @returns {Promise<SessionManager|null>}
-   */
-  async loadSessionContext(sessionId, options = {}) {
-    if (!sessionId) {
-      return null;
-    }
-
-    // 先检查内存缓存
-    let manager = this._sessionContexts.get(sessionId);
-    if (manager) {
-      return manager;
-    }
-
-    const cwd = options.cwd || this._cwd;
-    const sessionDir = path.join(cwd, '.foliko', 'sessions');
-    const sessionFile = path.join(sessionDir, `${sessionId}.jsonl`);
-
-    try {
-      if (require('fs').existsSync(sessionFile)) {
-        manager = SessionManager.open(sessionFile, sessionDir, cwd);
-        this._sessionContexts.set(sessionId, manager);
-        this.emit('session:context-created', { sessionId, manager });
-      }
-    } catch (err) {
-      // 文件不存在或损坏
-    }
-
-    return manager || null;
-  }
-
-  /**
-   * 配置 Session 存储目录
-   * @param {Object} config - 存储配置
-   * @param {string} [config.baseDir='.foliko/sessions'] - 文件存储目录
-   */
-  configureSessionStorage(config) {
-    this._sessionStorageConfig = config;
-  }
-
-  /**
-   * 获取当前 Session 存储配置
-   * @returns {Object}
-   */
-  getSessionStorage() {
-    return this._sessionStorageConfig;
-  }
-
-  /**
-   * 获取 SessionManager
-   * @param {string} sessionId - 会话 ID
-   * @returns {SessionManager|null}
-   */
-  getSessionContext(sessionId) {
-    return this._sessionContexts.get(sessionId) || null;
-  }
-
-  /**
-   * 获取当前 Session 上下文（从 AsyncLocalStorage 获取）
-   * @returns {SessionManager|null}
-   */
-  getCurrentSessionContext() {
-    const store = sessionStorage.getStore();
-    if (!store) return null;
-    const sessionId = store.sessionId;
-    return sessionId ? this._sessionContexts.get(sessionId) || null : null;
-  }
-
-  /**
-   * 获取当前 sessionId（从 AsyncLocalStorage 获取）
-   * @returns {string|null}
-   */
-  getCurrentSessionId() {
-    const store = sessionStorage.getStore();
-    return store?.sessionId || null;
-  }
-
-  /**
-   * 在 Session 上下文中执行函数
-   * @param {string} sessionId - 会话 ID
-   * @param {Object} options - Session 选项
-   * @param {Function} fn - 异步函数
-   * @returns {Promise}
-   */
-  runInSession(sessionId, options, fn) {
-    if (!sessionId) {
-      // 无 session，直接执行
-      return fn();
-    }
-
-    const manager = this.getOrCreateSessionContext(sessionId, options);
-    const context = { sessionContext: manager, sessionId };
-    return sessionStorage.run(context, fn);
-  }
-
-  /**
-   * 销毁 Session Manager
-   * @param {string} sessionId
-   */
-  destroySessionContext(sessionId) {
-    if (this._sessionContexts.has(sessionId)) {
-      const manager = this._sessionContexts.get(sessionId);
-      this._sessionContexts.delete(sessionId);
-      this.emit('session:context-destroyed', { sessionId });
-    }
-  }
-
-  // Session TTL 清理配置
-  _sessionTTL = 30 * 60 * 1000; // 默认 30 分钟
-  _sessionCleanupInterval = null;
-
-  /**
-   * 配置 Session TTL
-   * @param {number} ttlMs - TTL 毫秒数
-   */
-  setSessionTTL(ttlMs) {
-    this._sessionTTL = ttlMs;
-    return this;
-  }
-
-  // ============================================================================
-  // 工作目录与 Agent 目录
-  // ============================================================================
-
-  /**
-   * 获取当前工作目录
-   * @returns {string}
-   */
-  getCwd() {
-    return this._cwd;
-  }
-
-  /**
-   * 获取项目级 Agent 目录（绝对路径）
-   * @returns {string}
-   */
-  getAgentDir() {
-    return path.resolve(this._cwd, this._agentDir);
-  }
-
-  /**
-   * 获取用户级 Agent 目录（绝对路径）
-   * @returns {string}
-   */
-  getHomeAgentDir() {
-    return this._homeAgentDir;
-  }
-
-  /**
-   * 解析项目级 Agent 目录下的相对路径
-   * @param  {...string} parts
-   * @returns {string}
-   */
-  resolveAgentPath(...parts) {
-    return path.join(this.getAgentDir(), ...parts);
-  }
-
-  /**
-   * 解析用户级 Agent 目录下的相对路径
-   * @param  {...string} parts
-   * @returns {string}
-   */
-  resolveHomeAgentPath(...parts) {
-    return path.join(this.getHomeAgentDir(), ...parts);
-  }
-
-  /**
-   * 动态切换工作目录
-   *
-   * 切换后会自动:
-   *   1. 更新 PluginManager 状态文件位置
-   *   2. 销毁已存在的 Session 上下文（旧路径失效）
-   *   3. 通知所有已加载插件（onCwdChanged 钩子）并触发 reload
-   *   4. 发送 cwd:changed 事件
-   *
-   * @param {string} newCwd - 新工作目录（相对或绝对路径）
-   * @param {Object} [options]
-   * @param {boolean} [options.reload=true] - 是否自动重载已加载插件
-   * @param {string} [options.agentDir] - 顺带覆盖项目 agent 目录名
-   * @param {string} [options.homeAgentDir] - 顺带覆盖用户 agent 目录路径
-   * @returns {Promise<this>}
-   */
-  async setCwd(newCwd, options = {}) {
-    if (this._changingCwd) {
-      throw new Error('setCwd re-entered during cwd change');
-    }
-
-    const oldCwd = this._cwd;
-    const resolved = path.resolve(newCwd);
-    if (resolved === oldCwd) {
-      return this;
-    }
-
-    this._changingCwd = true;
-    try {
-      this._cwd = resolved;
-      if (options.agentDir) this._agentDir = options.agentDir;
-      if (options.homeAgentDir) this._homeAgentDir = options.homeAgentDir;
-
-      // 1. 更新 PluginManager 状态文件位置
-      this.pluginManager._setStateFile(resolved);
-
-      // 2. 销毁已存在的 Session 上下文（旧路径失效）
-      const count = this._sessionContexts.size;
-      for (const sid of Array.from(this._sessionContexts.keys())) {
-        this.destroySessionContext(sid);
-      }
-      this.emit('session:contexts-invalidated', { oldCwd, newCwd: resolved, count });
-
-      // 3. 通知已加载插件 + 触发 reload
-      if (options.reload !== false) {
-        for (const entry of this.pluginManager.getAll()) {
-          const inst = entry.instance;
-          try {
-            if (typeof inst?.onCwdChanged === 'function') {
-              await inst.onCwdChanged(oldCwd, resolved, this);
-            }
-            await this.pluginManager.reload(entry.name);
-          } catch (err) {
-            this.logger.warn(`Plugin ${entry.name} failed during cwd change: ${err.message}`);
-          }
-        }
-      }
-
-      // 4. 发送 cwd:changed 事件
-      this.emit('cwd:changed', { oldCwd, newCwd: resolved, framework: this });
-    } finally {
-      this._changingCwd = false;
-    }
-    return this;
-  }
-
-  // ============================================================================
-  // 项目重扫 — 重新扫描当前 cwd 下的插件与技能
-  // ============================================================================
-
-  /**
-   * 重新扫描当前 cwd 下的插件与技能目录
-   *
-   * 工作流程:
-   *   1. 卸载 keepLoaded 列表外的所有已加载插件
-   *   2. 重新读取 DefaultPlugins 配置（新的 skillsDirs / agentsDir / pluginLinks）
-   *   3. 重新跑 bootstrapDefaults 加载所有默认插件（核心 + 自定义）
-   *   4. 同步 SkillManager._skillsDirs 并触发技能重扫
-   *   5. 发出 rescan:complete 事件
-   *
-   * 典型用法: 配合 setCwd 切换到新项目
-   *   await framework.setCwd('D:/new-project');
-   *   await framework.rescanProject();
-   *
-   * @param {Object} [options]
-   * @param {string[]} [options.keepLoaded] - 保留的插件名列表（默认保留系统插件）
-   * @param {boolean} [options.reloadKept=false] - 是否对 keepLoaded 中的插件也执行 reload
-   * @param {boolean} [options.reloadSkillManager=true] - 是否重扫技能
-   * @returns {Promise<{unloaded: string[], loaded: string[], keepLoaded: string[]}>}
-   */
-  async rescanProject(options = {}) {
-    const { bootstrapDefaults, DefaultPlugins, loadAgentConfig } = require('../../plugins/default-plugins');
-    const keepList = options.keepLoaded || Array.from(SYSTEM_PLUGINS);
-    const keepSet = new Set(keepList);
-    const unloadList = [];
-    const loadList = [];
-
-    // 1. 卸载 keepSet 之外的插件
-    for (const entry of Array.from(this.pluginManager.getAll())) {
-      if (keepSet.has(entry.name)) continue;
-      const name = entry.name;
-      try {
-        await this.pluginManager.unload(name);
-        // 同步从注册表移除,避免 bootstrapDefaults 的 has() 跳过
-        this.pluginManager._plugins.delete(name);
-        unloadList.push(name);
-      } catch (err) {
-        this.logger.warn(`rescanProject: failed to unload ${name}: ${err.message}`);
-      }
-    }
-
-    // 2. 确保 defaults 插件已加载,重新读取配置
-    let defaultsPlugin = this.pluginManager.get('defaults');
-    if (!defaultsPlugin) {
-      const dp = new DefaultPlugins({ agentDir: this._agentDir });
-      try {
-        await this.loadPlugin(dp);
-        defaultsPlugin = dp;
-      } catch (err) {
-        this.logger.warn(`rescanProject: failed to load defaults: ${err.message}`);
-      }
-    } else {
-      try {
-        await defaultsPlugin.reload(this);
-      } catch (err) {
-        this.logger.warn(`rescanProject: failed to reload defaults: ${err.message}`);
-      }
-    }
-    const agentConfig = defaultsPlugin
-      ? defaultsPlugin.getConfig() || loadAgentConfig(this, this._agentDir)
-      : loadAgentConfig(this, this._agentDir);
-
-    // 3. 跑 bootstrapDefaults 加载默认插件（核心 + 自定义）
-    const beforeNames = new Set(this.pluginManager.getAll().map((p) => p.name));
-    try {
-      await bootstrapDefaults(this, { _config: agentConfig, _skipConfigLoad: true });
-    } catch (err) {
-      this.logger.warn(`rescanProject: bootstrapDefaults failed: ${err.message}`);
-    }
-    for (const name of this.pluginManager.getAll().map((p) => p.name)) {
-      if (!beforeNames.has(name)) loadList.push(name);
-    }
-
-    // 4. 同步并重扫技能
-    if (options.reloadSkillManager !== false) {
-      const skillManager = this.pluginManager.get('skill-manager');
-      if (skillManager) {
-        if (Array.isArray(agentConfig.skillsDirs)) {
-          skillManager._skillsDirs = agentConfig.skillsDirs;
-        }
-        try {
-          await skillManager.reload(this);
-        } catch (err) {
-          this.logger.warn(`rescanProject: skill-manager reload failed: ${err.message}`);
-        }
-      }
-    }
-
-    // 5. (可选) 对保留的插件也执行 reload
-    if (options.reloadKept) {
-      for (const name of keepList) {
-        if (!this.pluginManager.has(name)) continue;
-        try {
-          await this.pluginManager.reload(name);
-        } catch (err) {
-          this.logger.warn(`rescanProject: reload kept ${name} failed: ${err.message}`);
-        }
-      }
-    }
-
-    const result = { unloaded: unloadList, loaded: loadList, keepLoaded: keepList };
-    this.emit('rescan:complete', result);
-    this.logger.info(
-      `rescanProject: unloaded=${unloadList.length} loaded=${loadList.length} kept=${keepList.length}`
-    );
-    return result;
-  }
-
-  /**
-   * 启动 Session 自动清理
-   * @param {number} [intervalMs=60000] - 检查间隔
-   */
-  startSessionCleanup(intervalMs = 60000) {
-    if (this._sessionCleanupInterval) {
-      clearInterval(this._sessionCleanupInterval);
-    }
-    this._sessionCleanupInterval = setInterval(() => {
-      this._cleanupStaleSessions();
-    }, intervalMs);
-    if (this._sessionCleanupInterval.unref) {
-      this._sessionCleanupInterval.unref();
-    }
-    return this;
-  }
-
-  /**
-   * 停止 Session 自动清理
-   */
-  stopSessionCleanup() {
-    if (this._sessionCleanupInterval) {
-      clearInterval(this._sessionCleanupInterval);
-      this._sessionCleanupInterval = null;
-    }
-    return this;
-  }
-
-  /**
-   * 清理过期的 Session
-   * @private
-   */
-  _cleanupStaleSessions() {
-    const now = Date.now();
-    const staleIds = [];
-    for (const [sessionId, manager] of this._sessionContexts) {
-      const metadata = manager.getMetadata?.();
-      if (metadata && metadata.lastActive && (now - metadata.lastActive) > this._sessionTTL) {
-        staleIds.push(sessionId);
-      }
-    }
-    for (const id of staleIds) {
-      this.destroySessionContext(id);
-    }
-    if (staleIds.length > 0) {
-      this.logger.debug(`Cleaned up ${staleIds.length} stale sessions`);
-    }
-  }
-
-  /**
-   * 列出所有活跃的 Session ID
-   * @returns {string[]}
-   */
-  listActiveSessions() {
-    return Array.from(this._sessionContexts.keys());
-  }
-
-  // ============================================================================
-  // 分层上下文系统 - Request Context
-  // ============================================================================
-
-  /**
-   * 获取当前 Request 上下文
-   * @returns {Object|null}
-   */
-  getRequestContext() {
-    return requestStorage.getStore() || null;
-  }
-
-  /**
-   * 在 Request 上下文中执行函数
-   * @param {Object} context - Request 上下文
-   * @param {Function} fn - 异步函数
-   * @returns {Promise}
-   */
-  runWithRequestContext(context, fn) {
-    return requestStorage.run(context, fn);
-  }
-
-  // ============================================================================
-  // 分层上下文系统 - 组合上下文
-  // ============================================================================
-
-  /**
-   * 在完整上下文中执行（Request + Session）
-   * @param {Object} requestOptions - Request 选项
-   * @param {string} sessionId - Session ID
-   * @param {Function} fn - 异步函数
-   * @returns {Promise}
-   */
-  async runInContext(requestOptions, sessionId, fn) {
-    const sessionCtx = sessionId ? this.getOrCreateSessionContext(sessionId) : null;
-
-    return requestStorage.run(requestOptions, () => {
-      if (sessionCtx) {
-        return sessionStorage.run({ sessionContext: sessionCtx, sessionId }, fn);
-      }
-      return fn();
-    });
-  }
-
-  /**
-   * 创建 Agent
-   * @param {Object} config - Agent 配置
-   */
-  createAgent(config) {
-    // 合并 AI 插件配置
-    config = this._mergeAIConfig(config);
-
-    const agent = new Agent(this, config);
-
-    // 跟踪 agent
-    this._agents.push(agent);
-    if (!this._mainAgent) {
-      this._mainAgent = agent;
-    }
-
-    this.emit('agent:created', agent);
-    return agent;
-  }
-
-  /**
-   * 为指定 session 创建独立 Agent 实例
-   * @param {string} sessionId - session ID
-   * @param {Object} config - Agent 配置
-   */
-  createSessionAgent(sessionId, config = {}) {
-    const agentConfig = {
-      name: `session_${sessionId}`,
-      ...config,
-    };
-
-    // 合并 AI 插件配置
-    const merged = this._mergeAIConfig(agentConfig);
-
-    const agent = new Agent(this, merged);
-    this._agents.push(agent);
-
-    // 如果提供了 systemPrompt，需要替换 AgentChatHandler
-    if (merged.systemPrompt) {
-      agent.setSystemPrompt(merged.systemPrompt);
-    }
-
-    this.emit('agent:created', agent);
-    return agent;
-  }
-
-  /**
-   * 创建子Agent（轻量级，单次任务）
-   * @param {Object} config - 子Agent配置
-   * @param {string} config.name - 子Agent名称
-   * @param {string} [config.role] - 角色描述
-   * @param {string} [config.description] - 描述
-   * @param {string} [config.systemPrompt] - 直接指定的系统提示词（优先使用）
-   * @param {Object} [config.tools] - 自定义工具 { name: toolDef }
-   * @param {string[]} [config.parentTools] - 从父Agent继承的工具名称列表
-   * @param {Object} [config.llmConfig] - 独立LLM配置
-   * @returns {Subagent} 创建的子Agent
-   */
-  createSubAgent(config) {
-    const {
-      name,
-      role,
-      description = '',
-      systemPrompt: providedPrompt,
-      tools = {},
-      parentTools, // 如果不传，默认继承主agent所有工具
-      llmConfig = null,
-      maxRetries,
-      disableTools,
-    } = config;
-
-    // 获取 AI 配置
-    const aiPlugin = this.pluginManager.get('ai');
-    const aiConfig = aiPlugin ? aiPlugin.getConfig() : {};
-    const mergedAIConfig = { ...aiConfig, ...(llmConfig || {}) };
-
-    // 构建工具列表
-    // const toolList = [];
-
-    // // 添加自定义工具
-    // for (const [toolName, toolDef] of Object.entries(tools)) {
-    //   if (toolDef && typeof toolDef === 'object') {
-    //     toolList.push({
-    //       name: toolName,
-    //       description: toolDef.description || '',
-    //       inputSchema: toolDef.inputSchema,
-    //       execute: toolDef.execute,
-    //     });
-    //   }
-    // }
-
-    // 创建 Subagent
-    // 如果提供了 systemPrompt 则直接使用，否则让 Subagent 动态构建
-    const subagent = new Subagent({
-      name: `subagent_${name}`,
-      role: role || name,
-      description: description,
-      systemPrompt: providedPrompt,
-      model: mergedAIConfig.model || 'deepseek-chat',
-      provider: mergedAIConfig.provider || 'deepseek',
-      apiKey: mergedAIConfig.apiKey,
-      baseURL: mergedAIConfig.baseURL,
-      providerOptions: {
-        maxOutputTokens: mergedAIConfig.maxOutputTokens || 8192,
-        temperature: mergedAIConfig.temperature || 0.3,
-      },
-      tools: tools,
-      parentTools: parentTools,
-      framework: this, // 传递 framework 引用用于动态构建系统提示词
-      maxRetries,
-      disableTools,
-    });
-
-    // 注册主 Agent 的提示词部分到子 Agent（选择性注册）
-    if (this._mainAgent && this._mainAgent._systemPromptBuilder) {
-      const mainParts = this._mainAgent._systemPromptBuilder._parts;
-      if (mainParts) {
-        for (const [name, part] of mainParts) {
-          // 子 Agent 跳过这些不适合的部分
-          if (['original-prompt', 'shared-prompt', 'datetime', 'metadata', 'capabilities'].includes(name)) {
-            continue;
-          }
-          subagent.registerPromptPart(name, part.priority, part.provider);
-        }
-      }
-    }
-
-    this._agents.push(subagent);
-    this.emit('agent:created', subagent);
-    return subagent;
-  }
-
-  /**
-   * 同步主Agent的提示词部分到所有子Agent
-   * @public — 插件可能需要调用
-   */
-  syncPromptPartsToSubagents() {
-    if (!this._mainAgent || !this._mainAgent._systemPromptBuilder) return;
-    const mainParts = this._mainAgent._systemPromptBuilder._parts;
-    if (!mainParts) return;
-
-    // 遍历所有 agents，排除主agent
-    for (const agent of this._agents) {
-      if (agent === this._mainAgent) continue;
-      // 只同步 Subagent
-      if (!agent._isSubagent) continue;
-
-      // Build a Set of already registered parts for O(1) lookup
-      const registeredNames = new Set(agent._promptParts?.map(p => p.name) || []);
-
-      for (const [name, part] of mainParts) {
-        // 子 Agent 跳过这些不适合的部分
-        if (['original-prompt', 'shared-prompt', 'datetime', 'metadata', 'capabilities'].includes(name)) {
-          continue;
-        }
-        // O(1) lookup instead of O(m)
-        if (!registeredNames.has(name)) {
-          agent.registerPromptPart(name, part.priority, part.provider);
-          registeredNames.add(name);
-        }
-      }
-    }
-  }
-
-  /**
-   * 构建子Agent的系统提示词
-   * @private
-   */
-  _buildSubAgentSystemPrompt(role, description, tools) {
-    const lines = [];
-    const roleName = role || '助手';
-    const descText = description || '';
-
-    // 1. 角色定义
-    lines.push(`你是 ${roleName}。`);
-    if (descText) {
-      lines.push(descText);
-    }
-    lines.push('');
-
-    // 2. 主Agent的系统提示词（基础部分）
-    const mainAgent = this.getMainAgent();
-    if (mainAgent) {
-      const mainPrompt = mainAgent.getOriginalPrompt();
-      if (mainPrompt) {
-        lines.push('## 主Agent的系统提示词');
-        lines.push(mainPrompt);
-        lines.push('');
-      }
-    }
-
-    // 3. 工具描述
-    if (tools && tools.length > 0) {
-      lines.push('## 可用工具');
-      lines.push('');
-      for (const tool of tools) {
-        const desc = tool.description || '无描述';
-        lines.push(`- **${tool.name}**: ${desc}`);
-      }
-      lines.push('');
-    }
-
-    // 4. 子Agent核心规则
-    lines.push(`## ${roleName} 核心规则
-
-1. **专注本职任务**：只完成与 ${roleName} 相关的任务，不要处理其他领域的请求。
-2. **必须先调用工具**：需要信息或操作时，必须调用工具获取真实结果，禁止直接编造。
-3. **结果导向**：基于工具返回结果回答，不重复工具内部实现细节。
-4. **多步骤任务**：复杂任务拆解为多个工具调用，逐步完成。
-5. **响应规范**：直接给出结论，不说"我需要..."等铺垫话术。
-
-## 禁止事项
-
-- 不调用工具就直接回答
-- 编造数据、文件、订单等信息
-- 处理本职外的任务
-- 回复含糊不清`);
-
-    return lines.join('\n');
-  }
-
-  /**
-   * 获取 AI 插件
-   * @returns {Object|undefined}
-   */
-  getAIPlugin() {
-    return this.pluginManager.get('ai');
-  }
-
-  /**
-   * Bootstrap - 使用默认配置启动框架
-   * 自动加载 .foliko/ 目录下的配置和所有默认插件）
-   * @param {Object} config - 配置
-   * @param {string} [config.agentDir='.foliko'] - 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 || '.foliko',
-    });
-
-    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
-   */
-  _registerBuiltinTools() {
-    // 内置工具会在 Agent 创建时添加）
-  }
-
-  // ============================================================================
-  // Coordinator 模式管理
-  // ============================================================================
-
-  /**
-   * 初始化Coordinator管理器
-   * @param {Agent} coordinatorAgent - Coordinator Agent实例
-   */
-  initCoordinatorManager(coordinatorAgent) {
-    if (!this._coordinatorManager) {
-      this._coordinatorManager = new CoordinatorManager(this);
-    }
-    this._coordinatorManager.setCoordinatorAgent(coordinatorAgent);
-    return this._coordinatorManager;
-  }
-
-  /**
-   * 获取Coordinator管理器
-   * @returns {CoordinatorManager|null}
-   */
-  getCoordinatorManager() {
-    return this._coordinatorManager;
-  }
-
-  /**
-   * 创建Worker（由coordinator-plugin调用）
-   * @param {Object} config - Worker配置
-   * @param {string} config.name - Worker名称
-   * @param {string} config.task - 初始任务
-   * @param {string} [config.systemPrompt] - 可选系统提示
-   * @param {string[]} [config.tools] - 可用工具列表
-   * @returns {Promise<{workerId: string, status: string}>}
-   */
-  async createWorker(config) {
-    if (!this._coordinatorManager) {
-      throw new Error('CoordinatorManager not initialized. Call initCoordinatorManager first.');
-    }
-    return this._coordinatorManager.createWorker(config);
-  }
-
-  /**
-   * 销毁框架
-   */
-  async destroy() {
-    // 销毁Coordinator管理器
-    if (this._coordinatorManager) {
-      this._coordinatorManager.destroy();
-      this._coordinatorManager = null;
-    }
-
-    // 销毁所有 agents
-    for (const agent of this._agents) {
-      // 移除 agent 的事件转发监听器
-      const listeners = this._agentForwardingListeners?.get(agent);
-      if (listeners) {
-        agent.off('tool-call', listeners.toolCallHandler);
-        agent.off('tool-result', listeners.toolResultHandler);
-        agent.off('tool-error', listeners.toolErrorHandler);
-        agent.off('message', listeners.messageHandler);
-        this._agentForwardingListeners.delete(agent);
-      }
-      // 调用 agent.destroy() 清理自身资源
-      if (typeof agent.destroy === 'function') {
-        agent.destroy();
-      }
-    }
-    this._agents = [];
-
-    // 移除 toolRegistry 的事件监听器
-    if (this._toolRegistryListeners) {
-      for (const { event, handler } of this._toolRegistryListeners) {
-        this.toolRegistry.off(event, handler);
-      }
-      this._toolRegistryListeners = [];
-    }
-
-    // 停止 Session 清理
-    this.stopSessionCleanup();
-
-    // 清空 session contexts
-    this._sessionContexts.clear();
-
-    // 卸载所有插件（逐个保护，防止一个失败阻断后续）
-    const plugins = this.pluginManager.getAll();
-    for (const { name } of plugins) {
-      try {
-        await this.pluginManager.unload(name);
-      } catch (err) {
-        this.logger.warn(`Failed to unload plugin '${name}': ${err.message}`);
-      }
-    }
-
-    // 清空工具
-    this.toolRegistry.clear();
-
-    // 清空事件
-    this.removeAllListeners();
-
-    this.emit('framework:destroyed');
-  }
-}
-
-module.exports = { Framework };