expert

type EventErrorTranslator interface {
	TranslateEventError(ctx context.Context, message string) (Response, bool)
}

type EventErrorTranslatorFunc func(ctx context.Context, message string) (Response, bool)

type Expert interface {
	Do(ctx context.Context, req Request) (Response, error)
	GetBio() ExpertBio
}

type ExpertBio struct {
	Name        string
	Description string
	Personality string
	Tools       []tool.Tool
}

type ExpertConfig struct {
	// MaxLLMCalls is the maximum number of LLM calls per invocation (default: 15)
	MaxLLMCalls int
	// MaxHistoryRuns is the maximum number of history messages to include (default: 5)
	MaxHistoryRuns int
	// DisableParallelTools disables parallel tool execution (default: false)
	DisableParallelTools bool
	// ReasoningContentMode
	ReasoningContentMode string
	// PersonaTokenThreshold is the warning limit for the system prompt size (default: 2000)
	PersonaTokenThreshold int
	// Silent disables emitting events to the TUI, useful for background tasks (default: false)
	Silent bool
}

type ExpertOption func(*expert)

type Request struct {
	Message         string
	AdditionalTools []tool.Tool
	// Process each choices as they are generated
	ChoiceProcessor func(choices ...model.Choice) `json:"-"`
	// TaskType to use
	TaskType modelprovider.TaskType

	Mode ExpertConfig

	// Temperature overrides the default LLM sampling temperature (0.3).
	// Use nil to keep the default. Set explicitly for models that only accept
	// specific values — for example, OpenAI reasoning models (o1, o3) require
	// temperature=1.
	Temperature *float64

	// WorkingMemory is an optional shared memory used to cache file-read tool results.
	// When set, ToolWrapper will automatically cache results from read_file, list_file,
	// and read_multiple_files, preventing redundant reads within the same session.
	WorkingMemory *rtmemory.WorkingMemory

	// Attachments holds file/media attachments from the incoming message.
	// Image attachments with LocalPath are added as multimodal visual content.
	// Audio attachments are added as audio content parts (with OGG→WAV conversion).
	// Video attachments are embedded via the File API with explicit MIME type.
	// Other attachments (PDF, DOCX) are described textually or embedded as files.
	Attachments []messenger.Attachment
}

type Response struct {
	Choices []model.Choice
	Usage   *model.Usage
}