@vibexp/api-client 0.103.0 → 0.105.0

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

@@ -363,6 +363,10 @@ export type Prompt = {
      */
     project: ProjectSummary | null;
     freshness?: ResourceFreshnessState;
+    /**
+     * The lock held on this resource (epic #1285), or null when it is not locked. Present on every read, list and write response. Always null on a prompt read through a share link: lock state is internal to the team.
+     */
+    lock: ResourceLock | null;
 };
 export type CreatePromptRequest = {
     name: string;
@@ -1593,6 +1597,10 @@ export type Artifact = {
      */
     project: ProjectSummary | null;
     freshness?: ResourceFreshnessState;
+    /**
+     * The lock held on this resource (epic #1285), or null when it is not locked. Present on every read, list and write response.
+     */
+    lock: ResourceLock | null;
 };
 export type CreateArtifactRequest = {
     /**
@@ -2055,6 +2063,101 @@ export type ProjectSummary = {
      */
     slug: string;
 };
+/**
+ * A user named on a resource lock or a lock history event.
+ */
+export type ResourceLockActor = {
+    /**
+     * ID of the user.
+     */
+    user_id: string;
+    /**
+     * The user's display name.
+     */
+    display_name: string;
+};
+/**
+ * The lock held on a prompt, blueprint or artifact. A resource carries one while it is locked and `null` when it is not.
+ */
+export type ResourceLock = {
+    /**
+     * The team member holding the lock.
+     */
+    locked_by: ResourceLockActor;
+    /**
+     * Why the resource was locked, as given by the locker.
+     */
+    comment: string;
+    /**
+     * When the lock was taken.
+     */
+    locked_at: string;
+};
+/**
+ * RFC 9457 problem returned with `423 Locked` and code `RESOURCE_WRITE_LOCKED` when a write is refused because the prompt, blueprint or artifact is locked. A locked resource cannot be deleted, and an update may not change one of its frozen fields; content, title/name and description stay editable. Unlock the resource to make the change.
+ *
+ * Frozen fields, as `metadata.field` names them: `slug`, `status`, `project_id`, `labels` and `mcp_expose` on a prompt; `slug`, `status`, `type`, `subtype`, `project_id`, `labels`, `metadata` and `path` on a blueprint; `slug`, `status`, `type`, `project_id`, `labels` and `metadata` on an artifact. A frozen field sent with its current value is not a change.
+ */
+export type ResourceWriteLockedError = ErrorResponse & {
+    /**
+     * The lock that refused the write.
+     */
+    metadata: {
+        /**
+         * The kind of resource that is locked.
+         */
+        resource_type: 'prompt' | 'blueprint' | 'artifact';
+        /**
+         * The frozen field the update tried to change, by its request name. Absent when a delete was refused.
+         */
+        field?: string;
+        /**
+         * The team member holding the lock.
+         */
+        locked_by: ResourceLockActor;
+        /**
+         * Why the resource was locked, as given by the locker.
+         */
+        comment: string;
+    };
+};
+export type LockResourceRequest = {
+    /**
+     * Why the resource is being locked. Required: surrounding whitespace is trimmed, and a comment that is then empty or longer than 500 characters is rejected with 400.
+     */
+    comment: string;
+};
+/**
+ * One entry of a resource's append-only lock history.
+ */
+export type ResourceLockEvent = {
+    /**
+     * ID of the history event.
+     */
+    id: string;
+    /**
+     * Whether the resource was locked or unlocked.
+     */
+    action: 'lock' | 'unlock';
+    /**
+     * Who locked or unlocked the resource. Null once that user's account has been deleted.
+     */
+    actor: ResourceLockActor | null;
+    /**
+     * The lock comment for a `lock` event; null for an `unlock`.
+     */
+    comment: string | null;
+    /**
+     * When the event happened.
+     */
+    created_at: string;
+};
+export type ResourceLockHistoryResponse = {
+    /**
+     * Lock and unlock events, newest first. Not paginated: at most the 100 most recent events are returned.
+     */
+    events: Array<ResourceLockEvent>;
+};
 export type CreateProjectRequest = {
     /**
      * Human-readable name of the project
@@ -2565,6 +2668,10 @@ export type Blueprint = {
      */
     project: ProjectSummary | null;
     freshness?: ResourceFreshnessState;
+    /**
+     * The lock held on this resource (epic #1285), or null when it is not locked. Present on every read, list and write response.
+     */
+    lock: ResourceLock | null;
 };
 /**
  * Read-only import provenance; present only for imported blueprints.
@@ -7902,6 +8009,10 @@ export type ListArtifactsData = {
         team_id: string;
     };
     query?: {
+        /**
+         * Filter by lock state (epic #1285): `true` returns only locked resources, `false` only unlocked ones. Omit for no lock filtering. Returns 400 for a value that is not a boolean.
+         */
+        locked?: boolean;
         /**
          * 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.
          */
@@ -8050,6 +8161,10 @@ export type ListArtifactsByProjectData = {
         project_id: string;
     };
     query?: {
+        /**
+         * Filter by lock state (epic #1285): `true` returns only locked resources, `false` only unlocked ones. Omit for no lock filtering. Returns 400 for a value that is not a boolean.
+         */
+        locked?: boolean;
         /**
          * 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.
          */
@@ -8147,6 +8262,10 @@ export type DeleteArtifactErrors = {
      * Artifact not found
      */
     404: ErrorResponse;
+    /**
+     * The artifact is locked, so it cannot be deleted (code `RESOURCE_WRITE_LOCKED`). The lock is in `metadata`.
+     */
+    423: ResourceWriteLockedError;
 };
 export type DeleteArtifactError = DeleteArtifactErrors[keyof DeleteArtifactErrors];
 export type DeleteArtifactResponses = {
@@ -8237,6 +8356,10 @@ export type UpdateArtifactErrors = {
      * Artifact with same slug already exists in project
      */
     409: ErrorResponse;
+    /**
+     * The artifact is locked and the update changes a frozen field (code `RESOURCE_WRITE_LOCKED`). The lock is in `metadata`.
+     */
+    423: ResourceWriteLockedError;
 };
 export type UpdateArtifactError = UpdateArtifactErrors[keyof UpdateArtifactErrors];
 export type UpdateArtifactResponses = {
@@ -8246,6 +8369,161 @@ export type UpdateArtifactResponses = {
     200: Artifact;
 };
 export type UpdateArtifactResponse = UpdateArtifactResponses[keyof UpdateArtifactResponses];
+export type UnlockArtifactData = {
+    body?: never;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+        /**
+         * UUID of the project
+         */
+        project_id: string;
+        /**
+         * Artifact slug
+         */
+        slug: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/artifacts/{project_id}/{slug}/lock';
+};
+export type UnlockArtifactErrors = {
+    /**
+     * Bad request: a malformed path parameter
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden: not a member of the team, or the lock was placed by someone else and the caller's role does not hold `resource.unlock.any`
+     */
+    403: ErrorResponse;
+    /**
+     * Artifact not found
+     */
+    404: ErrorResponse;
+    /**
+     * The artifact is not locked (code `RESOURCE_NOT_LOCKED`)
+     */
+    409: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type UnlockArtifactError = UnlockArtifactErrors[keyof UnlockArtifactErrors];
+export type UnlockArtifactResponses = {
+    /**
+     * Artifact unlocked; the updated artifact is returned
+     */
+    200: Artifact;
+};
+export type UnlockArtifactResponse = UnlockArtifactResponses[keyof UnlockArtifactResponses];
+export type LockArtifactData = {
+    body: LockResourceRequest;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+        /**
+         * UUID of the project
+         */
+        project_id: string;
+        /**
+         * Artifact slug
+         */
+        slug: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/artifacts/{project_id}/{slug}/lock';
+};
+export type LockArtifactErrors = {
+    /**
+     * Bad request: a malformed path parameter or request body, or a missing, blank or too long comment
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden: not a member of the team
+     */
+    403: ErrorResponse;
+    /**
+     * Artifact not found
+     */
+    404: ErrorResponse;
+    /**
+     * The artifact is already locked (code `RESOURCE_LOCKED`)
+     */
+    409: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type LockArtifactError = LockArtifactErrors[keyof LockArtifactErrors];
+export type LockArtifactResponses = {
+    /**
+     * Artifact locked; the updated artifact is returned
+     */
+    200: Artifact;
+};
+export type LockArtifactResponse = LockArtifactResponses[keyof LockArtifactResponses];
+export type GetArtifactLockHistoryData = {
+    body?: never;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+        /**
+         * UUID of the project
+         */
+        project_id: string;
+        /**
+         * Artifact slug
+         */
+        slug: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/artifacts/{project_id}/{slug}/lock/history';
+};
+export type GetArtifactLockHistoryErrors = {
+    /**
+     * Bad request: a malformed path parameter
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden: not a member of the team
+     */
+    403: ErrorResponse;
+    /**
+     * Artifact not found
+     */
+    404: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type GetArtifactLockHistoryError = GetArtifactLockHistoryErrors[keyof GetArtifactLockHistoryErrors];
+export type GetArtifactLockHistoryResponses = {
+    /**
+     * Lock history retrieved successfully
+     */
+    200: ResourceLockHistoryResponse;
+};
+export type GetArtifactLockHistoryResponse = GetArtifactLockHistoryResponses[keyof GetArtifactLockHistoryResponses];
 export type ListAttachmentsData = {
     body?: never;
     path: {
@@ -9305,6 +9583,10 @@ export type ListSpecLibrariesData = {
         team_id: string;
     };
     query?: {
+        /**
+         * Filter by lock state (epic #1285): `true` returns only locked resources, `false` only unlocked ones. Omit for no lock filtering. Returns 400 for a value that is not a boolean.
+         */
+        locked?: boolean;
         /**
          * 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.
          */
@@ -9461,6 +9743,10 @@ export type ListSpecLibrariesByProjectData = {
         project_id: string;
     };
     query?: {
+        /**
+         * Filter by lock state (epic #1285): `true` returns only locked resources, `false` only unlocked ones. Omit for no lock filtering. Returns 400 for a value that is not a boolean.
+         */
+        locked?: boolean;
         /**
          * 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.
          */
@@ -9562,6 +9848,10 @@ export type DeleteBlueprintErrors = {
      * Spec library not found
      */
     404: ErrorResponse;
+    /**
+     * The blueprint is locked, so it cannot be deleted (code `RESOURCE_WRITE_LOCKED`). The lock is in `metadata`.
+     */
+    423: ResourceWriteLockedError;
     /**
      * Internal server error
      */
@@ -9660,6 +9950,10 @@ export type UpdateBlueprintErrors = {
      * Spec library with same slug already exists in project
      */
     409: ErrorResponse;
+    /**
+     * The blueprint is locked and the update changes a frozen field (code `RESOURCE_WRITE_LOCKED`). The lock is in `metadata`.
+     */
+    423: ResourceWriteLockedError;
     /**
      * Internal server error
      */
@@ -9673,6 +9967,161 @@ export type UpdateBlueprintResponses = {
     200: Blueprint;
 };
 export type UpdateBlueprintResponse = UpdateBlueprintResponses[keyof UpdateBlueprintResponses];
+export type UnlockBlueprintData = {
+    body?: never;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+        /**
+         * Project identifier (URL-encoded)
+         */
+        project_id: string;
+        /**
+         * Blueprint slug (URL-encoded)
+         */
+        slug: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/blueprints/{project_id}/{slug}/lock';
+};
+export type UnlockBlueprintErrors = {
+    /**
+     * Bad request: a malformed path parameter
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden: not a member of the team, or the lock was placed by someone else and the caller's role does not hold `resource.unlock.any`
+     */
+    403: ErrorResponse;
+    /**
+     * Blueprint not found
+     */
+    404: ErrorResponse;
+    /**
+     * The blueprint is not locked (code `RESOURCE_NOT_LOCKED`)
+     */
+    409: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type UnlockBlueprintError = UnlockBlueprintErrors[keyof UnlockBlueprintErrors];
+export type UnlockBlueprintResponses = {
+    /**
+     * Blueprint unlocked; the updated blueprint is returned
+     */
+    200: BlueprintDetail;
+};
+export type UnlockBlueprintResponse = UnlockBlueprintResponses[keyof UnlockBlueprintResponses];
+export type LockBlueprintData = {
+    body: LockResourceRequest;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+        /**
+         * Project identifier (URL-encoded)
+         */
+        project_id: string;
+        /**
+         * Blueprint slug (URL-encoded)
+         */
+        slug: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/blueprints/{project_id}/{slug}/lock';
+};
+export type LockBlueprintErrors = {
+    /**
+     * Bad request: a malformed path parameter or request body, or a missing, blank or too long comment
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden: not a member of the team
+     */
+    403: ErrorResponse;
+    /**
+     * Blueprint not found
+     */
+    404: ErrorResponse;
+    /**
+     * The blueprint is already locked (code `RESOURCE_LOCKED`)
+     */
+    409: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type LockBlueprintError = LockBlueprintErrors[keyof LockBlueprintErrors];
+export type LockBlueprintResponses = {
+    /**
+     * Blueprint locked; the updated blueprint is returned
+     */
+    200: BlueprintDetail;
+};
+export type LockBlueprintResponse = LockBlueprintResponses[keyof LockBlueprintResponses];
+export type GetBlueprintLockHistoryData = {
+    body?: never;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+        /**
+         * Project identifier (URL-encoded)
+         */
+        project_id: string;
+        /**
+         * Blueprint slug (URL-encoded)
+         */
+        slug: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/blueprints/{project_id}/{slug}/lock/history';
+};
+export type GetBlueprintLockHistoryErrors = {
+    /**
+     * Bad request: a malformed path parameter
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden: not a member of the team
+     */
+    403: ErrorResponse;
+    /**
+     * Blueprint not found
+     */
+    404: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type GetBlueprintLockHistoryError = GetBlueprintLockHistoryErrors[keyof GetBlueprintLockHistoryErrors];
+export type GetBlueprintLockHistoryResponses = {
+    /**
+     * Lock history retrieved successfully
+     */
+    200: ResourceLockHistoryResponse;
+};
+export type GetBlueprintLockHistoryResponse = GetBlueprintLockHistoryResponses[keyof GetBlueprintLockHistoryResponses];
 export type ListBlueprintVersionsData = {
     body?: never;
     path: {
@@ -9821,6 +10270,10 @@ export type ListPromptsData = {
         team_id: string;
     };
     query?: {
+        /**
+         * Filter by lock state (epic #1285): `true` returns only locked resources, `false` only unlocked ones. Omit for no lock filtering. Returns 400 for a value that is not a boolean.
+         */
+        locked?: boolean;
         /**
          * 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.
          */
@@ -9984,6 +10437,10 @@ export type DeletePromptErrors = {
      * Prompt not found
      */
     404: ErrorResponse;
+    /**
+     * The prompt is locked, so it cannot be deleted (code `RESOURCE_WRITE_LOCKED`). The lock is in `metadata`.
+     */
+    423: ResourceWriteLockedError;
 };
 export type DeletePromptError = DeletePromptErrors[keyof DeletePromptErrors];
 export type DeletePromptResponses = {
@@ -10066,6 +10523,10 @@ export type UpdatePromptErrors = {
      * Conflict (slug already exists)
      */
     409: ErrorResponse;
+    /**
+     * The prompt is locked and the update changes a frozen field (code `RESOURCE_WRITE_LOCKED`). The lock is in `metadata`.
+     */
+    423: ResourceWriteLockedError;
 };
 export type UpdatePromptError = UpdatePromptErrors[keyof UpdatePromptErrors];
 export type UpdatePromptResponses = {
@@ -10075,6 +10536,149 @@ export type UpdatePromptResponses = {
     200: Prompt;
 };
 export type UpdatePromptResponse = UpdatePromptResponses[keyof UpdatePromptResponses];
+export type UnlockPromptData = {
+    body?: never;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+        /**
+         * Prompt slug identifier
+         */
+        slug: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/prompts/{slug}/lock';
+};
+export type UnlockPromptErrors = {
+    /**
+     * Bad request: a malformed path parameter
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden: not a member of the team, or the lock was placed by someone else and the caller's role does not hold `resource.unlock.any`
+     */
+    403: ErrorResponse;
+    /**
+     * Prompt not found
+     */
+    404: ErrorResponse;
+    /**
+     * The prompt is not locked (code `RESOURCE_NOT_LOCKED`)
+     */
+    409: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type UnlockPromptError = UnlockPromptErrors[keyof UnlockPromptErrors];
+export type UnlockPromptResponses = {
+    /**
+     * Prompt unlocked; the updated prompt is returned
+     */
+    200: Prompt;
+};
+export type UnlockPromptResponse = UnlockPromptResponses[keyof UnlockPromptResponses];
+export type LockPromptData = {
+    body: LockResourceRequest;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+        /**
+         * Prompt slug identifier
+         */
+        slug: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/prompts/{slug}/lock';
+};
+export type LockPromptErrors = {
+    /**
+     * Bad request: a malformed path parameter or request body, or a missing, blank or too long comment
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden: not a member of the team
+     */
+    403: ErrorResponse;
+    /**
+     * Prompt not found
+     */
+    404: ErrorResponse;
+    /**
+     * The prompt is already locked (code `RESOURCE_LOCKED`)
+     */
+    409: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type LockPromptError = LockPromptErrors[keyof LockPromptErrors];
+export type LockPromptResponses = {
+    /**
+     * Prompt locked; the updated prompt is returned
+     */
+    200: Prompt;
+};
+export type LockPromptResponse = LockPromptResponses[keyof LockPromptResponses];
+export type GetPromptLockHistoryData = {
+    body?: never;
+    path: {
+        /**
+         * Team identifier
+         */
+        team_id: string;
+        /**
+         * Prompt slug identifier
+         */
+        slug: string;
+    };
+    query?: never;
+    url: '/api/v1/{team_id}/prompts/{slug}/lock/history';
+};
+export type GetPromptLockHistoryErrors = {
+    /**
+     * Bad request: a malformed path parameter
+     */
+    400: ErrorResponse;
+    /**
+     * Unauthorized
+     */
+    401: ErrorResponse;
+    /**
+     * Forbidden: not a member of the team
+     */
+    403: ErrorResponse;
+    /**
+     * Prompt not found
+     */
+    404: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+export type GetPromptLockHistoryError = GetPromptLockHistoryErrors[keyof GetPromptLockHistoryErrors];
+export type GetPromptLockHistoryResponses = {
+    /**
+     * Lock history retrieved successfully
+     */
+    200: ResourceLockHistoryResponse;
+};
+export type GetPromptLockHistoryResponse = GetPromptLockHistoryResponses[keyof GetPromptLockHistoryResponses];
 export type GetPromptPlaceholdersData = {
     body?: never;
     path: {