agent

type APIError = provider.APIError

type AfterToolCallContext struct {
	AssistantMessage ChatMessage
	ToolCall         ToolCall
	Result           string
	IsError          bool
	SystemPrompt     string
	Messages         []ChatMessage
}

type AfterToolCallResult struct {
	Result  *string
	IsError *bool
	Flow    ToolFlowDecision
}

type Agent struct {
	Cfg Config
	// contains filtered or unexported fields
}

type AgentType struct {
	FormattedPrompt string
	Model           string
	Background      bool
}

type AgentTypeResolver func(name string) (AgentType, error)

type BeforeToolCallContext struct {
	AssistantMessage ChatMessage
	ToolCall         ToolCall
	SystemPrompt     string
	Messages         []ChatMessage
}

type BeforeToolCallResult struct {
	Block  bool
	Reason string
}

type CacheRetention = provider.CacheRetention

type ChatCompletionRequest = provider.ChatCompletionRequest

type ChatCompletionResponse = provider.ChatCompletionResponse

type ChatCompletionStreamEvent = provider.ChatCompletionStreamEvent

type ChatMessage = provider.ChatMessage

type ChatMessageDelta = provider.ChatMessageDelta

type Choice = provider.Choice

type CompactConfig struct {
	Provider           Provider
	Model              string
	KeepRecentTokens   int
	CustomInstructions string
}

type CompactResult struct {
	TokensBefore int
	TokensAfter  int
	KeptMessages int
}

type Config struct {
	Provider         Provider
	Tools            *commands.CommandRegistry
	Model            string
	Fallbacks        []ProviderEntry
	SystemPrompt     string
	SystemPromptFn   SystemPromptFunc
	Messages         []ChatMessage
	MaxTokens        int
	Temperature      *float64
	Stream           bool
	MaxRetries       int
	TokenBudget      int
	ResponseFormat   *ResponseFormat
	Logger           telemetry.Logger
	TransformContext TransformContextFunc
	Bus              *eventbus.Bus[Event]
	BeforeToolCall   func(context.Context, BeforeToolCallContext) (*BeforeToolCallResult, error)
	AfterToolCall    func(context.Context, AfterToolCallContext) (*AfterToolCallResult, error)
	MaxTurns         int
	LoopScheduler    *LoopScheduler
	Inbox            inbox.Inbox
	Expander         *inbox.Expander
	MaxResultSize    int
	MaxParallelTools int
	CacheRetention   CacheRetention
	SessionID        string
	ParentSessionID  string
}

type ContentPart = provider.ContentPart

type CronExpr struct {
	Minute  []bool // [0..59]
	Hour    []bool // [0..23]
	Day     []bool // [1..31]
	Month   []bool // [1..12]
	Weekday []bool // [0..6]
	Raw     string
}

type Event struct {
	Type            EventType
	SessionID       string
	ParentSessionID string
	Turn            int
	EmittedAt       time.Time
	Request         *ChatCompletionRequest
	Message         ChatMessage
	Messages        []ChatMessage
	NewMessages     []ChatMessage
	ToolResults     []ChatMessage
	ToolCallID      string
	ToolName        string
	Arguments       string
	Result          string
	IsError         bool
	Err             error
	StartedAt       time.Time // tool execution start time (set on ToolExecutionEnd)
	Stop            StopReason
	Usage           *Usage
	TotalUsage      *Usage // cumulative usage across all turns (set on TurnEnd/AgentEnd)
	ContextTokens   int
	EvalRound       int
	EvalPass        bool
	EvalReason      string
	EvalError       string

	CompactTokensBefore int
	CompactTokensAfter  int
	CompactKeptMessages int
}

type EventType string

type FinishTool struct{}

type FunctionCall = provider.FunctionCall

type FunctionCallDelta = provider.FunctionCallDelta

type FunctionDefinition = provider.FunctionDefinition

type ImageURL = provider.ImageURL

type JSONSchemaSpec = provider.JSONSchemaSpec

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

type LoopEntry struct {
	Name      string
	Cron      *CronExpr
	Interval  time.Duration
	Prompt    string
	Mode      LoopMode
	Immediate bool
	CreatedAt time.Time
}

type LoopInfo struct {
	Name      string    `json:"name"`
	Prompt    string    `json:"prompt"`
	Schedule  string    `json:"schedule"`
	Mode      LoopMode  `json:"mode"`
	FireCount int       `json:"fire_count"`
	LastFired time.Time `json:"last_fired,omitempty"`
}

type LoopMode int

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

type Provider = provider.Provider

type ProviderConfig = provider.ProviderConfig

type ProviderEntry struct {
	Provider Provider
	Model    string
}

type ResponseFormat = provider.ResponseFormat

type Result struct {
	Output        string
	NewMessages   []ChatMessage
	Messages      []ChatMessage
	Turns         int
	TotalUsage    Usage
	TurnUsages    []TurnUsage
	ContextTokens int
	Stop          StopReason
	Err           error
}

type SessionData struct {
	Version   int           `json:"version"`
	CreatedAt time.Time     `json:"created_at"`
	UpdatedAt time.Time     `json:"updated_at"`
	Model     string        `json:"model,omitempty"`
	Provider  string        `json:"provider,omitempty"`
	Messages  []ChatMessage `json:"messages"`
}

type SessionInfo struct {
	Path      string
	CreatedAt time.Time
	UpdatedAt time.Time
	ModTime   time.Time
	Model     string
	Provider  string
	Messages  int
}

type State struct {
	SystemPrompt string
	Messages     []ChatMessage
	Tools        *commands.CommandRegistry
	ErrorMessage string
	LastError    error
}

type StopReason string

type StreamingProvider = provider.StreamingProvider

type SubAgentArgs struct {
	Action  string `` /* 203-byte string literal not displayed */
	Prompt  string `json:"prompt"            jsonschema:"description=Task description for the subagent (required for create)"`
	Mode    string `` /* 224-byte string literal not displayed */
	Type    string `json:"type,omitempty"    jsonschema:"description=Agent type name (a skill with agent:true)"`
	Name    string `json:"name,omitempty"    jsonschema:"description=Human-readable label for tracking"`
	Message string `json:"message,omitempty" jsonschema:"description=Message to send (action=message requires name)"`
	Timeout string `json:"timeout,omitempty" jsonschema:"description=Optional timeout for sync mode (e.g. 30s or 2m). Returns error on timeout."`
}

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

type SystemPromptFunc func(cfg *Config) string

type ToolCall = provider.ToolCall

type ToolCallDelta = provider.ToolCallDelta

type ToolDefinition = provider.ToolDefinition

type ToolFlowDecision int

type TransformContextFunc func([]ChatMessage) []ChatMessage

type TurnUsage struct {
	Turn             int `json:"turn"`
	PromptTokens     int `json:"prompt_tokens"`
	CompletionTokens int `json:"completion_tokens"`
	TotalTokens      int `json:"total_tokens"`
	CacheReadTokens  int `json:"cache_read_tokens,omitempty"`
	CacheWriteTokens int `json:"cache_write_tokens,omitempty"`
}

type Usage = provider.Usage