@herbertgao/pi-extensions 2026.8.13 → 2026.8.15

package/node_modules/@narumitw/pi-btw/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@narumitw/pi-btw",
-	"version": "0.55.4",
+	"version": "0.56.0",
 	"description": "Pi extension that adds a /btw side-question command.",
 	"type": "module",
 	"license": "MIT",
@@ -23,9 +23,6 @@
 			"./dist/index.ts"
 		]
 	},
-	"piExtension": {
-		"lifecycle": "stable"
-	},
 	"scripts": {
 		"build": "node scripts/build-runtime.mjs",
 		"check": "npm run build && biome check . && npm run typecheck",
@@ -34,10 +31,10 @@
 		"prepack": "npm run build"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "2.5.10",
-		"@earendil-works/pi-ai": "0.84.3",
-		"@earendil-works/pi-coding-agent": "0.84.3",
-		"@earendil-works/pi-tui": "0.84.3",
+		"@biomejs/biome": "2.5.11",
+		"@earendil-works/pi-ai": "0.84.4",
+		"@earendil-works/pi-coding-agent": "0.84.4",
+		"@earendil-works/pi-tui": "0.84.4",
 		"esbuild": "0.28.2",
 		"typescript": "7.0.2"
 	},

package/node_modules/@narumitw/pi-btw/src/btw.ts

