llm

type AgentConfigUpdate struct {
	ID           string
	Instructions *Instructions
	ToolsAdded   []string
	ToolsRemoved []string
	CreatedAt    time.Time
}

type AgentHandoff struct {
	Agent   any
	Returns any
}

type AgentHandoffItem struct {
	ID         string
	OldAgentID string
	NewAgentID string
	CreatedAt  time.Time
}

type AsyncToolOptions struct {
	UpdateTemplate                string
	UpdateTemplateSet             bool
	UpdateTemplateFunc            func(UpdatePromptArgs) string
	DuplicateRejectTemplate       string
	DuplicateRejectTemplateSet    bool
	DuplicateRejectTemplateFunc   func(DuplicatePromptArgs) string
	DuplicateConfirmTemplate      string
	DuplicateConfirmTemplateSet   bool
	DuplicateConfirmTemplateFunc  func(DuplicatePromptArgs) string
	ReplyAtTailTemplate           string
	ReplyAtTailTemplateSet        bool
	ReplyAtTailTemplateFunc       func(ReplyPromptArgs) string
	ReplyMaybeCoveredTemplate     string
	ReplyMaybeCoveredTemplateSet  bool
	ReplyMaybeCoveredTemplateFunc func(ReplyPromptArgs) string
}

type AsyncToolset struct {
	*Toolset
	// contains filtered or unexported fields
}

type AsyncToolsetOptions struct {
	ID           string
	Tools        []Tool
	Setup        func(context.Context, ToolsetContext) error
	Close        func(context.Context) error
	ToolHandling *AsyncToolOptions
}

type AudioContent struct {
	Frames     []agents.AudioFrame
	Transcript string
}

type AvailabilityChangedEvent struct {
	LLM       LLM
	Available bool
}

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

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

type ChatChunk struct {
	ID    string
	Delta *ChoiceDelta
	Usage *CompletionUsage
}

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

type ChatContextDiff struct {
	ToRemove []string                   `json:"toRemove"`
	ToCreate []ChatContextDiffOperation `json:"toCreate"`
	ToUpdate []ChatContextDiffOperation `json:"toUpdate"`
}

type ChatContextDiffOperation struct {
	PreviousItemID string `json:"previousItemId,omitempty"`
	ItemID         string `json:"itemId"`
}

type ChatContextJSONOptions struct {
	ExcludeImage        agents.Override[bool]
	ExcludeAudio        agents.Override[bool]
	ExcludeTimestamp    agents.Override[bool]
	ExcludeFunctionCall bool
	ExcludeConfigUpdate bool
	StripMarkup         bool
}

type ChatContextValidationCode string

type ChatContextValidationIssue struct {
	Severity ChatContextValidationSeverity `json:"severity"`
	Code     ChatContextValidationCode     `json:"code"`
	Index    int                           `json:"index"`
	ItemID   string                        `json:"itemId"`
	Message  string                        `json:"message"`
}

type ChatContextValidationResult struct {
	Valid    bool                         `json:"valid"`
	Errors   int                          `json:"errors"`
	Warnings int                          `json:"warnings"`
	Issues   []ChatContextValidationIssue `json:"issues"`
}

type ChatContextValidationSeverity string

type ChatItem interface {
	ItemID() string
	ItemType() ItemType
	ItemCreatedAt() time.Time
	// contains filtered or unexported methods
}

type ChatMessage struct {
	ID                   string
	Role                 ChatRole
	Content              []Content
	Interrupted          bool
	TranscriptConfidence *float64
	Extra                map[string]any
	Metrics              MetricsReport
	Hash                 []byte
	CreatedAt            time.Time
}

type ChatOptions struct {
	ChatContext       *ChatContext
	ToolContext       *Context
	ConnectOptions    agents.APIConnectOptions
	ParallelToolCalls bool
	ToolChoice        ToolChoice
	Extra             map[string]any
}

type ChatRole string

type ChoiceDelta struct {
	Role      ChatRole
	Content   string
	ToolCalls []*FunctionCall
	Extra     map[string]any
}

type CollectedResponse struct {
	Text      string
	ToolCalls []*FunctionCall
	Usage     *CompletionUsage
	Extra     map[string]any
}

type CompletionUsage struct {
	CompletionTokens    int64
	PromptTokens        int64
	PromptCachedTokens  int64
	CacheCreationTokens int64
	TotalTokens         int64
	ServiceTier         string
}

type Content interface {
	// contains filtered or unexported methods
}

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

