cmd

type AgentCommands struct {
	ListAgents ListAgentsCommand `cmd:"" name:"agents" help:"List agents." group:"TOOLS & AGENTS"`
	GetAgent   GetAgentCommand   `cmd:"" name:"agent" help:"Get an agent by name." group:"TOOLS & AGENTS"`
	CallAgent  CallAgentCommand  `cmd:"" name:"agent-call" help:"Call an agent by name." group:"TOOLS & AGENTS"`
}

type AskCommand struct {
	schema.GeneratorMeta `embed:""`
	Text                 string   `arg:"" help:"User input text"`
	File                 []string `name:"file" help:"Path or glob pattern for files to attach (may be repeated)" optional:""`
	Stream               bool     `name:"stream" help:"Stream the response as it is generated." default:"true" negatable:""`
	Out                  string   `name:"out" type:"dir" help:"Path to write response attachments (defaults to stdout)" optional:""`
}

type AskCommands struct {
	Ask AskCommand `cmd:"" name:"ask" help:"Send a stateless text request to a model." group:"RESPONSES"`
}

type CallAgentCommand struct {
	Name  string `arg:"" name:"name" help:"Agent name"`
	Input string `arg:"" name:"input" help:"JSON input payload" optional:""`
}

type CallToolCommand struct {
	Name  string `arg:"" name:"name" help:"Tool name"`
	Input string `arg:"" name:"input" help:"JSON input payload" optional:""`
}

type ChannelCommand struct {
	Session uuid.UUID `name:"session" help:"Session ID (defaults to the stored current session)." optional:""`
}

type ChannelCommands struct {
	SessionUI ChannelCommand `cmd:"" name:"session-ui" help:"Open the interactive session UI for an existing session." group:"RESPONSES"`
}

type ChatCommand struct {
	Session       uuid.UUID `name:"session" help:"Session ID (defaults to the stored current session)" optional:""`
	Text          string    `arg:"" help:"User input text"`
	Tools         []string  `name:"tool" help:"Tool names to include (may be repeated; nil means all, empty means none)" optional:""`
	MaxIterations uint      `name:"max-iterations" help:"Maximum tool-calling iterations (0 uses default)" optional:""`
	SystemPrompt  string    `name:"system-prompt" help:"Per-request system prompt appended to the session prompt" optional:""`
	Stream        bool      `name:"stream" help:"Stream the response as it is generated." default:"true" negatable:""`
	Out           string    `name:"out" type:"dir" help:"Path to write response attachments (defaults to stdout)" optional:""`
}

type ChatCommands struct {
	Chat ChatCommand `cmd:"" name:"chat" help:"Send a message within an existing session." group:"RESPONSES"`
}

type ConnectorCommands struct {
	ListConnectors  ListConnectorsCommand  `cmd:"" name:"connectors" help:"List connectors." group:"CONNECTORS"`
	CreateConnector CreateConnectorCommand `cmd:"" name:"connector-create" help:"Create a connector." group:"CONNECTORS"`
	DeleteConnector DeleteConnectorCommand `cmd:"" name:"connector-delete" help:"Delete a connector by URL." group:"CONNECTORS"`
	GetConnector    GetConnectorCommand    `cmd:"" name:"connector" help:"Get a connector by URL." group:"CONNECTORS"`
	UpdateConnector UpdateConnectorCommand `cmd:"" name:"connector-update" help:"Update connector metadata." group:"CONNECTORS"`
}

type CreateConnectorCommand struct {
	URL string `arg:"" name:"url" help:"MCP server endpoint URL"`
	schema.ConnectorMeta
}

type CreateProviderCommand struct {
	schema.ProviderInsert `embed:""`
}

type CreateSessionCommand struct {
	schema.SessionInsert `embed:""`
}

type DeleteConnectorCommand struct {
	URL string `arg:"" name:"url" help:"MCP server endpoint URL"`
}

type DeleteModelCommand struct {
	Name     string `arg:"" name:"name" help:"Model name to delete"`
	Provider string `name:"provider" help:"Provider name" optional:""`
}

type DeleteProviderCommand struct {
	Name string `arg:"" name:"name" help:"Provider name"`
}

type DeleteSessionCommand struct {
	ID uuid.UUID `arg:"" name:"id" help:"Session ID."`
}

type DownloadModelCommand struct {
	Name     string `arg:"" name:"name" help:"Model name to download"`
	Provider string `name:"provider" help:"Provider name" optional:""`
	Progress bool   `name:"progress" help:"Show download progress" default:"true" negatable:""`
}

type EmbeddingCommand struct {
	schema.EmbeddingRequest `embed:""`
	CSV                     string `` /* 147-byte string literal not displayed */
	Out                     string `name:"out" type:"file" placeholder:"FILE" help:"Path to output CSV file (defaults to stdout)" optional:""`
}

type EmbeddingCommands struct {
	Embedding EmbeddingCommand `` /* 126-byte string literal not displayed */
}

type GetAgentCommand struct {
	Name string `arg:"" name:"name" help:"Agent name"`
}

type GetConnectorCommand struct {
	URL string `arg:"" name:"url" help:"MCP server endpoint URL"`
}

type GetModelCommand struct {
	Name      string `arg:"" name:"name" help:"Model name" optional:""`
	Provider  string `name:"provider" help:"Provider name" optional:""`
	Default   bool   `name:"default" help:"Save as the default model" optional:""`
	Embedding bool   `name:"embedding" help:"Use the embedding model defaults instead of the completion model defaults" optional:""`
}

