@knowledge-stack/ksapi 1.118.0 → 1.120.0

package/dist/apis/DataSourcesApi.d.ts

@@ -10,13 +10,24 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { CreateDataSourceRequest, DataSourceCatalogResponse, DataSourceDetailResponse, DataSourceQueryRequest, DataSourceQueryResponse, DataSourceResponse, DataSourceSchemaListResponse, DataSourceTableResponse, ModelTableRequest, UpdateDataSourceRequest, UpdateTableRequest } from '../models/index';
+import type { BulkModelTablesRequest, BulkModelTablesResponse, CreateDataSourceRequest, DataSourceCatalogResponse, DataSourceDescriptionResponse, DataSourceDetailResponse, DataSourceQueryRequest, DataSourceQueryResponse, DataSourceResponse, DataSourceSchemaListResponse, DataSourceTableResponse, ModelTableRequest, UpdateDataSourceRequest, UpdateTableRequest } from '../models/index';
 export interface CreateDataSourceOperationRequest {
     createDataSourceRequest: CreateDataSourceRequest;
 }
 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;
 }
@@ -31,6 +42,10 @@ export interface ModelDataSourceTableRequest {
     dataSourceId: string;
     modelTableRequest: ModelTableRequest;
 }
+export interface ModelDataSourceTablesRequest {
+    dataSourceId: string;
+    bulkModelTablesRequest: BulkModelTablesRequest;
+}
 export interface QueryDataSourceRequest {
     dataSourceId: string;
     dataSourceQueryRequest: DataSourceQueryRequest;
@@ -83,7 +98,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.
@@ -92,10 +107,77 @@ 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
@@ -170,7 +252,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
@@ -180,10 +262,33 @@ 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
@@ -300,15 +405,57 @@ export declare class DataSourcesApi extends runtime.BaseAPI implements DataSourc
      */
     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).
      * Delete Data Source Handler
      */
     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
+     */
+    deleteDataSourceSchemaRequestOpts(requestParameters: DeleteDataSourceSchemaRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Un-model a schema and the tables under it (hard-delete the namespace).
+     * Delete Data Source Schema Handler
+     */
+    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
+     */
+    deleteDataSourceTableRequestOpts(requestParameters: DeleteDataSourceTableRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Un-model a single table (hard-delete it from its schema).
+     * Delete Data Source Table Handler
+     */
+    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
+     */
+    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.
+     * Generate Data Source Description Handler
+     */
+    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
      */
@@ -356,15 +503,29 @@ export declare class DataSourcesApi extends runtime.BaseAPI implements DataSourc
      */
     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.
      * Model Data Source Table Handler
      */
     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
+     */
+    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.
+     * Model Data Source Tables Handler
+     */
+    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
      */

package/dist/apis/DataSourcesApi.js

@@ -139,7 +139,7 @@ class DataSourcesApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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
      */
     deleteDataSourceRaw(requestParameters, initOverrides) {
@@ -150,7 +150,7 @@ class DataSourcesApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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, initOverrides) {
@@ -158,6 +158,156 @@ class DataSourcesApi extends runtime.BaseAPI {
             yield this.deleteDataSourceRaw(requestParameters, initOverrides);
         });
     }
+    /**
+     * Creates request options for deleteDataSourceSchema without sending the request
+     */
+    deleteDataSourceSchemaRequestOpts(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 deleteDataSourceSchema().');
+            }
+            if (requestParameters['schemaId'] == null) {
+                throw new runtime.RequiredError('schemaId', 'Required parameter "schemaId" was null or undefined when calling deleteDataSourceSchema().');
+            }
+            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/{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
+     */
+    deleteDataSourceSchemaRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.deleteDataSourceSchemaRequestOpts(requestParameters);
+            const response = yield 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
+     */
+    deleteDataSourceSchema(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.deleteDataSourceSchemaRaw(requestParameters, initOverrides);
+        });
+    }
+    /**
+     * Creates request options for deleteDataSourceTable without sending the request
+     */
+    deleteDataSourceTableRequestOpts(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 deleteDataSourceTable().');
+            }
+            if (requestParameters['tableId'] == null) {
+                throw new runtime.RequiredError('tableId', 'Required parameter "tableId" was null or undefined when calling deleteDataSourceTable().');
+            }
+            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}/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
+     */
+    deleteDataSourceTableRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.deleteDataSourceTableRequestOpts(requestParameters);
+            const response = yield 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
+     */
+    deleteDataSourceTable(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.deleteDataSourceTableRaw(requestParameters, initOverrides);
+        });
+    }
+    /**
+     * Creates request options for generateDataSourceDescription without sending the request
+     */
+    generateDataSourceDescriptionRequestOpts(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 generateDataSourceDescription().');
+            }
+            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}/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
+     */
+    generateDataSourceDescriptionRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.generateDataSourceDescriptionRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.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
+     */
+    generateDataSourceDescription(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.generateDataSourceDescriptionRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for getDataSource without sending the request
      */
@@ -338,7 +488,7 @@ class DataSourcesApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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
      */
     modelDataSourceTableRaw(requestParameters, initOverrides) {
@@ -349,7 +499,7 @@ class DataSourcesApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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, initOverrides) {
@@ -358,6 +508,59 @@ class DataSourcesApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for modelDataSourceTables without sending the request
+     */
+    modelDataSourceTablesRequestOpts(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 modelDataSourceTables().');
+            }
+            if (requestParameters['bulkModelTablesRequest'] == null) {
+                throw new runtime.RequiredError('bulkModelTablesRequest', 'Required parameter "bulkModelTablesRequest" was null or undefined when calling modelDataSourceTables().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                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: (0, index_1.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
+     */
+    modelDataSourceTablesRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.modelDataSourceTablesRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.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
+     */
+    modelDataSourceTables(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.modelDataSourceTablesRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for queryDataSource without sending the request
      */

package/dist/apis/DocumentVersionsApi.d.ts

@@ -235,7 +235,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
@@ -245,7 +245,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>;
@@ -417,12 +417,12 @@ export declare class DocumentVersionsApi extends runtime.BaseAPI implements Docu
      */
     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).
      * Get Document Version Diff Handler
      */
     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>;

package/dist/apis/DocumentVersionsApi.js

@@ -450,7 +450,7 @@ class DocumentVersionsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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
      */
     getDocumentVersionDiffRaw(requestParameters, initOverrides) {
@@ -461,7 +461,7 @@ class DocumentVersionsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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, initOverrides) {