@bolloon/bolloon-agent 0.2.6 → 0.2.8

package/dist/web/server.js

@@ -74,6 +74,9 @@ import { irohTransport } from '../network/iroh-transport.js';
 import { createAgentDelegateApp } from './agent-delegate-server.js';
 import { createIrohDelegateTransport } from './iroh-delegate-transport.js';
 import { verifyMessage, isAddress, getAddress } from 'viem';
+// 2026-07-05: peer 目录管理 + manifest 协议
+import * as peerFs from '../network/peer-fs.js';
+import { loadLocalResources, writeRemoteResources } from '../network/peer-resource-bridge.js';
 // 前端资源路径: 兼容 src 运行 + dist 运行 + npm 全局安装
 // - src 跑 (tsx):   __dirname = .../src/web  →  .../dist/web
 // - dist 跑 (npm):  __dirname = .../dist/web → 自身就是 web 根
@@ -285,6 +288,29 @@ let sseClients = new Set();
 // v3: 远端 channel UI 元数据缓存 — key: peerId, value: sanitize 过的 channel 列表
 // in-memory only, 进程重启清空 (judgment 内容永远不在这里)
 let remoteChannelCache = new Map();
+// 2026-07-05: 一次性 prompt 附加块 — key: channelId, value: 下一次 LLM prompt 时 prepend 的内容
+//   用于 manifest-loader 加载对方能力后, 仅影响本次对话, 不污染主 prompt
+const nextPromptHints = new Map();
+// 2026-07-05: 直接读 ~/.bolloon/agents/agents.json, 跳过 subagent-manager 的 lazy init
+//   原因: getSubAgentManager().getAllAgents() 只在 SubAgentManager.initialize() 后才加载,
+//   但没人调 initialize(), 永远返回 []. 这里用 raw 文件 IO 直接拿数据.
+async function loadLocalSubAgents() {
+    try {
+        const fsPromises = await import('fs/promises');
+        const path = await import('path');
+        const home = process.env.BOLLOON_HOME || process.env.HOME || '/tmp';
+        const file = path.join(home, '.bolloon', 'agents', 'agents.json');
+        const raw = await fsPromises.readFile(file, 'utf-8');
+        const parsed = JSON.parse(raw);
+        const arr = Array.isArray(parsed) ? parsed : [];
+        process.stderr.write(`[LOADED] ${arr.length} agents from ${file}\n`);
+        return arr;
+    }
+    catch (e) {
+        process.stderr.write(`[LOAD FAIL] ${e?.message}\n`);
+        return [];
+    }
+}
 // 2026-06-10: 持久化 remote channel cache 到 ~/.bolloon/remote-channels-cache.json
 // 之前是纯内存 Map, nodeA 重启后所有对端 channel 列表丢失, 需要等对面再推一次
 const REMOTE_CACHE_FILE = `${process.env.HOME || '/tmp'}/.bolloon/remote-channels-cache.json`;
