pi-ui-extend 0.1.4 → 0.1.6

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;
@@ -56,6 +57,7 @@ export declare class PiUiExtendApp {
     private resumeLoading;
     constructor(options: AppOptions);
     start(): Promise<void>;
+    private checkPixUpdateOnStartup;
     private bindCurrentSession;
     private activateRuntime;
     private createExtensionEventBus;
@@ -85,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,7 +37,9 @@ 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";
 import { createIsolatedExtensionEventBus } from "./extension-event-bus.js";
 import { setAppIconTheme } from "./icons.js";
@@ -71,6 +73,7 @@ export class PiUiExtendApp {
     subagentsWidgetController;
     todoWidgetController;
     terminalController;
+    terminalBellSoundController;
     toastController;
     nerdFontController;
     popupActions;
@@ -173,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,
@@ -243,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",
@@ -501,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);
@@ -656,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;
@@ -674,6 +682,18 @@ export class PiUiExtendApp {
         await this.sessionLifecycle.start();
         this.modelUsageController.startPolling();
         this.nerdFontController.ensureInstalledOnStartup();
+        void this.checkPixUpdateOnStartup();
+    }
+    async checkPixUpdateOnStartup() {
+        try {
+            const result = await checkPixUpdate();
+            if (result.status !== "newer")
+                return;
+            this.showToast(formatPixStartupUpdateDialog(result), "warning", { variant: "dialog" });
+        }
+        catch {
+            // Startup update checks should never interrupt the TUI.
+        }
     }
     async bindCurrentSession() {
         await this.sessionLifecycle.bindCurrentSession();
@@ -816,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/clipboard.d.ts

@@ -1,3 +1,4 @@
 export declare function copyTextToClipboard(text: string): void;
 export declare function clipboardSupportAvailable(env?: NodeJS.ProcessEnv): boolean;
 export declare function clipboardInstallHint(): string;
+export declare function osc52ClipboardSequence(text: string, env?: NodeJS.ProcessEnv): string;

package/dist/app/clipboard.js

@@ -10,6 +10,8 @@ export function copyTextToClipboard(text) {
     }
     if (copyWithNativeClipboard(text))
         return;
+    if (copyWithOsc52(text))
+        return;
     throw new Error(`No clipboard command found. ${clipboardInstallHint()}`);
 }
 export function clipboardSupportAvailable(env = process.env) {
@@ -60,6 +62,20 @@ function copyWithNativeClipboard(text) {
     });
     return !result.error && result.status === 0;
 }
+function copyWithOsc52(text) {
+    if (process.stdout.destroyed || (!process.stdout.isTTY && !process.env.TMUX && !process.env.STY))
+        return false;
+    process.stdout.write(osc52ClipboardSequence(text));
+    return true;
+}
+export function osc52ClipboardSequence(text, env = process.env) {
+    const sequence = `\x1b]52;c;${Buffer.from(text, "utf8").toString("base64")}\x07`;
+    if (env.TMUX)
+        return `\x1bPtmux;${sequence.replaceAll("\x1b", "\x1b\x1b")}\x1b\\`;
+    if (env.STY)
+        return `\x1bP${sequence}\x1b\\`;
+    return sequence;
+}
 function resolveNativeClipboardEntrypoint() {
     try {
         return require.resolve("@mariozechner/clipboard");

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/startup-info.d.ts

@@ -1,3 +1,3 @@
-import { type AgentSessionRuntime } from "@earendil-works/pi-coding-agent";
+import type { AgentSessionRuntime } from "@earendil-works/pi-coding-agent";
 export declare function createStartupInfoMessage(runtime: AgentSessionRuntime): string;
 export declare function isEmptyStartupSession(runtime: AgentSessionRuntime): boolean;

package/dist/app/startup-info.js

@@ -1,11 +1,12 @@
 import { homedir } from "node:os";
 import { basename, isAbsolute, relative, sep } from "node:path";
-import { VERSION } from "@earendil-works/pi-coding-agent";
+import { getPixPackageVersion } from "./update.js";
 export function createStartupInfoMessage(runtime) {
     const sections = startupSections(runtime);
     return [
         formatModelLine(runtime),
-        `pix · pi-sdk v${VERSION}`,
+        "",
+        `pix v${getPixPackageVersion()}`,
         "escape interrupt · ctrl+c/ctrl+d clear/exit · / commands",
         "",
         ...sections.flatMap(formatSection),

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/dist/app/update.d.ts

@@ -30,7 +30,9 @@ export type PixUpdateCheckOptions = {
 };
 export declare function pixUpdateUsage(): string;
 export declare function parsePixUpdateArgs(argv: readonly string[]): PixUpdateCliOptions;
+export declare function getPixPackageVersion(packageRoot?: string): string;
 export declare function checkPixUpdate(options?: PixUpdateCheckOptions): Promise<PixUpdateCheckResult>;
 export declare function formatPixUpdateCheck(result: PixUpdateCheckResult): string;
+export declare function formatPixStartupUpdateDialog(result: PixUpdateCheckResult): string;
 export declare function getPixSelfUpdateCommand(packageName: string, latestVersion?: string, packageRoot?: string): PixSelfUpdateCommand | undefined;
 export declare function runPixUpdateCli(argv?: readonly string[]): Promise<number>;

package/dist/app/update.js

@@ -40,6 +40,9 @@ export function parsePixUpdateArgs(argv) {
     }
     return { checkOnly, force, help };
 }
+export function getPixPackageVersion(packageRoot) {
+    return readPixPackageInfo(packageRoot).version;
+}
 export async function checkPixUpdate(options = {}) {
     const packageInfo = readPixPackageInfo(options.packageRoot);
     const base = {
@@ -107,6 +110,19 @@ export function formatPixUpdateCheck(result) {
     lines.push("scope: Pix package, renderer extensions, bundled skills copied into ~/.agents/skills, and the pi-tools-suite payload linked into ~/.pi/agent/extensions");
     return lines.join("\n");
 }
+export function formatPixStartupUpdateDialog(result) {
+    const lines = [
+        "A new Pix version is available.",
+        `current: ${result.packageName} v${result.currentVersion}`,
+        ...(result.latestVersion ? [`latest: ${result.latestVersion}`] : []),
+        "",
+        "To update:",
+        "1. Exit Pix.",
+        "2. Run `pix update` in your shell.",
+        "3. Start Pix again after the update completes.",
+    ];
+    return lines.join("\n");
+}
 export function getPixSelfUpdateCommand(packageName, latestVersion, packageRoot = readPixPackageInfo().packageRoot) {
     if (!packageRootLooksPackageManaged(packageRoot))
         return undefined;

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/src/default-pi-tools-suite-config.ts

@@ -16,6 +16,14 @@ export const DEFAULT_PI_TOOLS_SUITE_CONFIG_JSONC = `{
     // "dcp"
   ],
 
+  // Terminal bell notification settings.
+  "terminalBell": {
+    // Toggle terminal-bell attention signals across supported OSes:
+    // terminal BEL, macOS notification sound, and system notifications
+    // (macOS terminal-notifier/osascript or Linux notify-send when available).
+    "sound": true
+  },
+
   // Dynamic Context Pruning (DCP) module config.
   // The DCP module owns the compress tool and /dcp commands.
   "dcp": {

package/external/pi-tools-suite/src/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;
@@ -12,6 +14,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",
@@ -49,29 +53,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, '\\"')}"`;
 }
@@ -123,7 +153,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
@@ -138,7 +168,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") {
@@ -220,7 +250,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);
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-ui-extend",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "private": false,
   "type": "module",
   "bin": {