type CopyOptions struct {
	ExcludeFunctionCall bool
	ExcludeInstructions bool
	ExcludeEmptyMessage bool
	ExcludeHandoff      bool
	ExcludeConfigUpdate bool
	// ToolContext removes function calls/outputs for tools that are not
	// currently active, matching agents-js copy({ toolCtx }).
	ToolContext *Context
}

type DuplicateMode string

type DuplicatePromptArgs struct {
	FunctionName      string
	FunctionCallsJSON []string
	FunctionCallsText string
}

type ErrorEvent struct {
	Timestamp   time.Time
	Label       string
	Err         error
	Recoverable bool
}

type ExecutableTool interface {
	Tool
	Name() string
	Description() string
	Parameters() json.RawMessage
	Flags() ToolFlag
	OnDuplicate() DuplicateMode
	Execute(context.Context, json.RawMessage, ToolOptions) (any, error)
}

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

type FallbackOptions struct {
	LLMs             []LLM
	AttemptTimeout   time.Duration
	MaxRetriesPerLLM int
	RetryInterval    time.Duration
	RetryOnChunkSent bool
	StreamCapacity   int
	// KeepProvidersOpen transfers provider lifetime ownership to the caller.
	// By default Close closes every provider after in-flight recovery ends.
	KeepProvidersOpen bool
}

type FormatChatHistoryOptions struct {
	IncludeIDs        bool
	IncludeTimestamps bool
}

type FunctionCall struct {
	ID               string
	CallID           string
	Name             string
	Arguments        string
	CreatedAt        time.Time
	Extra            map[string]any
	GroupID          string
	ThoughtSignature string
}

type FunctionCallOutput struct {
	ID        string
	CallID    string
	Name      string
	Output    string
	IsError   bool
	CreatedAt time.Time
}

type FunctionTool[I any, O any] struct {
	// contains filtered or unexported fields
}

type FunctionToolOptions[I any, O any] struct {
	Name        string
	Description string
	Parameters  json.RawMessage
	Flags       ToolFlag
	OnDuplicate DuplicateMode
	Validate    func(*I) error
	Execute     func(context.Context, I, ToolOptions) (O, error)
}

type GenerateRealtimeReplyOptions struct {
	Instructions string
}

type GenerationCreatedEvent struct {
	MessageStream  stream.Reader[MessageGeneration]
	FunctionStream stream.Reader[*FunctionCall]
	UserInitiated  bool
	ResponseID     string
}

type ImageContent struct {
	ID              string
	Image           any
	InferenceDetail ImageDetail
	InferenceWidth  int
	InferenceHeight int
	MIMEType        string
}

type ImageDetail string

type InputSpeechStartedEvent struct{}

type InputSpeechStoppedEvent struct {
	UserTranscriptionEnabled bool
}

type InputTranscriptionCompletedEvent struct {
	ItemID        string
	Transcript    string
	IsFinal       bool
	TurnStartedAt *time.Time
}

type InstructionContent struct{ Instructions Instructions }

type Instructions struct {
	Audio string `json:"audio"`
	Text  string `json:"text,omitempty"`
	// contains filtered or unexported fields
}

type ItemType string

type LLM interface {
	Label() string
	Provider() string
	Model() string
	Chat(context.Context, ChatOptions) (LLMStream, error)
	Prewarm(context.Context)
	Close(context.Context) error
	OnMetrics(func(metrics.LLM)) func()
	OnError(func(ErrorEvent)) func()
}

type LLMStream interface {
	stream.Reader[ChatChunk]
	Collect(context.Context) (CollectedResponse, error)
	Close() error
	ChatContext() *ChatContext
	ToolContext() *Context
}

type MessageGeneration struct {
	MessageID   string
	TextStream  stream.Reader[RealtimeText]
	AudioStream stream.Reader[agents.AudioFrame]
	// Modalities is nil when the provider does not expose the asynchronous
	// modality result. Providers must return a fresh slice from the callback.
	Modalities func(context.Context) ([]Modality, error)
}

type MetricsReport struct {
	ProviderRequestIDs       []string
	StartedSpeakingAt        time.Time
	StoppedSpeakingAt        time.Time
	TranscriptionDelay       time.Duration
	EndOfTurnDelay           time.Duration
	OnUserTurnCompletedDelay time.Duration
	LLMNodeTTFT              time.Duration
	TTSNodeTTFB              time.Duration
	PlaybackLatency          time.Duration
	EndToEndLatency          time.Duration
}

type Modality string

type ProviderTool struct {
	ToolID string
	Data   map[string]any
}

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

