@vibexp/api-client 0.85.0 → 0.87.0

package/dist/schema.d.ts

@@ -2988,6 +2988,14 @@ export interface paths {
          *     `owner` is the project's creator (`projects.user_id`), which is not
          *     necessarily the owning team's owner.
          *
+         *     Resource counts cover exactly the five PROJECT-SCOPED types, the tables
+         *     that carry a direct `project_id`: prompts, memories, artifacts, blueprints
+         *     and feed items (a feed item posted without a project counts for none).
+         *     Agents and feeds are team-scoped and have no project association;
+         *     comments and attachments reach a project only indirectly, through the
+         *     resource they belong to. All four are therefore excluded from every count,
+         *     count filter, sort and `last_resource_created_at`.
+         *
          *     Instance-admin only; non-admin and unauthenticated requests receive 404.
          */
         get: operations["listAdminProjects"];
@@ -3010,8 +3018,9 @@ export interface paths {
          * Get an instance project
          * @description Returns one project with its owning team, its creator, and how many of each
          *     PROJECT-SCOPED resource type it contains (prompts, artifacts, memories,
-         *     blueprints). Agents and feeds are not included because they are team-scoped
-         *     and have no project association.
+         *     blueprints, feed items) plus their total. Agents and feeds are not included
+         *     because they are team-scoped and have no project association; comments and
+         *     attachments are not included because they reach a project only indirectly.
          *
          *     Instance-admin only; non-admin and unauthenticated requests receive 404, as
          *     does an unknown project id.
@@ -3203,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;
@@ -11310,6 +11447,14 @@ export interface components {
             created_at: string;
             /** Format: date-time */
             updated_at: string;
+            resource_counts: components["schemas"]["AdminProjectResourceCounts"];
+            /**
+             * Format: date-time
+             * @description When the project's most recent project-scoped resource (any of the five
+             *     types counted in resource_counts) was created; null for a project with
+             *     none.
+             */
+            last_resource_created_at: string | null;
         };
         /** @description A page of the instance-wide project listing. */
         AdminProjectListResponse: {
@@ -11328,12 +11473,17 @@ export interface components {
             total_pages: number;
         };
         /**
-         * @description How many of each PROJECT-SCOPED resource type the project contains.
+         * @description How many of each PROJECT-SCOPED resource type the project contains, plus
+         *     their total. Shared by the project listing and the project detail, which
+         *     always agree.
          *
-         *     Only these four types belong to a project. Agents and feeds are deliberately
-         *     absent: neither table has a project_id column (both are team-scoped), so
-         *     reporting zero for them would read as "this project has no agents" rather
-         *     than "agents do not belong to projects".
+         *     Only the five tables with a direct project_id belong to a project: prompts,
+         *     artifacts, memories, blueprints and feed items (a feed item posted without
+         *     a project counts for none). Agents and feeds are deliberately absent: both
+         *     are team-scoped and have no project_id, so reporting zero for them would
+         *     read as "this project has no agents" rather than "agents do not belong to
+         *     projects". Comments and attachments are absent too: they reach a project
+         *     only indirectly, through the resource they are attached to.
          */
         AdminProjectResourceCounts: {
             /**
@@ -11356,6 +11506,17 @@ export interface components {
              * @example 3
              */
             blueprints: number;
+            /**
+             * Format: int64
+             * @example 9
+             */
+            feed_items: number;
+            /**
+             * Format: int64
+             * @description Sum of the five project-scoped counts.
+             * @example 55
+             */
+            total: number;
         };
         /** @description A single project with its team, owner and resource counts (GET /api/v1/admin/projects/{id}). */
         AdminProjectDetail: {
@@ -11563,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.
          */
@@ -11585,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: {
             /**
@@ -11957,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
@@ -22338,8 +22595,50 @@ export interface operations {
                 created_from?: string;
                 /** @description Only projects created at or before this instant (inclusive). */
                 created_to?: string;
-                /** @description Column to sort by. Ties are always broken by project id so paging is stable. */
-                sort_by?: "created_at" | "name";
+                /** @description Only projects with at least this many prompts in the project (inclusive). */
+                prompt_count_min?: number;
+                /** @description Only projects with at most this many prompts in the project (inclusive). */
+                prompt_count_max?: number;
+                /** @description Only projects with at least this many memories in the project (inclusive). */
+                memory_count_min?: number;
+                /** @description Only projects with at most this many memories in the project (inclusive). */
+                memory_count_max?: number;
+                /** @description Only projects with at least this many artifacts in the project (inclusive). */
+                artifact_count_min?: number;
+                /** @description Only projects with at most this many artifacts in the project (inclusive). */
+                artifact_count_max?: number;
+                /** @description Only projects with at least this many blueprints in the project (inclusive). */
+                blueprint_count_min?: number;
+                /** @description Only projects with at most this many blueprints in the project (inclusive). */
+                blueprint_count_max?: number;
+                /** @description Only projects with at least this many feed items in the project (inclusive). */
+                feed_item_count_min?: number;
+                /** @description Only projects with at most this many feed items in the project (inclusive). */
+                feed_item_count_max?: number;
+                /** @description Only projects with at least this many project-scoped resources in the project (inclusive). The total is the sum of the five project-scoped types. */
+                total_resource_count_min?: number;
+                /** @description Only projects with at most this many project-scoped resources in the project (inclusive). The total is the sum of the five project-scoped types. */
+                total_resource_count_max?: number;
+                /** @description Case-insensitive exact match on the email of the project's creator (`projects.user_id`, the `owner` field), not the owning team's owner. For substring matching on name/slug use `search`. */
+                owner_email?: string;
+                /**
+                 * @description Only projects whose most recent project-scoped resource (any of the five
+                 *     types) was created at or after this instant (inclusive). Projects with
+                 *     no resources never match.
+                 */
+                last_resource_created_from?: string;
+                /**
+                 * @description Only projects whose most recent project-scoped resource (any of the five
+                 *     types) was created at or before this instant (inclusive). Projects with
+                 *     no resources never match.
+                 */
+                last_resource_created_to?: string;
+                /**
+                 * @description Column to sort by. Ties are always broken by project id so paging is stable.
+                 *     Sorting by last_resource_created_at places projects with no resources
+                 *     last in both directions.
+                 */
+                sort_by?: "created_at" | "name" | "prompt_count" | "memory_count" | "artifact_count" | "blueprint_count" | "feed_item_count" | "total_resource_count" | "last_resource_created_at";
                 /** @description Sort direction. */
                 sort_order?: "asc" | "desc";
             };
@@ -22772,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.85.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": {