@knowledge-stack/ksapi 1.131.5 → 1.133.0

package/dist/models/XlsxCellAnchorInputOrDocxParagraphAnchorInput.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/models/XlsxCellAnchorOutput.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/models/XlsxCellAnchorOutput.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/models/XlsxCellAnchorOutputOrDocxParagraphAnchorOutput.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/models/XlsxCellAnchorOutputOrDocxParagraphAnchorOutput.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/models/index.d.ts

@@ -67,7 +67,7 @@ export * from './CreateThreadMessageRequest';
 export * from './CreateThreadRequest';
 export * from './CreateWorkflowDefinitionRequest';
 export * from './DataSourceCatalogResponse';
-export * from './DataSourceDescriptionResponse';
+export * from './DataSourceDescribeResponse';
 export * from './DataSourceDetailResponse';
 export * from './DataSourceEngine';
 export * from './DataSourceQueryRequest';
@@ -76,6 +76,7 @@ export * from './DataSourceResponse';
 export * from './DataSourceSchemaListItem';
 export * from './DataSourceSchemaListResponse';
 export * from './DataSourceSchemaResponse';
+export * from './DataSourceSyncResponse';
 export * from './DataSourceTableResponse';
 export * from './DiffFormat';
 export * from './DiffRow';
@@ -220,9 +221,13 @@ export * from './ResolvedReferenceOutput';
 export * from './ResponseSendPwResetEmail';
 export * from './RevisionEdit';
 export * from './RootResponse';
+export * from './RunFolder';
+export * from './RunFolderRef';
 export * from './SSOInitiateResponse';
 export * from './ScoredChunkResponse';
 export * from './SearchSortOrder';
+export * from './SearchTablesRequest';
+export * from './SearchTablesResponse';
 export * from './SearchType';
 export * from './SearchablePartType';
 export * from './SeatQuotaStatus';
@@ -250,6 +255,7 @@ export * from './SubtreeChunksResponse';
 export * from './SupportedIdP';
 export * from './SupportedLanguage';
 export * from './TableCellChange';
+export * from './TableSearchResult';
 export * from './TagOrder';
 export * from './TagResponse';
 export * from './TemporalWorkflowStatusResponse';
@@ -263,6 +269,8 @@ export * from './TenantUserEditRequest';
 export * from './TenantUserOrder';
 export * from './TenantUserResponse';
 export * from './TenantUserRole';
+export * from './TestConnectionRequest';
+export * from './TestConnectionResponse';
 export * from './TextDiff';
 export * from './TextPart';
 export * from './TextPartOrReasoningPartOrToolPartOrDocEditPart';
@@ -271,6 +279,7 @@ export * from './ThreadMessageDetails';
 export * from './ThreadMessageResponse';
 export * from './ThreadOrder';
 export * from './ThreadResponse';
+export * from './ToolDisplayType';
 export * from './ToolPart';
 export * from './ToolStatus';
 export * from './TransferOwnerRequest';

package/dist/models/index.js

@@ -85,7 +85,7 @@ __exportStar(require("./CreateThreadMessageRequest"), exports);
 __exportStar(require("./CreateThreadRequest"), exports);
 __exportStar(require("./CreateWorkflowDefinitionRequest"), exports);
 __exportStar(require("./DataSourceCatalogResponse"), exports);
-__exportStar(require("./DataSourceDescriptionResponse"), exports);
+__exportStar(require("./DataSourceDescribeResponse"), exports);
 __exportStar(require("./DataSourceDetailResponse"), exports);
 __exportStar(require("./DataSourceEngine"), exports);
 __exportStar(require("./DataSourceQueryRequest"), exports);
@@ -94,6 +94,7 @@ __exportStar(require("./DataSourceResponse"), exports);
 __exportStar(require("./DataSourceSchemaListItem"), exports);
 __exportStar(require("./DataSourceSchemaListResponse"), exports);
 __exportStar(require("./DataSourceSchemaResponse"), exports);
+__exportStar(require("./DataSourceSyncResponse"), exports);
 __exportStar(require("./DataSourceTableResponse"), exports);
 __exportStar(require("./DiffFormat"), exports);
 __exportStar(require("./DiffRow"), exports);
@@ -238,9 +239,13 @@ __exportStar(require("./ResolvedReferenceOutput"), exports);
 __exportStar(require("./ResponseSendPwResetEmail"), exports);
 __exportStar(require("./RevisionEdit"), exports);
 __exportStar(require("./RootResponse"), exports);
+__exportStar(require("./RunFolder"), exports);
+__exportStar(require("./RunFolderRef"), exports);
 __exportStar(require("./SSOInitiateResponse"), exports);
 __exportStar(require("./ScoredChunkResponse"), exports);
 __exportStar(require("./SearchSortOrder"), exports);
