@vibexp/api-client 0.86.0 → 0.88.0

package/dist/axios/sdk.gen.js

@@ -3473,6 +3473,188 @@ export const getAdminUserNotificationPreferences = (options) => (options.client
     url: '/api/v1/admin/users/{id}/notification-preferences',
     ...options
 });
+/**
+ * Get a project's resource creation series
+ *
+ * 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.
+ *
+ */
+export const getAdminProjectResourceCreationMetrics = (options) => (options.client ?? client).get({
+    responseType: 'json',
+    security: [{
+            key: 'ApiKeyAuth',
+            scheme: 'bearer',
+            type: 'http'
+        }, {
+            in: 'cookie',
+            name: 'vx_session',
+            type: 'apiKey'
+        }],
+    url: '/api/v1/admin/projects/{id}/resource-creation-metrics',
+    ...options
+});
+/**
+ * Get a project's resource access series by source
+ *
+ * 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.
+ *
+ */
+export const getAdminProjectResourceAccessMetrics = (options) => (options.client ?? client).get({
+    responseType: 'json',
+    security: [{
+            key: 'ApiKeyAuth',
+            scheme: 'bearer',
+            type: 'http'
+        }, {
+            in: 'cookie',
+            name: 'vx_session',
+            type: 'apiKey'
+        }],
+    url: '/api/v1/admin/projects/{id}/resource-access-metrics',
+    ...options
+});
+/**
+ * Get a project's most-accessed resources
+ *
+ * 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.
+ *
+ */
+export const getAdminProjectTopAccessedResources = (options) => (options.client ?? client).get({
+    responseType: 'json',
+    security: [{
+            key: 'ApiKeyAuth',
+            scheme: 'bearer',
+            type: 'http'
+        }, {
+            in: 'cookie',
+            name: 'vx_session',
+            type: 'apiKey'
+        }],
+    url: '/api/v1/admin/projects/{id}/top-accessed-resources',
+    ...options
+});
+/**
+ * Get a project's configuration
+ *
+ * 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.
+ *
+ */
+export const getAdminProjectConfig = (options) => (options.client ?? client).get({
+    responseType: 'json',
+    security: [{
+            key: 'ApiKeyAuth',
+            scheme: 'bearer',
+            type: 'http'
+        }, {
+            in: 'cookie',
+            name: 'vx_session',
+            type: 'apiKey'
+        }],
+    url: '/api/v1/admin/projects/{id}/config',
+    ...options
+});
+/**
+ * Get the caller's saved filter presets for an admin list
+ *
+ * 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.
+ *
+ */
+export const getAdminSavedFilters = (options) => (options.client ?? client).get({
+    responseType: 'json',
+    security: [{
+            key: 'ApiKeyAuth',
+            scheme: 'bearer',
+            type: 'http'
+        }, {
+            in: 'cookie',
+            name: 'vx_session',
+            type: 'apiKey'
+        }],
+    url: '/api/v1/admin/saved-filters/{list}',
+    ...options
+});
+/**
+ * Replace the caller's saved filter presets for an admin list
+ *
+ * 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.
+ *
+ */
+export const replaceAdminSavedFilters = (options) => (options.client ?? client).put({
+    responseType: 'json',
+    security: [{
+            key: 'ApiKeyAuth',
+            scheme: 'bearer',
+            type: 'http'
+        }, {
+            in: 'cookie',
+            name: 'vx_session',
+            type: 'apiKey'
+        }],
+    url: '/api/v1/admin/saved-filters/{list}',
+    ...options,
+    headers: {
+        'Content-Type': 'application/json',
+        ...options.headers
+    }
+});
 /**
  * List a resource's comments
  *

package/dist/axios/types.gen.d.ts

@@ -5413,7 +5413,8 @@ export type AdminUserAccessMetrics = {
 };
 /**
  * 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.
  *
@@ -5434,14 +5435,19 @@ export type AdminTopAccessedResource = {
     project_id: string | null;
     project_name: string | null;
     /**
-     * True when the resource no longer exists (access events outlive their resource until pruned).
+     * 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;
     access_count: number;
 };
 /**
  * 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).
  *
  */
 export type AdminTopAccessedResourcesResponse = {
@@ -5868,6 +5874,182 @@ export type AdminTeamGitHubConfig = {
     app_config: AdminGitHubAppConfig | null;
     installation: AdminGitHubInstallation;
 };
+/**
+ * How many resources of each project-scoped type were created in the project within one time bucket.
+ */
+export type AdminProjectCreationPoint = {
+    /**
+     * Start of the bucket, in UTC.
+     */
+    bucket: string;
+    prompts: number;
+    memories: number;
+    artifacts: number;
+    blueprints: number;
+    feed_items: number;
+};
+/**
+ * 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.
+ *
+ */
+export type AdminProjectResourceCreationMetrics = {
+    /**
+     * Inclusive start of the range actually used, snapped DOWN to the start of
+     * its bucket (same rule as AdminTimeseriesResponse.from).
+     *
+     */
+    from: string;
+    /**
+     * Exclusive end of the range actually used (after defaulting); not snapped.
+     */
+    to: string;
+    /**
+     * Bucket size actually used.
+     */
+    granularity: 'day' | 'week' | 'month';
+    /**
+     * One point per bucket, ascending by bucket.
+     */
+    series: Array<AdminProjectCreationPoint>;
+};
+/**
+ * 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.
+ *
+ */
+export type AdminProjectAccessMetrics = {
+    /**
+     * Inclusive start of the range actually used, snapped DOWN to the start of
+     * its bucket (same rule as AdminTimeseriesResponse.from).
+     *
+     */
+    from: string;
+    /**
+     * Exclusive end of the range actually used (after defaulting); not snapped.
+     */
+    to: string;
+    /**
+     * Bucket size actually used.
+     */
+    granularity: 'day' | 'week' | 'month';
+    /**
+     * One point per (bucket, source), ascending by bucket then source.
+     */
+    access_by_source: Array<AdminSourcePoint>;
+    /**
+     * Oldest access event still retained (now minus
+     * `retention.access_event_days`); buckets before it read as zeros.
+     *
+     */
+    earliest_retained_at: string;
+};
+/**
+ * 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.
+ *
+ */
+export type AdminProjectConfig = {
+    /**
+     * Rules scoped to this project. `[]` when there are none.
+     */
+    project_rules: Array<AdminFreshnessRule>;
+    /**
+     * Rules with no project scope, which apply to every project of the team. `[]` when there are none.
+     */
+    team_wide_rules: Array<AdminFreshnessRule>;
+};
+/**
+ * The admin list a set of saved filter presets belongs to.
+ */
+export type AdminSavedFilterListName = 'users' | 'teams' | 'projects';
+/**
+ * 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.
+ *
+ */
+export type AdminSavedFilterQuery = {
+    [key: string]: string;
+};
+/**
+ * One named filter preset saved by an instance admin.
+ */
+export type AdminSavedFilterPreset = {
+    /**
+     * Stable preset id. Kept across renames.
+     */
+    id: string;
+    /**
+     * Display name, unique (case-insensitively) within the list.
+     */
+    name: string;
+    query: AdminSavedFilterQuery;
+};
+/**
+ * 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).
+ *
+ */
+export type AdminSavedFilterPresetInput = {
+    /**
+     * Existing preset id to keep; omitted for a new preset.
+     */
+    id?: string;
+    /**
+     * Display name. Surrounding whitespace is trimmed; must be unique
+     * (case-insensitively) within the list.
+     *
+     */
+    name: string;
+    query: AdminSavedFilterQuery;
+};
+/**
+ * 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.
+ *
+ */
+export type AdminSavedFilters = {
+    list: AdminSavedFilterListName;
+    /**
+     * The presets in their saved order. `[]` when there are none.
+     */
+    presets: Array<AdminSavedFilterPreset>;
+    /**
+     * 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;
+};
+/**
+ * Replaces the whole preset list for one admin list. Renaming and deleting are
+ * done by sending the edited list.
+ *
+ */
+export type AdminSavedFiltersReplaceRequest = {
+    /**
+     * The complete new preset list, in order (at most 20).
+     */
+    presets: Array<AdminSavedFilterPresetInput>;
+    /**
+     * The `version` last read. A stale value is rejected with 409 and nothing
+     * is saved.
+     *
+     */
+    version: number;
+};
 export type ProjectResponse = Project & {
     /**
      * Whether the project's git URL matches a repository accessible via the team's GitHub App installation
@@ -13674,6 +13856,256 @@ export type GetAdminUserNotificationPreferencesResponses = {
     200: AdminUserNotificationPreferences;
 };
 export type GetAdminUserNotificationPreferencesResponse = GetAdminUserNotificationPreferencesResponses[keyof GetAdminUserNotificationPreferencesResponses];
+export type GetAdminProjectResourceCreationMetricsData = {
+    body?: never;
+    path: {
+        /**
+         * Project id (UUID)
+         */
+        id: string;
+    };
+    query?: {
+        /**
+         * Inclusive start of the range. Defaults to 30 days before `to`.
+         */
+        from?: string;
+        /**
+         * Exclusive end of the range. Defaults to now.
+         */
+        to?: string;
+        /**
+         * Bucket size.
+         */
+        granularity?: 'day' | 'week' | 'month';
+    };
+    url: '/api/v1/admin/projects/{id}/resource-creation-metrics';
+};
+export type GetAdminProjectResourceCreationMetricsErrors = {
+    /**
+     * Bad request — malformed project id, `to` is not after `from`, the range
+     * exceeds the maximum span, or `granularity` is outside its enum
+     *
+     */
+    400: ErrorResponse;
+    /**
+     * Not found — unknown project id, or the caller is not an instance admin
+     */
+    404: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type GetAdminProjectResourceCreationMetricsError = GetAdminProjectResourceCreationMetricsErrors[keyof GetAdminProjectResourceCreationMetricsErrors];
+export type GetAdminProjectResourceCreationMetricsResponses = {
+    /**
+     * Bucketed creation counts per type
+     */
+    200: AdminProjectResourceCreationMetrics;
+};
+export type GetAdminProjectResourceCreationMetricsResponse = GetAdminProjectResourceCreationMetricsResponses[keyof GetAdminProjectResourceCreationMetricsResponses];
+export type GetAdminProjectResourceAccessMetricsData = {
+    body?: never;
+    path: {
+        /**
+         * Project id (UUID)
+         */
+        id: string;
+    };
+    query?: {
+        /**
+         * Inclusive start of the range. Defaults to 30 days before `to`.
+         */
+        from?: string;
+        /**
+         * Exclusive end of the range. Defaults to now.
+         */
+        to?: string;
+        /**
+         * Bucket size.
+         */
+        granularity?: 'day' | 'week' | 'month';
+    };
+    url: '/api/v1/admin/projects/{id}/resource-access-metrics';
+};
+export type GetAdminProjectResourceAccessMetricsErrors = {
+    /**
+     * Bad request — malformed project id, `to` is not after `from`, the range
+     * exceeds the maximum span, or `granularity` is outside its enum
+     *
+     */
+    400: ErrorResponse;
+    /**
+     * Not found — unknown project id, or the caller is not an instance admin
+     */
+    404: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type GetAdminProjectResourceAccessMetricsError = GetAdminProjectResourceAccessMetricsErrors[keyof GetAdminProjectResourceAccessMetricsErrors];
+export type GetAdminProjectResourceAccessMetricsResponses = {
+    /**
+     * Bucketed access counts per source
+     */
+    200: AdminProjectAccessMetrics;
+};
+export type GetAdminProjectResourceAccessMetricsResponse = GetAdminProjectResourceAccessMetricsResponses[keyof GetAdminProjectResourceAccessMetricsResponses];
+export type GetAdminProjectTopAccessedResourcesData = {
+    body?: never;
+    path: {
+        /**
+         * Project id (UUID)
+         */
+        id: string;
+    };
+    query?: {
+        /**
+         * Inclusive start of the range. Defaults to 30 days before `to`.
+         */
+        from?: string;
+        /**
+         * Exclusive end of the range. Defaults to now.
+         */
+        to?: string;
+        /**
+         * Maximum number of rows.
+         */
+        limit?: number;
+    };
+    url: '/api/v1/admin/projects/{id}/top-accessed-resources';
+};
+export type GetAdminProjectTopAccessedResourcesErrors = {
+    /**
+     * Bad request — malformed project id, `to` is not after `from`, the range
+     * exceeds the maximum span, or `limit` is out of range
+     *
+     */
+    400: ErrorResponse;
+    /**
+     * Not found — unknown project id, or the caller is not an instance admin
+     */
+    404: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type GetAdminProjectTopAccessedResourcesError = GetAdminProjectTopAccessedResourcesErrors[keyof GetAdminProjectTopAccessedResourcesErrors];
+export type GetAdminProjectTopAccessedResourcesResponses = {
+    /**
+     * The most-accessed resources, most accessed first
+     */
+    200: AdminTopAccessedResourcesResponse;
+};
+export type GetAdminProjectTopAccessedResourcesResponse = GetAdminProjectTopAccessedResourcesResponses[keyof GetAdminProjectTopAccessedResourcesResponses];
+export type GetAdminProjectConfigData = {
+    body?: never;
+    path: {
+        /**
+         * Project id (UUID)
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/api/v1/admin/projects/{id}/config';
+};
+export type GetAdminProjectConfigErrors = {
+    /**
+     * Bad request — malformed project id
+     */
+    400: ErrorResponse;
+    /**
+     * Not found — unknown project id, or the caller is not an instance admin
+     */
+    404: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type GetAdminProjectConfigError = GetAdminProjectConfigErrors[keyof GetAdminProjectConfigErrors];
+export type GetAdminProjectConfigResponses = {
+    /**
+     * The project's and the team-wide freshness rules
+     */
+    200: AdminProjectConfig;
+};
+export type GetAdminProjectConfigResponse = GetAdminProjectConfigResponses[keyof GetAdminProjectConfigResponses];
+export type GetAdminSavedFiltersData = {
+    body?: never;
+    path: {
+        /**
+         * Which admin list the presets belong to.
+         */
+        list: AdminSavedFilterListName;
+    };
+    query?: never;
+    url: '/api/v1/admin/saved-filters/{list}';
+};
+export type GetAdminSavedFiltersErrors = {
+    /**
+     * Bad request — unknown list name
+     */
+    400: ErrorResponse;
+    /**
+     * Not found — the caller is not an instance admin
+     */
+    404: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type GetAdminSavedFiltersError = GetAdminSavedFiltersErrors[keyof GetAdminSavedFiltersErrors];
+export type GetAdminSavedFiltersResponses = {
+    /**
+     * The caller's presets for this list
+     */
+    200: AdminSavedFilters;
+};
+export type GetAdminSavedFiltersResponse = GetAdminSavedFiltersResponses[keyof GetAdminSavedFiltersResponses];
+export type ReplaceAdminSavedFiltersData = {
+    body: AdminSavedFiltersReplaceRequest;
+    path: {
+        /**
+         * Which admin list the presets belong to.
+         */
+        list: AdminSavedFilterListName;
+    };
+    query?: never;
+    url: '/api/v1/admin/saved-filters/{list}';
+};
+export type ReplaceAdminSavedFiltersErrors = {
+    /**
+     * 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: ErrorResponse;
+    /**
+     * Not found — the caller is not an instance admin
+     */
+    404: ErrorResponse;
+    /**
+     * Conflict — the presets were changed elsewhere (stale `version`); nothing was saved
+     */
+    409: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type ReplaceAdminSavedFiltersError = ReplaceAdminSavedFiltersErrors[keyof ReplaceAdminSavedFiltersErrors];
+export type ReplaceAdminSavedFiltersResponses = {
+    /**
+     * The saved presets and the new version
+     */
+    200: AdminSavedFilters;
+};
+export type ReplaceAdminSavedFiltersResponse = ReplaceAdminSavedFiltersResponses[keyof ReplaceAdminSavedFiltersResponses];
 export type ListCommentsData = {
     body?: never;
     path: {