@knowledge-stack/ksapi 1.152.0 → 1.154.1

package/dist/esm/apis/DocumentsApi.js

@@ -21,11 +21,109 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
-import { CreateDocumentRequestToJSON, DocumentDownloadResponseFromJSON, DocumentResponseFromJSON, IngestDocumentResponseFromJSON, IngestZipResponseFromJSON, PaginatedResponseDocumentResponseFromJSON, UpdateDocumentRequestToJSON, } from '../models/index';
+import { CompleteUploadRequestToJSON, CreateDocumentRequestToJSON, CreateUploadRequestToJSON, CreateUploadResponseFromJSON, DocumentDownloadResponseFromJSON, DocumentResponseFromJSON, IngestDocumentResponseFromJSON, IngestZipResponseFromJSON, PaginatedResponseDocumentResponseFromJSON, UpdateDocumentRequestToJSON, UploadPartResponseFromJSON, UploadStatusResponseFromJSON, } from '../models/index';
 /**
  *
  */
 export class DocumentsApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for abortDocumentUpload without sending the request
+     */
+    abortDocumentUploadRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['xUploadToken'] == null) {
+                throw new runtime.RequiredError('xUploadToken', 'Required parameter "xUploadToken" was null or undefined when calling abortDocumentUpload().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (requestParameters['xUploadToken'] != null) {
+                headerParameters['X-Upload-Token'] = String(requestParameters['xUploadToken']);
+            }
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/v1/documents/uploads`;
+            return {
+                path: urlPath,
+                method: 'DELETE',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Discard an in-progress resumable upload and its parts.
+     * Abort Document Upload Handler
+     */
+    abortDocumentUploadRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.abortDocumentUploadRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.VoidApiResponse(response);
+        });
+    }
+    /**
+     * Discard an in-progress resumable upload and its parts.
+     * Abort Document Upload Handler
+     */
+    abortDocumentUpload(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.abortDocumentUploadRaw(requestParameters, initOverrides);
+        });
+    }
+    /**
+     * Creates request options for completeDocumentUpload without sending the request
+     */
+    completeDocumentUploadRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['completeUploadRequest'] == null) {
+                throw new runtime.RequiredError('completeUploadRequest', 'Required parameter "completeUploadRequest" was null or undefined when calling completeDocumentUpload().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/v1/documents/uploads/complete`;
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: CompleteUploadRequestToJSON(requestParameters['completeUploadRequest']),
+            };
+        });
+    }
+    /**
+     * Assemble the uploaded parts, create the document, and start ingestion.
+     * Complete Document Upload Handler
+     */
+    completeDocumentUploadRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.completeDocumentUploadRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => IngestDocumentResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Assemble the uploaded parts, create the document, and start ingestion.
+     * Complete Document Upload Handler
+     */
+    completeDocumentUpload(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.completeDocumentUploadRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for createDocument without sending the request
      */
@@ -75,6 +173,55 @@ export class DocumentsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for createDocumentUpload without sending the request
+     */
+    createDocumentUploadRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['createUploadRequest'] == null) {
+                throw new runtime.RequiredError('createUploadRequest', 'Required parameter "createUploadRequest" was null or undefined when calling createDocumentUpload().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/v1/documents/uploads`;
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: CreateUploadRequestToJSON(requestParameters['createUploadRequest']),
+            };
+        });
+    }
+    /**
+     * Begin a resumable multipart upload for a large file (audio/video/…).  Returns an opaque ``upload_token``. Stream the file as parts to ``PUT /v1/documents/uploads/parts/{part_number}`` (every part except the last at least 5 MiB), then ``POST /v1/documents/uploads/complete``. A dropped part is re-sent alone — ``GET /v1/documents/uploads/parts`` reports what landed.
+     * Create Document Upload Handler
+     */
+    createDocumentUploadRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.createDocumentUploadRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => CreateUploadResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Begin a resumable multipart upload for a large file (audio/video/…).  Returns an opaque ``upload_token``. Stream the file as parts to ``PUT /v1/documents/uploads/parts/{part_number}`` (every part except the last at least 5 MiB), then ``POST /v1/documents/uploads/complete``. A dropped part is re-sent alone — ``GET /v1/documents/uploads/parts`` reports what landed.
+     * Create Document Upload Handler
+     */
+    createDocumentUpload(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.createDocumentUploadRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for deleteDocument without sending the request
      */
@@ -222,6 +369,56 @@ export class DocumentsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for getDocumentUploadStatus without sending the request
+     */
+    getDocumentUploadStatusRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['xUploadToken'] == null) {
+                throw new runtime.RequiredError('xUploadToken', 'Required parameter "xUploadToken" was null or undefined when calling getDocumentUploadStatus().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            if (requestParameters['xUploadToken'] != null) {
+                headerParameters['X-Upload-Token'] = String(requestParameters['xUploadToken']);
+            }
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/v1/documents/uploads/parts`;
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Report which parts S3 already holds so the client resumes the rest.
+     * Get Document Upload Status Handler
+     */
+    getDocumentUploadStatusRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.getDocumentUploadStatusRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => UploadStatusResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Report which parts S3 already holds so the client resumes the rest.
+     * Get Document Upload Status Handler
+     */
+    getDocumentUploadStatus(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getDocumentUploadStatusRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for ingestDocument without sending the request
      */
@@ -266,6 +463,12 @@ export class DocumentsApi extends runtime.BaseAPI {
             if (requestParameters['name'] != null) {
                 formParams.append('name', requestParameters['name']);
             }
+            if (requestParameters['tagIds'] != null) {
+                formParams.append('tag_ids', requestParameters['tagIds'].join(runtime.COLLECTION_FORMATS["csv"]));
+            }
+            if (requestParameters['idempotencyKey'] != null) {
+                formParams.append('idempotency_key', requestParameters['idempotencyKey']);
+            }
             if (requestParameters['ingestionMode'] != null) {
                 formParams.append('ingestion_mode', requestParameters['ingestionMode']);
             }
@@ -281,12 +484,6 @@ export class DocumentsApi extends runtime.BaseAPI {
             if (requestParameters['workflowRunId'] != null) {
                 formParams.append('workflow_run_id', requestParameters['workflowRunId']);
             }
-            if (requestParameters['tagIds'] != null) {
-                formParams.append('tag_ids', requestParameters['tagIds'].join(runtime.COLLECTION_FORMATS["csv"]));
-            }
-            if (requestParameters['idempotencyKey'] != null) {
-                formParams.append('idempotency_key', requestParameters['idempotencyKey']);
-            }
             if (requestParameters['workflowDefinitionId'] != null) {
                 formParams.append('workflow_definition_id', requestParameters['workflowDefinitionId']);
             }
@@ -620,4 +817,63 @@ export class DocumentsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for uploadDocumentPart without sending the request
+     */
+    uploadDocumentPartRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['partNumber'] == null) {
+                throw new runtime.RequiredError('partNumber', 'Required parameter "partNumber" was null or undefined when calling uploadDocumentPart().');
+            }
+            if (requestParameters['xUploadToken'] == null) {
+                throw new runtime.RequiredError('xUploadToken', 'Required parameter "xUploadToken" was null or undefined when calling uploadDocumentPart().');
+            }
+            if (requestParameters['body'] == null) {
+                throw new runtime.RequiredError('body', 'Required parameter "body" was null or undefined when calling uploadDocumentPart().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/octet-stream';
+            if (requestParameters['xUploadToken'] != null) {
+                headerParameters['X-Upload-Token'] = String(requestParameters['xUploadToken']);
+            }
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/v1/documents/uploads/parts/{part_number}`;
+            urlPath = urlPath.replace(`{${"part_number"}}`, encodeURIComponent(String(requestParameters['partNumber'])));
+            return {
+                path: urlPath,
+                method: 'PUT',
+                headers: headerParameters,
+                query: queryParameters,
+                body: requestParameters['body'],
+            };
+        });
+    }
+    /**
+     * Upload one part (raw octet-stream body) of a resumable upload.
+     * Upload Document Part Handler
+     */
+    uploadDocumentPartRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.uploadDocumentPartRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => UploadPartResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Upload one part (raw octet-stream body) of a resumable upload.
+     * Upload Document Part Handler
+     */
+    uploadDocumentPart(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.uploadDocumentPartRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
 }