type RealtimeCapabilities struct {
	MessageTruncation            bool
	TurnDetection                bool
	UserTranscription            bool
	AutoToolReplyGeneration      bool
	AudioOutput                  bool
	ManualFunctionCalls          bool
	MidSessionChatContextUpdate  bool
	MidSessionInstructionsUpdate bool
	MidSessionToolsUpdate        bool
	PerResponseToolChoice        bool
	NativeTranscriptSync         bool // Deprecated: retained for provider compatibility.
}

type RealtimeError struct {
	Operation string
	Err       error
}

type RealtimeModel interface {
	Capabilities() RealtimeCapabilities
	Model() string
	Provider() string
	Label() string
	Session(context.Context) (RealtimeSession, error)
	Close(context.Context) error
}

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

type RealtimeModelError struct {
	Type        string
	Timestamp   time.Time
	Label       string
	Err         error
	Recoverable bool
}

type RealtimeSession interface {
	RealtimeModel() RealtimeModel
	ChatContext() *ChatContext
	Tools() *Context
	UpdateInstructions(context.Context, string) error
	UpdateChatContext(context.Context, *ChatContext) error
	UpdateTools(context.Context, *Context) error
	UpdateOptions(context.Context, RealtimeUpdateOptions) error
	PushAudio(context.Context, agents.AudioFrame) error
	GenerateReply(context.Context, GenerateRealtimeReplyOptions) (GenerationCreatedEvent, error)
	CommitAudio(context.Context) error
	ClearAudio(context.Context) error
	Interrupt(context.Context) error
	Truncate(context.Context, TruncateRealtimeMessageOptions) error
	StartUserActivity()
	SetInputAudioStream(context.Context, stream.Reader[agents.AudioFrame]) error
	Close(context.Context) error

	OnInputSpeechStarted(func(InputSpeechStartedEvent)) func()
	OnInputSpeechStopped(func(InputSpeechStoppedEvent)) func()
	OnInputTranscriptionCompleted(func(InputTranscriptionCompletedEvent)) func()
	OnGenerationCreated(func(GenerationCreatedEvent)) func()
	OnMetrics(func(metrics.Realtime)) func()
	OnError(func(RealtimeModelError)) func()
	OnReconnected(func(RealtimeSessionReconnectedEvent)) func()
}

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

type RealtimeSessionReconnectedEvent struct{}

type RealtimeSessionUpdate struct {
	Instructions *string
	ChatContext  *ChatContext
	Tools        *Context
}

type RealtimeText struct {
	Text  string
	Timed *agents.TimedString
}

type RealtimeUpdateOptions struct {
	// ToolChoice uses Override so Unset means no change and Null explicitly
	// resets the provider's tool choice.
	ToolChoice agents.Override[ToolChoice]
}

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

type RemoteChatItem struct {
	Item           ChatItem
	PreviousItemID string
	NextItemID     string
}

type ReplyPromptArgs struct {
	CallIDs []string
}

type RunContext struct {
	UserData     any
	ToolCallID   string
	Session      any
	FunctionCall *FunctionCall
	// contains filtered or unexported fields
}

type RunContextFillerOptions struct {
	Delay    time.Duration
	Interval *time.Duration
	MaxSteps *int
}

type RunContextRuntime interface {
	ToolCurrentSpeechHandle() any
	ToolWaitForPlayout(context.Context) error
	ToolDisallowInterruptions() error
	ToolUpdate(context.Context, any, RunContextUpdateOptions) error
	ToolForeground(context.Context, func(context.Context, any) error) error
	ToolFiller(context.Context, any, RunContextFillerOptions, func(context.Context) error) error
}

type RunContextUpdateOptions struct {
	Template string
	// TemplateSet distinguishes an explicit empty template (deliver the raw
	// message) from an omitted template (inherit the executor default).
	TemplateSet  bool
	TemplateFunc func(UpdatePromptArgs) string
}

type TextContent string

type ThinkingTokenFilter struct {
	StartTag string
	EndTag   string
	// contains filtered or unexported fields
}

type Tool interface {
	Type() ToolType
	ID() string
}

type ToolChoice struct {
	Kind ToolChoiceKind
	Name string
}

type ToolChoiceKind string

type ToolError struct{ Message string }

type ToolFlag uint32

type ToolOptions struct {
	Context    *RunContext
	ToolCallID string
}

type ToolType string

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

type ToolsetContext interface{ UpdateTools([]Tool) error }

type ToolsetOptions struct {
	ID    string
	Tools []Tool
	Setup func(context.Context, ToolsetContext) error
	Close func(context.Context) error
}

type TruncateRealtimeMessageOptions struct {
	MessageID       string
	AudioEnd        time.Duration
	Modalities      []Modality
	AudioTranscript string
}

type UpdatePromptArgs struct {
	FunctionName string
	CallID       string
	Message      string
}