@vanillagreen/pi-qol 1.0.4 → 1.1.0

package/README.md

@@ -26,8 +26,8 @@ Restart Pi after installation.
 
 ## What it provides
 
-- Compact statusline and `π` prompt editor: shows repo/project, branch/dirty state, model, colorized thinking level, optional Caveman badge, context window size, and remaining context percent while replacing Pi's default footer/editor chrome.
-- Reliable multiline input: `Shift+Enter` / `Shift+Return` inserts a newline when the terminal reports it distinctly; `ctrl+j` is the default fallback newline key. `Alt+Enter` is reserved for Pi follow-up messages. When `pi-caveman` is loaded, `Alt+C` cycles Caveman modes.
+- Compact statusline and `π` prompt editor: shows repo/project, branch/dirty state, model, colorized thinking level, optional Caveman badge, context window size, remaining context percent, and (inside `pi-agents-tmux` child panes) an ANSI-background subagent-name badge while replacing Pi's default footer/editor chrome.
+- Reliable multiline input: `Shift+Enter` / `Shift+Return` inserts a newline when the terminal reports it distinctly; `ctrl+j` is the default fallback newline key. `Alt+Enter` is reserved for Pi follow-up messages. QOL can also style Pi's built-in steering/follow-up pending queue preview with an ANSI green left bar while leaving the restore hint muted. When `pi-caveman` is loaded, `Alt+C` cycles Caveman modes.
 - Compact image placeholders: existing pasted image paths can collapse to `[Image #N]` aliases and are attached on submit.
 - Session naming: `/rename [name]` sets or shows the friendly session name; automatic first-prompt naming is enabled by default.
 - Context usage: `/context` prints an inline Claude-style context-window visualization with estimated Pi/model category breakdowns.
@@ -66,6 +66,13 @@ Settings are exposed through `pi-extension-manager` under **QOL**.
 - `inputBottomPaddingLines`: blank lines below the compact prompt; default `0`.
 - Git display knobs: `gitRefreshTimeoutMs`, `showDirtyMarker`.
 - If `pi-caveman` is loaded, QOL reads its bridge to show a Caveman icon in the statusline and to make `Alt+C` cycle Caveman modes. The Caveman package's `showStatusBadge` setting also controls this QOL badge.
+- If `pi-agents-tmux` is loaded inside a child pane, QOL reads its bridge/env metadata to show a trailing subagent-name badge after the context percent. The badge uses the agent `color:` frontmatter (`red`, `green`, `yellow`, `blue`, `magenta`, `cyan`; aliases `orange`, `purple`/`violet`, `teal`) or falls back to automatic color cycling.
+
+### Input
+
+- `newlineOnShiftEnter`: intercept distinguishable `Shift+Enter` / `Shift+Return` and insert a newline; default on.
+- `newlineFallbackKey`: alternate newline key for terminals that cannot distinguish shifted enter; default `ctrl+j`, or `none` to disable.
+- `pendingQueue.asciiGreen`: style Pi's built-in steering/follow-up pending queue preview with an ANSI green heavy left bar while keeping the Alt+Up restore hint in the theme hint color with a two-space indent; default on.
 
 ### Session auto-rename
 

package/extensions/qol.ts

@@ -21,9 +21,26 @@ const QUESTION_SERVICE_SYMBOL = Symbol.for("vstack.pi-questions.service");
 const QOL_NOTIFICATION_SERVICE_SYMBOL = Symbol.for("vstack.pi-qol.notification-service");
 const VSTACK_MODAL_LOCK_SYMBOL = Symbol.for("vstack.pi.modal-lock");
 const CAVEMAN_BRIDGE_SYMBOL = Symbol.for("vstack.pi.caveman");
+const PI_AGENTS_STATUSLINE_SYMBOL = Symbol.for("vstack.pi-agents-tmux.statusline");
 const CAVEMAN_ICON_ACTIVE = "\uee9a";
 const CAVEMAN_ICON_INACTIVE = "\u{f19e0}";
 
