@vanillagreen/pi-qol 1.4.0 → 1.4.2

package/README.md

@@ -10,15 +10,15 @@ Quality-of-life extension for Pi: compact statusline, multiline input, session n
 ## Highlights
 
 - Compact statusline with repo, branch, model, thinking level, and context percent.
-- Shift+Enter inserts a newline. Ctrl+J fallback for terminals that can't distinguish it.
+- Newline-insert in the editor (multi-line drafts without auto-submit), with a fallback binding for terminals that can't distinguish the primary key.
 - Sessions auto-name from your first prompt. `/rename` overrides anytime.
-- `/search` browses previous sessions with snippet previews. F2 opens it instantly.
+- `/search` browses previous sessions with snippet previews; the configured shortcut opens it instantly.
 - `/context` shows a Claude-style context-window breakdown.
 - `/handoff <goal>` drafts a focused prompt for a new session.
 - Permission gate prompts before risky `bash` commands. Default match: `rm -Rf`.
 - Notifications for ready, questions, blocked states, and task completion.
 - Thinking timer next to collapsed `Thinking...` labels.
-- Caveman badge and Alt+C mode cycling when `pi-caveman` is loaded.
+- Caveman badge and a mode-cycling shortcut when `pi-caveman` is loaded.
 - Subagent-name badge in `pi-agents-tmux` child panes.
 
 ## Install
@@ -56,7 +56,7 @@ Arguments support autocomplete.
 
 ## Settings
 
-All settings live in the extension manager under **QOL**. Names below match the labels shown there.
+Open `/extensions:settings`; settings appear under the **QOL** tab. Names below match the labels shown there.
 
 ### Statusline
 
@@ -74,8 +74,8 @@ All settings live in the extension manager under **QOL**. Names below match the
 
 | Setting | What it does |
 | --- | --- |
-| Shift+Enter inserts newline | Insert a newline instead of submitting on Shift+Enter. |
-| Fallback newline key | Alternate newline key for terminals that can't send Shift+Enter. |
+| Newline-insert binding | Insert a newline instead of submitting. |
+| Fallback newline binding | Alternate binding for terminals that can't send the primary one. |
 | Style pending queue preview | Highlight Pi's pending-queue preview with a green left bar. |
 | Style image chips | Render `[Image #N]` placeholders as distinct chips. |
 | Show attachment count | Show a status badge when the draft has image placeholders. |
@@ -112,7 +112,7 @@ Advanced: input cap, title length, output tokens, timeout, custom prompt templat
 | Setting | What it does |
 | --- | --- |
 | Enable session search | Register `/search` and the overlay. |
-| Session search shortcut | Shortcut to open search. Default `f2`; set to `none` to disable. |
+| Session search shortcut | Configurable; set to `none` to disable. |
 | Result limit | Max matching prompts returned. |
 | Visible session rows | Rows shown before scrolling. |
 | Preview snippets | Matching snippets shown on the preview screen. |

package/extensions/qol/handoff.ts

@@ -6,6 +6,11 @@ import { serializeMessagesForSummary } from "./compaction.js";
 import { HANDOFF_SYSTEM_PROMPT } from "./constants.js";
 import { settingBoolean } from "./settings.js";
 
