@vibexp/api-client 0.85.0 → 0.87.0

package/dist/axios/sdk.gen.js

@@ -3243,6 +3243,14 @@ export const reactivateAdminUser = (options) => (options.client ?? client).post(
  * `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.
  *
  */
@@ -3265,8 +3273,9 @@ export const listAdminProjects = (options) => (options?.client ?? client).get({
  *
  * 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.
@@ -3464,6 +3473,134 @@ 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
+});
 /**
  * List a resource's comments
  *

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

@@ -5162,6 +5162,14 @@ export type AdminProjectListItem = {
     owner: AdminTeamOwner;
     created_at: string;
     updated_at: string;
+    resource_counts: AdminProjectResourceCounts;
+    /**
+     * 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;
 };
 /**
  * A page of the instance-wide project listing.
@@ -5180,12 +5188,17 @@ export type AdminProjectListResponse = {
     total_pages: number;
 };
 /**
- * How many of each PROJECT-SCOPED resource type the project contains.
+ * 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.
  *
  */
 export type AdminProjectResourceCounts = {
@@ -5193,6 +5206,11 @@ export type AdminProjectResourceCounts = {
     artifacts: number;
     memories: number;
     blueprints: number;
+    feed_items: number;
+    /**
+     * Sum of the five project-scoped counts.
+     */
+    total: number;
 };
 /**
  * A single project with its team, owner and resource counts (GET /api/v1/admin/projects/{id}).
@@ -5395,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.
  *
@@ -5416,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 = {
@@ -5850,6 +5874,98 @@ 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>;
+};
 export type ProjectResponse = Project & {
     /**
      * Whether the project's git URL matches a repository accessible via the team's GitHub App installation
@@ -13269,10 +13385,79 @@ export type ListAdminProjectsData = {
          * Only projects created at or before this instant (inclusive).
          */
         created_to?: string;
+        /**
+         * Only projects with at least this many prompts in the project (inclusive).
+         */
+        prompt_count_min?: number;
+        /**
+         * Only projects with at most this many prompts in the project (inclusive).
+         */
+        prompt_count_max?: number;
+        /**
+         * Only projects with at least this many memories in the project (inclusive).
+         */
+        memory_count_min?: number;
+        /**
+         * Only projects with at most this many memories in the project (inclusive).
+         */
+        memory_count_max?: number;
+        /**
+         * Only projects with at least this many artifacts in the project (inclusive).
+         */
+        artifact_count_min?: number;
+        /**
+         * Only projects with at most this many artifacts in the project (inclusive).
+         */
+        artifact_count_max?: number;
+        /**
+         * Only projects with at least this many blueprints in the project (inclusive).
+         */
+        blueprint_count_min?: number;
+        /**
+         * Only projects with at most this many blueprints in the project (inclusive).
+         */
+        blueprint_count_max?: number;
+        /**
+         * Only projects with at least this many feed items in the project (inclusive).
+         */
+        feed_item_count_min?: number;
+        /**
+         * Only projects with at most this many feed items in the project (inclusive).
+         */
+        feed_item_count_max?: number;
+        /**
+         * 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;
+        /**
+         * 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;
+        /**
+         * 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;
+        /**
+         * 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;
+        /**
+         * 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;
         /**
          * 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';
+        sort_by?: 'created_at' | 'name' | 'prompt_count' | 'memory_count' | 'artifact_count' | 'blueprint_count' | 'feed_item_count' | 'total_resource_count' | 'last_resource_created_at';
         /**
          * Sort direction.
          */
@@ -13587,6 +13772,183 @@ 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 ListCommentsData = {
     body?: never;
     path: {