@knowledge-stack/ksapi 1.111.0 → 1.112.0

package/.openapi-generator/FILES

@@ -49,6 +49,7 @@ docs/CitedChunk.md
 docs/ClearVersionContentsResponse.md
 docs/CloneWorkflowRunRequest.md
 docs/ColumnConfig.md
+docs/ColumnReference.md
 docs/ConnectionConfig.md
 docs/CreateApiConnectionRequest.md
 docs/CreateApiKeyRequest.md
@@ -74,6 +75,8 @@ docs/DataSourceEngine.md
 docs/DataSourceQueryRequest.md
 docs/DataSourceQueryResponse.md
 docs/DataSourceResponse.md
+docs/DataSourceSchemaListResponse.md
+docs/DataSourceSchemaResponse.md
 docs/DataSourceTableResponse.md
 docs/DataSourcesApi.md
 docs/DefaultApi.md
@@ -405,6 +408,7 @@ src/models/CitedChunk.ts
 src/models/ClearVersionContentsResponse.ts
 src/models/CloneWorkflowRunRequest.ts
 src/models/ColumnConfig.ts
+src/models/ColumnReference.ts
 src/models/ConnectionConfig.ts
 src/models/CreateApiConnectionRequest.ts
 src/models/CreateApiKeyRequest.ts
@@ -430,6 +434,8 @@ src/models/DataSourceEngine.ts
 src/models/DataSourceQueryRequest.ts
 src/models/DataSourceQueryResponse.ts
 src/models/DataSourceResponse.ts
+src/models/DataSourceSchemaListResponse.ts
+src/models/DataSourceSchemaResponse.ts
 src/models/DataSourceTableResponse.ts
 src/models/DiffFormat.ts
 src/models/DiffRow.ts

package/README.md

@@ -1,4 +1,4 @@
-# @knowledge-stack/ksapi@1.111.0
+# @knowledge-stack/ksapi@1.112.0
 
 A TypeScript SDK client for the localhost API.
 
