@bolloon/bolloon-agent 0.1.24 → 0.1.26

package/src/web/server.ts

@@ -72,6 +72,8 @@ interface Channel {
   updatedAt: string;
   currentSessionId?: string;
   sessions?: SessionSummary[];
+  /** 用户在盾牌里手动绑定的判断力 (LLM 跑 channel 时会注入). 默认 []. */
+  bound_judgment_ids?: string[];
 }
 
 interface SessionSummary {
@@ -380,9 +382,93 @@ interface SSEClient {
 }
 
 let sseClients: Set<SSEClient> = new Set();
+// v3: 远端 channel UI 元数据缓存 — key: peerId, value: sanitize 过的 channel 列表
+// in-memory only, 进程重启清空 (judgment 内容永远不在这里)
+let remoteChannelCache: Map<string, Array<Record<string, unknown>>> = new Map();
 let channelSessions: Map<string, AgentSession> = new Map(); // key: channelId
 let sessionMessages: Map<string, any[]> = new Map(); // key: channelId + sessionId
 
+/**
+ * v3 重做: 构造 channel 的两路 judgment prompt 片段
+ *   路 1: 用户在盾牌里手动绑定的 judgment (channel.bound_judgment_ids)
+ *   路 2: 全局 judgment 列表 (供 LLM 在主调用中按需挑选, 写入回复)
+ * 返回 "" 表示完全没数据; 否则返回完整 "[系统上下文] ..." 块 (含尾部换行)
+ * 失败非致命 — 任何异常都返回空串, 保证 LLM 调用不被阻塞
+ */
+
+/**
+ * v3: 过滤 channel 元数据, 只返回对远端 peer 安全的字段.
+ * 关键: bound_judgment_ids / walletBinding / autoInvokeTools 内部状态不外传.
+ * judgment 内容永远不会出现在 RPC 响应里 (judgment 始终在 A 节点内存, 由 A 跑 LLM).
+ */
+function sanitizeChannelForPeer(ch: Channel): Record<string, unknown> {
+  return {
+    id: ch.id,
+    name: ch.name,
+    did: ch.did,
+    publicKey: ch.publicKey,
+    createdAt: ch.createdAt,
+    updatedAt: ch.updatedAt,
+    hasWallet: !!ch.walletAddress,    // 只告诉 B "有没有钱包", 不传地址
+    boundJudgmentCount: Array.isArray(ch.bound_judgment_ids) ? ch.bound_judgment_ids.length : 0,
+    // 🔒 不返回: bound_judgment_ids, walletAddress, walletBinding, autoInvokeTools, sessions
+  };
+}
+
+async function buildJudgmentHint(
+  channel: Channel | undefined | null,
+  channelIdForLog: string
+): Promise<string> {
+  try {
+    const { loadAllJudgments, initializeValueStore } = await import(
+      '../pi-ecosystem-judgment/human-value-store.js'
+    );
+    await initializeValueStore();
+    const allJudgments = await loadAllJudgments();
+    if (allJudgments.length === 0) return '';
+
+    const boundIds = new Set(
+      channel && Array.isArray(channel.bound_judgment_ids) ? channel.bound_judgment_ids : []
+    );
+    const bound = allJudgments.filter(j => j.id !== undefined && boundIds.has(j.id));
+    const others = allJudgments.filter(j => j.id !== undefined && !boundIds.has(j.id));
+
+    let hint = '';
+
+    // 路 1: 用户手动绑定的 judgment — 硬约束, 必须遵循
+    if (bound.length > 0) {
+      hint += `[系统上下文] 此 channel 用户绑定了 ${bound.length} 条判断力, 必须严格遵循:\n`;
+      for (const j of bound) {
+        const decision = (j.decision || '').toString().slice(0, 200);
+        const reasonList = Array.isArray(j.reasons) ? j.reasons : [];
+        const reasonText = reasonList.length > 0
+          ? ` (理由: ${reasonList.join('; ').slice(0, 100)})`
+          : '';
+        hint += `- ${decision}${reasonText}\n`;
+      }
+      hint += '\n';
+    }
+
+    // 路 2: 全局 judgment 候选池 — 软参考, LLM 自己挑
+    if (others.length > 0) {
+      hint += `[系统上下文] 候选判断力 (用户未明确绑定, 你可以按相关性自主选择参考):\n`;
+      for (const j of others) {
+        const decision = (j.decision || '').toString().slice(0, 120);
+        hint += `- [id=${j.id}] ${decision}\n`;
+      }
+      hint += `\n[系统上下文] 如果你的回复参考了某条候选判断力, 请在回复中自然提及 "我参考了你的判断: <decision 简述>" 即可, 无需复述 id.\n\n`;
+    }
+
+    console.log(
+      `[v3] channel ${channelIdForLog} 注入: 绑定 ${bound.length} 条, 候选 ${others.length} 条`
+    );
+    return hint;
+  } catch (err) {
+    console.error(`[v3] 加载判断力失败 (非致命):`, (err as Error).message);
+    return '';
+  }
+}
+
 async function getAgentForChannel(
   channelId: string,
   channelDid?: string,
@@ -640,6 +726,8 @@ export async function createWebServer(port: number = 3000, options: CreateWebSer
     // (line ~638) 与这里外层的 const channel 形成 shadowing 让 TS 误报"使用前未声明"
     const boundWalletAddress = channel?.walletAddress;
     const autoToolsEnabled = channel?.autoInvokeTools !== false; // 默认开启
+    // 捕获外层 channel 到独立变量, 避免被 try 块内 (line 740+) 的 const channel 遮蔽
+    const channelForJudgment = channel;
 
     try {
       const agent = await getAgentForChannel(channelId, realChannelDid, realChannelName, realChannelDidDoc);
@@ -675,6 +763,12 @@ export async function createWebServer(port: number = 3000, options: CreateWebSer
       } else {
         contextHint += `[系统上下文] 自动工具调用已关闭: 每次执行工具前必须先与用户确认。\n`;
       }
+
+      // v3: 注入 channel 绑定的判断力 (judgment_ids)
+      // 这是 v3 的核心 — channel 跑 LLM 时, 它的判断力 = 绑定的 judgment 列表
+      const judgmentHint = await buildJudgmentHint(channelForJudgment, channelId);
+      if (judgmentHint) contextHint += judgmentHint;
+
       if (contextHint) contextHint += '\n';
       fullResponse = await agent.promptStream(contextHint + text, streamCallback);
 
@@ -833,10 +927,47 @@ app.get('/channels', async (_req, res) => {
   }
 });
 
+  // v3: 列出本节点缓存的远端 channel (按 peerId 分组)
+  app.get('/api/remote-channels', async (_req, res) => {
+    try {
+      const out: Array<{ peerId: string; channels: Array<Record<string, unknown>> }> = [];
+      for (const [peerId, list] of remoteChannelCache.entries()) {
+        out.push({ peerId, channels: list });
+      }
+      res.json({ count: out.length, peers: out });
+    } catch (err: any) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+
+  // v3: 主动向所有已连接 P2P peer 拉 channel 列表
+  // 用法: B 端用户点 "刷新远端智能体" → 触发本 endpoint
+  app.post('/api/remote-channels/refresh', async (_req, res) => {
+    try {
+      const peers = irohTransport.getPeers ? irohTransport.getPeers() : [];
+      const peerIds = Array.isArray(peers) ? peers.map((p: any) => p.nodeId || p) : [];
+      if (peerIds.length === 0) {
+        return res.json({ ok: true, sent: 0, note: 'no connected peers' });
+      }
+      let sent = 0;
+      for (const peerId of peerIds) {
+        const ok = await irohTransport.sendMessage(
+          peerId,
+          'agent.meta.list',
+          new TextEncoder().encode('{}')
+        );
+        if (ok) sent++;
+      }
+      res.json({ ok: true, sent, total: peerIds.length });
+    } catch (err: any) {
+      res.status(500).json({ error: err.message });
+    }
+  });
+
   app.post('/channels', async (req, res) => {
     try {
-      const { name, agentId, walletAddress, autoInvokeTools } = req.body;
-      console.log(`[创建频道] 收到请求: name=${name}, agentId=${agentId}, wallet=${walletAddress ? 'yes' : 'no'}`);
+      const { name, agentId, walletAddress, autoInvokeTools, bound_judgment_ids } = req.body;
+      console.log(`[创建频道] 收到请求: name=${name}, agentId=${agentId}, wallet=${walletAddress ? 'yes' : 'no'}, boundJudgments=${Array.isArray(bound_judgment_ids) ? bound_judgment_ids.length : 0}`);
       if (!name || !agentId) {
         return res.status(400).json({ error: 'name and agentId required' });
       }
@@ -846,6 +977,11 @@ app.get('/channels', async (_req, res) => {
       // 校验钱包地址格式 (粗校验: 0x + 40 hex / Solana base58 / Sui 0x+64)
       const validWallet = isValidWalletAddress(walletAddress);
 
+      // 过滤 bound_judgment_ids: 只保留 string
+      const safeBoundIds = Array.isArray(bound_judgment_ids)
+        ? bound_judgment_ids.filter((x: unknown) => typeof x === 'string' && (x as string).length > 0)
+        : [];
+
       // 先创建频道（不阻塞等待 DID 生成）
       const channel: Channel = {
         id,
@@ -857,6 +993,7 @@ app.get('/channels', async (_req, res) => {
         walletAddress: validWallet || undefined,
         walletRegisteredAt: validWallet ? new Date().toISOString() : undefined,
         autoInvokeTools: autoInvokeTools !== false, // 默认 true
+        bound_judgment_ids: safeBoundIds,
         sessions: [{
           id: `sess_${Date.now()}`,
           createdAt: new Date().toISOString(),
@@ -1035,7 +1172,7 @@ app.get('/channels', async (_req, res) => {
   app.patch('/channels/:channelId', async (req, res) => {
     try {
       const { channelId } = req.params;
-      const { name, walletAddress, autoInvokeTools } = req.body;
+      const { name, walletAddress, autoInvokeTools, bound_judgment_ids } = req.body;
       const channels = await loadChannels();
       const channel = channels.find(c => c.id === channelId);
       if (!channel) {
@@ -1061,6 +1198,19 @@ app.get('/channels', async (_req, res) => {
       if (typeof autoInvokeTools === 'boolean') {
         channel.autoInvokeTools = autoInvokeTools;
       }
+      // bound_judgment_ids: 允许数组(替换)/null(清空)/undefined(不改)
+      if (bound_judgment_ids !== undefined) {
+        if (bound_judgment_ids === null) {
+          channel.bound_judgment_ids = [];
+        } else if (Array.isArray(bound_judgment_ids)) {
+          channel.bound_judgment_ids = bound_judgment_ids.filter(
+            (x: unknown) => typeof x === 'string' && (x as string).length > 0
+          );
+        } else {
+          return res.status(400).json({ error: 'bound_judgment_ids must be array or null' });
+        }
+        console.log(`[Channel ${channelId}] 绑定判断力: ${channel.bound_judgment_ids.length} 条`);
+      }
       channel.updatedAt = new Date().toISOString();
       await saveChannels(channels);
       res.json(channel);
@@ -1225,8 +1375,9 @@ app.get('/channels', async (_req, res) => {
         }
       };
 
-      // 重新生成时只发送用户消息
-      fullResponse = await agent.promptStream(userMessage, streamCallback);
+      // 重新生成时只发送用户消息 (v3: 同时注入 channel 绑定的判断力)
+      const regenHint = await buildJudgmentHint(channel, channelId);
+      fullResponse = await agent.promptStream(regenHint + userMessage, streamCallback);
 
       broadcast({ type: 'ai', content: fullResponse }, channelId);
 
@@ -1767,6 +1918,88 @@ app.get('/channels', async (_req, res) => {
         }, 'p2p-global');
       });
 
+      // ============ v3: 跨用户 channel 元数据 RPC ============
+      // 设计原则: judgment / bound_judgment_ids / wallet 等敏感字段绝不出现在 RPC 响应里.
+      // 收到 'agent.meta.list' → 返回本节点所有 channel 的 UI 元数据 (无 judgment)
+      // 收到 'agent.meta.get' + channelId → 返回单条 channel 的 UI 元数据
+      // B 节点收到响应 → 存到远端 cache → 渲染到 "远端智能体" 区域
+
+      // B 侧: 收到对端的 list/get 回复 → 更新远端 cache → SSE 推给前端
+      irohTransport.onMessage('agent.meta.list.reply', (msg) => {
+        try {
+          const data = JSON.parse(new TextDecoder().decode(msg.payload));
+          if (!data.ok) return;
+          const peerId = msg.from;
+          const list = Array.isArray(data.channels) ? data.channels : [];
+          remoteChannelCache.set(peerId, list);
+          console.log(`[v3] 缓存远端 peer ${peerId.substring(0, 12)}... 的 ${list.length} 个 channel`);
+          broadcast({
+            type: 'remote-channel-update',
+            peerId,
+            channels: list
+          }, 'p2p-global');
+        } catch (err) {
+          console.error('[v3] 处理 agent.meta.list.reply 失败:', err);
+        }
+      });
+
+      irohTransport.onMessage('agent.meta.get.reply', (msg) => {
+        try {
+          const data = JSON.parse(new TextDecoder().decode(msg.payload));
+          if (!data.ok || !data.channel) return;
+          const peerId = msg.from;
+          const ch = data.channel;
+          const list = remoteChannelCache.get(peerId) || [];
+          const idx = list.findIndex(c => c.id === ch.id);
+          if (idx >= 0) list[idx] = ch;
+          else list.push(ch);
+          remoteChannelCache.set(peerId, list);
+          broadcast({
+            type: 'remote-channel-update',
+            peerId,
+            channels: list
+          }, 'p2p-global');
+        } catch (err) {
+          console.error('[v3] 处理 agent.meta.get.reply 失败:', err);
+        }
+      });
+
+      // A 侧: 收到对端的 list/get 请求
+      irohTransport.onMessage('agent.meta.list', async (msg) => {
+        console.log(`[v3] 收到 agent.meta.list from ${msg.from.substring(0, 12)}...`);
+        try {
+          const channels = await loadChannels();
+          const publicMeta = channels.map(sanitizeChannelForPeer);
+          const response = JSON.stringify({ ok: true, channels: publicMeta });
+          const encoded = new TextEncoder().encode(response);
+          // 沿用 msg.from 路由回去
+          irohTransport.sendMessage(msg.from, 'agent.meta.list.reply', encoded).catch(err => {
+            console.error('[v3] 发送 agent.meta.list.reply 失败:', err);
+          });
+        } catch (err) {
+          console.error('[v3] 处理 agent.meta.list 失败:', err);
+        }
+      });
+
+      irohTransport.onMessage('agent.meta.get', async (msg) => {
+        try {
+          const req = JSON.parse(new TextDecoder().decode(msg.payload));
+          const channelId = req.channelId;
+          console.log(`[v3] 收到 agent.meta.get for ${channelId} from ${msg.from.substring(0, 12)}...`);
+          const channels = await loadChannels();
+          const ch = channels.find(c => c.id === channelId);
+          if (!ch) {
+            const response = JSON.stringify({ ok: false, error: 'channel not found' });
+            irohTransport.sendMessage(msg.from, 'agent.meta.get.reply', new TextEncoder().encode(response));
+            return;
+          }
+          const response = JSON.stringify({ ok: true, channel: sanitizeChannelForPeer(ch) });
+          irohTransport.sendMessage(msg.from, 'agent.meta.get.reply', new TextEncoder().encode(response));
+        } catch (err) {
+          console.error('[v3] 处理 agent.meta.get 失败:', err);
+        }
+      });
+
       irohTransport.onMessage('ai-dialogue', (msg) => {
         const content = new TextDecoder().decode(msg.payload);
         console.log(`[iroh] 收到 AI 对话 from ${msg.from.substring(0, 12)}...`);
@@ -2451,7 +2684,8 @@ app.get('/channels', async (_req, res) => {
   try {
     const { createHealthMonitor, createWatchdog } = await import('../heartbeat/index.js');
     healthMonitor = createHealthMonitor();
-    watchdog = createWatchdog();
+    // 把 watchdog 静默阈值拉到 30 分钟, 避免开发期 / 用户空闲时被误杀
+    watchdog = createWatchdog({ silentThresholdMs: 30 * 60 * 1000 });
 
     console.log('[24h] Heartbeat modules loaded');
   } catch (err) {

package/src/web/style.css

@@ -269,6 +269,41 @@ body {
   padding: 16px;
   position: relative;
 }
+
+/* v3: 本地/远端 flex 比例由 CSS variable 驱动, 拖拽分隔线时改这两个值 */
+.sidebar-section.local-flex { flex: var(--local-flex, 1) 1 0; }
+.sidebar-section.remote-flex { flex: var(--remote-flex, 1) 1 0; transition: flex 0.15s; }
+
+/* v3: 可拖拽分隔线 */
+#sidebar-split-handle {
+  flex: 0 0 auto;
+  height: 6px;
+  cursor: ns-resize;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  position: relative;
+  background: transparent;
+  user-select: none;
+}
+#sidebar-split-handle:hover { background: var(--bg-hover); }
+#sidebar-split-handle.dragging { background: var(--accent-glow); }
+#sidebar-split-handle .split-handle-grip {
+  width: 32px;
+  height: 3px;
+  border-radius: 2px;
+  background: var(--border-light);
+  pointer-events: none;
+}
+#sidebar-split-handle:hover .split-handle-grip,
+#sidebar-split-handle.dragging .split-handle-grip { background: var(--accent); }
+
+/* v3: 远端区域折叠状态 */
+#remote-agents-section.collapsed .channel-list { display: none; }
+#remote-agents-section.collapsed { flex: 0 0 auto; padding-top: 0; padding-bottom: 0; }
+#remote-agents-section.collapsed .section-header { margin-bottom: 0; }
+#remote-agents-section.collapsed #remote-agents-toggle { transform: rotate(-90deg); }
+
 .section-header {
   display: flex;
   align-items: center;