@herbertgao/pi-extensions 2026.8.14 → 2026.9.0

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/@narumitw/pi-btw/src/text.ts

@@ -8,3 +8,21 @@ export function sanitizeSingleLine(text: string): string {
 		.replace(/ +/gu, " ")
 		.trim();
 }
+
+export function formatKeyLabel(key: string): string {
+	const sanitized = sanitizeSingleLine(key);
+	if (!sanitized) return "";
+	return sanitized
+		.split("+")
+		.map((part) => {
+			const lower = part.toLowerCase();
+			if (lower === "shift") return "Shift";
+			if (lower === "ctrl") return "Ctrl";
+			if (lower === "alt") return "Alt";
+			if (lower === "super") return "Super";
+			return part.length === 1
+				? part.toUpperCase()
+				: `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`;
+		})
+		.join("+");
+}

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

@@ -24,7 +24,7 @@ import {
 } from "@earendil-works/pi-tui";
 import type { BtwFullscreenLayoutComponent } from "./fullscreen-ui.js";
 import type { BtwThinkingLevel, SideThreadTurn } from "./side-thread.js";
-import { sanitizeSingleLine } from "./text.js";
+import { formatKeyLabel, sanitizeSingleLine } from "./text.js";
 
 const TRANSCRIPT_CHROME_LINES = 2;
 const MAX_STEERING_DISPLAY_LINES = 3;
