cmd

type AuthCmd struct {
	Setup  AuthSetupCmd  `cmd:"" help:"Configure OAuth credentials"`
	Login  AuthLoginCmd  `cmd:"" help:"Authenticate with Front"`
	Logout AuthLogoutCmd `cmd:"" help:"Remove stored tokens"`
	Status AuthStatusCmd `cmd:"" help:"Show authentication status"`
	List   AuthListCmd   `cmd:"" help:"List authenticated accounts"`
}

type AuthListCmd struct{}

type AuthLoginCmd struct {
	Email        string `help:"Email/identifier to associate with this token" name:"email"`
	ClientName   string `help:"Client name" default:"default" name:"client-name"`
	ForceConsent bool   `help:"Force consent prompt even if already authorized"`
	Manual       bool   `help:"Manual authorization (paste URL instead of callback server)"`
}

type AuthLogoutCmd struct {
	Email      string `help:"Email/account to log out" name:"email"`
	ClientName string `help:"Client name" default:"default" name:"client-name"`
	All        bool   `help:"Log out all accounts for this client"`
}

type AuthSetupCmd struct {
	ClientID     string `arg:"" help:"OAuth client ID"`
	ClientSecret string `name:"client-secret" help:"OAuth client secret (for non-interactive use)"`
	ClientName   string `help:"Client name (default: default)" default:"default" name:"client-name"`
	RedirectURI  string `help:"OAuth redirect URI" default:"https://localhost:8484/callback"`
}

type AuthStatusCmd struct {
	ClientName string `help:"Client name" default:"default" name:"client-name"`
}

type CLI struct {
	RootFlags `embed:""`

	Version    kong.VersionFlag `help:"Print version and exit"`
	VersionCmd VersionCmd       `cmd:"" name:"version" help:"Print version"`
	Config     ConfigCmd        `cmd:"" help:"Manage configuration"`
	Auth       AuthCmd          `cmd:"" help:"Authentication and credentials"`
	Conv       ConvCmd          `cmd:"" name:"conversations" aliases:"conv" help:"Conversations"`
	Msg        MsgCmd           `cmd:"" name:"messages" aliases:"msg" help:"Messages"`
	Draft      DraftCmd         `cmd:"" name:"drafts" help:"Drafts"`
	Tag        TagCmd           `cmd:"" name:"tags" help:"Tags"`
	Inbox      InboxCmd         `cmd:"" name:"inboxes" help:"Inboxes"`
	Teammate   TeammateCmd      `cmd:"" name:"teammates" help:"Teammates"`
	Contact    ContactCmd       `cmd:"" name:"contacts" help:"Contacts"`
	Channel    ChannelCmd       `cmd:"" name:"channels" help:"Channels"`
	Comment    CommentCmd       `cmd:"" name:"comments" help:"Comments (internal discussions)"`
	Template   TemplateCmd      `cmd:"" name:"templates" help:"Templates (canned responses)"`
	Completion CompletionCmd    `cmd:"" help:"Generate shell completions"`
	Whoami     WhoamiCmd        `cmd:"" help:"Show authenticated user info"`
}

type ChannelCmd struct {
	List ChannelListCmd `cmd:"" help:"List channels"`
	Get  ChannelGetCmd  `cmd:"" help:"Get a channel"`
}

type ChannelGetCmd struct {
	ID string `arg:"" help:"Channel ID"`
}

type ChannelListCmd struct{}

type CommentCmd struct {
	List   CommentListCmd   `cmd:"" help:"List comments in a conversation"`
	Get    CommentGetCmd    `cmd:"" help:"Get a comment"`
	Create CommentCreateCmd `cmd:"" help:"Create a comment"`
}

type CommentCreateCmd struct {
	ConvID string `arg:"" help:"Conversation ID"`
	Body   string `required:"" help:"Comment body (@mentions supported)"`
}

type CommentGetCmd struct {
	ID string `arg:"" help:"Comment ID"`
}

type CommentListCmd struct {
	ConvID string `arg:"" help:"Conversation ID"`
}

type CompletionBashCmd struct{}

