@knowledge-stack/ksapi 1.152.0 → 1.154.1

package/dist/esm/models/CreateUploadResponse.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 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.
+ */
+/**
+ * Handles for a started resumable upload.
+ * @export
+ * @interface CreateUploadResponse
+ */
+export interface CreateUploadResponse {
+    /**
+     *
+     * @type {string}
+     * @memberof CreateUploadResponse
+     */
+    documentId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof CreateUploadResponse
+     */
+    documentVersionId: string;
+    /**
+     * Opaque token; return it on every part/status/complete/abort
+     * @type {string}
+     * @memberof CreateUploadResponse
+     */
+    uploadToken: string;
+    /**
+     * Recommended part size in bytes; every part except the last must be at least 5 MiB
+     * @type {number}
+     * @memberof CreateUploadResponse
+     */
+    partSize: number;
+}
+export declare const CreateUploadResponsePropertyValidationAttributesMap: {
+    [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 CreateUploadResponse interface.
+ */
+export declare function instanceOfCreateUploadResponse(value: object): value is CreateUploadResponse;
+export declare function CreateUploadResponseFromJSON(json: any): CreateUploadResponse;
+export declare function CreateUploadResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): CreateUploadResponse;
+export declare function CreateUploadResponseToJSON(json: any): CreateUploadResponse;
+export declare function CreateUploadResponseToJSONTyped(value?: CreateUploadResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/CreateUploadResponse.js

@@ -0,0 +1,56 @@
+/* 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.
+ */
+export const CreateUploadResponsePropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the CreateUploadResponse interface.
+ */
+export function instanceOfCreateUploadResponse(value) {
+    if (!('documentId' in value) || value['documentId'] === undefined)
+        return false;
+    if (!('documentVersionId' in value) || value['documentVersionId'] === undefined)
+        return false;
+    if (!('uploadToken' in value) || value['uploadToken'] === undefined)
+        return false;
+    if (!('partSize' in value) || value['partSize'] === undefined)
+        return false;
+    return true;
+}
+export function CreateUploadResponseFromJSON(json) {
+    return CreateUploadResponseFromJSONTyped(json, false);
+}
+export function CreateUploadResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'documentId': json['document_id'],
+        'documentVersionId': json['document_version_id'],
+        'uploadToken': json['upload_token'],
+        'partSize': json['part_size'],
+    };
+}
+export function CreateUploadResponseToJSON(json) {
+    return CreateUploadResponseToJSONTyped(json, false);
+}
+export function CreateUploadResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'document_id': value['documentId'],
+        'document_version_id': value['documentVersionId'],
+        'upload_token': value['uploadToken'],
+        'part_size': value['partSize'],
+    };
+}

package/dist/esm/models/DocumentType.d.ts

@@ -24,6 +24,8 @@ export declare const DocumentType: {
     readonly Json: 'JSON';
     readonly Yaml: 'YAML';
     readonly Code: 'CODE';
+    readonly Audio: 'AUDIO';
+    readonly Video: 'VIDEO';
     readonly Unknown: 'UNKNOWN';
 };
 export type DocumentType = typeof DocumentType[keyof typeof DocumentType];

package/dist/esm/models/DocumentType.js

