foliko 1.1.93 → 2.0.1

package/plugins/core/default/bootstrap.js

@@ -0,0 +1,224 @@
+'use strict';
+
+/**
+ * Bootstrap 辅助函数
+ * 根据配置加载所有默认插件
+ */
+
+const { Plugin } = require('../../../src/plugin/base');
+const { logger } = require('../../../src/common/logger');
+const { resolvePluginPath, scanPluginNames } = require('../../../src/utils/plugin-helpers');
+const path = require('path');
+const fs = require('fs');
+const log = logger.child('Bootstrap');
+
+/**
+ * 加载自定义插件（.foliko/plugins/ 和项目 plugins/ 目录）
+ */
+async function loadCustomPlugins(framework, agentConfig) {
+  const cwd = framework?.getCwd?.() ?? process.cwd();
+  const dirs = [
+    { dir: path.resolve(cwd, '.foliko', 'plugins'), forceEnabled: true },
+    { dir: path.resolve(cwd, 'plugins'), forceEnabled: false },
+    { dir: path.resolve(__dirname, '..', '..', '..', 'plugins'), forceEnabled: false },
+  ];
+  for (const { dir, forceEnabled } of dirs) {
+    if (!fs.existsSync(dir)) continue;
+    const names = scanPluginNames(dir);
+    for (const pluginName of names) {
+      try {
+        const resolved = resolvePluginPath(dir, pluginName);
+        if (!resolved) continue;
+        delete require.cache[require.resolve(resolved.path)];
+        const mod = require(resolved.path);
+        let pluginClass = mod.default || mod;
+        if (typeof pluginClass === 'function' && !(pluginClass.prototype instanceof Plugin)) {
+          const keys = Object.keys(mod).filter(k => mod[k] && mod[k].prototype instanceof Plugin);
+          if (keys.length > 0) pluginClass = mod[keys[0]];
+        }
+        let resolvedName = pluginName;
+        if (typeof pluginClass === 'function' && pluginClass.prototype instanceof Plugin) {
+          resolvedName = new pluginClass().name || pluginName;
+        }
+        if (framework.pluginManager.has(resolvedName) && framework.pluginManager.get(resolvedName)?._started) continue;
+        const pluginConfig = agentConfig[resolvedName] || {};
+        let instance;
+        if (typeof pluginClass === 'function' && pluginClass.prototype instanceof Plugin) {
+          instance = new pluginClass(pluginConfig);
+        } else {
+          instance = pluginClass;
+        }
+        await framework.pluginManager.load(instance, { forceEnabled });
+      } catch (err) { log.error(`Failed to load plugin ${pluginName}:`, err.message); }
+    }
+  }
+}
+
+/**
+ * Bootstrap 主函数
+ * 加载所有默认插件
+ */
+async function bootstrapDefaults(framework, config = {}) {
+  const agentConfig = config._config;
+  if (!agentConfig) {
+    log.error('No config provided, skipping plugin loading');
+    return;
+  }
+
+  // 启用 bootstrap 模式：load() 只 install 不 start，由 startAll() 统一启动
+  framework.pluginManager.setBootstrapping(true);
+
+  const shouldLoad = (plugin) => {
+    const name = typeof plugin === 'string' ? plugin : (plugin.name || plugin.prototype?.name);
+    if (framework.pluginManager.has(name)) { return false; }
+    return true;
+  };
+
+  const aiConfig = { ...agentConfig.ai, ...config.aiConfig };
+  const upperProvider = (aiConfig.provider || 'deepseek').toUpperCase().replace(/-/g, '_');
+  const envApiKey = process.env[`${upperProvider}_API_KEY`] || process.env.FOLIKO_API_KEY;
+
+  // 0. Install plugin
+  if (shouldLoad('install')) {
+    const InstallPlugin = require('../../install');
+    await framework.loadPlugin(new InstallPlugin({ agentDir: agentConfig.agentDir }));
+  }
+
+  // 0.5 Tools plugin (built-in management tools)
+  if (shouldLoad('tools')) {
+    const ToolsPlugin = require('../../tools');
+    await framework.loadPlugin(new ToolsPlugin());
+  }
+
+  // 0.6 Plugin manager (remote plugin management)
+  if (shouldLoad('plugin-manager')) {
+    const PluginManagerPlugin = require('../../plugin-manager');
+    await framework.loadPlugin(new PluginManagerPlugin({ repo: agentConfig.pluginRepo }));
+  }
+
+  const skillsDirs = [...(config.skillsDirs || []), ...(agentConfig.skillsDirs || [])];
+
+  // 1. AI plugin
+  if (shouldLoad('ai') && (aiConfig.provider || aiConfig.model || aiConfig.apiKey || envApiKey)) {
+    const AIPlugin = require('../ai');
+    await framework.loadPlugin(new AIPlugin({
+      provider: aiConfig.provider || 'deepseek',
+      model: aiConfig.model || 'deepseek-chat',
+      apiKey: aiConfig.apiKey || envApiKey,
+      baseURL: aiConfig.baseURL,
+    }));
+  }
+
+  // 1.5 Main Agent
+  if (!framework._mainAgent) {
+    const { Agent } = require('../../../src/agent/main');
+    const aiPlugin = framework.pluginManager.get('ai');
+    framework._mainAgent = framework.createAgent({
+      name: 'MainAgent',
+      systemPrompt: '你是一个智能助手。当用户提出问题或任务时，你会主动分析需求，选择合适的工具来获取信息或执行操作。你善于将复杂任务拆解为多个步骤，通过工具协作完成。',
+      model: aiConfig.model || 'deepseek-chat',
+      provider: aiConfig.provider || 'deepseek',
+      apiKey: aiPlugin ? aiPlugin.config.apiKey : (aiConfig.apiKey || envApiKey),
+      baseURL: aiConfig.baseURL,
+    });
+    framework._agents.push(framework._mainAgent);
+  }
+
+  // 1.875 Extension executor (needed by skill-manager for slash commands)
+  if (shouldLoad('extension-executor')) {
+    const ExtensionExecutorPlugin = require('../../executors/extension');
+    await framework.loadPlugin(new ExtensionExecutorPlugin());
+  }
+
+  // 2. Skill manager
+  if (shouldLoad('skill-manager') && skillsDirs.length > 0) {
+    const { SkillManagerPlugin } = require('../skill-manager');
+    await framework.loadPlugin(new SkillManagerPlugin({ skillsDirs }));
+  }
+
+  // 3. MCP executor
+  if (shouldLoad('mcp')) {
+    const servers = Object.entries(agentConfig.mcpServers || {}).map(([name, cfg]) => ({
+      ...cfg, name, command: cfg.command, args: cfg.args || [], env: cfg.env || {},
+      url: cfg.url, headers: cfg.headers, enabled: cfg.enabled !== false,
+    }));
+    const { MCPExecutorPlugin } = require('../../../src/executors/mcp-executor');
+    await framework.loadPlugin(new MCPExecutorPlugin({ servers }));
+  }
+
+  // 4. Python plugin loader
+  if (shouldLoad('python-plugin-loader')) {
+    const PythonPluginLoader = require('../python-loader');
+    await framework.loadPlugin(new PythonPluginLoader({ agentDir: agentConfig.agentDir }));
+  }
+
+  // 5. SubAgent manager
+  if (shouldLoad('subagent-manager')) {
+    try {
+      const { SubAgentConfigManager } = require('../../../src/agent/sub-config');
+      const subAgentConfigManager = new SubAgentConfigManager(agentConfig.agentsDir);
+      subAgentConfigManager.loadAll();
+      framework._subAgentConfigManager = subAgentConfigManager;
+      const { SubAgentManagerPlugin } = require('../sub-agent');
+      await framework.loadPlugin(new SubAgentManagerPlugin({ agentsDir: agentConfig.agentsDir }));
+    } catch (err) { log.warn('SubAgent Manager failed:', err.message); }
+  }
+
+  // 6. Workflow engine
+  if (shouldLoad('workflow')) {
+    const { WorkflowPlugin } = require('../workflow');
+    await framework.loadPlugin(new WorkflowPlugin({
+      workflowsDir: agentConfig.workflowsDir || '.foliko/workflows',
+    }));
+  }
+
+  // 6.25 Rules engine
+  if (shouldLoad('rules')) {
+    const RulesPlugin = require('../rules');
+    await framework.loadPlugin(new RulesPlugin({
+      rulesDir: agentConfig.rulesDir || '.foliko/rules',
+    }));
+  }
+
+  // 6.5 Data splitter
+  if (shouldLoad('data-splitter')) {
+    const { DataSplitterPlugin } = require('../../executors/data-splitter');
+    await framework.loadPlugin(new DataSplitterPlugin({
+      autoSplitThreshold: agentConfig.dataSplitter?.autoSplitThreshold || 50000,
+      chunkSize: agentConfig.dataSplitter?.chunkSize || 60000,
+      maxConcurrent: agentConfig.dataSplitter?.maxConcurrent || 3,
+    }));
+  }
+
+  // 6.75 Messaging plugins (from plugins/messaging/ subdirectory)
+  const messagingPlugins = ['telegram', 'qq', 'weixin', 'feishu', 'email'];
+  for (const name of messagingPlugins) {
+    if (shouldLoad(name)) {
+      try {
+        const pluginDir = path.resolve(__dirname, '..', '..', '..', 'plugins', 'messaging', name);
+        if (!fs.existsSync(pluginDir)) continue;
+        const PluginClass = require(`../../messaging/${name}`);
+        const pluginConfig = agentConfig[name] || {};
+        await framework.loadPlugin(new PluginClass(pluginConfig));
+      } catch (err) {
+        log.warn(`Messaging plugin '${name}' failed to load:`, err.message);
+      }
+    }
+  }
+
+  // 7. Custom plugins from directories
+  await loadCustomPlugins(framework, agentConfig);
+
+  // 统一启动所有插件
+  await framework.pluginManager.startAll();
+
+  // 退出 bootstrap 模式
+  framework.pluginManager.setBootstrapping(false);
+}
+
+module.exports = {
+  bootstrapDefaults,
+  loadCustomPlugins,
+  resolvePluginPath,
+  scanPluginNames,
+};

