@mcptoolshop/voice-soundboard-mcp 1.0.1 → 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,172 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.2] - 2026-03-25
+
+### Added
+- `--version` / `-V` flag to print version and exit
+- `--help` / `-h` flag with full CLI usage documentation
+- CHANGELOG.md and LICENSE included in npm tarballs
+
+### Fixed
+- Health endpoint version was hardcoded at 0.1.2 — now reads from package.json
+- SECURITY.md version table updated from 0.x to 1.0.x
+
+## [1.0.0] - 2026-02-27
+
+### Overview
+
+**First stable release.** Structured error contract, Ship Gate audit (46/50), version alignment, and v1 README.
+
+### Added
+
+- **Structured error contract** — all errors now carry `hint` (actionable guidance) and `retryable` (safe to retry?) fields
+- `SoundboardError` base class in core — extends `Error` with `code`, `hint`, `retryable`, `cause`
+- `fromError()` helper — converts any caught error into a `VoiceErrorResponse`, extracting hint + retryable from `SoundboardError` subclasses
+- `toToolError()` pattern in MCP server — converts errors into MCP tool error responses with structured fields, never exposes stack traces
+- `wrapError()` utility — wraps unknown thrown values into `SoundboardError`
+- `pnpm verify` script (build + test in one command)
+- Explicit "No telemetry" privacy statement in README
+- SHIP_GATE.md and SCORECARD.md for product quality tracking
+
+### Changed
+
+- All 11 error classes across core and server now extend `SoundboardError`
+- `VoiceErrorResponse` schema now includes `hint: string` and `retryable: boolean`
+- `voiceSpeak` and `voiceDialogue` handlers migrated from manual `instanceof` chains to `fromError()`
+- Golden-contract tests now verify `hint` and `retryable` fields in error responses
+- MCP server version string aligned with package version
+- Repo description and topics updated (48 voices, 9 languages)
+
+### Fixed
+
+- MCP handshake version was stuck at `0.2.1` — now aligned at `1.0.0`
+- Error responses from `BusyError`, `RateLimitError`, `TimeoutError` now correctly report `retryable: true`
+- Stale v2.x git tags deleted
+- Dependabot cleaned (removed stale pip ecosystem entry)
+
+## [0.2.1] - 2026-02-18
+
+### Fixed
+
+- README in `@mcptoolshop/voice-soundboard-core` npm tarball still showed 12 voices — corrected to 48 voices, 9 languages
+- Broken Development section in root README (stray `> Part of MCP Tool Shop` line inside code block)
+
+## [0.2.0] - 2026-02-18
+
+### Overview
+
+**Multilingual expansion** — 48 voices across 9 languages.
+
+### Added
+
+- **48 voices** — expanded from 12 English-only to 48 across 9 languages
+- **9 languages** — English US, English UK, Japanese, Mandarin Chinese, Spanish, French, Hindi, Italian, Brazilian Portuguese
+- **`getVoicesByLanguage(language)`** — new helper in `@mcptoolshop/voice-soundboard-core` to filter voices by language code
+- Language is auto-inferred by the synthesis backend from the voice ID prefix — no caller changes required
+
+### Changed
+
+- `VoiceInfo.accent` field widened from `"american" | "british"` to `string` to accommodate new languages
+- `VoiceInfo.language` values now use BCP-47 style codes (`"en-us"`, `"en-gb"`, `"ja"`, `"zh"`, etc.) instead of `"en"`
+- Server version string updated to `0.2.0`
+- Package descriptions updated to reflect 48 voices and 9 languages
+
+---
+
+## [0.1.0] - 2026-02-13
+
+### Overview
+
+**Initial release** — Node.js/TypeScript MCP server for text-to-speech.
+
+Complete rewrite from the original Python prototype into a pnpm monorepo with two
+publishable npm packages: `@mcp-tool-shop/voice-soundboard-core` and
+`@mcp-tool-shop/voice-soundboard-mcp`.
+
+### Packages
+
+- **@mcp-tool-shop/voice-soundboard-core** (v0.1.0) — Backend-agnostic core library
+- **@mcp-tool-shop/voice-soundboard-mcp** (v0.1.0) — MCP server with CLI
+
+### Added
+
+#### MCP Tools
+- `voice_speak` — Synthesize speech from text with voice, speed, format options
+- `voice_dialogue` — Multi-speaker dialogue synthesis with cast mapping
+- `voice_status` — Engine health, available voices, presets, backend info
+- `voice_interrupt` — Stop/rollback active synthesis
+- `voice_inner_monologue` — Ephemeral micro-utterances (ambient system, opt-in)
+
+#### Core Features
+- 12 approved voices (4 American female, 4 American male, 3 British female, 2 British male)
+- 5 voice presets (narrator, announcer, whisper, storyteller, assistant)
+- 8 emotion spans via `[happy]...[/happy]` inline markup
+- SSML-lite parser (`<break>`, `<emphasis>`, `<prosody>`)
+- SFX tags (`[ding]`, `[chime]`, `[whoosh]`, `[tada]`, `[error]`, `[click]`)
+- Text chunking with sentence/paragraph boundaries
+- WAV concatenation for multi-segment output
+- Base64 and file-path artifact delivery modes
+- Output directory sandboxing with path traversal protection
+
+#### Security & Guardrails
+- `SynthesisSemaphore` &mdash; configurable max concurrent synthesis (default 1)
+- `ToolRateLimiter` &mdash; per-tool sliding window rate limit (30 calls/60s)
+- `withTimeout` &mdash; per-request timeout (default 20s)
+- Path traversal protection (resolveOutputDir with symlink checks)
+- Secret/PII redaction in logs and error messages
+- Synthesis result validation (WAV header, duration, file size)
+- Output file retention cleanup (default 4 hours)
+
+#### Backend System
+- `Backend` interface with `synthesize()`, `voices()`, `health()`
+- MockBackend (built-in, deterministic WAV generation)
+- HTTP proxy backend (delegate to external TTS service)
+- Python bridge backend (connect to Python Kokoro/Piper engines)
+
+#### Developer Experience
+- 342 tests (252 core + 90 server)
+- Abuse battery (adversarial input testing)
+- CI pipeline: Node.js 20+22 matrix, type-check, npm pack dry-run
+- Dependabot for npm dependency updates
+- Architecture invariant enforcement (engine never imports compiler)
+
+### Architecture
+
+```
+@mcp-tool-shop/voice-soundboard-core
+  limits.ts       SHIP_LIMITS consolidation
+  schemas.ts      VoiceRequest, VoiceResponse, error codes
+  voices.ts       Approved voice registry + presets
+  emotion.ts      Emotion span parser
+  ssml/           SSML-lite parser
+  chunking/       Text chunker
+  sfx/            SFX tag parser
+  artifact.ts     Output directory sandboxing
+  sandbox.ts      Safe filenames, symlink checks
+  ambient.ts      AmbientEmitter
+  redact.ts       PII/secret redaction
+
+@mcp-tool-shop/voice-soundboard-mcp
+  server.ts       MCP tool registration + guardrails
+  cli.ts          CLI entrypoint (stdio transport)
+  backend.ts      Backend abstraction
+  concurrency.ts  SynthesisSemaphore
+  rateLimit.ts    ToolRateLimiter
+  timeout.ts      withTimeout
+  retention.ts    Output cleanup timer
+  validation.ts   Result validation
+  redact.ts       Server-level redaction
+```
+
+---
+
+## Pre-0.1.0 (Python)
+
+The original Python implementation (`voice_soundboard/`) with Compiler-Graph-Engine
+architecture is preserved in the repository but is not part of the npm packages.
+See git history for the full Python changelog.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mcp-tool-shop
+
+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

