Audio helpers

The adapter exports the three audio helpers it uses internally. They're stable exports — safe to reuse if you're building custom pipelines or writing tests.

import {
  framesToWav,
  parseWav,
  pcmSampleRateFromContentType,
} from '@spekoai/adapter-livekit';

framesToWav

function framesToWav(buffer: AudioBuffer): Uint8Array;

Encode one or more LiveKit AudioFrames (or an array) into a PCM16 mono WAV byte stream. Used by SpekoSTT to wrap each utterance before uploading to /v1/transcribe.

• Combines frames via combineAudioFrames from @livekit/rtc-node.
• Writes a standard 44-byte RIFF/WAVE header: fmt chunk (PCM, 16-bit, mono, sampleRate from frames) + data chunk.
• Sample rate is pulled from the input frames — whatever LiveKit gives you is what's encoded.

Mono-only. A multi-channel AudioBuffer throws:

SpekoSTT: expected mono audio (1 channel), got 2. Configure your LiveKit AgentSession to pass mono audio or pre-mix upstream of the STT.

parseWav

function parseWav(bytes: Uint8Array): {
  pcm: Uint8Array;
  sampleRate: number;
  channels: number;
};

Minimal PCM16 WAV parser. Used by SpekoTTS to unwrap WAV-encoded proxy responses into raw samples for AudioByteStream.

Accepted subset:

• Valid RIFF / WAVE header.
• fmt chunk present and of format = 1 (PCM).
• 16-bit samples.
• data chunk reachable by walking subsequent chunks (tolerates e.g. LIST chunks between fmt and data).

Anything outside this subset throws a descriptive error. channels is returned as-is — the caller is responsible for deciding whether stereo is acceptable. SpekoTTS currently throws on stereo.

pcmSampleRateFromContentType

function pcmSampleRateFromContentType(
  contentType: string,
  fallback: number,
): number;

Parse the rate parameter out of a Cartesia-style content type:

pcmSampleRateFromContentType('audio/pcm;rate=24000', 16_000); // 24000
pcmSampleRateFromContentType('audio/pcm', 16_000);            // 16000
pcmSampleRateFromContentType('audio/pcm;rate=abc', 16_000);   // 16000

Falls back when the rate is missing, zero, or unparseable. Case-insensitive on rate=.

Intended usage

You shouldn't need these helpers when consuming the adapter through createSpekoComponents — they're used internally by SpekoSTT and SpekoTTS. They're exported for:

• Unit tests — build canned WAV fixtures with framesToWav, round-trip them through parseWav.
• Custom STT / TTS pipelines that need to reuse the same WAV framing Speko uses.
• Debugging — decode what an upstream provider returned without instantiating a full TTS.