commands

type AgentConfig struct {
	Root string `help:"Agent root directory (FHS layout)" default:"/"`

	// Provider/model wiring is operator-controlled, kept on the CLI
	// surface so dev invocations of the runtime binary outside the
	// daemon can still run a one-shot chat. Inside the daemon
	// they're set from agent.yaml + the provider catalog.
	Model   string `help:"Model identifier (e.g. anthropic/claude-sonnet-4-20250514)" optional:""`
	Name    string `help:"Agent name" default:"agent"`
	APIKey  string `help:"API key for the provider" optional:""`
	APIBase string `help:"Custom API base URL for the provider" optional:""`
	Addr    string `help:"gRPC listen address" default:":8080"`

	// Runtime tunables — never CLI flags. Populated from agent.yaml's
	// `configs:` block by loadAgentConfig. Plain Go fields with
	// `kong:"-"` so Kong leaves them untouched.
	MaxTokens     int               `kong:"-"`
	MaxIterations int               `kong:"-"`
	Memory        MemoryServeConfig `kong:"-"`
	Notes         NotesServeConfig  `kong:"-"`

	// Provider sampling knobs. Pointer types so "unset" stays
	// distinguishable from a deliberately-zero value (temperature: 0
	// means deterministic, not "use the default"). Forwarded to
	// fantasy only when non-nil.
	Temperature      *float64 `kong:"-"`
	TopP             *float64 `kong:"-"`
	TopK             *int64   `kong:"-"`
	PresencePenalty  *float64 `kong:"-"`
	FrequencyPenalty *float64 `kong:"-"`

	// Persisted-config inputs from agent.yaml: tools list and the
	// ordered context files. Also never CLI flags.
	Tools   []ToolConfig        `kong:"-" yaml:"tools,omitempty" json:"tools,omitempty"`
	Context []agent.ContextFile `kong:"-" yaml:"context,omitempty" json:"context,omitempty"`
}

type MemoryServeConfig struct {
	Strategy    string `json:"strategy,omitempty" yaml:"strategy,omitempty"`
	MaxMessages int    `json:"max_messages,omitempty" yaml:"max_messages,omitempty"`
	MaxTokens   int    `json:"max_tokens,omitempty" yaml:"max_tokens,omitempty"`
}

type NotesServeConfig struct {
	MaxBytesPer   int    `json:"max_bytes_per,omitempty" yaml:"max_bytes_per,omitempty"`
	MaxCount      int    `json:"max_count,omitempty"      yaml:"max_count,omitempty"`
	PromptSection string `json:"prompt_section,omitempty" yaml:"prompt_section,omitempty"`
}

type Prompt struct {
	AgentConfig `embed:""`
	Message     string `arg:"" help:"Message to send to the agent"`
}

type Serve struct {
	AgentConfig `embed:""`
}

type ToolConfig struct {
	Name        string   `json:"name" yaml:"name"`
	Description string   `json:"description" yaml:"description"`
	Binary      string   `json:"binary" yaml:"binary"`
	Args        []string `json:"args,omitempty" yaml:"args,omitempty"`
	Usage       string   `json:"usage,omitempty" yaml:"usage,omitempty"`
}