@vibexp/api-client 0.80.0 → 0.82.0

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

@@ -5171,6 +5171,230 @@ 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;
+};
+/**
+ * Resource accesses by the user per bucket and source, across every team
+ * (GET /api/v1/admin/users/{id}/resource-access-metrics). Every bucket in the
+ * range is present with an explicit 0 for each source that appears.
+ *
+ */
+export type AdminUserAccessMetrics = {
+    /**
+     * 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, source), ascending by bucket then source.
+     */
+    access_by_source: Array<AdminSourcePoint>;
+    /**
+     * Oldest access event still retained (now minus
+     * `retention.access_event_days`); buckets before it read as zeros.
+     *
+     */
+    earliest_retained_at: string;
+};
+/**
+ * One opaque most-accessed resource: its type, where it lives and how often
+ * the user accessed it. Deliberately carries no title, slug or content — only
+ * the first 8 characters of the resource id. The identity fields share their
+ * names with AdminUserTimelineEvent.
+ *
+ */
+export type AdminTopAccessedResource = {
+    resource_type: 'prompt' | 'artifact' | 'blueprint' | 'memory' | 'project' | 'agent';
+    /**
+     * First 8 characters of the resource id.
+     */
+    resource_short_id: string;
+    team_id: string;
+    team_name: string;
+    /**
+     * The resource's project (for a `project` row, the project itself). Null
+     * for agents and for deleted resources.
+     *
+     */
+    project_id: string | null;
+    project_name: string | null;
+    /**
+     * True when the resource no longer exists (access events outlive their resource until pruned).
+     */
+    resource_deleted: boolean;
+    access_count: number;
+};
+/**
+ * The resources a user accessed most in a range
+ * (GET /api/v1/admin/users/{id}/top-accessed-resources).
+ *
+ */
+export type AdminTopAccessedResourcesResponse = {
+    /**
+     * Inclusive start of the range actually used (after defaulting); not snapped.
+     */
+    from: string;
+    /**
+     * Exclusive end of the range actually used (after defaulting).
+     */
+    to: string;
+    /**
+     * Most accessed first; ties broken by resource id.
+     */
+    items: Array<AdminTopAccessedResource>;
+    /**
+     * Oldest access event still retained (now minus
+     * `retention.access_event_days`); accesses before it are not counted.
+     *
+     */
+    earliest_retained_at: string;
+};
 export type ProjectResponse = Project & {
     /**
      * Whether the project's git URL matches a repository accessible via the team's GitHub App installation
@@ -5290,6 +5514,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;
     /**
@@ -5525,24 +5776,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
@@ -5563,15 +5796,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;
@@ -12206,6 +12430,258 @@ 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 GetAdminUserResourceAccessMetricsData = {
+    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-access-metrics';
+};
+export type GetAdminUserResourceAccessMetricsErrors = {
+    /**
+     * 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 GetAdminUserResourceAccessMetricsError = GetAdminUserResourceAccessMetricsErrors[keyof GetAdminUserResourceAccessMetricsErrors];
+export type GetAdminUserResourceAccessMetricsResponses = {
+    /**
+     * Bucketed access counts per source
+     */
+    200: AdminUserAccessMetrics;
+};
+export type GetAdminUserResourceAccessMetricsResponse = GetAdminUserResourceAccessMetricsResponses[keyof GetAdminUserResourceAccessMetricsResponses];
+export type GetAdminUserTopAccessedResourcesData = {
+    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;
+        /**
+         * Maximum number of rows.
+         */
+        limit?: number;
+    };
+    url: '/api/v1/admin/users/{id}/top-accessed-resources';
+};
+export type GetAdminUserTopAccessedResourcesErrors = {
+    /**
+     * Bad request — malformed user id, `to` is not after `from`, the range
+     * exceeds the maximum span, or `limit` is 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 GetAdminUserTopAccessedResourcesError = GetAdminUserTopAccessedResourcesErrors[keyof GetAdminUserTopAccessedResourcesErrors];
+export type GetAdminUserTopAccessedResourcesResponses = {
+    /**
+     * The most-accessed resources, most accessed first
+     */
+    200: AdminTopAccessedResourcesResponse;
+};
+export type GetAdminUserTopAccessedResourcesResponse = GetAdminUserTopAccessedResourcesResponses[keyof GetAdminUserTopAccessedResourcesResponses];
+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: {