@knowledge-stack/ksapi 1.153.0 → 1.155.0

package/dist/models/BulkMoveRequest.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Knowledge Stack API
+ * 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
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Move the selected folders and documents into ``target_folder_id``.
+ * @export
+ * @interface BulkMoveRequest
+ */
+export interface BulkMoveRequest {
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof BulkMoveRequest
+     */
+    folderIds?: Array<string>;
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof BulkMoveRequest
+     */
+    documentIds?: Array<string>;
+    /**
+     *
+     * @type {string}
+     * @memberof BulkMoveRequest
+     */
+    targetFolderId: string;
+}
+export declare const BulkMoveRequestPropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maximum?: number;
+        exclusiveMaximum?: boolean;
+        minimum?: number;
+        exclusiveMinimum?: boolean;
+        multipleOf?: number;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+    };
+};
+/**
+ * Check if a given object implements the BulkMoveRequest interface.
+ */
+export declare function instanceOfBulkMoveRequest(value: object): value is BulkMoveRequest;
+export declare function BulkMoveRequestFromJSON(json: any): BulkMoveRequest;
+export declare function BulkMoveRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): BulkMoveRequest;
+export declare function BulkMoveRequestToJSON(json: any): BulkMoveRequest;
+export declare function BulkMoveRequestToJSONTyped(value?: BulkMoveRequest | null, ignoreDiscriminator?: boolean): any;

package/dist/models/BulkMoveRequest.js

@@ -0,0 +1,56 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * 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
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BulkMoveRequestPropertyValidationAttributesMap = void 0;
+exports.instanceOfBulkMoveRequest = instanceOfBulkMoveRequest;
+exports.BulkMoveRequestFromJSON = BulkMoveRequestFromJSON;
+exports.BulkMoveRequestFromJSONTyped = BulkMoveRequestFromJSONTyped;
+exports.BulkMoveRequestToJSON = BulkMoveRequestToJSON;
+exports.BulkMoveRequestToJSONTyped = BulkMoveRequestToJSONTyped;
+exports.BulkMoveRequestPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the BulkMoveRequest interface.
+ */
+function instanceOfBulkMoveRequest(value) {
+    if (!('targetFolderId' in value) || value['targetFolderId'] === undefined)
+        return false;
+    return true;
+}
+function BulkMoveRequestFromJSON(json) {
+    return BulkMoveRequestFromJSONTyped(json, false);
+}
+function BulkMoveRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'folderIds': json['folder_ids'] == null ? undefined : json['folder_ids'],
+        'documentIds': json['document_ids'] == null ? undefined : json['document_ids'],
+        'targetFolderId': json['target_folder_id'],
+    };
+}
+function BulkMoveRequestToJSON(json) {
+    return BulkMoveRequestToJSONTyped(json, false);
+}
+function BulkMoveRequestToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'folder_ids': value['folderIds'],
+        'document_ids': value['documentIds'],
+        'target_folder_id': value['targetFolderId'],
+    };
+}

