claude-code-sounds 1.0.0

package/README.md

@@ -0,0 +1,273 @@
+<div align="center">
+
+<img src="images/peon.png" width="280" alt="WC3 Orc Peon" />
+
+# claude-code-sounds
+
+**Sound themes for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) lifecycle hooks.**
+
+Plays sound effects when sessions start, prompts are submitted, responses finish, errors occur, and more.
+
+Ships with a **WC3 Orc Peon** theme. Bring your own sounds or create new themes.
+
+*"Something need doing?"*
+
+</div>
+
+## Quick Start
+
+```bash
+npx claude-code-sounds
+```
+
+That's it. Requires macOS (uses `afplay`) and Node.js 16+.
+
+<details>
+<summary>Alternative: install from source</summary>
+
+```bash
+git clone https://github.com/ryparker/claude-code-sounds.git
+cd claude-code-sounds
+./install.sh
+```
+
+The bash installer requires `jq` (`brew install jq`).
+
+</details>
+
+## Usage
+
+```bash
+npx claude-code-sounds              # Install default theme (wc3-peon)
+npx claude-code-sounds <theme>      # Install a specific theme
+npx claude-code-sounds --list       # List available themes
+npx claude-code-sounds --uninstall  # Remove all sounds and hooks
+```
+
+## WC3 Orc Peon Theme
+
+55 sounds from Warcraft 3 Orc units mapped across 11 Claude Code lifecycle events.
+
+> After installing, preview all sounds with `./preview.sh` or a specific category with `./preview.sh start`
+
+<details open>
+<summary><b>start</b> — Session starting, being summoned (5 sounds)</summary>
+
+| Sound | Quote | Unit |
+|---|---|---|
+| `ready-to-work.wav` | *"Ready to work!"* | Peon |
+| `something-need-doing.wav` | *"Something need doing?"* | Peon |
+| `more-work.mp3` | *"More work?"* | Peon (WC2) |
+| `how-can-i-help.wav` | *"How can I help?"* | Shaman |
+| `someone-call-for-the-doctor.wav` | *"Someone call for the doctor?"* | Witch Doctor |
+
+</details>
+
+<details>
+<summary><b>prompt</b> — User submitted a prompt, acknowledging order (7 sounds)</summary>
+
+| Sound | Quote | Unit |
+|---|---|---|
+| `yes.wav` | *"Yes"* | Peon |
+| `dabu.wav` | *"Dabu"* | Grunt |
+| `zug-zug.wav` | *"Zug zug"* | Grunt |
+| `right-away.wav` | *"Right away"* | Shaman |
+| `immediately.wav` | *"Immediately!"* | Tauren |
+| `anything-you-want.wav` | *"Anything you want"* | Headhunter |
+| `more-work.mp3` | *"More work?"* | Peon (WC2) |
+
+</details>
+
+<details>
+<summary><b>stop</b> — Claude finished responding (8 sounds)</summary>
+
+| Sound | Quote | Unit |
+|---|---|---|
+| `zug-zug.wav` | *"Zug zug"* | Peon |
+| `ok.wav` | *"OK"* | Peon |
+| `i-can-do-that.wav` | *"I can do that"* | Peon |
+| `be-happy-to.wav` | *"Be happy to"* | Peon |
+| `understood.wav` | *"Understood"* | Shaman |
+| `of-course.wav` | *"Of course"* | Far Seer |
+| `it-is-certain.wav` | *"It is certain"* | Far Seer |
+| `whatever-you-say.wav` | *"Whatever you say"* | Grom Hellscream |
+
+</details>
+
+<details>
+<summary><b>permission</b> — Permission prompt, waiting for approval (5 sounds)</summary>
+
+| Sound | Quote | Unit |
+|---|---|---|
+| `hmmm.wav` | *"Hmmm?"* | Peon |
+| `what-you-want.wav` | *"What you want?"* | Peon |
+| `what-you-want-me-to-do.wav` | *"What you want me to do?"* | Headhunter |
+| `who-you-want-me-kill.wav` | *"Who you want me kill?"* | Headhunter |
+| `you-seek-me-help.wav` | *"You seek me help?"* | Witch Doctor |
+
+</details>
+
+<details>
+<summary><b>subagent</b> — Spawning a subagent (6 sounds)</summary>
+
+| Sound | Quote | Unit |
+|---|---|---|
+| `work-work.wav` | *"Work, work"* | Peon |
+| `zug-zug.wav` | *"Zug zug"* | Peon |
+| `ill-try.wav` | *"I'll try"* | Peon |
+| `why-not.wav` | *"Why not?"* | Peon |
+| `for-the-horde.wav` | *"For the Horde!"* | Grunt |
+| `taste-the-fury.wav` | *"Taste the fury of the Warsong!"* | Grom Hellscream |
+
+</details>
+
+<details>
+<summary><b>idle</b> — Waiting for user input (7 sounds)</summary>
+
+| Sound | Quote | Unit |
+|---|---|---|
+| `me-busy-leave-me-alone.wav` | *"Me busy, leave me alone!"* | Peon |
+| `no-time-for-play.wav` | *"No time for play!"* | Peon |
+| `me-not-that-kind-of-orc.wav` | *"Me not that kind of orc!"* | Peon |
+| `why-you-poking-me.wav` | *"Why are you poking me again?"* | Grunt |
+| `not-easy-being-green.wav` | *"It's not easy being green"* | Grunt |
+| `i-can-wait-no-longer.wav` | *"I can wait no longer!"* | Grom Hellscream |
+| `outlook-not-so-good.wav` | *"Outlook... not so good"* | Far Seer |
+
+</details>
+
+<details>
+<summary><b>error</b> — Tool call failed (4 sounds)</summary>
+
+| Sound | Quote | Unit |
+|---|---|---|
+| `peon-death.wav` | *(death sound)* | Peon |
+| `grunt-death.wav` | *(death sound)* | Grunt |
+| `headhunter-death.wav` | *(death sound)* | Headhunter |
+| `reply-hazy-try-again.wav` | *"Reply hazy, try again"* | Far Seer |
+
+</details>
+
+<details>
+<summary><b>end</b> — Session ending (3 sounds)</summary>
+
+| Sound | Quote | Unit |
+|---|---|---|
+| `well-done.wav` | *"Well done!"* | Tauren |
+| `finally.wav` | *"Finally!"* | Grom Hellscream |
+| `okie-dokie.wav` | *"Okie dokie"* | Peon |
+
+</details>
+
+<details>
+<summary><b>task-completed</b> — Task marked done (2 sounds)</summary>
+
+| Sound | Quote | Unit |
+|---|---|---|
+| `well-done.wav` | *"Well done!"* | Tauren |
+| `finally.wav` | *"Finally!"* | Grom Hellscream |
+
+</details>
+
+<details>
+<summary><b>compact</b> — Context compaction, memory fading (4 sounds)</summary>
+
+| Sound | Quote | Unit |
+|---|---|---|
+| `concentrate-and-ask-again.wav` | *"Concentrate... and ask again"* | Far Seer |
+| `reply-hazy-try-again.wav` | *"Reply hazy, try again"* | Far Seer |
+| `i-can-wait-no-longer.wav` | *"I can wait no longer!"* | Grom Hellscream |
+| `death.wav` | *(death sound)* | Peon |
+
+</details>
+
+<details>
+<summary><b>teammate-idle</b> — Teammate went idle (4 sounds)</summary>
+
+| Sound | Quote | Unit |
+|---|---|---|
+| `what.wav` | *"What?!"* | Peon |
+| `me-busy-leave-me-alone.wav` | *"Me busy, leave me alone!"* | Peon |
+| `no-time-for-play.wav` | *"No time for play!"* | Peon |
+| `i-can-wait-no-longer.wav` | *"I can wait no longer!"* | Grom Hellscream |
+
+</details>
+
+## Hook Events
+
+| Event | Hook | When |
+|---|---|---|
+| `start` | `SessionStart` | Session begins |
+| `end` | `SessionEnd` | Session ends |
+| `prompt` | `UserPromptSubmit` | You submit a prompt |
+| `stop` | `Stop` | Claude finishes responding |
+| `permission` | `Notification` | Permission prompt appears |
+| `idle` | `Notification` | Waiting for your input |
+| `subagent` | `SubagentStart` | Subagent spawned |
+| `error` | `PostToolUseFailure` | Tool call failed |
+| `task-completed` | `TaskCompleted` | Task marked done |
+| `compact` | `PreCompact` | Context compaction |
+| `teammate-idle` | `TeammateIdle` | Teammate went idle |
+
+## Creating a Theme
+
+Themes live in `themes/<name>/` with two files:
+
+### `theme.json`
+
+Defines metadata and maps source files to hook categories:
+
+```json
+{
+  "name": "My Theme",
+  "description": "A short description",
+  "sounds": {
+    "start": {
+      "description": "Session starting",
+      "files": [
+        { "src": "path/to/file.wav", "name": "descriptive-name.wav" }
+      ]
+    }
+  }
+}
+```
+
+### `download.sh`
+
+Downloads the sound files. Receives two arguments:
+- `$1` — target sounds directory (`~/.claude/sounds`)
+- `$2` — temp directory for downloads
+
+The script should download and extract files so they're accessible at `$2/Orc/<src path>` (matching the `src` values in `theme.json`).
+
+## How It Works
+
+A single script (`~/.claude/hooks/play-sound.sh`) handles all events. It takes a category name as an argument, picks a random `.wav` or `.mp3` from `~/.claude/sounds/<category>/`, and plays it with `afplay`.
+
+Hooks are configured in `~/.claude/settings.json` — each Claude Code lifecycle event calls the script with the appropriate category.
+
+## Customizing
+
+Drop any `.wav` or `.mp3` into the sound directories to add your own clips:
+
+```
+~/.claude/sounds/
+├── start/        # add files here for session start
+├── stop/         # add files here for response complete
+├── error/        # add files here for failures
+└── ...
+```
+
+The script picks randomly from whatever files are in each directory.
+
+## Uninstalling
+
+```bash
+npx claude-code-sounds --uninstall
+```
+
+This removes all sound files, the hook script, and the hooks config from `settings.json`.
+
+## Disclaimer
+
+Sound files are downloaded from third-party sources at install time and are not included in this repository. All game audio is property of Blizzard Entertainment.