+function errorMessage(error: unknown): string {
+	const message = error instanceof Error ? error.message : String(error);
+	return message.length > 180 ? `${message.slice(0, 179)}…` : message;
+}
+
 export async function runHandoff(args: string, ctx: ExtensionCommandContext): Promise<void> {
 	if (!ctx.hasUI) {
 		ctx.ui.notify("handoff requires interactive mode", "error");
@@ -36,56 +41,58 @@ export async function runHandoff(args: string, ctx: ExtensionCommandContext): Pr
 
 	const releaseModalLock = acquireVstackModalLock();
 	let result: string | null = null;
+	let generationError: unknown;
 	try {
-	result = await ctx.ui.custom<string | null>((tui: any, theme: any, _kb: any, done: (value: string | null) => void) => {
-		const loader = new BorderedLoader(tui, theme, "Generating handoff prompt...");
-		loader.onAbort = () => done(null);
-
-		const doGenerate = async () => {
-			const auth = await ctx.modelRegistry.getApiKeyAndHeaders(ctx.model!);
-			if (!auth.ok || !auth.apiKey) {
-				throw new Error(auth.ok ? `No API key for ${ctx.model!.provider}` : auth.error);
-			}
-
-			const userMessage: Message = {
-				role: "user",
-				content: [
-					{
-						type: "text",
-						text: `## Conversation History\n\n${conversationText}\n\n## User's Goal for New Thread\n\n${goal}`,
-					},
-				],
-				timestamp: Date.now(),
+		result = await ctx.ui.custom<string | null>((tui: any, theme: any, _kb: any, done: (value: string | null) => void) => {
+			const loader = new BorderedLoader(tui, theme, "Generating handoff prompt...");
+			loader.onAbort = () => done(null);
+
+			const doGenerate = async () => {
+				const auth = await ctx.modelRegistry.getApiKeyAndHeaders(ctx.model!);
+				if (!auth.ok || !auth.apiKey) {
+					throw new Error(auth.ok ? `No API key for ${ctx.model!.provider}` : auth.error);
+				}
+
+				const userMessage: Message = {
+					role: "user",
+					content: [
+						{
+							type: "text",
+							text: `## Conversation History\n\n${conversationText}\n\n## User's Goal for New Thread\n\n${goal}`,
+						},
+					],
+					timestamp: Date.now(),
+				};
+
+				const response = await complete(
+					ctx.model!,
+					{ systemPrompt: HANDOFF_SYSTEM_PROMPT, messages: [userMessage] },
+					{ apiKey: auth.apiKey, headers: auth.headers, signal: loader.signal },
+				);
+
+				if (response.stopReason === "aborted") return null;
+				return response.content
+					.filter((content): content is { type: "text"; text: string } => content.type === "text")
+					.map((content) => content.text)
+					.join("\n");
 			};
 
-			const response = await complete(
-				ctx.model!,
-				{ systemPrompt: HANDOFF_SYSTEM_PROMPT, messages: [userMessage] },
-				{ apiKey: auth.apiKey, headers: auth.headers, signal: loader.signal },
-			);
-
-			if (response.stopReason === "aborted") return null;
-			return response.content
-				.filter((content): content is { type: "text"; text: string } => content.type === "text")
-				.map((content) => content.text)
-				.join("\n");
-		};
-
-		doGenerate()
-			.then(done)
-			.catch((error) => {
-				console.error("Handoff generation failed:", error);
-				done(null);
-			});
-
-		return loader;
-	});
+			doGenerate()
+				.then(done)
+				.catch((error) => {
+					generationError = error;
+					done(null);
+				});
+
+			return loader;
+		});
 	} finally {
 		releaseModalLock();
 	}
 
 	if (result === null) {
-		ctx.ui.notify("Cancelled", "info");
+		if (generationError) ctx.ui.notify(`Handoff generation failed: ${errorMessage(generationError)}`, "error");
+		else ctx.ui.notify("Cancelled", "info");
 		return;
 	}
 

package/extensions/qol/session-search/context.ts

@@ -146,7 +146,7 @@ export function renderSessionSearchContextMessage(message: any, options: any, th
 	const title = raw.match(/^## Session Search Context:\s*(.+)$/m)?.[1]?.trim() || "session";
 	const date = raw.match(/\*\*Date:\*\*\s*([^|\n]+)/)?.[1]?.trim() || "";
 	const header = `${theme.fg("customMessageLabel", theme.bold("Session context: "))}${theme.fg("accent", title)}${date ? theme.fg("muted", ` (${date})`) : ""}`;
-	if (!options?.expanded) return new Text(`${header}${theme.fg("dim", "  ctrl+o expand")}`, 0, 0);
+	if (!options?.expanded) return new Text(`${header}${theme.fg("dim", "  ctrl+o to expand")}`, 0, 0);
 	const body = raw.slice(raw.indexOf("\n") + 1).trim();
 	return new Text(body ? `${header}\n\n${body}` : header, 0, 0);
 }

package/extensions/qol/session-search/index.ts

@@ -34,7 +34,7 @@ function queueSessionSearchCommandAction(ctx: ExtensionContext, action: QolSessi
 	const id = nextSessionSearchPendingActionId();
 	qolSessionSearchPendingActions.set(id, action);
 	ctx.ui.setEditorText(`/search:resume-pending ${id}`);
-	ctx.ui.notify(`${sessionDisplayName(action.result!)} — press Enter to ${action.type === "fork" ? "fork" : "resume"}`, "info");
+	ctx.ui.notify(`${sessionDisplayName(action.result!)} — press enter to ${action.type === "fork" ? "fork" : "resume"}`, "info");
 }
 
 export async function runSessionSearchResumeOrFork(pi: ExtensionAPI, ctx: ExtensionContext, action: QolSessionPaletteAction): Promise<boolean> {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vanillagreen/pi-qol",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "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": [
@@ -136,8 +136,8 @@
         },
         {
           "key": "newlineOnShiftEnter",
-          "label": "Shift+Enter inserts newline",
-          "description": "Intercept distinguishable Shift+Enter/Shift+Return in the prompt editor and insert a newline instead of submitting.",
+          "label": "shift+enter inserts newline",
+          "description": "Intercept distinguishable shift+enter/shift+return in the prompt editor and insert a newline instead of submitting.",
           "type": "boolean",
           "default": true,
           "category": "Input",
@@ -147,7 +147,7 @@
         {
           "key": "newlineFallbackKey",
           "label": "Fallback newline key",
-          "description": "Alternate newline key for terminals that cannot distinguish Shift+Enter. Alt+Enter is reserved for Pi follow-up messages.",
+          "description": "Alternate newline key for terminals that cannot distinguish shift+enter. alt+enter is reserved for Pi follow-up messages.",
           "type": "enum",
           "enumValues": [
             "ctrl+j",
@@ -161,7 +161,7 @@
         {
           "key": "pendingQueue.asciiGreen",
           "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.",
+          "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",
@@ -350,7 +350,7 @@
         {
           "key": "sessionSearch.shortcutKey",
           "label": "Session search shortcut",
-          "description": "Keyboard shortcut to open the session search overlay. Default f2 avoids Pi's built-in Ctrl+F and Alt+F editor bindings. Set to none to disable.",
+          "description": "Keyboard shortcut to open the session search overlay. Default f2 avoids Pi's built-in ctrl+f and alt+f editor bindings. Set to none to disable.",
           "type": "string",
           "default": "f2",
           "category": "Session Search",