Module trade_audio 

Spoken trade-event cues — embedded MP3s played via macOS afplay.

Audio policy (keep speech rare)

Speak (money moved or mechanical exit):

• Entry filled (EntryOpened)
• Exit filled with mechanical reason (ExitProfit, ExitStop, ExitDte, …)
• Broker rejected entry (EntryRejected)
• Broker OCO bracket fill (ExitBracket)

Silent (UI/Telegram only):

• LLM risk / halt / advisor cues (AlertRisk, AlertHalted, ExitAdvisor)
• Entry deferred (LLM veto, cooldown, awaiting proceed)
• Limit order working / accepted
• Stale entry cancel
• Skipped capacity / cooldown (fill_status SKIPPED)

Enums

TradeAudioEvent

Functions

init

Configure audio (call once when an agent/watch session starts).

speak

speak_exit_reason

speak_from_action

Map options-agent Telegram action payloads to spoken cues.