@@ -26,6 +26,8 @@ export const DocumentType = {
     Json: 'JSON',
     Yaml: 'YAML',
     Code: 'CODE',
+    Audio: 'AUDIO',
+    Video: 'VIDEO',
     Unknown: 'UNKNOWN'
 };
 export function instanceOfDocumentType(value) {

package/dist/esm/models/EnrichedCitation.d.ts

@@ -39,6 +39,18 @@ export interface EnrichedCitation {
      * @memberof EnrichedCitation
      */
     length: number;
+    /**
+     * Start time (ms) of the cited chunk in the source media, for AUDIO/VIDEO — lets the client deep-link playback to the moment. None for non-media chunks.
+     * @type {number}
+     * @memberof EnrichedCitation
+     */
+    startMs?: number | null;
+    /**
+     * End time (ms) of the cited chunk in the source media (AUDIO/VIDEO); None for non-media chunks.
+     * @type {number}
+     * @memberof EnrichedCitation
+     */
+    endMs?: number | null;
     /**
      *
      * @type {string}

package/dist/esm/models/EnrichedCitation.js

@@ -43,6 +43,8 @@ export function EnrichedCitationFromJSONTyped(json, ignoreDiscriminator) {
         'quote': json['quote'],
         'startChar': json['start_char'],
         'length': json['length'],
+        'startMs': json['start_ms'] == null ? undefined : json['start_ms'],
+        'endMs': json['end_ms'] == null ? undefined : json['end_ms'],
         'documentId': json['document_id'] == null ? undefined : json['document_id'],
         'documentVersionId': json['document_version_id'] == null ? undefined : json['document_version_id'],
         'documentName': json['document_name'] == null ? undefined : json['document_name'],
@@ -63,6 +65,8 @@ export function EnrichedCitationToJSONTyped(value, ignoreDiscriminator = false)
         'quote': value['quote'],
         'start_char': value['startChar'],
         'length': value['length'],
+        'start_ms': value['startMs'],
+        'end_ms': value['endMs'],
         'document_id': value['documentId'],
         'document_version_id': value['documentVersionId'],
         'document_name': value['documentName'],

package/dist/esm/models/IngestionMode.d.ts

@@ -17,6 +17,7 @@ export declare const IngestionMode: {
     readonly HighAccuracy: 'high_accuracy';
     readonly Standard: 'standard';
     readonly SingleChunk: 'single_chunk';
+    readonly Media: 'media';
 };
 export type IngestionMode = typeof IngestionMode[keyof typeof IngestionMode];
 export declare function instanceOfIngestionMode(value: any): boolean;

package/dist/esm/models/IngestionMode.js

@@ -18,7 +18,8 @@
 export const IngestionMode = {
     HighAccuracy: 'high_accuracy',
     Standard: 'standard',
-    SingleChunk: 'single_chunk'
+    SingleChunk: 'single_chunk',
+    Media: 'media'
 };
 export function instanceOfIngestionMode(value) {
     for (const key in IngestionMode) {

package/dist/esm/models/SubscriptionPlanResponse.d.ts

@@ -51,6 +51,12 @@ export interface SubscriptionPlanResponse {
      * @memberof SubscriptionPlanResponse
      */
     searches: number;
+    /**
+     * Per-period cap on transcribed media minutes (MEDIA_MINUTE).
+     * @type {number}
+     * @memberof SubscriptionPlanResponse
+     */
+    mediaMinutes: number;
     /**
      * Upper bound on num_seats accepted by the upgrade endpoint. Admin PATCH may set tenant.seats above this value.
      * @type {number}

package/dist/esm/models/SubscriptionPlanResponse.js

@@ -26,6 +26,8 @@ export function instanceOfSubscriptionPlanResponse(value) {
         return false;
     if (!('searches' in value) || value['searches'] === undefined)
         return false;
+    if (!('mediaMinutes' in value) || value['mediaMinutes'] === undefined)
+        return false;
     if (!('maxSeats' in value) || value['maxSeats'] === undefined)
         return false;
     if (!('_public' in value) || value['_public'] === undefined)
@@ -49,6 +51,7 @@ export function SubscriptionPlanResponseFromJSONTyped(json, ignoreDiscriminator)
         'ingestedPages': json['ingested_pages'],
         'messages': json['messages'],
         'searches': json['searches'],
+        'mediaMinutes': json['media_minutes'],
         'maxSeats': json['max_seats'],
         '_public': json['public'],
         'createdAt': (new Date(json['created_at'])),
@@ -68,6 +71,7 @@ export function SubscriptionPlanResponseToJSONTyped(value, ignoreDiscriminator =
         'ingested_pages': value['ingestedPages'],
         'messages': value['messages'],
         'searches': value['searches'],
+        'media_minutes': value['mediaMinutes'],
         'max_seats': value['maxSeats'],
         'public': value['_public'],
         'created_at': value['createdAt'].toISOString(),

package/dist/esm/models/UploadPartResponse.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.
+ */
+/**
+ * Acknowledgement of one stored part.
+ * @export
+ * @interface UploadPartResponse
+ */
+export interface UploadPartResponse {
+    /**
+     *
+     * @type {number}
+     * @memberof UploadPartResponse
+     */
+    partNumber: number;
+    /**
+     *
+     * @type {string}
+     * @memberof UploadPartResponse
+     */
+    etag: string;
+    /**
+     *
+     * @type {number}
+     * @memberof UploadPartResponse
+     */
+    size: number;
+}
+export declare const UploadPartResponsePropertyValidationAttributesMap: {
+    [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 UploadPartResponse interface.
+ */
+export declare function instanceOfUploadPartResponse(value: object): value is UploadPartResponse;
+export declare function UploadPartResponseFromJSON(json: any): UploadPartResponse;
+export declare function UploadPartResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): UploadPartResponse;
+export declare function UploadPartResponseToJSON(json: any): UploadPartResponse;
+export declare function UploadPartResponseToJSONTyped(value?: UploadPartResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/UploadPartResponse.js

@@ -0,0 +1,52 @@
+/* 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.
+ */
+export const UploadPartResponsePropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the UploadPartResponse interface.
+ */
+export function instanceOfUploadPartResponse(value) {
+    if (!('partNumber' in value) || value['partNumber'] === undefined)
+        return false;
+    if (!('etag' in value) || value['etag'] === undefined)
+        return false;
+    if (!('size' in value) || value['size'] === undefined)
+        return false;
+    return true;
+}
+export function UploadPartResponseFromJSON(json) {
+    return UploadPartResponseFromJSONTyped(json, false);
+}
+export function UploadPartResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'partNumber': json['part_number'],
+        'etag': json['etag'],
+        'size': json['size'],
+    };
+}
+export function UploadPartResponseToJSON(json) {
+    return UploadPartResponseToJSONTyped(json, false);
+}
+export function UploadPartResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'part_number': value['partNumber'],
+        'etag': value['etag'],
+        'size': value['size'],
+    };
+}

