@fyeeme/pi-peon-ping 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## [1.0.0] - 2025-07-25
+
+### Added
+
+- Initial release of pi-peon-ping
+- Route pi lifecycle events through peon.sh:
+  - `session_start` → `SessionStart`
+  - `turn_start` → `UserPromptSubmit`
+  - `turn_end` → `Stop`
+  - `tool_result` (isError) → `PostToolUseFailure`
+  - `session_shutdown` → `SessionEnd`
+- Terminal tab title updates with visual status indicators
+- Auto-discovery of peon.sh at standard install paths

package/LICENSE

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

package/README.md

@@ -0,0 +1,110 @@
+# pi-peon-ping
+
+peon-ping adapter for [pi](https://github.com/earendil-works/pi-coding-agent). Routes pi lifecycle events through `peon.sh` for sound packs, desktop notifications, and trainer reminders.
+
+## Features
+
+- **Sound packs** — Warcraft, StarCraft, Portal, Red Alert, and 160+ game character voice packs
+- **Desktop notifications** — overlay banners when the terminal is not focused
+- **Trainer reminders** — Pavel-style daily exercise nagging
+- **SSH/devcontainer relay** — sounds play on your local machine, not the remote
+- **Mobile notifications** — push to your phone via ntfy, Pushover, or Telegram
+- **Tab title updates** — `● project: working...` / `✓ project: done` / `✗ project: error`
+
+## Prerequisites
+
+Install [peon-ping](https://github.com/PeonPing/peon-ping) first:
+
+**Option 1: Homebrew**
+
+```bash
+brew install PeonPing/tap/peon-ping
+```
+
+**Option 2: Installer script (macOS, Linux, WSL2)**
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/PeonPing/peon-ping/main/install.sh | bash
+```
+
+## Installation
+
+### As a pi package
+
+```bash
+pi install @fyeeme/pi-peon-ping
+```
+
+### Manual (development)
+
+Copy `index.ts` to `~/.pi/agent/extensions/pi-peon-ping/` (global) or `.pi/extensions/pi-peon-ping/` (project-local), then restart pi.
+
+### From the monorepo
+
+This package lives at `packages/extensions/pi-peon-ping/`. To use it locally, symlink or copy the `index.ts` to your extensions directory:
+
+```bash
+ln -s $(pwd)/packages/extensions/pi-peon-ping ~/.pi/agent/extensions/pi-peon-ping
+```
+
+## Event Mapping
+
+| pi event                     | peon-ping event        | Occurs when                     |
+|------------------------------|------------------------|---------------------------------|
+| `session_start`              | `SessionStart`         | Pi starts or resumes a session  |
+| `turn_start`                 | `UserPromptSubmit`     | You submit a prompt             |
+| `turn_end`                   | `Stop`                 | Agent finishes responding       |
+| `tool_result` (isError)      | `PostToolUseFailure`   | A tool call fails               |
+| `session_shutdown`           | `SessionEnd`           | Session ends                    |
+
+## Configuration
+
+### Environment variable
+
+| Variable | Description |
+|----------|-------------|
+| `PEON_SH` | Absolute path to `peon.sh` / `peon.ps1`. Overrides all automatic discovery. |
+
+### peon.sh Discovery
+
+pi-peon-ping 自动查找已安装的 `peon.sh`，优先级如下（高 → 低）：
+
+| 优先级 | 来源 | 路径 |
+|--------|------|------|
+| 1 | `$PEON_SH` 环境变量 | 用户指定 |
+| 2 | Homebrew (macOS) | `$(brew --prefix peon-ping)/libexec/peon.sh` |
+| 3 | curl 安装 (Linux/macOS) | `~/.claude/hooks/peon-ping/peon.sh` |
+| 4 | `--openpeon` 模式 | `~/.openpeon/hooks/peon-ping/peon.sh` |
+| 5 | OpenClaw 安装 | `~/.openclaw/hooks/peon-ping/peon.sh` |
+| 6 | Windows/Git Bash WSL2 回退 | `~/.claude/hooks/peon-ping/peon.ps1` |
+
+当找到 `.ps1` 文件时，自动使用 `powershell` 而非 `bash` 执行。
+
+### peon-ping 配置
+
+所有 peon-ping 的功能配置通过 `peon` CLI 进行：
+
+```bash
+peon packs use glados          # Switch sound pack
+peon packs install --all       # Install all packs
+peon trainer on                # Enable trainer mode
+peon notifications off         # Mute popups but keep sounds
+peon mobile ntfy my-topic      # Push notifications to phone
+peon ssh-audio relay           # Route audio for remote sessions
+```
+
+## Uninstall
+
+```bash
+rm -rf ~/.pi/agent/extensions/pi-peon-ping
+```
+
+## How It Works
+
+This is a thin adapter — it does not play sounds or send notifications directly. Instead, it finds `peon.sh` (from the peon-ping install) and spawns it with a JSON payload on each lifecycle event. `peon.sh` handles all sound selection, playback, notifications, and trainer logic.
+
+The tab title is updated to reflect current agent state: `● working...` during a turn, `✓ done` on completion, `✗ error` on tool failures.
+
+## Credits
+
+Based on the [oh-my-pi (omp) adapter](https://github.com/PeonPing/peon-ping/tree/main/adapters/omp) from the peon-ping project. Sound packs by [OpenPeon](https://openpeon.com/).

package/index.ts

@@ -0,0 +1,234 @@
+/**
+ * pi-peon-ping — peon-ping adapter for pi
+ *
+ * Routes pi ExtensionAPI lifecycle events through peon.sh, giving pi users
+ * access to ALL peon-ping features:
+ * - Sound packs & rotation (Warcraft, StarCraft, Portal, etc.)
+ * - Desktop notifications
+ * - Trainer reminders (pushups, squats, etc.)
+ * - Spam detection
+ * - SSH/devcontainer relay
+ * - All config options via `peon` CLI
+ * - Tab title updates
+ *
+ * Event mapping (pi ExtensionAPI → peon.sh hook_event_name):
+ *   session_start                       → SessionStart
+ *   turn_start                          → UserPromptSubmit
+ *   turn_end                            → Stop
+ *   tool_result (event.isError === true) → PostToolUseFailure
+ *   session_shutdown                    → SessionEnd
+ *
+ * peon.sh discovery (first match wins):
+ *   1. $PEON_SH env var (explicit override)
+ *   2. brew --prefix peon-ping (macOS Homebrew)
+ *   3. ~/.claude/hooks/peon-ping/peon.sh (curl installer, Linux/macOS)
+ *   4. ~/.openpeon/hooks/peon-ping/peon.sh (tool-agnostic install)
+ *   5. ~/.openclaw/hooks/peon-ping/peon.sh (OpenClaw install)
+ *   6. ~/.claude/hooks/peon-ping/peon.ps1 (Windows/Git Bash WSL2 fallback)
+ *
+ * Requires peon-ping installed:
+ *   brew install PeonPing/tap/peon-ping
+ *   # or: curl -fsSL peonping.com/install | bash
+ *
+ * Based on the oh-my-pi (omp) adapter from:
+ *   https://github.com/PeonPing/peon-ping/tree/main/adapters/omp
+ */
+
+import { spawn, execFileSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { homedir, platform } from "node:os";
+import { basename, join } from "node:path";
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+
+// ============================================================================
+// Constants
+// ============================================================================
+
+/** Template paths for peon.sh discovery. $HOME is resolved at runtime. */
+export const PEON_SH_TEMPLATES = [
+	// Homebrew (macOS)
+	"$(brew --prefix peon-ping)/libexec/peon.sh",
+	// curl installer default (Linux/macOS)
+	"$HOME/.claude/hooks/peon-ping/peon.sh",
+	// --openpeon mode (tool-agnostic root)
+	"$HOME/.openpeon/hooks/peon-ping/peon.sh",
+	// OpenClaw install
+	"$HOME/.openclaw/hooks/peon-ping/peon.sh",
+	// Windows/Git Bash WSL2 fallback
+	"$HOME/.claude/hooks/peon-ping/peon.ps1",
+];
+
+// ============================================================================
+// peon.sh discovery
+// ============================================================================
+
+export function resolvePeonShPaths(): string[] {
+	const home = homedir();
+	return PEON_SH_TEMPLATES.map((t) => t.replace("$HOME", home));
+}
+
+/**
+ * Try to resolve the Homebrew peon-ping prefix.
+ * Returns the libexec/peon.sh path, or undefined if brew is unavailable.
+ */
+export function tryBrewPrefix(): string | undefined {
+	if (platform() !== "darwin") return undefined;
+	try {
+		const prefix = execFileSync("brew", ["--prefix", "peon-ping"], {
+			encoding: "utf-8",
+			timeout: 3000,
+			stdio: ["ignore", "pipe", "ignore"],
+		}).trim();
+		if (!prefix) return undefined;
+		const shPath = join(prefix, "libexec", "peon.sh");
+		return existsSync(shPath) ? shPath : undefined;
+	} catch {
+		return undefined;
+	}
+}
+
+export function findPeonSh(): string | null {
+	// 1. PEON_SH env var override
+	const envPath = process.env.PEON_SH;
+	if (envPath) {
+		try {
+			if (existsSync(envPath)) return envPath;
+		} catch {
+			// permission denied
+		}
+	}
+
+	// 2. Homebrew prefix (macOS only)
+	const brewPath = tryBrewPrefix();
+	if (brewPath) return brewPath;
+
+	// 3-6. Static paths
+	for (const p of resolvePeonShPaths()) {
+		try {
+			if (existsSync(p)) return p;
+		} catch {
+			// permission denied or other fs error
+		}
+	}
+	return null;
+}
+
+// ============================================================================
+// Shell detection
+// ============================================================================
+
+/**
+ * Returns the shell command to use for spawning peon.
+ * On Windows (Git Bash / WSL2), peon.sh may be peon.ps1 and needs powershell.
+ */
+export function resolveShellAndScript(
+	peonPath: string,
+): { shell: string; script: string } {
+	if (peonPath.endsWith(".ps1")) {
+		return { shell: "powershell", script: peonPath };
+	}
+	return { shell: "bash", script: peonPath };
+}
+
+// ============================================================================
+// Terminal tab title helpers
+// ============================================================================
+
+export function setTabTitle(title: string): void {
+	process.stdout.write(`\x1b]0;${title}\x07`);
+}
+
+// ============================================================================
+// Session ID helpers
+// ============================================================================
+
+export function getSessionId(ctx: ExtensionContext): string {
+	try {
+		const sm = ctx.sessionManager as { getSessionFile?: () => string | undefined };
+		const file = sm.getSessionFile?.();
+		if (file) return file;
+	} catch {
+		// session manager not available
+	}
+	return `pi-${Date.now()}`;
+}
+
+// ============================================================================
+// peon.sh invocation
+// ============================================================================
+
+export function firePeon(
+	peonPath: string,
+	event: string,
+	cwd: string,
+	sessionId: string,
+): void {
+	const payload = JSON.stringify({
+		hook_event_name: event,
+		notification_type: "",
+		cwd,
+		session_id: sessionId,
+		permission_mode: "",
+		source: "pi",
+	});
+
+	try {
+		const { shell, script } = resolveShellAndScript(peonPath);
+		const proc = spawn(shell, [script], {
+			stdio: ["pipe", "ignore", "ignore"],
+		});
+		proc.stdin.write(payload);
+		proc.stdin.end();
+		proc.unref();
+	} catch {
+		// best-effort, silently ignore
+	}
+}
+
+// ============================================================================
+// Extension
+// ============================================================================
+
+export default function peonPingExtension(pi: ExtensionAPI): void {
+	const peonPath = findPeonSh();
+	if (!peonPath) {
+		console.warn("[pi-peon-ping] peon.sh not found. Install peon-ping first:");
+		console.warn("  brew install PeonPing/tap/peon-ping");
+		console.warn("  # or: curl -fsSL peonping.com/install | bash");
+		console.warn("  # or: set PEON_SH=/path/to/peon.sh");
+		return;
+	}
+
+	const cwd = process.cwd();
+	const projectName = basename(cwd) || "pi";
+
+	pi.on("session_start", async (_event, ctx) => {
+		const sessionId = getSessionId(ctx);
+		if (ctx.hasUI) setTabTitle(`● ${projectName}: ready`);
+		firePeon(peonPath, "SessionStart", cwd, sessionId);
+	});
+
+	pi.on("turn_start", async (_event, ctx) => {
+		const sessionId = getSessionId(ctx);
+		if (ctx.hasUI) setTabTitle(`● ${projectName}: working...`);
+		firePeon(peonPath, "UserPromptSubmit", cwd, sessionId);
+	});
+
+	pi.on("turn_end", async (_event, ctx) => {
+		const sessionId = getSessionId(ctx);
+		if (ctx.hasUI) setTabTitle(`✓ ${projectName}: done`);
+		firePeon(peonPath, "Stop", cwd, sessionId);
+	});
+
+	pi.on("tool_result", async (event, ctx) => {
+		if (!event.isError) return;
+		const sessionId = getSessionId(ctx);
+		if (ctx.hasUI) setTabTitle(`✗ ${projectName}: error`);
+		firePeon(peonPath, "PostToolUseFailure", cwd, sessionId);
+	});
+
+	pi.on("session_shutdown", async (_event, ctx) => {
+		const sessionId = getSessionId(ctx);
+		firePeon(peonPath, "SessionEnd", cwd, sessionId);
+	});
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@fyeeme/pi-peon-ping",
+  "version": "1.0.0",
+  "description": "peon-ping adapter for pi — routes lifecycle events through peon.sh for sound packs, notifications, and trainer reminders.",
+  "type": "module",
+  "license": "MIT",
+  "author": "fyeeme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fyeeme/pi-packages"
+  },
+  "bugs": {
+    "url": "https://github.com/fyeeme/pi-packages/issues"
+  },
+  "homepage": "https://github.com/fyeeme/pi-packages#readme",
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "pi-package",
+    "pi",
+    "peon-ping",
+    "sounds",
+    "notifications",
+    "lifecycle",
+    "omp"
+  ],
+  "files": [
+    "index.ts",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "scripts": {
+    "test": "vitest --run",
+    "typecheck": "tsc"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": ">=0.77.0"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "0.77.0",
+    "@types/node": "22.19.19",
+    "typescript": "5.9.3"
+  }
+}