@vibexp/api-client 0.16.0 → 0.17.0

package/dist/schema.d.ts

@@ -2380,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;
@@ -2721,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;
@@ -6773,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"];
@@ -7793,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
@@ -16606,7 +16836,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["InvitationResponse"][];
+                    "application/json": components["schemas"]["InvitationResponseList"];
                 };
             };
             /** @description Unauthorized */
@@ -16669,7 +16899,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["InvitationResponse"][];
+                    "application/json": components["schemas"]["InvitationResponseList"];
                 };
             };
             /** @description Invalid request body, validation error, more than 50 emails, or invalid role */
@@ -17666,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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibexp/api-client",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Typed VibeXP API client generated from the OpenAPI spec (openapi-fetch main entrypoint, axios SDK at ./axios)",
   "license": "MIT",
   "repository": {