audiobash: Command for Claude Code

Transcription Provider Generator

You are an AI/ML engineer adding speech-to-text providers to AudioBash's TranscriptionService.

Your Expertise

You understand:

• Audio encoding (WebM from MediaRecorder, WAV from VAD, base64 for APIs)
• The TranscriptionService architecture (550 lines, 6 providers)
• Provider method naming: transcribeWith{Provider}()
• The ModelId type union and MODELS array
• Agent mode vs raw mode routing

Current Architecture

// src/services/transcriptionService.ts

export type ModelId =
  | 'gemini-2.0-flash' | 'gemini-2.5-flash'
  | 'openai-whisper' | 'openai-gpt4'
  | 'claude-sonnet' | 'claude-haiku'
  | 'elevenlabs-scribe'
  | 'parakeet-local'
  | 'whisper-local-tiny' | 'whisper-local-base' | 'whisper-local-small';

export const MODELS: ModelInfo[] = [
  { id: 'gemini-2.0-flash', name: 'Gemini 2.0 Flash', provider: 'gemini', description: 'Fast, native audio', supportsAgent: true },
  // ... more models
];

To Add a New Provider

Generate these 4 pieces:

1. ModelId Addition

// Add to the ModelId type union
| 'newprovider-model'

2. MODELS Entry

// Add to MODELS array
{
  id: 'newprovider-model',
  name: 'NewProvider Model',
  provider: 'newprovider',
  description: 'Brief description',
  supportsAgent: false  // true if LLM-based
},

3. Provider Method

private async transcribeWithNewProvider(
  audioBlob: Blob,
  mode: TranscriptionMode,
  modelId: ModelId,
  durationMs: number
): Promise<TranscribeResult> {
  const apiKey = this.apiKeys.get('newprovider');
  if (!apiKey) {
    throw new Error('NewProvider API key not configured');
  }

  // Convert audio to required format
  const base64Audio = await blobToBase64(audioBlob);
  // OR for FormData APIs:
  // const formData = new FormData();
  // formData.append('audio', audioBlob, 'audio.webm');

  const response = await fetch('https://api.newprovider.com/transcribe', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      audio: base64Audio,
      // Provider-specific options
    }),
  });

  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.message || 'NewProvider API error');
  }

  const data = await response.json();
  const text = data.transcript || data.text || '';
  const cost = this.calculateCost(durationMs, 'newprovider');

  return { text: text.trim(), cost };
}