agently

type ChatCmd struct {
	AgentID   string `short:"a" long:"agent-id" description:"agent id"`
	Query     string `short:"q" long:"query"    description:"user query"`
	ConvID    string `short:"c" long:"conv"     description:"conversation ID (optional)"`
	Policy    string `short:"p" long:"policy" description:"tool policy: auto|ask|deny" default:"auto"`
	ResetLogs bool   `long:"reset-logs" description:"truncate/clean log files before each run"  `
	Timeout   int    `short:"t" long:"timeout" description:"timeout in seconds for the agent response (0=none)" `
	User      string `short:"u" long:"user" description:"user id for the chat" default:"devuser"`

	// Arbitrary JSON payload that will be forwarded to the agent as contextual
	// information. It can be supplied either as an inline JSON string or as
	// @<path> pointing to a file containing the JSON document.
	Context string `long:"context" description:"inline JSON object or @file with context data"`

	// Attach allows adding one or more files to the LLM request. Repeatable.
	// Format: <path>[::caption]
	Attach []string `long:"attach" description:"file to attach (repeatable). Format: <path>[::caption]"`
}

type ExecCmd struct {
	Name       string `short:"n" long:"name" positional-arg-name:"tool" description:"Tool name (service_method)" required:"yes"`
	Inline     string `short:"i" long:"input" description:"Inline JSON arguments (object)"`
	File       string `short:"f" long:"file" description:"Path to JSON file with arguments (use - for stdin)"`
	TimeoutSec int    `long:"timeout" description:"Seconds to wait for completion" default:"120"`
	JSON       bool   `long:"json" description:"Print result as JSON"`
}

type ListCmd struct{}

type ListToolsCmd struct {
	Name string `short:"n" long:"name" description:"Tool name (service_method) to show full definition"`
	JSON bool   `long:"json" description:"Print result as JSON instead of table/plain text"`
}

type McpAddCmd struct {
	Name string `short:"n" long:"name" required:"yes" description:"identifier"`

	// Accept legacy and new aliases: stdio|sse|streaming plus streamable/streamableHTTP
	Type string `` /* 127-byte string literal not displayed */

	// HTTP
	URL string `long:"url" description:"server URL when type=sse|streaming"`

	// stdio
	Command   string   `long:"command" description:"command path when type=stdio"`
	Arguments []string `long:"arg" description:"extra arguments (repeatable)"`
}

type McpCmd struct {
	Add    *McpAddCmd    `command:"add" description:"Add or update MCP server"`
	Remove *McpRemoveCmd `command:"remove" description:"Delete MCP server"`
	List   *McpListCmd   `command:"list" description:"List MCP servers"`
}

type McpListCmd struct {
	JSON bool `long:"json" description:"output full JSON objects"`
}

type McpRemoveCmd struct {
	Name string `short:"n" long:"name" required:"yes" description:"identifier to delete"`
}

type ModelResetCmd struct {
	Agent string `short:"a" long:"agent" description:"agent file name (without extension)" required:"yes"`
}

type ModelSwitchCmd struct {
	Agent string `short:"a" long:"agent" description:"agent file name (without extension)" required:"yes"`
	Model string `short:"m" long:"model" description:"model name to set as default" required:"yes"`
}

type Options struct {
	Version     bool            `short:"v" long:"version" description:"Show agently version and exit"`
	Config      string          `short:"f" long:"config" description:"executor config YAML/JSON path"`
	Chat        *ChatCmd        `command:"chat"  description:"Chat with an agent (single turn or continuation)"`
	List        *ListCmd        `command:"list"  description:"List existing conversations"`
	ListTools   *ListToolsCmd   `command:"list-tools" description:"List available tools"`
	Exec        *ExecCmd        `command:"exec" description:"Execute a tool"`
	Run         *RunCmd         `command:"run"   description:"Run agentic workflow from JSON input"`
	ModelSwitch *ModelSwitchCmd `command:"model-switch" description:"Switch agent default model"`
	ModelReset  *ModelResetCmd  `command:"model-reset" description:"Clear agent model override"`
	Workspace   *WorkspaceCmd   `command:"ws" description:"Workspace CRUD operations"`
	Serve       *ServeCmd       `command:"serve" description:"StartedAt HTTP server"`
	MCP         *McpCmd         `command:"mcp" description:"Manage MCP servers"`
}

type RunCmd struct {
	Location  string `short:"l" long:"location" description:"agent definition path"`
	InputFile string `short:"i" long:"input"    description:"JSON file with QueryInput (stdin if empty)"`
	Policy    string `long:"policy" description:"tool policy: auto|ask|deny" default:"auto"`
}

type ServeCmd struct {
	Addr   string `short:"a" long:"addr" description:"listen address" default:":8080"`
	Policy string `short:"p" long:"policy" description:"tool policy: auto|ask|deny" default:"auto"`

	// Unified log file capturing LLM, tool and task events. Defaults to
	// "agently.log" in the current working directory when empty.
	Log string `long:"log" description:"unified log (LLM, TOOL, TASK)" default:"agently.log"`
}

type WorkspaceCmd struct {
	List   *WsListCmd   `command:"list" description:"List resources (agents|models|workflows)"`
	Get    *WsGetCmd    `command:"get" description:"Print resource YAML"`
	Add    *WsAddCmd    `command:"add" description:"Add or overwrite a resource"`
	Remove *WsRemoveCmd `command:"remove" description:"Delete resource"`
}

type WsAddCmd struct {
	File string `short:"f" long:"file" description:"YAML file ('-' for stdin)"`
	// contains filtered or unexported fields
}

type WsGetCmd struct {
	// contains filtered or unexported fields
}

type WsListCmd struct {
	// contains filtered or unexported fields
}

type WsRemoveCmd struct {
	// contains filtered or unexported fields
}