Expand description
Safe, blocking public engine primitives.
TtsEngine owns the one async runtime used below the synchronous public
facade. Model work is intentionally absent in Phase 0, but the admission,
cancellation, budget, observer, and bounded-streaming contracts are real so
later model stages cannot introduce a second orchestration path.
Modules§
- admission
- Resource admission: decide before allocating, and report truncation instead of hiding it.
- audio
- The audio output tail: decoded PCM to a playable file.
- health
- Runtime health: catch a run going wrong while it is still running.
Structs§
- Bounded
Receiver - A bounded queue consumer.
- Bounded
Sender - A bounded queue producer that cooperates with cancellation while stalled.
- Cancellation
Token - A caller-owned cancellation signal for one request.
- Code
Frame - One generated codec frame: the talker’s primary code plus the 15 residual codes.
- Engine
Config - Fixed limits for one engine instance.
- Enrollment
Request - A synchronous enrollment request.
- Enrollment
Result - A completed empty-pipeline enrollment result.
- Generation
Error - A model-side failure while generating codec frames.
- Language
Span - A byte range in normalized text with a caller-supplied language identifier.
- Normalization
Change - One observable normalization change.
- Normalization
Options - Caller-supplied behavior layered over the pinned verbatim path.
- Normalization
Trace - A deterministic record of what the normalizer did and why.
- Normalization
Trace Summary - The privacy-safe normalization information allowed on an observer event.
- PcmPacket
- A PCM packet emitted by the codec path.
- Prepared
Text - Token ids and a caller-owned trace returned by a model-specific text preparer.
- Pronunciation
Entry - An explicit pronunciation expansion.
- Stream
Queues - A streaming endpoint pair with independent bounded PCM and event queues.
- Synthesis
Request - A synchronous synthesis request.
- Synthesis
Result - A completed synthesis result.
- Text
Preparation Error - Named failure from a model-specific text preparer.
- TtsEngine
- Blocking public engine facade.
Enums§
- Engine
Error - Errors produced by the synchronous engine facade.
- Engine
Stage - A stage named in observer events and budget errors.
- Health
Event - A health signal emitted through the caller-owned observer.
- Normalization
Mode - The caller-visible text-normalization policy.
- Stream
Kind - The kind of a bounded stream queue.
- Synthesis
Event - Lifecycle information delivered to a caller-owned observer.
Constants§
- SCAFFOLD_
REVISION - Identifies this crate’s scaffold revision.
Traits§
- Frame
Generator - Model-specific autoregressive frame generation behind the blocking engine facade.
- Synthesis
Observer - Caller-owned telemetry for synthesis and enrollment.
- Text
Preparer - Model-specific text preparation used by the blocking engine facade.
Functions§
- process_
engine_ config - Process-wide engine defaults read once from
FTTS_STAGE_BUDGET_*_MS.