# audio.voice The spoken script — the words, who says them, and the name each line's clip is filed under. Data only; the generation and the processing that give them a voice live in `audio.voicebake`. Two speakers. **The Vagant** is close, tired and plain. **The Commissioner** is a man reading a minute-book aloud in a place with no walls. They are separated by writing and by processing, not by a voice id. `audio_gen.speech` takes an optional `voice` and nothing on the service enumerates the ids it accepts; a deliberately invalid id was accepted and returned audio, so a wrong id does not announce itself, and two known-public ids produced no pitch separation this could measure. Both speakers are therefore generated on the default voice, and the Commissioner is dropped a minor third, band-limited and thrown into a long cold tail in the bake. Eighteen lines: the opening (the Commissioner speaks first, from somewhere unseen), the lamps, the wig, the oil, the Commissioners closing in, and the two resolutions. Each line's first forty characters are unique on purpose: the generation service names its imported asset from a forty-character truncation of the text, and two lines sharing that prefix overwrite each other silently. `SoundDirector` emits `line(key, text, speaker, seconds)` whether or not the clip exists, so a failed generation is a quiet line rather than a lost one.

# audio.synth Pure-CPU audio synthesis. Every noise *First Light: Vagant* makes is computed here as interleaved f32 PCM in a `buffer`, then handed to `audio.encodePcm` / `asset.create("soundClip", …)`. No network, no credits, no failure mode. Author time only — `audio.recipes` and `audio.bake` are its consumers, and the game ships the baked clips, so a browser session synthesises nothing on the player's machine. Two conventions run through it: - every generator **adds** into a destination buffer, so layers compose; - a **loop-coherent** generator takes its frequency in cycles across the WHOLE buffer rather than in hertz, which is what makes a bed seamless end to end. ## What is in it - **Oscillators** — `sine` (table-driven), `addTone` (a gliding harmonic stack with vibrato), `addLoopPartial` (the loop-coherent form), `addPluck` (Karplus-Strong), `addNoise`. - **Envelopes** — `env` (breakpoints in seconds), `decayEnv` (attack plus an exponential tail), `mulEnv`. - **Filters** — `lowpass`, `highpass`, `lowpassSweep`, `bandpass` (a swept state-variable band), and the circular forms `lowpassCircular` / `bandpassCircular`, which converge the filter's state on the wrap point so its output is continuous ACROSS the loop join. - **Space and finishing** — `reverb` (four combs into two allpasses), `resample`, `gain`, `normalize`, `softClip`, `removeDc`, `fadeEdges`, `mix`, `addWrapped` (a tail that wraps round to the head of a loop). - **Measurement** — `peak`, `rms`, and `seamError`, which reports the step across a loop's join in the units the signal itself steps in: around 1 is seamless, a click reads in the tens.