package/dist/models/BulkOperationResponse.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Knowledge Stack API
+ * 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
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { BulkItemFailure } from './BulkItemFailure';
+/**
+ * Per-item outcome of a bulk operation keyed on a single PDO id.
+ * @export
+ * @interface BulkOperationResponse
+ */
+export interface BulkOperationResponse {
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof BulkOperationResponse
+     */
+    succeeded?: Array<string>;
+    /**
+     *
+     * @type {Array<BulkItemFailure>}
+     * @memberof BulkOperationResponse
+     */
+    failed?: Array<BulkItemFailure>;
+}
+export declare const BulkOperationResponsePropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maximum?: number;
+        exclusiveMaximum?: boolean;
+        minimum?: number;
+        exclusiveMinimum?: boolean;
+        multipleOf?: number;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+    };
+};
+/**
+ * Check if a given object implements the BulkOperationResponse interface.
+ */
+export declare function instanceOfBulkOperationResponse(value: object): value is BulkOperationResponse;
+export declare function BulkOperationResponseFromJSON(json: any): BulkOperationResponse;
+export declare function BulkOperationResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): BulkOperationResponse;
+export declare function BulkOperationResponseToJSON(json: any): BulkOperationResponse;
+export declare function BulkOperationResponseToJSONTyped(value?: BulkOperationResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/models/BulkOperationResponse.js

@@ -0,0 +1,53 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * 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
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BulkOperationResponsePropertyValidationAttributesMap = void 0;
+exports.instanceOfBulkOperationResponse = instanceOfBulkOperationResponse;
+exports.BulkOperationResponseFromJSON = BulkOperationResponseFromJSON;
+exports.BulkOperationResponseFromJSONTyped = BulkOperationResponseFromJSONTyped;
+exports.BulkOperationResponseToJSON = BulkOperationResponseToJSON;
+exports.BulkOperationResponseToJSONTyped = BulkOperationResponseToJSONTyped;
+const BulkItemFailure_1 = require("./BulkItemFailure");
+exports.BulkOperationResponsePropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the BulkOperationResponse interface.
+ */
+function instanceOfBulkOperationResponse(value) {
+    return true;
+}
+function BulkOperationResponseFromJSON(json) {
+    return BulkOperationResponseFromJSONTyped(json, false);
+}
+function BulkOperationResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'succeeded': json['succeeded'] == null ? undefined : json['succeeded'],
+        'failed': json['failed'] == null ? undefined : (json['failed'].map(BulkItemFailure_1.BulkItemFailureFromJSON)),
+    };
+}
+function BulkOperationResponseToJSON(json) {
+    return BulkOperationResponseToJSONTyped(json, false);
+}
+function BulkOperationResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'succeeded': value['succeeded'],
+        'failed': value['failed'] == null ? undefined : (value['failed'].map(BulkItemFailure_1.BulkItemFailureToJSON)),
+    };
+}

package/dist/models/BulkRevokeRequest.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Knowledge Stack API
+ * 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
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Revoke many permissions by their own permission-row ids.
+ * @export
+ * @interface BulkRevokeRequest
+ */
+export interface BulkRevokeRequest {
+    /**
+     *
+     * @type {string}
+     * @memberof BulkRevokeRequest
+     */
+    tenantId: string;
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof BulkRevokeRequest
+     */
+    permissionIds?: Array<string>;
+}
+export declare const BulkRevokeRequestPropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maximum?: number;
+        exclusiveMaximum?: boolean;
+        minimum?: number;
+        exclusiveMinimum?: boolean;
+        multipleOf?: number;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+    };
+};
+/**
+ * Check if a given object implements the BulkRevokeRequest interface.
+ */
+export declare function instanceOfBulkRevokeRequest(value: object): value is BulkRevokeRequest;
+export declare function BulkRevokeRequestFromJSON(json: any): BulkRevokeRequest;
+export declare function BulkRevokeRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): BulkRevokeRequest;
+export declare function BulkRevokeRequestToJSON(json: any): BulkRevokeRequest;
+export declare function BulkRevokeRequestToJSONTyped(value?: BulkRevokeRequest | null, ignoreDiscriminator?: boolean): any;

package/dist/models/BulkRevokeRequest.js

@@ -0,0 +1,54 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * 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
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BulkRevokeRequestPropertyValidationAttributesMap = void 0;
+exports.instanceOfBulkRevokeRequest = instanceOfBulkRevokeRequest;
+exports.BulkRevokeRequestFromJSON = BulkRevokeRequestFromJSON;
+exports.BulkRevokeRequestFromJSONTyped = BulkRevokeRequestFromJSONTyped;
+exports.BulkRevokeRequestToJSON = BulkRevokeRequestToJSON;
+exports.BulkRevokeRequestToJSONTyped = BulkRevokeRequestToJSONTyped;
+exports.BulkRevokeRequestPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the BulkRevokeRequest interface.
+ */
+function instanceOfBulkRevokeRequest(value) {
+    if (!('tenantId' in value) || value['tenantId'] === undefined)
+        return false;
+    return true;
+}
+function BulkRevokeRequestFromJSON(json) {
+    return BulkRevokeRequestFromJSONTyped(json, false);
+}
+function BulkRevokeRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'tenantId': json['tenant_id'],
+        'permissionIds': json['permission_ids'] == null ? undefined : json['permission_ids'],
+    };
+}
+function BulkRevokeRequestToJSON(json) {
+    return BulkRevokeRequestToJSONTyped(json, false);
+}
+function BulkRevokeRequestToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'tenant_id': value['tenantId'],
+        'permission_ids': value['permissionIds'],
+    };
+}

