@knowledge-stack/ksapi 1.111.1 → 1.112.0

package/dist/models/UpdateWorkflowRunRequest.d.ts

@@ -32,6 +32,18 @@ export interface UpdateWorkflowRunRequest {
      * @memberof UpdateWorkflowRunRequest
      */
     name?: string | null;
+    /**
+     * Arm (or disarm) auto-start on a draft run. When set true, the run dispatches itself once its ``inputs/`` uploads finish ingesting (see ``CreateWorkflowRunRequest.auto_start``). Arm a PENDING run after queuing all uploads to avoid a partial-input start. ``null`` leaves the current setting unchanged.
+     * @type {boolean}
+     * @memberof UpdateWorkflowRunRequest
+     */
+    autoStart?: boolean | null;
+    /**
+     * Set the note applied when this run auto-starts (see ``CreateWorkflowRunRequest.user_message``). ``null`` leaves the stored message unchanged; send an empty string to clear it.
+     * @type {string}
+     * @memberof UpdateWorkflowRunRequest
+     */
+    userMessage?: string | null;
 }
 export declare const UpdateWorkflowRunRequestPropertyValidationAttributesMap: {
     [property: string]: {

package/dist/models/UpdateWorkflowRunRequest.js

@@ -28,6 +28,9 @@ exports.UpdateWorkflowRunRequestPropertyValidationAttributesMap = {
         maxLength: 255,
         minLength: 1,
     },
+    userMessage: {
+        maxLength: 4000,
+    },
 };
 /**
  * Check if a given object implements the UpdateWorkflowRunRequest interface.
@@ -45,6 +48,8 @@ function UpdateWorkflowRunRequestFromJSONTyped(json, ignoreDiscriminator) {
     return {
         'inputScope': json['input_scope'] == null ? undefined : json['input_scope'],
         'name': json['name'] == null ? undefined : json['name'],
+        'autoStart': json['auto_start'] == null ? undefined : json['auto_start'],
+        'userMessage': json['user_message'] == null ? undefined : json['user_message'],
     };
 }
 function UpdateWorkflowRunRequestToJSON(json) {
@@ -57,5 +62,7 @@ function UpdateWorkflowRunRequestToJSONTyped(value, ignoreDiscriminator = false)
     return {
         'input_scope': value['inputScope'],
         'name': value['name'],
+        'auto_start': value['autoStart'],
+        'user_message': value['userMessage'],
     };
 }

package/dist/models/WorkflowRunResponse.d.ts

@@ -120,6 +120,18 @@ export interface WorkflowRunResponse {
      * @memberof WorkflowRunResponse
      */
     error: string | null;
+    /**
+     * Whether the run dispatches itself once its ``inputs/`` uploads finish ingesting, with no separate Start call.
+     * @type {boolean}
+     * @memberof WorkflowRunResponse
+     */
+    autoStart: boolean;
+    /**
+     * The note applied when this run auto-starts (set via create / PATCH ``user_message``); null when none was supplied.
+     * @type {string}
+     * @memberof WorkflowRunResponse
+     */
+    autoStartUserMessage?: string | null;
     /**
      * FOLDER path_part of the run's ``inputs/`` subfolder
      * @type {string}

package/dist/models/WorkflowRunResponse.js

@@ -63,6 +63,8 @@ function instanceOfWorkflowRunResponse(value) {
         return false;
     if (!('error' in value) || value['error'] === undefined)
         return false;
+    if (!('autoStart' in value) || value['autoStart'] === undefined)
+        return false;
     if (!('inputsPathPartId' in value) || value['inputsPathPartId'] === undefined)
         return false;
     if (!('outputsPathPartId' in value) || value['outputsPathPartId'] === undefined)
@@ -100,6 +102,8 @@ function WorkflowRunResponseFromJSONTyped(json, ignoreDiscriminator) {
         'completedAt': (json['completed_at'] == null ? null : new Date(json['completed_at'])),
         'runSnapshot': (0, WorkflowRunSnapshot_1.WorkflowRunSnapshotFromJSON)(json['run_snapshot']),
         'error': json['error'],
+        'autoStart': json['auto_start'],
+        'autoStartUserMessage': json['auto_start_user_message'] == null ? undefined : json['auto_start_user_message'],
         'inputsPathPartId': json['inputs_path_part_id'],
         'outputsPathPartId': json['outputs_path_part_id'],
         'discussionsPathPartId': json['discussions_path_part_id'],
@@ -135,6 +139,8 @@ function WorkflowRunResponseToJSONTyped(value, ignoreDiscriminator = false) {
         'completed_at': value['completedAt'] == null ? value['completedAt'] : value['completedAt'].toISOString(),
         'run_snapshot': (0, WorkflowRunSnapshot_1.WorkflowRunSnapshotToJSON)(value['runSnapshot']),
         'error': value['error'],
+        'auto_start': value['autoStart'],
+        'auto_start_user_message': value['autoStartUserMessage'],
         'inputs_path_part_id': value['inputsPathPartId'],
         'outputs_path_part_id': value['outputsPathPartId'],
         'discussions_path_part_id': value['discussionsPathPartId'],

package/dist/models/index.d.ts

@@ -38,6 +38,7 @@ export * from './CitedChunk';
 export * from './ClearVersionContentsResponse';
 export * from './CloneWorkflowRunRequest';
 export * from './ColumnConfig';
+export * from './ColumnReference';
 export * from './ConnectionConfig';
 export * from './CreateApiConnectionRequest';
 export * from './CreateApiKeyRequest';
@@ -63,6 +64,8 @@ export * from './DataSourceEngine';
 export * from './DataSourceQueryRequest';
 export * from './DataSourceQueryResponse';
 export * from './DataSourceResponse';
+export * from './DataSourceSchemaListResponse';
+export * from './DataSourceSchemaResponse';
 export * from './DataSourceTableResponse';
 export * from './DiffFormat';
 export * from './DiffRow';

package/dist/models/index.js

@@ -56,6 +56,7 @@ __exportStar(require("./CitedChunk"), exports);
 __exportStar(require("./ClearVersionContentsResponse"), exports);
 __exportStar(require("./CloneWorkflowRunRequest"), exports);
 __exportStar(require("./ColumnConfig"), exports);
+__exportStar(require("./ColumnReference"), exports);
 __exportStar(require("./ConnectionConfig"), exports);
 __exportStar(require("./CreateApiConnectionRequest"), exports);
 __exportStar(require("./CreateApiKeyRequest"), exports);
@@ -81,6 +82,8 @@ __exportStar(require("./DataSourceEngine"), exports);
 __exportStar(require("./DataSourceQueryRequest"), exports);
 __exportStar(require("./DataSourceQueryResponse"), exports);
 __exportStar(require("./DataSourceResponse"), exports);
+__exportStar(require("./DataSourceSchemaListResponse"), exports);
+__exportStar(require("./DataSourceSchemaResponse"), exports);
 __exportStar(require("./DataSourceTableResponse"), exports);
 __exportStar(require("./DiffFormat"), exports);
 __exportStar(require("./DiffRow"), exports);

package/docs/CatalogColumnResponse.md

@@ -9,6 +9,7 @@ Name | Type
 `name` | string
 `dataType` | string
 `isPk` | boolean
+`references` | [ColumnReference](ColumnReference.md)
 
 ## Example
 
@@ -20,6 +21,7 @@ const example = {
   "name": null,
   "dataType": null,
   "isPk": null,
+  "references": null,
 } satisfies CatalogColumnResponse
 
 console.log(example)

package/docs/CatalogTableResponse.md

@@ -7,6 +7,7 @@
 Name | Type
 ------------ | -------------
 `name` | string
+`schemaName` | string
 `columns` | [Array<CatalogColumnResponse>](CatalogColumnResponse.md)
 
 ## Example
@@ -17,6 +18,7 @@ import type { CatalogTableResponse } from '@knowledge-stack/ksapi'
 // TODO: Update the object below with actual values
 const example = {
   "name": null,
+  "schemaName": null,
   "columns": null,
 } satisfies CatalogTableResponse
 

package/docs/ColumnConfig.md

@@ -12,6 +12,7 @@ Name | Type
 `comment` | string
 `isPk` | boolean
 `exposed` | boolean
+`references` | [ColumnReference](ColumnReference.md)
 
 ## Example
 
@@ -25,6 +26,7 @@ const example = {
   "comment": null,
   "isPk": null,
   "exposed": null,
+  "references": null,
 } satisfies ColumnConfig
 
 console.log(example)

package/docs/ColumnReference.md

@@ -0,0 +1,39 @@
+
+# ColumnReference
+
+The table+column a foreign-key column points at.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`schemaName` | string
+`table` | string
+`column` | string
+
+## Example
+
+```typescript
+import type { ColumnReference } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "schemaName": null,
+  "table": null,
+  "column": null,
+} satisfies ColumnReference
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as ColumnReference
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/DataSourceSchemaListResponse.md

@@ -0,0 +1,35 @@
+
+# DataSourceSchemaListResponse
+
+The source\'s user namespaces (PG schemas / MySQL databases).
+
+## Properties
+
+Name | Type
+------------ | -------------
+`schemas` | [Array<DataSourceSchemaResponse>](DataSourceSchemaResponse.md)
+
+## Example
+
+```typescript
+import type { DataSourceSchemaListResponse } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "schemas": null,
+} satisfies DataSourceSchemaListResponse
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as DataSourceSchemaListResponse
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/DataSourceSchemaResponse.md

@@ -0,0 +1,36 @@
+
+# DataSourceSchemaResponse
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`name` | string
+`isDefault` | boolean
+
+## Example
+
+```typescript
+import type { DataSourceSchemaResponse } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "name": null,
+  "isDefault": null,
+} satisfies DataSourceSchemaResponse
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as DataSourceSchemaResponse
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/DataSourceTableResponse.md

@@ -16,6 +16,7 @@ Name | Type
 `name` | string
 `dataSourceId` | string
 `tableName` | string
+`schemaName` | string
 `description` | string
 `columnConfig` | Array<{ [key: string]: any; }>
 `approvalState` | [PathPartApprovalState](PathPartApprovalState.md)
@@ -39,6 +40,7 @@ const example = {
   "name": null,
   "dataSourceId": null,
   "tableName": null,
+  "schemaName": null,
   "description": null,
   "columnConfig": null,
   "approvalState": null,

package/docs/DataSourcesApi.md

@@ -8,6 +8,7 @@ All URIs are relative to *http://localhost:8000*
 | [**deleteDataSource**](DataSourcesApi.md#deletedatasource) | **DELETE** /v1/data-sources/{data_source_id} | Delete Data Source Handler |
 | [**getDataSource**](DataSourcesApi.md#getdatasource) | **GET** /v1/data-sources/{data_source_id} | Get Data Source Handler |
 | [**getDataSourceCatalog**](DataSourcesApi.md#getdatasourcecatalog) | **GET** /v1/data-sources/{data_source_id}/catalog | Get Data Source Catalog Handler |
+| [**listDataSourceSchemas**](DataSourcesApi.md#listdatasourceschemas) | **GET** /v1/data-sources/{data_source_id}/schemas | List Data Source Schemas Handler |
 | [**modelDataSourceTable**](DataSourcesApi.md#modeldatasourcetable) | **POST** /v1/data-sources/{data_source_id}/tables | Model Data Source Table Handler |
 | [**queryDataSource**](DataSourcesApi.md#querydatasource) | **POST** /v1/data-sources/{data_source_id}/query | Query Data Source Handler |
 | [**testDataSourceConnection**](DataSourcesApi.md#testdatasourceconnection) | **POST** /v1/data-sources/{data_source_id}/test | Test Data Source Connection Handler |
@@ -242,11 +243,11 @@ example().catch(console.error);
 
 ## getDataSourceCatalog
 
-> DataSourceCatalogResponse getDataSourceCatalog(dataSourceId)
+> DataSourceCatalogResponse getDataSourceCatalog(dataSourceId, schema)
 
 Get Data Source Catalog Handler
 
-Live-introspect the external DB so an admin can pick tables to model.
+Live-introspect a schema of the external DB so an admin can pick tables.
 
 ### Example
 
@@ -270,6 +271,8 @@ async function example() {
   const body = {
     // string
     dataSourceId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
+    // string | Schema/namespace to introspect (default: connection default) (optional)
+    schema: schema_example,
   } satisfies GetDataSourceCatalogRequest;
 
   try {
@@ -290,6 +293,7 @@ example().catch(console.error);
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **dataSourceId** | `string` |  | [Defaults to `undefined`] |
+| **schema** | `string` | Schema/namespace to introspect (default: connection default) | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 
@@ -315,6 +319,81 @@ example().catch(console.error);
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## listDataSourceSchemas
+
+> DataSourceSchemaListResponse listDataSourceSchemas(dataSourceId)
+
+List Data Source Schemas Handler
+
+List the source\'s user namespaces (PG schemas / MySQL databases).
+
+### Example
+
+```ts
+import {
+  Configuration,
+  DataSourcesApi,
+} from '@knowledge-stack/ksapi';
+import type { ListDataSourceSchemasRequest } from '@knowledge-stack/ksapi';
+
+async function example() {
+  console.log("🚀 Testing @knowledge-stack/ksapi SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: cookieAuth
+    apiKey: "YOUR API KEY",
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new DataSourcesApi(config);
+
+  const body = {
+    // string
+    dataSourceId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
+  } satisfies ListDataSourceSchemasRequest;
+
+  try {
+    const data = await api.listDataSourceSchemas(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **dataSourceId** | `string` |  | [Defaults to `undefined`] |
+
+### Return type
+
+[**DataSourceSchemaListResponse**](DataSourceSchemaListResponse.md)
+
+### Authorization
+
+[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Successful Response |  -  |
+| **422** | Validation Error |  -  |
+| **0** | Error response. |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## modelDataSourceTable
 
 > DataSourceTableResponse modelDataSourceTable(dataSourceId, modelTableRequest)

package/docs/DocumentVersionsApi.md

@@ -747,7 +747,7 @@ example().catch(console.error);
 
 Update Document Version Metadata Handler
 
-Merge metadata fields into an existing document version\'s metadata.  Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved.
+Merge metadata fields into an existing document version\'s metadata.  Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved.  When this PATCH settles an ``inputs/`` upload\'s ingestion (an in-progress pipeline reaching a terminal state), it drives the parent workflow run forward: the two-step ``PENDING <-> NOT_STARTED`` toggle, plus auto-start / auto-fail for an ``auto_start`` run (see ``WorkflowRunStartService.auto_advance_on_input_settled``).
 
 ### Example
 

package/docs/FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceTableResponseOrApiConnectionResponse.md

@@ -41,6 +41,8 @@ Name | Type
 `completedAt` | Date
 `runSnapshot` | [WorkflowRunSnapshot](WorkflowRunSnapshot.md)
 `error` | string
+`autoStart` | boolean
+`autoStartUserMessage` | string
 `inputsPathPartId` | string
 `outputsPathPartId` | string
 `discussionsPathPartId` | string
@@ -50,6 +52,7 @@ Name | Type
 `engine` | [DataSourceEngine](DataSourceEngine.md)
 `dataSourceId` | string
 `tableName` | string
+`schemaName` | string
 `columnConfig` | Array<{ [key: string]: any; }>
 `baseUrl` | string
 `networkClass` | [NetworkClass](NetworkClass.md)
@@ -100,6 +103,8 @@ const example = {
   "completedAt": null,
   "runSnapshot": null,
   "error": null,
+  "autoStart": null,
+  "autoStartUserMessage": null,
   "inputsPathPartId": null,
   "outputsPathPartId": null,
   "discussionsPathPartId": null,
@@ -109,6 +114,7 @@ const example = {
   "engine": null,
   "dataSourceId": null,
   "tableName": null,
+  "schemaName": null,
   "columnConfig": null,
   "baseUrl": null,
   "networkClass": null,

package/docs/ModelTableRequest.md

@@ -8,6 +8,7 @@ Model a DB table as a queryable child of the connector.
 Name | Type
 ------------ | -------------
 `tableName` | string
+`schemaName` | string
 `name` | string
 `description` | string
 `columnConfig` | [Array<ColumnConfig>](ColumnConfig.md)
@@ -20,6 +21,7 @@ import type { ModelTableRequest } from '@knowledge-stack/ksapi'
 // TODO: Update the object below with actual values
 const example = {
   "tableName": null,
+  "schemaName": null,
   "name": null,
   "description": null,
   "columnConfig": null,

package/docs/UpdateWorkflowRunRequest.md

@@ -9,6 +9,8 @@ Name | Type
 ------------ | -------------
 `inputScope` | Array<string>
 `name` | string
+`autoStart` | boolean
+`userMessage` | string
 
 ## Example
 
@@ -19,6 +21,8 @@ import type { UpdateWorkflowRunRequest } from '@knowledge-stack/ksapi'
 const example = {
   "inputScope": null,
   "name": null,
+  "autoStart": null,
+  "userMessage": null,
 } satisfies UpdateWorkflowRunRequest
 
 console.log(example)

package/docs/WorkflowDefinitionsApi.md

@@ -90,7 +90,7 @@ example().catch(console.error);
 
 ## createWorkflowRun
 
-> WorkflowRunResponse createWorkflowRun(definitionId, files, inputScope, idempotencyKey)
+> WorkflowRunResponse createWorkflowRun(definitionId, files, inputScope, idempotencyKey, autoStart, userMessage)
 
 Create Workflow Run Handler
 
@@ -124,6 +124,10 @@ async function example() {
     inputScope: inputScope_example,
     // string | Optional key to prevent duplicate runs from retries. (optional)
     idempotencyKey: idempotencyKey_example,
+    // boolean | When true, the run starts itself once its ``inputs/`` uploads finish ingesting — eliminating the separate Start call. If an upload\\\'s ingestion fails, the run is marked FAILED. Default false (two-step flow). Arm only after all uploads are queued; a synchronously-completing first upload would otherwise start the run before later uploads are added. (optional)
+    autoStart: true,
+    // string | Optional note carried to the auto-start dispatch (the equivalent of the Start endpoint\\\'s ``user_message`` for a self-starting run). Applied only when ``auto_start`` fires. (optional)
+    userMessage: userMessage_example,
   } satisfies CreateWorkflowRunRequest;
 
   try {
@@ -147,6 +151,8 @@ example().catch(console.error);
 | **files** | `Array<Blob>` | DEPRECATED — do not send files here. Carrying file bytes on run creation makes the call block on synchronous S3 upload (the ~30s \\\&#39;Create run\\\&#39; wait). Instead create an empty draft (omit this field), then upload each file to the run\\\&#39;s &#x60;&#x60;inputs/&#x60;&#x60; folder via &#x60;&#x60;POST /v1/documents/ingest&#x60;&#x60; with &#x60;&#x60;path_part_id&#x60;&#x60; set to the run\\\&#39;s &#x60;&#x60;inputs_path_part_id&#x60;&#x60;; that path ingests asynchronously and auto-syncs the run\\\&#39;s state. This field will be removed once the FE has migrated. | [Optional] |
 | **inputScope** | `string` | JSON array of &#x60;&#x60;DOCUMENT&#x60;&#x60; or &#x60;&#x60;FOLDER&#x60;&#x60; path_part UUIDs referenced from the existing knowledge base, pinned onto the new draft\\\&#39;s input scope. Optional — omit for an empty draft and add references later via PATCH. | [Optional] [Defaults to `undefined`] |
 | **idempotencyKey** | `string` | Optional key to prevent duplicate runs from retries. | [Optional] [Defaults to `undefined`] |
+| **autoStart** | `boolean` | When true, the run starts itself once its &#x60;&#x60;inputs/&#x60;&#x60; uploads finish ingesting — eliminating the separate Start call. If an upload\\\&#39;s ingestion fails, the run is marked FAILED. Default false (two-step flow). Arm only after all uploads are queued; a synchronously-completing first upload would otherwise start the run before later uploads are added. | [Optional] [Defaults to `false`] |
+| **userMessage** | `string` | Optional note carried to the auto-start dispatch (the equivalent of the Start endpoint\\\&#39;s &#x60;&#x60;user_message&#x60;&#x60; for a self-starting run). Applied only when &#x60;&#x60;auto_start&#x60;&#x60; fires. | [Optional] [Defaults to `undefined`] |
 
 ### Return type
 

package/docs/WorkflowRunResponse.md

@@ -22,6 +22,8 @@ Name | Type
 `completedAt` | Date
 `runSnapshot` | [WorkflowRunSnapshot](WorkflowRunSnapshot.md)
 `error` | string
+`autoStart` | boolean
+`autoStartUserMessage` | string
 `inputsPathPartId` | string
 `outputsPathPartId` | string
 `discussionsPathPartId` | string
@@ -55,6 +57,8 @@ const example = {
   "completedAt": null,
   "runSnapshot": null,
   "error": null,
+  "autoStart": null,
+  "autoStartUserMessage": null,
   "inputsPathPartId": null,
   "outputsPathPartId": null,
   "discussionsPathPartId": null,

package/docs/WorkflowRunsApi.md

@@ -746,7 +746,7 @@ example().catch(console.error);
 
 Update Workflow Run 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.
+Edit a NOT_STARTED run\'s KB scope, name, and / or auto_start.  Both body fields are optional but at least one must be present. The run must be ``NOT_STARTED`` or ``PENDING`` (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.  Arming ``auto_start`` on a run that is already ``NOT_STARTED`` (its inputs have settled) dispatches it immediately — the run would otherwise never receive an ingestion-completion hook to start it. A ``PENDING`` run is left to auto-advance when its uploads finish.
 
 ### Example
 

package/package.json

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