@knowledge-stack/ksapi 1.88.0 → 1.89.0

package/src/apis/WorkflowRunsApi.ts

@@ -15,20 +15,23 @@
 
 import * as runtime from '../runtime';
 import type {
+  CloneWorkflowRunRequest,
   HTTPValidationError,
-  PathPartApprovalResponse,
-  RejectFileRequest,
+  SetWorkflowRunApprovalRequest,
+  UpdateWorkflowRunRequest,
   WorkflowCallbackResponse,
   WorkflowRunCallbackRequest,
   WorkflowRunResponse,
 } from '../models/index';
 import {
+    CloneWorkflowRunRequestFromJSON,
+    CloneWorkflowRunRequestToJSON,
     HTTPValidationErrorFromJSON,
     HTTPValidationErrorToJSON,
-    PathPartApprovalResponseFromJSON,
-    PathPartApprovalResponseToJSON,
-    RejectFileRequestFromJSON,
-    RejectFileRequestToJSON,
+    SetWorkflowRunApprovalRequestFromJSON,
+    SetWorkflowRunApprovalRequestToJSON,
+    UpdateWorkflowRunRequestFromJSON,
+    UpdateWorkflowRunRequestToJSON,
     WorkflowCallbackResponseFromJSON,
     WorkflowCallbackResponseToJSON,
     WorkflowRunCallbackRequestFromJSON,
@@ -37,9 +40,9 @@ import {
     WorkflowRunResponseToJSON,
 } from '../models/index';
 
-export interface ApproveWorkflowRunFileRequest {
+export interface CloneWorkflowRunOperationRequest {
     runId: string;
-    pathPartId: string;
+    cloneWorkflowRunRequest: CloneWorkflowRunRequest;
     authorization?: string | null;
     ksUat?: string | null;
 }
@@ -56,17 +59,22 @@ export interface GetWorkflowRunRequest {
     ksUat?: string | null;
 }
 
-export interface RejectWorkflowRunFileRequest {
+export interface SetWorkflowRunApprovalOperationRequest {
     runId: string;
-    pathPartId: string;
-    rejectFileRequest: RejectFileRequest;
+    setWorkflowRunApprovalRequest: SetWorkflowRunApprovalRequest;
     authorization?: string | null;
     ksUat?: string | null;
 }
 
-export interface UnapproveWorkflowRunFileRequest {
+export interface StartWorkflowRunRequest {
     runId: string;
-    pathPartId: string;
+    authorization?: string | null;
+    ksUat?: string | null;
+}
+
+export interface UpdateWorkflowRunOperationRequest {
+    runId: string;
+    updateWorkflowRunRequest: UpdateWorkflowRunRequest;
     authorization?: string | null;
     ksUat?: string | null;
 }
@@ -74,6 +82,8 @@ export interface UnapproveWorkflowRunFileRequest {
 export interface WorkflowRunCallbackOperationRequest {
     runId: string;
     workflowRunCallbackRequest: WorkflowRunCallbackRequest;
+    authorization?: string | null;
+    ksUat?: string | null;
 }
 
 /**
@@ -84,34 +94,34 @@ export interface WorkflowRunCallbackOperationRequest {
  */
 export interface WorkflowRunsApiInterface {
     /**
-     * Creates request options for approveWorkflowRunFile without sending the request
+     * Creates request options for cloneWorkflowRun without sending the request
      * @param {string} runId 
-     * @param {string} pathPartId 
+     * @param {CloneWorkflowRunRequest} cloneWorkflowRunRequest 
      * @param {string} [authorization] 
      * @param {string} [ksUat] 
      * @throws {RequiredError}
      * @memberof WorkflowRunsApiInterface
      */
-    approveWorkflowRunFileRequestOpts(requestParameters: ApproveWorkflowRunFileRequest): Promise<runtime.RequestOpts>;
+    cloneWorkflowRunRequestOpts(requestParameters: CloneWorkflowRunOperationRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * 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
+     * Clone a started run into a new NOT_STARTED draft.  ``include_inputs=True`` pins the source\'s snapshotted inputs onto the new run; uploads stay in the source\'s ``inputs/`` and are referenced by path_part_id. No S3 copy. A NOT_STARTED source has no snapshot to pin → 409. The clone is born NOT_STARTED so the user can edit it (PATCH) before pressing Start.
+     * @summary Clone Workflow Run Handler
      * @param {string} runId 
-     * @param {string} pathPartId 
+     * @param {CloneWorkflowRunRequest} cloneWorkflowRunRequest 
      * @param {string} [authorization] 
      * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof WorkflowRunsApiInterface
      */
-    approveWorkflowRunFileRaw(requestParameters: ApproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>>;
+    cloneWorkflowRunRaw(requestParameters: CloneWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
 
     /**
-     * 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
+     * Clone a started run into a new NOT_STARTED draft.  ``include_inputs=True`` pins the source\'s snapshotted inputs onto the new run; uploads stay in the source\'s ``inputs/`` and are referenced by path_part_id. No S3 copy. A NOT_STARTED source has no snapshot to pin → 409. The clone is born NOT_STARTED so the user can edit it (PATCH) before pressing Start.
+     * Clone Workflow Run Handler
      */
-    approveWorkflowRunFile(requestParameters: ApproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse>;
+    cloneWorkflowRun(requestParameters: CloneWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
 
     /**
      * Creates request options for deleteWorkflowRun without sending the request
@@ -168,81 +178,111 @@ export interface WorkflowRunsApiInterface {
     getWorkflowRun(requestParameters: GetWorkflowRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
 
     /**
-     * Creates request options for rejectWorkflowRunFile without sending the request
+     * Creates request options for setWorkflowRunApproval without sending the request
+     * @param {string} runId 
+     * @param {SetWorkflowRunApprovalRequest} setWorkflowRunApprovalRequest 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @throws {RequiredError}
+     * @memberof WorkflowRunsApiInterface
+     */
+    setWorkflowRunApprovalRequestOpts(requestParameters: SetWorkflowRunApprovalOperationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Approve an entire completed run in one call.  Approves every output document under ``outputs/`` then the run folder. The run must be ``COMPLETED`` and its definition must have required approval. Requires write access to the run folder. ``run_id`` is the WorkflowRun id.
+     * @summary Set Workflow Run Approval Handler
+     * @param {string} runId 
+     * @param {SetWorkflowRunApprovalRequest} setWorkflowRunApprovalRequest 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WorkflowRunsApiInterface
+     */
+    setWorkflowRunApprovalRaw(requestParameters: SetWorkflowRunApprovalOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
+
+    /**
+     * Approve an entire completed run in one call.  Approves every output document under ``outputs/`` then the run folder. The run must be ``COMPLETED`` and its definition must have required approval. Requires write access to the run folder. ``run_id`` is the WorkflowRun id.
+     * Set Workflow Run Approval Handler
+     */
+    setWorkflowRunApproval(requestParameters: SetWorkflowRunApprovalOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
+
+    /**
+     * Creates request options for startWorkflowRun without sending the request
      * @param {string} runId 
-     * @param {string} pathPartId 
-     * @param {RejectFileRequest} rejectFileRequest 
      * @param {string} [authorization] 
      * @param {string} [ksUat] 
      * @throws {RequiredError}
      * @memberof WorkflowRunsApiInterface
      */
-    rejectWorkflowRunFileRequestOpts(requestParameters: RejectWorkflowRunFileRequest): Promise<runtime.RequestOpts>;
+    startWorkflowRunRequestOpts(requestParameters: StartWorkflowRunRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * 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
+     * Flip a NOT_STARTED run to IN_PROGRESS and dispatch its agent run.  Idempotent on IN_PROGRESS (returns the row). Terminal states → 409. Inputs still ingesting or in a failed terminal state → 409. The snapshot is built at this point (KB DOCUMENTs resolve to active versions, uploaded DVs are walked from inputs/, KB FOLDERs stay live).
+     * @summary Start Workflow Run Handler
      * @param {string} runId 
-     * @param {string} pathPartId 
-     * @param {RejectFileRequest} rejectFileRequest 
      * @param {string} [authorization] 
      * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof WorkflowRunsApiInterface
      */
-    rejectWorkflowRunFileRaw(requestParameters: RejectWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>>;
+    startWorkflowRunRaw(requestParameters: StartWorkflowRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
 
     /**
-     * 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
+     * Flip a NOT_STARTED run to IN_PROGRESS and dispatch its agent run.  Idempotent on IN_PROGRESS (returns the row). Terminal states → 409. Inputs still ingesting or in a failed terminal state → 409. The snapshot is built at this point (KB DOCUMENTs resolve to active versions, uploaded DVs are walked from inputs/, KB FOLDERs stay live).
+     * Start Workflow Run Handler
      */
-    rejectWorkflowRunFile(requestParameters: RejectWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse>;
+    startWorkflowRun(requestParameters: StartWorkflowRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
 
     /**
-     * Creates request options for unapproveWorkflowRunFile without sending the request
+     * Creates request options for updateWorkflowRun without sending the request
      * @param {string} runId 
-     * @param {string} pathPartId 
+     * @param {UpdateWorkflowRunRequest} updateWorkflowRunRequest 
      * @param {string} [authorization] 
      * @param {string} [ksUat] 
      * @throws {RequiredError}
      * @memberof WorkflowRunsApiInterface
      */
-    unapproveWorkflowRunFileRequestOpts(requestParameters: UnapproveWorkflowRunFileRequest): Promise<runtime.RequestOpts>;
+    updateWorkflowRunRequestOpts(requestParameters: UpdateWorkflowRunOperationRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * 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
+     * Edit a NOT_STARTED run\'s KB scope and / or display name.  Both body fields are optional but at least one must be present. The run must be ``NOT_STARTED`` (409 otherwise). Caller must be the triggerer or OWNER/ADMIN (403 otherwise). A name collision with a sibling run under the same definition\'s ``runs/`` folder maps to a 409 via ``IntegrityError`` translation.
+     * @summary Update Workflow Run Handler
      * @param {string} runId 
-     * @param {string} pathPartId 
+     * @param {UpdateWorkflowRunRequest} updateWorkflowRunRequest 
      * @param {string} [authorization] 
      * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof WorkflowRunsApiInterface
      */
-    unapproveWorkflowRunFileRaw(requestParameters: UnapproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>>;
+    updateWorkflowRunRaw(requestParameters: UpdateWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
 
     /**
-     * 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
+     * Edit a NOT_STARTED run\'s KB scope and / or display name.  Both body fields are optional but at least one must be present. The run must be ``NOT_STARTED`` (409 otherwise). Caller must be the triggerer or OWNER/ADMIN (403 otherwise). A name collision with a sibling run under the same definition\'s ``runs/`` folder maps to a 409 via ``IntegrityError`` translation.
+     * Update Workflow Run Handler
      */
-    unapproveWorkflowRunFile(requestParameters: UnapproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse>;
+    updateWorkflowRun(requestParameters: UpdateWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
 
     /**
      * Creates request options for workflowRunCallback without sending the request
      * @param {string} runId 
      * @param {WorkflowRunCallbackRequest} workflowRunCallbackRequest 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
      * @throws {RequiredError}
      * @memberof WorkflowRunsApiInterface
      */
     workflowRunCallbackRequestOpts(requestParameters: WorkflowRunCallbackOperationRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * 
+     * Terminal-state write seam for the in-process agent runner.  The gating Temporal activities ``mark_run_completed_activity`` and ``mark_run_failed_activity`` authenticate as the triggering user (via ``assume_user``) and POST here. Only the user who triggered the run (or OWNER/ADMIN) may write its terminal state. The handler is idempotent: a callback against an already-terminal row returns ``already_terminal`` and the activity-level retry treats it as a no-op.
      * @summary Workflow Run Callback Handler
      * @param {string} runId 
      * @param {WorkflowRunCallbackRequest} workflowRunCallbackRequest 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof WorkflowRunsApiInterface
@@ -250,6 +290,7 @@ export interface WorkflowRunsApiInterface {
     workflowRunCallbackRaw(requestParameters: WorkflowRunCallbackOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowCallbackResponse>>;
 
     /**
+     * Terminal-state write seam for the in-process agent runner.  The gating Temporal activities ``mark_run_completed_activity`` and ``mark_run_failed_activity`` authenticate as the triggering user (via ``assume_user``) and POST here. Only the user who triggered the run (or OWNER/ADMIN) may write its terminal state. The handler is idempotent: a callback against an already-terminal row returns ``already_terminal`` and the activity-level retry treats it as a no-op.
      * Workflow Run Callback Handler
      */
     workflowRunCallback(requestParameters: WorkflowRunCallbackOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowCallbackResponse>;
@@ -262,20 +303,20 @@ export interface WorkflowRunsApiInterface {
 export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiInterface {
 
     /**
-     * Creates request options for approveWorkflowRunFile without sending the request
+     * Creates request options for cloneWorkflowRun without sending the request
      */
-    async approveWorkflowRunFileRequestOpts(requestParameters: ApproveWorkflowRunFileRequest): Promise<runtime.RequestOpts> {
+    async cloneWorkflowRunRequestOpts(requestParameters: CloneWorkflowRunOperationRequest): Promise<runtime.RequestOpts> {
         if (requestParameters['runId'] == null) {
             throw new runtime.RequiredError(
                 'runId',
-                'Required parameter "runId" was null or undefined when calling approveWorkflowRunFile().'
+                'Required parameter "runId" was null or undefined when calling cloneWorkflowRun().'
             );
         }
 
-        if (requestParameters['pathPartId'] == null) {
+        if (requestParameters['cloneWorkflowRunRequest'] == null) {
             throw new runtime.RequiredError(
-                'pathPartId',
-                'Required parameter "pathPartId" was null or undefined when calling approveWorkflowRunFile().'
+                'cloneWorkflowRunRequest',
+                'Required parameter "cloneWorkflowRunRequest" was null or undefined when calling cloneWorkflowRun().'
             );
         }
 
@@ -283,40 +324,42 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
 
         const headerParameters: runtime.HTTPHeaders = {};
 
+        headerParameters['Content-Type'] = 'application/json';
+
         if (requestParameters['authorization'] != null) {
             headerParameters['authorization'] = String(requestParameters['authorization']);
         }
 
 
-        let urlPath = `/v1/workflow-runs/{run_id}/files/{path_part_id}/approve`;
+        let urlPath = `/v1/workflow-runs/{run_id}/clone`;
         urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
-        urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
 
         return {
             path: urlPath,
             method: 'POST',
             headers: headerParameters,
             query: queryParameters,
+            body: CloneWorkflowRunRequestToJSON(requestParameters['cloneWorkflowRunRequest']),
         };
     }
 
     /**
-     * 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
+     * Clone a started run into a new NOT_STARTED draft.  ``include_inputs=True`` pins the source\'s snapshotted inputs onto the new run; uploads stay in the source\'s ``inputs/`` and are referenced by path_part_id. No S3 copy. A NOT_STARTED source has no snapshot to pin → 409. The clone is born NOT_STARTED so the user can edit it (PATCH) before pressing Start.
+     * Clone Workflow Run Handler
      */
-    async approveWorkflowRunFileRaw(requestParameters: ApproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>> {
-        const requestOptions = await this.approveWorkflowRunFileRequestOpts(requestParameters);
+    async cloneWorkflowRunRaw(requestParameters: CloneWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>> {
+        const requestOptions = await this.cloneWorkflowRunRequestOpts(requestParameters);
         const response = await this.request(requestOptions, initOverrides);
 
-        return new runtime.JSONApiResponse(response, (jsonValue) => PathPartApprovalResponseFromJSON(jsonValue));
+        return new runtime.JSONApiResponse(response, (jsonValue) => WorkflowRunResponseFromJSON(jsonValue));
     }
 
     /**
-     * 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
+     * Clone a started run into a new NOT_STARTED draft.  ``include_inputs=True`` pins the source\'s snapshotted inputs onto the new run; uploads stay in the source\'s ``inputs/`` and are referenced by path_part_id. No S3 copy. A NOT_STARTED source has no snapshot to pin → 409. The clone is born NOT_STARTED so the user can edit it (PATCH) before pressing Start.
+     * Clone Workflow Run Handler
      */
-    async approveWorkflowRunFile(requestParameters: ApproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse> {
-        const response = await this.approveWorkflowRunFileRaw(requestParameters, initOverrides);
+    async cloneWorkflowRun(requestParameters: CloneWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse> {
+        const response = await this.cloneWorkflowRunRaw(requestParameters, initOverrides);
         return await response.value();
     }
 
@@ -418,27 +461,74 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
     }
 
     /**
-     * Creates request options for rejectWorkflowRunFile without sending the request
+     * Creates request options for setWorkflowRunApproval without sending the request
      */
-    async rejectWorkflowRunFileRequestOpts(requestParameters: RejectWorkflowRunFileRequest): Promise<runtime.RequestOpts> {
+    async setWorkflowRunApprovalRequestOpts(requestParameters: SetWorkflowRunApprovalOperationRequest): Promise<runtime.RequestOpts> {
         if (requestParameters['runId'] == null) {
             throw new runtime.RequiredError(
                 'runId',
-                'Required parameter "runId" was null or undefined when calling rejectWorkflowRunFile().'
+                'Required parameter "runId" was null or undefined when calling setWorkflowRunApproval().'
             );
         }
 
-        if (requestParameters['pathPartId'] == null) {
+        if (requestParameters['setWorkflowRunApprovalRequest'] == null) {
             throw new runtime.RequiredError(
-                'pathPartId',
-                'Required parameter "pathPartId" was null or undefined when calling rejectWorkflowRunFile().'
+                'setWorkflowRunApprovalRequest',
+                'Required parameter "setWorkflowRunApprovalRequest" was null or undefined when calling setWorkflowRunApproval().'
             );
         }
 
-        if (requestParameters['rejectFileRequest'] == null) {
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (requestParameters['authorization'] != null) {
+            headerParameters['authorization'] = String(requestParameters['authorization']);
+        }
+
+
+        let urlPath = `/v1/workflow-runs/{run_id}/approval`;
+        urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: SetWorkflowRunApprovalRequestToJSON(requestParameters['setWorkflowRunApprovalRequest']),
+        };
+    }
+
+    /**
+     * Approve an entire completed run in one call.  Approves every output document under ``outputs/`` then the run folder. The run must be ``COMPLETED`` and its definition must have required approval. Requires write access to the run folder. ``run_id`` is the WorkflowRun id.
+     * Set Workflow Run Approval Handler
+     */
+    async setWorkflowRunApprovalRaw(requestParameters: SetWorkflowRunApprovalOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>> {
+        const requestOptions = await this.setWorkflowRunApprovalRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => WorkflowRunResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Approve an entire completed run in one call.  Approves every output document under ``outputs/`` then the run folder. The run must be ``COMPLETED`` and its definition must have required approval. Requires write access to the run folder. ``run_id`` is the WorkflowRun id.
+     * Set Workflow Run Approval Handler
+     */
+    async setWorkflowRunApproval(requestParameters: SetWorkflowRunApprovalOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse> {
+        const response = await this.setWorkflowRunApprovalRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for startWorkflowRun without sending the request
+     */
+    async startWorkflowRunRequestOpts(requestParameters: StartWorkflowRunRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['runId'] == null) {
             throw new runtime.RequiredError(
-                'rejectFileRequest',
-                'Required parameter "rejectFileRequest" was null or undefined when calling rejectWorkflowRunFile().'
+                'runId',
+                'Required parameter "runId" was null or undefined when calling startWorkflowRun().'
             );
         }
 
@@ -446,61 +536,57 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
 
         const headerParameters: runtime.HTTPHeaders = {};
 
-        headerParameters['Content-Type'] = 'application/json';
-
         if (requestParameters['authorization'] != null) {
             headerParameters['authorization'] = String(requestParameters['authorization']);
         }
 
 
-        let urlPath = `/v1/workflow-runs/{run_id}/files/{path_part_id}/reject`;
+        let urlPath = `/v1/workflow-runs/{run_id}/start`;
         urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
-        urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
 
         return {
             path: urlPath,
             method: 'POST',
             headers: headerParameters,
             query: queryParameters,
-            body: RejectFileRequestToJSON(requestParameters['rejectFileRequest']),
         };
     }
 
     /**
-     * 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
+     * Flip a NOT_STARTED run to IN_PROGRESS and dispatch its agent run.  Idempotent on IN_PROGRESS (returns the row). Terminal states → 409. Inputs still ingesting or in a failed terminal state → 409. The snapshot is built at this point (KB DOCUMENTs resolve to active versions, uploaded DVs are walked from inputs/, KB FOLDERs stay live).
+     * Start Workflow Run Handler
      */
-    async rejectWorkflowRunFileRaw(requestParameters: RejectWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>> {
-        const requestOptions = await this.rejectWorkflowRunFileRequestOpts(requestParameters);
+    async startWorkflowRunRaw(requestParameters: StartWorkflowRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>> {
+        const requestOptions = await this.startWorkflowRunRequestOpts(requestParameters);
         const response = await this.request(requestOptions, initOverrides);
 
-        return new runtime.JSONApiResponse(response, (jsonValue) => PathPartApprovalResponseFromJSON(jsonValue));
+        return new runtime.JSONApiResponse(response, (jsonValue) => WorkflowRunResponseFromJSON(jsonValue));
     }
 
     /**
-     * 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
+     * Flip a NOT_STARTED run to IN_PROGRESS and dispatch its agent run.  Idempotent on IN_PROGRESS (returns the row). Terminal states → 409. Inputs still ingesting or in a failed terminal state → 409. The snapshot is built at this point (KB DOCUMENTs resolve to active versions, uploaded DVs are walked from inputs/, KB FOLDERs stay live).
+     * Start Workflow Run Handler
      */
-    async rejectWorkflowRunFile(requestParameters: RejectWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse> {
-        const response = await this.rejectWorkflowRunFileRaw(requestParameters, initOverrides);
+    async startWorkflowRun(requestParameters: StartWorkflowRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse> {
+        const response = await this.startWorkflowRunRaw(requestParameters, initOverrides);
         return await response.value();
     }
 
     /**
-     * Creates request options for unapproveWorkflowRunFile without sending the request
+     * Creates request options for updateWorkflowRun without sending the request
      */
-    async unapproveWorkflowRunFileRequestOpts(requestParameters: UnapproveWorkflowRunFileRequest): Promise<runtime.RequestOpts> {
+    async updateWorkflowRunRequestOpts(requestParameters: UpdateWorkflowRunOperationRequest): Promise<runtime.RequestOpts> {
         if (requestParameters['runId'] == null) {
             throw new runtime.RequiredError(
                 'runId',
-                'Required parameter "runId" was null or undefined when calling unapproveWorkflowRunFile().'
+                'Required parameter "runId" was null or undefined when calling updateWorkflowRun().'
             );
         }
 
-        if (requestParameters['pathPartId'] == null) {
+        if (requestParameters['updateWorkflowRunRequest'] == null) {
             throw new runtime.RequiredError(
-                'pathPartId',
-                'Required parameter "pathPartId" was null or undefined when calling unapproveWorkflowRunFile().'
+                'updateWorkflowRunRequest',
+                'Required parameter "updateWorkflowRunRequest" was null or undefined when calling updateWorkflowRun().'
             );
         }
 
@@ -508,40 +594,42 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
 
         const headerParameters: runtime.HTTPHeaders = {};
 
+        headerParameters['Content-Type'] = 'application/json';
+
         if (requestParameters['authorization'] != null) {
             headerParameters['authorization'] = String(requestParameters['authorization']);
         }
 
 
-        let urlPath = `/v1/workflow-runs/{run_id}/files/{path_part_id}/unapprove`;
+        let urlPath = `/v1/workflow-runs/{run_id}`;
         urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
-        urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
 
         return {
             path: urlPath,
-            method: 'POST',
+            method: 'PATCH',
             headers: headerParameters,
             query: queryParameters,
+            body: UpdateWorkflowRunRequestToJSON(requestParameters['updateWorkflowRunRequest']),
         };
     }
 
     /**
-     * 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
+     * Edit a NOT_STARTED run\'s KB scope and / or display name.  Both body fields are optional but at least one must be present. The run must be ``NOT_STARTED`` (409 otherwise). Caller must be the triggerer or OWNER/ADMIN (403 otherwise). A name collision with a sibling run under the same definition\'s ``runs/`` folder maps to a 409 via ``IntegrityError`` translation.
+     * Update Workflow Run Handler
      */
-    async unapproveWorkflowRunFileRaw(requestParameters: UnapproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>> {
-        const requestOptions = await this.unapproveWorkflowRunFileRequestOpts(requestParameters);
+    async updateWorkflowRunRaw(requestParameters: UpdateWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>> {
+        const requestOptions = await this.updateWorkflowRunRequestOpts(requestParameters);
         const response = await this.request(requestOptions, initOverrides);
 
-        return new runtime.JSONApiResponse(response, (jsonValue) => PathPartApprovalResponseFromJSON(jsonValue));
+        return new runtime.JSONApiResponse(response, (jsonValue) => WorkflowRunResponseFromJSON(jsonValue));
     }
 
     /**
-     * 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
+     * Edit a NOT_STARTED run\'s KB scope and / or display name.  Both body fields are optional but at least one must be present. The run must be ``NOT_STARTED`` (409 otherwise). Caller must be the triggerer or OWNER/ADMIN (403 otherwise). A name collision with a sibling run under the same definition\'s ``runs/`` folder maps to a 409 via ``IntegrityError`` translation.
+     * Update Workflow Run Handler
      */
-    async unapproveWorkflowRunFile(requestParameters: UnapproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse> {
-        const response = await this.unapproveWorkflowRunFileRaw(requestParameters, initOverrides);
+    async updateWorkflowRun(requestParameters: UpdateWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse> {
+        const response = await this.updateWorkflowRunRaw(requestParameters, initOverrides);
         return await response.value();
     }
 
@@ -569,6 +657,10 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
 
         headerParameters['Content-Type'] = 'application/json';
 
+        if (requestParameters['authorization'] != null) {
+            headerParameters['authorization'] = String(requestParameters['authorization']);
+        }
+
 
         let urlPath = `/v1/workflow-runs/{run_id}/callback`;
         urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
@@ -583,6 +675,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
     }
 
     /**
+     * Terminal-state write seam for the in-process agent runner.  The gating Temporal activities ``mark_run_completed_activity`` and ``mark_run_failed_activity`` authenticate as the triggering user (via ``assume_user``) and POST here. Only the user who triggered the run (or OWNER/ADMIN) may write its terminal state. The handler is idempotent: a callback against an already-terminal row returns ``already_terminal`` and the activity-level retry treats it as a no-op.
      * Workflow Run Callback Handler
      */
     async workflowRunCallbackRaw(requestParameters: WorkflowRunCallbackOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowCallbackResponse>> {
@@ -593,6 +686,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
     }
 
     /**
+     * Terminal-state write seam for the in-process agent runner.  The gating Temporal activities ``mark_run_completed_activity`` and ``mark_run_failed_activity`` authenticate as the triggering user (via ``assume_user``) and POST here. Only the user who triggered the run (or OWNER/ADMIN) may write its terminal state. The handler is idempotent: a callback against an already-terminal row returns ``already_terminal`` and the activity-level retry treats it as a no-op.
      * Workflow Run Callback Handler
      */
     async workflowRunCallback(requestParameters: WorkflowRunCallbackOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowCallbackResponse> {

package/src/apis/index.ts

@@ -13,6 +13,7 @@ export * from './FeaturesApi';
 export * from './FeedbackApi';
 export * from './FoldersApi';
 export * from './InvitesApi';
+export * from './PathPartApprovalsApi';
 export * from './PathPartsApi';
 export * from './PublicApi';
 export * from './SectionsApi';