type GetProviderCommand struct {
	Name string `arg:"" name:"name" help:"Provider name"`
}

type GetSessionCommand struct {
	ID      uuid.UUID `arg:"" name:"id" help:"Session ID (defaults to the stored current session)." optional:""`
	Default bool      `name:"default" help:"Save as the default session" optional:""`
}

type GetToolCommand struct {
	Name string `arg:"" name:"name" help:"Tool name"`
}

type ListAgentsCommand struct {
	schema.AgentListRequest `embed:""`
}

type ListConnectorsCommand struct {
	schema.ConnectorListRequest `embed:""`
}

type ListMessagesCommand struct {
	Session                   uuid.UUID `arg:"" name:"id" help:"Session ID (defaults to the stored current session)." optional:""`
	schema.MessageListRequest `embed:""`
}

type ListModelsCommand struct {
	schema.ModelListRequest `embed:""`
}

type ListProvidersCommand struct {
	schema.ProviderListRequest `embed:""`
}

type ListSessionsCommand struct {
	schema.SessionListRequest `embed:""`
}

type ListToolsCommand struct {
	schema.ToolListRequest `embed:""`
}

type ModelCommands struct {
	ListModels    ListModelsCommand    `cmd:"" name:"models" help:"List models." group:"MODELS"`
	DownloadModel DownloadModelCommand `cmd:"" name:"model-download" help:"Download a model." group:"MODELS"`
	DeleteModel   DeleteModelCommand   `cmd:"" name:"model-delete" help:"Delete a model by name." group:"MODELS"`
	GetModel      GetModelCommand      `cmd:"" name:"model" help:"Get a model by name." group:"MODELS"`
}

type PostgresFlags struct {
	Url      string `name:"url" env:"PG_URL" help:"PostgreSQL connection URL"`
	Password string `name:"password" env:"PG_PASSWORD" help:"PostgreSQL password"`
}

type ProviderCommands struct {
	ListProviders  ListProvidersCommand  `cmd:"" name:"providers" help:"List providers." group:"PROVIDERS"`
	CreateProvider CreateProviderCommand `cmd:"" name:"provider-create" help:"Create a provider." group:"PROVIDERS"`
	DeleteProvider DeleteProviderCommand `cmd:"" name:"provider-delete" help:"Delete a provider by name." group:"PROVIDERS"`
	GetProvider    GetProviderCommand    `cmd:"" name:"provider" help:"Get a provider by name." group:"PROVIDERS"`
	UpdateProvider UpdateProviderCommand `cmd:"" name:"provider-update" help:"Update provider metadata." group:"PROVIDERS"`
}

type RunServer struct {
	cmd.RunServer

	// Postgres connection flags
	PostgresFlags `embed:"" prefix:"pg."`

	// Schemas for tenancy
	Schema struct {
		Auth   string `name:"auth" help:"PostgreSQL schema for auth data." default:"auth"`
		LLM    string `name:"llm" help:"PostgreSQL schema for LLM data." default:"llm"`
		Memory string `name:"memory" help:"PostgreSQL schema for memory data." default:"memory"`
	} `embed:"" prefix:"schema."`

	// Home Assistant connector options
	HomeAssistant struct {
		Endpoint string `help:"Home Assistant endpoint URL." env:"HA_ENDPOINT"`
		APIKey   string `help:"Home Assistant long-lived access token." env:"HA_TOKEN"`
	} `embed:"" prefix:"homeassistant."`

	// Other flags
	Passphrases []string `name:"passphrase" env:"${ENV_NAME}_PASSPHRASES" help:"One or more passphrases used to encrypt credentials. "`
	Auth        bool     `name:"auth" help:"Enable authentication for protected endpoints." default:"true" negatable:""`
	Memory      bool     `name:"memory" help:"Enable memory and related endpoints." default:"true" negatable:""`
}

type SessionCommands struct {
	ListSessions  ListSessionsCommand  `cmd:"" name:"sessions" help:"List sessions." group:"SESSIONS"`
	ListMessages  ListMessagesCommand  `cmd:"" name:"session-messages" help:"List messages for a session." group:"SESSIONS"`
	CreateSession CreateSessionCommand `cmd:"" name:"session-create" help:"Create a new session." group:"SESSIONS"`
	GetSession    GetSessionCommand    `cmd:"" name:"session" help:"Get a session by ID or the stored current session." group:"SESSIONS"`
	UpdateSession UpdateSessionCommand `cmd:"" name:"session-update" help:"Update session metadata." group:"SESSIONS"`
	DeleteSession DeleteSessionCommand `cmd:"" name:"session-delete" help:"Delete a session by ID." group:"SESSIONS"`
}

type ToolCommands struct {
	ListTools ListToolsCommand `cmd:"" name:"tools" help:"List tools." group:"TOOLS & AGENTS"`
	GetTool   GetToolCommand   `cmd:"" name:"tool" help:"Get a tool by name." group:"TOOLS & AGENTS"`
	CallTool  CallToolCommand  `cmd:"" name:"tool-call" help:"Call a tool by name." group:"TOOLS & AGENTS"`
}

type UpdateConnectorCommand struct {
	URL string `arg:"" name:"url" help:"MCP server endpoint URL"`
	schema.ConnectorMeta
}

type UpdateProviderCommand struct {
	Name                string `arg:"" name:"name" help:"Provider name"`
	schema.ProviderMeta `embed:""`
}

type UpdateSessionCommand struct {
	ID                 uuid.UUID `arg:"" name:"id" help:"Session ID (defaults to the stored current session)." optional:""`
	schema.SessionMeta `embed:""`
}