stt

type AssemblyAIProvider struct {
	APIKey           string
	Models           []string
	StreamingModel   string
	BaseURL          string
	StreamingBaseURL string
	// SyncBaseURL points at the synchronous transcription endpoint
	// (https://sync.assemblyai.com; regional variants sync.us / sync.eu
	// exist). The Sync API returns a finished Universal-3.5 Pro transcript
	// in one request/response (~134 ms p50) for clips up to 120 s / 40 MB —
	// the low-latency dictation path. Empty uses the global endpoint.
	SyncBaseURL string
	// SyncModel is the X-AAI-Model routing header value for sync requests.
	// Empty uses universal-3-5-pro.
	SyncModel string
	// DisableSync forces every transcription through the classic async
	// upload+poll flow, even for clips the Sync API could serve.
	DisableSync bool
	// StreamingLLM, when set, attaches AssemblyAI LLM Gateway to Universal-3.5
	// Pro realtime turns. The formatted transcript still arrives as Turn;
	// LLMGatewayResponse may rewrite the final text for live cleanup.
	StreamingLLM *AssemblyAIStreamingLLM
	Validation   netsec.ValidationOptions
	PollInterval time.Duration
	PollTimeout  time.Duration
	// contains filtered or unexported fields
}

type AssemblyAIStreamingLLM struct {
	Model     string
	Prompt    string
	MaxTokens int
}

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

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

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

type DeepgramOptions struct {
	Configured            bool
	SmartFormat           bool
	Dictation             bool
	FillerWords           bool
	Numerals              bool
	DetectLanguage        bool
	LanguageOverride      string
	UseVocabularyKeyterms bool
	Keyterms              []string
	EndpointingMs         int
}

type DeepgramProvider struct {
	APIKey                string
	Model                 string
	DiarizationModel      string
	BaseURL               string
	Validation            netsec.ValidationOptions
	SmartFormat           bool
	Dictation             bool
	FillerWords           bool
	Numerals              bool
	DetectLanguage        bool
	LanguageOverride      string
	UseVocabularyKeyterms bool
	Keyterms              []string
	EndpointingMs         int
	// contains filtered or unexported fields
}

type EnabledProviders struct {
	Local       *LocalOpts
	HuggingFace *HuggingFaceOpts
	OpenRouter  *OpenRouterOpts
	VPS         *VPSOpts
	Ollama      *OllamaOpts
	Groq        *GroqOpts
	OpenAI      *OpenAIOpts
	Deepgram    *DeepgramOpts
	AssemblyAI  *AssemblyAIOpts
	Google      *GoogleOpts
	Extra       []STTProvider
}

type FluxStreamOptions struct {
	// Model selects flux-general-en or flux-general-multi. Empty uses the
	// multilingual model, which is the point of Flux for SpeechKit: it detects
	// and switches languages within a single conversation.
	Model string
	// LanguageHints biases recognition toward the given BCP-47 languages. Only
	// flux-general-multi accepts hints; they narrow the model, they do not pin
	// it, and every turn still reports what it actually heard.
	LanguageHints []string
	// Keyterms boost domain vocabulary (product names and other terms the model
	// has not seen).
	Keyterms []string
	// EOTThreshold, EagerEOTThreshold, and EOTTimeoutMs tune turn detection.
	// Zero keeps Deepgram's defaults; out-of-range values are clamped.
	EOTThreshold      float64
	EagerEOTThreshold float64
	EOTTimeoutMs      int
}

type FluxTurn struct {
	// Event is one of the Flux lifecycle events above.
	Event string `json:"event"`
	// TurnIndex counts turns within the connection.
	TurnIndex int `json:"turnIndex"`
	// Transcript is the full turn transcript so far, not a delta.
	Transcript string     `json:"transcript"`
	Words      []FluxWord `json:"words,omitempty"`
	// Languages are the languages actually detected in this turn; empty when
	// the turn holds no speech yet.
	Languages []string `json:"languages,omitempty"`
	// EndOfTurnConfidence is the model's confidence that the speaker is done.
	EndOfTurnConfidence float64 `json:"endOfTurnConfidence"`
	// AudioWindowStartMs/EndMs bound the audio this turn covers.
	AudioWindowStartMs int64 `json:"audioWindowStartMs"`
	AudioWindowEndMs   int64 `json:"audioWindowEndMs"`
	// SequenceID is Deepgram's per-connection event counter.
	SequenceID int64 `json:"sequenceId"`
	// RequestID identifies the connection in Deepgram's logs.
	RequestID string `json:"requestId"`
	// LatencyMs is the time from stream open to this event.
	LatencyMs int64 `json:"latencyMs"`
}

type FluxTurnStream struct {
	// contains filtered or unexported fields
}

type FluxWord struct {
	Text       string  `json:"text"`
	Confidence float64 `json:"confidence"`
	StartMs    int64   `json:"startMs"`
	EndMs      int64   `json:"endMs"`
}

type GoogleSTTProvider struct {
	APIKey                    string
	Model                     string // "latest_long", "latest_short", or another Google STT v1 model tag
	STTCredentialsJSONEnv     string
	ApplicationCredentialsEnv string
	BaseURL                   string // Override for testing; defaults to googleSTTBaseURL
	Validation                netsec.ValidationOptions
	// contains filtered or unexported fields
}

type HuggingFaceProvider struct {
	Model      string
	Token      string
	BaseURL    string // Override for testing; defaults to hfBaseURL
	Validation netsec.ValidationOptions
	// contains filtered or unexported fields
}

type InstallStatus struct {
	BinaryFound bool     `json:"binaryFound"`
	BinaryPath  string   `json:"binaryPath"`
	ModelFound  bool     `json:"modelFound"`
	ModelPath   string   `json:"modelPath"`
	ModelBytes  int64    `json:"modelBytes"`
	ServerReady bool     `json:"serverReady"`
	Problems    []string `json:"problems,omitempty"`
}

type LocalProvider struct {
	BaseURL    string // e.g. "http://127.0.0.1:8080"
	Port       int
	ModelPath  string
	GPU        string
	Validation netsec.ValidationOptions
	// contains filtered or unexported fields
}

type OpenAICompatibleProvider struct {
	BaseURL    string
	APIKey     string
	Model      string
	Validation netsec.ValidationOptions
	// contains filtered or unexported fields
}

type OpenRouterSTTProvider struct {
	BaseURL    string
	APIKey     string
	Model      string
	Validation netsec.ValidationOptions
	// contains filtered or unexported fields
}

type RouterConfig struct {
	Strategy             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
}

type VPSProvider = OpenAICompatibleProvider