pi-copy-message 1.0.11 → 2.1.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 2.1.0 - 2026-08-17
+
+- Add an `Alt+C` picker filter and `MessageVisibility.showCustom` option for showing or hiding custom messages.
+- Hide picker shortcut hints that collide with configured selection bindings.
+
+## 2.0.0 - 2026-08-06
+
+- Set pi 0.84.0 as the minimum supported version and refresh the local coding-agent and TUI development baseline.
+- Honor configured `tui.select.pageUp` and `tui.select.pageDown` bindings, with Ctrl-modified page and jump controls that remain available in fullscreen mode.
+- Decode Kitty CSI-u printable input so type-to-filter search works in terminals using Kitty keyboard disambiguation.
+- Validate the package and its core copy flows with an isolated Pi 0.84.0 installation.
+
 ## 1.0.11 - 2026-07-16
 
 - Refresh the local Pi development lock and compatibility baseline to 0.80.9; the unified model runtime and additive Kimi/model-catalog changes do not affect the message-history picker.

package/README.md

@@ -11,7 +11,7 @@ A [pi](https://github.com/earendil-works/pi-mono) extension that adds `/copy-mes
 - Copies raw stored session message text, not rendered terminal lines
 - Shows messages in chat order: oldest at top, newest at bottom
 - Selects the newest visible message by default
-- Supports role filters for user, assistant, and tool/bash messages
+- Supports role filters for user, assistant, tool/bash, and custom messages
 - Hides tool/bash messages by default
 - Supports type-to-filter search across role and message text, with `time:<term>` for timestamp search
 - Supports Home/End jumps for oldest/newest visible messages
@@ -93,14 +93,17 @@ Copy with role and timestamp metadata instead of raw text only:
 |---|---|
 | Configured `tui.select.up` (default: `↑`) | Move to older visible message |
 | Configured `tui.select.down` (default: `↓`) | Move to newer visible message |
-| `Home` | Jump to oldest visible message |
-| `End` | Jump to newest visible message |
+| Configured `tui.select.pageUp` / `tui.select.pageDown` (default: `PageUp` / `PageDown`) | Move by one visible page in regular mode |
+| `Ctrl+PageUp` / `Ctrl+PageDown` | Move by one visible page in fullscreen mode |
+| `Home` / `End` | Jump to oldest/newest visible message in regular mode |
+| `Ctrl+Home` / `Ctrl+End` | Jump to oldest/newest visible message in fullscreen mode |
 | Type text | Filter visible messages |
 | `time:<term>` | Search timestamps |
 | `Backspace` | Delete one search character |
 | `Ctrl+U` | Toggle user messages |
 | `Ctrl+A` | Toggle assistant messages |
 | `Ctrl+T` | Toggle tool/bash messages |
+| `Alt+C` | Toggle custom messages |
 | `Tab` | Toggle a wrapped preview of the selected message |
 | `Alt+M` | Toggle raw vs metadata copy format |
 | Configured `tui.select.confirm` (default: `Enter`) | Copy selected message text |
@@ -114,16 +117,16 @@ Copy with role and timestamp metadata instead of raw text only:
 - General search does not match timestamps; use `time:<term>` when you want to search by displayed time.
 - Filter labels honor the active pi theme.
 - Selection key hints show the active Pi bindings. Configured selection actions take precedence if they collide with the picker's filter, preview, or format shortcuts.
-- Hidden custom messages are excluded in both current `custom_message` entries and legacy message-wrapped entries; only messages with `display: true` can appear or be copied.
+- Only custom messages with `display: true` can appear or be copied from current `custom_message` entries or legacy message-wrapped entries; visible ones can be toggled with `Alt+C`.
 - Copy notifications include the role and a short preview so you can verify what was copied.
-- `/copy-message latest` respects default visibility: user and assistant messages are visible, tool/bash messages are hidden. If only hidden messages exist, it falls back to the newest message so the command still does something useful.
+- `/copy-message latest` and numbered selectors include user, assistant, and visible custom messages by default while hiding tool/bash messages. `Alt+C` only affects the picker. If only hidden messages exist, `latest` falls back to the newest message so the command still does something useful.
 - `/copy-message` with no direct selector requires interactive TUI mode because the picker is a custom TUI component.
 - Direct commands such as `/copy-user`, `/copy-message latest`, and `/copy-message 3` do not require TUI mode, though non-UI modes may not display notifications.
 
 ## Compatibility
 
-- Tested with pi 0.80.9
-- Pi 0.80.7 includes `Ctrl+X` for copying the latest assistant response; this extension remains useful for searchable history, other roles, metadata, and direct selectors.
+- Requires and is tested with Pi 0.84.0 or later
+- Pi includes `Ctrl+X` for copying the latest assistant response; this extension remains useful for searchable history, other roles, metadata, and direct selectors.
 - Supported Node.js range for local repo tooling: `>=22.19.0`
 - `.nvmrc` pins Node 22.19.0 for local development
 
@@ -139,4 +142,4 @@ npm run check
 Key files:
 
 - `extensions/copy-message.ts` — publishable extension implementation
-- `tests/copy-message.test.ts` — regression tests for command wiring, filtering, search, jumps, and clipboard behavior
+- `tests/copy-message.test.ts` — regression tests for command wiring, filtering, search, navigation, and copy formatting

package/extensions/copy-message.ts

@@ -1,7 +1,7 @@
 import { spawnSync } from "node:child_process";
 import type { ExtensionAPI, ExtensionCommandContext, KeybindingsManager } from "@earendil-works/pi-coding-agent";
-import type { AutocompleteItem } from "@earendil-works/pi-tui";
-import { matchesKey, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
+import type { AutocompleteItem, TuiMode } from "@earendil-works/pi-tui";
+import { decodeKittyPrintable, matchesKey, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
 
 const MAX_VISIBLE_MESSAGES = 8;
 const MAX_PEEK_LINES = 16;
@@ -241,12 +241,14 @@ export interface MessageVisibility {
 	showAssistant: boolean;
 	showUser: boolean;
 	showTools: boolean;
+	showCustom: boolean;
 }
 
 function isVisibleMessage(message: CopyableMessage, visibility: MessageVisibility): boolean {
 	if (isToolMessage(message)) return visibility.showTools;
 	if (message.role === "assistant") return visibility.showAssistant;
 	if (message.role === "user") return visibility.showUser;
+	if (message.role === "custom") return visibility.showCustom;
 	return true;
 }
 
@@ -274,7 +276,7 @@ export function filteredMessages(messages: CopyableMessage[], visibility: Messag
 }
 
 export function defaultVisibleMessages(messages: CopyableMessage[]): CopyableMessage[] {
-	return filteredMessages(messages, { showAssistant: true, showUser: true, showTools: false });
+	return filteredMessages(messages, { showAssistant: true, showUser: true, showTools: false, showCustom: true });
 }
 
 export function latestDefaultMessage(messages: CopyableMessage[]): CopyableMessage | undefined {
@@ -370,7 +372,7 @@ function bindingHint(keybindings: PickerKeybindings | undefined, action: "up" |
 	return keys.reduce((shortest, key) => visibleWidth(key) < visibleWidth(shortest) ? key : shortest, keys[0] ?? "unbound");
 }
 
-function helpLines(width: number, keybindings?: PickerKeybindings): string[] {
+function helpLines(width: number, keybindings: PickerKeybindings | undefined, tuiMode: TuiMode, hasCustomMessages: boolean): string[] {
 	const up = bindingHint(keybindings, "up");
 	const down = bindingHint(keybindings, "down");
 	const confirm = bindingHint(keybindings, "confirm");
@@ -379,6 +381,8 @@ function helpLines(width: number, keybindings?: PickerKeybindings): string[] {
 		!keybindings ||
 		!(keybindings.matches(data, "tui.select.up") ||
 			keybindings.matches(data, "tui.select.down") ||
+			keybindings.matches(data, "tui.select.pageUp") ||
+			keybindings.matches(data, "tui.select.pageDown") ||
 			keybindings.matches(data, "tui.select.confirm") ||
 			keybindings.matches(data, "tui.select.cancel"));
 	const peek = available("\t") ? "Tab peek" : undefined;
@@ -388,11 +392,17 @@ function helpLines(width: number, keybindings?: PickerKeybindings): string[] {
 		{ hint: "T", data: "\x14" },
 	].filter(({ data }) => available(data));
 	const filterHint = filters.length > 0 ? `Ctrl+${filters.map(({ hint }) => hint).join("/")} filters` : undefined;
-	const meta = available("\x1bm") ? "Alt+M meta" : undefined;
-	const jumps = [
-		{ hint: "Home", data: "\x1b[H" },
-		{ hint: "End", data: "\x1b[F" },
-	].filter(({ data }) => available(data));
+	const custom = hasCustomMessages && available("\x1b[99;3u") ? "Alt+C custom" : undefined;
+	const meta = available("\x1b[109;3u") ? "Alt+M meta" : undefined;
+	const jumps = (tuiMode === "fullscreen"
+		? [
+				{ hint: "Ctrl+Home", data: "\x1b[1;5H" },
+				{ hint: "Ctrl+End", data: "\x1b[1;5F" },
+			]
+		: [
+				{ hint: "Home", data: "\x1b[H" },
+				{ hint: "End", data: "\x1b[F" },
+			]).filter(({ data }) => available(data));
 	const jumpHint = jumps.length > 0 ? `${jumps.map(({ hint }) => hint).join("/")} jump` : undefined;
 	const join = (...hints: Array<string | undefined>) => hints.filter(Boolean).join(" · ");
 	const core = width < 74 ? [`${up}/${down} nav`, `${confirm} copy`, `${cancel} cancel`] : [`${up} older`, `${down} newer`, `${confirm} copy`, `${cancel} cancel`];
@@ -408,7 +418,7 @@ function helpLines(width: number, keybindings?: PickerKeybindings): string[] {
 		return lines;
 	}
 
-	for (const hint of width < 74 ? [jumpHint, peek, filterHint, meta] : ["type search", jumpHint, peek, filterHint, meta]) {
+	for (const hint of width < 74 ? [jumpHint, peek, filterHint, custom, meta] : ["type search", jumpHint, peek, filterHint, custom, meta]) {
 		if (hint && visibleWidth(join(...optional, hint, ...core)) <= width) optional.push(hint);
 	}
 
@@ -422,6 +432,7 @@ export class CopyMessagePickerState {
 		showAssistant: true,
 		showUser: true,
 		showTools: false,
+		showCustom: true,
 	};
 	search = "";
 	visibleMessages: CopyableMessage[];
@@ -445,10 +456,11 @@ export class CopyMessagePickerState {
 		return selected ? formatMessageForCopy(selected, this.format) : undefined;
 	}
 
-	render(width: number, theme: CopyMessageTheme, keybindings?: PickerKeybindings): string[] {
+	render(width: number, theme: CopyMessageTheme, keybindings?: PickerKeybindings, tuiMode: TuiMode = "regular"): string[] {
 		const maxVisible = Math.min(this.visibleMessages.length, MAX_VISIBLE_MESSAGES);
 		const start = maxVisible === 0 ? 0 : Math.max(0, Math.min(this.selectedIndex - maxVisible + 1, this.visibleMessages.length - maxVisible));
 		const end = Math.min(this.visibleMessages.length, start + maxVisible);
+		const hasCustomMessages = this.messages.some((message) => message.role === "custom");
 		const userState = filterLabel(theme, "user", this.visibility.showUser, "warning");
 		const assistantState = filterLabel(theme, "assistant", this.visibility.showAssistant, "accent");
 		const toolState = filterLabel(theme, "tools", this.visibility.showTools, "dim");
@@ -474,9 +486,11 @@ export class CopyMessagePickerState {
 		}
 
 		const position = this.visibleMessages.length === 0 ? "0/0" : `${this.selectedIndex + 1}/${this.visibleMessages.length}`;
-		lines.push(`${theme.fg("dim", `(${position})`)} · ${userState} · ${assistantState} · ${toolState} · ${formatState} · ${searchState}`);
+		const filters = [userState, assistantState, toolState];
+		if (hasCustomMessages) filters.push(filterLabel(theme, "custom", this.visibility.showCustom, "dim"));
+		lines.push([theme.fg("dim", `(${position})`), ...filters, searchState, formatState].join(" · "));
 		lines.push("");
-		lines.push(...helpLines(width, keybindings).map((line) => hotkeyHint(theme, line)));
+		lines.push(...helpLines(width, keybindings, tuiMode, hasCustomMessages).map((line) => hotkeyHint(theme, line)));
 		lines.push("");
 		return lines.map((line) => truncateToWidth(line, width, ""));
 	}
@@ -490,6 +504,14 @@ export class CopyMessagePickerState {
 			this.move(1);
 			return "render";
 		}
+		if (keybindings?.matches(data, "tui.select.pageUp")) {
+			this.move(-MAX_VISIBLE_MESSAGES);
+			return "render";
+		}
+		if (keybindings?.matches(data, "tui.select.pageDown")) {
+			this.move(MAX_VISIBLE_MESSAGES);
+			return "render";
+		}
 		if (keybindings?.matches(data, "tui.select.confirm")) {
 			return this.visibleMessages.length > 0 ? "copy" : "none";
 		}
@@ -509,6 +531,11 @@ export class CopyMessagePickerState {
 			this.refreshMessages();
 			return "render";
 		}
+		if (matchesKey(data, "alt+c")) {
+			this.visibility.showCustom = !this.visibility.showCustom;
+			this.refreshMessages();
+			return "render";
+		}
 		if (matchesKey(data, "alt+m")) {
 			this.format = this.format === "raw" ? "metadata" : "raw";
 			return "render";
@@ -521,8 +548,9 @@ export class CopyMessagePickerState {
 			this.setSearch(this.search.slice(0, -1));
 			return "render";
 		}
-		if (isPrintableSearchInput(data)) {
-			this.setSearch(this.search + data);
+		const printable = decodeKittyPrintable(data) ?? data;
+		if (isPrintableSearchInput(printable)) {
+			this.setSearch(this.search + printable);
 			return "render";
 		}
 		if (!keybindings && matchesKey(data, "up")) {
@@ -533,6 +561,30 @@ export class CopyMessagePickerState {
 			this.move(1);
 			return "render";
 		}
+		if (!keybindings && matchesKey(data, "pageUp")) {
+			this.move(-MAX_VISIBLE_MESSAGES);
+			return "render";
+		}
+		if (!keybindings && matchesKey(data, "pageDown")) {
+			this.move(MAX_VISIBLE_MESSAGES);
+			return "render";
+		}
+		if (matchesKey(data, "ctrl+pageUp")) {
+			this.move(-MAX_VISIBLE_MESSAGES);
+			return "render";
+		}
+		if (matchesKey(data, "ctrl+pageDown")) {
+			this.move(MAX_VISIBLE_MESSAGES);
+			return "render";
+		}
+		if (matchesKey(data, "ctrl+home")) {
+			this.jumpToTop();
+			return "render";
+		}
+		if (matchesKey(data, "ctrl+end")) {
+			this.jumpToBottom();
+			return "render";
+		}
 		if (matchesKey(data, "home")) {
 			this.jumpToTop();
 			return "render";
@@ -631,7 +683,7 @@ async function pickMessage(ctx: ExtensionCommandContext, messages: CopyableMessa
 		const state = new CopyMessagePickerState(messages, initialFormat);
 		return {
 			render(width: number) {
-				return state.render(width, theme, keybindings);
+				return state.render(width, theme, keybindings, tui.mode);
 			},
 			invalidate() {},
 			handleInput(data: string) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-copy-message",
-  "version": "1.0.11",
+  "version": "2.1.0",
   "description": "Pi extension with a searchable TUI picker for copying raw session messages",
   "author": "Mitch Fultz (https://github.com/fitchmultz)",
   "license": "MIT",
@@ -44,8 +44,8 @@
     "LICENSE"
   ],
   "devDependencies": {
-    "@earendil-works/pi-coding-agent": "^0.80.9",
-    "@earendil-works/pi-tui": "^0.80.9",
+    "@earendil-works/pi-coding-agent": "0.84.0",
+    "@earendil-works/pi-tui": "0.84.0",
     "@types/node": "^25.9.1",
     "tsx": "^4.22.4",
     "typescript": "^6.0.3"
@@ -59,5 +59,13 @@
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "*",
     "@earendil-works/pi-tui": "*"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "@earendil-works/pi-tui": {
+      "optional": true
+    }
   }
 }