allproviders

type AssemblyAIOpts struct {
	APIKey string
	// Models is the comma-separated STT model list accepted by
	// assemblyai.New.
	Models           string
	StreamingModel   string
	StreamingBaseURL string
	SyncBaseURL      string
	DisableSync      bool
	// StreamingLLM enables LLM Gateway cleanup on realtime dictation with
	// StreamingLLMModel.
	StreamingLLM      bool
	StreamingLLMModel string
}

type BuildSpec struct {
	ExecutionMode speechkit.ExecutionMode
	Provider      string
	ModelID       string

	APIKey  string // cloud API key (OpenAI/Groq/Google/Deepgram/AssemblyAI/OpenRouter/Foundry)
	Token   string // HuggingFace token
	BaseURL string // Ollama base URL (optional; defaulted when empty) or Foundry OpenAI-compatible base (required)

	// DiarizationModel overrides the Deepgram diarization model (optional).
	DiarizationModel string
	// Deepgram forwards provider-specific Listen options (optional).
	Deepgram deepgram.Options
	// Google streaming credential env-var names (optional), forwarded to the
	// Google provider so realtime transcription can authenticate.
	GoogleStreamingCredentialsEnv   string
	GoogleApplicationCredentialsEnv string
}

type DeepgramOpts struct {
	APIKey string
	Model  string
	// DiarizationModel overrides the provider default when non-empty.
	DiarizationModel string
	// Listen forwards Deepgram Listen options (applied when configured).
	Listen deepgram.Options
}

type EnabledProviders struct {
	Local       *LocalOpts
	HuggingFace *HuggingFaceOpts
	OpenRouter  *OpenRouterOpts
	VPS         *VPSOpts
	Ollama      *OllamaOpts
	Groq        *GroqOpts
	OpenAI      *OpenAIOpts
	Deepgram    *DeepgramOpts
	AssemblyAI  *AssemblyAIOpts
	Google      *GoogleOpts
	Foundry     *FoundryOpts
	Extra       []stt.STTProvider
	// Secrets is handed to every constructed provider that resolves
	// credentials lazily (currently Google streaming). Nil falls back to the
	// process environment.
	Secrets stt.SecretResolver
}

type FoundryOpts struct {
	APIKey  string
	BaseURL string
	Model   string
}

type GoogleOpts struct {
	APIKey string
	Model  string
	// Streaming credential env-var names forwarded via
	// SetStreamingCredentialEnvs.
	CredentialsJSONEnv        string
	ApplicationCredentialsEnv string
}

type GroqOpts struct {
	APIKey string
	Model  string
}

type HuggingFaceOpts struct {
	Model string
	Token string
}

type LocalOpts struct {
	Port      int
	ModelPath string
	GPU       string
}

type OllamaOpts struct {
	BaseURL string
	Model   string
	// Validation, when non-nil, replaces the provider's default netsec
	// validation (loopback+private+http). Restricted network scopes pass
	// a RequireLocal option set so public endpoints are rejected at
	// request and dial time.
	Validation *netsec.ValidationOptions
}

type OpenAIOpts struct {
	APIKey string
	Model  string
}

type OpenRouterOpts struct {
	APIKey string
	Model  string
}

type RouterConfig struct {
	Strategy             stt.Strategy
	PreferLocalUnderSecs float64
	ParallelCloud        bool
	ReplaceOnBetter      bool
	// PreferredProfileID optionally pins the cloud provider matching this
	// model_selection profile (or bare provider name) to the front of the
	// strategy order, analogous to tts.EnabledProviders.PreferredProfileID.
	PreferredProfileID string
	// OnProviderSelected is installed as the router's per-instance observer
	// (stt.Router.OnProviderSelected). Hosts wire audit logging here.
	OnProviderSelected stt.ProviderSelectedObserver
}

type VPSOpts struct {
	URL    string
	APIKey string
	Model  string
	// Validation, when non-nil, replaces the provider's default netsec
	// validation (loopback+private+http). Restricted network scopes pass
	// a RequireLocal option set so public endpoints are rejected at
	// request and dial time.
	Validation *netsec.ValidationOptions
}