cli

type AdminAuditCmd struct {
	Logs         AdminAuditLogsCmd         `cmd:"" help:"View admin action audit logs"`
	LoginHistory AdminAuditLoginHistoryCmd `cmd:"login-history" help:"View login history (90-day retention)"`
	SMTPLogs     AdminAuditSMTPLogsCmd     `cmd:"smtp-logs" help:"View SMTP transaction logs"`
	Sessions     AdminAuditSessionsCmd     `cmd:"" help:"View active sessions"`
	Security     AdminAuditSecurityCmd     `cmd:"" help:"View security policy settings"`
}

type AdminAuditLoginHistoryCmd struct {
	From  string `help:"Start date (YYYY-MM-DD or RFC3339)" required:""`
	To    string `help:"End date (YYYY-MM-DD or RFC3339)" required:""`
	Mode  string `` /* 142-byte string literal not displayed */
	Limit int    `help:"Batch size per page (Note: 90-day retention limit)" default:"100"`
}

type AdminAuditLogsCmd struct {
	From   string `help:"Start date (YYYY-MM-DD or RFC3339)" required:""`
	To     string `help:"End date (YYYY-MM-DD or RFC3339)" required:""`
	Search string `help:"Filter by category, performer, or operation"`
	Limit  int    `help:"Results per page" default:"100"`
}

type AdminAuditSMTPLogsCmd struct {
	From     string `help:"Start date (YYYY-MM-DD or RFC3339)" required:""`
	To       string `help:"End date (YYYY-MM-DD or RFC3339)" required:""`
	SearchBy string `help:"Search criteria field" enum:"messageId,fromAddr,toAddr," default:""`
	Search   string `help:"Search value (requires --search-by)"`
	Limit    int    `help:"Results per page" default:"100"`
}

type AdminAuditSecurityCmd struct{}

type AdminAuditSessionsCmd struct{}

type AdminCmd struct {
	Users   AdminUsersCmd   `cmd:"" help:"Manage organization users"`
	Groups  AdminGroupsCmd  `cmd:"" help:"Manage organization groups"`
	Domains AdminDomainsCmd `cmd:"" help:"Manage organization domains"`
	Audit   AdminAuditCmd   `cmd:"" help:"View audit logs and security information"`
}

type AdminDomainsAddCmd struct {
	Name string `arg:"" help:"Domain name to add (e.g., example.com)"`
}

type AdminDomainsCmd struct {
	List   AdminDomainsListCmd   `cmd:"" help:"List all domains"`
	Get    AdminDomainsGetCmd    `cmd:"" help:"Get domain details"`
	Add    AdminDomainsAddCmd    `cmd:"" help:"Add a new domain"`
	Verify AdminDomainsVerifyCmd `cmd:"" help:"Verify domain ownership"`
	Update AdminDomainsUpdateCmd `cmd:"" help:"Update domain settings"`
}

type AdminDomainsGetCmd struct {
	Name string `arg:"" help:"Domain name (e.g., example.com)"`
}

type AdminDomainsListCmd struct{}

type AdminDomainsUpdateCmd struct {
	Name    string `arg:"" help:"Domain name to update"`
	Setting string `` /* 194-byte string literal not displayed */
}

type AdminDomainsVerifyCmd struct {
	Name   string `arg:"" help:"Domain name to verify"`
	Method string `help:"Verification method: txt, cname, html" required:"" enum:"txt,cname,html" short:"m"`
}

type AdminGroupsCmd struct {
	List    AdminGroupsListCmd    `cmd:"" help:"List organization groups"`
	Get     AdminGroupsGetCmd     `cmd:"" help:"Get group details"`
	Create  AdminGroupsCreateCmd  `cmd:"" help:"Create a new group"`
	Update  AdminGroupsUpdateCmd  `cmd:"" help:"Update group settings"`
	Delete  AdminGroupsDeleteCmd  `cmd:"" help:"Delete a group permanently"`
	Members AdminGroupsMembersCmd `cmd:"" help:"Manage group members"`
}

