@vibexp/api-client 0.86.0 → 0.88.0

package/dist/schema.d.ts

@@ -3212,6 +3212,168 @@ 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/admin/saved-filters/{list}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get the caller's saved filter presets for an admin list
+         * @description Returns the calling instance admin's own named filter presets for one admin
+         *     list, plus the `version` to send back when replacing them. An admin with
+         *     nothing saved gets `presets: []` and `version: 0`. Presets are private to
+         *     the admin who saved them.
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404.
+         */
+        get: operations["getAdminSavedFilters"];
+        /**
+         * Replace the caller's saved filter presets for an admin list
+         * @description Atomically replaces the calling instance admin's presets for one admin
+         *     list. At most 20 presets; names are trimmed and must be 1–80 characters and
+         *     unique case-insensitively; ids must be unique (a missing id is assigned by
+         *     the server, a sent id is kept). The request's `version` must match the
+         *     stored one, otherwise nothing is saved and 409 is returned. A body carrying
+         *     an unknown field is rejected with 400.
+         *     Instance-admin only; non-admin and unauthenticated requests receive 404.
+         */
+        put: operations["replaceAdminSavedFilters"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/{team_id}/comments": {
         parameters: {
             query?: never;
@@ -11596,7 +11758,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 +11781,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 +12159,177 @@ 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"][];
+        };
+        /**
+         * @description The admin list a set of saved filter presets belongs to.
+         * @enum {string}
+         */
+        AdminSavedFilterListName: "users" | "teams" | "projects";
+        /**
+         * @description The list's filter state as URL query parameters (parameter name → value).
+         *     Stored as given and never executed server-side; the client owns its meaning.
+         *     At most 40 keys, each matching `^[a-z0-9_]{1,64}$`, each value at most 512
+         *     characters.
+         * @example {
+         *       "status": "suspended",
+         *       "sort_by": "created_at"
+         *     }
+         */
+        AdminSavedFilterQuery: {
+            [key: string]: string;
+        };
+        /** @description One named filter preset saved by an instance admin. */
+        AdminSavedFilterPreset: {
+            /**
+             * Format: uuid
+             * @description Stable preset id. Kept across renames.
+             */
+            id: string;
+            /**
+             * @description Display name, unique (case-insensitively) within the list.
+             * @example Dormant teams
+             */
+            name: string;
+            query: components["schemas"]["AdminSavedFilterQuery"];
+        };
+        /**
+         * @description A preset as sent in a replace request. Omit `id` for a new preset and the
+         *     server assigns one; send the existing `id` to keep it (e.g. on rename).
+         */
+        AdminSavedFilterPresetInput: {
+            /**
+             * Format: uuid
+             * @description Existing preset id to keep; omitted for a new preset.
+             */
+            id?: string;
+            /**
+             * @description Display name. Surrounding whitespace is trimmed; must be unique
+             *     (case-insensitively) within the list.
+             * @example Dormant teams
+             */
+            name: string;
+            query: components["schemas"]["AdminSavedFilterQuery"];
+        };
+        /**
+         * @description The calling instance admin's saved filter presets for one admin list
+         *     (GET/PUT /api/v1/admin/saved-filters/{list}). Presets are private to the
+         *     admin who saved them.
+         */
+        AdminSavedFilters: {
+            list: components["schemas"]["AdminSavedFilterListName"];
+            /** @description The presets in their saved order. `[]` when there are none. */
+            presets: components["schemas"]["AdminSavedFilterPreset"][];
+            /**
+             * Format: int64
+             * @description Optimistic-lock version of the admin's preferences record. `0` when
+             *     nothing has been saved yet. Send it back unchanged in the next replace
+             *     request; it is shared with the user's other preferences, so a change
+             *     made elsewhere also advances it.
+             */
+            version: number;
+        };
+        /**
+         * @description Replaces the whole preset list for one admin list. Renaming and deleting are
+         *     done by sending the edited list.
+         */
+        AdminSavedFiltersReplaceRequest: {
+            /** @description The complete new preset list, in order (at most 20). */
+            presets: components["schemas"]["AdminSavedFilterPresetInput"][];
+            /**
+             * Format: int64
+             * @description The `version` last read. A stale value is rejected with 409 and nothing
+             *     is saved.
+             */
+            version: number;
+        };
         ProjectResponse: components["schemas"]["Project"] & {
             /**
              * @description Whether the project's git URL matches a repository accessible via the team's GitHub App installation
@@ -22847,6 +23187,353 @@ 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"];
+                };
+            };
+        };
+    };
+    getAdminSavedFilters: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Which admin list the presets belong to. */
+                list: components["schemas"]["AdminSavedFilterListName"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The caller's presets for this list */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminSavedFilters"];
+                };
+            };
+            /** @description Bad request — unknown list name */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Not found — 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"];
+                };
+            };
+        };
+    };
+    replaceAdminSavedFilters: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Which admin list the presets belong to. */
+                list: components["schemas"]["AdminSavedFilterListName"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AdminSavedFiltersReplaceRequest"];
+            };
+        };
+        responses: {
+            /** @description The saved presets and the new version */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AdminSavedFilters"];
+                };
+            };
+            /**
+             * @description Bad request — unknown list name, an invalid preset (over the cap,
+             *     duplicate or out-of-range name, duplicate id, invalid query key or
+             *     value), or a body carrying an unknown field
+             */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Not found — the caller is not an instance admin */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Conflict — the presets were changed elsewhere (stale `version`); nothing was saved */
+            409: {
+                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: {