# nexo-plugin-voice

TTS reply transformer + per-conversation toggle for the Nexo agent
framework. Out-of-tree subprocess plugin loaded by `nexo-rs` via
manifest discovery (Phase 81.33.b.real).

## What it does

Lets any Nexo microapp reply to a chat with a voice note instead
of text. Per-conversation toggle, multi-provider TTS (Microsoft
Edge default, ElevenLabs/Azure/OpenAI/Cartesia/Piper/Kokoro
opt-in), SSML pipeline with operator-friendly markers,
fallback strategies, retry policy, circuit breaker, LRU cache,
HTTP toggle routes, admin RPC, Prometheus metrics, firehose
audit events.

Replaces the in-SDK `nexo_microapp_sdk::voice` pipeline that
shipped with `agent-creator-microapp` v1 — any microapp now
opts in by adding `plugins.voice: {...}` to its YAML and
declaring the plugin in its discovery search paths.

## Quickstart

See [docs/](./docs/) or jump to the [reference manifest](./nexo-plugin.toml).

## Status

Pre-alpha. Manifest scaffold ready; provider impls + tools +
HTTP/admin routes land step-by-step per `proyecto/PHASES.md`
(voice-plugin-extract phase).

## License

MIT OR Apache-2.0
