@vibexp/api-client 0.79.0 → 0.81.0

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

@@ -4664,6 +4664,39 @@ export type AdminUserListItem = {
      * Number of teams the user belongs to.
      */
     team_count: number;
+    /**
+     * Number of projects the user created.
+     */
+    project_count: number;
+    resource_counts: AdminResourceCounts;
+    /**
+     * 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;
+};
+/**
+ * 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.
+ *
+ */
+export type AdminResourceCounts = {
+    prompts: number;
+    memories: number;
+    artifacts: number;
+    blueprints: number;
+    agents: number;
+    feeds: number;
+    feed_items: number;
+    comments: number;
+    attachments: number;
+    /**
+     * Sum of the nine per-type counts.
+     */
+    total: number;
 };
 /**
  * A page of the instance-wide user listing, newest first.
@@ -5138,6 +5171,145 @@ export type AdminProjectDetail = {
     created_at: string;
     updated_at: string;
 };
+/**
+ * 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.
+ *
+ */
+export type AdminUserProjectResourceCounts = {
+    project_id: string;
+    project_name: string;
+    counts: AdminProjectResourceCounts;
+};
+/**
+ * How many resources the user authored in one team, with the per-project breakdown.
+ */
+export type AdminUserTeamResourceCounts = {
+    team_id: string;
+    team_name: string;
+    /**
+     * 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: AdminResourceCounts;
+    /**
+     * Per-project counts, ordered by project name.
+     */
+    projects: Array<AdminUserProjectResourceCounts>;
+};
+/**
+ * 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.
+ *
+ */
+export type AdminUserInsights = {
+    user_id: string;
+    totals: AdminResourceCounts;
+    /**
+     * Teams the user authored at least one resource in, ordered by team name.
+     */
+    teams: Array<AdminUserTeamResourceCounts>;
+};
+/**
+ * How many resources of each type the user created within one time bucket.
+ */
+export type AdminUserCreationPoint = {
+    /**
+     * Start of the bucket, in UTC.
+     */
+    bucket: string;
+    prompts: number;
+    memories: number;
+    artifacts: number;
+    blueprints: number;
+    agents: number;
+    feeds: number;
+    feed_items: number;
+    comments: number;
+    attachments: number;
+};
+/**
+ * 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.
+ *
+ */
+export type AdminUserResourceCreationMetrics = {
+    /**
+     * Inclusive start of the range actually used, snapped DOWN to the start of
+     * its bucket (same rule as AdminTimeseriesResponse.from).
+     *
+     */
+    from: string;
+    /**
+     * Exclusive end of the range actually used (after defaulting); not snapped.
+     */
+    to: string;
+    /**
+     * Bucket size actually used.
+     */
+    granularity: 'day' | 'week' | 'month';
+    /**
+     * One point per bucket, ascending by bucket.
+     */
+    series: Array<AdminUserCreationPoint>;
+};
+/**
+ * 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.
+ *
+ */
+export type AdminUserTimelineEvent = {
+    resource_type: 'prompt' | 'memory' | 'artifact' | 'blueprint' | 'agent' | 'feed' | 'feed_item' | 'comment' | 'attachment';
+    action: 'created' | 'updated';
+    team_id: string;
+    team_name: string;
+    /**
+     * Null for team-scoped resources and for feed items posted without a project.
+     */
+    project_id: string | null;
+    project_name: string | null;
+    /**
+     * First 8 characters of the resource id.
+     */
+    resource_short_id: string;
+    occurred_at: string;
+};
+/**
+ * One page of a user's resource timeline, newest first.
+ */
+export type AdminUserTimelinePage = {
+    items: Array<AdminUserTimelineEvent>;
+    /**
+     * Opaque cursor for the next page; null on the last page.
+     */
+    next_cursor: string | null;
+};
+/**
+ * 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`.
+ *
+ */
+export type AdminUserNotificationPreferences = {
+    email_notification: EmailNotificationPreferences;
+    notifications: NotificationPreferences;
+    /**
+     * When the user last saved their preferences; null when defaults are returned.
+     */
+    updated_at: string | null;
+    /**
+     * True when the user has no stored preferences and the defaults are shown.
+     */
+    is_default: boolean;
+};
 export type ProjectResponse = Project & {
     /**
      * Whether the project's git URL matches a repository accessible via the team's GitHub App installation
@@ -5257,6 +5429,33 @@ export type ActivityEntityTypesEnvelope = {
     message: string;
     data: Array<string>;
 };
+export type EmailNotificationPreferences = {
+    /**
+     * Receive platform announcement emails
+     */
+    platform_announcement: boolean;
+    /**
+     * Receive account security emails
+     */
+    account_security: boolean;
+    /**
+     * Receive new feature emails
+     */
+    new_feature: boolean;
+    /**
+     * Receive marketing and promotional emails
+     */
+    marketing_promotional: boolean;
+};
+export type NotificationPreferences = {
+    channels: NotificationChannelPreferences;
+    /**
+     * Per-type delivery preferences keyed by notification type (e.g. "feed.item.created", "feed.reply.created")
+     */
+    types: {
+        [key: string]: NotificationTypePreference;
+    };
+};
 export type PreferencesResponse = {
     preferences: Preferences;
     /**
@@ -5492,24 +5691,6 @@ export type TeamTopAccessedResourcesData = {
     range: '7d' | '14d' | '30d' | '60d' | '90d' | '180d';
     items: Array<TopAccessedResourceItem>;
 };
-export type EmailNotificationPreferences = {
-    /**
-     * Receive platform announcement emails
-     */
-    platform_announcement: boolean;
-    /**
-     * Receive account security emails
-     */
-    account_security: boolean;
-    /**
-     * Receive new feature emails
-     */
-    new_feature: boolean;
-    /**
-     * Receive marketing and promotional emails
-     */
-    marketing_promotional: boolean;
-};
 export type NotificationChannelPreferences = {
     /**
      * Enable in-app notifications globally
@@ -5530,15 +5711,6 @@ export type NotificationTypePreference = {
      */
     email: 'instant' | 'digest' | 'none';
 };
-export type NotificationPreferences = {
-    channels: NotificationChannelPreferences;
-    /**
-     * Per-type delivery preferences keyed by notification type (e.g. "feed.item.created", "feed.reply.created")
-     */
-    types: {
-        [key: string]: NotificationTypePreference;
-    };
-};
 export type Preferences = {
     email_notification: EmailNotificationPreferences;
     notifications: NotificationPreferences;
@@ -11574,10 +11746,121 @@ export type ListAdminUsersData = {
          * Narrow to accounts in this lifecycle state.
          */
         status?: 'active' | 'suspended';
+        /**
+         * Only users with at least this many teams the user belongs to (inclusive).
+         */
+        team_count_min?: number;
+        /**
+         * Only users with at most this many teams the user belongs to (inclusive).
+         */
+        team_count_max?: number;
+        /**
+         * Only users with at least this many projects the user created (inclusive).
+         */
+        project_count_min?: number;
+        /**
+         * Only users with at most this many projects the user created (inclusive).
+         */
+        project_count_max?: number;
+        /**
+         * Only users with at least this many prompts the user authored (inclusive).
+         */
+        prompt_count_min?: number;
+        /**
+         * Only users with at most this many prompts the user authored (inclusive).
+         */
+        prompt_count_max?: number;
+        /**
+         * Only users with at least this many memories the user authored (inclusive).
+         */
+        memory_count_min?: number;
+        /**
+         * Only users with at most this many memories the user authored (inclusive).
+         */
+        memory_count_max?: number;
+        /**
+         * Only users with at least this many artifacts the user authored (inclusive).
+         */
+        artifact_count_min?: number;
+        /**
+         * Only users with at most this many artifacts the user authored (inclusive).
+         */
+        artifact_count_max?: number;
+        /**
+         * Only users with at least this many blueprints the user authored (inclusive).
+         */
+        blueprint_count_min?: number;
+        /**
+         * Only users with at most this many blueprints the user authored (inclusive).
+         */
+        blueprint_count_max?: number;
+        /**
+         * Only users with at least this many agents the user created (inclusive).
+         */
+        agent_count_min?: number;
+        /**
+         * Only users with at most this many agents the user created (inclusive).
+         */
+        agent_count_max?: number;
+        /**
+         * Only users with at least this many feeds the user created (inclusive).
+         */
+        feed_count_min?: number;
+        /**
+         * Only users with at most this many feeds the user created (inclusive).
+         */
+        feed_count_max?: number;
+        /**
+         * Only users with at least this many feed items the user posted (inclusive).
+         */
+        feed_item_count_min?: number;
+        /**
+         * Only users with at most this many feed items the user posted (inclusive).
+         */
+        feed_item_count_max?: number;
+        /**
+         * Only users with at least this many comments the user wrote (inclusive).
+         */
+        comment_count_min?: number;
+        /**
+         * Only users with at most this many comments the user wrote (inclusive).
+         */
+        comment_count_max?: number;
+        /**
+         * Only users with at least this many attachments the user uploaded (inclusive).
+         */
+        attachment_count_min?: number;
+        /**
+         * Only users with at most this many attachments the user uploaded (inclusive).
+         */
+        attachment_count_max?: number;
+        /**
+         * 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;
+        /**
+         * 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;
+        /**
+         * 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;
+        /**
+         * 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;
         /**
          * 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';
+        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';
         /**
          * Sort direction.
          */
@@ -11587,7 +11870,7 @@ export type ListAdminUsersData = {
 };
 export type ListAdminUsersErrors = {
     /**
-     * Bad request — a query parameter is malformed or outside its enum
+     * 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: ErrorResponse;
     /**
@@ -12062,6 +12345,162 @@ export type GetAdminProjectResponses = {
     200: AdminProjectDetail;
 };
 export type GetAdminProjectResponse = GetAdminProjectResponses[keyof GetAdminProjectResponses];
+export type GetAdminUserInsightsData = {
+    body?: never;
+    path: {
+        /**
+         * User id (UUID)
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/api/v1/admin/users/{id}/insights';
+};
+export type GetAdminUserInsightsErrors = {
+    /**
+     * Bad request — malformed user id
+     */
+    400: ErrorResponse;
+    /**
+     * Not found — unknown user id, or the caller is not an instance admin
+     */
+    404: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type GetAdminUserInsightsError = GetAdminUserInsightsErrors[keyof GetAdminUserInsightsErrors];
+export type GetAdminUserInsightsResponses = {
+    /**
+     * The user's per-type resource counts
+     */
+    200: AdminUserInsights;
+};
+export type GetAdminUserInsightsResponse = GetAdminUserInsightsResponses[keyof GetAdminUserInsightsResponses];
+export type GetAdminUserResourceCreationMetricsData = {
+    body?: never;
+    path: {
+        /**
+         * User id (UUID)
+         */
+        id: string;
+    };
+    query?: {
+        /**
+         * Inclusive start of the range. Defaults to 30 days before `to`.
+         */
+        from?: string;
+        /**
+         * Exclusive end of the range. Defaults to now.
+         */
+        to?: string;
+        /**
+         * Bucket size.
+         */
+        granularity?: 'day' | 'week' | 'month';
+    };
+    url: '/api/v1/admin/users/{id}/resource-creation-metrics';
+};
+export type GetAdminUserResourceCreationMetricsErrors = {
+    /**
+     * Bad request — malformed user id, `to` is not after `from`, the range
+     * exceeds the maximum span, or `granularity` is outside its enum
+     *
+     */
+    400: ErrorResponse;
+    /**
+     * Not found — unknown user id, or the caller is not an instance admin
+     */
+    404: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type GetAdminUserResourceCreationMetricsError = GetAdminUserResourceCreationMetricsErrors[keyof GetAdminUserResourceCreationMetricsErrors];
+export type GetAdminUserResourceCreationMetricsResponses = {
+    /**
+     * Bucketed creation counts per type
+     */
+    200: AdminUserResourceCreationMetrics;
+};
+export type GetAdminUserResourceCreationMetricsResponse = GetAdminUserResourceCreationMetricsResponses[keyof GetAdminUserResourceCreationMetricsResponses];
+export type GetAdminUserTimelineData = {
+    body?: never;
+    path: {
+        /**
+         * User id (UUID)
+         */
+        id: string;
+    };
+    query?: {
+        /**
+         * Opaque cursor from a previous page's `next_cursor`.
+         */
+        cursor?: string;
+        /**
+         * Page size.
+         */
+        limit?: number;
+    };
+    url: '/api/v1/admin/users/{id}/timeline';
+};
+export type GetAdminUserTimelineErrors = {
+    /**
+     * Bad request — malformed user id, malformed cursor, or `limit` out of range
+     */
+    400: ErrorResponse;
+    /**
+     * Not found — unknown user id, or the caller is not an instance admin
+     */
+    404: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type GetAdminUserTimelineError = GetAdminUserTimelineErrors[keyof GetAdminUserTimelineErrors];
+export type GetAdminUserTimelineResponses = {
+    /**
+     * One page of timeline events, newest first
+     */
+    200: AdminUserTimelinePage;
+};
+export type GetAdminUserTimelineResponse = GetAdminUserTimelineResponses[keyof GetAdminUserTimelineResponses];
+export type GetAdminUserNotificationPreferencesData = {
+    body?: never;
+    path: {
+        /**
+         * User id (UUID)
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/api/v1/admin/users/{id}/notification-preferences';
+};
+export type GetAdminUserNotificationPreferencesErrors = {
+    /**
+     * Bad request — malformed user id
+     */
+    400: ErrorResponse;
+    /**
+     * Not found — unknown user id, or the caller is not an instance admin
+     */
+    404: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type GetAdminUserNotificationPreferencesError = GetAdminUserNotificationPreferencesErrors[keyof GetAdminUserNotificationPreferencesErrors];
+export type GetAdminUserNotificationPreferencesResponses = {
+    /**
+     * The user's notification preferences
+     */
+    200: AdminUserNotificationPreferences;
+};
+export type GetAdminUserNotificationPreferencesResponse = GetAdminUserNotificationPreferencesResponses[keyof GetAdminUserNotificationPreferencesResponses];
 export type ListCommentsData = {
     body?: never;
     path: {