/** * interrupt-marker:用户按 ESC 中止后,把「用户中断」写进模型上下文(对齐 Claude Code 的 * `[Request interrupted by user]`)。 * * 为什么需要:pi 在下一轮请求里整条丢弃被中止的 assistant(有意设计),也不写任何中断提示, * 模型只见 [老 prompt][新指令],于是接着干老活。完整设计与实测见 * docs/superpowers/specs/2026-10-30-interrupt-marker-design.md。 * * 三件事: * 1. `agent_settled` 且 aborted → 落盘一条可见的 custom_message(标记); * 2. `context`:标记在场时,请求期把被中止 assistant 的半截文本复活(存储里的消息不动); * 3. 渲染器:标记画成一行 dim 文字(不注册的话是 customMessageBg 灰底方框 + `[user-interrupt]` 标签)。 * * 为什么挂 `agent_settled`:被中止的运行会跳过 `agent_before_settle`;而 `agent_settled` 处理期间提交的 * prompt 会被 pi 延后到全部处理器跑完,所以前面有慢的 settled 处理器也不会让标记 * 晚于新 prompt。 * * 开关:PI_INTERRUPT_MARKER=off(加载期读取)。 */ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent"; import { decideMarkerText, entriesToMessages, fitLine, MARKER_TYPE, reviveAbortedPartials } from "./core.ts"; import type { LooseEntry, LooseMessage } from "./core.ts"; /** 渲染器要的文字:content 是字符串,或 text 片段数组。 */ function textOf(content: unknown): string { if (typeof content === "string") return content; if (!Array.isArray(content)) return ""; return content .filter((part: { type?: unknown }) => part?.type === "text") .map((part: { text?: unknown }) => String(part.text ?? "")) .join(""); } export default function interruptMarker(pi: ExtensionAPI): void { if ((process.env.PI_INTERRUPT_MARKER ?? "").trim().toLowerCase() === "off") return; pi.on("agent_settled", (event, ctx) => { if (!event.aborted) return; const text = decideMarkerText(entriesToMessages(ctx.sessionManager.getBranch() as unknown as LooseEntry[])); if (text === undefined) return; pi.sendMessage({ customType: MARKER_TYPE, content: text, display: true }, { triggerTurn: false }); }); pi.on("context", (event) => { const messages = reviveAbortedPartials(event.messages as unknown as LooseMessage[]); return messages ? { messages: messages as unknown as typeof event.messages } : undefined; }); pi.registerMessageRenderer(MARKER_TYPE, (message, options, theme) => ({ render: (width: number) => [theme.fg("dim", fitLine(textOf(message.content), width, options.outputPad))], invalidate() {}, })); }