@knowledge-stack/ksapi 1.85.0 → 1.86.1

package/dist/models/index.js

@@ -158,7 +158,6 @@ __exportStar(require("./RejectFileRequest"), exports);
 __exportStar(require("./ResolvedReferenceInput"), exports);
 __exportStar(require("./ResolvedReferenceOutput"), exports);
 __exportStar(require("./RootResponse"), exports);
-__exportStar(require("./RunLockResponse"), exports);
 __exportStar(require("./SSOInitiateResponse"), exports);
 __exportStar(require("./ScoredChunkResponse"), exports);
 __exportStar(require("./SearchSortOrder"), exports);

package/docs/DocumentVersionResponse.md

@@ -20,6 +20,7 @@ Name | Type
 `updatedAt` | Date
 `assetS3Url` | string
 `fastPlaintextUrl` | string
+`pageScreenshotUrls` | Array<string>
 `systemMetadata` | [DocumentVersionMetadata](DocumentVersionMetadata.md)
 
 ## Example
@@ -42,6 +43,7 @@ const example = {
   "updatedAt": null,
   "assetS3Url": null,
   "fastPlaintextUrl": null,
+  "pageScreenshotUrls": null,
   "systemMetadata": null,
 } satisfies DocumentVersionResponse
 

package/docs/DocumentVersionsApi.md

@@ -316,7 +316,7 @@ No authorization required
 
 ## getDocumentVersion
 
-> DocumentVersionResponse getDocumentVersion(versionId, authorization, ksUat)
+> DocumentVersionResponse getDocumentVersion(versionId, includePageScreenshots, authorization, ksUat)
 
 Get Document Version Handler
 