type AdminGroupsCreateCmd struct {
	Name        string `arg:"" help:"Group display name"`
	Email       string `help:"Group email address" required:"" short:"e"`
	Description string `help:"Group description" short:"d"`
}

type AdminGroupsDeleteCmd struct {
	Identifier string `arg:"" help:"Group ID (zgid) or group email address"`
	Confirm    bool   `help:"Confirm permanent deletion"`
}

type AdminGroupsGetCmd struct {
	Identifier  string `arg:"" help:"Group ID (zgid) or group email address"`
	ShowMembers bool   `help:"Include member list" short:"m" default:"true"`
}

type AdminGroupsListCmd struct {
	Limit int  `help:"Maximum groups to show per page" short:"l" default:"50"`
	All   bool `help:"Fetch all groups" short:"a"`
}

type AdminGroupsMembersAddCmd struct {
	Group   string   `arg:"" help:"Group ID (zgid) or group email address"`
	Members []string `arg:"" help:"Email addresses of members to add"`
	Role    string   `help:"Member role: member, moderator" default:"member" enum:"member,moderator" short:"r"`
}

type AdminGroupsMembersCmd struct {
	Add    AdminGroupsMembersAddCmd    `cmd:"" help:"Add members to a group"`
	Remove AdminGroupsMembersRemoveCmd `cmd:"" help:"Remove members from a group"`
}

type AdminGroupsMembersRemoveCmd struct {
	Group   string   `arg:"" help:"Group ID (zgid) or group email address"`
	Members []string `arg:"" help:"Email addresses of members to remove"`
}

type AdminGroupsUpdateCmd struct {
	Identifier  string `arg:"" help:"Group ID (zgid) or group email address"`
	Name        string `help:"New group name" short:"n"`
	Description string `help:"New description" short:"d"`
}

type AdminUsersActivateCmd struct {
	Identifier string `arg:"" help:"User ID (zuid) or email address"`
}

type AdminUsersCmd struct {
	List       AdminUsersListCmd       `cmd:"" help:"List organization users"`
	Get        AdminUsersGetCmd        `cmd:"" help:"Get user details"`
	Create     AdminUsersCreateCmd     `cmd:"" help:"Create a new user"`
	Update     AdminUsersUpdateCmd     `cmd:"" help:"Update user role"`
	Activate   AdminUsersActivateCmd   `cmd:"" help:"Activate a user account"`
	Deactivate AdminUsersDeactivateCmd `cmd:"" help:"Deactivate a user account"`
	Delete     AdminUsersDeleteCmd     `cmd:"" help:"Delete a user permanently"`
}

type AdminUsersCreateCmd struct {
	Email       string `arg:"" help:"Primary email address for the new user"`
	Password    string `help:"Initial password (if not set, Zoho sends setup email)" short:"p"`
	FirstName   string `help:"First name" short:"f"`
	LastName    string `help:"Last name" short:"l"`
	DisplayName string `help:"Display name" short:"d"`
	Role        string `help:"Role: member, admin" default:"member" enum:"member,admin" short:"r"`
}

type AdminUsersDeactivateCmd struct {
	Identifier    string `arg:"" help:"User ID (zuid) or email address"`
	BlockIncoming bool   `help:"Block incoming mail for deactivated user"`
	RemoveForward bool   `help:"Remove mail forwarding rules"`
	RemoveGroups  bool   `help:"Remove from all groups"`
	RemoveAliases bool   `help:"Remove email aliases"`
}

type AdminUsersDeleteCmd struct {
	Identifier string `arg:"" help:"User ID (zuid) or email address"`
	Confirm    bool   `help:"Confirm permanent deletion"`
}

type AdminUsersGetCmd struct {
	Identifier string `arg:"" help:"User ID (zuid) or email address"`
}

type AdminUsersListCmd struct {
	Limit int  `help:"Maximum users to show per page" short:"l" default:"50"`
	All   bool `help:"Fetch all users (no pagination limit)" short:"a"`
}

