@knowledge-stack/ksapi 1.23.5 → 1.25.0

package/dist/apis/ChunksApi.js

@@ -30,10 +30,9 @@ const index_1 = require("../models/index");
  */
 class ChunksApi extends runtime.BaseAPI {
     /**
-     * Create a new chunk with content.  The chunk is created as a child of the specified parent (must be DOCUMENT_VERSION or SECTION). Content is deduplicated by SHA256 hash.
-     * Create Chunk Handler
+     * Creates request options for createChunk without sending the request
      */
-    createChunkRaw(requestParameters, initOverrides) {
+    createChunkRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['createChunkRequest'] == null) {
                 throw new runtime.RequiredError('createChunkRequest', 'Required parameter "createChunkRequest" was null or undefined when calling createChunk().');
@@ -42,13 +41,23 @@ class ChunksApi extends runtime.BaseAPI {
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
             let urlPath = `/v1/chunks`;
-            const response = yield this.request({
+            return {
                 path: urlPath,
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
                 body: (0, index_1.CreateChunkRequestToJSON)(requestParameters['createChunkRequest']),
-            }, initOverrides);
+            };
+        });
+    }
+    /**
+     * Create a new chunk with content.  The chunk is created as a child of the specified parent (must be DOCUMENT_VERSION or SECTION). Content is deduplicated by SHA256 hash.
+     * Create Chunk Handler
+     */
+    createChunkRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.createChunkRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
             return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.ChunkResponseFromJSON)(jsonValue));
         });
     }
@@ -63,10 +72,9 @@ class ChunksApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Delete a chunk.  The chunk is deleted via its PathPart (cascading delete). The associated ChunkContent may remain if shared by other chunks.
-     * Delete Chunk Handler
+     * Creates request options for deleteChunk without sending the request
      */
-    deleteChunkRaw(requestParameters, initOverrides) {
+    deleteChunkRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['chunkId'] == null) {
                 throw new runtime.RequiredError('chunkId', 'Required parameter "chunkId" was null or undefined when calling deleteChunk().');
@@ -75,12 +83,22 @@ class ChunksApi extends runtime.BaseAPI {
             const headerParameters = {};
             let urlPath = `/v1/chunks/{chunk_id}`;
             urlPath = urlPath.replace(`{${"chunk_id"}}`, encodeURIComponent(String(requestParameters['chunkId'])));
-            const response = yield this.request({
+            return {
                 path: urlPath,
                 method: 'DELETE',
                 headers: headerParameters,
                 query: queryParameters,
-            }, initOverrides);
+            };
+        });
+    }
+    /**
+     * Delete a chunk.  The chunk is deleted via its PathPart (cascading delete). The associated ChunkContent may remain if shared by other chunks.
+     * Delete Chunk Handler
+     */
+    deleteChunkRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.deleteChunkRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
             return new runtime.VoidApiResponse(response);
         });
     }
@@ -94,10 +112,9 @@ class ChunksApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Get a chunk by its ID, including content.
-     * Get Chunk Handler
+     * Creates request options for getChunk without sending the request
      */
-    getChunkRaw(requestParameters, initOverrides) {
+    getChunkRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['chunkId'] == null) {
                 throw new runtime.RequiredError('chunkId', 'Required parameter "chunkId" was null or undefined when calling getChunk().');
@@ -106,12 +123,22 @@ class ChunksApi extends runtime.BaseAPI {
             const headerParameters = {};
             let urlPath = `/v1/chunks/{chunk_id}`;
             urlPath = urlPath.replace(`{${"chunk_id"}}`, encodeURIComponent(String(requestParameters['chunkId'])));
-            const response = yield this.request({
+            return {
                 path: urlPath,
                 method: 'GET',
                 headers: headerParameters,
                 query: queryParameters,
-            }, initOverrides);
+            };
+        });
+    }
+    /**
+     * Get a chunk by its ID, including content.
+     * Get Chunk Handler
+     */
+    getChunkRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.getChunkRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
             return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.ChunkResponseFromJSON)(jsonValue));
         });
     }
