@vibexp/api-client 0.15.0 → 0.17.0

package/dist/schema.d.ts

@@ -2320,6 +2320,57 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/teams/{id}/members/{userId}/role": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Change a team member's role
+         * @description Changes a member's role between `member` and `admin`.
+         *
+         *     Requires the caller to be an **owner or admin** of the team. The role value
+         *     may only be `member` or `admin` — ownership is never granted this way; use
+         *     the transfer-ownership operation instead. The team owner's role cannot be
+         *     changed by this operation, not even by another admin.
+         */
+        patch: operations["updateTeamMemberRole"];
+        trace?: never;
+    };
+    "/api/v1/teams/{id}/transfer-ownership": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Transfer team ownership
+         * @description Transfers ownership of the team to another member.
+         *
+         *     Requires the caller to be the **owner** of the team; admins cannot transfer
+         *     ownership. The target must already be a member. The target becomes the
+         *     owner and the previous owner becomes an admin, applied in a single
+         *     transaction so the team always has exactly one owner. Personal workspaces
+         *     cannot be transferred.
+         */
+        post: operations["transferTeamOwnership"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/teams/{id}/invitations": {
         parameters: {
             query?: never;
@@ -2329,8 +2380,9 @@ export interface paths {
         };
         /**
          * List team invitations
-         * @description Returns all invitations for the team. The `token`, `team_name` and
-         *     `invited_by` fields are not populated on this listing.
+         * @description Returns all invitations for the team, each with its `token` populated so
+         *     an admin or owner can copy the accept link and share it out of band. The
+         *     `team_name` and `invited_by` fields are not populated on this listing.
          */
         get: operations["listTeamInvitations"];
         put?: never;
@@ -2670,6 +2722,74 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/{team_id}/comments": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List a resource's comments
+         * @description Returns a page of comments on the given resource, newest first. The caller must be a member of the team.
+         */
+        get: operations["listComments"];
+        put?: never;
+        /**
+         * Create a comment
+         * @description Adds a comment on a resource. Any team member may comment; the target resource must exist in the team (404 otherwise).
+         */
+        post: operations["createComment"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/{team_id}/comments/recent": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List recent comment activity
+         * @description Returns the team's most recent comment activity for the homepage card, ordered by latest activity (an edited comment resurfaces). Each entry carries its resource's resolved title and link fields; entries whose resource has been deleted are omitted.
+         */
+        get: operations["listRecentComments"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/{team_id}/comments/{comment_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete a comment
+         * @description Deletes a comment. The author may delete their own; a team admin or owner may delete any comment (403 otherwise).
+         */
+        delete: operations["deleteComment"];
+        options?: never;
+        head?: never;
+        /**
+         * Edit a comment
+         * @description Updates a comment's content. Only the comment's author may edit it; no role can edit another member's comment (403 otherwise).
+         */
+        patch: operations["updateComment"];
+        trace?: never;
+    };
     "/api/v1/{team_id}/embedding-providers": {
         parameters: {
             query?: never;
@@ -6722,6 +6842,8 @@ export interface components {
             created_at?: string;
             invited_by?: components["schemas"]["InviterInfo"];
         };
+        /** @description Bare list of team invitations returned by the list endpoint. */
+        InvitationResponseList: components["schemas"]["InvitationResponse"][];
         /** @description Wrapper response for the get-invitation-by-token endpoint */
         InvitationDetailsResponse: {
             invitation: components["schemas"]["InvitationResponse"];
@@ -7225,7 +7347,7 @@ export interface components {
             message: string;
             data: components["schemas"]["CursorRecentActivitiesResponse"];
         };
-        /** @description A team (workspace) in the system. `role` and `member_count` are computed at read time for the requesting user. */
+        /** @description A team (workspace) in the system. `role`, `permissions` and `member_count` are computed at read time for the requesting user. */
         Team: {
             /**
              * Format: uuid
@@ -7249,10 +7371,21 @@ export interface components {
              */
             is_personal: boolean;
             /**
-             * @description The requesting user's role in this team: owner, admin, or member. Populated at runtime on list and single-team reads; empty string on create responses (not an enum constraint for that reason).
+             * @description The requesting user's role in this team: owner, admin, or member. Populated at runtime on every response that carries a team, including create (where the caller is by definition the owner). Not an enum constraint: older responses may still carry an empty string.
              * @example owner
              */
             role?: string;
+            /**
+             * @description Exactly what `role` permits the requesting user to do in this team, expanded server-side from the role matrix (epic #220). Clients MUST gate their UI on these strings rather than re-deriving them from `role` — the matrix lives on the server and may change without a client release.
+             *     Computed at read time for the requesting user, alongside `role`, and always present (an empty array means the role grants nothing). The values are stable API surface: renaming one is a breaking change, and they are kept byte-identical to the `internal/authz` constants by a drift test. Meanings:
+             *     * `team.update` — change team name, slug or description. * `team.delete` — delete the team (owner only). * `team.transfer` — transfer ownership to another member (owner only). * `member.invite` — invite new members. * `member.remove` — remove members from the team. * `member.role.update` — change a member's role. * `project.create` — create a project in the team. * `project.update` — update any project in the team. * `project.delete` — delete any project in the team. * `resource.create` — create a prompt, memory, artifact, blueprint or agent. * `resource.update.any` — update any resource, including other members'. * `resource.delete.own` — delete a resource the caller created. * `resource.delete.any` — delete a resource created by someone else. * `feed.delete.any` — delete another member's feed post or reply (moderation).
+             * @example [
+             *       "resource.create",
+             *       "resource.update.any",
+             *       "resource.delete.own"
+             *     ]
+             */
+            permissions: ("team.update" | "team.delete" | "team.transfer" | "member.invite" | "member.remove" | "member.role.update" | "project.create" | "project.update" | "project.delete" | "resource.create" | "resource.update.any" | "resource.delete.own" | "resource.delete.any" | "feed.delete.any")[];
             /**
              * @description Number of members in this team. Populated only on list responses; 0 on create and single-team reads.
              * @example 5
@@ -7334,6 +7467,39 @@ export interface components {
              */
             invitation_status?: "pending" | "accepted";
         };
+        /**
+         * @description Request body for changing a team member's role. Only `member` and `admin` are
+         *     accepted: a team has exactly one owner, and ownership moves solely through
+         *     the transfer-ownership operation.
+         */
+        UpdateTeamMemberRoleRequest: {
+            /**
+             * @description The role to assign to the member
+             * @example admin
+             * @enum {string}
+             */
+            role: "member" | "admin";
+        };
+        /** @description The team member after the role change */
+        UpdateTeamMemberRoleResponse: {
+            member: components["schemas"]["TeamMemberDetail"];
+        };
+        /**
+         * @description Request body for transferring team ownership. The target must already be a
+         *     member of the team; they become the owner and the current owner becomes an
+         *     admin, in a single transaction.
+         */
+        TransferTeamOwnershipRequest: {
+            /**
+             * @description User ID of the member who will become the team owner
+             * @example user_01HXYZABC123
+             */
+            new_owner_id: string;
+        };
+        /** @description The team after ownership has been transferred */
+        TransferTeamOwnershipResponse: {
+            team: components["schemas"]["Team"];
+        };
         /** @description Paginated list of team members */
         TeamMembersListResponse: {
             members: components["schemas"]["TeamMemberDetail"][];
@@ -7698,6 +7864,165 @@ export interface components {
              */
             total_count: number;
         };
+        /** @description A team-visible comment on a resource. */
+        Comment: {
+            /**
+             * Format: uuid
+             * @description Unique comment identifier
+             * @example 550e8400-e29b-41d4-a716-446655440000
+             */
+            id: string;
+            /**
+             * Format: uuid
+             * @description Owning team
+             * @example 660e8400-e29b-41d4-a716-446655440001
+             */
+            team_id: string;
+            /**
+             * @description Type of the commented resource (artifact, memory, prompt, or blueprint)
+             * @example artifact
+             */
+            resource_type: string;
+            /**
+             * Format: uuid
+             * @description Identifier of the commented resource
+             * @example 770e8400-e29b-41d4-a716-446655440002
+             */
+            resource_id: string;
+            /**
+             * Format: uuid
+             * @description Author of the comment
+             * @example 880e8400-e29b-41d4-a716-446655440003
+             */
+            user_id: string;
+            /**
+             * @description Comment body (markdown, 1–10,000 characters)
+             * @example These figures are from the v3 API, not v4.
+             */
+            content: string;
+            /**
+             * Format: date-time
+             * @description When the comment was created
+             * @example 2026-07-16T09:00:00Z
+             */
+            created_at: string;
+            /**
+             * Format: date-time
+             * @description When the comment was last edited (equals created_at if never edited)
+             * @example 2026-07-16T09:00:00Z
+             */
+            updated_at: string;
+        };
+        /** @description Request body for creating a comment on a resource. */
+        CreateCommentRequest: {
+            /**
+             * @description Type of the resource being commented on (artifact, memory, prompt, or blueprint)
+             * @example artifact
+             */
+            resource_type: string;
+            /**
+             * Format: uuid
+             * @description Identifier of the resource being commented on
+             * @example 770e8400-e29b-41d4-a716-446655440002
+             */
+            resource_id: string;
+            /**
+             * @description Comment body (markdown, 1–10,000 characters)
+             * @example These figures are from the v3 API, not v4.
+             */
+            content: string;
+        };
+        /** @description Request body for editing a comment's content. */
+        UpdateCommentRequest: {
+            /**
+             * @description New comment body (markdown, 1–10,000 characters)
+             * @example These figures are from the v3 API, not v4 (corrected).
+             */
+            content: string;
+        };
+        /** @description A page of a resource's comments, newest first. */
+        CommentListResponse: {
+            /** @description Comments on the resource, newest first */
+            comments: components["schemas"]["Comment"][];
+            /**
+             * @description Total number of comments on the resource
+             * @example 7
+             */
+            total_count: number;
+            /**
+             * @description Current page number
+             * @example 1
+             */
+            page: number;
+            /**
+             * @description Number of items per page
+             * @example 20
+             */
+            per_page: number;
+            /**
+             * @description Total number of pages
+             * @example 1
+             */
+            total_pages: number;
+        };
+        /** @description A recent comment for the homepage activity card: the comment's latest state plus its resource's resolved title and link fields. No comment body snippet. project_id is present for every resource type; slug is present for artifact/blueprint/prompt and absent for memory. */
+        RecentComment: {
+            /**
+             * Format: uuid
+             * @description Author of the comment
+             * @example 880e8400-e29b-41d4-a716-446655440003
+             */
+            user_id: string;
+            /**
+             * Format: date-time
+             * @description When the comment was created
+             * @example 2026-07-16T09:00:00Z
+             */
+            created_at: string;
+            /**
+             * Format: date-time
+             * @description When the comment was last edited (updated_at > created_at means edited)
+             * @example 2026-07-16T10:00:00Z
+             */
+            updated_at: string;
+            /**
+             * @description Type of the commented resource
+             * @example artifact
+             */
+            resource_type: string;
+            /**
+             * Format: uuid
+             * @description Identifier of the commented resource
+             * @example 770e8400-e29b-41d4-a716-446655440002
+             */
+            resource_id: string;
+            /**
+             * @description Resolved display title of the resource
+             * @example Q3 revenue analysis
+             */
+            resource_title: string;
+            /**
+             * Format: uuid
+             * @description Project the resource belongs to (for building the detail link)
+             * @example 990e8400-e29b-41d4-a716-446655440004
+             */
+            project_id?: string;
+            /**
+             * @description Resource slug for the detail link (absent for memories)
+             * @example q3-revenue-analysis
+             */
+            slug?: string;
+        };
+        /** @description The team's most recent comment activity, latest-activity first. */
+        RecentCommentListResponse: {
+            /** @description Recent comments across the team, most-recently-active first */
+            comments: components["schemas"]["RecentComment"][];
+            /**
+             * @description Number of entries in the list
+             * @example 10
+             */
+            total_count: number;
+        };
         ProjectResponse: components["schemas"]["Project"] & {
             /**
              * @description Whether the project's git URL matches a repository accessible via the team's GitHub App installation
@@ -8388,10 +8713,18 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Authentication successful — redirects browser to frontend home page */
+            /**
+             * @description Redirects the browser to the frontend. On success, to the home page
+             *     (a session cookie is set). When sign-in is denied by the access
+             *     allowlist, to `/auth/callback?error=access_restricted` with no session
+             *     cookie set.
+             */
             302: {
                 headers: {
-                    /** @description Frontend home URL (e.g. https://app.example.com/) */
+                    /**
+                     * @description Frontend URL — the home page on success (e.g. https://app.example.com/),
+                     *     or /auth/callback?error=access_restricted on an allowlist denial.
+                     */
                     Location?: string;
                     /** @description Encrypted session cookie (`vx_session`) containing the identity-provider access token */
                     "Set-Cookie"?: string;
@@ -8488,6 +8821,18 @@ export interface operations {
                     "application/problem+json": components["schemas"]["ErrorResponse"];
                 };
             };
+            /**
+             * @description Sign-in denied by the access allowlist. The response `code` is the
+             *     stable string `access_restricted`.
+             */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
             /** @description Endpoint not available outside development environment */
             404: {
                 headers: {
@@ -16327,25 +16672,40 @@ export interface operations {
             };
         };
     };
-    listTeamInvitations: {
+    updateTeamMemberRole: {
         parameters: {
             query?: never;
             header?: never;
             path: {
                 /** @description Team identifier */
                 id: string;
+                /** @description User ID of the member whose role is changing */
+                userId: string;
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateTeamMemberRoleRequest"];
+            };
+        };
         responses: {
-            /** @description Invitations retrieved successfully */
+            /** @description Role updated successfully */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["InvitationResponse"][];
+                    "application/json": components["schemas"]["UpdateTeamMemberRoleResponse"];
+                };
+            };
+            /** @description Invalid request body or role value */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
                 };
             };
             /** @description Unauthorized */
@@ -16357,8 +16717,8 @@ export interface operations {
                     "application/problem+json": components["schemas"]["ErrorResponse"];
                 };
             };
-            /** @description Payment required — active subscription required */
-            402: {
+            /** @description Forbidden — caller is not an owner or admin of the team, or the target is the team owner */
+            403: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -16366,8 +16726,8 @@ export interface operations {
                     "application/problem+json": components["schemas"]["ErrorResponse"];
                 };
             };
-            /** @description Forbidden — no permission to view this team's invitations */
-            403: {
+            /** @description Team not found, or the target user is not a member of the team */
+            404: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -16386,7 +16746,7 @@ export interface operations {
             };
         };
     };
-    sendTeamInvitations: {
+    transferTeamOwnership: {
         parameters: {
             query?: never;
             header?: never;
@@ -16398,20 +16758,20 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["SendInvitationsRequest"];
+                "application/json": components["schemas"]["TransferTeamOwnershipRequest"];
             };
         };
         responses: {
-            /** @description Invitations created successfully (the `token`, `team_name` and `invited_by` fields are not populated on this response) */
-            201: {
+            /** @description Ownership transferred successfully */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["InvitationResponse"][];
+                    "application/json": components["schemas"]["TransferTeamOwnershipResponse"];
                 };
             };
-            /** @description Invalid request body, validation error, more than 50 emails, or invalid role */
+            /** @description Invalid request body, or the caller is already the target owner */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -16429,8 +16789,8 @@ export interface operations {
                     "application/problem+json": components["schemas"]["ErrorResponse"];
                 };
             };
-            /** @description Payment required — active subscription required */
-            402: {
+            /** @description Forbidden — caller is not the team owner, or the team is a personal workspace */
+            403: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -16438,8 +16798,139 @@ export interface operations {
                     "application/problem+json": components["schemas"]["ErrorResponse"];
                 };
             };
-            /** @description Forbidden — personal workspace (code `upgrade_required`), no permission to invite (code `FORBIDDEN`), no active team subscription, or seat limit exceeded (code `RESOURCE_LIMIT_EXCEEDED` with metadata) */
-            403: {
+            /** @description Team not found, or the target user is not a member of the team */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    listTeamInvitations: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Team identifier */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Invitations retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InvitationResponseList"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Payment required — active subscription required */
+            402: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Forbidden — no permission to view this team's invitations */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    sendTeamInvitations: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Team identifier */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["SendInvitationsRequest"];
+            };
+        };
+        responses: {
+            /** @description Invitations created successfully (the `token`, `team_name` and `invited_by` fields are not populated on this response) */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["InvitationResponseList"];
+                };
+            };
+            /** @description Invalid request body, validation error, more than 50 emails, or invalid role */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Payment required — active subscription required */
+            402: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Forbidden — personal workspace (code `upgrade_required`), no permission to invite (code `FORBIDDEN`), no active team subscription, or seat limit exceeded (code `RESOURCE_LIMIT_EXCEEDED` with metadata) */
+            403: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -17405,6 +17896,350 @@ export interface operations {
             };
         };
     };
+    listComments: {
+        parameters: {
+            query: {
+                /** @description Type of the commented resource (artifact, memory, prompt, or blueprint) */
+                resource_type: string;
+                /** @description Identifier of the commented resource */
+                resource_id: string;
+                /** @description Page number (1-based) */
+                page?: number;
+                /** @description Items per page */
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                /** @description Team identifier */
+                team_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Comments retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommentListResponse"];
+                };
+            };
+            /** @description Invalid resource_type or query parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Caller is not a member of the team */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Failed to list comments */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    createComment: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Team identifier */
+                team_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateCommentRequest"];
+            };
+        };
+        responses: {
+            /** @description Comment created successfully */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Comment"];
+                };
+            };
+            /** @description Invalid resource_type or content */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Caller may not comment in the team */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Target resource not found in the team */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Failed to create comment */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    listRecentComments: {
+        parameters: {
+            query?: {
+                /** @description Maximum number of entries to return */
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                /** @description Team identifier */
+                team_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Recent comments retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RecentCommentListResponse"];
+                };
+            };
+            /** @description Invalid query parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Caller is not a member of the team */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Failed to list recent comments */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    deleteComment: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Team identifier */
+                team_id: string;
+                /** @description Comment identifier */
+                comment_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Comment deleted (no content) */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description comment_id is not a valid UUID */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Caller may not delete this comment */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Comment not found in the team */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Failed to delete comment */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    updateComment: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Team identifier */
+                team_id: string;
+                /** @description Comment identifier */
+                comment_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateCommentRequest"];
+            };
+        };
+        responses: {
+            /** @description Comment updated successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Comment"];
+                };
+            };
+            /** @description Invalid content */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Caller is not the comment's author */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Comment not found in the team */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Failed to update comment */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     listEmbeddingProviders: {
         parameters: {
             query?: never;