@knowledge-stack/ksapi 1.24.0 → 1.25.1

package/dist/esm/apis/ChunksApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { ChunkResponse, ChunkSearchRequest, CreateChunkRequest, ScoredChunkResponse, UpdateChunkContentRequest, UpdateChunkMetadataRequest } from '../models/index';
+import type { ChunkBulkResponse, ChunkResponse, ChunkSearchRequest, CreateChunkRequest, ScoredChunkResponse, UpdateChunkContentRequest, UpdateChunkMetadataRequest, VersionChunkIdsResponse } from '../models/index';
 export interface CreateChunkOperationRequest {
     createChunkRequest: CreateChunkRequest;
     ksUat?: string | null;
@@ -23,6 +23,14 @@ export interface GetChunkRequest {
     chunkId: string;
     ksUat?: string | null;
 }
+export interface GetChunksBulkRequest {
+    chunkIds?: Array<string> | null;
+    ksUat?: string | null;
+}
+export interface GetVersionChunkIdsRequest {
+    documentVersionId: string;
+    ksUat?: string | null;
+}
 export interface SearchChunksRequest {
     chunkSearchRequest: ChunkSearchRequest;
     ksUat?: string | null;
@@ -113,6 +121,52 @@ export interface ChunksApiInterface {
      * Get Chunk Handler
      */
     getChunk(requestParameters: GetChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ChunkResponse>;
+    /**
+     * Creates request options for getChunksBulk without sending the request
+     * @param {Array<string>} [chunkIds] Chunk IDs to resolve (max 200)
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof ChunksApiInterface
+     */
+    getChunksBulkRequestOpts(requestParameters: GetChunksBulkRequest): Promise<runtime.RequestOpts>;
+    /**
+     * 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.
+     * @summary Get Chunks Bulk Handler
+     * @param {Array<string>} [chunkIds] Chunk IDs to resolve (max 200)
+     * @param {string} [ksUat]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ChunksApiInterface
+     */
+    getChunksBulkRaw(requestParameters: GetChunksBulkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<ChunkBulkResponse>>>;
+    /**
+     * 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(requestParameters: GetChunksBulkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<ChunkBulkResponse>>;
+    /**
+     * Creates request options for getVersionChunkIds without sending the request
+     * @param {string} documentVersionId Document version ID
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof ChunksApiInterface
+     */
+    getVersionChunkIdsRequestOpts(requestParameters: GetVersionChunkIdsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Get all chunk IDs belonging to a document version.  Used by the embedding pipeline to discover chunks for a version.
+     * @summary Get Version Chunk Ids Handler
+     * @param {string} documentVersionId Document version ID
+     * @param {string} [ksUat]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ChunksApiInterface
+     */
+    getVersionChunkIdsRaw(requestParameters: GetVersionChunkIdsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<VersionChunkIdsResponse>>;
+    /**
+     * 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: GetVersionChunkIdsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<VersionChunkIdsResponse>;
     /**
      * Creates request options for searchChunks without sending the request
      * @param {ChunkSearchRequest} chunkSearchRequest
@@ -122,7 +176,7 @@ export interface ChunksApiInterface {
      */
     searchChunksRequestOpts(requestParameters: SearchChunksRequest): Promise<runtime.RequestOpts>;
     /**
-     * Semantic search over chunks using vector similarity.  Combines vector 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.
      * @summary Search Chunks Handler
      * @param {ChunkSearchRequest} chunkSearchRequest
      * @param {string} [ksUat]
@@ -132,7 +186,7 @@ export interface ChunksApiInterface {
      */
     searchChunksRaw(requestParameters: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<ScoredChunkResponse>>>;
     /**
-     * Semantic search over chunks using vector similarity.  Combines vector 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: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<ScoredChunkResponse>>;
@@ -233,17 +287,45 @@ export declare class ChunksApi extends runtime.BaseAPI implements ChunksApiInter
      * Get Chunk Handler
      */
     getChunk(requestParameters: GetChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ChunkResponse>;
+    /**
+     * Creates request options for getChunksBulk without sending the request
+     */
+    getChunksBulkRequestOpts(requestParameters: GetChunksBulkRequest): Promise<runtime.RequestOpts>;
+    /**
+     * 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: GetChunksBulkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<ChunkBulkResponse>>>;
+    /**
+     * 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(requestParameters?: GetChunksBulkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<ChunkBulkResponse>>;
+    /**
+     * Creates request options for getVersionChunkIds without sending the request
+     */
+    getVersionChunkIdsRequestOpts(requestParameters: GetVersionChunkIdsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * 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: GetVersionChunkIdsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<VersionChunkIdsResponse>>;
+    /**
+     * 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: GetVersionChunkIdsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<VersionChunkIdsResponse>;
     /**
      * Creates request options for searchChunks without sending the request
      */
     searchChunksRequestOpts(requestParameters: SearchChunksRequest): Promise<runtime.RequestOpts>;
     /**
-     * Semantic search over chunks using vector similarity.  Combines vector 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
      */
     searchChunksRaw(requestParameters: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<ScoredChunkResponse>>>;
     /**
-     * Semantic search over chunks using vector similarity.  Combines vector 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: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<ScoredChunkResponse>>;

package/dist/esm/apis/ChunksApi.js

@@ -21,7 +21,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
-import { ChunkResponseFromJSON, ChunkSearchRequestToJSON, CreateChunkRequestToJSON, ScoredChunkResponseFromJSON, UpdateChunkContentRequestToJSON, UpdateChunkMetadataRequestToJSON, } from '../models/index';
+import { ChunkBulkResponseFromJSON, ChunkResponseFromJSON, ChunkSearchRequestToJSON, CreateChunkRequestToJSON, ScoredChunkResponseFromJSON, UpdateChunkContentRequestToJSON, UpdateChunkMetadataRequestToJSON, VersionChunkIdsResponseFromJSON, } from '../models/index';
 /**
  *
  */
@@ -149,6 +149,89 @@ export class ChunksApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for getChunksBulk without sending the request
+     */
+    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(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) => 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
      */
@@ -171,7 +254,7 @@ export class ChunksApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Semantic search over chunks using vector similarity.  Combines vector 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
      */
     searchChunksRaw(requestParameters, initOverrides) {
@@ -182,7 +265,7 @@ export class ChunksApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Semantic search over chunks using vector similarity.  Combines vector 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) {

package/dist/esm/apis/PathPartsApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { BulkTagRequest, PaginatedResponsePathPartResponse, PathOrder, PathPartResponse, PathPartTagsResponse } from '../models/index';
+import type { BulkTagRequest, PaginatedResponsePathPartResponse, PathOrder, PathPartResponse, PathPartTagsResponse, SubtreeChunksResponse } from '../models/index';
 export interface BulkAddPathPartTagsRequest {
     pathPartId: string;
     bulkTagRequest: BulkTagRequest;
@@ -25,6 +25,15 @@ export interface GetPathPartRequest {
     pathPartId: string;
     ksUat?: string | null;
 }
+export interface GetPathPartSubtreeChunksRequest {
+    pathPartId: string;
+    ksUat?: string | null;
+}
+export interface GetPathPartTagsRequest {
+    pathPartId: string;
+    includeInherited?: boolean;
+    ksUat?: string | null;
+}
 export interface ListPathPartsRequest {
     parentPathId?: string | null;
     maxDepth?: number;
@@ -113,6 +122,54 @@ export interface PathPartsApiInterface {
      * Get Path Part Handler
      */
     getPathPart(requestParameters: GetPathPartRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartResponse>;
+    /**
+     * Creates request options for getPathPartSubtreeChunks without sending the request
+     * @param {string} pathPartId
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof PathPartsApiInterface
+     */
+    getPathPartSubtreeChunksRequestOpts(requestParameters: GetPathPartSubtreeChunksRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Resolve all descendant chunks for a subtree root.  Returns chunks grouped by identical (path_part_ids, tag_ids) tuples.
+     * @summary Get Path Part Subtree Chunks Handler
+     * @param {string} pathPartId
+     * @param {string} [ksUat]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PathPartsApiInterface
+     */
+    getPathPartSubtreeChunksRaw(requestParameters: GetPathPartSubtreeChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SubtreeChunksResponse>>;
+    /**
+     * Resolve all descendant chunks for a subtree root.  Returns chunks grouped by identical (path_part_ids, tag_ids) tuples.
+     * Get Path Part Subtree Chunks Handler
+     */
+    getPathPartSubtreeChunks(requestParameters: GetPathPartSubtreeChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SubtreeChunksResponse>;
+    /**
+     * Creates request options for getPathPartTags without sending the request
+     * @param {string} pathPartId
+     * @param {boolean} [includeInherited] Include tags inherited from ancestor path parts
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof PathPartsApiInterface
+     */
+    getPathPartTagsRequestOpts(requestParameters: GetPathPartTagsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Get tags for a path part.  When include_inherited=False (default), returns only directly-attached tags. When include_inherited=True, walks the ancestor chain and returns the deduplicated union of tags from all ancestors (including the path part itself).
+     * @summary Get Path Part Tags Handler
+     * @param {string} pathPartId
+     * @param {boolean} [includeInherited] Include tags inherited from ancestor path parts
+     * @param {string} [ksUat]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PathPartsApiInterface
+     */
+    getPathPartTagsRaw(requestParameters: GetPathPartTagsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartTagsResponse>>;
+    /**
+     * Get tags for a path part.  When include_inherited=False (default), returns only directly-attached tags. When include_inherited=True, walks the ancestor chain and returns the deduplicated union of tags from all ancestors (including the path part itself).
+     * Get Path Part Tags Handler
+     */
+    getPathPartTags(requestParameters: GetPathPartTagsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartTagsResponse>;
     /**
      * Creates request options for listPathParts without sending the request
      * @param {string} [parentPathId] Parent PathPart ID (defaults to root)
@@ -191,6 +248,34 @@ export declare class PathPartsApi extends runtime.BaseAPI implements PathPartsAp
      * Get Path Part Handler
      */
     getPathPart(requestParameters: GetPathPartRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartResponse>;
+    /**
+     * Creates request options for getPathPartSubtreeChunks without sending the request
+     */
+    getPathPartSubtreeChunksRequestOpts(requestParameters: GetPathPartSubtreeChunksRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Resolve all descendant chunks for a subtree root.  Returns chunks grouped by identical (path_part_ids, tag_ids) tuples.
+     * Get Path Part Subtree Chunks Handler
+     */
+    getPathPartSubtreeChunksRaw(requestParameters: GetPathPartSubtreeChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SubtreeChunksResponse>>;
+    /**
+     * Resolve all descendant chunks for a subtree root.  Returns chunks grouped by identical (path_part_ids, tag_ids) tuples.
+     * Get Path Part Subtree Chunks Handler
+     */
+    getPathPartSubtreeChunks(requestParameters: GetPathPartSubtreeChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SubtreeChunksResponse>;
+    /**
+     * Creates request options for getPathPartTags without sending the request
+     */
+    getPathPartTagsRequestOpts(requestParameters: GetPathPartTagsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Get tags for a path part.  When include_inherited=False (default), returns only directly-attached tags. When include_inherited=True, walks the ancestor chain and returns the deduplicated union of tags from all ancestors (including the path part itself).
+     * Get Path Part Tags Handler
+     */
+    getPathPartTagsRaw(requestParameters: GetPathPartTagsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartTagsResponse>>;
+    /**
+     * Get tags for a path part.  When include_inherited=False (default), returns only directly-attached tags. When include_inherited=True, walks the ancestor chain and returns the deduplicated union of tags from all ancestors (including the path part itself).
+     * Get Path Part Tags Handler
+     */
+    getPathPartTags(requestParameters: GetPathPartTagsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartTagsResponse>;
     /**
      * Creates request options for listPathParts without sending the request
      */

package/dist/esm/apis/PathPartsApi.js

@@ -21,7 +21,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
-import { BulkTagRequestToJSON, PaginatedResponsePathPartResponseFromJSON, PathPartResponseFromJSON, PathPartTagsResponseFromJSON, } from '../models/index';
+import { BulkTagRequestToJSON, PaginatedResponsePathPartResponseFromJSON, PathPartResponseFromJSON, PathPartTagsResponseFromJSON, SubtreeChunksResponseFromJSON, } from '../models/index';
 /**
  *
  */
@@ -159,6 +159,91 @@ export class PathPartsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for getPathPartSubtreeChunks without sending the request
+     */
+    getPathPartSubtreeChunksRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['pathPartId'] == null) {
+                throw new runtime.RequiredError('pathPartId', 'Required parameter "pathPartId" was null or undefined when calling getPathPartSubtreeChunks().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            let urlPath = `/v1/path-parts/{path_part_id}/subtree_chunks`;
+            urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Resolve all descendant chunks for a subtree root.  Returns chunks grouped by identical (path_part_ids, tag_ids) tuples.
+     * Get Path Part Subtree Chunks Handler
+     */
+    getPathPartSubtreeChunksRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.getPathPartSubtreeChunksRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => SubtreeChunksResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Resolve all descendant chunks for a subtree root.  Returns chunks grouped by identical (path_part_ids, tag_ids) tuples.
+     * Get Path Part Subtree Chunks Handler
+     */
+    getPathPartSubtreeChunks(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getPathPartSubtreeChunksRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for getPathPartTags without sending the request
+     */
+    getPathPartTagsRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['pathPartId'] == null) {
+                throw new runtime.RequiredError('pathPartId', 'Required parameter "pathPartId" was null or undefined when calling getPathPartTags().');
+            }
+            const queryParameters = {};
+            if (requestParameters['includeInherited'] != null) {
+                queryParameters['include_inherited'] = requestParameters['includeInherited'];
+            }
+            const headerParameters = {};
+            let urlPath = `/v1/path-parts/{path_part_id}/tags`;
+            urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Get tags for a path part.  When include_inherited=False (default), returns only directly-attached tags. When include_inherited=True, walks the ancestor chain and returns the deduplicated union of tags from all ancestors (including the path part itself).
+     * Get Path Part Tags Handler
+     */
+    getPathPartTagsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.getPathPartTagsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => PathPartTagsResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Get tags for a path part.  When include_inherited=False (default), returns only directly-attached tags. When include_inherited=True, walks the ancestor chain and returns the deduplicated union of tags from all ancestors (including the path part itself).
+     * Get Path Part Tags Handler
+     */
+    getPathPartTags(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getPathPartTagsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for listPathParts without sending the request
      */

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

@@ -0,0 +1,139 @@
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * 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 { ChunkMetadataOutput } from './ChunkMetadataOutput';
+import type { ChunkType } from './ChunkType';
+/**
+ * Chunk response with ancestor path part IDs for Qdrant payload construction.
+ * @export
+ * @interface ChunkBulkResponse
+ */
+export interface ChunkBulkResponse {
+    /**
+     * Chunk ID
+     * @type {string}
+     * @memberof ChunkBulkResponse
+     */
+    id: string;
+    /**
+     * PathPart ID
+     * @type {string}
+     * @memberof ChunkBulkResponse
+     */
+    pathPartId: string;
+    /**
+     * ChunkContent ID
+     * @type {string}
+     * @memberof ChunkBulkResponse
+     */
+    contentId: string;
+    /**
+     * Chunk text content
+     * @type {string}
+     * @memberof ChunkBulkResponse
+     */
+    content: string;
+    /**
+     *
+     * @type {ChunkType}
+     * @memberof ChunkBulkResponse
+     */
+    chunkType: ChunkType;
+    /**
+     *
+     * @type {ChunkMetadataOutput}
+     * @memberof ChunkBulkResponse
+     */
+    chunkMetadata: ChunkMetadataOutput;
+    /**
+     * Parent PathPart ID
+     * @type {string}
+     * @memberof ChunkBulkResponse
+     */
+    parentPathId: string;
+    /**
+     * Previous sibling PathPart ID
+     * @type {string}
+     * @memberof ChunkBulkResponse
+     */
+    prevSiblingPathId?: string | null;
+    /**
+     * Next sibling PathPart ID
+     * @type {string}
+     * @memberof ChunkBulkResponse
+     */
+    nextSiblingPathId?: string | null;
+    /**
+     * Full materialized path from root
+     * @type {string}
+     * @memberof ChunkBulkResponse
+     */
+    materializedPath: string;
+    /**
+     * Whether this chunk is system-managed
+     * @type {boolean}
+     * @memberof ChunkBulkResponse
+     */
+    systemManaged: boolean;
+    /**
+     * Tenant ID
+     * @type {string}
+     * @memberof ChunkBulkResponse
+     */
+    tenantId: string;
+    /**
+     * Creation timestamp
+     * @type {Date}
+     * @memberof ChunkBulkResponse
+     */
+    createdAt: Date;
+    /**
+     * Last update timestamp
+     * @type {Date}
+     * @memberof ChunkBulkResponse
+     */
+    updatedAt: Date;
+    /**
+     * Presigned URL to download the chunk's visual asset (6-hour validity)
+     * @type {string}
+     * @memberof ChunkBulkResponse
+     */
+    assetS3Url?: string | null;
+    /**
+     * Ordered ancestor PathPart IDs from root to chunk
+     * @type {Array<string>}
+     * @memberof ChunkBulkResponse
+     */
+    pathPartIdSegments: Array<string>;
+}
+/**
+ * Check if a given object implements the ChunkBulkResponse interface.
+ */
+export declare function instanceOfChunkBulkResponse(value: object): value is ChunkBulkResponse;
+export declare function ChunkBulkResponseFromJSON(json: any): ChunkBulkResponse;
+export declare function ChunkBulkResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): ChunkBulkResponse;
+export declare function ChunkBulkResponseToJSON(json: any): ChunkBulkResponse;
+export declare function ChunkBulkResponseToJSONTyped(value?: ChunkBulkResponse | null, ignoreDiscriminator?: boolean): any;
+export declare const ChunkBulkResponsePropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maximum?: number;
+        exclusiveMaximum?: boolean;
+        minimum?: number;
+        exclusiveMinimum?: boolean;
+        multipleOf?: number;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+    };
+};