cmd

type AuthCleanCmd struct{}

type AuthCmd struct {
	Login  AuthLoginCmd  `cmd:"" help:"Login to a Microsoft account"`
	Logout AuthLogoutCmd `cmd:"" help:"Logout from an account"`
	Clean  AuthCleanCmd  `cmd:"" help:"Remove all stored accounts and tokens"`
	List   AuthListCmd   `cmd:"" help:"List authenticated accounts"`
	Status AuthStatusCmd `cmd:"" help:"Show authentication status"`
}

type AuthListCmd struct{}

type AuthLoginCmd struct {
	ClientID   string   `help:"OAuth2 client ID" env:"OLK_CLIENT_ID"`
	TenantID   string   `help:"Azure AD tenant ID" env:"OLK_TENANT_ID" default:"common"`
	ReadOnly   bool     `help:"Request read-only permissions"`
	Enterprise bool     `help:"Request enterprise scopes (work/school accounts)" env:"OLK_ENTERPRISE"`
	Browser    bool     `help:"Sign in via the system browser (auth-code + PKCE) instead of device code" env:"OLK_BROWSER"`
	Scope      []string `help:"Additional OAuth scopes to request (repeatable, e.g. --scope Mail.Read.Shared)" name:"scope"`
}

type AuthLogoutCmd struct {
	Email string `arg:"" optional:"" help:"Account email to logout (default: current account)"`
}

type AuthStatusCmd struct{}

type CLI struct {
	RootFlags

	Auth     AuthCmd     `cmd:"" help:"Authentication commands"`
	Mail     MailCmd     `cmd:"" help:"Mail commands"`
	Calendar CalendarCmd `cmd:"" help:"Calendar commands"`
	Contacts ContactsCmd `cmd:"" help:"Contacts commands"`
	Todo     TodoCmd     `cmd:"" help:"Microsoft To Do tasks"`
	People   PeopleCmd   `cmd:"" help:"People directory search"`
	Drive    DriveCmd    `cmd:"" help:"OneDrive file operations"`
	Config   ConfigCmd   `cmd:"" help:"Configuration management"`
	MCP      MCPCmd      `cmd:"" name:"mcp" help:"Run an MCP server exposing olk as tools (stdio)"`
	Version  VersionCmd  `cmd:"" help:"Show version information"`
	Whoami   WhoamiCmd   `cmd:"" help:"Show current user profile"`
	Changes  ChangesCmd  `cmd:"" help:"Unified delta digest across mail, calendar, and contacts"`

	// Desire path shortcuts
	Send   SendCmd   `cmd:"" help:"Send an email (shortcut for mail send)" hidden:""`
	Ls     LsCmd     `cmd:"" help:"List inbox (shortcut for mail list)" hidden:""`
	Inbox  InboxCmd  `cmd:"" help:"List inbox (shortcut for mail list)" hidden:""`
	Search SearchCmd `cmd:"" help:"Search mail (shortcut for mail search)" hidden:""`
	Today  TodayCmd  `cmd:"" help:"Today's events (shortcut for calendar events --days 1)" hidden:""`
	Week   WeekCmd   `cmd:"" help:"This week's events (shortcut for calendar events --days 7)" hidden:""`
}

type CalendarAttachmentsAddCmd struct {
	EventID string `arg:"" help:"Event ID"`
	File    string `arg:"" help:"File to upload" type:"existingfile"`
}

type CalendarAttachmentsCmd struct {
	List     CalendarAttachmentsListCmd     `cmd:"" help:"List event attachments"`
	Add      CalendarAttachmentsAddCmd      `cmd:"" help:"Add a file attachment"`
	Download CalendarAttachmentsDownloadCmd `cmd:"" help:"Download an attachment"`
	Delete   CalendarAttachmentsDeleteCmd   `cmd:"" help:"Delete an attachment"`
}

type CalendarAttachmentsDeleteCmd struct {
	EventID      string `arg:"" help:"Event ID"`
	AttachmentID string `arg:"" help:"Attachment ID"`
}

type CalendarAttachmentsDownloadCmd struct {
	EventID      string `arg:"" help:"Event ID"`
	AttachmentID string `arg:"" help:"Attachment ID"`
	Out          string `help:"Output directory for download" default:"." type:"path"`
}

type CalendarAttachmentsListCmd struct {
	EventID string `arg:"" help:"Event ID"`
}

type CalendarAvailabilityCmd struct {
	Emails []string `help:"Email addresses to check" required:"" short:"e"`
	Days   int      `help:"Days to look ahead" default:"1" short:"d"`
	After  string   `help:"Start date (ISO 8601)"`
	Before string   `help:"End date (ISO 8601)"`
}

type CalendarCalendarsCmd struct{}

type CalendarCmd struct {
	Events       CalendarEventsCmd       `cmd:"" help:"List calendar events"`
	Delta        CalendarDeltaCmd        `cmd:"" help:"Incremental sync of calendar events (delta)"`
	Get          CalendarGetCmd          `cmd:"" help:"Get event details"`
	Create       CalendarCreateCmd       `cmd:"" help:"Create a calendar event"`
	Update       CalendarUpdateCmd       `cmd:"" help:"Update a calendar event"`
	Delete       CalendarDeleteCmd       `cmd:"" help:"Delete a calendar event"`
	Respond      CalendarRespondCmd      `cmd:"" help:"Respond to an event invitation"`
	Calendars    CalendarCalendarsCmd    `cmd:"" help:"List available calendars"`
	Attachments  CalendarAttachmentsCmd  `cmd:"" help:"Event attachment operations"`
	Availability CalendarAvailabilityCmd `cmd:"" help:"Check availability / free-busy"`
	View         CalendarViewCmd         `cmd:"" help:"Calendar view with expanded recurring events"`
	FindTimes    CalendarFindTimesCmd    `cmd:"" help:"Find available meeting times" name:"find-times"`
}

