/** * interrupt-marker 的纯逻辑:消息形状判定、「用户中断」标记的文案决策、分支条目 → 消息的转换。 * 设计与取舍见 docs/superpowers/specs/2026-10-30-interrupt-marker-design.md。 * * 不 import 任何 pi 模块:输入就是 pi 会话里真实的消息 / 条目形状,所以单测不需要解析 pi 包。 */ /** 标记消息的 customType(index.ts 的渲染器也按它注册)。 */ export const MARKER_TYPE = "user-interrupt"; /** 与 Claude Code 逐字一致:流式输出中被中止。 */ export const MARKER_TEXT = "[Request interrupted by user]"; /** 与 Claude Code 逐字一致:工具执行中被中止。 */ export const MARKER_TEXT_TOOL_USE = "[Request interrupted by user for tool use]"; /** 只约束本文件用到的字段;pi 的 AgentMessage 比这宽得多。 */ export type LooseMessage = { role: string; content?: unknown; stopReason?: string; customType?: string; [key: string]: unknown; }; /** 会话分支里的条目(`sessionManager.getBranch()` 的元素)。 */ export type LooseEntry = { type: string; [key: string]: unknown }; /** 非空白的 text 块。 */ function isNonBlankText(block: unknown): boolean { const b = block as { type?: unknown; text?: unknown } | null | undefined; return b?.type === "text" && typeof b.text === "string" && b.text.trim() !== ""; } /** * 「内容为空的失败 assistant」:`stopReason` 是 error / aborted,且 content 里既没有非空白的 text 块, * 也没有 toolCall 块。工具执行中被中止时,pi 会在 toolResult 之后再追加一条这样的消息(立即失败的 * 下一次请求留下的),它对模型没有任何信息量,判定尾部时要跳过。 */ function isEmptyFailedAssistant(message: LooseMessage): boolean { if (message.role !== "assistant") return false; if (message.stopReason !== "error" && message.stopReason !== "aborted") return false; const blocks = Array.isArray(message.content) ? message.content : []; return !blocks.some((b) => isNonBlankText(b) || (b as { type?: unknown } | null)?.type === "toolCall"); } /** 是不是本扩展写下的标记消息。 */ export function isMarker(message: LooseMessage): boolean { return message.role === "custom" && message.customType === MARKER_TYPE; } /** * 分支条目 → 消息:`message` 条目取其 message;`custom_message` 条目转成 role=custom 的消息 * (与请求期 `context` 事件里看到的形状一致);其余类型(model_change / thinking_level_change / * custom / compaction …)不是消息,一律跳过 —— 它们会夹在分支尾部,不能挡住判定。 */ export function entriesToMessages(entries: readonly LooseEntry[]): LooseMessage[] { const messages: LooseMessage[] = []; for (const entry of entries) { if (entry.type === "message") { messages.push(entry.message as LooseMessage); } else if (entry.type === "custom_message") { messages.push({ role: "custom", customType: entry.customType as string, content: entry.content, display: entry.display, }); } } return messages; } /** * 该写哪条标记:从尾部往前跳过「内容为空的失败 assistant」,看第一条剩下的 —— * 已经是标记 → `undefined`(不重复写);不是 toolResult(含空列表)→ 普通变体; * 是 toolResult 时,只有「工具阶段被打断」才用工具变体,两个条件缺一不可: * 1. 尾部连续的 toolResult 里至少一个没成功(isError); * 2. 被跳过的空 assistant 里没有 aborted 的。真正的工具中止,pi 会在 toolResult 之后再发一次立即失败的 * 请求,留下一条空的 **error** assistant;而工具已经跑完、用户是在模型回复阶段(常常是静默思考)按的 * ESC,留下的是空的 **aborted** assistant。后一种若也说成 "for tool use",模型会以为命令被打断了, * 可能把已经成功的、有副作用的命令再跑一遍。 */ export function decideMarkerText(messages: readonly LooseMessage[]): string | undefined { let i = messages.length - 1; let replyAborted = false; for (; i >= 0 && isEmptyFailedAssistant(messages[i]!); i--) { if (messages[i]!.stopReason === "aborted") replyAborted = true; } const tail = messages[i]; if (tail === undefined) return MARKER_TEXT; if (isMarker(tail)) return undefined; if (tail.role !== "toolResult" || replyAborted) return MARKER_TEXT; for (let j = i; j >= 0 && messages[j]!.role === "toolResult"; j--) { if (messages[j]!.isError === true) return MARKER_TEXT_TOOL_USE; } return MARKER_TEXT; } /** 被中止的 assistant(下标 index)之后、下一条 assistant 之前,有没有标记。中间夹别的 custom 消息不影响。 */ function markerFollows(messages: readonly LooseMessage[], index: number): boolean { for (let j = index + 1; j < messages.length; j++) { if (messages[j]!.role === "assistant") return false; if (isMarker(messages[j]!)) return true; } return false; } /** * 半截输出复活(请求期,纯函数)。pi 的 `transformMessages` 会把 `stopReason` 为 aborted 的 assistant * 整条丢掉(有意设计,见 spec §2),模型于是看不到自己说到一半的话;这里把「后面跟着标记」的被中止 * assistant 临时改写成一条正常的短回复,让它和标记一起交给模型。 * * **标记在场是唯一开关**:半截输出绝不能在没有说明的情况下出现(会被当成一次完整的回答),所以 * 旧会话、从被中止条目分叉出来的分支(该分支上没有标记)都保持原样被丢弃。 * * 只保留非空白的 text 块:thinking 的签名对不上、半截 toolCall 的参数不完整,发给 provider 都会出错。 * 不修改入参;没有任何改动时返回 `undefined`,调用方可以直接放行。 */ export function reviveAbortedPartials(messages: readonly T[]): T[] | undefined { let revived: T[] | undefined; messages.forEach((message, i) => { if (message.role !== "assistant" || message.stopReason !== "aborted") return; if (!Array.isArray(message.content)) return; const texts = message.content.filter(isNonBlankText); if (texts.length === 0 || !markerFollows(messages, i)) return; const { errorMessage: _dropped, ...rest } = message; revived ??= [...messages]; revived[i] = { ...rest, content: texts, stopReason: "stop" } as unknown as T; }); return revived; } /** * 把「pad 个空格 + text」排成不超过 width 列的一行:放得下原样返回,放不下取前 width-1 个字符再加 `…`; * width <= 0 返回空串 —— 渲染器遇到极窄终端不能抛,也不能超宽。按字符数计宽(标记文案是纯 ASCII)。 */ export function fitLine(text: string, width: number, pad: number): string { if (width <= 0) return ""; const line = " ".repeat(Math.max(0, pad)) + text; return line.length <= width ? line : `${line.slice(0, width - 1)}…`; }