@herbertgao/pi-extensions 2026.8.8 → 2026.8.9

package/node_modules/@herbertgao/pi-cc-extensions/extensions/feature/context.ts

@@ -9,7 +9,7 @@ import { Key, Markdown, matchesKey, truncateToWidth, visibleWidth } from "@earen
 export type ContextPart = {
 	label: string;
 	tokens: number;
-	color: "accent" | "success" | "warning" | "muted" | "dim";
+	color: "accent" | "success" | "warning" | "muted" | "dim" | "error";
 };
 
 type PreviewKey = "systemPrompt" | "tools" | "toolResults" | "contextFiles" | "skills";
@@ -43,11 +43,16 @@ export function escCloseHitbox(bounds: DialogBounds): {
 	};
 }
 
-let activeTextPreviews = 0;
+let activeContextOverlays = 0;
 
-/** fullscreen 输入包装用于把鼠标事件继续传给当前文本预览 overlay。 */
+/** fullscreen 输入包装用于把鼠标事件继续传给当前 context overlay。 */
 export function hasActiveTextPreview(): boolean {
-	return activeTextPreviews > 0;
+	return activeContextOverlays > 0;
+}
+
+/** fullscreen overlays fall back to 1002; restore motion events for hover states. */
+function ensureFullscreenMouseMotion(tui: any): void {
+	if (tui.mode === "fullscreen") tui.terminal?.write?.("\x1b[?1003h\x1b[?1006h");
 }
 
 export async function showTextPreview(
@@ -56,10 +61,11 @@ export async function showTextPreview(
 	rawContent: string,
 ): Promise<void> {
 	const content = normalizePreviewText(rawContent);
-	activeTextPreviews++;
+	activeContextOverlays++;
 	try {
 		await ctx.ui.custom(
 			(tui, theme, _keybindings, done) => {
+				ensureFullscreenMouseMotion(tui);
 				let scrollOffset = 0;
 				let pageSize = 1;
 				let totalLines = 1;
@@ -249,7 +255,7 @@ export async function showTextPreview(
 			},
 		);
 	} finally {
-		activeTextPreviews--;
+		activeContextOverlays--;
 	}
 }
 
@@ -424,7 +430,7 @@ export function collectContextBreakdown(ctx: ExtensionCommandContext): ContextBr
 	const parts: ContextPart[] = [
 		{ label: "System prompt", tokens: baseSystem, color: "accent" },
 		{ label: "Tools", tokens: toolTokens, color: "success" },
-		{ label: "Context files", tokens: contextFileTokens, color: "warning" },
+		{ label: "Memory", tokens: contextFileTokens, color: "error" },
 		{ label: "Skills", tokens: skillTokens, color: "warning" },
 		{ label: "User messages", tokens: user, color: "muted" },
 		{ label: "Assistant messages", tokens: assistant, color: "accent" },
@@ -448,10 +454,12 @@ export default function contextUsageExtension(pi: ExtensionAPI) {
 			const breakdown = collectContextBreakdown(ctx);
 			const estimated = breakdown.parts.reduce((sum, part) => sum + part.tokens, 0);
 			const fixedParts = breakdown.parts.filter(
-				(part) => part.label === "System prompt" || part.label === "Tools",
+				(part) =>
+					part.label === "System prompt" || part.label === "Memory" || part.label === "Tools",
 			);
 			const variableParts = breakdown.parts.filter(
-				(part) => part.label !== "System prompt" && part.label !== "Tools",
+				(part) =>
+					part.label !== "System prompt" && part.label !== "Memory" && part.label !== "Tools",
 			);
 			const orderedParts = [...fixedParts, ...variableParts];
 			const fixedTokens = fixedParts.reduce((sum, part) => sum + part.tokens, 0);
@@ -527,9 +535,9 @@ export default function contextUsageExtension(pi: ExtensionAPI) {
 				},
 				{
 					key: "contextFiles",
-					label: "Context files",
-					title: "Context Files",
-					content: contextFilesContent || "No context files loaded.",
+					label: "Memory",
+					title: "Memory Files",
+					content: contextFilesContent || "No memory files loaded.",
 				},
 				{
 					key: "skills",
@@ -549,8 +557,10 @@ export default function contextUsageExtension(pi: ExtensionAPI) {
 			let selectedPreviewIndex = 0;
 
 			while (true) {
-				const action = await ctx.ui.custom(
+				activeContextOverlays++;
+				const actionPromise = ctx.ui.custom(
 					(tui, theme, _keybindings, done) => {
+						ensureFullscreenMouseMotion(tui);
 						let previewHitboxes: Array<{
 							key: PreviewKey;
 							row: number;
@@ -558,6 +568,8 @@ export default function contextUsageExtension(pi: ExtensionAPI) {
 							endCol: number;
 						}> = [];
 						let escHitbox: { row: number; startCol: number; endCol: number } | undefined;
+						let escHovered = false;
+						let hoveredKey: PreviewKey | undefined;
 
 						const padLine = (text: string, width: number): string => {
 							const truncated = truncateToWidth(text, width, "…");
@@ -588,27 +600,32 @@ export default function contextUsageExtension(pi: ExtensionAPI) {
 								}
 
 								const mouse = parseSgrMousePacket(data);
-								if (
-									mouse?.final !== "M" ||
-									mouseBaseButton(mouse.code) !== 0 ||
-									(mouse.code & 32) !== 0
-								)
-									return;
-								if (
+								if (!mouse || mouse.final !== "M") return;
+								const overEsc = Boolean(
 									escHitbox &&
-									mouse.row === escHitbox.row &&
-									mouse.col >= escHitbox.startCol &&
-									mouse.col <= escHitbox.endCol
-								) {
-									done(undefined);
-									return;
-								}
+										mouse.row === escHitbox.row &&
+										mouse.col >= escHitbox.startCol &&
+										mouse.col <= escHitbox.endCol,
+								);
 								const hitbox = previewHitboxes.find(
 									(candidate) =>
 										mouse.row === candidate.row &&
 										mouse.col >= candidate.startCol &&
 										mouse.col <= candidate.endCol,
 								);
+								if ((mouse.code & 32) !== 0) {
+									if (overEsc !== escHovered || hitbox?.key !== hoveredKey) {
+										escHovered = overEsc;
+										hoveredKey = hitbox?.key;
+										tui.requestRender();
+									}
+									return;
+								}
+								if (mouseBaseButton(mouse.code) !== 0) return;
+								if (overEsc) {
+									done(undefined);
+									return;
+								}
 								if (hitbox) {
 									selectedPreviewIndex = Math.max(
 										0,
@@ -643,6 +660,9 @@ export default function contextUsageExtension(pi: ExtensionAPI) {
 									Math.max(...allParts.map((part) => part.label.length)),
 								);
 								const selectedLabel = visiblePreviews[selectedPreviewIndex]?.label;
+								const hoverLabel = visiblePreviews.find(
+									(preview) => preview.key === hoveredKey,
+								)?.label;
 								const partRows = allParts.map((part) => {
 									const pct = contextWindow > 0 ? (part.tokens / contextWindow) * 100 : 0;
 									const swatch = theme.fg(part.color, "■");
@@ -651,12 +671,13 @@ export default function contextUsageExtension(pi: ExtensionAPI) {
 									const selected = part.label === selectedLabel;
 									const prefix = selected ? "› " : "  ";
 									const row = padLine(`${prefix}${swatch} ${label} ${amount}`, inner);
-									return selected ? theme.bg("selectedBg", row) : row;
+									if (selected) return theme.bg("selectedBg", row);
+									return part.label === hoverLabel ? theme.bg("customMessageBg", row) : row;
 								});
 								const border = (text: string) => theme.fg("border", text);
 								const lines = [
 									border(`╭${"─".repeat(inner)}╮`),
-									`${border("│")}${padLine(` ${title}  ${theme.fg("muted", subtitle)}`, inner - escWidth)}${theme.fg("muted", "[esc]")}${border("│")}`,
+									`${border("│")}${padLine(` ${title}  ${theme.fg("muted", subtitle)}`, inner - escWidth)}${theme.fg(escHovered ? "text" : "muted", "[esc]")}${border("│")}`,
 									`${border("├")}${border("─".repeat(inner))}${border("┤")}`,
 									`${border("│")}${padLine(` ${segments}`, inner)}${border("│")}`,
 									`${border("│")}${" ".repeat(inner)}${border("│")}`,
@@ -706,6 +727,12 @@ export default function contextUsageExtension(pi: ExtensionAPI) {
 						},
 					},
 				);
+				let action;
+				try {
+					action = await actionPromise;
+				} finally {
+					activeContextOverlays--;
+				}
 
 				if (!action) break;
 				const preview = previewByKey.get(action as PreviewKey);

package/node_modules/@herbertgao/pi-cc-extensions/extensions/renderer/message-display.ts

@@ -141,7 +141,7 @@ export function installMessageDisplayRendering(): () => void {
 		tracked: new WeakSet(),
 		dispose: () => {},
 	};
-	const track = (component: object): void => {
+	const track = (component: Record<PropertyKey, unknown>): void => {
 		for (const ref of patch.components) {
 			if (!ref.deref()) patch.components.delete(ref);
 		}

package/node_modules/@herbertgao/pi-cc-extensions/extensions/renderer/mouse/interaction.ts

@@ -86,7 +86,8 @@ const TOOL_MOUSE_MOTION_ENABLE = "\x1b[?1003h\x1b[?1006h";
 const TOOL_MOUSE_MOTION_DISABLE = "\x1b[?1003l";
 const FULLSCREEN_MOTION_ENABLED = Symbol("ccstyle.fullscreen-motion-enabled");
 const TOOL_MOUSE_OWNER_KEY = Symbol.for("pi.ccstyle.tool-mouse-owner");
-const DEFAULT_TOOL_MOUSE_OWNER = {};
+type ToolMouseOwner = object;
+const DEFAULT_TOOL_MOUSE_OWNER: ToolMouseOwner = {};
 export const TOOL_MOUSE_DISABLE = "\x1b[?1006l\x1b[?1003l\x1b[?1000l";
 
 let toolMouseUi: any = null;
@@ -96,7 +97,7 @@ let toolMouseRenderPatchOriginal: ((...args: any[]) => any) | null = null;
 let toolMouseRenderPatchWrapper: ((...args: any[]) => any) | null = null;
 let toolMouseRenderPatchState: { active: boolean } | null = null;
 let toolMouseRawWrite: ((data: string) => unknown) | null = null;
-let toolMouseInstallationOwner: object | null = null;
+let toolMouseInstallationOwner: ToolMouseOwner | null = null;
 let fullscreenMotionTerminal: any = null;
 let ownsFullscreenMotion = false;
 let sessionRenderTimer: ReturnType<typeof setTimeout> | null = null;
@@ -156,9 +157,10 @@ function updateToolSummaryHover(tui: any, packet: SgrMousePacket): void {
 }
 
 const EXPAND_PANEL_DOUBLE_CLICK_MS = 400;
-let lastExpandPanelClick: { id: unknown; at: number } | null = null;
+type ExpandPanelIdentity = string | object;
+let lastExpandPanelClick: { id: ExpandPanelIdentity; at: number } | null = null;
 
-function expandPanelIdentity(card: any): unknown {
+function expandPanelIdentity(card: any): ExpandPanelIdentity {
 	return card instanceof ThinkingPreviewBlock
 		? thinkingRunKey(card.messageTimestamp, card.runStartIndex)
 		: card;
@@ -471,7 +473,7 @@ function patchFullscreenViewportInput(tui: any): void {
 				}
 			}
 		}
-		return Reflect.apply(original, this, [data]);
+		return original.apply(this, [data]);
 	};
 }
 
@@ -611,7 +613,7 @@ function wrapToolRendersForFrame(
 				) {
 					const boxOriginal = box.render;
 					const boxWrapped = function (this: any, ...boxArgs: any[]) {
-						const boxLines = Reflect.apply(boxOriginal, this, boxArgs);
+						const boxLines = boxOriginal.apply(this, boxArgs);
 						if (Array.isArray(boxLines)) contentBoxLines = boxLines.length;
 						return boxLines;
 					};
@@ -621,7 +623,7 @@ function wrapToolRendersForFrame(
 					}
 				}
 				try {
-					const lines = Reflect.apply(originalRender, this, renderArgs);
+					const lines = originalRender.apply(this, renderArgs);
 					if (!Array.isArray(lines)) return lines;
 					renderedTools.push({
 						component,
@@ -697,10 +699,10 @@ function patchToolMouseMotionAfterRender(tui: any): void {
 	const rawWrite = typeof terminal?.write === "function" ? terminal.write : undefined;
 	if (typeof original !== "function") return;
 
-	toolMouseRawWrite = rawWrite ? (data) => Reflect.apply(rawWrite, terminal, [data]) : null;
+	toolMouseRawWrite = rawWrite ? (data) => rawWrite.apply(terminal, [data]) : null;
 	const patchState = { active: true };
 	const wrapper = function (this: any, ...args: any[]) {
-		if (!patchState.active) return Reflect.apply(original, this, args);
+		if (!patchState.active) return original.apply(this, args);
 		const renderedTools: FrameToolRender[] = [];
 		const idToComponent = new Map<number, any>();
 		const frame: IoViewFrameState = {
@@ -717,7 +719,7 @@ function patchToolMouseMotionAfterRender(tui: any): void {
 		let sawTuiRender = false;
 		if (originalTuiRender) {
 			const wrappedTuiRender = function (this: any, ...renderArgs: any[]) {
-				const lines = Reflect.apply(originalTuiRender, this, renderArgs);
+				const lines = originalTuiRender.apply(this, renderArgs);
 				if (!Array.isArray(lines)) return lines;
 				sawTuiRender = true;
 				const extracted = extractToolFramePlacements(
@@ -734,7 +736,7 @@ function patchToolMouseMotionAfterRender(tui: any): void {
 		const previousFrame = getActiveIoViewFrame();
 		setActiveIoViewFrame(frame);
 		try {
-			const result = Reflect.apply(original, this, args);
+			const result = original.apply(this, args);
 			succeeded = true;
 			// Test harnesses may paint via doRender without tui.render; recover markers there.
 			if (!sawTuiRender && Array.isArray(this.previousLines)) {
@@ -811,7 +813,7 @@ function handleToolMouseInput(data: string): { consume: true } | undefined {
 }
 
 export function teardownToolMouseInteraction(
-	owner: object = toolMouseInstallationOwner ?? DEFAULT_TOOL_MOUSE_OWNER,
+	owner: ToolMouseOwner = toolMouseInstallationOwner ?? DEFAULT_TOOL_MOUSE_OWNER,
 ): void {
 	const host = globalThis as any;
 	if (host[TOOL_MOUSE_OWNER_KEY] && host[TOOL_MOUSE_OWNER_KEY] !== owner) return;
@@ -861,7 +863,7 @@ export function resetToolHoverState(): void {
 
 export function installToolMouseInteraction(
 	ctx: any,
-	owner: object = DEFAULT_TOOL_MOUSE_OWNER,
+	owner: ToolMouseOwner = DEFAULT_TOOL_MOUSE_OWNER,
 ): void {
 	teardownToolMouseInteraction(toolMouseInstallationOwner ?? owner);
 	if (ctx?.mode !== "tui" || !ctx?.hasUI) return;

package/node_modules/@herbertgao/pi-cc-extensions/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@herbertgao/pi-cc-extensions",
-	"version": "0.8.57",
+	"version": "0.8.58",
 	"license": "MIT",
 	"description": "A Pi productivity suite with Claude Code-style UI, context inspection, and agent/session references",
 	"type": "module",
@@ -69,8 +69,8 @@
 	},
 	"x-upstream": {
 		"package": "pi-cc-extensions",
-		"version": "0.8.64",
+		"version": "0.8.66",
 		"repository": "https://github.com/minuque/pi-cc-extensions",
-		"commit": "4709081a28255b8bdfe610620a2a9ee8951013d6"
+		"commit": "e971a39d1685590de81bd445e3a829279d216039"
 	}
 }

package/node_modules/@herbertgao/pi-handoff/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @tifan/pi-handoff
 
+## 2.0.0
+
+### Major Changes
+
+- [#116](https://github.com/HerbertGao/pi-extensions/pull/116) [`ecda398`](https://github.com/HerbertGao/pi-extensions/commit/ecda398b9a95212c512d53325c617e485e6ded8d) Thanks [@HerbertGao](https://github.com/HerbertGao)! - Adopt prompt-marker handoffs that generate a handoff artifact and start a clean session, while retaining the session query tool and local rename package integration.
+
+### Patch Changes
+
+- Updated dependencies [[`ecda398`](https://github.com/HerbertGao/pi-extensions/commit/ecda398b9a95212c512d53325c617e485e6ded8d)]:
+  - @herbertgao/pi-rename@0.5.0
+
+## 2.0.1
+
+### Patch Changes
+
+- Updated dependencies [[`b2ea184`](https://github.com/tifandotme/pi-extensions/commit/b2ea1841e99243aa4773bd5c33f43c40248859db)]:
+  - @tifan/pi-rename@0.5.0
+
+## 2.0.0
+
+### Major Changes
+
+- [`297e825`](https://github.com/tifandotme/pi-extensions/commit/297e825ba42eeed32814a34cd4fe5bdbe935b11c) Thanks [@tifandotme](https://github.com/tifandotme)! - Replace `/handoff-session` with the `-handoff` prompt marker and automatically start the new session from the generated handoff.
+
+### Patch Changes
+
+- Updated dependencies [[`e8709bc`](https://github.com/tifandotme/pi-extensions/commit/e8709bc388aa8e094918ec465cfab511358f18ff)]:
+  - @tifan/pi-rename@0.4.3
+
 ## 1.1.2
 
 ### Patch Changes

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

@@ -10,42 +10,39 @@ Start a fresh pi session from a handoff document, and query past sessions for co
 pi install npm:@herbertgao/pi-handoff
 ```
 
-For local development:
+## Requirements
+
+Matt Pocock's [`handoff` skill](https://github.com/mattpocock/skills/blob/main/skills/productivity/handoff/SKILL.md) is required:
 
 ```bash
-pi install /absolute/path/to/pi-extensions/packages/pi-handoff
+npx skills add https://github.com/mattpocock/skills --global --skill handoff
 ```
 
-You also need a `handoff` skill installed and discoverable by pi. For example, install or expose Matt Pocock's `handoff` skill, then run `/reload`.
-
 ## How it works
 
-Run `/handoff-session` to generate a handoff document from the current session and start a clean session from it. The command asks what the next session is for, uses the installed `handoff` skill as the document policy, and writes the handoff under the OS temp directory.
+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 is generated from the current conversation using pi-rename-style rules: lowercase, hyphen-separated, and under 60 characters. Naming uses `openai-codex/gpt-5.6-luna` when available, with a local fallback. The focus answer is used for the handoff document, not for the session name. The prompt is left in the editor for review and manual submit.
+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.
 
-## Commands
+## Usage
 
-- `/handoff-session`: Generate a handoff from the current session and start a renamed session from it.
+```text
+fix the auth flow -handoff
+```
 
-## Tools
+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.
 
-- `session_query`: Answer a question about a previous pi session, given the full path to its `.jsonl` file and the question to ask.
+## `session_query`
 
-## Behavior
+`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.
 
-- Uses the current selected model to generate the handoff document.
-- Uses `openai-codex/gpt-5.6-luna` to name the new pi session when available.
-- Requires a discoverable skill named exactly `handoff`.
-- Writes stable, readable files under the OS temp directory, such as `/tmp/pi-handoffs/pi-handoff-2026-06-01-inline-skills.md`.
-- Starts a clean session with native parent-session linking.
-- Does not autosend.
+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.
 
 ## Release notes
 
-See [CHANGELOG.md](CHANGELOG.md)
+See [CHANGELOG.md](CHANGELOG.md).
 
 ## License
 

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

@@ -1,6 +1,6 @@
 {
   "name": "@herbertgao/pi-handoff",
-  "version": "1.1.2",
+  "version": "2.0.0",
   "description": "Transfer pi session context to a new session and query past sessions.",
   "keywords": [
     "handoff",
@@ -33,7 +33,14 @@
     "provenance": true
   },
   "dependencies": {
-    "@herbertgao/pi-rename": "^0.4.2"
+    "@herbertgao/pi-rename": "^0.5.0",
+    "typebox": "^1.1.38"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-agent-core": ">=0.84.2",
+    "@earendil-works/pi-ai": ">=0.84.2",
+    "@earendil-works/pi-coding-agent": ">=0.84.2",
+    "@earendil-works/pi-tui": ">=0.84.2"
   },
   "engines": {
     "node": ">=20"
@@ -46,8 +53,8 @@
   },
   "x-upstream": {
     "package": "@tifan/pi-handoff",
-    "version": "1.1.2",
+    "version": "2.0.1",
     "repository": "https://github.com/tifandotme/pi-extensions",
-    "commit": "460d580"
+    "commit": "3f6b5e628e31817960a02cfae9bcb4a3f4bcd79b"
   }
 }

package/node_modules/@herbertgao/pi-handoff/src/complete-text.ts

@@ -0,0 +1,33 @@
+import { complete, type Message } from "@earendil-works/pi-ai/compat"
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent"
+
+export async function completeText(
+  ctx: Pick<ExtensionContext, "modelRegistry">,
+  model: NonNullable<ExtensionContext["model"]>,
+  systemPrompt: string,
+  message: Message,
+  signal?: AbortSignal,
+): Promise<string | null> {
+  const auth = await ctx.modelRegistry.getApiKeyAndHeaders(model)
+  if (!auth.ok) throw new Error(auth.error)
+
+  const response = await complete(
+    model,
+    { systemPrompt, messages: [message] },
+    {
+      ...(auth.apiKey ? { apiKey: auth.apiKey } : {}),
+      ...(auth.headers ? { headers: auth.headers } : {}),
+      ...(signal ? { signal } : {}),
+    },
+  )
+
+  if (response.stopReason === "aborted") return null
+
+  return response.content
+    .filter((content): content is { type: "text"; text: string } => {
+      return content.type === "text"
+    })
+    .map((content) => content.text)
+    .join("\n")
+    .trim()
+}