type CalendarCreateCmd struct {
	Subject         string   `help:"Event subject" required:"" short:"s"`
	Start           string   `help:"Start time (ISO 8601)" required:""`
	End             string   `help:"End time (ISO 8601)" required:""`
	Calendar        string   `help:"Calendar ID (default calendar when omitted)"`
	Location        string   `help:"Event location" short:"l"`
	Attendees       []string `help:"Attendee email addresses" short:"a"`
	AllDay          bool     `help:"All-day event"`
	EventTimeZone   string   `help:"Named time zone for all-day boundaries (e.g. America/Los_Angeles)" name:"event-timezone"`
	OnlineMeeting   bool     `help:"Create online meeting"`
	Recurrence      string   `help:"Recurrence: daily|weekdays|weekly|monthly|yearly" short:"r"`
	TransactionID   string   `help:"Retry-safe provider transaction ID" name:"transaction-id"`
	NoReminder      bool     `help:"Disable event reminders" name:"no-reminder"`
	ReminderMinutes *int32   `help:"Enable reminder this many minutes before the event" name:"reminder-minutes"`
	Body            *string  `help:"Event body" short:"b"`
	HTML            bool     `help:"Treat --body as HTML"`
}

type CalendarDeleteCmd struct {
	ID string `arg:"" help:"Event ID"`
}

type CalendarDeltaCmd struct {
	Days   int    `help:"Window size in days ahead for the initial sync" default:"30" short:"d"`
	After  string `help:"Window start (ISO 8601); overrides --days start"`
	Before string `help:"Window end (ISO 8601); overrides --days end"`
	Token  string `help:"Delta token from a previous call (omit to start a fresh sync)"`
	Top    int32  `help:"Max items per page" short:"n"`
}

type CalendarEventsCmd struct {
	Days       int     `help:"Number of days to look ahead" default:"7" short:"d"`
	After      string  `help:"Start date (ISO 8601)"`
	Before     string  `help:"End date (ISO 8601)"`
	Calendar   string  `help:"Calendar ID"`
	Top        int32   `help:"Max events to return" default:"25" short:"n"`
	BodyFormat *string `help:"Request provider-returned event body representation" enum:"text,html"`
}

type CalendarFindTimesCmd struct {
	Attendees []string `help:"Attendee email addresses" required:"" short:"a"`
	Duration  int32    `help:"Meeting duration in minutes" default:"60" short:"d"`
	After     string   `help:"Search after date (ISO 8601)"`
	Before    string   `help:"Search before date (ISO 8601)"`
}

type CalendarGetCmd struct {
	ID         string  `arg:"" help:"Event ID"`
	BodyFormat *string `help:"Request provider-returned event body representation" enum:"text,html"`
}

type CalendarRespondCmd struct {
	ID       string `arg:"" help:"Event ID"`
	Response string `arg:"" help:"Response: accept|decline|tentative" enum:"accept,decline,tentative"`
}

type CalendarUpdateCmd struct {
	ID              string  `arg:"" help:"Event ID"`
	Subject         string  `help:"New subject" short:"s"`
	Start           string  `help:"New start time (ISO 8601)"`
	End             string  `help:"New end time (ISO 8601)"`
	Location        string  `help:"New location" short:"l"`
	AllDay          *bool   `help:"Convert event to an all-day event" name:"all-day"`
	Timed           *bool   `help:"Convert event to a timed event"`
	EventTimeZone   string  `help:"Named time zone for all-day boundaries (e.g. America/Los_Angeles)" name:"event-timezone"`
	NoReminder      bool    `help:"Disable event reminders" name:"no-reminder"`
	ReminderMinutes *int32  `help:"Enable reminder this many minutes before the event" name:"reminder-minutes"`
	Body            *string `help:"Replace event body" short:"b"`
	HTML            bool    `help:"Treat --body as HTML"`
	ClearBody       bool    `help:"Clear the event body" name:"clear-body"`
}

type CalendarViewCmd struct {
	Days       int     `help:"Number of days to show" default:"7" short:"d"`
	After      string  `help:"Start date (ISO 8601)"`
	Before     string  `help:"End date (ISO 8601)"`
	Calendar   string  `help:"Calendar ID"`
	Top        int32   `help:"Max events to return" default:"50" short:"n"`
	BodyFormat *string `help:"Request provider-returned event body representation" enum:"text,html"`
}

type ChangesCmd struct {
	MailToken     string `help:"Delta token for mail (omit for a fresh sync)" name:"mail-token"`
	CalendarToken string `help:"Delta token for calendar (omit for a fresh sync)" name:"calendar-token"`
	ContactsToken string `help:"Delta token for contacts (omit for a fresh sync)" name:"contacts-token"`
	Days          int    `help:"Calendar window in days ahead for the initial sync" default:"30"`
	Top           int32  `help:"Max items per resource page" short:"n"`
}

type ConfigCmd struct {
	Set ConfigSetCmd `cmd:"" help:"Set a configuration value"`
	Get ConfigGetCmd `cmd:"" help:"Get a configuration value"`
}

type ConfigGetCmd struct {
	Key string `arg:"" help:"Configuration key (e.g. timezone)" enum:"timezone"`
}

type ConfigSetCmd struct {
	Key   string `arg:"" help:"Configuration key (e.g. timezone)" enum:"timezone"`
	Value string `arg:"" help:"Value to set"`
}

type ContactsCmd struct {
	List   ContactsListCmd   `cmd:"" help:"List contacts"`
	Delta  ContactsDeltaCmd  `cmd:"" help:"Incremental sync of contacts (delta)"`
	Get    ContactsGetCmd    `cmd:"" help:"Get contact details"`
	Create ContactsCreateCmd `cmd:"" help:"Create a contact"`
	Update ContactsUpdateCmd `cmd:"" help:"Update a contact"`
	Delete ContactsDeleteCmd `cmd:"" help:"Delete a contact"`
	Search ContactsSearchCmd `cmd:"" help:"Search contacts"`
}