@@ -126,10 +153,92 @@ class ChunksApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Semantic search over chunks using vector similarity.  Combines pgvector cosine similarity with path-based authorization and optional metadata filters. Uses a two-session design to avoid holding a DB connection during the external embedding API call.
-     * Search Chunks Handler
+     * Creates request options for getChunksBulk without sending the request
      */
-    searchChunksRaw(requestParameters, initOverrides) {
+    getChunksBulkRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const queryParameters = {};
+            if (requestParameters['chunkIds'] != null) {
+                queryParameters['chunk_ids'] = requestParameters['chunkIds'];
+            }
+            const headerParameters = {};
+            let urlPath = `/v1/chunks/bulk`;
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Batch-fetch chunks with their full ancestor path part IDs.  Returns standard chunk data plus path_part_id_segments (the ordered ancestor chain from root to chunk) for each requested chunk. Non-existent IDs are silently skipped. Limited to 200 IDs per call.
+     * Get Chunks Bulk Handler
+     */
+    getChunksBulkRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.getChunksBulkRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(index_1.ChunkBulkResponseFromJSON));
+        });
+    }
+    /**
+     * Batch-fetch chunks with their full ancestor path part IDs.  Returns standard chunk data plus path_part_id_segments (the ordered ancestor chain from root to chunk) for each requested chunk. Non-existent IDs are silently skipped. Limited to 200 IDs per call.
+     * Get Chunks Bulk Handler
+     */
+    getChunksBulk() {
+        return __awaiter(this, arguments, void 0, function* (requestParameters = {}, initOverrides) {
+            const response = yield this.getChunksBulkRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for getVersionChunkIds without sending the request
+     */
+    getVersionChunkIdsRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['documentVersionId'] == null) {
+                throw new runtime.RequiredError('documentVersionId', 'Required parameter "documentVersionId" was null or undefined when calling getVersionChunkIds().');
+            }
+            const queryParameters = {};
+            if (requestParameters['documentVersionId'] != null) {
+                queryParameters['document_version_id'] = requestParameters['documentVersionId'];
+            }
+            const headerParameters = {};
+            let urlPath = `/v1/chunks/version-chunk-ids`;
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Get all chunk IDs belonging to a document version.  Used by the embedding pipeline to discover chunks for a version.
+     * Get Version Chunk Ids Handler
+     */
+    getVersionChunkIdsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.getVersionChunkIdsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.VersionChunkIdsResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Get all chunk IDs belonging to a document version.  Used by the embedding pipeline to discover chunks for a version.
+     * Get Version Chunk Ids Handler
+     */
+    getVersionChunkIds(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getVersionChunkIdsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for searchChunks without sending the request
+     */
+    searchChunksRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['chunkSearchRequest'] == null) {
                 throw new runtime.RequiredError('chunkSearchRequest', 'Required parameter "chunkSearchRequest" was null or undefined when calling searchChunks().');
@@ -138,18 +247,28 @@ class ChunksApi extends runtime.BaseAPI {
             const headerParameters = {};
             headerParameters['Content-Type'] = 'application/json';
             let urlPath = `/v1/chunks/search`;
-            const response = yield this.request({
+            return {
                 path: urlPath,
                 method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
                 body: (0, index_1.ChunkSearchRequestToJSON)(requestParameters['chunkSearchRequest']),
-            }, initOverrides);
+            };
+        });
+    }
+    /**
+     * Semantic search over chunks using Qdrant vector similarity.  Combines vector similarity with path-based authorization and optional metadata filters. Uses Qdrant for vector search and hydrates results from Postgres.
+     * Search Chunks Handler
+     */
+    searchChunksRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.searchChunksRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
             return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(index_1.ScoredChunkResponseFromJSON));
         });
     }
     /**
-     * Semantic search over chunks using vector similarity.  Combines pgvector cosine similarity with path-based authorization and optional metadata filters. Uses a two-session design to avoid holding a DB connection during the external embedding API call.
+     * Semantic search over chunks using Qdrant vector similarity.  Combines vector similarity with path-based authorization and optional metadata filters. Uses Qdrant for vector search and hydrates results from Postgres.
      * Search Chunks Handler
      */
     searchChunks(requestParameters, initOverrides) {
@@ -159,10 +278,9 @@ class ChunksApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Update chunk content by creating a new content row.  The old content row is preserved (not deleted). If the new content matches an existing content hash, it will be deduplicated.
-     * Update Chunk Content Handler
+     * Creates request options for updateChunkContent without sending the request
      */
-    updateChunkContentRaw(requestParameters, initOverrides) {
+    updateChunkContentRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['chunkId'] == null) {
                 throw new runtime.RequiredError('chunkId', 'Required parameter "chunkId" was null or undefined when calling updateChunkContent().');
@@ -175,13 +293,23 @@ class ChunksApi extends runtime.BaseAPI {
             headerParameters['Content-Type'] = 'application/json';
             let urlPath = `/v1/chunks/{chunk_id}/content`;
             urlPath = urlPath.replace(`{${"chunk_id"}}`, encodeURIComponent(String(requestParameters['chunkId'])));
-            const response = yield this.request({
+            return {
                 path: urlPath,
                 method: 'PATCH',
                 headers: headerParameters,
                 query: queryParameters,
                 body: (0, index_1.UpdateChunkContentRequestToJSON)(requestParameters['updateChunkContentRequest']),
-            }, initOverrides);
+            };
+        });
+    }
+    /**
+     * Update chunk content by creating a new content row.  The old content row is preserved (not deleted). If the new content matches an existing content hash, it will be deduplicated.
+     * Update Chunk Content Handler
+     */
+    updateChunkContentRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.updateChunkContentRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
             return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.ChunkResponseFromJSON)(jsonValue));
         });
     }