type CompletionCmd struct {
	Bash CompletionBashCmd `cmd:"" help:"Generate bash completions"`
	Zsh  CompletionZshCmd  `cmd:"" help:"Generate zsh completions"`
	Fish CompletionFishCmd `cmd:"" help:"Generate fish completions"`
}

type CompletionFishCmd struct{}

type CompletionZshCmd struct{}

type ConfigCmd struct {
	Path ConfigPathCmd `cmd:"" help:"Show configuration paths"`
}

type ConfigPathCmd struct{}

type ContactCmd struct {
	List    ContactListCmd    `cmd:"" help:"List contacts"`
	Search  ContactSearchCmd  `cmd:"" help:"Search contacts"`
	Get     ContactGetCmd     `cmd:"" help:"Get a contact"`
	Handles ContactHandlesCmd `cmd:"" help:"List contact handles"`
	Handle  ContactHandleCmd  `cmd:"" help:"Manage contact handles"`
	Notes   ContactNotesCmd   `cmd:"" help:"List contact notes"`
	Note    ContactNoteCmd    `cmd:"" help:"Manage contact notes"`
	Convos  ContactConvosCmd  `cmd:"" help:"List conversations for a contact"`
	Create  ContactCreateCmd  `cmd:"" help:"Create a contact"`
	Update  ContactUpdateCmd  `cmd:"" help:"Update a contact"`
	Delete  ContactDeleteCmd  `cmd:"" help:"Delete a contact"`
	Merge   ContactMergeCmd   `cmd:"" help:"Merge contacts"`
}

type ContactConvosCmd struct {
	ID    string `arg:"" help:"Contact ID"`
	Limit int    `help:"Maximum results" default:"25"`
}

type ContactCreateCmd struct {
	Handle      string `required:"" help:"Contact handle (e.g., email:[email protected])"`
	Name        string `help:"Contact name"`
	Description string `help:"Contact description"`
}

type ContactDeleteCmd struct {
	ID string `arg:"" help:"Contact ID"`
}

type ContactGetCmd struct {
	ID string `arg:"" help:"Contact ID"`
}

type ContactHandleAddCmd struct {
	ContactID string `arg:"" help:"Contact ID"`
	Type      string `required:"" help:"Handle type (email, phone, etc)"`
	Value     string `required:"" help:"Handle value"`
}

type ContactHandleCmd struct {
	Add    ContactHandleAddCmd    `cmd:"" help:"Add a handle to a contact"`
	Delete ContactHandleDeleteCmd `cmd:"" help:"Delete a contact handle"`
}

type ContactHandleDeleteCmd struct {
	ID string `arg:"" help:"Handle ID"`
}

type ContactHandlesCmd struct {
	ID string `arg:"" help:"Contact ID"`
}

type ContactListCmd struct {
	Limit int `help:"Maximum results" default:"25"`
}

type ContactMergeCmd struct {
	Source string `arg:"" help:"Source contact ID (will be merged into target)"`
	Target string `arg:"" help:"Target contact ID (will receive merged data)"`
}

type ContactNoteAddCmd struct {
	ContactID string `arg:"" help:"Contact ID"`
	Body      string `required:"" help:"Note body"`
}

type ContactNoteCmd struct {
	Add ContactNoteAddCmd `cmd:"" help:"Add a note to a contact"`
}

type ContactNotesCmd struct {
	ID string `arg:"" help:"Contact ID"`
}

type ContactSearchCmd struct {
	Query    string `arg:"" help:"Search query (matches name or handle)"`
	Limit    int    `help:"Maximum results" default:"25"`
	MaxPages int    `help:"Maximum pages to search (100 contacts/page)" default:"25"`
}

type ContactUpdateCmd struct {
	ID          string `arg:"" help:"Contact ID"`
	Name        string `help:"New name"`
	Description string `help:"New description"`
}

type ConvArchiveCmd struct {
	IDs     []string `arg:"" help:"Conversation IDs to archive"`
	IDsFrom string   `help:"Read conversation IDs from stdin (use '-' for stdin)"`
}

type ConvAssignCmd struct {
	ID string `arg:"" help:"Conversation ID"`
	To string `required:"" help:"Teammate ID to assign to"`
}

