@vibexp/api-client 0.102.0 → 0.104.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,73 @@ 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;
+};
+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 +2640,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.
@@ -3328,9 +3407,9 @@ export type Team = {
     /**
      * Exactly what `role` permits the requesting user to do in this team, expanded server-side from the role matrix (epic #220). Clients MUST gate their UI on these strings rather than re-deriving them from `role` — the matrix lives on the server and may change without a client release.
      * Computed at read time for the requesting user, alongside `role`, and always present (an empty array means the role grants nothing). The values are stable API surface: renaming one is a breaking change, and they are kept byte-identical to the `internal/authz` constants by a drift test. Meanings:
-     * * `team.update` — change team name, slug or description. * `team.delete` — delete the team (owner only). * `team.transfer` — transfer ownership to another member (owner only). * `team.settings.update` — change team-level configuration, such as search ranking. * `member.invite` — invite new members. * `member.remove` — remove members from the team. * `member.role.update` — change a member's role. * `project.create` — create a project in the team. * `project.update` — update any project in the team. * `project.delete` — delete any project in the team. * `resource.create` — create a prompt, memory, artifact, blueprint or agent. * `resource.update.any` — update any resource, including other members'. * `resource.delete.own` — delete a resource the caller created. * `resource.delete.any` — delete a resource created by someone else. * `feed.delete.any` — delete another member's feed post or reply (moderation).
+     * * `team.update` — change team name, slug or description. * `team.delete` — delete the team (owner only). * `team.transfer` — transfer ownership to another member (owner only). * `team.settings.update` — change team-level configuration, such as search ranking. * `member.invite` — invite new members. * `member.remove` — remove members from the team. * `member.role.update` — change a member's role. * `project.create` — create a project in the team. * `project.update` — update any project in the team. * `project.delete` — delete any project in the team. * `resource.create` — create a prompt, memory, artifact, blueprint or agent. * `resource.update.any` — update any resource, including other members'. * `resource.delete.own` — delete a resource the caller created. * `resource.delete.any` — delete a resource created by someone else. * `resource.unlock.any` — unlock a resource locked by someone else. * `feed.delete.any` — delete another member's feed post or reply (moderation).
      */
-    permissions: Array<'team.update' | 'team.delete' | 'team.transfer' | 'team.settings.update' | 'member.invite' | 'member.remove' | 'member.role.update' | 'project.create' | 'project.update' | 'project.delete' | 'resource.create' | 'resource.update.any' | 'resource.delete.own' | 'resource.delete.any' | 'feed.delete.any'>;
+    permissions: Array<'team.update' | 'team.delete' | 'team.transfer' | 'team.settings.update' | 'member.invite' | 'member.remove' | 'member.role.update' | 'project.create' | 'project.update' | 'project.delete' | 'resource.create' | 'resource.update.any' | 'resource.delete.own' | 'resource.delete.any' | 'resource.unlock.any' | 'feed.delete.any'>;
     /**
      * Number of members in this team. Populated only on list responses; 0 on create and single-team reads.
      */
@@ -7902,6 +7981,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 +8133,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.
          */
@@ -8246,6 +8333,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 +9547,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 +9707,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.
          */
@@ -9673,6 +9923,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 +10226,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.
          */
@@ -10075,6 +10484,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: {