@@ -196,10 +324,9 @@ class ChunksApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Update chunk metadata by merging with existing metadata.  The provided metadata is shallow-merged into the existing chunk_metadata.
-     * Update Chunk Metadata Handler
+     * Creates request options for updateChunkMetadata without sending the request
      */
-    updateChunkMetadataRaw(requestParameters, initOverrides) {
+    updateChunkMetadataRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['chunkId'] == null) {
                 throw new runtime.RequiredError('chunkId', 'Required parameter "chunkId" was null or undefined when calling updateChunkMetadata().');
@@ -212,13 +339,23 @@ class ChunksApi extends runtime.BaseAPI {
             headerParameters['Content-Type'] = 'application/json';
             let urlPath = `/v1/chunks/{chunk_id}`;
             urlPath = urlPath.replace(`{${"chunk_id"}}`, encodeURIComponent(String(requestParameters['chunkId'])));
-            const response = yield this.request({
+            return {
                 path: urlPath,
                 method: 'PATCH',
                 headers: headerParameters,
                 query: queryParameters,
                 body: (0, index_1.UpdateChunkMetadataRequestToJSON)(requestParameters['updateChunkMetadataRequest']),
-            }, initOverrides);
+            };
+        });
+    }
+    /**
+     * Update chunk metadata by merging with existing metadata.  The provided metadata is shallow-merged into the existing chunk_metadata.
+     * Update Chunk Metadata Handler
+     */
+    updateChunkMetadataRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.updateChunkMetadataRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
             return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.ChunkResponseFromJSON)(jsonValue));
         });
     }

package/dist/apis/DefaultApi.d.ts