type ConvCmd struct {
	List      ConvListCmd      `cmd:"" help:"List conversations"`
	Get       ConvGetCmd       `cmd:"" help:"Get a conversation"`
	Search    ConvSearchCmd    `cmd:"" help:"Search conversations"`
	Messages  ConvMessagesCmd  `cmd:"" help:"List messages in a conversation"`
	Comments  ConvCommentsCmd  `cmd:"" help:"List comments in a conversation"`
	Archive   ConvArchiveCmd   `cmd:"" help:"Archive conversations"`
	Open      ConvOpenCmd      `cmd:"" help:"Open (unarchive) conversations"`
	Trash     ConvTrashCmd     `cmd:"" help:"Move conversations to trash"`
	Assign    ConvAssignCmd    `cmd:"" help:"Assign a conversation"`
	Unassign  ConvUnassignCmd  `cmd:"" help:"Unassign a conversation"`
	Snooze    ConvSnoozeCmd    `cmd:"" help:"Snooze a conversation"`
	Unsnooze  ConvUnsnoozeCmd  `cmd:"" help:"Unsnooze a conversation"`
	Followers ConvFollowersCmd `cmd:"" help:"List followers of a conversation"`
	Follow    ConvFollowCmd    `cmd:"" help:"Follow a conversation"`
	Unfollow  ConvUnfollowCmd  `cmd:"" help:"Unfollow a conversation"`
	Tag       ConvTagCmd       `cmd:"" help:"Add tag to conversation"`
	Untag     ConvUntagCmd     `cmd:"" help:"Remove tag from conversation"`
	Update    ConvUpdateCmd    `cmd:"" help:"Update conversation custom fields"`
}

type ConvCommentsCmd struct {
	ID    string `arg:"" help:"Conversation ID"`
	Limit int    `help:"Maximum number of comments" default:"25"`
}

type ConvFollowCmd struct {
	ID   string `arg:"" help:"Conversation ID"`
	User string `help:"Teammate ID to follow as"`
}

type ConvFollowersCmd struct {
	ID string `arg:"" help:"Conversation ID"`
}

type ConvGetCmd struct {
	ID       string `arg:"" help:"Conversation ID"`
	Messages bool   `help:"Include messages" short:"m"`
	Comments bool   `help:"Include comments" short:"c"`
	Full     bool   `help:"Include full content with comments inline (implies -m -c)"`
	HTML     bool   `help:"Show message body as HTML (with --full)"`
	Text     bool   `help:"Show message body as plain text (with --full)"`
}

type ConvListCmd struct {
	Inbox     string `help:"Filter by inbox ID"`
	Tag       string `help:"Filter by tag ID"`
	Status    string `help:"Filter by status (open, assigned, unassigned, archived, snoozed, trashed)"`
	Limit     int    `help:"Maximum number of results" default:"25"`
	SortOrder string `help:"Sort order (asc, desc)" short:"s" enum:"asc,desc,-" default:"-"`
}

type ConvMessagesCmd struct {
	ID    string `arg:"" help:"Conversation ID"`
	Limit int    `help:"Maximum number of messages" default:"25"`
}

type ConvOpenCmd struct {
	IDs     []string `arg:"" help:"Conversation IDs to open"`
	IDsFrom string   `help:"Read conversation IDs from stdin (use '-' for stdin)"`
}

type ConvSearchCmd struct {
	Query      string   `arg:"" optional:"" help:"Search query"`
	RawQuery   string   `help:"Raw query override" short:"q" name:"query"`
	From       string   `help:"Filter by sender (from:)"`
	To         string   `help:"Filter by recipient (to:)"`
	Recipient  string   `help:"Filter by recipient (recipient:)"`
	Inbox      string   `help:"Filter by inbox (inbox:)"`
	Tag        []string `help:"Filter by tag (tag:)"`
	Status     string   `help:"Filter by status (open, archived, snoozed, trashed)"`
	Assignee   string   `help:"Filter by assignee (assignee: or me)"`
	Unassigned bool     `help:"Filter unassigned conversations"`
	Before     string   `help:"Filter before date/time (before:)"`
	After      string   `help:"Filter after date/time (after:)"`
	Limit      int      `help:"Maximum results" default:"25"`
}

