utils/

Package context provides the text-alignment utilities that let a TTS service map the words it actually spoke back to the original written text, so the conversation context can be truncated to exactly what was spoken when the bot is interrupted.

Package errors classifies failures the way every service shares: it gives a provider-agnostic vocabulary for why an operation failed, so a caller can tell a transient failure (worth retrying) from a permanent one (retrying will never help).

Package events is the event-handler registry an object exposes to report what it did, for the things a caller wants to observe but the frame path does not carry: a summary being applied, a socket failing to open, a worker becoming ready.

Package network holds the retry helpers shared by services that keep a connection open to a provider for the length of a call.

Package notify carries the signaling primitives processors use to coordinate with one another without being wired together in the pipeline.

Package security holds the checks that decide whether a connection from outside is allowed in.

Package text normalizes written text into a form better suited to text-to-speech: it strips Markdown, expands numbers, currency, percentages, dates, units and acronyms into spoken words, spaces out phone-number digits, and spells email addresses.