@vibexp/api-client 0.81.0 → 0.83.0

package/dist/schema.d.ts

@@ -2602,8 +2602,10 @@ export interface paths {
         };
         /**
          * List instance teams
-         * @description Returns a paginated, instance-wide listing of teams with each team's owner
-         *     and member count. Supports case-insensitive search, typed filters, and
+         * @description Returns a paginated, instance-wide listing of teams with each team's owner,
+         *     member/owner/admin/project counts, per-type resource counts and which
+         *     settings the team has configured itself (instance-level fallback never
+         *     counts as configured). 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.
@@ -2899,6 +2901,67 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/admin/users/{id}/resource-access-metrics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a user's resource access series by source
+         * @description Returns how many times the user accessed (opened) resources per bucket and
+         *     per access source (web, cli, mcp, api), across every team. 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 each source that appears in the range.
+         *
+         *     Access events are TTL-pruned (`retention.access_event_days`), so a range
+         *     reaching back before `earliest_retained_at` reads as zeros there.
+         *
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404, as
+         *     does an unknown user id.
+         */
+        get: operations["getAdminUserResourceAccessMetrics"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/admin/users/{id}/top-accessed-resources": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get the resources a user accessed most
+         * @description Returns the resources the user accessed most often in a time range, across
+         *     every team, ranked by access count (ties broken by resource id). Rows are
+         *     OPAQUE: resource type, team, project and the first 8 characters of the
+         *     resource id — never a title, slug or content. A resource deleted since it
+         *     was accessed is still listed, with `resource_deleted: true` and no project.
+         *
+         *     `from` defaults to 30 days before `to`, and `to` to now. Access events are
+         *     TTL-pruned (`retention.access_event_days`), so accesses before
+         *     `earliest_retained_at` are not counted.
+         *
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404, as
+         *     does an unknown user id.
+         */
+        get: operations["getAdminUserTopAccessedResources"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/admin/users/{id}/notification-preferences": {
         parameters: {
             query?: never;
@@ -10433,10 +10496,11 @@ export interface components {
             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.
+         * @description How many resources of each type belong to the listed row. On a user row
+         *     these are the resources the user authored, counted by the author column of
+         *     each table (feeds by creator, feed items by poster); on a team row they are
+         *     the resources in the team, counted by team_id. Every row counts regardless
+         *     of its status or archive state. `total` is the sum of the nine types.
          */
         AdminResourceCounts: {
             /**
@@ -10609,9 +10673,50 @@ export interface components {
              * @example 8
              */
             member_count: number;
+            /**
+             * Format: int64
+             * @description Number of members holding the owner role. Always 1 by application invariant; any other value signals integrity drift.
+             * @example 1
+             */
+            owner_count: number;
+            /**
+             * Format: int64
+             * @description Number of members holding the admin role.
+             * @example 2
+             */
+            admin_count: number;
+            /**
+             * Format: int64
+             * @description Number of projects in the team.
+             * @example 3
+             */
+            project_count: number;
+            resource_counts: components["schemas"]["AdminResourceCounts"];
+            configuration: components["schemas"]["AdminTeamConfiguration"];
             /** Format: date-time */
             created_at: string;
         };
+        /**
+         * @description Which settings a team has configured itself. Each flag reflects the team's
+         *     OWN rows only; instance-level fallback configuration (config.yaml) never
+         *     counts as configured.
+         */
+        AdminTeamConfiguration: {
+            /** @description The team has at least one embedding provider of its own. */
+            embedding_configured: boolean;
+            /** @description The team has at least one LLM model provider of its own. */
+            llm_configured: boolean;
+            /** @description The team has its own AI summary settings with summaries enabled. */
+            ai_summary_enabled: boolean;
+            /** @description The team has its own email provider, regardless of its delivery health. */
+            email_configured: boolean;
+            /** @description The team has its own GitHub App configuration or at least one GitHub App installation (suspended installations included). */
+            github_configured: boolean;
+            /** @description The team has its own search settings. */
+            search_settings_customized: boolean;
+            /** @description The team has at least one enabled freshness rule. */
+            freshness_enabled: boolean;
+        };
         /** @description A page of the instance-wide team listing, newest first. */
         AdminTeamListResponse: {
             /** @description Teams on this page, newest first. */
@@ -11208,6 +11313,90 @@ export interface components {
             /** @description True when the user has no stored preferences and the defaults are shown. */
             is_default: boolean;
         };
+        /**
+         * @description 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.
+         */
+        AdminUserAccessMetrics: {
+            /**
+             * 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, source), ascending by bucket then source. */
+            access_by_source: components["schemas"]["AdminSourcePoint"][];
+            /**
+             * Format: date-time
+             * @description Oldest access event still retained (now minus
+             *     `retention.access_event_days`); buckets before it read as zeros.
+             */
+            earliest_retained_at: string;
+        };
+        /**
+         * @description 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.
+         */
+        AdminTopAccessedResource: {
+            /** @enum {string} */
+            resource_type: "prompt" | "artifact" | "blueprint" | "memory" | "project" | "agent";
+            /**
+             * @description First 8 characters of the resource id.
+             * @example 3f2a9c1e
+             */
+            resource_short_id: string;
+            /** Format: uuid */
+            team_id: string;
+            team_name: string;
+            /**
+             * Format: uuid
+             * @description 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;
+            /** @description True when the resource no longer exists (access events outlive their resource until pruned). */
+            resource_deleted: boolean;
+            /** Format: int64 */
+            access_count: number;
+        };
+        /**
+         * @description The resources a user accessed most in a range
+         *     (GET /api/v1/admin/users/{id}/top-accessed-resources).
+         */
+        AdminTopAccessedResourcesResponse: {
+            /**
+             * Format: date-time
+             * @description Inclusive start of the range actually used (after defaulting); not snapped.
+             */
+            from: string;
+            /**
+             * Format: date-time
+             * @description Exclusive end of the range actually used (after defaulting).
+             */
+            to: string;
+            /** @description Most accessed first; ties broken by resource id. */
+            items: components["schemas"]["AdminTopAccessedResource"][];
+            /**
+             * Format: date-time
+             * @description Oldest access event still retained (now minus
+             *     `retention.access_event_days`); accesses before it are not counted.
+             */
+            earliest_retained_at: string;
+        };
         ProjectResponse: components["schemas"]["Project"] & {
             /**
              * @description Whether the project's git URL matches a repository accessible via the team's GitHub App installation
@@ -20753,8 +20942,80 @@ export interface operations {
                 created_from?: string;
                 /** @description Only teams created at or before this instant (inclusive). */
                 created_to?: string;
+                /** @description Only teams with at least this many members (inclusive). */
+                member_count_min?: number;
+                /** @description Only teams with at most this many members (inclusive). */
+                member_count_max?: number;
+                /** @description Only teams with at least this many members holding the owner role (always 1 by application invariant; any other value is integrity drift) (inclusive). */
+                owner_count_min?: number;
+                /** @description Only teams with at most this many members holding the owner role (always 1 by application invariant; any other value is integrity drift) (inclusive). */
+                owner_count_max?: number;
+                /** @description Only teams with at least this many members holding the admin role (inclusive). */
+                admin_count_min?: number;
+                /** @description Only teams with at most this many members holding the admin role (inclusive). */
+                admin_count_max?: number;
+                /** @description Only teams with at least this many projects in the team (inclusive). */
+                project_count_min?: number;
+                /** @description Only teams with at most this many projects in the team (inclusive). */
+                project_count_max?: number;
+                /** @description Only teams with at least this many prompts in the team (inclusive). */
+                prompt_count_min?: number;
+                /** @description Only teams with at most this many prompts in the team (inclusive). */
+                prompt_count_max?: number;
+                /** @description Only teams with at least this many memories in the team (inclusive). */
+                memory_count_min?: number;
+                /** @description Only teams with at most this many memories in the team (inclusive). */
+                memory_count_max?: number;
+                /** @description Only teams with at least this many artifacts in the team (inclusive). */
+                artifact_count_min?: number;
+                /** @description Only teams with at most this many artifacts in the team (inclusive). */
+                artifact_count_max?: number;
+                /** @description Only teams with at least this many blueprints in the team (inclusive). */
+                blueprint_count_min?: number;
+                /** @description Only teams with at most this many blueprints in the team (inclusive). */
+                blueprint_count_max?: number;
+                /** @description Only teams with at least this many agents in the team (inclusive). */
+                agent_count_min?: number;
+                /** @description Only teams with at most this many agents in the team (inclusive). */
+                agent_count_max?: number;
+                /** @description Only teams with at least this many feeds in the team (inclusive). */
+                feed_count_min?: number;
+                /** @description Only teams with at most this many feeds in the team (inclusive). */
+                feed_count_max?: number;
+                /** @description Only teams with at least this many feed items in the team (inclusive). */
+                feed_item_count_min?: number;
+                /** @description Only teams with at most this many feed items in the team (inclusive). */
+                feed_item_count_max?: number;
+                /** @description Only teams with at least this many comments in the team (inclusive). */
+                comment_count_min?: number;
+                /** @description Only teams with at most this many comments in the team (inclusive). */
+                comment_count_max?: number;
+                /** @description Only teams with at least this many attachments in the team (inclusive). */
+                attachment_count_min?: number;
+                /** @description Only teams with at most this many attachments in the team (inclusive). */
+                attachment_count_max?: number;
+                /** @description Only teams with at least this many resources in the team across all nine types (the sum of resource_counts) (inclusive). */
+                total_resource_count_min?: number;
+                /** @description Only teams with at most this many resources in the team across all nine types (the sum of resource_counts) (inclusive). */
+                total_resource_count_max?: number;
+                /** @description Case-insensitive exact match on the team owner's email (the user referenced by the team's owner). For substring matching use `search`. */
+                owner_email?: string;
+                /** @description true = the team has at least one embedding provider of its own; false = it does not; omit = any. Instance-level fallback configuration never counts. */
+                embedding_configured?: boolean;
+                /** @description true = the team has at least one LLM model provider of its own; false = it does not; omit = any. Instance-level fallback configuration never counts. */
+                llm_configured?: boolean;
+                /** @description true = the team has its own AI summary settings with summaries enabled; false = it does not; omit = any. Instance-level fallback configuration never counts. */
+                ai_summary_enabled?: boolean;
+                /** @description true = the team has its own email provider (regardless of its delivery health); false = it does not; omit = any. Instance-level fallback configuration never counts. */
+                email_configured?: boolean;
+                /** @description true = the team has its own GitHub App configuration or at least one GitHub App installation (suspended installations included); false = it does not; omit = any. Instance-level fallback configuration never counts. */
+                github_configured?: boolean;
+                /** @description true = the team has its own search settings; false = it does not; omit = any. Instance-level fallback configuration never counts. */
+                search_settings_customized?: boolean;
+                /** @description true = the team has at least one enabled freshness rule; false = it does not; omit = any. Instance-level fallback configuration never counts. */
+                freshness_enabled?: boolean;
                 /** @description Column to sort by. Ties are always broken by team id so paging is stable. */
-                sort_by?: "created_at" | "name" | "member_count";
+                sort_by?: "created_at" | "name" | "member_count" | "owner_count" | "admin_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";
                 /** @description Sort direction. */
                 sort_order?: "asc" | "desc";
             };
@@ -21326,6 +21587,126 @@ export interface operations {
             };
         };
     };
+    getAdminUserResourceAccessMetrics: {
+        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 access counts per source */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminUserAccessMetrics"];
+                };
+            };
+            /**
+             * @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"];
+                };
+            };
+        };
+    };
+    getAdminUserTopAccessedResources: {
+        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 Maximum number of rows. */
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                /** @description User id (UUID) */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The most-accessed resources, most accessed first */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminTopAccessedResourcesResponse"];
+                };
+            };
+            /**
+             * @description Bad request — malformed user id, `to` is not after `from`, the range
+             *     exceeds the maximum span, or `limit` is 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;

package/package.json

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