@arbidocs/client 0.4.84 → 0.4.85

package/dist/index.d.cts

@@ -639,14 +639,13 @@ interface paths {
          * @description Login with Ed25519 signature verification (local or SSO).
          *
          *     Authentication flow:
-         *     1. Client derives Ed25519 keypair from password
-         *     2. Client signs "email|timestamp" with Ed25519 private key
-         *     3. Server verifies signature using stored Ed25519 public key
-         *     4. Server encrypts response with stored X25519 public key
+         *     1. Client derives the password key (Ed25519) from the password, or holds the identity key
+         *        (recovery key, session re-login)
+         *     2. Client signs "email|timestamp" with it
+         *     3. Server verifies the signature against the stored password key or identity key
+         *     4. The response carries ``wrapped_identity_key``, which only the password key opens
          *
          *     For SSO users: Also validates SSO token before proceeding.
-         *
-         *     Returns encrypted login response that only the correct password can decrypt.
          */
         post: operations['login_user'];
         delete?: never;
@@ -730,17 +729,13 @@ interface paths {
         put?: never;
         /**
          * Change Password
-         * @description Change user's master password by re-keying all workspace keys.
-         *
-         *     Self re-key (agent_ext_id omitted):
-         *     1. Sign "email|timestamp" with current Ed25519 key (proves current password)
-         *     2. Provide new Ed25519 signing key (derived from new password)
-         *     3. Re-wrap all workspace keys with new X25519 public key
+         * @description Change the master password (or set a new one after signing in with the recovery key).
          *
-         *     Agent re-key (agent_ext_id provided):
-         *     1. Parent signs "agent_ext_id|timestamp" with their own Ed25519 key (proves authority)
-         *     2. Provide new Ed25519 signing key for the agent
-         *     3. Re-wrap the agent's workspace keys with the agent's new X25519 public key
+         *     The password only protects the identity keypair; it never encrypts content. The client signs
+         *     "email|timestamp" with the current password key (or with the identity key, in recovery), derives the
+         *     new password key, and wraps the identity's secret key under it. The server swaps the two values: the
+         *     identity — and every workspace key, mailbox key, direct message and directory entry bound to it —
+         *     is untouched, so nothing is re-encrypted and nothing can be left behind.
          */
         post: operations['change_password'];
         delete?: never;
@@ -1558,6 +1553,30 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/workspace/{workspace_ext_id}/activity': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Workspace Activity
+         * @description What happened in the workspace, newest first: thread history, people posting, documents uploaded, new
+         *     versions and signatures, and workflow runs.
+         *
+         *     Only what the caller can already see is listed: private threads (their events and messages), documents and
+         *     workflows of others are left out. Nothing here is pushed; notifications tell a person what needs them.
+         */
+        get: operations['get_workspace_activity'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/editor/{document_id}/mentions': {
         parameters: {
             query?: never;
@@ -3104,7 +3123,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    '/v1/tag/list': {
+    '/v1/tag/': {
         parameters: {
             query?: never;
             header?: never;
@@ -3113,18 +3132,32 @@ interface paths {
         };
         /**
          * List Tags
-         * @description List all tags in the current workspace.
+         * @description The workspace's tags, filtered: of a ``kind``, children of a ``parent``, or the ``ids`` given (filters
+         *     combine). Oldest first, or in the order of ``ids``.
+         *
+         *     A table of tags is this list: ``?kind=issue&include=links`` is every issue with its values (``field_values``,
+         *     for the columns ``GET /v1/tag/kinds/issue`` defines) and its evidence. With ``include=links`` each tag lists up
+         *     to ``links_limit`` documents (the doctag's note, how many passages it cites), facts and threads, newest first;
+         *     the counts are the totals, so a tag with none is a gap.
          */
         get: operations['list_tags'];
         put?: never;
-        post?: never;
+        /**
+         * Create Tag
+         * @description Create a new tag for a given workspace.
+         *
+         *     If 'shared' is provided, the tag will be set to shared or private accordingly.
+         *     If 'shared' is not provided, it defaults to True (shared). ``kind`` defaults from the format. Issues, people
+         *     and organisations are flat (no parent). ``field_values`` are for the kind's fields.
+         */
+        post: operations['create_tag'];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    '/v1/tag/matrix': {
+    '/v1/tag/kinds': {
         parameters: {
             query?: never;
             header?: never;
@@ -3132,15 +3165,10 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Get Tag Matrix
-         * @description A set of tags with their fields and values, plus the documents and facts linked to each.
-         *
-         *     Select the rows with ``parent_ext_id`` (its children; the parent comes back too, its fields being the
-         *     shared columns), with ``kind`` (e.g. every person, or every issue) or with ``tag_ext_id``. Each row lists up
-         *     to ``links_limit`` documents (with the doctag's note and how many passages it cites) and facts, newest
-         *     first; ``doc_count``/``fact_count`` are the totals.
+         * List Tag Kinds
+         * @description Every tag kind's fields in this workspace (the built-in ones where the workspace has not set its own).
          */
-        get: operations['get_tag_matrix'];
+        get: operations['list_tag_kinds'];
         put?: never;
         post?: never;
         delete?: never;
@@ -3149,30 +3177,33 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    '/v1/tag/entities/extract': {
+    '/v1/tag/kinds/{kind}': {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
         /**
-         * Extract Entities
-         * @description Find the people and organisations these documents name, and link each to its entity tag (on demand).
-         *
-         *     Returns 202 at once; a ``batch_complete`` (``entity_extract``) WebSocket message follows when every document
-         *     is done. Reuses entities already in the workspace by name or "Also known as"; only ever adds links.
+         * Get Tag Kind
+         * @description A kind's fields in this workspace — the columns of a table of its tags (e.g. the workspace's issue fields).
+         *     Each tag of the kind holds its own values (``field_values``).
          */
-        post: operations['extract_entities'];
+        get: operations['get_tag_kind'];
+        /**
+         * Update Tag Kind
+         * @description Set a kind's fields in this workspace, in full and in order: a field given with its ``id`` is kept (its
+         *     type cannot change; its name and options can), one without is added, one left out is removed.
+         */
+        put: operations['update_tag_kind'];
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    '/v1/tag/': {
+    '/v1/tag/entities/extract': {
         parameters: {
             query?: never;
             header?: never;
@@ -3182,14 +3213,13 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Create Tag
-         * @description Create a new tag for a given workspace.
+         * Extract Entities
+         * @description Find the people and organisations these documents name, and link each to its entity tag (on demand).
          *
-         *     If 'shared' is provided, the tag will be set to shared or private accordingly.
-         *     If 'shared' is not provided, it defaults to True (shared). ``kind`` defaults from the format; a person or
-         *     organisation gets that kind's default fields unless ``fields`` are given.
+         *     Returns 202 at once; a ``batch_complete`` (``entity_extract``) WebSocket message follows when every document
+         *     is done. Reuses entities already in the workspace by name (a person also by title and surname); only ever adds.
          */
-        post: operations['create_tag'];
+        post: operations['extract_entities'];
         delete?: never;
         options?: never;
         head?: never;
@@ -6156,23 +6186,6 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    '/v1/mail/native/rotation-credentials': {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /** Rotation Credentials */
-        get: operations['rotation_credentials_v1_mail_native_rotation_credentials_get'];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     '/v1/mail/accounts/{account_id}/drafts': {
         parameters: {
             query?: never;
@@ -6967,7 +6980,7 @@ interface components {
             WORKSPACE_SETUP: boolean;
             /**
              * Workspace Tools Enabled
-             * @description Enable native user-action tools so the agent can act as an ARBI user within its active workspace: list_workspaces, upload_document, list_tags, create_tag and tag_documents. In-process and RLS-native — bounded by the agent's workspace memberships. Off by default.
+             * @description Enable native user-action tools so the agent can act as an ARBI user within its active workspace: list_workspaces, upload_document, list_tags, create_tag, set_tag_fields and tag_documents. In-process and RLS-native — bounded by the agent's workspace memberships. Off by default.
              * @default false
              */
             WORKSPACE_TOOLS_ENABLED: boolean;
@@ -7234,7 +7247,7 @@ interface components {
             SKILLS_ENABLED: boolean;
             /**
              * Workspace Tools Enabled
-             * @description Enable native user-action tools so the agent can act as an ARBI user within its active workspace: list_workspaces, upload_document, list_tags, create_tag and tag_documents. In-process and RLS-native — bounded by the agent's workspace memberships. Off by default.
+             * @description Enable native user-action tools so the agent can act as an ARBI user within its active workspace: list_workspaces, upload_document, list_tags, create_tag, set_tag_fields and tag_documents. In-process and RLS-native — bounded by the agent's workspace memberships. Off by default.
              * @default false
              */
             WORKSPACE_TOOLS_ENABLED: boolean;
@@ -7932,19 +7945,19 @@ interface components {
             title: string;
             /**
              * Mode
-             * @description Rendering mode: markdown (default, supports redlines), html (single-file page, rendered in a sandboxed preview), react (single-file JSX component, rendered in a sandboxed preview), plain text, or image (a generated image artifact — render the doc via the image viewer)
+             * @description What the model wrote: markdown (default) or plain text — a document draft, stored as a Word document (DOCX) and opened in the Word editor; html (single-file page, rendered in a sandboxed preview); react (single-file JSX component, rendered in a sandboxed preview); or image (a generated image artifact — render the doc via the image viewer)
              * @default markdown
              * @enum {string}
              */
             mode: 'markdown' | 'html' | 'text' | 'react' | 'image';
             /**
              * Content
-             * @description The artifact content (markdown/html/text; empty for image mode)
+             * @description What the model wrote: the Markdown/text of a document draft (a preview: the document is the stored DOCX), or the html/jsx source; empty for image mode
              */
             content: string;
             /**
              * File Type
-             * @description Bare file extension for image-mode artifacts (e.g. 'png'); empty for text modes
+             * @description Bare extension of the stored file: 'docx' for a document draft (markdown/text), 'html' or 'jsx' for a UI artifact, the image's (e.g. 'png') for image mode
              * @default
              */
             file_type: string;
@@ -9103,50 +9116,25 @@ interface components {
         };
         /**
          * ChangePasswordRequest
-         * @description Password change request with signature-based auth.
+         * @description Change the master password: replace the password key and the wrapped identity key, nothing else.
          *
-         *     Self re-key (agent_ext_id omitted):
-         *       Client proves knowledge of current password by signing "email|timestamp"
-         *       with their own Ed25519 key.
-         *
-         *     Agent re-key (agent_ext_id provided):
-         *       Parent re-keys an agent's signing/encryption keys.  Parent proves authority
-         *       by signing "agent_ext_id|timestamp" with their own Ed25519 key.
-         *       rewrapped_workspace_keys must contain entries for the agent's workspaces,
-         *       each wrapped with the agent's new X25519 public key.
+         *     Everything the user can read (workspace keys, mailbox keys, direct messages, call keys) is encrypted
+         *     to the identity keypair, which a password change keeps, so the change is O(1) and re-encrypts nothing.
          */
         ChangePasswordRequest: {
             /** Signature */
             signature: string;
             /** Timestamp */
             timestamp: number;
-            /** New Signing Key */
-            new_signing_key: string;
-            /** Rewrapped Workspace Keys */
-            rewrapped_workspace_keys: {
-                [key: string]: string;
-            };
-            /** Agent Ext Id */
-            agent_ext_id?: string | null;
-            /** Rewrapped Agent Recovery Keys */
-            rewrapped_agent_recovery_keys?: {
-                [key: string]: string;
-            } | null;
-            /** Rewrapped Mail Keys */
-            rewrapped_mail_keys?: {
-                [key: string]: string;
-            } | null;
-            /** Rewrapped Mail Credentials */
-            rewrapped_mail_credentials?: {
-                [key: string]: string;
-            } | null;
+            /** New Login Key */
+            new_login_key: string;
+            /** Wrapped Identity Key */
+            wrapped_identity_key: string;
         };
         /** ChangePasswordResponse */
         ChangePasswordResponse: {
             /** Detail */
             detail: string;
-            /** Workspaces Updated */
-            workspaces_updated: number;
         };
         /**
          * ChatCompletionRequest
@@ -10514,9 +10502,9 @@ interface components {
          * CreateTagRequest
          * @description Request to create a new tag in a workspace.
          *
-         *     ``kind`` defaults to the parent's when the parent is an issue, person or organisation (so a matrix's new row
-         *     is one too), else from the format (checkbox → label, search → search, any other → annotation). A person or
-         *     organisation is created with that kind's default fields unless ``fields`` are given.
+         *     ``kind`` defaults from the format (checkbox → label, search → search, any other → annotation), never from the
+         *     parent. Issues, people and organisations are flat: they take no parent. ``field_values`` are for the kind's
+         *     fields (``GET /v1/tag/kinds/{kind}``).
          */
         CreateTagRequest: {
             /** Name */
@@ -10530,8 +10518,6 @@ interface components {
             shared?: boolean | null;
             /** Parent Ext Id */
             parent_ext_id?: string | null;
-            /** Fields */
-            fields?: components['schemas']['FieldDefinitionWrite'][] | null;
             /** Field Values */
             field_values?: {
                 [key: string]: unknown;
@@ -12111,9 +12097,11 @@ interface components {
          * ExtractEntitiesRequest
          * @description Find the people and organisations these documents name and link each to its entity tag.
          *
-         *     An entity already in the workspace (same kind, same name or one of its "Also known as" names) is reused;
-         *     a new one is created with that kind's default fields. Each document gets a link (a doctag citing the
-         *     passages that name the entity), and facts drawn from the document that mention the entity get it too.
+         *     An entity already in the workspace (same kind and name — for a person also "Mr Grant" for an only Grant)
+         *     is reused, its empty fields filled; a new one is created. Values go into the fields of that name the
+         *     workspace's person / organisation fields have. Each document
+         *     gets a link (a doctag citing the passages that name the entity), and facts drawn from the document that
+         *     mention the entity get it too.
          *     Existing links are kept; ``overwrite`` refreshes their citations (e.g. after a new version).
          */
         ExtractEntitiesRequest: {
@@ -12299,6 +12287,23 @@ interface components {
              */
             label: string;
         };
+        /**
+         * FieldDefinition
+         * @description A field as the API returns it — decrypted.
+         */
+        FieldDefinition: {
+            /** Id */
+            id: string;
+            /** Name */
+            name: string;
+            /**
+             * Type
+             * @enum {string}
+             */
+            type: 'text' | 'number' | 'date' | 'checkbox' | 'select' | 'person' | 'document' | 'relation' | 'lookup' | 'rollup';
+            /** Options */
+            options?: string[] | null;
+        };
         /**
          * FieldDefinitionWrite
          * @description A field in a write. Give ``id`` to keep an existing field (its type cannot change); omit it to add one.
@@ -13169,6 +13174,8 @@ interface components {
             /** Session Key */
             session_key: string;
             user: components['schemas']['UserResponse'];
+            /** Wrapped Identity Key */
+            wrapped_identity_key?: string | null;
             /**
              * Workspaces
              * @default []
@@ -14217,7 +14224,7 @@ interface components {
          *     Type is self-descriptive, no need to parse content field.
          * @enum {string}
          */
-        NotificationType: 'user_message' | 'workspaceuser_added_owner' | 'workspaceuser_added_collaborator' | 'workspaceuser_added_guest' | 'workspaceuser_removed' | 'workspaceuser_updated_owner' | 'workspaceuser_updated_collaborator' | 'workspaceuser_updated_guest' | 'contact_accepted' | 'signup_reward' | 'referral_reward' | 'native_mail_received' | 'mail_draft_ready' | 'email_reply' | 'quota_threshold_50' | 'quota_threshold_90' | 'quota_threshold_100' | 'doc_shared' | 'docx_mention' | 'workspace_access_request' | 'conversation_ready' | 'conversation_done' | 'conversation_notified' | 'workflow_failed' | 'agent_input_requested' | 'workflow_completed' | 'workflow_signal' | 'step_ready' | 'task_started' | 'task_completed' | 'mailbox_sync_complete' | 'drive_sync_complete' | 'activity' | 'mention' | 'call_missed' | 'calendar_invite' | 'calendar_update' | 'calendar_cancel' | 'calendar_reply' | 'calendar_counter' | 'calendar_reminder' | 'calendar_share';
+        NotificationType: 'user_message' | 'workspaceuser_added_owner' | 'workspaceuser_added_collaborator' | 'workspaceuser_added_guest' | 'workspaceuser_removed' | 'workspaceuser_updated_owner' | 'workspaceuser_updated_collaborator' | 'workspaceuser_updated_guest' | 'contact_accepted' | 'signup_reward' | 'referral_reward' | 'native_mail_received' | 'mail_draft_ready' | 'email_reply' | 'quota_threshold_50' | 'quota_threshold_90' | 'quota_threshold_100' | 'doc_shared' | 'docx_mention' | 'workspace_access_request' | 'conversation_ready' | 'conversation_done' | 'conversation_notified' | 'workflow_failed' | 'agent_input_requested' | 'workflow_completed' | 'workflow_signal' | 'step_ready' | 'task_started' | 'task_completed' | 'mailbox_sync_complete' | 'drive_sync_complete' | 'activity' | 'mention' | 'thread_reply' | 'document_activity' | 'call_missed' | 'calendar_invite' | 'calendar_update' | 'calendar_cancel' | 'calendar_reply' | 'calendar_counter' | 'calendar_reminder' | 'calendar_share';
         /**
          * NotificationUpdate
          * @description Single notification update for bulk PATCH.
@@ -15763,10 +15770,15 @@ interface components {
          *     For local users: given_name and family_name are required
          *     For SSO users: given_name and family_name are optional (extracted from JWT if not provided)
          *
-         *     Key derivation:
-         *     1. Client derives Ed25519 keypair from password using Argon2id
-         *     2. Client sends Ed25519 public key (signing_key)
-         *     3. Backend derives X25519 encryption key from Ed25519 signing key
+         *     Keys:
+         *     1. Client generates a random Ed25519 identity keypair and sends its public key (signing_key);
+         *        the backend derives the X25519 encryption key from it
+         *     2. Client derives the password key from the password (Argon2id) and sends its public key (login_key)
+         *        with the identity's secret key wrapped under it (wrapped_identity_key)
+         *
+         *     Omitting both login_key and wrapped_identity_key makes the password-derived key the identity itself
+         *     (``signing_key`` is then the password key). Scripts and service accounts use this; a password change
+         *     later keeps that identity, so its original password keeps opening it.
          */
         RegisterRequest: {
             /**
@@ -15776,6 +15788,10 @@ interface components {
             email: string;
             /** Signing Key */
             signing_key: string;
+            /** Login Key */
+            login_key?: string | null;
+            /** Wrapped Identity Key */
+            wrapped_identity_key?: string | null;
             /** Verification Credential */
             verification_credential: string;
             /** Given Name */
@@ -18112,51 +18128,10 @@ interface components {
             requests: number;
         };
         /**
-         * TagField
-         * @description A field a tag has — its own, or inherited from an ancestor (``tag_ext_id`` says which tag defines it).
+         * TagDocLink
+         * @description A document the tag is applied to: the doctag's note is the link's value.
          */
-        TagField: {
-            /** Id */
-            id: string;
-            /** Name */
-            name: string;
-            /**
-             * Type
-             * @enum {string}
-             */
-            type: 'text' | 'number' | 'date' | 'checkbox' | 'select' | 'person' | 'document' | 'relation' | 'lookup' | 'rollup';
-            /** Options */
-            options?: string[] | null;
-            /** Tag Ext Id */
-            tag_ext_id: string;
-        };
-        /**
-         * TagFormat
-         * @description Tag format configuration stored as JSONB.
-         *
-         *     Type-specific fields:
-         *     - select: options (list of choices, can be single or multi-select)
-         *     - search: tag name is the query, chunks include relevance scores
-         *     - checkbox, text, number: type only
-         */
-        TagFormat: {
-            /**
-             * Type
-             * @default checkbox
-             * @enum {string}
-             */
-            type: 'checkbox' | 'text' | 'number' | 'select' | 'search' | 'date';
-            /**
-             * Options
-             * @default []
-             */
-            options: string[];
-        };
-        /**
-         * TagMatrixDocLink
-         * @description A document a matrix tag is applied to: the doctag's note is the link's value.
-         */
-        TagMatrixDocLink: {
+        TagDocLink: {
             /** Doc Ext Id */
             doc_ext_id: string;
             /** File Name */
@@ -18175,10 +18150,10 @@ interface components {
             updated_at: string;
         };
         /**
-         * TagMatrixFactLink
-         * @description A fact carrying a matrix tag. A plain link: the fact is relevant to the tag's category.
+         * TagFactLink
+         * @description A fact carrying the tag. A plain link: the fact is relevant to the tag.
          */
-        TagMatrixFactLink: {
+        TagFactLink: {
             /** Fact Ext Id */
             fact_ext_id: string;
             /** Text */
@@ -18191,27 +18166,62 @@ interface components {
              */
             updated_at: string;
         };
-        /** TagMatrixResponse */
-        TagMatrixResponse: {
-            /** Rows */
-            rows?: components['schemas']['TagMatrixRow'][];
-            parent?: components['schemas']['TagResponse'] | null;
-            /** Links Limit */
-            links_limit: number;
+        /**
+         * TagFormat
+         * @description Tag format configuration stored as JSONB.
+         *
+         *     Type-specific fields:
+         *     - select: options (list of choices, can be single or multi-select)
+         *     - search: tag name is the query, chunks include relevance scores
+         *     - checkbox, text, number: type only
+         */
+        TagFormat: {
+            /**
+             * Type
+             * @default checkbox
+             * @enum {string}
+             */
+            type: 'checkbox' | 'text' | 'number' | 'select' | 'search' | 'date';
+            /**
+             * Options
+             * @default []
+             */
+            options: string[];
         };
         /**
-         * TagMatrixRow
-         * @description One tag of the matrix with its evidence. ``docs``/``facts``/``threads`` are capped; the counts are the
-         *     totals.
+         * TagKindSchema
+         * @description A kind's fields in a workspace: the columns of a table of that kind's tags. Each tag holds its own values.
+         *
+         *     ``is_default`` until the workspace sets its own (the kind's built-in fields, whose ids are stable).
          */
-        TagMatrixRow: {
-            tag: components['schemas']['TagResponse'];
+        TagKindSchema: {
+            /**
+             * Kind
+             * @enum {string}
+             */
+            kind: 'label' | 'annotation' | 'search' | 'issue' | 'person' | 'organisation';
+            /** Fields */
+            fields?: components['schemas']['FieldDefinition'][];
+            /**
+             * Is Default
+             * @default false
+             */
+            is_default: boolean;
+            /** Updated At */
+            updated_at?: string | null;
+        };
+        /**
+         * TagLinks
+         * @description A tag's evidence: ``docs``/``facts``/``threads`` newest first, at most the list's ``links_limit`` of each;
+         *     the counts are the totals (a tag with no documents and no facts is a gap).
+         */
+        TagLinks: {
             /** Docs */
-            docs?: components['schemas']['TagMatrixDocLink'][];
+            docs?: components['schemas']['TagDocLink'][];
             /** Facts */
-            facts?: components['schemas']['TagMatrixFactLink'][];
+            facts?: components['schemas']['TagFactLink'][];
             /** Threads */
-            threads?: components['schemas']['TagMatrixThreadLink'][];
+            threads?: components['schemas']['TagThreadLink'][];
             /**
              * Doc Count
              * @default 0
@@ -18228,21 +18238,6 @@ interface components {
              */
             thread_count: number;
         };
-        /**
-         * TagMatrixThreadLink
-         * @description A thread (conversation) carrying a matrix tag.
-         */
-        TagMatrixThreadLink: {
-            /** Conversation Ext Id */
-            conversation_ext_id: string;
-            /** Title */
-            title?: string | null;
-            /**
-             * Updated At
-             * Format: date-time
-             */
-            updated_at: string;
-        };
         /** TagResponse */
         TagResponse: {
             /** External Id */
@@ -18276,12 +18271,11 @@ interface components {
              * @default 0
              */
             convotag_count: number;
-            /** Fields */
-            fields?: components['schemas']['TagField'][];
             /** Field Values */
             field_values?: {
                 [key: string]: unknown;
             };
+            links?: components['schemas']['TagLinks'] | null;
             /** Created By Ext Id */
             created_by_ext_id: string;
             /** Updated By Ext Id */
@@ -18308,6 +18302,21 @@ interface components {
             instruction?: string | null;
             tag_type?: components['schemas']['TagFormat'];
         };
+        /**
+         * TagThreadLink
+         * @description A thread (conversation) carrying the tag.
+         */
+        TagThreadLink: {
+            /** Conversation Ext Id */
+            conversation_ext_id: string;
+            /** Title */
+            title?: string | null;
+            /**
+             * Updated At
+             * Format: date-time
+             */
+            updated_at: string;
+        };
         /**
          * TaskOptions
          * @description Make the conversation an assistant query starts a task: ``POST /v1/assistant/query`` with ``task`` set.
@@ -19062,6 +19071,16 @@ interface components {
              */
             is_identity_verified: boolean;
         };
+        /**
+         * UpdateTagKindRequest
+         * @description The kind's fields, in full and in order: give a field's id to keep it (its type cannot change; its name and
+         *     options can), omit the id to add one. A field left out is removed: the tags' values for it are hidden, and
+         *     come back only with that field (its id), never by adding another of the same name.
+         */
+        UpdateTagKindRequest: {
+            /** Fields */
+            fields: components['schemas']['FieldDefinitionWrite'][];
+        };
         /**
          * UpdateTagRequest
          * @description Partial update. Omitted fields are left unchanged.
@@ -19079,30 +19098,19 @@ interface components {
             tag_type?: components['schemas']['TagFormat'] | null;
             /**
              * Kind
-             * @description New kind. A label can become an issue, person or organisation and back (all presence tags); a format change alone re-derives label/annotation/search.
+             * @description New kind. A label can become an issue, person or organisation and back (all presence tags); a format change alone re-derives label/annotation/search. Issues, people and organisations are flat: a tag becoming one must have no parent and no children.
              */
             kind?: ('label' | 'annotation' | 'search' | 'issue' | 'person' | 'organisation') | null;
-            /**
-             * Kind To Children
-             * @description With kind: also give it to this tag's children whose format allows it (e.g. mark an existing issue list and its issues in one call).
-             * @default false
-             */
-            kind_to_children: boolean;
             /** Shared */
             shared?: boolean | null;
             /**
              * Parent Ext Id
-             * @description Parent tag external ID. Send null to un-nest the tag; omit to leave the parent unchanged.
+             * @description Parent tag external ID (not for issues, people or organisations, which are flat). Send null to un-nest the tag; omit to leave the parent unchanged.
              */
             parent_ext_id?: string | null;
-            /**
-             * Fields
-             * @description The tag's own fields, in full: give a field's id to keep it (its type cannot change), omit the id to add one; fields left out are dropped. Inherited fields are changed on the tag that defines them.
-             */
-            fields?: components['schemas']['FieldDefinitionWrite'][] | null;
             /**
              * Field Values
-             * @description Merged into the current values, keyed by field id or name; null clears a field.
+             * @description Merged into the current values of the kind's fields, keyed by field id or name; null clears one.
              */
             field_values?: {
                 [key: string]: unknown;
@@ -19609,6 +19617,21 @@ interface components {
              * @default []
              */
             muted_users: string[];
+            /**
+             * Muted Workspaces
+             * @default []
+             */
+            muted_workspaces: string[];
+            /**
+             * Followed Workspaces
+             * @default []
+             */
+            followed_workspaces: string[];
+            /**
+             * Followed Threads
+             * @default []
+             */
+            followed_threads: string[];
             email_notifications?: components['schemas']['EmailNotificationSettings'];
             /** Premium Model */
             premium_model?: string | null;
@@ -19688,6 +19711,12 @@ interface components {
             hide_online_status?: boolean | null;
             /** Muted Users */
             muted_users?: string[] | null;
+            /** Muted Workspaces */
+            muted_workspaces?: string[] | null;
+            /** Followed Workspaces */
+            followed_workspaces?: string[] | null;
+            /** Followed Threads */
+            followed_threads?: string[] | null;
             email_notifications?: components['schemas']['EmailNotificationSettingsUpdate'] | null;
             /** Premium Model */
             premium_model?: string | null;
@@ -20094,6 +20123,64 @@ interface components {
             /** Location */
             location?: ('office' | 'home' | 'other') | null;
         };
+        /**
+         * WorkspaceActivityEntry
+         * @description One thing that happened in a workspace that the reader can see.
+         *
+         *     Titles and names are decrypted when the caller's session has the workspace open, and ``None`` otherwise.
+         */
+        WorkspaceActivityEntry: {
+            /** External Id */
+            external_id: string;
+            source: components['schemas']['WorkspaceActivitySource'];
+            /** Kind */
+            kind: string;
+            /** Actor Ext Id */
+            actor_ext_id?: string | null;
+            /** Conversation Ext Id */
+            conversation_ext_id?: string | null;
+            /** Conversation Title */
+            conversation_title?: string | null;
+            /** Message Ext Id */
+            message_ext_id?: string | null;
+            /** Document Ext Id */
+            document_ext_id?: string | null;
+            /** Document Name */
+            document_name?: string | null;
+            /** Version */
+            version?: number | null;
+            /** Workflow Ext Id */
+            workflow_ext_id?: string | null;
+            /** Workflow Name */
+            workflow_name?: string | null;
+            /** Status */
+            status?: string | null;
+            /** Detail */
+            detail?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+        };
+        /**
+         * WorkspaceActivityPage
+         * @description A page of the feed, newest first. Pass ``next_cursor`` back as ``cursor`` for the next one (None: the end).
+         */
+        WorkspaceActivityPage: {
+            /** Items */
+            items: components['schemas']['WorkspaceActivityEntry'][];
+            /** Next Cursor */
+            next_cursor?: string | null;
+        };
+        /**
+         * WorkspaceActivitySource
+         * @description Where a feed entry comes from.
+         * @enum {string}
+         */
+        WorkspaceActivitySource: 'thread' | 'message' | 'document' | 'workflow';
         /** WorkspaceCreateRequest */
         WorkspaceCreateRequest: {
             /** Name */
@@ -22627,6 +22714,41 @@ interface operations {
             };
         };
     };
+    get_workspace_activity: {
+        parameters: {
+            query?: {
+                /** @description ``next_cursor`` of the previous page */
+                cursor?: string | null;
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                workspace_ext_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['WorkspaceActivityPage'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
     request_docx_agent_v1_editor__document_id__mentions_post: {
         parameters: {
             query?: never;
@@ -24867,7 +24989,18 @@ interface operations {
     };
     list_tags: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Only tags of this kind (e.g. every issue) */
+                kind?: ('label' | 'annotation' | 'search' | 'issue' | 'person' | 'organisation') | null;
+                /** @description Only this tag's children (a label hierarchy) */
+                parent?: string | null;
+                /** @description Only these tags, in this order (repeat the parameter) */
+                ids?: string[] | null;
+                /** @description links: each tag's documents (with the doctag's note), facts and threads, and their counts */
+                include?: 'links'[] | null;
+                /** @description With include=links: most documents, facts and threads per tag (newest first) */
+                links_limit?: number;
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -24883,20 +25016,53 @@ interface operations {
                     'application/json': components['schemas']['TagResponse'][];
                 };
             };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
         };
     };
-    get_tag_matrix: {
+    create_tag: {
         parameters: {
-            query?: {
-                /** @description Rows are this tag's children, oldest first */
-                parent_ext_id?: string | null;
-                /** @description Rows are these tags, in this order (repeatable) */
-                tag_ext_id?: string[] | null;
-                /** @description Rows are every tag of this kind, oldest first */
-                kind?: ('label' | 'annotation' | 'search' | 'issue' | 'person' | 'organisation') | null;
-                /** @description Most documents and facts per row */
-                links_limit?: number;
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['CreateTagRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['TagResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
             };
+        };
+    };
+    list_tag_kinds: {
+        parameters: {
+            query?: never;
             header?: never;
             path?: never;
             cookie?: never;
@@ -24909,7 +25075,29 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['TagMatrixResponse'];
+                    'application/json': components['schemas']['TagKindSchema'][];
+                };
+            };
+        };
+    };
+    get_tag_kind: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                kind: 'label' | 'annotation' | 'search' | 'issue' | 'person' | 'organisation';
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['TagKindSchema'];
                 };
             };
             /** @description Validation Error */
@@ -24923,29 +25111,28 @@ interface operations {
             };
         };
     };
-    extract_entities: {
+    update_tag_kind: {
         parameters: {
-            query?: {
-                /** @description Configuration to use for the LLM */
-                config_ext_id?: string | null;
-            };
+            query?: never;
             header?: never;
-            path?: never;
+            path: {
+                kind: 'label' | 'annotation' | 'search' | 'issue' | 'person' | 'organisation';
+            };
             cookie?: never;
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['ExtractEntitiesRequest'];
+                'application/json': components['schemas']['UpdateTagKindRequest'];
             };
         };
         responses: {
             /** @description Successful Response */
-            202: {
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['ExtractEntitiesResponse'];
+                    'application/json': components['schemas']['TagKindSchema'];
                 };
             };
             /** @description Validation Error */
@@ -24959,26 +25146,29 @@ interface operations {
             };
         };
     };
-    create_tag: {
+    extract_entities: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Configuration to use for the LLM */
+                config_ext_id?: string | null;
+            };
             header?: never;
             path?: never;
             cookie?: never;
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['CreateTagRequest'];
+                'application/json': components['schemas']['ExtractEntitiesRequest'];
             };
         };
         responses: {
             /** @description Successful Response */
-            201: {
+            202: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['TagResponse'];
+                    'application/json': components['schemas']['ExtractEntitiesResponse'];
                 };
             };
             /** @description Validation Error */
@@ -30541,28 +30731,6 @@ interface operations {
             };
         };
     };
-    rotation_credentials_v1_mail_native_rotation_credentials_get: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Successful Response */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': {
-                        [key: string]: string;
-                    };
-                };
-            };
-        };
-    };
     save_draft_v1_mail_accounts__account_id__drafts_post: {
         parameters: {
             query?: never;