voice-synth

name	voice-synth
description	Cloud text-to-speech (Google or Azure) for English and Hebrew — on-demand via mrctl or optional auto voice attachments per space.

Voice synthesis (TTS)

mrctl tts synthesize is available in this environment. When the user asks for a voice message, audio reply, or TTS, you MUST run the command below. Do not assume it is unavailable — always try it and report any error verbatim.

Do not paste mrctl, shell snippets, or JSON tool-call blobs into your visible reply — use the bash tool only for the command. The user sees normal text plus the audio attachment.

How to send a voice message

mrctl tts synthesize --text "Your spoken reply here" --out outbox/reply.mp3

This writes an MP3 file to outbox/ which Mercury automatically attaches to your reply. Do not create .txt files or use misleading names — chat apps decide how to render attachments from the file extension and MIME type.

Optional flags:

• --language — auto (default), he-IL, or en-US. auto picks Hebrew if the text contains Hebrew script.
• --provider — google, azure, or auto (host default).

Requires the caller to have tts.synthesize permission (admins have it by default).

Telegram / WhatsApp delivery

Telegram uses sendAudio for MP3 (in-chat player) and sendVoice for OGG voice notes. WhatsApp treats audio as a voice note when the filename matches voice-*.ogg (case-insensitive); otherwise it sends as normal audio (ptt: false).

Automatic mode (optional)

Setting	Behavior
voice-synth.mode=on_demand (default)	TTS runs only when you call mrctl tts synthesize.
voice-synth.mode=auto	The host attaches a TTS MP3 to every assistant reply automatically.

Set with mrctl config set voice-synth.mode on_demand or auto.