@bolloon/bolloon-agent 0.3.8 → 0.3.9

package/dist/web/api-config.html

@@ -34,6 +34,10 @@
         <span class="api-tab-icon">🎵</span>
         <span>音频生成</span>
       </button>
+      <button class="api-tab" data-tab="engines" onclick="switchTab('engines')">
+        <span class="api-tab-icon">🤖</span>
+        <span>外部智能体</span>
+      </button>
     </div>
 
     <!-- LLM 面板 -->
@@ -63,6 +67,16 @@
       </div>
     </div>
 
+    <!-- 外部智能体面板 -->
+    <div class="api-panel" id="panel-engines" data-panel="engines" style="display: none;">
+      <div class="video-intro">
+        <p>Bolloon 自动发现本机已安装的 AI 编码工具（Codex / Claude Code / OpenCode / OpenClaw / Hermes）与实验目录声明的 API。可在此筛选模型并把它们的 API 当作 Bolloon 的供应商一键导入，无需重复填 Key。委派执行请通过对话里的 <code>delegate_to_engine</code> 工具。</p>
+      </div>
+      <div class="provider-list" id="engineList">
+        <div class="loading-state">加载中...</div>
+      </div>
+    </div>
+
     <!-- 配置弹窗 -->
     <div class="modal-overlay" id="configModal" style="display: none;">
       <div class="modal-box">
@@ -186,6 +200,62 @@
     </div>
   </div>
 
+  <!-- 外部智能体 配置弹窗 -->
+  <div class="modal-overlay" id="engineModal" style="display: none;">
+    <div class="modal-box">
+      <div class="modal-header">
+        <div class="modal-title-group">
+          <div class="modal-icon" id="engineModalIcon">A</div>
+          <div>
+            <h2 id="engineModalTitle">配置</h2>
+            <p class="modal-subtitle" id="engineModalSubtitle">描述</p>
+          </div>
+        </div>
+        <button class="modal-close" onclick="closeEngineModal()">×</button>
+      </div>
+
+      <form class="modal-form" id="engineConfigForm">
+        <div class="form-group">
+          <label>映射供应商</label>
+          <select id="engineProviderInput"></select>
+          <p class="form-hint">导入时写进该 Bolloon 供应商 (可覆盖发现的映射)</p>
+        </div>
+
+        <div class="form-group">
+          <label>API Key</label>
+          <input type="password" id="engineApiKeyInput" placeholder="输入 API Key">
+          <p class="form-hint" id="engineApiKeyHint">已有 Key 会保留，输入新值以更新</p>
+        </div>
+
+        <div class="form-group">
+          <label>Base URL</label>
+          <input type="text" id="engineBaseUrlInput" placeholder="https://api.example.com/v1">
+          <p class="form-hint">留空使用默认地址</p>
+        </div>
+
+        <div class="form-group">
+          <label>模型（可筛选）</label>
+          <div class="combobox" id="engineModelCombobox">
+            <input type="text" id="engineModelInput" placeholder="输入关键字筛选模型…" autocomplete="off">
+            <div class="combobox-list" id="engineModelList" style="display: none;"></div>
+          </div>
+          <p class="form-hint" id="engineModelHint">从发现到的候选模型里筛选，或手动输入自定义模型名</p>
+        </div>
+
+        <div class="form-group">
+          <button type="button" class="test-btn" id="engineImportBtn" onclick="importEngine()">
+            ⚡ 导入为供应商
+          </button>
+          <div class="test-result" id="engineImportResult" style="display: none;"></div>
+        </div>
+
+        <div class="form-actions">
+          <button type="button" class="btn-cancel" onclick="closeEngineModal()">取消</button>
+        </div>
+      </form>
+    </div>
+  </div>
+
   <script>
     // 当前 tab
     let currentTab = 'llm';
@@ -194,7 +264,9 @@
     let llmConfigData = null;
     let videoConfigData = null;
     let audioConfigData = null;
+    let engineData = null;
     let currentProvider = null;
+    let currentEngine = null;
     let currentProviderType = 'llm'; // 'llm' | 'video' | 'audio'
 
     // ==================== Tab 切换 ====================