@@ -17,7 +17,7 @@
 </p>
 
 <p align="center">
-  48 voices &bull; 9 languages &bull; 5 presets &bull; 8 emotions &bull; SSML-lite &bull; SFX tags &bull; multi-speaker dialogue<br>
+  46 voices &bull; 9 languages &bull; 5 presets &bull; 8 emotions &bull; SSML-lite &bull; SFX tags &bull; multi-speaker dialogue<br>
   Swappable TTS backends. Guardrails built in. Ships as a single <code>npx</code> command.
 </p>
 
@@ -27,7 +27,7 @@
 
 - **MCP native** &mdash; stdio transport, works with Claude Desktop, Cursor, and any MCP client
 - **5 tools** &mdash; `voice_speak`, `voice_dialogue`, `voice_status`, `voice_interrupt`, `voice_inner_monologue`
-- **48 approved voices, 9 languages** &mdash; English (American + British), Japanese, Mandarin, Spanish, French, Hindi, Italian, Brazilian Portuguese. Curated presets: `narrator`, `announcer`, `whisper`, `storyteller`, `assistant`
+- **46 approved voices, 9 languages** &mdash; English (American + British), Japanese, Mandarin, Spanish, French, Hindi, Italian, Brazilian Portuguese. Curated presets: `narrator`, `announcer`, `whisper`, `storyteller`, `assistant`
 - **Emotion spans** &mdash; 8 emotions via `[happy]...[/happy]` inline markup
 - **SSML-lite** &mdash; `<break>`, `<emphasis>`, `<prosody>` without full SSML complexity
 - **SFX tags** &mdash; `[ding]`, `[chime]`, `[whoosh]`, `[tada]`, `[error]`, `[click]` inline sound effects
