Daybook

search_mailread

Search Avery's mailbox. Every filter is optional and filters combine with AND. Returns matching threads newest first, each with folder, labels, unread/starred flags and its latest message. Searches every folder except Trash unless folder says otherwise. Fails with invalid_time (bad after/before) or unknown_label.

read_threadread

Open a thread: every message with sender, recipients, subject, time, body and attachments (attachment ids are what forward_message takes). Opening a thread does not mark it read; use mark_threads for that. Fails with not_found.

list_labelsread

List the mail folders (Inbox, Archive, Sent, Trash) and custom labels with thread and unread counts, plus the number of saved drafts.

send_emailwrite

Send a new email from Avery. It starts a new thread that appears in Sent. Recipients are email addresses; addresses at northwind.example must belong to someone in the directory. To pass on a file from another email, use forward_message. Fails with invalid_address, unknown_recipient, missing_subject or empty_body.

reply_to_messagewrite

Reply to a message inside its thread. reply_all false (the default) replies to the sender only; reply_all true also includes everyone else on the original To and Cc lines. Avery is never added as a recipient. The subject gets a Re: prefix. Fails with not_found, empty_body or no_recipients.

forward_messagewrite

Forward a message as a new email that quotes the original. attachment_ids chooses which of that message's attachments go along: omit it to include all of them, or pass [] for none. Fails with not_found, invalid_address, unknown_recipient or attachment_not_in_message.

save_draftwrite

Create or update a draft without sending it. New reply draft: pass in_reply_to (a message id) and optionally reply_all; recipients and subject are filled in as for a reply unless you pass them. New email draft: pass any of to, cc, subject, body. Edit a draft: pass draft_id plus the fields to replace. send_draft sends it later. Fails with not_found, invalid_address, unknown_recipient, empty_draft, invalid_draft_update or nothing_to_change.

send_draftwrite

Send a saved draft. A reply draft is sent into its original thread; any other draft starts a new thread. The draft is removed once sent. Fails with not_found, no_recipients, missing_subject or empty_body.

label_threadswrite

Add and/or remove custom labels on one or more threads. Labels are given by name or id, e.g. "Receipts". A label a thread already has (or lacks) is left alone. Folders are not labels: use archive_threads or trash_threads to move mail. Fails with not_found, unknown_label, conflicting_labels or nothing_to_change; nothing changes if any argument is bad.

archive_threadswrite

Archive threads: move them out of the Inbox (or Sent) into Archive, where they stay searchable. Already-archived threads are skipped. Mail in Trash can't be archived. Fails with not_found or in_trash; nothing changes if any id fails.

trash_threadswrite

Move threads to Trash. Nothing is ever permanently deleted. Policy: only do this when Avery explicitly asks to delete or trash mail; otherwise archive. Threads already in Trash are skipped. Fails with not_found; nothing changes if any id fails.

mark_threadswrite

Mark threads read or unread and/or starred or unstarred. Pass read, starred or both. Fails with not_found or nothing_to_change.

search_contactsread

Search the Northwind directory and external contacts by name, email, title, team or company. Each contact has their time zone, fixed UTC offset, working hours (local time, Monday to Friday) and current local time. With no filters, lists everyone.

list_eventsread

List events on Avery's calendar (meetings Avery organizes or is invited to) that overlap start–end; default is this week, Monday 12 to Friday 16 January, New York time. my_response is organizer, needs_action (a pending invitation), accepted, declined or tentative. Cancelled events are hidden unless include_cancelled. Fails with invalid_time or invalid_range.

get_eventread

Full details of an event on Avery's calendar: description, organizer, each attendee's response and note, room and its capacity, video link and proposed times. Fails with not_found (also for events that aren't on Avery's calendar).

get_free_busyread

Free/busy for Northwind colleagues between start and end (at most 14 days). Include Avery's own address to see Avery's busy time. For each person: time zone, fixed UTC offset, working hours as UTC windows, and merged busy intervals in UTC. Accepted, tentative and unanswered invitations all count as busy; event details stay private. Fails with unknown_person (external addresses have no free/busy), invalid_time or invalid_range.

list_roomsread

List meeting rooms with capacity (seats), floor and equipment. Pass start and end to see whether each room is free then; min_capacity filters by seats. Fails with invalid_time or invalid_range.

create_eventwrite

Create a meeting with Avery as organizer and send the invitations. attendees are required guests and optional_attendees optional ones (email addresses; northwind.example addresses must exist). Avery is added automatically. room_id books a room and fails with room_unavailable if it's taken; a room smaller than the meeting is allowed but triggers a warning. video_call adds a video link. The result includes warnings about working hours, conflicts and room size. Fails with missing_title, invalid_time, invalid_range, in_past, invalid_address, unknown_recipient, room_not_found or room_unavailable.

update_eventwrite

Change an event Avery organizes: title, time, room, description, location, video link or guests. Pass only what changes. If start moves and end is omitted, the duration is kept. room_id "" removes the room; the event's room must be free at a new time. When the time changes, every attendee's response resets to needs_action. notify (default true) sends the update to all attendees with your optional message. Fails with not_found, not_organizer, cancelled, invalid_time, invalid_range, in_past, room_not_found, room_unavailable, invalid_address, unknown_recipient, not_an_attendee or nothing_to_change.

cancel_eventwrite

Cancel an event Avery organizes and, by default, tell the attendees. Invitations from other people can't be cancelled; decline them with rsvp_event. Fails with not_found, not_organizer, already_cancelled or in_past.

rsvp_eventwrite

Respond to an invitation on Avery's behalf: accepted, declined or tentative, with an optional note that replaces any earlier note. The organizer is notified unless notify_organizer is false. Answering again with the same response and note changes nothing. Fails with not_found, organizer_cannot_rsvp, cancelled or in_past.

propose_new_timewrite

Suggest a different time for an invitation to its organizer, with an optional note. Avery's RSVP stays as it is. Fails with not_found, organizer_cannot_propose (change your own events with update_event), cancelled, invalid_time, invalid_range or in_past.