klaudio 0.9.0 → 0.9.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "klaudio",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Add sound effects to your coding sessions — play sounds when tasks complete, notifications arrive, and more",
   "type": "module",
   "bin": {

package/src/installer.js

@@ -60,6 +60,12 @@ export async function install({ scope, sounds, tts = false }) {
     const event = EVENTS[eventId];
     if (!event) continue;
 
+    // Approval event uses a PreToolUse/PostToolUse timer instead of a direct hook
+    if (eventId === "approval") {
+      await installApprovalHooks(settings, soundPath, claudeDir);
+      continue;
+    }
+
     const hookEvent = event.hookEvent;
     // Enable TTS only for the "stop" event (task complete)
     const useTts = tts && eventId === "stop";
@@ -101,6 +107,64 @@ export async function install({ scope, sounds, tts = false }) {
   };
 }
 
+/**
+ * Install approval notification hooks (PreToolUse/PostToolUse timer).
+ * Writes a helper script and hooks that play a sound after 15s if no approval.
+ */
+async function installApprovalHooks(settings, soundPath, claudeDir) {
+  const normalized = soundPath.replace(/\\/g, "/");
+  const scriptPath = join(claudeDir, "approval-notify.sh").replace(/\\/g, "/");
+
+  // Write the timer script
+  const script = `#!/usr/bin/env bash
+# klaudio: approval notification timer
+# Plays a sound if a tool isn't approved within DELAY seconds.
+DELAY=15
+MARKER="/tmp/.claude-approval-pending"
+SOUND="${normalized}"
+
+case "$1" in
+  start)
+    TOKEN="$$-$(date +%s%N)"
+    echo "$TOKEN" > "$MARKER"
+    (
+      sleep "$DELAY"
+      if [ -f "$MARKER" ] && [ "$(cat "$MARKER" 2>/dev/null)" = "$TOKEN" ]; then
+        rm -f "$MARKER"
+        npx klaudio play "$SOUND" 2>/dev/null
+      fi
+    ) &
+    ;;
+  cancel)
+    rm -f "$MARKER"
+    ;;
+esac
+`;
+  await writeFile(scriptPath, script, "utf-8");
+
+  // Add PreToolUse hook
+  if (!settings.hooks.PreToolUse) settings.hooks.PreToolUse = [];
+  settings.hooks.PreToolUse = settings.hooks.PreToolUse.filter(
+    (e) => !e._klaudio && !e._klonk
+  );
+  settings.hooks.PreToolUse.push({
+    _klaudio: true,
+    matcher: "",
+    hooks: [{ type: "command", command: `bash "${scriptPath}" start` }],
+  });
+
+  // Add PostToolUse hook
+  if (!settings.hooks.PostToolUse) settings.hooks.PostToolUse = [];
+  settings.hooks.PostToolUse = settings.hooks.PostToolUse.filter(
+    (e) => !e._klaudio && !e._klonk
+  );
+  settings.hooks.PostToolUse.push({
+    _klaudio: true,
+    matcher: "",
+    hooks: [{ type: "command", command: `bash "${scriptPath}" cancel` }],
+  });
+}
+
 /**
  * Install hooks for GitHub Copilot coding agent.
  * Writes .github/hooks/klaudio.json in the Copilot format.
@@ -168,9 +232,23 @@ export async function getExistingSounds(scope) {
     if (!settings.hooks) return sounds;
 
     for (const [eventId, event] of Object.entries(EVENTS)) {
+      // Approval event: read sound from the approval-notify.sh script
+      if (eventId === "approval") {
+        const scriptPath = join(claudeDir, "approval-notify.sh");
+        try {
+          const script = await readFile(scriptPath, "utf-8");
+          const m = script.match(/SOUND="([^"]+\.(wav|mp3|ogg|flac|aac))"/);
+          if (m) {
+            sounds[eventId] = m[1].replace(/\//g, join("a", "b").includes("\\") ? "\\" : "/");
+          }
+        } catch { /* no script */ }
+        continue;
+      }
+
       const hookEntries = settings.hooks[event.hookEvent];
       if (!hookEntries) continue;
-      const entry = hookEntries.find((e) => e._klaudio || e._klonk);
+      const entry = hookEntries.find((e) => e._klaudio || e._klonk
+        || e.hooks?.[0]?.command?.includes("klaudio"));
       if (!entry?.hooks?.[0]?.command) continue;
 
       // Extract file path from the play command