@@ -133,7 +133,7 @@ category?:    "thinking"           # general | thinking | observation | debug
 
 ## Voices
 
-48 voices across 9 languages. Language is auto-inferred from the voice ID prefix — no configuration required.
+46 voices across 9 languages. Language is auto-inferred from the voice ID prefix — no configuration required.
 
 | Prefix | Language |
 |--------|----------|

package/backend-python/soundboard_bridge/__main__.py

@@ -0,0 +1,200 @@
+"""
+Voice Soundboard Python Bridge — NDJSON stdio protocol.
+
+Auto-downloads Kokoro ONNX model + voices on first run.
+Communicates with the Node.js MCP server via newline-delimited JSON on stdin/stdout.
+
+Protocol:
+  IN:  {"id": "...", "op": "health"}
+  OUT: {"id": "...", "ok": true, "model": "kokoro-v0.19"}
+
+  IN:  {"id": "...", "op": "synthesize", "text": "Hello", "voice": "af_bella", "speed": 1.0,
+        "format": "wav", "artifact_mode": "base64"}
+  OUT: {"id": "...", "ok": true, "audio_bytes_base64": "...", "duration_ms": 1234,
+        "sample_rate": 24000, "format": "wav"}
+
+  IN:  {"id": "...", "op": "interrupt"}
+  OUT: {"id": "...", "ok": true}
+"""
+
+import json
+import sys
+import io
+import base64
+import struct
+import os
+
+
+GITHUB_RELEASE = "https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0"
+MODEL_FILE = "kokoro-v1.0.onnx"
+VOICES_FILE = "voices-v1.0.bin"
+
+
+def ensure_deps():
+    """Install kokoro-onnx if missing."""
+    try:
+        import kokoro_onnx  # noqa: F401
+    except ImportError:
+        import subprocess
+        print("[bridge] Installing kokoro-onnx...", file=sys.stderr)
+        subprocess.check_call(
+            [sys.executable, "-m", "pip", "install", "--user", "-q", "kokoro-onnx"],
+            stdout=sys.stderr,
+            stderr=sys.stderr,
+        )
+
+
+def download_file(url: str, dest: str):
+    """Download a file with progress."""
+    import urllib.request
+    filename = os.path.basename(dest)
+    print(f"[bridge] Downloading {filename}...", file=sys.stderr)
+    urllib.request.urlretrieve(url, dest)
+    size_mb = os.path.getsize(dest) / (1024 * 1024)
+    print(f"[bridge] Downloaded {filename} ({size_mb:.0f} MB)", file=sys.stderr)
+
+
+def download_model():
+    """Download Kokoro ONNX model + voices from GitHub releases. Returns (model_path, voices_path)."""
+    cache_dir = os.path.join(os.path.expanduser("~"), ".cache", "voice-soundboard")
+    os.makedirs(cache_dir, exist_ok=True)
+
+    model_path = os.path.join(cache_dir, MODEL_FILE)
+    voices_path = os.path.join(cache_dir, VOICES_FILE)
+
+    if not os.path.exists(model_path):
+        download_file(f"{GITHUB_RELEASE}/{MODEL_FILE}", model_path)
+
+    if not os.path.exists(voices_path):
+        download_file(f"{GITHUB_RELEASE}/{VOICES_FILE}", voices_path)
+
+    print(f"[bridge] Model ready: {model_path}", file=sys.stderr)
+    return model_path, voices_path
+
+
+def pcm_to_wav(samples, sample_rate: int) -> bytes:
+    """Convert float32 numpy array to WAV bytes."""
+    import numpy as np
+
+    # Clamp and convert to 16-bit PCM
+    pcm = np.clip(samples, -1.0, 1.0)
+    pcm = (pcm * 32767).astype(np.int16)
+    raw = pcm.tobytes()
+
+    # Build WAV header
+    buf = io.BytesIO()
+    num_channels = 1
+    bits_per_sample = 16
+    byte_rate = sample_rate * num_channels * bits_per_sample // 8
+    block_align = num_channels * bits_per_sample // 8
+    data_size = len(raw)
+
+    buf.write(b"RIFF")
+    buf.write(struct.pack("<I", 36 + data_size))
+    buf.write(b"WAVE")
+    buf.write(b"fmt ")
+    buf.write(struct.pack("<I", 16))
+    buf.write(struct.pack("<H", 1))  # PCM
+    buf.write(struct.pack("<H", num_channels))
+    buf.write(struct.pack("<I", sample_rate))
+    buf.write(struct.pack("<I", byte_rate))
+    buf.write(struct.pack("<H", block_align))
+    buf.write(struct.pack("<H", bits_per_sample))
+    buf.write(b"data")
+    buf.write(struct.pack("<I", data_size))
+    buf.write(raw)
+
+    return buf.getvalue()
+
+
+def main():
+    ensure_deps()
+
+    from kokoro_onnx import Kokoro
+
+    model_path, voices_path = download_model()
+    kokoro = Kokoro(model_path, voices_path)
+    available_voices = kokoro.get_voices()
+
+    print(f"[bridge] Ready — {len(available_voices)} voices available", file=sys.stderr)
+
+    for line in sys.stdin:
+        line = line.strip()
+        if not line:
+            continue
+
+        try:
+            msg = json.loads(line)
+        except json.JSONDecodeError:
+            continue
+
+        req_id = msg.get("id")
+        op = msg.get("op")
+
+        if op == "health":
+            resp = {"id": req_id, "ok": True, "model": "kokoro-v1.1-onnx", "voices": len(available_voices)}
+            sys.stdout.write(json.dumps(resp) + "\n")
+            sys.stdout.flush()
+
+        elif op == "synthesize":
+            try:
+                text = msg.get("text", "")
+                voice = msg.get("voice", "af_bella")
+                speed = float(msg.get("speed", 1.0))
+                artifact_mode = msg.get("artifact_mode", "base64")
+
+                # Validate voice
+                if voice not in available_voices:
+                    # Try partial match
+                    matches = [v for v in available_voices if v.startswith(voice)]
+                    voice = matches[0] if matches else available_voices[0]
+
+                samples, sample_rate = kokoro.create(text, voice=voice, speed=speed)
+                wav_bytes = pcm_to_wav(samples, sample_rate)
+                duration_ms = int(len(samples) / sample_rate * 1000)
+
+                if artifact_mode == "base64":
+                    resp = {
+                        "id": req_id,
+                        "ok": True,
+                        "audio_bytes_base64": base64.b64encode(wav_bytes).decode(),
+                        "duration_ms": duration_ms,
+                        "sample_rate": sample_rate,
+                        "format": "wav",
+                    }
+                else:
+                    output_dir = msg.get("output_dir", os.path.join(os.path.expanduser("~"), ".voice-soundboard"))
+                    os.makedirs(output_dir, exist_ok=True)
+                    import uuid
+                    audio_path = os.path.join(output_dir, f"vsmcp_{uuid.uuid4().hex[:8]}.wav")
+                    with open(audio_path, "wb") as f:
+                        f.write(wav_bytes)
+                    resp = {
+                        "id": req_id,
+                        "ok": True,
+                        "audio_path": audio_path,
+                        "duration_ms": duration_ms,
+                        "sample_rate": sample_rate,
+                        "format": "wav",
+                    }
+
+                sys.stdout.write(json.dumps(resp) + "\n")
+                sys.stdout.flush()
+
+            except Exception as e:
+                resp = {
+                    "id": req_id,
+                    "ok": False,
+                    "error": {"code": "SYNTHESIS_FAILED", "message": str(e)},
+                }
+                sys.stdout.write(json.dumps(resp) + "\n")
+                sys.stdout.flush()
+
+        elif op == "interrupt":
+            resp = {"id": req_id, "ok": True}
+            sys.stdout.write(json.dumps(resp) + "\n")
+            sys.stdout.flush()
+
+
+if __name__ == "__main__":
+    main()