package/plugins/core/default/config.js

@@ -0,0 +1,222 @@
+'use strict';
+
+/**
+ * Agent 配置加载器
+ * 检测 .foliko/ 目录下的配置，提供给 bootstrap() 使用
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { logger } = require('../../../src/common/logger');
+const log = logger.child('AgentConfig');
+
+/**
+ * 加载 .foliko 目录下的配置
+ * @returns {Object} 配置对象
+ */
+function loadAgentConfig(framework, agentDir = '.foliko') {
+  if (typeof framework === 'string') {
+    agentDir = framework;
+    framework = null;
+  }
+
+  const fwCwd = framework?.getCwd?.() ?? process.cwd();
+  if (path.isAbsolute(agentDir)) {
+    const rel = path.relative(fwCwd, agentDir);
+    if (rel && !rel.startsWith('..') && !path.isAbsolute(rel)) {
+      agentDir = rel.split(path.sep).join('/');
+    }
+  }
+
+  const config = {
+    agentDir,
+    ai: {},
+    mcpServers: {},
+    plugins: [],
+    skillsDirs: [],
+    agentsDir: null,
+    pluginLinks: {},
+  };
+  const cwd = framework?.getCwd?.() ?? process.cwd();
+  const resolvedDir = path.resolve(cwd, agentDir);
+
+  const agentsDir = path.join(resolvedDir, 'agents');
+  if (fs.existsSync(agentsDir)) config.agentsDir = agentsDir;
+
+  // load .foliko/config
+  const configFile = path.join(resolvedDir, 'config');
+  if (fs.existsSync(configFile)) {
+    try {
+      const lines = fs.readFileSync(configFile, 'utf-8').split('\n');
+      for (const line of lines) {
+        const t = line.trim();
+        if (!t || t.startsWith('#')) continue;
+        const ci = t.indexOf(':');
+        if (ci === -1) continue;
+        const key = t.substring(0, ci).trim();
+        const val = t.substring(ci + 1).trim();
+        if (key === 'ai_key' || key === 'api_key') config.ai.apiKey = val;
+        else if (key === 'ai_model' || key === 'model') config.ai.model = val;
+        else if (key === 'ai_provider' || key === 'provider') config.ai.provider = val;
+        else if (key === 'ai_base_url' || key === 'baseURL') config.ai.baseURL = val;
+        // 目录路径配置（覆盖默认值）
+        else if (key === 'skills_dirs' || key === 'skillsDirs') {
+          config.skillsDirsConfig = val.split(',').map(s => s.trim()).filter(Boolean);
+        } else if (key === 'workflows_dir' || key === 'workflowsDir') {
+          config.workflowsDir = val;
+        } else if (key === 'rules_dir' || key === 'rulesDir') {
+          config.rulesDir = val;
+        } else if (key === 'agents_dir' || key === 'agentsDir') {
+          config.agentsDir = val;
+        }
+      }
+    } catch (err) { log.error('Failed to load config:', err.message); }
+  }
+
+  // load .foliko/ai.json
+  const aiFile = path.join(resolvedDir, 'ai.json');
+  if (fs.existsSync(aiFile)) {
+    try {
+      config.ai = { ...config.ai, ...JSON.parse(fs.readFileSync(aiFile, 'utf-8')) };
+    } catch (err) { log.error('Failed to load ai.json:', err.message); }
+  }
+
+  // load .foliko/plugins.json
+  const pluginsFile = path.join(resolvedDir, 'plugins.json');
+  if (fs.existsSync(pluginsFile)) {
+    try {
+      const pc = JSON.parse(fs.readFileSync(pluginsFile, 'utf-8'));
+      if (pc.telegram) config.telegram = pc.telegram;
+      if (pc.weixin) config.weixin = pc.weixin;
+      if (pc.qq) config.qq = pc.qq;
+      if (pc.feishu) config.feishu = pc.feishu;
+      if (pc.email) config.email = pc.email;
+      if (pc.pluginLinks) config.pluginLinks = pc.pluginLinks;
+    } catch (err) { log.error('Failed to load plugins.json:', err.message); }
+  }
+
+  // load .foliko/weixin.json
+  const weixinFile = path.join(resolvedDir, 'weixin.json');
+  if (fs.existsSync(weixinFile)) {
+    try {
+      config.weixin = { ...config.weixin, ...JSON.parse(fs.readFileSync(weixinFile, 'utf-8')) };
+    } catch (err) { log.error('Failed to load weixin.json:', err.message); }
+  }
+
+  // load .foliko/mcp_config.json
+  const mcpFile = path.join(resolvedDir, 'mcp_config.json');
+  if (fs.existsSync(mcpFile)) {
+    try {
+      config.mcpServers = JSON.parse(fs.readFileSync(mcpFile, 'utf-8')).mcpServers || {};
+    } catch (err) { log.error('Failed to load mcp_config.json:', err.message); }
+  }
+
+  // skills dirs (顺序决定优先级：先加载的优先)
+  // 如果用户在 .foliko/config 配置了 skills_dirs，则用用户配置替换默认值
+  if (config.skillsDirsConfig && config.skillsDirsConfig.length > 0) {
+    config.skillsDirs = [...config.skillsDirsConfig];
+  } else {
+    // 默认路径
+    // 1. ~/.foliko/skills — 用户主目录下的全局技能（最高优先级）
+    // 1b. ~/.foliko/workflows — 用户全局工作流
+    const homeFoliko = path.join(os.homedir(), '.foliko');
+    const homeSkillsDir = path.join(homeFoliko, 'skills');
+    const homeWorkflowsDir = path.join(homeFoliko, 'workflows');
+    if (fs.existsSync(homeFoliko)) {
+      if (!fs.existsSync(homeSkillsDir)) fs.mkdirSync(homeSkillsDir, { recursive: true });
+      config.skillsDirs.push(homeSkillsDir);
+      if (!fs.existsSync(homeWorkflowsDir)) fs.mkdirSync(homeWorkflowsDir, { recursive: true });
+      config.skillsDirs.push(homeWorkflowsDir);
+    }
+
+    // 2. .foliko/skills — 项目级
+    const projectSkillsRel = path.join(agentDir, 'skills');
+    const projectSkillsAbs = path.resolve(cwd, projectSkillsRel);
+    if (fs.existsSync(resolvedDir) && !fs.existsSync(projectSkillsAbs)) {
+      fs.mkdirSync(projectSkillsAbs, { recursive: true });
+    }
+    if (fs.existsSync(projectSkillsAbs)) config.skillsDirs.push(projectSkillsRel);
+
+    // 3. .foliko/workflows/ — 工作流技能
+    const workflowsSkillsRel = path.join(agentDir, 'workflows');
+    const workflowsSkillsAbs = path.resolve(cwd, workflowsSkillsRel);
+    if (fs.existsSync(workflowsSkillsAbs)) config.skillsDirs.push(workflowsSkillsRel);
+
+    // 4. skills — 项目根目录
+    const cmdSkillsRel = 'skills';
+    const cmdSkillsAbs = path.resolve(cwd, cmdSkillsRel);
+    if (fs.existsSync(cmdSkillsAbs)) config.skillsDirs.push(cmdSkillsRel);
+
+    // 5. plugins/core/skills — 内置全局（最低优先级）
+    const rootSkillsDir = path.join(path.dirname(__dirname), 'skills');
+    if (fs.existsSync(rootSkillsDir)) config.skillsDirs.push(rootSkillsDir);
+  }
+
+  // Home dir (~/.foliko/) fallback
+  const homeDir = framework?.getHomeAgentDir?.();
+  const isHomeSame = homeDir && path.resolve(homeDir) === resolvedDir;
+  if (homeDir && fs.existsSync(homeDir) && !isHomeSame) {
+    const hc = path.join(homeDir, 'config');
+    if (!fs.existsSync(path.join(resolvedDir, 'config')) && fs.existsSync(hc)) {
+      try {
+        const lines = fs.readFileSync(hc, 'utf-8').split('\n');
+        for (const ln of lines) {
+          const t = ln.trim();
+          if (!t || t.startsWith('#')) continue;
+          const ci = t.indexOf(':');
+          if (ci === -1) continue;
+          const k = t.substring(0, ci).trim();
+          const v = t.substring(ci + 1).trim();
+          if ((k === 'ai_key' || k === 'api_key') && !config.ai.apiKey) config.ai.apiKey = v;
+          else if ((k === 'ai_model' || k === 'model') && !config.ai.model) config.ai.model = v;
+          else if ((k === 'ai_provider' || k === 'provider') && !config.ai.provider) config.ai.provider = v;
+          else if ((k === 'ai_base_url' || k === 'baseURL') && !config.ai.baseURL) config.ai.baseURL = v;
+        }
+      } catch (err) { log.error('Failed to load home config:', err.message); }
+    }
+
+    const homeAi = path.join(homeDir, 'ai.json');
+    if (!fs.existsSync(path.join(resolvedDir, 'ai.json')) && fs.existsSync(homeAi)) {
+      try { config.ai = { ...JSON.parse(fs.readFileSync(homeAi, 'utf-8')), ...config.ai }; } catch {}
+    }
+
+    const homePlugins = path.join(homeDir, 'plugins.json');
+    if (!fs.existsSync(path.join(resolvedDir, 'plugins.json')) && fs.existsSync(homePlugins)) {
+      try { const pc = JSON.parse(fs.readFileSync(homePlugins, 'utf-8')); if (pc.telegram && !config.telegram) config.telegram = pc.telegram; if (pc.weixin && !config.weixin) config.weixin = pc.weixin; if (pc.qq && !config.qq) config.qq = pc.qq; if (pc.feishu && !config.feishu) config.feishu = pc.feishu; if (pc.email && !config.email) config.email = pc.email; config.pluginLinks = { ...(pc.pluginLinks || {}), ...config.pluginLinks }; } catch {}
+    }
+
+    const homeMcp = path.join(homeDir, 'mcp_config.json');
+    if (!fs.existsSync(path.join(resolvedDir, 'mcp_config.json')) && fs.existsSync(homeMcp)) {
+      try { const m = JSON.parse(fs.readFileSync(homeMcp, 'utf-8')); config.mcpServers = { ...(m.mcpServers || {}), ...config.mcpServers }; } catch {}
+    }
+
+    const homeAgents = path.join(homeDir, 'agents');
+    if (!config.agentsDir && fs.existsSync(homeAgents)) config.agentsDir = homeAgents;
+
+    const homeSkills = path.join(homeDir, 'skills');
+    if (!fs.existsSync(homeSkills)) fs.mkdirSync(homeSkills, { recursive: true });
+    if (fs.existsSync(homeSkills)) {
+      const idx = config.skillsDirs.findIndex(d => d === path.join(resolvedDir, 'skills'));
+      config.skillsDirs.splice(idx >= 0 ? idx + 1 : config.skillsDirs.length, 0, homeSkills);
+    }
+
+    const homePluginsDir = path.join(homeDir, 'plugins');
+    if (fs.existsSync(homePluginsDir)) {
+      for (const entry of fs.readdirSync(homePluginsDir, { withFileTypes: true })) {
+        const name = entry.name.replace(/\.js$/, '');
+        const folderPath = path.join(homePluginsDir, name);
+        const filePath = path.join(homePluginsDir, entry.name);
+        if (entry.isDirectory()) {
+          if (fs.existsSync(path.join(folderPath, 'index.js'))) config.pluginLinks[name] = folderPath;
+        } else if (entry.isFile() && entry.name.endsWith('.js')) {
+          config.pluginLinks[name] = filePath;
+        }
+      }
+    }
+  }
+
+  return config;
+}
+
+module.exports = { loadAgentConfig };