type ContactsCreateCmd struct {
	FirstName     string   `help:"First name" required:""`
	LastName      string   `help:"Last name" required:""`
	MiddleName    string   `help:"Middle name" name:"middle-name"`
	NickName      string   `help:"Nickname" name:"nickname"`
	Email         []string `help:"Email address (repeatable)" short:"e"`
	MobilePhone   string   `help:"Mobile phone number" short:"p" name:"mobile-phone"`
	BusinessPhone string   `help:"Business phone number" name:"business-phone"`
	HomePhone     string   `help:"Home phone number" name:"home-phone"`
	Company       string   `help:"Company name" short:"c"`
	Title         string   `help:"Job title"`
	Department    string   `help:"Department" short:"d"`
	Manager       string   `help:"Manager name"`
	Birthday      string   `help:"Birthday (YYYY-MM-DD)"`
	Notes         string   `help:"Personal notes"`
	Categories    []string `help:"Category (repeatable)" short:"g"`
	Street        string   `help:"Street address"`
	City          string   `help:"City"`
	State         string   `help:"State or province"`
	PostalCode    string   `help:"Postal code" name:"postal-code"`
	Country       string   `help:"Country or region"`
	AddressType   string   `help:"Which address to set" enum:"business,home,other" default:"business" name:"address-type"`
}

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

type ContactsDeltaCmd struct {
	Token string `help:"Delta token from a previous call (omit to start a fresh sync)"`
	Top   int32  `help:"Max items per page" short:"n"`
}

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

type ContactsListCmd struct {
	Top  int32  `help:"Max contacts to return" default:"25" short:"n"`
	Skip int32  `help:"Number of contacts to skip (offset pagination)" default:"0"`
	Sort string `help:"Sort by field" enum:"displayName,givenName,surname," default:""`
}

type ContactsSearchCmd struct {
	Query string `arg:"" help:"Search query"`
	Top   int32  `help:"Max results" default:"25" short:"n"`
}

type ContactsUpdateCmd struct {
	ID            string   `arg:"" help:"Contact ID"`
	FirstName     string   `help:"First name"`
	LastName      string   `help:"Last name"`
	MiddleName    string   `help:"Middle name ('none' to clear)" name:"middle-name"`
	NickName      string   `help:"Nickname ('none' to clear)" name:"nickname"`
	Email         []string `help:"Email address (repeatable, replaces all; 'none' to clear)" short:"e"`
	MobilePhone   string   `help:"Mobile phone number ('none' to clear)" short:"p" name:"mobile-phone"`
	BusinessPhone string   `help:"Business phone number ('none' to clear)" name:"business-phone"`
	HomePhone     string   `help:"Home phone number ('none' to clear)" name:"home-phone"`
	Company       string   `help:"Company name ('none' to clear)" short:"c"`
	Title         string   `help:"Job title ('none' to clear)"`
	Department    string   `help:"Department ('none' to clear)" short:"d"`
	Manager       string   `help:"Manager name ('none' to clear)"`
	Birthday      string   `help:"Birthday (YYYY-MM-DD, 'none' to clear)"`
	Notes         string   `help:"Personal notes ('none' to clear)"`
	Categories    []string `help:"Category (repeatable, replaces all; 'none' to clear)" short:"g"`
	Street        string   `help:"Street address ('none' to clear)"`
	City          string   `help:"City ('none' to clear)"`
	State         string   `help:"State or province ('none' to clear)"`
	PostalCode    string   `help:"Postal code ('none' to clear)" name:"postal-code"`
	Country       string   `help:"Country or region ('none' to clear)"`
	AddressType   string   `help:"Which address to set" enum:"business,home,other" default:"business" name:"address-type"`
}

type DriveCmd struct {
	List     DriveListCmd     `cmd:"" help:"List all drives"`
	Info     DriveInfoCmd     `cmd:"" help:"Show drive details and quota"`
	Ls       DriveLsCmd       `cmd:"" help:"List folder contents"`
	Get      DriveGetCmd      `cmd:"" help:"Get item details"`
	Search   DriveSearchCmd   `cmd:"" help:"Search files"`
	Recent   DriveRecentCmd   `cmd:"" help:"Recently accessed files"`
	Shared   DriveSharedCmd   `cmd:"" help:"Files shared with me"`
	Download DriveDownloadCmd `cmd:"" help:"Download a file"`
	Upload   DriveUploadCmd   `cmd:"" help:"Upload a file"`
	Mkdir    DriveMkdirCmd    `cmd:"" help:"Create a folder"`
	Cp       DriveCpCmd       `cmd:"" help:"Copy a file or folder"`
	Mv       DriveMvCmd       `cmd:"" help:"Move or rename a file or folder"`
	Rm       DriveRmCmd       `cmd:"" help:"Delete a file or folder"`
	Share    DriveShareCmd    `cmd:"" help:"Create a sharing link"`
	Versions DriveVersionsCmd `cmd:"" help:"List file version history"`
}

type DriveCpCmd struct {
	ItemID  string `arg:"" help:"Source item ID"`
	Dest    string `arg:"" help:"Destination folder path"`
	Name    string `help:"New name for the copy" short:"n"`
	DriveID string `help:"Drive ID (default: primary drive)" name:"drive-id" env:"OLK_DRIVE_ID"`
}

type DriveDownloadCmd struct {
	ID      string `arg:"" help:"Item ID"`
	Output  string `help:"Output directory" short:"o" default:"." type:"path"`
	DriveID string `help:"Drive ID (default: primary drive)" name:"drive-id" env:"OLK_DRIVE_ID"`
}