type AdminUsersUpdateCmd struct {
	Identifier string `arg:"" help:"User ID (zuid) or email address"`
	Role       string `help:"New role: member, admin" required:"" enum:"member,admin" short:"r"`
}

type AttachmentListRow struct {
	Name         string
	Size         string
	Type         string
	AttachmentID string
}

type AuthCmd struct {
	Login  AuthLoginCmd  `cmd:"" help:"Log in to Zoho account"`
	Logout AuthLogoutCmd `cmd:"" help:"Log out and remove stored credentials"`
	List   AuthListCmd   `cmd:"" help:"List stored accounts"`
}

type AuthListCmd struct {
	Check bool `help:"Validate stored tokens are still valid" short:"c"`
}

type AuthLoginCmd struct {
	Manual bool `help:"Manual paste mode (no browser)" short:"m"`
}

type AuthLogoutCmd struct {
	All bool `help:"Remove all stored accounts" short:"a"`
}

type CLI struct {
	Globals

	Setup  SetupCmd  `cmd:"" help:"Interactive first-time setup wizard"`
	Auth   AuthCmd   `cmd:"" help:"Authentication commands"`
	Config ConfigCmd `cmd:"" help:"Configuration commands"`
	Admin  AdminCmd  `cmd:"" help:"Admin operations"`
	Mail   MailCmd   `cmd:"" help:"Mail operations"`

	// Desire-path shortcuts
	Send MailSendComposeCmd `cmd:"" help:"Send an email (shortcut for mail send compose)" hidden:""`
	Ls   LsCmd              `cmd:"" help:"List resources (users, groups, folders, labels)" hidden:""`

	// Shell completion
	Completion CompletionCmd `cmd:"" help:"Shell completion commands"`

	// Introspection
	Schema  SchemaCmd  `cmd:"" help:"Show machine-readable command tree as JSON"`
	Version VersionCmd `cmd:"" help:"Show version information"`
}

type CompletionCmd struct {
	Install kongplete.InstallCompletions `cmd:"" help:"Install shell completions for bash, zsh, or fish"`
}

type ConfigCmd struct {
	Get   ConfigGetCmd        `cmd:"" help:"Get a configuration value"`
	Set   ConfigSetCmd        `cmd:"" help:"Set a configuration value"`
	Unset ConfigUnsetCmd      `cmd:"" help:"Remove a configuration value"`
	List  ConfigListConfigCmd `cmd:"" name:"list" help:"List all configuration values"`
	Path  ConfigPathCmd       `cmd:"" help:"Show config file path"`
}

type ConfigGetCmd struct {
	Key string `arg:"" help:"Config key to get (e.g., region, client_id)"`
}

type ConfigListConfigCmd struct{}

type ConfigPathCmd struct{}

type ConfigSetCmd struct {
	Key   string `arg:"" help:"Config key to set"`
	Value string `arg:"" help:"Value to set"`
}

type ConfigUnsetCmd struct {
	Key string `arg:"" help:"Config key to remove"`
}

type DeliveryLogRow struct {
	Subject      string
	From         string
	To           string
	Status       string
	SentTime     string
	DeliveryTime string
}

type FormatterProvider struct {
	Formatter output.Formatter
}

type Globals struct {
	Region      string `help:"Zoho region" default:"" enum:"us,eu,in,au,jp,ca,sa,uk," env:"ZOH_REGION"`
	Output      string `help:"Output format" default:"auto" enum:"json,plain,rich,auto" short:"o" env:"ZOH_OUTPUT"`
	Verbose     bool   `help:"Verbose output" short:"v" env:"ZOH_VERBOSE"`
	ResultsOnly bool   `help:"Strip JSON envelope, return data array only" env:"ZOH_RESULTS_ONLY"`
	NoInput     bool   `help:"Disable interactive prompts (fail instead)" env:"ZOH_NO_INPUT"`
	Force       bool   `help:"Skip confirmation prompts for destructive operations" env:"ZOH_FORCE"`
	DryRun      bool   `help:"Preview operation without executing" name:"dry-run" env:"ZOH_DRY_RUN"`
}