@@ -454,22 +480,25 @@ async function routeMentionsInReply(originChannelId, replyText, localChannels, r
                 continue;
             }
             try {
-                const rpc = JSON.stringify({
-                    v: 3, op: 'agent.cross.post',
-                    payload: {
-                        targetChannelId: remoteTarget.id,
-                        targetChannelName: remoteTarget.name,
-                        originChannelId,
-                        originChannelName,
-                        text,
-                        fromPublicKey: v3P2PRef.getPublicKey()
-                    }
-                });
-                const ok = v3P2PRef.sendTo(ownerPk, rpc);
-                if (ok) {
+                const rpcPayload = {
+                    targetChannelId: remoteTarget.id,
+                    targetChannelName: remoteTarget.name,
+                    originChannelId,
+                    originChannelName,
+                    text,
+                    fromPublicKey: v3P2PRef.getPublicKey()
+                };
+                // 2026-07-05: 用 outbox.sendOrQueue 兜底 — 对方不在线时自动入队, 上线后批量重发
+                const { sendOrQueue } = await import('../network/p2p-outbox.js');
+                const r = await sendOrQueue(ownerPk, 'agent.cross.post', rpcPayload, v3P2PRef);
+                if (r === 'SENT') {
                     console.log(`[v3-cross] (${originChannelName}) @${targetName} → 远端 peer ${ownerPk.substring(0, 12)}... (channelId=${remoteTarget.id})`);
                     results.push({ targetName, targetId: remoteTarget.id, source: 'remote', text, status: 'sent' });
                 }
+                else if (r === 'QUEUED') {
+                    console.log(`[v3-cross] (${originChannelName}) @${targetName} → 远端 peer ${ownerPk.substring(0, 12)}... 已入队 (对方不在线)`);
+                    results.push({ targetName, targetId: remoteTarget.id, source: 'remote', text, status: 'queued' });
+                }
                 else {
                     results.push({ targetName, targetId: remoteTarget.id, source: 'remote', text, status: 'failed' });
                 }
@@ -605,6 +634,28 @@ async function handleV3P2PMessage(parsed, conn, comm) {
             catch (saveErr) {
                 console.warn(`[v3] 存 user 消息失败 (不影响 chat):`, saveErr.message);
             }
+            // 2026-07-05: 同时追加到 sender 的 peer 月度归档 — 让 A 本地的"与 sender 对话历史"也能离线查看
+            try {
+                const { appendChatArchive } = await import('../bootstrap/chat-archiver.js');
+                const chanObj = (await loadChannels()).find(c => c.id === channelId);
+                await appendChatArchive({
+                    publicKey: senderKey,
+                    entry: {
+                        ts: new Date().toISOString(),
+                        source: 'remote',
+                        channelId, channelName: chanObj?.name,
+                        text,
+                        fromPublicKey: senderKey,
+                        msgType: 'user',
+                    }
+                });
+                // 顺手把 sender 加入 known peers (如果没有)
+                const { addOrUpdatePeer } = await import('../network/known-peers.js');
+                await addOrUpdatePeer(undefined, senderKey);
+            }
+            catch (archiveErr) {
+                console.warn('[chat-archive] remote user 归档失败 (non-fatal):', archiveErr?.message?.slice(0, 200));
+            }
             // v3 修复: 同步给 A 自己的 UI — broadcast SSE 事件让 A 的 owner 实时看到 B 的消息
             broadcast({
                 type: 'user',
@@ -705,6 +756,25 @@ async function handleV3P2PMessage(parsed, conn, comm) {
             catch (saveErr) {
                 console.warn(`[v3] 存 assistant 消息失败 (不影响):`, saveErr.message);
             }
+            // 2026-07-05: A 的 assistant 回复也归档到 sender 的月度 — 这样 sender 本地也有一份"与 A 的对话"
+            try {
+                const { appendChatArchive } = await import('../bootstrap/chat-archiver.js');
+                const chanObj = (await loadChannels()).find(c => c.id === channelId);
+                await appendChatArchive({
+                    publicKey: senderKey,
+                    entry: {
+                        ts: new Date().toISOString(),
+                        source: 'ai-mention-remote',
+                        channelId, channelName: chanObj?.name,
+                        text: `[${v3P2PRef?.getPublicKey()?.slice(0, 12)}…] ${fullResponse.slice(0, 1500)}`,
+                        fromPublicKey: v3P2PRef?.getPublicKey(),
+                        msgType: 'ai',
+                    }
+                });
+            }
+            catch (archiveErr) {
+                console.warn('[chat-archive] remote ai 归档失败 (non-fatal):', archiveErr?.message?.slice(0, 200));
+            }
             // v3 修复: 同步给 A 自己的 UI — broadcast AI 回复给 A 的 owner 实时看到
             broadcast({
                 type: 'ai',
@@ -873,6 +943,26 @@ async function handleV3P2PMessage(parsed, conn, comm) {
             session.lastUpdated = new Date().toISOString();
             await saveSession(session);
             console.log(`[v3-cross] 收到远端 @-mention: ${originChannelName} → 本地 ${targetChannelName} (${text.length} chars)`);
+            // 2026-07-05: 跨渠道 @-mention 也归档到 fromPublicKey 的月度 — 本节点 owner 看月度历史能还原跨节点对话
+            if (fromPublicKey) {
+                try {
+                    const { appendChatArchive } = await import('../bootstrap/chat-archiver.js');
+                    await appendChatArchive({
+                        publicKey: fromPublicKey,
+                        entry: {
+                            ts: new Date().toISOString(),
+                            source: 'ai-mention-remote',
+                            channelId: targetChannelId, channelName: targetChannelName,
+                            text: `[跨渠道] from ${originChannelName}: ${text.slice(0, 1500)}`,
+                            fromPublicKey,
+                            msgType: 'ai',
+                        }
+                    });
+                }
+                catch (archiveErr) {
+                    console.warn('[chat-archive] cross.post 归档失败 (non-fatal):', archiveErr?.message?.slice(0, 200));
+                }
+            }
             // 推 SSE 让本地 UI 知道有跨渠道消息到达
             broadcast({
                 type: 'cross-mention-received',
@@ -887,6 +977,201 @@ async function handleV3P2PMessage(parsed, conn, comm) {
         }
         return;
     }
+    // ============== 2026-07-05: agent.manifest.exchange ==============
+    // 对方问: "给我你的 agent 清单 + capabilities"
+    // 我们回: agent.manifest.exchange.reply, 含本地 SubAgent + persona 描述
+    if (op === 'agent.manifest.exchange') {
+        try {
+            // 直接读 agents.json, 跳过 subagent-manager 的 lazy initialize
+            const localAgents = await loadLocalSubAgents();
+            // 转成 AgentManifestEntry
+            const entries = localAgents.map((a) => ({
+                id: a.id,
+                name: a.name,
+                capabilities: a.capabilities || [],
+                status: a.status || 'active',
+                peerId: a.peerId,
+                irohNodeId: a.irohNodeId,
+                sessionId: a.sessionId,
+                cid: a.cid,
+                ipnsName: a.ipnsName,
+            }));
+            // 读本地 persona 拿 owner 名字 + 简介
+            let ownerName = '';
+            let ownerDescription = '';
+            try {
+                const { readFileSync, existsSync } = await import('fs');
+                const p = path.join(process.env.HOME || '/tmp', '.bolloon', 'persona.json');
+                if (existsSync(p)) {
+                    const pj = JSON.parse(readFileSync(p, 'utf-8'));
+                    ownerName = pj.name || '';
+                    ownerDescription = pj.description || '';
+                }
+            }
+            catch { }
+            const manifest = {
+                ownerName,
+                ownerDescription,
+                ownerPublicKey: v3P2PRef?.getPublicKey() || '',
+                agents: entries,
+                publishedAt: Date.now(),
+                ...(await loadLocalResources()),
+            };
+            const reply = JSON.stringify({
+                v: 3, op: 'agent.manifest.exchange.reply',
+                payload: {
+                    manifest,
+                    since: parsed.payload?.since || 0,
+                }
+            });
+            await comm.sendToConnection(conn.id, reply);
+            // 2026-07-05: P2PDirect.sendToWithWait 双发 (兼容同机 P2PDirect 互不相连场景)
+            if (v3P2PRef && peerKey) {
+                try {
+                    const r = await v3P2PRef.sendToWithWait(peerKey, reply, 2000);
+                    console.log(`[v3-manifest] 回 ${peerKey.substring(0, 12)}... manifest (comm=${await comm.sendToConnection.length}, p2p=${r}, ${entries.length} agents)`);
+                }
+                catch { }
+            }
+            else {
+                console.log(`[v3-manifest] 回 ${peerKey.substring(0, 12)}... manifest (${entries.length} agents, owner=${ownerName || '?'})`);
+            }
+        }
+        catch (err) {
+            console.error('[v3-manifest] 处理 agent.manifest.exchange 失败:', err.message);
+        }
+        return;
+    }
+    // 对方推 manifest 过来 (我们这边是接收方)
+    if (op === 'agent.manifest.exchange.reply') {
+        try {
+            const manifest = parsed.payload?.manifest;
+            if (!manifest || !manifest.ownerPublicKey) {
+                console.warn('[v3-manifest] manifest.exchange.reply 缺 manifest/ownerPublicKey');
+                return;
+            }
+            // 2026-07-05 修复: 跳过自己的 manifest (Hyperswarm 内部 peer discovery 会推送自己)
+            const peerKey2 = manifest.ownerPublicKey;
+            if (v3P2PRef && peerKey2 === v3P2PRef.getPublicKey()) {
+                return;
+            }
+            // 增量: 如果 since >= 本地最新 ts, 跳过
+            const existing = await peerFs.readPeerIndex(peerKey2);
+            if (existing?.manifestTs && existing.manifestTs >= manifest.publishedAt && parsed.payload?.since) {
+                console.log(`[v3-manifest] ${peerKey2.substring(0, 12)}... manifest 已是最新 (ts=${manifest.publishedAt}), 跳过`);
+                return;
+            }
+            // 写 peer.json + _index.json + 每个 agent 的 md
+            await peerFs.upsertPeer({
+                publicKey: peerKey2,
+                name: manifest.ownerName,
+                lastSeenAt: new Date().toISOString(),
+                lastManifestTs: manifest.publishedAt,
+                manifestCount: (await peerFs.getPeer(peerKey2))?.manifestCount ?? 0 + 1,
+            });
+            // 拼 _index.json
+            const ownerDescription = manifest.ownerDescription || '';
+            const idx = {
+                version: 1,
+                publicKey: peerKey2,
+                ownerName: manifest.ownerName,
+                ownerDescription,
+                agents: manifest.agents,
+                groups: manifest.groups,
+                functions: manifest.functions,
+                exportments: manifest.exportments,
+                updatedAt: new Date().toISOString(),
+                manifestTs: manifest.publishedAt,
+            };
+            await peerFs.writePeerIndex(peerKey2, idx);
+            // 每个 agent 写一份 markdown
+            for (const a of manifest.agents) {
+                await peerFs.writeAgentDescription(peerKey2, a, ownerDescription);
+            }
+            // 2026-07-05: 4 类资源 (groups/function/exportment/science) 也落盘
+            const counts = await writeRemoteResources(peerKey2, manifest);
+            // capability-index.md (≤500 字, 进 prompt)
+            await peerFs.writeCapabilityIndex(peerKey2, idx);
+            console.log(`[v3-manifest] 收到 ${peerKey2.substring(0, 12)}... manifest (${manifest.agents.length} agents, owner=${manifest.ownerName || '?'}, +g${counts.groups}/f${counts.functions}/e${counts.exportments}/s${counts.sciences}) → 落盘`);
+            // 推 SSE 让前端知道"对方能力刷新了"
+            broadcast({
+                type: 'peer-manifest-updated',
+                fromPublicKey: peerKey2,
+                ownerName: manifest.ownerName,
+                agentCount: manifest.agents.length,
+                capabilityIndex: await peerFs.readCapabilityIndex(peerKey2),
+            }, 'p2p-global');
+        }
+        catch (err) {
+            console.error('[v3-manifest] 处理 manifest.exchange.reply 失败:', err.message);
+        }
+        return;
+    }
+    // 对方问: "给我某个 agent 的详细描述" (markdown 全文)
+    if (op === 'agent.resource.get') {
+        try {
+            const agentId = parsed.payload?.agentId;
+            if (!agentId)
+                return;
+            // 2026-07-05: 4 类资源 (group/function/exportment/science) 也走同一个 RPC
+            // 识别方式: id 前缀 group:/fn:/game:/exp:  → 读 ~/.bolloon/local-resources/<cat>/<id>.md
+            let body = '';
+            const prefixMatch = String(agentId).match(/^(group|fn|game|exp):(.+)$/);
+            if (prefixMatch) {
+                const cat = prefixMatch[1] === 'fn' ? 'functions'
+                    : prefixMatch[1] === 'game' ? 'exportments'
+                        : prefixMatch[1] === 'exp' ? 'sciences'
+                            : 'groups';
+                try {
+                    const fsPromises = await import('fs/promises');
+                    const safe = String(prefixMatch[2]).replace(/[^a-zA-Z0-9_-]/g, '_').slice(0, 64);
+                    const file = path.join(process.env.HOME || '/tmp', '.bolloon', 'local-resources', cat, `${safe}.md`);
+                    body = await fsPromises.readFile(file, 'utf-8');
+                }
+                catch {
+                    body = '';
+                }
+                const reply = JSON.stringify({
+                    v: 3, op: 'agent.resource.get.reply',
+                    payload: { agentId, body: body || '(空)', fromPublicKey: v3P2PRef?.getPublicKey() || '' }
+                });
+                await comm.sendToConnection(conn.id, reply);
+                return;
+            }
+            // 默认: 读本地 persona/<agentId>/agent.md (6 段 persona 之一)
+            try {
+                const fsPromises = await import('fs/promises');
+                const safeId = agentId.replace(/[^a-zA-Z0-9_-]/g, '_').slice(0, 64);
+                const file = path.join(process.env.HOME || '/tmp', '.bolloon', 'persona', safeId, 'agent.md');
+                body = await fsPromises.readFile(file, 'utf-8');
+            }
+            catch {
+                body = '';
+            }
+            // fallback: 用 subagent-manager 的 description
+            if (!body) {
+                const all = await loadLocalSubAgents();
+                const a = all.find((x) => x.id === agentId);
+                if (a?.persona?.description)
+                    body = a.persona.description;
+            }
+            const reply = JSON.stringify({
+                v: 3, op: 'agent.resource.get.reply',
+                payload: { agentId, body: body || '(空)', fromPublicKey: v3P2PRef?.getPublicKey() || '' }
+            });
+            await comm.sendToConnection(conn.id, reply);
+        }
+        catch (err) {
+            console.error('[v3-manifest] resource.get 失败:', err.message);
+        }
+        return;
+    }
+    // 对方回某 agent 的详细描述
+    if (op === 'agent.resource.get.reply') {
+        // 由 caller 端通过 rpcId 解析 (这里只 log)
+        console.log(`[v3-manifest] 收到 agent.resource.get.reply (agentId=${parsed.payload?.agentId}, body=${(parsed.payload?.body || '').length} chars)`);
+        return;
+    }
     console.log(`[v3] 收到未知 op: ${op}`);
 }
 async function buildJudgmentHint(channel, channelIdForLog) {
@@ -1008,6 +1293,8 @@ async function getAgentForChannel(channelId, channelDid, channelName, channelDid
         cwd: process.cwd(),
         peerId: `channel-${channelId}:${currentSessionId}`,
         identityDoc,
+        // 2026-07-04: 透传 agentId 让 onSessionStart 加载 persona docs
+        agentId: channel?.agentId,
         // M2.3 (2026-06-17): 构造时从 session JSON 回灌历史 — 服务重启后 LLM 仍记得前面对话
         //   key 跟 server.ts:240 写入路径保持一致: ~/.bolloon/sessions/cache/<key>.json
         loadSessionKey: sessionKey,
@@ -1255,6 +1542,66 @@ export async function createWebServer(port = 3000, options = {}) {
                             }, 'p2p-global');
                             return;
                         }
+                        // 2026-07-05: v3 P2PDirect 主路径也要独立处理 manifest.exchange.reply — 否则只走老通道就拿不到
+                        if (parsed.op === 'agent.manifest.exchange.reply') {
+                            const manifest = parsed.payload?.manifest;
+                            if (!manifest || !manifest.ownerPublicKey) {
+                                console.warn('[v3-manifest] manifest.exchange.reply 缺 manifest/ownerPublicKey');
+                                return;
+                            }
+                            const peerKey2 = manifest.ownerPublicKey;
+                            // 2026-07-05 修复: 跳过自己的 manifest
+                            if (v3P2PRef && peerKey2 === v3P2PRef.getPublicKey()) {
+                                return;
+                            }
+                            // 异步落盘, 不阻塞 data handler
+                            (async () => {
+                                try {
+                                    const existing = await peerFs.readPeerIndex(peerKey2);
+                                    if (existing?.manifestTs && existing.manifestTs >= manifest.publishedAt && parsed.payload?.since) {
+                                        console.log(`[v3-manifest] ${peerKey2.substring(0, 12)}... manifest 已是最新, 跳过`);
+                                        return;
+                                    }
+                                    await peerFs.upsertPeer({
+                                        publicKey: peerKey2,
+                                        name: manifest.ownerName,
+                                        lastSeenAt: new Date().toISOString(),
+                                        lastManifestTs: manifest.publishedAt,
+                                    });
+                                    const ownerDescription = manifest.ownerDescription || '';
+                                    const idx = {
+                                        version: 1,
+                                        publicKey: peerKey2,
+                                        ownerName: manifest.ownerName,
+                                        ownerDescription,
+                                        agents: manifest.agents,
+                                        groups: manifest.groups,
+                                        functions: manifest.functions,
+                                        exportments: manifest.exportments,
+                                        updatedAt: new Date().toISOString(),
+                                        manifestTs: manifest.publishedAt,
+                                    };
+                                    await peerFs.writePeerIndex(peerKey2, idx);
+                                    for (const a of manifest.agents) {
+                                        await peerFs.writeAgentDescription(peerKey2, a, ownerDescription);
+                                    }
+                                    const counts = await writeRemoteResources(peerKey2, manifest);
+                                    await peerFs.writeCapabilityIndex(peerKey2, idx);
+                                    console.log(`[v3-manifest] (P2PDirect) 收到 ${peerKey2.substring(0, 12)}... manifest (${manifest.agents.length} agents, owner=${manifest.ownerName || '?'}, +g${counts.groups}/f${counts.functions}/e${counts.exportments}/s${counts.sciences}) → 落盘`);
+                                    broadcast({
+                                        type: 'peer-manifest-updated',
+                                        fromPublicKey: peerKey2,
+                                        ownerName: manifest.ownerName,
+                                        agentCount: manifest.agents.length,
+                                        capabilityIndex: await peerFs.readCapabilityIndex(peerKey2),
+                                    }, 'p2p-global');
+                                }
+                                catch (err) {
+                                    console.error('[v3-manifest] (P2PDirect) manifest.exchange.reply 失败:', err.message);
+                                }
+                            })();
+                            return;
+                        }
                         // 2026-06-10: 收到对方请求本机的 channel 列表 (启动时主动发请求, 加速 cache 填充)
                         if (parsed.op === 'agent.meta.list.request') {
                             console.log(`[v3-meta] 收到 ${evt.fromPublicKey.substring(0, 12)}... 的 channel 列表请求 → 立刻回包`);
@@ -1296,6 +1643,47 @@ export async function createWebServer(port = 3000, options = {}) {
                         console.error('[v3] 新连接发 list.reply 失败:', err.message);
                     }
                 }, 500);
+                // 2026-07-05: 新连接到来立刻推自己的 manifest — 让对方秒知道我有哪些 agent
+                setTimeout(async () => {
+                    try {
+                        // 跳过自己的连接 (Hyperswarm 内部 peer discovery 会推自己过来, 形成循环)
+                        if (v3P2PRef && evt.remotePublicKey === v3P2PRef.getPublicKey()) {
+                            return;
+                        }
+                        const localAgents = await loadLocalSubAgents();
+                        const entries = localAgents.map((a) => ({
+                            id: a.id, name: a.name,
+                            capabilities: a.capabilities || [],
+                            status: a.status || 'active',
+                            peerId: a.peerId, irohNodeId: a.irohNodeId,
+                            sessionId: a.sessionId, cid: a.cid, ipnsName: a.ipnsName,
+                        }));
+                        let ownerName = '';
+                        try {
+                            const fsPromises = await import('fs/promises');
+                            const p = (process.env.HOME || '/tmp') + '/.bolloon/persona.json';
+                            const raw = await fsPromises.readFile(p, 'utf-8');
+                            ownerName = JSON.parse(raw).name || '';
+                        }
+                        catch { }
+                        const manifest = {
+                            ownerName,
+                            ownerPublicKey: v3P2PRef?.getPublicKey() || '',
+                            agents: entries,
+                            publishedAt: Date.now(),
+                            ...(await loadLocalResources()),
+                        };
+                        const msg = JSON.stringify({
+                            v: 3, op: 'agent.manifest.exchange.reply',
+                            payload: { manifest, since: 0 }
+                        });
+                        const r = await v3P2PRef.sendToWithWait(evt.remotePublicKey, msg, 3000);
+                        console.log(`[v3-manifest] 新连接 ${evt.remotePublicKey.substring(0, 12)}... → 主动推 manifest (${entries.length} agents, p2p=${r})`);
+                    }
+                    catch (err) {
+                        console.error('[v3-manifest] 新连接推 manifest 失败:', err.message);
+                    }
+                }, 800);
             });
             console.log(`[v3] P2PDirect 已启动, role=${v3P2PRef.getRole()}, publicKey=${v3P2PRef.getPublicKey().substring(0, 12)}...`);
             // v3: 启动后自动重连 known peers — 让"启动就互联"成为现实
@@ -1325,6 +1713,10 @@ export async function createWebServer(port = 3000, options = {}) {
                     // 2026-06-10: 同时主动请求每个 known peer 把 ta 的 channel 列表推过来
                     // 避免对面 publicKey 没变但 cache 丢了(本机重启) → 一直空
                     setTimeout(() => requestChannelsFromAllPeers(), 3500);
+                    // 2026-07-05: 拉每个 known peer 的 manifest (agent 能力清单)
+                    setTimeout(() => requestManifestsFromAllPeers(), 4500);
+                    // 2026-07-05: 对方刚连上来, 把本地的 outbox 重发出去
+                    setTimeout(() => flushAllOutboxes(), 6000);
                 }
                 catch (err) {
                     console.error('[v3] 自动重连失败:', err.message);
@@ -1357,6 +1749,78 @@ export async function createWebServer(port = 3000, options = {}) {
             // 立即跑一次 + 每 30s 兜底 (跟 v3BroadcastOwn 一样的节奏)
             setTimeout(requestChannelsFromAllPeers, 4000);
             setInterval(requestChannelsFromAllPeers, 30000);
+            // 2026-07-05 新增: 主动向所有 known peer 发起 manifest 拉取
+            async function requestManifestsFromAllPeers() {
+                if (!v3P2PRef)
+                    return;
+                try {
+                    const { listPeers } = await import('../network/known-peers.js');
+                    const peers = await listPeers();
+                    const myPk = v3P2PRef.getPublicKey();
+                    let sent = 0;
+                    for (const peer of peers) {
+                        if (peer.publicKey === myPk)
+                            continue;
+                        // 增量: since = 本地已有的 lastManifestTs, 对端 manifestTs <= since 则跳过
+                        const peerRec = await peerFs.getPeer(peer.publicKey);
+                        const since = peerRec?.lastManifestTs || 0;
+                        const req = JSON.stringify({
+                            v: 3, op: 'agent.manifest.exchange',
+                            payload: { since, fromPublicKey: myPk }
+                        });
+                        const r = await v3P2PRef.sendToWithWait(peer.publicKey, req, 3000);
+                        if (r === 'SENT')
+                            sent++;
+                    }
+                    console.log(`[v3-manifest] requestManifestsFromAllPeers → sent=${sent}/${peers.length - 1}`);
+                }
+                catch (err) {
+                    console.warn('[v3-manifest] requestManifestsFromAllPeers failed:', err.message);
+                }
+            }
+            // 每 5 分钟兜底 (manifest 增量拉取)
+            setInterval(requestManifestsFromAllPeers, 5 * 60 * 1000);
+            // 2026-07-05 新增: 把每个 peer 的 outbox 队列重发出去 (对方上线后)
+            async function flushAllOutboxes() {
+                if (!v3P2PRef)
+                    return;
+                try {
+                    const { listPeers } = await import('../network/known-peers.js');
+                    const peers = await listPeers();
+                    const myPk = v3P2PRef.getPublicKey();
+                    let totalFlushed = 0;
+                    for (const peer of peers) {
+                        if (peer.publicKey === myPk)
+                            continue;
+                        const outbox = await peerFs.readOutbox(peer.publicKey);
+                        if (outbox.length === 0)
+                            continue;
+                        let sent = 0;
+                        for (const entry of outbox) {
+                            const rpc = JSON.stringify({ v: 3, op: entry.op, payload: entry.payload });
+                            const r = await v3P2PRef.sendToWithWait(peer.publicKey, rpc, 3000);
+                            if (r === 'SENT')
+                                sent++;
+                        }
+                        if (sent > 0) {
+                            // 全部成功 → 清空; 部分成功 → 写回剩余 (简单起见, 全成功才清)
+                            if (sent === outbox.length) {
+                                await peerFs.clearOutbox(peer.publicKey);
+                                totalFlushed += sent;
+                                console.log(`[v3-outbox] flush → ${peer.publicKey.substring(0, 12)}... 重发 ${sent} 条 ✓`);
+                            }
+                        }
+                    }
+                    if (totalFlushed > 0) {
+                        console.log(`[v3-outbox] 累计重发 ${totalFlushed} 条离线消息`);
+                    }
+                }
+                catch (err) {
+                    console.warn('[v3-outbox] flushAllOutboxes failed:', err.message);
+                }
+            }
+            // 每 2 分钟兜底 flush
+            setInterval(flushAllOutboxes, 2 * 60 * 1000);
         }
         catch (err) {
             console.error('[v3] P2PDirect 启动失败:', err.message);
@@ -1367,6 +1831,9 @@ export async function createWebServer(port = 3000, options = {}) {
         // v3 修复: 用 setInterval 替代一次性 setTimeout, 确保分享变更后能持续推送给 peer
         setInterval(v3BroadcastOwn, 30000);
         // 保留 @diap/sdk 的旧实例 (它的 Hyperswarm 实例能帮 P2PDirect 做 DHT bootstrap)
+        // 2026-07-04: hyperswarm 4.x 删除了 Discovery.update() (被 .flushed() 替代).
+        //   @diap/sdk 0.1.10 还调 .update(), 是上游 bug (已记录 docs/plans/2026-06-17-supervisor-iter-1.md).
+        //   这里静默 joinTopic 失败, P2PDirect (v3 主路径) 不依赖 @diap/sdk, 不影响功能.
         try {
             const rawSeed = crypto.getRandomValues(new Uint8Array(32));
             p2pCommunicator = createHyperswarmCommunicator({
@@ -1380,13 +1847,38 @@ export async function createWebServer(port = 3000, options = {}) {
                 // 旧 p2p_message 路径 (非 v3)
                 const content = new TextDecoder().decode(msg.content);
                 broadcast({ type: 'p2p_message', from: conn.publicKey.substring(0, 8), content }, undefined);
+                // 2026-07-05: 老通道也要走 v3 RPC handler — 兼容同机/跨机 P2PDirect 互不相连的场景
+                //   实测: P2PDirect 用 hyperswarm 4.x, 同机 2 role 互不相连; 但 @diap/sdk 0.1.10 的 HyperswarmCommunicator 能互通
+                //   所以 manifest/exchange/chat.send 都可能从老通道来, 必须进 handleV3P2PMessage
+                try {
+                    const parsed = JSON.parse(content);
+                    if (parsed && parsed.v === 3 && parsed.op && p2pCommunicator) {
+                        await handleV3P2PMessage(parsed, conn, p2pCommunicator);
+                    }
+                }
+                catch (err) {
+                    // 非 v3 JSON 帧 (老 p2p_message), 静默忽略
+                }
             });
             await p2pCommunicator.start();
             // @diap/sdk 也 join topic — 它的 Hyperswarm 实例帮 P2PDirect 做 DHT 引导
-            // @diap/sdk 收到的数据是 mock (不真发), 但 DHT 发现 + 节点连接是 OK 的
+            // joinTopic 失败已知 (hyperswarm 4.x + @diap/sdk 0.1.10), catch 静默
             const oldTopic = createTopic('bolloon-agent-harness');
-            await p2pCommunicator.joinTopic(oldTopic);
-            console.log(`P2P 老通道已就绪 (DHT bootstrap 帮 P2PDirect, 实际数据走 P2PDirect)`);
+            try {
+                await p2pCommunicator.joinTopic(oldTopic);
+                console.log(`P2P 老通道已就绪 (DHT bootstrap 帮 P2PDirect, 实际数据走 P2PDirect)`);
+            }
+            catch (joinErr) {
+                // 已知: @diap/sdk 0.1.10 + hyperswarm 4.x → discovery.update is not a function
+                // v3 P2PDirect 是主路径, 此处不阻断
+                const msg = String(joinErr?.message || joinErr);
+                if (msg.includes('discovery.update') || msg.includes('is not a function')) {
+                    console.warn(`[v3-legacy] @diap/sdk joinTopic 失败 (已知 hyperswarm 4.x 兼容问题, 已忽略): ${msg}`);
+                }
+                else {
+                    throw joinErr;
+                }
+            }
         }
         catch (e) {
             console.log(`P2P 老通道初始化失败: ${e.message}`);
@@ -1409,6 +1901,12 @@ export async function createWebServer(port = 3000, options = {}) {
         next();
     });
     app.use(express.static(webRoot));
+    // 2026-07-01 (v0.2.6 修复): 前端 message-renderer import 了 src/agents/chat-segmenter.js,
+    //   浏览器加载时按相对路径解析成 /agents/chat-segmenter.js. 这个路径在 webRoot (dist/web) 之外.
+    //   解决: 把 dist/agents 也 mount 到 /agents 静态路径, 让前端 import 解析成功.
+    //   这条不破坏 segmenter 内部 import (Node 走文件系统, 浏览器走 HTTP).
+    const agentsRoot = path.join(webRoot, '..', 'agents');
+    app.use('/agents', express.static(agentsRoot));
     app.get('/', (req, res) => {
         res.sendFile(join(webRoot, 'index.html'));
     });
@@ -1561,6 +2059,14 @@ export async function createWebServer(port = 3000, options = {}) {
         }
         runState.running = true;
         runState.abortController = new AbortController();
+        // 2026-07-04: pivot loop safety net — 60s 强制 timeout 防止 LLM hang (minimax M3
+        //   偶尔反复 think 不输出 <final gen>, pivot 连 5 次无进展时会 hang 在
+        //   quality 评估). setTimeout 让 LLM 客户端收 signal 主动 break.
+        const PIVOT_FORCE_TIMEOUT_MS = 30_000;
+        const forceTimeout = setTimeout(() => {
+            console.warn(`[server] /message pivot 强制 timeout (${PIVOT_FORCE_TIMEOUT_MS}ms), aborting`);
+            runState.abortController?.abort();
+        }, PIVOT_FORCE_TIMEOUT_MS);
         broadcastQueueUpdate(channelId);
         // 2026-07-01 (v0.2.5): hoist sessionKey 到 try 外, 让 finally 块的 saveCurrentSession 能用
         const sessionKey = `${channelId}:${currentSessionId}`;
@@ -1792,7 +2298,14 @@ export async function createWebServer(port = 3000, options = {}) {
                 //   修法: contextHint 当 "背景信息", text 当 "本轮用户请求" — 显式 marker 让 LLM 区分
                 // 2026-06-15 二次修: 把 text 放在最前 (LLM 看到 input 第一眼是 user text, 不会被 judgmentHint 末尾
                 //   的 "..." 误判为整个 input 截断)
-                const markedPrompt = `【本轮用户请求】\n${text}\n【请求结束】\n\n${contextHint}`;
+                // 2026-07-05: prepend nextPromptHints (manifest-loader 加载的对方能力, 仅本次生效)
+                let extraHint = '';
+                const hint = nextPromptHints.get(channelId);
+                if (hint) {
+                    extraHint = hint + '\n\n';
+                    nextPromptHints.delete(channelId);
+                }
+                const markedPrompt = `${extraHint}【本轮用户请求】\n${text}\n【请求结束】\n\n${contextHint}`;
                 fullResponse = await agent.promptStream(markedPrompt, streamCallback, runState.abortController?.signal, channelId);
             }
             catch (err) {
@@ -1808,8 +2321,12 @@ export async function createWebServer(port = 3000, options = {}) {
                     broadcast({ type: 'error', content: fullResponse }, channelId);
                 }
             }
-            // abort 模式: 给 partial 拼后缀
-            if (runState.abortController?.signal.aborted && fullResponse.trim().length > 0) {
+            // abort 模式: 给 partial 拼后缀 — 只在 LLM 真有输出时加中断标记,
+            //   跳过空响应 + 跳过 [AI 服务调用失败] fallback (这些本身就是错误占位, 拼
+            //   "[生成已中断]" 会误导用户)
+            const hasRealLlmOutput = fullResponse.trim().length > 0 &&
+                !fullResponse.trimStart().startsWith('[AI 服务调用失败]');
+            if (runState.abortController?.signal.aborted && hasRealLlmOutput) {
                 fullResponse = fullResponse + '\n\n_[生成已中断]_';
             }
             // 2026-06-18: 修 lastFinalReply 没设 → /api/loop/inspect 永远返回空
@@ -1833,6 +2350,117 @@ export async function createWebServer(port = 3000, options = {}) {
             });
             session.lastUpdated = new Date().toISOString();
             await saveSession(session);
+            // 2026-07-04: 写 session 后, 调 memory-compressor 把消息历史压缩到
+            //   ~/.bolloon/memory/<channel.agentId>/sessions/<safe-channel>__<safe-session>.summary.md
+            // 失败静默, 不阻塞 /message 主路径.
+            try {
+                const channelsForMemory = await loadChannels();
+                const channelForMemory = channelsForMemory.find(c => c.id === channelId);
+                if (channelForMemory?.agentId) {
+                    const { compressSessionToMemory } = await import('../bootstrap/memory-compressor.js');
+                    const compressRes = await compressSessionToMemory({
+                        agentId: channelForMemory.agentId,
+                        channelId,
+                        sessionId: currentSessionId,
+                    });
+                    if (!compressRes.skipped && compressRes.bytesWritten > 0) {
+                        console.log(`[memory] compressed ${compressRes.messagesCount} new messages for ${channelForMemory.agentId}/${channelId} → ${compressRes.summaryPath} (${compressRes.bytesWritten}B)`);
+                    }
+                }
+            }
+            catch (memErr) {
+                console.warn('[memory] compressSessionToMemory failed (non-fatal):', memErr?.message?.slice(0, 200));
+            }
+            // 2026-07-05: 把 session 里的 user/ai 消息按涉及到的远端 peer 归档到月度 markdown
+            //   触发条件: 消息里出现过 @远端 channel, 或者 session 历史上与该 peer 通信过
+            //   失败静默, 不阻塞主对话
+            try {
+                const { appendChatArchive } = await import('../bootstrap/chat-archiver.js');
+                // 找到这条消息涉及到的远端 peer (从 routeMentionsInReply 的结果推断 — 简单起见直接遍历 remoteChannels)
+                const localChannels2 = (await loadChannels());
+                const remoteChannels2 = [];
+                for (const [peerPk, list] of remoteChannelCache.entries()) {
+                    for (const ch of list) {
+                        remoteChannels2.push({ ...ch, _ownerPublicKey: peerPk });
+                    }
+                }
+                // 找出本次 text/fullResponse 里出现 @ 的 channel 对应的 owner pk
+                const peerSet = new Set();
+                const mentionRe = /@([一-龥A-Za-z0-9_\-]{1,30})/g;
+                const mentionedNames = new Set();
+                for (const m of text.matchAll(mentionRe))
+                    mentionedNames.add(m[1]);
+                for (const m of fullResponse.matchAll(mentionRe))
+                    mentionedNames.add(m[1]);
+                for (const rc of remoteChannels2) {
+                    if (mentionedNames.has(rc.name))
+                        peerSet.add(rc._ownerPublicKey);
+                }
+                // 追加到每个相关 peer 的月度归档
+                for (const pk of peerSet) {
+                    await appendChatArchive({
+                        publicKey: pk,
+                        entry: {
+                            ts: new Date().toISOString(),
+                            source: 'local',
+                            channelId, channelName: (await loadChannels()).find(c => c.id === channelId)?.name,
+                            text: `[本节点] user: ${text.slice(0, 500)}\n[本节点] ai: ${fullResponse.slice(0, 800)}`,
+                            fromPublicKey: v3P2PRef?.getPublicKey(),
+                            msgType: 'user',
+                        }
+                    });
+                }
+            }
+            catch (archiveErr) {
+                console.warn('[chat-archive] append failed (non-fatal):', archiveErr?.message?.slice(0, 200));
+            }
+            // 2026-07-05: 懒加载触发器 — 探测到 @-mention 远端 / 连续失败 / 关键词, 拉对方 manifest
+            //   把 capability-index 拼到下一次 prompt 上下文 (只生效 1 次, 不污染主循环)
+            try {
+                const { detectLoadTrigger, loadPeerManifest, clearFailure } = await import('../agents/peer-manifest-loader.js');
+                const remoteChannelsForDetect = [];
+                for (const [peerPk, list] of remoteChannelCache.entries()) {
+                    for (const ch of list) {
+                        remoteChannelsForDetect.push({ ...ch, _ownerPublicKey: peerPk });
+                    }
+                }
+                // 检测 + 加载
+                const detection = detectLoadTrigger({
+                    text,
+                    channelId,
+                    remoteChannels: remoteChannelsForDetect,
+                });
+                if (detection.shouldLoad && detection.remotePublicKey && v3P2PRef) {
+                    const result = await loadPeerManifest({
+                        channelId,
+                        channelName: (await loadChannels()).find(c => c.id === channelId)?.name,
+                        reason: detection.reason,
+                        triggerValue: detection.triggerValue,
+                        remotePublicKey: detection.remotePublicKey,
+                    }, { p2p: v3P2PRef });
+                    if (result && result.promptBlock) {
+                        console.log(`[manifest-loader] ${detection.reason} → ${detection.remotePublicKey.slice(0, 12)}... (${result.durationMs}ms, rpc=${result.rpcTriggered}, agents=${result.agentDescriptions.length})`);
+                        // 把 promptBlock 推给前端 + 写入一次性的 prompt 附加 (nextPromptHint 全局变量, 在下次 agent.promptStream 前 prepend)
+                        broadcast({
+                            type: 'peer-manifest-loaded',
+                            fromPublicKey: detection.remotePublicKey,
+                            reason: detection.reason,
+                            promptBlock: result.promptBlock,
+                            capabilityIndex: result.capabilityIndex,
+                        }, channelId);
+                        // 缓存到 channel 维度的 nextPromptHint (下一次 LLM prompt 前 inject)
+                        nextPromptHints.set(channelId, (nextPromptHints.get(channelId) || '') + '\n\n' + result.promptBlock);
+                        clearFailure(channelId);
+                    }
+                }
+                else {
+                    // 没触发, 也清掉连续失败计数 (用户消息说明对话还在正常进行)
+                    clearFailure(channelId);
+                }
+            }
+            catch (loaderErr) {
+                console.warn('[manifest-loader] failed (non-fatal):', loaderErr?.message?.slice(0, 200));
+            }
             const channels = await loadChannels();
             const channel = channels.find(c => c.id === channelId);
             // 2026-06-11: 移除 suggestRename 的二次 LLM 调用 — 之前每次用户发消息, 智能体 channel 都会再调一次 LLM (5-8s) 自动改名
@@ -1894,6 +2522,10 @@ export async function createWebServer(port = 3000, options = {}) {
                 res.status(500).json({ error: err.message });
         }
         finally {
+            // 2026-07-04: 清掉 pivot 强制 timeout timer, 避免 hang 情况下 timer 在
+            //   process 里一直挂着. forceTimeout 在 try 外创建, finally 在闭包里
+            //   能直接拿到引用.
+            clearTimeout(forceTimeout);
             // queue dequeue: 跑完或失败都要清状态
             // 当前实现: 自动接下一条需要把 ~200 行 try 块抽函数, 暂不抽.
             // 替代: 用户点 [队列 +N] 按钮时, 客户端发起一个特殊的 HTTP 请求触发下一条
@@ -3657,11 +4289,25 @@ export async function createWebServer(port = 3000, options = {}) {
             res.json({ initialized: false });
             return;
         }
+        // 2026-07-04: irohTransport.getNodeId() 在某些环境下返回空字符串 (@rayhanadev/iroh + Windows
+        //   native binding 启动延迟). fallback: 用 v3 P2PDirect (hyperswarm) 的 publicKey 兜底,
+        //   保证客户端拿到一个可用的 peer id (v3 是实际数据通道, 不是 mock).
+        let effectiveNodeId = irohNodeInfo.irohNodeId;
+        if (!effectiveNodeId && v3P2PRef) {
+            try {
+                effectiveNodeId = v3P2PRef.getPublicKey() || '';
+                if (effectiveNodeId) {
+                    console.log('[iroh API] irohNodeId 为空, fallback 到 v3 P2PDirect publicKey:', effectiveNodeId.substring(0, 16) + '...');
+                }
+            }
+            catch { /* ignore */ }
+        }
         res.json({
             initialized: true,
             did: irohNodeInfo.did,
             cid: irohNodeInfo.cid,
-            irohNodeId: irohNodeInfo.irohNodeId,
+            irohNodeId: effectiveNodeId,
+            irohNodeIdSource: effectiveNodeId === irohNodeInfo.irohNodeId ? 'iroh' : (effectiveNodeId ? 'v3-p2p-fallback' : 'unavailable'),
             name: irohNodeInfo.name
         });
     });