@agentdevjs/viewer 0.1.0 → 0.1.1

package/dist/{chunk-OPBQEOJC.js → chunk-OVQA4A62.js}

@@ -6844,9 +6844,9 @@ var ViewerWorker = class _ViewerWorker {
           reject(err);
         }
       });
-      this.server.listen(this.port, async () => {
-        const url = `http://localhost:${this.port}`;
-        console.log(`[Viewer Worker] ${url}`);
+      this.server.listen(this.port, "127.0.0.1", async () => {
+        const url = `http://127.0.0.1:${this.port}`;
+        console.log(`[Viewer Worker] ${url} (loopback only)`);
         console.log(`[Viewer Worker] MCP endpoint: ${url}/mcp`);
         if (this.openBrowser) {
           try {
@@ -7037,7 +7037,7 @@ var ViewerWorker = class _ViewerWorker {
     }
     const msgMatch = url.match(/^\/api\/agents\/([^/]+)\/messages$/);
     if (msgMatch && req.method === "GET") {
-      this.handleGetAgentMessages(req, res, msgMatch[1]);
+      this.handleGetAgentMessages(req, res, msgMatch[1], urlObj.searchParams);
       return;
     }
     const toolsMatch = url.match(/^\/api\/agents\/([^/]+)\/tools$/);
@@ -7197,20 +7197,46 @@ var ViewerWorker = class _ViewerWorker {
           }
         }
       }
-    } catch (e) {
+    } catch {
     }
     return null;
   }
   /**
    * GET /api/agents/:id/messages - 获取指定 Agent 的消息
+   *
+   * 增量取数（ADR-0012）：?since=<n> 返回自下标 n 起的尾部切片（附 baseCount）；
+   * ?tail=1 返回最后一条。无参数路径的响应形状与历史完全一致（全量数组）。
    */
-  handleGetAgentMessages(req, res, agentId) {
+  handleGetAgentMessages(req, res, agentId, searchParams) {
     const session = this.agentSessions.get(agentId);
     if (!session) {
       res.writeHead(404);
       res.end(JSON.stringify({ error: "Agent not found" }));
       return;
     }
+    const since = searchParams?.get("since");
+    if (since !== null && since !== void 0) {
+      const n = Number.parseInt(since, 10);
+      if (Number.isNaN(n) || n < 0) {
+        res.writeHead(400, { "Content-Type": "application/json; charset=utf-8" });
+        res.end(JSON.stringify({ error: "Invalid since parameter" }));
+        return;
+      }
+      res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
+      res.end(JSON.stringify({
+        messages: session.messages.slice(n),
+        baseCount: n
+      }));
+      return;
+    }
+    if (searchParams?.get("tail") === "1") {
+      const last = session.messages.length > 0 ? session.messages[session.messages.length - 1] : null;
+      res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
+      res.end(JSON.stringify({
+        messages: last ? [last] : []
+      }));
+      return;
+    }
     res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
     res.end(JSON.stringify({
       agentId,
@@ -7252,7 +7278,9 @@ var ViewerWorker = class _ViewerWorker {
       return;
     }
     res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
-    res.end(JSON.stringify(this.getMergedOverview(session)));
+    const overview = this.getMergedOverview(session);
+    const probe = this.getMessagesProbe(session);
+    res.end(JSON.stringify(probe ? { ...overview, _messagesProbe: probe } : overview));
   }
   handleGetAgentTodoPlan(req, res, agentId) {
     const session = this.agentSessions.get(agentId);
@@ -7438,7 +7466,7 @@ var ViewerWorker = class _ViewerWorker {
         delete session.inputLease;
         res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
         res.end(JSON.stringify({ success: true }));
-      } catch (e) {
+      } catch {
         res.writeHead(400);
         res.end(JSON.stringify({ error: "Invalid request" }));
       }
@@ -7759,17 +7787,35 @@ var ViewerWorker = class _ViewerWorker {
   }
   /**
    * 应用内存限制
+   *
+   * 字节限制基于增量缓存 _totalBytes（推送时维护，修剪时扣减）：未超限
+   * 零序列化开销；未初始化（旧路径未走过推送）时先全量求和建立基线。
+   * 切点语义与原实现一致：超出 MAX_BYTES 时保留首个超限条目之后的尾部。
    */
   enforceMemoryLimits(session) {
+    const store = session;
     while (session.messages.length > this.MAX_MESSAGES) {
-      session.messages.shift();
+      const removed = session.messages.shift();
+      if (typeof store._totalBytes === "number") {
+        store._totalBytes -= JSON.stringify(removed).length;
+      }
     }
-    let byteSize = 0;
-    for (let i = 0; i < session.messages.length; i++) {
-      byteSize += JSON.stringify(session.messages[i]).length;
-      if (byteSize > this.MAX_BYTES) {
-        session.messages = session.messages.slice(i + 1);
-        break;
+    if (typeof store._totalBytes !== "number") {
+      let total = 0;
+      for (let i = 0; i < session.messages.length; i++) {
+        total += JSON.stringify(session.messages[i]).length;
+      }
+      store._totalBytes = total;
+    }
+    if (store._totalBytes > this.MAX_BYTES) {
+      let byteSize = 0;
+      for (let i = 0; i < session.messages.length; i++) {
+        byteSize += JSON.stringify(session.messages[i]).length;
+        if (byteSize > this.MAX_BYTES) {
+          session.messages = session.messages.slice(i + 1);
+          store._totalBytes -= byteSize;
+          break;
+        }
       }
     }
   }
@@ -7778,7 +7824,7 @@ var ViewerWorker = class _ViewerWorker {
    * 处理注册 Agent
    */
   handleRegisterAgent(msg, clientId) {
-    const { agentId, name, createdAt, projectRoot, templateMounts, templateEntries, hookInspector, overview, activeInputRequest, inputPolicy } = msg;
+    const { agentId, name, projectRoot, templateMounts, templateEntries, hookInspector, overview, activeInputRequest, inputPolicy } = msg;
     const session = this.getOrCreateSession(agentId, name);
     if (inputPolicy === "none") {
       session.inputPolicy = "none";
@@ -7887,18 +7933,33 @@ var ViewerWorker = class _ViewerWorker {
   /**
    * 处理推送消息（带去重优化）
    *
-   * 只有在消息真正变化时才更新会话并触发前端更新
+   * 只有在消息真正变化时才更新会话并触发前端更新。推送时刻新旧数组都在手上，
+   * 顺带完成变更分类（ADR-0012）并增量维护总字节缓存；分类为 rewrite 时
+   * 照常更新 session.messages——修正"中段变化但 count 与末条签名均不变"
+   * 被静默丢弃的盲区。
    */
   handlePushMessages(msg) {
     const { agentId, messages } = msg;
     const session = this.agentSessions.get(agentId);
     if (!session) return;
-    const messagesChanged = this.hasMessagesChanged(session, messages);
-    if (messagesChanged) {
+    const oldMessages = session.messages;
+    const change = this.classifyMessagesChange(oldMessages, messages);
+    if (change) {
       session.messages = messages;
+      const store = session;
+      store._messagesChangeSeq = (typeof store._messagesChangeSeq === "number" ? store._messagesChangeSeq : 0) + 1;
+      this.updateTotalBytes(session, oldMessages, messages, change.changeKind);
       session._lastMessageSig = this.getLastMessageSignature(messages);
       this.updateSessionActivity(agentId);
+      const preTrimCount = messages.length;
       this.enforceMemoryLimits(session);
+      const trimmed = session.messages.length < preTrimCount;
+      store._messagesChange = {
+        changeKind: trimmed ? "rewrite" : change.changeKind,
+        sinceIndex: trimmed ? 0 : change.sinceIndex,
+        fakeFullBytes: store._totalBytes
+      };
+    } else if (typeof session._totalBytes !== "number") {
     }
   }
   createEmptyOverview() {
@@ -8031,18 +8092,78 @@ var ViewerWorker = class _ViewerWorker {
     };
   }
   /**
-   * 检查消息是否发生变化
+   * 变更分类（ADR-0012，推送时刻新旧数组都在手上）：
+   * - append：新数组以旧数组为前缀且变长（sinceIndex = 旧数组长度）
+   * - tail：条数不变，仅最后一条不同（流式输出）
+   * - rewrite：其余（中段替换 / 条数减少，含 count 与末条签名均不变的盲区）
+   * 返回 null 表示未变化。
    */
-  hasMessagesChanged(session, newMessages) {
-    if (newMessages.length !== session.messages.length) {
-      return true;
+  classifyMessagesChange(oldMessages, newMessages) {
+    const oldLen = oldMessages.length;
+    const newLen = newMessages.length;
+    if (newLen > oldLen && this.isSameMessagePrefix(oldMessages, newMessages, oldLen)) {
+      return { changeKind: "append", sinceIndex: oldLen };
+    }
+    if (newLen === oldLen) {
+      if (newLen === 0) return null;
+      const lastSigChanged = this.getLastMessageSignature(newMessages) !== this.getLastMessageSignature(oldMessages);
+      const prefixLen = lastSigChanged ? newLen - 1 : newLen;
+      if (this.isSameMessagePrefix(oldMessages, newMessages, prefixLen)) {
+        return lastSigChanged ? { changeKind: "tail", sinceIndex: newLen - 1 } : null;
+      }
+      return { changeKind: "rewrite", sinceIndex: 0 };
     }
-    if (newMessages.length === 0) {
-      return false;
+    return { changeKind: "rewrite", sinceIndex: 0 };
+  }
+  /**
+   * 判断两数组前 len 条是否逐条一致：先比引用（运行时对未变化条目通常
+   * 复用同一对象），不一致再退回 JSON 全等（消息对象可能被重建）。
+   */
+  isSameMessagePrefix(oldMessages, newMessages, len) {
+    for (let i = 0; i < len; i++) {
+      if (oldMessages[i] === newMessages[i]) continue;
+      if (JSON.stringify(oldMessages[i]) !== JSON.stringify(newMessages[i])) return false;
+    }
+    return true;
+  }
+  /**
+   * 消息探测数据（/overview HTTP 组装用，ADR-0012）。count 取当前消息数，
+   * 其余为最近一次推送记录下的分类与假想全量字节；未走过推送路径
+   * （_totalBytes 未初始化）时返回 null，调用方据此整体省略 _messagesProbe。
+   */
+  getMessagesProbe(session) {
+    const change = session._messagesChange;
+    if (!change || typeof session._totalBytes !== "number") return null;
+    return {
+      seq: session._messagesChangeSeq || 0,
+      count: session.messages.length,
+      changeKind: change.changeKind,
+      sinceIndex: change.sinceIndex,
+      fakeFullBytes: change.fakeFullBytes
+    };
+  }
+  /**
+   * 增量维护 session 总字节缓存（_totalBytes = 全量响应体假想字节数）：
+   * append 只序列化新增条目，tail 只序列化末条新旧两份；rewrite（rollback /
+   * compact 等低频路径）与未初始化基线时全量重建。
+   */
+  updateTotalBytes(session, oldMessages, newMessages, changeKind) {
+    const store = session;
+    if (typeof store._totalBytes !== "number" || changeKind === "rewrite") {
+      let total = 0;
+      for (let i = 0; i < newMessages.length; i++) {
+        total += JSON.stringify(newMessages[i]).length;
+      }
+      store._totalBytes = total;
+      return;
+    }
+    if (changeKind === "append") {
+      for (let i = oldMessages.length; i < newMessages.length; i++) {
+        store._totalBytes += JSON.stringify(newMessages[i]).length;
+      }
+      return;
     }
-    const newSig = this.getLastMessageSignature(newMessages);
-    const oldSig = session._lastMessageSig;
-    return newSig !== oldSig;
+    store._totalBytes += JSON.stringify(newMessages[newMessages.length - 1]).length - JSON.stringify(oldMessages[oldMessages.length - 1]).length;
   }
   /**
    * 获取最后一条消息的签名（用于变化检测）
@@ -8565,4 +8686,4 @@ export {
   generateViewerHtml,
   ViewerWorker
 };
-//# sourceMappingURL=chunk-OPBQEOJC.js.map
+//# sourceMappingURL=chunk-OVQA4A62.js.map