@vibexp/api-client 0.32.0 → 0.34.0

package/dist/schema.d.ts

@@ -2754,9 +2754,11 @@ export interface paths {
         };
         /**
          * List instance users
-         * @description Returns a paginated, instance-wide listing of users (newest first) with
-         *     each user's team count. Instance-admin only; non-admin and unauthenticated
-         *     requests receive 404.
+         * @description Returns a paginated, instance-wide listing of users with each user's team
+         *     count. 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.
          */
         get: operations["listAdminUsers"];
         put?: never;
@@ -2798,8 +2800,10 @@ export interface paths {
         };
         /**
          * List instance teams
-         * @description Returns a paginated, instance-wide listing of teams (newest first) with
-         *     each team's owner and member count. Instance-admin only; non-admin and
+         * @description Returns a paginated, instance-wide listing of teams with each team's owner
+         *     and member count. 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.
          */
         get: operations["listAdminTeams"];
@@ -2833,6 +2837,59 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/admin/dashboard/overview": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get admin dashboard overview
+         * @description Returns instance-wide entity totals, status/type breakdowns, and system
+         *     health (database size and per-table estimated row counts), plus the running
+         *     backend version. Computed on demand — there are no rollup tables.
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404.
+         */
+        get: operations["getAdminDashboardOverview"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/admin/dashboard/timeseries": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get admin dashboard time series
+         * @description Returns growth, sign-in, and resource-access-by-source counts bucketed over
+         *     a time range. Omitting the parameters yields the last 30 days at `day`
+         *     granularity. Every bucket in the range is present in every series with an
+         *     explicit 0.
+         *
+         *     Both event sources are TTL-pruned (config `retention.activity_days` and
+         *     `retention.access_event_days`), so the response carries a `data_window`
+         *     stating the earliest instant for which data still exists — a range older
+         *     than that legitimately reads as zeros rather than missing data.
+         *
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404.
+         */
+        get: operations["getAdminDashboardTimeseries"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/{team_id}/comments": {
         parameters: {
             query?: never;
@@ -8798,6 +8855,16 @@ export interface components {
             id: string;
             /** @example Acme Engineering */
             name: string;
+            /**
+             * @description URL-safe team identifier.
+             * @example acme-engineering
+             */
+            slug: string;
+            /**
+             * @description True for a user's default personal workspace, false for a shared team workspace.
+             * @example false
+             */
+            is_personal: boolean;
             owner: components["schemas"]["AdminTeamOwner"];
             /**
              * Format: int64
@@ -8855,12 +8922,242 @@ export interface components {
             id: string;
             /** @example Acme Engineering */
             name: string;
+            /**
+             * @description URL-safe team identifier.
+             * @example acme-engineering
+             */
+            slug: string;
+            /**
+             * @description True for a user's default personal workspace, false for a shared team workspace.
+             * @example false
+             */
+            is_personal: boolean;
             owner: components["schemas"]["AdminTeamOwner"];
             /** Format: date-time */
             created_at: string;
             /** @description The team's members. */
             members: components["schemas"]["AdminTeamMember"][];
         };
+        /**
+         * @description Instance-wide totals for every top-level entity. A superset of
+         *     AdminInstanceCounts, which stays as-is for the legacy stats endpoint.
+         */
+        AdminExtendedCounts: {
+            /**
+             * Format: int64
+             * @example 42
+             */
+            users: number;
+            /**
+             * Format: int64
+             * @example 12
+             */
+            teams: number;
+            /**
+             * Format: int64
+             * @example 30
+             */
+            projects: number;
+            /**
+             * Format: int64
+             * @example 340
+             */
+            prompts: number;
+            /**
+             * Format: int64
+             * @example 128
+             */
+            artifacts: number;
+            /**
+             * Format: int64
+             * @example 512
+             */
+            memories: number;
+            /**
+             * Format: int64
+             * @example 64
+             */
+            blueprints: number;
+            /**
+             * Format: int64
+             * @example 9
+             */
+            agents: number;
+            /**
+             * Format: int64
+             * @example 4
+             */
+            feeds: number;
+            /**
+             * Format: int64
+             * @example 17
+             */
+            api_keys: number;
+        };
+        /** @description One value of a grouped column plus how many rows carry it. */
+        AdminBreakdownBucket: {
+            /**
+             * @description The column value. NULL values are reported as an empty string.
+             * @example active
+             */
+            value: string;
+            /**
+             * Format: int64
+             * @example 120
+             */
+            count: number;
+        };
+        /** @description A GROUP BY over one status/type column of one entity table. */
+        AdminEntityBreakdown: {
+            /**
+             * @description The entity table the breakdown covers.
+             * @example prompts
+             */
+            entity: string;
+            /**
+             * @description The grouped column.
+             * @example status
+             */
+            field: string;
+            /** @description One entry per distinct value, most frequent first. */
+            buckets: components["schemas"]["AdminBreakdownBucket"][];
+        };
+        /** @description Approximate row count for one table. */
+        AdminTableStat: {
+            /** @example prompts */
+            table: string;
+            /**
+             * Format: int64
+             * @description ESTIMATE from pg_stat_user_tables.n_live_tup, not an exact COUNT(*) —
+             *     an exact per-table count does not scale and this figure is only meant
+             *     for relative sizing. Freshness depends on autovacuum/ANALYZE.
+             * @example 34012
+             */
+            estimated_rows: number;
+        };
+        /** @description Instance storage health. */
+        AdminSystemHealth: {
+            /**
+             * Format: int64
+             * @description pg_database_size(current_database()).
+             * @example 184549376
+             */
+            database_size_bytes: number;
+            /** @description Per-table estimated row counts, largest first. */
+            tables: components["schemas"]["AdminTableStat"][];
+        };
+        /** @description Totals, breakdowns and system health (GET /api/v1/admin/dashboard/overview). */
+        AdminDashboardOverview: {
+            counts: components["schemas"]["AdminExtendedCounts"];
+            /** @description One entry per entity/column pair that has a status or type column. */
+            breakdowns: components["schemas"]["AdminEntityBreakdown"][];
+            system_health: components["schemas"]["AdminSystemHealth"];
+            /**
+             * @description The running backend application version ("dev" when unset).
+             * @example 1.2.3
+             */
+            version: string;
+        };
+        /** @description New rows created per entity within one time bucket. */
+        AdminGrowthPoint: {
+            /**
+             * Format: date-time
+             * @description Start of the bucket, in UTC.
+             */
+            bucket: string;
+            /** Format: int64 */
+            users: number;
+            /** Format: int64 */
+            teams: number;
+            /** Format: int64 */
+            projects: number;
+            /** Format: int64 */
+            prompts: number;
+            /** Format: int64 */
+            artifacts: number;
+            /** Format: int64 */
+            memories: number;
+        };
+        /** @description A single count within one time bucket. */
+        AdminCountPoint: {
+            /**
+             * Format: date-time
+             * @description Start of the bucket, in UTC.
+             */
+            bucket: string;
+            /** Format: int64 */
+            count: number;
+        };
+        /** @description A count for one access source within one time bucket. */
+        AdminSourcePoint: {
+            /**
+             * Format: date-time
+             * @description Start of the bucket, in UTC.
+             */
+            bucket: string;
+            /**
+             * @description Access source (e.g. "web", "cli", "mcp").
+             * @example mcp
+             */
+            source: string;
+            /** Format: int64 */
+            count: number;
+        };
+        /**
+         * @description Earliest instant for which event data still exists. Both source tables are
+         *     TTL-pruned (config retention.activity_days / retention.access_event_days),
+         *     so a chart asking for a range older than these values will legitimately show
+         *     zeros rather than missing data.
+         */
+        AdminDataWindow: {
+            /**
+             * Format: date-time
+             * @description now() - retention.activity_days.
+             */
+            sign_ins_earliest_retained_at: string;
+            /**
+             * Format: date-time
+             * @description now() - retention.access_event_days.
+             */
+            access_by_source_earliest_retained_at: string;
+        };
+        /**
+         * @description Bucketed metrics over a time range (GET /api/v1/admin/dashboard/timeseries).
+         *     Every bucket in the requested range is present in every series with an
+         *     explicit 0 — the series are gap-filled, never sparse.
+         */
+        AdminTimeseriesResponse: {
+            /**
+             * Format: date-time
+             * @description Inclusive start of the range actually used. This is snapped DOWN to the
+             *     start of its bucket, so it may precede the requested `from` (asking for
+             *     2026-07-15 at month granularity reports and queries 2026-07-01). Buckets
+             *     are therefore always whole, never partial at the head.
+             */
+            from: string;
+            /**
+             * Format: date-time
+             * @description Exclusive end of the range actually used (after defaulting). This is NOT
+             *     snapped, so the final bucket may cover only part of its period.
+             */
+            to: string;
+            /**
+             * @description Bucket size actually used.
+             * @enum {string}
+             */
+            granularity: "day" | "week" | "month";
+            /** @description New entities per bucket, ascending by bucket. */
+            growth: components["schemas"]["AdminGrowthPoint"][];
+            /** @description Successful sign-ins per bucket (activities.auth_login), ascending. */
+            sign_ins: components["schemas"]["AdminCountPoint"][];
+            /**
+             * @description Resource accesses per bucket per source, ascending by bucket then source.
+             *     Only sources actually observed in the range appear; a source with no
+             *     events in a bucket is gap-filled to 0 for the sources that do appear.
+             */
+            access_by_source: components["schemas"]["AdminSourcePoint"][];
+            data_window: components["schemas"]["AdminDataWindow"];
+        };
         ProjectResponse: components["schemas"]["Project"] & {
             /**
              * @description Whether the project's git URL matches a repository accessible via the team's GitHub App installation
@@ -18793,6 +19090,18 @@ export interface operations {
                 page?: number;
                 /** @description Items per page */
                 limit?: number;
+                /** @description Case-insensitive substring match over the user's email and name. */
+                search?: string;
+                /** @description Exact match on the user's identity-provider name (e.g. "google", "oidc"). */
+                idp_provider?: string;
+                /** @description Only users created at or after this instant (inclusive). */
+                created_from?: string;
+                /** @description Only users created at or before this instant (inclusive). */
+                created_to?: string;
+                /** @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 Sort direction. */
+                sort_order?: "asc" | "desc";
             };
             header?: never;
             path?: never;
@@ -18809,6 +19118,15 @@ export interface operations {
                     "application/json": components["schemas"]["AdminUserListResponse"];
                 };
             };
+            /** @description Bad request — a query parameter is malformed or outside its enum */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
             /** @description Not found — the caller is not an instance admin (surface not advertised) */
             404: {
                 headers: {
@@ -18877,6 +19195,18 @@ export interface operations {
                 page?: number;
                 /** @description Items per page */
                 limit?: number;
+                /** @description Case-insensitive substring match over the team name, team slug, and the owner's email. */
+                search?: string;
+                /** @description Narrow to personal workspaces (true) or shared team workspaces (false). */
+                is_personal?: boolean;
+                /** @description Only teams created at or after this instant (inclusive). */
+                created_from?: string;
+                /** @description Only teams created at or before this instant (inclusive). */
+                created_to?: string;
+                /** @description Column to sort by. Ties are always broken by team id so paging is stable. */
+                sort_by?: "created_at" | "name" | "member_count";
+                /** @description Sort direction. */
+                sort_order?: "asc" | "desc";
             };
             header?: never;
             path?: never;
@@ -18893,6 +19223,15 @@ export interface operations {
                     "application/json": components["schemas"]["AdminTeamListResponse"];
                 };
             };
+            /** @description Bad request — a query parameter is malformed or outside its enum */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
             /** @description Not found — the caller is not an instance admin (surface not advertised) */
             404: {
                 headers: {
@@ -18954,6 +19293,101 @@ export interface operations {
             };
         };
     };
+    getAdminDashboardOverview: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Dashboard overview */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminDashboardOverview"];
+                };
+            };
+            /** @description Not found — the caller is not an instance admin (surface not advertised) */
+            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"];
+                };
+            };
+        };
+    };
+    getAdminDashboardTimeseries: {
+        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?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Bucketed time series for the requested range */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminTimeseriesResponse"];
+                };
+            };
+            /**
+             * @description Bad request — `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 — the caller is not an instance admin (surface not advertised) */
+            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: {

package/package.json

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