Start a device-code sign-in for the mailbox. Returns a URL and a code for the human to enter in a browser; then call iris_login_finish() to complete. Only needed once, or after the refresh token lapses.

Complete a device-code sign-in started with iris_login(). Call after entering the code in the browser. Waits up to ~60s; if the code has not been entered yet, it says so and can simply be called again.

Report whether iris is signed in, as whom, and with what scopes.

Compose a message into a mail folder as an unsent draft. It is NOT sent — a human opens Outlook and presses Send.

folder selects the destination folder by display name, created on first use if absent. Omit it to use the configured default (IRIS_DRAFT_FOLDER, currently "AI Drafts"); pass "" or "Drafts" for the normal Outlook Drafts folder. Set reply_to_message_id to draft a threaded reply.

List recent messages sitting in a draft folder. folder selects which one by display name; omit it for the configured default (IRIS_DRAFT_FOLDER), or pass "" / "Drafts" for the normal Outlook Drafts folder.

List the mailbox's top-level mail folders (name, id, unread/total counts) so you can pick one to pass as the folder argument to iris_create_draft or iris_list_drafts.

Revise an existing draft in place. Only the fields you pass are changed.

Delete a draft. Destructive, so confirm=true is required — set it only after the human has explicitly approved deleting this specific draft.