type DriveGetCmd struct {
	ID      string `arg:"" help:"Item ID"`
	DriveID string `help:"Drive ID (default: primary drive)" name:"drive-id" env:"OLK_DRIVE_ID"`
}

type DriveInfoCmd struct {
	DriveID string `help:"Drive ID (default: primary drive)" name:"drive-id" env:"OLK_DRIVE_ID"`
}

type DriveListCmd struct{}

type DriveLsCmd struct {
	Path    string `arg:"" optional:"" help:"Folder path (default: root)" default:"/"`
	DriveID string `help:"Drive ID (default: primary drive)" name:"drive-id" env:"OLK_DRIVE_ID"`
	Top     int32  `help:"Number of items to return" default:"50" short:"n"`
}

type DriveMkdirCmd struct {
	Path    string `arg:"" help:"Folder path to create (e.g. /Documents/NewFolder)"`
	DriveID string `help:"Drive ID (default: primary drive)" name:"drive-id" env:"OLK_DRIVE_ID"`
}

type DriveMvCmd struct {
	ItemID  string `arg:"" help:"Item ID to move or rename"`
	Dest    string `arg:"" help:"Destination folder path or new name"`
	DriveID string `help:"Drive ID (default: primary drive)" name:"drive-id" env:"OLK_DRIVE_ID"`
}

type DriveRecentCmd struct {
	DriveID string `help:"Drive ID (default: primary drive)" name:"drive-id" env:"OLK_DRIVE_ID"`
}

type DriveRmCmd struct {
	ID      string `arg:"" help:"Item ID to delete"`
	DriveID string `help:"Drive ID (default: primary drive)" name:"drive-id" env:"OLK_DRIVE_ID"`
}

type DriveSearchCmd struct {
	Query   string `arg:"" help:"Search query"`
	DriveID string `help:"Drive ID (default: primary drive)" name:"drive-id" env:"OLK_DRIVE_ID"`
	Top     int32  `help:"Number of results" default:"25" short:"n"`
}

type DriveShareCmd struct {
	ID      string `arg:"" help:"Item ID"`
	Type    string `help:"Link type" enum:"view,edit" default:"view" short:"t"`
	Scope   string `help:"Link scope" enum:"anonymous,organization" default:"anonymous" short:"s"`
	DriveID string `help:"Drive ID (default: primary drive)" name:"drive-id" env:"OLK_DRIVE_ID"`
}

type DriveSharedCmd struct {
	DriveID string `help:"Drive ID (default: primary drive)" name:"drive-id" env:"OLK_DRIVE_ID"`
}

type DriveUploadCmd struct {
	LocalPath  string `arg:"" help:"Local file path" type:"existingfile"`
	RemotePath string `arg:"" help:"Remote path (e.g. /Documents/report.pdf)"`
	DriveID    string `help:"Drive ID (default: primary drive)" name:"drive-id" env:"OLK_DRIVE_ID"`
	Replace    bool   `help:"Replace existing file" default:"false"`
}

type DriveVersionsCmd struct {
	ID      string `arg:"" help:"Item ID"`
	DriveID string `help:"Drive ID (default: primary drive)" name:"drive-id" env:"OLK_DRIVE_ID"`
}

type InboxCmd struct {
	Top    int32 `help:"Number of messages" default:"25" short:"n"`
	Unread bool  `help:"Unread only" short:"u"`
}

type LsCmd struct {
	Folder string `help:"Mail folder" short:"f"`
	Top    int32  `help:"Number of messages" default:"25" short:"n"`
	Unread bool   `help:"Unread only" short:"u"`
}

type MCPCmd struct {
	AllowWrite       []string `` /* 162-byte string literal not displayed */
	AllowSend        []string `` /* 226-byte string literal not displayed */
	AllowDestructive []string `` /* 210-byte string literal not displayed */
	AllowTool        []string `` /* 229-byte string literal not displayed */
	MaxOutputBytes   int      `` /* 159-byte string literal not displayed */
	AllowMailbox     []string `` /* 235-byte string literal not displayed */
}

type MailAttachmentsCmd struct {
	ID           string `arg:"" help:"Message ID"`
	Save         bool   `help:"Download all attachments" default:"false"`
	Out          string `help:"Output directory for downloads" default:"." type:"path"`
	AttachmentID string `help:"Download a specific attachment by ID" name:"attachment-id"`
}

type MailBatchCmd struct {
	ID         []string `help:"Message ID to fetch (repeatable, max 20)" name:"id"`
	BodyFormat *string  `help:"Request provider-returned message body representation" enum:"text,html"`
}

type MailCategoriesCmd struct {
	List   MailCategoriesListCmd   `cmd:"" help:"List available categories"`
	Create MailCategoriesCreateCmd `cmd:"" help:"Create a category"`
	Delete MailCategoriesDeleteCmd `cmd:"" help:"Delete a category"`
}

type MailCategoriesCreateCmd struct {
	Name  string `help:"Category name" required:"" short:"n"`
	Color string `name:"preset" help:"Color preset: none, preset0 through preset24" default:""`
}

type MailCategoriesDeleteCmd struct {
	ID string `arg:"" help:"Category ID"`
}

type MailCategoriesListCmd struct{}

type MailCategorizeCmd struct {
	ID         string   `arg:"" help:"Message ID"`
	Categories []string `help:"Category names" required:"" short:"c"`
}