+__exportStar(require("./SearchTablesRequest"), exports);
+__exportStar(require("./SearchTablesResponse"), exports);
 __exportStar(require("./SearchType"), exports);
 __exportStar(require("./SearchablePartType"), exports);
 __exportStar(require("./SeatQuotaStatus"), exports);
@@ -268,6 +273,7 @@ __exportStar(require("./SubtreeChunksResponse"), exports);
 __exportStar(require("./SupportedIdP"), exports);
 __exportStar(require("./SupportedLanguage"), exports);
 __exportStar(require("./TableCellChange"), exports);
+__exportStar(require("./TableSearchResult"), exports);
 __exportStar(require("./TagOrder"), exports);
 __exportStar(require("./TagResponse"), exports);
 __exportStar(require("./TemporalWorkflowStatusResponse"), exports);
@@ -281,6 +287,8 @@ __exportStar(require("./TenantUserEditRequest"), exports);
 __exportStar(require("./TenantUserOrder"), exports);
 __exportStar(require("./TenantUserResponse"), exports);
 __exportStar(require("./TenantUserRole"), exports);
+__exportStar(require("./TestConnectionRequest"), exports);
+__exportStar(require("./TestConnectionResponse"), exports);
 __exportStar(require("./TextDiff"), exports);
 __exportStar(require("./TextPart"), exports);
 __exportStar(require("./TextPartOrReasoningPartOrToolPartOrDocEditPart"), exports);
@@ -289,6 +297,7 @@ __exportStar(require("./ThreadMessageDetails"), exports);
 __exportStar(require("./ThreadMessageResponse"), exports);
 __exportStar(require("./ThreadOrder"), exports);
 __exportStar(require("./ThreadResponse"), exports);
+__exportStar(require("./ToolDisplayType"), exports);
 __exportStar(require("./ToolPart"), exports);
 __exportStar(require("./ToolStatus"), exports);
 __exportStar(require("./TransferOwnerRequest"), exports);

package/dist/runtime.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/runtime.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/docs/AgentApi.md

@@ -15,7 +15,7 @@ All URIs are relative to *http://localhost:8000*
 
 Agent Ask Handler
 
-Run a one-shot text agent request to completion and return the payload.  The request blocks until the underlying Temporal workflow finishes. Clients should set a generous HTTP timeout to accommodate tool-heavy runs.  Quota: consumes one MESSAGE before ``start_workflow``. Refund semantics distinguish cause:  * **Cancellation** (client disconnect → ``asyncio.CancelledError``,   OR explicit ``DELETE /v1/workflows/{id}`` while we await   ``handle.result()`` → Temporal-wrapped ``CancelledError``)   → **NO REFUND.** The user walked away or actively cancelled;   that\'s their volition. We still best-effort cancel the   workflow so the agent stops burning LLM tokens, but the   consume stays charged. Detection uses   ``temporalio.exceptions.is_cancelled_exception`` which spans   both forms. * Any other exception (pre-enqueue ``start_workflow`` raise,   Temporal failure, workflow-internal error) → **REFUND.** Server   / our-problem failures don\'t bill the user.
+Run a one-shot text agent request to completion and return the payload.  The request blocks until the underlying Temporal workflow finishes. Clients should set a generous HTTP timeout to accommodate tool-heavy runs.  Quota: consumes one MESSAGE before ``start_workflow``. Refund semantics distinguish cause:  * **Cancellation** (client disconnect → ``asyncio.CancelledError``,   OR explicit ``DELETE /v1/system-jobs/{id}`` while we await   ``handle.result()`` → Temporal-wrapped ``CancelledError``)   → **NO REFUND.** The user walked away or actively cancelled;   that\'s their volition. We still best-effort cancel the   workflow so the agent stops burning LLM tokens, but the   consume stays charged. Detection uses   ``temporalio.exceptions.is_cancelled_exception`` which spans   both forms. * Any other exception (pre-enqueue ``start_workflow`` raise,   Temporal failure, workflow-internal error) → **REFUND.** Server   / our-problem failures don\'t bill the user.
 
 ### Example
 

package/docs/AskRequest.md

@@ -16,7 +16,7 @@ import type { AskRequest } from '@knowledge-stack/ksapi'
 
 // TODO: Update the object below with actual values
 const example = {
-  "prompt": null,
+  "prompt": Summarize the latest version of the Q3 vendor contract.,
 } satisfies AskRequest
 
 console.log(example)

package/docs/AuditEventsApi.md

@@ -15,7 +15,7 @@ All URIs are relative to *http://localhost:8000*
 
 Export Audit Events Handler
 