@@ -104,6 +104,7 @@ All URIs are relative to *http://localhost:8000*
 *DataSourcesApi* | [**deleteDataSource**](docs/DataSourcesApi.md#deletedatasource) | **DELETE** /v1/data-sources/{data_source_id} | Delete Data Source Handler
 *DataSourcesApi* | [**getDataSource**](docs/DataSourcesApi.md#getdatasource) | **GET** /v1/data-sources/{data_source_id} | Get Data Source Handler
 *DataSourcesApi* | [**getDataSourceCatalog**](docs/DataSourcesApi.md#getdatasourcecatalog) | **GET** /v1/data-sources/{data_source_id}/catalog | Get Data Source Catalog Handler
+*DataSourcesApi* | [**listDataSourceSchemas**](docs/DataSourcesApi.md#listdatasourceschemas) | **GET** /v1/data-sources/{data_source_id}/schemas | List Data Source Schemas Handler
 *DataSourcesApi* | [**modelDataSourceTable**](docs/DataSourcesApi.md#modeldatasourcetable) | **POST** /v1/data-sources/{data_source_id}/tables | Model Data Source Table Handler
 *DataSourcesApi* | [**queryDataSource**](docs/DataSourcesApi.md#querydatasource) | **POST** /v1/data-sources/{data_source_id}/query | Query Data Source Handler
 *DataSourcesApi* | [**testDataSourceConnection**](docs/DataSourcesApi.md#testdatasourceconnection) | **POST** /v1/data-sources/{data_source_id}/test | Test Data Source Connection Handler
@@ -300,6 +301,7 @@ All URIs are relative to *http://localhost:8000*
 - [ClearVersionContentsResponse](docs/ClearVersionContentsResponse.md)
 - [CloneWorkflowRunRequest](docs/CloneWorkflowRunRequest.md)
 - [ColumnConfig](docs/ColumnConfig.md)
+- [ColumnReference](docs/ColumnReference.md)
 - [ConnectionConfig](docs/ConnectionConfig.md)
 - [CreateApiConnectionRequest](docs/CreateApiConnectionRequest.md)
 - [CreateApiKeyRequest](docs/CreateApiKeyRequest.md)
@@ -325,6 +327,8 @@ All URIs are relative to *http://localhost:8000*
 - [DataSourceQueryRequest](docs/DataSourceQueryRequest.md)
 - [DataSourceQueryResponse](docs/DataSourceQueryResponse.md)
 - [DataSourceResponse](docs/DataSourceResponse.md)
+- [DataSourceSchemaListResponse](docs/DataSourceSchemaListResponse.md)
+- [DataSourceSchemaResponse](docs/DataSourceSchemaResponse.md)
 - [DataSourceTableResponse](docs/DataSourceTableResponse.md)
 - [DiffFormat](docs/DiffFormat.md)
 - [DiffRow](docs/DiffRow.md)
@@ -577,7 +581,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `0.1.0`
-- Package version: `1.111.0`
+- Package version: `1.112.0`
 - Generator version: `7.21.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

package/dist/apis/DataSourcesApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { CreateDataSourceRequest, DataSourceCatalogResponse, DataSourceDetailResponse, DataSourceQueryRequest, DataSourceQueryResponse, DataSourceResponse, DataSourceTableResponse, ModelTableRequest, UpdateTableRequest } from '../models/index';
+import type { CreateDataSourceRequest, DataSourceCatalogResponse, DataSourceDetailResponse, DataSourceQueryRequest, DataSourceQueryResponse, DataSourceResponse, DataSourceSchemaListResponse, DataSourceTableResponse, ModelTableRequest, UpdateTableRequest } from '../models/index';
 export interface CreateDataSourceOperationRequest {
     createDataSourceRequest: CreateDataSourceRequest;
 }
@@ -22,6 +22,10 @@ export interface GetDataSourceRequest {
 }
 export interface GetDataSourceCatalogRequest {
     dataSourceId: string;
+    schema?: string | null;
+}
+export interface ListDataSourceSchemasRequest {
+    dataSourceId: string;
 }
 export interface ModelDataSourceTableRequest {
     dataSourceId: string;
@@ -112,24 +116,47 @@ export interface DataSourcesApiInterface {
     /**
      * Creates request options for getDataSourceCatalog without sending the request
      * @param {string} dataSourceId
+     * @param {string} [schema] Schema/namespace to introspect (default: connection default)
      * @throws {RequiredError}
      * @memberof DataSourcesApiInterface
      */
     getDataSourceCatalogRequestOpts(requestParameters: GetDataSourceCatalogRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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.
      * @summary Get Data Source Catalog Handler
      * @param {string} dataSourceId
+     * @param {string} [schema] Schema/namespace to introspect (default: connection default)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof DataSourcesApiInterface
      */
     getDataSourceCatalogRaw(requestParameters: GetDataSourceCatalogRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceCatalogResponse>>;
     /**
-     * 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.
      * Get Data Source Catalog Handler
      */
     getDataSourceCatalog(requestParameters: GetDataSourceCatalogRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceCatalogResponse>;
+    /**
+     * Creates request options for listDataSourceSchemas without sending the request
+     * @param {string} dataSourceId
+     * @throws {RequiredError}
+     * @memberof DataSourcesApiInterface
+     */
+    listDataSourceSchemasRequestOpts(requestParameters: ListDataSourceSchemasRequest): Promise<runtime.RequestOpts>;
+    /**
+     * List the source\'s user namespaces (PG schemas / MySQL databases).
+     * @summary List Data Source Schemas Handler
+     * @param {string} dataSourceId
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DataSourcesApiInterface
+     */
+    listDataSourceSchemasRaw(requestParameters: ListDataSourceSchemasRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceSchemaListResponse>>;
+    /**
+     * List the source\'s user namespaces (PG schemas / MySQL databases).
+     * List Data Source Schemas Handler
+     */
+    listDataSourceSchemas(requestParameters: ListDataSourceSchemasRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceSchemaListResponse>;
     /**
      * Creates request options for modelDataSourceTable without sending the request
      * @param {string} dataSourceId
@@ -274,15 +301,29 @@ export declare class DataSourcesApi extends runtime.BaseAPI implements DataSourc
      */
     getDataSourceCatalogRequestOpts(requestParameters: GetDataSourceCatalogRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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.
      * Get Data Source Catalog Handler
      */
     getDataSourceCatalogRaw(requestParameters: GetDataSourceCatalogRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceCatalogResponse>>;
     /**
-     * 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.
      * Get Data Source Catalog Handler
      */
     getDataSourceCatalog(requestParameters: GetDataSourceCatalogRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceCatalogResponse>;
+    /**
+     * Creates request options for listDataSourceSchemas without sending the request
+     */
+    listDataSourceSchemasRequestOpts(requestParameters: ListDataSourceSchemasRequest): Promise<runtime.RequestOpts>;
+    /**
+     * List the source\'s user namespaces (PG schemas / MySQL databases).
+     * List Data Source Schemas Handler
+     */
+    listDataSourceSchemasRaw(requestParameters: ListDataSourceSchemasRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceSchemaListResponse>>;
+    /**
+     * List the source\'s user namespaces (PG schemas / MySQL databases).
+     * List Data Source Schemas Handler
+     */
+    listDataSourceSchemas(requestParameters: ListDataSourceSchemasRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceSchemaListResponse>;
     /**
      * Creates request options for modelDataSourceTable without sending the request
      */

package/dist/apis/DataSourcesApi.js

@@ -215,6 +215,9 @@ class DataSourcesApi extends runtime.BaseAPI {
                 throw new runtime.RequiredError('dataSourceId', 'Required parameter "dataSourceId" was null or undefined when calling getDataSourceCatalog().');
             }
             const queryParameters = {};
+            if (requestParameters['schema'] != null) {
+                queryParameters['schema'] = requestParameters['schema'];
+            }
             const headerParameters = {};
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
@@ -234,7 +237,7 @@ class DataSourcesApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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.
      * Get Data Source Catalog Handler
      */
     getDataSourceCatalogRaw(requestParameters, initOverrides) {
@@ -245,7 +248,7 @@ class DataSourcesApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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.
      * Get Data Source Catalog Handler
      */
     getDataSourceCatalog(requestParameters, initOverrides) {
@@ -254,6 +257,54 @@ class DataSourcesApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for listDataSourceSchemas without sending the request
+     */
+    listDataSourceSchemasRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['dataSourceId'] == null) {
+                throw new runtime.RequiredError('dataSourceId', 'Required parameter "dataSourceId" was null or undefined when calling listDataSourceSchemas().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/v1/data-sources/{data_source_id}/schemas`;
+            urlPath = urlPath.replace(`{${"data_source_id"}}`, encodeURIComponent(String(requestParameters['dataSourceId'])));
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * List the source\'s user namespaces (PG schemas / MySQL databases).
+     * List Data Source Schemas Handler
+     */
+    listDataSourceSchemasRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.listDataSourceSchemasRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.DataSourceSchemaListResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * List the source\'s user namespaces (PG schemas / MySQL databases).
+     * List Data Source Schemas Handler
+     */
+    listDataSourceSchemas(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.listDataSourceSchemasRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for modelDataSourceTable without sending the request
      */

package/dist/apis/DocumentVersionsApi.d.ts

@@ -297,7 +297,7 @@ export interface DocumentVersionsApiInterface {
      */
     updateDocumentVersionMetadataRequestOpts(requestParameters: UpdateDocumentVersionMetadataRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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``).
      * @summary Update Document Version Metadata Handler
      * @param {string} versionId DocumentVersion ID
      * @param {DocumentVersionMetadataUpdate} documentVersionMetadataUpdate
@@ -307,7 +307,7 @@ export interface DocumentVersionsApiInterface {
      */
     updateDocumentVersionMetadataRaw(requestParameters: UpdateDocumentVersionMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DocumentVersionResponse>>;
     /**
-     * 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``).
      * Update Document Version Metadata Handler
      */
     updateDocumentVersionMetadata(requestParameters: UpdateDocumentVersionMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionResponse>;
@@ -445,12 +445,12 @@ export declare class DocumentVersionsApi extends runtime.BaseAPI implements Docu
      */
     updateDocumentVersionMetadataRequestOpts(requestParameters: UpdateDocumentVersionMetadataRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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``).
      * Update Document Version Metadata Handler
      */
     updateDocumentVersionMetadataRaw(requestParameters: UpdateDocumentVersionMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DocumentVersionResponse>>;
     /**
-     * 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``).
      * Update Document Version Metadata Handler
      */
     updateDocumentVersionMetadata(requestParameters: UpdateDocumentVersionMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionResponse>;

package/dist/apis/DocumentVersionsApi.js

@@ -580,7 +580,7 @@ class DocumentVersionsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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``).
      * Update Document Version Metadata Handler
      */
     updateDocumentVersionMetadataRaw(requestParameters, initOverrides) {
@@ -591,7 +591,7 @@ class DocumentVersionsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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``).
      * Update Document Version Metadata Handler
      */
     updateDocumentVersionMetadata(requestParameters, initOverrides) {

package/dist/apis/WorkflowDefinitionsApi.d.ts

@@ -19,6 +19,8 @@ export interface CreateWorkflowRunRequest {
     files?: Array<Blob>;
     inputScope?: string | null;
     idempotencyKey?: string | null;
+    autoStart?: boolean;
+    userMessage?: string | null;
 }
 export interface DeleteWorkflowDefinitionRequest {
     definitionId: string;
@@ -90,6 +92,8 @@ export interface WorkflowDefinitionsApiInterface {
      * @param {Array<Blob>} [files] 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.
      * @param {string} [inputScope] 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.
      * @param {string} [idempotencyKey] Optional key to prevent duplicate runs from retries.
+     * @param {boolean} [autoStart] 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.
+     * @param {string} [userMessage] 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.
      * @throws {RequiredError}
      * @memberof WorkflowDefinitionsApiInterface
      */
@@ -101,6 +105,8 @@ export interface WorkflowDefinitionsApiInterface {
      * @param {Array<Blob>} [files] 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.
      * @param {string} [inputScope] 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.
      * @param {string} [idempotencyKey] Optional key to prevent duplicate runs from retries.
+     * @param {boolean} [autoStart] 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.
+     * @param {string} [userMessage] 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.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof WorkflowDefinitionsApiInterface

package/dist/apis/WorkflowDefinitionsApi.js

@@ -152,6 +152,12 @@ class WorkflowDefinitionsApi extends runtime.BaseAPI {
             if (requestParameters['idempotencyKey'] != null) {
                 formParams.append('idempotency_key', requestParameters['idempotencyKey']);
             }
+            if (requestParameters['autoStart'] != null) {
+                formParams.append('auto_start', requestParameters['autoStart']);
+            }
+            if (requestParameters['userMessage'] != null) {
+                formParams.append('user_message', requestParameters['userMessage']);
+            }
             let urlPath = `/v1/workflow-definitions/{definition_id}/runs`;
             urlPath = urlPath.replace(`{${"definition_id"}}`, encodeURIComponent(String(requestParameters['definitionId'])));
             return {

package/dist/apis/WorkflowRunsApi.d.ts

@@ -300,7 +300,7 @@ export interface WorkflowRunsApiInterface {
      */
     updateWorkflowRunRequestOpts(requestParameters: UpdateWorkflowRunOperationRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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.
      * @summary Update Workflow Run Handler
      * @param {string} runId
      * @param {UpdateWorkflowRunRequest} updateWorkflowRunRequest
@@ -310,7 +310,7 @@ export interface WorkflowRunsApiInterface {
      */
     updateWorkflowRunRaw(requestParameters: UpdateWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
     /**
-     * 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.
      * Update Workflow Run Handler
      */
     updateWorkflowRun(requestParameters: UpdateWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
@@ -469,12 +469,12 @@ export declare class WorkflowRunsApi extends runtime.BaseAPI implements Workflow
      */
     updateWorkflowRunRequestOpts(requestParameters: UpdateWorkflowRunOperationRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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.
      * Update Workflow Run Handler
      */
     updateWorkflowRunRaw(requestParameters: UpdateWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
     /**
-     * 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.
      * Update Workflow Run Handler
      */
     updateWorkflowRun(requestParameters: UpdateWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;

package/dist/apis/WorkflowRunsApi.js

@@ -574,7 +574,7 @@ class WorkflowRunsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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.
      * Update Workflow Run Handler
      */
     updateWorkflowRunRaw(requestParameters, initOverrides) {
@@ -585,7 +585,7 @@ class WorkflowRunsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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.
      * Update Workflow Run Handler
      */
     updateWorkflowRun(requestParameters, initOverrides) {

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

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { CreateDataSourceRequest, DataSourceCatalogResponse, DataSourceDetailResponse, DataSourceQueryRequest, DataSourceQueryResponse, DataSourceResponse, DataSourceTableResponse, ModelTableRequest, UpdateTableRequest } from '../models/index';
+import type { CreateDataSourceRequest, DataSourceCatalogResponse, DataSourceDetailResponse, DataSourceQueryRequest, DataSourceQueryResponse, DataSourceResponse, DataSourceSchemaListResponse, DataSourceTableResponse, ModelTableRequest, UpdateTableRequest } from '../models/index';
 export interface CreateDataSourceOperationRequest {
     createDataSourceRequest: CreateDataSourceRequest;
 }
@@ -22,6 +22,10 @@ export interface GetDataSourceRequest {
 }
 export interface GetDataSourceCatalogRequest {
     dataSourceId: string;
+    schema?: string | null;
+}
+export interface ListDataSourceSchemasRequest {
+    dataSourceId: string;
 }
 export interface ModelDataSourceTableRequest {
     dataSourceId: string;
@@ -112,24 +116,47 @@ export interface DataSourcesApiInterface {
     /**
      * Creates request options for getDataSourceCatalog without sending the request
      * @param {string} dataSourceId
+     * @param {string} [schema] Schema/namespace to introspect (default: connection default)
      * @throws {RequiredError}
      * @memberof DataSourcesApiInterface
      */
     getDataSourceCatalogRequestOpts(requestParameters: GetDataSourceCatalogRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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.
      * @summary Get Data Source Catalog Handler
      * @param {string} dataSourceId
+     * @param {string} [schema] Schema/namespace to introspect (default: connection default)
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof DataSourcesApiInterface
      */
     getDataSourceCatalogRaw(requestParameters: GetDataSourceCatalogRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceCatalogResponse>>;
     /**
-     * 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.
      * Get Data Source Catalog Handler
      */
     getDataSourceCatalog(requestParameters: GetDataSourceCatalogRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceCatalogResponse>;
+    /**
+     * Creates request options for listDataSourceSchemas without sending the request
+     * @param {string} dataSourceId
+     * @throws {RequiredError}
+     * @memberof DataSourcesApiInterface
+     */
+    listDataSourceSchemasRequestOpts(requestParameters: ListDataSourceSchemasRequest): Promise<runtime.RequestOpts>;
+    /**
+     * List the source\'s user namespaces (PG schemas / MySQL databases).
+     * @summary List Data Source Schemas Handler
+     * @param {string} dataSourceId
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DataSourcesApiInterface
+     */
+    listDataSourceSchemasRaw(requestParameters: ListDataSourceSchemasRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceSchemaListResponse>>;
+    /**
+     * List the source\'s user namespaces (PG schemas / MySQL databases).
+     * List Data Source Schemas Handler
+     */
+    listDataSourceSchemas(requestParameters: ListDataSourceSchemasRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceSchemaListResponse>;
     /**
      * Creates request options for modelDataSourceTable without sending the request
      * @param {string} dataSourceId
@@ -274,15 +301,29 @@ export declare class DataSourcesApi extends runtime.BaseAPI implements DataSourc
      */
     getDataSourceCatalogRequestOpts(requestParameters: GetDataSourceCatalogRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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.
      * Get Data Source Catalog Handler
      */
     getDataSourceCatalogRaw(requestParameters: GetDataSourceCatalogRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceCatalogResponse>>;
     /**
-     * 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.
      * Get Data Source Catalog Handler
      */
     getDataSourceCatalog(requestParameters: GetDataSourceCatalogRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceCatalogResponse>;
+    /**
+     * Creates request options for listDataSourceSchemas without sending the request
+     */
+    listDataSourceSchemasRequestOpts(requestParameters: ListDataSourceSchemasRequest): Promise<runtime.RequestOpts>;
+    /**
+     * List the source\'s user namespaces (PG schemas / MySQL databases).
+     * List Data Source Schemas Handler
+     */
+    listDataSourceSchemasRaw(requestParameters: ListDataSourceSchemasRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceSchemaListResponse>>;
+    /**
+     * List the source\'s user namespaces (PG schemas / MySQL databases).
+     * List Data Source Schemas Handler
+     */
+    listDataSourceSchemas(requestParameters: ListDataSourceSchemasRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceSchemaListResponse>;
     /**
      * Creates request options for modelDataSourceTable without sending the request
      */

package/dist/esm/apis/DataSourcesApi.js

@@ -21,7 +21,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
-import { CreateDataSourceRequestToJSON, DataSourceCatalogResponseFromJSON, DataSourceDetailResponseFromJSON, DataSourceQueryRequestToJSON, DataSourceQueryResponseFromJSON, DataSourceResponseFromJSON, DataSourceTableResponseFromJSON, ModelTableRequestToJSON, UpdateTableRequestToJSON, } from '../models/index';
+import { CreateDataSourceRequestToJSON, DataSourceCatalogResponseFromJSON, DataSourceDetailResponseFromJSON, DataSourceQueryRequestToJSON, DataSourceQueryResponseFromJSON, DataSourceResponseFromJSON, DataSourceSchemaListResponseFromJSON, DataSourceTableResponseFromJSON, ModelTableRequestToJSON, UpdateTableRequestToJSON, } from '../models/index';
 /**
  *
  */
@@ -179,6 +179,9 @@ export class DataSourcesApi extends runtime.BaseAPI {
                 throw new runtime.RequiredError('dataSourceId', 'Required parameter "dataSourceId" was null or undefined when calling getDataSourceCatalog().');
             }
             const queryParameters = {};
+            if (requestParameters['schema'] != null) {
+                queryParameters['schema'] = requestParameters['schema'];
+            }
             const headerParameters = {};
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;
@@ -198,7 +201,7 @@ export class DataSourcesApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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.
      * Get Data Source Catalog Handler
      */
     getDataSourceCatalogRaw(requestParameters, initOverrides) {
@@ -209,7 +212,7 @@ export class DataSourcesApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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.
      * Get Data Source Catalog Handler
      */
     getDataSourceCatalog(requestParameters, initOverrides) {
@@ -218,6 +221,54 @@ export class DataSourcesApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for listDataSourceSchemas without sending the request
+     */
+    listDataSourceSchemasRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['dataSourceId'] == null) {
+                throw new runtime.RequiredError('dataSourceId', 'Required parameter "dataSourceId" was null or undefined when calling listDataSourceSchemas().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/v1/data-sources/{data_source_id}/schemas`;
+            urlPath = urlPath.replace(`{${"data_source_id"}}`, encodeURIComponent(String(requestParameters['dataSourceId'])));
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * List the source\'s user namespaces (PG schemas / MySQL databases).
+     * List Data Source Schemas Handler
+     */
+    listDataSourceSchemasRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.listDataSourceSchemasRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => DataSourceSchemaListResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * List the source\'s user namespaces (PG schemas / MySQL databases).
+     * List Data Source Schemas Handler
+     */
+    listDataSourceSchemas(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.listDataSourceSchemasRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for modelDataSourceTable without sending the request
      */