@knowledge-stack/ksapi 1.61.0 → 1.61.1

package/.openapi-generator/FILES

@@ -18,6 +18,7 @@ docs/ChunkLineageResponse.md
 docs/ChunkLineagesApi.md
 docs/ChunkMetadataInput.md
 docs/ChunkMetadataOutput.md
+docs/ChunkNeighborsResponse.md
 docs/ChunkResponse.md
 docs/ChunkSearchRequest.md
 docs/ChunkType.md
@@ -204,6 +205,7 @@ src/models/ChunkDocumentVersionResponse.ts
 src/models/ChunkLineageResponse.ts
 src/models/ChunkMetadataInput.ts
 src/models/ChunkMetadataOutput.ts
+src/models/ChunkNeighborsResponse.ts
 src/models/ChunkResponse.ts
 src/models/ChunkSearchRequest.ts
 src/models/ChunkType.ts

package/README.md

@@ -1,4 +1,4 @@
-# @knowledge-stack/ksapi@1.61.0
+# @knowledge-stack/ksapi@1.61.1
 
 A TypeScript SDK client for the localhost API.
 
@@ -72,6 +72,7 @@ All URIs are relative to *http://localhost:8000*
 *ChunksApi* | [**createChunk**](docs/ChunksApi.md#createchunkoperation) | **POST** /v1/chunks | Create Chunk Handler
 *ChunksApi* | [**deleteChunk**](docs/ChunksApi.md#deletechunk) | **DELETE** /v1/chunks/{chunk_id} | Delete Chunk Handler
 *ChunksApi* | [**getChunk**](docs/ChunksApi.md#getchunk) | **GET** /v1/chunks/{chunk_id} | Get Chunk Handler
+*ChunksApi* | [**getChunkNeighbors**](docs/ChunksApi.md#getchunkneighbors) | **GET** /v1/chunks/{chunk_id}/neighbors | Get Chunk Neighbors Handler
 *ChunksApi* | [**getChunksBulk**](docs/ChunksApi.md#getchunksbulk) | **GET** /v1/chunks/bulk | Get Chunks Bulk Handler
 *ChunksApi* | [**getVersionChunkIds**](docs/ChunksApi.md#getversionchunkids) | **GET** /v1/chunks/version-chunk-ids | Get Version Chunk Ids Handler
 *ChunksApi* | [**searchChunks**](docs/ChunksApi.md#searchchunks) | **POST** /v1/chunks/search | Search Chunks Handler
@@ -173,6 +174,7 @@ All URIs are relative to *http://localhost:8000*
 - [ChunkLineageResponse](docs/ChunkLineageResponse.md)
 - [ChunkMetadataInput](docs/ChunkMetadataInput.md)
 - [ChunkMetadataOutput](docs/ChunkMetadataOutput.md)
+- [ChunkNeighborsResponse](docs/ChunkNeighborsResponse.md)
 - [ChunkResponse](docs/ChunkResponse.md)
 - [ChunkSearchRequest](docs/ChunkSearchRequest.md)
 - [ChunkType](docs/ChunkType.md)
@@ -321,7 +323,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `0.1.0`
-- Package version: `1.61.0`
+- Package version: `1.61.1`
 - Generator version: `7.20.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

package/dist/apis/ChunksApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { ChunkBulkResponse, ChunkResponse, ChunkSearchRequest, CreateChunkRequest, ScoredChunkResponse, UpdateChunkContentRequest, UpdateChunkMetadataRequest, VersionChunkIdsResponse } from '../models/index';
+import type { ChunkBulkResponse, ChunkNeighborsResponse, ChunkResponse, ChunkSearchRequest, CreateChunkRequest, ScoredChunkResponse, UpdateChunkContentRequest, UpdateChunkMetadataRequest, VersionChunkIdsResponse } from '../models/index';
 export interface CreateChunkOperationRequest {
     createChunkRequest: CreateChunkRequest;
     authorization?: string | null;
@@ -27,6 +27,14 @@ export interface GetChunkRequest {
     authorization?: string | null;
     ksUat?: string | null;
 }
+export interface GetChunkNeighborsRequest {
+    chunkId: string;
+    prev?: number;
+    next?: number;
+    chunksOnly?: boolean;
+    authorization?: string | null;
+    ksUat?: string | null;
+}
 export interface GetChunksBulkRequest {
     chunkIds?: Array<string> | null;
     authorization?: string | null;
@@ -138,6 +146,37 @@ export interface ChunksApiInterface {
      * Get Chunk Handler
      */
     getChunk(requestParameters: GetChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ChunkResponse>;
+    /**
+     * Creates request options for getChunkNeighbors without sending the request
+     * @param {string} chunkId
+     * @param {number} [prev] Number of preceding siblings to include
+     * @param {number} [next] Number of succeeding siblings to include
+     * @param {boolean} [chunksOnly] When true, stop traversal at non-CHUNK siblings (default: false)
+     * @param {string} [authorization]
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof ChunksApiInterface
+     */
+    getChunkNeighborsRequestOpts(requestParameters: GetChunkNeighborsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * @summary Get Chunk Neighbors Handler
+     * @param {string} chunkId
+     * @param {number} [prev] Number of preceding siblings to include
+     * @param {number} [next] Number of succeeding siblings to include
+     * @param {boolean} [chunksOnly] When true, stop traversal at non-CHUNK siblings (default: false)
+     * @param {string} [authorization]
+     * @param {string} [ksUat]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ChunksApiInterface
+     */
+    getChunkNeighborsRaw(requestParameters: GetChunkNeighborsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ChunkNeighborsResponse>>;
+    /**
+     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * Get Chunk Neighbors Handler
+     */
+    getChunkNeighbors(requestParameters: GetChunkNeighborsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ChunkNeighborsResponse>;
     /**
      * Creates request options for getChunksBulk without sending the request
      * @param {Array<string>} [chunkIds] Chunk IDs to resolve (max 200)
@@ -314,6 +353,20 @@ 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 getChunkNeighbors without sending the request
+     */
+    getChunkNeighborsRequestOpts(requestParameters: GetChunkNeighborsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * Get Chunk Neighbors Handler
+     */
+    getChunkNeighborsRaw(requestParameters: GetChunkNeighborsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ChunkNeighborsResponse>>;
+    /**
+     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * Get Chunk Neighbors Handler
+     */
+    getChunkNeighbors(requestParameters: GetChunkNeighborsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ChunkNeighborsResponse>;
     /**
      * Creates request options for getChunksBulk without sending the request
      */

package/dist/apis/ChunksApi.js

@@ -164,6 +164,59 @@ class ChunksApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for getChunkNeighbors without sending the request
+     */
+    getChunkNeighborsRequestOpts(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 getChunkNeighbors().');
+            }
+            const queryParameters = {};
+            if (requestParameters['prev'] != null) {
+                queryParameters['prev'] = requestParameters['prev'];
+            }
+            if (requestParameters['next'] != null) {
+                queryParameters['next'] = requestParameters['next'];
+            }
+            if (requestParameters['chunksOnly'] != null) {
+                queryParameters['chunks_only'] = requestParameters['chunksOnly'];
+            }
+            const headerParameters = {};
+            if (requestParameters['authorization'] != null) {
+                headerParameters['authorization'] = String(requestParameters['authorization']);
+            }
+            let urlPath = `/v1/chunks/{chunk_id}/neighbors`;
+            urlPath = urlPath.replace(`{${"chunk_id"}}`, encodeURIComponent(String(requestParameters['chunkId'])));
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * Get Chunk Neighbors Handler
+     */
+    getChunkNeighborsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.getChunkNeighborsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.ChunkNeighborsResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * Get Chunk Neighbors Handler
+     */
+    getChunkNeighbors(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getChunkNeighborsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for getChunksBulk without sending the request
      */

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

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { ChunkBulkResponse, ChunkResponse, ChunkSearchRequest, CreateChunkRequest, ScoredChunkResponse, UpdateChunkContentRequest, UpdateChunkMetadataRequest, VersionChunkIdsResponse } from '../models/index';
+import type { ChunkBulkResponse, ChunkNeighborsResponse, ChunkResponse, ChunkSearchRequest, CreateChunkRequest, ScoredChunkResponse, UpdateChunkContentRequest, UpdateChunkMetadataRequest, VersionChunkIdsResponse } from '../models/index';
 export interface CreateChunkOperationRequest {
     createChunkRequest: CreateChunkRequest;
     authorization?: string | null;
@@ -27,6 +27,14 @@ export interface GetChunkRequest {
     authorization?: string | null;
     ksUat?: string | null;
 }
+export interface GetChunkNeighborsRequest {
+    chunkId: string;
+    prev?: number;
+    next?: number;
+    chunksOnly?: boolean;
+    authorization?: string | null;
+    ksUat?: string | null;
+}
 export interface GetChunksBulkRequest {
     chunkIds?: Array<string> | null;
     authorization?: string | null;
@@ -138,6 +146,37 @@ export interface ChunksApiInterface {
      * Get Chunk Handler
      */
     getChunk(requestParameters: GetChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ChunkResponse>;
+    /**
+     * Creates request options for getChunkNeighbors without sending the request
+     * @param {string} chunkId
+     * @param {number} [prev] Number of preceding siblings to include
+     * @param {number} [next] Number of succeeding siblings to include
+     * @param {boolean} [chunksOnly] When true, stop traversal at non-CHUNK siblings (default: false)
+     * @param {string} [authorization]
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof ChunksApiInterface
+     */
+    getChunkNeighborsRequestOpts(requestParameters: GetChunkNeighborsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * @summary Get Chunk Neighbors Handler
+     * @param {string} chunkId
+     * @param {number} [prev] Number of preceding siblings to include
+     * @param {number} [next] Number of succeeding siblings to include
+     * @param {boolean} [chunksOnly] When true, stop traversal at non-CHUNK siblings (default: false)
+     * @param {string} [authorization]
+     * @param {string} [ksUat]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ChunksApiInterface
+     */
+    getChunkNeighborsRaw(requestParameters: GetChunkNeighborsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ChunkNeighborsResponse>>;
+    /**
+     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * Get Chunk Neighbors Handler
+     */
+    getChunkNeighbors(requestParameters: GetChunkNeighborsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ChunkNeighborsResponse>;
     /**
      * Creates request options for getChunksBulk without sending the request
      * @param {Array<string>} [chunkIds] Chunk IDs to resolve (max 200)
@@ -314,6 +353,20 @@ 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 getChunkNeighbors without sending the request
+     */
+    getChunkNeighborsRequestOpts(requestParameters: GetChunkNeighborsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * Get Chunk Neighbors Handler
+     */
+    getChunkNeighborsRaw(requestParameters: GetChunkNeighborsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ChunkNeighborsResponse>>;
+    /**
+     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * Get Chunk Neighbors Handler
+     */
+    getChunkNeighbors(requestParameters: GetChunkNeighborsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ChunkNeighborsResponse>;
     /**
      * Creates request options for getChunksBulk without sending the request
      */

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 { ChunkBulkResponseFromJSON, ChunkResponseFromJSON, ChunkSearchRequestToJSON, CreateChunkRequestToJSON, ScoredChunkResponseFromJSON, UpdateChunkContentRequestToJSON, UpdateChunkMetadataRequestToJSON, VersionChunkIdsResponseFromJSON, } from '../models/index';
+import { ChunkBulkResponseFromJSON, ChunkNeighborsResponseFromJSON, ChunkResponseFromJSON, ChunkSearchRequestToJSON, CreateChunkRequestToJSON, ScoredChunkResponseFromJSON, UpdateChunkContentRequestToJSON, UpdateChunkMetadataRequestToJSON, VersionChunkIdsResponseFromJSON, } from '../models/index';
 /**
  *
  */
@@ -161,6 +161,59 @@ export class ChunksApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for getChunkNeighbors without sending the request
+     */
+    getChunkNeighborsRequestOpts(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 getChunkNeighbors().');
+            }
+            const queryParameters = {};
+            if (requestParameters['prev'] != null) {
+                queryParameters['prev'] = requestParameters['prev'];
+            }
+            if (requestParameters['next'] != null) {
+                queryParameters['next'] = requestParameters['next'];
+            }
+            if (requestParameters['chunksOnly'] != null) {
+                queryParameters['chunks_only'] = requestParameters['chunksOnly'];
+            }
+            const headerParameters = {};
+            if (requestParameters['authorization'] != null) {
+                headerParameters['authorization'] = String(requestParameters['authorization']);
+            }
+            let urlPath = `/v1/chunks/{chunk_id}/neighbors`;
+            urlPath = urlPath.replace(`{${"chunk_id"}}`, encodeURIComponent(String(requestParameters['chunkId'])));
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * Get Chunk Neighbors Handler
+     */
+    getChunkNeighborsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.getChunkNeighborsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => ChunkNeighborsResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * Get Chunk Neighbors Handler
+     */
+    getChunkNeighbors(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.getChunkNeighborsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for getChunksBulk without sending the request
      */

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

@@ -0,0 +1,57 @@
+/**
+ * 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 { SectionContentItemOrChunkContentItem } from './SectionContentItemOrChunkContentItem';
+/**
+ * Response for chunk neighbor traversal.
+ *
+ * Returns items in the same ``SectionOrChunkItem`` discriminated union
+ * format used by the document version contents endpoint.
+ * @export
+ * @interface ChunkNeighborsResponse
+ */
+export interface ChunkNeighborsResponse {
+    /**
+     * Ordered siblings: preceding → anchor → succeeding
+     * @type {Array<SectionContentItemOrChunkContentItem>}
+     * @memberof ChunkNeighborsResponse
+     */
+    items: Array<SectionContentItemOrChunkContentItem>;
+    /**
+     * Index of the anchor chunk in items
+     * @type {number}
+     * @memberof ChunkNeighborsResponse
+     */
+    anchorIndex: number;
+}
+/**
+ * Check if a given object implements the ChunkNeighborsResponse interface.
+ */
+export declare function instanceOfChunkNeighborsResponse(value: object): value is ChunkNeighborsResponse;
+export declare function ChunkNeighborsResponseFromJSON(json: any): ChunkNeighborsResponse;
+export declare function ChunkNeighborsResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): ChunkNeighborsResponse;
+export declare function ChunkNeighborsResponseToJSON(json: any): ChunkNeighborsResponse;
+export declare function ChunkNeighborsResponseToJSONTyped(value?: ChunkNeighborsResponse | null, ignoreDiscriminator?: boolean): any;
+export declare const ChunkNeighborsResponsePropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maximum?: number;
+        exclusiveMaximum?: boolean;
+        minimum?: number;
+        exclusiveMinimum?: boolean;
+        multipleOf?: number;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+    };
+};

package/dist/esm/models/ChunkNeighborsResponse.js

@@ -0,0 +1,49 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 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 { SectionContentItemOrChunkContentItemFromJSON, SectionContentItemOrChunkContentItemToJSON, } from './SectionContentItemOrChunkContentItem';
+/**
+ * Check if a given object implements the ChunkNeighborsResponse interface.
+ */
+export function instanceOfChunkNeighborsResponse(value) {
+    if (!('items' in value) || value['items'] === undefined)
+        return false;
+    if (!('anchorIndex' in value) || value['anchorIndex'] === undefined)
+        return false;
+    return true;
+}
+export function ChunkNeighborsResponseFromJSON(json) {
+    return ChunkNeighborsResponseFromJSONTyped(json, false);
+}
+export function ChunkNeighborsResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'items': (json['items'].map(SectionContentItemOrChunkContentItemFromJSON)),
+        'anchorIndex': json['anchor_index'],
+    };
+}
+export function ChunkNeighborsResponseToJSON(json) {
+    return ChunkNeighborsResponseToJSONTyped(json, false);
+}
+export function ChunkNeighborsResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'items': (value['items'].map(SectionContentItemOrChunkContentItemToJSON)),
+        'anchor_index': value['anchorIndex'],
+    };
+}
+export const ChunkNeighborsResponsePropertyValidationAttributesMap = {};

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

@@ -11,6 +11,7 @@ export * from './ChunkDocumentVersionResponse';
 export * from './ChunkLineageResponse';
 export * from './ChunkMetadataInput';
 export * from './ChunkMetadataOutput';
+export * from './ChunkNeighborsResponse';
 export * from './ChunkResponse';
 export * from './ChunkSearchRequest';
 export * from './ChunkType';

package/dist/esm/models/index.js

@@ -13,6 +13,7 @@ export * from './ChunkDocumentVersionResponse';
 export * from './ChunkLineageResponse';
 export * from './ChunkMetadataInput';
 export * from './ChunkMetadataOutput';
+export * from './ChunkNeighborsResponse';
 export * from './ChunkResponse';
 export * from './ChunkSearchRequest';
 export * from './ChunkType';

package/dist/models/ChunkNeighborsResponse.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 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 { SectionContentItemOrChunkContentItem } from './SectionContentItemOrChunkContentItem';
+/**
+ * Response for chunk neighbor traversal.
+ *
+ * Returns items in the same ``SectionOrChunkItem`` discriminated union
+ * format used by the document version contents endpoint.
+ * @export
+ * @interface ChunkNeighborsResponse
+ */
+export interface ChunkNeighborsResponse {
+    /**
+     * Ordered siblings: preceding → anchor → succeeding
+     * @type {Array<SectionContentItemOrChunkContentItem>}
+     * @memberof ChunkNeighborsResponse
+     */
+    items: Array<SectionContentItemOrChunkContentItem>;
+    /**
+     * Index of the anchor chunk in items
+     * @type {number}
+     * @memberof ChunkNeighborsResponse
+     */
+    anchorIndex: number;
+}
+/**
+ * Check if a given object implements the ChunkNeighborsResponse interface.
+ */
+export declare function instanceOfChunkNeighborsResponse(value: object): value is ChunkNeighborsResponse;
+export declare function ChunkNeighborsResponseFromJSON(json: any): ChunkNeighborsResponse;
+export declare function ChunkNeighborsResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): ChunkNeighborsResponse;
+export declare function ChunkNeighborsResponseToJSON(json: any): ChunkNeighborsResponse;
+export declare function ChunkNeighborsResponseToJSONTyped(value?: ChunkNeighborsResponse | null, ignoreDiscriminator?: boolean): any;
+export declare const ChunkNeighborsResponsePropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maximum?: number;
+        exclusiveMaximum?: boolean;
+        minimum?: number;
+        exclusiveMinimum?: boolean;
+        multipleOf?: number;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+    };
+};

package/dist/models/ChunkNeighborsResponse.js

@@ -0,0 +1,57 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChunkNeighborsResponsePropertyValidationAttributesMap = void 0;
+exports.instanceOfChunkNeighborsResponse = instanceOfChunkNeighborsResponse;
+exports.ChunkNeighborsResponseFromJSON = ChunkNeighborsResponseFromJSON;
+exports.ChunkNeighborsResponseFromJSONTyped = ChunkNeighborsResponseFromJSONTyped;
+exports.ChunkNeighborsResponseToJSON = ChunkNeighborsResponseToJSON;
+exports.ChunkNeighborsResponseToJSONTyped = ChunkNeighborsResponseToJSONTyped;
+const SectionContentItemOrChunkContentItem_1 = require("./SectionContentItemOrChunkContentItem");
+/**
+ * Check if a given object implements the ChunkNeighborsResponse interface.
+ */
+function instanceOfChunkNeighborsResponse(value) {
+    if (!('items' in value) || value['items'] === undefined)
+        return false;
+    if (!('anchorIndex' in value) || value['anchorIndex'] === undefined)
+        return false;
+    return true;
+}
+function ChunkNeighborsResponseFromJSON(json) {
+    return ChunkNeighborsResponseFromJSONTyped(json, false);
+}
+function ChunkNeighborsResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'items': (json['items'].map(SectionContentItemOrChunkContentItem_1.SectionContentItemOrChunkContentItemFromJSON)),
+        'anchorIndex': json['anchor_index'],
+    };
+}
+function ChunkNeighborsResponseToJSON(json) {
+    return ChunkNeighborsResponseToJSONTyped(json, false);
+}
+function ChunkNeighborsResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'items': (value['items'].map(SectionContentItemOrChunkContentItem_1.SectionContentItemOrChunkContentItemToJSON)),
+        'anchor_index': value['anchorIndex'],
+    };
+}
+exports.ChunkNeighborsResponsePropertyValidationAttributesMap = {};

package/dist/models/index.d.ts

@@ -11,6 +11,7 @@ export * from './ChunkDocumentVersionResponse';
 export * from './ChunkLineageResponse';
 export * from './ChunkMetadataInput';
 export * from './ChunkMetadataOutput';
+export * from './ChunkNeighborsResponse';
 export * from './ChunkResponse';
 export * from './ChunkSearchRequest';
 export * from './ChunkType';

package/dist/models/index.js

@@ -29,6 +29,7 @@ __exportStar(require("./ChunkDocumentVersionResponse"), exports);
 __exportStar(require("./ChunkLineageResponse"), exports);
 __exportStar(require("./ChunkMetadataInput"), exports);
 __exportStar(require("./ChunkMetadataOutput"), exports);
+__exportStar(require("./ChunkNeighborsResponse"), exports);
 __exportStar(require("./ChunkResponse"), exports);
 __exportStar(require("./ChunkSearchRequest"), exports);
 __exportStar(require("./ChunkType"), exports);

package/docs/ChunkNeighborsResponse.md

@@ -0,0 +1,37 @@
+
+# ChunkNeighborsResponse
+
+Response for chunk neighbor traversal.  Returns items in the same ``SectionOrChunkItem`` discriminated union format used by the document version contents endpoint.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`items` | [Array<SectionContentItemOrChunkContentItem>](SectionContentItemOrChunkContentItem.md)
+`anchorIndex` | number
+
+## Example
+
+```typescript
+import type { ChunkNeighborsResponse } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "items": null,
+  "anchorIndex": null,
+} satisfies ChunkNeighborsResponse
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as ChunkNeighborsResponse
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/ChunksApi.md

@@ -7,6 +7,7 @@ All URIs are relative to *http://localhost:8000*
 | [**createChunk**](ChunksApi.md#createchunkoperation) | **POST** /v1/chunks | Create Chunk Handler |
 | [**deleteChunk**](ChunksApi.md#deletechunk) | **DELETE** /v1/chunks/{chunk_id} | Delete Chunk Handler |
 | [**getChunk**](ChunksApi.md#getchunk) | **GET** /v1/chunks/{chunk_id} | Get Chunk Handler |
+| [**getChunkNeighbors**](ChunksApi.md#getchunkneighbors) | **GET** /v1/chunks/{chunk_id}/neighbors | Get Chunk Neighbors Handler |
 | [**getChunksBulk**](ChunksApi.md#getchunksbulk) | **GET** /v1/chunks/bulk | Get Chunks Bulk Handler |
 | [**getVersionChunkIds**](ChunksApi.md#getversionchunkids) | **GET** /v1/chunks/version-chunk-ids | Get Version Chunk Ids Handler |
 | [**searchChunks**](ChunksApi.md#searchchunks) | **POST** /v1/chunks/search | Search Chunks Handler |
@@ -240,6 +241,89 @@ No authorization required
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## getChunkNeighbors
+
+> ChunkNeighborsResponse getChunkNeighbors(chunkId, prev, next, chunksOnly, authorization, ksUat)
+
+Get Chunk Neighbors Handler
+
+Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  ChunksApi,
+} from '@knowledge-stack/ksapi';
+import type { GetChunkNeighborsRequest } from '@knowledge-stack/ksapi';
+
+async function example() {
+  console.log("🚀 Testing @knowledge-stack/ksapi SDK...");
+  const api = new ChunksApi();
+
+  const body = {
+    // string
+    chunkId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
+    // number | Number of preceding siblings to include (optional)
+    prev: 56,
+    // number | Number of succeeding siblings to include (optional)
+    next: 56,
+    // boolean | When true, stop traversal at non-CHUNK siblings (default: false) (optional)
+    chunksOnly: true,
+    // string (optional)
+    authorization: authorization_example,
+    // string (optional)
+    ksUat: ksUat_example,
+  } satisfies GetChunkNeighborsRequest;
+
+  try {
+    const data = await api.getChunkNeighbors(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **chunkId** | `string` |  | [Defaults to `undefined`] |
+| **prev** | `number` | Number of preceding siblings to include | [Optional] [Defaults to `1`] |
+| **next** | `number` | Number of succeeding siblings to include | [Optional] [Defaults to `1`] |
+| **chunksOnly** | `boolean` | When true, stop traversal at non-CHUNK siblings (default: false) | [Optional] [Defaults to `false`] |
+| **authorization** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **ksUat** | `string` |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**ChunkNeighborsResponse**](ChunkNeighborsResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Successful Response |  -  |
+| **422** | Validation Error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## getChunksBulk
 
 > Array<ChunkBulkResponse> getChunksBulk(chunkIds, authorization, ksUat)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowledge-stack/ksapi",
-  "version": "1.61.0",
+  "version": "1.61.1",
   "description": "OpenAPI client for @knowledge-stack/ksapi",
   "author": "OpenAPI-Generator",
   "repository": {

package/src/apis/ChunksApi.ts

@@ -16,6 +16,7 @@
 import * as runtime from '../runtime';
 import type {
   ChunkBulkResponse,
+  ChunkNeighborsResponse,
   ChunkResponse,
   ChunkSearchRequest,
   CreateChunkRequest,
@@ -28,6 +29,8 @@ import type {
 import {
     ChunkBulkResponseFromJSON,
     ChunkBulkResponseToJSON,
+    ChunkNeighborsResponseFromJSON,
+    ChunkNeighborsResponseToJSON,
     ChunkResponseFromJSON,
     ChunkResponseToJSON,
     ChunkSearchRequestFromJSON,
@@ -65,6 +68,15 @@ export interface GetChunkRequest {
     ksUat?: string | null;
 }
 
+export interface GetChunkNeighborsRequest {
+    chunkId: string;
+    prev?: number;
+    next?: number;
+    chunksOnly?: boolean;
+    authorization?: string | null;
+    ksUat?: string | null;
+}
+
 export interface GetChunksBulkRequest {
     chunkIds?: Array<string> | null;
     authorization?: string | null;
@@ -190,6 +202,40 @@ export interface ChunksApiInterface {
      */
     getChunk(requestParameters: GetChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ChunkResponse>;
 
+    /**
+     * Creates request options for getChunkNeighbors without sending the request
+     * @param {string} chunkId 
+     * @param {number} [prev] Number of preceding siblings to include
+     * @param {number} [next] Number of succeeding siblings to include
+     * @param {boolean} [chunksOnly] When true, stop traversal at non-CHUNK siblings (default: false)
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @throws {RequiredError}
+     * @memberof ChunksApiInterface
+     */
+    getChunkNeighborsRequestOpts(requestParameters: GetChunkNeighborsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * @summary Get Chunk Neighbors Handler
+     * @param {string} chunkId 
+     * @param {number} [prev] Number of preceding siblings to include
+     * @param {number} [next] Number of succeeding siblings to include
+     * @param {boolean} [chunksOnly] When true, stop traversal at non-CHUNK siblings (default: false)
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof ChunksApiInterface
+     */
+    getChunkNeighborsRaw(requestParameters: GetChunkNeighborsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ChunkNeighborsResponse>>;
+
+    /**
+     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * Get Chunk Neighbors Handler
+     */
+    getChunkNeighbors(requestParameters: GetChunkNeighborsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ChunkNeighborsResponse>;
+
     /**
      * Creates request options for getChunksBulk without sending the request
      * @param {Array<string>} [chunkIds] Chunk IDs to resolve (max 200)
@@ -499,6 +545,69 @@ export class ChunksApi extends runtime.BaseAPI implements ChunksApiInterface {
         return await response.value();
     }
 
+    /**
+     * Creates request options for getChunkNeighbors without sending the request
+     */
+    async getChunkNeighborsRequestOpts(requestParameters: GetChunkNeighborsRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['chunkId'] == null) {
+            throw new runtime.RequiredError(
+                'chunkId',
+                'Required parameter "chunkId" was null or undefined when calling getChunkNeighbors().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['prev'] != null) {
+            queryParameters['prev'] = requestParameters['prev'];
+        }
+
+        if (requestParameters['next'] != null) {
+            queryParameters['next'] = requestParameters['next'];
+        }
+
+        if (requestParameters['chunksOnly'] != null) {
+            queryParameters['chunks_only'] = requestParameters['chunksOnly'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (requestParameters['authorization'] != null) {
+            headerParameters['authorization'] = String(requestParameters['authorization']);
+        }
+
+
+        let urlPath = `/v1/chunks/{chunk_id}/neighbors`;
+        urlPath = urlPath.replace(`{${"chunk_id"}}`, encodeURIComponent(String(requestParameters['chunkId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * Get Chunk Neighbors Handler
+     */
+    async getChunkNeighborsRaw(requestParameters: GetChunkNeighborsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ChunkNeighborsResponse>> {
+        const requestOptions = await this.getChunkNeighborsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => ChunkNeighborsResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * Get Chunk Neighbors Handler
+     */
+    async getChunkNeighbors(requestParameters: GetChunkNeighborsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ChunkNeighborsResponse> {
+        const response = await this.getChunkNeighborsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for getChunksBulk without sending the request
      */

package/src/models/ChunkNeighborsResponse.ts

@@ -0,0 +1,103 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 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 { mapValues } from '../runtime';
+import type { SectionContentItemOrChunkContentItem } from './SectionContentItemOrChunkContentItem';
+import {
+    SectionContentItemOrChunkContentItemFromJSON,
+    SectionContentItemOrChunkContentItemFromJSONTyped,
+    SectionContentItemOrChunkContentItemToJSON,
+    SectionContentItemOrChunkContentItemToJSONTyped,
+} from './SectionContentItemOrChunkContentItem';
+
+/**
+ * Response for chunk neighbor traversal.
+ * 
+ * Returns items in the same ``SectionOrChunkItem`` discriminated union
+ * format used by the document version contents endpoint.
+ * @export
+ * @interface ChunkNeighborsResponse
+ */
+export interface ChunkNeighborsResponse {
+    /**
+     * Ordered siblings: preceding → anchor → succeeding
+     * @type {Array<SectionContentItemOrChunkContentItem>}
+     * @memberof ChunkNeighborsResponse
+     */
+    items: Array<SectionContentItemOrChunkContentItem>;
+    /**
+     * Index of the anchor chunk in items
+     * @type {number}
+     * @memberof ChunkNeighborsResponse
+     */
+    anchorIndex: number;
+}
+
+/**
+ * Check if a given object implements the ChunkNeighborsResponse interface.
+ */
+export function instanceOfChunkNeighborsResponse(value: object): value is ChunkNeighborsResponse {
+    if (!('items' in value) || value['items'] === undefined) return false;
+    if (!('anchorIndex' in value) || value['anchorIndex'] === undefined) return false;
+    return true;
+}
+
+export function ChunkNeighborsResponseFromJSON(json: any): ChunkNeighborsResponse {
+    return ChunkNeighborsResponseFromJSONTyped(json, false);
+}
+
+export function ChunkNeighborsResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): ChunkNeighborsResponse {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'items': ((json['items'] as Array<any>).map(SectionContentItemOrChunkContentItemFromJSON)),
+        'anchorIndex': json['anchor_index'],
+    };
+}
+
+export function ChunkNeighborsResponseToJSON(json: any): ChunkNeighborsResponse {
+    return ChunkNeighborsResponseToJSONTyped(json, false);
+}
+
+export function ChunkNeighborsResponseToJSONTyped(value?: ChunkNeighborsResponse | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'items': ((value['items'] as Array<any>).map(SectionContentItemOrChunkContentItemToJSON)),
+        'anchor_index': value['anchorIndex'],
+    };
+}
+
+export const ChunkNeighborsResponsePropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number,
+        minLength?: number,
+        pattern?: string,
+        maximum?: number,
+        exclusiveMaximum?: boolean,
+        minimum?: number,
+        exclusiveMinimum?: boolean,
+        multipleOf?: number,
+        maxItems?: number,
+        minItems?: number,
+        uniqueItems?: boolean
+    }
+} = {
+}
+

package/src/models/index.ts

@@ -13,6 +13,7 @@ export * from './ChunkDocumentVersionResponse';
 export * from './ChunkLineageResponse';
 export * from './ChunkMetadataInput';
 export * from './ChunkMetadataOutput';
+export * from './ChunkNeighborsResponse';
 export * from './ChunkResponse';
 export * from './ChunkSearchRequest';
 export * from './ChunkType';