agent

Documentation

Overview

Package agent provides the Agent type which represents a running LLM agent instance.

Index

• type Agent
  • func New(cfg config.Config, paths config.Paths, rt *config.Runtime, name string, ...) (*Agent, error)
• type Overrides

Types

type Agent

type Agent struct {
	Name           string
	Model          config.Model
	Provider       providers.Provider
	Mode           string
	System         string // system prompt name (empty = agent default or default compositor)
	Tools          tool.Tools
	Prompt         string // rendered system prompt
	Thinking       thinking.Strategy
	ResponseFormat *responseformat.ResponseFormat
}

Agent represents a running LLM agent with all its runtime state.

func New

func New(
	cfg config.Config,
	paths config.Paths,
	rt *config.Runtime,
	name string,
	overrides ...Overrides,
) (*Agent, error)

New creates a new Agent from configuration with optional overrides.

type Overrides

type Overrides struct {
	Agent      *string // nil = no override (use session/default agent); for ResumeSession branching only
	Mode       *string
	System     *string
	Think      *thinking.Value
	Provider   *string
	Model      *string
	Context    *int                   // --override model.context
	Generation *generation.Generation // --override model.generation.*
	Vars       map[string]string      // --set template variables, threaded to BuildAgent
}

Overrides holds CLI flag overrides applied on top of agent config. Pointer fields use nil = no override, non-nil = explicit value (including empty to clear).