@f5-sales-demo/xcsh 19.51.2

package/src/modes/components/welcome.ts

@@ -0,0 +1,270 @@
+import { type Component, padding, truncateToWidth, visibleWidth } from "@f5xc-salesdemos/pi-tui";
+import { APP_NAME, t } from "@f5xc-salesdemos/pi-utils";
+import { theme } from "../../modes/theme/theme";
+import { formatStatusIcon } from "../../services/xcsh-context-indicators";
+import type { ModelStatus, ServiceStatus, UnifiedPluginStatus } from "./welcome-checks";
+
+export interface UpdateStatus {
+	available: boolean;
+	latestVersion?: string;
+}
+
+export class WelcomeComponent implements Component {
+	constructor(
+		private readonly version: string,
+		private modelStatus: ModelStatus,
+		private services: ServiceStatus[] = [],
+		private updateStatus?: UpdateStatus,
+		private plugins: UnifiedPluginStatus[] = [],
+	) {}
+	invalidate(): void {}
+	setModelStatus(status: ModelStatus): void {
+		this.modelStatus = status;
+	}
+	setServices(services: ServiceStatus[]): void {
+		this.services = services;
+	}
+	setUpdateStatus(status: UpdateStatus | undefined): void {
+		this.updateStatus = status;
+	}
+	setPlugins(plugins: UnifiedPluginStatus[]): void {
+		this.plugins = plugins;
+	}
+
+	render(termWidth: number): string[] {
+		const minLeftCol = 48;
+		const minRightCol = 20;
+		const preferredLeftCol = 50;
+
+		// Content-driven right column width
+		const naturalRight = this.#measureStatusWidth() + 1; // +1 right padding
+		const idealRight = Math.max(naturalRight, minRightCol);
+		const idealBox = preferredLeftCol + idealRight + 3; // 3 border chars: │ + │ + │
+		const boxWidth = Math.min(idealBox, Math.max(0, termWidth - 2));
+		if (boxWidth < 4) return [];
+
+		const dualContentWidth = boxWidth - 3;
+		// When terminal is narrower than ideal, shrink left column toward minLeftCol first
+		const dualLeftCol =
+			dualContentWidth >= preferredLeftCol + idealRight
+				? preferredLeftCol
+				: Math.max(minLeftCol, dualContentWidth - idealRight);
+		const dualRightCol = Math.max(0, dualContentWidth - dualLeftCol);
+		// Only show dual column when both columns have enough room for their content
+		const showRightColumn = dualLeftCol >= minLeftCol && dualRightCol >= Math.max(minRightCol, naturalRight);
+		const leftCol = showRightColumn ? dualLeftCol : boxWidth - 2;
+		const rightCol = showRightColumn ? dualRightCol : 0;
+
+		// biome-ignore format: preserve ASCII art layout
+		const f5Logo = [
+			"                   ________",
+			"              (\u2592\u2592\u2592\u2592\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2592\u2592\u2592\u2592)",
+			"         (\u2592\u2592\u2592\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2592\u2592\u2592)",
+			"      (\u2592\u2592\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588)",
+			"    (\u2592\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2592\u2592\u2592\u2592\u2592\u2588\u2588\u2588\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2592)",
+			"   (\u2592\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2592\u2593\u2593\u2593\u2593\u2593\u2592\u2592\u2592\u2593\u2588\u2588\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2593\u2592)",
+			"  (\u2592\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2592\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2592)",
+			" (\u2592\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2592)",
+			"(\u2592\u2593\u2593\u2593\u2592\u2592\u2592\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2592\u2592\u2592\u2592\u2592\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2592)",
+			"|\u2592\u2593\u2593\u2593\u2593\u2593\u2593\u2592\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2592|",
+			"|\u2592\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2592|",
+			"(\u2592\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2592\u2592\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2592\u2592)",
+			" (\u2592\u2593\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2592\u2592\u2592\u2588\u2588\u2588\u2588\u2592\u2592)",
+			"  (\u2592\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2592\u2592)",
+			"   (\u2592\u2592\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2592\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2592\u2592\u2592)",
+			"    (\u2592\u2592\u2592\u2592\u2592\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2592\u2592\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2592\u2592\u2593\u2592)",
+			"      (\u2592\u2593\u2593\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2593\u2593\u2593\u2593\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2593\u2592)",
+			"         (\u2592\u2592\u2592\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2592\u2592\u2592)",
+			"              (\u2592\u2592\u2592\u2592\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2592\u2592\u2592\u2592)",
+		];
+
+		const logoColored = f5Logo.map(line => this.#f5ColorLine(line));
+		const logoMaxWidth = 46;
+		const logoBlockPad = Math.max(0, Math.floor((leftCol - logoMaxWidth) / 2));
+		const logoPadStr = padding(logoBlockPad);
+		const leftLines = [...logoColored.map(l => logoPadStr + l), ""];
+		const rightLines = this.#buildStatusLines(showRightColumn ? rightCol : leftCol);
+		if (!showRightColumn) {
+			leftLines.push(...rightLines);
+		}
+		const border = (s: string) => theme.fg("borderMuted", s);
+		const hChar = theme.boxRound.horizontal;
+		const h = border(hChar);
+		const v = border(theme.boxRound.vertical);
+		const tl = border(theme.boxRound.topLeft);
+		const tr = border(theme.boxRound.topRight);
+		const bl = border(theme.boxRound.bottomLeft);
+		const br = border(theme.boxRound.bottomRight);
+		const lines: string[] = [];
+		const title = ` ${APP_NAME} v${this.version} `;
+		const titlePrefixRaw = hChar.repeat(3);
+		const titleStyled = border(titlePrefixRaw) + theme.bold(theme.fg("text", title));
+		const titleVisLen = visibleWidth(titlePrefixRaw) + visibleWidth(title);
+		const titleSpace = boxWidth - 2;
+		if (titleVisLen >= titleSpace) {
+			lines.push(tl + truncateToWidth(titleStyled, titleSpace) + tr);
+		} else {
+			lines.push(tl + titleStyled + border(hChar.repeat(titleSpace - titleVisLen)) + tr);
+		}
+		const maxRows = showRightColumn ? Math.max(leftLines.length, rightLines.length) : leftLines.length;
+		for (let i = 0; i < maxRows; i++) {
+			const left = this.#fitToWidth(leftLines[i] ?? "", leftCol);
+			if (showRightColumn) {
+				const right = this.#fitToWidth(rightLines[i] ?? "", rightCol);
+				lines.push(v + left + v + right + v);
+			} else {
+				lines.push(v + left + v);
+			}
+		}
+		if (showRightColumn) {
+			lines.push(bl + h.repeat(leftCol) + border(theme.boxSharp.teeUp) + h.repeat(rightCol) + br);
+		} else {
+			lines.push(bl + h.repeat(leftCol) + br);
+		}
+		return lines;
+	}
+
+	#measureStatusWidth(): number {
+		const lines: string[] = [` ${t("welcome.modelProvider")}`, ...this.#renderModelStatus()];
+		const coreServices = this.services.filter(s => !s._isPlugin);
+		for (const svc of coreServices) {
+			lines.push(this.#renderServiceLine(svc));
+		}
+		if (this.plugins.length > 0) {
+			lines.push(` ${t("welcome.plugins")}`);
+			for (const p of this.plugins) {
+				lines.push(this.#renderUnifiedPluginLine(p));
+			}
+		}
+		if (this.#showUpdateSection()) {
+			lines.push(this.#renderUpdateLine());
+		}
+		return Math.max(...lines.map(l => visibleWidth(l)));
+	}
+
+	#renderUnifiedPluginLine(plugin: UnifiedPluginStatus): string {
+		if (plugin.state === "connected" || plugin.state === "installed") {
+			return ` ${formatStatusIcon("connected")} ${theme.fg("muted", plugin.name)}`;
+		}
+		if (plugin.state === "not_installed") {
+			return ` ${theme.fg("dim", "·")} ${theme.fg("dim", plugin.name)}`;
+		}
+		const hint = plugin.hint ?? "";
+		return ` ${formatStatusIcon("warning")} ${theme.fg("muted", plugin.name)}  ${theme.fg("dim", hint)}`;
+	}
+
+	#buildStatusLines(rightCol: number): string[] {
+		const lines: string[] = [];
+		const separatorWidth = Math.max(0, rightCol - 2);
+		const separator = ` ${theme.fg("muted", theme.boxRound.horizontal.repeat(separatorWidth))}`;
+		lines.push("");
+		lines.push(` ${theme.bold(theme.fg("contentAccent", t("welcome.modelProvider")))}`);
+		lines.push(...this.#renderModelStatus());
+		lines.push("");
+		const coreServices = this.services.filter(s => !s._isPlugin);
+		const hasContent = coreServices.length > 0 || this.plugins.length > 0 || this.#showUpdateSection();
+		if (hasContent) {
+			lines.push(separator);
+			for (const svc of coreServices) {
+				lines.push(this.#renderServiceLine(svc));
+			}
+			if (this.plugins.length > 0) {
+				lines.push("");
+				lines.push(` ${theme.fg("dim", t("welcome.plugins"))}`);
+				for (const p of this.plugins) {
+					lines.push(this.#renderUnifiedPluginLine(p));
+				}
+				const missing = this.plugins.filter(p => p.state === "not_installed");
+				if (missing.length > 0) {
+					lines.push(`   ${theme.fg("dim", t("welcome.pluginSetupHint"))}`);
+				}
+			}
+
+			if (this.#showUpdateSection()) {
+				lines.push(this.#renderUpdateLine());
+			}
+		}
+		lines.push("");
+		return lines;
+	}
+
+	#showUpdateSection(): boolean {
+		return this.updateStatus?.available === true;
+	}
+
+	#renderServiceLine(service: ServiceStatus): string {
+		if (service.state === "connected") {
+			return ` ${formatStatusIcon("connected")} ${theme.fg("muted", service.name)}`;
+		}
+		const hint = service.hint ?? "";
+		return ` ${formatStatusIcon("warning")} ${theme.fg("muted", service.name)}  ${theme.fg("dim", hint)}`;
+	}
+
+	#renderUpdateLine(): string {
+		const latest = this.updateStatus?.latestVersion;
+		const label = latest ? `v${latest}` : t("welcome.newVersion");
+		return ` ${theme.fg("warning", "↑")} ${theme.fg("muted", label)}  ${theme.fg("dim", t("welcome.updateHint"))}`;
+	}
+
+	#renderModelStatus(): string[] {
+		const { state, provider } = this.modelStatus;
+		const p = provider ?? "unknown";
+		switch (state) {
+			case "connected":
+				return [` ${formatStatusIcon("connected")} ${theme.fg("muted", p)}`];
+			case "auth_error":
+				return [
+					` ${formatStatusIcon("error")} ${theme.fg("muted", p)} ${theme.fg("error", t("welcome.connectionFailed"))}`,
+					`   ${theme.fg("dim", t("welcome.runLoginReconnect"))}`,
+				];
+			case "no_provider":
+				return [
+					` ${formatStatusIcon("error")} ${theme.fg("error", t("welcome.noModelProvider"))}`,
+					`   ${theme.fg("dim", t("welcome.runLoginConnect"))}`,
+				];
+		}
+	}
+
+	#f5ColorLine(line: string): string {
+		const red = "\x1b[38;5;160m";
+		const white = "\x1b[1;37m";
+		// Explicit dark-red bg for the ▒ halo so the stipple reads as a
+		// consistent mid-dark red regardless of terminal background; without
+		// this the terminal bg leaks through half of each cell and the
+		// drop-shadow effect washes out on light terminals.
+		const shadowBg = "\x1b[48;5;88m";
+		const reset = "\x1b[0m";
+		let result = "";
+		for (const char of line) {
+			if (char === "\u2593") result += `${red}\u2588${reset}`;
+			else if (char === "\u2588") result += `${white}\u2588${reset}`;
+			else if (char === "\u2592") result += `${red}${shadowBg}\u2592${reset}`;
+			else if ("()|_".includes(char)) result += `${red}${char}${reset}`;
+			else result += char;
+		}
+		return result;
+	}
+
+	#fitToWidth(str: string, width: number): string {
+		const visLen = visibleWidth(str);
+		if (visLen > width) {
+			const ellipsis = "\u2026";
+			const maxW = Math.max(0, width - visibleWidth(ellipsis));
+			let t = "";
+			let cw = 0;
+			let esc = false;
+			for (const ch of str) {
+				if (ch === "\x1b") esc = true;
+				if (esc) {
+					t += ch;
+					if (ch === "m") esc = false;
+				} else if (cw < maxW) {
+					t += ch;
+					cw++;
+				}
+			}
+			return `${t}${ellipsis}`;
+		}
+		return str + padding(width - visLen);
+	}
+}