+type AgentAsciiColor = "red" | "green" | "yellow" | "blue" | "magenta" | "cyan";
+
+interface PiAgentsStatuslineBridge {
+	getCurrentSubagent(cwd?: string): { name: string; color?: string } | undefined;
+}
+
+const AGENT_ASCII_COLOR_SEQUENCE: AgentAsciiColor[] = ["magenta", "green", "blue", "cyan", "yellow", "red"];
+const AGENT_ASCII_BG: Record<AgentAsciiColor, number> = {
+	red: 41,
+	green: 42,
+	yellow: 43,
+	blue: 44,
+	magenta: 45,
+	cyan: 46,
+};
+
 interface CavemanBridge {
 	isActive(): boolean;
 	getMode(): string;
@@ -41,6 +58,52 @@ function readCavemanBridge(): CavemanBridge | undefined {
 	const value = host[CAVEMAN_BRIDGE_SYMBOL];
 	return value && typeof value === "object" ? (value as CavemanBridge) : undefined;
 }
+
+function readPiAgentsStatuslineBridge(): PiAgentsStatuslineBridge | undefined {
+	const host = globalThis as unknown as Record<PropertyKey, unknown>;
+	const value = host[PI_AGENTS_STATUSLINE_SYMBOL];
+	return value && typeof value === "object" && typeof (value as PiAgentsStatuslineBridge).getCurrentSubagent === "function"
+		? (value as PiAgentsStatuslineBridge)
+		: undefined;
+}
+
+function normalizeAgentAsciiColor(value: string | undefined): AgentAsciiColor | undefined {
+	const normalized = value?.trim().toLowerCase().replace(/[^a-z]/g, "");
+	switch (normalized) {
+		case "red": return "red";
+		case "green": return "green";
+		case "yellow":
+		case "orange": return "yellow";
+		case "blue": return "blue";
+		case "magenta":
+		case "purple":
+		case "violet": return "magenta";
+		case "cyan":
+		case "teal": return "cyan";
+		default: return undefined;
+	}
+}
+
+function fallbackAgentAsciiColor(name: string): AgentAsciiColor {
+	let hash = 0;
+	for (const char of name) hash = ((hash * 31) + char.charCodeAt(0)) >>> 0;
+	return AGENT_ASCII_COLOR_SEQUENCE[hash % AGENT_ASCII_COLOR_SEQUENCE.length] ?? "magenta";
+}
+
+function ansiAgentBg(color: AgentAsciiColor, text: string): string {
+	return `\x1b[30;${AGENT_ASCII_BG[color]}m${text}\x1b[39;49m`;
+}
+
+function subagentStatuslineMarker(cwd: string, maxInnerWidth = 24): { plain: string; styled: string } | undefined {
+	const bridgeInfo = readPiAgentsStatuslineBridge()?.getCurrentSubagent(cwd);
+	const envName = process.env.PI_SUBAGENT_CHILD_AGENT?.trim();
+	const rawName = bridgeInfo?.name?.trim() || envName;
+	if (!rawName) return undefined;
+	const color = normalizeAgentAsciiColor(bridgeInfo?.color) ?? normalizeAgentAsciiColor(process.env.PI_SUBAGENT_CHILD_COLOR) ?? fallbackAgentAsciiColor(rawName);
+	const inner = truncateToWidth(rawName, Math.max(1, maxInnerWidth), "…");
+	const plain = ` ${inner} `;
+	return { plain, styled: ansiAgentBg(color, plain) };
+}
 const THINKING_TIMER_STORE_SYMBOL = Symbol.for("vstack.pi-qol.thinking-timer.store");
 const THINKING_TIMER_PATCH_SYMBOL = Symbol.for("vstack.pi-qol.thinking-timer.patch");
 const SESSION_SEARCH_PENDING_SYMBOL = Symbol.for("vstack.pi-qol.session-search.pending-context");
@@ -1257,25 +1320,29 @@ function cavemanIconTone(mode: string, active: boolean): "muted" | "text" | "suc
 
 function renderStatusLine(width: number, ctx: ExtensionContext, git: GitState, pi: ExtensionAPI, theme: Pick<Theme, "fg">): string {
 	const { label: contextLabel, percent } = statuslineContextInfo(ctx);
-	const projectChunk = `${git.projectName}${gitBadge(git, settingBoolean("showDirtyMarker", true, ctx.cwd))} ${formatModelName(ctx)} / `;
+	const projectChunk = `${git.projectName}${gitBadge(git, settingBoolean("showDirtyMarker", true, ctx.cwd))} ${formatModelName(ctx)}`;
+	const statusSeparator = " / ";
 	const thinkingLevel = normalizeThinkingLevel(pi.getThinkingLevel());
 	const thinkingChunk = thinkingLevel;
-	const contextChunk = ` (${contextLabel})`;
+	const contextChunk = ` ${contextLabel}`;
 	const cavemanBridge = readCavemanBridge();
 	const cavemanVisible = !!cavemanBridge && (cavemanBridge.isStatusBadgeEnabled?.(ctx.cwd) ?? true);
 	const caveman = cavemanVisible ? cavemanBridge : undefined;
 	const cavemanActive = caveman?.isActive() ?? false;
 	const cavemanGlyph = caveman ? (cavemanActive ? CAVEMAN_ICON_ACTIVE : CAVEMAN_ICON_INACTIVE) : "";
 	const cavemanTone = cavemanIconTone(caveman?.getMode() ?? "off", cavemanActive);
-	const cavemanSegment = caveman ? ` / ${cavemanGlyph}` : "";
-	const contextSeparator = caveman ? "  / " : "";
-	const leftPlain = `${projectChunk}${thinkingChunk}${cavemanSegment}${contextSeparator}${contextChunk.trimStart()}`;
-	const rightPlain = percent === null ? "…%" : `${percent}%`;
+	const cavemanSegment = caveman ? `${statusSeparator}${cavemanGlyph}` : "";
+	const contextSeparator = caveman ? ` ${statusSeparator}` : "";
+	const leftPlain = `${projectChunk}${statusSeparator}${thinkingChunk}${cavemanSegment}${contextSeparator}${contextChunk.trimStart()}`;
+	const percentPlain = percent === null ? "…%" : `${percent}%`;
+	const subagentMarker = subagentStatuslineMarker(ctx.cwd);
+	const rightPlain = subagentMarker ? `${percentPlain} ${subagentMarker.plain}` : percentPlain;
 	const percentColor = percent === null ? "muted" : percent <= 15 ? "error" : percent <= 30 ? "warning" : "success";
+	const separatorColored = theme.fg("muted", statusSeparator);
 	const leftColored = caveman
-		? `${theme.fg("accent", projectChunk)}${theme.fg(THINKING_TOKEN[thinkingLevel], thinkingChunk)}${theme.fg("accent", " / ")}${theme.fg(cavemanTone, cavemanGlyph)}${theme.fg("accent", `${contextSeparator}${contextChunk.trimStart()}`)}`
-		: `${theme.fg("accent", projectChunk)}${theme.fg(THINKING_TOKEN[thinkingLevel], thinkingChunk)}${theme.fg("accent", contextChunk)}`;
-	const right = theme.fg(percentColor, rightPlain);
+		? `${theme.fg("accent", projectChunk)}${separatorColored}${theme.fg(THINKING_TOKEN[thinkingLevel], thinkingChunk)}${separatorColored}${theme.fg(cavemanTone, cavemanGlyph)}${theme.fg("muted", contextSeparator)}${theme.fg("accent", contextChunk.trimStart())}`
+		: `${theme.fg("accent", projectChunk)}${separatorColored}${theme.fg(THINKING_TOKEN[thinkingLevel], thinkingChunk)}${theme.fg("accent", contextChunk)}`;
+	const right = subagentMarker ? `${theme.fg(percentColor, percentPlain)} ${subagentMarker.styled}` : theme.fg(percentColor, percentPlain);
 	const minimumGap = 1;
 	const gapWidth = Math.max(minimumGap, width - visibleWidth(leftPlain) - visibleWidth(rightPlain) - 2);
 	const filled = percent === null ? 0 : Math.round(gapWidth * (percent / 100));
@@ -2456,8 +2523,8 @@ function isPendingQueueHintText(text: string): boolean {
 	return plain.startsWith("↳ ") && plain.includes("queued messages");
 }
 
-function pendingQueueLine(text: string): string {
-	return ansiGreen(`| ${text}`);
+function pendingQueuePreviewLine(text: string): string {
+	return ansiGreen(`┃ ${text}`);
 }
 
 function isQueuedMessageStatusText(text: string): boolean {
@@ -2500,7 +2567,8 @@ function installPendingQueueThemePatch(ctx: ExtensionContext): void {
 	proto[PENDING_QUEUE_THEME_PATCH_SYMBOL] = patch;
 	proto.fg = function patchedQolFg(this: Theme, token: string, text: string): string {
 		if (token === "dim" && typeof text === "string" && settingBoolean("pendingQueue.asciiGreen", true, patch.cwd)) {
-			if (isPendingQueuePreviewText(text) || isPendingQueueHintText(text)) return pendingQueueLine(text);
+			if (isPendingQueuePreviewText(text)) return pendingQueuePreviewLine(text);
+			if (isPendingQueueHintText(text)) return (patch.originalFg as (this: Theme, token: string, text: string) => string).call(this, token, `  ${text}`);
 		}
 		return (patch.originalFg as (this: Theme, token: string, text: string) => string).call(this, token, text);
 	};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vanillagreen/pi-qol",
-  "version": "1.0.4",
+  "version": "1.1.0",
   "description": "Pi quality-of-life extension: compact statusline/π prompt, reliable multiline input, styled pasted-image chips, session naming/search/context import, handoff, permission prompts, notifications, custom compaction, and a collapsed-thinking timer.",
   "license": "MIT",
   "keywords": [
@@ -150,8 +150,8 @@
         },
         {
           "key": "pendingQueue.asciiGreen",
-          "label": "Green pending queue preview",
-          "description": "Render Pi's built-in steering/follow-up queue preview and Alt+Up hint in ANSI green with a left | queue bar instead of the dim hint color.",
+          "label": "Style pending queue preview",
+          "description": "Render Pi's built-in steering/follow-up queue preview in ANSI green with a heavy left queue bar, while keeping the Alt+Up restore hint in the theme hint color with a two-space indent.",
           "type": "boolean",
           "default": true,
           "category": "Input",