@co0ontty/wand 1.63.1 → 1.64.0

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commit": "c173e20f2e7e864991c953a06e6187e84f422e67",
-  "builtAt": "2026-06-14T06:57:16.056Z",
-  "version": "1.63.1",
+  "commit": "e1e2c0bff9e13be91e47f3bbfc02fec8eca1e1d8",
+  "builtAt": "2026-06-14T12:18:11.568Z",
+  "version": "1.64.0",
   "channel": "stable"
 }

package/dist/message-truncator.d.ts

@@ -4,6 +4,25 @@
  * with a summary, and clients fetch full content on-demand via API.
  */
 import type { CardExpandDefaults, ConversationTurn } from "./types.js";
+/**
+ * 默认窗口大小：init/resync/快照/REST 默认只下发最近这么多条 turn，更早的由客户端
+ * 滚动到顶时按需分页拉取。移动端 WebSocket 单帧上限（iOS 默认 1 MiB）下，长会话一次
+ * 全量下发会撑爆帧导致反复断连——窗口化是根治手段，64MB 提帧只是兜底。
+ */
+export declare const MESSAGE_WINDOW_SIZE = 40;
+export interface WindowedMessages {
+    /** 已截断 + 窗口化后的 turn 列表（最近 windowSize 条）。 */
+    messages: ConversationTurn[];
+    /** messages[0] 在完整历史里的绝对下标（0 表示已含最早一条）。 */
+    messageOffset: number;
+    /** 完整历史的 turn 总数（客户端据此判断是否还有更早的可加载）。 */
+    messageTotal: number;
+}
+/**
+ * 取完整历史的「最近 windowSize 条」并对其做 transport 截断，附带 offset/total 元数据。
+ * 客户端持有的永远是一段连续的「后缀」（最近的若干条），更早的按 offset 往前翻页。
+ */
+export declare function windowMessagesForTransport(all: ConversationTurn[] | undefined, cardDefaults: CardExpandDefaults, windowSize?: number): WindowedMessages;
 /**
  * Truncate messages for WebSocket transport. Tool results for collapsed card
  * types are replaced with a short summary when they exceed the threshold.

package/dist/message-truncator.js

@@ -5,6 +5,26 @@
  */
 const TRUNCATION_THRESHOLD = 200;
 const SUMMARY_LENGTH = 100;
+/**
+ * 默认窗口大小：init/resync/快照/REST 默认只下发最近这么多条 turn，更早的由客户端
+ * 滚动到顶时按需分页拉取。移动端 WebSocket 单帧上限（iOS 默认 1 MiB）下，长会话一次
+ * 全量下发会撑爆帧导致反复断连——窗口化是根治手段，64MB 提帧只是兜底。
+ */
+export const MESSAGE_WINDOW_SIZE = 40;
+/**
+ * 取完整历史的「最近 windowSize 条」并对其做 transport 截断，附带 offset/total 元数据。
+ * 客户端持有的永远是一段连续的「后缀」（最近的若干条），更早的按 offset 往前翻页。
+ */
+export function windowMessagesForTransport(all, cardDefaults, windowSize = MESSAGE_WINDOW_SIZE) {
+    const total = all?.length ?? 0;
+    const offset = Math.max(0, total - windowSize);
+    const slice = all ? all.slice(offset) : [];
+    return {
+        messages: truncateMessagesForTransport(slice, cardDefaults),
+        messageOffset: offset,
+        messageTotal: total,
+    };
+}
 /** Tool name → cardDefaults field mapping */
 function isToolDefaultCollapsed(toolName, defaults) {
     switch (toolName) {

package/dist/server-session-routes.js

@@ -1,6 +1,7 @@
 import express from "express";
 import { SessionInputError } from "./process-manager.js";
 import { normalizeMode } from "./config.js";
+import { truncateMessagesForTransport, windowMessagesForTransport } from "./message-truncator.js";
 import { checkSessionWorktreeMergeability, cleanupSessionWorktree, getWorktreeMergeErrorCode, mergeSessionWorktree, WorktreeMergeError } from "./git-worktree.js";
 import { getGitStatus, QuickCommitError, runQuickCommit, runTagHead, runPush, generateCommitMessageOnly, } from "./git-quick-commit.js";
 import { getErrorMessage } from "./error-utils.js";
@@ -598,13 +599,38 @@ export function registerSessionRoutes(app, processes, structured, storage, defau
             ? processes.getPtyTranscript(snapshot.id) ?? snapshot.output
             : snapshot.output;
         if (req.query.format === "chat") {
-            const messages = snapshot.messages ?? [];
-            res.json({ ...snapshot, output: transcriptOutput, messages });
+            // 与 WS init 对齐：只回最近一窗 turn + offset/total，更早的走 /messages 翻页。
+            const windowed = windowMessagesForTransport(snapshot.messages ?? [], config.cardDefaults ?? {});
+            res.json({
+                ...snapshot,
+                output: transcriptOutput,
+                messages: windowed.messages,
+                messageOffset: windowed.messageOffset,
+                messageTotal: windowed.messageTotal,
+            });
         }
         else {
             res.json({ ...snapshot, output: transcriptOutput });
         }
     });
+    // 历史消息分页拉取：客户端滚动到顶时按绝对下标往前翻。
+    // 返回 messages = 完整历史的 [offset, offset+limit)（已做 transport 截断）+ total。
+    app.get("/api/sessions/:id/messages", (req, res) => {
+        const snapshot = getSessionById(processes, structured, req.params.id);
+        if (!snapshot) {
+            res.status(404).json({ error: "未找到该会话，可能已被删除。" });
+            return;
+        }
+        const all = snapshot.messages ?? [];
+        const total = all.length;
+        const rawLimit = parseInt(String(req.query.limit ?? ""), 10);
+        const rawOffset = parseInt(String(req.query.offset ?? ""), 10);
+        const limit = Math.min(Math.max(Number.isFinite(rawLimit) ? rawLimit : 40, 1), 200);
+        const offset = Math.min(Math.max(Number.isFinite(rawOffset) ? rawOffset : 0, 0), total);
+        const end = Math.min(offset + limit, total);
+        const slice = truncateMessagesForTransport(all.slice(offset, end), config.cardDefaults ?? {});
+        res.json({ messages: slice, offset, total });
+    });
     app.post("/api/sessions/:id/resume", (req, res) => {
         const sessionId = req.params.id;
         const body = req.body;