type MailCmd struct {
	List        MailListCmd        `cmd:"" help:"List messages in inbox"`
	Delta       MailDeltaCmd       `cmd:"" help:"Incremental sync of a mail folder (delta)"`
	Get         MailGetCmd         `cmd:"" help:"Get a message"`
	Batch       MailBatchCmd       `cmd:"" help:"Fetch up to 20 messages by ID in one request ($batch)"`
	Thread      MailThreadCmd      `cmd:"" help:"List all messages in a conversation thread"`
	Send        MailSendCmd        `cmd:"" help:"Send a message"`
	Search      MailSearchCmd      `cmd:"" help:"Search messages"`
	Reply       MailReplyCmd       `cmd:"" help:"Reply to a message"`
	Forward     MailForwardCmd     `cmd:"" help:"Forward a message"`
	Move        MailMoveCmd        `cmd:"" help:"Move a message to a folder"`
	Delete      MailDeleteCmd      `cmd:"" help:"Delete a message"`
	Mark        MailMarkCmd        `cmd:"" help:"Mark message as read/unread"`
	Folders     MailFoldersCmd     `cmd:"" help:"Mail folder operations"`
	Attachments MailAttachmentsCmd `cmd:"" help:"List/download attachments"`
	Drafts      MailDraftsCmd      `cmd:"" help:"Draft message operations"`
	Flag        MailFlagCmd        `cmd:"" help:"Set follow-up flag on a message"`
	Importance  MailImportanceCmd  `cmd:"" help:"Set importance on a message"`
	Categorize  MailCategorizeCmd  `cmd:"" help:"Set categories on a message"`
	Categories  MailCategoriesCmd  `cmd:"" help:"Manage category definitions"`
	OOO         MailOOOCmd         `cmd:"" help:"Out-of-office / auto-reply settings"`
	Rules       MailRulesCmd       `cmd:"" help:"Inbox rules"`
}

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

type MailDeltaCmd struct {
	Folder string `help:"Mail folder ID, well-known name, or path (for example Inbox/2026)" short:"f" default:"inbox"`
	Token  string `help:"Delta token from a previous call (omit to start a fresh sync)"`
	Top    int32  `help:"Max items per page" short:"n"`
}

type MailDraftsAttachCmd struct {
	ID   string `arg:"" help:"Draft message ID"`
	File string `arg:"" help:"File to attach (under 3 MB)" type:"existingfile"`
}

type MailDraftsCmd struct {
	List   MailDraftsListCmd   `cmd:"" help:"List draft messages"`
	Create MailDraftsCreateCmd `cmd:"" help:"Create a draft message"`
	Send   MailDraftsSendCmd   `cmd:"" help:"Send a draft message"`
	Delete MailDraftsDeleteCmd `cmd:"" help:"Delete a draft message"`
	Attach MailDraftsAttachCmd `cmd:"" help:"Attach a file to an existing draft"`
	Update MailDraftsUpdateCmd `cmd:"" help:"Replace the recipients, subject or body of an existing draft"`
}

type MailDraftsCreateCmd struct {
	To      []string `help:"Recipient email addresses" required:"" short:"t"`
	Subject string   `help:"Email subject" required:"" short:"s"`
	Body    string   `help:"Email body" short:"b"`
	CC      []string `help:"CC recipients"`
	BCC     []string `help:"BCC recipients"`
	HTML    bool     `help:"Body is HTML"`
	Inline  []string `help:"Inline image as CID=PATH (repeatable; HTML only)" placeholder:"CID=PATH"`
}

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

type MailDraftsListCmd struct {
	Top int32 `help:"Number of drafts to return" default:"25" short:"n"`
}

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

type MailDraftsUpdateCmd struct {
	ID      string   `arg:"" help:"Draft message ID"`
	To      []string `help:"Replace To recipients; pass an empty string to clear" short:"t"`
	CC      []string `help:"Replace CC recipients; pass an empty string to clear"`
	BCC     []string `help:"Replace BCC recipients; pass an empty string to clear"`
	Subject *string  `help:"Replace the subject" short:"s"`
	Body    *string  `help:"Replace the whole body, including any quoted reply or forward history" short:"b"`
	HTML    bool     `help:"Treat --body as HTML"`
}

type MailFlagCmd struct {
	ID     string `arg:"" help:"Message ID"`
	Status string `arg:"" help:"Flag status: flagged|complete|notFlagged" enum:"flagged,complete,notFlagged" default:"flagged"`
}

type MailFoldersCmd struct {
	List   MailFoldersListCmd   `cmd:"" default:"1" help:"List all visible mail folders recursively"`
	Create MailFoldersCreateCmd `cmd:"" help:"Create a mail folder"`
	Rename MailFoldersRenameCmd `cmd:"" help:"Rename a mail folder"`
	Delete MailFoldersDeleteCmd `cmd:"" help:"Delete a mail folder"`
}

type MailFoldersCreateCmd struct {
	Name string `help:"Folder name" required:"" short:"n"`
}

type MailFoldersDeleteCmd struct {
	ID string `arg:"" help:"Folder ID"`
}

type MailFoldersListCmd struct {
	WellKnown string `help:"Resolve one guarded destination by canonical Graph name (archive, deleteditems, inbox, or junkemail)"`
}

type MailFoldersRenameCmd struct {
	ID   string `arg:"" help:"Folder ID"`
	Name string `help:"New folder name" required:"" short:"n"`
}

type MailForwardCmd struct {
	ID      string   `arg:"" help:"Message ID to forward"`
	To      []string `help:"Recipient email addresses" required:"" short:"t"`
	CC      []string `help:"CC recipients"`
	Comment string   `help:"Comment to include" short:"c"`
	HTML    bool     `help:"Comment is HTML"`
	Draft   bool     `help:"Create a forward draft instead of sending"`
}

type MailGetCmd struct {
	ID     string `arg:"" help:"Message ID"`
	Format string `help:"Output format: full|text|html|eml (eml is the raw RFC 5322 message)" default:"full" enum:"full,text,html,eml"`
	Out    string `help:"With --format eml, write the message to this file instead of stdout" type:"path"`
}

