useyuva 0.0.4 → 0.0.6

package/dist/types/schema.gen.d.ts

@@ -396,6 +396,35 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/me/mentions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Notes that mention you
+         * @description Notes in the workspace whose `mentions` name the calling member, written by someone else,
+         *     newest first, in conversations the member can see now. Each item has the note (a preview
+         *     of its text and its author), the conversation, and `seen`: whether the member has read the
+         *     conversation up to the note (`POST /v1/conversations/{id}/read`, or writing in it). The
+         *     page carries `unseen`, the number of unseen mentions over all pages, for a badge. Member
+         *     sessions only.
+         *
+         *     Realtime: a new mention arrives as `message.created` with `kind: note` and the member in
+         *     `mentions`; `conversation.read` changes `seen`; `conversation.moved` and
+         *     `inbox_access.changed` can hide or show items.
+         */
+        get: operations["listMentions"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/workspace": {
         parameters: {
             query?: never;
@@ -442,7 +471,9 @@ export interface paths {
         };
         /**
          * List members
-         * @description Scope: `inboxes:read`.
+         * @description Every member of the workspace with their `availability` and whether they are `online`.
+         *
+         *     Scope: `inboxes:read`.
          */
         get: operations["listMembers"];
         put?: never;
@@ -812,7 +843,11 @@ export interface paths {
         };
         /**
          * List contacts
-         * @description Newest first. `q` searches names, e-mail addresses and external ids.
+         * @description Newest first, or most recently active first with `sort=last_seen` (contacts never seen sort
+         *     by when they were created). `q` searches names, e-mail addresses and external ids.
+         *     With `sort=last_seen`, a contact who becomes active while you page moves above the pages
+         *     already read and does not appear on the later ones; no contact appears twice.
+         *     Each item carries `activity`, counted over the inboxes the caller can see.
          *
          *     Scope: `contacts:read`.
          */
@@ -940,6 +975,80 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/contacts/{contactId}/notes": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List notes about a contact
+         * @description Team-only notes about the contact, not tied to a conversation, newest first. Whoever can
+         *     see the contact can read and add them; contacts never see them, and no event or webhook
+         *     carries them.
+         *
+         *     Scope: `contacts:read`.
+         */
+        get: operations["listContactNotes"];
+        put?: never;
+        /**
+         * Add a note about a contact
+         * @description Scope: `contacts:write`.
+         */
+        post: operations["createContactNote"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/contacts/{contactId}/notes/{noteId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete a note about a contact
+         * @description Its author (a member, or the API key that wrote it) or an owner or admin; anyone else gets
+         *     `403 forbidden`.
+         *
+         *     Scope: `contacts:write`.
+         */
+        delete: operations["deleteContactNote"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/contacts/{contactId}/summary": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * How the team served a contact
+         * @description First-reply time and ratings over the contact's conversations the caller can see. The
+         *     counts of conversations are on the contact's `activity`.
+         *
+         *     Scope: `contacts:read` and `conversations:read`.
+         */
+        get: operations["getContactSummary"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/contacts/{contactId}/presence": {
         parameters: {
             query?: never;
@@ -952,7 +1061,7 @@ export interface paths {
          * @description Whether the contact has a live `/client/v1/realtime` connection (widget or app in the
          *     foreground), and when one was last seen. A host backend that sends its own push
          *     notifications can skip the push while the contact is online; webhooks carry the same
-         *     `contact.online`.
+         *     `contact.online`, and `contact.presence` events on `/v1/realtime` report changes.
          *
          *     Scope: `contacts:read`.
          */
@@ -981,7 +1090,8 @@ export interface paths {
          *     Scope: `conversations:read`.
          *
          *     Each item carries the contact (id, name, first e-mail address), a preview of the last
-         *     `message` (notes and events are not previewed) and `unread` for the calling member.
+         *     `message` (notes and events are not previewed), and `unread` and `pinned_at` for the
+         *     calling member.
          */
         get: operations["listConversations"];
         put?: never;
@@ -1006,8 +1116,8 @@ export interface paths {
         /**
          * Count open conversations
          * @description Open conversations in the inboxes the caller can see: all of them, those assigned to the
-         *     calling member (`0` for API keys), unassigned ones, and per inbox and per label. Inboxes and
-         *     labels without open conversations are left out of their lists. Conversations flagged as
+         *     calling member (`0` for API keys), unassigned ones, and per inbox, per assignee and per
+         *     label. Inboxes, assignees and labels without open conversations are left out of their lists. Conversations flagged as
          *     spam are counted only in `spam`.
          *
          *     Scope: `conversations:read`.
@@ -1021,6 +1131,36 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/stats": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Team activity since a moment
+         * @description What the team did in the inboxes the caller can see (or in one of them) from `since` until
+         *     now: replies sent by members (messages members wrote or drafts they sent; not notes, not
+         *     bots' own messages), conversations closed, the median time from a contact's first
+         *     message to the first member reply, over the conversations whose first reply falls in the
+         *     window, and the ratings contacts gave in it. `members` breaks replies and closes down per member, leaving out members with
+         *     neither. Nothing is stored for it; it is counted from the messages each time.
+         *
+         *     `since` defaults to the start of today in `timezone` (an IANA name, `UTC` by default); the
+         *     panel sends the browser's zone. It must be in the past and at most 366 days ago.
+         *
+         *     Scope: `conversations:read`.
+         */
+        get: operations["getStats"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/conversations/bulk": {
         parameters: {
             query?: never;
@@ -1190,6 +1330,57 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/conversations/{conversationId}/unread": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Mark a conversation unread
+         * @description Marks the conversation unread for the calling member, wherever their read cursor is: it is
+         *     `unread` in their lists until they read it again (`POST .../read`, or a message or note
+         *     of their own). Others are not affected. A `conversation.read` event with `unread: true`
+         *     reaches the member's connections. Member sessions only.
+         */
+        post: operations["markConversationUnread"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/conversations/{conversationId}/pin": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Pin a conversation
+         * @description Pins the conversation to the top of the calling member's lists; nobody else sees it.
+         *     Pinning a pinned conversation keeps its `pinned_at`. A `conversation.pin` event reaches the
+         *     member's connections. Member sessions only.
+         */
+        put: operations["pinConversation"];
+        post?: never;
+        /**
+         * Unpin a conversation
+         * @description Takes the calling member's pin away; unpinning a conversation that is not pinned changes
+         *     nothing. A `conversation.pin` event reaches the member's connections when a pin was
+         *     removed. Member sessions only.
+         */
+        delete: operations["unpinConversation"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/conversations/{conversationId}/typing": {
         parameters: {
             query?: never;
@@ -1215,6 +1406,37 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/drafts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List pending drafts
+         * @description Drafts waiting to be sent, edited or discarded in the conversations the caller can see,
+         *     newest first, each with its conversation. `author` narrows them to drafts by bots (API
+         *     keys), by assistants (members through an OAuth client, `author.via` set) or by members in
+         *     the panel. The page carries `total`, the number of drafts matching the filters over all
+         *     pages, for a badge.
+         *
+         *     Scope: `conversations:read`.
+         *
+         *     Realtime: `draft.created`, `draft.updated` and `draft.deleted` carry the draft; a sent
+         *     draft arrives as `message.created` with the draft's id and `draft: false`;
+         *     `conversation.updated`, `conversation.moved` and `inbox_access.changed` can change the
+         *     conversation summary or hide items.
+         */
+        get: operations["listDrafts"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/attachments/{attachmentId}": {
         parameters: {
             query?: never;
@@ -1305,8 +1527,8 @@ export interface paths {
         /**
          * Get a message's e-mail details
          * @description The full text with the quoted history and signature that the thread hides, the full
-         *     sanitized HTML, and the headers that matter. Only messages that came or went by e-mail
-         *     have them; others answer `404`.
+         *     sanitized HTML, the original HTML with the sender's styling, and the headers that matter.
+         *     Only messages that came or went by e-mail have them; others answer `404`.
          *
          *     Scope: `conversations:read`.
          */
@@ -1886,9 +2108,15 @@ export interface paths {
          *     arrives and every 30 seconds. An API key or token needs `conversations:read`, and contact
          *     events reach it only with `contacts:read`. `inbox.created` reaches owners,
          *     admins and API keys (an agent learns of a new inbox from `inbox_access.changed`);
-         *     `inbox.deleted` reaches everyone who could see the inbox. `conversation.read` reaches only
-         *     the connections of the member who read. `typing` (a contact or another member typing) has no
-         *     `id`, is not stored and is not replayed.
+         *     `inbox.deleted` reaches everyone who could see the inbox. `conversation.read` and
+         *     `conversation.pin` reach only the connections of the member who read or pinned. `typing` (a contact or another member typing) has no
+         *     `id`, is not stored and is not replayed. `member.presence` (a member of the workspace opened
+         *     or closed the panel or changed `availability`) reaches member sessions only, also has no
+         *     `id` and is not replayed; so does `viewing` (another member opened or left a conversation),
+         *     which follows inbox access like conversation events. `contact.presence` (a contact
+         *     connected to or disconnected from `/client/v1/realtime`) follows contact events, also has no
+         *     `id` and is not replayed. `contact.read` (the contact read the conversation up to a
+         *     message) follows conversation events.
          *
          *     A member session's open connection also makes the member available to contacts of `live`
          *     inboxes they can access (see `availability` on `/v1/me`).
@@ -1905,8 +2133,10 @@ export interface paths {
          *     a text frame `{"type": "viewing", "conversation_id": "<id>"}`, and
          *     `{"type": "viewing", "conversation_id": null}` when it shows none or the page is hidden;
          *     send it again after every reconnect. While a connection of the member views a
-         *     conversation, the member gets no push or e-mail notification about it. Other client
-         *     frames are ignored. Close codes: 1008 (`unauthenticated`, `forbidden`) when the session
+         *     conversation, the member gets no push or e-mail notification about it. Other members who
+         *     can see the conversation get a `viewing` event when the member opens or leaves it, and
+         *     the reporting connection gets a `viewing` event for each other member already there.
+         *     Other client frames are ignored. Close codes: 1008 (`unauthenticated`, `forbidden`) when the session
          *     or membership ends, 1013 (`slow_consumer`) when the client does not read fast enough, 1012
          *     (`restart`) when the server restarts or loses its event feed. Reconnect with
          *     `last_event_id` after any of them except 1008. While the server is reconnecting its own event
@@ -2096,6 +2326,8 @@ export interface paths {
          * Mark a conversation read
          * @description Moves the contact's read cursor to `message_id`, or to the latest message when it is
          *     absent; it only moves forward. Replies the contact has read are not e-mailed to them.
+         *     When it moves, members see it as the conversation's `last_read_by_contact_at` and a
+         *     `contact.read` event on `/v1/realtime`.
          */
         post: operations["markClientConversationRead"];
         delete?: never;
@@ -2104,6 +2336,31 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/client/v1/conversations/{conversationId}/rating": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Rate a closed conversation
+         * @description Records the contact's rating (`good` or `bad`) and optional comment for a conversation
+         *     whose `can_rate` is true. It is stored once per close: members see it in the thread as a
+         *     `rated` event and on the conversation, and it sends the `conversation.rated` webhook.
+         *     Answers `409 rating_unavailable` when `can_rate` is false (the inbox does not ask for
+         *     ratings, the conversation is open, the close is older than 30 days) and
+         *     `409 already_rated` when the contact already rated this close.
+         */
+        post: operations["rateClientConversation"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/client/v1/conversations/{conversationId}/typing": {
         parameters: {
             query?: never;
@@ -2494,6 +2751,27 @@ export interface webhooks {
         patch?: never;
         trace?: never;
     };
+    "conversation.rated": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * A contact rated a conversation
+         * @description The contact rated a closed conversation; `conversation.rating` holds the rating and
+         *     comment. Sent once per rating, with `conversation.updated` for the same change.
+         */
+        post: operations["webhookConversationRated"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "conversation.updated": {
         parameters: {
             query?: never;
@@ -2756,8 +3034,90 @@ export interface components {
             email: components["schemas"]["Email"];
             name: string;
             role: components["schemas"]["Role"];
+            availability: components["schemas"]["Availability"];
+            /**
+             * @description The member has a `/v1/realtime` connection seen in the last 75 seconds (any panel tab
+             *     or device). `member.presence` events on `/v1/realtime` report changes.
+             */
+            online: boolean;
+            /** Format: date-time */
+            created_at: string;
+        };
+        MemberPresence: {
+            /** Format: uuid */
+            member_id: string;
+            availability: components["schemas"]["Availability"];
+            online: boolean;
+        };
+        Viewing: {
+            /** Format: uuid */
+            member_id: string;
+            /** Format: uuid */
+            conversation_id: string;
+            /** @description `false` when the member no longer has the conversation open anywhere. */
+            viewing: boolean;
+        };
+        /**
+         * @description Another member opened (`viewing: true`) or left a conversation, as their panel reported
+         *     with a `viewing` frame; leaving includes hiding the page and disconnecting. Right after a
+         *     connection reports a conversation, it also gets one `viewing: true` event for every other
+         *     member who already has it open. Not stored: it has no `id` and is not replayed. Sent to
+         *     member sessions that can see the conversation's inbox; members do not get their own.
+         */
+        ViewingEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "viewing";
+            /** Format: uuid */
+            workspace_id: string;
+            /** Format: uuid */
+            inbox_id: string;
+            /** Format: uuid */
+            conversation_id: string;
+            /** Format: date-time */
+            created_at: string;
+            data: components["schemas"]["Viewing"];
+        };
+        /**
+         * @description A member's `availability` or `online` changed (they opened or closed the panel, or set
+         *     themselves away). Carries the member's current state, so it may repeat the previous one.
+         *     Not stored: it has no `id` and is not replayed; reload `/v1/members` after a reconnect.
+         *     A server process that stops without closing its connections sends none: such members
+         *     turn offline in `/v1/members` 75 seconds later. Sent to member sessions only, the member's
+         *     own included.
+         */
+        MemberPresenceEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "member.presence";
+            /** Format: uuid */
+            workspace_id: string;
+            /** Format: date-time */
+            created_at: string;
+            data: components["schemas"]["MemberPresence"];
+        };
+        /**
+         * @description One of a contact's `/client/v1/realtime` connections opened or closed. Carries the
+         *     contact's current presence, so it may repeat the previous one.
+         *     Not stored: it has no `id` and is not replayed; read `/v1/contacts/{contactId}/presence`
+         *     after a reconnect. A connection that ends without closing (a server process that died) is
+         *     announced within about two minutes.
+         */
+        ContactPresenceEvent: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "contact.presence";
+            /** Format: uuid */
+            workspace_id: string;
             /** Format: date-time */
             created_at: string;
+            data: components["schemas"]["ContactPresence"];
         };
         MemberList: {
             items: components["schemas"]["Member"][];
@@ -2944,6 +3304,7 @@ export interface components {
             message_in_my_conversation: components["schemas"]["NotificationChannels"];
             message_in_unassigned_conversation: components["schemas"]["NotificationChannels"];
             assigned_to_me: components["schemas"]["NotificationChannels"];
+            mentioned: components["schemas"]["NotificationChannels"];
         };
         /** @description Some events and their channels. */
         NotificationEventsUpdate: {
@@ -2952,6 +3313,7 @@ export interface components {
             message_in_my_conversation?: components["schemas"]["NotificationChannels"];
             message_in_unassigned_conversation?: components["schemas"]["NotificationChannels"];
             assigned_to_me?: components["schemas"]["NotificationChannels"];
+            mentioned?: components["schemas"]["NotificationChannels"];
         };
         NotificationSettings: {
             events: components["schemas"]["NotificationEvents"];
@@ -2986,7 +3348,7 @@ export interface components {
              * @description What caused it (see the `notifications` tag), or `test`.
              * @enum {string}
              */
-            event: "new_live_conversation" | "new_async_conversation" | "message_in_my_conversation" | "message_in_unassigned_conversation" | "assigned_to_me" | "test";
+            event: "new_live_conversation" | "new_async_conversation" | "message_in_my_conversation" | "message_in_unassigned_conversation" | "assigned_to_me" | "mentioned" | "test";
             /**
              * @description The inbox name and the contact's name.
              * @example Support · Ayşe Yılmaz
@@ -3096,6 +3458,13 @@ export interface components {
              */
             expected_reply_minutes?: number;
             business_hours: components["schemas"]["BusinessHours"];
+            /**
+             * @description Contacts may rate a closed conversation (`good` or `bad`, with an optional comment):
+             *     the widget and the mobile SDKs offer it, and e-mail contacts get a request with two
+             *     links after a member's conversation is closed. Off by default. Only conversations
+             *     closed after it was turned on can be rated; turning it off and on again starts over.
+             */
+            ask_for_rating: boolean;
             /** Format: date-time */
             created_at: string;
             /** Format: date-time */
@@ -3112,6 +3481,8 @@ export interface components {
             /** Format: int32 */
             expected_reply_minutes?: number;
             business_hours?: components["schemas"]["BusinessHours"];
+            /** @default false */
+            ask_for_rating: boolean;
         };
         InboxUpdate: {
             name?: string;
@@ -3126,6 +3497,7 @@ export interface components {
              */
             expected_reply_minutes?: number | null;
             business_hours?: components["schemas"]["BusinessHours"];
+            ask_for_rating?: boolean;
         };
         InboxCreated: {
             inbox: components["schemas"]["Inbox"];
@@ -3293,32 +3665,96 @@ export interface components {
             locale?: components["schemas"]["LanguageTag"];
             /** @description The contact's addresses that must not be mailed. */
             undeliverable: components["schemas"]["UndeliverableEmail"][];
+            activity?: components["schemas"]["ContactActivity"];
             /** Format: date-time */
             created_at: string;
             /** Format: date-time */
             updated_at: string;
         };
-        ContactPresence: {
-            /** Format: uuid */
-            contact_id: string;
-            /** @description A `/client/v1/realtime` connection of the contact was seen in the last 75 seconds. */
-            online: boolean;
+        /**
+         * @description Only on `GET /v1/contacts` and `GET /v1/contacts/{contactId}`. The counts cover the
+         *     conversations the caller can see, spam left out; `last_seen_at` does not depend on the caller.
+         */
+        ContactActivity: {
             /**
              * Format: date-time
-             * @description The contact's last client activity (a connection or a session use); absent when never seen.
+             * @description The contact's last activity: a message (any channel), a rating, or use of a widget or
+             *     app session. Absent when never active.
              */
             last_seen_at?: string;
+            /** Format: int64 */
+            conversations: number;
+            /** Format: int64 */
+            open_conversations: number;
+            /**
+             * Format: date-time
+             * @description The last message in any of those conversations, else when the newest one started.
+             */
+            last_conversation_at?: string;
         };
-        FeedbackContact: {
-            /** @description The host app's id for this user, per inbox. */
-            external_id: string;
-            email?: components["schemas"]["Email"];
-            name?: string;
-        };
-        FeedbackCreate: components["schemas"]["FeedbackFields"] & {
+        ContactNote: {
             /** Format: uuid */
-            inbox_id: string;
-            contact: components["schemas"]["FeedbackContact"];
+            id: string;
+            /** Format: uuid */
+            contact_id: string;
+            /** @description A `member` or a `bot` (API key); `member_id` is absent once the member was removed. */
+            author: components["schemas"]["MessageAuthor"];
+            /** @description Plain text. */
+            body: string;
+            /** Format: date-time */
+            created_at: string;
+        };
+        ContactNoteCreate: {
+            body: string;
+        };
+        ContactNotePage: {
+            items: components["schemas"]["ContactNote"][];
+            next_cursor?: string;
+        };
+        /**
+         * @description How the team has served the contact, over all their conversations the caller can see (spam
+         *     left out).
+         */
+        ContactSummary: {
+            /**
+             * Format: int64
+             * @description Conversations where a member answered the contact's first message.
+             */
+            first_replies: number;
+            /**
+             * Format: int64
+             * @description Median seconds from the contact's first message to the first member reply; absent when `first_replies` is 0.
+             */
+            median_first_reply_seconds?: number;
+            /** @description The latest rating of each conversation. */
+            ratings: {
+                /** Format: int64 */
+                good: number;
+                /** Format: int64 */
+                bad: number;
+            };
+        };
+        ContactPresence: {
+            /** Format: uuid */
+            contact_id: string;
+            /** @description A `/client/v1/realtime` connection of the contact was seen in the last 75 seconds. */
+            online: boolean;
+            /**
+             * Format: date-time
+             * @description The contact's last client activity (a connection or a session use); absent when never seen.
+             */
+            last_seen_at?: string;
+        };
+        FeedbackContact: {
+            /** @description The host app's id for this user, per inbox. */
+            external_id: string;
+            email?: components["schemas"]["Email"];
+            name?: string;
+        };
+        FeedbackCreate: components["schemas"]["FeedbackFields"] & {
+            /** Format: uuid */
+            inbox_id: string;
+            contact: components["schemas"]["FeedbackContact"];
             category: components["schemas"]["FeedbackCategory"];
             subject?: string;
             body: string;
@@ -3337,7 +3773,7 @@ export interface components {
             count: number;
         };
         /** @enum {string} */
-        WebhookEventType: "conversation.created" | "conversation.updated" | "message.created" | "feedback.created" | "contact.updated" | "contact.deleted" | "draft.created" | "draft.updated" | "draft.deleted";
+        WebhookEventType: "conversation.created" | "conversation.updated" | "conversation.rated" | "message.created" | "feedback.created" | "contact.updated" | "contact.deleted" | "draft.created" | "draft.updated" | "draft.deleted";
         WebhookEndpoint: {
             /** Format: uuid */
             id: string;
@@ -3622,11 +4058,38 @@ export interface components {
              * @description The last message or note, or the creation time.
              */
             last_activity_at: string;
+            /**
+             * Format: date-time
+             * @description When it was last closed; absent when it never was.
+             */
+            closed_at?: string;
+            rating?: components["schemas"]["ConversationRating"];
+            /**
+             * Format: date-time
+             * @description The contact has read every message created at or before this time, in the widget or
+             *     an app (`POST /client/v1/conversations/{id}/read`). Absent until the contact has read
+             *     anything, and in conversations the contact only reaches by e-mail. A `contact.read`
+             *     event tells when it moves.
+             */
+            last_read_by_contact_at?: string;
             /** Format: date-time */
             created_at: string;
             /** Format: date-time */
             updated_at: string;
         };
+        /**
+         * @description The contact's latest rating. A conversation can be rated once each time it is closed, so
+         *     this may belong to an earlier close (compare `rated_at` with `closed_at`). The thread also
+         *     has it as a `rated` event message whose body is the comment.
+         */
+        ConversationRating: {
+            rating: components["schemas"]["Rating"];
+            comment?: string;
+            /** Format: date-time */
+            rated_at: string;
+        };
+        /** @enum {string} */
+        Rating: "good" | "bad";
         ConversationCreate: {
             /** Format: uuid */
             inbox_id: string;
@@ -3723,21 +4186,137 @@ export interface components {
             last_message?: components["schemas"]["MessagePreview"];
             /**
              * @description A message or note from someone other than the calling member is newer than the
-             *     member's read cursor. Always `false` for API keys.
+             *     member's read cursor, or the member marked it unread. Always `false` for API keys.
              */
             unread: boolean;
+            /**
+             * Format: date-time
+             * @description When the calling member pinned it; absent when they did not, and for API keys.
+             */
+            pinned_at?: string;
         };
         ConversationPage: {
             items: components["schemas"]["ConversationListItem"][];
             /** @description Absent on the last page. */
             next_cursor?: string;
         };
+        /** @description Enough of a conversation to show where an item belongs. */
+        ConversationSummary: {
+            /** Format: uuid */
+            id: string;
+            /** Format: uuid */
+            inbox_id: string;
+            subject: string;
+            status: components["schemas"]["ConversationStatus"];
+            contact: components["schemas"]["ConversationContact"];
+        };
+        MentionNote: {
+            /** Format: uuid */
+            id: string;
+            /** @description The plain-text body on one line, cut to 140 characters with `…` when longer. */
+            text: string;
+            author: components["schemas"]["MessageAuthor"];
+            /** Format: date-time */
+            created_at: string;
+        };
+        Mention: {
+            note: components["schemas"]["MentionNote"];
+            conversation: components["schemas"]["ConversationSummary"];
+            /** @description The calling member has read the conversation up to this note. */
+            seen: boolean;
+        };
+        MentionPage: {
+            items: components["schemas"]["Mention"][];
+            /** @description Absent on the last page. */
+            next_cursor?: string;
+            /**
+             * Format: int64
+             * @description Unseen mentions over all pages.
+             */
+            unseen: number;
+        };
+        /**
+         * @description `bot`: written with an API key. `assistant`: written by a member through an OAuth client.
+         *     `member`: written by a member in the panel.
+         * @enum {string}
+         */
+        DraftAuthorKind: "bot" | "assistant" | "member";
+        DraftItem: {
+            draft: components["schemas"]["Message"];
+            conversation: components["schemas"]["ConversationSummary"];
+        };
+        DraftPage: {
+            items: components["schemas"]["DraftItem"][];
+            /** @description Absent on the last page. */
+            next_cursor?: string;
+            /**
+             * Format: int64
+             * @description Drafts matching the filters over all pages.
+             */
+            total: number;
+        };
         CountByID: {
             /** Format: uuid */
             id: string;
             /** Format: int64 */
             count: number;
         };
+        Stats: {
+            /** Format: date-time */
+            since: string;
+            /**
+             * Format: date-time
+             * @description When it was counted.
+             */
+            until: string;
+            /**
+             * Format: int64
+             * @description Replies sent by members.
+             */
+            replies: number;
+            /**
+             * Format: int64
+             * @description Times a conversation was closed, by anyone (members, API keys, the server).
+             */
+            closed: number;
+            /**
+             * Format: int64
+             * @description Conversations whose first member reply to the contact was sent in the window.
+             */
+            first_replies: number;
+            /**
+             * Format: int64
+             * @description Median seconds from the contact's first message to that reply; absent when `first_replies` is 0.
+             */
+            median_first_reply_seconds?: number;
+            ratings: components["schemas"]["RatingStats"];
+            /** @description Per member, by member id. */
+            members: components["schemas"]["MemberStats"][];
+        };
+        /** @description Ratings contacts gave in the window, in total and per inbox (inboxes without any are left out). */
+        RatingStats: {
+            /** Format: int64 */
+            good: number;
+            /** Format: int64 */
+            bad: number;
+            inboxes: components["schemas"]["InboxRatingStats"][];
+        };
+        InboxRatingStats: {
+            /** Format: uuid */
+            inbox_id: string;
+            /** Format: int64 */
+            good: number;
+            /** Format: int64 */
+            bad: number;
+        };
+        MemberStats: {
+            /** Format: uuid */
+            member_id: string;
+            /** Format: int64 */
+            replies: number;
+            /** Format: int64 */
+            closed: number;
+        };
         /** @description Open conversations in the inboxes the caller can see. */
         ConversationCounts: {
             /**
@@ -3760,6 +4339,11 @@ export interface components {
             unassigned: number;
             /** @description Per inbox id. */
             inboxes: components["schemas"]["CountByID"][];
+            /**
+             * @description Per assignee's member id: each member's open load, for choosing whom to hand a
+             *     conversation to. Counts only the inboxes the caller can see.
+             */
+            assignees: components["schemas"]["CountByID"][];
             /** @description Per label id. */
             labels: components["schemas"]["CountByID"][];
         };
@@ -3781,8 +4365,21 @@ export interface components {
              * @description Absent when the conversation has nothing to read yet.
              */
             last_read_message_id?: string;
+            /** @description Something is newer than the cursor, or the member marked it unread. */
             unread: boolean;
         };
+        /** @description Whether a member pinned a conversation to the top of their lists. */
+        ConversationPin: {
+            /** Format: uuid */
+            conversation_id: string;
+            /** Format: uuid */
+            member_id: string;
+            /**
+             * Format: date-time
+             * @description Absent when it is not pinned.
+             */
+            pinned_at?: string;
+        };
         /**
          * @description `message` goes to or comes from the contact, `note` is for members only, `event` records a
          *     change (assignment, status, labels).
@@ -3824,7 +4421,7 @@ export interface components {
             via?: string;
         };
         /** @enum {string} */
-        EventType: "assigned" | "unassigned" | "status_changed" | "labels_changed" | "moved";
+        EventType: "assigned" | "unassigned" | "status_changed" | "labels_changed" | "moved" | "rated";
         MessageEvent: {
             type: components["schemas"]["EventType"];
             /**
@@ -3851,6 +4448,8 @@ export interface components {
              * @description The inbox it moved from (`moved`).
              */
             previous_inbox_id?: string;
+            /** @description `rated` only: the contact's rating; the message body is their comment. */
+            rating?: components["schemas"]["Rating"];
         };
         Attachment: {
             /**
@@ -3897,6 +4496,8 @@ export interface components {
             draft: boolean;
             /** @description Who sent a draft (`member` or `bot`); absent for messages that were never drafts. */
             sent_by?: components["schemas"]["MessageAuthor"];
+            /** @description Members a note mentions (notes only; absent when it mentions nobody). */
+            mentions?: string[];
             /**
              * Format: date-time
              * @description For a sent draft, when it was sent.
@@ -3956,7 +4557,16 @@ export interface components {
             full_text: string;
             /** @description The whole HTML part, sanitized. */
             full_html?: string;
-            /** @description `full_html` loads images from other servers; block them until the member asks. */
+            /**
+             * @description The whole HTML part of the kept original, built on request and sanitized with a policy
+             *     that keeps inline styles limited to an allowlist of CSS properties (no `url(`,
+             *     `expression` or `@import` values) and the colour, alignment and size attributes of
+             *     tables and `font`; never `<style>` blocks, scripts, forms, frames, stylesheets or event
+             *     handlers. `cid:` sources are kept as in `full_html`. Absent when the original is not
+             *     kept, has no HTML part or is too large.
+             */
+            original_html?: string;
+            /** @description `full_html` or `original_html` loads images from other servers; block them until the member asks. */
             has_remote_images: boolean;
             in_reply_to?: string;
             references?: string[];
@@ -3979,6 +4589,14 @@ export interface components {
             client_id?: string;
             /** @description Stores an outgoing message as a draft instead of delivering it. */
             draft?: boolean;
+            /**
+             * @description Notes only: members to notify about the note. Each must be a member of the workspace
+             *     who can see the conversation's inbox (`400 validation_failed` otherwise). They get the
+             *     `mentioned` notification (realtime as `message.created`, Web Push and e-mail per their
+             *     notification settings); the author is never notified. The panel shows mentions in the
+             *     body as it likes; the server does not parse `@` in the text.
+             */
+            mentions?: string[];
         };
         MessageCreateMultipart: {
             /** @enum {string} */
@@ -3988,6 +4606,8 @@ export interface components {
             html?: string;
             client_id?: string;
             draft?: boolean;
+            /** @description Notes only; repeat the field once per member id. */
+            mentions?: string[];
             files?: string[];
         };
         /** @description Only the fields sent change. */
@@ -4270,6 +4890,56 @@ export interface components {
             created_at: string;
             data: components["schemas"]["ConversationRead"];
         };
+        /** @description The contact's read position in a conversation. */
+        ContactRead: {
+            /** Format: uuid */
+            conversation_id: string;
+            /** Format: uuid */
+            last_read_message_id: string;
+            /**
+             * Format: date-time
+             * @description The contact has read every message created at or before this time.
+             */
+            read_at: string;
+        };
+        /** @description The contact read the conversation further, in the widget or an app. */
+        ContactReadEvent: {
+            /** Format: int64 */
+            id: number;
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "contact.read";
+            /** Format: uuid */
+            workspace_id: string;
+            /** Format: uuid */
+            inbox_id: string;
+            /** Format: uuid */
+            conversation_id: string;
+            /** Format: date-time */
+            created_at: string;
+            data: components["schemas"]["ContactRead"];
+        };
+        /** @description The receiving member pinned or unpinned a conversation, in this or another tab or device. */
+        ConversationPinEvent: {
+            /** Format: int64 */
+            id: number;
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            type: "conversation.pin";
+            /** Format: uuid */
+            workspace_id: string;
+            /** Format: uuid */
+            inbox_id: string;
+            /** Format: uuid */
+            conversation_id: string;
+            /** Format: date-time */
+            created_at: string;
+            data: components["schemas"]["ConversationPin"];
+        };
         /** @description A member was given or lost access to an inbox. Reload the inboxes and conversations when it is about you. */
         InboxAccessChangedEvent: {
             /** Format: int64 */
@@ -4326,7 +4996,7 @@ export interface components {
             type: "resync_required";
         };
         /** @description An event as `GET /v1/events` returns it, told apart by `type`; the same objects realtime and webhooks carry. */
-        StoredEvent: components["schemas"]["ConversationEvent"] | components["schemas"]["ConversationMovedEvent"] | components["schemas"]["MessageCreatedEvent"] | components["schemas"]["MessageUpdatedEvent"] | components["schemas"]["DraftEvent"] | components["schemas"]["ContactUpdatedEvent"] | components["schemas"]["ContactDeletedEvent"] | components["schemas"]["InboxCreatedEvent"] | components["schemas"]["InboxUpdatedEvent"] | components["schemas"]["InboxDeletedEvent"] | components["schemas"]["InboxAccessChangedEvent"] | components["schemas"]["ConversationReadEvent"];
+        StoredEvent: components["schemas"]["ConversationEvent"] | components["schemas"]["ConversationMovedEvent"] | components["schemas"]["MessageCreatedEvent"] | components["schemas"]["MessageUpdatedEvent"] | components["schemas"]["DraftEvent"] | components["schemas"]["ContactUpdatedEvent"] | components["schemas"]["ContactDeletedEvent"] | components["schemas"]["InboxCreatedEvent"] | components["schemas"]["InboxUpdatedEvent"] | components["schemas"]["InboxDeletedEvent"] | components["schemas"]["InboxAccessChangedEvent"] | components["schemas"]["ConversationReadEvent"] | components["schemas"]["ContactReadEvent"] | components["schemas"]["ConversationPinEvent"];
         EventPage: {
             events: components["schemas"]["StoredEvent"][];
             /**
@@ -4345,7 +5015,7 @@ export interface components {
             id: number;
         };
         /** @description One server message on `/v1/realtime`, told apart by `type`. */
-        RealtimeMessage: components["schemas"]["ConversationEvent"] | components["schemas"]["ConversationMovedEvent"] | components["schemas"]["MessageCreatedEvent"] | components["schemas"]["MessageUpdatedEvent"] | components["schemas"]["DraftEvent"] | components["schemas"]["ContactUpdatedEvent"] | components["schemas"]["ContactDeletedEvent"] | components["schemas"]["InboxCreatedEvent"] | components["schemas"]["InboxUpdatedEvent"] | components["schemas"]["InboxDeletedEvent"] | components["schemas"]["InboxAccessChangedEvent"] | components["schemas"]["ConversationReadEvent"] | components["schemas"]["TypingEvent"] | components["schemas"]["RealtimeReady"] | components["schemas"]["RealtimeResyncRequired"];
+        RealtimeMessage: components["schemas"]["ConversationEvent"] | components["schemas"]["ConversationMovedEvent"] | components["schemas"]["MessageCreatedEvent"] | components["schemas"]["MessageUpdatedEvent"] | components["schemas"]["DraftEvent"] | components["schemas"]["ContactUpdatedEvent"] | components["schemas"]["ContactDeletedEvent"] | components["schemas"]["InboxCreatedEvent"] | components["schemas"]["InboxUpdatedEvent"] | components["schemas"]["InboxDeletedEvent"] | components["schemas"]["InboxAccessChangedEvent"] | components["schemas"]["ConversationReadEvent"] | components["schemas"]["ContactReadEvent"] | components["schemas"]["ConversationPinEvent"] | components["schemas"]["TypingEvent"] | components["schemas"]["MemberPresenceEvent"] | components["schemas"]["ContactPresenceEvent"] | components["schemas"]["ViewingEvent"] | components["schemas"]["RealtimeReady"] | components["schemas"]["RealtimeResyncRequired"];
         /**
          * @description `auto`: available in `live` inboxes while connected to `/v1/realtime` within business
          *     hours. `away`: never shown as available.
@@ -4565,6 +5235,11 @@ export interface components {
             chat: components["schemas"]["ClientChatSettings"];
             /** @description The categories `POST /client/v1/feedback` accepts, in display order. */
             feedback_categories: components["schemas"]["FeedbackCategory"][];
+            /**
+             * @description The inbox asks contacts to rate closed conversations; offer it where `can_rate` is true
+             *     on a conversation.
+             */
+            ask_for_rating: boolean;
         };
         ClientContact: {
             /** Format: uuid */
@@ -4596,6 +5271,9 @@ export interface components {
             /** Format: uuid */
             id: string;
             status: components["schemas"]["ConversationStatus"];
+            /** @description As on `ClientConversation`. */
+            can_rate: boolean;
+            rating?: components["schemas"]["Rating"];
             /** Format: date-time */
             updated_at: string;
         };
@@ -4628,9 +5306,23 @@ export interface components {
              *     when no member has read the conversation, and in `async` inboxes.
              */
             last_read_by_member_at?: string;
+            /**
+             * @description The contact may rate it now with `POST /client/v1/conversations/{id}/rating`: the inbox
+             *     asks for ratings (`ask_for_rating`), the conversation is closed, was closed at most 30
+             *     days ago and after the inbox started asking, and has no rating since it was closed. A message from the contact reopens it,
+             *     and the next close allows a new rating.
+             */
+            can_rate: boolean;
+            /** @description The contact's rating since the last close; absent when they have not rated it. */
+            rating?: components["schemas"]["Rating"];
             /** Format: date-time */
             created_at: string;
         };
+        ClientRatingCreate: {
+            rating: components["schemas"]["Rating"];
+            /** @description Optional; blank is the same as absent. */
+            comment?: string;
+        };
         ClientConversationPage: {
             items: components["schemas"]["ClientConversation"][];
             /** @description Absent on the last page. */
@@ -5659,6 +6351,37 @@ export interface operations {
             404: components["responses"]["Problem"];
         };
     };
+    listMentions: {
+        parameters: {
+            query?: {
+                /** @description The `next_cursor` of the previous page. */
+                cursor?: components["parameters"]["Cursor"];
+                /** @description Page size, 1 to 100; 25 by default. */
+                limit?: components["parameters"]["Limit"];
+            };
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description A page of mentions. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MentionPage"];
+                };
+            };
+            400: components["responses"]["Problem"];
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+        };
+    };
     getWorkspace: {
         parameters: {
             query?: never;
@@ -6502,6 +7225,14 @@ export interface operations {
             query?: {
                 /** @description Full-text search (Postgres `simple` configuration, `websearch` syntax). */
                 q?: components["parameters"]["Search"];
+                /**
+                 * @description `known`: the contact has an e-mail address or an external id. `visitor`: neither (an
+                 *     anonymous widget visitor, or someone known only by a typed, unconfirmed address).
+                 */
+                kind?: "known" | "visitor";
+                /** @description Only contacts with (`true`) or without (`false`) an open conversation the caller can see; spam does not count. */
+                has_open?: boolean;
+                sort?: "created" | "last_seen";
                 /** @description The `next_cursor` of the previous page. */
                 cursor?: components["parameters"]["Cursor"];
                 /** @description Page size, 1 to 100; 25 by default. */
@@ -6744,9 +7475,14 @@ export interface operations {
             404: components["responses"]["Problem"];
         };
     };
-    getContactPresence: {
+    listContactNotes: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description The `next_cursor` of the previous page. */
+                cursor?: components["parameters"]["Cursor"];
+                /** @description Page size, 1 to 100; 25 by default. */
+                limit?: components["parameters"]["Limit"];
+            };
             header?: {
                 /** @description The workspace to act on; see "Workspace selection". */
                 "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
@@ -6758,57 +7494,179 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description The contact's presence. */
+            /** @description A page of notes. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ContactPresence"];
+                    "application/json": components["schemas"]["ContactNotePage"];
                 };
             };
+            400: components["responses"]["Problem"];
             401: components["responses"]["Problem"];
             403: components["responses"]["Problem"];
             404: components["responses"]["Problem"];
         };
     };
-    listConversations: {
+    createContactNote: {
         parameters: {
-            query?: {
-                inbox_id?: string;
-                /** @description Only this contact's conversations. A contact of another workspace answers `404`. */
-                contact_id?: string;
-                status?: components["schemas"]["ConversationStatus"];
-                /** @description A member id, `me` (member sessions only) or `unassigned`. */
-                assignee?: string;
-                label_id?: string;
-                /**
-                 * @description `true` lists only conversations flagged as spam (the spam view); without it, or with
-                 *     `false`, spam is left out.
-                 */
-                spam?: boolean;
-                /** @description Only conversations of this kind, e.g. `feedback` for the feedback view. */
-                kind?: components["schemas"]["ConversationKind"];
-                /** @description Only feedback of this category (implies `kind=feedback`). */
-                category?: components["schemas"]["FeedbackCategory"];
-                /** @description Full-text search (Postgres `simple` configuration, `websearch` syntax). */
-                q?: components["parameters"]["Search"];
-                /** @description The `next_cursor` of the previous page. */
-                cursor?: components["parameters"]["Cursor"];
-                /** @description Page size, 1 to 100; 25 by default. */
-                limit?: components["parameters"]["Limit"];
-            };
+            query?: never;
             header?: {
                 /** @description The workspace to act on; see "Workspace selection". */
                 "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
             };
-            path?: never;
+            path: {
+                contactId: components["parameters"]["ContactId"];
+            };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ContactNoteCreate"];
+            };
+        };
         responses: {
-            /** @description A page of conversations. */
-            200: {
+            /** @description The note. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ContactNote"];
+                };
+            };
+            400: components["responses"]["Problem"];
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+        };
+    };
+    deleteContactNote: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path: {
+                contactId: components["parameters"]["ContactId"];
+                noteId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Deleted. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+        };
+    };
+    getContactSummary: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path: {
+                contactId: components["parameters"]["ContactId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The summary. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ContactSummary"];
+                };
+            };
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+        };
+    };
+    getContactPresence: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path: {
+                contactId: components["parameters"]["ContactId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The contact's presence. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ContactPresence"];
+                };
+            };
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+        };
+    };
+    listConversations: {
+        parameters: {
+            query?: {
+                inbox_id?: string;
+                /** @description Only this contact's conversations. A contact of another workspace answers `404`. */
+                contact_id?: string;
+                status?: components["schemas"]["ConversationStatus"];
+                /** @description A member id, `me` (member sessions only) or `unassigned`. */
+                assignee?: string;
+                label_id?: string;
+                /**
+                 * @description `true` lists only conversations flagged as spam (the spam view); without it, or with
+                 *     `false`, spam is left out.
+                 */
+                spam?: boolean;
+                /** @description Only conversations of this kind, e.g. `feedback` for the feedback view. */
+                kind?: components["schemas"]["ConversationKind"];
+                /** @description Only feedback of this category (implies `kind=feedback`). */
+                category?: components["schemas"]["FeedbackCategory"];
+                /**
+                 * @description `true` lists only the conversations the calling member pinned, `false` only the others;
+                 *     without it, both. Member sessions only (`400 validation_failed` for API keys).
+                 */
+                pinned?: boolean;
+                /** @description Full-text search (Postgres `simple` configuration, `websearch` syntax). */
+                q?: components["parameters"]["Search"];
+                /** @description The `next_cursor` of the previous page. */
+                cursor?: components["parameters"]["Cursor"];
+                /** @description Page size, 1 to 100; 25 by default. */
+                limit?: components["parameters"]["Limit"];
+            };
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description A page of conversations. */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -6880,6 +7738,40 @@ export interface operations {
             403: components["responses"]["Problem"];
         };
     };
+    getStats: {
+        parameters: {
+            query?: {
+                /** @description Only this inbox (`404` when the caller cannot see it). */
+                inbox_id?: string;
+                /** @description Start of the window; the start of today in `timezone` when absent. */
+                since?: string;
+                /** @description IANA time zone for the default `since`. */
+                timezone?: string;
+            };
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The activity. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Stats"];
+                };
+            };
+            400: components["responses"]["Problem"];
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+        };
+    };
     bulkUpdateConversations: {
         parameters: {
             query?: never;
@@ -7127,6 +8019,92 @@ export interface operations {
             404: components["responses"]["Problem"];
         };
     };
+    markConversationUnread: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Makes a retried request return the first response; see "Idempotency". */
+                "Idempotency-Key"?: components["parameters"]["IdempotencyKey"];
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path: {
+                conversationId: components["parameters"]["ConversationId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The member's read state. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ConversationRead"];
+                };
+            };
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+        };
+    };
+    pinConversation: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path: {
+                conversationId: components["parameters"]["ConversationId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The member's pin. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ConversationPin"];
+                };
+            };
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+        };
+    };
+    unpinConversation: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path: {
+                conversationId: components["parameters"]["ConversationId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The member's pin, without `pinned_at`. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ConversationPin"];
+                };
+            };
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+        };
+    };
     setMemberTyping: {
         parameters: {
             query?: never;
@@ -7160,6 +8138,41 @@ export interface operations {
             404: components["responses"]["Problem"];
         };
     };
+    listDrafts: {
+        parameters: {
+            query?: {
+                /** @description Only drafts in this inbox. An inbox the caller cannot see answers `404`. */
+                inbox_id?: string;
+                author?: components["schemas"]["DraftAuthorKind"];
+                /** @description The `next_cursor` of the previous page. */
+                cursor?: components["parameters"]["Cursor"];
+                /** @description Page size, 1 to 100; 25 by default. */
+                limit?: components["parameters"]["Limit"];
+            };
+            header?: {
+                /** @description The workspace to act on; see "Workspace selection". */
+                "Yuva-Workspace"?: components["parameters"]["WorkspaceHeader"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description A page of drafts. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DraftPage"];
+                };
+            };
+            400: components["responses"]["Problem"];
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+        };
+    };
     downloadAttachment: {
         parameters: {
             query?: {
@@ -8473,6 +9486,37 @@ export interface operations {
             404: components["responses"]["Problem"];
         };
     };
+    rateClientConversation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                conversationId: components["parameters"]["ConversationId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ClientRatingCreate"];
+            };
+        };
+        responses: {
+            /** @description The conversation with its rating. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ClientConversation"];
+                };
+            };
+            400: components["responses"]["Problem"];
+            401: components["responses"]["Problem"];
+            403: components["responses"]["Problem"];
+            404: components["responses"]["Problem"];
+            409: components["responses"]["Problem"];
+        };
+    };
     setClientTyping: {
         parameters: {
             query?: never;
@@ -8940,6 +9984,39 @@ export interface operations {
             };
         };
     };
+    webhookConversationRated: {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description The delivery's id, the same on every retry; use it to ignore duplicates. */
+                "webhook-id": components["parameters"]["WebhookIdHeader"];
+                /** @description Unix seconds of this attempt. Refuse values far from your clock. */
+                "webhook-timestamp": components["parameters"]["WebhookTimestampHeader"];
+                /**
+                 * @description Space-separated `v1,<base64>` signatures: HMAC-SHA256 over
+                 *     `<webhook-id>.<webhook-timestamp>.<body>` with the base64-decoded part of the
+                 *     `whsec_` secret (Standard Webhooks). Two during a secret rotation.
+                 */
+                "webhook-signature": components["parameters"]["WebhookSignatureHeader"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WebhookConversationPayload"];
+            };
+        };
+        responses: {
+            /** @description Any 2xx answer counts as delivered. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     webhookConversationUpdated: {
         parameters: {
             query?: never;