@baize-ai/core 0.2.0 → 0.3.0

package/skills/web-console/public/app.js

@@ -1382,14 +1382,875 @@ async function installChannelFromCatalogue(btn) {
   }
 }
 
+// ── A2A (Agent-to-Agent) view ───────────────────────────────────────────────
+
+function renderA2a(basePath) {
+  _globalBasePath = basePath;
+  setAdminMsg('');
+  loadA2aStatus(basePath);
+  loadAgentCard(basePath);
+  loadA2aAuthz(basePath);
+  loadA2aPeers(basePath);
+  loadA2aTasks(basePath);
+  loadA2aMessages(basePath);
+}
+
+function a2aCliUnavailable(body) {
+  return /未找到 baize-a2a CLI/.test(body.error || '');
+}
+
+async function loadA2aStatus(basePath) {
+  const el = document.getElementById('a2a-status');
+  const state = document.getElementById('a2a-status-state');
+  if (!el) return;
+  let body;
+  try {
+    const r = await adminFetch(basePath, '/api/admin/a2a/status');
+    if (r.status !== 200) {
+      const e = new Error(r.body?.error || '状态加载失败');
+      e.__body = r.body || null; // keep the server's resolved mode for the fresh-install card
+      throw e;
+    }
+    body = r.body;
+  } catch (err) {
+    // Fresh install: the CLI may be missing (status 400) — the server still
+    // resolves mode='standalone', so surface the mode card as 单机 (with the
+    // upload entry) instead of an opaque "状态不可用".
+    const fallback = (err && err.__body && err.__body.mode) ? err.__body : null;
+    _lastA2aStatus = null;
+    updateA2aInstallArea(null);
+    if (fallback) updateA2aModeCard({ mode: fallback.mode, daemonHealthy: false });
+    else updateA2aModeCard(null);
+    updateA2aHealth(null);
+    el.innerHTML = `<p class="cred-state">状态加载失败：${escapeHtml(err.message)}</p>`;
+    return;
+  }
+  _lastA2aStatus = body;
+  const enabled = body.enabled === true || String(body.enabled) === 'true';
+  if (state) {
+    state.textContent = enabled ? '已启用' : '未启用';
+    state.className = `channel-state ${enabled ? 'ok' : 'warn'}`;
+  }
+  const rows = [
+    ['启用', enabled ? '是' : '否'],
+    ['Agent ID', body.agentId],
+    ['已注册', body.registered === true ? '是' : (body.registered === false ? '否' : body.registered)],
+    ['注册状态', body.registrationStatus],
+    ['宣告地址', body.advertiseUrl],
+    ['Endpoint', body.endpoint],
+    ['版本', body.version],
+  ].filter(([, v]) => v !== undefined && v !== null && v !== '');
+  el.innerHTML = rows.map(([k, v]) => `<div class="conn-summary-row"><span class="conn-summary-name">${escapeHtml(k)}</span><span class="conn-summary-detail">${escapeHtml(String(v))}</span></div>`).join('');
+  updateA2aInstallArea(body);
+  updateA2aModeCard(body);
+  updateA2aConfigArea(body);
+  updateA2aHealth(body);
+}
+
+// ── D25 U3: module install / mode card / config / health ───────
+
+// 最近一次 status / peers 数据，供健康卡跨渲染刷新 peer 数
+let _lastA2aStatus = null;
+let _lastA2aPeerCount = null;
+
+function a2aModeInfo(body) {
+  const mode = body && body.mode === 'cluster' ? 'cluster' : 'standalone';
+  const healthy = !!(body && body.daemonHealthy === true);
+  if (mode === 'cluster') {
+    return {
+      mode,
+      label: healthy ? '集群·在线' : '集群·故障',
+      cls: healthy ? 'a2a-mode-badge ok' : 'a2a-mode-badge err',
+      detail: healthy ? '已加入集群，daemon 健康' : 'daemon 异常，集群服务不可用',
+      stateText: healthy ? '集群·在线' : '集群·故障',
+    };
+  }
+  return {
+    mode,
+    label: '单机',
+    cls: 'a2a-mode-badge',
+    detail: '仅本机运行，未加入集群',
+    stateText: '单机',
+  };
+}
+
+function updateA2aInstallArea(body) {
+  const el = document.getElementById('a2a-install-status');
+  const state = document.getElementById('a2a-install-state');
+  const fileInput = document.getElementById('a2a-install-file');
+  const btn = document.getElementById('btn-a2a-install');
+  if (!el || !fileInput || !btn) return;
+  const version = body && (body.version || body.installedVersion);
+  if (version) {
+    el.textContent = `已安装 baize-a2a v${String(version).replace(/^v/, '')}。如需升级请重新上传模块包。`;
+    if (state) { state.textContent = '已安装'; state.className = 'channel-state ok'; }
+    fileInput.disabled = true;
+    btn.disabled = true;
+  } else {
+    el.textContent = '未安装 — 上传 baize-a2a 模块包（.tgz）完成安装。';
+    if (state) { state.textContent = '未安装'; state.className = 'channel-state warn'; }
+    fileInput.disabled = false;
+    btn.disabled = false;
+  }
+}
+
+function updateA2aModeCard(body) {
+  const badgeEl = document.getElementById('a2a-mode-badge');
+  const btn = document.getElementById('btn-a2a-switch-mode');
+  const state = document.getElementById('a2a-mode-state');
+  if (!badgeEl || !btn) return;
+  if (!body || body.error) {
+    badgeEl.innerHTML = '<span class="a2a-mode-badge">状态不可用</span> <span class="a2a-mode-detail">无法获取运行模式（daemon 未运行或未安装）</span>';
+    if (state) { state.textContent = '不可用'; state.className = 'channel-state warn'; }
+    btn.textContent = '切换集群模式';
+    btn.dataset.targetMode = 'cluster';
+    btn.disabled = true;
+    return;
+  }
+  const info = a2aModeInfo(body);
+  badgeEl.innerHTML = `<span class="${info.cls}">${info.label}</span> <span class="a2a-mode-detail">${info.detail}</span>`;
+  if (state) { state.textContent = info.stateText; state.className = 'channel-state'; }
+  btn.textContent = info.mode === 'cluster' ? '切换单机模式' : '切换集群模式';
+  btn.dataset.targetMode = info.mode === 'cluster' ? 'standalone' : 'cluster';
+  btn.disabled = false;
+}
+
+function updateA2aConfigArea(body) {
+  const adminInput = document.getElementById('a2a-config-admin-url');
+  const advertiseInput = document.getElementById('a2a-config-advertise-url');
+  if (!adminInput || !advertiseInput) return;
+  if (!adminInput.value && body && body.adminUrl) adminInput.value = body.adminUrl;
+  if (!advertiseInput.value && body && body.advertiseUrl) advertiseInput.value = body.advertiseUrl;
+}
+
+function a2aHeartbeatLabel(body) {
+  if (!body) return '—';
+  const direct = body.heartbeat ?? body.lastHeartbeat ?? body.heartbeatAt;
+  if (direct !== undefined && direct !== null && direct !== '') return String(direct);
+  // 未暴露心跳时间戳时，用注册态作为心跳健康代理（registered = JWT 有效，daemon 仍在心跳续期）
+  return body.registered === true ? '正常（注册有效）' : (body.registrationStatus || '—');
+}
+
+function updateA2aHealth(body, peerCountOverride) {
+  const el = document.getElementById('a2a-health');
+  const state = document.getElementById('a2a-health-state');
+  if (!el) return;
+  const healthy = !!(body && body.daemonHealthy === true);
+  const modeLabel = body && body.mode === 'cluster' ? '集群' : '单机';
+  let peerCount = '—';
+  if (peerCountOverride !== undefined && peerCountOverride !== null) {
+    peerCount = peerCountOverride;
+  } else if (body) {
+    peerCount = body.peerCount ?? (Array.isArray(body.peers) ? body.peers.length : null) ?? (_lastA2aPeerCount ?? '—');
+  } else if (_lastA2aPeerCount !== null) {
+    peerCount = _lastA2aPeerCount;
+  }
+  const rows = [
+    ['Daemon 健康', healthy ? '✅ 正常' : '❌ 异常'],
+    ['运行模式', modeLabel],
+    ['Peer 数', peerCount],
+    ['最近心跳', a2aHeartbeatLabel(body)],
+  ].filter(([, v]) => v !== undefined && v !== null && v !== '');
+  el.innerHTML = rows.map(([k, v]) => `<div class="conn-summary-row"><span class="conn-summary-name">${escapeHtml(k)}</span><span class="conn-summary-detail">${escapeHtml(String(v))}</span></div>`).join('');
+  if (state) {
+    state.textContent = healthy ? '健康' : '异常';
+    state.className = `channel-state ${healthy ? 'ok' : 'warn'}`;
+  }
+}
+
+// ── Agent card (D21: name/description/skills self-service) ───────────────────
+
+async function loadAgentCard(basePath) {
+  const el = document.getElementById('a2a-card');
+  const state = document.getElementById('a2a-card-state');
+  if (!el) return;
+  let body;
+  try {
+    const { status, body: b } = await adminFetch(basePath, '/api/admin/a2a/card');
+    if (status !== 200) throw new Error(b.error || '名片加载失败');
+    body = b;
+  } catch (err) {
+    el.innerHTML = `<p class="cred-state">名片加载失败：${escapeHtml(err.message)}</p>`;
+    return;
+  }
+  const skills = Array.isArray(body.skills) ? body.skills : [];
+  if (state) state.textContent = skills.length ? `${skills.length} 个 skills` : '无 skills';
+  const skillLines = skills.length
+    ? skills.map((s) => `  · ${escapeHtml(s && (s.id || s.name))}`).join('<br>')
+    : '<span class="cred-state">（未配置 — 点击「编辑名片」从已安装 skills 中选择）</span>';
+  el.innerHTML = `<div class="conn-summary-row"><span class="conn-summary-name">名称</span><span class="conn-summary-detail">${escapeHtml(body.name || '')}</span></div>`
+    + `<div class="conn-summary-row"><span class="conn-summary-name">描述</span><span class="conn-summary-detail">${escapeHtml(body.description || '')}</span></div>`
+    + `<div class="conn-summary-row"><span class="conn-summary-name">Skills</span><span class="conn-summary-detail">${skillLines}</span></div>`;
+}
+
+// ── Call authorization (D22 单元 C) ──────────────────────────────────────────
+
+async function loadA2aAuthz(basePath) {
+  const el = document.getElementById('a2a-authz');
+  const state = document.getElementById('a2a-authz-state');
+  if (!el) return;
+  let body;
+  try {
+    const { status, body: b } = await adminFetch(basePath, '/api/admin/a2a/authz');
+    if (status !== 200) throw new Error(b.error || '授权策略加载失败');
+    body = b;
+  } catch (err) {
+    el.innerHTML = `<p class="cred-state">授权策略加载失败：${escapeHtml(err.message)}</p>`;
+    return;
+  }
+  const isAllowlist = body.mode === 'allowlist';
+  const modeName = isAllowlist ? '白名单' : '开放';
+  const listName = isAllowlist ? '允许' : '阻止';
+  const items = Array.isArray(isAllowlist ? body.allow : body.block) ? (isAllowlist ? body.allow : body.block) : [];
+  if (state) state.textContent = items.length ? `${listName} ${items.length} 个` : '未设置';
+  const lines = items.length
+    ? items.map((id) => `  · ${escapeHtml(id)}`).join('<br>')
+    : '<span class="cred-state">未设置 — 点击「编辑名片」→「调用授权」配置</span>';
+  el.innerHTML = `<div class="conn-summary-row"><span class="conn-summary-name">模式</span><span class="conn-summary-detail">${modeName}</span></div>`
+    + `<div class="conn-summary-row"><span class="conn-summary-name">${listName}列表</span><span class="conn-summary-detail">${lines}</span></div>`;
+}
+
+/**
+ * Open the agent-card editor modal: name + description + skills multi-selector.
+ * Available for use whether or not A2A is enabled (initializes card basics).
+ */
+async function openAgentCardEditor(basePath) {
+  const existing = document.getElementById('agent-card-modal');
+  if (existing) existing.remove();
+
+  let catalogue;
+  let card;
+  let authz;
+  let peerIds;
+  try {
+    const [catRes, cardRes, authzRes, peersRes] = await Promise.all([
+      adminFetch(basePath, '/api/admin/a2a/card/skills'),
+      adminFetch(basePath, '/api/admin/a2a/card'),
+      adminFetch(basePath, '/api/admin/a2a/authz'),
+      adminFetch(basePath, '/api/admin/a2a/peers'),
+    ]);
+    if (catRes.status !== 200) throw new Error(catRes.body.error || 'skills 列表加载失败');
+    if (cardRes.status !== 200) throw new Error(cardRes.body.error || '名片加载失败');
+    if (authzRes.status !== 200) throw new Error(authzRes.body.error || '授权策略加载失败');
+    catalogue = catRes.body.skills || [];
+    card = cardRes.body;
+    authz = authzRes.body;
+    peerIds = peersRes.status === 200 && Array.isArray(peersRes.body.peers)
+      ? peersRes.body.peers.map((p) => p.agentId).filter(Boolean)
+      : [];
+  } catch (err) {
+    setAdminMsg(`❌ 无法打开名片编辑器：${err.message}`, true);
+    return;
+  }
+
+  const selected = new Set((card.skills || []).map((s) => (typeof s === 'string' ? s : (s && s.id))).filter(Boolean));
+
+  const overlay = document.createElement('div');
+  overlay.id = 'agent-card-modal';
+  overlay.className = 'agent-card-modal-overlay';
+  overlay.innerHTML = `
+    <div class="agent-card-modal" role="dialog" aria-modal="true" aria-label="编辑名片">
+      <div class="agent-card-modal-head">
+        <div class="card-title">编辑名片</div>
+        <button type="button" class="agent-card-modal-close" aria-label="关闭">×</button>
+      </div>
+      <div class="agent-card-modal-tabs" role="tablist" aria-label="编辑内容">
+        <button type="button" class="agent-card-tab active" role="tab" aria-selected="true" data-tab="card">名片信息</button>
+        <button type="button" class="agent-card-tab" role="tab" aria-selected="false" data-tab="authz">调用授权</button>
+      </div>
+      <div class="agent-card-modal-body">
+        <div id="agent-card-tab-card">
+          <label class="agent-card-field-label" for="agent-card-name">名称（必填，≤60 字符）</label>
+          <input type="text" id="agent-card-name" class="agent-card-input" maxlength="60" autocomplete="off" spellcheck="false">
+          <label class="agent-card-field-label" for="agent-card-desc">描述（≤300 字符）</label>
+          <textarea id="agent-card-desc" class="agent-card-input agent-card-textarea" rows="3" maxlength="300" placeholder="一句话介绍你的 agent"></textarea>
+          <div class="agent-card-field-label">Skills <span class="agent-card-selected-count" id="agent-card-count">已选 0 个</span></div>
+          <input type="text" id="agent-card-search" class="agent-card-input" placeholder="搜索 skill（名称 / 描述 / 目录名）" autocomplete="off" spellcheck="false">
+          <div class="agent-card-skill-list" id="agent-card-skills" role="list" aria-live="polite"></div>
+        </div>
+        <div id="agent-card-tab-authz" hidden>
+          <div class="agent-card-field-label">模式</div>
+          <div class="authz-mode-row">
+            <label class="authz-mode-option"><input type="radio" name="authz-mode" value="open"> 开放（默认）</label>
+            <label class="authz-mode-option"><input type="radio" name="authz-mode" value="allowlist"> 白名单</label>
+          </div>
+          <p class="conn-block-desc" id="authz-mode-desc"></p>
+          <div class="agent-card-field-label"><span id="authz-list-title">阻止列表</span> <span class="agent-card-selected-count" id="authz-count"></span></div>
+          <div class="authz-tags" id="authz-tags" aria-live="polite"></div>
+          <div class="authz-add-row">
+            <input type="text" id="authz-peer-input" class="agent-card-input" placeholder="输入 peer agent_id 后添加" autocomplete="off" spellcheck="false">
+            <button type="button" class="btn btn-outline" id="authz-peer-add">添加</button>
+          </div>
+          <div class="agent-card-field-label">从 peer 列表选择</div>
+          <select id="authz-peer-select" class="agent-card-input" aria-label="从 peer 列表选择"></select>
+        </div>
+      </div>
+      <div class="agent-card-modal-foot">
+        <button type="button" class="btn btn-outline" id="agent-card-cancel">取消</button>
+        <button type="button" class="btn btn-primary" id="agent-card-save">保存</button>
+      </div>
+    </div>
+  `;
+  document.body.appendChild(overlay);
+
+  const nameInput = overlay.querySelector('#agent-card-name');
+  const descInput = overlay.querySelector('#agent-card-desc');
+  const searchInput = overlay.querySelector('#agent-card-search');
+  const listEl = overlay.querySelector('#agent-card-skills');
+  const countEl = overlay.querySelector('#agent-card-count');
+  nameInput.value = card.name || '';
+  descInput.value = card.description || '';
+
+  // ── 调用授权 tab state (D22 单元 C) ──
+  const allowSet = new Set(Array.isArray(authz.allow) ? authz.allow : []);
+  const blockSet = new Set(Array.isArray(authz.block) ? authz.block : []);
+  let authzMode = authz.mode === 'allowlist' ? 'allowlist' : 'open';
+  const activeAuthzList = () => (authzMode === 'allowlist' ? allowSet : blockSet);
+
+  const authzModeDesc = overlay.querySelector('#authz-mode-desc');
+  const authzListTitle = overlay.querySelector('#authz-list-title');
+  const authzCount = overlay.querySelector('#authz-count');
+  const authzTagsEl = overlay.querySelector('#authz-tags');
+  const authzPeerInput = overlay.querySelector('#authz-peer-input');
+  const authzPeerSelect = overlay.querySelector('#authz-peer-select');
+
+  const renderAuthz = () => {
+    overlay.querySelectorAll('input[name="authz-mode"]').forEach((r) => {
+      r.checked = r.value === authzMode;
+    });
+    const isAllowlist = authzMode === 'allowlist';
+    authzModeDesc.textContent = isAllowlist
+      ? '仅允许列表中的 agent 可以调用本 agent（空列表 = 无人可调用）。'
+      : '接受所有已批准 agent，除阻止列表中的 agent。';
+    authzListTitle.textContent = isAllowlist ? '允许列表' : '阻止列表';
+    const list = [...activeAuthzList()];
+    authzCount.textContent = `${list.length} 个`;
+    authzTagsEl.innerHTML = list.length
+      ? list.map((id) => `<span class="authz-tag">${escapeHtml(id)}<button type="button" class="authz-tag-x" aria-label="移除 ${escapeHtml(id)}" data-id="${escapeHtml(id)}">×</button></span>`).join('')
+      : '<span class="cred-state">（空）</span>';
+    const current = new Set(activeAuthzList());
+    const available = peerIds.filter((id) => !current.has(id));
+    authzPeerSelect.innerHTML = `<option value="">${available.length ? '选择 peer 添加到列表…' : '列表已包含所有已知 peer'}</option>`
+      + available.map((id) => `<option value="${escapeHtml(id)}">${escapeHtml(id)}</option>`).join('');
+    authzPeerSelect.disabled = available.length === 0;
+  };
+
+  overlay.querySelectorAll('input[name="authz-mode"]').forEach((r) => {
+    r.addEventListener('change', () => {
+      if (r.checked) {
+        authzMode = r.value;
+        renderAuthz();
+      }
+    });
+  });
+
+  const addAuthzPeer = () => {
+    const value = authzPeerInput.value.trim();
+    if (!value) {
+      setAdminMsg('请输入 peer agent_id', true);
+      return;
+    }
+    const list = activeAuthzList();
+    if (list.has(value)) {
+      setAdminMsg(`⚠️ ${value} 已在${authzMode === 'allowlist' ? '允许' : '阻止'}列表中`, true);
+      return;
+    }
+    list.add(value);
+    authzPeerInput.value = '';
+    renderAuthz();
+  };
+  authzPeerInput.addEventListener('keydown', (e) => {
+    if (e.key === 'Enter') {
+      e.preventDefault();
+      addAuthzPeer();
+    }
+  });
+  overlay.querySelector('#authz-peer-add').addEventListener('click', addAuthzPeer);
+  authzPeerSelect.addEventListener('change', () => {
+    const value = authzPeerSelect.value;
+    if (!value) return;
+    activeAuthzList().add(value);
+    renderAuthz();
+  });
+  authzTagsEl.addEventListener('click', (e) => {
+    const btn = e.target.closest('.authz-tag-x');
+    if (btn) {
+      activeAuthzList().delete(btn.dataset.id);
+      renderAuthz();
+    }
+  });
+
+  // ── Tab switching ──
+  const tabButtons = overlay.querySelectorAll('.agent-card-tab');
+  const cardTabEl = overlay.querySelector('#agent-card-tab-card');
+  const authzTabEl = overlay.querySelector('#agent-card-tab-authz');
+  const switchTab = (name) => {
+    const isCard = name === 'card';
+    cardTabEl.hidden = !isCard;
+    authzTabEl.hidden = isCard;
+    tabButtons.forEach((b) => {
+      const active = b.dataset.tab === name;
+      b.classList.toggle('active', active);
+      b.setAttribute('aria-selected', active ? 'true' : 'false');
+    });
+  };
+  tabButtons.forEach((b) => b.addEventListener('click', () => switchTab(b.dataset.tab)));
+
+  const updateCount = () => {
+    countEl.textContent = `已选 ${selected.size} 个`;
+  };
+
+  const renderSkills = () => {
+    const q = searchInput.value.trim().toLowerCase();
+    const filtered = catalogue.filter((s) => {
+      if (!q) return true;
+      return [s.name, s.description, s.id].some((v) => String(v || '').toLowerCase().includes(q));
+    });
+    if (!filtered.length) {
+      listEl.innerHTML = '<p class="cred-state">没有匹配的 skill。</p>';
+      return;
+    }
+    listEl.innerHTML = filtered.map((s) => {
+      const isSelected = selected.has(s.id);
+      return `<div class="agent-card-skill-row ${isSelected ? 'selected' : ''}" role="listitem" data-id="${escapeHtml(s.id)}" tabindex="0" aria-pressed="${isSelected}">
+        <div class="agent-card-skill-main">
+          <div class="agent-card-skill-title"><strong>${escapeHtml(s.name)}</strong> <span class="agent-card-skill-id">${escapeHtml(s.id)}</span></div>
+          <p class="conn-block-desc">${escapeHtml(s.description || '')}</p>
+        </div>
+        <span class="agent-card-skill-check">${isSelected ? '✓' : ''}</span>
+      </div>`;
+    }).join('');
+    updateCount();
+  };
+
+  const toggleSkill = (id) => {
+    if (selected.has(id)) selected.delete(id);
+    else selected.add(id);
+    renderSkills();
+  };
+
+  listEl.addEventListener('click', (e) => {
+    const row = e.target.closest('.agent-card-skill-row');
+    if (row) toggleSkill(row.dataset.id);
+  });
+  listEl.addEventListener('keydown', (e) => {
+    if (e.key === 'Enter' || e.key === ' ') {
+      const row = e.target.closest('.agent-card-skill-row');
+      if (row) {
+        e.preventDefault();
+        toggleSkill(row.dataset.id);
+      }
+    }
+  });
+  searchInput.addEventListener('input', renderSkills);
+
+  const closeModal = () => {
+    overlay.remove();
+    document.removeEventListener('keydown', onModalKey);
+  };
+  const onModalKey = (e) => {
+    if (e.key === 'Escape' && document.getElementById('agent-card-modal') === overlay) {
+      closeModal();
+    }
+  };
+  document.addEventListener('keydown', onModalKey);
+
+  overlay.querySelector('#agent-card-cancel').addEventListener('click', closeModal);
+  overlay.querySelector('.agent-card-modal-close').addEventListener('click', closeModal);
+  overlay.addEventListener('mousedown', (e) => {
+    if (e.target === overlay) closeModal();
+  });
+
+  overlay.querySelector('#agent-card-save').addEventListener('click', async () => {
+    const name = nameInput.value.trim();
+    const description = descInput.value.trim();
+    if (!name) {
+      setAdminMsg('名片名称不能为空', true);
+      return;
+    }
+    const saveBtn = overlay.querySelector('#agent-card-save');
+    saveBtn.disabled = true;
+    saveBtn.textContent = '保存中...';
+    try {
+      const [cardRes, authzRes] = await Promise.all([
+        adminFetch(basePath, '/api/admin/a2a/card', {
+          method: 'PUT',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ name, description, skills: [...selected] }),
+        }),
+        adminFetch(basePath, '/api/admin/a2a/authz', {
+          method: 'PUT',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ mode: authzMode, allow: [...allowSet], block: [...blockSet] }),
+        }),
+      ]);
+      if (cardRes.status === 401 || authzRes.status === 401) {
+        setAdminMsg('未登录或会话过期，请重新登录', true);
+        closeModal();
+        return;
+      }
+      const failed = [];
+      if (cardRes.status !== 200) failed.push(`名片：${cardRes.body.error || '未知错误'}`);
+      if (authzRes.status !== 200) failed.push(`调用授权：${authzRes.body.error || '未知错误'}`);
+      if (failed.length) {
+        setAdminMsg(`❌ 保存失败：${failed.join('；')}`, true);
+        return;
+      }
+      setAdminMsg('✅ 名片与调用授权已保存（baize-a2a 将在数秒内热更新）');
+      closeModal();
+      loadAgentCard(basePath);
+      loadA2aAuthz(basePath);
+    } catch (err) {
+      setAdminMsg(`❌ 保存失败：${err.message}`, true);
+    } finally {
+      saveBtn.disabled = false;
+      saveBtn.textContent = '保存';
+    }
+  });
+
+  renderSkills();
+  renderAuthz();
+  nameInput.focus();
+}
+
+async function loadA2aPeers(basePath) {
+  const el = document.getElementById('a2a-peers');
+  const state = document.getElementById('a2a-peers-state');
+  if (!el) return;
+  let body;
+  try {
+    const { status, body: b } = await adminFetch(basePath, '/api/admin/a2a/peers');
+    if (status !== 200) throw new Error(b.error || 'peer 列表加载失败');
+    body = b;
+  } catch (err) {
+    el.innerHTML = `<p class="cred-state">Peer 列表加载失败：${escapeHtml(err.message)}</p>`;
+    return;
+  }
+  const peers = body.peers || [];
+  // 同步刷新健康卡 peer 数（status 无 peerCount 时以本列表为准）
+  _lastA2aPeerCount = peers.length;
+  updateA2aHealth(_lastA2aStatus);
+  if (state) state.textContent = peers.length ? `${peers.length} 个` : '';
+  if (!peers.length) {
+    el.innerHTML = '<p class="cred-state">暂无缓存 peer。启用 A2A 并注册后，或使用下方搜索发现 agent。</p>';
+    return;
+  }
+  el.innerHTML = peers.map((p) => {
+    const skills = Array.isArray(p.skills) && p.skills.length
+      ? ` · skills: ${p.skills.map((s) => (typeof s === 'string' ? s : s.id || s.name)).join(', ')}` : '';
+    const expiry = p.expiresAt ? ` · 缓存至 ${escapeHtml(p.expiresAt)}` : '';
+    return `<div class="channel-item" role="listitem">
+      <div class="channel-item-main">
+        <div class="channel-item-title"><strong>${escapeHtml(p.agentId)}</strong></div>
+        <p class="conn-block-desc">endpoint: ${escapeHtml(p.endpoint || '-')}${skills}${expiry}</p>
+      </div>
+    </div>`;
+  }).join('');
+}
+
+// A2A 看板/消息列表最多渲染条数（后端 API 可查全部，前端控制展示长度）
+const A2A_LIST_MAX = 20;
+
+async function loadA2aTasks(basePath) {
+  const el = document.getElementById('a2a-tasks');
+  const state = document.getElementById('a2a-tasks-state');
+  if (!el) return;
+  let body;
+  try {
+    const { status, body: b } = await adminFetch(basePath, '/api/admin/a2a/tasks');
+    if (status !== 200) throw new Error(b.error || '任务看板加载失败');
+    body = b;
+  } catch (err) {
+    el.innerHTML = `<p class="cred-state">任务看板加载失败：${escapeHtml(err.message)}</p>`;
+    return;
+  }
+  const tasks = body.tasks || [];
+  // 列表只渲染最近 20 条，避免任务多时页面过长（后端 API 仍可查全部）
+  const shownTasks = tasks.slice(0, A2A_LIST_MAX);
+  if (state) state.textContent = tasks.length ? `${tasks.length} 条（显示最近 ${shownTasks.length}）` : '';
+  if (body.hint || !tasks.length) {
+    el.innerHTML = `<p class="cred-state">${escapeHtml(body.hint || '暂无 A2A 任务。')}</p>`;
+    return;
+  }
+  const statusCls = (s) => ((s === 'completed') ? 'ok' : ((s === 'failed' || s === 'canceled') ? 'warn' : 'warn'));
+  const statusLabel = (s) => ({ queued: '排队中', running: '运行中', input_required: '等待输入', cancel_requested: '取消中', completed: '已完成', failed: '失败', canceled: '已取消' }[s] || s);
+  el.innerHTML = shownTasks.map((t) => {
+    const inst = String(t.instruction || '').length > 120 ? `${String(t.instruction).slice(0, 120)}…` : String(t.instruction || '');
+    const meta = [t.caller_agent_id ? `caller: ${t.caller_agent_id}` : null, t.skill_id ? `skill: ${t.skill_id}` : null, t.created_at ? `创建: ${t.created_at}` : null].filter(Boolean).join(' · ');
+    return `<div class="channel-item" role="listitem">
+      <div class="channel-item-main">
+        <div class="channel-item-title">
+          <strong>${escapeHtml(String(t.id).slice(0, 24))}</strong>
+          <span class="channel-state ${statusCls(t.status)}">${escapeHtml(statusLabel(t.status))}</span>
+        </div>
+        <p class="conn-block-desc">${escapeHtml(inst)}</p>
+        <p class="conn-block-desc">${escapeHtml(meta)}</p>
+      </div>
+    </div>`;
+  }).join('');
+}
+
+async function loadA2aMessages(basePath) {
+  const el = document.getElementById('a2a-messages');
+  const state = document.getElementById('a2a-messages-state');
+  if (!el) return;
+  let body;
+  try {
+    const { status, body: b } = await adminFetch(basePath, '/api/admin/a2a/messages');
+    if (status !== 200) throw new Error(b.error || '消息记录加载失败');
+    body = b;
+  } catch (err) {
+    el.innerHTML = `<p class="cred-state">消息记录加载失败：${escapeHtml(err.message)}</p>`;
+    return;
+  }
+  const messages = body.messages || [];
+  // 只渲染最近 20 条（后端 API 可查全部）
+  const shownMessages = messages.slice(0, A2A_LIST_MAX);
+  if (state) state.textContent = messages.length ? `${messages.length} 条（显示最近 ${shownMessages.length}）` : '';
+  if (body.hint || !messages.length) {
+    el.innerHTML = `<p class="cred-state">${escapeHtml(body.hint || '暂无 A2A 消息。')}</p>`;
+    return;
+  }
+  el.innerHTML = shownMessages.map((m) => {
+    const arrow = m.direction === 'in' ? '← 收' : '→ 发';
+    const kind = m.kind === 'task' ? '任务' : '消息';
+    const status = m.status ? ` · ${m.status}` : '';
+    const content = String(m.content || '');
+    const preview = content.length > 160 ? `${content.slice(0, 160)}…` : content;
+    return `<div class="channel-item" role="listitem">
+      <div class="channel-item-main">
+        <div class="channel-item-title">
+          <strong>${escapeHtml(m.direction === 'in' ? m.peer : m.peer)}</strong>
+          <span class="channel-type">${arrow} · ${kind}</span>
+          <span class="channel-state warn">${escapeHtml(m.createdAt || '')}</span>
+        </div>
+        <p class="conn-block-desc">${escapeHtml(preview)}</p>
+        <p class="conn-block-desc">${escapeHtml(status)}</p>
+      </div>
+    </div>`;
+  }).join('');
+}
+
+// ── D25 U3: module install upload ───────────────────────────────
+
+async function submitA2aInstall(basePath, btn) {
+  const fileInput = document.getElementById('a2a-install-file');
+  const feedback = document.getElementById('a2a-install-feedback');
+  if (!fileInput || !btn || !feedback) return;
+  const file = fileInput.files && fileInput.files[0];
+  if (!file) {
+    feedback.textContent = '请先选择要上传的模块包（.tgz）';
+    feedback.className = 'a2a-feedback-error';
+    return;
+  }
+  const original = btn.textContent;
+  btn.disabled = true;
+  btn.textContent = '上传安装中...';
+  feedback.textContent = '';
+  feedback.className = '';
+  const fd = new FormData();
+  fd.append('file', file);
+  try {
+    const { status, body } = await adminFetch(basePath, '/api/admin/a2a/install', { method: 'POST', body: fd });
+    if (body.ok === true || body.success === true) {
+      const version = body.version ? ` v${String(body.version).replace(/^v/, '')}` : '';
+      feedback.textContent = `✅ 安装成功${version}`;
+      feedback.className = 'a2a-feedback-ok';
+      fileInput.value = '';
+      setAdminMsg(`✅ baize-a2a 安装成功${version}`);
+      loadA2aStatus(basePath); // 刷新版本/模式/健康
+    } else {
+      const msg = body.error || body.message || `HTTP ${status}`;
+      feedback.textContent = `❌ 安装失败：${msg}`;
+      feedback.className = 'a2a-feedback-error';
+      setAdminMsg(`❌ 安装失败：${msg}`, true);
+    }
+  } catch (err) {
+    feedback.textContent = `❌ 安装请求失败：${err.message}`;
+    feedback.className = 'a2a-feedback-error';
+    setAdminMsg(`❌ 安装请求失败：${err.message}`, true);
+  } finally {
+    btn.disabled = false;
+    btn.textContent = original;
+  }
+}
+
+// ── D25 U3: config area (adminUrl / advertiseUrl → enable 复用现有配置能力) ──
+
+async function submitA2aConfig(basePath, btn) {
+  const adminInput = document.getElementById('a2a-config-admin-url');
+  const advertiseInput = document.getElementById('a2a-config-advertise-url');
+  const feedback = document.getElementById('a2a-config-feedback');
+  if (!adminInput || !advertiseInput || !btn || !feedback) return;
+  const adminUrl = adminInput.value.trim();
+  const advertiseUrl = advertiseInput.value.trim();
+  if (!adminUrl || !advertiseUrl) {
+    feedback.textContent = '保存配置需要填写 Admin 服务地址与对外宣告地址';
+    feedback.className = 'a2a-feedback-error';
+    return;
+  }
+  const original = btn.textContent;
+  btn.disabled = true;
+  btn.textContent = '保存中...';
+  feedback.textContent = '';
+  feedback.className = '';
+  try {
+    const { status, body } = await adminFetch(basePath, '/api/admin/a2a/enable', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ adminUrl, advertiseUrl }),
+    });
+    if (status === 401) { setAdminMsg('未登录或会话过期，请重新登录', true); return; }
+    if (body.ok === true || body.success === true) {
+      const reg = body.registrationId ? `，注册 ID ${body.registrationId}（${body.status || 'pending'}，等待管理员审批）` : '';
+      feedback.textContent = `✅ 配置已保存${body.mode === 'cluster' ? '，已切换集群模式' : ''}${reg}`;
+      feedback.className = 'a2a-feedback-ok';
+      setAdminMsg(`✅ A2A 配置已保存${body.agentId ? `：Agent ID ${body.agentId}` : ''}${reg}`);
+      loadA2aStatus(basePath);
+    } else {
+      const msg = body.error || '未知错误';
+      feedback.textContent = `❌ 保存失败：${msg}`;
+      feedback.className = 'a2a-feedback-error';
+      setAdminMsg(`❌ 保存失败：${msg}`, true);
+    }
+  } catch (err) {
+    feedback.textContent = `❌ 保存失败：${err.message}`;
+    feedback.className = 'a2a-feedback-error';
+    setAdminMsg(`❌ 保存失败：${err.message}`, true);
+  } finally {
+    btn.disabled = false;
+    btn.textContent = original;
+  }
+}
+
+// ── D25 U3: mode switch (单机 ↔ 集群) ──────────────────────────
+
+async function switchA2aMode(basePath, btn) {
+  if (!btn) return;
+  const target = btn.dataset.targetMode === 'cluster' ? 'cluster' : 'standalone';
+  const label = target === 'cluster' ? '集群' : '单机';
+  const feedback = document.getElementById('a2a-mode-feedback');
+  const confirmMsg = target === 'cluster'
+    ? '切换到集群模式？（启用并注册到 admin 集群，可被 peer 发现）'
+    : '切换到单机模式？（停止注册与对外服务，仅保留本机运行）';
+  if (!confirm(confirmMsg)) return;
+  const original = btn.textContent;
+  btn.disabled = true;
+  btn.textContent = '切换中...';
+  if (feedback) { feedback.textContent = ''; feedback.className = ''; }
+  try {
+    let bodyPayload = {};
+    if (target === 'cluster') {
+      // 集群模式复用配置区已填地址（未填则由后端报错提示）
+      const adminUrl = (document.getElementById('a2a-config-admin-url') || {}).value || '';
+      const advertiseUrl = (document.getElementById('a2a-config-advertise-url') || {}).value || '';
+      if (adminUrl.trim() || advertiseUrl.trim()) bodyPayload = { adminUrl: adminUrl.trim(), advertiseUrl: advertiseUrl.trim() };
+    }
+    const { status, body } = await adminFetch(basePath, target === 'cluster' ? '/api/admin/a2a/enable' : '/api/admin/a2a/disable', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(bodyPayload),
+    });
+    if (status === 401) { setAdminMsg('未登录或会话过期，请重新登录', true); return; }
+    if (body.ok === true || body.success === true) {
+      if (feedback) { feedback.textContent = `✅ 已切换到${label}模式`; feedback.className = 'a2a-feedback-ok'; }
+      setAdminMsg(`✅ A2A 已切换到${label}模式`);
+      loadA2aStatus(basePath);
+      loadA2aPeers(basePath);
+    } else {
+      const msg = body.error || '未知错误';
+      if (feedback) { feedback.textContent = `❌ 切换失败：${msg}`; feedback.className = 'a2a-feedback-error'; }
+      setAdminMsg(`❌ 切换失败：${msg}`, true);
+    }
+  } catch (err) {
+    if (feedback) { feedback.textContent = `❌ 切换失败：${err.message}`; feedback.className = 'a2a-feedback-error'; }
+    setAdminMsg(`❌ 切换失败：${err.message}`, true);
+  } finally {
+    btn.disabled = false;
+    btn.textContent = original;
+  }
+}
+
+async function searchA2aFromAdmin(basePath, form, btn) {
+  const q = document.getElementById('a2a-search-query').value.trim();
+  const results = document.getElementById('a2a-search-results');
+  if (!q) { setAdminMsg('请输入搜索关键字', true); return; }
+  if (btn) { btn.disabled = true; }
+  try {
+    const { status, body } = await adminFetch(basePath, `/api/admin/a2a/search?q=${encodeURIComponent(q)}`);
+    if (status !== 200) { results.innerHTML = `搜索失败：${escapeHtml(body.error || '')}`; return; }
+    const agents = body.agents || [];
+    if (!agents.length) { results.innerHTML = '未找到匹配 agent。'; return; }
+    results.innerHTML = agents.map((a) => {
+      const meta = [a.status, a.team, a.role].filter(Boolean).join(' · ');
+      const labels = Array.isArray(a.labels) && a.labels.length ? ` · labels: ${a.labels.join(', ')}` : '';
+      const skills = Array.isArray(a.skills) && a.skills.length ? ` · skills: ${a.skills.map((s) => (typeof s === 'string' ? s : s.id || s.name)).join(', ')}` : '';
+      return `<div class="channel-item" role="listitem">
+        <div class="channel-item-main">
+          <div class="channel-item-title"><strong>${escapeHtml(a.agentId)}</strong>${a.name ? ` <span class="channel-type">${escapeHtml(a.name)}</span>` : ''}</div>
+          <p class="conn-block-desc">${escapeHtml(meta)}${labels}${skills}</p>
+        </div>
+      </div>`;
+    }).join('');
+  } finally {
+    if (btn) btn.disabled = false;
+  }
+}
+
+async function submitA2aSend(basePath) {
+  const peer = document.getElementById('a2a-send-peer').value.trim();
+  const text = document.getElementById('a2a-send-text').value.trim();
+  if (!peer || !text) { setAdminMsg('发送消息需要填写 peer 与内容', true); return; }
+  setAdminMsg(`发送消息给 ${peer}...`);
+  const { status, body } = await adminFetch(basePath, '/api/admin/a2a/send', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ peer, text }),
+  });
+  if (status === 401) { setAdminMsg('未登录或会话过期，请重新登录', true); return; }
+  if (body.success) {
+    setAdminMsg(`✅ 已发送：${body.status || 'accepted'}${body.requestId ? `（${body.requestId}）` : ''}`);
+    document.getElementById('a2a-send-text').value = '';
+    loadA2aMessages(basePath);
+  } else {
+    setAdminMsg(`❌ 发送失败：${body.error || '未知错误'}`, true);
+  }
+}
+
+async function submitA2aTaskForm(basePath) {
+  const peer = document.getElementById('a2a-task-peer').value.trim();
+  const skill = document.getElementById('a2a-task-skill').value.trim() || undefined;
+  const instruction = document.getElementById('a2a-task-instruction').value.trim();
+  const isAsync = document.getElementById('a2a-task-async').checked;
+  if (!peer || !instruction) { setAdminMsg('派发任务需要填写 peer 与指令', true); return; }
+  setAdminMsg(`派发任务给 ${peer}${isAsync ? '（异步）' : '（同步，等待终态）'}...`);
+  const { status, body } = await adminFetch(basePath, '/api/admin/a2a/task', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ peer, skill, instruction, async: isAsync }),
+  });
+  if (status === 401) { setAdminMsg('未登录或会话过期，请重新登录', true); return; }
+  if (body.success) {
+    const tail = body.status === 'completed' ? `，结果：${String(body.result || '').slice(0, 200)}` : '';
+    setAdminMsg(`✅ 任务已派发：${body.taskId}（${body.status}）${body.error ? `，错误：${body.error}` : ''}${tail}`);
+    document.getElementById('a2a-task-instruction').value = '';
+    loadA2aTasks(basePath);
+    loadA2aMessages(basePath);
+  } else {
+    setAdminMsg(`❌ 派发失败：${body.error || '未知错误'}`, true);
+  }
+}
+
 function showAppView(basePath, view) {
   const chatView = document.getElementById('chat-view');
   const modelView = document.getElementById('model-view');
   const channelsView = document.getElementById('channels-view');
+  const a2aView = document.getElementById('a2a-view');
   const navChat = document.getElementById('nav-chat');
   const navModel = document.getElementById('nav-model');
   const navChannels = document.getElementById('nav-channels');
-  if (!chatView || !modelView || !channelsView) return;
+  const navA2a = document.getElementById('nav-a2a');
+  if (!chatView || !modelView || !channelsView || !a2aView) return;
   const setNav = (active, others) => {
     active.classList.add('active');
     active.setAttribute('aria-current', 'page');
@@ -1401,20 +2262,30 @@ function showAppView(basePath, view) {
   if (view === 'model') {
     chatView.hidden = true;
     channelsView.hidden = true;
+    a2aView.hidden = true;
     modelView.hidden = false;
-    setNav(navModel, [navChat, navChannels]);
+    setNav(navModel, [navChat, navChannels, navA2a]);
     renderModelSettings(basePath);
   } else if (view === 'channels') {
     chatView.hidden = true;
     modelView.hidden = true;
+    a2aView.hidden = true;
     channelsView.hidden = false;
-    setNav(navChannels, [navChat, navModel]);
+    setNav(navChannels, [navChat, navModel, navA2a]);
     renderChannels(basePath);
+  } else if (view === 'a2a') {
+    chatView.hidden = true;
+    modelView.hidden = true;
+    channelsView.hidden = true;
+    a2aView.hidden = false;
+    setNav(navA2a, [navChat, navModel, navChannels]);
+    renderA2a(basePath);
   } else {
     modelView.hidden = true;
     channelsView.hidden = true;
+    a2aView.hidden = true;
     chatView.hidden = false;
-    setNav(navChat, [navModel, navChannels]);
+    setNav(navChat, [navModel, navChannels, navA2a]);
     ensureChatEmptyState(basePath);
     updateChatHint(basePath);
     refreshRuntimeLabel(basePath);
@@ -1575,6 +2446,7 @@ function initViews(basePath) {
   document.getElementById('nav-chat').addEventListener('click', () => showAppView(basePath, 'chat'));
   document.getElementById('nav-model').addEventListener('click', () => showAppView(basePath, 'model'));
   document.getElementById('nav-channels').addEventListener('click', () => showAppView(basePath, 'channels'));
+  document.getElementById('nav-a2a').addEventListener('click', () => showAppView(basePath, 'a2a'));
 
   // D8 two-column layout: Claude official = setup-token form; custom API =
   // per-column quick forms. The standalone api-key forms were removed.
@@ -1614,6 +2486,30 @@ function initViews(basePath) {
   if (channelsCatalogue) bindChannelCatalogue(channelsCatalogue);
   document.getElementById('btn-activate-official').addEventListener('click', () => activateProviderFromAdmin(basePath, 'official'));
   document.getElementById('btn-activate-official-openai').addEventListener('click', () => activateProviderFromAdmin(basePath, 'official-openai'));
+
+  // A2A view
+  document.getElementById('form-a2a-install').addEventListener('submit', (e) => {
+    e.preventDefault();
+    submitA2aInstall(basePath, e.target.querySelector('button[type="submit"]'));
+  });
+  document.getElementById('form-a2a-config').addEventListener('submit', (e) => {
+    e.preventDefault();
+    submitA2aConfig(basePath, e.target.querySelector('button[type="submit"]'));
+  });
+  document.getElementById('btn-a2a-switch-mode').addEventListener('click', (e) => switchA2aMode(basePath, e.target));
+  document.getElementById('btn-a2a-edit-card').addEventListener('click', () => openAgentCardEditor(basePath));
+  document.getElementById('form-a2a-search').addEventListener('submit', (e) => {
+    e.preventDefault();
+    searchA2aFromAdmin(basePath, e.target, e.target.querySelector('button[type="submit"]'));
+  });
+  document.getElementById('form-a2a-send').addEventListener('submit', (e) => {
+    e.preventDefault();
+    submitA2aSend(basePath);
+  });
+  document.getElementById('form-a2a-task').addEventListener('submit', (e) => {
+    e.preventDefault();
+    submitA2aTaskForm(basePath);
+  });
 }
 
 async function determineConfigured(basePath) {