@@ -211,6 +283,13 @@
     }
 
     function updateCountBadge() {
+      if (currentTab === 'engines') {
+        const list = engineData && engineData.engines ? engineData.engines : [];
+        const total = list.length;
+        const available = list.filter(e => e.available).length;
+        document.getElementById('configCount').textContent = available + '/' + total + ' 智能体可用';
+        return;
+      }
       const data = currentTab === 'llm' ? llmConfigData :
                    currentTab === 'video' ? videoConfigData : audioConfigData;
       if (!data) {
@@ -235,7 +314,19 @@
 
     // ==================== 加载 ====================
     async function loadAll() {
-      await Promise.all([loadLLMConfig(), loadVideoConfig(), loadAudioConfig()]);
+      await Promise.all([loadLLMConfig(), loadVideoConfig(), loadAudioConfig(), loadEngines()]);
+    }
+
+    async function loadEngines() {
+      try {
+        const resp = await fetch('/api/external-engines');
+        engineData = await resp.json();
+        renderEngines();
+        if (currentTab === 'engines') updateCountBadge();
+      } catch (err) {
+        const el = document.getElementById('engineList');
+        if (el) el.innerHTML = '<div class="error-state">加载失败: ' + err.message + '</div>';
+      }
     }
 
     async function loadLLMConfig() {
@@ -518,6 +609,164 @@
       }
     };
 
+    // ==================== 外部智能体 渲染 ====================
+    function renderEngines() {
+      const listEl = document.getElementById('engineList');
+      if (!listEl) return;
+      const list = engineData && engineData.engines ? engineData.engines : [];
+      if (list.length === 0) {
+        listEl.innerHTML = '<div class="error-state">未发现本机已安装的外部编码智能体，也未找到实验目录 API（BOLLOON_EXPERIMENT_API_DIR）</div>';
+        return;
+      }
+      let html = '';
+      for (const e of list) {
+        const isExperiment = String(e.id).startsWith('experiment:');
+        let statusText, statusClass;
+        if (e.available) { statusText = '可用'; statusClass = 'status-green'; }
+        else if (e.installed) { statusText = '已装未配'; statusClass = 'status-yellow'; }
+        else if (e.configured) { statusText = '已配未装'; statusClass = 'status-yellow'; }
+        else { statusText = '未发现'; statusClass = 'status-muted'; }
+
+        html += `
+          <div class="provider-card ${e.available ? 'active' : ''}" onclick="openEngineModal('${e.id}')">
+            <div class="provider-header">
+              <div class="provider-icon">${isExperiment ? '🧪' : e.displayName.charAt(0).toUpperCase()}</div>
+              <div class="provider-info">
+                <h3 class="provider-name">${e.displayName}</h3>
+                <p class="provider-desc">${e.id}${e.provider ? ' → ' + e.provider : ''}${e.cliPath ? ' · 已安装' : ''}</p>
+              </div>
+              <div class="status-badge ${statusClass}">
+                <span class="status-dot"></span>
+                ${statusText}
+              </div>
+            </div>
+            <div class="provider-footer">
+              <div class="config-status">
+                <span class="status-icon ${e.configured ? 'configured' : ''}">${e.configured ? '✓' : '○'}</span>
+                ${e.configured ? '已配置 API' : '未配置 API'}
+              </div>
+              ${e.model ? '<div class="model-info">模型: ' + e.model + '</div>' : ''}
+              ${e.models && e.models.length ? '<div class="model-info">候选模型: ' + e.models.length + ' 个（可筛选）</div>' : ''}
+              <div class="arrow-indicator">›</div>
+            </div>
+          </div>
+        `;
+      }
+      listEl.innerHTML = html;
+    }
+
+    // ==================== 外部智能体 配置弹窗 ====================
+    const ENGINE_PROVIDER_FALLBACK = ['openai','anthropic','ollama','openrouter','gemini','minimax','deepseek','kimi','glm','qwen','mimo','local'];
+
+    function openEngineModal(id) {
+      const list = engineData && engineData.engines ? engineData.engines : [];
+      const e = list.find(x => x.id === id);
+      if (!e) return;
+      currentEngine = e;
+
+      document.getElementById('engineModalIcon').textContent = String(e.displayName).charAt(0).toUpperCase();
+      document.getElementById('engineModalTitle').textContent = '配置 ' + e.displayName;
+      document.getElementById('engineModalSubtitle').textContent = (e.notes || '') + (e.configPath ? ' · 配置: ' + e.configPath : '');
+
+      // 映射供应商 select
+      const provSel = document.getElementById('engineProviderInput');
+      const provKeys = (llmConfigData && llmConfigData.providers) ? Object.keys(llmConfigData.providers) : ENGINE_PROVIDER_FALLBACK;
+      const mapped = e.provider || 'openai';
+      provSel.innerHTML = provKeys.map(k => `<option value="${k}" ${k === mapped ? 'selected' : ''}>${k}</option>`).join('');
+
+      document.getElementById('engineApiKeyInput').value = '';
+      document.getElementById('engineApiKeyHint').textContent = e.apiKey
+        ? '当前已发现 (***' + (e.apiKey.slice(-4) || '') + ')，输入新值以更新'
+        : '输入 API Key';
+      document.getElementById('engineBaseUrlInput').value = e.baseUrl || '';
+      document.getElementById('engineModelInput').value = e.model || '';
+      document.getElementById('engineModelHint').textContent = (e.models && e.models.length)
+        ? '从 ' + e.models.length + ' 个候选模型里筛选，或手动输入'
+        : '手动输入模型名';
+
+      document.getElementById('engineImportResult').style.display = 'none';
+      document.getElementById('engineModal').style.display = 'flex';
+      // 准备模型筛选下拉
+      renderEngineModelList('');
+      setTimeout(() => document.getElementById('engineModelInput').focus(), 50);
+    }
+
+    function closeEngineModal() {
+      document.getElementById('engineModal').style.display = 'none';
+      currentEngine = null;
+      document.getElementById('engineModelList').style.display = 'none';
+    }
+
+    // 模型筛选下拉
+    function renderEngineModelList(filter) {
+      const listEl = document.getElementById('engineModelList');
+      if (!currentEngine || !currentEngine.models) { listEl.style.display = 'none'; return; }
+      const f = (filter || '').toLowerCase();
+      const matched = currentEngine.models.filter(m => m.toLowerCase().includes(f));
+      if (matched.length === 0) { listEl.style.display = 'none'; return; }
+      listEl.innerHTML = matched.map(m => `<div class="combobox-option" onclick="selectEngineModel('${m.replace(/'/g, "\\'")}')">${m}</div>`).join('');
+      listEl.style.display = 'block';
+    }
+
+    function selectEngineModel(model) {
+      document.getElementById('engineModelInput').value = model;
+      document.getElementById('engineModelList').style.display = 'none';
+    }
+
+    document.getElementById('engineModelInput').addEventListener('input', (ev) => {
+      renderEngineModelList(ev.target.value);
+    });
+    document.getElementById('engineModelInput').addEventListener('focus', (ev) => {
+      renderEngineModelList(ev.target.value);
+    });
+    // 点击空白关闭下拉
+    document.addEventListener('click', (ev) => {
+      const cb = document.getElementById('engineModelCombobox');
+      if (cb && !cb.contains(ev.target)) {
+        document.getElementById('engineModelList').style.display = 'none';
+      }
+    });
+    document.getElementById('engineModal').addEventListener('click', (ev) => {
+      if (ev.target === document.getElementById('engineModal')) closeEngineModal();
+    });
+
+    async function importEngine() {
+      if (!currentEngine) return;
+      const btn = document.getElementById('engineImportBtn');
+      const result = document.getElementById('engineImportResult');
+      btn.disabled = true;
+      requestAnimationFrame(() => { btn.textContent = '⚡ 导入中...'; });
+      result.style.display = 'none';
+
+      const body = {
+        id: currentEngine.id,
+        model: document.getElementById('engineModelInput').value.trim(),
+        provider: document.getElementById('engineProviderInput').value,
+      };
+
+      try {
+        const resp = await fetch('/api/external-engines/import', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify(body),
+        });
+        const data = await resp.json();
+        if (!resp.ok) throw new Error(data.error || '导入失败');
+        result.className = 'test-result test-success';
+        result.innerHTML = '<span>✓</span> 已导入为供应商: ' + (data.provider || '') +
+          (data.autoActivated ? '（已激活）' : '') + '，可在「LLM 对话」tab 选用';
+        result.style.display = 'flex';
+        // 刷新 LLM 配置 + 引擎列表
+        await Promise.all([loadLLMConfig(), loadEngines()]);
+      } catch (err) {
+        result.className = 'test-result test-error';
+        result.innerHTML = '<span>✗</span> ' + (err.message || '导入失败');
+        result.style.display = 'flex';
+      }
+      btn.disabled = false;
+      requestAnimationFrame(() => { btn.textContent = '⚡ 导入为供应商'; });
+    }
+
     // ==================== 关闭弹窗 ====================
     document.getElementById('configModal').onclick = function(e) {
       if (e.target === this) closeModal();

package/dist/web/routes-external-engines.js

@@ -0,0 +1,111 @@
+/**
+ * routes-external-engines.ts — 外部编码智能体 配置/委派 路由
+ *
+ * 三个能力:
+ *   GET  /api/external-engines          发现本机已装的引擎 (脱敏)
+ *   POST /api/external-engines/import   把发现的引擎 API 写进 Bolloon provider 体系 (当供应商)
+ *   POST /api/external-engines/run      委派编码任务给引擎 CLI (子智能体)
+ *
+ * 复用 routes-llm-config.ts 的 llmConfigStore + initMinimax 做激活.
+ */
+import { discoverEngines, mapEngineToProviderConfig, resolveProvider } from '../external-engines/index.js';
+import { llmConfigStore } from '../llm/config-store.js';
+import { initMinimax } from '../constraints/index.js';
+function maskKey(key) {
+    if (!key)
+        return '';
+    if (key.length <= 4)
+        return '***';
+    return '***' + key.slice(-4);
+}
+export function registerExternalEngineRoutes(app) {
+    // ==================== 发现 ====================
+    app.get('/api/external-engines', async (_req, res) => {
+        try {
+            const engines = await discoverEngines();
+            const safe = engines.map((e) => ({
+                ...e,
+                apiKey: maskKey(e.apiKey),
+            }));
+            res.json({ engines: safe });
+        }
+        catch (err) {
+            res.status(500).json({ error: err?.message || String(err) });
+        }
+    });
+    // ==================== 导入为供应商 ====================
+    app.post('/api/external-engines/import', async (req, res) => {
+        try {
+            const { id, model, provider: providerOverride } = req.body || {};
+            if (!id)
+                return res.status(400).json({ error: 'id 必填' });
+            const engines = await discoverEngines();
+            const engine = engines.find((e) => e.id === id);
+            if (!engine)
+                return res.status(404).json({ error: `未发现的引擎: ${id}` });
+            if (!engine.configured) {
+                return res.status(400).json({ error: `引擎 ${id} 未配置 API key / baseUrl, 无法导入为供应商` });
+            }
+            // 允许前端在导入时覆盖 model / provider (API 配置 UI 里用户筛选模型后传来)
+            if (model && typeof model === 'string' && model.trim()) {
+                engine.model = model.trim();
+            }
+            if (providerOverride && typeof providerOverride === 'string' && providerOverride.trim()) {
+                const resolved = resolveProvider(providerOverride.trim(), engine.provider || 'openai');
+                engine.provider = resolved;
+            }
+            let importPatch;
+            try {
+                importPatch = mapEngineToProviderConfig(engine);
+            }
+            catch (e) {
+                return res.status(400).json({ error: e.message });
+            }
+            const { provider, patch } = importPatch;
+            await llmConfigStore.updateProvider(provider, patch);
+            // 导入即激活 (若提供了有效 key, 或不需要 key 的 provider)
+            const shouldActivate = !!patch.apiKey || !engine.apiKey;
+            let autoActivated = false;
+            if (shouldActivate) {
+                try {
+                    await llmConfigStore.setActiveProvider(provider);
+                    initMinimax({
+                        provider: provider,
+                        apiKey: patch.apiKey || undefined,
+                        baseUrl: patch.baseUrl || undefined,
+                        model: patch.model || undefined,
+                    });
+                    autoActivated = true;
+                }
+                catch (e) {
+                    // 激活失败不阻断导入 (可能该 provider 仍需别的字段)
+                    console.warn('[external-engines] 激活失败:', e?.message);
+                }
+            }
+            res.json({ ok: true, provider, autoActivated, imported: { ...patch, apiKey: maskKey(patch.apiKey) } });
+        }
+        catch (err) {
+            res.status(500).json({ error: err?.message || String(err) });
+        }
+    });
+    // ==================== 委派执行 ====================
+    app.post('/api/external-engines/run', async (req, res) => {
+        try {
+            const { id, prompt, cwd, model } = req.body || {};
+            if (!id)
+                return res.status(400).json({ error: 'id 必填' });
+            if (!prompt)
+                return res.status(400).json({ error: 'prompt 必填' });
+            // 动态 import 避免顶层循环依赖 (delegate -> discovery, 这里反向)
+            const { delegateToEngine } = await import('../external-engines/delegate.js');
+            const result = await delegateToEngine(id, prompt, {
+                cwd,
+                ...(model ? { model: String(model) } : {}),
+            });
+            res.json(result);
+        }
+        catch (err) {
+            res.status(500).json({ error: err?.message || String(err) });
+        }
+    });
+}

package/dist/web/server.js

@@ -12,6 +12,7 @@ import { segmentChatReply } from '../agents/chat-segmenter.js';
 import { listTools } from '../llm/tool-manifest/index.js';
 import { registerJudgmentsRoutes } from './routes-judgments.js';
 import { registerLlmConfigRoutes } from './routes-llm-config.js';
+import { registerExternalEngineRoutes } from './routes-external-engines.js';
 import { registerTaskRoutes } from './routes-tasks.js';
 import { registerHearthRoutes } from './routes-hearth.js';
 // 2026-07-06: 类型抽到 ./server-types.ts (channel / session / task / sse client / iroh info / paths)
@@ -3929,6 +3930,9 @@ ${goalDesc}
     registerTaskRoutes(app, { broadcast, getAgentForChannel });
     // 2026-07-06: LLM/Video/Audio 配置路由抽到 ./routes-llm-config.ts
     registerLlmConfigRoutes(app);
+    // 2026-07-22: 外部编码智能体 (codex/claude-code/opencode/openclaw/hermes/实验 API)
+    // 发现 + 配置为供应商 + 委派
+    registerExternalEngineRoutes(app);
     // ==================== P2P Network API ====================
     // 获取当前身份
     app.get('/api/identity', async (_req, res) => {

package/dist/web/style.css

@@ -2820,6 +2820,37 @@ body {
   margin-top: 6px;
 }
 
+/* 模型筛选下拉 (外部智能体配置弹窗) */
+.combobox {
+  position: relative;
+}
+.combobox-list {
+  position: absolute;
+  top: calc(100% + 4px);
+  left: 0;
+  right: 0;
+  max-height: 240px;
+  overflow-y: auto;
+  background: var(--bg-elevated, var(--bg));
+  border: 1px solid var(--border);
+  border-radius: var(--radius-sm);
+  z-index: 50;
+  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.35);
+}
+.combobox-option {
+  padding: 9px 14px;
+  font-size: 13px;
+  color: var(--text);
+  cursor: pointer;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.combobox-option:hover {
+  background: var(--accent);
+  color: #fff;
+}
+
 .form-row {
   display: flex;
   gap: 12px;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bolloon/bolloon-agent",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "type": "module",
   "description": "P2P AI Document Agent - 全局安装后执行 `bolloon` 启动产品",
   "main": "dist/cli-entry.js",