@diegopetrucci/pi-extensions 0.1.74 → 0.1.78

package/extensions/notify/index.ts

@@ -25,308 +25,300 @@ type DesktopBackend = "auto" | "macos" | "linux" | "windows-toast" | "none";
 type SoundBackend = "auto" | "macos" | "linux" | "windows-beep" | "command" | "none";
 
 type ProjectConfigContext = {
-	cwd: string;
-	isProjectTrusted?: () => boolean;
+  cwd: string;
+  isProjectTrusted?: () => boolean;
 };
 
 interface NotifyConfig {
-	enabled: boolean;
-	onlyWhenInteractive: boolean;
-	title: string;
-	body: string;
-	channels: {
-		terminal: boolean;
-		desktop: boolean;
-		bell: boolean;
-		sound: boolean;
-	};
-	terminal: {
-		backend: TerminalBackend;
-		tmuxPassthrough: TmuxPassthrough;
-	};
-	desktop: {
-		backend: DesktopBackend;
-	};
-	sound: {
-		backend: SoundBackend;
-		name: string;
-		linuxSoundId: string;
-		frequencyHz: number;
-		durationMs: number;
-		command: string;
-	};
+  enabled: boolean;
+  onlyWhenInteractive: boolean;
+  title: string;
+  body: string;
+  channels: {
+    terminal: boolean;
+    desktop: boolean;
+    bell: boolean;
+    sound: boolean;
+  };
+  terminal: {
+    backend: TerminalBackend;
+    tmuxPassthrough: TmuxPassthrough;
+  };
+  desktop: {
+    backend: DesktopBackend;
+  };
+  sound: {
+    backend: SoundBackend;
+    name: string;
+    linuxSoundId: string;
+    frequencyHz: number;
+    durationMs: number;
+    command: string;
+  };
 }
 
 const DEFAULT_CONFIG: NotifyConfig = {
-	enabled: true,
-	onlyWhenInteractive: true,
-	title: "Pi",
-	body: "Ready for input",
-	channels: {
-		terminal: true,
-		desktop: true,
-		bell: true,
-		sound: false,
-	},
-	terminal: {
-		backend: "auto",
-		tmuxPassthrough: "auto",
-	},
-	desktop: {
-		backend: "auto",
-	},
-	sound: {
-		backend: "auto",
-		name: "Glass",
-		linuxSoundId: "complete",
-		frequencyHz: 1000,
-		durationMs: 250,
-		command: "",
-	},
+  enabled: true,
+  onlyWhenInteractive: true,
+  title: "Pi",
+  body: "Ready for input",
+  channels: {
+    terminal: true,
+    desktop: true,
+    bell: true,
+    sound: false,
+  },
+  terminal: {
+    backend: "auto",
+    tmuxPassthrough: "auto",
+  },
+  desktop: {
+    backend: "auto",
+  },
+  sound: {
+    backend: "auto",
+    name: "Glass",
+    linuxSoundId: "complete",
+    frequencyHz: 1000,
+    durationMs: 250,
+    command: "",
+  },
 };
 
 function readConfigFile(path: string): Partial<NotifyConfig> {
-	if (!existsSync(path)) return {};
-
-	try {
-		return JSON.parse(readFileSync(path, "utf-8")) as Partial<NotifyConfig>;
-	} catch (error) {
-		console.error(`Warning: Could not parse ${path}: ${error}`);
-		return {};
-	}
+  if (!existsSync(path)) return {};
+
+  try {
+    return JSON.parse(readFileSync(path, "utf-8")) as Partial<NotifyConfig>;
+  } catch (error) {
+    console.error(`Warning: Could not parse ${path}: ${error}`);
+    return {};
+  }
 }
 
 function mergeConfig(base: NotifyConfig, overrides: Partial<NotifyConfig>): NotifyConfig {
-	return {
-		...base,
-		...overrides,
-		channels: {
-			...base.channels,
-			...overrides.channels,
-		},
-		terminal: {
-			...base.terminal,
-			...overrides.terminal,
-		},
-		desktop: {
-			...base.desktop,
-			...overrides.desktop,
-		},
-		sound: {
-			...base.sound,
-			...overrides.sound,
-		},
-	};
+  return {
+    ...base,
+    ...overrides,
+    channels: {
+      ...base.channels,
+      ...overrides.channels,
+    },
+    terminal: {
+      ...base.terminal,
+      ...overrides.terminal,
+    },
+    desktop: {
+      ...base.desktop,
+      ...overrides.desktop,
+    },
+    sound: {
+      ...base.sound,
+      ...overrides.sound,
+    },
+  };
 }
 
 function canReadProjectConfig(ctx: ProjectConfigContext): boolean {
-	return typeof ctx.isProjectTrusted === "function" && ctx.isProjectTrusted();
+  return typeof ctx.isProjectTrusted === "function" && ctx.isProjectTrusted();
 }
 
 function loadConfig(ctx: ProjectConfigContext): NotifyConfig {
-	const globalConfig = readConfigFile(join(getAgentDir(), "extensions", "notify.json"));
-	const projectConfig = canReadProjectConfig(ctx)
-		? readConfigFile(join(ctx.cwd, CONFIG_DIR_NAME, "notify.json"))
-		: {};
-	return mergeConfig(mergeConfig(DEFAULT_CONFIG, globalConfig), projectConfig);
+  const globalConfig = readConfigFile(join(getAgentDir(), "extensions", "notify.json"));
+  const projectConfig = canReadProjectConfig(ctx)
+    ? readConfigFile(join(ctx.cwd, CONFIG_DIR_NAME, "notify.json"))
+    : {};
+  return mergeConfig(mergeConfig(DEFAULT_CONFIG, globalConfig), projectConfig);
 }
 
 function powershellString(value: string): string {
-	return `'${value.replace(/'/g, "''")}'`;
+  return `'${value.replace(/'/g, "''")}'`;
 }
 
 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(${powershellString(body)})) > $null`,
-		`[${type}.ToastNotificationManager]::CreateToastNotifier(${powershellString(title)}).Show(${toast})`,
-	].join("; ");
+  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(${powershellString(body)})) > $null`,
+    `[${type}.ToastNotificationManager]::CreateToastNotifier(${powershellString(title)}).Show(${toast})`,
+  ].join("; ");
 }
 
