voiceagent

type Callbacks struct {
	OnStateChange func(state State)
	OnAudio       func(audio []byte) // Audio chunk to play
	OnText        func(text string)  // Text for display (speech bubble)
	OnError       func(err error)
}

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

type IdleConfig struct {
	ReminderAfter   time.Duration // Default: 5 minutes
	DeactivateAfter time.Duration // Default: 15 minutes
}

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

type LiveConfig struct {
	Model          string // e.g. "gemini-2.5-flash-native-audio-preview-12-2025"
	APIKey         string
	Voice          string // Voice name
	SystemPrompt   string
	VocabularyHint string
	Locale         string
}

type LiveMessage struct {
	Audio []byte // PCM audio chunk (24kHz 16-bit mono)
	Text  string // Text transcript (may be partial or empty)
	Done  bool   // True when the model's turn is complete
}

type LiveProvider interface {
	// Connect establishes a WebSocket session to the real-time model.
	Connect(ctx context.Context, cfg LiveConfig) error

	// SendAudio streams PCM audio chunks to the model.
	// Format: 16-bit signed int, little-endian, mono, 16kHz.
	SendAudio(chunk []byte) error

	// Receive blocks until the next server message arrives.
	// Returns audio chunks and/or text from the model.
	Receive(ctx context.Context) (*LiveMessage, error)

	// SendText injects a text prompt into the session (for idle reminders).
	SendText(text string) error

	// Close terminates the WebSocket session.
	Close() error

	// Name returns the provider identifier.
	Name() string
}

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

type State string