type MailImportanceCmd struct {
	ID         string `arg:"" help:"Message ID"`
	Importance string `arg:"" help:"Importance: low|normal|high" enum:"low,normal,high"`
}

type MailListCmd struct {
	Folder  string  `help:"Mail folder ID, well-known name, or path (for example Inbox/2026)" short:"f" env:"OLK_MAIL_FOLDER" default:"inbox"`
	Top     int32   `help:"Number of messages to return" default:"25" short:"n"`
	Unread  bool    `help:"Show only unread messages" short:"u"`
	From    string  `help:"Filter by sender email"`
	After   string  `help:"Filter messages after date (ISO 8601)"`
	Before  string  `help:"Filter messages before date (ISO 8601)"`
	Focused bool    `help:"Show only Focused Inbox messages"`
	Other   bool    `help:"Show only Other Inbox messages"`
	Order   *string `help:"Message order: newest|oldest (default newest)" enum:"newest,oldest"`
}

type MailMarkCmd struct {
	ID     string `arg:"" help:"Message ID"`
	Read   bool   `help:"Mark as read" xor:"state"`
	Unread bool   `help:"Mark as unread" xor:"state"`
}

type MailMoveCmd struct {
	ID     string `arg:"" help:"Message ID"`
	Folder string `arg:"" help:"Destination folder ID, well-known name, or path (for example Inbox/2026)"`
}

type MailOOOCmd struct {
	Get MailOOOGetCmd `cmd:"" help:"Get auto-reply settings"`
	Set MailOOOSetCmd `cmd:"" help:"Set auto-reply"`
	Off MailOOOOffCmd `cmd:"" help:"Disable auto-reply"`
}

type MailOOOGetCmd struct{}

type MailOOOOffCmd struct{}

type MailOOOSetCmd struct {
	Message         string `help:"Auto-reply message (internal)" required:"" short:"m"`
	ExternalMessage string `help:"Auto-reply message for external senders (defaults to --message)" short:"x"`
	Start           string `help:"Start date/time (ISO 8601, enables scheduled mode)"`
	End             string `help:"End date/time (ISO 8601, enables scheduled mode)"`
	Audience        string `help:"External audience: none|contactsOnly|all" default:"all" enum:"none,contactsOnly,all"`
}

type MailReplyCmd struct {
	ID       string   `arg:"" help:"Message ID to reply to"`
	Body     string   `help:"Reply body" required:"" short:"b"`
	HTML     bool     `help:"Reply body is HTML"`
	ReplyAll bool     `help:"Reply to all recipients" short:"a"`
	Draft    bool     `help:"Create a reply draft instead of sending"`
	Inline   []string `help:"Inline image as CID=PATH (repeatable; HTML drafts only)" placeholder:"CID=PATH"`
}

type MailRulesCmd struct {
	List   MailRulesListCmd   `cmd:"" help:"List inbox rules"`
	Create MailRulesCreateCmd `cmd:"" help:"Create an inbox rule"`
	Delete MailRulesDeleteCmd `cmd:"" help:"Delete an inbox rule"`
}

type MailRulesCreateCmd struct {
	Name           string `help:"Rule name" required:"" short:"n"`
	From           string `help:"Match sender email"`
	SubjectContain string `help:"Match subject containing text" name:"subject-contains"`
	HasAttachment  bool   `help:"Match messages with attachments"`
	Move           string `help:"Move to folder ID or well-known name"`
	MarkRead       bool   `help:"Mark as read"`
	Delete         bool   `help:"Delete the message"`
	ForwardTo      string `help:"Forward to email address" name:"forward-to"`
	SetImportance  string `help:"Set importance: low|normal|high" name:"set-importance" enum:",low,normal,high" default:""`
}

type MailRulesDeleteCmd struct {
	ID string `arg:"" help:"Rule ID"`
}

type MailRulesListCmd struct{}

type MailSearchCmd struct {
	Query string `arg:"" help:"Search query — supports KQL operators (from:, subject:, hasAttachment:, etc.)"`
	Top   int32  `help:"Number of results" default:"25" short:"n"`
}

type MailSendCmd struct {
	To          []string `help:"Recipient email addresses" required:"" short:"t"`
	Subject     string   `help:"Email subject" required:"" short:"s"`
	Body        string   `help:"Email body" short:"b"`
	CC          []string `help:"CC recipients"`
	BCC         []string `help:"BCC recipients"`
	HTML        bool     `help:"Send body as HTML"`
	Attach      []string `help:"File paths to attach" type:"path"`
	Importance  string   `help:"Message importance: low|normal|high" enum:",low,normal,high" default:""`
	ReadReceipt bool     `help:"Request a read receipt"`
}

type MailThreadCmd struct {
	ConversationID string  `arg:"" help:"Conversation ID (a message's conversationId)" name:"conversation-id"`
	Top            int32   `help:"Max messages to return" default:"50" short:"n"`
	Complete       bool    `help:"Consume every provider page before returning"`
	BodyFormat     *string `help:"Request provider-returned message body representation" enum:"text,html"`
}

type PeopleCmd struct {
	Search PeopleSearchCmd `cmd:"" help:"Search people directory"`
}

type PeopleSearchCmd struct {
	Query string `arg:"" help:"Search query"`
	Top   int32  `help:"Max results to return" default:"25" short:"n"`
}