-/**
- * Inside tmux, terminal notifications are written to tmux, not to the terminal
- * that can act on them: tmux is the pane's emulator and parses the sequence
- * itself. tmux has no OSC 777 or OSC 99 handler (checked in 3.7b, whose OSC
- * dispatch covers 4/7/8/9;4/10/11/12/52/104/133) and does not forward OSC codes
- * it does not recognise, so both backends are silently dropped.
- *
- * tmux's DCS passthrough asks it to write a payload to the outer terminal
- * verbatim. Every ESC inside the payload must be doubled.
- *
- * Users must also allow passthrough in tmux.conf:
- *
- *   set -g allow-passthrough all
- *
- * `all` rather than `on`, because `on` only honours passthrough from panes that
- * are currently visible - which drops exactly the notification that matters,
- * the one fired while the user is looking at a different window. When
- * passthrough is disabled entirely, the wrapped sequence is dropped just like
- * the bare one, so wrapping is never a regression.
- */
+/** tmux drops unrecognized OSC, so wrap in DCS passthrough with doubled ESC. */
 function wrapForTmux(sequence: string): string {
-	return `\x1bPtmux;${sequence.replaceAll("\x1b", "\x1b\x1b")}\x1b\\`;
+  return `\x1bPtmux;${sequence.replaceAll("\x1b", "\x1b\x1b")}\x1b\\`;
 }
 
 function shouldWrapForTmux(config: NotifyConfig): boolean {
-	if (config.terminal.tmuxPassthrough === "never") return false;
-	if (config.terminal.tmuxPassthrough === "always") return true;
-	return Boolean(process.env.TMUX);
+  if (config.terminal.tmuxPassthrough === "never") return false;
+  if (config.terminal.tmuxPassthrough === "always") return true;
+  return Boolean(process.env.TMUX);
 }
 
 function writeTerminalSequence(sequence: string, wrap: boolean): void {
-	process.stdout.write(wrap ? wrapForTmux(sequence) : sequence);
+  process.stdout.write(wrap ? wrapForTmux(sequence) : sequence);
 }
 
 function notifyOSC777(title: string, body: string, wrap: boolean): void {
-	writeTerminalSequence(`\x1b]777;notify;${title};${body}\x07`, wrap);
+  writeTerminalSequence(`\x1b]777;notify;${title};${body}\x07`, wrap);
 }
 
 function notifyOSC99(title: string, body: string, wrap: boolean): void {
-	writeTerminalSequence(`\x1b]99;i=1:d=0;${title}\x1b\\`, wrap);
-	writeTerminalSequence(`\x1b]99;i=1:p=body;${body}\x1b\\`, wrap);
+  writeTerminalSequence(`\x1b]99;i=1:d=0;${title}\x1b\\`, wrap);
+  writeTerminalSequence(`\x1b]99;i=1:p=body;${body}\x1b\\`, wrap);
 }
 
 function ringBell(): void {
-	process.stdout.write("\x07");
+  process.stdout.write("\x07");
 }
 
 function runCommand(command: string, args: string[]): Promise<boolean> {
-	return new Promise((resolve) => {
-		execFile(command, args, (error) => resolve(!error));
-	});
+  return new Promise((resolve) => {
+    execFile(command, args, (error) => resolve(!error));
+  });
 }
 
 function runShellCommand(command: string): Promise<boolean> {
-	if (process.platform === "win32") {
-		return runCommand("cmd.exe", ["/d", "/s", "/c", command]);
-	}
+  if (process.platform === "win32") {
+    return runCommand("cmd.exe", ["/d", "/s", "/c", command]);
+  }
 
-	return runCommand(process.env.SHELL || "/bin/sh", ["-lc", command]);
+  return runCommand(process.env.SHELL || "/bin/sh", ["-lc", command]);
 }
 
 function detectTerminalBackend(config: NotifyConfig): Exclude<TerminalBackend, "auto"> {
-	if (config.terminal.backend !== "auto") return config.terminal.backend;
-	if (process.env.KITTY_WINDOW_ID) return "osc99";
-	return "osc777";
+  if (config.terminal.backend !== "auto") return config.terminal.backend;
+  if (process.env.KITTY_WINDOW_ID) return "osc99";
+  return "osc777";
 }
 
 function detectDesktopBackend(config: NotifyConfig): Exclude<DesktopBackend, "auto"> {
-	if (config.desktop.backend !== "auto") return config.desktop.backend;
-	if (process.env.WT_SESSION || process.env.WSL_DISTRO_NAME) return "windows-toast";
-	if (process.platform === "darwin") return "macos";
-	if (process.platform === "linux") return "linux";
-	if (process.platform === "win32") return "windows-toast";
-	return "none";
+  if (config.desktop.backend !== "auto") return config.desktop.backend;
+  if (process.env.WT_SESSION || process.env.WSL_DISTRO_NAME) return "windows-toast";
+  if (process.platform === "darwin") return "macos";
+  if (process.platform === "linux") return "linux";
+  if (process.platform === "win32") return "windows-toast";
+  return "none";
 }
 
 function detectSoundBackend(config: NotifyConfig): Exclude<SoundBackend, "auto"> {
-	if (config.sound.backend !== "auto") return config.sound.backend;
-	if (process.env.WT_SESSION || process.platform === "win32" || process.env.WSL_DISTRO_NAME) return "windows-beep";
-	if (process.platform === "darwin") return "macos";
-	if (process.platform === "linux") return "linux";
-	return "none";
+  if (config.sound.backend !== "auto") return config.sound.backend;
+  if (process.env.WT_SESSION || process.platform === "win32" || process.env.WSL_DISTRO_NAME)
+    return "windows-beep";
+  if (process.platform === "darwin") return "macos";
+  if (process.platform === "linux") return "linux";
+  return "none";
 }
 
 function sendTerminalNotification(
-	title: string,
-	body: string,
-	backend: Exclude<TerminalBackend, "auto">,
-	wrap: boolean,
+  title: string,
+  body: string,
+  backend: Exclude<TerminalBackend, "auto">,
+  wrap: boolean,
 ): void {
-	if (backend === "osc99") {
-		notifyOSC99(title, body, wrap);
-		return;
-	}
-	if (backend === "osc777") {
-		notifyOSC777(title, body, wrap);
-	}
+  if (backend === "osc99") {
+    notifyOSC99(title, body, wrap);
+    return;
+  }
+  if (backend === "osc777") {
+    notifyOSC777(title, body, wrap);
+  }
 }
 
 function appleScriptString(value: string): string {
-	return JSON.stringify(value);
+  return JSON.stringify(value);
 }
 
 function sendDesktopNotification(
-	title: string,
-	body: string,
-	backend: Exclude<DesktopBackend, "auto">,
+  title: string,
+  body: string,
+  backend: Exclude<DesktopBackend, "auto">,
 ): Promise<boolean> {
-	if (backend === "windows-toast") {
-		return runCommand("powershell.exe", ["-NoProfile", "-Command", windowsToastScript(title, body)]);
-	}
-	if (backend === "macos") {
-		return runCommand("osascript", ["-e", `display notification ${appleScriptString(body)} with title ${appleScriptString(title)}`]);
-	}
-	if (backend === "linux") {
-		return runCommand("notify-send", [title, body]);
-	}
-	return Promise.resolve(false);
+  if (backend === "windows-toast") {
+    return runCommand("powershell.exe", [
+      "-NoProfile",
+      "-Command",
+      windowsToastScript(title, body),
+    ]);
+  }
+  if (backend === "macos") {
+    return runCommand("osascript", [
+      "-e",
+      `display notification ${appleScriptString(body)} with title ${appleScriptString(title)}`,
+    ]);
+  }
+  if (backend === "linux") {
+    return runCommand("notify-send", [title, body]);
+  }
+  return Promise.resolve(false);
 }
 