package/src/modes/controllers/btw-controller.ts

@@ -0,0 +1,193 @@
+import type { AgentMessage } from "@f5xc-salesdemos/pi-agent-core";
+import { type AssistantMessage, type Context, streamSimple } from "@f5xc-salesdemos/pi-ai";
+import { prompt } from "@f5xc-salesdemos/pi-utils";
+import btwUserPrompt from "../../prompts/system/btw-user.md" with { type: "text" };
+import { toReasoningEffort } from "../../thinking";
+import { BtwPanelComponent } from "../components/btw-panel";
+import type { InteractiveModeContext } from "../types";
+
+interface BtwRequest {
+	component: BtwPanelComponent;
+	abortController: AbortController;
+	question: string;
+}
+
+export class BtwController {
+	#activeRequest: BtwRequest | undefined;
+	readonly #streamFn: typeof streamSimple;
+
+	constructor(
+		private readonly ctx: InteractiveModeContext,
+		options?: { streamFn?: typeof streamSimple },
+	) {
+		this.#streamFn = options?.streamFn ?? streamSimple;
+	}
+
+	hasActiveRequest(): boolean {
+		return this.#activeRequest !== undefined;
+	}
+
+	handleEscape(): boolean {
+		if (!this.#activeRequest) return false;
+		this.#closeActiveRequest({ abort: this.#activeRequest.abortController.signal.aborted === false });
+		return true;
+	}
+
+	dispose(): void {
+		this.#closeActiveRequest({ abort: true });
+	}
+
+	async start(question: string): Promise<void> {
+		const trimmedQuestion = question.trim();
+		if (!trimmedQuestion) {
+			this.ctx.showStatus("Usage: /btw <question>");
+			return;
+		}
+
+		const model = this.ctx.session.model;
+		if (!model) {
+			this.ctx.showError("No active model available for /btw.");
+			return;
+		}
+
+		this.#closeActiveRequest({ abort: true });
+
+		const request: BtwRequest = {
+			component: new BtwPanelComponent({ question: trimmedQuestion, tui: this.ctx.ui }),
+			abortController: new AbortController(),
+			question: trimmedQuestion,
+		};
+		this.ctx.btwContainer.clear();
+		this.ctx.btwContainer.addChild(request.component);
+		this.ctx.ui.requestRender();
+		this.#activeRequest = request;
+		void this.#runRequest(request, model);
+	}
+
+	async #runRequest(
+		request: BtwRequest,
+		model: NonNullable<InteractiveModeContext["session"]["model"]>,
+	): Promise<void> {
+		try {
+			const apiKey = await this.ctx.session.modelRegistry.getApiKey(model, this.ctx.session.sessionId);
+			if (!apiKey) {
+				throw new Error(`No API key for provider: ${model.provider}`);
+			}
+
+			const llmMessages = await this.ctx.session.convertMessagesToLlm(
+				[...this.#buildMessageSnapshot(), this.#buildQuestionMessage(request.question)],
+				request.abortController.signal,
+			);
+			const context: Context = {
+				systemPrompt: this.ctx.session.systemPrompt,
+				messages: llmMessages,
+			};
+			const options = this.ctx.session.prepareSimpleStreamOptions({
+				apiKey,
+				sessionId: this.ctx.session.sessionId,
+				reasoning: toReasoningEffort(this.ctx.session.thinkingLevel),
+				serviceTier: this.ctx.session.serviceTier,
+				signal: request.abortController.signal,
+				toolChoice: "none",
+			});
+			const stream = this.#streamFn(model, context, options);
+
+			for await (const event of stream) {
+				if (!this.#isActiveRequest(request)) {
+					return;
+				}
+				if (event.type === "text_delta") {
+					request.component.appendText(event.delta);
+					continue;
+				}
+				if (event.type === "done") {
+					const finalText = this.#assistantText(event.message);
+					if (finalText) {
+						request.component.setAnswer(finalText);
+					}
+					request.component.markComplete();
+					return;
+				}
+				if (event.type === "error") {
+					if (event.reason === "aborted" || request.abortController.signal.aborted) {
+						request.component.markAborted();
+					} else {
+						request.component.markError(
+							this.#assistantText(event.error) || event.error.errorMessage || "BTW request failed.",
+						);
+					}
+					return;
+				}
+			}
+		} catch (error) {
+			if (!this.#isActiveRequest(request)) {
+				return;
+			}
+			if (request.abortController.signal.aborted) {
+				request.component.markAborted();
+				return;
+			}
+			request.component.markError(error instanceof Error ? error.message : String(error));
+		}
+	}
+
+	#buildQuestionMessage(question: string): AgentMessage {
+		return {
+			role: "user",
+			content: [
+				{
+					type: "text",
+					text: prompt.render(btwUserPrompt, { question }),
+				},
+			],
+			attribution: "user",
+			timestamp: Date.now(),
+		};
+	}
+
+	#buildMessageSnapshot(): AgentMessage[] {
+		const messages = this.ctx.session.messages.slice();
+		if (!this.ctx.session.isStreaming || !this.ctx.streamingMessage) {
+			return messages;
+		}
+		const streamingText = this.ctx.extractAssistantText(this.ctx.streamingMessage);
+		const lastMessage = messages.at(-1);
+		if (!streamingText) {
+			return lastMessage?.role === "assistant" ? messages.slice(0, -1) : messages;
+		}
+		const normalizedStreamingMessage: AssistantMessage = {
+			...this.ctx.streamingMessage,
+			content: [{ type: "text", text: streamingText }],
+		};
+		if (lastMessage?.role === "assistant") {
+			return [...messages.slice(0, -1), normalizedStreamingMessage];
+		}
+		return [...messages, normalizedStreamingMessage];
+	}
+
+	#assistantText(message: AssistantMessage): string {
+		let text = "";
+		for (const content of message.content) {
+			if (content.type === "text") {
+				text += content.text;
+			}
+		}
+		return text.trim();
+	}
+
+	#closeActiveRequest(options: { abort: boolean }): void {
+		const request = this.#activeRequest;
+		if (!request) return;
+		this.#activeRequest = undefined;
+		if (options.abort) {
+			request.abortController.abort();
+		}
+		request.component.close();
+		this.ctx.btwContainer.clear();
+		this.ctx.ui.requestRender();
+	}
+
+	#isActiveRequest(request: BtwRequest): boolean {
+		return this.#activeRequest === request;
+	}
+}