type ConvSnoozeCmd struct {
	ID       string `arg:"" help:"Conversation ID"`
	Until    string `help:"Snooze until (RFC3339 timestamp)"`
	Duration string `help:"Snooze duration (e.g. 2h, 30m)"`
}

type ConvTagCmd struct {
	ID    string `arg:"" help:"Conversation ID"`
	TagID string `arg:"" help:"Tag ID to add"`
}

type ConvTrashCmd struct {
	IDs     []string `arg:"" help:"Conversation IDs to trash"`
	IDsFrom string   `help:"Read conversation IDs from stdin (use '-' for stdin)"`
}

type ConvUnassignCmd struct {
	ID string `arg:"" help:"Conversation ID"`
}

type ConvUnfollowCmd struct {
	ID   string `arg:"" help:"Conversation ID"`
	User string `help:"Teammate ID to unfollow"`
}

type ConvUnsnoozeCmd struct {
	ID string `arg:"" help:"Conversation ID"`
}

type ConvUntagCmd struct {
	ID    string `arg:"" help:"Conversation ID"`
	TagID string `arg:"" help:"Tag ID to remove"`
}

type ConvUpdateCmd struct {
	ID     string   `arg:"" help:"Conversation ID"`
	Fields []string `help:"Custom field update (key=value)" name:"field"`
}

type DraftCmd struct {
	Create DraftCreateCmd `cmd:"" help:"Create a draft"`
	List   DraftListCmd   `cmd:"" help:"List drafts in a conversation"`
	Get    DraftGetCmd    `cmd:"" help:"Get a draft"`
	Update DraftUpdateCmd `cmd:"" help:"Update a draft"`
	Delete DraftDeleteCmd `cmd:"" help:"Delete a draft"`
}

type DraftCreateCmd struct {
	ConvID   string `arg:"" help:"Conversation ID (for reply drafts)" optional:""`
	Channel  string `help:"Channel ID (for new message drafts)"`
	To       string `help:"Recipient (for new message drafts)"`
	Subject  string `help:"Draft subject"`
	Body     string `help:"Draft body"`
	BodyFile string `help:"Read body from file" type:"existingfile"`
}

type DraftDeleteCmd struct {
	ID string `arg:"" help:"Draft ID"`
}

type DraftGetCmd struct {
	ID string `arg:"" help:"Draft ID"`
}

type DraftListCmd struct {
	ConvID string `arg:"" help:"Conversation ID"`
}

type DraftUpdateCmd struct {
	ID           string `arg:"" help:"Draft ID"`
	Body         string `help:"New body"`
	BodyFile     string `help:"Read body from file" type:"existingfile"`
	Subject      string `help:"New subject"`
	DraftVersion int    `required:"" name:"draft-version" help:"Current version number (for optimistic locking)"`
}

type ExitError struct {
	Code int
	Err  error
}

type InboxChannelsCmd struct {
	ID string `arg:"" help:"Inbox ID"`
}

type InboxCmd struct {
	List     InboxListCmd     `cmd:"" help:"List inboxes"`
	Get      InboxGetCmd      `cmd:"" help:"Get an inbox"`
	Convos   InboxConvosCmd   `cmd:"" help:"List conversations in an inbox"`
	Channels InboxChannelsCmd `cmd:"" help:"List channels in an inbox"`
}

type InboxConvosCmd struct {
	ID    string `arg:"" help:"Inbox ID"`
	Limit int    `help:"Maximum number of results" default:"25"`
}

type InboxGetCmd struct {
	ID string `arg:"" help:"Inbox ID"`
}

type InboxListCmd struct{}

type MsgAttachmentCmd struct {
	Download MsgAttachmentDownloadCmd `cmd:"" help:"Download an attachment"`
}

type MsgAttachmentDownloadCmd struct {
	ID     string `arg:"" help:"Attachment ID"`
	Output string `short:"o" help:"Output file path"`
}

type MsgAttachmentsCmd struct {
	ID string `arg:"" help:"Message ID"`
}