-async function playSound(config: NotifyConfig, backend: Exclude<SoundBackend, "auto">): Promise<boolean> {
-	if (backend === "command") {
-		if (!config.sound.command.trim()) return false;
-		return runShellCommand(config.sound.command);
-	}
-
-	if (backend === "windows-beep") {
-		return runCommand("powershell.exe", [
-			"-NoProfile",
-			"-Command",
-			`[console]::beep(${config.sound.frequencyHz}, ${config.sound.durationMs})`,
-		]);
-	}
-
-	if (backend === "macos") {
-		return runCommand("afplay", [`/System/Library/Sounds/${config.sound.name}.aiff`]);
-	}
-
-	if (backend === "linux") {
-		const soundId = config.sound.linuxSoundId;
-		const viaCanberra = await runCommand("canberra-gtk-play", ["-i", soundId]);
-		if (viaCanberra) return true;
-		return runCommand("paplay", [`/usr/share/sounds/freedesktop/stereo/${soundId}.oga`]);
-	}
-
-	return false;
+async function playSound(
+  config: NotifyConfig,
+  backend: Exclude<SoundBackend, "auto">,
+): Promise<boolean> {
+  if (backend === "command") {
+    if (!config.sound.command.trim()) return false;
+    return runShellCommand(config.sound.command);
+  }
+
+  if (backend === "windows-beep") {
+    return runCommand("powershell.exe", [
+      "-NoProfile",
+      "-Command",
+      `[console]::beep(${config.sound.frequencyHz}, ${config.sound.durationMs})`,
+    ]);
+  }
+
+  if (backend === "macos") {
+    return runCommand("afplay", [`/System/Library/Sounds/${config.sound.name}.aiff`]);
+  }
+
+  if (backend === "linux") {
+    const soundId = config.sound.linuxSoundId;
+    const viaCanberra = await runCommand("canberra-gtk-play", ["-i", soundId]);
+    if (viaCanberra) return true;
+    return runCommand("paplay", [`/usr/share/sounds/freedesktop/stereo/${soundId}.oga`]);
+  }
+
+  return false;
 }
 
 export default function notifyExtension(pi: ExtensionAPI) {
-	pi.on("agent_settled", async (_event, ctx) => {
-		const config = loadConfig(ctx);
-		if (!config.enabled) return;
-		if (config.onlyWhenInteractive && !ctx.hasUI) return;
-
-		const tasks: Array<Promise<unknown>> = [];
-
-		if (config.channels.terminal) {
-			sendTerminalNotification(
-				config.title,
-				config.body,
-				detectTerminalBackend(config),
-				shouldWrapForTmux(config),
-			);
-		}
-
-		if (config.channels.desktop) {
-			tasks.push(sendDesktopNotification(config.title, config.body, detectDesktopBackend(config)));
-		}
-
-		if (config.channels.bell) {
-			ringBell();
-		}
-
-		if (config.channels.sound) {
-			tasks.push(playSound(config, detectSoundBackend(config)));
-		}
-
-		if (tasks.length > 0) {
-			await Promise.allSettled(tasks);
-		}
-	});
+  pi.on("agent_settled", async (_event, ctx) => {
+    const config = loadConfig(ctx);
+    if (!config.enabled) return;
+    if (config.onlyWhenInteractive && !ctx.hasUI) return;
+
+    const tasks: Array<Promise<unknown>> = [];
+
+    if (config.channels.terminal) {
+      sendTerminalNotification(
+        config.title,
+        config.body,
+        detectTerminalBackend(config),
+        shouldWrapForTmux(config),
+      );
+    }
+
+    if (config.channels.desktop) {
+      tasks.push(sendDesktopNotification(config.title, config.body, detectDesktopBackend(config)));
+    }
+
+    if (config.channels.bell) {
+      ringBell();
+    }
+
+    if (config.channels.sound) {
+      tasks.push(playSound(config, detectSoundBackend(config)));
+    }
+
+    if (tasks.length > 0) {
+      await Promise.allSettled(tasks);
+    }
+  });
 }

package/extensions/notify/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-notify",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "A pi extension that sends a notification when the agent is ready for input.",
   "keywords": [
     "pi-package",

package/extensions/openai-fast/README.md

@@ -1,83 +1,21 @@
 # openai-fast
 
-A pi extension that enables OpenAI Codex Fast mode for ChatGPT-auth GPT-5.5 and GPT-5.6 Codex variants (`gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`).
+Deprecated standalone leftover. This package no longer enables Codex Fast mode, registers `/fast`, or reads `openai-fast.json`. On startup it clears a leftover `openai-fast` footer status and removes `fast-mode-2026-02-01` from the current model header. It does not inject Fast fields into requests.
 
-This package is standalone-only and is not auto-loaded by the `@diegopetrucci/pi-extensions` collection package. The collection uses the unified [`fast`](../fast) extension instead.
+Fast mode lives in the unified [`fast`](../fast) extension. Install `@diegopetrucci/pi-fast`, or install the collection, which loads `extensions/fast` only.
 
-When active, the extension injects this into eligible OpenAI Codex request payloads:
-
-```json
-{
-  "service_tier": "priority"
-}
-```
-
-The user-facing feature is OpenAI Codex **Fast mode**. The wire value is `priority` because current Codex clients map Fast mode to the OpenAI priority service tier.
-
-## Eligibility
-
-Fast mode is only injected when all of these are true:
-
-- The current provider is `openai-codex`.
-- The current API is `openai-codex-responses`.
-- The current model is `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, or `gpt-5.6-luna`.
-- The provider is using ChatGPT OAuth/subscription auth, not API-key auth.
-- The request payload does not already include `service_tier`.
-
-## Commands
-
-```text
-/fast
-```
-
-Run `/fast` to toggle Fast mode on or off for the current session/runtime. The command reports the new state in chat, and the footer shows `fast` while Fast mode is active for an eligible model.
-
-The extension defaults to off so installing the full collection does not accidentally spend Fast-mode credits.
-
-## Config
-
-Optional global config:
-
-```text
-~/<pi-config-dir>/agent/extensions/openai-fast.json
-```
-
-Optional project config:
-
-```text
-<project>/<pi-config-dir>/openai-fast.json
-```
-
-Here `<pi-config-dir>` is Pi's runtime config directory name (`CONFIG_DIR_NAME`; `.pi` by default). Project config overrides global config after Pi reports that the project is trusted.
-
-```json
-{
-  "enabled": false,
-  "showStatus": true
-}
-```
-
-- `enabled`: default Fast-mode state when there is no session override.
-- `showStatus`: show a compact `fast` status when Fast mode is active for the current model.
+This package is standalone-only and is not auto-loaded by the `@diegopetrucci/pi-extensions` collection package.
 
 ## Install
 
-### Standalone npm package
-
 ```bash
 pi install npm:@diegopetrucci/pi-openai-fast
 ```
 
-### Collection package
-
-```bash
-pi install npm:@diegopetrucci/pi-extensions
-```
-
-### GitHub package
+Installing this package does not enable Fast mode. For the working extension:
 
 ```bash
-pi install git:github.com/diegopetrucci/pi-extensions
+pi install npm:@diegopetrucci/pi-fast
 ```
 
 Then reload pi:
@@ -85,9 +23,3 @@ Then reload pi:
 ```text
 /reload
 ```
-
-## Notes
-
-- This extension intentionally does not affect API-key OpenAI models.
-- Pi may only account Fast-mode cost correctly when the backend reports `service_tier: "priority"` in the streamed response. The extension does not patch usage totals to avoid double-counting.
-- If pi adds first-class service-tier support later, this extension skips payloads that already contain `service_tier`.