/** * interrupt-marker 接线层(index.ts)的单测:用极简假 `pi` 收集它注册的处理器 / 渲染器, * 再直接调用。真 pi 的完整链路(RPC + 假 LLM)由 interrupt-marker.e2e.test.ts 覆盖。 * * node --test clients/pi/extensions/interrupt-marker/index.test.ts */ import assert from "node:assert/strict"; import test from "node:test"; import { MARKER_TEXT, MARKER_TEXT_TOOL_USE, MARKER_TYPE } from "./core.ts"; import interruptMarker from "./index.ts"; type Fn = (...args: any[]) => any; /** * 把 PI_INTERRUPT_MARKER 设为 markerEnv(undefined 则删除)后调用 interruptMarker(假 pi),调用结束恢复原值。 * 假 pi 只有 on / registerMessageRenderer / sendMessage 三个方法,各自把入参记进返回的容器。 */ function load(markerEnv?: string) { const saved = process.env.PI_INTERRUPT_MARKER; if (markerEnv === undefined) delete process.env.PI_INTERRUPT_MARKER; else process.env.PI_INTERRUPT_MARKER = markerEnv; const handlers = new Map(); const renderers = new Map(); const sent: Array<{ message: unknown; options: unknown }> = []; const pi = { on: (event: string, handler: Fn) => void handlers.set(event, handler), registerMessageRenderer: (type: string, renderer: Fn) => void renderers.set(type, renderer), sendMessage: (message: unknown, options: unknown) => void sent.push({ message, options }), }; try { interruptMarker(pi as never); } finally { if (saved === undefined) delete process.env.PI_INTERRUPT_MARKER; else process.env.PI_INTERRUPT_MARKER = saved; } return { handlers, renderers, sent }; } const text = (t: string) => ({ type: "text", text: t }); const entry = (message: unknown) => ({ type: "message", message }); const ctxOf = (entries: unknown[]) => ({ sessionManager: { getBranch: () => entries } }); const OLD = entry({ role: "user", content: "OLD" }); const ABORTED = entry({ role: "assistant", stopReason: "aborted", content: [text("step0 ")] }); const theme = { fg: (slot: string, s: string) => `<${slot}>${s}` }; const visible = (s: string) => s.replace(/<\/?dim>/g, ""); const SETTLED = (aborted: boolean) => ({ type: "agent_settled", aborted }); test("注册 agent_settled、context 和 user-interrupt 渲染器", () => { const { handlers, renderers } = load(); assert.deepEqual([...handlers.keys()].sort(), ["agent_settled", "context"]); assert.deepEqual([...renderers.keys()], [MARKER_TYPE]); }); test("PI_INTERRUPT_MARKER=off(不分大小写、容忍空白)→ 什么都不注册", () => { for (const v of ["off", "OFF", " Off "]) { const { handlers, renderers } = load(v); assert.equal(handlers.size + renderers.size, 0, v); } }); test("agent_settled: 流式中止 → 写普通标记(display:true, triggerTurn:false)", () => { const { handlers, sent } = load(); handlers.get("agent_settled")!(SETTLED(true), ctxOf([OLD, ABORTED])); assert.deepEqual(sent, [{ message: { customType: MARKER_TYPE, content: MARKER_TEXT, display: true }, options: { triggerTurn: false } }]); }); test("agent_settled: 工具中止 → for tool use 文案", () => { const entries = [OLD, entry({ role: "assistant", stopReason: "toolUse", content: [{ type: "toolCall", id: "c1", name: "bash", arguments: {} }] }), entry({ role: "toolResult", toolCallId: "c1", toolName: "bash", isError: true, content: [text("Command aborted")] }), entry({ role: "assistant", stopReason: "error", content: [] })]; const { handlers, sent } = load(); handlers.get("agent_settled")!(SETTLED(true), ctxOf(entries)); assert.equal((sent[0]!.message as { content: string }).content, MARKER_TEXT_TOOL_USE); }); test("agent_settled: 不该写的两种情形(aborted=false、尾部已是标记)都不写", () => { const marked = { type: "custom_message", customType: MARKER_TYPE, content: MARKER_TEXT, display: true }; const { handlers, sent } = load(); handlers.get("agent_settled")!(SETTLED(false), ctxOf([OLD, ABORTED])); handlers.get("agent_settled")!(SETTLED(true), ctxOf([OLD, ABORTED, marked])); assert.equal(sent.length, 0); }); test("context: 标记在场 → 返回复活后的 messages;否则返回 undefined", () => { const { handlers } = load(); const aborted = { role: "assistant", stopReason: "aborted", content: [text("step0 ")] }; const marker = { role: "custom", customType: MARKER_TYPE, content: MARKER_TEXT, display: true }; const old = { role: "user", content: "OLD" }; assert.equal(handlers.get("context")!({ type: "context", messages: [old, aborted, marker] }).messages[1].stopReason, "stop"); assert.equal(handlers.get("context")!({ type: "context", messages: [old, aborted] }), undefined); }); test("渲染器: 一行 dim 文字,按 outputPad 缩进;content 是字符串或 text 片段数组都行", () => { const { renderers } = load(); const render = renderers.get(MARKER_TYPE)!; for (const content of [MARKER_TEXT, [text(MARKER_TEXT)]]) { const component = render({ role: "custom", customType: MARKER_TYPE, content, display: true }, { expanded: false, outputPad: 1 }, theme); assert.deepEqual(component.render(80), [` ${MARKER_TEXT}`]); assert.doesNotThrow(() => component.invalidate()); } }); test("渲染器: 窄屏截断加 …;宽度 0/1/2 不抛也不超宽", () => { const { renderers } = load(); const component = renderers.get(MARKER_TYPE)!({ content: MARKER_TEXT }, { expanded: false, outputPad: 1 }, theme); assert.equal(visible(component.render(10)[0]!), " [Request…"); for (const w of [0, 1, 2]) { const lines = component.render(w); assert.equal(lines.length, 1); assert.ok(visible(lines[0]!).length <= w, `width ${w}`); } });