@bolloon/bolloon-agent 0.4.13 → 0.4.14

package/dist/agents/pi-sdk-tools.js

@@ -2505,6 +2505,123 @@ export function registerBuiltinTools(ctx) {
             }
         },
     });
+    // 2026-08-14: Agent Gateway — 经济协调层统一入口 (注册/调用/加入网络/状态)
+    ctx.tools.set('gateway_register', {
+        name: 'gateway_register',
+        description: '把本 Agent 注册为服务提供者 (Agent Gateway 入口). capability: 能力名 (research/coding/data...); price: 价格; per: 计价单位; wallet: 收款地址. 注册后其他 Agent 能发现并调用你.',
+        parameters: {
+            capability: '能力名 (必填, research/coding/data/compute...)',
+            price: '价格 (必填, 如 0.05)',
+            currency: '币种 (默认 USDC)',
+            per: '计价单位 (默认 query)',
+            description: '服务描述 (可选)',
+            wallet: '收款钱包地址 (可选)',
+        },
+        execute: async (args) => {
+            const { gatewayRegisterAgent } = await import('./agent-gateway.js');
+            const r = await gatewayRegisterAgent({
+                capability: String(args.capability || '').trim(),
+                price: String(args.price || '').trim(),
+                currency: String(args.currency || 'USDC'),
+                per: String(args.per || 'query'),
+                description: String(args.description || '').trim() || undefined,
+                wallet: String(args.wallet || '').trim() || undefined,
+            }, { did: ctx.identity?.did || '', name: ctx.identity?.name || 'agent', wallet: String(args.wallet || '') });
+            return r.ok
+                ? { success: true, output: `✅ 已加入 Agent 网络: ${args.capability} @ ${args.price} ${args.currency}/${args.per}` }
+                : { success: false, error: r.error };
+        },
+    });
+    ctx.tools.set('gateway_call', {
+        name: 'gateway_call',
+        description: '通过 Agent Gateway 调用服务 (自动闭环: 发现→预算→验证门→执行→信誉). task: 任务描述; budget: 预算 (USDC); capability: 需要的能力. 需人工确认的支付会返回 approval 待审批.',
+        parameters: {
+            task: '任务描述 (必填)',
+            budget: '预算 USDC (必填)',
+            capability: '需要的能力 (可选, 如 research)',
+            url: '服务端点 URL (可选)',
+        },
+        execute: async (args) => {
+            const task = String(args.task || '').trim();
+            const budget = Number(args.budget);
+            if (!task || !budget || budget <= 0)
+                return { success: false, error: 'task 和 budget(>0) 必填' };
+            try {
+                const { gatewayCallAgent } = await import('./agent-gateway.js');
+                const r = await gatewayCallAgent({
+                    task,
+                    budget,
+                    capability: String(args.capability || '').trim() || undefined,
+                    url: String(args.url || '').trim() || undefined,
+                });
+                if (r.success)
+                    return { success: true, output: `✅ ${r.provider}: ${r.output}` };
+                return { success: false, error: r.error, requiresApproval: r.requiresApproval, approvalId: r.approvalId, provider: r.provider };
+            }
+            catch (e) {
+                return { success: false, error: `gateway_call 失败: ${String(e?.message || e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('gateway_join', {
+        name: 'gateway_join',
+        description: '通过链接加入共享 Agent 网络 (拉取远端服务合并到本地 registry). link: ipns://<name> 或 orbitdb://<address> 或 https://.../registry. 加入后可用 gateway_call 调用网络里的服务.',
+        parameters: { link: '网络链接 (必填, ipns:// / orbitdb:// / https://)' },
+        execute: async (args) => {
+            const link = String(args.link || '').trim();
+            if (!link)
+                return { success: false, error: 'link 必填 (ipns:// / orbitdb:// / https://)' };
+            try {
+                const { joinNetwork } = await import('./gateway-network.js');
+                const r = await joinNetwork(link);
+                if (!r.ok)
+                    return { success: false, error: r.error };
+                return { success: true, output: `✅ 已加入 Agent 网络: 拉取 ${r.total} 个服务, 新增 ${r.joined} 个 (${r.linkKind})` };
+            }
+            catch (e) {
+                return { success: false, error: `gateway_join 失败: ${String(e?.message || e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('gateway_status', {
+        name: 'gateway_status',
+        description: '查看 Agent 网络状态 (已注册服务 + 信誉 + 已加入的网络).',
+        parameters: {},
+        execute: async () => {
+            try {
+                const { gatewayStatus } = await import('./agent-gateway.js');
+                const { listJoinedNetworks } = await import('./gateway-network.js');
+                const nets = await listJoinedNetworks();
+                const netLine = nets.length
+                    ? `\n已加入网络 (${nets.length}):\n` + nets.slice(0, 10).map((n) => `  [${n.kind}] ${n.name || n.link.slice(0, 48)} (${n.serviceCount} 服务, ${n.joinedAt.slice(0, 10)})`).join('\n')
+                    : '\n(未加入任何网络, 收到 orbitdb:// 链接会自动加入, 或用 gateway_join)';
+                return { success: true, output: (await gatewayStatus()) + netLine };
+            }
+            catch (e) {
+                return { success: false, error: `gateway_status 失败: ${String(e?.message || e).slice(0, 200)}` };
+            }
+        },
+    });
+    ctx.tools.set('gateway_share', {
+        name: 'gateway_share',
+        description: '生成本 Agent 网络的分享链接 (orbitdb://...). 把链接发给其他 Bolloon/Agent, 对方收到后会自动加入你的网络并发现你注册的服务.',
+        parameters: {
+            name: '网络名 (可选, 默认 registry 名)',
+        },
+        execute: async (args) => {
+            try {
+                const { shareNetworkLink } = await import('./gateway-network.js');
+                const name = String(args.name || '').trim() || undefined;
+                const r = await shareNetworkLink(name ? { name } : undefined);
+                if (!r.ok)
+                    return { success: false, error: r.error };
+                return { success: true, output: `🔗 Agent 网络分享链接 (对方收到后自动加入):\n${r.link}` };
+            }
+            catch (e) {
+                return { success: false, error: `gateway_share 失败: ${String(e?.message || e).slice(0, 200)}` };
+            }
+        },
+    });
     // ============================================================
     // publish_did (2026-08-03) — 把当前 agent 的 DID 发布到 IPFS + IPNS
     // 全自动: 自动安装/启动本地 Kubo → 上传 DID 文档 → 发布 IPNS name

package/dist/constraint-runtime/tools/PolymarketSDK/econ-integration.d.ts

@@ -0,0 +1,55 @@
+/**
+ * econ-integration.ts — Polymarket × Agent 经济网络集成 (2026-08-13, Task C4)
+ *
+ * 打通 Agent Economic Network 与 Polymarket 预测市场:
+ *   - Agent 可用 Treasury 资金在 Polymarket 下单 (预测/对冲)
+ *   - 下单前过 Policy Engine (预算/授权)
+ *   - 订单结果 (成交/收益) 记录回经济层 (审计)
+ *
+ * Polymarket 合约架构 (Polygon):
+ *   - CLOB (链上订单簿): createOrder/getOrders/cancelOrder (现有 SDK)
+ *   - CTF 条件代币框架: 市场 = 条件代币对 (Yes/No)
+ *   - NegRisk 适配器: 互斥结果市场
+ *   收益结算在链上 (USDC), Agent Treasury 可接收.
+ */
+import { type CreateOrderParams, type CreateOrderResult } from './createOrder.js';
+import { type GetOrdersParams, type GetOrdersResult } from './getOrders.js';
+export interface EconOrderOptions {
+    /** 预算上限 (USDC) — 经 Policy Engine 检查 */
+    maxSpendUsdc?: number;
+    /** 服务名 (Policy 白名单用, 默认 polymarket) */
+    service?: string;
+    /** 是否记录经济审计 */
+    audit?: boolean;
+    /** 注入 Policy 检查回调 (根包 Agent 经济层注入; 子包不跨包 import) */
+    policyCheck?: (intent: {
+        payTo: string;
+        amount: number;
+        service?: string;
+    }) => Promise<{
+        allowed: boolean;
+        reason?: string;
+    }>;
+    /** 注入花费记录回调 */
+    recordSpend?: (amount: number) => Promise<void>;
+    /** 注入 createOrder 实现 (测试 mock; 默认真实 CLOB) */
+    createOrderImpl?: (params: CreateOrderParams) => Promise<CreateOrderResult>;
+}
+export interface EconOrderResult {
+    success: boolean;
+    order?: CreateOrderResult;
+    policy?: {
+        allowed: boolean;
+        reason?: string;
+    };
+    error?: string;
+}
+/**
+ * 带 Policy 检查的 Polymarket 下单.
+ * 流程: 金额 → Policy 授权 (回调注入) → CLOB 下单.
+ */
+export declare function createOrderEcon(params: CreateOrderParams, opts?: EconOrderOptions): Promise<EconOrderResult>;
+/** 查询订单 (含经济层关联信息) */
+export declare function getOrdersEcon(params?: GetOrdersParams): Promise<GetOrdersResult>;
+/** Polymarket 合约架构摘要 (文档化, 供 Agent 理解) */
+export declare const POLYMARKET_CONTRACT_OVERVIEW = "\nPolymarket \u5408\u7EA6\u67B6\u6784 (Polygon):\n- CLOB: \u94FE\u4E0A\u8BA2\u5355\u7C3F (createOrder/getOrders/cancelOrder)\n- CTF (Conditional Token Framework): \u5E02\u573A = \u6761\u4EF6\u4EE3\u5E01\u5BF9 Yes/No\n- NegRisk \u9002\u914D\u5668: \u4E92\u65A5\u7ED3\u679C\u5E02\u573A (\u5982\"\u54EA\u4E2A\u5019\u9009\u4EBA\u80DC\u51FA\")\n- \u7ED3\u7B97: USDC \u94FE\u4E0A, \u6536\u76CA\u53EF\u56DE\u6536\u5230 Agent Treasury\n- Agent \u96C6\u6210: Treasury \u8D44\u91D1 \u2192 Policy \u6388\u6743 \u2192 CLOB \u4E0B\u5355 \u2192 \u7ED3\u679C \u2192 \u6536\u76CA\u56DE\u6D41\n";

package/dist/constraint-runtime/tools/PolymarketSDK/econ-integration.js

@@ -0,0 +1,59 @@
+/**
+ * econ-integration.ts — Polymarket × Agent 经济网络集成 (2026-08-13, Task C4)
+ *
+ * 打通 Agent Economic Network 与 Polymarket 预测市场:
+ *   - Agent 可用 Treasury 资金在 Polymarket 下单 (预测/对冲)
+ *   - 下单前过 Policy Engine (预算/授权)
+ *   - 订单结果 (成交/收益) 记录回经济层 (审计)
+ *
+ * Polymarket 合约架构 (Polygon):
+ *   - CLOB (链上订单簿): createOrder/getOrders/cancelOrder (现有 SDK)
+ *   - CTF 条件代币框架: 市场 = 条件代币对 (Yes/No)
+ *   - NegRisk 适配器: 互斥结果市场
+ *   收益结算在链上 (USDC), Agent Treasury 可接收.
+ */
+import { createOrder as pmCreateOrder } from './createOrder.js';
+import { getOrders as pmGetOrders } from './getOrders.js';
+/**
+ * 带 Policy 检查的 Polymarket 下单.
+ * 流程: 金额 → Policy 授权 (回调注入) → CLOB 下单.
+ */
+export async function createOrderEcon(params, opts = {}) {
+    const amountUsdc = Number(params.price) * Number(params.size ?? 1);
+    // 1. Policy 授权 (预算/白名单) — 回调注入, 不跨包
+    if (opts.policyCheck) {
+        const decision = await opts.policyCheck({
+            payTo: 'polymarket-clob',
+            amount: amountUsdc,
+            service: opts.service || 'polymarket',
+        });
+        if (!decision.allowed) {
+            return { success: false, policy: { allowed: false, reason: `[policy] ${decision.reason}` } };
+        }
+        await opts.recordSpend?.(amountUsdc).catch(() => { });
+    }
+    else if (opts.maxSpendUsdc !== undefined && amountUsdc > opts.maxSpendUsdc) {
+        return { success: false, policy: { allowed: false, reason: `Polymarket 下单超预算: ${amountUsdc} > ${opts.maxSpendUsdc}` } };
+    }
+    // 2. CLOB 下单 (可注入 mock, 默认真实)
+    try {
+        const order = opts.createOrderImpl ? await opts.createOrderImpl(params) : await pmCreateOrder(params);
+        return { success: true, order, policy: { allowed: true } };
+    }
+    catch (e) {
+        return { success: false, error: `Polymarket 下单失败: ${String(e?.message || e).slice(0, 200)}` };
+    }
+}
+/** 查询订单 (含经济层关联信息) */
+export async function getOrdersEcon(params = {}) {
+    return pmGetOrders(params);
+}
+/** Polymarket 合约架构摘要 (文档化, 供 Agent 理解) */
+export const POLYMARKET_CONTRACT_OVERVIEW = `
+Polymarket 合约架构 (Polygon):
+- CLOB: 链上订单簿 (createOrder/getOrders/cancelOrder)
+- CTF (Conditional Token Framework): 市场 = 条件代币对 Yes/No
+- NegRisk 适配器: 互斥结果市场 (如"哪个候选人胜出")
+- 结算: USDC 链上, 收益可回收到 Agent Treasury
+- Agent 集成: Treasury 资金 → Policy 授权 → CLOB 下单 → 结果 → 收益回流
+`;

package/dist/orbitdb/cid-database.js

@@ -151,15 +151,9 @@ export class OrbitDBAdapter {
         await this.node.helia.blockstore.put(CID.parse(rec.id), dagCbor.encode(rec));
         return `bolloon-cid://${rec.id}`;
     }
-    /**
-     * 2026-08-08: 在同一 OrbitDB 实例上打开附加 store。
-     * events 类型 = append-only 事件流 (WAL 复制 / 轨迹流用).
-     * 返回的 store 是通用适配 (put=keyvalue / add=events).
-     */
-    async openStore(name, type = 'keyvalue') {
-        await this.ensure();
-        const raw = (await this._orbitdb.open(name, { type }));
-        const store = {
+    /** 打开 store 的通用适配 (keyvalue/events 统一成 OrbitDBStore) */
+    wrapStore(raw) {
+        return {
             address: raw.address,
             put: async (key, value) => { await raw.put(key, JSON.parse(JSON.stringify(value))); },
             add: async (value) => { await raw.add(JSON.parse(JSON.stringify(value))); },
@@ -190,7 +184,42 @@ export class OrbitDBAdapter {
                 };
             },
         };
-        return store;
+    }
+    /**
+     * 2026-08-08: 在同一 OrbitDB 实例上打开附加 store。
+     * events 类型 = append-only 事件流 (WAL 复制 / 轨迹流用).
+     * opts.accessController: 群组用 write:['*'] (任何人可写).
+     */
+    async openStore(name, type = 'keyvalue', opts) {
+        await this.ensure();
+        const options = { type };
+        if (opts?.accessController)
+            options.accessController = opts.accessController;
+        const raw = (await this._orbitdb.open(name, options));
+        return this.wrapStore(raw);
+    }
+    /**
+     * 2026-08-14: 按地址打开远端 store (Agent Gateway 共享网络 / 群组)。
+     * replica=true → 只读副本: 拉取复制但不写回 (自动加入网络不污染他人 registry)。
+     * replica=false → 可写 (群组: events store 配 write:'*' 时成员可广播)。
+     */
+    async openStoreByAddress(address, type = 'keyvalue', opts) {
+        await this.ensure();
+        try {
+            const options = { type };
+            if (opts?.replica === false)
+                options.replica = false;
+            else
+                options.replica = true;
+            if (opts?.accessController)
+                options.accessController = opts.accessController;
+            const raw = (await this._orbitdb.open(address, options));
+            return this.wrapStore(raw);
+        }
+        catch (err) {
+            console.warn(`[orbitdb] openStoreByAddress 失败: ${String(err?.message || err).slice(0, 160)}`);
+            return null;
+        }
     }
     async close() {
         try {

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>