Struct Agent

pkg/agent/agent.go:22–66

Agent represents an AI agent

// Agent represents an AI agent
type Agent struct {
	name                    string
	description             string
	welcomeMessage          string
	instruction             string
	toolsets                []*tools.StartableToolSet
	models                  []provider.Provider
	fallbackModels          []provider.Provider                 // Fallback models to try if primary fails
	fallbackRetries         int                                 // Number of retries per fallback model with exponential backoff
	fallbackCooldown        time.Duration                       // Duration to stick with fallback after non-retryable error
	titleModel              provider.Provider                   // Optional dedicated model for session-title generation
	compactionModel         provider.Provider                   // Optional dedicated model for session compaction (summary generation)
	modelOverrides          atomic.Pointer[[]provider.Provider] // Optional model override(s) set at runtime (supports alloy)
	subAgents               []*Agent
	handoffs                []*Agent
	forceHandoff            *Agent
	parents                 []*Agent
	addDate                 bool
	addEnvironmentInfo      bool
	addDescriptionParameter bool
	redactSecrets           bool
	saferShell              bool
	maxIterations           int
	maxConsecutiveToolCalls int
	maxOldToolCallTokens    int
	numHistoryItems         int
	addPromptFiles          []string
	tools                   []tools.Tool
	commands                types.Commands
	harness                 *latest.HarnessConfig
	hooks                   *latest.HooksConfig
	cache                   *cache.Cache

	// warningsMu guards pendingWarnings. AddToolWarning and DrainWarnings
	// may be called concurrently from the runtime loop, the MCP server,
	// the TUI and session manager.
	warningsMu      sync.Mutex
	pendingWarnings []string

	// collisionsMu guards reportedCollisions, the once-per-streak guard for
	// duplicate-tool-name warnings. collectTools may run concurrently from
	// the runtime loop and MCP notification handlers.
	collisionsMu       sync.Mutex
	reportedCollisions map[string]bool
}

// New creates a new agent
func New(name, prompt string, opts ...Opt) *Agent {