commands

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

	Model         string `help:"Model identifier (e.g. anthropic/claude-sonnet-4-20250514)" optional:""`
	Name          string `help:"Agent name" default:"agent"`
	MaxTokens     int    `help:"Max output tokens" default:"4096"`
	MaxIterations int    `help:"Max tool iterations per turn" default:"20"`

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

	Tools     []ToolConfig      `help:"Tool configurations" yaml:"tools,omitempty" json:"tools,omitempty"`
	Neighbors []NeighborConfig  `help:"Neighbor agent configurations" yaml:"neighbors,omitempty" json:"neighbors,omitempty"`
	Memory    MemoryServeConfig `embed:"" prefix:"memory-"`
}

type MemoryServeConfig struct {
	Strategy    string `json:"strategy,omitempty" yaml:"strategy,omitempty" help:"Compaction strategy (sliding or summarize)" default:"summarize"`
	MaxMessages int    `json:"max_messages,omitempty" yaml:"max_messages,omitempty" help:"Max messages before compaction" default:"20"`
	MaxTokens   int    `json:"max_tokens,omitempty" yaml:"max_tokens,omitempty" help:"Max estimated tokens before compaction" default:"0"`
}

type NeighborConfig struct {
	Name  string `json:"name" yaml:"name"`
	URL   string `json:"url" yaml:"url"`
	WSUrl string `json:"ws_url,omitempty" yaml:"ws_url,omitempty"`
	Token string `json:"token,omitempty" yaml:"token,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"`
	Docs        ToolDocs `json:"docs,omitempty" yaml:"docs,omitempty"`
}

type ToolDocs struct {
	Usage string `json:"usage,omitempty" yaml:"usage,omitempty"`
}