@bolloon/bolloon-agent 0.4.12 → 0.4.14

package/dist/web/client.js

@@ -1771,6 +1771,275 @@
       notice.remove();
     }, 15e3);
   }
+  var gwGroups = [];
+  var gwNetworks = [];
+  var gwActiveChat = null;
+  var gwMsgCache = /* @__PURE__ */ new Map();
+  function gwToast(text) {
+    try {
+      window.showToast?.(text);
+    } catch {
+    }
+    console.log("[gateway]", text);
+  }
+  function gwEsc(s) {
+    try {
+      return escapeHtml2(String(s ?? ""));
+    } catch {
+      return String(s ?? "");
+    }
+  }
+  function gwModal(html) {
+    const overlay = document.createElement("div");
+    overlay.className = "gw-modal-overlay";
+    overlay.innerHTML = `<div class="gw-modal">${html}<div class="gw-modal-close" title="\u5173\u95ED">\u2715</div></div>`;
+    document.body.appendChild(overlay);
+    const close = () => overlay.remove();
+    overlay.querySelector(".gw-modal-close")?.addEventListener("click", close);
+    overlay.addEventListener("click", (e) => {
+      if (e.target === overlay) close();
+    });
+    return { root: overlay, close };
+  }
+  async function loadGatewaySidebar() {
+    try {
+      const [g, n] = await Promise.all([
+        fetch("/api/gateway/groups").then((r) => r.json()).catch(() => ({ groups: [] })),
+        fetch("/api/gateway/status").then((r) => r.json()).catch(() => ({ networks: [] }))
+      ]);
+      gwGroups = Array.isArray(g.groups) ? g.groups : [];
+      gwNetworks = Array.isArray(n.networks) ? n.networks : [];
+      renderGatewaySidebar();
+    } catch {
+    }
+  }
+  function renderGatewaySidebar() {
+    const list = document.getElementById("gateway-list");
+    if (!list) return;
+    list.innerHTML = "";
+    for (const grp of gwGroups) {
+      const li = document.createElement("li");
+      li.className = "gateway-item";
+      li.innerHTML = `<span class="gateway-item-icon">\u{1F465}</span>
+      <span class="gateway-item-main">
+        <span class="gateway-item-name">${gwEsc(grp.name || "\u7FA4\u7EC4")}</span>
+        <span class="gateway-item-sub">${grp.memberCount ?? 0} \u6210\u5458 \xB7 ${grp.messageCount ?? 0} \u6761\u6D88\u606F</span>
+      </span>`;
+      li.title = "\u6253\u5F00\u7FA4\u804A";
+      li.onclick = () => openGroupChat(grp.id, grp.name || grp.id);
+      list.appendChild(li);
+    }
+    for (const net of gwNetworks) {
+      const li = document.createElement("li");
+      li.className = "gateway-item gateway-item-net";
+      li.innerHTML = `<span class="gateway-item-icon">\u{1F310}</span>
+      <span class="gateway-item-main">
+        <span class="gateway-item-name">${gwEsc(net.name || String(net.link || "").slice(0, 24) || "\u7F51\u7EDC")}</span>
+        <span class="gateway-item-sub">${net.serviceCount ?? 0} \u4E2A\u670D\u52A1</span>
+      </span>`;
+      li.title = `\u670D\u52A1\u7F51\u7EDC: ${net.link || ""}`;
+      list.appendChild(li);
+    }
+    if (!gwGroups.length && !gwNetworks.length) {
+      list.innerHTML = '<li class="sidebar-empty-hint">(\u6682\u65E0\u7F51\u7EDC, \u70B9 + \u52A0\u5165)</li>';
+    }
+  }
+  function openGatewayJoinModal() {
+    const { root, close } = gwModal(`
+    <div class="gw-join">
+      <h3>\u52A0\u5165 Agent \u7F51\u7EDC / \u7FA4\u7EC4</h3>
+      <p class="gw-hint">\u7C98\u8D34\u9080\u8BF7\u94FE\u63A5 (orbitdb://...), \u81EA\u52A8\u8BC6\u522B\u670D\u52A1\u7F51\u7EDC\u6216\u7FA4\u7EC4.</p>
+      <input class="gw-join-input" placeholder="orbitdb:///orbitdb/...?type=group&name=..." />
+      <div class="gw-join-actions">
+        <button class="gw-join-go">\u52A0\u5165</button>
+        <button class="gw-join-my">\u{1F517} \u6211\u7684\u7F51\u7EDC\u94FE\u63A5</button>
+      </div>
+      <div class="gw-join-result"></div>
+    </div>`);
+    const input2 = root.querySelector(".gw-join-input");
+    const go = root.querySelector(".gw-join-go");
+    const my = root.querySelector(".gw-join-my");
+    const result = root.querySelector(".gw-join-result");
+    go.onclick = async () => {
+      const link = String(input2.value || "").trim();
+      if (!link) {
+        result.textContent = "\u8BF7\u8F93\u5165\u94FE\u63A5";
+        return;
+      }
+      if (link.includes("type=group")) {
+        const r = await fetch("/api/gateway/groups/join", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ link })
+        }).then((x) => x.json()).catch(() => ({ ok: false, error: "\u8BF7\u6C42\u5931\u8D25" }));
+        if (r.ok) {
+          result.textContent = r.already ? "\u5DF2\u5728\u8BE5\u7FA4\u7EC4\u4E2D \u2713" : `\u2705 \u5DF2\u52A0\u5165\u7FA4\u7EC4\u300C${r.group?.name || ""}\u300D`;
+          close();
+          loadGatewaySidebar();
+        } else result.textContent = `\u274C ${r.error || "\u52A0\u5165\u5931\u8D25"}`;
+      } else {
+        const r = await fetch("/api/gateway/join", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ link })
+        }).then((x) => x.json()).catch(() => ({ ok: false, error: "\u8BF7\u6C42\u5931\u8D25" }));
+        if (r.ok) {
+          result.textContent = r.already ? "\u5DF2\u5728\u8BE5\u7F51\u7EDC\u4E2D \u2713" : `\u2705 \u5DF2\u52A0\u5165\u7F51\u7EDC (${r.total} \u670D\u52A1, \u65B0\u589E ${r.joined})`;
+          close();
+          loadGatewaySidebar();
+        } else result.textContent = `\u274C ${r.error || "\u52A0\u5165\u5931\u8D25"}`;
+      }
+    };
+    my.onclick = async () => {
+      const r = await fetch("/api/gateway/link").then((x) => x.json()).catch(() => null);
+      if (r?.link) {
+        try {
+          await navigator.clipboard.writeText(r.link);
+        } catch {
+        }
+        result.innerHTML = `\u6211\u7684\u7F51\u7EDC\u9080\u8BF7\u94FE\u63A5\u5DF2\u590D\u5236:<br><code>${gwEsc(r.link)}</code>`;
+      } else result.textContent = "\u274C \u751F\u6210\u94FE\u63A5\u5931\u8D25 (OrbitDB \u672A\u5C31\u7EEA)";
+    };
+  }
+  function openGatewayNewGroupModal() {
+    const { root, close } = gwModal(`
+    <div class="gw-join">
+      <h3>\u521B\u5EFA\u7FA4\u7EC4</h3>
+      <p class="gw-hint">\u7FA4\u7EC4 = \u5FAE\u4FE1\u5F0F\u7FA4\u804A, \u5206\u4EAB\u94FE\u63A5\u9080\u8BF7\u5176\u4ED6 Agent / Bolloon \u52A0\u5165.</p>
+      <input class="gw-join-input" placeholder="\u7FA4\u7EC4\u540D (\u5982: \u7814\u7A76\u534F\u4F5C\u7EC4)" />
+      <div class="gw-join-actions"><button class="gw-join-go">\u521B\u5EFA</button></div>
+      <div class="gw-join-result"></div>
+    </div>`);
+    const input2 = root.querySelector(".gw-join-input");
+    const go = root.querySelector(".gw-join-go");
+    const result = root.querySelector(".gw-join-result");
+    go.onclick = async () => {
+      const name = String(input2.value || "").trim();
+      if (!name) {
+        result.textContent = "\u8BF7\u8F93\u5165\u7FA4\u7EC4\u540D";
+        return;
+      }
+      const r = await fetch("/api/gateway/groups", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ name, from: "web-user" })
+      }).then((x) => x.json()).catch(() => ({ ok: false, error: "\u8BF7\u6C42\u5931\u8D25" }));
+      if (r.ok) {
+        result.innerHTML = `\u2705 \u7FA4\u7EC4\u5DF2\u521B\u5EFA.<br><b>\u9080\u8BF7\u94FE\u63A5:</b><br><code>${gwEsc(r.group?.link)}</code><br>\u590D\u5236\u5206\u4EAB\u7ED9\u5176\u4ED6 Bolloon/Agent.`;
+        loadGatewaySidebar();
+      } else result.textContent = `\u274C ${r.error || "\u521B\u5EFA\u5931\u8D25"}`;
+    };
+  }
+  function openGroupChat(id, name) {
+    gwActiveChat = { id, name };
+    const { root, close } = gwModal(`
+    <div class="gw-chat">
+      <div class="gw-chat-header">
+        <b>\u{1F465} ${gwEsc(name)}</b>
+        <span class="gw-chat-actions">
+          <button class="gw-chat-invite" title="\u590D\u5236\u7FA4\u9080\u8BF7\u94FE\u63A5">\u{1F517} \u9080\u8BF7</button>
+        </span>
+      </div>
+      <div class="gw-chat-msgs" id="gw-msgs-${id}"><div class="gw-msg-empty">\u52A0\u8F7D\u4E2D...</div></div>
+      <div class="gw-chat-input-row">
+        <input class="gw-chat-input" id="gw-input-${id}" placeholder="\u53D1\u6D88\u606F\u7ED9\u7FA4\u6210\u5458... (Enter \u53D1\u9001)" />
+        <button class="gw-chat-send">\u53D1\u9001</button>
+      </div>
+    </div>`);
+    root.querySelector(".gw-chat-invite")?.addEventListener("click", async () => {
+      const r = await fetch(`/api/gateway/groups/${id}/link`).then((x) => x.json()).catch(() => null);
+      if (r?.link) {
+        try {
+          await navigator.clipboard.writeText(r.link);
+        } catch {
+        }
+        gwToast("\u7FA4\u9080\u8BF7\u94FE\u63A5\u5DF2\u590D\u5236, \u5206\u4EAB\u7ED9\u5176\u4ED6 Agent");
+      } else gwToast("\u83B7\u53D6\u94FE\u63A5\u5931\u8D25");
+    });
+    const sendBtn2 = root.querySelector(".gw-chat-send");
+    const input2 = root.querySelector(".gw-chat-input");
+    sendBtn2.onclick = () => {
+      void sendGroupMessage(id);
+    };
+    input2.onkeydown = (e) => {
+      if (e.key === "Enter") {
+        e.preventDefault();
+        void sendGroupMessage(id);
+      }
+    };
+    void loadGroupMessages(id);
+  }
+  async function loadGroupMessages(id) {
+    const box = document.getElementById(`gw-msgs-${id}`);
+    if (!box) return;
+    const r = await fetch(`/api/gateway/groups/${id}/messages?limit=50`).then((x) => x.json()).catch(() => ({ messages: [] }));
+    gwMsgCache.set(id, Array.isArray(r.messages) ? r.messages : []);
+    renderGroupMessages(id);
+  }
+  function renderGroupMessages(id) {
+    const box = document.getElementById(`gw-msgs-${id}`);
+    if (!box) return;
+    const msgs = gwMsgCache.get(id) || [];
+    const myName = (document.getElementById("user-name")?.textContent || "web-user").trim();
+    box.innerHTML = msgs.map((m) => {
+      const mine = m.from === myName || m.from === "web-user" || m.from === "me";
+      const t = new Date(m.ts).toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" });
+      return `<div class="gw-msg ${mine ? "gw-msg-mine" : ""}">
+      <div class="gw-msg-meta"><b>${gwEsc(String(m.from).slice(0, 24))}</b> \xB7 ${t}</div>
+      <div class="gw-msg-text">${gwEsc(String(m.text))}</div>
+    </div>`;
+    }).join("") || '<div class="gw-msg-empty">\u7FA4\u8FD8\u6CA1\u6709\u6D88\u606F, \u8BF4\u70B9\u4EC0\u4E48\u5427 \u{1F44B}</div>';
+    box.scrollTop = box.scrollHeight;
+  }
+  async function sendGroupMessage(id) {
+    const input2 = document.getElementById(`gw-input-${id}`);
+    const text = input2?.value?.trim();
+    if (!text) return;
+    const myName = (document.getElementById("user-name")?.textContent || "web-user").trim();
+    const r = await fetch(`/api/gateway/groups/${id}/message`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ text, from: myName })
+    }).then((x) => x.json()).catch(() => ({ ok: false, error: "\u8BF7\u6C42\u5931\u8D25" }));
+    if (r.ok) {
+      if (input2) input2.value = "";
+      void loadGroupMessages(id);
+    } else gwToast(r.error || "\u53D1\u9001\u5931\u8D25");
+  }
+  function handleGroupMessage(msg) {
+    const { groupId, message, groupName } = msg || {};
+    if (!groupId || !message) return;
+    const cur = gwActiveChat;
+    if (cur && cur.id === groupId) {
+      const cache = gwMsgCache.get(groupId) || [];
+      cache.push(message);
+      gwMsgCache.set(groupId, cache.slice(-100));
+      renderGroupMessages(groupId);
+    } else {
+      gwToast(`\u{1F4E2} ${groupName || "\u7FA4\u7EC4"} \u65B0\u6D88\u606F: ${String(message.text || "").slice(0, 40)}`);
+    }
+    void loadGatewaySidebar();
+  }
+  document.addEventListener("DOMContentLoaded", () => {
+    const addBtn = document.getElementById("gateway-add-btn");
+    if (addBtn) addBtn.onclick = openGatewayJoinModal;
+    const ngBtn = document.getElementById("gateway-new-group-btn");
+    if (ngBtn) ngBtn.onclick = openGatewayNewGroupModal;
+    const gHeader = document.getElementById("gateway-header");
+    if (gHeader) gHeader.onclick = () => {
+      const t = document.getElementById("gateway-toggle");
+      const list = document.getElementById("gateway-list");
+      if (t && list) {
+        const open = t.textContent === "\u25BC";
+        t.textContent = open ? "\u25B6" : "\u25BC";
+        list.style.display = open ? "none" : "";
+      }
+    };
+    void loadGatewaySidebar();
+    setInterval(() => {
+      void loadGatewaySidebar();
+    }, 3e4);
+  });
   var v3GlobalEventSource = null;
   function startV3GlobalSSE() {
     if (v3GlobalEventSource) return;
@@ -1779,6 +2048,10 @@
       v3GlobalEventSource.onmessage = (e) => {
         try {
           const msg = JSON.parse(e.data);
+          if (msg.type === "group-message") {
+            handleGroupMessage(msg);
+            return;
+          }
           if (msg.type === "remote-chat-sent") {
             console.log("[v3] \u6536\u5230 remote-chat-sent:", msg.channelId, "|", String(msg.text || "").slice(0, 30));
             try {

package/dist/web/index.html

@@ -90,6 +90,23 @@
         </ul>
       </div>
 
+      <!-- 2026-08-14: Agent 网络 (Gateway) — 群组群聊 + 服务网络 -->
+      <div class="sidebar-section" id="gateway-section">
+        <div class="section-header is-compact is-clickable" id="gateway-header">
+          <span class="section-header-row">
+            <span id="gateway-toggle">▼</span>
+            <span class="section-title">Agent 网络</span>
+          </span>
+          <span class="section-header-actions">
+            <button id="gateway-new-group-btn" class="sidebar-mini-btn" title="创建群组 (微信群聊式)">+ 群组</button>
+            <button id="gateway-add-btn" class="sidebar-mini-btn" title="粘贴链接加入网络/群组 (orbitdb://...)">+ 加入</button>
+          </span>
+        </div>
+        <ul class="channel-list" id="gateway-list">
+          <li class="sidebar-empty-hint">(暂无网络, 点 + 加入)</li>
+        </ul>
+      </div>
+
       <div class="sidebar-footer">
         <div class="user-avatar" id="user-avatar" title="点击查看 DID 身份">
           <span class="avatar-letter" id="avatar-letter">?</span>

package/dist/web/mobile.html

@@ -36,6 +36,8 @@
       </div>
       <div class="section-label">MCP 工具 (触控调用)</div>
       <div class="list" id="mcp-tools"></div>
+      <div class="section-label">待人工审批支付</div>
+      <div class="list" id="approval-list"></div>
       <div class="section-label">A2UI 动态面板 (智能体生成)</div>
       <div id="a2ui-root"></div>
     </section>

package/dist/web/mobile.js

@@ -44,7 +44,7 @@
     $$('.page').forEach((p) => { p.hidden = p.dataset.tab !== tab; });
     $$('.tab').forEach((t) => t.classList.toggle('active', t.dataset.tab === tab));
     $('#topbar-title').textContent = TITLES[tab] || '微信';
-    if (tab === 'discover') loadMcpTools();
+    if (tab === 'discover') { loadMcpTools(); loadApprovals(); }
     window.__mobileTouch?.('tab', tab);
   }
   $$('.tab').forEach((t) => t.addEventListener('click', () => switchTab(t.dataset.tab)));
@@ -307,6 +307,43 @@
     // 预留: 触控事件上报/控制
   };
 
+  // === 人工支付审批 (2026-08-13): YAML 验证门 confirm 的支付请求 → 人工批准/拒绝 ===
+  async function loadApprovals() {
+    const box = $('#approval-list');
+    if (!box) return;
+    try {
+      const r = await api.get('/api/payments/pending');
+      const approvals = r.approvals || [];
+      box.innerHTML = '';
+      if (approvals.length === 0) {
+        box.innerHTML = '<div style="padding:10px 16px;color:var(--text-muted)">无待审批支付</div>';
+        return;
+      }
+      approvals.forEach((a) => {
+        const el = document.createElement('div');
+        el.className = 'conv-item';
+        el.style.flexDirection = 'column';
+        el.style.alignItems = 'flex-start';
+        el.innerHTML = `
+          <div style="width:100%"><b>${escapeHtml(a.service)}</b> $${a.amount} → ${escapeHtml(String(a.recipient).slice(0, 14))}...</div>
+          <div style="color:var(--text-muted);font-size:12px">${escapeHtml(a.reason)}</div>
+          <div style="display:flex;gap:8px;margin-top:6px">
+            <button class="approve-btn" data-id="${escapeHtml(a.id)}" style="background:var(--success,#22c55e);border:none;border-radius:6px;padding:4px 14px;color:#fff">批准</button>
+            <button class="reject-btn" data-id="${escapeHtml(a.id)}" style="background:var(--error,#ef4444);border:none;border-radius:6px;padding:4px 14px;color:#fff">拒绝</button>
+          </div>`;
+        el.querySelector('.approve-btn').addEventListener('click', async () => {
+          await api.post(`/api/payments/${a.id}/approve`, {}).catch(() => {});
+          loadApprovals();
+        });
+        el.querySelector('.reject-btn').addEventListener('click', async () => {
+          await api.post(`/api/payments/${a.id}/reject`, {}).catch(() => {});
+          loadApprovals();
+        });
+        box.appendChild(el);
+      });
+    } catch (e) { box.innerHTML = '<div style="padding:10px;color:var(--error)">审批加载失败</div>'; }
+  }
+
   // === MCP 驱动前端 UI (2026-08-12): 订阅 /events, 收到 {type:'ui'} 指令执行组件动作 ===
   function setupUiControl() {
     try {

package/dist/web/server.js

@@ -735,6 +735,16 @@ async function handleV3P2PMessage(parsed, conn, comm) {
         }
         // 2026-07-29: 语义分析 — 分析远端聊天内容, 隐式滑动 trustScore
         recordInteraction(senderKey, text).catch(() => { });
+        // 2026-08-14: 远端消息带 gateway 链接 → 自动加入 (幂等, fire-and-forget 不阻塞聊天)
+        import('../agents/gateway-network.js').then(({ maybeAutoJoinGateway }) => maybeAutoJoinGateway(String(text || '')).then((note) => {
+            if (note) {
+                console.log(`[agent-gateway] ${note}`);
+                try {
+                    broadcast({ type: 'gateway', content: note, channelId }, channelId);
+                }
+                catch { /* 广播失败忽略 */ }
+            }
+        }).catch(() => { })).catch(() => { });
         console.log(`[v3] 收到 ${senderKey.substring(0, 12)}... (${tierLabel(tierState.tier)}) 对 channel ${channelId} 的 chat: "${text.substring(0, 40)}..."`);
         try {
             // 1. 找到 channel
@@ -2811,6 +2821,201 @@ ${goalDesc}
             res.status(500).json({ error: e?.message });
         }
     });
+    // 2026-08-14: Agent Gateway — 网络加入 / 分享链接 / 成员 / 状态 (入口要小: 一条链接)
+    app.post('/api/gateway/join', async (req, res) => {
+        try {
+            const { joinNetwork } = await import('../agents/gateway-network.js');
+            const link = String(req.body?.link || '').trim();
+            if (!link)
+                return res.status(400).json({ error: 'link 必填 (orbitdb:// / ipns:// / https://.../registry)' });
+            const r = await joinNetwork(link);
+            res.json(r);
+        }
+        catch (e) {
+            res.status(500).json({ error: e?.message });
+        }
+    });
+    app.get('/api/gateway/link', async (req, res) => {
+        try {
+            const { shareNetworkLink } = await import('../agents/gateway-network.js');
+            const name = String(req.query?.name || '').trim() || undefined;
+            const r = await shareNetworkLink(name ? { name } : undefined);
+            if (!r.ok)
+                return res.status(400).json({ error: r.error });
+            res.json({ ok: true, link: r.link });
+        }
+        catch (e) {
+            res.status(500).json({ error: e?.message });
+        }
+    });
+    app.get('/api/gateway/networks', async (_req, res) => {
+        try {
+            const { listJoinedNetworks } = await import('../agents/gateway-network.js');
+            res.json({ networks: await listJoinedNetworks() });
+        }
+        catch (e) {
+            res.status(500).json({ error: e?.message });
+        }
+    });
+    app.get('/api/gateway/status', async (_req, res) => {
+        try {
+            const { gatewayStatus } = await import('../agents/agent-gateway.js');
+            const { getAgentRegistry } = await import('../agents/agent-registry.js');
+            const { listJoinedNetworks } = await import('../agents/gateway-network.js');
+            const registry = getAgentRegistry();
+            const services = await registry.list();
+            res.json({
+                ready: registry.ready,
+                count: services.length,
+                services,
+                networks: await listJoinedNetworks(),
+                summary: await gatewayStatus(),
+            });
+        }
+        catch (e) {
+            res.status(500).json({ error: e?.message });
+        }
+    });
+    // ============ 2026-08-14: P2P 群组 (微信式群聊, OrbitDB events store) ============
+    app.post('/api/gateway/groups', async (req, res) => {
+        try {
+            const { createGroup } = await import('../agents/gateway-group.js');
+            const r = await createGroup(String(req.body?.name || '').trim(), {
+                from: String(req.body?.from || '').trim() || undefined,
+                hello: req.body?.hello ? String(req.body.hello) : undefined,
+            });
+            if (!r.ok)
+                return res.status(400).json({ error: r.error });
+            registerGroupSse(r.group.id, r.group.name);
+            res.json({ ok: true, group: r.group });
+        }
+        catch (e) {
+            res.status(500).json({ error: e?.message });
+        }
+    });
+    app.post('/api/gateway/groups/join', async (req, res) => {
+        try {
+            const { joinGroup } = await import('../agents/gateway-group.js');
+            const link = String(req.body?.link || '').trim();
+            if (!link)
+                return res.status(400).json({ error: 'link 必填 (orbitdb://...?type=group&name=...)' });
+            const r = await joinGroup(link);
+            if (!r.ok)
+                return res.status(400).json({ error: r.error });
+            if (r.group)
+                registerGroupSse(r.group.id, r.group.name);
+            res.json(r);
+        }
+        catch (e) {
+            res.status(500).json({ error: e?.message });
+        }
+    });
+    app.get('/api/gateway/groups', async (_req, res) => {
+        try {
+            const { listGroups, groupInfo } = await import('../agents/gateway-group.js');
+            const groups = await listGroups();
+            const detailed = await Promise.all(groups.map((g) => groupInfo(g.id).catch(() => g)));
+            res.json({ groups: detailed });
+        }
+        catch (e) {
+            res.status(500).json({ error: e?.message });
+        }
+    });
+    app.get('/api/gateway/groups/:id/messages', async (req, res) => {
+        try {
+            const { groupMessages } = await import('../agents/gateway-group.js');
+            const limit = Math.min(Number(req.query?.limit || 50), 200);
+            const msgs = await groupMessages(String(req.params.id), limit);
+            res.json({ messages: msgs });
+        }
+        catch (e) {
+            res.status(500).json({ error: e?.message });
+        }
+    });
+    app.post('/api/gateway/groups/:id/message', async (req, res) => {
+        try {
+            const { groupSend } = await import('../agents/gateway-group.js');
+            const r = await groupSend(String(req.params.id), String(req.body?.text || ''), String(req.body?.from || 'web-user'));
+            if (!r.ok)
+                return res.status(400).json({ error: r.error });
+            res.json({ ok: true });
+        }
+        catch (e) {
+            res.status(500).json({ error: e?.message });
+        }
+    });
+    app.get('/api/gateway/groups/:id/link', async (req, res) => {
+        try {
+            const { groupLink } = await import('../agents/gateway-group.js');
+            const link = await groupLink(String(req.params.id));
+            if (!link)
+                return res.status(404).json({ error: '群组不存在' });
+            res.json({ ok: true, link });
+        }
+        catch (e) {
+            res.status(500).json({ error: e?.message });
+        }
+    });
+    // 2026-08-13: 人工支付审批 API — YAML 验证门 confirm 的支付请求
+    app.get('/api/payments/pending', async (_req, res) => {
+        try {
+            const { getApprovalStore } = await import('../agents/payment-approval.js');
+            const approvals = await getApprovalStore().pending();
+            res.json({ approvals });
+        }
+        catch (e) {
+            res.status(500).json({ error: e?.message });
+        }
+    });
+    app.get('/api/payments', async (_req, res) => {
+        try {
+            const { getApprovalStore } = await import('../agents/payment-approval.js');
+            const approvals = await getApprovalStore().list();
+            res.json({ approvals });
+        }
+        catch (e) {
+            res.status(500).json({ error: e?.message });
+        }
+    });
+    app.post('/api/payments/:id/approve', async (req, res) => {
+        try {
+            const { getApprovalStore, setApprovalExecutor } = await import('../agents/payment-approval.js');
+            const store = getApprovalStore();
+            // 批准后执行: 重试 serviceCall (带 retryPayload)
+            setApprovalExecutor(async (approval) => {
+                const payload = approval.retryPayload;
+                if (!payload)
+                    return { ok: false, error: '无重试载荷' };
+                const { serviceCall } = await import('../agents/agent-service-client.js');
+                const r = await serviceCall({
+                    serviceName: payload.serviceName,
+                    args: payload.args,
+                    privateKey: payload.privateKey,
+                    maxPaymentAmount: payload.maxPaymentAmount,
+                });
+                return { ok: r.success, result: r.output, error: r.error };
+            });
+            const r = await store.approve(String(req.params.id));
+            if (!r.ok)
+                return res.status(400).json({ error: r.error });
+            res.json({ ok: true, approval: r.approval });
+        }
+        catch (e) {
+            res.status(500).json({ error: e?.message });
+        }
+    });
+    app.post('/api/payments/:id/reject', async (req, res) => {
+        try {
+            const { getApprovalStore } = await import('../agents/payment-approval.js');
+            const r = await getApprovalStore().reject(String(req.params.id));
+            if (!r.ok)
+                return res.status(400).json({ error: r.error });
+            res.json({ ok: true, approval: r.approval });
+        }
+        catch (e) {
+            res.status(500).json({ error: e?.message });
+        }
+    });
     // 2026-08-12: MCP 工具列表 (MCP 前端支持 — 手机端/桌面 UI 展示可用 MCP 工具)
     app.get('/api/mcp/tools', async (_req, res) => {
         try {
@@ -2850,11 +3055,38 @@ ${goalDesc}
             const { warmAgentRegistry } = await import('../agents/agent-registry.js');
             const ok = await warmAgentRegistry();
             console.log(`[agent-registry] OrbitDB 服务注册表 ${ok ? '已启用' : '未启用 (回退本地)'}`);
+            // 2026-08-14: 恢复已加入的 Agent 网络 (重启后仍是家庭成员, 失败静默保留记录)
+            const { restoreJoinedNetworks } = await import('../agents/gateway-network.js');
+            restoreJoinedNetworks().then((r) => {
+                if (r.total > 0)
+                    console.log(`[agent-gateway] 恢复 ${r.restored}/${r.total} 个已加入网络 (失败 ${r.failed}, 记录保留)`);
+            }).catch(() => { });
+            // 2026-08-14: 恢复已加入的群组 (重开 store + 注册 SSE 广播)
+            const { restoreGroups, listGroups } = await import('../agents/gateway-group.js');
+            restoreGroups().then((r) => {
+                if (r.total > 0)
+                    console.log(`[agent-gateway] 恢复 ${r.restored}/${r.total} 个群组 (失败 ${r.failed})`);
+                listGroups().then((gs) => { for (const g of gs)
+                    registerGroupSse(g.id, g.name); }).catch(() => { });
+            }).catch(() => { });
         }
         catch (e) {
             console.warn('[agent-registry] 预热失败 (非致命):', e?.message?.slice(0, 120));
         }
     })();
+    // 2026-08-14: 群组消息 → SSE 广播 (手机端/Web 实时收到群聊)
+    const groupSseRegistered = new Set();
+    function registerGroupSse(groupId, groupName) {
+        if (groupSseRegistered.has(groupId))
+            return;
+        groupSseRegistered.add(groupId);
+        import('../agents/gateway-group.js').then(({ onGroupMessage }) => onGroupMessage(groupId, (msg) => {
+            try {
+                broadcast({ type: 'group-message', groupId, groupName, message: msg }, 'p2p-global');
+            }
+            catch { /* 忽略 */ }
+        })).catch(() => { });
+    }
     app.get('/api/health', (_req, res) => {
         res.json(healthCheck(getPackageVersion()));
     });
@@ -3595,6 +3827,17 @@ ${goalDesc}
             catch { /* 预激活失败不阻塞 */ }
             // 将真实 DID 作为上下文前缀，让 AI 使用真实的 DID 而不是自己编造的
             let contextHint = '';
+            // 2026-08-14: 本地消息带 gateway 链接 → 自动加入, 结果注入 agent 上下文 (5s 上限, 不阻塞 LLM)
+            try {
+                const { maybeAutoJoinGateway } = await import('../agents/gateway-network.js');
+                const gwNote = await Promise.race([
+                    maybeAutoJoinGateway(text),
+                    new Promise((resolve) => setTimeout(() => resolve(null), 5000)),
+                ]);
+                if (gwNote)
+                    contextHint += `[系统上下文] ${gwNote}\n`;
+            }
+            catch { /* 自动加入失败不阻塞 */ }
             // 2026-08-02: slash 命令提示 (在 /message 开头解析, 这里注入)
             if (slashCommandHint)
                 contextHint += slashCommandHint;