package/dist/models/BulkTrashRequest.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Knowledge Stack API
+ * 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
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Restore or permanently delete the selected trashed objects by PDO id.
+ * @export
+ * @interface BulkTrashRequest
+ */
+export interface BulkTrashRequest {
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof BulkTrashRequest
+     */
+    objectIds?: Array<string>;
+}
+export declare const BulkTrashRequestPropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maximum?: number;
+        exclusiveMaximum?: boolean;
+        minimum?: number;
+        exclusiveMinimum?: boolean;
+        multipleOf?: number;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+    };
+};
+/**
+ * Check if a given object implements the BulkTrashRequest interface.
+ */
+export declare function instanceOfBulkTrashRequest(value: object): value is BulkTrashRequest;
+export declare function BulkTrashRequestFromJSON(json: any): BulkTrashRequest;
+export declare function BulkTrashRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): BulkTrashRequest;
+export declare function BulkTrashRequestToJSON(json: any): BulkTrashRequest;
+export declare function BulkTrashRequestToJSONTyped(value?: BulkTrashRequest | null, ignoreDiscriminator?: boolean): any;

package/dist/models/BulkTrashRequest.js

@@ -0,0 +1,50 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * 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
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BulkTrashRequestPropertyValidationAttributesMap = void 0;
+exports.instanceOfBulkTrashRequest = instanceOfBulkTrashRequest;
+exports.BulkTrashRequestFromJSON = BulkTrashRequestFromJSON;
+exports.BulkTrashRequestFromJSONTyped = BulkTrashRequestFromJSONTyped;
+exports.BulkTrashRequestToJSON = BulkTrashRequestToJSON;
+exports.BulkTrashRequestToJSONTyped = BulkTrashRequestToJSONTyped;
+exports.BulkTrashRequestPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the BulkTrashRequest interface.
+ */
+function instanceOfBulkTrashRequest(value) {
+    return true;
+}
+function BulkTrashRequestFromJSON(json) {
+    return BulkTrashRequestFromJSONTyped(json, false);
+}
+function BulkTrashRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'objectIds': json['object_ids'] == null ? undefined : json['object_ids'],
+    };
+}
+function BulkTrashRequestToJSON(json) {
+    return BulkTrashRequestToJSONTyped(json, false);
+}
+function BulkTrashRequestToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'object_ids': value['objectIds'],
+    };
+}

package/dist/models/CreateUploadRequest.d.ts