@@ -18,6 +18,12 @@ import type { HealthCheckResponse, RootResponse } from '../models/index';
  * @interface DefaultApiInterface
  */
 export interface DefaultApiInterface {
+    /**
+     * Creates request options for healthCheck without sending the request
+     * @throws {RequiredError}
+     * @memberof DefaultApiInterface
+     */
+    healthCheckRequestOpts(): Promise<runtime.RequestOpts>;
     /**
      * Health check endpoint.
      * @summary Health Check Handler
@@ -31,6 +37,12 @@ export interface DefaultApiInterface {
      * Health Check Handler
      */
     healthCheck(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<HealthCheckResponse>;
+    /**
+     * Creates request options for hello without sending the request
+     * @throws {RequiredError}
+     * @memberof DefaultApiInterface
+     */
+    helloRequestOpts(): Promise<runtime.RequestOpts>;
     /**
      * Root endpoint.
      * @summary Root Handler
@@ -49,6 +61,10 @@ export interface DefaultApiInterface {
  *
  */
 export declare class DefaultApi extends runtime.BaseAPI implements DefaultApiInterface {
+    /**
+     * Creates request options for healthCheck without sending the request
+     */
+    healthCheckRequestOpts(): Promise<runtime.RequestOpts>;
     /**
      * Health check endpoint.
      * Health Check Handler
@@ -59,6 +75,10 @@ export declare class DefaultApi extends runtime.BaseAPI implements DefaultApiInt
      * Health Check Handler
      */
     healthCheck(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<HealthCheckResponse>;
+    /**
+     * Creates request options for hello without sending the request
+     */
+    helloRequestOpts(): Promise<runtime.RequestOpts>;
     /**
      * Root endpoint.
      * Root Handler

package/dist/apis/DefaultApi.js

@@ -30,20 +30,29 @@ const index_1 = require("../models/index");
  */
 class DefaultApi extends runtime.BaseAPI {
     /**
-     * Health check endpoint.
-     * Health Check Handler
+     * Creates request options for healthCheck without sending the request
      */
-    healthCheckRaw(initOverrides) {
+    healthCheckRequestOpts() {
         return __awaiter(this, void 0, void 0, function* () {
             const queryParameters = {};
             const headerParameters = {};
             let urlPath = `/healthz`;
-            const response = yield this.request({
+            return {
                 path: urlPath,
                 method: 'GET',
                 headers: headerParameters,
                 query: queryParameters,
-            }, initOverrides);
+            };
+        });
+    }
+    /**
+     * Health check endpoint.
+     * Health Check Handler
+     */
+    healthCheckRaw(initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.healthCheckRequestOpts();
+            const response = yield this.request(requestOptions, initOverrides);
             return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.HealthCheckResponseFromJSON)(jsonValue));
         });
     }
@@ -58,20 +67,29 @@ class DefaultApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Root endpoint.
-     * Root Handler
+     * Creates request options for hello without sending the request
      */
-    helloRaw(initOverrides) {
+    helloRequestOpts() {
         return __awaiter(this, void 0, void 0, function* () {
             const queryParameters = {};
             const headerParameters = {};
             let urlPath = `/`;
-            const response = yield this.request({
+            return {
                 path: urlPath,
                 method: 'GET',
                 headers: headerParameters,
                 query: queryParameters,
-            }, initOverrides);
+            };
+        });
+    }
+    /**
+     * Root endpoint.
+     * Root Handler
+     */
+    helloRaw(initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.helloRequestOpts();
+            const response = yield this.request(requestOptions, initOverrides);
             return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.RootResponseFromJSON)(jsonValue));
         });
     }

