add deepgram provider with nova-3 and nova-2 streaming models

internal/provider/deepgram.go

@@ -0,0 +1,94 @@
+package provider
+
+// DeepgramProvider implements Provider for Deepgram transcription services
+type DeepgramProvider struct{}
+
+func (p *DeepgramProvider) Name() string {
+	return "deepgram"
+}
+
+func (p *DeepgramProvider) RequiresAPIKey() bool {
+	return true
+}
+
+func (p *DeepgramProvider) ValidateAPIKey(key string) bool {
+	// Deepgram API keys are alphanumeric, just check non-empty
+	return len(key) > 0
+}
+
+func (p *DeepgramProvider) IsLocal() bool {
+	return false
+}
+
+func (p *DeepgramProvider) Models() []Model {
+	// Nova-3 language support - maps to our 57 language list
+	// from https://developers.deepgram.com/docs/models-languages-overview
+	nova3Langs := []string{
+		"ar", "be", "bs", "bg", "ca", "hr", "cs", "da", "nl", "en", "et", "fi",
+		"fr", "de", "el", "hi", "hu", "id", "it", "ja", "kn", "ko", "lv", "lt",
+		"mk", "ms", "mr", "no", "pl", "pt", "ro", "ru", "sr", "sk", "sl", "es",
+		"sv", "tl", "ta", "tr", "uk", "vi",
+	}
+
+	// Nova-2 language support - subset of nova-3
+	nova2Langs := []string{
+		"bg", "ca", "zh", "cs", "da", "nl", "en", "et", "fi", "fr", "de", "el",
+		"hi", "hu", "id", "it", "ja", "ko", "lv", "lt", "ms", "no", "pl", "pt",
+		"ro", "ru", "sk", "es", "sv", "th", "tr", "uk", "vi",
+	}
+
+	return []Model{
+		{
+			ID:                 "nova-3",
+			Name:               "Nova-3",
+			Description:        "Best accuracy, 40+ languages, real-time",
+			Type:               Transcription,
+			Streaming:          true,
+			Local:              false,
+			AdapterType:        "deepgram",
+			SupportedLanguages: nova3Langs,
+			Endpoint:           &EndpointConfig{BaseURL: "wss://api.deepgram.com", Path: "/v1/listen"},
+		},
+		{
+			ID:                 "nova-3-general",
+			Name:               "Nova-3 General",
+			Description:        "General purpose, same as nova-3",
+			Type:               Transcription,
+			Streaming:          true,
+			Local:              false,
+			AdapterType:        "deepgram",
+			SupportedLanguages: nova3Langs,
+			Endpoint:           &EndpointConfig{BaseURL: "wss://api.deepgram.com", Path: "/v1/listen"},
+		},
+		{
+			ID:                 "nova-2",
+			Name:               "Nova-2",
+			Description:        "Fast, 30+ languages, filler words",
+			Type:               Transcription,
+			Streaming:          true,
+			Local:              false,
+			AdapterType:        "deepgram",
+			SupportedLanguages: nova2Langs,
+			Endpoint:           &EndpointConfig{BaseURL: "wss://api.deepgram.com", Path: "/v1/listen"},
+		},
+		{
+			ID:                 "nova-2-general",
+			Name:               "Nova-2 General",
+			Description:        "General purpose, same as nova-2",
+			Type:               Transcription,
+			Streaming:          true,
+			Local:              false,
+			AdapterType:        "deepgram",
+			SupportedLanguages: nova2Langs,
+			Endpoint:           &EndpointConfig{BaseURL: "wss://api.deepgram.com", Path: "/v1/listen"},
+		},
+	}
+}
+
+func (p *DeepgramProvider) DefaultModel(t ModelType) string {
+	switch t {
+	case Transcription:
+		return "nova-3"
+	}
+	return ""
+}

internal/provider/deepgram_test.go

@@ -0,0 +1,110 @@
+package provider
+
+import "testing"
+
+func TestDeepgramProvider(t *testing.T) {
+	p := GetProvider("deepgram")
+	if p == nil {
+		t.Fatal("deepgram provider not registered")
+	}
+
+	if p.Name() != "deepgram" {
+		t.Errorf("Name() = %q, want %q", p.Name(), "deepgram")
+	}
+
+	if !p.RequiresAPIKey() {
+		t.Error("RequiresAPIKey() should return true")
+	}
+
+	if p.IsLocal() {
+		t.Error("IsLocal() should return false")
+	}
+}
+
+func TestDeepgramProvider_Models(t *testing.T) {
+	p := &DeepgramProvider{}
+	models := p.Models()
+
+	if len(models) != 4 {
+		t.Errorf("Models() returned %d models, want 4", len(models))
+	}
+
+	// all models should be streaming
+	for _, m := range models {
+		if !m.Streaming {
+			t.Errorf("model %s should be streaming", m.ID)
+		}
+		if m.AdapterType != "deepgram" {
+			t.Errorf("model %s has AdapterType %q, want 'deepgram'", m.ID, m.AdapterType)
+		}
+		if m.Local {
+			t.Errorf("model %s should not be local", m.ID)
+		}
+	}
+}
+
+func TestDeepgramProvider_Nova3Languages(t *testing.T) {
+	p := &DeepgramProvider{}
+	models := p.Models()
+
+	var nova3 *Model
+	for i := range models {
+		if models[i].ID == "nova-3" {
+			nova3 = &models[i]
+			break
+		}
+	}
+	if nova3 == nil {
+		t.Fatal("nova-3 model not found")
+	}
+
+	// nova-3 should support many languages from our list
+	supportedTests := []struct {
+		code string
+		want bool
+	}{
+		{"en", true},
+		{"es", true},
+		{"fr", true},
+		{"de", true},
+		{"ja", true},
+		{"", true}, // auto always supported
+	}
+
+	for _, tt := range supportedTests {
+		got := nova3.SupportsLanguage(tt.code)
+		if got != tt.want {
+			t.Errorf("nova-3.SupportsLanguage(%q) = %v, want %v", tt.code, got, tt.want)
+		}
+	}
+}
+
+func TestDeepgramProvider_DefaultModel(t *testing.T) {
+	p := &DeepgramProvider{}
+
+	if got := p.DefaultModel(Transcription); got != "nova-3" {
+		t.Errorf("DefaultModel(Transcription) = %q, want 'nova-3'", got)
+	}
+
+	if got := p.DefaultModel(LLM); got != "" {
+		t.Errorf("DefaultModel(LLM) = %q, want empty (no LLM support)", got)
+	}
+}
+
+func TestDeepgramProvider_Endpoint(t *testing.T) {
+	p := &DeepgramProvider{}
+	models := p.Models()
+
+	for _, m := range models {
+		if m.Endpoint == nil {
+			t.Errorf("model %s has nil Endpoint", m.ID)
+			continue
+		}
+		if m.Endpoint.BaseURL != "wss://api.deepgram.com" {
+			t.Errorf("model %s has BaseURL %q, want 'wss://api.deepgram.com'", m.ID, m.Endpoint.BaseURL)
+		}
+		if m.Endpoint.Path != "/v1/listen" {
+			t.Errorf("model %s has Path %q, want '/v1/listen'", m.ID, m.Endpoint.Path)
+		}
+	}
+}

internal/provider/provider.go

@@ -29,6 +29,7 @@ func init() {
 	Register(&MistralProvider{})
 	Register(&ElevenLabsProvider{})
 	Register(&WhisperCppProvider{})
+	Register(&DeepgramProvider{})
 }
 
 // Register adds a provider to the registry