pi-ui-extend 0.1.5 → 0.1.8

package/dist/app/app.d.ts

@@ -26,6 +26,7 @@ export declare class PiUiExtendApp {
     private readonly subagentsWidgetController;
     private readonly todoWidgetController;
     private readonly terminalController;
+    private readonly terminalBellSoundController;
     private readonly toastController;
     private readonly nerdFontController;
     private readonly popupActions;
@@ -86,6 +87,7 @@ export declare class PiUiExtendApp {
     private toolDefaultExpanded;
     private stopBlinking;
     private stop;
+    private toggleTerminalBellSound;
     private refreshModelUsageStatusFromClick;
     private showToast;
     private clearToastTimers;

package/dist/app/app.js

@@ -37,6 +37,7 @@ import { AppTodoWidgetController } from "./todo-widget-controller.js";
 import { AppTabsController } from "./tabs-controller.js";
 import { TabLineRenderer } from "./tab-line-renderer.js";
 import { AppTerminalController } from "./terminal-controller.js";
+import { TerminalBellSoundController } from "./terminal-bell-sound-controller.js";
 import { AppToastController } from "./toast-controller.js";
 import { checkPixUpdate, formatPixStartupUpdateDialog } from "./update.js";
 import { AppVoiceController } from "./voice-controller.js";
@@ -72,6 +73,7 @@ export class PiUiExtendApp {
     subagentsWidgetController;
     todoWidgetController;
     terminalController;
+    terminalBellSoundController;
     toastController;
     nerdFontController;
     popupActions;
@@ -174,6 +176,7 @@ export class PiUiExtendApp {
         });
         this.pixConfig = loadPixConfig();
         setAppIconTheme(this.pixConfig.iconTheme.name);
+        this.terminalBellSoundController = new TerminalBellSoundController();
         this.promptEnhancer = new AppPromptEnhancerController({
             runtime: () => this.runtime,
             inputEditor: () => this.inputEditor,
@@ -244,6 +247,8 @@ export class PiUiExtendApp {
             promptEnhancerStatusWidgetText: () => this.promptEnhancer.statusWidgetText(),
             promptEnhancerStatusWidgetActive: () => this.promptEnhancer.statusWidgetActive(),
             promptEnhancerStatusWidgetEnabled: () => this.promptEnhancer.statusWidgetEnabled(),
+            terminalBellSoundStatusWidgetText: () => this.terminalBellSoundController.statusWidgetText(),
+            terminalBellSoundStatusWidgetEnabled: () => this.terminalBellSoundController.isEnabled(),
             voiceStatusWidgetText: () => this.voiceController.statusWidgetText(),
             voiceStatusWidgetActive: () => this.voiceController.statusWidgetActive(),
             userMessageJumpMenuActive: () => this.popupMenus.directMenu === "user-message-jump",
@@ -502,6 +507,7 @@ export class PiUiExtendApp {
                 this.superCompactTools = !this.superCompactTools;
                 this.render();
             },
+            toggleTerminalBellSound: () => this.toggleTerminalBellSound(),
             handleExtensionInputMouse: (event) => this.extensionUiController.handleCustomUiMouse(event),
             render: () => this.render(),
         }, this.popupMenus, this.popupActions, this.scrollController, this.commandController);
@@ -657,6 +663,7 @@ export class PiUiExtendApp {
                 this.mouseController.statusUserJumpTarget = undefined;
                 this.mouseController.statusThinkingExpandTarget = undefined;
                 this.mouseController.statusCompactToolsTarget = undefined;
+                this.mouseController.statusTerminalBellSoundTarget = undefined;
                 this.mouseController.statusSessionTarget = undefined;
                 this.mouseController.statusPromptEnhancerTarget = undefined;
                 this.mouseController.statusVoiceMicTarget = undefined;
@@ -829,6 +836,17 @@ export class PiUiExtendApp {
     async stop() {
         await this.terminalController.stop();
     }
+    toggleTerminalBellSound() {
+        try {
+            const enabled = this.terminalBellSoundController.toggle();
+            this.showToast(enabled ? "Terminal bell notifications enabled" : "Terminal bell notifications muted", "info");
+            this.render();
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.showToast(`Could not update terminal bell notifications: ${message}`, "error");
+        }
+    }
     refreshModelUsageStatusFromClick() {
         const refresh = this.modelUsageController.refreshNow();
         if (refresh.kind === "unsupported") {

package/dist/app/extension-ui-controller.js

@@ -207,6 +207,7 @@ export class ExtensionUiController {
             setHeader: () => undefined,
             setTitle: (title) => {
                 process.title = title;
+                renderIfRunning();
             },
             custom: (async (factory) => await this.showCustomUi(factory)),
             pasteToEditor: (text) => {

package/dist/app/icons.d.ts

@@ -16,6 +16,8 @@ declare const NERD_FONT_ICONS: {
     readonly plus: "󰐕";
     readonly record: "󰑊";
     readonly refresh: "󰑐";
+    readonly volumeHigh: "󰕾";
+    readonly volumeOff: "󰖁";
     readonly user: "󰀄";
     readonly compactTools: "󰍜";
     readonly thinkingExpanded: "󰌵";

package/dist/app/icons.js

@@ -22,6 +22,8 @@ const NERD_FONT_ICONS = {
     plus: "\u{f0415}",
     record: "\u{f044a}",
     refresh: "\u{f0450}",
+    volumeHigh: "\u{f057e}",
+    volumeOff: "\u{f0581}",
     user: "\u{f0004}",
     compactTools: "\u{f035c}",
     thinkingExpanded: "\u{f0335}",
@@ -45,6 +47,8 @@ const FALLBACK_ICONS = {
     plus: "+",
     record: "●",
     refresh: "↻",
+    volumeHigh: "♪",
+    volumeOff: "ø",
     user: "@",
     compactTools: "≡",
     thinkingExpanded: ">",

package/dist/app/mouse-controller.d.ts

@@ -6,7 +6,7 @@ import type { ToastEntry, ToastVariant } from "../ui.js";
 import type { AppPopupActionController } from "./popup-action-controller.js";
 import type { AppPopupMenuController } from "./popup-menu-controller.js";
 import type { AppScrollController } from "./scroll-controller.js";
-import type { Entry, ImageClickTarget, MouseEvent, MouseSelection, StatusContextTarget, StatusCompactToolsTarget, StatusModelTarget, StatusModelUsageTarget, StatusPromptEnhancerTarget, StatusSessionTarget, TabLineMouseTarget, StatusThinkingExpandTarget, StatusThinkingTarget, StatusUserJumpTarget, StatusVoiceLanguageTarget, StatusVoiceMicTarget } from "./types.js";
+import type { Entry, ImageClickTarget, MouseEvent, MouseSelection, StatusContextTarget, StatusCompactToolsTarget, StatusModelTarget, StatusModelUsageTarget, StatusPromptEnhancerTarget, StatusSessionTarget, StatusTerminalBellSoundTarget, TabLineMouseTarget, StatusThinkingExpandTarget, StatusThinkingTarget, StatusUserJumpTarget, StatusVoiceLanguageTarget, StatusVoiceMicTarget } from "./types.js";
 import { type RenderedLink } from "./file-links.js";
 import type { AgentSession } from "@earendil-works/pi-coding-agent";
 type ClickFlash = {
@@ -58,6 +58,7 @@ export type AppMouseControllerHost = {
     refreshModelUsageStatus(): void | Promise<void>;
     toggleAllThinkingExpanded?(): void;
     toggleSuperCompactTools?(): void;
+    toggleTerminalBellSound?(): void;
     copyTextToClipboard?(text: string): void;
     handleExtensionInputMouse(event: MouseEvent & {
         localRow: number;
@@ -101,6 +102,7 @@ export declare class AppMouseController {
     statusUserJumpTarget: StatusUserJumpTarget | undefined;
     statusThinkingExpandTarget: StatusThinkingExpandTarget | undefined;
     statusCompactToolsTarget: StatusCompactToolsTarget | undefined;
+    statusTerminalBellSoundTarget: StatusTerminalBellSoundTarget | undefined;
     statusSessionTarget: StatusSessionTarget | undefined;
     statusPromptEnhancerTarget: StatusPromptEnhancerTarget | undefined;
     statusVoiceMicTarget: StatusVoiceMicTarget | undefined;
@@ -152,6 +154,7 @@ export declare class AppMouseController {
     private handleStatusUserJumpClick;
     private handleStatusThinkingExpandClick;
     private handleStatusCompactToolsClick;
+    private handleStatusTerminalBellSoundClick;
     private handleStatusSessionClick;
     private handleStatusPromptEnhancerClick;
     private handleStatusVoiceMicClick;

package/dist/app/mouse-controller.js

@@ -25,6 +25,7 @@ export class AppMouseController {
     statusUserJumpTarget;
     statusThinkingExpandTarget;
     statusCompactToolsTarget;
+    statusTerminalBellSoundTarget;
     statusSessionTarget;
     statusPromptEnhancerTarget;
     statusVoiceMicTarget;
@@ -78,6 +79,8 @@ export class AppMouseController {
             return;
         if (event.button === 0 && this.withClickFlash(event, () => this.handleStatusCompactToolsClick(event)))
             return;
+        if (event.button === 0 && this.withClickFlash(event, () => this.handleStatusTerminalBellSoundClick(event)))
+            return;
         if (event.button === 0 && this.withClickFlash(event, () => this.handleStatusSessionClick(event)))
             return;
         if (event.button === 0 && this.withClickFlash(event, () => this.handleStatusPromptEnhancerClick(event)))
@@ -522,6 +525,15 @@ export class AppMouseController {
         this.host.toggleSuperCompactTools?.();
         return true;
     }
+    handleStatusTerminalBellSoundClick(event) {
+        const target = this.statusTerminalBellSoundTarget;
+        if (!target)
+            return false;
+        if (event.y !== target.row || event.x < target.startColumn || event.x >= target.endColumn)
+            return false;
+        this.host.toggleTerminalBellSound?.();
+        return true;
+    }
     handleStatusSessionClick(event) {
         const target = this.statusSessionTarget;
         if (!target)

package/dist/app/render-controller.js

@@ -294,6 +294,7 @@ export class AppRenderController {
         this.deps.mouseController.statusUserJumpTarget = this.deps.statusLineRenderer.userJumpTarget?.(statusLayout, statusRow);
         this.deps.mouseController.statusThinkingExpandTarget = this.deps.statusLineRenderer.thinkingExpandTarget?.(statusLayout, statusRow);
         this.deps.mouseController.statusCompactToolsTarget = this.deps.statusLineRenderer.compactToolsTarget?.(statusLayout, statusRow);
+        this.deps.mouseController.statusTerminalBellSoundTarget = this.deps.statusLineRenderer.terminalBellSoundTarget?.(statusLayout, statusRow);
         this.deps.mouseController.statusSessionTarget = this.deps.statusLineRenderer.sessionTarget(statusLayout.text, statusRow, statusLayout.sessionLabel, statusLayout.workspaceLabel);
         this.deps.mouseController.statusPromptEnhancerTarget = this.deps.statusLineRenderer.promptEnhancerTarget(statusLayout, statusRow);
         this.deps.mouseController.statusVoiceMicTarget = this.deps.statusLineRenderer.voiceMicTarget(statusLayout, statusRow);

package/dist/app/session-lifecycle-controller.js

@@ -67,6 +67,9 @@ export class AppSessionLifecycleController {
     async bindCurrentSession() {
         const runtime = this.requireRuntime();
         this.unsubscribe?.();
+        this.unsubscribe = runtime.session.subscribe((event) => {
+            this.host.handleSessionEvent(event);
+        });
         this.host.closeSdkMenuForBind();
         this.host.clearExtensionWidgets();
         await runtime.session.bindExtensions({
@@ -75,9 +78,6 @@ export class AppSessionLifecycleController {
             shutdownHandler: this.host.extensionShutdownHandler(),
             onError: (error) => this.host.handleExtensionError(error),
         });
-        this.unsubscribe = runtime.session.subscribe((event) => {
-            this.host.handleSessionEvent(event);
-        });
     }
     unsubscribeSession() {
         this.unsubscribe?.();

package/dist/app/status-line-renderer.d.ts

@@ -1,6 +1,6 @@
 import type { AgentSession } from "@earendil-works/pi-coding-agent";
 import type { Theme } from "../theme.js";
-import type { SessionActivity, StatusCompactToolsTarget, StatusContextTarget, StatusLineLayout, StatusModelTarget, StatusModelUsageTarget, StatusPromptEnhancerTarget, StatusSessionTarget, StatusThinkingExpandTarget, StatusThinkingTarget, StatusUserJumpTarget, StatusVoiceLanguageTarget, StatusVoiceMicTarget } from "./types.js";
+import type { SessionActivity, StatusCompactToolsTarget, StatusContextTarget, StatusLineLayout, StatusModelTarget, StatusModelUsageTarget, StatusPromptEnhancerTarget, StatusSessionTarget, StatusTerminalBellSoundTarget, StatusThinkingExpandTarget, StatusThinkingTarget, StatusUserJumpTarget, StatusVoiceLanguageTarget, StatusVoiceMicTarget } from "./types.js";
 import type { ScreenStyler } from "./screen-styler.js";
 import { type ModelColorsConfig } from "../config.js";
 export type StatusLineRendererHost = {
@@ -22,6 +22,8 @@ export type StatusLineRendererHost = {
     promptEnhancerStatusWidgetText(): string;
     promptEnhancerStatusWidgetActive(): boolean;
     promptEnhancerStatusWidgetEnabled(): boolean;
+    terminalBellSoundStatusWidgetText(): string;
+    terminalBellSoundStatusWidgetEnabled(): boolean;
     voiceStatusWidgetText(): string;
     voiceStatusWidgetActive(): boolean;
     userMessageJumpMenuActive?(): boolean;
@@ -43,12 +45,14 @@ export declare class StatusLineRenderer {
     userJumpTarget(layout: StatusLineLayout, row: number): StatusUserJumpTarget | undefined;
     thinkingExpandTarget(layout: StatusLineLayout, row: number): StatusThinkingExpandTarget | undefined;
     compactToolsTarget(layout: StatusLineLayout, row: number): StatusCompactToolsTarget | undefined;
+    terminalBellSoundTarget(layout: StatusLineLayout, row: number): StatusTerminalBellSoundTarget | undefined;
     sessionTarget(statusText: string, row: number, label: string, workspaceLabel: string): StatusSessionTarget | undefined;
     private segments;
     private pushPromptEnhancerWidgetSegment;
     private pushUserJumpWidgetSegment;
     private pushThinkingExpandWidgetSegment;
     private pushCompactToolsWidgetSegment;
+    private pushTerminalBellSoundWidgetSegment;
     private pushVoiceWidgetSegment;
     private pushWorkspaceSegments;
     private pushModelUsageSegments;

package/dist/app/status-line-renderer.js

@@ -16,9 +16,10 @@ export class StatusLineRenderer {
         const userJumpButton = APP_ICONS.user;
         const thinkingExpandButton = APP_ICONS.thinkingExpanded;
         const compactToolsButton = APP_ICONS.compactTools;
+        const terminalBellSoundWidgetText = this.host.terminalBellSoundStatusWidgetText();
         const promptEnhancerWidgetText = this.host.promptEnhancerStatusWidgetText();
         const voiceWidgetText = this.host.voiceStatusWidgetText();
-        const rightWidgetText = [userJumpButton, thinkingExpandButton, compactToolsButton, promptEnhancerWidgetText, voiceWidgetText].filter((text) => text.length > 0).join(" ");
+        const rightWidgetText = [userJumpButton, terminalBellSoundWidgetText, thinkingExpandButton, compactToolsButton, promptEnhancerWidgetText, voiceWidgetText].filter((text) => text.length > 0).join(" ");
         const rightWidgetWidth = stringDisplayWidth(rightWidgetText);
         const leftWidth = rightWidgetWidth > 0 && contentWidth > rightWidgetWidth + 1 ? contentWidth - rightWidgetWidth - 1 : contentWidth;
         const baseStatus = this.host.currentStatus();
@@ -38,6 +39,11 @@ export class StatusLineRenderer {
             : undefined;
         if (userJumpWidget)
             nextWidgetStartColumn = userJumpWidget.endColumn + 1;
+        const terminalBellSoundWidget = leftWidth < contentWidth && terminalBellSoundWidgetText.length > 0
+            ? this.widgetLayout(nextWidgetStartColumn, terminalBellSoundWidgetText)
+            : undefined;
+        if (terminalBellSoundWidget)
+            nextWidgetStartColumn = terminalBellSoundWidget.endColumn + 1;
         const thinkingExpandWidget = leftWidth < contentWidth
             ? this.widgetLayout(nextWidgetStartColumn, thinkingExpandButton)
             : undefined;
@@ -62,6 +68,7 @@ export class StatusLineRenderer {
             ...(userJumpWidget ? { userJumpWidget } : {}),
             ...(thinkingExpandWidget ? { thinkingExpandWidget } : {}),
             ...(compactToolsWidget ? { compactToolsWidget } : {}),
+            ...(terminalBellSoundWidget ? { terminalBellSoundWidget } : {}),
             ...(modelUsageLabel ? { modelUsageLabel } : {}),
             ...(contextBarLabel ? { contextBarLabel } : {}),
             ...(promptEnhancerWidget ? { promptEnhancerWidget } : {}),
@@ -162,6 +169,12 @@ export class StatusLineRenderer {
             return undefined;
         return { row, startColumn: widget.startColumn, endColumn: widget.endColumn };
     }
+    terminalBellSoundTarget(layout, row) {
+        const widget = layout.terminalBellSoundWidget;
+        if (!widget)
+            return undefined;
+        return { row, startColumn: widget.startColumn, endColumn: widget.endColumn };
+    }
     sessionTarget(statusText, row, label, workspaceLabel) {
         if (!this.host.session || !label)
             return undefined;
@@ -185,6 +198,7 @@ export class StatusLineRenderer {
         this.pushUserJumpWidgetSegment(segments, statusText);
         this.pushThinkingExpandWidgetSegment(segments, statusText);
         this.pushCompactToolsWidgetSegment(segments, statusText);
+        this.pushTerminalBellSoundWidgetSegment(segments, statusText);
         this.pushWorkspaceSegments(segments, statusText, layout.workspaceLabel);
         if (layout.modelUsageLabel)
             this.pushModelUsageSegments(segments, statusText, layout.modelUsageLabel);
@@ -248,6 +262,13 @@ export class StatusLineRenderer {
             return;
         this.pushSegment(segments, start, buttonText.length, this.host.superCompactToolsActive?.() ? this.host.theme.colors.info : this.host.theme.colors.muted);
     }
+    pushTerminalBellSoundWidgetSegment(segments, statusText) {
+        const widgetText = this.host.terminalBellSoundStatusWidgetText();
+        const start = statusText.lastIndexOf(widgetText);
+        if (start < 0 || widgetText.length <= 0)
+            return;
+        this.pushSegment(segments, start, widgetText.length, this.host.terminalBellSoundStatusWidgetEnabled() ? this.host.theme.colors.info : this.host.theme.colors.muted);
+    }
     pushVoiceWidgetSegment(segments, statusText) {
         const widgetText = this.host.voiceStatusWidgetText();
         const start = statusText.lastIndexOf(widgetText);
@@ -261,7 +282,7 @@ export class StatusLineRenderer {
         }
         const separatorIndex = widgetText.indexOf(" ");
         const micLength = separatorIndex >= 0 ? separatorIndex : widgetText.length;
-        this.pushSegment(segments, start, micLength, this.host.theme.colors.info);
+        this.pushSegment(segments, start, micLength, this.host.theme.colors.muted);
     }
     pushWorkspaceSegments(segments, statusText, workspaceLabel) {
         const start = statusText.lastIndexOf(workspaceLabel);

package/dist/app/terminal-bell-sound-controller.d.ts

@@ -0,0 +1,11 @@
+export declare function getPiToolsSuiteUserConfigPath(homeDir?: string): string;
+export declare function readTerminalBellSoundEnabled(configPath?: string): boolean;
+export declare function writeTerminalBellSoundEnabled(enabled: boolean, configPath?: string): void;
+export declare class TerminalBellSoundController {
+    private readonly configPath;
+    private enabled;
+    constructor(configPath?: string);
+    statusWidgetText(): string;
+    isEnabled(): boolean;
+    toggle(): boolean;
+}

package/dist/app/terminal-bell-sound-controller.js

@@ -0,0 +1,58 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { applyEdits, modify, parse as parseJsonc } from "jsonc-parser";
+import { APP_ICONS } from "./icons.js";
+const TERMINAL_BELL_CONFIG_KEY = "terminalBell";
+const SOUND_CONFIG_KEY = "sound";
+export function getPiToolsSuiteUserConfigPath(homeDir = homedir()) {
+    return join(homeDir, ".config", "pi", "pi-tools-suite.jsonc");
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+export function readTerminalBellSoundEnabled(configPath = getPiToolsSuiteUserConfigPath()) {
+    if (!existsSync(configPath))
+        return true;
+    try {
+        const parsed = parseJsonc(readFileSync(configPath, "utf-8"));
+        if (!isRecord(parsed))
+            return true;
+        const terminalBell = parsed[TERMINAL_BELL_CONFIG_KEY];
+        if (!isRecord(terminalBell))
+            return true;
+        return typeof terminalBell[SOUND_CONFIG_KEY] === "boolean" ? terminalBell[SOUND_CONFIG_KEY] : true;
+    }
+    catch {
+        return true;
+    }
+}
+export function writeTerminalBellSoundEnabled(enabled, configPath = getPiToolsSuiteUserConfigPath()) {
+    const original = existsSync(configPath) ? readFileSync(configPath, "utf-8") : "{}\n";
+    const edits = modify(original, [TERMINAL_BELL_CONFIG_KEY, SOUND_CONFIG_KEY], enabled, {
+        formattingOptions: { insertSpaces: true, tabSize: 2, eol: "\n" },
+    });
+    const updated = applyEdits(original, edits);
+    mkdirSync(dirname(configPath), { recursive: true });
+    writeFileSync(configPath, updated.endsWith("\n") ? updated : `${updated}\n`, "utf-8");
+}
+export class TerminalBellSoundController {
+    configPath;
+    enabled;
+    constructor(configPath = getPiToolsSuiteUserConfigPath()) {
+        this.configPath = configPath;
+        this.enabled = readTerminalBellSoundEnabled(this.configPath);
+    }
+    statusWidgetText() {
+        return this.enabled ? APP_ICONS.volumeHigh : APP_ICONS.volumeOff;
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    toggle() {
+        const nextEnabled = !this.enabled;
+        writeTerminalBellSoundEnabled(nextEnabled, this.configPath);
+        this.enabled = nextEnabled;
+        return this.enabled;
+    }
+}

package/dist/app/types.d.ts

@@ -266,6 +266,7 @@ export type StatusLineLayout = {
     userJumpWidget?: StatusUserJumpWidgetLayout;
     thinkingExpandWidget?: StatusThinkingExpandWidgetLayout;
     compactToolsWidget?: StatusCompactToolsWidgetLayout;
+    terminalBellSoundWidget?: StatusTerminalBellSoundWidgetLayout;
     promptEnhancerWidget?: StatusPromptEnhancerWidgetLayout;
     voiceWidget?: StatusVoiceWidgetLayout;
 };
@@ -281,10 +282,19 @@ export type StatusCompactToolsWidgetLayout = {
     startColumn: number;
     endColumn: number;
 };
+export type StatusTerminalBellSoundWidgetLayout = {
+    startColumn: number;
+    endColumn: number;
+};
 export type StatusPromptEnhancerWidgetLayout = {
     startColumn: number;
     endColumn: number;
 };
+export type StatusTerminalBellSoundTarget = {
+    row: number;
+    startColumn: number;
+    endColumn: number;
+};
 export type StatusVoiceWidgetLayout = {
     startColumn: number;
     micEndColumn: number;

package/extensions/terminal-bell/index.ts

@@ -1,7 +1,9 @@
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { spawn } from "node:child_process";
-import { existsSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
 import { delimiter, isAbsolute, join } from "node:path";
+import { parse as parseJsonc } from "jsonc-parser";
 
 const BELL = "\x07";
 const DEFAULT_IDLE_DELAY_MS = 250;
@@ -13,6 +15,8 @@ const DEFAULT_NOTIFICATION_TITLE = "Pi";
 const DEFAULT_NOTIFICATION_MESSAGE = "Session stopped";
 const DEFAULT_ASK_USER_NOTIFICATION_MESSAGE = "Waiting for your answer";
 const DEFAULT_MAC_SOUND = "Glass";
+const TERMINAL_BELL_CONFIG_KEY = "terminalBell";
+const SOUND_CONFIG_KEY = "sound";
 
 const TERM_PROGRAM_BUNDLE_IDS: Record<string, string> = {
 	Apple_Terminal: "com.apple.Terminal",
@@ -50,29 +54,55 @@ function extensionDisabled(): boolean {
 	return isTruthyEnv(process.env.HEADLESS) || isTruthyEnv(process.env.PI_TERMINAL_BELL_DISABLED);
 }
 
-function canRingTerminal(): boolean {
-	if (process.env.PI_TERMINAL_BELL === "0") return false;
-	if (process.env.PI_TERMINAL_BELL_FORCE === "1") return true;
-	return Boolean(process.stdout.isTTY || process.stderr.isTTY);
+function getPiToolsSuiteUserConfigPath(homeDir = homedir()): string {
+	return join(homeDir, ".config", "pi", "pi-tools-suite.jsonc");
 }
 
-function writeBell(): void {
-	const stream = process.stdout.isTTY || !process.stderr.isTTY ? process.stdout : process.stderr;
-	stream.write(BELL);
+function isRecord(value: unknown): value is Record<string, unknown> {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+
+export function readTerminalBellSoundConfig(configPath = getPiToolsSuiteUserConfigPath()): boolean | undefined {
+	if (!existsSync(configPath)) return undefined;
+	try {
+		const parsed = parseJsonc(readFileSync(configPath, "utf-8")) as unknown;
+		if (!isRecord(parsed)) return undefined;
+		const terminalBell = parsed[TERMINAL_BELL_CONFIG_KEY];
+		if (!isRecord(terminalBell)) return undefined;
+		const sound = terminalBell[SOUND_CONFIG_KEY];
+		return typeof sound === "boolean" ? sound : undefined;
+	} catch {
+		return undefined;
+	}
 }
 
-function soundEnabled(ctx: ExtensionContext): boolean {
+export function terminalBellSoundEnabled(ctx: Pick<ExtensionContext, "hasUI">, configPath = getPiToolsSuiteUserConfigPath()): boolean {
 	if (process.env.PI_TERMINAL_BELL_SOUND === "0") return false;
 	if (process.env.PI_TERMINAL_BELL_SOUND === "1") return true;
+	const configured = readTerminalBellSoundConfig(configPath);
+	if (configured !== undefined) return configured;
 	return ctx.hasUI === true;
 }
 
-function notificationsEnabled(ctx: ExtensionContext): boolean {
+export function terminalBellNotificationsEnabled(ctx: Pick<ExtensionContext, "hasUI">, configPath = getPiToolsSuiteUserConfigPath()): boolean {
+	if (!terminalBellSoundEnabled(ctx, configPath)) return false;
 	if (process.env.PI_TERMINAL_BELL_NOTIFY === "0") return false;
 	if (process.env.PI_TERMINAL_BELL_NOTIFY === "1") return true;
 	return ctx.hasUI === true;
 }
 
+export function canRingTerminal(ctx: Pick<ExtensionContext, "hasUI">, configPath = getPiToolsSuiteUserConfigPath()): boolean {
+	if (!terminalBellSoundEnabled(ctx, configPath)) return false;
+	if (process.env.PI_TERMINAL_BELL === "0") return false;
+	if (process.env.PI_TERMINAL_BELL_FORCE === "1") return true;
+	return Boolean(process.stdout.isTTY || process.stderr.isTTY);
+}
+
+function writeBell(): void {
+	const stream = process.stdout.isTTY || !process.stderr.isTTY ? process.stdout : process.stderr;
+	stream.write(BELL);
+}
+
 function appleScriptString(value: string): string {
 	return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
 }
@@ -124,7 +154,7 @@ function detectMacActivationBundleId(): string | undefined {
 }
 
 function playAttentionSound(ctx: ExtensionContext): void {
-	if (!soundEnabled(ctx)) return;
+	if (!terminalBellSoundEnabled(ctx)) return;
 	if (process.platform !== "darwin") return;
 	const sound = process.env.PI_TERMINAL_BELL_SOUND && process.env.PI_TERMINAL_BELL_SOUND !== "1"
 		? process.env.PI_TERMINAL_BELL_SOUND
@@ -139,7 +169,7 @@ function notifySessionStopped(
 	macActivationBundleId: string | undefined,
 	message = process.env.PI_TERMINAL_BELL_NOTIFY_MESSAGE ?? DEFAULT_NOTIFICATION_MESSAGE,
 ): void {
-	if (!notificationsEnabled(ctx)) return;
+	if (!terminalBellNotificationsEnabled(ctx)) return;
 	const title = process.env.PI_TERMINAL_BELL_NOTIFY_TITLE ?? DEFAULT_NOTIFICATION_TITLE;
 
 	if (process.platform === "darwin") {
@@ -221,7 +251,7 @@ export default function terminalBell(pi: ExtensionAPI) {
 	}
 
 	function notifyAttention(ctx: ExtensionContext, message?: string): void {
-		if (canRingTerminal()) writeBell();
+		if (canRingTerminal(ctx)) writeBell();
 		playAttentionSound(ctx);
 		notifySessionStopped(ctx, macActivationBundleId, message);
 		pi.events.emit(TERMINAL_BELL_ATTENTION_EVENT, {

package/external/pi-tools-suite/README.md

@@ -2,11 +2,10 @@
 
 Local all-in-one Pi extension package.
 
-This package keeps the former standalone extensions as ordinary source folders under `src/` and registers them through one entrypoint.
+This package keeps shared Pi tools as ordinary source folders under `src/` and registers them through one entrypoint.
 
 - `src/ast-grep` — `ast_grep` / `ast_apply`
 - `src/async-subagents` — `subagents` tool and sub-agent slash commands, including oh-my-openagent-style `/ultrawork` (`/ulw`) and `/hyperplan` orchestration prompts, plus config-defined sub-agent model/thinking/args presets selected via `/subagent-preset` from `asyncSubagents` in `~/.config/pi/pi-tools-suite.jsonc`; includes the `frontend` profile for Gemini-friendly UI/UX and visual frontend work plus the `vision` profile for screenshot/image description via `openai-codex/gpt-5.4-mini`; enforces a 30-minute per-agent execution timeout, project-wide `maxConcurrent` queueing, optional retry/backoff, and `result.json` structured metadata/chaining fields next to raw `result.md`; stores project-local run files and a registry under `.pi/subagents/` so result/status collection can recover after compaction or reload while the main session remains alive
-- `src/terminal-bell` — terminal bell, macOS attention sound, and best-effort OS notification when the main agent session returns to idle; defers the alert while sub-agents are still running or the main agent is waiting for sub-agent results
 - `src/lsp` — shared LSP diagnostics hook/library that enriches mutating tool results with diagnostics and shuts down language servers on session shutdown
 - `src/repo-discovery` — `/idx-init`, `/idx-update`, and indexed-only `repo_architecture` / `repo_structure` / `repo_ast` / `repo_search` / `repo_explain` / `repo_deps`; tools register only when the launch project has `.indexer-cli`
 - `src/antigravity-auth` — `antigravity` custom provider with Google Antigravity OAuth login, startup account list, `/antigravity-import` credential migration from opencode, `/antigravity-add-account` OAuth append into rotation, `/antigravity-account` status display, account rotation/failover, Antigravity plus Gemini CLI model registration, and streaming through the Cloud Code Assist unified gateway
@@ -19,7 +18,7 @@ This package keeps the former standalone extensions as ordinary source folders u
 
 `index.ts` is intentionally only a thin auto-discovery shim that re-exports `src/index.ts`. There is no `pi.extensions` manifest here, so local Pi auto-discovery loads the suite once via `~/.pi/agent/extensions/pi-tools-suite/index.ts` and does not double-register tools.
 
-Registration order is preserved in `src/index.ts`: ast-grep, async-subagents, terminal-bell, lsp, repo-discovery command/tool gate, antigravity-auth provider, todo, model-tools, usage, web-search, dcp, then prompt-commands. Tool metadata and active model-specific tool sets have two modes: standard and repo-aware. When `.indexer-cli` enables `repo_*`, those tools stay active ahead of overlapping lower-level aliases so the indexed discovery surface has priority.
+Registration order is preserved in `src/index.ts`: ast-grep, async-subagents, lsp, repo-discovery command/tool gate, antigravity-auth provider, todo, model-tools, usage, web-search, dcp, then prompt-commands. Tool metadata and active model-specific tool sets have two modes: standard and repo-aware. When `.indexer-cli` enables `repo_*`, those tools stay active ahead of overlapping lower-level aliases so the indexed discovery surface has priority.
 
 ## Disabling modules
 
@@ -27,14 +26,14 @@ Disable suite modules without editing `src/index.ts` via config or environment v
 
 ```jsonc
 {
-  "disabledModules": ["terminal-bell", "web-search"]
+  "disabledModules": ["web-search"]
 }
 ```
 
 Environment overrides are applied last:
 
 ```bash
-PI_TOOLS_SUITE_DISABLED_MODULES=terminal-bell,web-search pi ...
+PI_TOOLS_SUITE_DISABLED_MODULES=web-search pi ...
 PI_TOOLS_SUITE_DISABLED=1 pi ...   # disables all pi-tools-suite modules
 ```
 
@@ -152,50 +151,6 @@ Troubleshooting:
 
 Do not send secrets, tokens, private repository text, or credential-bearing URLs through these tools; Ollama may query external web services to satisfy the request.
 
-## Terminal bell / idle alert
-
-`src/terminal-bell` alerts the user when the main Pi agent returns to idle. It does not alert while sub-agents are still running or while the main agent is waiting for sub-agent results.
-
-Disable it entirely for headless runs:
-
-```bash
-HEADLESS=1 pi ...
-# or
-PI_TERMINAL_BELL_DISABLED=1 pi ...
-```
-
-Common environment options:
-
-| Variable | Effect |
-| --- | --- |
-| `PI_TERMINAL_BELL=0` | Disable terminal `\x07` bell only |
-| `PI_TERMINAL_BELL_FORCE=1` | Emit terminal bell even without TTY |
-| `PI_TERMINAL_BELL_DELAY_MS=250` | Delay before alerting after idle |
-| `PI_TERMINAL_BELL_SOUND=0` | Disable macOS `afplay` attention sound |
-| `PI_TERMINAL_BELL_SOUND=Glass` | macOS sound name or absolute `.aiff` path |
-| `PI_TERMINAL_BELL_NOTIFY=0` | Disable OS notification only |
-| `PI_TERMINAL_BELL_NOTIFY=1` | Force OS notification even outside UI mode |
-| `PI_TERMINAL_BELL_NOTIFY_TITLE=Pi` | Notification title |
-| `PI_TERMINAL_BELL_NOTIFY_MESSAGE="Session stopped"` | Notification body |
-
-macOS clickable notifications require `terminal-notifier`:
-
-```bash
-brew install terminal-notifier
-```
-
-At extension startup, the module resolves the app to activate on click from `PI_TERMINAL_BELL_NOTIFY_ACTIVATE`, `__CFBundleIdentifier`, or `TERM_PROGRAM` (Zed, iTerm2, Terminal, WezTerm, Warp, Ghostty, Kitty, Alacritty, VS Code). The resolved bundle id is passed to `terminal-notifier -activate` and to an explicit `open -b <bundleId>` click action.
-
-macOS-specific notification options:
-
-| Variable | Effect |
-| --- | --- |
-| `PI_TERMINAL_BELL_NOTIFY_ACTIVATE=dev.zed.Zed` | Override click activation bundle id |
-| `PI_TERMINAL_BELL_NOTIFY_ACTIVATE=0` | Disable click activation |
-| `PI_TERMINAL_BELL_NOTIFIER=/path/to/terminal-notifier` | Use a custom notifier binary |
-| `PI_TERMINAL_BELL_NOTIFY_SENDER=1` | Also pass `-sender <bundleId>` (can break click handling on some macOS versions) |
-| `PI_TERMINAL_BELL_NOTIFY_OSASCRIPT=1` | Use the `osascript` fallback when `terminal-notifier` is missing; clicking these notifications can open Script Editor |
-
 ## Layout
 
 ```text
@@ -206,7 +161,6 @@ pi-tools-suite/
     index.ts
     ast-grep/
     async-subagents/
-    terminal-bell/
     lsp/
     repo-discovery/
     antigravity-auth/

package/external/pi-tools-suite/src/async-subagents/core/spawn.ts

@@ -673,7 +673,6 @@ function subagentEnvironment(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv {
 		PI_TOOLS_SUITE_DISABLED_MODULES: appendEnvList(env.PI_TOOLS_SUITE_DISABLED_MODULES, [
 			"async-subagents",
 			"question",
-			"terminal-bell",
 		]),
 	};
 }