package/dist/apis/DocumentVersionsApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { ClearVersionContentsResponse, DocumentVersionMetadataUpdate, DocumentVersionResponse, PaginatedResponseDocumentContentPathPart, PaginatedResponseDocumentVersionResponse } from '../models/index';
+import type { ClearVersionContentsResponse, DocumentVersionMetadataUpdate, DocumentVersionResponse, PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator, PaginatedResponseDocumentVersionResponse } from '../models/index';
 export interface ClearDocumentVersionContentsRequest {
     versionId: string;
     ksUat?: string | null;
@@ -52,6 +52,14 @@ export interface UpdateDocumentVersionMetadataRequest {
  * @interface DocumentVersionsApiInterface
  */
 export interface DocumentVersionsApiInterface {
+    /**
+     * Creates request options for clearDocumentVersionContents without sending the request
+     * @param {string} versionId DocumentVersion ID
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof DocumentVersionsApiInterface
+     */
+    clearDocumentVersionContentsRequestOpts(requestParameters: ClearDocumentVersionContentsRequest): Promise<runtime.RequestOpts>;
     /**
      * Delete all sections and chunks under a document version.  Removes all content (sections and chunks) from the version while keeping the version itself intact. Used by the ingestion pipeline for idempotent re-processing.
      * @summary Clear Document Version Contents Handler
@@ -67,6 +75,14 @@ export interface DocumentVersionsApiInterface {
      * Clear Document Version Contents Handler
      */
     clearDocumentVersionContents(requestParameters: ClearDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ClearVersionContentsResponse>;
+    /**
+     * Creates request options for createDocumentVersion without sending the request
+     * @param {string} documentId Document ID
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof DocumentVersionsApiInterface
+     */
+    createDocumentVersionRequestOpts(requestParameters: CreateDocumentVersionRequest): Promise<runtime.RequestOpts>;
     /**
      * Create a new version for a document.  The version number is automatically incremented from the highest existing version.
      * @summary Create Document Version Handler
@@ -82,6 +98,14 @@ export interface DocumentVersionsApiInterface {
      * Create Document Version Handler
      */
     createDocumentVersion(requestParameters: CreateDocumentVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionResponse>;
+    /**
+     * Creates request options for deleteDocumentVersion without sending the request
+     * @param {string} versionId DocumentVersion ID
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof DocumentVersionsApiInterface
+     */
+    deleteDocumentVersionRequestOpts(requestParameters: DeleteDocumentVersionRequest): Promise<runtime.RequestOpts>;
     /**
      * Delete a document version by its ID.  Cannot delete the active version of a document.
      * @summary Delete Document Version Handler
@@ -97,6 +121,14 @@ export interface DocumentVersionsApiInterface {
      * Delete Document Version Handler
      */
     deleteDocumentVersion(requestParameters: DeleteDocumentVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Creates request options for getDocumentVersion without sending the request
+     * @param {string} versionId DocumentVersion ID
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof DocumentVersionsApiInterface
+     */
+    getDocumentVersionRequestOpts(requestParameters: GetDocumentVersionRequest): Promise<runtime.RequestOpts>;
     /**
      * Get a document version by its ID.
      * @summary Get Document Version Handler
@@ -113,7 +145,18 @@ export interface DocumentVersionsApiInterface {
      */
     getDocumentVersion(requestParameters: GetDocumentVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionResponse>;
     /**
-     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * Creates request options for getDocumentVersionContents without sending the request
+     * @param {string} versionId DocumentVersion ID
+     * @param {string} [sectionId] Optional section ID to scope traversal to a subtree
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof DocumentVersionsApiInterface
+     */
+    getDocumentVersionContentsRequestOpts(requestParameters: GetDocumentVersionContentsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").
      * @summary Get Document Version Contents Handler
      * @param {string} versionId DocumentVersion ID
      * @param {string} [sectionId] Optional section ID to scope traversal to a subtree
@@ -124,12 +167,22 @@ export interface DocumentVersionsApiInterface {
      * @throws {RequiredError}
      * @memberof DocumentVersionsApiInterface
      */
-    getDocumentVersionContentsRaw(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseDocumentContentPathPart>>;
+    getDocumentVersionContentsRaw(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator>>;
     /**
-     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").
      * Get Document Version Contents Handler
      */
-    getDocumentVersionContents(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseDocumentContentPathPart>;
+    getDocumentVersionContents(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator>;
+    /**
+     * Creates request options for listDocumentVersions without sending the request
+     * @param {string} documentId Document ID to list versions for
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof DocumentVersionsApiInterface
+     */
+    listDocumentVersionsRequestOpts(requestParameters: ListDocumentVersionsRequest): Promise<runtime.RequestOpts>;
     /**
      * List all versions for a document.  Returns versions ordered by version number ascending (v0, v1, v2...).
      * @summary List Document Versions Handler
@@ -147,6 +200,15 @@ export interface DocumentVersionsApiInterface {
      * List Document Versions Handler
      */
     listDocumentVersions(requestParameters: ListDocumentVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseDocumentVersionResponse>;
+    /**
+     * Creates request options for updateDocumentVersionMetadata without sending the request
+     * @param {string} versionId DocumentVersion ID
+     * @param {DocumentVersionMetadataUpdate} documentVersionMetadataUpdate
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof DocumentVersionsApiInterface
+     */
+    updateDocumentVersionMetadataRequestOpts(requestParameters: UpdateDocumentVersionMetadataRequest): Promise<runtime.RequestOpts>;
     /**
      * Merge metadata fields into an existing document version\'s metadata.  Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved.
      * @summary Update Document Version Metadata Handler
@@ -168,6 +230,10 @@ export interface DocumentVersionsApiInterface {
  *
  */
 export declare class DocumentVersionsApi extends runtime.BaseAPI implements DocumentVersionsApiInterface {
+    /**
+     * Creates request options for clearDocumentVersionContents without sending the request
+     */
+    clearDocumentVersionContentsRequestOpts(requestParameters: ClearDocumentVersionContentsRequest): Promise<runtime.RequestOpts>;
     /**
      * Delete all sections and chunks under a document version.  Removes all content (sections and chunks) from the version while keeping the version itself intact. Used by the ingestion pipeline for idempotent re-processing.
      * Clear Document Version Contents Handler
@@ -178,6 +244,10 @@ export declare class DocumentVersionsApi extends runtime.BaseAPI implements Docu
      * Clear Document Version Contents Handler
      */
     clearDocumentVersionContents(requestParameters: ClearDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ClearVersionContentsResponse>;
+    /**
+     * Creates request options for createDocumentVersion without sending the request
+     */
+    createDocumentVersionRequestOpts(requestParameters: CreateDocumentVersionRequest): Promise<runtime.RequestOpts>;
     /**
      * Create a new version for a document.  The version number is automatically incremented from the highest existing version.
      * Create Document Version Handler
@@ -188,6 +258,10 @@ export declare class DocumentVersionsApi extends runtime.BaseAPI implements Docu
      * Create Document Version Handler
      */
     createDocumentVersion(requestParameters: CreateDocumentVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionResponse>;
+    /**
+     * Creates request options for deleteDocumentVersion without sending the request
+     */
+    deleteDocumentVersionRequestOpts(requestParameters: DeleteDocumentVersionRequest): Promise<runtime.RequestOpts>;
     /**
      * Delete a document version by its ID.  Cannot delete the active version of a document.
      * Delete Document Version Handler
@@ -198,6 +272,10 @@ export declare class DocumentVersionsApi extends runtime.BaseAPI implements Docu
      * Delete Document Version Handler
      */
     deleteDocumentVersion(requestParameters: DeleteDocumentVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    /**
+     * Creates request options for getDocumentVersion without sending the request
+     */
+    getDocumentVersionRequestOpts(requestParameters: GetDocumentVersionRequest): Promise<runtime.RequestOpts>;
     /**
      * Get a document version by its ID.
      * Get Document Version Handler
@@ -209,15 +287,23 @@ export declare class DocumentVersionsApi extends runtime.BaseAPI implements Docu
      */
     getDocumentVersion(requestParameters: GetDocumentVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionResponse>;
     /**
-     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * Creates request options for getDocumentVersionContents without sending the request
+     */
+    getDocumentVersionContentsRequestOpts(requestParameters: GetDocumentVersionContentsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").
      * Get Document Version Contents Handler
      */
-    getDocumentVersionContentsRaw(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseDocumentContentPathPart>>;
+    getDocumentVersionContentsRaw(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator>>;
     /**
-     * List all sections and chunks for a document version in depth-first logical order.  Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").
      * Get Document Version Contents Handler
      */
-    getDocumentVersionContents(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseDocumentContentPathPart>;
+    getDocumentVersionContents(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator>;
+    /**
+     * Creates request options for listDocumentVersions without sending the request
+     */
+    listDocumentVersionsRequestOpts(requestParameters: ListDocumentVersionsRequest): Promise<runtime.RequestOpts>;
     /**
      * List all versions for a document.  Returns versions ordered by version number ascending (v0, v1, v2...).
      * List Document Versions Handler
@@ -228,6 +314,10 @@ export declare class DocumentVersionsApi extends runtime.BaseAPI implements Docu
      * List Document Versions Handler
      */
     listDocumentVersions(requestParameters: ListDocumentVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseDocumentVersionResponse>;
+    /**
+     * Creates request options for updateDocumentVersionMetadata without sending the request
+     */
+    updateDocumentVersionMetadataRequestOpts(requestParameters: UpdateDocumentVersionMetadataRequest): Promise<runtime.RequestOpts>;
     /**
      * Merge metadata fields into an existing document version\'s metadata.  Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved.
      * Update Document Version Metadata Handler