package/dist/backend.d.ts

@@ -62,6 +62,7 @@ export declare class MockBackend implements Backend {
     readonly model = "mock-silence";
     readonly sampleRate = 24000;
     health(): Promise<BackendHealth>;
+    interrupt(): Promise<void>;
     synthesize(request: SynthesisRequest): Promise<SynthesisResult>;
 }
 //# sourceMappingURL=backend.d.ts.map

package/dist/backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAOzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAI3E,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IACjC,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAChE,SAAS,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAID,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAqB/D;AAWD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAoD3E;AAID,qBAAa,WAAY,YAAW,OAAO;IACzC,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,QAAQ,CAAC,KAAK,SAAS;IAEjB,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IAIhC,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC;CAG7C;AAyCD,qBAAa,WAAY,YAAW,OAAO;IACzC,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,QAAQ,CAAC,KAAK,QAAQ;IACtB,QAAQ,CAAC,KAAK,kBAAkB;IAChC,QAAQ,CAAC,UAAU,SAAS;IAEtB,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IAIhC,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;CAwBtE"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAOzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAI3E,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IACjC,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAChE,SAAS,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAID,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CA2B/D;AAWD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAwD3E;AAID,qBAAa,WAAY,YAAW,OAAO;IACzC,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,QAAQ,CAAC,KAAK,SAAS;IAEjB,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IAIhC,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC;CAG7C;AAyCD,qBAAa,WAAY,YAAW,OAAO;IACzC,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,QAAQ,CAAC,KAAK,QAAQ;IACtB,QAAQ,CAAC,KAAK,kBAAkB;IAChC,QAAQ,CAAC,UAAU,SAAS;IAEtB,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IAIhC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;CAwBtE"}

