pi-notify 0.1.0 → 1.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Warren Winter
+Copyright (c) 2026
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,64 +1,54 @@
-# Notifications for Pi (`pi-notify`)
+# pi-notify
 
-Sends notifications when an agent turn finishes and took longer than a configurable threshold.
+A [Pi](https://github.com/badlogic/pi-mono) extension that sends a native desktop notification when the agent finishes and is waiting for input.
 
-Supports:
-- desktop popups (macOS)
-- sounds (macOS `afplay`), with plenty of customization options
-- optional Pushover notifications (useful for Apple Watch / iOS)
+## Compatibility
 
-## Install
+| Terminal | Support | Protocol |
+|----------|---------|----------|
+| Ghostty | ✓ | OSC 777 |
+| iTerm2 | ✓ | OSC 777 |
+| WezTerm | ✓ | OSC 777 |
+| rxvt-unicode | ✓ | OSC 777 |
+| Kitty | ✓ | OSC 99 |
+| Windows Terminal | ✓ | PowerShell toast |
+| Terminal.app | ✗ | — |
+| Alacritty | ✗ | — |
 
-From npm:
+## Install
 
 ```bash
 pi install npm:pi-notify
 ```
 
-From the dot314 git bundle (filtered install):
-
-Add to `~/.pi/agent/settings.json` (or replace an existing unfiltered `git:github.com/w-winter/dot314` entry):
-
-```json
-{
-  "packages": [
-    {
-      "source": "git:github.com/w-winter/dot314",
-      "extensions": ["extensions/notify/index.ts"],
-      "skills": [],
-      "themes": [],
-      "prompts": []
-    }
-  ]
-}
+Or via git:
+
+```bash
+pi install git:github.com/ferologics/pi-notify
 ```
 
-## Setup
+Restart Pi.
+
+## How it works
 
-Create your config file:
+When Pi's agent finishes (`agent_end` event), the extension sends a notification via the appropriate protocol:
 
-- copy `notify.json.example` → `notify.json`
+- **OSC 777** (Ghostty, iTerm2, WezTerm, rxvt-unicode): Native escape sequence
+- **OSC 99** (Kitty): Kitty's notification protocol, detected via `KITTY_WINDOW_ID`
+- **Windows toast** (Windows Terminal): PowerShell notification, detected via `WT_SESSION`
 
-Location:
+Clicking the notification focuses the terminal window/tab.
 
-- `~/.pi/agent/extensions/notify/notify.json`
+## What's OSC 777/99?
 
-(If the config file is missing, the extension will error with instructions.)
+OSC = Operating System Command, part of ANSI escape sequences. Terminals use these for things beyond text formatting (change title, colors, notifications, etc.).
 
-## Usage
+`777` is the number rxvt-unicode picked for notifications. Ghostty, iTerm2, WezTerm adopted it. Kitty uses `99` with a more extensible protocol.
 
-- Command: `/notify`
-- Shortcut: `Alt+N` (toggle on/off)
+## Known Limitations
 
-Quick forms:
-- `/notify on|off`
-- `/notify popup` (toggle popup)
-- `/notify pushover` (toggle Pushover)
-- `/notify volume` (toggle constant ↔ timeScaled)
-- `/notify <seconds>` (set minimum duration threshold)
-- `/notify <sound-alias>` (set sound)
+Terminal multiplexers (zellij, tmux, screen) create their own PTY and typically don't pass through OSC notification sequences. Run pi directly in your terminal for notifications to work.
 
-## Notes
+## License
 
-- macOS-only out of the box (uses `osascript` + `afplay`)
-- Pushover requires `curl` and valid `userKey` + `apiToken` in config
+MIT

package/index.ts

@@ -0,0 +1,55 @@
+/**
+ * Pi Notify Extension
+ *
+ * Sends a native terminal notification when Pi agent is done and waiting for input.
+ * Supports multiple terminal protocols:
+ * - OSC 777: Ghostty, iTerm2, WezTerm, rxvt-unicode
+ * - OSC 99: Kitty
+ * - Windows toast: Windows Terminal (WSL)
+ */
+
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+
+function windowsToastScript(title: string, body: string): string {
+    const type = "Windows.UI.Notifications";
+    const mgr = `[${type}.ToastNotificationManager, ${type}, ContentType = WindowsRuntime]`;
+    const template = `[${type}.ToastTemplateType]::ToastText01`;
+    const toast = `[${type}.ToastNotification]::new($xml)`;
+    return [
+        `${mgr} > $null`,
+        `$xml = [${type}.ToastNotificationManager]::GetTemplateContent(${template})`,
+        `$xml.GetElementsByTagName('text')[0].AppendChild($xml.CreateTextNode('${body}')) > $null`,
+        `[${type}.ToastNotificationManager]::CreateToastNotifier('${title}').Show(${toast})`,
+    ].join("; ");
+}
+
+function notifyOSC777(title: string, body: string): void {
+    process.stdout.write(`\x1b]777;notify;${title};${body}\x07`);
+}
+
+function notifyOSC99(title: string, body: string): void {
+    // Kitty OSC 99: i=notification id, d=0 means not done yet, p=body for second part
+    process.stdout.write(`\x1b]99;i=1:d=0;${title}\x1b\\`);
+    process.stdout.write(`\x1b]99;i=1:p=body;${body}\x1b\\`);
+}
+
+function notifyWindows(title: string, body: string): void {
+    const { execFile } = require("child_process");
+    execFile("powershell.exe", ["-NoProfile", "-Command", windowsToastScript(title, body)]);
+}
+
+function notify(title: string, body: string): void {
+    if (process.env.WT_SESSION) {
+        notifyWindows(title, body);
+    } else if (process.env.KITTY_WINDOW_ID) {
+        notifyOSC99(title, body);
+    } else {
+        notifyOSC777(title, body);
+    }
+}
+
+export default function (pi: ExtensionAPI) {
+    pi.on("agent_end", async () => {
+        notify("Pi", "Ready for input");
+    });
+}

package/package.json

@@ -1,37 +1,19 @@
 {
-  "name": "pi-notify",
-  "version": "0.1.0",
-  "description": "Highly configurable desktop/sound/Pushover notifications when Pi agent turn finishes and took longer than a definable threshold",
-  "keywords": ["pi-package", "pi", "pi-coding-agent"],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/w-winter/dot314.git",
-    "directory": "packages/pi-notify"
-  },
-  "bugs": {
-    "url": "https://github.com/w-winter/dot314/issues"
-  },
-  "homepage": "https://github.com/w-winter/dot314#readme",
-  "pi": {
-    "extensions": ["extensions/notify/index.ts"]
-  },
-  "peerDependencies": {
-    "@mariozechner/pi-coding-agent": "*",
-    "@mariozechner/pi-tui": "*"
-  },
-  "scripts": {
-    "prepack": "node ../../scripts/pi-package-prepack.mjs"
-  },
-  "files": ["extensions/**", "README.md", "LICENSE", "package.json"],
-  "dot314Prepack": {
-    "copy": [
-      { "from": "../../extensions/notify/index.ts", "to": "extensions/notify/index.ts" },
-      {
-        "from": "../../extensions/notify/notify.json.example",
-        "to": "extensions/notify/notify.json.example"
-      },
-      { "from": "../../LICENSE", "to": "LICENSE" }
-    ]
-  }
+    "name": "pi-notify",
+    "version": "1.0.0",
+    "description": "Desktop notifications for Pi agent via OSC 777/99 and Windows toast",
+    "keywords": ["pi-package", "pi", "pi-coding-agent", "notifications", "osc"],
+    "author": "ferologics",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/ferologics/pi-notify.git"
+    },
+    "homepage": "https://github.com/ferologics/pi-notify#readme",
+    "bugs": {
+        "url": "https://github.com/ferologics/pi-notify/issues"
+    },
+    "pi": {
+        "extensions": ["index.ts"]
+    }
 }

package/extensions/notify/index.ts

@@ -1,583 +0,0 @@
-/**
- * Desktop Notification Extension
- *
- * Sends a native desktop notification (with optional sound) when the agent finishes,
- * but only if the response took longer than a configurable threshold.
- *
- * Features:
- * - /notify command to configure (or quick: /notify on|off|popup|pushover|<seconds>|<sound>|volume)
- * - Configurable hotkey (default Alt+N) to toggle on/off
- * - Only notifies if agent turn took >= minDurationSeconds
- * - Configurable sounds: system sounds, custom paths, silent, or random
- * - "silent" reserved alias: no sound plays (popup only if enabled)
- * - "random" reserved alias: randomly picks from all sounds with paths
- * - Popup and sound can be toggled independently
- * - Volume modes: "constant" (always max) or "timeScaled" (louder for longer responses)
- * - Pushover integration for Apple Watch / iOS notifications
- * - Status indicator in footer (♫ sound, ↥ popup, ⚡︎ pushover)
- *
- * Configuration file: ~/.pi/agent/extensions/notify/notify.json
- *
- * Volume modes:
- * - "constant": Always plays at volume.max
- * - "timeScaled": Linear interpolation from volume.min (at threshold) to volume.max (at 4× threshold)
- *
- * Usage:
- * - Alt+N (or configured hotkey) to toggle notifications on/off
- * - /notify - open configuration menu
- * - /notify on|off - toggle directly
- * - /notify popup - toggle popup on/off
- * - /notify pushover - toggle Pushover on/off
- * - /notify volume - toggle between constant/timeScaled
- * - /notify 10 - set minimum duration to 10 seconds
- * - /notify glass - set sound to Glass (case-insensitive alias match)
- * - /notify silent - disable sound (popup only)
- * - /notify random - randomly select sound each notification
- */
-
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
-import { execSync, spawn } from "node:child_process";
-import { homedir } from "node:os";
-import { join, dirname } from "node:path";
-import type { ExtensionAPI, ExtensionContext } from "@mariozechner/pi-coding-agent";
-import { Key, type KeyId } from "@mariozechner/pi-tui";
-
-// =============================================================================
-// Configuration
-// =============================================================================
-
-// Configurable hotkey - change this to your preference
-// Examples: Key.ctrl("n"), Key.alt("n"), Key.ctrlShift("n")
-const TOGGLE_HOTKEY: KeyId = Key.alt("n");
-
-// =============================================================================
-// Types
-// =============================================================================
-
-interface SoundEntry {
-	alias: string;
-	path?: string; // undefined for reserved aliases like "silent" and "random"
-}
-
-interface VolumeConfig {
-	mode: "constant" | "timeScaled";
-	max: number; // 0.0 to 1.0+
-	min: number; // 0.0 to 1.0+ (only used in timeScaled mode)
-}
-
-interface PushoverConfig {
-	enabled: boolean;
-	userKey: string;
-	apiToken: string;
-}
-
-interface NotifyConfig {
-	enabled: boolean;
-	minDurationSeconds: number;
-	sound: string; // alias reference
-	showPopup: boolean;
-	sounds: SoundEntry[];
-	volume: VolumeConfig;
-	pushover: PushoverConfig;
-}
-
-// =============================================================================
-// Config File Management
-// =============================================================================
-
-function getConfigPath(): string {
-	return join(homedir(), ".pi", "agent", "extensions", "notify", "notify.json");
-}
-
-function loadConfig(): NotifyConfig {
-	const configPath = getConfigPath();
-
-	if (existsSync(configPath)) {
-		try {
-			const content = readFileSync(configPath, "utf-8");
-			const parsed = JSON.parse(content);
-
-			// Apply defaults for optional sections
-			return {
-				...parsed,
-				volume: {
-					mode: "constant",
-					max: 1.0,
-					min: 0.25,
-					...parsed.volume,
-				},
-				pushover: {
-					enabled: false,
-					userKey: "",
-					apiToken: "",
-					...parsed.pushover,
-				},
-			} as NotifyConfig;
-		} catch {
-			// Fall through to error
-		}
-	}
-
-	throw new Error(
-		`Notify extension: config file not found at ${configPath}. ` +
-		`Please create it with the required structure (see extension docstring).`
-	);
-}
-
-function saveConfig(config: NotifyConfig): void {
-	const configPath = getConfigPath();
-	const dir = dirname(configPath);
-
-	if (!existsSync(dir)) {
-		mkdirSync(dir, { recursive: true });
-	}
-
-	writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
-}
-
-// =============================================================================
-// Volume Calculation
-// =============================================================================
-
-function calculateVolume(config: NotifyConfig, elapsedSeconds: number): number {
-	if (config.volume.mode === "constant") {
-		return config.volume.max;
-	}
-
-	// timeScaled mode: linear interpolation from min to max
-	// At 1× threshold: min volume
-	// At 4× threshold: max volume
-	const threshold = config.minDurationSeconds;
-	const minTime = threshold;
-	const maxTime = threshold * 4;
-
-	if (elapsedSeconds <= minTime) {
-		return config.volume.min;
-	}
-	if (elapsedSeconds >= maxTime) {
-		return config.volume.max;
-	}
-
-	// Linear interpolation
-	const t = (elapsedSeconds - minTime) / (maxTime - minTime);
-	return config.volume.min + t * (config.volume.max - config.volume.min);
-}
-
-// =============================================================================
-// Sound Playback
-// =============================================================================
-
-function findSound(config: NotifyConfig, alias: string): SoundEntry | undefined {
-	return config.sounds.find((s) => s.alias.toLowerCase() === alias.toLowerCase());
-}
-
-function getPlayableSound(config: NotifyConfig, alias: string): SoundEntry | undefined {
-	const lowerAlias = alias.toLowerCase();
-
-	// Handle "random" - pick a random sound (excluding silent and random)
-	if (lowerAlias === "random") {
-		const playableSounds = config.sounds.filter(
-			(s) => s.path && s.alias.toLowerCase() !== "silent" && s.alias.toLowerCase() !== "random"
-		);
-		if (playableSounds.length === 0) return undefined;
-		return playableSounds[Math.floor(Math.random() * playableSounds.length)];
-	}
-
-	return findSound(config, alias);
-}
-
-function playSound(soundEntry: SoundEntry | undefined, volume: number): void {
-	if (!soundEntry || !soundEntry.path) {
-		// silent or not found
-		return;
-	}
-
-	// Spawn detached so sound plays without blocking input
-	const child = spawn("afplay", ["-v", String(volume), soundEntry.path], {
-		detached: true,
-		stdio: "ignore",
-	});
-	child.unref();
-}
-
-// =============================================================================
-// Pushover Integration
-// =============================================================================
-
-function sendPushover(config: NotifyConfig, title: string, message: string): void {
-	if (!config.pushover.enabled || !config.pushover.userKey || !config.pushover.apiToken) {
-		return;
-	}
-
-	// Spawn curl detached so it doesn't block
-	const child = spawn("curl", [
-		"-s",
-		"-X", "POST",
-		"https://api.pushover.net/1/messages.json",
-		"--data-urlencode", `token=${config.pushover.apiToken}`,
-		"--data-urlencode", `user=${config.pushover.userKey}`,
-		"--data-urlencode", `title=${title}`,
-		"--data-urlencode", `message=${message}`,
-	], {
-		detached: true,
-		stdio: "ignore",
-	});
-	child.unref();
-}
-
-// =============================================================================
-// Notification
-// =============================================================================
-
-function notify(title: string, body: string, config: NotifyConfig, elapsedSeconds: number): void {
-	// Show popup notification if enabled
-	if (config.showPopup) {
-		try {
-			execSync(`osascript -e 'display notification "${body}" with title "${title}"'`);
-		} catch {
-			// Silently fail
-		}
-	}
-
-	// Play sound with calculated volume
-	const soundEntry = getPlayableSound(config, config.sound);
-	const volume = calculateVolume(config, elapsedSeconds);
-	playSound(soundEntry, volume);
-
-	// Send Pushover notification
-	sendPushover(config, title, body);
-}
-
-// =============================================================================
-// Extension
-// =============================================================================
-
-export default function notifyExtension(pi: ExtensionAPI) {
-	let config: NotifyConfig;
-	let agentStartTime: number | null = null;
-
-	// =========================================================================
-	// Status Display
-	// =========================================================================
-
-	function updateStatus(ctx: ExtensionContext): void {
-		if (!ctx.hasUI) return;
-
-		if (config.enabled) {
-			const lowerSound = config.sound.toLowerCase();
-			const soundIndicator = lowerSound === "silent" ? "" : "♫";
-			const popupIndicator = config.showPopup ? "↑" : "";
-			const pushoverIndicator = config.pushover.enabled ? "⚡︎" : "";
-			ctx.ui.setStatus(
-				"notify",
-				ctx.ui.theme.fg("success", `${soundIndicator}${popupIndicator}${pushoverIndicator} ${config.minDurationSeconds}s`)
-			);
-		} else {
-			ctx.ui.setStatus("notify", ctx.ui.theme.fg("muted", ""));
-		}
-	}
-
-	// =========================================================================
-	// Toggle Functions
-	// =========================================================================
-
-	function toggleEnabled(ctx: ExtensionContext): void {
-		config.enabled = !config.enabled;
-		saveConfig(config);
-
-		if (ctx.hasUI) {
-			ctx.ui.notify(
-				config.enabled
-					? `Notifications enabled (≥${config.minDurationSeconds}s)`
-					: "Notifications disabled",
-				"info"
-			);
-		}
-
-		updateStatus(ctx);
-	}
-
-	function togglePopup(ctx: ExtensionContext): void {
-		config.showPopup = !config.showPopup;
-		saveConfig(config);
-
-		if (ctx.hasUI) {
-			ctx.ui.notify(
-				config.showPopup ? "Popup notifications enabled" : "Popup notifications disabled",
-				"info"
-			);
-		}
-
-		updateStatus(ctx);
-	}
-
-	function togglePushover(ctx: ExtensionContext): void {
-		config.pushover.enabled = !config.pushover.enabled;
-		saveConfig(config);
-
-		if (ctx.hasUI) {
-			ctx.ui.notify(
-				config.pushover.enabled ? "Pushover notifications enabled" : "Pushover notifications disabled",
-				"info"
-			);
-		}
-
-		updateStatus(ctx);
-	}
-
-	function toggleVolumeMode(ctx: ExtensionContext): void {
-		config.volume.mode = config.volume.mode === "constant" ? "timeScaled" : "constant";
-		saveConfig(config);
-
-		if (ctx.hasUI) {
-			ctx.ui.notify(
-				config.volume.mode === "constant"
-					? `Volume mode: constant (${config.volume.max})`
-					: `Volume mode: timeScaled (${config.volume.min} → ${config.volume.max})`,
-				"info"
-			);
-		}
-	}
-
-	// =========================================================================
-	// Hotkey Registration
-	// =========================================================================
-
-	pi.registerShortcut(TOGGLE_HOTKEY, {
-		description: "Toggle notifications",
-		handler: async (ctx) => {
-			toggleEnabled(ctx);
-		},
-	});
-
-	// =========================================================================
-	// Command Registration
-	// =========================================================================
-
-	pi.registerCommand("notify", {
-		description: "Configure desktop notifications",
-		handler: async (args, ctx) => {
-			// Quick subcommands
-			if (args) {
-				const arg = args.trim().toLowerCase();
-
-				// /notify on
-				if (arg === "on") {
-					config.enabled = true;
-					saveConfig(config);
-					ctx.ui.notify("Notifications enabled", "info");
-					updateStatus(ctx);
-					return;
-				}
-
-				// /notify off
-				if (arg === "off") {
-					config.enabled = false;
-					saveConfig(config);
-					ctx.ui.notify("Notifications disabled", "info");
-					updateStatus(ctx);
-					return;
-				}
-
-				// /notify popup
-				if (arg === "popup") {
-					togglePopup(ctx);
-					return;
-				}
-
-				// /notify pushover
-				if (arg === "pushover") {
-					togglePushover(ctx);
-					return;
-				}
-
-				// /notify volume
-				if (arg === "volume") {
-					toggleVolumeMode(ctx);
-					return;
-				}
-
-				// /notify <number> - set duration
-				const num = parseInt(arg, 10);
-				if (!isNaN(num) && num >= 0) {
-					config.minDurationSeconds = num;
-					saveConfig(config);
-					ctx.ui.notify(`Notification threshold set to ${num} seconds`, "info");
-					updateStatus(ctx);
-					return;
-				}
-
-				// /notify <sound alias> - set sound (case-insensitive match)
-				const matchedSound = findSound(config, arg);
-				if (matchedSound) {
-					config.sound = matchedSound.alias;
-					saveConfig(config);
-					if (matchedSound.path) {
-						playSound(matchedSound, config.volume.max); // Preview at max volume
-					}
-					ctx.ui.notify(`Notification sound set to ${matchedSound.alias}`, "info");
-					updateStatus(ctx);
-					return;
-				}
-
-				// Unknown arg - show help
-				ctx.ui.notify(
-					`Unknown argument: ${args}\nUse: on, off, popup, pushover, volume, <seconds>, or <sound alias>`,
-					"warning"
-				);
-				return;
-			}
-
-			// No args - show interactive menu
-			const menuItems = [
-				`${config.enabled ? "Disable" : "Enable"} notifications`,
-				`${config.showPopup ? "Disable" : "Enable"} popup`,
-				`${config.pushover.enabled ? "Disable" : "Enable"} Pushover (watch)`,
-				`Volume mode: ${config.volume.mode} (tap to toggle)`,
-				`Set max volume (current: ${config.volume.max})`,
-				...(config.volume.mode === "timeScaled" ? [`Set min volume (current: ${config.volume.min})`] : []),
-				`Set duration threshold (current: ${config.minDurationSeconds}s)`,
-				`Change sound (current: ${config.sound})`,
-				"Test notification",
-			];
-
-			const choice = await ctx.ui.select("Notification Settings", menuItems);
-
-			if (choice === null) return;
-
-			// Toggle notifications
-			if (choice === menuItems[0]) {
-				toggleEnabled(ctx);
-				return;
-			}
-
-			// Toggle popup
-			if (choice === menuItems[1]) {
-				togglePopup(ctx);
-				return;
-			}
-
-			// Toggle Pushover
-			if (choice === menuItems[2]) {
-				togglePushover(ctx);
-				return;
-			}
-
-			// Toggle volume mode
-			if (choice === menuItems[3]) {
-				toggleVolumeMode(ctx);
-				return;
-			}
-
-			// Set max volume
-			if (choice === menuItems[4]) {
-				const input = await ctx.ui.input("Max volume (0.0 - 1.0+)", String(config.volume.max));
-				if (input !== null) {
-					const vol = parseFloat(input);
-					if (!isNaN(vol) && vol >= 0) {
-						config.volume.max = vol;
-						saveConfig(config);
-						ctx.ui.notify(`Max volume set to ${vol}`, "info");
-					} else {
-						ctx.ui.notify("Invalid volume", "error");
-					}
-				}
-				return;
-			}
-
-			// Set min volume (only in timeScaled mode)
-			if (config.volume.mode === "timeScaled" && choice === menuItems[5]) {
-				const input = await ctx.ui.input("Min volume (0.0 - 1.0+)", String(config.volume.min));
-				if (input !== null) {
-					const vol = parseFloat(input);
-					if (!isNaN(vol) && vol >= 0) {
-						config.volume.min = vol;
-						saveConfig(config);
-						ctx.ui.notify(`Min volume set to ${vol}`, "info");
-					} else {
-						ctx.ui.notify("Invalid volume", "error");
-					}
-				}
-				return;
-			}
-
-			// Set duration - index shifts based on whether min volume is shown
-			const durationIndex = config.volume.mode === "timeScaled" ? 6 : 5;
-			if (choice === menuItems[durationIndex]) {
-				const input = await ctx.ui.input(
-					"Minimum duration (seconds)",
-					String(config.minDurationSeconds)
-				);
-				if (input !== null) {
-					const num = parseInt(input, 10);
-					if (!isNaN(num) && num >= 0) {
-						config.minDurationSeconds = num;
-						saveConfig(config);
-						ctx.ui.notify(`Threshold set to ${num} seconds`, "info");
-						updateStatus(ctx);
-					} else {
-						ctx.ui.notify("Invalid number", "error");
-					}
-				}
-				return;
-			}
-
-			// Change sound
-			const soundIndex = config.volume.mode === "timeScaled" ? 7 : 6;
-			if (choice === menuItems[soundIndex]) {
-				const soundAliases = config.sounds.map((s) => s.alias);
-				const soundChoice = await ctx.ui.select("Select sound", soundAliases);
-				if (soundChoice !== null) {
-					config.sound = soundChoice;
-					saveConfig(config);
-					const soundEntry = findSound(config, soundChoice);
-					if (soundEntry?.path) {
-						playSound(soundEntry, config.volume.max); // Preview at max volume
-					}
-					ctx.ui.notify(`Sound set to ${soundChoice}`, "info");
-					updateStatus(ctx);
-				}
-				return;
-			}
-
-			// Test notification
-			const testIndex = config.volume.mode === "timeScaled" ? 8 : 7;
-			if (choice === menuItems[testIndex]) {
-				// Test at 4x threshold to demonstrate max volume
-				notify("Pi", "℟", config, config.minDurationSeconds * 4);
-				return;
-			}
-		},
-	});
-
-	// =========================================================================
-	// Agent Lifecycle Events
-	// =========================================================================
-
-	pi.on("agent_start", async () => {
-		agentStartTime = Date.now();
-	});
-
-	pi.on("agent_end", async () => {
-		if (!config.enabled || agentStartTime === null) {
-			agentStartTime = null;
-			return;
-		}
-
-		const elapsedSeconds = (Date.now() - agentStartTime) / 1000;
-		agentStartTime = null;
-
-		if (elapsedSeconds >= config.minDurationSeconds) {
-			notify("Pi", "℟", config, elapsedSeconds);
-		}
-	});
-
-	// =========================================================================
-	// Session Initialization
-	// =========================================================================
-
-	pi.on("session_start", async (_event, ctx) => {
-		config = loadConfig();
-		updateStatus(ctx);
-	});
-}

package/extensions/notify/notify.json.example

@@ -1,52 +0,0 @@
-{
-  "enabled": true,
-  "minDurationSeconds": 10,
-  "sound": "silent",
-  "showPopup": false,
-  "sounds": [
-    {
-      "alias": "silent"
-    },
-    {
-      "alias": "random"
-    },
-    {
-      "alias": "Funk",
-      "path": "/System/Library/Sounds/Funk.aiff"
-    },
-    {
-      "alias": "Glass",
-      "path": "/System/Library/Sounds/Glass.aiff"
-    },
-    {
-      "alias": "Hero",
-      "path": "/System/Library/Sounds/Hero.aiff"
-    },
-    {
-      "alias": "Submarine",
-      "path": "/System/Library/Sounds/Submarine.aiff"
-    },
-    {
-      "alias": "dubdelay1",
-      "path": "/Users/yourUser/Documents/notification_sounds/dubdelay1.mp3"
-    },
-    {
-      "alias": "dubdelay2",
-      "path": "/Users/yourUser/Documents/notification_sounds/dubdelay2.mp3"
-    },
-    {
-      "alias": "liquid",
-      "path": "/Users/yourUser/Documents/notification_sounds/liquid-notif.mp3"
-    }
-  ],
-  "volume": {
-    "mode": "timeScaled",
-    "max": 1,
-    "min": 0.1
-  },
-  "pushover": {
-    "enabled": true,
-    "userKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
-    "apiToken": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
-  }
-}