@@ -338,6 +338,8 @@ async function example() {
   const body = {
     // string | DocumentVersion ID
     versionId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
+    // boolean | When true, populate page_screenshot_urls with presigned URLs for every per-page WEBP screenshot the ingestion pipeline produced. Off by default to keep typical responses small. (optional)
+    includePageScreenshots: true,
     // string (optional)
     authorization: authorization_example,
     // string (optional)
@@ -362,6 +364,7 @@ example().catch(console.error);
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **versionId** | `string` | DocumentVersion ID | [Defaults to `undefined`] |
+| **includePageScreenshots** | `boolean` | When true, populate page_screenshot_urls with presigned URLs for every per-page WEBP screenshot the ingestion pipeline produced. Off by default to keep typical responses small. | [Optional] [Defaults to `false`] |
 | **authorization** | `string` |  | [Optional] [Defaults to `undefined`] |
 | **ksUat** | `string` |  | [Optional] [Defaults to `undefined`] |
 

package/docs/ThreadMessageDetailsInput.md

@@ -8,6 +8,7 @@ Name | Type
 ------------ | -------------
 `steps` | [Array<StepInput>](StepInput.md)
 `checkpoint` | [CheckpointDetails](CheckpointDetails.md)
+`modelId` | string
 
 ## Example
 
@@ -18,6 +19,7 @@ import type { ThreadMessageDetailsInput } from '@knowledge-stack/ksapi'
 const example = {
   "steps": null,
   "checkpoint": null,
+  "modelId": null,
 } satisfies ThreadMessageDetailsInput
 
 console.log(example)

package/docs/ThreadMessageDetailsOutput.md

@@ -8,6 +8,7 @@ Name | Type
 ------------ | -------------
 `steps` | [Array<StepOutput>](StepOutput.md)
 `checkpoint` | [CheckpointDetails](CheckpointDetails.md)
+`modelId` | string
 
 ## Example
 
@@ -18,6 +19,7 @@ import type { ThreadMessageDetailsOutput } from '@knowledge-stack/ksapi'
 const example = {
   "steps": null,
   "checkpoint": null,
+  "modelId": null,
 } satisfies ThreadMessageDetailsOutput
 
 console.log(example)

package/docs/WorkflowRunsApi.md

@@ -4,98 +4,22 @@ All URIs are relative to *http://localhost:8000*
 
 | Method | HTTP request | Description |
 |------------- | ------------- | -------------|
-| [**acquireWorkflowRunLock**](WorkflowRunsApi.md#acquireworkflowrunlock) | **POST** /v1/workflow-runs/{run_id}/lock | Acquire Workflow Run Lock Handler |
 | [**approveWorkflowRunFile**](WorkflowRunsApi.md#approveworkflowrunfile) | **POST** /v1/workflow-runs/{run_id}/files/{path_part_id}/approve | Approve Workflow Run File Handler |
 | [**deleteWorkflowRun**](WorkflowRunsApi.md#deleteworkflowrun) | **DELETE** /v1/workflow-runs/{run_id} | Delete Workflow Run Handler |
 | [**getWorkflowRun**](WorkflowRunsApi.md#getworkflowrun) | **GET** /v1/workflow-runs/{run_id} | Get Workflow Run Handler |
 | [**rejectWorkflowRunFile**](WorkflowRunsApi.md#rejectworkflowrunfile) | **POST** /v1/workflow-runs/{run_id}/files/{path_part_id}/reject | Reject Workflow Run File Handler |
-| [**releaseWorkflowRunLock**](WorkflowRunsApi.md#releaseworkflowrunlock) | **DELETE** /v1/workflow-runs/{run_id}/lock | Release Workflow Run Lock Handler |
 | [**unapproveWorkflowRunFile**](WorkflowRunsApi.md#unapproveworkflowrunfile) | **POST** /v1/workflow-runs/{run_id}/files/{path_part_id}/unapprove | Unapprove Workflow Run File Handler |
 | [**workflowRunCallback**](WorkflowRunsApi.md#workflowruncallbackoperation) | **POST** /v1/workflow-runs/{run_id}/callback | Workflow Run Callback Handler |
 
 
 
-## acquireWorkflowRunLock
-
-> RunLockResponse acquireWorkflowRunLock(runId, authorization, ksUat)
-
-Acquire Workflow Run Lock Handler
-
-Acquire (or renew) the reviewer lock on ``run_id``.  The current holder may re-POST to refresh ``lock_acquired_at``. A different user receives 409 until the lock is released or auto-swept.
-
-### Example
-
-```ts
-import {
-  Configuration,
-  WorkflowRunsApi,
-} from '@knowledge-stack/ksapi';
-import type { AcquireWorkflowRunLockRequest } from '@knowledge-stack/ksapi';
-
-async function example() {
-  console.log("🚀 Testing @knowledge-stack/ksapi SDK...");
-  const api = new WorkflowRunsApi();
-
-  const body = {
-    // string
-    runId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
-    // string (optional)
-    authorization: authorization_example,
-    // string (optional)
-    ksUat: ksUat_example,
-  } satisfies AcquireWorkflowRunLockRequest;
-
-  try {
-    const data = await api.acquireWorkflowRunLock(body);
-    console.log(data);
-  } catch (error) {
-    console.error(error);
-  }
-}
-
-// Run the test
-example().catch(console.error);
-```
-
-### Parameters
-
-
-| Name | Type | Description  | Notes |
-|------------- | ------------- | ------------- | -------------|
-| **runId** | `string` |  | [Defaults to `undefined`] |
-| **authorization** | `string` |  | [Optional] [Defaults to `undefined`] |
-| **ksUat** | `string` |  | [Optional] [Defaults to `undefined`] |
-
-### Return type
-
-[**RunLockResponse**](RunLockResponse.md)
-
-### Authorization
-
-No authorization required
-
-### HTTP request headers
-
-- **Content-Type**: Not defined
-- **Accept**: `application/json`
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-| **200** | Successful Response |  -  |
-| **422** | Validation Error |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
-
-
 ## approveWorkflowRunFile
 
 > PathPartApprovalResponse approveWorkflowRunFile(runId, pathPartId, authorization, ksUat)
 
 Approve Workflow Run File Handler
 
-Approve a single generated file. Caller must hold the run lock.
+Approve a generated file or the run folder itself.  Open to any user with ``can_write`` on the run path — both individual child files and the run folder (the final verdict that flips the run to APPROVED). Folder approval still requires no descendants in ``pending`` or ``rejected`` state.
 
 ### Example
 
@@ -316,7 +240,7 @@ No authorization required
 
 Reject Workflow Run File Handler
 
-Reject a single generated file with a reason. Caller must hold the run lock.
+Reject a generated file or the run folder itself with a reason.  Open to any user with ``can_write`` on the run path — both individual child files and the run folder (the final verdict that flips the run to REJECTED).
 
 ### Example
 
@@ -390,87 +314,13 @@ No authorization required
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## releaseWorkflowRunLock
-
-> releaseWorkflowRunLock(runId, authorization, ksUat)
-
-Release Workflow Run Lock Handler
-
-Release the reviewer lock; only the holder may call this.  DELETE /lock is idempotent: returns 204 even if no lock is held.
-
-### Example
-
-```ts
-import {
-  Configuration,
-  WorkflowRunsApi,
-} from '@knowledge-stack/ksapi';
-import type { ReleaseWorkflowRunLockRequest } from '@knowledge-stack/ksapi';
-
-async function example() {
-  console.log("🚀 Testing @knowledge-stack/ksapi SDK...");
-  const api = new WorkflowRunsApi();
-
-  const body = {
-    // string
-    runId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
-    // string (optional)
-    authorization: authorization_example,
-    // string (optional)
-    ksUat: ksUat_example,
-  } satisfies ReleaseWorkflowRunLockRequest;
-
-  try {
-    const data = await api.releaseWorkflowRunLock(body);
-    console.log(data);
-  } catch (error) {
-    console.error(error);
-  }
-}
-
-// Run the test
-example().catch(console.error);
-```
-
-### Parameters
-
-
-| Name | Type | Description  | Notes |
-|------------- | ------------- | ------------- | -------------|
-| **runId** | `string` |  | [Defaults to `undefined`] |
-| **authorization** | `string` |  | [Optional] [Defaults to `undefined`] |
-| **ksUat** | `string` |  | [Optional] [Defaults to `undefined`] |
-
-### Return type
-
-`void` (Empty response body)
-
-### Authorization
-
-No authorization required
-
-### HTTP request headers
-
-- **Content-Type**: Not defined
-- **Accept**: `application/json`
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-| **204** | Successful Response |  -  |
-| **422** | Validation Error |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
-
-
 ## unapproveWorkflowRunFile
 
 > PathPartApprovalResponse unapproveWorkflowRunFile(runId, pathPartId, authorization, ksUat)
 
 Unapprove Workflow Run File Handler
 
-Revert an approved file to ``pending``.  Does NOT require the reviewer lock — anyone with ``can_write`` on the run path may unapprove (pilot plan §11.7).
+Revert an approved or rejected file to ``pending``.  Open to any user with ``can_write`` on the run path. Cannot unapprove a leaf whose ancestor is currently ``approved`` — unapprove the ancestor first.
 
 ### Example
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowledge-stack/ksapi",
-  "version": "1.85.0",
+  "version": "1.86.1",
   "description": "OpenAPI client for @knowledge-stack/ksapi",
   "author": "OpenAPI-Generator",
   "repository": {

package/src/apis/DocumentVersionsApi.ts

@@ -73,6 +73,7 @@ export interface DocumentVersionActionRequest {
 
 export interface GetDocumentVersionRequest {
     versionId: string;
+    includePageScreenshots?: boolean;
     authorization?: string | null;
     ksUat?: string | null;
 }
@@ -226,6 +227,7 @@ export interface DocumentVersionsApiInterface {
     /**
      * Creates request options for getDocumentVersion without sending the request
      * @param {string} versionId DocumentVersion ID
+     * @param {boolean} [includePageScreenshots] When true, populate page_screenshot_urls with presigned URLs for every per-page WEBP screenshot the ingestion pipeline produced. Off by default to keep typical responses small.
      * @param {string} [authorization] 
      * @param {string} [ksUat] 
      * @throws {RequiredError}
@@ -237,6 +239,7 @@ export interface DocumentVersionsApiInterface {
      * Get a document version by its ID.
      * @summary Get Document Version Handler
      * @param {string} versionId DocumentVersion ID
+     * @param {boolean} [includePageScreenshots] When true, populate page_screenshot_urls with presigned URLs for every per-page WEBP screenshot the ingestion pipeline produced. Off by default to keep typical responses small.
      * @param {string} [authorization] 
      * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
@@ -583,6 +586,10 @@ export class DocumentVersionsApi extends runtime.BaseAPI implements DocumentVers
 
         const queryParameters: any = {};
 
+        if (requestParameters['includePageScreenshots'] != null) {
+            queryParameters['include_page_screenshots'] = requestParameters['includePageScreenshots'];
+        }
+
         const headerParameters: runtime.HTTPHeaders = {};
 
         if (requestParameters['authorization'] != null) {

package/src/apis/WorkflowRunsApi.ts

@@ -18,7 +18,6 @@ import type {
   HTTPValidationError,
   PathPartApprovalResponse,
   RejectFileRequest,
-  RunLockResponse,
   WorkflowCallbackResponse,
   WorkflowRunCallbackRequest,
   WorkflowRunResponse,
@@ -30,8 +29,6 @@ import {
     PathPartApprovalResponseToJSON,
     RejectFileRequestFromJSON,
     RejectFileRequestToJSON,
-    RunLockResponseFromJSON,
-    RunLockResponseToJSON,
     WorkflowCallbackResponseFromJSON,
     WorkflowCallbackResponseToJSON,
     WorkflowRunCallbackRequestFromJSON,
@@ -40,12 +37,6 @@ import {
     WorkflowRunResponseToJSON,
 } from '../models/index';
 
-export interface AcquireWorkflowRunLockRequest {
-    runId: string;
-    authorization?: string | null;
-    ksUat?: string | null;
-}
-
 export interface ApproveWorkflowRunFileRequest {
     runId: string;
     pathPartId: string;
@@ -73,12 +64,6 @@ export interface RejectWorkflowRunFileRequest {
     ksUat?: string | null;
 }
 
-export interface ReleaseWorkflowRunLockRequest {
-    runId: string;
-    authorization?: string | null;
-    ksUat?: string | null;
-}
-
 export interface UnapproveWorkflowRunFileRequest {
     runId: string;
     pathPartId: string;
@@ -98,34 +83,6 @@ export interface WorkflowRunCallbackOperationRequest {
  * @interface WorkflowRunsApiInterface
  */
 export interface WorkflowRunsApiInterface {
-    /**
-     * Creates request options for acquireWorkflowRunLock without sending the request
-     * @param {string} runId 
-     * @param {string} [authorization] 
-     * @param {string} [ksUat] 
-     * @throws {RequiredError}
-     * @memberof WorkflowRunsApiInterface
-     */
-    acquireWorkflowRunLockRequestOpts(requestParameters: AcquireWorkflowRunLockRequest): Promise<runtime.RequestOpts>;
-
-    /**
-     * Acquire (or renew) the reviewer lock on ``run_id``.  The current holder may re-POST to refresh ``lock_acquired_at``. A different user receives 409 until the lock is released or auto-swept.
-     * @summary Acquire Workflow Run Lock Handler
-     * @param {string} runId 
-     * @param {string} [authorization] 
-     * @param {string} [ksUat] 
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     * @memberof WorkflowRunsApiInterface
-     */
-    acquireWorkflowRunLockRaw(requestParameters: AcquireWorkflowRunLockRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<RunLockResponse>>;
-
-    /**
-     * Acquire (or renew) the reviewer lock on ``run_id``.  The current holder may re-POST to refresh ``lock_acquired_at``. A different user receives 409 until the lock is released or auto-swept.
-     * Acquire Workflow Run Lock Handler
-     */
-    acquireWorkflowRunLock(requestParameters: AcquireWorkflowRunLockRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<RunLockResponse>;
-
     /**
      * Creates request options for approveWorkflowRunFile without sending the request
      * @param {string} runId 
@@ -138,7 +95,7 @@ export interface WorkflowRunsApiInterface {
     approveWorkflowRunFileRequestOpts(requestParameters: ApproveWorkflowRunFileRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Approve a single generated file. Caller must hold the run lock.
+     * Approve a generated file or the run folder itself.  Open to any user with ``can_write`` on the run path — both individual child files and the run folder (the final verdict that flips the run to APPROVED). Folder approval still requires no descendants in ``pending`` or ``rejected`` state.
      * @summary Approve Workflow Run File Handler
      * @param {string} runId 
      * @param {string} pathPartId 
@@ -151,7 +108,7 @@ export interface WorkflowRunsApiInterface {
     approveWorkflowRunFileRaw(requestParameters: ApproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>>;
 
     /**
-     * Approve a single generated file. Caller must hold the run lock.
+     * Approve a generated file or the run folder itself.  Open to any user with ``can_write`` on the run path — both individual child files and the run folder (the final verdict that flips the run to APPROVED). Folder approval still requires no descendants in ``pending`` or ``rejected`` state.
      * Approve Workflow Run File Handler
      */
     approveWorkflowRunFile(requestParameters: ApproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse>;
@@ -223,7 +180,7 @@ export interface WorkflowRunsApiInterface {
     rejectWorkflowRunFileRequestOpts(requestParameters: RejectWorkflowRunFileRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Reject a single generated file with a reason. Caller must hold the run lock.
+     * Reject a generated file or the run folder itself with a reason.  Open to any user with ``can_write`` on the run path — both individual child files and the run folder (the final verdict that flips the run to REJECTED).
      * @summary Reject Workflow Run File Handler
      * @param {string} runId 
      * @param {string} pathPartId 
@@ -237,39 +194,11 @@ export interface WorkflowRunsApiInterface {
     rejectWorkflowRunFileRaw(requestParameters: RejectWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>>;
 
     /**
-     * Reject a single generated file with a reason. Caller must hold the run lock.
+     * Reject a generated file or the run folder itself with a reason.  Open to any user with ``can_write`` on the run path — both individual child files and the run folder (the final verdict that flips the run to REJECTED).
      * Reject Workflow Run File Handler
      */
     rejectWorkflowRunFile(requestParameters: RejectWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse>;
 
-    /**
-     * Creates request options for releaseWorkflowRunLock without sending the request
-     * @param {string} runId 
-     * @param {string} [authorization] 
-     * @param {string} [ksUat] 
-     * @throws {RequiredError}
-     * @memberof WorkflowRunsApiInterface
-     */
-    releaseWorkflowRunLockRequestOpts(requestParameters: ReleaseWorkflowRunLockRequest): Promise<runtime.RequestOpts>;
-
-    /**
-     * Release the reviewer lock; only the holder may call this.  DELETE /lock is idempotent: returns 204 even if no lock is held.
-     * @summary Release Workflow Run Lock Handler
-     * @param {string} runId 
-     * @param {string} [authorization] 
-     * @param {string} [ksUat] 
-     * @param {*} [options] Override http request option.
-     * @throws {RequiredError}
-     * @memberof WorkflowRunsApiInterface
-     */
-    releaseWorkflowRunLockRaw(requestParameters: ReleaseWorkflowRunLockRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
-
-    /**
-     * Release the reviewer lock; only the holder may call this.  DELETE /lock is idempotent: returns 204 even if no lock is held.
-     * Release Workflow Run Lock Handler
-     */
-    releaseWorkflowRunLock(requestParameters: ReleaseWorkflowRunLockRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
-
     /**
      * Creates request options for unapproveWorkflowRunFile without sending the request
      * @param {string} runId 
@@ -282,7 +211,7 @@ export interface WorkflowRunsApiInterface {
     unapproveWorkflowRunFileRequestOpts(requestParameters: UnapproveWorkflowRunFileRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Revert an approved file to ``pending``.  Does NOT require the reviewer lock — anyone with ``can_write`` on the run path may unapprove (pilot plan §11.7).
+     * Revert an approved or rejected file to ``pending``.  Open to any user with ``can_write`` on the run path. Cannot unapprove a leaf whose ancestor is currently ``approved`` — unapprove the ancestor first.
      * @summary Unapprove Workflow Run File Handler
      * @param {string} runId 
      * @param {string} pathPartId 
@@ -295,7 +224,7 @@ export interface WorkflowRunsApiInterface {
     unapproveWorkflowRunFileRaw(requestParameters: UnapproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>>;
 
     /**
-     * Revert an approved file to ``pending``.  Does NOT require the reviewer lock — anyone with ``can_write`` on the run path may unapprove (pilot plan §11.7).
+     * Revert an approved or rejected file to ``pending``.  Open to any user with ``can_write`` on the run path. Cannot unapprove a leaf whose ancestor is currently ``approved`` — unapprove the ancestor first.
      * Unapprove Workflow Run File Handler
      */
     unapproveWorkflowRunFile(requestParameters: UnapproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse>;
@@ -332,57 +261,6 @@ export interface WorkflowRunsApiInterface {
  */
 export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiInterface {
 
-    /**
-     * Creates request options for acquireWorkflowRunLock without sending the request
-     */
-    async acquireWorkflowRunLockRequestOpts(requestParameters: AcquireWorkflowRunLockRequest): Promise<runtime.RequestOpts> {
-        if (requestParameters['runId'] == null) {
-            throw new runtime.RequiredError(
-                'runId',
-                'Required parameter "runId" was null or undefined when calling acquireWorkflowRunLock().'
-            );
-        }
-
-        const queryParameters: any = {};
-
-        const headerParameters: runtime.HTTPHeaders = {};
-
-        if (requestParameters['authorization'] != null) {
-            headerParameters['authorization'] = String(requestParameters['authorization']);
-        }
-
-
-        let urlPath = `/v1/workflow-runs/{run_id}/lock`;
-        urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
-
-        return {
-            path: urlPath,
-            method: 'POST',
-            headers: headerParameters,
-            query: queryParameters,
-        };
-    }
-
-    /**
-     * Acquire (or renew) the reviewer lock on ``run_id``.  The current holder may re-POST to refresh ``lock_acquired_at``. A different user receives 409 until the lock is released or auto-swept.
-     * Acquire Workflow Run Lock Handler
-     */
-    async acquireWorkflowRunLockRaw(requestParameters: AcquireWorkflowRunLockRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<RunLockResponse>> {
-        const requestOptions = await this.acquireWorkflowRunLockRequestOpts(requestParameters);
-        const response = await this.request(requestOptions, initOverrides);
-
-        return new runtime.JSONApiResponse(response, (jsonValue) => RunLockResponseFromJSON(jsonValue));
-    }
-
-    /**
-     * Acquire (or renew) the reviewer lock on ``run_id``.  The current holder may re-POST to refresh ``lock_acquired_at``. A different user receives 409 until the lock is released or auto-swept.
-     * Acquire Workflow Run Lock Handler
-     */
-    async acquireWorkflowRunLock(requestParameters: AcquireWorkflowRunLockRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<RunLockResponse> {
-        const response = await this.acquireWorkflowRunLockRaw(requestParameters, initOverrides);
-        return await response.value();
-    }
-
     /**
      * Creates request options for approveWorkflowRunFile without sending the request
      */
@@ -423,7 +301,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
     }
 
     /**
-     * Approve a single generated file. Caller must hold the run lock.
+     * Approve a generated file or the run folder itself.  Open to any user with ``can_write`` on the run path — both individual child files and the run folder (the final verdict that flips the run to APPROVED). Folder approval still requires no descendants in ``pending`` or ``rejected`` state.
      * Approve Workflow Run File Handler
      */
     async approveWorkflowRunFileRaw(requestParameters: ApproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>> {
@@ -434,7 +312,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
     }
 
     /**
-     * Approve a single generated file. Caller must hold the run lock.
+     * Approve a generated file or the run folder itself.  Open to any user with ``can_write`` on the run path — both individual child files and the run folder (the final verdict that flips the run to APPROVED). Folder approval still requires no descendants in ``pending`` or ``rejected`` state.
      * Approve Workflow Run File Handler
      */
     async approveWorkflowRunFile(requestParameters: ApproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse> {
@@ -589,7 +467,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
     }
 
     /**
-     * Reject a single generated file with a reason. Caller must hold the run lock.
+     * Reject a generated file or the run folder itself with a reason.  Open to any user with ``can_write`` on the run path — both individual child files and the run folder (the final verdict that flips the run to REJECTED).
      * Reject Workflow Run File Handler
      */
     async rejectWorkflowRunFileRaw(requestParameters: RejectWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>> {
@@ -600,7 +478,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
     }
 
     /**
-     * Reject a single generated file with a reason. Caller must hold the run lock.
+     * Reject a generated file or the run folder itself with a reason.  Open to any user with ``can_write`` on the run path — both individual child files and the run folder (the final verdict that flips the run to REJECTED).
      * Reject Workflow Run File Handler
      */
     async rejectWorkflowRunFile(requestParameters: RejectWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse> {
@@ -608,56 +486,6 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
         return await response.value();
     }
 
-    /**
-     * Creates request options for releaseWorkflowRunLock without sending the request
-     */
-    async releaseWorkflowRunLockRequestOpts(requestParameters: ReleaseWorkflowRunLockRequest): Promise<runtime.RequestOpts> {
-        if (requestParameters['runId'] == null) {
-            throw new runtime.RequiredError(
-                'runId',
-                'Required parameter "runId" was null or undefined when calling releaseWorkflowRunLock().'
-            );
-        }
-
-        const queryParameters: any = {};
-
-        const headerParameters: runtime.HTTPHeaders = {};
-
-        if (requestParameters['authorization'] != null) {
-            headerParameters['authorization'] = String(requestParameters['authorization']);
-        }
-
-
-        let urlPath = `/v1/workflow-runs/{run_id}/lock`;
-        urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
-
-        return {
-            path: urlPath,
-            method: 'DELETE',
-            headers: headerParameters,
-            query: queryParameters,
-        };
-    }
-
-    /**
-     * Release the reviewer lock; only the holder may call this.  DELETE /lock is idempotent: returns 204 even if no lock is held.
-     * Release Workflow Run Lock Handler
-     */
-    async releaseWorkflowRunLockRaw(requestParameters: ReleaseWorkflowRunLockRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
-        const requestOptions = await this.releaseWorkflowRunLockRequestOpts(requestParameters);
-        const response = await this.request(requestOptions, initOverrides);
-
-        return new runtime.VoidApiResponse(response);
-    }
-
-    /**
-     * Release the reviewer lock; only the holder may call this.  DELETE /lock is idempotent: returns 204 even if no lock is held.
-     * Release Workflow Run Lock Handler
-     */
-    async releaseWorkflowRunLock(requestParameters: ReleaseWorkflowRunLockRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {
-        await this.releaseWorkflowRunLockRaw(requestParameters, initOverrides);
-    }
-
     /**
      * Creates request options for unapproveWorkflowRunFile without sending the request
      */
@@ -698,7 +526,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
     }
 
     /**
-     * Revert an approved file to ``pending``.  Does NOT require the reviewer lock — anyone with ``can_write`` on the run path may unapprove (pilot plan §11.7).
+     * Revert an approved or rejected file to ``pending``.  Open to any user with ``can_write`` on the run path. Cannot unapprove a leaf whose ancestor is currently ``approved`` — unapprove the ancestor first.
      * Unapprove Workflow Run File Handler
      */
     async unapproveWorkflowRunFileRaw(requestParameters: UnapproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>> {
@@ -709,7 +537,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
     }
 
     /**
-     * Revert an approved file to ``pending``.  Does NOT require the reviewer lock — anyone with ``can_write`` on the run path may unapprove (pilot plan §11.7).
+     * Revert an approved or rejected file to ``pending``.  Open to any user with ``can_write`` on the run path. Cannot unapprove a leaf whose ancestor is currently ``approved`` — unapprove the ancestor first.
      * Unapprove Workflow Run File Handler
      */
     async unapproveWorkflowRunFile(requestParameters: UnapproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse> {