@knowledge-stack/ksapi 1.131.5 → 1.133.0

package/dist/apis/BulkDownloadApi.js

@@ -3,7 +3,7 @@
 /* eslint-disable */
 /**
  * Knowledge Stack API
- * Knowledge Stack backend API for authentication and knowledge management
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call.
  *
  * The version of the OpenAPI document: 0.1.0
  *

package/dist/apis/ChunkLineagesApi.d.ts

@@ -1,6 +1,6 @@
 /**
  * Knowledge Stack API
- * Knowledge Stack backend API for authentication and knowledge management
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call.
  *
  * The version of the OpenAPI document: 0.1.0
  *

package/dist/apis/ChunkLineagesApi.js

@@ -3,7 +3,7 @@
 /* eslint-disable */
 /**
  * Knowledge Stack API
- * Knowledge Stack backend API for authentication and knowledge management
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call.
  *
  * The version of the OpenAPI document: 0.1.0
  *

package/dist/apis/ChunksApi.d.ts

@@ -1,6 +1,6 @@
 /**
  * Knowledge Stack API
- * Knowledge Stack backend API for authentication and knowledge management
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call.
  *
  * The version of the OpenAPI document: 0.1.0
  *

package/dist/apis/ChunksApi.js

@@ -3,7 +3,7 @@
 /* eslint-disable */
 /**
  * Knowledge Stack API
- * Knowledge Stack backend API for authentication and knowledge management
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call.
  *
  * The version of the OpenAPI document: 0.1.0
  *

package/dist/apis/DataSourcesApi.d.ts

@@ -1,6 +1,6 @@
 /**
  * Knowledge Stack API
- * Knowledge Stack backend API for authentication and knowledge management
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call.
  *
  * The version of the OpenAPI document: 0.1.0
  *
@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { BulkModelTablesRequest, BulkModelTablesResponse, CreateDataSourceRequest, DataSourceCatalogResponse, DataSourceDescriptionResponse, DataSourceDetailResponse, DataSourceQueryRequest, DataSourceQueryResponse, DataSourceResponse, DataSourceSchemaListResponse, DataSourceTableResponse, ModelTableRequest, UpdateDataSourceRequest, UpdateTableRequest } from '../models/index';
+import type { BulkModelTablesRequest, BulkModelTablesResponse, CreateDataSourceRequest, DataSourceCatalogResponse, DataSourceDescribeResponse, DataSourceDetailResponse, DataSourceQueryRequest, DataSourceQueryResponse, DataSourceResponse, DataSourceSchemaListResponse, DataSourceSyncResponse, DataSourceTableResponse, ModelTableRequest, SearchTablesRequest, SearchTablesResponse, TestConnectionRequest, TestConnectionResponse, UpdateDataSourceRequest, UpdateTableRequest } from '../models/index';
 export interface CreateDataSourceOperationRequest {
     createDataSourceRequest: CreateDataSourceRequest;
 }
@@ -25,7 +25,7 @@ export interface DeleteDataSourceTableRequest {
     dataSourceId: string;
     tableId: string;
 }
-export interface GenerateDataSourceDescriptionRequest {
+export interface DescribeDataSourceTablesRequest {
     dataSourceId: string;
 }
 export interface GetDataSourceRequest {
@@ -50,9 +50,18 @@ export interface QueryDataSourceRequest {
     dataSourceId: string;
     dataSourceQueryRequest: DataSourceQueryRequest;
 }
+export interface SearchDataSourceTablesRequest {
+    searchTablesRequest: SearchTablesRequest;
+}
+export interface SyncDataSourceRequest {
+    dataSourceId: string;
+}
 export interface TestDataSourceConnectionRequest {
     dataSourceId: string;
 }
+export interface TestDataSourceConnectionFreshRequest {
+    testConnectionRequest: TestConnectionRequest;
+}
 export interface UpdateDataSourceOperationRequest {
     dataSourceId: string;
     updateDataSourceRequest: UpdateDataSourceRequest;
@@ -98,7 +107,7 @@ export interface DataSourcesApiInterface {
      */
     deleteDataSourceRequestOpts(requestParameters: DeleteDataSourceRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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).
