@vibexp/api-client 0.79.0 → 0.81.0

package/dist/schema.d.ts

@@ -2506,7 +2506,8 @@ export interface paths {
         /**
          * List instance users
          * @description Returns a paginated, instance-wide listing of users with each user's team
-         *     count. Supports case-insensitive search, typed filters, and allowlisted
+         *     and project counts, per-type authored-resource counts and the time of their
+         *     most recent resource. Supports case-insensitive search, typed filters, and allowlisted
          *     sorting; filters combine with AND and the pagination envelope reflects the
          *     filtered set. Instance-admin only; non-admin and unauthenticated requests
          *     receive 404.
@@ -2805,6 +2806,123 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/admin/users/{id}/insights": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a user's resource counts
+         * @description Returns how many resources of each of the nine counted types (prompts,
+         *     memories, artifacts, blueprints, agents, feeds, feed items, comments,
+         *     attachments) the user authored: instance-wide totals, per team, and per
+         *     project for the four project-scoped types. Counts only — no titles, slugs or
+         *     content.
+         *
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404, as
+         *     does an unknown user id.
+         */
+        get: operations["getAdminUserInsights"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/admin/users/{id}/resource-creation-metrics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a user's resource creation series
+         * @description Returns how many resources of each type the user created per bucket over a
+         *     time range. Omitting the parameters yields the last 30 days at `day`
+         *     granularity, and the range rules match getAdminDashboardTimeseries. Every
+         *     bucket is present with an explicit 0 for every type.
+         *
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404, as
+         *     does an unknown user id.
+         */
+        get: operations["getAdminUserResourceCreationMetrics"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/admin/users/{id}/timeline": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a user's resource timeline
+         * @description Returns an opaque, newest-first timeline of the resources the user created
+         *     or updated: resource type, action, team, project and the first 8 characters
+         *     of the resource id — never a title, slug or content. Cursor-paginated: pass
+         *     the previous page's `next_cursor` to continue.
+         *
+         *     `updated` events are APPROXIMATE, by construction of the data:
+         *
+         *     - Only the latest `updated_at` is stored, so a resource edited many times
+         *       appears as ONE `updated` event, at its latest edit.
+         *     - There is no `updated_by` column. The event means "a resource authored by
+         *       this user was last modified", not "this user edited it" — a teammate's
+         *       edit, or a system write that bumps `updated_at` (for example a blueprint
+         *       GitHub re-sync or a team-wide artifact type rename), shows up here too.
+         *     - An update is only reported when `updated_at` is more than one second after
+         *       `created_at`, so a never-edited resource produces no `updated` event.
+         *     - Agents, feed items and attachments only ever produce `created` events.
+         *
+         *     Deleted resources leave no trace (resources are hard-deleted).
+         *
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404, as
+         *     does an unknown user id.
+         */
+        get: operations["getAdminUserTimeline"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/admin/users/{id}/notification-preferences": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a user's notification preferences
+         * @description Returns the user's notification preferences, read-only. A user who has never
+         *     saved preferences gets the defaults with `is_default: true`.
+         *
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404, as
+         *     does an unknown user id.
+         */
+        get: operations["getAdminUserNotificationPreferences"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/{team_id}/comments": {
         parameters: {
             query?: never;
@@ -10300,6 +10418,78 @@ export interface components {
              * @example 3
              */
             team_count: number;
+            /**
+             * Format: int64
+             * @description Number of projects the user created.
+             * @example 2
+             */
+            project_count: number;
+            resource_counts: components["schemas"]["AdminResourceCounts"];
+            /**
+             * Format: date-time
+             * @description When the user's most recent resource (any of the nine types counted in
+             *     resource_counts) was created; null for a user who has authored none.
+             */
+            last_resource_created_at?: string | null;
+        };
+        /**
+         * @description How many resources of each type a user authored, counted by the author
+         *     column of each table (feeds by creator, feed items by poster). Every row
+         *     counts regardless of its status or archive state. `total` is the sum of the
+         *     nine types.
+         */
+        AdminResourceCounts: {
+            /**
+             * Format: int64
+             * @example 12
+             */
+            prompts: number;
+            /**
+             * Format: int64
+             * @example 40
+             */
+            memories: number;
+            /**
+             * Format: int64
+             * @example 5
+             */
+            artifacts: number;
+            /**
+             * Format: int64
+             * @example 3
+             */
+            blueprints: number;
+            /**
+             * Format: int64
+             * @example 1
+             */
+            agents: number;
+            /**
+             * Format: int64
+             * @example 2
+             */
+            feeds: number;
+            /**
+             * Format: int64
+             * @example 18
+             */
+            feed_items: number;
+            /**
+             * Format: int64
+             * @example 7
+             */
+            comments: number;
+            /**
+             * Format: int64
+             * @example 4
+             */
+            attachments: number;
+            /**
+             * Format: int64
+             * @description Sum of the nine per-type counts.
+             * @example 92
+             */
+            total: number;
         };
         /** @description A page of the instance-wide user listing, newest first. */
         AdminUserListResponse: {
@@ -10877,6 +11067,147 @@ export interface components {
             /** Format: date-time */
             updated_at: string;
         };
+        /**
+         * @description How many PROJECT-SCOPED resources the user authored in one project. Only the
+         *     four types with a NOT NULL project_id are attributed to a project; every
+         *     other type is counted at the team level only.
+         */
+        AdminUserProjectResourceCounts: {
+            /** Format: uuid */
+            project_id: string;
+            /** @example Platform */
+            project_name: string;
+            counts: components["schemas"]["AdminProjectResourceCounts"];
+        };
+        /** @description How many resources the user authored in one team, with the per-project breakdown. */
+        AdminUserTeamResourceCounts: {
+            /** Format: uuid */
+            team_id: string;
+            /** @example Acme */
+            team_name: string;
+            /**
+             * @description Whether the user is still a member of the team. A former member's
+             *     authored resources stay in the team and are still counted here.
+             */
+            is_member: boolean;
+            counts: components["schemas"]["AdminResourceCounts"];
+            /** @description Per-project counts, ordered by project name. */
+            projects: components["schemas"]["AdminUserProjectResourceCounts"][];
+        };
+        /**
+         * @description Per-type counts of the resources one user authored, instance-wide, per team
+         *     and per project (GET /api/v1/admin/users/{id}/insights). For every type the
+         *     per-team counts sum to `totals`. An attachment whose author was deleted
+         *     (user_id set to NULL) counts for nobody.
+         */
+        AdminUserInsights: {
+            /** Format: uuid */
+            user_id: string;
+            totals: components["schemas"]["AdminResourceCounts"];
+            /** @description Teams the user authored at least one resource in, ordered by team name. */
+            teams: components["schemas"]["AdminUserTeamResourceCounts"][];
+        };
+        /** @description How many resources of each type the user created within one time bucket. */
+        AdminUserCreationPoint: {
+            /**
+             * Format: date-time
+             * @description Start of the bucket, in UTC.
+             */
+            bucket: string;
+            /** Format: int64 */
+            prompts: number;
+            /** Format: int64 */
+            memories: number;
+            /** Format: int64 */
+            artifacts: number;
+            /** Format: int64 */
+            blueprints: number;
+            /** Format: int64 */
+            agents: number;
+            /** Format: int64 */
+            feeds: number;
+            /** Format: int64 */
+            feed_items: number;
+            /** Format: int64 */
+            comments: number;
+            /** Format: int64 */
+            attachments: number;
+        };
+        /**
+         * @description Resources the user created per bucket, stacked by type
+         *     (GET /api/v1/admin/users/{id}/resource-creation-metrics). Every bucket in
+         *     the range is present with an explicit 0 for every type.
+         */
+        AdminUserResourceCreationMetrics: {
+            /**
+             * Format: date-time
+             * @description Inclusive start of the range actually used, snapped DOWN to the start of
+             *     its bucket (same rule as AdminTimeseriesResponse.from).
+             */
+            from: string;
+            /**
+             * Format: date-time
+             * @description Exclusive end of the range actually used (after defaulting); not snapped.
+             */
+            to: string;
+            /**
+             * @description Bucket size actually used.
+             * @enum {string}
+             */
+            granularity: "day" | "week" | "month";
+            /** @description One point per bucket, ascending by bucket. */
+            series: components["schemas"]["AdminUserCreationPoint"][];
+        };
+        /**
+         * @description One opaque timeline entry: which kind of resource the user created or last
+         *     updated, where, and when. Deliberately carries no title, slug or content —
+         *     only the first 8 characters of the resource id.
+         */
+        AdminUserTimelineEvent: {
+            /** @enum {string} */
+            resource_type: "prompt" | "memory" | "artifact" | "blueprint" | "agent" | "feed" | "feed_item" | "comment" | "attachment";
+            /** @enum {string} */
+            action: "created" | "updated";
+            /** Format: uuid */
+            team_id: string;
+            team_name: string;
+            /**
+             * Format: uuid
+             * @description Null for team-scoped resources and for feed items posted without a project.
+             */
+            project_id: string | null;
+            project_name: string | null;
+            /**
+             * @description First 8 characters of the resource id.
+             * @example 3f2a9c1e
+             */
+            resource_short_id: string;
+            /** Format: date-time */
+            occurred_at: string;
+        };
+        /** @description One page of a user's resource timeline, newest first. */
+        AdminUserTimelinePage: {
+            items: components["schemas"]["AdminUserTimelineEvent"][];
+            /** @description Opaque cursor for the next page; null on the last page. */
+            next_cursor: string | null;
+        };
+        /**
+         * @description A user's notification preferences, read-only
+         *     (GET /api/v1/admin/users/{id}/notification-preferences). When the user has
+         *     never saved preferences, the defaults are returned with `is_default: true`
+         *     and `updated_at: null`.
+         */
+        AdminUserNotificationPreferences: {
+            email_notification: components["schemas"]["EmailNotificationPreferences"];
+            notifications: components["schemas"]["NotificationPreferences"];
+            /**
+             * Format: date-time
+             * @description When the user last saved their preferences; null when defaults are returned.
+             */
+            updated_at: string | null;
+            /** @description True when the user has no stored preferences and the defaults are shown. */
+            is_default: boolean;
+        };
         ProjectResponse: components["schemas"]["Project"] & {
             /**
              * @description Whether the project's git URL matches a repository accessible via the team's GitHub App installation
@@ -11016,6 +11347,35 @@ export interface components {
              */
             data: string[];
         };
+        EmailNotificationPreferences: {
+            /**
+             * @description Receive platform announcement emails
+             * @example true
+             */
+            platform_announcement: boolean;
+            /**
+             * @description Receive account security emails
+             * @example true
+             */
+            account_security: boolean;
+            /**
+             * @description Receive new feature emails
+             * @example true
+             */
+            new_feature: boolean;
+            /**
+             * @description Receive marketing and promotional emails
+             * @example false
+             */
+            marketing_promotional: boolean;
+        };
+        NotificationPreferences: {
+            channels: components["schemas"]["NotificationChannelPreferences"];
+            /** @description Per-type delivery preferences keyed by notification type (e.g. "feed.item.created", "feed.reply.created") */
+            types: {
+                [key: string]: components["schemas"]["NotificationTypePreference"];
+            };
+        };
         PreferencesResponse: {
             preferences: components["schemas"]["Preferences"];
             /**
@@ -11325,28 +11685,6 @@ export interface components {
             range: "7d" | "14d" | "30d" | "60d" | "90d" | "180d";
             items: components["schemas"]["TopAccessedResourceItem"][];
         };
-        EmailNotificationPreferences: {
-            /**
-             * @description Receive platform announcement emails
-             * @example true
-             */
-            platform_announcement: boolean;
-            /**
-             * @description Receive account security emails
-             * @example true
-             */
-            account_security: boolean;
-            /**
-             * @description Receive new feature emails
-             * @example true
-             */
-            new_feature: boolean;
-            /**
-             * @description Receive marketing and promotional emails
-             * @example false
-             */
-            marketing_promotional: boolean;
-        };
         NotificationChannelPreferences: {
             /**
              * @description Enable in-app notifications globally
@@ -11372,13 +11710,6 @@ export interface components {
              */
             email: "instant" | "digest" | "none";
         };
-        NotificationPreferences: {
-            channels: components["schemas"]["NotificationChannelPreferences"];
-            /** @description Per-type delivery preferences keyed by notification type (e.g. "feed.item.created", "feed.reply.created") */
-            types: {
-                [key: string]: components["schemas"]["NotificationTypePreference"];
-            };
-        };
         Preferences: {
             email_notification: components["schemas"]["EmailNotificationPreferences"];
             notifications: components["schemas"]["NotificationPreferences"];
@@ -20080,8 +20411,70 @@ export interface operations {
                 created_to?: string;
                 /** @description Narrow to accounts in this lifecycle state. */
                 status?: "active" | "suspended";
-                /** @description Column to sort by. Ties are always broken by user id so paging is stable. */
-                sort_by?: "created_at" | "email" | "name" | "team_count";
+                /** @description Only users with at least this many teams the user belongs to (inclusive). */
+                team_count_min?: number;
+                /** @description Only users with at most this many teams the user belongs to (inclusive). */
+                team_count_max?: number;
+                /** @description Only users with at least this many projects the user created (inclusive). */
+                project_count_min?: number;
+                /** @description Only users with at most this many projects the user created (inclusive). */
+                project_count_max?: number;
+                /** @description Only users with at least this many prompts the user authored (inclusive). */
+                prompt_count_min?: number;
+                /** @description Only users with at most this many prompts the user authored (inclusive). */
+                prompt_count_max?: number;
+                /** @description Only users with at least this many memories the user authored (inclusive). */
+                memory_count_min?: number;
+                /** @description Only users with at most this many memories the user authored (inclusive). */
+                memory_count_max?: number;
+                /** @description Only users with at least this many artifacts the user authored (inclusive). */
+                artifact_count_min?: number;
+                /** @description Only users with at most this many artifacts the user authored (inclusive). */
+                artifact_count_max?: number;
+                /** @description Only users with at least this many blueprints the user authored (inclusive). */
+                blueprint_count_min?: number;
+                /** @description Only users with at most this many blueprints the user authored (inclusive). */
+                blueprint_count_max?: number;
+                /** @description Only users with at least this many agents the user created (inclusive). */
+                agent_count_min?: number;
+                /** @description Only users with at most this many agents the user created (inclusive). */
+                agent_count_max?: number;
+                /** @description Only users with at least this many feeds the user created (inclusive). */
+                feed_count_min?: number;
+                /** @description Only users with at most this many feeds the user created (inclusive). */
+                feed_count_max?: number;
+                /** @description Only users with at least this many feed items the user posted (inclusive). */
+                feed_item_count_min?: number;
+                /** @description Only users with at most this many feed items the user posted (inclusive). */
+                feed_item_count_max?: number;
+                /** @description Only users with at least this many comments the user wrote (inclusive). */
+                comment_count_min?: number;
+                /** @description Only users with at most this many comments the user wrote (inclusive). */
+                comment_count_max?: number;
+                /** @description Only users with at least this many attachments the user uploaded (inclusive). */
+                attachment_count_min?: number;
+                /** @description Only users with at most this many attachments the user uploaded (inclusive). */
+                attachment_count_max?: number;
+                /** @description Only users with at least this many resources the user authored across all nine types (the sum of resource_counts) (inclusive). */
+                total_resource_count_min?: number;
+                /** @description Only users with at most this many resources the user authored across all nine types (the sum of resource_counts) (inclusive). */
+                total_resource_count_max?: number;
+                /**
+                 * @description Only users whose most recent resource (any of the nine types) was created
+                 *     at or after this instant (inclusive). Users with no resources never match.
+                 */
+                last_resource_created_from?: string;
+                /**
+                 * @description Only users whose most recent resource (any of the nine types) was created
+                 *     at or before this instant (inclusive). Users with no resources never match.
+                 */
+                last_resource_created_to?: string;
+                /**
+                 * @description Column to sort by. Ties are always broken by user id so paging is stable.
+                 *     Sorting by last_resource_created_at places users with no resources last
+                 *     in both directions.
+                 */
+                sort_by?: "created_at" | "email" | "name" | "team_count" | "project_count" | "prompt_count" | "memory_count" | "artifact_count" | "blueprint_count" | "agent_count" | "feed_count" | "feed_item_count" | "comment_count" | "attachment_count" | "total_resource_count" | "last_resource_created_at";
                 /** @description Sort direction. */
                 sort_order?: "asc" | "desc";
             };
@@ -20100,7 +20493,7 @@ export interface operations {
                     "application/json": components["schemas"]["AdminUserListResponse"];
                 };
             };
-            /** @description Bad request — a query parameter is malformed or outside its enum */
+            /** @description Bad request — a query parameter is malformed or outside its enum, a count bound is negative, or a min/max or from/to pair is inverted */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -20768,6 +21161,221 @@ export interface operations {
             };
         };
     };
+    getAdminUserInsights: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description User id (UUID) */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The user's per-type resource counts */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminUserInsights"];
+                };
+            };
+            /** @description Bad request — malformed user id */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Not found — unknown user id, or the caller is not an instance admin */
+            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"];
+                };
+            };
+        };
+    };
+    getAdminUserResourceCreationMetrics: {
+        parameters: {
+            query?: {
+                /** @description Inclusive start of the range. Defaults to 30 days before `to`. */
+                from?: string;
+                /** @description Exclusive end of the range. Defaults to now. */
+                to?: string;
+                /** @description Bucket size. */
+                granularity?: "day" | "week" | "month";
+            };
+            header?: never;
+            path: {
+                /** @description User id (UUID) */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Bucketed creation counts per type */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminUserResourceCreationMetrics"];
+                };
+            };
+            /**
+             * @description Bad request — malformed user id, `to` is not after `from`, the range
+             *     exceeds the maximum span, or `granularity` is outside its enum
+             */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Not found — unknown user id, or the caller is not an instance admin */
+            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"];
+                };
+            };
+        };
+    };
+    getAdminUserTimeline: {
+        parameters: {
+            query?: {
+                /** @description Opaque cursor from a previous page's `next_cursor`. */
+                cursor?: string;
+                /** @description Page size. */
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                /** @description User id (UUID) */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description One page of timeline events, newest first */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminUserTimelinePage"];
+                };
+            };
+            /** @description Bad request — malformed user id, malformed cursor, or `limit` out of range */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Not found — unknown user id, or the caller is not an instance admin */
+            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"];
+                };
+            };
+        };
+    };
+    getAdminUserNotificationPreferences: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description User id (UUID) */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The user's notification preferences */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminUserNotificationPreferences"];
+                };
+            };
+            /** @description Bad request — malformed user id */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Not found — unknown user id, or the caller is not an instance admin */
+            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"];
+                };
+            };
+        };
+    };
     listComments: {
         parameters: {
             query: {