@knowledge-stack/ksapi 1.111.1 → 1.112.0

package/src/apis/DataSourcesApi.ts

@@ -21,6 +21,7 @@ import type {
   DataSourceQueryRequest,
   DataSourceQueryResponse,
   DataSourceResponse,
+  DataSourceSchemaListResponse,
   DataSourceTableResponse,
   ErrorResponse,
   HTTPValidationError,
@@ -40,6 +41,8 @@ import {
     DataSourceQueryResponseToJSON,
     DataSourceResponseFromJSON,
     DataSourceResponseToJSON,
+    DataSourceSchemaListResponseFromJSON,
+    DataSourceSchemaListResponseToJSON,
     DataSourceTableResponseFromJSON,
     DataSourceTableResponseToJSON,
     ErrorResponseFromJSON,
@@ -66,6 +69,11 @@ export interface GetDataSourceRequest {
 
 export interface GetDataSourceCatalogRequest {
     dataSourceId: string;
+    schema?: string | null;
+}
+
+export interface ListDataSourceSchemasRequest {
+    dataSourceId: string;
 }
 
 export interface ModelDataSourceTableRequest {
@@ -170,15 +178,17 @@ 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
@@ -186,11 +196,35 @@ export interface 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 
@@ -481,6 +515,10 @@ export class DataSourcesApi extends runtime.BaseAPI implements DataSourcesApiInt
 
         const queryParameters: any = {};
 
+        if (requestParameters['schema'] != null) {
+            queryParameters['schema'] = requestParameters['schema'];
+        }
+
         const headerParameters: runtime.HTTPHeaders = {};
 
         if (this.configuration && this.configuration.accessToken) {
@@ -504,7 +542,7 @@ export class DataSourcesApi extends runtime.BaseAPI implements DataSourcesApiInt
     }
 
     /**
-     * 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
      */
     async getDataSourceCatalogRaw(requestParameters: GetDataSourceCatalogRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceCatalogResponse>> {
@@ -515,7 +553,7 @@ export class DataSourcesApi extends runtime.BaseAPI implements DataSourcesApiInt
     }
 
     /**
-     * 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
      */
     async getDataSourceCatalog(requestParameters: GetDataSourceCatalogRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceCatalogResponse> {
@@ -523,6 +561,61 @@ export class DataSourcesApi extends runtime.BaseAPI implements DataSourcesApiInt
         return await response.value();
     }
 
+    /**
+     * Creates request options for listDataSourceSchemas without sending the request
+     */
+    async listDataSourceSchemasRequestOpts(requestParameters: ListDataSourceSchemasRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['dataSourceId'] == null) {
+            throw new runtime.RequiredError(
+                'dataSourceId',
+                'Required parameter "dataSourceId" was null or undefined when calling listDataSourceSchemas().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await 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
+     */
+    async listDataSourceSchemasRaw(requestParameters: ListDataSourceSchemasRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceSchemaListResponse>> {
+        const requestOptions = await this.listDataSourceSchemasRequestOpts(requestParameters);
+        const response = await 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
+     */
+    async listDataSourceSchemas(requestParameters: ListDataSourceSchemasRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceSchemaListResponse> {
+        const response = await this.listDataSourceSchemasRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for modelDataSourceTable without sending the request
      */

package/src/apis/DocumentVersionsApi.ts

@@ -388,7 +388,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 
@@ -399,7 +399,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>;
@@ -1027,7 +1027,7 @@ export class DocumentVersionsApi extends runtime.BaseAPI implements DocumentVers
     }
 
     /**
-     * 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
      */
     async updateDocumentVersionMetadataRaw(requestParameters: UpdateDocumentVersionMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DocumentVersionResponse>> {
@@ -1038,7 +1038,7 @@ export class DocumentVersionsApi extends runtime.BaseAPI implements DocumentVers
     }
 
     /**
-     * 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
      */
     async updateDocumentVersionMetadata(requestParameters: UpdateDocumentVersionMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionResponse> {

package/src/apis/WorkflowDefinitionsApi.ts

@@ -64,6 +64,8 @@ export interface CreateWorkflowRunRequest {
     files?: Array<Blob>;
     inputScope?: string | null;
     idempotencyKey?: string | null;
+    autoStart?: boolean;
+    userMessage?: string | null;
 }
 
 export interface DeleteWorkflowDefinitionRequest {
@@ -145,6 +147,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
      */
@@ -157,6 +161,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
@@ -461,6 +467,14 @@ export class WorkflowDefinitionsApi extends runtime.BaseAPI implements WorkflowD
             formParams.append('idempotency_key', requestParameters['idempotencyKey'] as any);
         }
 
+        if (requestParameters['autoStart'] != null) {
+            formParams.append('auto_start', requestParameters['autoStart'] as any);
+        }
+
+        if (requestParameters['userMessage'] != null) {
+            formParams.append('user_message', requestParameters['userMessage'] as any);
+        }
+
 
         let urlPath = `/v1/workflow-definitions/{definition_id}/runs`;
         urlPath = urlPath.replace(`{${"definition_id"}}`, encodeURIComponent(String(requestParameters['definitionId'])));

package/src/apis/WorkflowRunsApi.ts

@@ -389,7 +389,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 
@@ -400,7 +400,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>;
@@ -1045,7 +1045,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
     }
 
     /**
-     * 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
      */
     async updateWorkflowRunRaw(requestParameters: UpdateWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>> {
@@ -1056,7 +1056,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
     }
 
     /**
-     * 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
      */
     async updateWorkflowRun(requestParameters: UpdateWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse> {

package/src/models/CatalogColumnResponse.ts

@@ -13,6 +13,14 @@
  */
 
 import { mapValues } from '../runtime';
+import type { ColumnReference } from './ColumnReference';
+import {
+    ColumnReferenceFromJSON,
+    ColumnReferenceFromJSONTyped,
+    ColumnReferenceToJSON,
+    ColumnReferenceToJSONTyped,
+} from './ColumnReference';
+
 /**
  * 
  * @export
@@ -37,6 +45,12 @@ export interface CatalogColumnResponse {
      * @memberof CatalogColumnResponse
      */
     isPk: boolean;
+    /**
+     * 
+     * @type {ColumnReference}
+     * @memberof CatalogColumnResponse
+     */
+    references?: ColumnReference | null;
 }
 export const CatalogColumnResponsePropertyValidationAttributesMap: {
     [property: string]: {
@@ -79,6 +93,7 @@ export function CatalogColumnResponseFromJSONTyped(json: any, ignoreDiscriminato
         'name': json['name'],
         'dataType': json['data_type'],
         'isPk': json['is_pk'],
+        'references': json['references'] == null ? undefined : ColumnReferenceFromJSON(json['references']),
     };
 }
 
@@ -96,6 +111,7 @@ export function CatalogColumnResponseToJSONTyped(value?: CatalogColumnResponse |
         'name': value['name'],
         'data_type': value['dataType'],
         'is_pk': value['isPk'],
+        'references': ColumnReferenceToJSON(value['references']),
     };
 }
 

package/src/models/CatalogTableResponse.ts

@@ -33,6 +33,12 @@ export interface CatalogTableResponse {
      * @memberof CatalogTableResponse
      */
     name: string;
+    /**
+     * 
+     * @type {string}
+     * @memberof CatalogTableResponse
+     */
+    schemaName: string;
     /**
      * 
      * @type {Array<CatalogColumnResponse>}
@@ -63,6 +69,7 @@ export const CatalogTableResponsePropertyValidationAttributesMap: {
  */
 export function instanceOfCatalogTableResponse(value: object): value is CatalogTableResponse {
     if (!('name' in value) || value['name'] === undefined) return false;
+    if (!('schemaName' in value) || value['schemaName'] === undefined) return false;
     if (!('columns' in value) || value['columns'] === undefined) return false;
     return true;
 }
@@ -78,6 +85,7 @@ export function CatalogTableResponseFromJSONTyped(json: any, ignoreDiscriminator
     return {
         
         'name': json['name'],
+        'schemaName': json['schema_name'],
         'columns': ((json['columns'] as Array<any>).map(CatalogColumnResponseFromJSON)),
     };
 }
@@ -94,6 +102,7 @@ export function CatalogTableResponseToJSONTyped(value?: CatalogTableResponse | n
     return {
         
         'name': value['name'],
+        'schema_name': value['schemaName'],
         'columns': ((value['columns'] as Array<any>).map(CatalogColumnResponseToJSON)),
     };
 }

package/src/models/ColumnConfig.ts

@@ -13,6 +13,14 @@
  */
 
 import { mapValues } from '../runtime';
+import type { ColumnReference } from './ColumnReference';
+import {
+    ColumnReferenceFromJSON,
+    ColumnReferenceFromJSONTyped,
+    ColumnReferenceToJSON,
+    ColumnReferenceToJSONTyped,
+} from './ColumnReference';
+
 /**
  * A modeled column. Only ``exposed`` columns are surfaced to the agent.
  * @export
@@ -49,6 +57,12 @@ export interface ColumnConfig {
      * @memberof ColumnConfig
      */
     exposed?: boolean;
+    /**
+     * 
+     * @type {ColumnReference}
+     * @memberof ColumnConfig
+     */
+    references?: ColumnReference | null;
 }
 export const ColumnConfigPropertyValidationAttributesMap: {
     [property: string]: {
@@ -91,6 +105,7 @@ export function ColumnConfigFromJSONTyped(json: any, ignoreDiscriminator: boolea
         'comment': json['comment'] == null ? undefined : json['comment'],
         'isPk': json['is_pk'] == null ? undefined : json['is_pk'],
         'exposed': json['exposed'] == null ? undefined : json['exposed'],
+        'references': json['references'] == null ? undefined : ColumnReferenceFromJSON(json['references']),
     };
 }
 
@@ -110,6 +125,7 @@ export function ColumnConfigToJSONTyped(value?: ColumnConfig | null, ignoreDiscr
         'comment': value['comment'],
         'is_pk': value['isPk'],
         'exposed': value['exposed'],
+        'references': ColumnReferenceToJSON(value['references']),
     };
 }
 

package/src/models/ColumnReference.ts

@@ -0,0 +1,100 @@
+/* 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.
+ */
+
+import { mapValues } from '../runtime';
+/**
+ * The table+column a foreign-key column points at.
+ * @export
+ * @interface ColumnReference
+ */
+export interface ColumnReference {
+    /**
+     * 
+     * @type {string}
+     * @memberof ColumnReference
+     */
+    schemaName?: string | null;
+    /**
+     * 
+     * @type {string}
+     * @memberof ColumnReference
+     */
+    table: string;
+    /**
+     * 
+     * @type {string}
+     * @memberof ColumnReference
+     */
+    column: string;
+}
+export const ColumnReferencePropertyValidationAttributesMap: {
+    [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 ColumnReference interface.
+ */
+export function instanceOfColumnReference(value: object): value is ColumnReference {
+    if (!('table' in value) || value['table'] === undefined) return false;
+    if (!('column' in value) || value['column'] === undefined) return false;
+    return true;
+}
+
+export function ColumnReferenceFromJSON(json: any): ColumnReference {
+    return ColumnReferenceFromJSONTyped(json, false);
+}
+
+export function ColumnReferenceFromJSONTyped(json: any, ignoreDiscriminator: boolean): ColumnReference {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'schemaName': json['schema_name'] == null ? undefined : json['schema_name'],
+        'table': json['table'],
+        'column': json['column'],
+    };
+}
+
+export function ColumnReferenceToJSON(json: any): ColumnReference {
+    return ColumnReferenceToJSONTyped(json, false);
+}
+
+export function ColumnReferenceToJSONTyped(value?: ColumnReference | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'schema_name': value['schemaName'],
+        'table': value['table'],
+        'column': value['column'],
+    };
+}
+

package/src/models/DataSourceSchemaListResponse.ts

@@ -0,0 +1,91 @@
+/* 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.
+ */
+
+import { mapValues } from '../runtime';
+import type { DataSourceSchemaResponse } from './DataSourceSchemaResponse';
+import {
+    DataSourceSchemaResponseFromJSON,
+    DataSourceSchemaResponseFromJSONTyped,
+    DataSourceSchemaResponseToJSON,
+    DataSourceSchemaResponseToJSONTyped,
+} from './DataSourceSchemaResponse';
+
+/**
+ * The source's user namespaces (PG schemas / MySQL databases).
+ * @export
+ * @interface DataSourceSchemaListResponse
+ */
+export interface DataSourceSchemaListResponse {
+    /**
+     * 
+     * @type {Array<DataSourceSchemaResponse>}
+     * @memberof DataSourceSchemaListResponse
+     */
+    schemas: Array<DataSourceSchemaResponse>;
+}
+export const DataSourceSchemaListResponsePropertyValidationAttributesMap: {
+    [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 DataSourceSchemaListResponse interface.
+ */
+export function instanceOfDataSourceSchemaListResponse(value: object): value is DataSourceSchemaListResponse {
+    if (!('schemas' in value) || value['schemas'] === undefined) return false;
+    return true;
+}
+
+export function DataSourceSchemaListResponseFromJSON(json: any): DataSourceSchemaListResponse {
+    return DataSourceSchemaListResponseFromJSONTyped(json, false);
+}
+
+export function DataSourceSchemaListResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): DataSourceSchemaListResponse {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'schemas': ((json['schemas'] as Array<any>).map(DataSourceSchemaResponseFromJSON)),
+    };
+}
+
+export function DataSourceSchemaListResponseToJSON(json: any): DataSourceSchemaListResponse {
+    return DataSourceSchemaListResponseToJSONTyped(json, false);
+}
+
+export function DataSourceSchemaListResponseToJSONTyped(value?: DataSourceSchemaListResponse | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'schemas': ((value['schemas'] as Array<any>).map(DataSourceSchemaResponseToJSON)),
+    };
+}
+