package/dist/esm/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/esm/models/ChunkMetadata.js

@@ -34,6 +34,8 @@ export 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 : 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'],
@@ -59,6 +61,8 @@ export function ChunkMetadataToJSONTyped(value, ignoreDiscriminator = false) {
         'summarize_for_embedding': value['summarizeForEmbedding'],
         'extracted_text_s3_uri': value['extractedTextS3Uri'],
         'secondary_taxonomy': 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/esm/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/esm/models/Citation.js

@@ -43,6 +43,8 @@ export 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'],
     };
 }
 export function CitationToJSON(json) {
@@ -57,5 +59,7 @@ export function CitationToJSONTyped(value, ignoreDiscriminator = false) {
         'quote': value['quote'],
         'start_char': value['startChar'],
         'length': value['length'],
+        'start_ms': value['startMs'],
+        'end_ms': value['endMs'],
     };
 }

package/dist/esm/models/CompleteUploadRequest.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.
+ */
+/**
+ * Finalize a resumable upload and start ingestion.
+ * @export
+ * @interface CompleteUploadRequest
+ */
+export interface CompleteUploadRequest {
+    /**
+     * Token from create-upload
+     * @type {string}
+     * @memberof CompleteUploadRequest
+     */
+    uploadToken: string;
+}
+export declare const CompleteUploadRequestPropertyValidationAttributesMap: {
+    [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 CompleteUploadRequest interface.
+ */
+export declare function instanceOfCompleteUploadRequest(value: object): value is CompleteUploadRequest;
+export declare function CompleteUploadRequestFromJSON(json: any): CompleteUploadRequest;
+export declare function CompleteUploadRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): CompleteUploadRequest;
+export declare function CompleteUploadRequestToJSON(json: any): CompleteUploadRequest;
+export declare function CompleteUploadRequestToJSONTyped(value?: CompleteUploadRequest | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/CompleteUploadRequest.js

@@ -0,0 +1,44 @@
+/* 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 CompleteUploadRequestPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the CompleteUploadRequest interface.
+ */
+export function instanceOfCompleteUploadRequest(value) {
+    if (!('uploadToken' in value) || value['uploadToken'] === undefined)
+        return false;
+    return true;
+}
+export function CompleteUploadRequestFromJSON(json) {
+    return CompleteUploadRequestFromJSONTyped(json, false);
+}
+export function CompleteUploadRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'uploadToken': json['upload_token'],
+    };
+}
+export function CompleteUploadRequestToJSON(json) {
+    return CompleteUploadRequestToJSONTyped(json, false);
+}
+export function CompleteUploadRequestToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'upload_token': value['uploadToken'],
+    };
+}