type LsCmd struct {
	Users   AdminUsersListCmd  `cmd:"" help:"List users (shortcut for admin users list)"`
	Groups  AdminGroupsListCmd `cmd:"" help:"List groups (shortcut for admin groups list)"`
	Folders MailFoldersListCmd `cmd:"" help:"List folders (shortcut for mail folders list)"`
	Labels  MailLabelsListCmd  `cmd:"" help:"List labels (shortcut for mail labels list)"`
}

type MailAdminCmd struct {
	Retention MailAdminRetentionCmd `cmd:"" help:"Manage retention policies"`
	Spam      MailAdminSpamCmd      `cmd:"" help:"Manage spam filter settings"`
	Logs      MailAdminLogsCmd      `cmd:"" help:"View delivery logs"`
}

type MailAdminLogsCmd struct {
	Limit int `help:"Maximum logs to show" default:"50"`
	Start int `help:"Starting offset" default:"0"`
}

type MailAdminRetentionCmd struct {
	Get MailAdminRetentionGetCmd `cmd:"" help:"View retention policy settings"`
}

type MailAdminRetentionGetCmd struct{}

type MailAdminSpamCategoriesCmd struct{}

type MailAdminSpamCmd struct {
	Get        MailAdminSpamGetCmd        `cmd:"" help:"View spam settings for a category"`
	Update     MailAdminSpamUpdateCmd     `cmd:"" help:"Update spam allowlist/blocklist"`
	Categories MailAdminSpamCategoriesCmd `cmd:"" help:"List available spam categories"`
}

type MailAdminSpamGetCmd struct {
	Category string `help:"Spam category (e.g., allowlist-email, blocklist-domain)" required:""`
}

type MailAdminSpamUpdateCmd struct {
	Category string   `help:"Spam category (e.g., allowlist-email, blocklist-domain)" required:""`
	Values   []string `help:"Email addresses, domains, or IPs to add (repeatable)" required:""`
}

type MailAttachmentsCmd struct {
	List     MailAttachmentsListCmd     `cmd:"" help:"List attachments for a message"`
	Download MailAttachmentsDownloadCmd `cmd:"" help:"Download an attachment"`
}

type MailAttachmentsDownloadCmd struct {
	AttachmentID string `arg:"" help:"Attachment ID to download"`
	MessageID    string `help:"Message ID (required)" required:""`
	Folder       string `help:"Folder name or ID (required)" short:"f" required:""`
	OutputPath   string `help:"Output file path (default: attachment name)" name:"output-path" predictor:"file"`
}

type MailAttachmentsListCmd struct {
	MessageID string `arg:"" help:"Message ID"`
	Folder    string `help:"Folder name or ID (required)" short:"f" required:""`
}

type MailCmd struct {
	Folders     MailFoldersCmd     `cmd:"" help:"Manage mail folders"`
	Labels      MailLabelsCmd      `cmd:"" help:"Manage mail labels"`
	Messages    MailMessagesCmd    `cmd:"" help:"Manage messages"`
	Attachments MailAttachmentsCmd `cmd:"" help:"Manage attachments"`
	Send        MailSendCmd        `cmd:"" help:"Send email messages"`
	Settings    MailSettingsCmd    `cmd:"" help:"Manage mail settings"`
	Admin       MailAdminCmd       `cmd:"" help:"Mail administration operations"`
}

type MailFoldersCmd struct {
	List MailFoldersListCmd `cmd:"" help:"List all folders"`
}

type MailFoldersListCmd struct{}

type MailLabelsCmd struct {
	List MailLabelsListCmd `cmd:"" help:"List all labels"`
}

type MailLabelsListCmd struct{}

type MailMessagesCmd struct {
	List   MailMessagesListCmd   `cmd:"" help:"List messages in a folder"`
	Get    MailMessagesGetCmd    `cmd:"" help:"Get full message details"`
	Search MailMessagesSearchCmd `cmd:"" help:"Search messages with query filters"`
	Thread MailMessagesThreadCmd `cmd:"" help:"View all messages in a thread"`
}