package/dist/esm/models/UploadStatusResponse.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 { UploadPartResponse } from './UploadPartResponse';
+/**
+ * Parts S3 already holds — resume by re-sending the rest.
+ * @export
+ * @interface UploadStatusResponse
+ */
+export interface UploadStatusResponse {
+    /**
+     *
+     * @type {Array<UploadPartResponse>}
+     * @memberof UploadStatusResponse
+     */
+    parts: Array<UploadPartResponse>;
+    /**
+     *
+     * @type {number}
+     * @memberof UploadStatusResponse
+     */
+    uploadedBytes: number;
+}
+export declare const UploadStatusResponsePropertyValidationAttributesMap: {
+    [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 UploadStatusResponse interface.
+ */
+export declare function instanceOfUploadStatusResponse(value: object): value is UploadStatusResponse;
+export declare function UploadStatusResponseFromJSON(json: any): UploadStatusResponse;
+export declare function UploadStatusResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): UploadStatusResponse;
+export declare function UploadStatusResponseToJSON(json: any): UploadStatusResponse;
+export declare function UploadStatusResponseToJSONTyped(value?: UploadStatusResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/UploadStatusResponse.js

@@ -0,0 +1,49 @@
+/* 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.
+ */
+import { UploadPartResponseFromJSON, UploadPartResponseToJSON, } from './UploadPartResponse';
+export const UploadStatusResponsePropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the UploadStatusResponse interface.
+ */
+export function instanceOfUploadStatusResponse(value) {
+    if (!('parts' in value) || value['parts'] === undefined)
+        return false;
+    if (!('uploadedBytes' in value) || value['uploadedBytes'] === undefined)
+        return false;
+    return true;
+}
+export function UploadStatusResponseFromJSON(json) {
+    return UploadStatusResponseFromJSONTyped(json, false);
+}
+export function UploadStatusResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'parts': (json['parts'].map(UploadPartResponseFromJSON)),
+        'uploadedBytes': json['uploaded_bytes'],
+    };
+}
+export function UploadStatusResponseToJSON(json) {
+    return UploadStatusResponseToJSONTyped(json, false);
+}
+export function UploadStatusResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'parts': (value['parts'].map(UploadPartResponseToJSON)),
+        'uploaded_bytes': value['uploadedBytes'],
+    };
+}

