Adom TTS: Text to Speech

⋯ 1 unchanged line ⋯

@@ -1,6 +1,6 @@ {   "slug": "adom-tts",-  "version": "1.9.32",+  "version": "1.9.33",   "type": "app",   "description": "Adom's shared text-to-speech CLI + Playground. Reads your AI answers back to you while driving, and renders perfectly-timed voiceover tracks for demo videos.",   "license": "MIT",

@@ -4,7 +4,7 @@   "slug": "adom-tts",   "title": "Adom TTS — Text to Speech",   "brief": "Adom's shared voice service. Reads your AI's answers back to you while you drive, and renders perfectly-timed voiceover tracks for your demo videos — so you never record your own voice.",-  "version": "1.9.32",+  "version": "1.9.33",   "license": "MIT",   "tags": [     "tts",@@ -12,6 +12,7 @@     "audio",     "demo",     "accessibility",+    "cli",     "open-source",     "mit"   ],@@ -64,5 +65,25 @@   ],   "install": {     "binary_name": "adom-tts"+  },+  "description": "Adom's shared text-to-speech CLI + Playground. Reads your AI answers back to you while driving, and renders perfectly-timed voiceover tracks for demo videos.",+  "dependencies": {},+  "scripts": {+    "install": "./install.sh",+    "uninstall": "./uninstall.sh"+  },+  "needs_sudo": false,+  "files": [+    "package.json",+    "install.sh",+    "uninstall.sh",+    "bin/adom-tts",+    "skills/**",+    "completions/**"+  ],+  "org": "adom",+  "author": {+    "name": "John Lauer",+    "email": "[email protected]"   } }\ No newline at end of file

@@ -116,12 +116,22 @@ adom-tts say "Generic sentence" --out g.mp3 --no-pronunciations --play **Default to the hydrogen webview surface. Only use `--surface pup` when the user explicitly asks for it.** The default (no `--surface`) is the hydrogen webview and it is the reliable path — proven end-to-end. Pup is more fragile:-its window can strand on a stale port and, with more than one Adom Desktop on-the relay, its window is ambiguous and won't open. So do NOT auto-route a+with more than one Adom Desktop on the relay its window is ambiguous and can't+auto-open (the tool tells you which desktops it sees). So do NOT auto-route a "pup window_mode" user into `--surface pup`; just narrate on the default surface. If you DO need pup (user asked), first `export ADOM_DESKTOP_TARGET=<host>`-(the desktop the human is at); if a clip comes back `surface-unavailable`,-re-send WITHOUT `--surface pup`.+(the desktop the human is at). The tool self-surfaces — you NEVER hand-open a+URL: the drainer opens the player itself, and `adom-tts reopen` re-surfaces the+SAME surface (a pup drainer re-opens a pup window, hydrogen re-offers its tab),+both bound to the live player port. If a clip still comes back+`surface-unavailable`, the message NAMES the live player-page URL and says to+re-send WITHOUT `--surface pup` — do that; hydrogen is reliable.++**Two different URLs — never confuse them.** `adom-tts config` prints a+`service url` (the TTS API, where audio is synthesized — NOT a page to open) and+a `player page` (the live proxy URL at the current port — THIS is what shows the+player). Opening the service URL shows nothing; if you ever need to eyeball the+player, use the `player page` line.  **NEVER install a local TTS engine as a fallback.** If `adom-tts` exits non-zero — `adom-tts: unreachable` (exit 2) or `HTTP <status>` (exit 4) — or