type RootFlags struct {
	JSON         bool         `help:"Output as JSON" env:"OLK_JSON"`
	Plain        bool         `help:"Output as plain TSV" env:"OLK_PLAIN"`
	Account      string       `help:"Account email to use" env:"OLK_ACCOUNT"`
	Mailbox      string       `` /* 226-byte string literal not displayed */
	Verbose      bool         `help:"Verbose output" short:"v" env:"OLK_VERBOSE"`
	DryRun       bool         `help:"Dry run mode" env:"OLK_DRY_RUN"`
	Force        bool         `help:"Force operation" env:"OLK_FORCE"`
	Color        string       `help:"Color mode: auto|never|always" default:"auto" env:"OLK_COLOR" enum:"auto,never,always"`
	Select       SelectFields `help:"Comma-separated fields to output" env:"OLK_SELECT"`
	ResultsOnly  bool         `help:"Output only the results array (no envelope)" env:"OLK_RESULTS_ONLY"`
	Concise      bool         `` /* 138-byte string literal not displayed */
	Timeout      int          `help:"Request timeout in seconds" default:"60" env:"OLK_TIMEOUT"`
	TimeZone     string       `help:"IANA time zone for display (e.g. America/New_York, Local, UTC)" name:"tz" env:"OLK_TIMEZONE"`
	ImmutableIDs bool         `help:"Use Outlook IDs that remain stable across moves within one mailbox" name:"immutable-ids" env:"OLK_IMMUTABLE_IDS"`

	// Capability guards (enforced for CLI, MCP, scripts, and --mailbox alike).
	// Named --no-write rather than --read-only because `auth login --read-only`
	// already exists (it requests read-only OAuth scopes).
	NoWrite       bool `help:"Refuse any mutating operation" env:"OLK_NO_WRITE"`
	NoSend        bool `help:"Refuse sending mail or meeting invites" env:"OLK_NO_SEND"`
	NoInput       bool `help:"Fail instead of prompting (headless/agent safety)" env:"OLK_NO_INPUT"`
	WrapUntrusted bool `help:"Wrap external free-text in untrusted-content markers (JSON/plain output)" env:"OLK_WRAP_UNTRUSTED"`

	// Command-scoping allow/deny lists (comma-separated dotted paths).
	EnableCommands      string `help:"Allow only these command prefixes (csv; e.g. mail,calendar)" env:"OLK_ENABLE_COMMANDS"`
	EnableCommandsExact string `help:"Allow only these exact command paths (csv; e.g. mail.list,mail.get)" env:"OLK_ENABLE_COMMANDS_EXACT"`
	DisableCommands     string `help:"Block these command paths (csv; overrides allows)" env:"OLK_DISABLE_COMMANDS"`
}

type RunContext struct {
	Ctx   context.Context
	Flags *RootFlags
	// contains filtered or unexported fields
}

type SearchCmd struct {
	Query string `arg:"" help:"Search query"`
	Top   int32  `help:"Max results" default:"25" short:"n"`
}

type SelectFields struct {
	Value string
	Set   bool
}

type SendCmd struct {
	To          []string `help:"Recipient email addresses" required:"" short:"t"`
	Subject     string   `help:"Email subject" required:"" short:"s"`
	Body        string   `help:"Email body" short:"b"`
	CC          []string `help:"CC recipients"`
	BCC         []string `help:"BCC recipients"`
	HTML        bool     `help:"Send body as HTML"`
	Attach      []string `help:"File paths to attach" type:"path"`
	Importance  string   `help:"Message importance: low|normal|high" enum:",low,normal,high" default:""`
	ReadReceipt bool     `help:"Request a read receipt"`
}

type TodayCmd struct {
	Top int32 `help:"Max events" default:"25" short:"n"`
}

type TodoAttachCmd struct {
	List     TodoAttachListCmd     `cmd:"" help:"List task attachments"`
	Upload   TodoAttachUploadCmd   `cmd:"" help:"Upload a file attachment"`
	Download TodoAttachDownloadCmd `cmd:"" help:"Download an attachment"`
	Delete   TodoAttachDeleteCmd   `cmd:"" help:"Delete an attachment"`
}

type TodoAttachDeleteCmd struct {
	TaskID       string `arg:"" help:"Task ID"`
	AttachmentID string `arg:"" help:"Attachment ID"`
	List         string `help:"Task list ID" env:"OLK_TODO_LIST"`
}

type TodoAttachDownloadCmd struct {
	TaskID       string `arg:"" help:"Task ID"`
	AttachmentID string `arg:"" help:"Attachment ID"`
	Out          string `help:"Output directory for download" default:"." type:"path"`
	List         string `help:"Task list ID" env:"OLK_TODO_LIST"`
}

type TodoAttachListCmd struct {
	TaskID string `arg:"" help:"Task ID"`
	List   string `help:"Task list ID" env:"OLK_TODO_LIST"`
}

type TodoAttachUploadCmd struct {
	TaskID string `arg:"" help:"Task ID"`
	File   string `arg:"" help:"File to upload" type:"existingfile"`
	List   string `help:"Task list ID" env:"OLK_TODO_LIST"`
}

type TodoChecklistCmd struct {
	List   TodoChecklistListCmd   `cmd:"" help:"List checklist items"`
	Create TodoChecklistCreateCmd `cmd:"" help:"Create a checklist item"`
	Toggle TodoChecklistToggleCmd `cmd:"" help:"Toggle a checklist item checked/unchecked"`
	Update TodoChecklistUpdateCmd `cmd:"" help:"Update a checklist item"`
	Delete TodoChecklistDeleteCmd `cmd:"" help:"Delete a checklist item"`
}

type TodoChecklistCreateCmd struct {
	TaskID string `arg:"" help:"Task ID"`
	Name   string `help:"Checklist item name" required:"" short:"n"`
	List   string `help:"Task list ID" env:"OLK_TODO_LIST"`
}

type TodoChecklistDeleteCmd struct {
	TaskID string `arg:"" help:"Task ID"`
	ItemID string `arg:"" help:"Checklist item ID"`
	List   string `help:"Task list ID" env:"OLK_TODO_LIST"`
}

