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:"-"`

	// 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 []string     `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 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"`
}