package/dist/esm/models/CreateUploadRequest.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.
+ */
+/**
+ * Begin a resumable upload.
+ * @export
+ * @interface CreateUploadRequest
+ */
+export interface CreateUploadRequest {
+    /**
+     * Parent folder path part ID (FOLDER)
+     * @type {string}
+     * @memberof CreateUploadRequest
+     */
+    parentPathId: string;
+    /**
+     * Document name
+     * @type {string}
+     * @memberof CreateUploadRequest
+     */
+    name: string;
+    /**
+     * Original filename; its extension selects the type + size cap
+     * @type {string}
+     * @memberof CreateUploadRequest
+     */
+    filename: string;
+    /**
+     * Declared total size; fast-rejected against the type cap
+     * @type {number}
+     * @memberof CreateUploadRequest
+     */
+    sizeBytes: number;
+}
+export declare const CreateUploadRequestPropertyValidationAttributesMap: {
+    [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 CreateUploadRequest interface.
+ */
+export declare function instanceOfCreateUploadRequest(value: object): value is CreateUploadRequest;
+export declare function CreateUploadRequestFromJSON(json: any): CreateUploadRequest;
+export declare function CreateUploadRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): CreateUploadRequest;
+export declare function CreateUploadRequestToJSON(json: any): CreateUploadRequest;
+export declare function CreateUploadRequestToJSONTyped(value?: CreateUploadRequest | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/CreateUploadRequest.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 CreateUploadRequestPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the CreateUploadRequest interface.
+ */
+export function instanceOfCreateUploadRequest(value) {
+    if (!('parentPathId' in value) || value['parentPathId'] === undefined)
+        return false;
+    if (!('name' in value) || value['name'] === undefined)
+        return false;
+    if (!('filename' in value) || value['filename'] === undefined)
+        return false;
+    if (!('sizeBytes' in value) || value['sizeBytes'] === undefined)
+        return false;
+    return true;
+}
+export function CreateUploadRequestFromJSON(json) {
+    return CreateUploadRequestFromJSONTyped(json, false);
+}
+export function CreateUploadRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'parentPathId': json['parent_path_id'],
+        'name': json['name'],
+        'filename': json['filename'],
+        'sizeBytes': json['size_bytes'],
+    };
+}
+export function CreateUploadRequestToJSON(json) {
+    return CreateUploadRequestToJSONTyped(json, false);
+}
+export function CreateUploadRequestToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'parent_path_id': value['parentPathId'],
+        'name': value['name'],
+        'filename': value['filename'],
+        'size_bytes': value['sizeBytes'],
+    };
+}