---

name: whisper-lolo-transcription-jobs description: Implement or adjust background transcription jobs for whisper-lolo. Use when wiring Inngest events, handling long-running jobs, chunking before transcription, persisting transcripts, or maintaining the TranscriptionProvider abstraction.

Whisper Lolo Transcription Jobs

Overview

Run transcription asynchronously with Inngest, storing results in Postgres, and keep a provider abstraction for Whisper now and Voxtral later.

Job workflow

1. Emit recording.uploaded after successful Blob upload.
2. In Inngest, start transcribeRecording on that event.
3. Download audio from blob_url.
4. Chunk before transcription to fit provider limits.
5. Call the provider (Whisper now) and store text + segments.
6. Update statuses and handle errors with retries.

Provider abstraction

• Maintain a TranscriptionProvider interface with transcribe(audioUrl).
• Implement WhisperProvider now; leave VoxtralProvider stubbed.
• Avoid provider-specific logic in job orchestration.

Status discipline

• recordings.status: uploaded -> transcribing -> done/error.
• transcriptions.status: pending -> done/error.
• Persist timestamps for observability where possible.

Error handling

• Log failures with enough context to retry safely.
• Avoid duplicate transcription on retry (idempotency checks).

References to consult

• documentation/inngest-background-jobs.md
• documentation/inngest-demo-nextjs-full-stack.md
• documentation/openai-node-audio-example.md
• documentation/openai-speech-to-text.md
• documentation/openai-audio-api-reference.md