@@ -39,6 +39,12 @@ export interface CreateUploadRequest {
      * @memberof CreateUploadRequest
      */
     sizeBytes: number;
+    /**
+     * Tags applied to the document on completion (mirrors the buffered ingest endpoints so a mixed submit tags recordings too)
+     * @type {Array<string>}
+     * @memberof CreateUploadRequest
+     */
+    tagIds?: Array<string>;
 }
 export declare const CreateUploadRequestPropertyValidationAttributesMap: {
     [property: string]: {

package/dist/models/CreateUploadRequest.js

@@ -46,6 +46,7 @@ function CreateUploadRequestFromJSONTyped(json, ignoreDiscriminator) {
         'name': json['name'],
         'filename': json['filename'],
         'sizeBytes': json['size_bytes'],
+        'tagIds': json['tag_ids'] == null ? undefined : json['tag_ids'],
     };
 }
 function CreateUploadRequestToJSON(json) {
@@ -60,5 +61,6 @@ function CreateUploadRequestToJSONTyped(value, ignoreDiscriminator = false) {
         'name': value['name'],
         'filename': value['filename'],
         'size_bytes': value['sizeBytes'],
+        'tag_ids': value['tagIds'],
     };
 }

package/dist/models/DocumentVersionMetadata.d.ts

@@ -87,6 +87,24 @@ export interface DocumentVersionMetadata {
      * @memberof DocumentVersionMetadata
      */
     totalChunks?: number | null;
+    /**
+     * Media (audio/video) duration in milliseconds; null for non-media
+     * @type {number}
+     * @memberof DocumentVersionMetadata
+     */
+    durationMs?: number | null;
+    /**
+     * ASR-detected language of the media transcript, as returned by the ASR provider; null for non-media or when the provider omits it
+     * @type {string}
+     * @memberof DocumentVersionMetadata
+     */
+    language?: string | null;
+    /**
+     * Number of transcript segments produced by ASR; null for non-media
+     * @type {number}
+     * @memberof DocumentVersionMetadata
+     */
+    segmentCount?: number | null;
     /**
      * Total formula cells in the workbook (XLSX only)
      * @type {number}

package/dist/models/DocumentVersionMetadata.js

@@ -47,6 +47,9 @@ function DocumentVersionMetadataFromJSONTyped(json, ignoreDiscriminator) {
         'totalPages': json['total_pages'] == null ? undefined : json['total_pages'],
         'totalSections': json['total_sections'] == null ? undefined : json['total_sections'],
         'totalChunks': json['total_chunks'] == null ? undefined : json['total_chunks'],
+        'durationMs': json['duration_ms'] == null ? undefined : json['duration_ms'],
+        'language': json['language'] == null ? undefined : json['language'],
+        'segmentCount': json['segment_count'] == null ? undefined : json['segment_count'],
         'totalFormulas': json['total_formulas'] == null ? undefined : json['total_formulas'],
         'xlsxParseResultS3': json['xlsx_parse_result_s3'] == null ? undefined : json['xlsx_parse_result_s3'],
         'xlsxNamedRanges': json['xlsx_named_ranges'] == null ? undefined : json['xlsx_named_ranges'],
@@ -78,6 +81,9 @@ function DocumentVersionMetadataToJSONTyped(value, ignoreDiscriminator = false)
         'total_pages': value['totalPages'],
         'total_sections': value['totalSections'],
         'total_chunks': value['totalChunks'],
+        'duration_ms': value['durationMs'],
+        'language': value['language'],
+        'segment_count': value['segmentCount'],
         'total_formulas': value['totalFormulas'],
         'xlsx_parse_result_s3': value['xlsxParseResultS3'],
         'xlsx_named_ranges': value['xlsxNamedRanges'],

package/dist/models/DocumentVersionMetadataUpdate.d.ts

@@ -99,6 +99,24 @@ export interface DocumentVersionMetadataUpdate {
      * @memberof DocumentVersionMetadataUpdate
      */
     totalChunks?: number | null;
+    /**
+     *
+     * @type {number}
+     * @memberof DocumentVersionMetadataUpdate
+     */
+    durationMs?: number | null;
+    /**
+     *
+     * @type {string}
+     * @memberof DocumentVersionMetadataUpdate
+     */
+    language?: string | null;
+    /**
+     *
+     * @type {number}
+     * @memberof DocumentVersionMetadataUpdate
+     */
+    segmentCount?: number | null;
     /**
      *
      * @type {number}

package/dist/models/DocumentVersionMetadataUpdate.js

@@ -50,6 +50,9 @@ function DocumentVersionMetadataUpdateFromJSONTyped(json, ignoreDiscriminator) {
         'totalPages': json['total_pages'] == null ? undefined : json['total_pages'],
         'totalSections': json['total_sections'] == null ? undefined : json['total_sections'],
         'totalChunks': json['total_chunks'] == null ? undefined : json['total_chunks'],
+        'durationMs': json['duration_ms'] == null ? undefined : json['duration_ms'],
+        'language': json['language'] == null ? undefined : json['language'],
+        'segmentCount': json['segment_count'] == null ? undefined : json['segment_count'],
         'totalFormulas': json['total_formulas'] == null ? undefined : json['total_formulas'],
         'xlsxParseResultS3': json['xlsx_parse_result_s3'] == null ? undefined : json['xlsx_parse_result_s3'],
         'xlsxNamedRanges': json['xlsx_named_ranges'] == null ? undefined : json['xlsx_named_ranges'],
@@ -83,6 +86,9 @@ function DocumentVersionMetadataUpdateToJSONTyped(value, ignoreDiscriminator = f
         'total_pages': value['totalPages'],
         'total_sections': value['totalSections'],
         'total_chunks': value['totalChunks'],
+        'duration_ms': value['durationMs'],
+        'language': value['language'],
+        'segment_count': value['segmentCount'],
         'total_formulas': value['totalFormulas'],
         'xlsx_parse_result_s3': value['xlsxParseResultS3'],
         'xlsx_named_ranges': value['xlsxNamedRanges'],

package/dist/models/ErrorResponse.d.ts

@@ -40,6 +40,7 @@ export interface ErrorResponse {
 export declare const ErrorResponseCodeEnum: {
     readonly Error: 'error';
     readonly BadRequest: 'bad_request';
+    readonly PermissionLimit: 'permission_limit';
     readonly Unauthorized: 'unauthorized';
     readonly Forbidden: 'forbidden';
     readonly NotFound: 'not_found';

package/dist/models/ErrorResponse.js

@@ -25,6 +25,7 @@ exports.ErrorResponseToJSONTyped = ErrorResponseToJSONTyped;
 exports.ErrorResponseCodeEnum = {
     Error: 'error',
     BadRequest: 'bad_request',
+    PermissionLimit: 'permission_limit',
     Unauthorized: 'unauthorized',
     Forbidden: 'forbidden',
     NotFound: 'not_found',

package/dist/models/index.d.ts

@@ -17,10 +17,22 @@ export * from './AskResponse';
 export * from './BlockChangeType';
 export * from './BlockKind';
 export * from './BrandingLogoType';
+export * from './BulkDeleteRequest';
 export * from './BulkDownloadRequest';
+export * from './BulkFailureReason';
+export * from './BulkGrantItem';
+export * from './BulkGrantItemFailure';
+export * from './BulkGrantRequest';
+export * from './BulkGrantResponse';
+export * from './BulkGrantSuccess';
+export * from './BulkItemFailure';
 export * from './BulkModelTablesRequest';
 export * from './BulkModelTablesResponse';
+export * from './BulkMoveRequest';
+export * from './BulkOperationResponse';
+export * from './BulkRevokeRequest';
 export * from './BulkTagRequest';
+export * from './BulkTrashRequest';
 export * from './CatalogColumnResponse';
 export * from './CatalogTableResponse';
 export * from './CellChange';

package/dist/models/index.js

@@ -35,10 +35,22 @@ __exportStar(require("./AskResponse"), exports);
 __exportStar(require("./BlockChangeType"), exports);
 __exportStar(require("./BlockKind"), exports);
 __exportStar(require("./BrandingLogoType"), exports);
+__exportStar(require("./BulkDeleteRequest"), exports);
 __exportStar(require("./BulkDownloadRequest"), exports);
+__exportStar(require("./BulkFailureReason"), exports);
+__exportStar(require("./BulkGrantItem"), exports);
+__exportStar(require("./BulkGrantItemFailure"), exports);
+__exportStar(require("./BulkGrantRequest"), exports);
+__exportStar(require("./BulkGrantResponse"), exports);
+__exportStar(require("./BulkGrantSuccess"), exports);
+__exportStar(require("./BulkItemFailure"), exports);
 __exportStar(require("./BulkModelTablesRequest"), exports);
 __exportStar(require("./BulkModelTablesResponse"), exports);
+__exportStar(require("./BulkMoveRequest"), exports);
+__exportStar(require("./BulkOperationResponse"), exports);
+__exportStar(require("./BulkRevokeRequest"), exports);
 __exportStar(require("./BulkTagRequest"), exports);
+__exportStar(require("./BulkTrashRequest"), exports);
 __exportStar(require("./CatalogColumnResponse"), exports);
 __exportStar(require("./CatalogTableResponse"), exports);
 __exportStar(require("./CellChange"), exports);