@knowledge-stack/ksapi 1.104.0 → 1.106.0

package/.openapi-generator/FILES

@@ -236,6 +236,7 @@ docs/SetApprovalStateRequest.md
 docs/SetWorkflowRunApprovalRequest.md
 docs/SignInRequest.md
 docs/SortDirection.md
+docs/StartWorkflowRunRequest.md
 docs/StepInput.md
 docs/StepKind.md
 docs/StepOutput.md
@@ -577,6 +578,7 @@ src/models/SetApprovalStateRequest.ts
 src/models/SetWorkflowRunApprovalRequest.ts
 src/models/SignInRequest.ts
 src/models/SortDirection.ts
+src/models/StartWorkflowRunRequest.ts
 src/models/StepInput.ts
 src/models/StepKind.ts
 src/models/StepOutput.ts

package/README.md

@@ -1,4 +1,4 @@
-# @knowledge-stack/ksapi@1.104.0
+# @knowledge-stack/ksapi@1.106.0
 
 A TypeScript SDK client for the localhost API.
 
@@ -247,7 +247,7 @@ All URIs are relative to *http://localhost:8000*
 *WorkflowRunsApi* | [**listWorkflowRunsForTenant**](docs/WorkflowRunsApi.md#listworkflowrunsfortenant) | **GET** /v1/workflow-runs | List Workflow Runs For Tenant Handler
 *WorkflowRunsApi* | [**retryWorkflowRun**](docs/WorkflowRunsApi.md#retryworkflowrun) | **POST** /v1/workflow-runs/{run_id}/retry | Retry Workflow Run Handler
 *WorkflowRunsApi* | [**setWorkflowRunApproval**](docs/WorkflowRunsApi.md#setworkflowrunapprovaloperation) | **POST** /v1/workflow-runs/{run_id}/approval | Set Workflow Run Approval Handler
-*WorkflowRunsApi* | [**startWorkflowRun**](docs/WorkflowRunsApi.md#startworkflowrun) | **POST** /v1/workflow-runs/{run_id}/start | Start Workflow Run Handler
+*WorkflowRunsApi* | [**startWorkflowRun**](docs/WorkflowRunsApi.md#startworkflowrunoperation) | **POST** /v1/workflow-runs/{run_id}/start | Start Workflow Run Handler
 *WorkflowRunsApi* | [**stopWorkflowRun**](docs/WorkflowRunsApi.md#stopworkflowrun) | **POST** /v1/workflow-runs/{run_id}/stop | Stop Workflow Run Handler
 *WorkflowRunsApi* | [**updateWorkflowRun**](docs/WorkflowRunsApi.md#updateworkflowrunoperation) | **PATCH** /v1/workflow-runs/{run_id} | Update Workflow Run Handler
 *WorkflowRunsApi* | [**workflowRunCallback**](docs/WorkflowRunsApi.md#workflowruncallbackoperation) | **POST** /v1/workflow-runs/{run_id}/callback | Workflow Run Callback Handler
@@ -473,6 +473,7 @@ All URIs are relative to *http://localhost:8000*
 - [SetWorkflowRunApprovalRequest](docs/SetWorkflowRunApprovalRequest.md)
 - [SignInRequest](docs/SignInRequest.md)
 - [SortDirection](docs/SortDirection.md)
+- [StartWorkflowRunRequest](docs/StartWorkflowRunRequest.md)
 - [StepInput](docs/StepInput.md)
 - [StepKind](docs/StepKind.md)
 - [StepOutput](docs/StepOutput.md)
@@ -576,7 +577,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `0.1.0`
-- Package version: `1.104.0`
+- Package version: `1.106.0`
 - Generator version: `7.21.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

package/dist/apis/WorkflowRunsApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { CloneWorkflowRunRequest, PaginatedResponseWorkflowRunResponse, SetWorkflowRunApprovalRequest, SortDirection, UpdateWorkflowRunRequest, WorkflowCallbackResponse, WorkflowExecutionState, WorkflowRunCallbackRequest, WorkflowRunOrder, WorkflowRunResponse, WorkflowRunSummaryResponse } from '../models/index';
+import type { CloneWorkflowRunRequest, PaginatedResponseWorkflowRunResponse, SetWorkflowRunApprovalRequest, SortDirection, StartWorkflowRunRequest, UpdateWorkflowRunRequest, WorkflowCallbackResponse, WorkflowExecutionState, WorkflowRunCallbackRequest, WorkflowRunOrder, WorkflowRunResponse, WorkflowRunSummaryResponse } from '../models/index';
 export interface CloneWorkflowRunOperationRequest {
     runId: string;
     cloneWorkflowRunRequest: CloneWorkflowRunRequest;
@@ -48,8 +48,9 @@ export interface SetWorkflowRunApprovalOperationRequest {
     runId: string;
     setWorkflowRunApprovalRequest: SetWorkflowRunApprovalRequest;
 }
-export interface StartWorkflowRunRequest {
+export interface StartWorkflowRunOperationRequest {
     runId: string;
+    startWorkflowRunRequest?: StartWorkflowRunRequest | null;
 }
 export interface StopWorkflowRunRequest {
     runId: string;
@@ -249,24 +250,26 @@ export interface WorkflowRunsApiInterface {
     /**
      * Creates request options for startWorkflowRun without sending the request
      * @param {string} runId
+     * @param {StartWorkflowRunRequest} [startWorkflowRunRequest]
      * @throws {RequiredError}
      * @memberof WorkflowRunsApiInterface
      */
-    startWorkflowRunRequestOpts(requestParameters: StartWorkflowRunRequest): Promise<runtime.RequestOpts>;
+    startWorkflowRunRequestOpts(requestParameters: StartWorkflowRunOperationRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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).
+     * 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).  The body is optional; ``user_message`` (when sent) is pinned into the snapshot and shown in the run thread (see ``StartWorkflowRunRequest``).
      * @summary Start Workflow Run Handler
      * @param {string} runId
+     * @param {StartWorkflowRunRequest} [startWorkflowRunRequest]
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof WorkflowRunsApiInterface
      */
-    startWorkflowRunRaw(requestParameters: StartWorkflowRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
+    startWorkflowRunRaw(requestParameters: StartWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
     /**
-     * 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).
+     * 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).  The body is optional; ``user_message`` (when sent) is pinned into the snapshot and shown in the run thread (see ``StartWorkflowRunRequest``).
      * Start Workflow Run Handler
      */
-    startWorkflowRun(requestParameters: StartWorkflowRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
+    startWorkflowRun(requestParameters: StartWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
     /**
      * Creates request options for stopWorkflowRun without sending the request
      * @param {string} runId
@@ -436,17 +439,17 @@ export declare class WorkflowRunsApi extends runtime.BaseAPI implements Workflow
     /**
      * Creates request options for startWorkflowRun without sending the request
      */
-    startWorkflowRunRequestOpts(requestParameters: StartWorkflowRunRequest): Promise<runtime.RequestOpts>;
+    startWorkflowRunRequestOpts(requestParameters: StartWorkflowRunOperationRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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).
+     * 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).  The body is optional; ``user_message`` (when sent) is pinned into the snapshot and shown in the run thread (see ``StartWorkflowRunRequest``).
      * Start Workflow Run Handler
      */
-    startWorkflowRunRaw(requestParameters: StartWorkflowRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
+    startWorkflowRunRaw(requestParameters: StartWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
     /**
-     * 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).
+     * 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).  The body is optional; ``user_message`` (when sent) is pinned into the snapshot and shown in the run thread (see ``StartWorkflowRunRequest``).
      * Start Workflow Run Handler
      */
-    startWorkflowRun(requestParameters: StartWorkflowRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
+    startWorkflowRun(requestParameters: StartWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
     /**
      * Creates request options for stopWorkflowRun without sending the request
      */

package/dist/apis/WorkflowRunsApi.js

@@ -453,6 +453,7 @@ class WorkflowRunsApi extends runtime.BaseAPI {
             }
             const queryParameters = {};
             const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
                 const tokenString = yield token("bearerAuth", []);
@@ -467,11 +468,12 @@ class WorkflowRunsApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
+                body: (0, index_1.StartWorkflowRunRequestToJSON)(requestParameters['startWorkflowRunRequest']),
             };
         });
     }
     /**
-     * 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).
+     * 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).  The body is optional; ``user_message`` (when sent) is pinned into the snapshot and shown in the run thread (see ``StartWorkflowRunRequest``).
      * Start Workflow Run Handler
      */
     startWorkflowRunRaw(requestParameters, initOverrides) {
@@ -482,7 +484,7 @@ class WorkflowRunsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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).
+     * 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).  The body is optional; ``user_message`` (when sent) is pinned into the snapshot and shown in the run thread (see ``StartWorkflowRunRequest``).
      * Start Workflow Run Handler
      */
     startWorkflowRun(requestParameters, initOverrides) {

package/dist/esm/apis/WorkflowRunsApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { CloneWorkflowRunRequest, PaginatedResponseWorkflowRunResponse, SetWorkflowRunApprovalRequest, SortDirection, UpdateWorkflowRunRequest, WorkflowCallbackResponse, WorkflowExecutionState, WorkflowRunCallbackRequest, WorkflowRunOrder, WorkflowRunResponse, WorkflowRunSummaryResponse } from '../models/index';
+import type { CloneWorkflowRunRequest, PaginatedResponseWorkflowRunResponse, SetWorkflowRunApprovalRequest, SortDirection, StartWorkflowRunRequest, UpdateWorkflowRunRequest, WorkflowCallbackResponse, WorkflowExecutionState, WorkflowRunCallbackRequest, WorkflowRunOrder, WorkflowRunResponse, WorkflowRunSummaryResponse } from '../models/index';
 export interface CloneWorkflowRunOperationRequest {
     runId: string;
     cloneWorkflowRunRequest: CloneWorkflowRunRequest;
@@ -48,8 +48,9 @@ export interface SetWorkflowRunApprovalOperationRequest {
     runId: string;
     setWorkflowRunApprovalRequest: SetWorkflowRunApprovalRequest;
 }
-export interface StartWorkflowRunRequest {
+export interface StartWorkflowRunOperationRequest {
     runId: string;
+    startWorkflowRunRequest?: StartWorkflowRunRequest | null;
 }
 export interface StopWorkflowRunRequest {
     runId: string;
@@ -249,24 +250,26 @@ export interface WorkflowRunsApiInterface {
     /**
      * Creates request options for startWorkflowRun without sending the request
      * @param {string} runId
+     * @param {StartWorkflowRunRequest} [startWorkflowRunRequest]
      * @throws {RequiredError}
      * @memberof WorkflowRunsApiInterface
      */
-    startWorkflowRunRequestOpts(requestParameters: StartWorkflowRunRequest): Promise<runtime.RequestOpts>;
+    startWorkflowRunRequestOpts(requestParameters: StartWorkflowRunOperationRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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).
+     * 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).  The body is optional; ``user_message`` (when sent) is pinned into the snapshot and shown in the run thread (see ``StartWorkflowRunRequest``).
      * @summary Start Workflow Run Handler
      * @param {string} runId
+     * @param {StartWorkflowRunRequest} [startWorkflowRunRequest]
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof WorkflowRunsApiInterface
      */
-    startWorkflowRunRaw(requestParameters: StartWorkflowRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
+    startWorkflowRunRaw(requestParameters: StartWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
     /**
-     * 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).
+     * 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).  The body is optional; ``user_message`` (when sent) is pinned into the snapshot and shown in the run thread (see ``StartWorkflowRunRequest``).
      * Start Workflow Run Handler
      */
-    startWorkflowRun(requestParameters: StartWorkflowRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
+    startWorkflowRun(requestParameters: StartWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
     /**
      * Creates request options for stopWorkflowRun without sending the request
      * @param {string} runId
@@ -436,17 +439,17 @@ export declare class WorkflowRunsApi extends runtime.BaseAPI implements Workflow
     /**
      * Creates request options for startWorkflowRun without sending the request
      */
-    startWorkflowRunRequestOpts(requestParameters: StartWorkflowRunRequest): Promise<runtime.RequestOpts>;
+    startWorkflowRunRequestOpts(requestParameters: StartWorkflowRunOperationRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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).
+     * 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).  The body is optional; ``user_message`` (when sent) is pinned into the snapshot and shown in the run thread (see ``StartWorkflowRunRequest``).
      * Start Workflow Run Handler
      */
-    startWorkflowRunRaw(requestParameters: StartWorkflowRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
+    startWorkflowRunRaw(requestParameters: StartWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
     /**
-     * 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).
+     * 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).  The body is optional; ``user_message`` (when sent) is pinned into the snapshot and shown in the run thread (see ``StartWorkflowRunRequest``).
      * Start Workflow Run Handler
      */
-    startWorkflowRun(requestParameters: StartWorkflowRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
+    startWorkflowRun(requestParameters: StartWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
     /**
      * Creates request options for stopWorkflowRun without sending the request
      */

package/dist/esm/apis/WorkflowRunsApi.js

@@ -21,7 +21,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
-import { CloneWorkflowRunRequestToJSON, PaginatedResponseWorkflowRunResponseFromJSON, SetWorkflowRunApprovalRequestToJSON, UpdateWorkflowRunRequestToJSON, WorkflowCallbackResponseFromJSON, WorkflowRunCallbackRequestToJSON, WorkflowRunResponseFromJSON, WorkflowRunSummaryResponseFromJSON, } from '../models/index';
+import { CloneWorkflowRunRequestToJSON, PaginatedResponseWorkflowRunResponseFromJSON, SetWorkflowRunApprovalRequestToJSON, StartWorkflowRunRequestToJSON, UpdateWorkflowRunRequestToJSON, WorkflowCallbackResponseFromJSON, WorkflowRunCallbackRequestToJSON, WorkflowRunResponseFromJSON, WorkflowRunSummaryResponseFromJSON, } from '../models/index';
 /**
  *
  */
@@ -417,6 +417,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI {
             }
             const queryParameters = {};
             const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
                 const tokenString = yield token("bearerAuth", []);
@@ -431,11 +432,12 @@ export class WorkflowRunsApi extends runtime.BaseAPI {
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
+                body: StartWorkflowRunRequestToJSON(requestParameters['startWorkflowRunRequest']),
             };
         });
     }
     /**
-     * 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).
+     * 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).  The body is optional; ``user_message`` (when sent) is pinned into the snapshot and shown in the run thread (see ``StartWorkflowRunRequest``).
      * Start Workflow Run Handler
      */
     startWorkflowRunRaw(requestParameters, initOverrides) {
@@ -446,7 +448,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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).
+     * 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).  The body is optional; ``user_message`` (when sent) is pinned into the snapshot and shown in the run thread (see ``StartWorkflowRunRequest``).
      * Start Workflow Run Handler
      */
     startWorkflowRun(requestParameters, initOverrides) {

package/dist/esm/models/DirectorySyncResponse.d.ts

@@ -45,6 +45,36 @@ export interface DirectorySyncResponse {
      * @memberof DirectorySyncResponse
      */
     usersSkipped?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof DirectorySyncResponse
+     */
+    seatCapExcludedNum?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof DirectorySyncResponse
+     */
+    groupsCreated?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof DirectorySyncResponse
+     */
+    groupsUpdated?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof DirectorySyncResponse
+     */
+    groupMembershipsAdded?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof DirectorySyncResponse
+     */
+    groupMembershipsRemoved?: number;
     /**
      *
      * @type {Array<string>}

package/dist/esm/models/DirectorySyncResponse.js

@@ -31,6 +31,11 @@ export function DirectorySyncResponseFromJSONTyped(json, ignoreDiscriminator) {
         'usersActivated': json['users_activated'] == null ? undefined : json['users_activated'],
         'usersDeactivated': json['users_deactivated'] == null ? undefined : json['users_deactivated'],
         'usersSkipped': json['users_skipped'] == null ? undefined : json['users_skipped'],
+        'seatCapExcludedNum': json['seat_cap_excluded_num'] == null ? undefined : json['seat_cap_excluded_num'],
+        'groupsCreated': json['groups_created'] == null ? undefined : json['groups_created'],
+        'groupsUpdated': json['groups_updated'] == null ? undefined : json['groups_updated'],
+        'groupMembershipsAdded': json['group_memberships_added'] == null ? undefined : json['group_memberships_added'],
+        'groupMembershipsRemoved': json['group_memberships_removed'] == null ? undefined : json['group_memberships_removed'],
         'warnings': json['warnings'] == null ? undefined : json['warnings'],
         'errors': json['errors'] == null ? undefined : json['errors'],
     };
@@ -48,6 +53,11 @@ export function DirectorySyncResponseToJSONTyped(value, ignoreDiscriminator = fa
         'users_activated': value['usersActivated'],
         'users_deactivated': value['usersDeactivated'],
         'users_skipped': value['usersSkipped'],
+        'seat_cap_excluded_num': value['seatCapExcludedNum'],
+        'groups_created': value['groupsCreated'],
+        'groups_updated': value['groupsUpdated'],
+        'group_memberships_added': value['groupMembershipsAdded'],
+        'group_memberships_removed': value['groupMembershipsRemoved'],
         'warnings': value['warnings'],
         'errors': value['errors'],
     };

package/dist/esm/models/GroupResponse.d.ts

@@ -39,6 +39,12 @@ export interface GroupResponse {
      * @memberof GroupResponse
      */
     description: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof GroupResponse
+     */
+    idpGroupId?: string | null;
     /**
      *
      * @type {number}

package/dist/esm/models/GroupResponse.js

@@ -42,6 +42,7 @@ export function GroupResponseFromJSONTyped(json, ignoreDiscriminator) {
         'tenantId': json['tenant_id'],
         'name': json['name'],
         'description': json['description'],
+        'idpGroupId': json['idp_group_id'] == null ? undefined : json['idp_group_id'],
         'memberCount': json['member_count'] == null ? undefined : json['member_count'],
         'createdAt': (new Date(json['created_at'])),
         'updatedAt': (new Date(json['updated_at'])),
@@ -59,6 +60,7 @@ export function GroupResponseToJSONTyped(value, ignoreDiscriminator = false) {
         'tenant_id': value['tenantId'],
         'name': value['name'],
         'description': value['description'],
+        'idp_group_id': value['idpGroupId'],
         'member_count': value['memberCount'],
         'created_at': value['createdAt'].toISOString(),
         'updated_at': value['updatedAt'].toISOString(),

package/dist/esm/models/MembershipResponse.d.ts

@@ -39,6 +39,12 @@ export interface MembershipResponse {
      * @memberof MembershipResponse
      */
     userId: string;
+    /**
+     *
+     * @type {boolean}
+     * @memberof MembershipResponse
+     */
+    idpManaged?: boolean;
     /**
      *
      * @type {Date}

package/dist/esm/models/MembershipResponse.js

@@ -42,6 +42,7 @@ export function MembershipResponseFromJSONTyped(json, ignoreDiscriminator) {
         'tenantId': json['tenant_id'],
         'groupId': json['group_id'],
         'userId': json['user_id'],
+        'idpManaged': json['idp_managed'] == null ? undefined : json['idp_managed'],
         'createdAt': (new Date(json['created_at'])),
         'updatedAt': (new Date(json['updated_at'])),
     };
@@ -58,6 +59,7 @@ export function MembershipResponseToJSONTyped(value, ignoreDiscriminator = false
         'tenant_id': value['tenantId'],
         'group_id': value['groupId'],
         'user_id': value['userId'],
+        'idp_managed': value['idpManaged'],
         'created_at': value['createdAt'].toISOString(),
         'updated_at': value['updatedAt'].toISOString(),
     };

package/dist/esm/models/StartWorkflowRunRequest.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Optional JSON body for ``POST /v1/workflow-runs/{id}/start``.
+ *
+ * The whole body is optional: an absent body starts the run with just
+ * the localized "Started workflow: X" opening message, exactly as
+ * before. When ``user_message`` is set it is appended to that opening
+ * thread message AND injected into the runner's first user turn, so the
+ * agent acts on it as guidance layered on the workflow instruction.
+ * @export
+ * @interface StartWorkflowRunRequest
+ */
+export interface StartWorkflowRunRequest {
+    /**
+     * Free-text instruction shown in the run thread and passed to the agent as additional guidance on top of the workflow instruction. Optional.
+     * @type {string}
+     * @memberof StartWorkflowRunRequest
+     */
+    userMessage?: string | null;
+}
+export declare const StartWorkflowRunRequestPropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maximum?: number;
+        exclusiveMaximum?: boolean;
+        minimum?: number;
+        exclusiveMinimum?: boolean;
+        multipleOf?: number;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+    };
+};
+/**
+ * Check if a given object implements the StartWorkflowRunRequest interface.
+ */
+export declare function instanceOfStartWorkflowRunRequest(value: object): value is StartWorkflowRunRequest;
+export declare function StartWorkflowRunRequestFromJSON(json: any): StartWorkflowRunRequest;
+export declare function StartWorkflowRunRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): StartWorkflowRunRequest;
+export declare function StartWorkflowRunRequestToJSON(json: any): StartWorkflowRunRequest;
+export declare function StartWorkflowRunRequestToJSONTyped(value?: StartWorkflowRunRequest | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/StartWorkflowRunRequest.js

@@ -0,0 +1,46 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+export const StartWorkflowRunRequestPropertyValidationAttributesMap = {
+    userMessage: {
+        maxLength: 4000,
+    },
+};
+/**
+ * Check if a given object implements the StartWorkflowRunRequest interface.
+ */
+export function instanceOfStartWorkflowRunRequest(value) {
+    return true;
+}
+export function StartWorkflowRunRequestFromJSON(json) {
+    return StartWorkflowRunRequestFromJSONTyped(json, false);
+}
+export function StartWorkflowRunRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'userMessage': json['user_message'] == null ? undefined : json['user_message'],
+    };
+}
+export function StartWorkflowRunRequestToJSON(json) {
+    return StartWorkflowRunRequestToJSONTyped(json, false);
+}
+export function StartWorkflowRunRequestToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'user_message': value['userMessage'],
+    };
+}

package/dist/esm/models/WorkflowRunSnapshot.d.ts

@@ -49,6 +49,12 @@ export interface WorkflowRunSnapshot {
      * @memberof WorkflowRunSnapshot
      */
     inputs: Array<InputSnapshot>;
+    /**
+     * Optional free-text message the caller supplied at Start. Pinned here so the runner injects it into the agent's first user turn and it survives retry, redrive, and workflow-thread follow-ups (all of which re-assemble the prompt from this snapshot).
+     * @type {string}
+     * @memberof WorkflowRunSnapshot
+     */
+    userMessage?: string | null;
 }
 export declare const WorkflowRunSnapshotPropertyValidationAttributesMap: {
     [property: string]: {

package/dist/esm/models/WorkflowRunSnapshot.js

@@ -13,7 +13,11 @@
  */
 import { InputSnapshotFromJSON, InputSnapshotToJSON, } from './InputSnapshot';
 import { InstructionSnapshotFromJSON, InstructionSnapshotToJSON, } from './InstructionSnapshot';
-export const WorkflowRunSnapshotPropertyValidationAttributesMap = {};
+export const WorkflowRunSnapshotPropertyValidationAttributesMap = {
+    userMessage: {
+        maxLength: 4000,
+    },
+};
 /**
  * Check if a given object implements the WorkflowRunSnapshot interface.
  */
@@ -40,6 +44,7 @@ export function WorkflowRunSnapshotFromJSONTyped(json, ignoreDiscriminator) {
         'maxRunDurationSeconds': json['max_run_duration_seconds'],
         'instruction': InstructionSnapshotFromJSON(json['instruction']),
         'inputs': (json['inputs'].map(InputSnapshotFromJSON)),
+        'userMessage': json['user_message'] == null ? undefined : json['user_message'],
     };
 }
 export function WorkflowRunSnapshotToJSON(json) {
@@ -54,5 +59,6 @@ export function WorkflowRunSnapshotToJSONTyped(value, ignoreDiscriminator = fals
         'max_run_duration_seconds': value['maxRunDurationSeconds'],
         'instruction': InstructionSnapshotToJSON(value['instruction']),
         'inputs': (value['inputs'].map(InputSnapshotToJSON)),
+        'user_message': value['userMessage'],
     };
 }

package/dist/esm/models/index.d.ts

@@ -211,6 +211,7 @@ export * from './SetApprovalStateRequest';
 export * from './SetWorkflowRunApprovalRequest';
 export * from './SignInRequest';
 export * from './SortDirection';
+export * from './StartWorkflowRunRequest';
 export * from './StepInput';
 export * from './StepKind';
 export * from './StepOutput';

package/dist/esm/models/index.js

@@ -213,6 +213,7 @@ export * from './SetApprovalStateRequest';
 export * from './SetWorkflowRunApprovalRequest';
 export * from './SignInRequest';
 export * from './SortDirection';
+export * from './StartWorkflowRunRequest';
 export * from './StepInput';
 export * from './StepKind';
 export * from './StepOutput';

package/dist/models/DirectorySyncResponse.d.ts

@@ -45,6 +45,36 @@ export interface DirectorySyncResponse {
      * @memberof DirectorySyncResponse
      */
     usersSkipped?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof DirectorySyncResponse
+     */
+    seatCapExcludedNum?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof DirectorySyncResponse
+     */
+    groupsCreated?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof DirectorySyncResponse
+     */
+    groupsUpdated?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof DirectorySyncResponse
+     */
+    groupMembershipsAdded?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof DirectorySyncResponse
+     */
+    groupMembershipsRemoved?: number;
     /**
      *
      * @type {Array<string>}

package/dist/models/DirectorySyncResponse.js

@@ -39,6 +39,11 @@ function DirectorySyncResponseFromJSONTyped(json, ignoreDiscriminator) {
         'usersActivated': json['users_activated'] == null ? undefined : json['users_activated'],
         'usersDeactivated': json['users_deactivated'] == null ? undefined : json['users_deactivated'],
         'usersSkipped': json['users_skipped'] == null ? undefined : json['users_skipped'],
+        'seatCapExcludedNum': json['seat_cap_excluded_num'] == null ? undefined : json['seat_cap_excluded_num'],
+        'groupsCreated': json['groups_created'] == null ? undefined : json['groups_created'],
+        'groupsUpdated': json['groups_updated'] == null ? undefined : json['groups_updated'],
+        'groupMembershipsAdded': json['group_memberships_added'] == null ? undefined : json['group_memberships_added'],
+        'groupMembershipsRemoved': json['group_memberships_removed'] == null ? undefined : json['group_memberships_removed'],
         'warnings': json['warnings'] == null ? undefined : json['warnings'],
         'errors': json['errors'] == null ? undefined : json['errors'],
     };
@@ -56,6 +61,11 @@ function DirectorySyncResponseToJSONTyped(value, ignoreDiscriminator = false) {
         'users_activated': value['usersActivated'],
         'users_deactivated': value['usersDeactivated'],
         'users_skipped': value['usersSkipped'],
+        'seat_cap_excluded_num': value['seatCapExcludedNum'],
+        'groups_created': value['groupsCreated'],
+        'groups_updated': value['groupsUpdated'],
+        'group_memberships_added': value['groupMembershipsAdded'],
+        'group_memberships_removed': value['groupMembershipsRemoved'],
         'warnings': value['warnings'],
         'errors': value['errors'],
     };

package/dist/models/GroupResponse.d.ts

@@ -39,6 +39,12 @@ export interface GroupResponse {
      * @memberof GroupResponse
      */
     description: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof GroupResponse
+     */
+    idpGroupId?: string | null;
     /**
      *
      * @type {number}