package/src/modes/controllers/chord-routing.ts

@@ -0,0 +1,37 @@
+import type { ChordResult } from "@f5xc-salesdemos/pi-tui";
+
+/**
+ * Sinks invoked by routeChordResult. Exactly one of these fires per call
+ * (or neither, for pending / abandoned — which are intentionally swallowed
+ * so the user's partial chord never leaks into the editor buffer).
+ */
+export interface ChordRouteSinks {
+	action: (actionId: string) => void;
+	editor: (key: string) => void;
+}
+
+/**
+ * Pure routing: given a ChordResult, dispatch to the right sink.
+ *
+ * - `dispatched` → action sink (keybinding matched a complete chord)
+ * - `passthrough` → editor sink (key is not a chord leader or match)
+ * - `pending` / `abandoned` → swallowed (Emacs convention: an abandoned
+ *   leader does not emit the second key into the buffer)
+ *
+ * Extracted so tests can exercise routing logic without constructing a
+ * full InputController.
+ */
+export function routeChordResult(result: ChordResult, key: string, sinks: ChordRouteSinks): void {
+	switch (result.kind) {
+		case "dispatched":
+			sinks.action(result.action);
+			return;
+		case "passthrough":
+			sinks.editor(key);
+			return;
+		case "pending":
+		case "abandoned":
+			// Swallowed — Emacs convention for abandoned leaders.
+			return;
+	}
+}