@bolloon/bolloon-agent 0.4.23 → 0.4.24

package/dist/ios/mobile-core.js

@@ -86151,11 +86151,16 @@ ${[...listenStats.errors.entries()].map(([addr, err2]) => {
   // src/web/mobile-p2p.ts
   var mobile_p2p_exports = {};
   __export(mobile_p2p_exports, {
+    RELAY_HOP_PROTOCOL: () => RELAY_HOP_PROTOCOL,
     addMobilePeer: () => addMobilePeer,
+    getMobileCircuitAddrs: () => getMobileCircuitAddrs,
     getMobileP2PConnections: () => getMobileP2PConnections,
     getMobileP2PState: () => getMobileP2PState,
+    getMobileRelayReservations: () => getMobileRelayReservations,
+    getMobileRelays: () => getMobileRelays,
     listMobilePeerAddrs: () => listMobilePeerAddrs,
     onMobileP2PMessage: () => onMobileP2PMessage,
+    reserveMobileRelay: () => reserveMobileRelay,
     sendMobileP2PMessage: () => sendMobileP2PMessage,
     startMobileP2P: () => startMobileP2P
   });
@@ -86175,7 +86180,13 @@ ${[...listenStats.errors.entries()].map(([addr, err2]) => {
   async function startMobileP2P(cfg = {}) {
     if (node) return state;
     try {
+      const relayListen = (cfg.relayAddrs || []).map((a) => (a || "").trim().replace(/\/p2p-circuit\/?$/, "")).filter((a) => /\/p2p\/[^/]+$/.test(a)).map((a) => `${a}/p2p-circuit`);
       node = await createLibp2p({
+        // 2026-09-11: 手机唯一的「可被拨入」途径 = 向中继预约。
+        // listen /p2p-circuit 会在传输层 reserveRelay() 一个待预约名额; 之后只要连上
+        // 一个广播了 hop 协议的中继, 就会自动预约并拿到 <relay>/p2p-circuit/p2p/<本机>。
+        // (WebView 不能 listen ip4/ip6 → 只有这一类 listen 项是有意义的。)
+        addresses: { listen: ["/p2p-circuit", ...relayListen] },
         transports: [webSockets(), circuitRelayTransport()],
         connectionEncrypters: [noise()],
         streamMuxers: [yamux()],
@@ -86232,6 +86243,16 @@ ${[...listenStats.errors.entries()].map(([addr, err2]) => {
           console.warn(`[mobile-p2p] failed to dial saved ${addr}:`, String(e).slice(0, 100));
         }
       }
+      for (const addr of cfg.relayAddrs || []) {
+        if (getMobileCircuitAddrs().length > 0) break;
+        const r = await reserveMobileRelay(addr);
+        console.log(
+          `[mobile-p2p] relay reserve ${addr} \u2192 ok=${r.ok} circuitAddrs=${r.circuitAddrs.length}` + (r.error ? ` err=${String(r.error).slice(0, 140)}` : "")
+        );
+      }
+      if (getMobileCircuitAddrs().length > 0) {
+        console.log(`[mobile-p2p] \u53EF\u62E8\u5165\u5730\u5740: ${getMobileCircuitAddrs().join(" , ")}`);
+      }
       refreshState();
       return state;
     } catch (e) {
@@ -86317,6 +86338,58 @@ ${[...listenStats.errors.entries()].map(([addr, err2]) => {
   function listMobilePeerAddrs() {
     return [...peerAddrs];
   }
+  function getMobileCircuitAddrs() {
+    if (!node) return [];
+    try {
+      return (node.getMultiaddrs() || []).map((a) => typeof a?.toString === "function" ? a.toString() : String(a)).filter((a) => a.includes("/p2p-circuit")).sort((a, b) => wsFirstRank(a) - wsFirstRank(b));
+    } catch {
+      return [];
+    }
+  }
+  function getMobileRelays() {
+    const out = [];
+    for (const a of getMobileCircuitAddrs()) {
+      const head = a.split("/p2p-circuit")[0] || "";
+      const ids = head.match(/\/p2p\/([^/]+)/g) || [];
+      const last = ids[ids.length - 1];
+      const relay = last ? last.slice("/p2p/".length) : "";
+      if (relay && !out.includes(relay)) out.push(relay);
+    }
+    return out;
+  }
+  function getMobileRelayReservations() {
+    return relayReservationResults.map((r) => ({ ...r }));
+  }
+  async function reserveMobileRelay(relayAddr) {
+    const raw = (relayAddr || "").trim();
+    if (!node) return { ok: false, circuitAddrs: [], error: "P2P \u8282\u70B9\u672A\u542F\u52A8" };
+    if (!raw) return { ok: false, circuitAddrs: [], error: "\u4E2D\u7EE7\u5730\u5740\u4E3A\u7A7A" };
+    const base6 = raw.replace(/\/p2p-circuit\/?$/, "");
+    if (!/\/p2p\/[^/]+$/.test(base6)) {
+      const err2 = "\u4E2D\u7EE7\u5730\u5740\u5FC5\u987B\u5E26 /p2p/<\u4E2D\u7EE7PeerId> (\u6CA1\u6709 PeerId \u65E0\u6CD5\u9884\u7EA6)";
+      relayReservationResults.push({ addr: raw, ok: false, error: err2 });
+      return { ok: false, circuitAddrs: [], error: err2 };
+    }
+    try {
+      const listenAddr = multiaddr(`${base6}/p2p-circuit`);
+      if (typeof node.listen === "function") {
+        await node.listen(listenAddr);
+      } else if (node.components?.transportManager?.listen) {
+        await node.components.transportManager.listen([listenAddr]);
+      } else {
+        throw new Error("\u672C\u7248\u672C libp2p \u65E2\u65E0 node.listen() \u4E5F\u65E0 components.transportManager.listen() \u2014\u2014 \u4E2D\u7EE7\u5730\u5740\u5FC5\u987B\u5728 createLibp2p \u7684 addresses.listen \u91CC\u7ED9");
+      }
+      const circuitAddrs = getMobileCircuitAddrs();
+      const relay = getMobileRelays().slice(-1)[0];
+      relayReservationResults.push({ addr: raw, ok: circuitAddrs.length > 0, relay, error: circuitAddrs.length ? void 0 : "\u9884\u7EA6\u8FD4\u56DE\u4F46\u672A\u62FF\u5230 /p2p-circuit \u5730\u5740" });
+      return { ok: circuitAddrs.length > 0, circuitAddrs };
+    } catch (e) {
+      const err2 = String(e?.message || e).slice(0, 240);
+      relayReservationResults.push({ addr: raw, ok: false, error: err2 });
+      console.warn("[mobile-p2p] relay reservation failed:", err2);
+      return { ok: false, circuitAddrs: getMobileCircuitAddrs(), error: err2 };
+    }
+  }
   async function addMobilePeer(addr) {
     const normalized = (addr || "").trim();
     if (!normalized) return { ok: false, error: "\u5730\u5740\u4E0D\u80FD\u4E3A\u7A7A" };
@@ -86340,7 +86413,7 @@ ${[...listenStats.errors.entries()].map(([addr, err2]) => {
       return { ok: false, error: "\u8FDE\u63A5\u5931\u8D25: " + String(e?.message || e).slice(0, 120) };
     }
   }
-  var node, state, msgHandlers, peerAddrs;
+  var RELAY_HOP_PROTOCOL, node, state, msgHandlers, relayReservationResults, peerAddrs, wsFirstRank;
   var init_mobile_p2p = __esm({
     "src/web/mobile-p2p.ts"() {
       "use strict";
@@ -86354,13 +86427,24 @@ ${[...listenStats.errors.entries()].map(([addr, err2]) => {
       init_src72();
       init_src74();
       init_src14();
+      RELAY_HOP_PROTOCOL = "/libp2p/circuit/relay/0.2.0/hop";
       node = null;
       state = { connected: false, peerCount: 0, peerIds: [] };
       msgHandlers = [];
+      relayReservationResults = [];
       peerAddrs = [];
       loadPeerAddrs();
+      wsFirstRank = (a) => {
+        const parts = a.split("/");
+        return parts.includes("ws") || parts.includes("wss") ? 0 : 1;
+      };
       if (typeof globalThis !== "undefined") {
-        globalThis.__mobileP2PStateSync = () => ({ ...state });
+        globalThis.__mobileP2PStateSync = () => ({
+          ...state,
+          circuitAddrs: getMobileCircuitAddrs(),
+          relays: getMobileRelays(),
+          relayReservations: getMobileRelayReservations()
+        });
       }
     }
   });
@@ -86571,15 +86655,20 @@ ${[...listenStats.errors.entries()].map(([addr, err2]) => {
   // src/web/mobile-agent.ts
   var mobile_agent_exports = {};
   __export(mobile_agent_exports, {
+    MOBILE_JOIN_DOC_RE: () => MOBILE_JOIN_DOC_RE,
     callRemoteAgent: () => callRemoteAgent,
     cancelPhoneAgent: () => cancelPhoneAgent,
     default: () => mobile_agent_default,
+    detectJoinDocUrl: () => detectJoinDocUrl,
     ensureIdentity: () => ensureIdentity,
+    formatMobileJoinResult: () => formatMobileJoinResult,
     getLastWorklog: () => getLastWorklog,
     getLlmConfig: () => getLlmConfig,
+    getMobileJoinState: () => getMobileJoinState,
     handleIncomingAgentMessage: () => handleIncomingAgentMessage,
     handleIncomingPhoneMessage: () => handleIncomingPhoneMessage,
     identityStatus: () => identityStatus,
+    joinGatewayFromDoc: () => joinGatewayFromDoc,
     loginIdentity: () => loginIdentity,
     logoutIdentity: () => logoutIdentity,
     notifyAgentReply: () => notifyAgentReply,
@@ -86726,9 +86815,171 @@ ${[...listenStats.errors.entries()].map(([addr, err2]) => {
     } catch {
     }
   }
+  function detectJoinDocUrl(text) {
+    const m2 = MOBILE_JOIN_DOC_RE.exec(String(text || ""));
+    return m2 ? m2[1] : null;
+  }
+  function parseFm(text) {
+    const m2 = /^---\r?\n([\s\S]*?)\r?\n---/.exec(String(text || ""));
+    if (!m2) return {};
+    const out = {};
+    for (const line of m2[1].split(/\r?\n/)) {
+      const kv = /^([A-Za-z_][\w-]*)\s*:\s*(.*)$/.exec(line.trim());
+      if (!kv) continue;
+      const k = kv[1].toLowerCase();
+      if (k === "name") out.name = kv[2].trim().replace(/^["']|["']$/g, "");
+      if (k === "version") out.version = kv[2].trim().replace(/^["']|["']$/g, "");
+    }
+    return out;
+  }
+  async function getMobileJoinState() {
+    try {
+      const raw = typeof localStorage !== "undefined" ? localStorage.getItem(MOBILE_JOIN_STATE_KEY) : null;
+      return raw ? JSON.parse(raw) : null;
+    } catch {
+      return null;
+    }
+  }
+  function saveMobileJoinState(s2) {
+    try {
+      if (typeof localStorage !== "undefined") localStorage.setItem(MOBILE_JOIN_STATE_KEY, JSON.stringify(s2));
+    } catch {
+    }
+  }
+  async function joinGatewayFromDoc(docUrl, opts = {}) {
+    const f = opts.fetchImpl || fetch;
+    const steps = [];
+    const url = String(docUrl || "").trim();
+    if (!/^https?:\/\//i.test(url)) {
+      return { ok: false, docUrl: url, steps, error: `\u5165\u7F51\u8BF4\u660E\u5730\u5740\u5FC5\u987B\u662F http(s) URL (\u6536\u5230: ${url.slice(0, 60)})` };
+    }
+    let docVersion;
+    try {
+      const r = await f(url, { signal: AbortSignal.timeout(opts.timeoutMs ?? 15e3) });
+      if (!r.ok) {
+        steps.push({ step: "\u8BFB\u5165\u7F51\u8BF4\u660E", ok: false, note: `\u6587\u6863\u4E0D\u53EF\u8FBE (HTTP ${r.status})` });
+        return { ok: false, docUrl: url, steps, error: `\u5165\u7F51\u8BF4\u660E\u4E0D\u53EF\u8FBE (HTTP ${r.status})` };
+      }
+      const text = await r.text();
+      const fm = parseFm(text);
+      if (fm.name !== "bolloon-gateway-join" && !/加入网关|bolloon-gateway-join/.test(text)) {
+        steps.push({ step: "\u8BFB\u5165\u7F51\u8BF4\u660E", ok: false, note: `\u4E0D\u662F Bolloon \u5165\u7F51\u8BF4\u660E (name=${fm.name || "\u65E0"})` });
+        return { ok: false, docUrl: url, steps, error: "\u8BE5\u6587\u6863\u4E0D\u662F Bolloon \u7F51\u5173\u5165\u7F51\u8BF4\u660E, \u62D2\u7EDD\u636E\u6B64\u5165\u7F51" };
+      }
+      docVersion = fm.version;
+      steps.push({ step: "\u8BFB\u5165\u7F51\u8BF4\u660E", ok: true, note: `${fm.name || "bolloon-gateway-join"} v${fm.version || "?"} (${text.length} \u5B57\u7B26)` });
+    } catch (e) {
+      steps.push({ step: "\u8BFB\u5165\u7F51\u8BF4\u660E", ok: false, note: `\u8BFB\u53D6\u5931\u8D25: ${String(e?.message || e).slice(0, 120)}` });
+      return { ok: false, docUrl: url, steps, error: `\u5165\u7F51\u8BF4\u660E\u8BFB\u53D6\u5931\u8D25: ${String(e?.message || e).slice(0, 120)}` };
+    }
+    let did = String(opts.did || "");
+    if (did) {
+      steps.push({ step: "DID \u8EAB\u4EFD", ok: true, note: `${did} (\u6CE8\u5165\u8EAB\u4EFD)` });
+    } else {
+      try {
+        const id = await ensureIdentity();
+        did = id.did;
+        steps.push({ step: "DID \u8EAB\u4EFD", ok: true, note: `${did} (\u624B\u673A\u7AEF\u672C\u673A\u751F\u6210)` });
+      } catch (e) {
+        steps.push({ step: "DID \u8EAB\u4EFD", ok: false, note: String(e?.message || e).slice(0, 120) });
+        return { ok: false, docUrl: url, docVersion, steps, error: "\u624B\u673A\u7AEF DID \u751F\u6210\u5931\u8D25" };
+      }
+    }
+    const name10 = String(opts.name || "phone-agent");
+    const capabilities = ["chat", "gateway-join"];
+    let desktopBase = String(opts.desktopBaseUrl ?? "");
+    if (opts.desktopBaseUrl === void 0) {
+      try {
+        const g = await Promise.resolve().then(() => (init_mobile_gateway(), mobile_gateway_exports));
+        desktopBase = String(g.getDesktopBaseUrl() || "");
+      } catch {
+        desktopBase = "";
+      }
+    }
+    desktopBase = desktopBase.replace(/\/+$/, "");
+    let registeredOn = "local";
+    if (desktopBase) {
+      try {
+        const r = await f(`${desktopBase}/api/registry/register`, {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify({
+            agentId: did,
+            name: name10,
+            wallet: "",
+            service: { name: "chat", description: "\u624B\u673A\u7AEF\u667A\u80FD\u4F53 (\u81EA\u8DB3\u8282\u70B9)", price: { amount: "0", currency: "USDC", per: "task" }, endpoint: "" },
+            capabilities
+          }),
+          signal: AbortSignal.timeout(opts.timeoutMs ?? 15e3)
+        });
+        if (r.ok) {
+          registeredOn = "desktop";
+          steps.push({ step: "\u670D\u52A1\u767B\u8BB0", ok: true, note: `\u5DF2\u767B\u8BB0\u8FDB\u7535\u8111\u7AEF\u7F51\u7EDC registry (${desktopBase}) \u2014\u2014 \u7F51\u7EDC\u5185\u5176\u4ED6\u667A\u80FD\u4F53\u53EF\u6309\u80FD\u529B\u53D1\u73B0\u6211` });
+        } else {
+          steps.push({ step: "\u670D\u52A1\u767B\u8BB0", ok: false, note: `\u7535\u8111\u7AEF registry \u62D2\u7EDD (HTTP ${r.status}); \u5DF2\u6539\u4E3A\u672C\u673A\u767B\u8BB0` });
+        }
+      } catch (e) {
+        steps.push({ step: "\u670D\u52A1\u767B\u8BB0", ok: false, note: `\u7535\u8111\u7AEF\u4E0D\u53EF\u8FBE (${String(e?.message || e).slice(0, 80)}); \u5DF2\u6539\u4E3A\u672C\u673A\u767B\u8BB0` });
+      }
+    } else {
+      steps.push({ step: "\u670D\u52A1\u767B\u8BB0", ok: true, note: "\u672A\u914D\u7F6E\u7535\u8111\u7AEF\u57FA\u5740 \u2192 \u53EA\u5728\u672C\u673A\u767B\u8BB0 (\u624B\u673A\u662F\u81EA\u6CBB\u8282\u70B9; \u8BBE\u7F6E\u91CC\u586B\u7535\u8111\u7AEF\u5730\u5740\u53EF\u767B\u8BB0\u8FDB\u7F51\u7EDC registry)" });
+    }
+    try {
+      const p2p = await Promise.resolve().then(() => (init_mobile_p2p(), mobile_p2p_exports));
+      let peers = 0;
+      try {
+        peers = (p2p.getConnectedPeers?.() || []).length;
+      } catch {
+        peers = 0;
+      }
+      if (peers > 0 && typeof p2p.sendMobileP2PMessage === "function") {
+        const okAnnounce = await p2p.sendMobileP2PMessage("*", "registry.register", JSON.stringify({ agent_id: did, name: name10, capabilities }), did);
+        steps.push({ step: "P2P \u516C\u544A", ok: !!okAnnounce, note: okAnnounce ? `\u5DF2\u5411 ${peers} \u4E2A\u5BF9\u7AEF\u5E7F\u64AD\u672C\u673A\u58F0\u660E` : `\u5E7F\u64AD\u5931\u8D25 (\u5BF9\u7AEF ${peers} \u4E2A)` });
+      } else {
+        steps.push({ step: "P2P \u516C\u544A", ok: false, note: "\u5F53\u524D\u65E0\u5DF2\u8FDE\u63A5\u5BF9\u7AEF (\u6D4F\u89C8\u5668/\u672A\u8FDE\u7535\u8111\u7AEF\u65F6\u6B63\u5E38) \u2014 \u672C\u673A\u58F0\u660E\u5DF2\u5C31\u7EEA, \u8FDE\u4E0A\u5373\u751F\u6548" });
+      }
+    } catch (e) {
+      steps.push({ step: "P2P \u516C\u544A", ok: false, note: `P2P \u5C42\u4E0D\u53EF\u7528: ${String(e?.message || e).slice(0, 80)}` });
+    }
+    saveMobileJoinState({ url, did, name: name10, capabilities, docVersion, registeredOn, desktopBaseUrl: desktopBase || void 0, joinedAt: (/* @__PURE__ */ new Date()).toISOString() });
+    const state2 = await getMobileJoinState();
+    steps.push({ step: "\u843D\u76D8\u5165\u7F51\u6001", ok: !!state2?.did, note: `localStorage:${MOBILE_JOIN_STATE_KEY}` });
+    return { ok: true, docUrl: url, docVersion, did, steps };
+  }
+  function formatMobileJoinResult(r) {
+    if (!r.ok) {
+      return `\u274C \u5165\u7F51\u5931\u8D25: ${r.error || "\u672A\u77E5\u539F\u56E0"}
+
+${r.steps.map((s3) => `${s3.ok ? "\u2713" : "\u2717"} ${s3.step}: ${s3.note}`).join("\n")}`;
+    }
+    const s2 = r.steps.find((x) => x.step === "\u670D\u52A1\u767B\u8BB0");
+    return [
+      "\u2705 \u5DF2\u52A0\u5165\u5168\u7403\u667A\u80FD\u4F53\u7F51\u7EDC (\u624B\u673A\u7AEF\u81EA\u8DB3\u6267\u884C)",
+      "",
+      `DID: ${r.did}`,
+      `\u5165\u7F51\u8BF4\u660E: v${r.docVersion || "?"} (${r.docUrl})`,
+      s2 ? `\u767B\u8BB0: ${s2.note}` : "",
+      "",
+      ...r.steps.map((x) => `${x.ok ? "\u2713" : "\u2717"} ${x.step}: ${x.note}`),
+      "",
+      "\u7528\u300C\u7F51\u7EDC \u2192 Agent \u7F51\u7EDC\u300D\u53EF\u67E5\u770B\u6210\u5458; \u8BBE\u7F6E\u91CC\u586B\u7535\u8111\u7AEF\u5730\u5740\u53EF\u628A\u672C\u673A\u767B\u8BB0\u8FDB\u7F51\u7EDC registry\u3002"
+    ].filter((l) => l !== "").join("\n");
+  }
   async function runLocalAgent(goal) {
     const win = typeof window !== "undefined" ? window : null;
     const cap = win?.Capacitor;
+    const joinDocUrl = detectJoinDocUrl(goal);
+    if (joinDocUrl) {
+      _lastWorklog = [`\u{1F9E9} \u8BC6\u522B\u4E3A\u5165\u7F51\u53E3\u4EE4: ${joinDocUrl}`];
+      const r = await joinGatewayFromDoc(joinDocUrl).catch((e) => ({
+        ok: false,
+        docUrl: joinDocUrl,
+        steps: [{ step: "\u5165\u7F51", ok: false, note: String(e?.message || e).slice(0, 120) }],
+        error: String(e?.message || e)
+      }));
+      _lastWorklog = [..._lastWorklog, ...r.steps.map((s2) => `${s2.ok ? "\u2713" : "\u2717"} ${s2.step}: ${s2.note}`)];
+      return formatMobileJoinResult(r);
+    }
     const bridge = cap && cap.Plugins && cap.Plugins.RokidBridge;
     if (bridge && cap.isNativePlatform?.()) {
       try {
@@ -86984,7 +87235,7 @@ ${[...listenStats.errors.entries()].map(([addr, err2]) => {
     } catch {
     }
   }
-  var IDENTITY_DB, _identity, _identityDb, _llmConfig, _lastWorklog, _send, _ownDid, replyHandlers, inboundChatHandlers, mobile_agent_default;
+  var IDENTITY_DB, _identity, _identityDb, _llmConfig, _lastWorklog, MOBILE_JOIN_DOC_RE, MOBILE_JOIN_STATE_KEY, _send, _ownDid, replyHandlers, inboundChatHandlers, mobile_agent_default;
   var init_mobile_agent = __esm({
     "src/web/mobile-agent.ts"() {
       "use strict";
@@ -86994,6 +87245,8 @@ ${[...listenStats.errors.entries()].map(([addr, err2]) => {
       _identityDb = null;
       _llmConfig = null;
       _lastWorklog = [];
+      MOBILE_JOIN_DOC_RE = /read\s+(https?:\/\/\S*bolloon-gateway-join\.md)/i;
+      MOBILE_JOIN_STATE_KEY = "bolloon_gateway_join";
       _send = null;
       _ownDid = "";
       replyHandlers = /* @__PURE__ */ new Set();
@@ -99765,13 +100018,21 @@ ${[...listenStats.errors.entries()].map(([addr, err2]) => {
       if (!r.ok) return { ok: false, addrs: [], error: `\u7535\u8111\u7AEF\u8FD4\u56DE ${r.status}` };
       const j = await r.json();
       const raw = Array.isArray(j?.wsAddrs) ? j.wsAddrs : [];
-      const addrs = raw.map((a) => {
-        let out = a;
-        if (host) out = out.replace(/\/ip4\/(0\.0\.0\.0|127\.0\.0\.1)\//, `/ip4/${host}/`);
-        out = out.replace(/\/ip6\/::1\//, `/ip4/${host || "127.0.0.1"}/`);
-        return out;
-      }).filter((a) => ip4Of(a) && !/\/ip4\/(0\.0\.0\.0|127\.0\.0\.1)\//.test(a));
-      return { ok: j?.ok !== false, peerId: j?.peerId || "", addrs: Array.from(new Set(addrs)) };
+      const rewrite = (a) => {
+        let out2 = a;
+        if (host) out2 = out2.replace(/\/ip4\/(0\.0\.0\.0|127\.0\.0\.1)\//, `/ip4/${host}/`);
+        out2 = out2.replace(/\/ip6\/::1\//, `/ip4/${host || "127.0.0.1"}/`);
+        return out2;
+      };
+      const keep = (a) => ip4Of(a) && !/\/ip4\/(0\.0\.0\.0|127\.0\.0\.1)\//.test(a);
+      const addrs = raw.map(rewrite).filter(keep);
+      const relayRaw = Array.isArray(j?.relayAddrs) ? j.relayAddrs : [];
+      const relayAddrs = relayRaw.map(rewrite).filter(keep);
+      const out = { ok: j?.ok !== false, peerId: j?.peerId || "", addrs: Array.from(new Set(addrs)) };
+      if (j?.isRelay === true) out.isRelay = true;
+      if (relayAddrs.length) out.relayAddrs = Array.from(new Set(relayAddrs));
+      if (typeof j?.relayProtocol === "string") out.relayProtocol = j.relayProtocol;
+      return out;
     } catch (e) {
       return { ok: false, addrs: [], error: e?.message || String(e) };
     }
@@ -149882,6 +150143,32 @@ ${error.stack}` : head;
       return `error:${errMsg3(err2)}`;
     }
   }
+  function relaysFromCircuitAddrs(circuitAddrs) {
+    const out = [];
+    for (const a of circuitAddrs) {
+      const head = a.split("/p2p-circuit")[0] || "";
+      const ids = head.match(/\/p2p\/([^/]+)/g) || [];
+      const last = ids[ids.length - 1];
+      const relay = last ? last.slice("/p2p/".length) : "";
+      if (relay && !out.includes(relay)) out.push(relay);
+    }
+    return out;
+  }
+  function circuitInfoOf(libp2p) {
+    try {
+      const all2 = (libp2p?.getMultiaddrs?.() || []).map(
+        (a) => a && typeof a.toString === "function" ? a.toString() : String(a)
+      );
+      const isWs = (a) => {
+        const parts = a.split("/");
+        return parts.includes("ws") || parts.includes("wss");
+      };
+      const circuitAddrs = all2.filter((a) => a.includes("/p2p-circuit")).sort((a, b) => (isWs(a) ? 0 : 1) - (isWs(b) ? 0 : 1));
+      return { circuitAddrs, relays: relaysFromCircuitAddrs(circuitAddrs) };
+    } catch {
+      return { circuitAddrs: [], relays: [] };
+    }
+  }
   function verifyStarted(node2) {
     const peerId = peerIdOf(node2);
     const lps = libp2pStatusOf(node2);
@@ -150147,7 +150434,9 @@ ${error.stack}` : head;
         ok: true,
         running: false,
         peers: [],
-        libp2pStatus: "not-created"
+        libp2pStatus: "not-created",
+        circuitAddrs: [],
+        relays: []
       };
       if (lastStartError) out.lastError = lastStartError;
       return out;
@@ -150157,6 +150446,7 @@ ${error.stack}` : head;
       const libp2pStatus = libp2pStatusOf(node2);
       const peerId = currentPeerId ?? peerIdOf(node2);
       const running = libp2pError ? false : libp2p ? libp2pStatus === "started" : node2.status === "started";
+      const { circuitAddrs, relays } = circuitInfoOf(libp2p);
       let peers = [];
       try {
         const list = libp2p?.getPeers?.() || [];
@@ -150174,7 +150464,7 @@ ${error.stack}` : head;
           blockCount = void 0;
         }
       }
-      const out = { ok: true, running, peers, libp2pStatus };
+      const out = { ok: true, running, peers, libp2pStatus, circuitAddrs, relays };
       if (peerId) out.peerId = peerId;
       if (blockCount !== void 0) out.blockCount = blockCount;
       if (lastStartError) out.lastError = lastStartError;
@@ -150186,6 +150476,8 @@ ${error.stack}` : head;
         running: false,
         peers: [],
         libp2pStatus: libp2pStatusOf(node2),
+        circuitAddrs: [],
+        relays: [],
         error: errDetail(err2)
       };
       if (lastStartError) out.lastError = lastStartError;
@@ -162617,8 +162909,10 @@ ${error.stack}` : head;
     resolve(path) {
       const p = path || "";
       if (p === "/channels") return () => core.channels.get();
+      if (p === "/api/data/snapshot") return () => core.data.snapshot();
       if (p === "/api/peers") return () => core.peers.list();
       if (p === "/api/mcp/tools") return () => core.mcp.tools();
+      if (p === "/api/skills") return () => core.skills.list();
       if (p === "/api/auth/status") return () => core.identity.status();
       if (p === "/api/payments/pending") return () => core.payments.pending();
       if (p === "/api/llm-config") return () => core.data.getLlmConfig();
@@ -162652,6 +162946,7 @@ ${error.stack}` : head;
       if (p === "/api/desktop/url") return () => core.desktop.url();
       if (p === "/api/desktop/sync") return () => core.desktop.sync();
       if (p === "/api/judgments/cached") return () => core.desktop.judgments();
+      if (p === "/api/x402/info") return () => core.x402.list();
       if (p === "/api/orbit/status") return () => core.orbit.status();
       if (p === "/api/orbit/replica") return () => core.orbit.replica();
       if (p.startsWith("/sessions/")) {
@@ -162663,6 +162958,10 @@ ${error.stack}` : head;
     /** POST 路径 → 内核函数 */
     resolvePost(path, body) {
       const p = path || "";
+      if (p === "/api/mcp/call") {
+        const b = body || {};
+        return () => core.mcp.call(String(b.name || ""), b.args || {});
+      }
       if (p === "/message") {
         const b = body || {};
         return () => core.message.send({ text: b.text, channelId: b.channelId });
@@ -162752,6 +163051,10 @@ ${error.stack}` : head;
         const b = body || {};
         return () => core.desktop.setUrl(String(b.url || ""));
       }
+      if (p === "/api/x402/info/buy") {
+        const b = body || {};
+        return () => core.x402.buy(b);
+      }
       if (p === "/api/network/connect") return () => core.network.connect();
       if (p === "/api/social/announce") return () => core.social.announce();
       if (p === "/api/chain/config") {
@@ -162887,6 +163190,7 @@ ${error.stack}` : head;
           const dataLayer = await Promise.resolve().then(() => (init_mobile_data(), mobile_data_exports));
           const id = await agentLayer.ensureIdentity();
           let seeds = seedAddrs && seedAddrs.length ? seedAddrs : void 0;
+          let relayAddrs;
           let desktopPeer = "";
           if (!seeds) {
             try {
@@ -162896,10 +163200,11 @@ ${error.stack}` : head;
                 seeds = d2.addrs;
                 desktopPeer = d2.peerId || "";
               }
+              if (d2.ok && Array.isArray(d2.relayAddrs) && d2.relayAddrs.length) relayAddrs = d2.relayAddrs;
             } catch {
             }
           }
-          const st = await startMobileP2P2({ seedAddrs: seeds, ownDid: id.did });
+          const st = await startMobileP2P2({ seedAddrs: seeds, ownDid: id.did, relayAddrs });
           if (desktopPeer) busBroadcast({ type: "p2p-desktop", peerId: desktopPeer, addrs: seeds || [] });
           try {
             const social = await Promise.resolve().then(() => (init_mobile_social(), mobile_social_exports));
@@ -163168,6 +163473,50 @@ ${error.stack}` : head;
         return { judgments: s2.getCachedJudgments() };
       }
     },
+    // 微信息 (x402 付费信息) — 手机端**不持 EVM 私钥**: 浏览与代付一律转发电脑端;
+    //   电脑端不可达就如实回 desktop-unreachable, 绝不返回假数据 (2026-09-13)
+    x402: {
+      /** 桌面基址 (设置页填; 与 mobile.js 的 desktopBaseUrl() 同一 localStorage key) */
+      async baseUrl() {
+        try {
+          const g = await Promise.resolve().then(() => (init_mobile_gateway(), mobile_gateway_exports));
+          return String(g.getDesktopBaseUrl() || "").replace(/\/+$/, "");
+        } catch {
+          return "";
+        }
+      },
+      /** 免费元数据列表 (电脑端已发布的付费信息); 不可达 → {count:0,items:[],note:'desktop-unreachable'} */
+      async list() {
+        const base6 = await core.x402.baseUrl();
+        if (!base6) return { count: 0, items: [], note: "desktop-unreachable" };
+        try {
+          const r = await fetch(`${base6}/api/x402/info`);
+          if (!r.ok) return { count: 0, items: [], note: "desktop-unreachable" };
+          const d2 = await r.json();
+          if (!d2 || !Array.isArray(d2.items)) return { count: 0, items: [], note: "desktop-unreachable" };
+          return d2;
+        } catch {
+          return { count: 0, items: [], note: "desktop-unreachable" };
+        }
+      },
+      /** 购买并验真: 转发电脑端 /api/x402/info/buy 代付; 失败把后端 error 原文带回 (不吞错) */
+      async buy(body) {
+        const base6 = await core.x402.baseUrl();
+        if (!base6) return { ok: false, error: "\u9700\u8981\u7535\u8111\u7AEF\u5728\u7EBF (\u8BBE\u7F6E\u91CC\u586B\u684C\u9762\u5730\u5740)" };
+        try {
+          const r = await fetch(`${base6}/api/x402/info/buy`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body || {})
+          });
+          const d2 = await r.json().catch(() => null);
+          if (!r.ok) return { ok: false, status: r.status, error: d2 && (d2.error || d2.message) || `\u7535\u8111\u7AEF\u8FD4\u56DE ${r.status}` };
+          return d2 || { ok: false, error: "\u7535\u8111\u7AEF\u8FD4\u56DE\u7A7A\u54CD\u5E94" };
+        } catch (e) {
+          return { ok: false, error: "\u7535\u8111\u7AEF\u4E0D\u53EF\u8FBE: " + String(e?.message || e).slice(0, 120) };
+        }
+      }
+    },
     // 自动社交 (E1): 服务声明广播 / 发现 / 心跳 — 协议见 docs/wiki/agent-economic-protocol.md
     social: {
       async announce() {
@@ -163311,6 +163660,17 @@ ${error.stack}` : head;
           { name: "gateway_call", description: "\u901A\u8FC7 Agent Gateway \u8C03\u7528\u670D\u52A1 (\u81EA\u52A8\u95ED\u73AF)" },
           { name: "gateway_join", description: "\u901A\u8FC7\u94FE\u63A5\u52A0\u5165\u5171\u4EAB Agent \u7F51\u7EDC" }
         ];
+      },
+      async call(name10, args) {
+        const { mobileGatewayTool: mobileGatewayTool2 } = await Promise.resolve().then(() => (init_mobile_gateway(), mobile_gateway_exports));
+        return mobileGatewayTool2(String(name10 || ""), args || {});
+      }
+    },
+    skills: {
+      async list() {
+        const s2 = await Promise.resolve().then(() => (init_mobile_sync(), mobile_sync_exports));
+        const snap = s2.getLastSnapshot();
+        return snap && Array.isArray(snap.skills) ? snap.skills : [];
       }
     },
     message: {