pi-firecode 0.8.1 → 1.0.0

package/tools/line.ts

@@ -1,6 +1,6 @@
 /** 单条工具行的渲染：状态字形 + 标签 + 主体 + 右侧耗时/大小，展开时附完整结果。 */
 import { stripVTControlCharacters } from "node:util";
-import type { Theme } from "@earendil-works/pi-coding-agent";
+import type { Theme, ThemeColor } from "@earendil-works/pi-coding-agent";
 import { type Component, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
 import { type ClipSide, clip, oneLine } from "../format.js";
 import {
@@ -14,6 +14,11 @@ import {
 import { takeDuration } from "./timing.js";
 
 export const RAIL = "▏ ";
+/**
+ * 聊天行右侧留出的列：宿主全屏模式把滚动条画在最后一列，按列切掉它时会丢掉行尾的颜色复位，
+ * 所以行宽到倒数第二列为止，末尾再空一格与滚动条隔开。
+ */
+export const CHAT_GUTTER = 2;
 /** 右侧列与主体之间至少留出的空隙，不够就先丢弃右侧列 */
 const RIGHT_GAP = 2;
 const MIN_VALUE_WIDTH = 8;
@@ -24,7 +29,10 @@ const STATUS = {
 	run: { glyph: "●", color: "accent", bg: "toolPendingBg" },
 	ok: { glyph: "✓", color: "success", bg: "toolSuccessBg" },
 	err: { glyph: "✗", color: "error", bg: "toolErrorBg" },
-} as const;
+} as const satisfies Record<string, Status>;
+
+type Status = { glyph: string; color: ThemeColor; bg?: ThemeBg };
+type ThemeBg = Parameters<Theme["bg"]>[0];
 
 /** renderCall / renderResult 之间共享的行状态。 */
 export type RowState = {
@@ -71,12 +79,12 @@ function sanitizeDisplayText(text: string): string {
 	return output;
 }
 
-function resultText(result: ToolResult): { displayText: string; chars: number } {
+export function resultText(result: ToolResult, includeText: boolean): { displayText: string; chars: number } {
 	const blocks: string[] = [];
 	let chars = 0;
 	for (const item of result.content ?? []) {
 		if (item.type !== "text" || typeof item.text !== "string") continue;
-		blocks.push(sanitizeDisplayText(item.text));
+		if (includeText) blocks.push(sanitizeDisplayText(item.text));
 		chars += item.text.length;
 	}
 	return { displayText: blocks.join("\n"), chars };
@@ -110,67 +118,96 @@ export function paintBgLine(line: string, width: number, bgFn?: (text: string) =
 	return bgFn ? bgFn(padded) : padded;
 }
 
-export class ToolLine implements Component {
-	constructor(private readonly options: ToolLineOptions) {}
+/** 折叠摘要从工具行取当前动作词；未提供该能力的静态工具由通用参数摘要承担。 */
+export interface ActionLine extends Component {
+	readonly actionWord: string;
+	/** 当前动作的简短目标（纯文本），摘要行跟在动作词后面。 */
+	readonly actionTarget?: string;
+}
 
+export class ToolLine implements ActionLine {
+	constructor(private readonly options: ToolLineOptions) {}
 	invalidate(): void {}
 
+	get actionWord(): string {
+		return this.options.label;
+	}
+
+	get actionTarget(): string {
+		return this.options.value.map((part) => part.text).join("").trim();
+	}
+
 	render(width: number): string[] {
 		const { theme, ctx } = this.options;
 		const state = ctx.state;
 		const status = ctx.isError ? STATUS.err : ctx.isPartial ? STATUS.run : STATUS.ok;
-		const safeWidth = Math.max(1, width - 2);
-		const head: Part[] = [
-			{ text: RAIL, color: "dim" },
-			{ text: `${status.glyph} `, color: status.color, bold: true },
-			{
-				text: `${this.options.label} `,
-				color: ctx.isError ? "error" : "toolTitle",
-				bold: true,
-			},
-		];
-		const headWidth = partsWidth(head);
-		const bgFn = typeof theme.bg === "function" ? (text: string) => theme.bg(status.bg, text) : undefined;
-		if (safeWidth <= headWidth) {
-			const clipped = paint(theme, clipParts(head, safeWidth, "end"));
-			return [paintBgLine(clipped, width, bgFn)];
-		}
-
-		const meta = [...(this.options.meta ?? []), ...(state.meta ?? [])];
-		const right = [durationPart(state.durationMs), sizePart(state.chars)].filter(
-			(part): part is Part => !!part,
-		);
-		while (
-			right.length &&
-			safeWidth - headWidth - rightContentWidth(right) - RIGHT_GAP < MIN_VALUE_WIDTH
-		)
-			right.pop();
-		const rightVisible = rightContentWidth(right);
-		const freeWidth = safeWidth - headWidth - (right.length ? rightVisible + RIGHT_GAP : 0);
-		const errorText = ctx.isError && !ctx.expanded ? oneLine(state.errorText ?? "") : "";
-		let value = [...this.options.value, ...meta];
-		if (ctx.isError) value = value.map((part) => ({ ...part, color: "error" as const }));
-
-		let errorPart: Part | undefined;
-		if (errorText) {
-			value = clipParts(value, Math.max(1, Math.floor(freeWidth * ERROR_VALUE_RATIO)), this.options.clip);
-			const errorWidth = freeWidth - partsWidth(value) - 3;
-			if (errorWidth >= 1)
-				errorPart = { text: ` · ${clip(errorText, errorWidth, "end")}`, color: "error" };
-		} else {
-			value = clipParts(value, freeWidth, this.options.clip);
-		}
-
-		const body = [...head, ...value, ...(errorPart ? [errorPart] : [])];
-		let line = paint(theme, body);
-		if (right.length) {
-			const pad = Math.max(RIGHT_GAP, safeWidth - partsWidth(body) - rightVisible);
-			line +=
-				" ".repeat(pad) +
-				right.map((part) => paint(theme, [part])).join(theme.fg("dim", " · "));
-		}
-		return [paintBgLine(line, width, bgFn)];
+		const value = this.valueWithMeta();
+		return renderLine(theme, width, {
+			status,
+			label: { text: this.options.label, color: ctx.isError ? "error" : "toolTitle", bold: true },
+			value: ctx.isError ? value.map((part) => ({ ...part, color: "error" as const })) : value,
+			clip: this.options.clip,
+			error: ctx.isError && !ctx.expanded ? oneLine(state.errorText ?? "") : "",
+			right: [durationPart(state.durationMs), sizePart(state.chars)].filter((part): part is Part => !!part),
+		});
+	}
+
+	private valueWithMeta(): Part[] {
+		const { value, meta, ctx } = this.options;
+		return [...value, ...(meta ?? []), ...(ctx.state.meta ?? [])];
+	}
+}
+
+/** 一行的布局：头与尾固定，值可裁，错误摘要与值分摊，右列空间不足时先整列丢弃。 */
+type LineSpec = {
+	status: Status;
+	label: Part;
+	value: Part[];
+	clip: ClipSide;
+	error?: string;
+	right: Part[];
+};
+
+function renderLine(theme: Theme, width: number, spec: LineSpec): string[] {
+	const { status } = spec;
+	const safeWidth = Math.max(1, width - CHAT_GUTTER);
+	const head: Part[] = [
+		{ text: RAIL, color: "dim" },
+		{ text: `${status.glyph} `, color: status.color, bold: true },
+		spec.label,
+		...(partsWidth(spec.value) ? [{ text: " " }] : []),
+	];
+	const fixedWidth = partsWidth(head);
+	const bg = status.bg;
+	const bgFn = bg ? (text: string) => theme.bg(bg, text) : undefined;
+	if (safeWidth <= fixedWidth) {
+		const clipped = paint(theme, clipParts(head, safeWidth, "end"));
+		return [paintBgLine(clipped, width, bgFn)];
+	}
+
+	const right = [...spec.right];
+	while (right.length && safeWidth - fixedWidth - rightContentWidth(right) - RIGHT_GAP < MIN_VALUE_WIDTH)
+		right.pop();
+	const rightVisible = rightContentWidth(right);
+	const freeWidth = safeWidth - fixedWidth - (right.length ? rightVisible + RIGHT_GAP : 0);
+	let value = spec.value;
+	let errorPart: Part | undefined;
+	if (spec.error) {
+		value = clipParts(value, Math.max(1, Math.floor(freeWidth * ERROR_VALUE_RATIO)), spec.clip);
+		const errorWidth = freeWidth - partsWidth(value) - 3;
+		if (errorWidth >= 1)
+			errorPart = { text: ` · ${clip(spec.error, errorWidth, "end")}`, color: "error" };
+	} else {
+		value = clipParts(value, freeWidth, spec.clip);
+	}
+
+	const body = [...head, ...value, ...(errorPart ? [errorPart] : [])];
+	let line = paint(theme, body);
+	if (right.length) {
+		const pad = Math.max(RIGHT_GAP, safeWidth - partsWidth(body) - rightVisible);
+		line += " ".repeat(pad) + right.map((part) => paint(theme, [part])).join(theme.fg("dim", " · "));
 	}
+	return [paintBgLine(line, width, bgFn)];
 }
 
 /** 折叠时只回写行状态；展开时输出完整结果。 */
@@ -182,7 +219,7 @@ export function makeResultRenderer(sized: boolean) {
 		context: RenderContext,
 	): Component => {
 		const state = context.state;
-		const { displayText, chars } = resultText(result);
+		const { displayText, chars } = resultText(result, options.expanded || context.isError);
 		if (sized) state.chars = chars;
 		const durationMs = takeDuration(context.toolCallId);
 		if (durationMs !== undefined) state.durationMs = durationMs;

package/tools/machine.ts

@@ -0,0 +1,78 @@
+/** 机器消息（指挥官事件、观察员发言、审查卡）的一行投影：卡片与折叠展开态共用，数据只来自信封正文。 */
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { type EnvelopeTag, parseEnvelopes } from "../deliver.js";
+import { clip, firstSentence } from "../format.js";
+import { CHAT_GUTTER } from "./line.js";
+
+export interface MachineEntry {
+	/** 一行标题：Master 事件与审查卡是信封正文第一行原样，观察员固定为“观察员”。 */
+	title: string;
+	/** 正文首句，没有则为空。 */
+	preview: string;
+	/** 画失败色：只认生产端声明的事实——Master 事件带“错误：”分节，审查卡的 details.tone 为 warning/error。 */
+	alarm: boolean;
+	/** Master 事件才有：标题第一个空格前的子代理名。 */
+	worker?: string;
+	/** Master 事件正文带独占一行的“错误：”分节：子代理失败。 */
+	failed?: boolean;
+	/** 落定类 Master 事件的子代理本次运行时长；有它即触发摘要行的到达高亮。 */
+	duration?: string;
+}
+
+/** 正文分节标记独占一行（如“回复：”“错误：”）；失败时预览取错误分节之后的正文，否则取首个分节之后的。 */
+const SECTION = /^[^\s：]{1,8}：$/u;
+const ERROR_SECTION = "错误：";
+const RUN_TIME = /^耗时：本次运行 (\S+)/mu;
+/** 审查卡生产端（review/card.ts）在 details.tone 里声明的失败色。 */
+const ALARM_TONES = new Set(["warning", "error"]);
+/** 审查卡正文里的发现标题（“## 发现 1：…”）与原因行（“原因：…”）。 */
+const FINDING = /^#{1,6}\s*(?:发现|Finding)\s*[^：:]*[：:]\s*(.+)$/mu;
+const REASON = /^(?:原因|Reason)[：:]\s*(.+)$/mu;
+/** 审查卡里不是结论的行：模型分节、模型清单、卡点、分隔线与用时脚注。 */
+const REVIEW_NOISE = /^(?:\*\*(?:模型|Model)[ ·].*\*\*|(?:模型|Models)[：:].*|(?:卡点|Blocker)[：:].*|---|(?:用时|Elapsed)[：:].*)$/u;
+
+/** review/state.ts 多审查者通过汇总的一行：“• 模型短名：结论”。 */
+const MODEL_BULLET = /^•\s*[^\s：:]+[：:]\s*/u;
+
+/** details 是承载信封的 CustomMessage 的 details（审查卡带 tone）；用户消息形态没有。 */
+export function machineEntries(text: string, details?: unknown): MachineEntry[] | undefined {
+	return parseEnvelopes(text)?.map(({ tag, body }) => entryOf(tag, body, details));
+}
+
+function entryOf(tag: EnvelopeTag, body: string, details: unknown): MachineEntry {
+	const [heading = "", ...rest] = body.split("\n");
+	if (tag === "firecode_watcher") return { title: "观察员", preview: firstSentence(rest.join("\n")), alarm: false };
+	if (tag === "firecode_review")
+		return { title: heading, preview: reviewPreview(rest), alarm: ALARM_TONES.has((details as { tone?: string } | undefined)?.tone ?? "") };
+	// 失败只看是否有独占一行的“错误：”，不论它是第几个分节；失败时预览从错误分节取。
+	// 预览只取分节里给人看的正文：没有分节的事件（通知、被中断）正文是写给模型的指令，↳ 只显示标题。
+	const errorAt = rest.findIndex((line) => line.trim() === ERROR_SECTION);
+	const failed = errorAt >= 0;
+	const marker = failed ? errorAt : rest.findIndex((line) => SECTION.test(line.trim()));
+	const content = marker < 0 ? "" : rest.slice(marker + 1).filter((line) => !RUN_TIME.test(line)).join("\n");
+	const duration = RUN_TIME.exec(body)?.[1];
+	return {
+		title: heading,
+		preview: firstSentence(content),
+		alarm: failed,
+		worker: heading.split(" ", 1)[0],
+		failed,
+		...(duration ? { duration } : {}),
+	};
+}
+
+/** 审查卡的预览是结论：首条发现标题，否则原因，否则第一句非模型名的正文（多审查者汇总行去掉“• 模型：”前缀）。 */
+function reviewPreview(lines: string[]): string {
+	const text = lines.join("\n");
+	const pick = FINDING.exec(text)?.[1] ?? REASON.exec(text)?.[1];
+	const body = lines.filter((line) => !REVIEW_NOISE.test(line.trim())).map((line) => line.replace(MODEL_BULLET, ""));
+	return firstSentence(pick ?? body.join("\n"));
+}
+
+/** “↳ 标题 · 时长 首句”；不铺背景，可直接用 clip 截断。宿主在聊天区右缘画滚动条，留一列给它，截断才由 clip 加省略号。 */
+export function machineLine(entry: MachineEntry, theme: Theme, width: number): string {
+	const head = `${theme.fg(entry.alarm ? "error" : "success", "↳")} ${theme.fg(entry.alarm ? "error" : "text", entry.title)}`;
+	const duration = entry.duration ? `${theme.fg("dim", " · ")}${theme.fg("muted", entry.duration)}` : "";
+	const preview = entry.preview ? ` ${theme.fg("muted", entry.preview)}` : "";
+	return clip(`${head}${duration}${preview}`, Math.max(1, width - CHAT_GUTTER));
+}

package/tools/parts.ts

@@ -26,8 +26,8 @@ export function paint(theme: Theme, parts: Part[]): string {
 	return parts
 		.map((part) => {
 			let text = part.bold ? theme.bold(part.text) : part.text;
-			if (part.color && typeof theme.fg === "function") text = theme.fg(part.color, text);
-			if (part.bg && typeof theme.bg === "function") text = theme.bg(part.bg, text);
+			if (part.color) text = theme.fg(part.color, text);
+			if (part.bg) text = theme.bg(part.bg, text);
 			return text;
 		})
 		.join("");

package/tools/round.ts

@@ -0,0 +1,95 @@
+/**
+ * 轮记录：一段会话进行中（一次人类输入到歇下，含等子代理）的事后事实——整段时长与终态。
+ * 歇下边沿写成官方 CustomEntry 持久化，自己不占行；过程组摘要行落定时读它，重载后依然有数。
+ */
+import type { CustomEntry, EntryRenderer } from "@earendil-works/pi-coding-agent";
+import type { Component } from "@earendil-works/pi-tui";
+import type { SettledRound } from "../busy.js";
+import { parseEnvelopes } from "../deliver.js";
+import { textOf } from "../format.js";
+
+export const ROUND_ENTRY = "firecode-round";
+/** 轮记录写进会话之后在进程内总线上发布（无 payload）：订阅方此刻读分支一定已含这条记录，不依赖歇下边沿的订阅顺序。 */
+export const ROUND_RECORDED_CHANNEL = "firecode:round-recorded";
+
+export interface Round extends SettledRound {
+	/** 歇下时刻（宿主记录的 entry 时间戳）。 */
+	at: number;
+}
+
+/** 零行标记组件：只把记录带进聊天树，供投影按能力识别。 */
+interface RoundMarker extends Component {
+	round: Round;
+}
+
+/** 零行标记：投影按 roundOf 识别。会话里的轮记录经宿主渲染成它，没有轮记录的会话（子代理）也可按运行边界直接造。 */
+export function roundMarker(round: Round): Component {
+	const marker: RoundMarker = { round, render: () => [], invalidate() {} };
+	return marker;
+}
+
+/** 本模块写的 entry 一定带 data；类型上的 data? 只是宿主给所有 CustomEntry 的通用形状。 */
+export const renderRound: EntryRenderer<SettledRound> = (entry: CustomEntry<SettledRound>) =>
+	roundMarker({ ...(entry.data as SettledRound), at: Date.parse(entry.timestamp) });
+
+/** 一轮里更早的非完成终态的短标记。 */
+const EARLIER_TEXT = { aborted: "中断过", error: "请求失败过" } as const;
+
+/**
+ * 一轮可能有多条记录（中断后又跑了一段，如 /fire-review 或命令触发的再次进行）。合成规则不丢信息：
+ * 耗时累加（用户关心这一轮总共花了多久），终态与落定时刻取最后一条（这一轮最终怎样），更早的中断/请求失败
+ * 以“中断过 N 次”追加；多段的均速没有请求墙钟无法合成，按“不出半截的数”不给。
+ */
+export interface TurnRecord {
+	round: Round;
+	earlier: string[];
+}
+
+export function combineRounds(rounds: readonly Round[]): TurnRecord | undefined {
+	const last = rounds.at(-1);
+	if (!last) return undefined;
+	const elapsed = rounds.reduce((total, round) => total + round.elapsed, 0);
+	const round: Round = rounds.length === 1 ? last : { elapsed, outcome: last.outcome, at: last.at };
+	const earlier = (["aborted", "error"] as const).flatMap((outcome) => {
+		const count = rounds.slice(0, -1).filter((round) => round.outcome === outcome).length;
+		return count ? [`${EARLIER_TEXT[outcome]} ${count} 次`] : [];
+	});
+	return { round, earlier };
+}
+
+/** 会话分支条目里本模块读到的部分（宿主 SessionEntry 的结构子集）。 */
+export type BranchEntry =
+	| { type: "custom"; customType: string; data?: unknown; timestamp: string }
+	| { type: "message"; message: { role: string; content?: unknown } }
+	| { type: string };
+
+const isHumanEntry = (entry: BranchEntry) => entry.type === "message" && "message" in entry
+	&& entry.message.role === "user" && !parseEnvelopes(textOf(entry.message.content));
+
+/** 会话条目若是轮记录，给出它（带落定时刻）；子代理全过程视图与 Master 的本次运行耗时都按它读子代理会话。 */
+export function roundFromEntry(entry: unknown): Round | undefined {
+	const record = entry as { type?: unknown; customType?: unknown; data?: unknown; timestamp?: unknown };
+	if (record?.type !== "custom" || record.customType !== ROUND_ENTRY || typeof record.timestamp !== "string") return undefined;
+	return { ...(record.data as SettledRound), at: Date.parse(record.timestamp) };
+}
+
+/**
+ * 当前分支最近一轮的落定事实：最近一条人类消息之后的全部轮记录，按 combineRounds 合成。
+ * 输入框上边框落定态读它，与摘要行是同一份记录、同一条合成规则。
+ */
+export function latestTurnRecord(branch: readonly BranchEntry[]): TurnRecord | undefined {
+	const rounds: Round[] = [];
+	for (let index = branch.length - 1; index >= 0; index--) {
+		const entry = branch[index];
+		if (isHumanEntry(entry)) break;
+		const round = roundFromEntry(entry);
+		if (round) rounds.unshift(round);
+	}
+	return combineRounds(rounds);
+}
+
+/** 宿主把 entry 包成 Container（Spacer + 渲染器组件）；按能力找标记，不依赖类身份。 */
+export function roundOf(component: Component): Round | undefined {
+	const children = (component as { children?: readonly Component[] }).children;
+	return children?.find((child): child is RoundMarker => "round" in child)?.round;
+}

package/tools/turn-clock.ts

@@ -0,0 +1,41 @@
+/**
+ * 轮次时钟：把 busy.ts 的会话进行中事实投影到各轮摘要行——哪一轮开着、机器消息是否刚到。
+ * 落定后的耗时与终态不在这里，来自聊天树里的轮记录（round.ts）。
+ */
+import { type BusyView, IDLE } from "../busy.js";
+
+/** 子代理结果到达后摘要行高亮多久。 */
+export const ARRIVAL_FLASH_MS = 2500;
+
+export class TurnClock {
+	private busy: BusyView = IDLE;
+	private lastKey?: object;
+	private readonly arrivals = new WeakMap<object, number>();
+
+	constructor(readonly now: () => number = Date.now) {}
+
+	sync(view: BusyView): void {
+		this.busy = view;
+	}
+
+	/** 指挥官自己的回合在跑；否则这一段只是在等子代理，摘要行没有当前动作可说。 */
+	get agentRunning(): boolean {
+		return this.busy.agentRunning;
+	}
+
+	/** 投影每次渲染声明当前最后一轮。 */
+	track(key: object): void {
+		this.lastKey = key;
+	}
+
+	/** 会话正在进行且这是最后一轮。 */
+	live(key: object): boolean {
+		return this.busy.busy && key === this.lastKey;
+	}
+
+	/** 机器消息距首次出现多久；只有运行中出现的才算“新到达”，恢复的历史永远是旧的。 */
+	arrivalAge(item: object): number {
+		if (!this.arrivals.has(item)) this.arrivals.set(item, this.busy.busy ? this.now() : -Infinity);
+		return this.now() - this.arrivals.get(item)!;
+	}
+}

package/tools/turn-summary.ts

@@ -0,0 +1,109 @@
+/**
+ * 一轮的摘要行：只承担运行状态、事后记录与异常提醒。运行中是火苗 + 当前动作（实时计时只在边框），落定后是 ✓ 整段耗时 · 均速，
+ * 中断/请求失败是 ✗ 加终态字样；这一轮有子代理失败追加“N 个子代理失败”，宿主的 ⚠ 提示原文也追加。
+ * 工具失败是模型的工作过程，不计数、不影响标记。纯渲染，不碰宿主组件。
+ */
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { type Component, type TuiMouseEvent, visibleWidth } from "@earendil-works/pi-tui";
+import { HEAT_COLORS, flame, mix, paint, settleMark } from "../flame.js";
+import { OUTCOME_TEXT, roundTexts } from "../busy.js";
+import { clip } from "../format.js";
+import { CHAT_GUTTER } from "./line.js";
+import type { Round } from "./round.js";
+import { ARRIVAL_FLASH_MS } from "./turn-clock.js";
+
+export interface SummaryView {
+	/** 折入段内的首条宿主提示原文（缓存、丢思考、压缩计费）。 */
+	notice?: string;
+	live: boolean;
+	/** 运行中的当前动作（动作词 + 简短目标）；落定后或指挥官只在等子代理时没有，只画火苗。 */
+	action?: { word: string; target?: string };
+	/** 子代理结果刚到达：短暂替换当前动作。 */
+	arrival?: { text: string; failed: boolean; age: number };
+	/** 这一轮里失败的子代理数（按名字去重）。 */
+	failures?: number;
+	/** 落定后的轮记录：这一轮各段合成的耗时与终态（见 round.ts 的 combineRounds）。 */
+	round?: Round;
+	/** 这一轮更早几段的非完成终态短标记，如“中断过 1 次”。 */
+	earlier?: string[];
+	sinceEnd?: number;
+	/** 单轮展开/收起；全局展开时为空，点击无效。 */
+	toggle?: () => void;
+}
+
+/** 提示原文被目标挤压时至少保留的列数。 */
+const NOTICE_MIN = 12;
+/** 目标少于这个宽度就不显示，只留动作词。 */
+const MIN_TARGET = 4;
+
+export class TurnSummary implements Component {
+	constructor(private readonly view: SummaryView, private readonly theme: Theme) {}
+	invalidate(): void {}
+
+	render(full: number): string[] {
+		const width = full - CHAT_GUTTER;
+		const { theme, view } = this;
+		const sep = theme.fg("dim", " · ");
+		const outcome = this.outcomeText();
+		const word = view.live ? this.actionText() : outcome;
+		const target = view.live && view.action?.target && !this.flashing() ? view.action.target : undefined;
+		const glyph = view.live
+			? flame(1, 0.05)
+			: settleMark(outcome ? "failed" : "done", view.sinceEnd ?? Infinity);
+		const head = word ? `${glyph} ${word}` : glyph;
+		const record = view.round === undefined ? [] : roundTexts(view.round).map((text) => theme.fg("muted", text));
+		// 失败数与更早的中断都是不能丢的固定标记，窄屏时与它们一起保留。
+		const failures = [
+			...(view.earlier ?? []).map((text) => theme.fg("warning", text)),
+			...(view.failures ? [theme.fg("error", `${view.failures} 个子代理失败`)] : []),
+		];
+		const join = (lead: string, parts: string[]) => `${lead}${parts.map((part, index) => (index === 0 && !word ? " " : sep) + part).join("")}`;
+		const noticeNeed = view.notice ? visibleWidth(sep) + 2 + Math.min(visibleWidth(view.notice), NOTICE_MIN) : 0;
+		// 窄屏先裁目标（给提示原文留出最小空间），再裁提示原文，仍放不下再丢记录，最后丢提示原文；动作词与失败数是固定标记。
+		for (const base of [[...record, ...failures], failures]) {
+			const targetRoom = width - visibleWidth(join(head, base)) - noticeNeed - 1;
+			const lead = target && targetRoom >= MIN_TARGET ? `${head} ${theme.fg("muted", clip(target, targetRoom))}` : head;
+			const used = visibleWidth(join(lead, base));
+			if (!view.notice && used <= width) return [join(lead, base)];
+			const noticeRoom = width - used - visibleWidth(sep) - 2;
+			if (view.notice && noticeRoom >= 4) return [join(lead, [...base, theme.fg("warning", `⚠ ${clip(view.notice, noticeRoom)}`)])];
+		}
+		const marked = join(head, failures);
+		return [visibleWidth(marked) <= width ? marked : clip(head, Math.max(1, width))];
+	}
+
+	private flashing(): boolean {
+		return !!this.view.arrival && this.view.arrival.age < ARRIVAL_FLASH_MS;
+	}
+
+	private outcomeText(): string {
+		const text = OUTCOME_TEXT[this.view.round?.outcome ?? "complete"];
+		return text && this.theme.fg("error", text);
+	}
+
+	private actionText(): string {
+		const { theme, view } = this;
+		const { arrival } = view;
+		if (arrival && arrival.age < ARRIVAL_FLASH_MS) {
+			const fade = Math.min(1, arrival.age / ARRIVAL_FLASH_MS);
+			const settled = arrival.failed ? HEAT_COLORS.fail : HEAT_COLORS.gold;
+			return paint(mix(HEAT_COLORS.white, settled, fade), theme.bold(arrival.text));
+		}
+		return view.action ? theme.fg("text", view.action.word) : "";
+	}
+
+	handleMouse(event: TuiMouseEvent) {
+		if (!this.view.toggle || event.type !== "click" || event.button !== "left") return undefined;
+		this.view.toggle();
+		return { handled: true };
+	}
+}
+
+/** 单行文本，截断不加背景相关的 reset。 */
+export class Line implements Component {
+	constructor(private readonly text: string) {}
+	invalidate(): void {}
+	render(width: number): string[] {
+		return [clip(this.text, Math.max(1, width - CHAT_GUTTER))];
+	}
+}

package/truncated-write.ts

@@ -0,0 +1,18 @@
+/**
+ * 拦截把 read 截断结果整体写回的 write：宿主 read 截断时在正文末尾追加“…Use offset=N to continue.]”，
+ * codemode 脚本把它原样写回会把文件清成半截（出过两次，测试文件被截断还被提交）。不属于任何可关的功能，每个会话都注册。
+ */
+import { isToolCallEventType, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+/** 与宿主 core/tools/read.ts 的截断提示同形。 */
+const READ_TRUNCATION = /\n\[(?:Showing lines \d+-\d+ of \d+[^\]\n]*|\d+ more lines in file)\. Use offset=\d+ to continue\.\]/;
+
+export function registerTruncatedWriteGuard(pi: ExtensionAPI): void {
+	pi.on("tool_call", (event) => {
+		if (!isToolCallEventType("write", event) || !READ_TRUNCATION.test(event.input.content)) return;
+		return {
+			block: true,
+			reason: "写入内容带 read 截断提示，说明拿的是截断后的半截文件：改文件用 edit，或分段读完整再写",
+		};
+	});
+}