@@ -33,6 +33,7 @@ import {
 } from "./menu.js";
 import {
 	type BtwSettings,
+	effectiveFullscreenCopyOnSelect,
 	effectiveRememberThinkingLevelChanges,
 	parseBtwModelReference,
 	readBtwSettings,
@@ -193,7 +194,7 @@ export async function loadBtwThinkingLevel(
 
 	options.warn?.(
 		sanitizeSingleLine(
-			`pi-btw settings ignored: ${settings.reason}; expected optional model "provider/model-id", omitted thinkingLevel for Same as main thread or thinkingLevel "${BTW_THINKING_LEVELS.join('" | "')}", and boolean rememberThinkingLevelChanges. Using current Pi thinking level.`,
+			`pi-btw settings ignored: ${settings.reason}; expected optional model "provider/model-id", omitted thinkingLevel for Same as main thread or thinkingLevel "${BTW_THINKING_LEVELS.join('" | "')}", boolean rememberThinkingLevelChanges, and boolean fullscreenCopyOnSelect. Using current Pi thinking level.`,
 		),
 	);
 	return currentThinkingLevel;
@@ -314,31 +315,35 @@ export default function btw(pi: ExtensionAPI, dependencies: BtwExtensionDependen
 			const startingTurnCount = state?.thread.turns.length ?? 0;
 
 			try {
-				await runFullscreen(ctx, (fullscreenCtx) => {
-					if (!state) {
-						const createdAt = Date.now();
-						state = {
-							id: `btw-${nextThreadNumber}`,
-							thread: createSideThread(
-								selectedConversationContext ??
-									buildConversationContext(fullscreenCtx.sessionManager.getBranch()),
-							),
-							thinkingLevel: settings.thinkingLevel ?? pi.getThinkingLevel(),
-							createdAt,
-							updatedAt: createdAt,
-						};
-						nextThreadNumber += 1;
-					}
-					return runThread({
-						initialQuestion: question || undefined,
-						selected: resolution.selected,
-						thinkingLevel: state.thinkingLevel,
-						rememberThinkingLevelChanges:
-							!sameAsMainThinkingLevel && effectiveRememberThinkingLevelChanges(settings),
-						state,
-						ctx: fullscreenCtx,
-					});
-				});
+				await runFullscreen(
+					ctx,
+					(fullscreenCtx) => {
+						if (!state) {
+							const createdAt = Date.now();
+							state = {
+								id: `btw-${nextThreadNumber}`,
+								thread: createSideThread(
+									selectedConversationContext ??
+										buildConversationContext(fullscreenCtx.sessionManager.getBranch()),
+								),
+								thinkingLevel: settings.thinkingLevel ?? pi.getThinkingLevel(),
+								createdAt,
+								updatedAt: createdAt,
+							};
+							nextThreadNumber += 1;
+						}
+						return runThread({
+							initialQuestion: question || undefined,
+							selected: resolution.selected,
+							thinkingLevel: state.thinkingLevel,
+							rememberThinkingLevelChanges:
+								!sameAsMainThinkingLevel && effectiveRememberThinkingLevelChanges(settings),
+							state,
+							ctx: fullscreenCtx,
+						});
+					},
+					{ copyOnSelect: effectiveFullscreenCopyOnSelect(settings) },
+				);
 			} finally {
 				if (state?.title && state.thread.turns.length > 0) {
 					if (state.thread.turns.length > startingTurnCount) {

package/node_modules/@narumitw/pi-btw/src/fullscreen-ui.ts

@@ -30,6 +30,7 @@ type BtwCustomFactory<T> = (
 type BtwFullscreenTui = TUI & {
 	flash?: (message: string, durationMs?: number) => void;
 	setLayoutRoot(component: Component | undefined): void;
+	addInputListenerBeforeAll?(listener: TuiInputListener): () => void;
 	addInputListenerBeforeViewport?(listener: TuiInputListener): () => void;
 };
 
@@ -37,17 +38,28 @@ export interface BtwFullscreenLayoutComponent extends Component {
 	getFullscreenLayout(): Component;
 }
 
-export type BtwFullscreenTuiFactory = (parent: TUI, theme: Theme) => BtwFullscreenTui;
+export interface BtwFullscreenOptions {
+	copyOnSelect?: boolean;
+}
+
+export type BtwFullscreenTuiFactory = (
+	parent: TUI,
+	theme: Theme,
+	keybindings: KeybindingsManager,
+	options: BtwFullscreenOptions,
+) => BtwFullscreenTui;
 
 export interface BtwFullscreenDependencies {
 	createTui?: BtwFullscreenTuiFactory;
 	openUrl?: (url: string) => void;
 	copyToClipboard?: (text: string) => Promise<void>;
+	manualSelectionCopySupported?: boolean;
 }
 
 export type RunBtwFullscreen = <T>(
 	ctx: ExtensionCommandContext,
 	run: (ctx: ExtensionCommandContext) => Promise<T>,
+	options?: BtwFullscreenOptions,
 ) => Promise<T>;
 
 type FullscreenOutcome<T> = { kind: "completed"; value: T } | { kind: "failed"; error: unknown };
@@ -62,14 +74,23 @@ class FullscreenUiDisposedError extends Error {
 export async function runBtwFullscreen<T>(
 	ctx: ExtensionCommandContext,
 	run: (ctx: ExtensionCommandContext) => Promise<T>,
+	options: BtwFullscreenOptions = {},
 	dependencies: BtwFullscreenDependencies = {},
 ): Promise<T> {
 	const createTui =
 		dependencies.createTui ??
-		((parent: TUI, theme: Theme) =>
+		((
+			parent: TUI,
+			theme: Theme,
+			keybindings: KeybindingsManager,
+			fullscreenOptions: BtwFullscreenOptions,
+		) =>
 			createBtwFullscreenTui(
 				parent,
 				theme,
+				keybindings,
+				fullscreenOptions.copyOnSelect ?? true,
+				dependencies.manualSelectionCopySupported ?? hasManualSelectionCopyApi(),
 				dependencies.openUrl ?? openUrlInBrowser,
 				dependencies.copyToClipboard ?? copyToHostClipboard,
 			));
@@ -94,6 +115,7 @@ export async function runBtwFullscreen<T>(
 					done(value);
 				},
 				createTui,
+				options,
 			);
 			return host;
 		},
@@ -114,6 +136,7 @@ export async function runBtwFullscreen<T>(
 }
 
 type BtwInputListeners = {
+	beforeAll: Set<TuiInputListener>;
 	beforeViewport: Set<TuiInputListener>;
 	regular: Set<TuiInputListener>;
 };
@@ -122,7 +145,7 @@ const btwInputListeners = new WeakMap<BtwTuiAltScreen, BtwInputListeners>();
 
 function dispatchBtwInput(listeners: BtwInputListeners, data: string): TuiInputListenerResult {
 	let current = data;
-	for (const group of [listeners.beforeViewport, listeners.regular]) {
+	for (const group of [listeners.beforeAll, listeners.beforeViewport, listeners.regular]) {
 		for (const listener of group) {
 			const result = listener(current);
 			if (result?.consume) return result;
@@ -133,10 +156,15 @@ function dispatchBtwInput(listeners: BtwInputListeners, data: string): TuiInputL
 }
 
 class BtwTuiAltScreen extends TuiAltScreen {
+	hasFocusedOverlay(): boolean {
+		return this.isOverlayFocused();
+	}
+
 	override addInputListener(listener: TuiInputListener): () => void {
 		let listeners = btwInputListeners.get(this);
 		if (!listeners) {
 			const registeredListeners: BtwInputListeners = {
+				beforeAll: new Set(),
 				beforeViewport: new Set(),
 				regular: new Set(),
 			};
@@ -148,6 +176,13 @@ class BtwTuiAltScreen extends TuiAltScreen {
 		return () => listeners.regular.delete(listener);
 	}
 
+	addInputListenerBeforeAll(listener: TuiInputListener): () => void {
+		const listeners = btwInputListeners.get(this);
+		if (!listeners) return super.addInputListener(listener);
+		listeners.beforeAll.add(listener);
+		return () => listeners.beforeAll.delete(listener);
+	}
+
 	addInputListenerBeforeViewport(listener: TuiInputListener): () => void {
 		const listeners = btwInputListeners.get(this);
 		if (!listeners) return super.addInputListener(listener);
@@ -161,33 +196,85 @@ class BtwTuiAltScreen extends TuiAltScreen {
 			super.removeInputListener(listener);
 			return;
 		}
+		listeners.beforeAll.delete(listener);
 		listeners.beforeViewport.delete(listener);
 		listeners.regular.delete(listener);
 	}
 }
 
+const BRACKETED_PASTE_START = "\u001b[200~";
+const BRACKETED_PASTE_END = "\u001b[201~";
+
+function hasManualSelectionCopyApi(): boolean {
+	return (
+		typeof TuiAltScreen.prototype.hasActiveSelection === "function" &&
+		typeof TuiAltScreen.prototype.copyActiveSelectionToClipboard === "function"
+	);
+}
+
 function createBtwFullscreenTui(
 	parent: TUI,
 	theme: Theme,
+	keybindings: KeybindingsManager,
+	copyOnSelect: boolean,
+	manualSelectionCopySupported: boolean,
 	openUrl: (url: string) => void,
 	copyToClipboard: (text: string) => Promise<void>,
 ): BtwFullscreenTui {
+	if (!copyOnSelect && !manualSelectionCopySupported) {
+		throw new Error(
+			"Manual fullscreen selection copying is unavailable in this Pi version; update Pi or enable automatic selection copying.",
+		);
+	}
 	const styleSearchMatch = (text: string) =>
 		theme.bg("searchMatchBg", theme.fg("searchMatchText", text));
-	return new BtwTuiAltScreen(parent.terminal, parent.getShowHardwareCursor(), undefined, {
-		mouse: true,
-		searchMatchStyle: (text) => theme.underline(styleSearchMatch(text)),
-		searchCurrentMatchStyle: (text) => theme.bold(theme.inverse(styleSearchMatch(text))),
-		openUrl,
-		copySelection: async (text) => {
-			try {
-				await copyToClipboard(text);
-				return true;
-			} catch {
-				return false;
-			}
+	const fullscreen = new BtwTuiAltScreen(
+		parent.terminal,
+		parent.getShowHardwareCursor(),
+		undefined,
+		{
+			mouse: true,
+			copyOnSelect,
+			searchMatchStyle: (text) => theme.underline(styleSearchMatch(text)),
+			searchCurrentMatchStyle: (text) => theme.bold(theme.inverse(styleSearchMatch(text))),
+			openUrl,
+			copySelection: async (text) => {
+				try {
+					await copyToClipboard(text);
+					return true;
+				} catch {
+					return false;
+				}
+			},
 		},
-	});
+	);
+	if (!copyOnSelect) {
+		let isInBracketedPaste = false;
+		fullscreen.addInputListenerBeforeViewport((data) => {
+			const wasInBracketedPaste = isInBracketedPaste;
+			const startsBracketedPaste = data.includes(BRACKETED_PASTE_START);
+			if (startsBracketedPaste) isInBracketedPaste = true;
+			if (isInBracketedPaste && data.includes(BRACKETED_PASTE_END)) {
+				isInBracketedPaste = false;
+			}
+			if (
+				wasInBracketedPaste ||
+				startsBracketedPaste ||
+				fullscreen.hasFocusedOverlay() ||
+				isKeyRelease(data) ||
+				!keybindings.matches(data, "app.message.copy")
+			) {
+				return undefined;
+			}
+			if (!fullscreen.hasActiveSelection()) {
+				fullscreen.flash("No selection to copy");
+				return { consume: true };
+			}
+			void fullscreen.copyActiveSelectionToClipboard().catch(() => fullscreen.flash("Copy failed"));
+			return { consume: true };
+		});
+	}
+	return fullscreen;
 }
 
 // Pi does not export its browser opener, so mirror its shell-free launcher for this isolated TUI.
@@ -226,6 +313,7 @@ class BtwFullscreenHost<T> implements Component {
 		private readonly run: (ctx: ExtensionCommandContext) => Promise<T>,
 		private readonly done: (outcome: FullscreenOutcome<T>) => void,
 		private readonly createTui: BtwFullscreenTuiFactory,
+		private readonly options: BtwFullscreenOptions,
 	) {
 		queueMicrotask(() => void this.start());
 	}
@@ -255,11 +343,12 @@ class BtwFullscreenHost<T> implements Component {
 			this.parent.stop({ preserveScreen: true });
 			this.parentStopped = true;
 			if (this.disposed) throw new FullscreenUiDisposedError();
-			this.fullscreen = this.createTui(this.parent, this.theme);
+			this.fullscreen = this.createTui(this.parent, this.theme, this.keybindings, this.options);
 			this.fullscreenCreated = true;
 			this.fullscreen.start();
 			// Waiting for the custom promise would leave follow-up keys bound to the side TUI.
 			const addHardCancelListener =
+				this.fullscreen.addInputListenerBeforeAll?.bind(this.fullscreen) ??
 				this.fullscreen.addInputListenerBeforeViewport?.bind(this.fullscreen) ??
 				this.fullscreen.addInputListener.bind(this.fullscreen);
 			this.removeHardCancelListener = addHardCancelListener((data) => {

package/node_modules/@narumitw/pi-btw/src/menu.ts

@@ -9,6 +9,7 @@ import {
 	type BtwSettings,
 	type BtwSettingsPatch,
 	btwSettingsPath,
+	effectiveFullscreenCopyOnSelect,
 	effectiveRememberThinkingLevelChanges,
 	readBtwSettings,
 	type UpdateBtwSettingsOptions,
@@ -48,7 +49,13 @@ export type BtwCommandMenuResult =
 	| { kind: "resume"; threadId: string };
 
 type BtwMenuScreen = "main" | "resume" | "settings" | "invalid";
-type BtwMenuAction = "start" | "start-tree" | "resume" | "set-thinking" | "set-remember";
+type BtwMenuAction =
+	| "start"
+	| "start-tree"
+	| "resume"
+	| "set-thinking"
+	| "set-remember"
+	| "set-fullscreen-copy";
 const SAME_AS_MAIN_THREAD = "Same as main thread";
 type BtwCustomOptions = Parameters<ExtensionCommandContext["ui"]["custom"]>[1];
 
@@ -111,6 +118,7 @@ export async function showBtwCommandMenu(
 				title: "Pi BTW",
 				lines: [
 					`Thinking: ${displayThinkingSummary(state.settings)} · Remember changes: ${displayRememberSummary(state.settings)}`,
+					`Copy on select: ${effectiveFullscreenCopyOnSelect(state.settings) ? "On" : "Off"}`,
 				],
 				items: [
 					{
@@ -138,7 +146,7 @@ export async function showBtwCommandMenu(
 					{
 						id: "settings",
 						label: "Settings",
-						description: "Choose pi-btw thinking level and fixed-level shortcut memory",
+						description: "Choose thinking, shortcut memory, and selection copying",
 						to: state.kind === "invalid" ? "invalid" : "settings",
 					},
 				],
@@ -178,6 +186,15 @@ export async function showBtwCommandMenu(
 						values: ["On", "Off"],
 						action: "set-remember",
 					},
+					{
+						id: "fullscreenCopyOnSelect",
+						label: "Copy selection automatically",
+						description:
+							"Copy mouse selections immediately instead of with the configured copy key.",
+						currentValue: effectiveFullscreenCopyOnSelect(state.settings) ? "On" : "Off",
+						values: ["On", "Off"],
+						action: "set-fullscreen-copy",
+					},
 				],
 			}),
 			invalid: ({ state }) => ({
@@ -240,6 +257,21 @@ export async function showBtwCommandMenu(
 					return { kind: "rejected" };
 				}
 			},
+			"set-fullscreen-copy": async ({ value, signal }) => {
+				if (value !== "On" && value !== "Off") return { kind: "rejected" };
+				try {
+					await updateSettings(
+						{ fullscreenCopyOnSelect: value === "On" },
+						{ settingsPath, signal },
+					);
+					if (signal.aborted) return { kind: "rejected" };
+					notifySafely(ctx, `Copy selection automatically: ${value}.`, "info");
+					return { kind: "stay" };
+				} catch (error) {
+					if (!signal.aborted) notifySaveFailure(ctx, error);
+					return { kind: "rejected" };
+				}
+			},
 		},
 	});
 

package/node_modules/@narumitw/pi-btw/src/settings.ts

@@ -6,6 +6,7 @@ import { getAgentDir } from "@earendil-works/pi-coding-agent";
 import { BTW_THINKING_LEVELS, type BtwThinkingLevel } from "./side-thread.js";
 
 export const BTW_SETTINGS_FILE = "pi-btw.json";
+export const DEFAULT_FULLSCREEN_COPY_ON_SELECT = true;
 export const DEFAULT_REMEMBER_THINKING_LEVEL_CHANGES = true;
 const MAX_SETTINGS_BYTES = 64 * 1024;
 
@@ -13,6 +14,7 @@ export interface BtwSettings {
 	model?: string;
 	thinkingLevel?: BtwThinkingLevel;
 	rememberThinkingLevelChanges?: boolean;
+	fullscreenCopyOnSelect?: boolean;
 }
 
 export type BtwSettingsLoadResult =
@@ -23,6 +25,7 @@ export type BtwSettingsLoadResult =
 export interface BtwSettingsPatch {
 	thinkingLevel?: BtwThinkingLevel;
 	rememberThinkingLevelChanges?: boolean;
+	fullscreenCopyOnSelect?: boolean;
 }
 
 export interface UpdateBtwSettingsOptions {
@@ -58,6 +61,11 @@ export function normalizeBtwSettings(value: unknown): BtwSettings | undefined {
 		if (typeof remember !== "boolean") return undefined;
 		settings.rememberThinkingLevelChanges = remember;
 	}
+	if (Object.hasOwn(value, "fullscreenCopyOnSelect")) {
+		const copyOnSelect = Reflect.get(value, "fullscreenCopyOnSelect");
+		if (typeof copyOnSelect !== "boolean") return undefined;
+		settings.fullscreenCopyOnSelect = copyOnSelect;
+	}
 	return settings;
 }
 
@@ -70,6 +78,10 @@ export function parseBtwModelReference(
 	return { provider: reference.slice(0, separator), modelId: reference.slice(separator + 1) };
 }
 
+export function effectiveFullscreenCopyOnSelect(settings: BtwSettings): boolean {
+	return settings.fullscreenCopyOnSelect ?? DEFAULT_FULLSCREEN_COPY_ON_SELECT;
+}
+
 export function effectiveRememberThinkingLevelChanges(settings: BtwSettings): boolean {
 	return settings.rememberThinkingLevelChanges ?? DEFAULT_REMEMBER_THINKING_LEVEL_CHANGES;
 }
@@ -233,6 +245,10 @@ function applyBtwSettingsPatch(
 	if (Object.hasOwn(patch, "rememberThinkingLevelChanges")) {
 		updated.rememberThinkingLevelChanges = patch.rememberThinkingLevelChanges;
 	}
+	if (Object.hasOwn(patch, "fullscreenCopyOnSelect")) {
+		if (patch.fullscreenCopyOnSelect === undefined) delete updated.fullscreenCopyOnSelect;
+		else updated.fullscreenCopyOnSelect = patch.fullscreenCopyOnSelect;
+	}
 	return updated;
 }
 

package/node_modules/@tifan/pi-handoff/README.md

@@ -1,6 +1,6 @@
 # @tifan/pi-handoff
 
-Start a fresh pi session from a handoff document, and query past sessions for context, decisions, or code changes.
+Start a new pi session from a handoff document. The new session can use the `session_query` tool to look up decisions, files, and next steps from earlier sessions.
 
 ## Install
 
@@ -10,33 +10,56 @@ pi install npm:@tifan/pi-handoff
 
 ## Requirements
 
-Matt Pocock's [`handoff` skill](https://github.com/mattpocock/skills/blob/main/skills/productivity/handoff/SKILL.md) is required:
+Install Matt Pocock's `handoff` skill:
 
 ```bash
 npx skills add https://github.com/mattpocock/skills --global --skill handoff
 ```
 
-## How it works
-
-Submit a prompt containing a standalone `-handoff` marker to generate a handoff document from the current session and automatically start a clean session from it. The marker can appear anywhere in the prompt. The handoff is written under the OS temp directory.
-
-The new session name uses the current session name when available. Otherwise, it uses the next-session focus, sanitized to lowercase, hyphen-separated text under 60 characters.
-
-The handoff includes the previous session path when available, so the next agent can use `session_query` if the handoff omits a detail.
-
 ## Usage
 
+Add a standalone `-handoff` marker to a prompt:
+
 ```text
 fix the auth flow -handoff
 ```
 
-The standalone `-handoff` marker is consumed before the prompt reaches the agent. The text before and after it becomes the next-session focus. A prompt containing only `-handoff` continues the current work.
+The marker is consumed before the prompt reaches the agent.
+
+- Text around the marker becomes the next-session focus.
+- The focus is used in the handoff document.
+- A handoff document is written under the OS temp directory.
+- A new session starts automatically from the document.
+- When Pi runs inside Herdr, the handoff opens in a new focused tab. The current parent session stays available in its original tab.
+- The handoff session keeps the parent-session link and selected provider/model when available.
+- Outside Herdr, the current session is replaced.
+
+A prompt containing only `-handoff` continues the current work.
+
+## Session naming
+
+`pi-handoff` imports the shared naming code from `@tifan/pi-rename`. Installing pi-handoff installs this dependency automatically, but it does not enable pi-rename's commands.
+
+Handoff uses the same naming logic as `/rename`:
+
+- Uses the first user message and up to three latest user messages.
+- Reads the model from `$PI_CODING_AGENT_DIR/extensions/pi-rename.json`.
+- Uses `openai-codex/gpt-5.6-luna` when no config exists.
+- Produces lowercase, hyphen-separated names of up to 30 characters.
+- Falls back to the latest user message if the naming model is unavailable.
+- Uses `handoff-session` when no usable user text exists.
+
+Install `@tifan/pi-rename` separately only if you want its `/rename` and `/rename config` commands.
 
 ## `session_query`
 
-`session_query`: Answer a question about a previous pi session, given the full path to its `.jsonl` file and the question to ask. It uses the configured `openai-codex/gpt-5.6-luna` model, which must be available and authenticated.
+`session_query` answers questions about a previous pi session:
+
+- Reads the previous `.jsonl` session file.
+- Uses the `openai-codex/gpt-5.6-luna` model.
+- Requires that model to be available and authenticated.
 
-Pi provides session loading and compaction-aware context reconstruction, but not semantic questions about an arbitrary previous session. `session_query` supplies that model-powered query layer.
+Pi provides session loading and compaction-aware context reconstruction. `session_query` provides semantic answers about the previous session.
 
 ## Release notes
 

package/node_modules/@tifan/pi-handoff/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tifan/pi-handoff",
-  "version": "2.0.1",
+  "version": "2.2.0",
   "description": "Transfer pi session context to a new session and query past sessions.",
   "keywords": [
     "handoff",
@@ -29,7 +29,7 @@
     "provenance": true
   },
   "dependencies": {
-    "@tifan/pi-rename": "^0.5.0"
+    "@tifan/pi-rename": "^0.6.0"
   },
   "engines": {
     "node": ">=20"