package/bin/cli.js

@@ -0,0 +1,262 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const { execSync } = require("child_process");
+
+// ─── Paths ───────────────────────────────────────────────────────────────────
+
+const PKG_DIR = path.resolve(__dirname, "..");
+const CLAUDE_DIR = path.join(os.homedir(), ".claude");
+const SOUNDS_DIR = path.join(CLAUDE_DIR, "sounds");
+const HOOKS_DIR = path.join(CLAUDE_DIR, "hooks");
+const SETTINGS_PATH = path.join(CLAUDE_DIR, "settings.json");
+const THEMES_DIR = path.join(PKG_DIR, "themes");
+
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+
+function print(msg = "") {
+  console.log(msg);
+}
+
+function die(msg) {
+  console.error(`Error: ${msg}`);
+  process.exit(1);
+}
+
+function mkdirp(dir) {
+  fs.mkdirSync(dir, { recursive: true });
+}
+
+function exec(cmd, opts = {}) {
+  return execSync(cmd, { encoding: "utf-8", stdio: "pipe", ...opts });
+}
+
+function listThemes() {
+  const themes = [];
+  for (const name of fs.readdirSync(THEMES_DIR)) {
+    const themeJson = path.join(THEMES_DIR, name, "theme.json");
+    if (!fs.existsSync(themeJson)) continue;
+    const meta = JSON.parse(fs.readFileSync(themeJson, "utf-8"));
+    themes.push({ name, description: meta.description || "", display: meta.name || name });
+  }
+  return themes;
+}
+
+function readSettings() {
+  if (fs.existsSync(SETTINGS_PATH)) {
+    return JSON.parse(fs.readFileSync(SETTINGS_PATH, "utf-8"));
+  }
+  return {};
+}
+
+function writeSettings(settings) {
+  mkdirp(CLAUDE_DIR);
+  fs.writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2) + "\n");
+}
+
+// ─── Hooks Config ────────────────────────────────────────────────────────────
+
+const HOOKS_CONFIG = {
+  SessionStart: [{ matcher: "startup", hooks: [{ type: "command", command: '/bin/bash "$HOME/.claude/hooks/play-sound.sh" start', timeout: 5 }] }],
+  SessionEnd: [{ hooks: [{ type: "command", command: '/bin/bash "$HOME/.claude/hooks/play-sound.sh" end', timeout: 5 }] }],
+  Notification: [
+    { matcher: "permission_prompt", hooks: [{ type: "command", command: '/bin/bash "$HOME/.claude/hooks/play-sound.sh" permission', timeout: 5 }] },
+    { matcher: "idle_prompt", hooks: [{ type: "command", command: '/bin/bash "$HOME/.claude/hooks/play-sound.sh" idle', timeout: 5 }] },
+  ],
+  Stop: [{ hooks: [{ type: "command", command: '/bin/bash "$HOME/.claude/hooks/play-sound.sh" stop', timeout: 5 }] }],
+  SubagentStart: [{ hooks: [{ type: "command", command: '/bin/bash "$HOME/.claude/hooks/play-sound.sh" subagent', timeout: 5 }] }],
+  PostToolUseFailure: [{ hooks: [{ type: "command", command: '/bin/bash "$HOME/.claude/hooks/play-sound.sh" error', timeout: 5 }] }],
+  UserPromptSubmit: [{ hooks: [{ type: "command", command: '/bin/bash "$HOME/.claude/hooks/play-sound.sh" prompt', timeout: 5 }] }],
+  TaskCompleted: [{ hooks: [{ type: "command", command: '/bin/bash "$HOME/.claude/hooks/play-sound.sh" task-completed', timeout: 5 }] }],
+  PreCompact: [{ hooks: [{ type: "command", command: '/bin/bash "$HOME/.claude/hooks/play-sound.sh" compact', timeout: 5 }] }],
+  TeammateIdle: [{ hooks: [{ type: "command", command: '/bin/bash "$HOME/.claude/hooks/play-sound.sh" teammate-idle', timeout: 5 }] }],
+};
+
+// ─── Commands ────────────────────────────────────────────────────────────────
+
+function showHelp() {
+  print("");
+  print("  claude-code-sounds");
+  print("  ──────────────────────────────");
+  print("");
+  print("  Usage:");
+  print("    npx claude-code-sounds              Install default theme (wc3-peon)");
+  print("    npx claude-code-sounds <theme>      Install a specific theme");
+  print("    npx claude-code-sounds --list       List available themes");
+  print("    npx claude-code-sounds --uninstall  Remove all sounds and hooks");
+  print("    npx claude-code-sounds --help       Show this help");
+  print("");
+}
+
+function showList() {
+  print("");
+  print("  Available themes:");
+  print("");
+  for (const t of listThemes()) {
+    print(`    ${t.name} — ${t.description}`);
+  }
+  print("");
+}
+
+function uninstall() {
+  print("");
+  print("  Uninstalling claude-code-sounds...");
+
+  if (fs.existsSync(SOUNDS_DIR)) {
+    fs.rmSync(SOUNDS_DIR, { recursive: true });
+    print("  Removed ~/.claude/sounds/");
+  }
+
+  const hookScript = path.join(HOOKS_DIR, "play-sound.sh");
+  if (fs.existsSync(hookScript)) {
+    fs.unlinkSync(hookScript);
+    print("  Removed ~/.claude/hooks/play-sound.sh");
+  }
+
+  if (fs.existsSync(SETTINGS_PATH)) {
+    const settings = readSettings();
+    delete settings.hooks;
+    writeSettings(settings);
+    print("  Removed hooks from settings.json");
+  }
+
+  print("");
+  print("  Done. All sounds removed.");
+  print("");
+}
+
+function install(themeName) {
+  const themeDir = path.join(THEMES_DIR, themeName);
+  const themeJsonPath = path.join(themeDir, "theme.json");
+
+  if (!fs.existsSync(themeJsonPath)) {
+    die(`Theme '${themeName}' not found.\n\nAvailable themes:\n${listThemes().map((t) => `  ${t.name} — ${t.description}`).join("\n")}`);
+  }
+
+  const theme = JSON.parse(fs.readFileSync(themeJsonPath, "utf-8"));
+  const categories = Object.keys(theme.sounds);
+
+  // Preflight
+  try {
+    exec("which afplay");
+  } catch {
+    die("afplay not found. This tool requires macOS.");
+  }
+
+  print("");
+  print("  claude-code-sounds");
+  print("  ──────────────────────────────");
+  print(`  Theme: ${theme.name}`);
+  print("");
+
+  // 1. Create directories
+  print("  [1/4] Creating directories...");
+  for (const cat of categories) {
+    mkdirp(path.join(SOUNDS_DIR, cat));
+  }
+  mkdirp(HOOKS_DIR);
+
+  // 2. Download sounds
+  print("  [2/4] Downloading sounds...");
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "claude-sounds-"));
+
+  try {
+    const downloadScript = path.join(themeDir, "download.sh");
+    if (fs.existsSync(downloadScript)) {
+      exec(`bash "${downloadScript}" "${SOUNDS_DIR}" "${tmpDir}"`, { stdio: "inherit" });
+    }
+
+    // 3. Sort sounds
+    print("  [3/4] Sorting sounds...");
+
+    // Clear existing sounds
+    for (const cat of categories) {
+      const catDir = path.join(SOUNDS_DIR, cat);
+      for (const f of fs.readdirSync(catDir)) {
+        if (f.endsWith(".wav") || f.endsWith(".mp3")) {
+          fs.unlinkSync(path.join(catDir, f));
+        }
+      }
+    }
+
+    // Copy files based on theme.json
+    const srcBase = path.join(tmpDir, "Orc");
+    for (const [category, config] of Object.entries(theme.sounds)) {
+      for (const file of config.files) {
+        let srcFile;
+        if (file.src.startsWith("@soundfxcenter/")) {
+          srcFile = path.join(srcBase, path.basename(file.src));
+        } else {
+          srcFile = path.join(srcBase, file.src);
+        }
+
+        const destFile = path.join(SOUNDS_DIR, category, file.name);
+        if (fs.existsSync(srcFile)) {
+          fs.copyFileSync(srcFile, destFile);
+        } else {
+          print(`    Warning: ${file.src} not found, skipping`);
+        }
+      }
+    }
+
+    // 4. Install hooks
+    print("  [4/4] Installing hooks...");
+
+    // Copy play-sound.sh
+    const hookSrc = path.join(PKG_DIR, "hooks", "play-sound.sh");
+    const hookDest = path.join(HOOKS_DIR, "play-sound.sh");
+    fs.copyFileSync(hookSrc, hookDest);
+    fs.chmodSync(hookDest, 0o755);
+
+    // Merge hooks into settings.json
+    const settings = readSettings();
+    settings.hooks = HOOKS_CONFIG;
+    writeSettings(settings);
+
+    // Summary
+    print("");
+    print("  Installed! Here's what you'll hear:");
+    print("  ─────────────────────────────────────");
+
+    let total = 0;
+    for (const [cat, config] of Object.entries(theme.sounds)) {
+      const count = config.files.length;
+      total += count;
+      print(`    ${cat} (${count}) — ${config.description}`);
+    }
+
+    print("");
+    print(`  ${total} sound files across ${categories.length} events.`);
+    print("  Start a new Claude Code session to hear it!");
+    print("");
+    print("  Zug zug.");
+    print("");
+  } finally {
+    // Cleanup
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  }
+}
+
+// ─── Main ────────────────────────────────────────────────────────────────────
+
+const args = process.argv.slice(2);
+const arg = args[0] || "wc3-peon";
+
+switch (arg) {
+  case "--help":
+  case "-h":
+    showHelp();
+    break;
+  case "--list":
+  case "-l":
+    showList();
+    break;
+  case "--uninstall":
+  case "--remove":
+    uninstall();
+    break;
+  default:
+    install(arg);
+}