type MailMessagesGetCmd struct {
	MessageID string `arg:"" help:"Message ID to retrieve"`
	Folder    string `help:"Folder name or ID (required)" short:"f" required:""`
}

type MailMessagesListCmd struct {
	Folder string `help:"Folder name or ID" default:"Inbox" short:"f"`
	Limit  int    `help:"Maximum messages to show" short:"l" default:"50"`
	All    bool   `help:"Fetch all messages (no pagination limit)" short:"a"`
}

type MailMessagesSearchCmd struct {
	Query         string `arg:"" optional:"" help:"Free-text search query"`
	From          string `help:"Filter by sender email" short:"f"`
	Subject       string `help:"Filter by subject" short:"s"`
	After         string `help:"Messages after date (YYYY-MM-DD)" short:"a"`
	Before        string `help:"Messages before date (YYYY-MM-DD)" short:"b"`
	Unread        bool   `help:"Only unread messages" short:"u"`
	HasAttachment bool   `help:"Only messages with attachments"`
	Limit         int    `help:"Maximum results" short:"l" default:"50"`
}

type MailMessagesThreadCmd struct {
	ThreadID string `arg:"" help:"Thread ID to view"`
	Folder   string `help:"Folder name or ID" default:"Inbox" short:"f"`
	Limit    int    `help:"Maximum messages to scan" short:"l" default:"200"`
}

type MailSendCmd struct {
	Compose MailSendComposeCmd `cmd:"" help:"Compose and send a new email"`
	Reply   MailSendReplyCmd   `cmd:"" help:"Reply to a message"`
	Forward MailSendForwardCmd `cmd:"" help:"Forward a message"`
}

type MailSendComposeCmd struct {
	To      string   `help:"Recipient email address" required:""`
	Cc      string   `help:"CC recipient(s)" short:"c"`
	Bcc     string   `help:"BCC recipient(s)" short:"b"`
	Subject string   `help:"Email subject" required:""`
	Body    string   `help:"Email body content" required:""`
	HTML    bool     `help:"Send as HTML (default: plain text)" name:"html"`
	Attach  []string `help:"File path(s) to attach (repeatable)" name:"attach" predictor:"file"`
}

type MailSendForwardCmd struct {
	MessageID string   `arg:"" help:"Message ID to forward"`
	Folder    string   `help:"Folder name or ID" required:"" short:"f"`
	To        string   `help:"Recipient email address" required:""`
	Body      string   `help:"Additional message body" default:""`
	HTML      bool     `help:"Send as HTML (default: plain text)" name:"html"`
	Attach    []string `help:"File path(s) to attach (repeatable)" name:"attach" predictor:"file"`
}

type MailSendReplyCmd struct {
	MessageID string   `arg:"" help:"Message ID to reply to"`
	Folder    string   `help:"Folder name or ID" required:"" short:"f"`
	Body      string   `help:"Reply body content" required:""`
	HTML      bool     `help:"Send as HTML (default: plain text)" name:"html"`
	Attach    []string `help:"File path(s) to attach (repeatable)" name:"attach" predictor:"file"`
	All       bool     `help:"Reply to all recipients" name:"all"`
}

type MailSettingsCmd struct {
	Signatures  MailSettingsSignaturesCmd  `cmd:"" help:"Manage email signatures"`
	Vacation    MailSettingsVacationCmd    `cmd:"" help:"Manage vacation auto-reply"`
	DisplayName MailSettingsDisplayNameCmd `cmd:"display-name" help:"Manage account display name"`
	Forwarding  MailSettingsForwardingCmd  `cmd:"" help:"View forwarding settings"`
}

type MailSettingsDisplayNameCmd struct {
	Get MailSettingsDisplayNameGetCmd `cmd:"" help:"View account display name"`
	Set MailSettingsDisplayNameSetCmd `cmd:"" help:"Update account display name"`
}