package/src/player.js

@@ -403,8 +403,9 @@ export async function handlePlayCommand(args) {
       .replace(/_([^_]+)_/g, "$1")          // _italic_ -> text
       .replace(/#{1,6}\s+/g, "")            // headings
       .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1") // [links](url) -> text
-      .replace(/^\s*[-*+]\s+/gm, "")        // list bullets
-      .replace(/^\s*\d+\.\s+/gm, "")        // numbered lists
+      .replace(/\([^)]*\)/g, "")           // remove parenthesised content
+      .replace(/^\s*[-*+]\s+(.*)/gm, "... $1.") // list bullets -> paused items
+      .replace(/^\s*\d+\.\s+(.*)/gm, "... $1.") // numbered lists -> paused items
       .replace(/\n+/g, " ")                 // newlines -> spaces
       .trim();
     // Build summary: include sentences up to ~25 words max.
@@ -430,12 +431,14 @@ export async function handlePlayCommand(args) {
         }
         // Include next sentence if we're still under the word limit
         if (wordsSoFar + nextWords <= MAX_WORDS) {
-          summary += " " + next;
+          summary += " ... " + next;
         } else {
           break;
         }
       }
     }
+    // Collapse repeated ellipsis/dots and ensure pauses between sentences
+    summary = summary.replace(/\.{2,}/g, "...").replace(/\s{2,}/g, " ");
     // Prefix with project folder name if available
     const project = hookData.cwd ? hookData.cwd.replace(/\\/g, "/").split("/").pop() : null;
     const spoken = project ? `${project}: ${summary}` : summary;

package/src/presets.js

@@ -14,7 +14,7 @@ const SOUNDS_DIR = isCompiledBinary
 export const EVENTS = {
   notification: {
     name: "Notification",
-    description: "Plays when Claude needs your attention",
+    description: "Plays when Claude sends a notification (e.g. long task finished in background)",
     hookEvent: "Notification",
     copilotHookEvent: null, // Copilot doesn't have this yet
   },
@@ -24,6 +24,12 @@ export const EVENTS = {
     hookEvent: "Stop",
     copilotHookEvent: "sessionEnd",
   },
+  approval: {
+    name: "Waiting for Approval",
+    description: "Plays when Claude waits for you to approve an action",
+    hookEvent: null, // Uses PreToolUse/PostToolUse timer, not a direct hook
+    copilotHookEvent: null,
+  },
 };
 
 /**
@@ -37,6 +43,7 @@ export const PRESETS = {
     sounds: {
       stop: join(SOUNDS_DIR, "retro-8bit", "stop.wav"),
       notification: join(SOUNDS_DIR, "retro-8bit", "notification.wav"),
+      approval: join(SOUNDS_DIR, "retro-8bit", "notification.wav"),
     },
   },
   "minimal-zen": {
@@ -46,6 +53,7 @@ export const PRESETS = {
     sounds: {
       stop: join(SOUNDS_DIR, "minimal-zen", "stop.wav"),
       notification: join(SOUNDS_DIR, "minimal-zen", "notification.wav"),
+      approval: join(SOUNDS_DIR, "minimal-zen", "notification.wav"),
     },
   },
   "sci-fi-terminal": {
@@ -55,6 +63,7 @@ export const PRESETS = {
     sounds: {
       stop: join(SOUNDS_DIR, "sci-fi-terminal", "stop.wav"),
       notification: join(SOUNDS_DIR, "sci-fi-terminal", "notification.wav"),
+      approval: join(SOUNDS_DIR, "sci-fi-terminal", "notification.wav"),
     },
   },
   "victory-fanfare": {
@@ -64,6 +73,7 @@ export const PRESETS = {
     sounds: {
       stop: join(SOUNDS_DIR, "victory-fanfare", "stop.wav"),
       notification: join(SOUNDS_DIR, "victory-fanfare", "notification.wav"),
+      approval: join(SOUNDS_DIR, "victory-fanfare", "notification.wav"),
     },
   },
 };

package/src/tts.js

@@ -220,6 +220,7 @@ export async function speak(text, onProgress) {
       const child = execFile(piperBin, [
         "--model", modelPath,
         "--output_file", outPath,
+        "--sentence_silence", "0.5",
       ], { windowsHide: true, timeout: 15000 }, (err) => {
         if (err) reject(err);
         else resolve();