voicegateway

type ChoiceConfig struct {
	ID         string           `toml:"id"`
	Label      string           `toml:"label"`
	Backend    string           `toml:"backend"`
	Model      string           `toml:"model"`
	LocalStack LocalStackConfig `toml:"local_stack"`
}

type ChoiceMediaBridge interface {
	VoiceChoiceProvider
	HandleChoiceOffer(ctx context.Context, sdp, choiceID string) (sdpAnswer, sessionID string, err error)
}

type ChoiceTextSessionServer interface {
	VoiceChoiceProvider
	ServeTextChoice(ctx context.Context, w http.ResponseWriter, r *http.Request, choiceID string) error
}

type CloseSessionResp struct {
	Status string `json:"status"`
}

type Config struct {
	Choices         []ChoiceConfig        `toml:"choices"`
	DefaultChoiceID string                `toml:"default_choice_id"`
	Server          ServerConfig          `toml:"server"`
	Model           string                `toml:"model"`
	Backend         string                `toml:"backend"`
	LocalStack      LocalStackConfig      `toml:"local_stack"`
	TrustedIssuers  []TrustedIssuerConfig `toml:"trusted_issuers"`
}

type DiagnosticMediaBridge interface {
	DiagnoseVoiceRTC(ctx context.Context, sessionID string, client *voicev1.VoiceRTCClientDiagnostics) voicev1.VoiceRTCDiagnosticsResp
}

type HealthResp struct {
	Status string `json:"status"`
}

type LocalStackASRConfig struct {
	Engine   LocalStackASREngine `toml:"engine"`
	Provider string              `toml:"provider"`
	Remote   string              `toml:"remote"`
	Model    string              `toml:"model"`
}

type LocalStackASREngine string

type LocalStackConfig struct {
	// TextOnly disables gateway speech processing. Clients transcribe and speak;
	// the choice serves text sessions only and never initializes ASR or TTS.
	TextOnly bool                `toml:"text_only"`
	ASR      LocalStackASRConfig `toml:"asr"`
	LLM      LocalStackLLMConfig `toml:"llm"`
	TTS      LocalStackTTSConfig `toml:"tts"`
}

type LocalStackLLMConfig struct {
	Provider string `toml:"provider"`
	Remote   string `toml:"remote"`
	Model    string `toml:"model"`
	// APIKeyName names the environment variable containing the bearer token
	// for an openaicompatible endpoint. The credential is never stored in TOML.
	APIKeyName string `toml:"api_key_name"`
}

type LocalStackTTSConfig struct {
	Engine LocalStackTTSEngine `toml:"engine"`
	Remote string              `toml:"remote"`
	Model  string              `toml:"model"`
	Voice  string              `toml:"voice"`
}

type LocalStackTTSEngine string

type MediaBridge interface {
	HandleOffer(ctx context.Context, sdp string) (sdpAnswer, sessionID string, err error)
	Close(sessionID string)
}

type MediaBridgeProvider func() MediaBridge

type OfferResp struct {
	SDP       string `json:"sdp"`
	SessionID string `json:"sessionID"`
}

type ServerConfig struct {
	HTTP          string `toml:"http"`
	WebRTCUDPPort int    `toml:"webrtc_udp_port"`
}

type TextSessionServer interface {
	// ServeTextSession runs one text session on the HTTP response. It owns the
	// response and writes its own error response, so the caller only logs a
	// returned error.
	ServeTextSession(ctx context.Context, w http.ResponseWriter, r *http.Request) error
}

type TrustedIssuerConfig struct {
	// Service is the service kind allowed to issue tokens, for example "caic" or "mddb".
	Service string `toml:"service"`
	// Issuer is the backend origin that owns the signing key.
	//
	// It must match the service authorization base URL and the token backend origin.
	Issuer string `toml:"issuer"`
	// PublicKey is the imported Ed25519 public key used to verify scoped tokens from issuer.
	//
	// The expected format is the value returned by gomode.EncodeServiceSigningPublicKey.
	PublicKey string `toml:"public_key"`
	// OAuth enables OAuth 2.0 access token verification through discovery and JWKS.
	OAuth bool `toml:"oauth"`
	// Audience is the required OAuth token audience. It defaults to
	// gomode.ScopedTokenAudience when empty.
	Audience string `toml:"audience"`
	// Scope is the OAuth scope a token must carry. It defaults to
	// DefaultVoiceScope when empty.
	Scope string `toml:"scope"`
}

type VoiceChoiceProvider interface {
	VoiceChoices() voicev1.VoiceChoicesResp
}