@knowledge-stack/ksapi 1.118.0 → 1.120.0

package/src/apis/DataSourcesApi.ts

@@ -15,8 +15,11 @@
 
 import * as runtime from '../runtime';
 import type {
+  BulkModelTablesRequest,
+  BulkModelTablesResponse,
   CreateDataSourceRequest,
   DataSourceCatalogResponse,
+  DataSourceDescriptionResponse,
   DataSourceDetailResponse,
   DataSourceQueryRequest,
   DataSourceQueryResponse,
@@ -30,10 +33,16 @@ import type {
   UpdateTableRequest,
 } from '../models/index';
 import {
+    BulkModelTablesRequestFromJSON,
+    BulkModelTablesRequestToJSON,
+    BulkModelTablesResponseFromJSON,
+    BulkModelTablesResponseToJSON,
     CreateDataSourceRequestFromJSON,
     CreateDataSourceRequestToJSON,
     DataSourceCatalogResponseFromJSON,
     DataSourceCatalogResponseToJSON,
+    DataSourceDescriptionResponseFromJSON,
+    DataSourceDescriptionResponseToJSON,
     DataSourceDetailResponseFromJSON,
     DataSourceDetailResponseToJSON,
     DataSourceQueryRequestFromJSON,
@@ -66,6 +75,20 @@ export interface DeleteDataSourceRequest {
     dataSourceId: string;
 }
 
+export interface DeleteDataSourceSchemaRequest {
+    dataSourceId: string;
+    schemaId: string;
+}
+
+export interface DeleteDataSourceTableRequest {
+    dataSourceId: string;
+    tableId: string;
+}
+
+export interface GenerateDataSourceDescriptionRequest {
+    dataSourceId: string;
+}
+
 export interface GetDataSourceRequest {
     dataSourceId: string;
 }
@@ -84,6 +107,11 @@ export interface ModelDataSourceTableRequest {
     modelTableRequest: ModelTableRequest;
 }
 
+export interface ModelDataSourceTablesRequest {
+    dataSourceId: string;
+    bulkModelTablesRequest: BulkModelTablesRequest;
+}
+
 export interface QueryDataSourceRequest {
     dataSourceId: string;
     dataSourceQueryRequest: DataSourceQueryRequest;
@@ -144,7 +172,7 @@ export interface DataSourcesApiInterface {
     deleteDataSourceRequestOpts(requestParameters: DeleteDataSourceRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Move a connector and its modeled tables to trash.  Soft-delete via the path_part subtree (the tables are children, so they trash with it). Connectors carry no Qdrant vectors, so there is no trash-sync workflow.
+     * Move a connector and its schemas/tables to trash.  Soft-delete via the path_part subtree (schemas + tables are children, so they trash with it). The connector\'s generated ``.overview`` description Document IS ingested, so its Qdrant points are flipped to trashed via the set-trashed workflow (best-effort, mirrors the document delete path).
      * @summary Delete Data Source Handler
      * @param {string} dataSourceId 
      * @param {*} [options] Override http request option.
@@ -154,11 +182,87 @@ export interface DataSourcesApiInterface {
     deleteDataSourceRaw(requestParameters: DeleteDataSourceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
 
     /**
-     * Move a connector and its modeled tables to trash.  Soft-delete via the path_part subtree (the tables are children, so they trash with it). Connectors carry no Qdrant vectors, so there is no trash-sync workflow.
+     * Move a connector and its schemas/tables to trash.  Soft-delete via the path_part subtree (schemas + tables are children, so they trash with it). The connector\'s generated ``.overview`` description Document IS ingested, so its Qdrant points are flipped to trashed via the set-trashed workflow (best-effort, mirrors the document delete path).
      * Delete Data Source Handler
      */
     deleteDataSource(requestParameters: DeleteDataSourceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
 
+    /**
+     * Creates request options for deleteDataSourceSchema without sending the request
+     * @param {string} dataSourceId 
+     * @param {string} schemaId 
+     * @throws {RequiredError}
+     * @memberof DataSourcesApiInterface
+     */
+    deleteDataSourceSchemaRequestOpts(requestParameters: DeleteDataSourceSchemaRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Un-model a schema and the tables under it (hard-delete the namespace).
+     * @summary Delete Data Source Schema Handler
+     * @param {string} dataSourceId 
+     * @param {string} schemaId 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DataSourcesApiInterface
+     */
+    deleteDataSourceSchemaRaw(requestParameters: DeleteDataSourceSchemaRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+
+    /**
+     * Un-model a schema and the tables under it (hard-delete the namespace).
+     * Delete Data Source Schema Handler
+     */
+    deleteDataSourceSchema(requestParameters: DeleteDataSourceSchemaRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+
+    /**
+     * Creates request options for deleteDataSourceTable without sending the request
+     * @param {string} dataSourceId 
+     * @param {string} tableId 
+     * @throws {RequiredError}
+     * @memberof DataSourcesApiInterface
+     */
+    deleteDataSourceTableRequestOpts(requestParameters: DeleteDataSourceTableRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Un-model a single table (hard-delete it from its schema).
+     * @summary Delete Data Source Table Handler
+     * @param {string} dataSourceId 
+     * @param {string} tableId 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DataSourcesApiInterface
+     */
+    deleteDataSourceTableRaw(requestParameters: DeleteDataSourceTableRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+
+    /**
+     * Un-model a single table (hard-delete it from its schema).
+     * Delete Data Source Table Handler
+     */
+    deleteDataSourceTable(requestParameters: DeleteDataSourceTableRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+
+    /**
+     * Creates request options for generateDataSourceDescription without sending the request
+     * @param {string} dataSourceId 
+     * @throws {RequiredError}
+     * @memberof DataSourcesApiInterface
+     */
+    generateDataSourceDescriptionRequestOpts(requestParameters: GenerateDataSourceDescriptionRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * (Re)generate the connector\'s hidden, searchable \'Database overview\' Document.  Requires ``can_write`` on the connector. The structural overview is deterministic; an LLM prose summary is prepended best-effort. The document ingests through the normal pipeline so the agent\'s semantic search finds it.
+     * @summary Generate Data Source Description Handler
+     * @param {string} dataSourceId 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DataSourcesApiInterface
+     */
+    generateDataSourceDescriptionRaw(requestParameters: GenerateDataSourceDescriptionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceDescriptionResponse>>;
+
+    /**
+     * (Re)generate the connector\'s hidden, searchable \'Database overview\' Document.  Requires ``can_write`` on the connector. The structural overview is deterministic; an LLM prose summary is prepended best-effort. The document ingests through the normal pipeline so the agent\'s semantic search finds it.
+     * Generate Data Source Description Handler
+     */
+    generateDataSourceDescription(requestParameters: GenerateDataSourceDescriptionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceDescriptionResponse>;
+
     /**
      * Creates request options for getDataSource without sending the request
      * @param {string} dataSourceId 
@@ -243,7 +347,7 @@ export interface DataSourcesApiInterface {
     modelDataSourceTableRequestOpts(requestParameters: ModelDataSourceTableRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Model a table as a queryable PathPart child; auto-introspect columns.
+     * Model a table under its (auto-created) Schema PDO; auto-introspect columns.
      * @summary Model Data Source Table Handler
      * @param {string} dataSourceId 
      * @param {ModelTableRequest} modelTableRequest 
@@ -254,11 +358,37 @@ export interface DataSourcesApiInterface {
     modelDataSourceTableRaw(requestParameters: ModelDataSourceTableRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceTableResponse>>;
 
     /**
-     * Model a table as a queryable PathPart child; auto-introspect columns.
+     * Model a table under its (auto-created) Schema PDO; auto-introspect columns.
      * Model Data Source Table Handler
      */
     modelDataSourceTable(requestParameters: ModelDataSourceTableRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceTableResponse>;
 
+    /**
+     * Creates request options for modelDataSourceTables without sending the request
+     * @param {string} dataSourceId 
+     * @param {BulkModelTablesRequest} bulkModelTablesRequest 
+     * @throws {RequiredError}
+     * @memberof DataSourcesApiInterface
+     */
+    modelDataSourceTablesRequestOpts(requestParameters: ModelDataSourceTablesRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Import several tables across one or more schemas; per-item results.  Schemas are auto find-or-created. Duplicates are pre-checked against the already-modeled tables and earlier items in the same batch (so a conflict never triggers a failed INSERT, which would otherwise roll back the batch\'s prior writes); introspection failures are reported per item. One bad item never aborts the batch.
+     * @summary Model Data Source Tables Handler
+     * @param {string} dataSourceId 
+     * @param {BulkModelTablesRequest} bulkModelTablesRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DataSourcesApiInterface
+     */
+    modelDataSourceTablesRaw(requestParameters: ModelDataSourceTablesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BulkModelTablesResponse>>;
+
+    /**
+     * Import several tables across one or more schemas; per-item results.  Schemas are auto find-or-created. Duplicates are pre-checked against the already-modeled tables and earlier items in the same batch (so a conflict never triggers a failed INSERT, which would otherwise roll back the batch\'s prior writes); introspection failures are reported per item. One bad item never aborts the batch.
+     * Model Data Source Tables Handler
+     */
+    modelDataSourceTables(requestParameters: ModelDataSourceTablesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BulkModelTablesResponse>;
+
     /**
      * Creates request options for queryDataSource without sending the request
      * @param {string} dataSourceId 
@@ -463,7 +593,7 @@ export class DataSourcesApi extends runtime.BaseAPI implements DataSourcesApiInt
     }
 
     /**
-     * Move a connector and its modeled tables to trash.  Soft-delete via the path_part subtree (the tables are children, so they trash with it). Connectors carry no Qdrant vectors, so there is no trash-sync workflow.
+     * Move a connector and its schemas/tables to trash.  Soft-delete via the path_part subtree (schemas + tables are children, so they trash with it). The connector\'s generated ``.overview`` description Document IS ingested, so its Qdrant points are flipped to trashed via the set-trashed workflow (best-effort, mirrors the document delete path).
      * Delete Data Source Handler
      */
     async deleteDataSourceRaw(requestParameters: DeleteDataSourceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
@@ -474,13 +604,192 @@ export class DataSourcesApi extends runtime.BaseAPI implements DataSourcesApiInt
     }
 
     /**
-     * Move a connector and its modeled tables to trash.  Soft-delete via the path_part subtree (the tables are children, so they trash with it). Connectors carry no Qdrant vectors, so there is no trash-sync workflow.
+     * Move a connector and its schemas/tables to trash.  Soft-delete via the path_part subtree (schemas + tables are children, so they trash with it). The connector\'s generated ``.overview`` description Document IS ingested, so its Qdrant points are flipped to trashed via the set-trashed workflow (best-effort, mirrors the document delete path).
      * Delete Data Source Handler
      */
     async deleteDataSource(requestParameters: DeleteDataSourceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {
         await this.deleteDataSourceRaw(requestParameters, initOverrides);
     }
 
+    /**
+     * Creates request options for deleteDataSourceSchema without sending the request
+     */
+    async deleteDataSourceSchemaRequestOpts(requestParameters: DeleteDataSourceSchemaRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['dataSourceId'] == null) {
+            throw new runtime.RequiredError(
+                'dataSourceId',
+                'Required parameter "dataSourceId" was null or undefined when calling deleteDataSourceSchema().'
+            );
+        }
+
+        if (requestParameters['schemaId'] == null) {
+            throw new runtime.RequiredError(
+                'schemaId',
+                'Required parameter "schemaId" was null or undefined when calling deleteDataSourceSchema().'
+            );
+        }
+
+        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/{schema_id}`;
+        urlPath = urlPath.replace(`{${"data_source_id"}}`, encodeURIComponent(String(requestParameters['dataSourceId'])));
+        urlPath = urlPath.replace(`{${"schema_id"}}`, encodeURIComponent(String(requestParameters['schemaId'])));
+
+        return {
+            path: urlPath,
+            method: 'DELETE',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Un-model a schema and the tables under it (hard-delete the namespace).
+     * Delete Data Source Schema Handler
+     */
+    async deleteDataSourceSchemaRaw(requestParameters: DeleteDataSourceSchemaRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
+        const requestOptions = await this.deleteDataSourceSchemaRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.VoidApiResponse(response);
+    }
+
+    /**
+     * Un-model a schema and the tables under it (hard-delete the namespace).
+     * Delete Data Source Schema Handler
+     */
+    async deleteDataSourceSchema(requestParameters: DeleteDataSourceSchemaRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {
+        await this.deleteDataSourceSchemaRaw(requestParameters, initOverrides);
+    }
+
+    /**
+     * Creates request options for deleteDataSourceTable without sending the request
+     */
+    async deleteDataSourceTableRequestOpts(requestParameters: DeleteDataSourceTableRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['dataSourceId'] == null) {
+            throw new runtime.RequiredError(
+                'dataSourceId',
+                'Required parameter "dataSourceId" was null or undefined when calling deleteDataSourceTable().'
+            );
+        }
+
+        if (requestParameters['tableId'] == null) {
+            throw new runtime.RequiredError(
+                'tableId',
+                'Required parameter "tableId" was null or undefined when calling deleteDataSourceTable().'
+            );
+        }
+
+        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}/tables/{table_id}`;
+        urlPath = urlPath.replace(`{${"data_source_id"}}`, encodeURIComponent(String(requestParameters['dataSourceId'])));
+        urlPath = urlPath.replace(`{${"table_id"}}`, encodeURIComponent(String(requestParameters['tableId'])));
+
+        return {
+            path: urlPath,
+            method: 'DELETE',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Un-model a single table (hard-delete it from its schema).
+     * Delete Data Source Table Handler
+     */
+    async deleteDataSourceTableRaw(requestParameters: DeleteDataSourceTableRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
+        const requestOptions = await this.deleteDataSourceTableRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.VoidApiResponse(response);
+    }
+
+    /**
+     * Un-model a single table (hard-delete it from its schema).
+     * Delete Data Source Table Handler
+     */
+    async deleteDataSourceTable(requestParameters: DeleteDataSourceTableRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {
+        await this.deleteDataSourceTableRaw(requestParameters, initOverrides);
+    }
+
+    /**
+     * Creates request options for generateDataSourceDescription without sending the request
+     */
+    async generateDataSourceDescriptionRequestOpts(requestParameters: GenerateDataSourceDescriptionRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['dataSourceId'] == null) {
+            throw new runtime.RequiredError(
+                'dataSourceId',
+                'Required parameter "dataSourceId" was null or undefined when calling generateDataSourceDescription().'
+            );
+        }
+
+        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}/describe`;
+        urlPath = urlPath.replace(`{${"data_source_id"}}`, encodeURIComponent(String(requestParameters['dataSourceId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * (Re)generate the connector\'s hidden, searchable \'Database overview\' Document.  Requires ``can_write`` on the connector. The structural overview is deterministic; an LLM prose summary is prepended best-effort. The document ingests through the normal pipeline so the agent\'s semantic search finds it.
+     * Generate Data Source Description Handler
+     */
+    async generateDataSourceDescriptionRaw(requestParameters: GenerateDataSourceDescriptionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceDescriptionResponse>> {
+        const requestOptions = await this.generateDataSourceDescriptionRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => DataSourceDescriptionResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * (Re)generate the connector\'s hidden, searchable \'Database overview\' Document.  Requires ``can_write`` on the connector. The structural overview is deterministic; an LLM prose summary is prepended best-effort. The document ingests through the normal pipeline so the agent\'s semantic search finds it.
+     * Generate Data Source Description Handler
+     */
+    async generateDataSourceDescription(requestParameters: GenerateDataSourceDescriptionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceDescriptionResponse> {
+        const response = await this.generateDataSourceDescriptionRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for getDataSource without sending the request
      */
@@ -696,7 +1005,7 @@ export class DataSourcesApi extends runtime.BaseAPI implements DataSourcesApiInt
     }
 
     /**
-     * Model a table as a queryable PathPart child; auto-introspect columns.
+     * Model a table under its (auto-created) Schema PDO; auto-introspect columns.
      * Model Data Source Table Handler
      */
     async modelDataSourceTableRaw(requestParameters: ModelDataSourceTableRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceTableResponse>> {
@@ -707,7 +1016,7 @@ export class DataSourcesApi extends runtime.BaseAPI implements DataSourcesApiInt
     }
 
     /**
-     * Model a table as a queryable PathPart child; auto-introspect columns.
+     * Model a table under its (auto-created) Schema PDO; auto-introspect columns.
      * Model Data Source Table Handler
      */
     async modelDataSourceTable(requestParameters: ModelDataSourceTableRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceTableResponse> {
@@ -715,6 +1024,71 @@ export class DataSourcesApi extends runtime.BaseAPI implements DataSourcesApiInt
         return await response.value();
     }
 
+    /**
+     * Creates request options for modelDataSourceTables without sending the request
+     */
+    async modelDataSourceTablesRequestOpts(requestParameters: ModelDataSourceTablesRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['dataSourceId'] == null) {
+            throw new runtime.RequiredError(
+                'dataSourceId',
+                'Required parameter "dataSourceId" was null or undefined when calling modelDataSourceTables().'
+            );
+        }
+
+        if (requestParameters['bulkModelTablesRequest'] == null) {
+            throw new runtime.RequiredError(
+                'bulkModelTablesRequest',
+                'Required parameter "bulkModelTablesRequest" was null or undefined when calling modelDataSourceTables().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        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}/tables/batch`;
+        urlPath = urlPath.replace(`{${"data_source_id"}}`, encodeURIComponent(String(requestParameters['dataSourceId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: BulkModelTablesRequestToJSON(requestParameters['bulkModelTablesRequest']),
+        };
+    }
+
+    /**
+     * Import several tables across one or more schemas; per-item results.  Schemas are auto find-or-created. Duplicates are pre-checked against the already-modeled tables and earlier items in the same batch (so a conflict never triggers a failed INSERT, which would otherwise roll back the batch\'s prior writes); introspection failures are reported per item. One bad item never aborts the batch.
+     * Model Data Source Tables Handler
+     */
+    async modelDataSourceTablesRaw(requestParameters: ModelDataSourceTablesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BulkModelTablesResponse>> {
+        const requestOptions = await this.modelDataSourceTablesRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => BulkModelTablesResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Import several tables across one or more schemas; per-item results.  Schemas are auto find-or-created. Duplicates are pre-checked against the already-modeled tables and earlier items in the same batch (so a conflict never triggers a failed INSERT, which would otherwise roll back the batch\'s prior writes); introspection failures are reported per item. One bad item never aborts the batch.
+     * Model Data Source Tables Handler
+     */
+    async modelDataSourceTables(requestParameters: ModelDataSourceTablesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BulkModelTablesResponse> {
+        const response = await this.modelDataSourceTablesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for queryDataSource without sending the request
      */

package/src/apis/DocumentVersionsApi.ts

@@ -320,7 +320,7 @@ export interface DocumentVersionsApiInterface {
     getDocumentVersionDiffRequestOpts(requestParameters: GetDocumentVersionDiffRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Side-by-side diff of a version against a previous one of the same document.  Diffs the two versions\' plaintext on the fly (no stored diff), so any pair of versions can be compared. ``from_version_id`` defaults to the immediate predecessor; the first version diffs against empty (all additions). Requires read permission on the document.
+     * Side-by-side diff of a version against a previous one of the same document.  Diffs the two versions on the fly (no stored diff), so any pair of versions can be compared. ``from_version_id`` defaults to the immediate predecessor; the first version diffs against empty (all additions). Requires read permission on both versions. Viewing a diff is a sensitive read, so it emits a ``document.diff.viewed`` audit event (a durable write on this GET, by design — like a download).
      * @summary Get Document Version Diff Handler
      * @param {string} versionId The new (right) version ID
      * @param {string} [fromVersionId] The old (left) version; defaults to the predecessor
@@ -331,7 +331,7 @@ export interface DocumentVersionsApiInterface {
     getDocumentVersionDiffRaw(requestParameters: GetDocumentVersionDiffRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<VersionDiffResponse>>;
 
     /**
-     * Side-by-side diff of a version against a previous one of the same document.  Diffs the two versions\' plaintext on the fly (no stored diff), so any pair of versions can be compared. ``from_version_id`` defaults to the immediate predecessor; the first version diffs against empty (all additions). Requires read permission on the document.
+     * Side-by-side diff of a version against a previous one of the same document.  Diffs the two versions on the fly (no stored diff), so any pair of versions can be compared. ``from_version_id`` defaults to the immediate predecessor; the first version diffs against empty (all additions). Requires read permission on both versions. Viewing a diff is a sensitive read, so it emits a ``document.diff.viewed`` audit event (a durable write on this GET, by design — like a download).
      * Get Document Version Diff Handler
      */
     getDocumentVersionDiff(requestParameters: GetDocumentVersionDiffRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<VersionDiffResponse>;
@@ -868,7 +868,7 @@ export class DocumentVersionsApi extends runtime.BaseAPI implements DocumentVers
     }
 
     /**
-     * Side-by-side diff of a version against a previous one of the same document.  Diffs the two versions\' plaintext on the fly (no stored diff), so any pair of versions can be compared. ``from_version_id`` defaults to the immediate predecessor; the first version diffs against empty (all additions). Requires read permission on the document.
+     * Side-by-side diff of a version against a previous one of the same document.  Diffs the two versions on the fly (no stored diff), so any pair of versions can be compared. ``from_version_id`` defaults to the immediate predecessor; the first version diffs against empty (all additions). Requires read permission on both versions. Viewing a diff is a sensitive read, so it emits a ``document.diff.viewed`` audit event (a durable write on this GET, by design — like a download).
      * Get Document Version Diff Handler
      */
     async getDocumentVersionDiffRaw(requestParameters: GetDocumentVersionDiffRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<VersionDiffResponse>> {
@@ -879,7 +879,7 @@ export class DocumentVersionsApi extends runtime.BaseAPI implements DocumentVers
     }
 
     /**
-     * Side-by-side diff of a version against a previous one of the same document.  Diffs the two versions\' plaintext on the fly (no stored diff), so any pair of versions can be compared. ``from_version_id`` defaults to the immediate predecessor; the first version diffs against empty (all additions). Requires read permission on the document.
+     * Side-by-side diff of a version against a previous one of the same document.  Diffs the two versions on the fly (no stored diff), so any pair of versions can be compared. ``from_version_id`` defaults to the immediate predecessor; the first version diffs against empty (all additions). Requires read permission on both versions. Viewing a diff is a sensitive read, so it emits a ``document.diff.viewed`` audit event (a durable write on this GET, by design — like a download).
      * Get Document Version Diff Handler
      */
     async getDocumentVersionDiff(requestParameters: GetDocumentVersionDiffRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<VersionDiffResponse> {

package/src/apis/FoldersApi.ts

@@ -21,7 +21,7 @@ import type {
   FolderActionResponse,
   FolderResponse,
   HTTPValidationError,
-  PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceTableResponseApiConnectionResponseDiscriminator,
+  PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator,
   PaginatedResponseFolderResponse,
   PathOrder,
   SearchSortOrder,
@@ -42,8 +42,8 @@ import {
     FolderResponseToJSON,
     HTTPValidationErrorFromJSON,
     HTTPValidationErrorToJSON,
-    PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceTableResponseApiConnectionResponseDiscriminatorFromJSON,
-    PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceTableResponseApiConnectionResponseDiscriminatorToJSON,
+    PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminatorFromJSON,
+    PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminatorToJSON,
     PaginatedResponseFolderResponseFromJSON,
     PaginatedResponseFolderResponseToJSON,
     PathOrderFromJSON,
@@ -246,13 +246,13 @@ export interface FoldersApiInterface {
      * @throws {RequiredError}
      * @memberof FoldersApiInterface
      */
-    listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceTableResponseApiConnectionResponseDiscriminator>>;
+    listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator>>;
 
     /**
      * List all contents (folders and documents) under a folder.  Returns a discriminated union of FolderResponse and DocumentResponse items, distinguished by the `part_type` field (\"FOLDER\" or \"DOCUMENT\").  When with_tags=true, each item includes a tags field with the full tag objects.  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
      * List Folder Contents Handler
      */
-    listFolderContents(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceTableResponseApiConnectionResponseDiscriminator>;
+    listFolderContents(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator>;
 
     /**
      * Creates request options for listFolders without sending the request
@@ -326,13 +326,13 @@ export interface FoldersApiInterface {
      * @throws {RequiredError}
      * @memberof FoldersApiInterface
      */
-    searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceTableResponseApiConnectionResponseDiscriminator>>;
+    searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator>>;
 
     /**
      * Search for folders, documents, and connectors by name.  Performs a case-insensitive partial name match using trigram indexing. Results are filtered by the current user\'s path permissions.  When parent_path_part_id is provided, only items under that folder are searched. Otherwise, all accessible items across the tenant are searched.
      * Search Items Handler
      */
-    searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceTableResponseApiConnectionResponseDiscriminator>;
+    searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator>;
 
     /**
      * Creates request options for updateFolder without sending the request
@@ -660,18 +660,18 @@ export class FoldersApi extends runtime.BaseAPI implements FoldersApiInterface {
      * List all contents (folders and documents) under a folder.  Returns a discriminated union of FolderResponse and DocumentResponse items, distinguished by the `part_type` field (\"FOLDER\" or \"DOCUMENT\").  When with_tags=true, each item includes a tags field with the full tag objects.  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
      * List Folder Contents Handler
      */
-    async listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceTableResponseApiConnectionResponseDiscriminator>> {
+    async listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator>> {
         const requestOptions = await this.listFolderContentsRequestOpts(requestParameters);
         const response = await this.request(requestOptions, initOverrides);
 
-        return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceTableResponseApiConnectionResponseDiscriminatorFromJSON(jsonValue));
+        return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminatorFromJSON(jsonValue));
     }
 
     /**
      * List all contents (folders and documents) under a folder.  Returns a discriminated union of FolderResponse and DocumentResponse items, distinguished by the `part_type` field (\"FOLDER\" or \"DOCUMENT\").  When with_tags=true, each item includes a tags field with the full tag objects.  This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
      * List Folder Contents Handler
      */
-    async listFolderContents(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceTableResponseApiConnectionResponseDiscriminator> {
+    async listFolderContents(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator> {
         const response = await this.listFolderContentsRaw(requestParameters, initOverrides);
         return await response.value();
     }
@@ -833,18 +833,18 @@ export class FoldersApi extends runtime.BaseAPI implements FoldersApiInterface {
      * Search for folders, documents, and connectors by name.  Performs a case-insensitive partial name match using trigram indexing. Results are filtered by the current user\'s path permissions.  When parent_path_part_id is provided, only items under that folder are searched. Otherwise, all accessible items across the tenant are searched.
      * Search Items Handler
      */
-    async searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceTableResponseApiConnectionResponseDiscriminator>> {
+    async searchItemsRaw(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator>> {
         const requestOptions = await this.searchItemsRequestOpts(requestParameters);
         const response = await this.request(requestOptions, initOverrides);
 
-        return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceTableResponseApiConnectionResponseDiscriminatorFromJSON(jsonValue));
+        return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminatorFromJSON(jsonValue));
     }
 
     /**
      * Search for folders, documents, and connectors by name.  Performs a case-insensitive partial name match using trigram indexing. Results are filtered by the current user\'s path permissions.  When parent_path_part_id is provided, only items under that folder are searched. Otherwise, all accessible items across the tenant are searched.
      * Search Items Handler
      */
-    async searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceTableResponseApiConnectionResponseDiscriminator> {
+    async searchItems(requestParameters: SearchItemsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator> {
         const response = await this.searchItemsRaw(requestParameters, initOverrides);
         return await response.value();
     }