package/hooks/play-sound.sh

@@ -0,0 +1,23 @@
+#!/bin/bash
+SOUNDS_DIR="$HOME/.claude/sounds"
+CATEGORY="${1:-}"
+
+# Drain stdin so the hook system doesn't get a broken pipe
+cat > /dev/null 2>&1
+
+[[ -z "$CATEGORY" ]] && exit 0
+DIR="$SOUNDS_DIR/$CATEGORY"
+[[ ! -d "$DIR" ]] && exit 0
+
+# Collect all .wav and .mp3 files
+FILES=()
+for f in "$DIR"/*.wav "$DIR"/*.mp3; do
+  [[ -f "$f" ]] && FILES+=("$f")
+done
+[[ ${#FILES[@]} -eq 0 ]] && exit 0
+
+# Pick a random file and play it in the background
+RANDOM_FILE="${FILES[$RANDOM % ${#FILES[@]}]}"
+afplay "$RANDOM_FILE" &
+
+exit 0

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "claude-code-sounds",
+  "version": "1.0.0",
+  "description": "Sound themes for Claude Code lifecycle hooks",
+  "bin": {
+    "claude-code-sounds": "bin/cli.js"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "sounds",
+    "hooks",
+    "warcraft",
+    "peon",
+    "soundboard"
+  ],
+  "author": "ryparker",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ryparker/claude-code-sounds.git"
+  },
+  "files": [
+    "bin/",
+    "hooks/",
+    "themes/",
+    "images/"
+  ],
+  "engines": {
+    "node": ">=16"
+  }
+}

package/themes/wc3-peon/download.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+#
+# Downloads sound files for the wc3-peon theme.
+# Called by install.sh with $1 = target sounds directory, $2 = temp directory.
+#
+set -e
+
+SOUNDS_DIR="$1"
+TMP_DIR="$2"
+
+echo "  Downloading WC3 Orc sounds..."
+ZIP="$TMP_DIR/orc-sounds.zip"
+curl -sL -o "$ZIP" "https://sounds.spriters-resource.com/media/assets/422/425494.zip?updated=1755544622"
+
+if ! file "$ZIP" | grep -q "Zip"; then
+  echo "  Error: Failed to download WC3 sound pack."
+  return 1
+fi
+
+unzip -qo "$ZIP" \
+  "Orc/Peon/*" "Orc/Grunt/*" "Orc/HeadHunter/*" "Orc/Shaman/*" \
+  "Orc/Hellscream/*" "Orc/HeroFarseer/*" "Orc/Tauren/*" "Orc/WitchDoctor/*" \
+  -d "$TMP_DIR"
+
+# Download supplemental clips not in the zip
+echo "  Downloading supplemental clips..."
+curl -sL -o "$TMP_DIR/Orc/more-work.mp3" \
+  "https://soundfxcenter.com/video-games/warcraft-2/8d82b5_Warcraft_2_Peasant_More_Work_Sound_Effect.mp3"
+
+echo "  Download complete."

package/themes/wc3-peon/theme.json

@@ -0,0 +1,117 @@
+{
+  "name": "WC3 Orc Peon",
+  "description": "Warcraft 3 Orc unit soundbites — Peons, Grunts, Shamans, and more",
+  "author": "ryparker",
+  "sounds": {
+    "start": {
+      "description": "Session starting — being summoned",
+      "files": [
+        { "src": "Peon/PeonReady1.wav", "name": "ready-to-work.wav" },
+        { "src": "Peon/PeonWhat4.wav", "name": "something-need-doing.wav" },
+        { "src": "Shaman/ShamanWhat3.wav", "name": "how-can-i-help.wav" },
+        { "src": "WitchDoctor/WitchDoctorReady1.wav", "name": "someone-call-for-the-doctor.wav" },
+        { "src": "@soundfxcenter/more-work.mp3", "name": "more-work.mp3" }
+      ]
+    },
+    "end": {
+      "description": "Session over — farewell",
+      "files": [
+        { "src": "Tauren/TaurenYes3.wav", "name": "well-done.wav" },
+        { "src": "Hellscream/GromYes3.wav", "name": "finally.wav" },
+        { "src": "Peon/PeonYes4.wav", "name": "okie-dokie.wav" }
+      ]
+    },
+    "permission": {
+      "description": "Permission prompt — what do you want to approve?",
+      "files": [
+        { "src": "Peon/PeonWhat2.wav", "name": "hmmm.wav" },
+        { "src": "Peon/PeonWhat3.wav", "name": "what-you-want.wav" },
+        { "src": "HeadHunter/HeadHunterWhat3.wav", "name": "what-you-want-me-to-do.wav" },
+        { "src": "HeadHunter/HeadHunterWhat1.wav", "name": "who-you-want-me-kill.wav" },
+        { "src": "WitchDoctor/WitchDoctorWhat3.wav", "name": "you-seek-me-help.wav" }
+      ]
+    },
+    "stop": {
+      "description": "Done responding — acknowledgment",
+      "files": [
+        { "src": "Peon/PeonYesAttack2.wav", "name": "zug-zug.wav" },
+        { "src": "Peon/PeonYesAttack1.wav", "name": "ok.wav" },
+        { "src": "Peon/PeonYes1.wav", "name": "i-can-do-that.wav" },
+        { "src": "Peon/PeonYes2.wav", "name": "be-happy-to.wav" },
+        { "src": "Shaman/ShamanYes2.wav", "name": "understood.wav" },
+        { "src": "HeroFarseer/HeroFarseerYes2.wav", "name": "of-course.wav" },
+        { "src": "HeroFarseer/HeroFarseerYes4.wav", "name": "it-is-certain.wav" },
+        { "src": "Hellscream/GromYes2.wav", "name": "whatever-you-say.wav" }
+      ]
+    },
+    "subagent": {
+      "description": "Spawning subagent — dispatching",
+      "files": [
+        { "src": "Peon/PeonYes3.wav", "name": "work-work.wav" },
+        { "src": "Grunt/GruntWarcry1.wav", "name": "for-the-horde.wav" },
+        { "src": "Hellscream/GromWarcry1.wav", "name": "taste-the-fury.wav" },
+        { "src": "Peon/PeonYesAttack3.wav", "name": "ill-try.wav" },
+        { "src": "Peon/PeonWarcry1.wav", "name": "why-not.wav" },
+        { "src": "Peon/PeonYesAttack2.wav", "name": "zug-zug.wav" }
+      ]
+    },
+    "idle": {
+      "description": "Waiting for input — bored and annoyed",
+      "files": [
+        { "src": "Peon/PeonAngry2.wav", "name": "me-busy-leave-me-alone.wav" },
+        { "src": "Peon/PeonAngry3.wav", "name": "no-time-for-play.wav" },
+        { "src": "Peon/PeonAngry4.wav", "name": "me-not-that-kind-of-orc.wav" },
+        { "src": "Grunt/GruntAngry1.wav", "name": "why-you-poking-me.wav" },
+        { "src": "Grunt/GruntAngry7.wav", "name": "not-easy-being-green.wav" },
+        { "src": "Hellscream/GromWhat3.wav", "name": "i-can-wait-no-longer.wav" },
+        { "src": "HeroFarseer/HeroFarseerAngry4.wav", "name": "outlook-not-so-good.wav" }
+      ]
+    },
+    "error": {
+      "description": "Tool failure — something broke",
+      "files": [
+        { "src": "Peon/PeonDeath.wav", "name": "peon-death.wav" },
+        { "src": "Grunt/GruntDeath.wav", "name": "grunt-death.wav" },
+        { "src": "HeadHunter/HeadHunterDeath.wav", "name": "headhunter-death.wav" },
+        { "src": "HeroFarseer/HeroFarseerAngry5.wav", "name": "reply-hazy-try-again.wav" }
+      ]
+    },
+    "prompt": {
+      "description": "User submitted prompt — acknowledging order",
+      "files": [
+        { "src": "Peon/PeonWhat1.wav", "name": "yes.wav" },
+        { "src": "Grunt/GruntYes1.wav", "name": "dabu.wav" },
+        { "src": "Grunt/GruntYes4.wav", "name": "zug-zug.wav" },
+        { "src": "Shaman/ShamanYes4.wav", "name": "right-away.wav" },
+        { "src": "Tauren/TaurenYes2.wav", "name": "immediately.wav" },
+        { "src": "HeadHunter/HeadHunterYes2.wav", "name": "anything-you-want.wav" },
+        { "src": "@soundfxcenter/more-work.mp3", "name": "more-work.mp3" }
+      ]
+    },
+    "task-completed": {
+      "description": "Task finished — victory",
+      "files": [
+        { "src": "Tauren/TaurenYes3.wav", "name": "well-done.wav" },
+        { "src": "Hellscream/GromYes3.wav", "name": "finally.wav" }
+      ]
+    },
+    "compact": {
+      "description": "Context compaction — memory fading",
+      "files": [
+        { "src": "HeroFarseer/HeroFarseerAngry3.wav", "name": "concentrate-and-ask-again.wav" },
+        { "src": "HeroFarseer/HeroFarseerAngry5.wav", "name": "reply-hazy-try-again.wav" },
+        { "src": "Peon/PeonDeath.wav", "name": "death.wav" },
+        { "src": "Hellscream/GromWhat3.wav", "name": "i-can-wait-no-longer.wav" }
+      ]
+    },
+    "teammate-idle": {
+      "description": "Teammate went idle — impatient",
+      "files": [
+        { "src": "Peon/PeonAngry1.wav", "name": "what.wav" },
+        { "src": "Peon/PeonAngry2.wav", "name": "me-busy-leave-me-alone.wav" },
+        { "src": "Peon/PeonAngry3.wav", "name": "no-time-for-play.wav" },
+        { "src": "Hellscream/GromWhat3.wav", "name": "i-can-wait-no-longer.wav" }
+      ]
+    }
+  }
+}