@vibexp/api-client 0.86.0 → 0.87.0

package/dist/schema.d.ts

@@ -3212,6 +3212,134 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/admin/projects/{id}/resource-creation-metrics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a project's resource creation series
+         * @description Returns how many resources of each PROJECT-SCOPED type (prompts, memories,
+         *     artifacts, blueprints, feed items) were created in the project per bucket
+         *     over a time range. Only resources that currently belong to the project are
+         *     counted: deleted resources drop out, and a resource moved in by a project
+         *     migration counts here from its original creation time. 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 project id.
+         */
+        get: operations["getAdminProjectResourceCreationMetrics"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/admin/projects/{id}/resource-access-metrics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a project's resource access series by source
+         * @description Returns how many times the project's resources (prompts, artifacts,
+         *     blueprints, memories) and the project itself were accessed (opened) per
+         *     bucket and per access source (web, cli, mcp, api). 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 carry no project, so an event is attributed to the project
+         *     its resource belongs to NOW: accesses to a since-deleted resource drop out,
+         *     and a resource moved in by a project migration brings its whole access
+         *     history with it. Agents are team-scoped and never count. Access events are
+         *     also 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 project id.
+         */
+        get: operations["getAdminProjectResourceAccessMetrics"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/admin/projects/{id}/top-accessed-resources": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a project's most-accessed resources
+         * @description Returns the project's resources (prompts, artifacts, blueprints, memories)
+         *     accessed most often in a time range, 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.
+         *     Opening the project page itself counts in the access series but is not
+         *     listed here, and `resource_deleted` is always `false`: attribution is by
+         *     the resource's CURRENT project, so a deleted resource has none and drops
+         *     out.
+         *
+         *     `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 project id.
+         */
+        get: operations["getAdminProjectTopAccessedResources"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/admin/projects/{id}/config": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a project's configuration
+         * @description Returns the configuration that applies to the project. Projects have no
+         *     settings of their own, so today this is the freshness rules that govern
+         *     it, split in two: the rules scoped to this project, and the team-wide
+         *     rules (no project scope) that apply to every project of its team. Rules
+         *     combine cumulatively, so both lists apply. Rules scoped to other projects
+         *     of the team are never included. The team's freshness settings live in
+         *     getAdminTeamFreshnessConfig. Read-only.
+         *
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404, as
+         *     does an unknown project id.
+         */
+        get: operations["getAdminProjectConfig"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/{team_id}/comments": {
         parameters: {
             query?: never;
@@ -11596,7 +11724,8 @@ export interface components {
         };
         /**
          * @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 user accessed it (or, for a project, how often it was accessed).
+         *     Deliberately carries no title, slug or content — only
          *     the first 8 characters of the resource id. The identity fields share their
          *     names with AdminUserTimelineEvent.
          */
@@ -11618,14 +11747,20 @@ export interface components {
              */
             project_id: string | null;
             project_name: string | null;
-            /** @description True when the resource no longer exists (access events outlive their resource until pruned). */
+            /**
+             * @description True when the resource no longer exists (access events outlive their
+             *     resource until pruned). Always `false` for a project's top resources
+             *     (GET /api/v1/admin/projects/{id}/top-accessed-resources), where a
+             *     deleted resource has no current project and drops out.
+             */
             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).
+         *     (GET /api/v1/admin/users/{id}/top-accessed-resources), or a project's
+         *     most-accessed resources (GET /api/v1/admin/projects/{id}/top-accessed-resources).
          */
         AdminTopAccessedResourcesResponse: {
             /**
@@ -11990,6 +12125,95 @@ export interface components {
             app_config: components["schemas"]["AdminGitHubAppConfig"] | null;
             installation: components["schemas"]["AdminGitHubInstallation"];
         };
+        /** @description How many resources of each project-scoped type were created in the project within one time bucket. */
+        AdminProjectCreationPoint: {
+            /**
+             * 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 */
+            feed_items: number;
+        };
+        /**
+         * @description Resources created in the project per bucket, stacked by type
+         *     (GET /api/v1/admin/projects/{id}/resource-creation-metrics). Every bucket in
+         *     the range is present with an explicit 0 for every type.
+         */
+        AdminProjectResourceCreationMetrics: {
+            /**
+             * 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"]["AdminProjectCreationPoint"][];
+        };
+        /**
+         * @description Accesses to the project's resources and to the project itself per bucket and
+         *     source (GET /api/v1/admin/projects/{id}/resource-access-metrics). An event
+         *     is attributed to the project its resource belongs to now, so accesses to a
+         *     deleted resource drop out and a migrated resource brings its history with
+         *     it. Every bucket in the range is present with an explicit 0 for each source
+         *     that appears.
+         */
+        AdminProjectAccessMetrics: {
+            /**
+             * 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 The configuration that applies to a project
+         *     (GET /api/v1/admin/projects/{id}/config): the freshness rules scoped to it
+         *     and the team-wide rules that also apply. Both lists are oldest first and
+         *     include disabled rules.
+         */
+        AdminProjectConfig: {
+            /** @description Rules scoped to this project. `[]` when there are none. */
+            project_rules: components["schemas"]["AdminFreshnessRule"][];
+            /** @description Rules with no project scope, which apply to every project of the team. `[]` when there are none. */
+            team_wide_rules: components["schemas"]["AdminFreshnessRule"][];
+        };
         ProjectResponse: components["schemas"]["Project"] & {
             /**
              * @description Whether the project's git URL matches a repository accessible via the team's GitHub App installation
@@ -22847,6 +23071,236 @@ export interface operations {
             };
         };
     };
+    getAdminProjectResourceCreationMetrics: {
+        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 Project 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"]["AdminProjectResourceCreationMetrics"];
+                };
+            };
+            /**
+             * @description Bad request — malformed project 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 project 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"];
+                };
+            };
+        };
+    };
+    getAdminProjectResourceAccessMetrics: {
+        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 Project 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"]["AdminProjectAccessMetrics"];
+                };
+            };
+            /**
+             * @description Bad request — malformed project 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 project 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"];
+                };
+            };
+        };
+    };
+    getAdminProjectTopAccessedResources: {
+        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 Project 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 project 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 project 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"];
+                };
+            };
+        };
+    };
+    getAdminProjectConfig: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Project id (UUID) */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The project's and the team-wide freshness rules */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminProjectConfig"];
+                };
+            };
+            /** @description Bad request — malformed project id */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Not found — unknown project 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: {

package/package.json

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