@vibexp/api-client 0.80.0 → 0.82.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -3067,6 +3067,184 @@ export const getAdminProject = (options) => (options.client ?? client).get({
3067
3067
  url: '/api/v1/admin/projects/{id}',
3068
3068
  ...options
3069
3069
  });
3070
+ /**
3071
+ * Get a user's resource counts
3072
+ *
3073
+ * Returns how many resources of each of the nine counted types (prompts,
3074
+ * memories, artifacts, blueprints, agents, feeds, feed items, comments,
3075
+ * attachments) the user authored: instance-wide totals, per team, and per
3076
+ * project for the four project-scoped types. Counts only — no titles, slugs or
3077
+ * content.
3078
+ *
3079
+ * Instance-admin only; non-admin and unauthenticated requests receive 404, as
3080
+ * does an unknown user id.
3081
+ *
3082
+ */
3083
+ export const getAdminUserInsights = (options) => (options.client ?? client).get({
3084
+ responseType: 'json',
3085
+ security: [{
3086
+ key: 'ApiKeyAuth',
3087
+ scheme: 'bearer',
3088
+ type: 'http'
3089
+ }, {
3090
+ in: 'cookie',
3091
+ name: 'vx_session',
3092
+ type: 'apiKey'
3093
+ }],
3094
+ url: '/api/v1/admin/users/{id}/insights',
3095
+ ...options
3096
+ });
3097
+ /**
3098
+ * Get a user's resource creation series
3099
+ *
3100
+ * Returns how many resources of each type the user created per bucket over a
3101
+ * time range. Omitting the parameters yields the last 30 days at `day`
3102
+ * granularity, and the range rules match getAdminDashboardTimeseries. Every
3103
+ * bucket is present with an explicit 0 for every type.
3104
+ *
3105
+ * Instance-admin only; non-admin and unauthenticated requests receive 404, as
3106
+ * does an unknown user id.
3107
+ *
3108
+ */
3109
+ export const getAdminUserResourceCreationMetrics = (options) => (options.client ?? client).get({
3110
+ responseType: 'json',
3111
+ security: [{
3112
+ key: 'ApiKeyAuth',
3113
+ scheme: 'bearer',
3114
+ type: 'http'
3115
+ }, {
3116
+ in: 'cookie',
3117
+ name: 'vx_session',
3118
+ type: 'apiKey'
3119
+ }],
3120
+ url: '/api/v1/admin/users/{id}/resource-creation-metrics',
3121
+ ...options
3122
+ });
3123
+ /**
3124
+ * Get a user's resource timeline
3125
+ *
3126
+ * Returns an opaque, newest-first timeline of the resources the user created
3127
+ * or updated: resource type, action, team, project and the first 8 characters
3128
+ * of the resource id — never a title, slug or content. Cursor-paginated: pass
3129
+ * the previous page's `next_cursor` to continue.
3130
+ *
3131
+ * `updated` events are APPROXIMATE, by construction of the data:
3132
+ *
3133
+ * - Only the latest `updated_at` is stored, so a resource edited many times
3134
+ * appears as ONE `updated` event, at its latest edit.
3135
+ * - There is no `updated_by` column. The event means "a resource authored by
3136
+ * this user was last modified", not "this user edited it" — a teammate's
3137
+ * edit, or a system write that bumps `updated_at` (for example a blueprint
3138
+ * GitHub re-sync or a team-wide artifact type rename), shows up here too.
3139
+ * - An update is only reported when `updated_at` is more than one second after
3140
+ * `created_at`, so a never-edited resource produces no `updated` event.
3141
+ * - Agents, feed items and attachments only ever produce `created` events.
3142
+ *
3143
+ * Deleted resources leave no trace (resources are hard-deleted).
3144
+ *
3145
+ * Instance-admin only; non-admin and unauthenticated requests receive 404, as
3146
+ * does an unknown user id.
3147
+ *
3148
+ */
3149
+ export const getAdminUserTimeline = (options) => (options.client ?? client).get({
3150
+ responseType: 'json',
3151
+ security: [{
3152
+ key: 'ApiKeyAuth',
3153
+ scheme: 'bearer',
3154
+ type: 'http'
3155
+ }, {
3156
+ in: 'cookie',
3157
+ name: 'vx_session',
3158
+ type: 'apiKey'
3159
+ }],
3160
+ url: '/api/v1/admin/users/{id}/timeline',
3161
+ ...options
3162
+ });
3163
+ /**
3164
+ * Get a user's resource access series by source
3165
+ *
3166
+ * Returns how many times the user accessed (opened) resources per bucket and
3167
+ * per access source (web, cli, mcp, api), across every team. Omitting the
3168
+ * parameters yields the last 30 days at `day` granularity, and the range
3169
+ * rules match getAdminDashboardTimeseries. Every bucket is present with an
3170
+ * explicit 0 for each source that appears in the range.
3171
+ *
3172
+ * Access events are TTL-pruned (`retention.access_event_days`), so a range
3173
+ * reaching back before `earliest_retained_at` reads as zeros there.
3174
+ *
3175
+ * Instance-admin only; non-admin and unauthenticated requests receive 404, as
3176
+ * does an unknown user id.
3177
+ *
3178
+ */
3179
+ export const getAdminUserResourceAccessMetrics = (options) => (options.client ?? client).get({
3180
+ responseType: 'json',
3181
+ security: [{
3182
+ key: 'ApiKeyAuth',
3183
+ scheme: 'bearer',
3184
+ type: 'http'
3185
+ }, {
3186
+ in: 'cookie',
3187
+ name: 'vx_session',
3188
+ type: 'apiKey'
3189
+ }],
3190
+ url: '/api/v1/admin/users/{id}/resource-access-metrics',
3191
+ ...options
3192
+ });
3193
+ /**
3194
+ * Get the resources a user accessed most
3195
+ *
3196
+ * Returns the resources the user accessed most often in a time range, across
3197
+ * every team, ranked by access count (ties broken by resource id). Rows are
3198
+ * OPAQUE: resource type, team, project and the first 8 characters of the
3199
+ * resource id — never a title, slug or content. A resource deleted since it
3200
+ * was accessed is still listed, with `resource_deleted: true` and no project.
3201
+ *
3202
+ * `from` defaults to 30 days before `to`, and `to` to now. Access events are
3203
+ * TTL-pruned (`retention.access_event_days`), so accesses before
3204
+ * `earliest_retained_at` are not counted.
3205
+ *
3206
+ * Instance-admin only; non-admin and unauthenticated requests receive 404, as
3207
+ * does an unknown user id.
3208
+ *
3209
+ */
3210
+ export const getAdminUserTopAccessedResources = (options) => (options.client ?? client).get({
3211
+ responseType: 'json',
3212
+ security: [{
3213
+ key: 'ApiKeyAuth',
3214
+ scheme: 'bearer',
3215
+ type: 'http'
3216
+ }, {
3217
+ in: 'cookie',
3218
+ name: 'vx_session',
3219
+ type: 'apiKey'
3220
+ }],
3221
+ url: '/api/v1/admin/users/{id}/top-accessed-resources',
3222
+ ...options
3223
+ });
3224
+ /**
3225
+ * Get a user's notification preferences
3226
+ *
3227
+ * Returns the user's notification preferences, read-only. A user who has never
3228
+ * saved preferences gets the defaults with `is_default: true`.
3229
+ *
3230
+ * Instance-admin only; non-admin and unauthenticated requests receive 404, as
3231
+ * does an unknown user id.
3232
+ *
3233
+ */
3234
+ export const getAdminUserNotificationPreferences = (options) => (options.client ?? client).get({
3235
+ responseType: 'json',
3236
+ security: [{
3237
+ key: 'ApiKeyAuth',
3238
+ scheme: 'bearer',
3239
+ type: 'http'
3240
+ }, {
3241
+ in: 'cookie',
3242
+ name: 'vx_session',
3243
+ type: 'apiKey'
3244
+ }],
3245
+ url: '/api/v1/admin/users/{id}/notification-preferences',
3246
+ ...options
3247
+ });
3070
3248
  /**
3071
3249
  * List a resource's comments
3072
3250
  *