type TodoChecklistListCmd struct {
	TaskID string `arg:"" help:"Task ID"`
	List   string `help:"Task list ID" env:"OLK_TODO_LIST"`
}

type TodoChecklistToggleCmd struct {
	TaskID string `arg:"" help:"Task ID"`
	ItemID string `arg:"" help:"Checklist item ID"`
	List   string `help:"Task list ID" env:"OLK_TODO_LIST"`
}

type TodoChecklistUpdateCmd struct {
	TaskID string `arg:"" help:"Task ID"`
	ItemID string `arg:"" help:"Checklist item ID"`
	Name   string `help:"New name" short:"n"`
	List   string `help:"Task list ID" env:"OLK_TODO_LIST"`
}

type TodoCmd struct {
	Lists     TodoListsCmd     `cmd:"" help:"Task list operations"`
	List      TodoListCmd      `cmd:"" help:"List tasks in a list"`
	Get       TodoGetCmd       `cmd:"" help:"Get task details"`
	Create    TodoCreateCmd    `cmd:"" help:"Create a task"`
	Complete  TodoCompleteCmd  `cmd:"" help:"Mark a task as complete"`
	Update    TodoUpdateCmd    `cmd:"" help:"Update a task"`
	Delete    TodoDeleteCmd    `cmd:"" help:"Delete a task"`
	Checklist TodoChecklistCmd `cmd:"" help:"Checklist item operations"`
	Attach    TodoAttachCmd    `cmd:"" help:"Task attachment operations"`
	Links     TodoLinksCmd     `cmd:"" help:"Linked resource operations"`
}

type TodoCompleteCmd struct {
	ID   string `arg:"" help:"Task ID"`
	List string `help:"Task list ID" env:"OLK_TODO_LIST"`
}

type TodoCreateCmd struct {
	List       string   `help:"Task list ID" env:"OLK_TODO_LIST"`
	Title      string   `help:"Task title" required:"" short:"t"`
	Due        string   `help:"Due date (ISO 8601, e.g. 2024-12-31)" short:"d"`
	Start      string   `help:"Start date (ISO 8601)" short:"s"`
	Reminder   string   `help:"Reminder date/time (ISO 8601)"`
	Recurrence string   `help:"Recurrence pattern" enum:"daily,weekdays,weekly,monthly,yearly," default:""`
	Importance string   `help:"Importance level" enum:"low,normal,high," default:""`
	Body       string   `help:"Task body text" short:"b"`
	Categories []string `help:"Categories to assign" short:"c"`
}

type TodoDeleteCmd struct {
	ID   string `arg:"" help:"Task ID"`
	List string `help:"Task list ID" env:"OLK_TODO_LIST"`
}

type TodoGetCmd struct {
	ID   string `arg:"" help:"Task ID"`
	List string `help:"Task list ID" env:"OLK_TODO_LIST"`
}

type TodoLinksCmd struct {
	List   TodoLinksListCmd   `cmd:"" help:"List linked resources"`
	Create TodoLinksCreateCmd `cmd:"" help:"Create a linked resource"`
	Delete TodoLinksDeleteCmd `cmd:"" help:"Delete a linked resource"`
}

type TodoLinksCreateCmd struct {
	TaskID     string `arg:"" help:"Task ID"`
	Name       string `help:"Display name" required:"" short:"n"`
	URL        string `help:"Web URL"`
	AppName    string `help:"Application name" default:"olk"`
	ExternalID string `help:"External ID"`
	List       string `help:"Task list ID" env:"OLK_TODO_LIST"`
}

type TodoLinksDeleteCmd struct {
	TaskID     string `arg:"" help:"Task ID"`
	ResourceID string `arg:"" help:"Linked resource ID"`
	List       string `help:"Task list ID" env:"OLK_TODO_LIST"`
}

type TodoLinksListCmd struct {
	TaskID string `arg:"" help:"Task ID"`
	List   string `help:"Task list ID" env:"OLK_TODO_LIST"`
}

type TodoListCmd struct {
	List   string `help:"Task list ID" env:"OLK_TODO_LIST"`
	Top    int32  `help:"Number of tasks to return" default:"25" short:"n"`
	Status string `help:"Filter by status" enum:"notStarted,inProgress,completed,waitingOnOthers,deferred," default:""`
}

type TodoListsCmd struct {
	List   TodoListsListCmd   `cmd:"" default:"1" help:"List task lists"`
	Create TodoListsCreateCmd `cmd:"" help:"Create a task list"`
	Delete TodoListsDeleteCmd `cmd:"" help:"Delete a task list"`
}

type TodoListsCreateCmd struct {
	Name string `help:"List name" required:"" short:"n"`
}

type TodoListsDeleteCmd struct {
	ID string `arg:"" help:"Task list ID"`
}

type TodoListsListCmd struct{}

type TodoUpdateCmd struct {
	ID         string   `arg:"" help:"Task ID"`
	List       string   `help:"Task list ID" env:"OLK_TODO_LIST"`
	Title      string   `help:"New title" short:"t"`
	Due        string   `help:"New due date (ISO 8601, or 'none' to clear)" short:"d"`
	Start      string   `help:"New start date (ISO 8601, or 'none' to clear)" short:"s"`
	Reminder   string   `help:"New reminder date/time (ISO 8601, or 'none' to clear)"`
	Recurrence string   `help:"New recurrence pattern, or 'none' to clear" enum:"daily,weekdays,weekly,monthly,yearly,none," default:""`
	Importance string   `help:"New importance level" enum:"low,normal,high," default:""`
	Body       string   `help:"New body text" short:"b"`
	Categories []string `help:"New categories (use -c none to clear)" short:"c"`
}

type VersionCmd struct{}

type WeekCmd struct {
	Top int32 `help:"Max events" default:"25" short:"n"`
}

type WhoamiCmd struct{}