@remit/api-openapi-types 0.0.41 → 0.0.43

package/types.d.ts

@@ -137,6 +137,34 @@ current enum emitter anyway, so the wire contract uses the bare form.
      * Lifecycle state of a smart-organize back-apply job (RFC 034, #1278). Mirrors the account-export job's lifecycle: a Pending row the worker picks up, drives to Running, then to a terminal Complete or Failed.
      */
     export type OrganizeJobState = "Pending" | "Running" | "Complete" | "Failed";
+    /**
+     * Display color for a calendar collection. Positional rather than named: the palette is a client-side concern, so the store carries the slot and the client owns what it renders (issue #15).
+     */
+    export type CalendarColor = "Cal1" | "Cal2" | "Cal3" | "Cal4" | "Cal5" | "Cal6";
+    /**
+     * Which iCalendar components a collection accepts (RFC 4791 supported-calendar-component-set). Only VEVENT is stored today; VTODO and VJOURNAL collections would be separate members, so the value is a property of the collection rather than of each object.
+     */
+    export type CalendarComponentSet = "VeventOnly";
+    /**
+     * Where a calendar collection came from. `Default` is the one provisioned per account config on first use and is never deleted; `UserCreated` is one a person made; `MailDerived` is one populated from mail rather than by a person.
+     */
+    export type CalendarSource = "Default" | "UserCreated" | "MailDerived";
+    /**
+     * Projection of a VEVENT's STATUS property (RFC 5545 3.8.1.11). A VEVENT with no STATUS projects as `Confirmed`, which is the value RFC 5545 gives an event whose status is unstated.
+     */
+    export type CalendarEventStatus = "Confirmed" | "Tentative" | "Cancelled";
+    /**
+     * Projection of a VEVENT's TRANSP property (RFC 5545 3.8.2.7) — whether the event consumes free/busy time. A VEVENT with no TRANSP projects as `Opaque`, the RFC default.
+     */
+    export type CalendarTransparency = "Opaque" | "Transparent";
+    /**
+     * How confidently a stored time was placed on the clock. A calendar that cannot say this hides its worst failure: an event read in the wrong zone is off by hours and looks exactly like an event read correctly.
+     */
+    export type ZoneCertainty = "Local" | "Explicit" | "Ambiguous";
+    /**
+     * Which occurrences of a recurring event a write applies to (issue #15). A request parameter, never a stored column: the resource records what the series is, and this records what the caller meant by editing one drawing of it.
+     */
+    export type RecurrenceScope = "This" | "Following" | "All";
     /**
      * Sort order for list operations
      */
@@ -233,6 +261,18 @@ distinguishable from a network failure without parsing prose.
      * Manual bulk label action (issue #26) — apply or remove a label on a `just these` selection. Never sets `appliedByFilterId`: that field is reserved for filter-driven applies (RFC 034 Decision 3.3).
      */
     export type LabelAction = "Apply" | "Remove";
+    /**
+     * What has become of a suggestion. `Pending` is the only state that asks a person for anything; every other value is a decision already taken, and nothing but an explicit act moves a suggestion out of `Pending`.
+     */
+    export type CalendarSuggestionState = "Pending" | "Accepted" | "Declined" | "Tentative" | "Dismissed" | "Superseded";
+    /**
+     * The iTIP method a scheduling message carries (RFC 5546 3.2), read from the VCALENDAR's METHOD property. It says what the sender is asking for, which is not derivable from the VEVENT: a cancellation and an invitation differ by this property alone.
+     */
+    export type CalendarInviteMethod = "Request" | "Reply" | "Cancel" | "Counter" | "Publish" | "None";
+    /**
+     * Where in a message a suggestion was read from. It is what a card says to explain itself, and it is what separates a suggestion carrying real iCalendar from one inferred out of prose.
+     */
+    export type CalendarSuggestionSource = "IcalendarPart" | "IcalendarAttachment" | "TextHeuristic";
     /**
      * System message flags defined in RFC 9051 Section 2.3.2 - MUST be supported by all servers
      */
@@ -265,30 +305,6 @@ distinguishable from a network failure without parsing prose.
      * Which piece of configuration a still-unbound folder reference belongs to. A mailbox id is regenerated by every discovery, so an imported file names folders by IMAP path and the binder writes the row once a path resolves.
      */
     export type ConfigImportRefKind = "FolderRole" | "MailboxOverride" | "FilterAction";
-    /**
-     * Display color for a calendar collection. Positional rather than named: the palette is a client-side concern, so the store carries the slot and the client owns what it renders (issue #15).
-     */
-    export type CalendarColor = "Cal1" | "Cal2" | "Cal3" | "Cal4" | "Cal5" | "Cal6";
-    /**
-     * Which iCalendar components a collection accepts (RFC 4791 supported-calendar-component-set). Only VEVENT is stored today; VTODO and VJOURNAL collections would be separate members, so the value is a property of the collection rather than of each object.
-     */
-    export type CalendarComponentSet = "VeventOnly";
-    /**
-     * Where a calendar collection came from. `Default` is the one provisioned per account config on first use and is never deleted; `UserCreated` is one a person made; `MailDerived` is one populated from mail rather than by a person.
-     */
-    export type CalendarSource = "Default" | "UserCreated" | "MailDerived";
-    /**
-     * Projection of a VEVENT's STATUS property (RFC 5545 3.8.1.11). A VEVENT with no STATUS projects as `Confirmed`, which is the value RFC 5545 gives an event whose status is unstated.
-     */
-    export type CalendarEventStatus = "Confirmed" | "Tentative" | "Cancelled";
-    /**
-     * Projection of a VEVENT's TRANSP property (RFC 5545 3.8.2.7) — whether the event consumes free/busy time. A VEVENT with no TRANSP projects as `Opaque`, the RFC default.
-     */
-    export type CalendarTransparency = "Opaque" | "Transparent";
-    /**
-     * How confidently a stored time was placed on the clock. A calendar that cannot say this hides its worst failure: an event read in the wrong zone is off by hours and looks exactly like an event read correctly.
-     */
-    export type ZoneCertainty = "Local" | "Explicit" | "Ambiguous";
     /**
      * Explicit state engine for a pending placement-move marker (issue #1271, epic #1281). Recovery keys off this field, not control-flow inference: a redelivered/retried call drives a marker forward from whichever state it is actually in, rather than re-deriving intent by comparing the message's current location.
      */
@@ -415,6 +431,24 @@ a compile-time error rather than a value that silently sorts incorrectly.
        */
       details?: Record;
     }
+    /**
+     * Not found error response
+     */
+    export interface NotFoundError {
+      statusCode: 404;
+      error: ApiError;
+    }
+    /**
+     * The condition the request stated is no longer true. Answered when an
+`If-Match` names an etag the stored resource no longer carries: somebody else
+wrote it in between, so applying this request would silently discard their
+change. The client re-reads the resource and decides what to do with the
+version it now has.
+     */
+    export interface PreconditionFailedError {
+      statusCode: 412;
+      error: ApiError;
+    }
     /**
      * The same flat 409 body, with the two codes this endpoint can answer with.
 
@@ -463,13 +497,6 @@ a compile-time error rather than a value that silently sorts incorrectly.
       passthroughBehavior: "when_no_match";
       uri: any;
     }
-    /**
-     * Not found error response
-     */
-    export interface NotFoundError {
-      statusCode: 404;
-      error: ApiError;
-    }
     /**
      * Internal server error response
      */
@@ -2250,166 +2277,663 @@ standing to persist.
       updatedAt: number;
     }
     /**
-     * Response from emptying trash
+     * Every calendar collection of the caller's account config, url segment first. Unpaginated: an account holds a handful of calendars, and a page boundary in a sidebar is a bug waiting to happen.
      */