package/dist/esm/models/UsageMetric.d.ts

@@ -17,6 +17,7 @@ export declare const UsageMetric: {
     readonly Page: 'PAGE';
     readonly Search: 'SEARCH';
     readonly Message: 'MESSAGE';
+    readonly MediaMinute: 'MEDIA_MINUTE';
 };
 export type UsageMetric = typeof UsageMetric[keyof typeof UsageMetric];
 export declare function instanceOfUsageMetric(value: any): boolean;

package/dist/esm/models/UsageMetric.js

@@ -18,7 +18,8 @@
 export const UsageMetric = {
     Page: 'PAGE',
     Search: 'SEARCH',
-    Message: 'MESSAGE'
+    Message: 'MESSAGE',
+    MediaMinute: 'MEDIA_MINUTE'
 };
 export function instanceOfUsageMetric(value) {
     for (const key in UsageMetric) {

package/dist/esm/models/index.d.ts

@@ -47,6 +47,7 @@ export * from './CloneWorkflowRunRequest';
 export * from './ColumnConfig';
 export * from './ColumnReference';
 export * from './CommonFileExclusionReason';
+export * from './CompleteUploadRequest';
 export * from './ConnectionConfig';
 export * from './ContentsSortOrder';
 export * from './CreateApiConnectionRequest';
@@ -67,6 +68,8 @@ export * from './CreateSkillRequest';
 export * from './CreateTagRequest';
 export * from './CreateThreadMessageRequest';
 export * from './CreateThreadRequest';
+export * from './CreateUploadRequest';
+export * from './CreateUploadResponse';
 export * from './CreateWorkflowDefinitionRequest';
 export * from './DataSourceCatalogResponse';
 export * from './DataSourceDescribeResponse';
@@ -328,6 +331,8 @@ export * from './UpdateWorkflowDefinitionRequest';
 export * from './UpdateWorkflowRunRequest';
 export * from './UploadConstraints';
 export * from './UploadFormat';
+export * from './UploadPartResponse';
+export * from './UploadStatusResponse';
 export * from './UsageMetric';
 export * from './UserInfo';
 export * from './UserMessageRequest';

package/dist/esm/models/index.js

@@ -49,6 +49,7 @@ export * from './CloneWorkflowRunRequest';
 export * from './ColumnConfig';
 export * from './ColumnReference';
 export * from './CommonFileExclusionReason';
+export * from './CompleteUploadRequest';
 export * from './ConnectionConfig';
 export * from './ContentsSortOrder';
 export * from './CreateApiConnectionRequest';
@@ -69,6 +70,8 @@ export * from './CreateSkillRequest';
 export * from './CreateTagRequest';
 export * from './CreateThreadMessageRequest';
 export * from './CreateThreadRequest';
+export * from './CreateUploadRequest';
+export * from './CreateUploadResponse';
 export * from './CreateWorkflowDefinitionRequest';
 export * from './DataSourceCatalogResponse';
 export * from './DataSourceDescribeResponse';
@@ -330,6 +333,8 @@ export * from './UpdateWorkflowDefinitionRequest';
 export * from './UpdateWorkflowRunRequest';
 export * from './UploadConstraints';
 export * from './UploadFormat';
+export * from './UploadPartResponse';
+export * from './UploadStatusResponse';
 export * from './UsageMetric';
 export * from './UserInfo';
 export * from './UserMessageRequest';

package/dist/models/ChunkMetadata.d.ts

@@ -53,6 +53,18 @@ export interface ChunkMetadata {
      * @memberof ChunkMetadata
      */
     secondaryTaxonomy?: ImageTaxonomy;
+    /**
+     * Start time of this chunk in the source media (ms from start).
+     * @type {number}
+     * @memberof ChunkMetadata
+     */
+    startMs?: number | null;
+    /**
+     * End time of this chunk in the source media (ms from start).
+     * @type {number}
+     * @memberof ChunkMetadata
+     */
+    endMs?: number | null;
     /**
      * Worksheet name this chunk was extracted from (XLSX only)
      * @type {string}

package/dist/models/ChunkMetadata.js

@@ -42,6 +42,8 @@ function ChunkMetadataFromJSONTyped(json, ignoreDiscriminator) {
         'summarizeForEmbedding': json['summarize_for_embedding'] == null ? undefined : json['summarize_for_embedding'],
         'extractedTextS3Uri': json['extracted_text_s3_uri'] == null ? undefined : json['extracted_text_s3_uri'],
         'secondaryTaxonomy': json['secondary_taxonomy'] == null ? undefined : (0, ImageTaxonomy_1.ImageTaxonomyFromJSON)(json['secondary_taxonomy']),
+        'startMs': json['start_ms'] == null ? undefined : json['start_ms'],
+        'endMs': json['end_ms'] == null ? undefined : json['end_ms'],
         'sheetName': json['sheet_name'] == null ? undefined : json['sheet_name'],
         'blockType': json['block_type'] == null ? undefined : json['block_type'],
         'sourceUri': json['source_uri'] == null ? undefined : json['source_uri'],
@@ -67,6 +69,8 @@ function ChunkMetadataToJSONTyped(value, ignoreDiscriminator = false) {
         'summarize_for_embedding': value['summarizeForEmbedding'],
         'extracted_text_s3_uri': value['extractedTextS3Uri'],
         'secondary_taxonomy': (0, ImageTaxonomy_1.ImageTaxonomyToJSON)(value['secondaryTaxonomy']),
+        'start_ms': value['startMs'],
+        'end_ms': value['endMs'],
         'sheet_name': value['sheetName'],
         'block_type': value['blockType'],
         'source_uri': value['sourceUri'],

package/dist/models/Citation.d.ts

@@ -39,6 +39,18 @@ export interface Citation {
      * @memberof Citation
      */
     length: number;
+    /**
+     * Start time (ms) of the cited chunk in the source media, for AUDIO/VIDEO — lets the client deep-link playback to the moment. None for non-media chunks.
+     * @type {number}
+     * @memberof Citation
+     */
+    startMs?: number | null;
+    /**
+     * End time (ms) of the cited chunk in the source media (AUDIO/VIDEO); None for non-media chunks.
+     * @type {number}
+     * @memberof Citation
+     */
+    endMs?: number | null;
 }
 export declare const CitationPropertyValidationAttributesMap: {
     [property: string]: {

package/dist/models/Citation.js

@@ -51,6 +51,8 @@ function CitationFromJSONTyped(json, ignoreDiscriminator) {
         'quote': json['quote'],
         'startChar': json['start_char'],
         'length': json['length'],
+        'startMs': json['start_ms'] == null ? undefined : json['start_ms'],
+        'endMs': json['end_ms'] == null ? undefined : json['end_ms'],
     };
 }
 function CitationToJSON(json) {
@@ -65,5 +67,7 @@ function CitationToJSONTyped(value, ignoreDiscriminator = false) {
         'quote': value['quote'],
         'start_char': value['startChar'],
         'length': value['length'],
+        'start_ms': value['startMs'],
+        'end_ms': value['endMs'],
     };
 }