package/dist/backend.js

@@ -17,12 +17,18 @@ export function readBackendConfig(argv) {
         }
     }
     // Env vars (lower precedence than explicit flags)
-    config.ttsUrl = process.env.VOICE_SOUNDBOARD_TTS_URL;
+    // VOICE_SOUNDBOARD_TTS_URL is canonical; VOICE_SOUNDBOARD_HTTP_URL is an alias (DX-015)
+    config.ttsUrl = process.env.VOICE_SOUNDBOARD_TTS_URL
+        ?? process.env.VOICE_SOUNDBOARD_HTTP_URL;
     config.ttsToken = process.env.VOICE_SOUNDBOARD_TTS_TOKEN;
     config.pythonCommand = process.env.VOICE_SOUNDBOARD_PYTHON;
     config.pythonModule = process.env.VOICE_SOUNDBOARD_PYTHON_MODULE;
     if (process.env.VOICE_SOUNDBOARD_HTTP_TIMEOUT) {
-        config.httpTimeout = parseInt(process.env.VOICE_SOUNDBOARD_HTTP_TIMEOUT, 10);
+        const parsed = parseInt(process.env.VOICE_SOUNDBOARD_HTTP_TIMEOUT, 10);
+        // MCP-010: Guard against NaN from invalid env var
+        if (Number.isFinite(parsed) && parsed > 0) {
+            config.httpTimeout = parsed;
+        }
     }
     return config;
 }
