@co0ontty/wand 4.76.0 → 4.77.0-beta.g7fb0b70

package/dist/git-quick-commit.js

@@ -5,7 +5,7 @@ import { callSystemAiTextWithFallback } from "./system-ai.js";
 import { buildChildEnv } from "./env-utils.js";
 import { isSessionProvider } from "./session-provider.js";
 import { runGitAsync as runGitAsyncBase, runGitRawAsync as runGitRawAsyncBase, getGitErrorMessage, } from "./git-utils.js";
-import { thinkingEffortToClaudeCliEffort, thinkingEffortToCodexReasoningEffort, thinkingEffortToGrokEffort, thinkingEffortToOpenCodeVariant, thinkingEffortToQoderEffort, thinkingEffortToPiLevel, } from "./structured-provider-common.js";
+import { composeSystemFallback, systemPromptFlag, thinkingEffortToClaudeCliEffort, thinkingEffortToCodexReasoningEffort, thinkingEffortToGrokEffort, thinkingEffortToOpenCodeVariant, thinkingEffortToQoderEffort, thinkingEffortToPiLevel, } from "./structured-provider-common.js";
 /** provider 缺省值：无法识别时回落到 Claude。 */
 function defaultProvider(provider) {
     return isSessionProvider(provider) ? provider : "claude";
@@ -283,13 +283,14 @@ export class QuickCommitError extends Error {
     }
 }
 // ── AI commit message generation ──
