selfplay

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

type AudioGenerator interface {
	// NextUserTurnAudio generates a user message and converts it to audio.
	// Returns the text result and audio data.
	// The opts parameter is optional and can be nil.
	NextUserTurnAudio(
		ctx context.Context,
		history []types.Message,
		scenarioID string,
		opts *GeneratorOptions,
	) (*AudioResult, error)
}

type AudioProvider interface {
	Provider

	// GetAudioContentGenerator returns an audio generator for the given role and persona.
	// The TTS config specifies the voice and provider for text-to-speech synthesis.
	GetAudioContentGenerator(role, personaID string, ttsConfig *config.TTSConfig) (AudioGenerator, error)
}

type AudioResult struct {
	// TextResult contains the text generation result with cost info and metadata.
	TextResult *pipeline.ExecutionResult

	// Audio contains the synthesized audio data.
	Audio []byte

	// AudioFormat describes the audio encoding.
	AudioFormat tts.AudioFormat

	// SampleRate is the sample rate of the audio data in Hz.
	SampleRate int
}

type CacheKey struct {
	Role      string
	PersonaID string
}

type CacheStats struct {
	Size        int     // Number of cached entries
	Hits        int     // Number of cache hits
	Misses      int     // Number of cache misses
	HitRate     float64 // Cache hit rate (0.0 to 1.0)
	CachedPairs []CacheKey
}

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

type Generator interface {
	NextUserTurn(
		ctx context.Context,
		history []types.Message,
		scenarioID string,
		opts *GeneratorOptions,
	) (*pipeline.ExecutionResult, error)
}

type GeneratorOptions struct {
	// SelfplayTurnIndex is the 1-indexed selfplay turn number (first selfplay turn = 1).
	// If set, this overrides the automatic turn counting from history.
	// This is important for scenarios with mixed file-based and selfplay turns.
	SelfplayTurnIndex int
}

type MockTTSService struct {
	// SampleRate is the audio sample rate (default: 24000).
	SampleRate int

	// AudioFiles is a list of PCM audio files to load and rotate through.
	// If empty, falls back to generating silence.
	AudioFiles []string

	// Latency simulates network/processing delay before returning audio.
	Latency time.Duration
	// contains filtered or unexported fields
}

type Provider interface {
	GetContentGenerator(role, personaID string) (Generator, error)
}

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

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