registry

type CallSystemProviderFactory func(config ProviderConfig) (callsystem.CallSystem, error)

type Gateway interface {
	// Name returns the provider name.
	Name() string

	// Start starts the gateway server.
	Start(ctx any) error

	// Stop gracefully shuts down the gateway.
	Stop() error
}

type GatewayProviderFactory func(config ProviderConfig) (Gateway, error)

type ProviderConfig struct {
	// APIKey is the authentication key for the provider.
	APIKey string //nolint:gosec // G117: This is a config struct, not storing secrets

	// BaseURL is an optional custom API endpoint.
	BaseURL string

	// Extensions holds provider-specific configuration.
	Extensions map[string]any
}

type ProviderOption func(*ProviderConfig)

type RealtimeProvider interface {
	// Name returns the provider name (e.g., "openai", "gemini").
	Name() string

	// Close closes the provider and releases resources.
	Close() error
}

type RealtimeProviderFactory func(config ProviderConfig) (RealtimeProvider, error)

type Registry interface {
	// TTS registration
	RegisterTTSProvider(name string, factory TTSProviderFactory)
	GetTTSProvider(name string, opts ...ProviderOption) (tts.Provider, error)
	ListTTSProviders() []string
	HasTTSProvider(name string) bool

	// STT registration
	RegisterSTTProvider(name string, factory STTProviderFactory)
	GetSTTProvider(name string, opts ...ProviderOption) (stt.Provider, error)
	ListSTTProviders() []string
	HasSTTProvider(name string) bool

	// CallSystem registration
	RegisterCallSystemProvider(name string, factory CallSystemProviderFactory)
	GetCallSystemProvider(name string, opts ...ProviderOption) (callsystem.CallSystem, error)
	ListCallSystemProviders() []string
	HasCallSystemProvider(name string) bool

	// Gateway registration
	RegisterGatewayProvider(name string, factory GatewayProviderFactory)
	GetGatewayProvider(name string, opts ...ProviderOption) (Gateway, error)
	ListGatewayProviders() []string
	HasGatewayProvider(name string) bool

	// Realtime registration
	RegisterRealtimeProvider(name string, factory RealtimeProviderFactory)
	GetRealtimeProvider(name string, opts ...ProviderOption) (RealtimeProvider, error)
	ListRealtimeProviders() []string
	HasRealtimeProvider(name string) bool
}

type STTProviderFactory func(config ProviderConfig) (stt.Provider, error)

type TTSProviderFactory func(config ProviderConfig) (tts.Provider, error)