@vibexp/api-client 0.99.0 → 0.101.0

package/dist/schema.d.ts

@@ -2538,6 +2538,54 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/{team_id}/statuses": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List the statuses of a resource type
+         * @description Returns every status the team may give a resource of `resource_type`: the built-in system statuses first, then the team's custom statuses. Each carries `usage_count`, the number of the team's resources currently using it. Any team member may call this.
+         */
+        get: operations["listStatuses"];
+        put?: never;
+        /**
+         * Create a custom status
+         * @description Creates a status the team can give its resources of `resource_type`. Requires the `team.settings.update` permission (team owners and admins). A team may have at most 20 custom statuses per resource type.
+         */
+        post: operations["createStatus"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/{team_id}/statuses/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete a custom status
+         * @description Deletes a custom status. Every resource of the team that carries it is moved to the resource type's default system status (`draft` for prompts, `active` otherwise) in the same transaction, and the response reports how many were moved. Moving a resource this way does not change its `updated_at`. Requires the `team.settings.update` permission (team owners and admins).
+         */
+        delete: operations["deleteStatus"];
+        options?: never;
+        head?: never;
+        /**
+         * Rename a custom status
+         * @description Changes the display name of a custom status. The slug never changes: resources store it. Requires the `team.settings.update` permission (team owners and admins).
+         */
+        patch: operations["updateStatus"];
+        trace?: never;
+    };
     "/api/v1/admin/stats": {
         parameters: {
             query?: never;
@@ -2809,7 +2857,8 @@ export interface paths {
         };
         /**
          * List a team's settings audit log
-         * @description Returns one page of the team's settings-copy audit log, newest first, with
+         * @description Returns one page of the team's settings audit log (cross-team copies and
+         *     custom status changes), newest first, with
          *     actor and source-team names resolved. Each entry's `detail` is filtered to
          *     a per-surface key allowlist, so no credential can surface here.
          *     Read-only. Instance-admin only; non-admin and unauthenticated requests
@@ -4468,7 +4517,7 @@ export interface paths {
         };
         /**
          * List the team's settings audit log
-         * @description Every configuration copied into this team from another team, newest first and paginated, with the actor and source-team names resolved server-side. Requires the team.settings.update permission (owner or admin). The list is empty, never null, past the last page.
+         * @description Every configuration copied into this team from another team, and every custom status created, renamed or deleted in it, newest first and paginated, with the actor and source-team names resolved server-side. Requires the team.settings.update permission (owner or admin). The list is empty, never null, past the last page.
          */
         get: operations["listTeamSettingsAudit"];
         put?: never;
@@ -5991,35 +6040,31 @@ export interface components {
             total_pages: number;
         };
         /**
-         * @description The complete status vocabulary shared by prompts, artifacts, blueprints and memories. Each resource type accepts a named subset of these values, never the whole set; see PromptStatus, ArtifactStatus, BlueprintStatus and MemoryStatus.
+         * @description The system status vocabulary shared by prompts, artifacts, blueprints and memories. Each resource type has a named subset of these values as its system statuses; see PromptStatus, ArtifactStatus, BlueprintStatus and MemoryStatus. A team's custom status may not reuse any of these values.
          * @example active
          * @enum {string}
          */
         ResourceStatus: "active" | "draft" | "archived" | "published" | "expired";
         /**
-         * @description Publication status of a prompt. A prompt is only exposed over MCP once it is `published`.
+         * @description Status of a prompt. The system values are `draft` and `published`; a prompt is only exposed over MCP once it is `published`. A team may define further statuses of its own for prompts, so this is an open string: any other value must be one of the team's custom prompt statuses, or the request is rejected with 400.
          * @example published
-         * @enum {string}
          */
-        PromptStatus: "draft" | "published";
+        PromptStatus: string;
         /**
-         * @description Lifecycle status of an artifact.
+         * @description Status of an artifact. The system values are `active`, `draft` and `archived`. A team may define further statuses of its own for artifacts, so this is an open string: any other value must be one of the team's custom artifact statuses, or the request is rejected with 400.
          * @example active
-         * @enum {string}
          */
-        ArtifactStatus: "active" | "draft" | "archived";
+        ArtifactStatus: string;
         /**
-         * @description Lifecycle status of a blueprint. `expired` marks a blueprint whose rules no longer apply but whose content is kept for reference.
+         * @description Status of a blueprint. The system values are `active` and `expired`; `expired` marks a blueprint whose rules no longer apply but whose content is kept for reference. A team may define further statuses of its own for blueprints, so this is an open string: any other value must be one of the team's custom blueprint statuses, or the request is rejected with 400.
          * @example active
-         * @enum {string}
          */
-        BlueprintStatus: "active" | "expired";
+        BlueprintStatus: string;
         /**
-         * @description Lifecycle status of a memory.
+         * @description Status of a memory. The system values are `active`, `draft` and `archived`. A team may define further statuses of its own for memories, so this is an open string: any other value must be one of the team's custom memory statuses, or the request is rejected with 400.
          * @example active
-         * @enum {string}
          */
-        MemoryStatus: "active" | "draft" | "archived";
+        MemoryStatus: string;
         /** @description Per-source access counts for a single calendar day (UTC), zero-filled. */
         ResourceAccessDailyCount: {
             /**
@@ -10498,6 +10543,99 @@ export interface components {
              */
             skipped_count: number;
         };
+        /**
+         * @description A resource type that carries a status. Singular, as in the comment and relation APIs.
+         * @example artifact
+         * @enum {string}
+         */
+        StatusResourceType: "prompt" | "artifact" | "blueprint" | "memory";
+        /** @description One status a team may give a resource of `resource_type`. A system status (`is_system: true`) is built in, identical for every team and cannot be renamed or deleted; it has no `id` and no timestamps. A custom status belongs to the team. */
+        StatusDefinition: {
+            /**
+             * Format: uuid
+             * @description Identifier of a custom status. Absent for a system status.
+             * @example 550e8400-e29b-41d4-a716-446655440000
+             */
+            id?: string;
+            resource_type: components["schemas"]["StatusResourceType"];
+            /**
+             * @description The value stored on the resource. Unique per team and resource type, and immutable once created.
+             * @example in-review
+             */
+            slug: string;
+            /**
+             * @description Human-readable display name
+             * @example In review
+             */
+            name: string;
+            /**
+             * @description True for a built-in status, which cannot be renamed or deleted
+             * @example false
+             */
+            is_system: boolean;
+            /**
+             * @description Whether a resource carrying this status counts as live, usable content. False only for the built-in work-in-progress and retired statuses (`draft`, `archived`, `expired`); always true for a custom status.
+             * @example true
+             */
+            is_live: boolean;
+            /**
+             * @description How many of the team's resources of this type currently carry the status. For a custom status this is the number of resources a delete would move to the default status.
+             * @example 12
+             */
+            usage_count: number;
+            /**
+             * Format: date-time
+             * @description When the custom status was created. Absent for a system status.
+             * @example 2026-06-15T09:00:00Z
+             */
+            created_at?: string;
+            /**
+             * Format: date-time
+             * @description When the custom status was last renamed. Absent for a system status.
+             * @example 2026-06-15T09:00:00Z
+             */
+            updated_at?: string;
+        };
+        /** @description The system statuses of a resource type followed by the team's custom ones */
+        StatusListResponse: {
+            /** @description System statuses first, in their built-in order, then custom statuses by name */
+            statuses: components["schemas"]["StatusDefinition"][];
+        };
+        /** @description Request body for creating a custom status */
+        CreateStatusRequest: {
+            resource_type: components["schemas"]["StatusResourceType"];
+            /**
+             * @description Lowercase letters and numbers in hyphen-separated groups, at most 50 characters. It cannot be one of the built-in statuses (`active`, `draft`, `archived`, `published`, `expired`), whichever resource type the status is for, and it cannot be changed later.
+             * @example in-review
+             */
+            slug: string;
+            /**
+             * @description Display name. Surrounding whitespace is trimmed, and what remains must be 1 to 50 characters.
+             * @example In review
+             */
+            name: string;
+        };
+        /** @description Request body for renaming a custom status. Only the display name can change; any other field, including `slug`, is rejected. */
+        UpdateStatusRequest: {
+            /**
+             * @description New display name. Surrounding whitespace is trimmed, and what remains must be 1 to 50 characters.
+             * @example Under review
+             */
+            name: string;
+        };
+        /** @description The outcome of deleting a custom status */
+        DeleteStatusResponse: {
+            /**
+             * @description How many resources carried the status and were moved to `reassigned_to`
+             * @example 12
+             */
+            reassigned_count: number;
+            /**
+             * @description The system status those resources now carry: `draft` for prompts, `active` for every other resource type.
+             * @example active
+             */
+            reassigned_to: string;
+        };
         /** @description A team-visible comment on a resource. */
         Comment: {
             /**
@@ -11426,12 +11564,12 @@ export interface components {
             max_output_tokens: number;
         };
         /**
-         * @description Which settings surface was copied between teams.
+         * @description Which settings surface the entry is about. `embedding_provider`, `model_provider` and `custom_types` record a copy from another team; `custom_statuses` records a custom status being created, renamed or deleted in this team.
          * @example model_provider
          * @enum {string}
          */
-        TeamSettingsAuditSurface: "embedding_provider" | "model_provider" | "custom_types";
-        /** @description One recorded settings copy into this team: which surface arrived, who brought it, and where it came from. */
+        TeamSettingsAuditSurface: "embedding_provider" | "model_provider" | "custom_types" | "custom_statuses";
+        /** @description One recorded change to this team's settings: a configuration copied in from another team (which surface arrived, who brought it, and where it came from), or a custom status created, renamed or deleted here. */
         TeamSettingsAuditEntry: {
             /**
              * Format: uuid
@@ -11441,7 +11579,7 @@ export interface components {
             surface: components["schemas"]["TeamSettingsAuditSurface"];
             /**
              * Format: uuid
-             * @description Who performed the copy. `null` once that account is deleted — the entry outlives the actor on purpose, so that deletion cannot erase the record of what the account did.
+             * @description Who made the change. `null` once that account is deleted — the entry outlives the actor on purpose, so that deletion cannot erase the record of what the account did.
              */
             actor_user_id: string | null;
             /**
@@ -11451,26 +11589,26 @@ export interface components {
             actor_name: string | null;
             /**
              * Format: uuid
-             * @description The team the configuration was copied FROM.
+             * @description The team the configuration was copied FROM. `null` for a `custom_statuses` entry, which has no source team.
              */
             source_team_id: string | null;
             /**
-             * @description The source team's name, resolved server-side. `null` when that team has since been deleted — the id above is then the only remaining handle on it, and is deliberately still present rather than blanked.
+             * @description The source team's name, resolved server-side. `null` when that team has since been deleted — the id above is then the only remaining handle on it, and is deliberately still present rather than blanked. Also `null` for a `custom_statuses` entry.
              * @example Platform Team
              */
             source_team_name: string | null;
             /**
              * Format: uuid
-             * @description The resource that was copied. `null` for a `custom_types` copy, where one action copies a whole set and the individual ids live in `detail`.
+             * @description The resource that was copied. `null` for a `custom_types` copy, where one action copies a whole set and the individual ids live in `detail`, and for a `custom_statuses` entry, which copies nothing.
              */
             source_resource_id: string | null;
             /**
              * Format: uuid
-             * @description The resource created in this team. `null` for a `custom_types` copy, for the same reason as `source_resource_id`.
+             * @description The resource created in this team. `null` for a `custom_types` copy, for the same reason as `source_resource_id`. For a `custom_statuses` entry it is the id of a newly created status, and `null` for a rename or a delete.
              */
             created_resource_id: string | null;
             /**
-             * @description Surface-specific facts snapshotted at write time — resource names, and for a provider copy whether it carried a credential and whether it became the team's active provider. Always an object, never null.
+             * @description Surface-specific facts snapshotted at write time — resource names, and for a provider copy whether it carried a credential and whether it became the team's active provider. A `custom_statuses` entry carries `action` (`created`, `renamed` or `deleted`), `resource_type`, `slug` and `name`, plus `previous_name` for a rename and `reassigned_count` and `reassigned_to` for a delete. Always an object, never null.
              * @example {
              *       "source_name": "OpenAI (Platform)",
              *       "created_name": "OpenAI (Platform)",
@@ -11482,7 +11620,7 @@ export interface components {
             };
             /**
              * Format: date-time
-             * @description When the copy was recorded.
+             * @description When the change was recorded.
              */
             created_at: string;
         };
@@ -12650,12 +12788,12 @@ export interface components {
             /** @description System types first, then custom types, each by name. */
             types: components["schemas"]["AdminArtifactType"][];
         };
-        /** @description One recorded settings copy into the team. */
+        /** @description One recorded change to the team's settings: a configuration copied in from another team, or (`custom_statuses`) a custom status created, renamed or deleted. */
         AdminTeamSettingsAuditEntry: {
             /** Format: uuid */
             id: string;
             /** @enum {string} */
-            surface: "embedding_provider" | "model_provider" | "custom_types";
+            surface: "embedding_provider" | "model_provider" | "custom_types" | "custom_statuses";
             /** Format: uuid */
             actor_user_id: string | null;
             actor_name: string | null;
@@ -12671,8 +12809,9 @@ export interface components {
              *     (model_provider: source_name, created_name, provider_type, model,
              *     has_api_key; embedding_provider: the same plus becomes_active,
              *     displaced_model, displaced_embedded_resources; custom_types: added_ids,
-             *     added_slugs, skipped_slugs). Any other stored key is dropped. Always an
-             *     object, never null.
+             *     added_slugs, skipped_slugs; custom_statuses: action, resource_type,
+             *     slug, name, previous_name, reassigned_count, reassigned_to). Any other
+             *     stored key is dropped. Always an object, never null.
              */
             detail: {
                 [key: string]: unknown;
@@ -15250,7 +15389,7 @@ export interface operations {
                 freshness?: "stale";
                 /** @description Filter by project ID */
                 project_id?: string;
-                /** @description Filter by status */
+                /** @description Filter by status: one of the system statuses or one of the team's custom statuses for this resource type. Returns 400 for unknown values. */
                 status?: components["schemas"]["ArtifactStatus"];
                 /** @description Filter by type. An open string matched against the team's registered types (the system defaults work_reports, static_contexts and general, plus any custom types the team has added), not a fixed enum. */
                 type?: string;
@@ -15431,7 +15570,7 @@ export interface operations {
             query?: {
                 /** @description Filter to resources currently flagged stale by the team's freshness rules (epic #726). Omit for no freshness filtering. Returns 400 for any other value — a silently ignored filter would return the full list, which looks like a legitimate answer. */
                 freshness?: "stale";
-                /** @description Filter by status */
+                /** @description Filter by status: one of the system statuses or one of the team's custom statuses for this resource type. Returns 400 for unknown values. */
                 status?: components["schemas"]["ArtifactStatus"];
                 /** @description Filter by type. An open string matched against the team's registered types (the system defaults work_reports, static_contexts and general, plus any custom types the team has added), not a fixed enum. */
                 type?: string;
@@ -17147,7 +17286,7 @@ export interface operations {
                 project_name?: string;
                 /** @description Filter by project ID. On this team-scoped variant the backend reads it only when a project is not already selected via a path parameter (i.e. not on listSpecLibrariesByProject). */
                 project_id?: string;
-                /** @description Filter by status */
+                /** @description Filter by status: one of the system statuses or one of the team's custom statuses for this resource type. Returns 400 for unknown values. */
                 status?: components["schemas"]["BlueprintStatus"];
                 /** @description Filter by type */
                 type?: "general" | "claude-code" | "claude" | "cursor" | "codex";
@@ -17344,7 +17483,7 @@ export interface operations {
             query?: {
                 /** @description Filter to resources currently flagged stale by the team's freshness rules (epic #726). Omit for no freshness filtering. Returns 400 for any other value — a silently ignored filter would return the full list, which looks like a legitimate answer. */
                 freshness?: "stale";
-                /** @description Filter by status */
+                /** @description Filter by status: one of the system statuses or one of the team's custom statuses for this resource type. Returns 400 for unknown values. */
                 status?: components["schemas"]["BlueprintStatus"];
                 /** @description Filter by type */
                 type?: "general" | "claude-code" | "claude" | "cursor" | "codex";
@@ -17824,7 +17963,7 @@ export interface operations {
                 limit?: number;
                 /** @description Search term to filter prompts by name or description */
                 search?: string;
-                /** @description Filter by prompt status */
+                /** @description Filter by status: one of the system statuses or one of the team's custom statuses for this resource type. Returns 400 for unknown values. */
                 status?: components["schemas"]["PromptStatus"];
                 /**
                  * @description Comma-separated list of labels to filter by. A resource matches when it carries at least one of the listed labels. At most 25 labels, each at most 50 characters; beyond that the request is rejected with 400.
@@ -23264,6 +23403,284 @@ export interface operations {
             };
         };
     };
+    listStatuses: {
+        parameters: {
+            query: {
+                /** @description Resource type whose statuses to list */
+                resource_type: components["schemas"]["StatusResourceType"];
+            };
+            header?: never;
+            path: {
+                /** @description Team identifier */
+                team_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Statuses retrieved successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StatusListResponse"];
+                };
+            };
+            /** @description Missing or unsupported resource_type, or malformed team id */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Caller is not a member of the team */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Failed to list statuses */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    createStatus: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Team identifier */
+                team_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateStatusRequest"];
+            };
+        };
+        responses: {
+            /** @description Status created successfully */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StatusDefinition"];
+                };
+            };
+            /** @description Unknown body field, unsupported resource_type, invalid slug or name, or the team already has 20 custom statuses for this resource type */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Caller is not a member of the team, or is a member whose role may not change team settings */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description The slug is a built-in status, or the team already has a status with this slug for this resource type */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Failed to create status */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    deleteStatus: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Team identifier */
+                team_id: string;
+                /** @description Custom status identifier */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Status deleted and its resources reassigned */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DeleteStatusResponse"];
+                };
+            };
+            /** @description Status id or team id is not a valid UUID */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Caller is not a member of the team, or is a member whose role may not change team settings */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description No custom status with this id exists in the team */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Failed to delete status */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    updateStatus: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Team identifier */
+                team_id: string;
+                /** @description Custom status identifier */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateStatusRequest"];
+            };
+        };
+        responses: {
+            /** @description Status renamed successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["StatusDefinition"];
+                };
+            };
+            /** @description Unknown body field (including slug), invalid name, or malformed id */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Caller is not a member of the team, or is a member whose role may not change team settings */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description No custom status with this id exists in the team */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description Failed to rename status */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     getAdminStats: {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibexp/api-client",
-  "version": "0.99.0",
+  "version": "0.101.0",
   "description": "Typed VibeXP API client generated from the OpenAPI spec (openapi-fetch main entrypoint, axios SDK at ./axios)",
   "license": "MIT",
   "repository": {