type MailSettingsDisplayNameGetCmd struct{}

type MailSettingsDisplayNameSetCmd struct {
	Name string `arg:"" help:"New display name" required:""`
}

type MailSettingsForwardingCmd struct {
	Get MailSettingsForwardingGetCmd `cmd:"" help:"View forwarding settings"`
}

type MailSettingsForwardingGetCmd struct{}

type MailSettingsSignaturesCmd struct {
	List   MailSettingsSignaturesListCmd   `cmd:"" help:"List all email signatures"`
	Create MailSettingsSignaturesCreateCmd `cmd:"" help:"Create a new email signature"`
}

type MailSettingsSignaturesCreateCmd struct {
	Name        string `help:"Signature name" required:""`
	Content     string `help:"Signature HTML content" required:""`
	Position    int    `help:"Position: 0=below quoted, 1=above quoted" default:"0"`
	AssignUsers string `help:"Comma-separated email addresses to assign signature to" name:"assign-users"`
}

type MailSettingsSignaturesListCmd struct{}

type MailSettingsVacationCmd struct {
	Get     MailSettingsVacationGetCmd     `cmd:"" help:"View vacation auto-reply settings"`
	Set     MailSettingsVacationSetCmd     `cmd:"" help:"Enable vacation auto-reply"`
	Disable MailSettingsVacationDisableCmd `cmd:"" help:"Disable vacation auto-reply"`
}

type MailSettingsVacationDisableCmd struct{}

type MailSettingsVacationGetCmd struct{}

type MailSettingsVacationSetCmd struct {
	From     string `help:"Start date (MM/DD/YYYY HH:MM:SS)" required:""`
	To       string `help:"End date (MM/DD/YYYY HH:MM:SS)" required:""`
	Subject  string `help:"Auto-reply subject" required:""`
	Content  string `help:"Auto-reply message content" required:""`
	Interval int    `help:"Reply interval in minutes" default:"1440"`
	SendTo   string `help:"Send to: all/contacts/noncontacts/org/nonOrgAll" default:"all" enum:"all,contacts,noncontacts,org,nonOrgAll"`
}

type MessageDetail struct {
	Subject       string
	From          string
	To            string
	Cc            string
	Date          string
	Size          string
	Status        string
	Priority      string
	HasAttachment string
	MessageID     string
	ThreadID      string
	FolderID      string
	Body          string
}

type MessageListRow struct {
	Status      string
	FromAddress string
	Subject     string
	Date        string
	Attachment  string
	MessageID   string
}

type SchemaArg struct {
	Name     string `json:"name"`
	Help     string `json:"help,omitempty"`
	Required bool   `json:"required,omitempty"`
}

type SchemaCmd struct {
	Command string `arg:"" optional:"" help:"Command path to show schema for (e.g., 'admin users')"`
}

type SchemaFlag struct {
	Name     string   `json:"name"`
	Help     string   `json:"help,omitempty"`
	Type     string   `json:"type"`
	Required bool     `json:"required,omitempty"`
	Default  string   `json:"default,omitempty"`
	Enum     []string `json:"enum,omitempty"`
	Short    string   `json:"short,omitempty"`
	Env      string   `json:"env,omitempty"`
}

type SchemaNode struct {
	Name     string        `json:"name"`
	Type     string        `json:"type"` // "application", "command", "argument"
	Help     string        `json:"help,omitempty"`
	Aliases  []string      `json:"aliases,omitempty"`
	Hidden   bool          `json:"hidden,omitempty"`
	Children []*SchemaNode `json:"commands,omitempty"`
	Flags    []*SchemaFlag `json:"flags,omitempty"`
	Args     []*SchemaArg  `json:"args,omitempty"`
}

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

type SetupCmd struct{}

type SignatureRow struct {
	Name        string
	Position    string
	AssignUsers string
	ID          string
}

type SpamCategoryRow struct {
	Name     string
	APIValue string
}

type VersionCmd struct{}