-async function callClaudeText(prompt, cwd, language, opts) {
+async function callClaudeText(request, cwd, language, opts) {
     try {
         const effort = thinkingEffortToClaudeCliEffort(opts.thinkingEffort ?? "off");
-        return await runClaudePrint(prompt, {
+        return await runClaudePrint(request.prompt, {
             cwd,
             timeoutMs: CLAUDE_MESSAGE_TIMEOUT_MS,
             language,
+            systemInstructions: request.system,
             model: opts.model ?? undefined,
             ...(effort ? { effort } : {}),
         });
@@ -421,7 +422,7 @@ function extractPiText(stdout) {
     }
     return text.trim();
 }
-function buildPiTextArgs(prompt, opts, allowTools = false) {
+function buildPiTextArgs(request, opts, allowTools = false) {
     const args = ["--mode", "json", "--print", "--no-session"];
     if (!allowTools)
         args.push("--no-tools");
@@ -431,33 +432,48 @@ function buildPiTextArgs(prompt, opts, allowTools = false) {
     const level = thinkingEffortToPiLevel(opts.thinkingEffort ?? "off");
     if (level)
         args.push("--thinking", level);
-    args.push(prompt);
+    args.push(...systemPromptArgsFrom("pi", request.system));
+    args.push(request.prompt);
     return args;
 }
-function buildGrokTextArgs(prompt, opts, allowTools = false) {
-    const args = ["--no-auto-update", "-p", prompt, "--output-format", "streaming-json"];
+function buildGrokTextArgs(request, opts, allowTools = false) {
+    const args = ["--no-auto-update", "-p", request.prompt, "--output-format", "streaming-json"];
     const model = opts.model?.trim();
     if (model && model !== "default")
         args.push("--model", model);
     const effort = thinkingEffortToGrokEffort(opts.thinkingEffort ?? "off");
     if (effort)
         args.push("--effort", effort);
+    args.push(...systemPromptArgsFrom("grok", request.system));
     if (allowTools)
         args.push("--always-approve");
     return args;
 }
-function buildQoderTextArgs(prompt, opts, allowTools = false) {
-    const args = ["-p", prompt, "--output-format", "stream-json", "--no-session-persistence"];
+function buildQoderTextArgs(request, opts, allowTools = false) {
+    const args = ["-p", request.prompt, "--output-format", "stream-json", "--no-session-persistence"];
     const model = opts.model?.trim();
     if (model && model !== "default")
         args.push("--model", model);
     const effort = thinkingEffortToQoderEffort(opts.thinkingEffort ?? "off");
     if (effort)
         args.push("--reasoning-effort", effort);
+    args.push(...systemPromptArgsFrom("qoder", request.system));
     if (allowTools)
         args.push("--permission-mode", "bypass_permissions");
     return args;
 }
+/** provider 自己的系统提示开关 + 规则文本；没有开关的 provider 返回空。 */
+function systemPromptArgsFrom(provider, system) {
+    const text = system?.trim();
+    if (!text)
+        return [];
+    const flag = systemPromptFlag(provider);
+    return flag ? [flag, text] : [];
+}
+/** 没有系统提示开关的 provider（codex / opencode）：规则只能并进内容前面。 */
+function contentWithSystemPrompt(provider, request) {
+    return systemPromptFlag(provider) ? request.prompt : composeSystemFallback(request.system, request.prompt);
+}
 function runCliText(command, args, prompt, opts) {
     return new Promise((resolve, reject) => {
         const child = spawn(command, args, {
@@ -509,7 +525,7 @@ function runCliText(command, args, prompt, opts) {
         child.stdin?.end(prompt);
     });
 }
-async function callCodexText(prompt, cwd, opts) {
+async function callCodexText(request, cwd, opts) {
     // Quick commit is an internal one-shot request, not a user conversation. Keep
     // Codex from persisting it into ~/.codex/sessions, where Wand would otherwise
     // surface the generated prompt as a recoverable session.
@@ -521,7 +537,7 @@ async function callCodexText(prompt, cwd, opts) {
     if (reasoningEffort)
         args.push("-c", `model_reasoning_effort=${reasoningEffort}`);
     args.push("-");
-    const stdout = await runCliText("codex", args, prompt, {
+    const stdout = await runCliText("codex", args, contentWithSystemPrompt("codex", request), {
         cwd,
         timeoutMs: CODEX_MESSAGE_TIMEOUT_MS,
         inheritEnv: opts.inheritEnv,
@@ -532,7 +548,7 @@ async function callCodexText(prompt, cwd, opts) {
     }
     return text;
 }
-async function callOpenCodeText(prompt, cwd, opts) {
+async function callOpenCodeText(request, cwd, opts) {
     const args = ["run", "--format", "json"];
     const model = opts.model?.trim();
     if (model && model !== "default")
@@ -540,7 +556,7 @@ async function callOpenCodeText(prompt, cwd, opts) {
     const variant = thinkingEffortToOpenCodeVariant(opts.thinkingEffort ?? "off");
     if (variant)
         args.push("--variant", variant);
-    const stdout = await runCliText("opencode", args, prompt, {
+    const stdout = await runCliText("opencode", args, contentWithSystemPrompt("opencode", request), {
         cwd,
         timeoutMs: CODEX_MESSAGE_TIMEOUT_MS,
         inheritEnv: opts.inheritEnv,
@@ -550,8 +566,8 @@ async function callOpenCodeText(prompt, cwd, opts) {
         throw new QuickCommitError("OpenCode 返回了空的 commit message。", "EMPTY_AI_MESSAGE");
     return text;
 }
-async function callGrokText(prompt, cwd, opts) {
-    const stdout = await runCliText("grok", buildGrokTextArgs(prompt, opts), "", {
+async function callGrokText(request, cwd, opts) {
+    const stdout = await runCliText("grok", buildGrokTextArgs(request, opts), "", {
         cwd,
         timeoutMs: CODEX_MESSAGE_TIMEOUT_MS,
         inheritEnv: opts.inheritEnv,
@@ -561,8 +577,8 @@ async function callGrokText(prompt, cwd, opts) {
         throw new QuickCommitError("Grok 返回了空的 commit message。", "EMPTY_AI_MESSAGE");
     return text;
 }
-async function callQoderText(prompt, cwd, opts) {
-    const stdout = await runCliText("qodercli", buildQoderTextArgs(prompt, opts), "", {
+async function callQoderText(request, cwd, opts) {
+    const stdout = await runCliText("qodercli", buildQoderTextArgs(request, opts), "", {
         cwd,
         timeoutMs: CODEX_MESSAGE_TIMEOUT_MS,
         inheritEnv: opts.inheritEnv,
@@ -572,30 +588,30 @@ async function callQoderText(prompt, cwd, opts) {
         throw new QuickCommitError("Qoder 返回了空的 commit message。", "EMPTY_AI_MESSAGE");
     return text;
 }
-async function callPiText(prompt, cwd, opts) {
-    const stdout = await runCliText("pi", buildPiTextArgs(prompt, opts), "", { cwd, timeoutMs: CODEX_MESSAGE_TIMEOUT_MS, inheritEnv: opts.inheritEnv });
+async function callPiText(request, cwd, opts) {
+    const stdout = await runCliText("pi", buildPiTextArgs(request, opts), "", { cwd, timeoutMs: CODEX_MESSAGE_TIMEOUT_MS, inheritEnv: opts.inheritEnv });
     const text = extractPiText(stdout);
     if (!text)
         throw new QuickCommitError("Pi 返回了空的 commit message。", "EMPTY_AI_MESSAGE");
     return text;
 }
-async function callCliAiText(prompt, cwd, language, opts) {
+async function callCliAiText(request, cwd, language, opts) {
     const provider = defaultProvider(opts.provider);
     if (provider === "codex") {
-        return callCodexText(prompt, cwd, opts);
+        return callCodexText(request, cwd, opts);
     }
     if (provider === "opencode")
-        return callOpenCodeText(prompt, cwd, opts);
+        return callOpenCodeText(request, cwd, opts);
     if (provider === "grok")
-        return callGrokText(prompt, cwd, opts);
+        return callGrokText(request, cwd, opts);
     if (provider === "qoder")
-        return callQoderText(prompt, cwd, opts);
+        return callQoderText(request, cwd, opts);
     if (provider === "pi")
-        return callPiText(prompt, cwd, opts);
-    return callClaudeText(prompt, cwd, language, opts);
+        return callPiText(request, cwd, opts);
+    return callClaudeText(request, cwd, language, opts);
 }
-async function callDirectApiText(prompt, systemAi) {
-    const text = await callSystemAiTextWithFallback(prompt, systemAi, DIRECT_API_PROFILE_TIMEOUT_MS);
+async function callDirectApiText(request, systemAi) {
+    const text = await callSystemAiTextWithFallback(request, systemAi, DIRECT_API_PROFILE_TIMEOUT_MS);
     if (!text.trim()) {
         throw new QuickCommitError("直连 API 返回了空结果。", "EMPTY_AI_MESSAGE");
     }
@@ -610,23 +626,23 @@ function aiFallbackFailed(primary, primaryError, fallbackError) {
  * exhausts its profile chain and then falls back once to the current-session
  * CLI. CLI mode uses only that CLI.
  */
-export async function callConfiguredAiText(prompt, cwd, language, opts) {
+export async function callConfiguredAiText(request, cwd, language, opts) {
     if (opts.systemAi?.enabled) {
         try {
-            return await callDirectApiText(prompt, opts.systemAi);
+            return await callDirectApiText(request, opts.systemAi);
         }
         catch (apiError) {
             try {
                 // The user selected the direct API first. If it is unavailable or
                 // empty, retry this exact request through their selected CLI.
-                return await callCliAiText(prompt, cwd, language, opts);
+                return await callCliAiText(request, cwd, language, opts);
             }
             catch (cliError) {
                 throw aiFallbackFailed("直连 API", apiError, cliError);
             }
         }
     }
-    return callCliAiText(prompt, cwd, language, opts);
+    return callCliAiText(request, cwd, language, opts);
 }
 /** Read the unstaged + staged tree without touching the index. */
 async function collectWorkingTreeDiff(cwd) {
@@ -717,8 +733,7 @@ function commitTaskLine(lang, usedIteration) {
 async function generateCommitMessage(cwd, language, ai = {}, options = {}) {
     const { input, usedIteration } = await buildCommitPromptInput(cwd, options);
     const lang = language.trim() || "中文";
-    const prompt = `${commitTaskLine(lang, usedIteration)}\n\n${input}`;
-    const raw = await callConfiguredAiText(prompt, cwd, language, ai);
+    const raw = await callConfiguredAiText({ system: commitTaskLine(lang, usedIteration), prompt: input }, cwd, language, ai);
     const message = normalizeAiText(raw);
     if (!message) {
         throw new QuickCommitError("AI 返回了空的 commit message。", "EMPTY_AI_MESSAGE");
@@ -765,15 +780,13 @@ async function generateCommitMessageWithTag(cwd, language, ai = {}, options = {}
     const tagHint = latestTag
         ? `当前最新 tag 是 \`${latestTag}\`，请基于它给出下一个版本号（保持原有前缀风格，例如有 \`v\` 就保留 \`v\`）。`
         : `仓库还没有任何 tag，请直接给一个起始版本号（建议 \`v0.0.1\` / \`v0.1.0\` / \`v1.0.0\` 之一，按改动幅度选择）。`;
-    const prompt = `阅读以下输入，完成两件事：
+    const system = `阅读本轮用户消息，完成两件事：
 1. 用${lang}写一条简洁的 commit message（祈使句，不超过 50 字，描述「做了什么」）。
-2. 根据改动幅度推荐下一个语义化版本 tag（破坏性变更 → 升 major；新增功能 → 升 minor；修复 / 文档 / 重构 / 维护 → 升 patch）。${tagHint}
+2. 根据改动幅度推荐下一个语义化版本 tag（破坏性变更 → 升 major；新增功能 → 升 minor；修复 / 文档 / 重构 / 维护 → 升 patch）。
 
 请严格输出**单行 JSON 对象**，不要 Markdown 代码块、不要任何解释文字、不要多余引号。格式：
-{"message":"...","tag":"v1.2.3"}
-
-${input}`;
-    const raw = await callConfiguredAiText(prompt, cwd, language, ai);
+{"message":"...","tag":"v1.2.3"}`;
+    const raw = await callConfiguredAiText({ system, prompt: `${tagHint}\n\n${input}` }, cwd, language, ai);
     const parsed = tryParseJson(raw);
     let message;
     let suggestedTag;
@@ -833,16 +846,12 @@ async function generateTagAfterCommit(cwd, language, commitMessage, ai = {}) {
     const tagHint = latestTag
         ? `当前最新 tag 是 \`${latestTag}\`，请基于它给出下一个版本号（保持原有前缀风格，例如有 \`v\` 就保留 \`v\`）。`
         : `仓库还没有任何 tag，请给一个起始版本号（建议 \`v0.0.1\` / \`v0.1.0\` / \`v1.0.0\` 之一，按改动幅度选择）。`;
-    const prompt = `根据以下 commit message 和 git diff 推荐一个语义化版本 tag（破坏性变更 → 升 major；新增功能 → 升 minor；修复 / 文档 / 重构 / 维护 → 升 patch）。${tagHint}
+    const system = `根据本轮用户消息里的 commit message 和 git diff 推荐一个语义化版本 tag（破坏性变更 → 升 major；新增功能 → 升 minor；修复 / 文档 / 重构 / 维护 → 升 patch）。
 
 请用${lang}思考但严格输出**单行 JSON 对象**，不要 Markdown 代码块、不要任何解释文字、不要多余引号。格式：
-{"tag":"v1.2.3"}
-
-commit message：${commitMessage}
-
-git diff：
-${diff}`;
-    const raw = await callConfiguredAiText(prompt, cwd, language, ai);
+{"tag":"v1.2.3"}`;
+    const prompt = `${tagHint}\n\ncommit message：${commitMessage}\n\ngit diff：\n${diff}`;
+    const raw = await callConfiguredAiText({ system, prompt }, cwd, language, ai);
     const parsed = tryParseJson(raw);
     let suggested;
     if (parsed && typeof parsed.tag === "string") {
@@ -1212,15 +1221,18 @@ function buildFallbackPrompt(opts, priorError) {
     const submoduleLine = opts.submodule
         ? "- 如果 submodule 内部也有改动，先在对应 submodule 内 add/commit，再提交父仓库里的 submodule 指针"
         : "- 不进入 submodule 内部提交，只提交父仓库自身已纳入的改动";
-    return [
+    // 角色、约束、输出格式走系统提示；本次要做什么、为什么走到兜底走用户消息。
+    const system = [
         "你正在作为 Wand 的快捷提交兜底执行器运行。前置的内置快捷提交流程失败了，现在请直接用 CLI 工具完成同一件事。",
         "",
         "约束：",
         "- 只允许执行与 git 快捷提交直接相关的命令，例如 git status、git diff、git add、git commit、git tag、git push、git submodule status。",
         "- 不要修改源代码内容，不要运行测试，不要安装依赖，不要重构文件。",
         "- 如果没有可提交改动，明确说明并停止，不要创建空 commit。",
-        "- commit message 和自然语言输出使用 " + lang + "。",
-        "",
+        "- 完成后只输出一行 JSON：{\"ok\":true,\"message\":\"...\",\"tag\":\"...\"}。失败时输出一行 JSON：{\"ok\":false,\"error\":\"...\"}。",
+        `- commit message 和自然语言输出使用 ${lang}。`,
+    ].join("\n");
+    const prompt = [
         "任务：",
         "- 执行 git add -A 纳入当前改动。",
         messageLine,
@@ -1232,9 +1244,8 @@ function buildFallbackPrompt(opts, priorError) {
             : []),
         "",
         `内置流程失败原因：${priorError}`,
-        "",
-        "完成后只输出一行 JSON：{\"ok\":true,\"message\":\"...\",\"tag\":\"...\"}。失败时输出一行 JSON：{\"ok\":false,\"error\":\"...\"}。",
     ].join("\n");
+    return { system, prompt };
 }
 async function getHead(cwd) {
     try {
@@ -1265,7 +1276,7 @@ async function getLatestTagAtHead(cwd) {
 async function runQuickCommitFallbackCli(opts, priorError) {
     await assertGitWorkTreeAsync(opts.cwd);
     const beforeHead = await getHead(opts.cwd);
-    const prompt = buildFallbackPrompt(opts, priorError);
+    const request = buildFallbackPrompt(opts, priorError);
     const provider = defaultProvider(opts.provider);
     if (provider === "codex") {
         const args = ["exec", "--ephemeral", "--json", "--color", "never", "--skip-git-repo-check", "--dangerously-bypass-approvals-and-sandbox"];
@@ -1276,7 +1287,7 @@ async function runQuickCommitFallbackCli(opts, priorError) {
         if (reasoningEffort)
             args.push("-c", `model_reasoning_effort=${reasoningEffort}`);
         args.push("-");
-        await runCliText("codex", args, prompt, {
+        await runCliText("codex", args, contentWithSystemPrompt("codex", request), {
             cwd: opts.cwd,
             timeoutMs: QUICK_COMMIT_CLI_TIMEOUT_MS,
             inheritEnv: opts.inheritEnv,
@@ -1290,28 +1301,28 @@ async function runQuickCommitFallbackCli(opts, priorError) {
         const variant = thinkingEffortToOpenCodeVariant(opts.thinkingEffort ?? "off");
         if (variant)
             args.push("--variant", variant);
-        await runCliText("opencode", args, prompt, {
+        await runCliText("opencode", args, contentWithSystemPrompt("opencode", request), {
             cwd: opts.cwd,
             timeoutMs: QUICK_COMMIT_CLI_TIMEOUT_MS,
             inheritEnv: opts.inheritEnv,
         });
     }
     else if (provider === "grok") {
-        await runCliText("grok", buildGrokTextArgs(prompt, opts, true), "", {
+        await runCliText("grok", buildGrokTextArgs(request, opts, true), "", {
             cwd: opts.cwd,
             timeoutMs: QUICK_COMMIT_CLI_TIMEOUT_MS,
             inheritEnv: opts.inheritEnv,
         });
     }
     else if (provider === "qoder") {
-        await runCliText("qodercli", buildQoderTextArgs(prompt, opts, true), "", {
+        await runCliText("qodercli", buildQoderTextArgs(request, opts, true), "", {
             cwd: opts.cwd,
             timeoutMs: QUICK_COMMIT_CLI_TIMEOUT_MS,
             inheritEnv: opts.inheritEnv,
         });
     }
     else if (provider === "pi") {
-        await runCliText("pi", buildPiTextArgs(prompt, opts, true), "", {
+        await runCliText("pi", buildPiTextArgs(request, opts, true), "", {
             cwd: opts.cwd,
             timeoutMs: QUICK_COMMIT_CLI_TIMEOUT_MS,
             inheritEnv: opts.inheritEnv,
@@ -1334,7 +1345,8 @@ async function runQuickCommitFallbackCli(opts, priorError) {
         const claudeEffort = thinkingEffortToClaudeCliEffort(opts.thinkingEffort ?? "off");
         if (claudeEffort)
             args.push("--effort", claudeEffort);
-        await runCliText("claude", args, prompt, {
+        args.push(...systemPromptArgsFrom("claude", request.system));
+        await runCliText("claude", args, request.prompt, {
             cwd: opts.cwd,
             timeoutMs: QUICK_COMMIT_CLI_TIMEOUT_MS,
             inheritEnv: opts.inheritEnv,

package/dist/message-truncator.d.ts

@@ -17,14 +17,50 @@ export interface BlockWindowedMessages extends WindowedMessages {
     leadingBlockOffset: number;
     /** turn messageOffset 的完整块数（客户端据此判断该 turn 是否已全部加载）。 */
     leadingBlockTotal: number;
+    /**
+     * 被切掉的头部里「用户可感知」的块数：默认收起的工具 / 思考块不计入（它们在客户端
+     * 合并成一条折叠条，不该被当成一条更早消息）。客户端据此显示「还有 N 条」。
+     */
+    leadingVisibleCount: number;
 }
 /**
- * 块级窗口：取完整历史「最近 blockBudget 个内容块」并做 transport 截断。
- * 从最新 turn 往回累计块数，能整条放下就整条放，放不下的那条（最旧的入窗 turn）
- * 只取其尾部若干块，并通过 leadingBlockOffset 告知客户端「这条 turn 还有更早的块」。
- * 客户端先按块翻完这条 turn 的头部，再按 turn 往前翻更早的整条。
+ * 首次下发（首屏）的载荷上限：截断后的聊天 JSON 体积。整段历史在这个体积内就不做窗口化 ——
+ * 一条提示词 + 一段长回复的会话不该因为几十个默认收起的工具块就出现「更早消息」。
+ * 超出的会话才按下面的预算从尾部切：客户端先翻这条 turn 的头部块，再按 turn 往前翻。
  */
-export declare function blockWindowMessagesForTransport(all: ConversationTurn[] | undefined, cardDefaults: CardExpandDefaults, blockBudget?: number): BlockWindowedMessages;
+export declare const MESSAGE_FIRST_PAINT_BYTES: number;
+/** 每个块在客户端是否「默认收起」（思考块 + 默认收起的工具卡片，与传输截断同一口径）。 */
+export declare function collapsedBlockFlags(content: ContentBlock[], cardDefaults: CardExpandDefaults): boolean[];
+/**
+ * 一段内容在传输层的估算体积。`limit` 用来提前收尾：一旦确认超过它就不再往下算
+ * （预算判定只需要知道「超了」，不需要精确值）。
+ */
+export declare function contentTransportBytes(content: ContentBlock[], cardDefaults: CardExpandDefaults, limit?: number): number;
+/**
+ * 把块级窗口 / 翻页的起点吸附到「语义干净」的位置：
+ *
+ * 1. 起点落在默认收起的折叠段中间 → 回到该段起点（整段入窗）。半截工具段在客户端
+ *    会渲染成一个少了前几个调用的折叠条，用户看着就是「更早消息缺了一块」。
+ * 2. 起点是配对的 tool_result（它的 tool_use 被切在前面）→ 回到 tool_use，否则客户端
+ *    顶部会冒出一张「无头结果」卡。
+ * 3. 需要往回吃掉的体积超过 MAX_BLOCK_SNAP_BACK_BYTES（或本页范围内吃不下）时不再
+ *    往回吸附，改为跳到该段之后（整段都是默认收起的内容，跳过去不会藏掉可见内容）。
+ *
+ * 返回吸附后的起点；起点越界时回退到 0（整条 turn 入窗，保证窗口不为空）。
+ */
+export declare function alignedBlockStart(content: ContentBlock[], cardDefaults: CardExpandDefaults, rawStart: number, forwardLimit?: number): number;
+/** [0, end) 里用户可感知的块数（默认收起的工具 / 思考块不计入）。 */
+export declare function visibleBlockCount(content: ContentBlock[], cardDefaults: CardExpandDefaults, end: number): number;
+/**
+ * 块级窗口：默认取整段历史（只要它在预算内），超出的才从最新 turn 往回累计，
+ * 能整条放下就整条放，放不下的那条（最旧的入窗 turn）只取其尾部若干块，
+ * 并通过 leadingBlockOffset 告知客户端「这条 turn 还有更早的块」。
+ *
+ * 预算口径：`blockBudget` 数的是**用户可感知的条数**（默认收起的工具 / 思考块不计入），
+ * 另外叠加一层载荷上限 —— 否则一段长工具调用会把预算吃光，把用户自己的提示词挤出首屏，
+ * 一条提示词的会话也会莫名出现「更早消息」。
+ */
+export declare function blockWindowMessagesForTransport(all: ConversationTurn[] | undefined, cardDefaults: CardExpandDefaults, blockBudget?: number, byteBudget?: number): BlockWindowedMessages;
 /**
  * 块级翻页：取某条 turn 的 content[start, end) 这一段（已做 transport 截断）。
  * 客户端滚动到顶、且当前最旧 turn 仍有更早块时调用，end = 客户端当前 leadingBlockOffset。