@@ -613,21 +613,10 @@ function renderSideThreadHeader(
 }
 
 function thinkingKeyLabel(keybindings: KeybindingsManager): string {
-	const key =
-		sanitizeSingleLine(String(keybindings.getKeys("app.thinking.cycle")[0] ?? "shift+tab")) ||
-		"Shift+Tab";
-	return key
-		.split("+")
-		.map((part) => {
-			const lower = part.toLowerCase();
-			if (lower === "shift") return "Shift";
-			if (lower === "ctrl") return "Ctrl";
-			if (lower === "alt") return "Alt";
-			return part.length === 1
-				? part.toUpperCase()
-				: `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`;
-		})
-		.join("+");
+	return (
+		formatKeyLabel(String(keybindings.getKeys("app.thinking.cycle")[0] ?? "shift+tab")) ||
+		"Shift+Tab"
+	);
 }
 
 function fitComposerLayout(

package/node_modules/@narumitw/pi-caffeinate/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 narumiruna
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/node_modules/@narumitw/pi-caffeinate/README.md

@@ -0,0 +1,224 @@
+# ☕ pi-caffeinate — Keep Your Computer Awake While Pi Runs
+
+[![npm](https://img.shields.io/npm/v/@narumitw/pi-caffeinate)](https://www.npmjs.com/package/@narumitw/pi-caffeinate) [![Pi extension](https://img.shields.io/badge/Pi-extension-blue)](https://pi.dev) [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)
+
+Prevent system or display sleep while Pi is running an agent task, then release the inhibitor when the run ends.
+
+## ✨ Features
+
+- Starts an OS sleep inhibitor when a Pi run begins and releases it when the run or session ends.
+- Supports macOS, Windows, WSL, and Linux, with display-awake as the default.
+- Provides `/caffeinate` controls for keep-awake mode and status.
+- Persists preferences locally and accepts an optional custom inhibitor command.
+- Falls back when possible, warns on partial activation, and reports when no inhibitor is available.
+
+## 📦 Install
+
+```bash
+pi install npm:@narumitw/pi-caffeinate
+```
+
+Try without installing permanently:
+
+```bash
+pi -e npm:@narumitw/pi-caffeinate
+```
+
+Try this package locally from the repository root:
+
+```bash
+npm --workspace @narumitw/pi-caffeinate run build
+pi -e ./packages/pi-caffeinate
+```
+
+The package declares `dist/index.ts`, so an unbuilt local checkout must be built before Pi loads the package directory.
+Pi extensions run with the Pi process's user permissions, so install only trusted packages.
+
+## 🚀 Quick start
+
+Load the extension and use Pi normally.
+During each agent run, pi-caffeinate uses the saved mode and defaults to keeping the system and display awake.
+Run `/caffeinate` for controls or `/caffeinate status` for the current state.
+
+## 🖥️ Supported platforms
+
+The default `display` mode prevents system sleep, suspend, or hibernate and keeps the display awake.
+Use `/caffeinate sleep` to prevent system sleep while allowing normal screen blanking or monitor power-off.
+
+| Platform | `sleep` mode | `display` mode, default |
+| --- | --- | --- |
+| macOS | `caffeinate -ims` | `caffeinate -dimsu` |
+| Windows | PowerShell `SetThreadExecutionState(0x80000001)` | PowerShell `SetThreadExecutionState(0x80000003)` |
+| WSL | Windows `powershell.exe` with `SetThreadExecutionState(0x80000001)` | Windows `powershell.exe` with `SetThreadExecutionState(0x80000003)` |
+| Linux with systemd | `systemd-inhibit --what=sleep ... sleep infinity` | D-Bus `org.freedesktop.ScreenSaver.Inhibit` + `systemd-inhibit --what=idle:sleep ... sleep infinity` |
+| Linux without systemd | `caffeinate -ims` when available | D-Bus `org.freedesktop.ScreenSaver.Inhibit` + `caffeinate -dimsu` when available; D-Bus only otherwise |
+
+On Linux, `display` mode requests idle inhibition from `org.freedesktop.ScreenSaver` over D-Bus.
+It tries `/org/freedesktop/ScreenSaver` and `/ScreenSaver` for desktop compatibility and keeps the session-bus connection open for the agent turn.
+Calling `UnInhibit` or closing the connection releases the request.
+`systemd-inhibit --what=idle:sleep` runs alongside D-Bus to preserve logind idle and sleep inhibition.
+If the ScreenSaver service is unavailable, pi-caffeinate keeps the systemd or `caffeinate` blocker and warns that activation is partial.
+If only D-Bus is available, it warns that direct system suspend may remain possible.
+D-Bus calls have 2-second deadlines, and stop or shutdown aborts an in-progress acquisition before closing the connection.
+
+If no supported inhibitor is available, the extension stays loaded and reports that caffeinate is unavailable.
+
+## 💬 Commands
+
+```text
+/caffeinate
+```
+
+Opens keep-awake controls in TUI or RPC mode.
+Print and JSON modes reject the interactive menu.
+Direct routes avoid interactive UI, but Pi's print and JSON modes do not display their notification feedback.
+
+```text
+/caffeinate display
+```
+
+Keeps the system and screen/display awake.
+If an inhibitor is currently active, it is restarted so the new mode applies immediately.
+
+```text
+/caffeinate sleep
+```
+
+Keeps the system awake while allowing normal display sleep.
+If an inhibitor is currently active, it is restarted so the new mode applies immediately.
+
+```text
+/caffeinate status
+```
+
+Shows whether the inhibitor is active, unavailable, disabled, or idle.
+The result includes the mode, quiet-mode state, and settings path.
+
+```text
+/caffeinate mode
+```
+
+Opens the keep-awake mode selector in TUI or RPC mode.
+Escape closes it.
+
+```text
+/caffeinate stop
+```
+
+Releases the active inhibitor until Pi starts another agent run.
+
+```text
+/caffeinate help
+```
+
+Shows the canonical command routes.
+In TUI and RPC mode, unknown commands and trailing text show a rejection with the command guide.
+Compatibility aliases are `screen` for `display`, `system` for `sleep`, `off` for `stop`, and `config` or `settings` for `mode`.
+
+## ⚙️ Settings
+
+### Persisted settings
+
+`/caffeinate sleep` and `/caffeinate display` save the selected mode to:
+
+```text
+${PI_CODING_AGENT_DIR:-~/.pi/agent}/pi-caffeinate.json
+```
+
+Example:
+
+```json
+{
+  "mode": "display",
+  "quiet": true,
+  "updatedAt": 1791763200000
+}
+```
+
+Set `"quiet": true` to hide routine start and release notifications and clear the `caffeinate` status item while active or unavailable.
+Quiet mode does not hide warnings or explicit command feedback.
+It defaults to `false` when omitted.
+The file is read at startup and on `/reload`.
+After editing it in a running session, run `/reload` before using mode commands.
+
+Missing, invalid, or deleted settings use `display` mode with quiet mode off.
+A missing file stays absent until the first successful mode change.
+Within one Pi process, mode saves run in invocation order, reread the latest valid document, and preserve unknown fields.
+Malformed JSON or an invalid recognized field blocks saves until repaired.
+A failed save keeps the previous runtime mode.
+If applying a published mode fails while an inhibitor is active, the extension restores the previous saved mode and inhibitor or reports a rollback failure.
+
+Older versions used `pi-caffeinate-settings.json`.
+A legacy-only file remains readable with a warning and is not modified automatically; rename it to `pi-caffeinate.json`.
+The next settings save writes the canonical file.
+If both files exist, `pi-caffeinate.json` takes precedence.
+The legacy filename is deprecated and will be removed in a future major release.
+
+### Environment variables
+
+Disable the extension:
+
+```bash
+PI_CAFFEINATE_DISABLED=1 pi
+```
+
+Use a custom inhibitor command:
+
+```bash
+PI_CAFFEINATE_COMMAND='systemd-inhibit --what=idle:sleep --why="pi running" --mode=block sleep infinity' pi
+```
+
+The custom command uses shell-like argument parsing but runs directly without a shell.
+`PI_CAFFEINATE_COMMAND` overrides the saved mode, and `/caffeinate status` reports the override.
+
+Deprecated: `PI_CAFFEINATE_ICON` still works for now.
+If you use `@narumitw/pi-statusline`, move the icon to `${PI_CODING_AGENT_DIR:-~/.pi/agent}/pi-statusline.json`:
+
+```json
+{
+  "extensionStatusIcons": {
+    "caffeinate": "☕️"
+  }
+}
+```
+
+Without `@narumitw/pi-statusline`, keep using `PI_CAFFEINATE_ICON` during the compatibility window.
+In `pi-statusline.json`, use an empty string to show caffeinate status without an icon.
+
+Status output calls `display` mode `display-awake` and `sleep` mode `system-awake`.
+
+## 📦 Dependencies
+
+On Linux, `display` mode uses the pure-JavaScript `dbus-native` package to call `org.freedesktop.ScreenSaver` on the session bus.
+
+## 🗂️ Package layout
+
+```txt
+packages/pi-caffeinate/
+├── src/
+│   ├── index.ts       # Pi package entrypoint
+│   ├── caffeinate.ts  # Extension registration and lifecycle orchestration
+│   └── *.ts           # Package-local inhibitor and settings modules
+├── dist/              # Generated source-mapped Jiti runtime
+├── scripts/
+│   └── build-runtime.mjs
+├── test/
+│   ├── build-runtime.test.ts
+│   └── caffeinate.test.ts
+├── README.md
+├── LICENSE
+├── tsconfig.json
+└── package.json
+```
+
+`src/index.ts` remains the thin authoritative forwarder, while Pi loads the generated `dist/index.ts` runtime.
+The other source modules are internal.
+
+## 🔎 Keywords
+
+Pi extension, Pi coding agent, caffeinate, prevent sleep, keep awake, sleep inhibitor, AI agent automation, long-running coding task, TypeScript Pi package.
+
+## 📄 License
+
+MIT.
+See [`LICENSE`](./LICENSE).