-Export the tenant\'s audit events as a CSV download (admin/owner only).  Same filters as ``list_audit_events`` but unpaginated — streams every matching event newest-first. Each row resolves the actor\'s name and the subject\'s name + path so an auditor can read the file directly in Excel.
+Export the tenant\'s audit events as a CSV download (admin/owner only).  Same filters as ``list_audit_events`` but unpaginated — streams every matching event newest-first. Each row resolves the actor\'s name and the subject\'s name + path so an auditor can read the file directly in Excel.  With no `since`/`until` the export covers the entire audit log; pass either bound to narrow to an optional from/to window.
 
 ### Example
 
@@ -41,9 +41,9 @@ async function example() {
     actorUserId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
     // string | Filter to one event kind (optional)
     kind: kind_example,
-    // Date | Only events at or after this timestamp (optional)
+    // Date | Only events at or after this timestamp (from). Omit to export the entire audit log. Must not be in the future or after `until`. (optional)
     since: 2013-10-20T19:20:30+01:00,
-    // Date | Only events strictly before this timestamp (optional)
+    // Date | Only events strictly before this timestamp (to). Omit for no upper bound. Must not be in the future. (optional)
     until: 2013-10-20T19:20:30+01:00,
     // string | Scope to one document/folder/run subject (optional)
     subjectPathPartId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
@@ -70,8 +70,8 @@ example().catch(console.error);
 |------------- | ------------- | ------------- | -------------|
 | **actorUserId** | `string` | Filter to one actor | [Optional] [Defaults to `undefined`] |
 | **kind** | `string` | Filter to one event kind | [Optional] [Defaults to `undefined`] |
-| **since** | `Date` | Only events at or after this timestamp | [Optional] [Defaults to `undefined`] |
-| **until** | `Date` | Only events strictly before this timestamp | [Optional] [Defaults to `undefined`] |
+| **since** | `Date` | Only events at or after this timestamp (from). Omit to export the entire audit log. Must not be in the future or after `until`. | [Optional] [Defaults to `undefined`] |
+| **until** | `Date` | Only events strictly before this timestamp (to). Omit for no upper bound. Must not be in the future. | [Optional] [Defaults to `undefined`] |
 | **subjectPathPartId** | `string` | Scope to one document/folder/run subject | [Optional] [Defaults to `undefined`] |
 | **recursive** | `boolean` | Include the subject\'s descendants (needs subject) | [Optional] [Defaults to `false`] |
 
@@ -105,7 +105,7 @@ example().catch(console.error);
 
 List Audit Events Handler
 
-List the tenant\'s audit events, newest first (admin/owner only).  Returns every event in the caller\'s own tenant — ADMIN/OWNER bypass path permissions by design. Filter by actor, kind, time window, and/or a subject subtree. Each event carries its resolved actor name.
+List the tenant\'s audit events, newest first (admin/owner only).  Returns every event in the caller\'s own tenant — ADMIN/OWNER bypass path permissions by design. Filter by actor, kind, an optional `since`(from)/ `until`(to) window, and/or a subject subtree. Each event carries its resolved actor name.
 
 ### Example
 
@@ -131,9 +131,9 @@ async function example() {
     actorUserId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
     // string | Filter to one event kind (optional)
     kind: kind_example,
-    // Date | Only events at or after this timestamp (optional)
+    // Date | Only events at or after this timestamp (from). Omit for no lower bound. Must not be in the future or after `until`. (optional)
     since: 2013-10-20T19:20:30+01:00,
-    // Date | Only events strictly before this timestamp (optional)
+    // Date | Only events strictly before this timestamp (to). Omit for no upper bound. Must not be in the future. (optional)
     until: 2013-10-20T19:20:30+01:00,
     // string | Scope to one document/folder/run subject (optional)
     subjectPathPartId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
@@ -166,8 +166,8 @@ example().catch(console.error);
 |------------- | ------------- | ------------- | -------------|
 | **actorUserId** | `string` | Filter to one actor | [Optional] [Defaults to `undefined`] |
 | **kind** | `string` | Filter to one event kind | [Optional] [Defaults to `undefined`] |
-| **since** | `Date` | Only events at or after this timestamp | [Optional] [Defaults to `undefined`] |
-| **until** | `Date` | Only events strictly before this timestamp | [Optional] [Defaults to `undefined`] |
+| **since** | `Date` | Only events at or after this timestamp (from). Omit for no lower bound. Must not be in the future or after `until`. | [Optional] [Defaults to `undefined`] |
+| **until** | `Date` | Only events strictly before this timestamp (to). Omit for no upper bound. Must not be in the future. | [Optional] [Defaults to `undefined`] |
 | **subjectPathPartId** | `string` | Scope to one document/folder/run subject | [Optional] [Defaults to `undefined`] |
 | **recursive** | `boolean` | Include the subject\'s descendants (needs subject) | [Optional] [Defaults to `false`] |
 | **sortDir** | `SortDirection` | Sort by timestamp (default: DESC, newest first) | [Optional] [Defaults to `undefined`] [Enum: ASC, DESC] |

package/docs/CreateApiKeyRequest.md

@@ -17,8 +17,8 @@ import type { CreateApiKeyRequest } from '@knowledge-stack/ksapi'
 
 // TODO: Update the object below with actual values
 const example = {
-  "name": null,
-  "expiresAt": null,
+  "name": rpa-invoice-bot,
+  "expiresAt": 2026-12-31T23:59:59Z,
 } satisfies CreateApiKeyRequest
 
 console.log(example)

package/docs/CreateApiKeyResponse.md

@@ -23,7 +23,7 @@ import type { CreateApiKeyResponse } from '@knowledge-stack/ksapi'
 const example = {
   "id": null,
   "name": null,
-  "key": null,
+  "key": sk-user-0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef,
   "keySuffix": null,
   "createdAt": null,
   "expiresAt": null,

package/docs/DataSourceDescribeResponse.md

@@ -0,0 +1,41 @@
+
+# DataSourceDescribeResponse
+
+Result of (re)describing a connector\'s modeled tables.  Each modeled table gets a one-line summary embedded as a single Qdrant point for the agent\'s table search. Counts report how many tables were (re)summarized and (re)embedded this call; unchanged tables are skipped (the embed is content-hash gated), so a repeat call reports zeros.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`dataSourceId` | string
+`tablesTotal` | number
+`summarized` | number
+`embedded` | number
+
+## Example
+
+```typescript
+import type { DataSourceDescribeResponse } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "dataSourceId": null,
+  "tablesTotal": null,
+  "summarized": null,
+  "embedded": null,
+} satisfies DataSourceDescribeResponse
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as DataSourceDescribeResponse
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/DataSourceDetailResponse.md

@@ -1,7 +1,7 @@
 
 # DataSourceDetailResponse
 
-A connector plus the schemas (and their readable tables) the caller sees.  ``description_document_id`` points at the connector\'s generated, ingested \"Database overview\" Document (a hidden system file); null until generated.
+A connector plus the schemas (and their readable tables) the caller sees.
 
 ## Properties
 
@@ -9,7 +9,6 @@ Name | Type
 ------------ | -------------
 `dataSource` | [DataSourceResponse](DataSourceResponse.md)
 `schemas` | [Array<DataSourceSchemaResponse>](DataSourceSchemaResponse.md)
-`descriptionDocumentId` | string
 
 ## Example
 
@@ -20,7 +19,6 @@ import type { DataSourceDetailResponse } from '@knowledge-stack/ksapi'
 const example = {
   "dataSource": null,
   "schemas": null,
-  "descriptionDocumentId": null,
 } satisfies DataSourceDetailResponse
 
 console.log(example)

package/docs/DataSourceSchemaResponse.md

@@ -17,7 +17,6 @@ Name | Type
 `dataSourceId` | string
 `schemaName` | string
 `isDefault` | boolean
-`description` | string
 `approvalState` | [PathPartApprovalState](PathPartApprovalState.md)
 `permissions` | [ItemPermissions](ItemPermissions.md)
 `createdAt` | Date
@@ -41,7 +40,6 @@ const example = {
   "dataSourceId": null,
   "schemaName": null,
   "isDefault": null,
-  "description": null,
   "approvalState": null,
   "permissions": null,
   "createdAt": null,

package/docs/DataSourceSyncResponse.md

@@ -0,0 +1,41 @@
+
+# DataSourceSyncResponse
+
+Result of reconciling modeled tables against the live external catalog.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`dataSourceId` | string
+`updated` | number
+`unchanged` | number
+`deleted` | number
+
+## Example
+
+```typescript
+import type { DataSourceSyncResponse } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "dataSourceId": null,
+  "updated": null,
+  "unchanged": null,
+  "deleted": null,
+} satisfies DataSourceSyncResponse
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as DataSourceSyncResponse
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/DataSourceTableResponse.md

@@ -17,7 +17,6 @@ Name | Type
 `dataSourceId` | string
 `dataSourceSchemaId` | string
 `tableName` | string
-`description` | string
 `columnConfig` | Array<{ [key: string]: any; }>
 `approvalState` | [PathPartApprovalState](PathPartApprovalState.md)
 `permissions` | [ItemPermissions](ItemPermissions.md)
@@ -41,7 +40,6 @@ const example = {
   "dataSourceId": null,
   "dataSourceSchemaId": null,
   "tableName": null,
-  "description": null,
   "columnConfig": null,
   "approvalState": null,
   "permissions": null,