type MsgCmd struct {
	Get         MsgGetCmd         `cmd:"" help:"Get a message"`
	Send        MsgSendCmd        `cmd:"" help:"Send a new message"`
	Reply       MsgReplyCmd       `cmd:"" help:"Reply to a conversation"`
	Attachments MsgAttachmentsCmd `cmd:"" help:"List message attachments"`
	Attachment  MsgAttachmentCmd  `cmd:"" help:"Attachment operations"`
}

type MsgGetCmd struct {
	ID  string `arg:"" help:"Message ID"`
	Raw bool   `help:"Show raw body (no HTML conversion)"`
}

type MsgReplyCmd struct {
	ConvID    string `arg:"" help:"Conversation ID to reply to"`
	Body      string `help:"Reply body"`
	BodyFile  string `help:"Read body from file" type:"existingfile"`
	InReplyTo string `help:"Message ID to reply to (for threading)"`
}

type MsgSendCmd struct {
	Channel  string `required:"" help:"Channel ID to send from"`
	To       string `required:"" help:"Recipient address"`
	Subject  string `help:"Message subject"`
	Body     string `help:"Message body"`
	BodyFile string `help:"Read body from file" type:"existingfile"`
}

type RootFlags struct {
	Account string `help:"Account email for multi-account support"`
	Client  string `help:"OAuth client name override"`
	JSON    bool   `help:"Output JSON to stdout (best for scripting)"`
	Plain   bool   `help:"Output TSV (stable for scripts)"`
	Verbose bool   `help:"Enable verbose logging"`
}

type TagChildrenCmd struct {
	ID string `arg:"" help:"Parent tag ID"`
}

type TagCmd struct {
	List     TagListCmd     `cmd:"" help:"List tags"`
	Get      TagGetCmd      `cmd:"" help:"Get a tag"`
	Create   TagCreateCmd   `cmd:"" help:"Create a tag"`
	Update   TagUpdateCmd   `cmd:"" help:"Update a tag"`
	Delete   TagDeleteCmd   `cmd:"" help:"Delete a tag"`
	Children TagChildrenCmd `cmd:"" help:"List child tags"`
	Convos   TagConvosCmd   `cmd:"" help:"List conversations with a tag"`
}

type TagConvosCmd struct {
	ID    string `arg:"" help:"Tag ID"`
	Limit int    `help:"Maximum number of results" default:"25"`
}

type TagCreateCmd struct {
	Name        string `required:"" help:"Tag name"`
	Description string `help:"Tag description"`
	Color       string `help:"Tag color (highlight)"`
	Parent      string `help:"Parent tag ID"`
}

type TagDeleteCmd struct {
	ID string `arg:"" help:"Tag ID"`
}

type TagGetCmd struct {
	ID string `arg:"" help:"Tag ID"`
}

type TagListCmd struct {
	Tree bool `help:"Show hierarchical tree view"`
}

type TagUpdateCmd struct {
	ID          string `arg:"" help:"Tag ID"`
	Name        string `help:"New name"`
	Description string `help:"New description"`
	Color       string `help:"New color"`
}

type TeammateCmd struct {
	List   TeammateListCmd   `cmd:"" help:"List teammates"`
	Get    TeammateGetCmd    `cmd:"" help:"Get a teammate"`
	Convos TeammateConvosCmd `cmd:"" help:"List conversations assigned to a teammate"`
}

type TeammateConvosCmd struct {
	ID    string `arg:"" help:"Teammate ID"`
	Limit int    `help:"Maximum number of results" default:"25"`
}

type TeammateGetCmd struct {
	ID string `arg:"" help:"Teammate ID"`
}

type TeammateListCmd struct{}

type TemplateCmd struct {
	List TemplateListCmd `cmd:"" help:"List templates"`
	Get  TemplateGetCmd  `cmd:"" help:"Get a template"`
	Use  TemplateUseCmd  `cmd:"" help:"Output a template body for piping"`
}

type TemplateGetCmd struct {
	ID string `arg:"" help:"Template ID"`
}

type TemplateListCmd struct{}

type TemplateUseCmd struct {
	ID string `arg:"" help:"Template ID"`
}

type VersionCmd struct{}

type WhoamiCmd struct{}