+     * 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). Each modeled table\'s summary Qdrant point carries that table\'s path_part, so the set-trashed workflow flips it to trashed too — keeping trashed tables out of the agent\'s table search (best-effort, mirrors the document delete path).
      * @summary Delete Data Source Handler
      * @param {string} dataSourceId
      * @param {*} [options] Override http request option.
@@ -107,7 +116,7 @@ export interface DataSourcesApiInterface {
      */
     deleteDataSourceRaw(requestParameters: DeleteDataSourceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
     /**
-     * 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).
+     * 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). Each modeled table\'s summary Qdrant point carries that table\'s path_part, so the set-trashed workflow flips it to trashed too — keeping trashed tables out of the agent\'s table search (best-effort, mirrors the document delete path).
      * Delete Data Source Handler
      */
     deleteDataSource(requestParameters: DeleteDataSourceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
@@ -143,7 +152,7 @@ export interface DataSourcesApiInterface {
      */
     deleteDataSourceTableRequestOpts(requestParameters: DeleteDataSourceTableRequest): Promise<runtime.RequestOpts>;
     /**
-     * Un-model a single table (hard-delete it from its schema).
+     * Un-model a single table (hard-delete it) and purge its summary point.
      * @summary Delete Data Source Table Handler
      * @param {string} dataSourceId
      * @param {string} tableId
@@ -153,31 +162,31 @@ export interface DataSourcesApiInterface {
      */
     deleteDataSourceTableRaw(requestParameters: DeleteDataSourceTableRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
     /**
-     * Un-model a single table (hard-delete it from its schema).
+     * Un-model a single table (hard-delete it) and purge its summary point.
      * Delete Data Source Table Handler
      */
     deleteDataSourceTable(requestParameters: DeleteDataSourceTableRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
-     * Creates request options for generateDataSourceDescription without sending the request
+     * Creates request options for describeDataSourceTables without sending the request
      * @param {string} dataSourceId
      * @throws {RequiredError}
      * @memberof DataSourcesApiInterface
      */
-    generateDataSourceDescriptionRequestOpts(requestParameters: GenerateDataSourceDescriptionRequest): Promise<runtime.RequestOpts>;
+    describeDataSourceTablesRequestOpts(requestParameters: DescribeDataSourceTablesRequest): 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
+     * Summarize + embed each modeled table so the agent can find it by meaning.  Requires ``can_write`` on the connector. Writes one dense Qdrant point per table (``object_kind=table_description``) so the agent\'s table search surfaces the right table across the corpus, while users never see the summaries in ordinary chunk search. Content-hash gated: a table whose summary + exposed columns are unchanged makes no LLM/embedding call, so a repeat call is cheap.
+     * @summary Describe Data Source Tables 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>>;
+    describeDataSourceTablesRaw(requestParameters: DescribeDataSourceTablesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceDescribeResponse>>;
     /**
-     * (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
+     * Summarize + embed each modeled table so the agent can find it by meaning.  Requires ``can_write`` on the connector. Writes one dense Qdrant point per table (``object_kind=table_description``) so the agent\'s table search surfaces the right table across the corpus, while users never see the summaries in ordinary chunk search. Content-hash gated: a table whose summary + exposed columns are unchanged makes no LLM/embedding call, so a repeat call is cheap.
+     * Describe Data Source Tables Handler
      */
-    generateDataSourceDescription(requestParameters: GenerateDataSourceDescriptionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceDescriptionResponse>;
+    describeDataSourceTables(requestParameters: DescribeDataSourceTablesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceDescribeResponse>;
     /**
      * Creates request options for getDataSource without sending the request
      * @param {string} dataSourceId
@@ -312,6 +321,48 @@ export interface DataSourcesApiInterface {
      * Query Data Source Handler
      */
     queryDataSource(requestParameters: QueryDataSourceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceQueryResponse>;
+    /**
+     * Creates request options for searchDataSourceTables without sending the request
+     * @param {SearchTablesRequest} searchTablesRequest
+     * @throws {RequiredError}
+     * @memberof DataSourcesApiInterface
+     */
+    searchDataSourceTablesRequestOpts(requestParameters: SearchDataSourceTablesRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Find modeled tables by the meaning of their summaries (agent discovery).  Dense semantic search over each table\'s summary, scoped to the tenant (optionally one connector). Only tables the caller can read are returned; users never see these summaries in ordinary chunk search.
+     * @summary Search Data Source Tables Handler
+     * @param {SearchTablesRequest} searchTablesRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DataSourcesApiInterface
+     */
+    searchDataSourceTablesRaw(requestParameters: SearchDataSourceTablesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SearchTablesResponse>>;
+    /**
+     * Find modeled tables by the meaning of their summaries (agent discovery).  Dense semantic search over each table\'s summary, scoped to the tenant (optionally one connector). Only tables the caller can read are returned; users never see these summaries in ordinary chunk search.
+     * Search Data Source Tables Handler
+     */
+    searchDataSourceTables(requestParameters: SearchDataSourceTablesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SearchTablesResponse>;
+    /**
+     * Creates request options for syncDataSource without sending the request
+     * @param {string} dataSourceId
+     * @throws {RequiredError}
+     * @memberof DataSourcesApiInterface
+     */
+    syncDataSourceRequestOpts(requestParameters: SyncDataSourceRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Reconcile modeled tables against the live external catalog.  Requires ``can_write``. Re-introspects each modeled schema and, per table: a schema change (columns added/removed/retyped) refreshes ``column_config`` (preserving the admin\'s ``exposed``/``comment`` field-modeling) and re-summarizes + re-embeds; an unchanged table is a no-op; a table dropped from the source is soft-deleted (keeping the \"was modeled, now gone\" record) and its embedding purged. It never models tables that were not imported.
+     * @summary Sync Data Source Handler
+     * @param {string} dataSourceId
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DataSourcesApiInterface
+     */
+    syncDataSourceRaw(requestParameters: SyncDataSourceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceSyncResponse>>;
+    /**
+     * Reconcile modeled tables against the live external catalog.  Requires ``can_write``. Re-introspects each modeled schema and, per table: a schema change (columns added/removed/retyped) refreshes ``column_config`` (preserving the admin\'s ``exposed``/``comment`` field-modeling) and re-summarizes + re-embeds; an unchanged table is a no-op; a table dropped from the source is soft-deleted (keeping the \"was modeled, now gone\" record) and its embedding purged. It never models tables that were not imported.
+     * Sync Data Source Handler
+     */
+    syncDataSource(requestParameters: SyncDataSourceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceSyncResponse>;
     /**
      * Creates request options for testDataSourceConnection without sending the request
      * @param {string} dataSourceId
@@ -333,6 +384,27 @@ export interface DataSourcesApiInterface {
      * Test Data Source Connection Handler
      */
     testDataSourceConnection(requestParameters: TestDataSourceConnectionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Creates request options for testDataSourceConnectionFresh without sending the request
+     * @param {TestConnectionRequest} testConnectionRequest
+     * @throws {RequiredError}
+     * @memberof DataSourcesApiInterface
+     */
+    testDataSourceConnectionFreshRequestOpts(requestParameters: TestDataSourceConnectionFreshRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Probe fresh creds or a stored connector without persisting anything.  Returns a 200 body describing success/failure (vs the 400 the create/test routes raise) so the FE can render inline connection validation.
+     * @summary Test Data Source Connection Fresh Handler
+     * @param {TestConnectionRequest} testConnectionRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof DataSourcesApiInterface
+     */
+    testDataSourceConnectionFreshRaw(requestParameters: TestDataSourceConnectionFreshRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TestConnectionResponse>>;
+    /**
+     * Probe fresh creds or a stored connector without persisting anything.  Returns a 200 body describing success/failure (vs the 400 the create/test routes raise) so the FE can render inline connection validation.
+     * Test Data Source Connection Fresh Handler
+     */
+    testDataSourceConnectionFresh(requestParameters: TestDataSourceConnectionFreshRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TestConnectionResponse>;
     /**
      * Creates request options for updateDataSource without sending the request
      * @param {string} dataSourceId
@@ -342,7 +414,7 @@ export interface DataSourcesApiInterface {
      */
     updateDataSourceRequestOpts(requestParameters: UpdateDataSourceOperationRequest): Promise<runtime.RequestOpts>;
     /**
-     * Rename and/or move a connector.  Requires ``can_write`` on the connector (and on the destination folder for a move).
+     * Rename, move, and/or re-credential a connector.  Requires ``can_write`` on the connector (and on the destination folder for a move). Fresh ``connection_config`` is re-validated against the DB before persisting (bad creds → 400, consistent with create); creds are never echoed back. ``engine`` is immutable.
      * @summary Update Data Source Handler
      * @param {string} dataSourceId
      * @param {UpdateDataSourceRequest} updateDataSourceRequest
@@ -352,7 +424,7 @@ export interface DataSourcesApiInterface {
      */
     updateDataSourceRaw(requestParameters: UpdateDataSourceOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceResponse>>;
     /**
-     * Rename and/or move a connector.  Requires ``can_write`` on the connector (and on the destination folder for a move).
+     * Rename, move, and/or re-credential a connector.  Requires ``can_write`` on the connector (and on the destination folder for a move). Fresh ``connection_config`` is re-validated against the DB before persisting (bad creds → 400, consistent with create); creds are never echoed back. ``engine`` is immutable.
      * Update Data Source Handler
      */
     updateDataSource(requestParameters: UpdateDataSourceOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceResponse>;
@@ -366,7 +438,7 @@ export interface DataSourcesApiInterface {
      */
     updateDataSourceTableRequestOpts(requestParameters: UpdateDataSourceTableRequest): Promise<runtime.RequestOpts>;
     /**
-     * Field-modeling: update the table\'s description / column allowlist.
+     * Field-modeling: update the table\'s column allowlist.
      * @summary Update Data Source Table Handler
      * @param {string} dataSourceId
      * @param {string} tableId
@@ -377,7 +449,7 @@ export interface DataSourcesApiInterface {
      */
     updateDataSourceTableRaw(requestParameters: UpdateDataSourceTableRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceTableResponse>>;
     /**
-     * Field-modeling: update the table\'s description / column allowlist.
+     * Field-modeling: update the table\'s column allowlist.
      * Update Data Source Table Handler
      */
     updateDataSourceTable(requestParameters: UpdateDataSourceTableRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceTableResponse>;
@@ -405,12 +477,12 @@ export declare class DataSourcesApi extends runtime.BaseAPI implements DataSourc
      */
     deleteDataSourceRequestOpts(requestParameters: DeleteDataSourceRequest): Promise<runtime.RequestOpts>;
     /**
-     * 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).
+     * 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). Each modeled table\'s summary Qdrant point carries that table\'s path_part, so the set-trashed workflow flips it to trashed too — keeping trashed tables out of the agent\'s table search (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 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).
+     * 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). Each modeled table\'s summary Qdrant point carries that table\'s path_part, so the set-trashed workflow flips it to trashed too — keeping trashed tables out of the agent\'s table search (best-effort, mirrors the document delete path).
      * Delete Data Source Handler
      */
     deleteDataSource(requestParameters: DeleteDataSourceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
@@ -433,29 +505,29 @@ export declare class DataSourcesApi extends runtime.BaseAPI implements DataSourc
      */
     deleteDataSourceTableRequestOpts(requestParameters: DeleteDataSourceTableRequest): Promise<runtime.RequestOpts>;
     /**
-     * Un-model a single table (hard-delete it from its schema).
+     * Un-model a single table (hard-delete it) and purge its summary point.
      * 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).
+     * Un-model a single table (hard-delete it) and purge its summary point.
      * Delete Data Source Table Handler
      */
     deleteDataSourceTable(requestParameters: DeleteDataSourceTableRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
-     * Creates request options for generateDataSourceDescription without sending the request
+     * Creates request options for describeDataSourceTables without sending the request
      */
-    generateDataSourceDescriptionRequestOpts(requestParameters: GenerateDataSourceDescriptionRequest): Promise<runtime.RequestOpts>;
+    describeDataSourceTablesRequestOpts(requestParameters: DescribeDataSourceTablesRequest): 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
+     * Summarize + embed each modeled table so the agent can find it by meaning.  Requires ``can_write`` on the connector. Writes one dense Qdrant point per table (``object_kind=table_description``) so the agent\'s table search surfaces the right table across the corpus, while users never see the summaries in ordinary chunk search. Content-hash gated: a table whose summary + exposed columns are unchanged makes no LLM/embedding call, so a repeat call is cheap.
+     * Describe Data Source Tables Handler
      */
-    generateDataSourceDescriptionRaw(requestParameters: GenerateDataSourceDescriptionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceDescriptionResponse>>;
+    describeDataSourceTablesRaw(requestParameters: DescribeDataSourceTablesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceDescribeResponse>>;
     /**
-     * (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
+     * Summarize + embed each modeled table so the agent can find it by meaning.  Requires ``can_write`` on the connector. Writes one dense Qdrant point per table (``object_kind=table_description``) so the agent\'s table search surfaces the right table across the corpus, while users never see the summaries in ordinary chunk search. Content-hash gated: a table whose summary + exposed columns are unchanged makes no LLM/embedding call, so a repeat call is cheap.
+     * Describe Data Source Tables Handler
      */
-    generateDataSourceDescription(requestParameters: GenerateDataSourceDescriptionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceDescriptionResponse>;
+    describeDataSourceTables(requestParameters: DescribeDataSourceTablesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceDescribeResponse>;
     /**
      * Creates request options for getDataSource without sending the request
      */
@@ -540,6 +612,34 @@ export declare class DataSourcesApi extends runtime.BaseAPI implements DataSourc
      * Query Data Source Handler
      */
     queryDataSource(requestParameters: QueryDataSourceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceQueryResponse>;
+    /**
+     * Creates request options for searchDataSourceTables without sending the request
+     */
+    searchDataSourceTablesRequestOpts(requestParameters: SearchDataSourceTablesRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Find modeled tables by the meaning of their summaries (agent discovery).  Dense semantic search over each table\'s summary, scoped to the tenant (optionally one connector). Only tables the caller can read are returned; users never see these summaries in ordinary chunk search.
+     * Search Data Source Tables Handler
+     */
+    searchDataSourceTablesRaw(requestParameters: SearchDataSourceTablesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SearchTablesResponse>>;
+    /**
+     * Find modeled tables by the meaning of their summaries (agent discovery).  Dense semantic search over each table\'s summary, scoped to the tenant (optionally one connector). Only tables the caller can read are returned; users never see these summaries in ordinary chunk search.
+     * Search Data Source Tables Handler
+     */
+    searchDataSourceTables(requestParameters: SearchDataSourceTablesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SearchTablesResponse>;
+    /**
+     * Creates request options for syncDataSource without sending the request
+     */
+    syncDataSourceRequestOpts(requestParameters: SyncDataSourceRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Reconcile modeled tables against the live external catalog.  Requires ``can_write``. Re-introspects each modeled schema and, per table: a schema change (columns added/removed/retyped) refreshes ``column_config`` (preserving the admin\'s ``exposed``/``comment`` field-modeling) and re-summarizes + re-embeds; an unchanged table is a no-op; a table dropped from the source is soft-deleted (keeping the \"was modeled, now gone\" record) and its embedding purged. It never models tables that were not imported.
+     * Sync Data Source Handler
+     */
+    syncDataSourceRaw(requestParameters: SyncDataSourceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceSyncResponse>>;
+    /**
+     * Reconcile modeled tables against the live external catalog.  Requires ``can_write``. Re-introspects each modeled schema and, per table: a schema change (columns added/removed/retyped) refreshes ``column_config`` (preserving the admin\'s ``exposed``/``comment`` field-modeling) and re-summarizes + re-embeds; an unchanged table is a no-op; a table dropped from the source is soft-deleted (keeping the \"was modeled, now gone\" record) and its embedding purged. It never models tables that were not imported.
+     * Sync Data Source Handler
+     */
+    syncDataSource(requestParameters: SyncDataSourceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceSyncResponse>;
     /**
      * Creates request options for testDataSourceConnection without sending the request
      */
@@ -554,17 +654,31 @@ export declare class DataSourcesApi extends runtime.BaseAPI implements DataSourc
      * Test Data Source Connection Handler
      */
     testDataSourceConnection(requestParameters: TestDataSourceConnectionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Creates request options for testDataSourceConnectionFresh without sending the request
+     */
+    testDataSourceConnectionFreshRequestOpts(requestParameters: TestDataSourceConnectionFreshRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Probe fresh creds or a stored connector without persisting anything.  Returns a 200 body describing success/failure (vs the 400 the create/test routes raise) so the FE can render inline connection validation.
+     * Test Data Source Connection Fresh Handler
+     */
+    testDataSourceConnectionFreshRaw(requestParameters: TestDataSourceConnectionFreshRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<TestConnectionResponse>>;
+    /**
+     * Probe fresh creds or a stored connector without persisting anything.  Returns a 200 body describing success/failure (vs the 400 the create/test routes raise) so the FE can render inline connection validation.
+     * Test Data Source Connection Fresh Handler
+     */
+    testDataSourceConnectionFresh(requestParameters: TestDataSourceConnectionFreshRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<TestConnectionResponse>;
     /**
      * Creates request options for updateDataSource without sending the request
      */
     updateDataSourceRequestOpts(requestParameters: UpdateDataSourceOperationRequest): Promise<runtime.RequestOpts>;
     /**
-     * Rename and/or move a connector.  Requires ``can_write`` on the connector (and on the destination folder for a move).
+     * Rename, move, and/or re-credential a connector.  Requires ``can_write`` on the connector (and on the destination folder for a move). Fresh ``connection_config`` is re-validated against the DB before persisting (bad creds → 400, consistent with create); creds are never echoed back. ``engine`` is immutable.
      * Update Data Source Handler
      */
     updateDataSourceRaw(requestParameters: UpdateDataSourceOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceResponse>>;
     /**
-     * Rename and/or move a connector.  Requires ``can_write`` on the connector (and on the destination folder for a move).
+     * Rename, move, and/or re-credential a connector.  Requires ``can_write`` on the connector (and on the destination folder for a move). Fresh ``connection_config`` is re-validated against the DB before persisting (bad creds → 400, consistent with create); creds are never echoed back. ``engine`` is immutable.
      * Update Data Source Handler
      */
     updateDataSource(requestParameters: UpdateDataSourceOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceResponse>;
@@ -573,12 +687,12 @@ export declare class DataSourcesApi extends runtime.BaseAPI implements DataSourc
      */
     updateDataSourceTableRequestOpts(requestParameters: UpdateDataSourceTableRequest): Promise<runtime.RequestOpts>;
     /**
-     * Field-modeling: update the table\'s description / column allowlist.
+     * Field-modeling: update the table\'s column allowlist.
      * Update Data Source Table Handler
      */
     updateDataSourceTableRaw(requestParameters: UpdateDataSourceTableRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DataSourceTableResponse>>;
     /**
-     * Field-modeling: update the table\'s description / column allowlist.
+     * Field-modeling: update the table\'s column allowlist.
      * Update Data Source Table Handler
      */
     updateDataSourceTable(requestParameters: UpdateDataSourceTableRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DataSourceTableResponse>;