package/plugins/core/default/index.js

@@ -0,0 +1,58 @@
+'use strict';
+
+/**
+ * DefaultPlugins — 默认插件配置加载器
+ * 组合 config.js + bootstrap.js
+ */
+
+const { Plugin } = require('../../../src/plugin/base');
+const { loadAgentConfig } = require('./config');
+const { bootstrapDefaults, loadCustomPlugins, resolvePluginPath, scanPluginNames } = require('./bootstrap');
+
+class DefaultPlugins extends Plugin {
+  constructor(config = {}) {
+    super();
+    this.name = 'defaults';
+    this.version = '1.0.0';
+    this.description = '默认插件配置加载器';
+    this.priority = 0;
+    this.system = true;
+
+    this._framework = null;
+    this._agentDir = config.agentDir || '.foliko';
+    this._config = null;
+  }
+
+  install(framework) {
+    this._framework = framework;
+    return this;
+  }
+
+  start(framework) {
+    this._config = loadAgentConfig(this._framework, this._agentDir);
+    return this;
+  }
+
+  getConfig() {
+    return this._config || loadAgentConfig(this._framework, this._agentDir);
+  }
+
+  reload(framework) {
+    this._framework = framework;
+    this._config = loadAgentConfig(this._framework, this._agentDir);
+  }
+
+  uninstall(framework) {
+    this._framework = null;
+    this._config = null;
+  }
+}
+
+module.exports = {
+  DefaultPlugins,
+  loadAgentConfig,
+  bootstrapDefaults,
+  loadCustomPlugins,
+  resolvePluginPath,
+  scanPluginNames,
+};

package/plugins/core/mcp/index.js

@@ -0,0 +1 @@
+module.exports = require('../../../src/executors/mcp-executor');