fix: install kokoro TTS deps with agent-session-tools, warn on fallback

install.sh now installs agent-session-tools with [tts] extras, which
includes kokoro-onnx and sounddevice. Previously these were missing
from the tool venv, causing silent fallback to macOS say.

speak.py now prints a warning when kokoro backend is configured but
unavailable, instead of silently falling back. This makes it obvious
why voice quality is degraded.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: taylaand

packages/agent-session-tools/src/agent_session_tools/speak.py

@@ -170,6 +170,12 @@ def speak(
         return
 
     # Fallback chain: kokoro → macos
+    if backend == "kokoro":
+        typer.echo(
+            "⚠ Kokoro TTS not available — falling back to macOS say. "
+            "Install TTS deps: uv tool install './packages/agent-session-tools[tts]' --force",
+            err=True,
+        )
     if backend != "kokoro" and _speak_kokoro(text, voice=voice, speed=speed):
         return
     _speak_macos(text, voice=macos_voice)

scripts/install.sh

@@ -97,9 +97,16 @@ fi
 step "Installing CLI tools globally"
 for pkg in "${REPO_DIR}"/packages/*/; do
   pkg_name=$(basename "$pkg")
-  uv tool install "$pkg" --editable --force 2>&1 | while read -r line; do
-    echo "  $line"
-  done
+  # Include TTS extras for agent-session-tools (kokoro voice output)
+  if [ "$pkg_name" = "agent-session-tools" ]; then
+    uv tool install "${pkg}[tts]" --editable --force 2>&1 | while read -r line; do
+      echo "  $line"
+    done
+  else
+    uv tool install "$pkg" --editable --force 2>&1 | while read -r line; do
+      echo "  $line"
+    done
+  fi
 done
 info "CLI tools installed (studyctl, session-export, session-query, session-sync, session-maint, tutor-checkpoint, study-speak)"