@@ -49,7 +55,7 @@ export async function selectBackend(config) {
         switch (config.backend) {
             case "mock":
                 return new MockBackend();
-            case "http":
+            case "http": {
                 // Lazy import to avoid loading HTTP backend when not needed
                 const { HttpBackend } = await import("./backends/httpBackend.js");
                 return new HttpBackend({
@@ -57,6 +63,7 @@ export async function selectBackend(config) {
                     token: config.ttsToken,
                     timeout: config.httpTimeout,
                 });
+            }
             case "python": {
                 const { PythonBackend } = await import("./backends/pythonBackend.js");
                 const pyBackend = new PythonBackend({
@@ -69,6 +76,9 @@ export async function selectBackend(config) {
             }
             case "none":
                 return new NoneBackend();
+            default:
+                // MCP-009: Reject unrecognized backend types
+                throw new Error(`Unknown backend type: ${JSON.stringify(config.backend)}. Valid types: mock, http, python, none`);
         }
     }
     // Auto-detect: HTTP URL set?
@@ -158,6 +168,9 @@ export class MockBackend {
     async health() {
         return { ready: true, details: "Mock backend — returns silence" };
     }
+    async interrupt() {
+        // Mock backend has no real synthesis to cancel — no-op.
+    }
     async synthesize(request) {
         const wav = generateMockWav();
         if (request.artifact.mode === "base64") {

package/dist/backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"backend.js","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../src/backend.ts"],"names":[],"mappings":"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"}

package/dist/backends/httpBackend.d.ts

@@ -21,9 +21,12 @@ export declare class HttpBackend implements Backend {
     private readonly token?;
     private readonly timeout;
     private readonly maxResponseSize;
+    /** Active fetch controller — aborted by interrupt(). */
+    private activeController;
     constructor(config: HttpBackendConfig);
     health(): Promise<BackendHealth>;
     synthesize(request: SynthesisRequest): Promise<SynthesisResult>;
+    interrupt(): Promise<void>;
     private buildHeaders;
     private readResponseBody;
     private parseResponse;

package/dist/backends/httpBackend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"httpBackend.d.ts","sourceRoot":"","sources":["../../src/backends/httpBackend.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAMjF,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE5F,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAQD,2DAA2D;AAC3D,qBAAa,gBAAiB,SAAQ,eAAe;IACnD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAG3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,iBAAiB,GAAG,sBAAsB,GAAG,qBAAqB,EACxE,UAAU,CAAC,EAAE,MAAM;CAMtB;AAKD,qBAAa,WAAY,YAAW,OAAO;IACzC,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAE7B,MAAM,EAAE,iBAAiB;IAQ/B,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IA0BhC,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAiErE,OAAO,CAAC,YAAY;YAQN,gBAAgB;YAyChB,aAAa;CAoF5B"}
+{"version":3,"file":"httpBackend.d.ts","sourceRoot":"","sources":["../../src/backends/httpBackend.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAMjF,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE5F,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAQD,2DAA2D;AAC3D,qBAAa,gBAAiB,SAAQ,eAAe;IACnD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAG3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,iBAAiB,GAAG,sBAAsB,GAAG,qBAAqB,EACxE,UAAU,CAAC,EAAE,MAAM;CAMtB;AA2DD,qBAAa,WAAY,YAAW,OAAO;IACzC,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,wDAAwD;IACxD,OAAO,CAAC,gBAAgB,CAAgC;gBAE5C,MAAM,EAAE,iBAAiB;IAQ/B,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IA0BhC,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAoE/D,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAOhC,OAAO,CAAC,YAAY;YAQN,gBAAgB;YAyChB,aAAa;CA6I5B"}