-    export interface EmptyTrashResponse {
-      /**
-       * Number of messages permanently deleted
-       */
-      deletedCount: number;
+    export interface CalendarListResponse {
+      items: CalendarResponse[];
     }
     /**
-     * Sync trigger response
+     * A calendar collection scoped to an account config (issue #15) — the CalDAV
+collection a client mounts, and the parent of every CalendarObject.
+
+`calendarId` is derived from `(accountConfigId, urlSegment)`, so the DAV path
+a client bookmarks resolves to a row without a lookup table, and provisioning
+the same collection twice writes the same row instead of a second one.
+`displayName` is the mutable human overlay and is never the key.
+
+`syncSequence` is the collection's monotonic change counter: every write
+through the calendar service's put path bumps it and stamps the new value on
+the object it wrote, which is what a later WebDAV-Sync `sync-token` reports
+and what `CalendarObject.bySyncSequence` pages by.
      */
-    export interface SyncTriggerResponse {
+    export interface CalendarCollection {
       /**
-       * Whether sync was triggered successfully
+       * Primary identifier, derived from accountConfigId + urlSegment
        */
-      triggered: boolean;
+      calendarId: UUID;
       /**
-       * Message about sync status
+       * Owning account configuration
        */
-      message: string;
-    }
-    /**
-     * Aggregate sync-status response for an account
-     */
-    export interface AccountSyncStatusResponse {
+      accountConfigId: UUID;
       /**
-       * Account identifier
+       * Path segment this collection is addressed by, unique within the account config. Stored case-folded, the same folding `calendarId` is derived from — a DAV path is matched case-insensitively, and storing the writer's casing would let a lookup by segment and a lookup by derived id disagree about one path. The default collection provisioned on first use holds "default".
        */
-      accountId: UUID;
+      urlSegment: String64;
       /**
-       * Current sync phase for the account
+       * Human-readable collection name (display)
        */
-      syncPhase?: SyncPhase;
+      displayName: String140;
       /**
-       * Total number of mailboxes discovered
+       * Display color slot for this collection
        */
-      mailboxCountTotal?: number;
+      color: CalendarColor;
       /**
-       * Number of mailboxes whose initial message sync has completed
+       * Which iCalendar components this collection accepts
        */
-      mailboxCountSynced?: number;
+      componentSet: CalendarComponentSet;
       /**
-       * When the account's most recent sync round started, stamped once per round by the worker. A client that triggered a sync compares this against the reading it took before triggering, so it confirms only on a round of its own rather than one already in flight.
+       * Where this collection came from
        */
-      lastSyncAt?: number;
+      source: CalendarSource;
       /**
-       * Per-mailbox sync progress
+       * IANA time zone this collection's floating times are read in, e.g. "Europe/Amsterdam". `""` when none is set, which reads as UTC.
        */
-      mailboxes: MailboxSyncProgress[];
+      timezone: String64;
+      /**
+       * Monotonic change counter for this collection. Bumped by every write to one of its objects; the value stamped on `CalendarObject.syncSequence` is the value this counter held after that write.
+       */
+      syncSequence: number;
+      createdAt: number;
+      updatedAt: number;
     }
     /**
-     * Per-mailbox progress entry in the sync-status response
+     * A calendar collection as the API returns it.
      */
-    export interface MailboxSyncProgress {
+    export interface CalendarResponse {
       /**
-       * Mailbox identifier
+       * Primary identifier, derived from accountConfigId + urlSegment
        */
-      mailboxId: UUID;
+      calendarId: UUID;
       /**
-       * Full IMAP path (e.g. INBOX, Sent)
+       * Owning account configuration
        */
-      fullPath: string;
+      accountConfigId: UUID;
       /**
-       * Sync phase for this mailbox: pending (never synced), syncing (in-progress), or complete
+       * Path segment this collection is addressed by, unique within the account config. Stored case-folded, the same folding `calendarId` is derived from — a DAV path is matched case-insensitively, and storing the writer's casing would let a lookup by segment and a lookup by derived id disagree about one path. The default collection provisioned on first use holds "default".
        */
-      phase: string;
+      urlSegment: String64;
       /**
-       * Total messages in mailbox (refreshed each batch)
+       * Human-readable collection name (display)
        */
-      messagesTotal: number;
+      displayName: String140;
       /**
-       * Approximate number of messages synced. Computed as highWaterMarkUid − lastSyncUid (UID-range approximation; UIDs are sparse so this may undercount). Clamped to messagesTotal.
+       * Display color slot for this collection
        */
-      messagesSynced: number;
+      color: CalendarColor;
       /**
-       * Timestamp of the last successful message sync for this mailbox
+       * Which iCalendar components this collection accepts
        */
-      lastSyncedAt?: number;
+      componentSet: CalendarComponentSet;
+      /**
+       * Where this collection came from
+       */
+      source: CalendarSource;
+      /**
+       * IANA time zone this collection's floating times are read in, e.g. "Europe/Amsterdam". `""` when none is set, which reads as UTC.
+       */
+      timezone: String64;
+      /**
+       * Monotonic change counter for this collection. Bumped by every write to one of its objects; the value stamped on `CalendarObject.syncSequence` is the value this counter held after that write.
+       */
+      syncSequence: number;
+      createdAt: number;
+      updatedAt: number;
     }
     /**
-     * Input for creating a new email account
+     * Input for creating a calendar collection (issue #15).
+
+`urlSegment` is supplied rather than derived from the display name: it is the
+collection's identity — `calendarId` is a hash of it — and the path a CalDAV
+client will later bookmark. Slugging a name would make two calendars called
+"Work" one row, and a rename would either move a bookmarked path or leave a
+segment that no longer matches anything a person recognises. The name is the
+mutable overlay; this is the address.
      */
-    export interface CreateAccountInput {
+    export interface CreateCalendarInput {
       /**
-       * Primary email address for this account
+       * Human-readable collection name (display)
        */
-      email: string;
+      displayName: String140;
       /**
-       * Display name (optional)
+       * Path segment addressing this collection, unique within the account config. Case-folded on write, so "Work" and "work" name the same collection and the second create is refused rather than silently merged into the first.
        */
-      displayName?: string;
+      urlSegment: String64;
       /**
-       * IMAP login username (defaults to email if not provided)
+       * Display colour slot. Absent takes the collection's own default.
        */
-      username?: string;
+      color?: CalendarColor;
       /**
-       * Authentication mechanism for this account. Defaults to `password`. Pass `oauthMicrosoft` only via the OAuth connect flow (POST /accounts/oauth/microsoft/start).
+       * IANA time zone this collection's floating times are read in. Absent reads them as UTC.
        */
-      authType?: AccountAuthType;
+      timezone?: String64;
+    }
+    /**
+     * Input for updating a calendar collection. The name, colour and timezone are the mutable overlay; `urlSegment` is not among them, because it is the collection's identity and the path a client has bookmarked.
+     */
+    export interface UpdateCalendarInput {
       /**
-       * Account password (will be encrypted). Required for password accounts; omit for OAuth accounts.
+       * Human-readable collection name (display)
        */
-      password?: string;
+      displayName: String140;
       /**
-       * IMAP server hostname
+       * Display color slot for this collection
        */
-      imapHost: string;
+      color: CalendarColor;
       /**
-       * IMAP server port
+       * IANA time zone this collection's floating times are read in, e.g. "Europe/Amsterdam". `""` when none is set, which reads as UTC.
        */
-      imapPort: number;
+      timezone: String64;
+    }
+    /**
+     * Nothing to return. The resource, or the occurrence, is gone.
+     */
+    export interface CalendarNoContent {
+      statusCode: 204;
+    }
+    /**
+     * Expanded occurrences in the requested window, in start order.
+
+Includes an occurrence that began before `from` and runs into the window, up
+to a bounded lookback — a meeting that started last night is part of this
+morning. Unpaginated: the window is the bound.
+     */
+    export interface CalendarEventListResponse {
+      items: CalendarEventInstance[];
+    }
+    /**
+     * One occurrence of an event, in the window the caller asked for (issue #15).
+
+Instances are expanded by the server. A client never reads an RRULE and never
+reconstructs a series: it renders what this returns, and addresses one
+occurrence by `calendarObjectId` plus `recurrenceId`.
+     */
+    export interface CalendarEventInstance {
       /**
-       * Use TLS encryption
+       * Collection this occurrence belongs to
        */
-      imapTls: boolean;
+      calendarId: UUID;
       /**
-       * Use STARTTLS upgrade
+       * Resource this occurrence was expanded from
        */
-      imapStartTls: boolean;
+      calendarObjectId: UUID;
       /**
-       * Whether to enable SMTP sending for this account. When omitted, the server enables sending if an SMTP host is supplied.
+       * RECURRENCE-ID of this occurrence as an ISO 8601 UTC instant, or `""` for a resource that does not recur. This is the value a scoped write passes back to name the occurrence it means.
        */
-      smtpEnabled?: boolean;
+      recurrenceId: String64;
       /**
-       * SMTP server hostname (optional)
+       * The event's iCalendar UID, shared by every occurrence of the series
        */
-      smtpHost?: string;
+      icalUid: String512;
       /**
-       * SMTP server port
+       * Projection of the VEVENT's SUMMARY. `""` when the event carries none.
        */
-      smtpPort?: number;
+      summary: String512;
       /**
-       * Use TLS encryption for SMTP
+       * When this occurrence starts, as an ISO 8601 date-time with zone offset, read in the collection's timezone. A business date, not an epoch instant: an all-day occurrence carries midnight of its civil date.
        */
-      smtpTls?: boolean;
+      start: String64;
       /**
-       * Use STARTTLS upgrade for SMTP
+       * When this occurrence ends, as an ISO 8601 date-time with zone offset. Exclusive for an all-day occurrence, per RFC 5545 3.6.1.
        */
-      smtpStartTls?: boolean;
+      end: String64;
       /**
-       * SMTP username if different from IMAP
+       * Whether this occurrence is all-day
        */
-      smtpUsername?: string;
+      allDay: boolean;
       /**
-       * SMTP password if different from IMAP
+       * Projection of the occurrence's STATUS
        */
-      smtpPassword?: string;
-    }
-    /**
-     * Input for testing connection without saving
-     */
-    export interface TestConnectionInput {
+      status: CalendarEventStatus;
       /**
-       * Account ID (optional, used to retrieve stored password if password is empty)
+       * Projection of the occurrence's TRANSP — whether it consumes free/busy time
        */
-      accountId?: UUID;
+      transparency: CalendarTransparency;
       /**
-       * IMAP login username
+       * How the resource's start was placed on the clock. `Ambiguous` means the resource named a zone nothing could resolve, so this occurrence may be hours out; a client says so rather than presenting the guess as a fact.
        */
-      username: string;
+      zoneCertainty: ZoneCertainty;
+      /**
+       * Entity tag of the resource this occurrence came from. Pass it as `If-Match` on a scoped write to refuse an edit built on a version somebody has since replaced.
+       */
+      etag: String64;
+      /**
+       * Whether the resource this occurrence came from expands to more than one instance. A client showing the recurrence-scope prompt gates on this.
+       */
+      hasRecurrence: boolean;
+    }
+    /**
+     * Input for creating an event (issue #15). The server builds the VEVENT and
+writes it through the single calendar write path, so an event created here,
+one accepted from an invitation, and one PUT over CalDAV are the same bytes
+written the same way.
+
+Times are ISO 8601 with zone offset — or a bare `YYYY-MM-DD` date when
+`allDay` is set. The offset pins the instant; `timeZone` names the zone the
+event is anchored in, which is what a recurring event needs to survive a DST
+transition. An offset alone cannot: a weekly 09:00 meeting written as
+`+02:00` becomes an 08:00 meeting in November.
+     */
+    export interface CreateCalendarEventInput {
+      /**
+       * Collection to write the event into
+       */
+      calendarId: UUID;
+      /**
+       * SUMMARY of the event
+       */
+      summary: String512;
+      /**
+       * DESCRIPTION of the event. Absent writes none.
+       */
+      description?: String2048;
+      /**
+       * LOCATION of the event. Absent writes none.
+       */
+      location?: String512;
+      /**
+       * When the event starts: an ISO 8601 date-time with zone offset, or a `YYYY-MM-DD` date when `allDay` is set.
+       */
+      start: String64;
+      /**
+       * When the event ends, in the same form as `start`. Exclusive for an all-day event, per RFC 5545 3.6.1.
+       */
+      end: String64;
+      /**
+       * Whether this is an all-day event, whose times are civil dates rather than instants
+       */
+      allDay?: boolean;
+      /**
+       * IANA time zone the event is anchored in, e.g. "Europe/Amsterdam", written as the DTSTART TZID. Absent anchors the event in UTC. Refused with 400 when the zone is one this server cannot resolve — a calendar that accepted an unknown zone would draw the event hours away from where it belongs.
+       */
+      timeZone?: String64;
+      /**
+       * STATUS of the event
+       */
+      status?: CalendarEventStatus;
+      /**
+       * TRANSP of the event — whether it consumes free/busy time
+       */
+      transparency?: CalendarTransparency;
+      /**
+       * RRULE value for a recurring event, e.g. "FREQ=WEEKLY;BYDAY=MO" (RFC 5545 3.8.5.3), without the property name. `""` creates a single event. Refused with 400 when it is not a rule this server can read.
+       */
+      recurrenceRule?: String512;
+    }
+    /**
+     * One calendar resource — the bytes behind one `.ics` URL (issue #15).
+
+`icalData` is the canonical value. Every other column on this row is a
+projection of it, computed on write and never written independently: a reader
+that needs a fact the projection does not carry re-parses `icalData` rather
+than adding a column that could disagree with it.
+
+The write path parses the bytes to validate and project them and then stores
+the bytes it was handed, never a reserialization of them. That is what keeps
+`etag` honest: the tag is a digest of exactly what the writer sent, so it
+moves only when a writer sends something different. It is not a digest that
+survives a round trip through the parser — ical.js refolds long lines and
+reorders properties, so a resource stored as its own reserialization would
+change tag without anyone editing it, and every client's cache would miss.
+
+`calendarObjectId` is derived from `(calendarId, resourceName)`: the resource
+name is the last path segment of the resource's URL, so the URL a client holds
+resolves to a row directly, and a repeated PUT of the same resource rewrites
+its own row.
+     */
+    export interface CalendarObject {
+      /**
+       * Primary identifier, derived from calendarId + resourceName
+       */
+      calendarObjectId: UUID;
+      /**
+       * Collection this resource belongs to
+       */
+      calendarId: UUID;
+      /**
+       * Last path segment of the resource's URL, e.g. "a1b2c3.ics". Unique within the collection and chosen by whoever wrote the resource, never derived from its contents — a client is free to rename a resource without changing the event it holds.
+       */
+      resourceName: String256;
+      /**
+       * The VEVENT's UID property (RFC 5545 3.8.4.7). Identifies the event across collections and servers, which `resourceName` does not.
+       */
+      icalUid: String512;
+      /**
+       * The complete VCALENDAR text, byte-for-byte as stored — CANONICAL. Line endings are CRLF and are never normalized; unknown properties and components are preserved verbatim.
+       */
+      icalData: string;
+      /**
+       * Strong entity tag over the stored `icalData` bytes, used for If-Match on a conditional write and for change detection on read.
+       */
+      etag: String64;
+      /**
+       * The VEVENT's SEQUENCE property (RFC 5545 3.8.7.4) — the organizer's own revision counter, carried for scheduling comparisons. `0` when the event declares none, which is the RFC default.
+       */
+      sequence: number;
+      /**
+       * Value the owning collection's `syncSequence` held after the write that produced this row. Pages the `bySyncSequence` read.
+       */
+      syncSequence: number;
+      /**
+       * Projection of the VEVENT's SUMMARY (RFC 5545 3.8.1.12). `""` when the event carries none.
+       */
+      summary: String512;
+      /**
+       * Projection of the master VEVENT's DTSTART as an ISO 8601 date-time with zone offset — a business date, not an epoch instant. An all-day event carries midnight in the event's own zone.
+       */
+      dtStart: String64;
+      /**
+       * Projection of the master VEVENT's effective end as an ISO 8601 date-time with zone offset, resolved from DTEND or from DTSTART + DURATION. An event with neither ends when it starts (RFC 5545 3.6.1).
+       */
+      dtEnd: String64;
+      /**
+       * Whether the master VEVENT's DTSTART is a DATE rather than a DATE-TIME (RFC 5545 3.3.4) — an all-day or multi-day event, whose end is exclusive.
+       */
+      allDay: boolean;
+      /**
+       * How the master VEVENT's DTSTART was placed on the clock. `Ambiguous` means the resource named a zone nothing could resolve, so `dtStart` and every occurrence expanded from it may be off by hours — a client shows the event and says so rather than presenting a guess as a fact.
+       */
+      zoneCertainty: ZoneCertainty;
+      /**
+       * Projection of the master VEVENT's STATUS
+       */
+      status: CalendarEventStatus;
+      /**
+       * Projection of the master VEVENT's TRANSP
+       */
+      transparency: CalendarTransparency;
+      /**
+       * Whether the resource expands to more than its master instance — an RRULE, an RDATE, or an override VEVENT. Overrides count on their own: a client that edits one instance and then drops the rule leaves a resource with a master and its exceptions, and each of those is still an occurrence.
+       */
+      hasRecurrence: boolean;
+      /**
+       * ISO 8601 UTC instant through which `CalendarEventIndex` rows exist for this resource, when the series runs past the expansion horizon and the index is therefore incomplete. `""` when the index is exhaustive — a single event, or a series that ends inside the horizon. A later live-expansion pass reads this to find the resources whose instances it must compute rather than query.
+       */
+      expandedThrough: String64;
+      createdAt: number;
+      updatedAt: number;
+    }
+    /**
+     * A stored calendar resource — the bytes behind one event, plus the columns projected from them. `icalData` is canonical; every other field is derived from it on write.
+     */
+    export interface CalendarEventResponse {
+      /**
+       * Primary identifier, derived from calendarId + resourceName
+       */
+      calendarObjectId: UUID;
+      /**
+       * Collection this resource belongs to
+       */
+      calendarId: UUID;
+      /**
+       * Last path segment of the resource's URL, e.g. "a1b2c3.ics". Unique within the collection and chosen by whoever wrote the resource, never derived from its contents — a client is free to rename a resource without changing the event it holds.
+       */
+      resourceName: String256;
+      /**
+       * The VEVENT's UID property (RFC 5545 3.8.4.7). Identifies the event across collections and servers, which `resourceName` does not.
+       */
+      icalUid: String512;
+      /**
+       * The complete VCALENDAR text, byte-for-byte as stored — CANONICAL. Line endings are CRLF and are never normalized; unknown properties and components are preserved verbatim.
+       */
+      icalData: string;
+      /**
+       * Strong entity tag over the stored `icalData` bytes, used for If-Match on a conditional write and for change detection on read.
+       */
+      etag: String64;
+      /**
+       * The VEVENT's SEQUENCE property (RFC 5545 3.8.7.4) — the organizer's own revision counter, carried for scheduling comparisons. `0` when the event declares none, which is the RFC default.
+       */
+      sequence: number;
+      /**
+       * Value the owning collection's `syncSequence` held after the write that produced this row. Pages the `bySyncSequence` read.
+       */
+      syncSequence: number;
+      /**
+       * Projection of the VEVENT's SUMMARY (RFC 5545 3.8.1.12). `""` when the event carries none.
+       */
+      summary: String512;
+      /**
+       * Projection of the master VEVENT's DTSTART as an ISO 8601 date-time with zone offset — a business date, not an epoch instant. An all-day event carries midnight in the event's own zone.
+       */
+      dtStart: String64;
+      /**
+       * Projection of the master VEVENT's effective end as an ISO 8601 date-time with zone offset, resolved from DTEND or from DTSTART + DURATION. An event with neither ends when it starts (RFC 5545 3.6.1).
+       */
+      dtEnd: String64;
+      /**
+       * Whether the master VEVENT's DTSTART is a DATE rather than a DATE-TIME (RFC 5545 3.3.4) — an all-day or multi-day event, whose end is exclusive.
+       */
+      allDay: boolean;
+      /**
+       * How the master VEVENT's DTSTART was placed on the clock. `Ambiguous` means the resource named a zone nothing could resolve, so `dtStart` and every occurrence expanded from it may be off by hours — a client shows the event and says so rather than presenting a guess as a fact.
+       */
+      zoneCertainty: ZoneCertainty;
+      /**
+       * Projection of the master VEVENT's STATUS
+       */
+      status: CalendarEventStatus;
+      /**
+       * Projection of the master VEVENT's TRANSP
+       */
+      transparency: CalendarTransparency;
+      /**
+       * Whether the resource expands to more than its master instance — an RRULE, an RDATE, or an override VEVENT. Overrides count on their own: a client that edits one instance and then drops the rule leaves a resource with a master and its exceptions, and each of those is still an occurrence.
+       */
+      hasRecurrence: boolean;
+      /**
+       * ISO 8601 UTC instant through which `CalendarEventIndex` rows exist for this resource, when the series runs past the expansion horizon and the index is therefore incomplete. `""` when the index is exhaustive — a single event, or a series that ends inside the horizon. A later live-expansion pass reads this to find the resources whose instances it must compute rather than query.
+       */
+      expandedThrough: String64;
+      createdAt: number;
+      updatedAt: number;
+    }
+    /**
+     * Input for updating an event. Every field is optional and absence means
+untouched — a patch that carries only `summary` renames the event and moves
+nothing.
+
+What the patch applies to is the `scope` parameter's business: `All` rewrites
+the master, `This` writes a RECURRENCE-ID override for one occurrence, and
+`Following` splits the series at one occurrence and applies the patch to the
+remainder.
+     */
+    export interface UpdateCalendarEventInput {
+      summary?: String512;
+      description?: String2048;
+      location?: String512;
+      start?: String64;
+      end?: String64;
+      allDay?: boolean;
+      timeZone?: String64;
+      status?: CalendarEventStatus;
+      transparency?: CalendarTransparency;
+      /**
+       * RRULE value, or `""` to drop the rule. Only meaningful with `scope=All` or `scope=Following`: an override is one occurrence and carries no rule of its own.
+       */
+      recurrenceRule?: String512;
+    }
+    /**
+     * Merged busy spans over the requested window, in start order. An event marked TRANSP:TRANSPARENT or STATUS:CANCELLED is not busy time and never appears here.
+     */
+    export interface CalendarFreeBusyResponse {
+      items: CalendarFreeBusySpan[];
+    }
+    /**
+     * One stretch of time the caller is busy in. Merged across every calendar they
+hold, so two overlapping meetings in two calendars are one span and a caller
+asking "is this slot free" never has to do the merging itself.
+     */
+    export interface CalendarFreeBusySpan {
+      /**
+       * When the busy stretch starts, as an ISO 8601 date-time with a `+00:00` offset. A busy span is an interval on the clock rather than a civil date, so it carries no calendar's local zone — the caller renders it in whichever zone it is drawing.
+       */
+      start: String64;
+      /**
+       * When the busy stretch ends, as an ISO 8601 date-time with a `+00:00` offset
+       */
+      end: String64;
+    }
+    /**
+     * Response from emptying trash
+     */
+    export interface EmptyTrashResponse {
+      /**
+       * Number of messages permanently deleted
+       */
+      deletedCount: number;
+    }
+    /**
+     * Sync trigger response
+     */
+    export interface SyncTriggerResponse {
+      /**
+       * Whether sync was triggered successfully
+       */
+      triggered: boolean;
+      /**
+       * Message about sync status
+       */
+      message: string;
+    }
+    /**
+     * Aggregate sync-status response for an account
+     */
+    export interface AccountSyncStatusResponse {
+      /**
+       * Account identifier
+       */
+      accountId: UUID;
+      /**
+       * Current sync phase for the account
+       */
+      syncPhase?: SyncPhase;
+      /**
+       * Total number of mailboxes discovered
+       */
+      mailboxCountTotal?: number;
+      /**
+       * Number of mailboxes whose initial message sync has completed
+       */
+      mailboxCountSynced?: number;
+      /**
+       * When the account's most recent sync round started, stamped once per round by the worker. A client that triggered a sync compares this against the reading it took before triggering, so it confirms only on a round of its own rather than one already in flight.
+       */
+      lastSyncAt?: number;
+      /**
+       * Per-mailbox sync progress
+       */
+      mailboxes: MailboxSyncProgress[];
+    }
+    /**
+     * Per-mailbox progress entry in the sync-status response
+     */
+    export interface MailboxSyncProgress {
+      /**
+       * Mailbox identifier
+       */
+      mailboxId: UUID;
+      /**
+       * Full IMAP path (e.g. INBOX, Sent)
+       */
+      fullPath: string;
+      /**
+       * Sync phase for this mailbox: pending (never synced), syncing (in-progress), or complete
+       */
+      phase: string;
+      /**
+       * Total messages in mailbox (refreshed each batch)
+       */
+      messagesTotal: number;
+      /**
+       * Approximate number of messages synced. Computed as highWaterMarkUid − lastSyncUid (UID-range approximation; UIDs are sparse so this may undercount). Clamped to messagesTotal.
+       */
+      messagesSynced: number;
+      /**
+       * Timestamp of the last successful message sync for this mailbox
+       */
+      lastSyncedAt?: number;
+    }
+    /**
+     * Input for creating a new email account
+     */
+    export interface CreateAccountInput {
+      /**
+       * Primary email address for this account
+       */
+      email: string;
+      /**
+       * Display name (optional)
+       */
+      displayName?: string;
+      /**
+       * IMAP login username (defaults to email if not provided)
+       */
+      username?: string;
+      /**
+       * Authentication mechanism for this account. Defaults to `password`. Pass `oauthMicrosoft` only via the OAuth connect flow (POST /accounts/oauth/microsoft/start).
+       */
+      authType?: AccountAuthType;
+      /**
+       * Account password (will be encrypted). Required for password accounts; omit for OAuth accounts.
+       */
+      password?: string;
+      /**
+       * IMAP server hostname
+       */
+      imapHost: string;
+      /**
+       * IMAP server port
+       */
+      imapPort: number;
+      /**
+       * Use TLS encryption
+       */
+      imapTls: boolean;
+      /**
+       * Use STARTTLS upgrade
+       */
+      imapStartTls: boolean;
+      /**
+       * Whether to enable SMTP sending for this account. When omitted, the server enables sending if an SMTP host is supplied.
+       */
+      smtpEnabled?: boolean;
+      /**
+       * SMTP server hostname (optional)
+       */
+      smtpHost?: string;
+      /**
+       * SMTP server port
+       */
+      smtpPort?: number;
+      /**
+       * Use TLS encryption for SMTP
+       */
+      smtpTls?: boolean;
+      /**
+       * Use STARTTLS upgrade for SMTP
+       */
+      smtpStartTls?: boolean;
+      /**
+       * SMTP username if different from IMAP
+       */
+      smtpUsername?: string;
+      /**
+       * SMTP password if different from IMAP
+       */
+      smtpPassword?: string;
+    }
+    /**
+     * Input for testing connection without saving
+     */
+    export interface TestConnectionInput {
+      /**
+       * Account ID (optional, used to retrieve stored password if password is empty)
+       */
+      accountId?: UUID;
+      /**
+       * IMAP login username
+       */
+      username: string;
       /**
        * Account password (optional if accountId provided - uses stored password)
        */
@@ -4307,30 +4831,222 @@ either way and cannot tell which it received.
      */
     export interface SpamReportBulkResult {
       /**
-       * Number of items accepted for processing
+       * Number of items accepted for processing
+       */
+      successCount: number;
+      /**
+       * Number of items rejected before processing
+       */
+      failureCount: number;
+      /**
+       * One entry per message that failed, naming why. Absent or empty when every message succeeded.
+       */
+      failures?: SpamReportFailure[];
+    }
+    /**
+     * One message's failure reason within a report-spam or not-spam bulk call.
+     */
+    export interface SpamReportFailure {
+      /**
+       * The message that failed
+       */
+      messageId: UUID;
+      /**
+       * Why it failed, safe to show the user as-is. One of a small allowlisted set of user-facing messages (e.g. "has not settled yet" while a prior move is still in flight) — never a raw internal error, which is logged server-side instead and never returned here. Not intended to be parsed programmatically.
+       */
+      reason: string;
+    }
+    /**
+     * An event a message offers, waiting on a person (issue #1033).
+
+A suggestion is not a calendar entry and never becomes one on its own. It is
+derived from a message, lives beside it, and belongs to no collection: it has
+no etag, no sync sequence, and a DAV client never sees one. Nothing reaches a
+calendar until someone presses the button, which is what separates this
+entity from `CalendarObject` — the two are distinct models rather than one
+model with a kind field, because everything that makes a stored resource a
+resource is exactly what a suggestion does not have.
+
+`suggestionId` is derived from `(messageId, bodyPartId, icalUid)`, so a
+re-sync of the same message converges on the one row it wrote the first time
+instead of stacking a fresh card on the message every pass.
+
+Revisions are a chain, not an edit. A later message carrying the same
+`icalUid` with a higher `SEQUENCE` leaves the earlier suggestion in place as
+`Superseded` and writes a new `Pending` one, so the message the older card
+came from still has its card and the user can see which revision they are
+being asked about. `METHOD:CANCEL` is a suggestion of its own for the same
+reason: withdrawing an event the user accepted is a change to their calendar,
+and no message may make that change without them.
+     */
+    export interface CalendarSuggestion {
+      /**
+       * Primary identifier, derived from messageId + bodyPartId + icalUid
+       */
+      suggestionId: UUID;
+      /**
+       * Owning account configuration
+       */
+      accountConfigId: UUID;
+      /**
+       * Message this suggestion was read out of. The card is offered beside this message and nowhere else.
+       */
+      messageId: UUID;
+      /**
+       * MIME part the iCalendar bytes came from. Part of the identity, so two invitations in one message stay two suggestions rather than overwriting each other.
+       */
+      bodyPartId: UUID;
+      /**
+       * The VEVENT's UID property (RFC 5545 3.8.4.7). What ties a revision, a cancellation and the original invitation together across three separate messages.
+       */
+      icalUid: String512;
+      /**
+       * The VEVENT's SEQUENCE property (RFC 5545 3.8.7.4) — the organizer's revision counter. A later message carrying the same `icalUid` with a higher value supersedes this one. `0` when the event declares none, which is the RFC default.
+       */
+      sequence: number;
+      /**
+       * The iTIP method the VCALENDAR declared. `None` when it declared no METHOD.
+       */
+      method: CalendarInviteMethod;
+      /**
+       * Where in the message this was read from
+       */
+      source: CalendarSuggestionSource;
+      /**
+       * What has become of this suggestion. Only `Pending` asks the user for anything.
+       */
+      state: CalendarSuggestionState;
+      /**
+       * Projection of the VEVENT's SUMMARY. `""` when the event carries none.
+       */
+      summary: String512;
+      /**
+       * Projection of the VEVENT's DTSTART as an ISO 8601 date-time with zone offset — a business date, not an epoch instant. An all-day event carries midnight in the event's own zone.
+       */
+      dtStart: String64;
+      /**
+       * Projection of the VEVENT's effective end as an ISO 8601 date-time with zone offset, resolved from DTEND or from DTSTART + DURATION. An event with neither ends when it starts (RFC 5545 3.6.1).
+       */
+      dtEnd: String64;
+      /**
+       * Whether DTSTART is a DATE rather than a DATE-TIME (RFC 5545 3.3.4) — an all-day or multi-day event, whose end is exclusive.
+       */
+      allDay: boolean;
+      /**
+       * Projection of the VEVENT's LOCATION. `""` when the event carries none.
+       */
+      location: String512;
+      /**
+       * Mail address of the VEVENT's ORGANIZER, without the `mailto:` scheme. `""` when the event names none — which is what a `PUBLISH` typically looks like, and why dismissing with `muteSender` mutes the message's sender rather than this field.
+       */
+      organizer: String256;
+      /**
+       * How the DTSTART above was placed on the clock. `Ambiguous` means the invitation named a zone nothing could resolve, so the time shown may be hours out — a card says so rather than presenting a guess as a fact.
+       */
+      zoneCertainty: ZoneCertainty;
+      /**
+       * The VCALENDAR text as it arrived in the message, byte for byte — CANONICAL when present. Accepting builds the stored resource out of these bytes, so an X- property nobody modelled survives into the calendar. `""` for a `TextHeuristic` suggestion, which was read out of prose and has no iCalendar behind it.
+       */
+      icalData: string;
+      /**
+       * The `CalendarObject` that accepting this suggestion wrote. `""` until it is accepted — the named absent state, never a missing attribute — and the resource's id afterwards, so the card can link to the event it produced.
+       */
+      acceptedCalendarObjectId: string;
+      createdAt: number;
+      updatedAt: number;
+    }
+    /**
+     * A suggestion as the API returns it. The raw `icalData` is not surfaced: a client renders the projected fields, and the bytes exist so that accepting can write them into a calendar unchanged.
+     */
+    export interface CalendarSuggestionResponse {
+      /**
+       * Primary identifier, derived from messageId + bodyPartId + icalUid
+       */
+      suggestionId: UUID;
+      /**
+       * Owning account configuration
+       */
+      accountConfigId: UUID;
+      /**
+       * Message this suggestion was read out of. The card is offered beside this message and nowhere else.
+       */
+      messageId: UUID;
+      /**
+       * MIME part the iCalendar bytes came from. Part of the identity, so two invitations in one message stay two suggestions rather than overwriting each other.
+       */
+      bodyPartId: UUID;
+      /**
+       * The VEVENT's UID property (RFC 5545 3.8.4.7). What ties a revision, a cancellation and the original invitation together across three separate messages.
+       */
+      icalUid: String512;
+      /**
+       * The VEVENT's SEQUENCE property (RFC 5545 3.8.7.4) — the organizer's revision counter. A later message carrying the same `icalUid` with a higher value supersedes this one. `0` when the event declares none, which is the RFC default.
+       */
+      sequence: number;
+      /**
+       * The iTIP method the VCALENDAR declared. `None` when it declared no METHOD.
+       */
+      method: CalendarInviteMethod;
+      /**
+       * Where in the message this was read from
+       */
+      source: CalendarSuggestionSource;
+      /**
+       * What has become of this suggestion. Only `Pending` asks the user for anything.
+       */
+      state: CalendarSuggestionState;
+      /**
+       * Projection of the VEVENT's SUMMARY. `""` when the event carries none.
+       */
+      summary: String512;
+      /**
+       * Projection of the VEVENT's DTSTART as an ISO 8601 date-time with zone offset — a business date, not an epoch instant. An all-day event carries midnight in the event's own zone.
+       */
+      dtStart: String64;
+      /**
+       * Projection of the VEVENT's effective end as an ISO 8601 date-time with zone offset, resolved from DTEND or from DTSTART + DURATION. An event with neither ends when it starts (RFC 5545 3.6.1).
+       */
+      dtEnd: String64;
+      /**
+       * Whether DTSTART is a DATE rather than a DATE-TIME (RFC 5545 3.3.4) — an all-day or multi-day event, whose end is exclusive.
+       */
+      allDay: boolean;
+      /**
+       * Projection of the VEVENT's LOCATION. `""` when the event carries none.
        */
-      successCount: number;
+      location: String512;
       /**
-       * Number of items rejected before processing
+       * Mail address of the VEVENT's ORGANIZER, without the `mailto:` scheme. `""` when the event names none — which is what a `PUBLISH` typically looks like, and why dismissing with `muteSender` mutes the message's sender rather than this field.
        */
-      failureCount: number;
+      organizer: String256;
       /**
-       * One entry per message that failed, naming why. Absent or empty when every message succeeded.
+       * How the DTSTART above was placed on the clock. `Ambiguous` means the invitation named a zone nothing could resolve, so the time shown may be hours out — a card says so rather than presenting a guess as a fact.
        */
-      failures?: SpamReportFailure[];
+      zoneCertainty: ZoneCertainty;
+      /**
+       * The `CalendarObject` that accepting this suggestion wrote. `""` until it is accepted — the named absent state, never a missing attribute — and the resource's id afterwards, so the card can link to the event it produced.
+       */
+      acceptedCalendarObjectId: string;
+      createdAt: number;
+      updatedAt: number;
     }
     /**
-     * One message's failure reason within a report-spam or not-spam bulk call.
+     * Body of `POST /calendar-suggestions/{suggestionId}/accept`. Names the collection the event is written into; there is no default, because filing someone else's invitation into a calendar the user did not pick is a decision the server does not get to make.
      */
-    export interface SpamReportFailure {
+    export interface AcceptCalendarSuggestionInput {
       /**
-       * The message that failed
+       * Collection the accepted event is written into.
        */
-      messageId: UUID;
+      calendarId: UUID;
+    }
+    /**
+     * Body of `POST /calendar-suggestions/{suggestionId}/dismiss`.
+     */
+    export interface DismissCalendarSuggestionInput {
       /**
-       * Why it failed, safe to show the user as-is. One of a small allowlisted set of user-facing messages (e.g. "has not settled yet" while a prior move is still in flight) — never a raw internal error, which is logged server-side instead and never returned here. Not intended to be parsed programmatically.
+       * Also stop offering invitations from this message's sender, by writing a standing `Filter` rule. `false` dismisses this one card and nothing else.
        */
-      reason: string;
+      muteSender: boolean;
     }
     /**
      * Junction table linking envelope addresses to normalized addresses. Stores per-message display name since it may vary.
@@ -4951,153 +5667,6 @@ domain already uses"; it does not close it.
       createdAt: number;
       updatedAt: number;
     }
-    /**
-     * A calendar collection scoped to an account config (issue #15) — the CalDAV
-collection a client mounts, and the parent of every CalendarObject.
-
-`calendarId` is derived from `(accountConfigId, urlSegment)`, so the DAV path
-a client bookmarks resolves to a row without a lookup table, and provisioning
-the same collection twice writes the same row instead of a second one.
-`displayName` is the mutable human overlay and is never the key.
-
-`syncSequence` is the collection's monotonic change counter: every write
-through the calendar service's put path bumps it and stamps the new value on
-the object it wrote, which is what a later WebDAV-Sync `sync-token` reports
-and what `CalendarObject.bySyncSequence` pages by.
-     */
-    export interface CalendarCollection {
-      /**
-       * Primary identifier, derived from accountConfigId + urlSegment
-       */
-      calendarId: UUID;
-      /**
-       * Owning account configuration
-       */
-      accountConfigId: UUID;
-      /**
-       * Path segment this collection is addressed by, unique within the account config. Stored case-folded, the same folding `calendarId` is derived from — a DAV path is matched case-insensitively, and storing the writer's casing would let a lookup by segment and a lookup by derived id disagree about one path. The default collection provisioned on first use holds "default".
-       */
-      urlSegment: String64;
-      /**
-       * Human-readable collection name (display)
-       */
-      displayName: String140;
-      /**
-       * Display color slot for this collection
-       */
-      color: CalendarColor;
-      /**
-       * Which iCalendar components this collection accepts
-       */
-      componentSet: CalendarComponentSet;
-      /**
-       * Where this collection came from
-       */
-      source: CalendarSource;
-      /**
-       * IANA time zone this collection's floating times are read in, e.g. "Europe/Amsterdam". `""` when none is set, which reads as UTC.
-       */
-      timezone: String64;
-      /**
-       * Monotonic change counter for this collection. Bumped by every write to one of its objects; the value stamped on `CalendarObject.syncSequence` is the value this counter held after that write.
-       */
-      syncSequence: number;
-      createdAt: number;
-      updatedAt: number;
-    }
-    /**
-     * One calendar resource — the bytes behind one `.ics` URL (issue #15).
-
-`icalData` is the canonical value. Every other column on this row is a
-projection of it, computed on write and never written independently: a reader
-that needs a fact the projection does not carry re-parses `icalData` rather
-than adding a column that could disagree with it.
-
-The write path parses the bytes to validate and project them and then stores
-the bytes it was handed, never a reserialization of them. That is what keeps
-`etag` honest: the tag is a digest of exactly what the writer sent, so it
-moves only when a writer sends something different. It is not a digest that
-survives a round trip through the parser — ical.js refolds long lines and
-reorders properties, so a resource stored as its own reserialization would
-change tag without anyone editing it, and every client's cache would miss.
-
-`calendarObjectId` is derived from `(calendarId, resourceName)`: the resource
-name is the last path segment of the resource's URL, so the URL a client holds
-resolves to a row directly, and a repeated PUT of the same resource rewrites
-its own row.
-     */
-    export interface CalendarObject {
-      /**
-       * Primary identifier, derived from calendarId + resourceName
-       */
-      calendarObjectId: UUID;
-      /**
-       * Collection this resource belongs to
-       */
-      calendarId: UUID;
-      /**
-       * Last path segment of the resource's URL, e.g. "a1b2c3.ics". Unique within the collection and chosen by whoever wrote the resource, never derived from its contents — a client is free to rename a resource without changing the event it holds.
-       */
-      resourceName: String256;
-      /**
-       * The VEVENT's UID property (RFC 5545 3.8.4.7). Identifies the event across collections and servers, which `resourceName` does not.
-       */
-      icalUid: String512;
-      /**
-       * The complete VCALENDAR text, byte-for-byte as stored — CANONICAL. Line endings are CRLF and are never normalized; unknown properties and components are preserved verbatim.
-       */
-      icalData: string;
-      /**
-       * Strong entity tag over the stored `icalData` bytes, used for If-Match on a conditional write and for change detection on read.
-       */
-      etag: String64;
-      /**
-       * The VEVENT's SEQUENCE property (RFC 5545 3.8.7.4) — the organizer's own revision counter, carried for scheduling comparisons. `0` when the event declares none, which is the RFC default.
-       */
-      sequence: number;
-      /**
-       * Value the owning collection's `syncSequence` held after the write that produced this row. Pages the `bySyncSequence` read.
-       */
-      syncSequence: number;
-      /**
-       * Projection of the VEVENT's SUMMARY (RFC 5545 3.8.1.12). `""` when the event carries none.
-       */
-      summary: String512;
-      /**
-       * Projection of the master VEVENT's DTSTART as an ISO 8601 date-time with zone offset — a business date, not an epoch instant. An all-day event carries midnight in the event's own zone.
-       */
-      dtStart: String64;
-      /**
-       * Projection of the master VEVENT's effective end as an ISO 8601 date-time with zone offset, resolved from DTEND or from DTSTART + DURATION. An event with neither ends when it starts (RFC 5545 3.6.1).
-       */
-      dtEnd: String64;
-      /**
-       * Whether the master VEVENT's DTSTART is a DATE rather than a DATE-TIME (RFC 5545 3.3.4) — an all-day or multi-day event, whose end is exclusive.
-       */
-      allDay: boolean;
-      /**
-       * How the master VEVENT's DTSTART was placed on the clock. `Ambiguous` means the resource named a zone nothing could resolve, so `dtStart` and every occurrence expanded from it may be off by hours — a client shows the event and says so rather than presenting a guess as a fact.
-       */
-      zoneCertainty: ZoneCertainty;
-      /**
-       * Projection of the master VEVENT's STATUS
-       */
-      status: CalendarEventStatus;
-      /**
-       * Projection of the master VEVENT's TRANSP
-       */
-      transparency: CalendarTransparency;
-      /**
-       * Whether the resource expands to more than its master instance — an RRULE, an RDATE, or an override VEVENT. Overrides count on their own: a client that edits one instance and then drops the rule leaves a resource with a master and its exceptions, and each of those is still an occurrence.
-       */
-      hasRecurrence: boolean;
-      /**
-       * ISO 8601 UTC instant through which `CalendarEventIndex` rows exist for this resource, when the series runs past the expansion horizon and the index is therefore incomplete. `""` when the index is exhaustive — a single event, or a series that ends inside the horizon. A later live-expansion pass reads this to find the resources whose instances it must compute rather than query.
-       */
-      expandedThrough: String64;
-      createdAt: number;
-      updatedAt: number;
-    }
     /**
      * One occurrence of a CalendarObject, flattened so a date range can be queried
 instead of expanded (issue #15). Every row is derived from
@@ -5144,6 +5713,18 @@ occurrences from every zone but its own.
        * Whether this occurrence is all-day, copied from the resource it came from so a range read never has to join back to it. A client renders an all-day occurrence as the civil date its start falls on in the collection's timezone, not as the instant stored here.
        */
       allDay: boolean;
+      /**
+       * Projection of this occurrence's own SUMMARY. An overridden occurrence carries the override's, not the master's — an edit to one instance of a series is exactly the thing a range read must show, and a reader that took the summary from the master would draw the old title over the new one.
+       */
+      summary: String512;
+      /**
+       * Projection of this occurrence's own STATUS. Per occurrence for the same reason as `summary`: one cancelled instance of a series is cancelled, and reading the master's status would keep it in a free/busy answer.
+       */
+      status: CalendarEventStatus;
+      /**
+       * Projection of this occurrence's own TRANSP — whether it consumes free/busy time.
+       */
+      transparency: CalendarTransparency;
       createdAt: number;
       updatedAt: number;
     }
@@ -5433,51 +6014,175 @@ declare namespace Paths {
       export type $200 = void;
     }
   }
-  namespace UpdateLabel {
-    export interface PathParameters {
-      accountId: Components.Schemas.UUID;
-      labelId: Components.Schemas.UUID;
-    }
-    export type RequestBody = Components.Schemas.UpdateLabelInput;
+  namespace UpdateLabel {
+    export interface PathParameters {
+      accountId: Components.Schemas.UUID;
+      labelId: Components.Schemas.UUID;
+    }
+    export type RequestBody = Components.Schemas.UpdateLabelInput;
+    namespace Responses {
+      export type $200 = void;
+    }
+  }
+  namespace DeleteLabel {
+    export interface PathParameters {
+      accountId: Components.Schemas.UUID;
+      labelId: Components.Schemas.UUID;
+    }
+    namespace Responses {
+    }
+  }
+  namespace CreateOrganizeJob {
+    export interface PathParameters {
+      accountId: Components.Schemas.UUID;
+    }
+    export type RequestBody = Components.Schemas.OrganizeInput;
+    namespace Responses {
+      export type $202 = void;
+      export type $400 = void;
+    }
+  }
+  namespace PreviewOrganize {
+    export interface PathParameters {
+      accountId: Components.Schemas.UUID;
+    }
+    export type RequestBody = Components.Schemas.OrganizeInput;
+    namespace Responses {
+      export type $200 = void;
+      export type $400 = void;
+    }
+  }
+  namespace GetOrganizeJob {
+    export interface PathParameters {
+      accountId: Components.Schemas.UUID;
+      organizeJobId: Components.Schemas.UUID;
+    }
+    namespace Responses {
+      export type $200 = void;
+    }
+  }
+  namespace ListCalendars {
+    namespace Responses {
+      export type $200 = void;
+    }
+  }
+  namespace CreateCalendar {
+    export type RequestBody = Components.Schemas.CreateCalendarInput;
+    namespace Responses {
+      export type $200 = void;
+      export type $400 = void;
+    }
+  }
+  namespace GetCalendar {
+    export interface PathParameters {
+      calendarId: Components.Schemas.UUID;
+    }
+    namespace Responses {
+      export type $200 = void;
+      export type $404 = void;
+    }
+  }
+  namespace UpdateCalendar {
+    export interface PathParameters {
+      calendarId: Components.Schemas.UUID;
+    }
+    export type RequestBody = Components.Schemas.UpdateCalendarInput;
+    namespace Responses {
+      export type $200 = void;
+      export type $400 = void;
+      export type $404 = void;
+    }
+  }
+  namespace DeleteCalendar {
+    export interface PathParameters {
+      calendarId: Components.Schemas.UUID;
+    }
+    namespace Responses {
+      export type $204 = void;
+      export type $400 = void;
+      export type $404 = void;
+    }
+  }
+  namespace ListCalendarEvents {
+    export interface QueryParameters {
+      from: string;
+      to: string;
+      calendarId?: Components.Schemas.UUID[];
+    }
+    namespace Responses {
+      export type $200 = void;
+      export type $400 = void;
+      export type $404 = void;
+    }
+  }
+  namespace CreateCalendarEvent {
+    export type RequestBody = Components.Schemas.CreateCalendarEventInput;
     namespace Responses {
       export type $200 = void;
+      export type $400 = void;
+      export type $404 = void;
     }
   }
-  namespace DeleteLabel {
+  namespace GetCalendarEvent {
     export interface PathParameters {
-      accountId: Components.Schemas.UUID;
-      labelId: Components.Schemas.UUID;
+      calendarObjectId: Components.Schemas.UUID;
+    }
+    export interface QueryParameters {
+      calendarId: Components.Schemas.UUID;
     }
     namespace Responses {
+      export type $200 = void;
+      export type $400 = void;
+      export type $404 = void;
     }
   }
-  namespace CreateOrganizeJob {
+  namespace UpdateCalendarEvent {
     export interface PathParameters {
-      accountId: Components.Schemas.UUID;
+      calendarObjectId: Components.Schemas.UUID;
     }
-    export type RequestBody = Components.Schemas.OrganizeInput;
+    export interface QueryParameters {
+      calendarId: Components.Schemas.UUID;
+      scope?: Components.Schemas.RecurrenceScope;
+      recurrenceId?: string;
+    }
+    export interface HeaderParameters {
+      ifMatch?: string;
+    }
+    export type RequestBody = Components.Schemas.UpdateCalendarEventInput;
     namespace Responses {
-      export type $202 = void;
+      export type $200 = void;
       export type $400 = void;
+      export type $404 = void;
+      export type $412 = void;
     }
   }
-  namespace PreviewOrganize {
+  namespace DeleteCalendarEvent {
     export interface PathParameters {
-      accountId: Components.Schemas.UUID;
+      calendarObjectId: Components.Schemas.UUID;
+    }
+    export interface QueryParameters {
+      calendarId: Components.Schemas.UUID;
+      scope?: Components.Schemas.RecurrenceScope;
+      recurrenceId?: string;
+    }
+    export interface HeaderParameters {
+      ifMatch?: string;
     }
-    export type RequestBody = Components.Schemas.OrganizeInput;
     namespace Responses {
-      export type $200 = void;
+      export type $204 = void;
       export type $400 = void;
+      export type $404 = void;
+      export type $412 = void;
     }
   }
-  namespace GetOrganizeJob {
-    export interface PathParameters {
-      accountId: Components.Schemas.UUID;
-      organizeJobId: Components.Schemas.UUID;
+  namespace ListCalendarFreeBusy {
+    export interface QueryParameters {
+      from: string;
+      to: string;
     }
     namespace Responses {
       export type $200 = void;
+      export type $400 = void;
     }
   }
   namespace EmptyTrash {
@@ -5778,6 +6483,54 @@ declare namespace Paths {
       export type $200 = void;
     }
   }
+  namespace ListCalendarSuggestions {
+    export interface QueryParameters {
+      state: Components.Schemas.CalendarSuggestionState;
+      continuationToken?: string;
+    }
+    namespace Responses {
+      export type $200 = void;
+      export type $400 = void;
+    }
+  }
+  namespace ListMessageCalendarSuggestions {
+    export interface PathParameters {
+      messageId: Components.Schemas.UUID;
+    }
+    namespace Responses {
+      export type $200 = void;
+      export type $400 = void;
+    }
+  }
+  namespace AcceptCalendarSuggestion {
+    export interface PathParameters {
+      suggestionId: Components.Schemas.UUID;
+    }
+    export type RequestBody = Components.Schemas.AcceptCalendarSuggestionInput;
+    namespace Responses {
+      export type $200 = void;
+      export type $400 = void;
+    }
+  }
+  namespace DeclineCalendarSuggestion {
+    export interface PathParameters {
+      suggestionId: Components.Schemas.UUID;
+    }
+    namespace Responses {
+      export type $200 = void;
+      export type $400 = void;
+    }
+  }
+  namespace DismissCalendarSuggestion {
+    export interface PathParameters {
+      suggestionId: Components.Schemas.UUID;
+    }
+    export type RequestBody = Components.Schemas.DismissCalendarSuggestionInput;
+    namespace Responses {
+      export type $200 = void;
+      export type $400 = void;
+    }
+  }
 }
 
 export interface OperationMethods {
@@ -6013,6 +6766,122 @@ export interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig
   ): OperationResponse<Paths.GetOrganizeJob.Responses.$200>;
+  /**
+   * listCalendars - List the caller's calendar collections. Provisions the account config's default collection when it has none, so a first read never comes back empty and no client has to know how a calendar gets made.
+   */
+  'listCalendars'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: any,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.ListCalendars.Responses.$200>;
+  /**
+   * createCalendar - Create a calendar collection. Refused with 400 when `urlSegment` is empty or already taken in this account config — the segment is the collection's identity, so a second create under the same one would otherwise silently return the collection that already exists.
+   */
+  'createCalendar'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: Paths.CreateCalendar.RequestBody,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.CreateCalendar.Responses.$200>;
+  /**
+   * getCalendar
+   */
+  'getCalendar'(
+    parameters?: Parameters<Paths.GetCalendar.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.GetCalendar.Responses.$200>;
+  /**
+   * updateCalendar
+   */
+  'updateCalendar'(
+    parameters?: Parameters<Paths.UpdateCalendar.PathParameters> | null,
+    data?: Paths.UpdateCalendar.RequestBody,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.UpdateCalendar.Responses.$200>;
+  /**
+   * deleteCalendar - Delete a calendar collection and every event in it. Refused with 400 for the account's default collection: it is the one place an accepted invitation or a first event can land, and an account with no calendar has nowhere to put an event.
+   */
+  'deleteCalendar'(
+    parameters?: Parameters<Paths.DeleteCalendar.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.DeleteCalendar.Responses.$204>;
+  /**
+   * listCalendarEvents - Expanded event occurrences in a window. The server does the recurrence
+expansion and the client renders instances — no RRULE is ever evaluated
+in a browser, so a week grid and a day strip agree with each other and
+with what a native client will later read over CalDAV.
+
+Occurrences are served from the stored occurrence index. A series whose
+index stops before `to` — an open-ended event older than the expansion
+horizon — is expanded live for this window instead, and nothing
+unbounded is written to serve a read.
+
+Refused with 400 when `from` and `to` are not ISO 8601 date-times, when
+`to` is not after `from`, or when the window is wider than a year.
+   */
+  'listCalendarEvents'(
+    parameters?: Parameters<Paths.ListCalendarEvents.QueryParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.ListCalendarEvents.Responses.$200>;
+  /**
+   * createCalendarEvent - Create an event. The server builds the VEVENT and writes it through the single calendar write path — the same one an accepted invitation and a later CalDAV PUT go through — so the object, its expanded occurrences and the collection's sync sequence land together or not at all.
+   */
+  'createCalendarEvent'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: Paths.CreateCalendarEvent.RequestBody,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.CreateCalendarEvent.Responses.$200>;
+  /**
+   * getCalendarEvent - Get one stored event, including its canonical iCalendar text and its etag.
+   */
+  'getCalendarEvent'(
+    parameters?: Parameters<Paths.GetCalendarEvent.PathParameters & Paths.GetCalendarEvent.QueryParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.GetCalendarEvent.Responses.$200>;
+  /**
+   * updateCalendarEvent - Update an event. `scope` says what the caller meant by editing one
+drawing of a series: `All` rewrites the master, `This` writes a
+RECURRENCE-ID override for the named occurrence, and `Following` splits
+the series — the master's rule is truncated and a second resource carries
+the remainder under a UID of its own.
+
+`recurrenceId` is required for `This` and `Following` and is refused with
+400 otherwise, along with a scope other than `All` on an event that does
+not recur, and a `recurrenceId` naming no occurrence of the series.
+
+`If-Match` makes the write conditional on the etag the caller read. A
+mismatch is 412: somebody replaced the resource in between, and applying
+this patch would discard their change without either of them seeing it.
+   */
+  'updateCalendarEvent'(
+    parameters?: Parameters<Paths.UpdateCalendarEvent.PathParameters & Paths.UpdateCalendarEvent.QueryParameters & Paths.UpdateCalendarEvent.HeaderParameters> | null,
+    data?: Paths.UpdateCalendarEvent.RequestBody,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.UpdateCalendarEvent.Responses.$200>;
+  /**
+   * deleteCalendarEvent - Delete an event. `All` removes the resource and every occurrence it
+produced; `This` writes an EXDATE for the named occurrence and keeps the
+rest of the series; `Following` truncates the series to end just before
+it.
+
+Same refusals and the same `If-Match` precondition as the update.
+   */
+  'deleteCalendarEvent'(
+    parameters?: Parameters<Paths.DeleteCalendarEvent.PathParameters & Paths.DeleteCalendarEvent.QueryParameters & Paths.DeleteCalendarEvent.HeaderParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.DeleteCalendarEvent.Responses.$204>;
+  /**
+   * listCalendarFreeBusy - Busy spans over a window, merged across every calendar the caller holds. Backs the clash check beside a mail invitation and the free-stretch maths in the day strip, neither of which should have to fetch every event and merge them itself. Refused with 400 on the same window rules as the event listing.
+   */
+  'listCalendarFreeBusy'(
+    parameters?: Parameters<Paths.ListCalendarFreeBusy.QueryParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.ListCalendarFreeBusy.Responses.$200>;
   /**
    * emptyTrash - Permanently delete all messages in the Trash mailbox
    */
@@ -6309,6 +7178,61 @@ Callers that omit `query` are unaffected: the INBOX (and starred) listings behav
     data?: Paths.NotSpam.RequestBody,
     config?: AxiosRequestConfig
   ): OperationResponse<Paths.NotSpam.Responses.$200>;
+  /**
+   * listCalendarSuggestions - List the caller's suggestions in one state, newest first. `Pending` is the set that is waiting on a person and the one a client normally asks for.
+   */
+  'listCalendarSuggestions'(
+    parameters?: Parameters<Paths.ListCalendarSuggestions.QueryParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.ListCalendarSuggestions.Responses.$200>;
+  /**
+   * listMessageCalendarSuggestions - Every suggestion read out of one message, in whatever state each has reached — a superseded revision included, so the card can say which revision replaced it.
+   */
+  'listMessageCalendarSuggestions'(
+    parameters?: Parameters<Paths.ListMessageCalendarSuggestions.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.ListMessageCalendarSuggestions.Responses.$200>;
+  /**
+   * acceptCalendarSuggestion - Add the suggested event to a calendar. One transaction: a VCALENDAR is
+built from the invitation's own bytes, keeping its UID and SEQUENCE and
+marking the user `ATTENDEE;PARTSTAT=ACCEPTED`, and written through the
+same service function every other calendar write goes through — so a web
+edit and a native edit of that event cannot diverge. Accepting a `Cancel`
+suggestion writes `STATUS:CANCELLED` on the resource the same way.
+
+No reply is sent to the organizer. This endpoint sends no mail at all,
+and the card says so.
+
+Idempotent: accepting an already-accepted suggestion rewrites the same
+resource and returns the same suggestion, because both the resource id
+and the suggestion id are derived rather than minted.
+
+400 when the suggestion is not one that can be accepted — already
+declined, dismissed or superseded — or when its iCalendar will not parse.
+   */
+  'acceptCalendarSuggestion'(
+    parameters?: Parameters<Paths.AcceptCalendarSuggestion.PathParameters> | null,
+    data?: Paths.AcceptCalendarSuggestion.RequestBody,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.AcceptCalendarSuggestion.Responses.$200>;
+  /**
+   * declineCalendarSuggestion - Say no. Writes no calendar object and sends no reply to the organizer. Idempotent; 400 when the suggestion was already accepted, since a resource exists and declining would not remove it.
+   */
+  'declineCalendarSuggestion'(
+    parameters?: Parameters<Paths.DeclineCalendarSuggestion.PathParameters> | null,
+    data?: any,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.DeclineCalendarSuggestion.Responses.$200>;
+  /**
+   * dismissCalendarSuggestion - Wave the card away. Writes no calendar object. With `muteSender`, also writes a standing `Filter` rule on the message's sender so their invitations stop being offered. Idempotent; 400 when the suggestion was already accepted.
+   */
+  'dismissCalendarSuggestion'(
+    parameters?: Parameters<Paths.DismissCalendarSuggestion.PathParameters> | null,
+    data?: Paths.DismissCalendarSuggestion.RequestBody,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.DismissCalendarSuggestion.Responses.$200>;
 }
 
 export interface PathsDictionary {
@@ -6582,6 +7506,132 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig
     ): OperationResponse<Paths.GetOrganizeJob.Responses.$200>;
   };
+  ['/calendars']: {
+    /**
+     * listCalendars - List the caller's calendar collections. Provisions the account config's default collection when it has none, so a first read never comes back empty and no client has to know how a calendar gets made.
+     */
+    'get'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: any,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.ListCalendars.Responses.$200>;
+    /**
+     * createCalendar - Create a calendar collection. Refused with 400 when `urlSegment` is empty or already taken in this account config — the segment is the collection's identity, so a second create under the same one would otherwise silently return the collection that already exists.
+     */
+    'post'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: Paths.CreateCalendar.RequestBody,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.CreateCalendar.Responses.$200>;
+  };
+  ['/calendars/{calendarId}']: {
+    /**
+     * getCalendar
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetCalendar.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.GetCalendar.Responses.$200>;
+    /**
+     * updateCalendar
+     */
+    'patch'(
+      parameters?: Parameters<Paths.UpdateCalendar.PathParameters> | null,
+      data?: Paths.UpdateCalendar.RequestBody,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.UpdateCalendar.Responses.$200>;
+    /**
+     * deleteCalendar - Delete a calendar collection and every event in it. Refused with 400 for the account's default collection: it is the one place an accepted invitation or a first event can land, and an account with no calendar has nowhere to put an event.
+     */
+    'delete'(
+      parameters?: Parameters<Paths.DeleteCalendar.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.DeleteCalendar.Responses.$204>;
+  };
+  ['/calendar-events']: {
+    /**
+     * listCalendarEvents - Expanded event occurrences in a window. The server does the recurrence
+expansion and the client renders instances — no RRULE is ever evaluated
+in a browser, so a week grid and a day strip agree with each other and
+with what a native client will later read over CalDAV.
+
+Occurrences are served from the stored occurrence index. A series whose
+index stops before `to` — an open-ended event older than the expansion
+horizon — is expanded live for this window instead, and nothing
+unbounded is written to serve a read.
+
+Refused with 400 when `from` and `to` are not ISO 8601 date-times, when
+`to` is not after `from`, or when the window is wider than a year.
+     */
+    'get'(
+      parameters?: Parameters<Paths.ListCalendarEvents.QueryParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.ListCalendarEvents.Responses.$200>;
+    /**
+     * createCalendarEvent - Create an event. The server builds the VEVENT and writes it through the single calendar write path — the same one an accepted invitation and a later CalDAV PUT go through — so the object, its expanded occurrences and the collection's sync sequence land together or not at all.
+     */
+    'post'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: Paths.CreateCalendarEvent.RequestBody,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.CreateCalendarEvent.Responses.$200>;
+  };
+  ['/calendar-events/{calendarObjectId}']: {
+    /**
+     * getCalendarEvent - Get one stored event, including its canonical iCalendar text and its etag.
+     */
+    'get'(
+      parameters?: Parameters<Paths.GetCalendarEvent.PathParameters & Paths.GetCalendarEvent.QueryParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.GetCalendarEvent.Responses.$200>;
+    /**
+     * updateCalendarEvent - Update an event. `scope` says what the caller meant by editing one
+drawing of a series: `All` rewrites the master, `This` writes a
+RECURRENCE-ID override for the named occurrence, and `Following` splits
+the series — the master's rule is truncated and a second resource carries
+the remainder under a UID of its own.
+
+`recurrenceId` is required for `This` and `Following` and is refused with
+400 otherwise, along with a scope other than `All` on an event that does
+not recur, and a `recurrenceId` naming no occurrence of the series.
+
+`If-Match` makes the write conditional on the etag the caller read. A
+mismatch is 412: somebody replaced the resource in between, and applying
+this patch would discard their change without either of them seeing it.
+     */
+    'patch'(
+      parameters?: Parameters<Paths.UpdateCalendarEvent.PathParameters & Paths.UpdateCalendarEvent.QueryParameters> | null,
+      data?: Paths.UpdateCalendarEvent.RequestBody,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.UpdateCalendarEvent.Responses.$200>;
+    /**
+     * deleteCalendarEvent - Delete an event. `All` removes the resource and every occurrence it
+produced; `This` writes an EXDATE for the named occurrence and keeps the
+rest of the series; `Following` truncates the series to end just before
+it.
+
+Same refusals and the same `If-Match` precondition as the update.
+     */
+    'delete'(
+      parameters?: Parameters<Paths.DeleteCalendarEvent.PathParameters & Paths.DeleteCalendarEvent.QueryParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.DeleteCalendarEvent.Responses.$204>;
+  };
+  ['/calendar-free-busy']: {
+    /**
+     * listCalendarFreeBusy - Busy spans over a window, merged across every calendar the caller holds. Backs the clash check beside a mail invitation and the free-stretch maths in the day strip, neither of which should have to fetch every event and merge them itself. Refused with 400 on the same window rules as the event listing.
+     */
+    'get'(
+      parameters?: Parameters<Paths.ListCalendarFreeBusy.QueryParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.ListCalendarFreeBusy.Responses.$200>;
+  };
   ['/accounts/{accountId}/trash/empty']: {
     /**
      * emptyTrash - Permanently delete all messages in the Trash mailbox
@@ -6938,6 +7988,71 @@ Callers that omit `query` are unaffected: the INBOX (and starred) listings behav
       config?: AxiosRequestConfig
     ): OperationResponse<Paths.NotSpam.Responses.$200>;
   };
+  ['/calendar-suggestions']: {
+    /**
+     * listCalendarSuggestions - List the caller's suggestions in one state, newest first. `Pending` is the set that is waiting on a person and the one a client normally asks for.
+     */
+    'get'(
+      parameters?: Parameters<Paths.ListCalendarSuggestions.QueryParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.ListCalendarSuggestions.Responses.$200>;
+  };
+  ['/messages/{messageId}/calendar-suggestions']: {
+    /**
+     * listMessageCalendarSuggestions - Every suggestion read out of one message, in whatever state each has reached — a superseded revision included, so the card can say which revision replaced it.
+     */
+    'get'(
+      parameters?: Parameters<Paths.ListMessageCalendarSuggestions.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.ListMessageCalendarSuggestions.Responses.$200>;
+  };
+  ['/calendar-suggestions/{suggestionId}/accept']: {
+    /**
+     * acceptCalendarSuggestion - Add the suggested event to a calendar. One transaction: a VCALENDAR is
+built from the invitation's own bytes, keeping its UID and SEQUENCE and
+marking the user `ATTENDEE;PARTSTAT=ACCEPTED`, and written through the
+same service function every other calendar write goes through — so a web
+edit and a native edit of that event cannot diverge. Accepting a `Cancel`
+suggestion writes `STATUS:CANCELLED` on the resource the same way.
+
+No reply is sent to the organizer. This endpoint sends no mail at all,
+and the card says so.
+
+Idempotent: accepting an already-accepted suggestion rewrites the same
+resource and returns the same suggestion, because both the resource id
+and the suggestion id are derived rather than minted.
+
+400 when the suggestion is not one that can be accepted — already
+declined, dismissed or superseded — or when its iCalendar will not parse.
+     */
+    'post'(
+      parameters?: Parameters<Paths.AcceptCalendarSuggestion.PathParameters> | null,
+      data?: Paths.AcceptCalendarSuggestion.RequestBody,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.AcceptCalendarSuggestion.Responses.$200>;
+  };
+  ['/calendar-suggestions/{suggestionId}/decline']: {
+    /**
+     * declineCalendarSuggestion - Say no. Writes no calendar object and sends no reply to the organizer. Idempotent; 400 when the suggestion was already accepted, since a resource exists and declining would not remove it.
+     */
+    'post'(
+      parameters?: Parameters<Paths.DeclineCalendarSuggestion.PathParameters> | null,
+      data?: any,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.DeclineCalendarSuggestion.Responses.$200>;
+  };
+  ['/calendar-suggestions/{suggestionId}/dismiss']: {
+    /**
+     * dismissCalendarSuggestion - Wave the card away. Writes no calendar object. With `muteSender`, also writes a standing `Filter` rule on the message's sender so their invitations stop being offered. Idempotent; 400 when the suggestion was already accepted.
+     */
+    'post'(
+      parameters?: Parameters<Paths.DismissCalendarSuggestion.PathParameters> | null,
+      data?: Paths.DismissCalendarSuggestion.RequestBody,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.DismissCalendarSuggestion.Responses.$200>;
+  };
 }
 
 export type Client = OpenAPIClient<OperationMethods, PathsDictionary>;
@@ -6949,10 +8064,11 @@ export type AccessPattern = Components.Schemas.AccessPattern;
 export type ResultList = Components.Schemas.ResultList;
 export type FolderRoleConflict = Components.Schemas.FolderRoleConflict;
 export type AppointFolderRoleConflict = Components.Schemas.AppointFolderRoleConflict;
+export type NotFoundError = Components.Schemas.NotFoundError;
+export type PreconditionFailedError = Components.Schemas.PreconditionFailedError;
 export type DeleteMessagesConflict = Components.Schemas.DeleteMessagesConflict;
 export type MessagePlacementConflict = Components.Schemas.MessagePlacementConflict;
 export type AmazonApiGatewayIntegration = Components.Schemas.AmazonApiGatewayIntegration;
-export type NotFoundError = Components.Schemas.NotFoundError;
 export type InternalServerError = Components.Schemas.InternalServerError;
 export type UnauthorizedError = Components.Schemas.UnauthorizedError;
 export type ForbiddenError = Components.Schemas.ForbiddenError;
@@ -7004,6 +8120,20 @@ export type CreateOrganizeJobResponse = Components.Schemas.CreateOrganizeJobResp
 export type OrganizePreviewResponse = Components.Schemas.OrganizePreviewResponse;
 export type OrganizeJobRequest = Components.Schemas.OrganizeJobRequest;
 export type OrganizeJobResponse = Components.Schemas.OrganizeJobResponse;
+export type CalendarListResponse = Components.Schemas.CalendarListResponse;
+export type CalendarCollection = Components.Schemas.CalendarCollection;
+export type CalendarResponse = Components.Schemas.CalendarResponse;
+export type CreateCalendarInput = Components.Schemas.CreateCalendarInput;
+export type UpdateCalendarInput = Components.Schemas.UpdateCalendarInput;
+export type CalendarNoContent = Components.Schemas.CalendarNoContent;
+export type CalendarEventListResponse = Components.Schemas.CalendarEventListResponse;
+export type CalendarEventInstance = Components.Schemas.CalendarEventInstance;
+export type CreateCalendarEventInput = Components.Schemas.CreateCalendarEventInput;
+export type CalendarObject = Components.Schemas.CalendarObject;
+export type CalendarEventResponse = Components.Schemas.CalendarEventResponse;
+export type UpdateCalendarEventInput = Components.Schemas.UpdateCalendarEventInput;
+export type CalendarFreeBusyResponse = Components.Schemas.CalendarFreeBusyResponse;
+export type CalendarFreeBusySpan = Components.Schemas.CalendarFreeBusySpan;
 export type EmptyTrashResponse = Components.Schemas.EmptyTrashResponse;
 export type SyncTriggerResponse = Components.Schemas.SyncTriggerResponse;
 export type AccountSyncStatusResponse = Components.Schemas.AccountSyncStatusResponse;
@@ -7068,6 +8198,10 @@ export type CopyMessagesInput = Components.Schemas.CopyMessagesInput;
 export type UpdateMessageLabelsInput = Components.Schemas.UpdateMessageLabelsInput;
 export type SpamReportBulkResult = Components.Schemas.SpamReportBulkResult;
 export type SpamReportFailure = Components.Schemas.SpamReportFailure;
+export type CalendarSuggestion = Components.Schemas.CalendarSuggestion;
+export type CalendarSuggestionResponse = Components.Schemas.CalendarSuggestionResponse;
+export type AcceptCalendarSuggestionInput = Components.Schemas.AcceptCalendarSuggestionInput;
+export type DismissCalendarSuggestionInput = Components.Schemas.DismissCalendarSuggestionInput;
 export type EnvelopeAddress = Components.Schemas.EnvelopeAddress;
 export type ConfigImportUnresolvedRef = Components.Schemas.ConfigImportUnresolvedRef;
 export type ConfigImport = Components.Schemas.ConfigImport;
@@ -7092,8 +8226,6 @@ export type BodyPartParameter = Components.Schemas.BodyPartParameter;
 export type RawMessageStorage = Components.Schemas.RawMessageStorage;
 export type BodyPartStorage = Components.Schemas.BodyPartStorage;
 export type BodyPartContent = Components.Schemas.BodyPartContent;
-export type CalendarCollection = Components.Schemas.CalendarCollection;
-export type CalendarObject = Components.Schemas.CalendarObject;
 export type CalendarEventIndex = Components.Schemas.CalendarEventIndex;
 export type MessageLabel = Components.Schemas.MessageLabel;
 export type FilterAnchor = Components.Schemas.FilterAnchor;
@@ -7124,6 +8256,13 @@ export type FilterMatchOperator = Components.Schemas.FilterMatchOperator;
 export type FilterClauseField = Components.Schemas.FilterClauseField;
 export type LabelColor = Components.Schemas.LabelColor;
 export type OrganizeJobState = Components.Schemas.OrganizeJobState;
+export type CalendarColor = Components.Schemas.CalendarColor;
+export type CalendarComponentSet = Components.Schemas.CalendarComponentSet;
+export type CalendarSource = Components.Schemas.CalendarSource;
+export type CalendarEventStatus = Components.Schemas.CalendarEventStatus;
+export type CalendarTransparency = Components.Schemas.CalendarTransparency;
+export type ZoneCertainty = Components.Schemas.ZoneCertainty;
+export type RecurrenceScope = Components.Schemas.RecurrenceScope;
 export type SortOrder = Components.Schemas.SortOrder;
 export type StarColor = Components.Schemas.StarColor;
 export type MessageCategory = Components.Schemas.MessageCategory;
@@ -7146,6 +8285,9 @@ export type ContentDisposition = Components.Schemas.ContentDisposition;
 export type MultipartSubtype = Components.Schemas.MultipartSubtype;
 export type ReferenceType = Components.Schemas.ReferenceType;
 export type LabelAction = Components.Schemas.LabelAction;
+export type CalendarSuggestionState = Components.Schemas.CalendarSuggestionState;
+export type CalendarInviteMethod = Components.Schemas.CalendarInviteMethod;
+export type CalendarSuggestionSource = Components.Schemas.CalendarSuggestionSource;
 export type MessageSystemFlag = Components.Schemas.MessageSystemFlag;
 export type MessageKeywordFlag = Components.Schemas.MessageKeywordFlag;
 export type MailboxAttribute = Components.Schemas.MailboxAttribute;
@@ -7154,12 +8296,6 @@ export type ContentEncoding = Components.Schemas.ContentEncoding;
 export type AccountSettingName = Components.Schemas.AccountSettingName;
 export type ConfigImportState = Components.Schemas.ConfigImportState;
 export type ConfigImportRefKind = Components.Schemas.ConfigImportRefKind;
-export type CalendarColor = Components.Schemas.CalendarColor;
-export type CalendarComponentSet = Components.Schemas.CalendarComponentSet;
-export type CalendarSource = Components.Schemas.CalendarSource;
-export type CalendarEventStatus = Components.Schemas.CalendarEventStatus;
-export type CalendarTransparency = Components.Schemas.CalendarTransparency;
-export type ZoneCertainty = Components.Schemas.ZoneCertainty;
 export type MessagePlacementMoveState = Components.Schemas.MessagePlacementMoveState;
 export type FlagPushOperation = Components.Schemas.FlagPushOperation;
 export type MessageFlagPushState = Components.Schemas.MessageFlagPushState;