@knowledge-stack/ksapi 1.23.5 → 1.25.0

package/docs/ChunksApi.md

@@ -0,0 +1,590 @@
+# ChunksApi
+
+All URIs are relative to *http://localhost:8000*
+
+| Method | HTTP request | Description |
+|------------- | ------------- | -------------|
+| [**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 |
+| [**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 |
+| [**updateChunkContent**](ChunksApi.md#updatechunkcontentoperation) | **PATCH** /v1/chunks/{chunk_id}/content | Update Chunk Content Handler |
+| [**updateChunkMetadata**](ChunksApi.md#updatechunkmetadataoperation) | **PATCH** /v1/chunks/{chunk_id} | Update Chunk Metadata Handler |
+
+
+
+## createChunk
+
+> ChunkResponse createChunk(createChunkRequest, ksUat)
+
+Create Chunk Handler
+
+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.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  ChunksApi,
+} from '@knowledge-stack/ksapi';
+import type { CreateChunkOperationRequest } from '@knowledge-stack/ksapi';
+
+async function example() {
+  console.log("🚀 Testing @knowledge-stack/ksapi SDK...");
+  const api = new ChunksApi();
+
+  const body = {
+    // CreateChunkRequest
+    createChunkRequest: ...,
+    // string (optional)
+    ksUat: ksUat_example,
+  } satisfies CreateChunkOperationRequest;
+
+  try {
+    const data = await api.createChunk(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **createChunkRequest** | [CreateChunkRequest](CreateChunkRequest.md) |  | |
+| **ksUat** | `string` |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**ChunkResponse**](ChunkResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **201** | 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)
+
+
+## deleteChunk
+
+> deleteChunk(chunkId, ksUat)
+
+Delete Chunk Handler
+
+Delete a chunk.  The chunk is deleted via its PathPart (cascading delete). The associated ChunkContent may remain if shared by other chunks.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  ChunksApi,
+} from '@knowledge-stack/ksapi';
+import type { DeleteChunkRequest } 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,
+    // string (optional)
+    ksUat: ksUat_example,
+  } satisfies DeleteChunkRequest;
+
+  try {
+    const data = await api.deleteChunk(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`] |
+| **ksUat** | `string` |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+`void` (Empty response body)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **204** | 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)
+
+
+## getChunk
+
+> ChunkResponse getChunk(chunkId, ksUat)
+
+Get Chunk Handler
+
+Get a chunk by its ID, including content.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  ChunksApi,
+} from '@knowledge-stack/ksapi';
+import type { GetChunkRequest } 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,
+    // string (optional)
+    ksUat: ksUat_example,
+  } satisfies GetChunkRequest;
+
+  try {
+    const data = await api.getChunk(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`] |
+| **ksUat** | `string` |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**ChunkResponse**](ChunkResponse.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, ksUat)
+
+Get Chunks Bulk Handler
+
+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.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  ChunksApi,
+} from '@knowledge-stack/ksapi';
+import type { GetChunksBulkRequest } from '@knowledge-stack/ksapi';
+
+async function example() {
+  console.log("🚀 Testing @knowledge-stack/ksapi SDK...");
+  const api = new ChunksApi();
+
+  const body = {
+    // Array<string> | Chunk IDs to resolve (max 200) (optional)
+    chunkIds: ...,
+    // string (optional)
+    ksUat: ksUat_example,
+  } satisfies GetChunksBulkRequest;
+
+  try {
+    const data = await api.getChunksBulk(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **chunkIds** | `Array<string>` | Chunk IDs to resolve (max 200) | [Optional] |
+| **ksUat** | `string` |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**Array&lt;ChunkBulkResponse&gt;**](ChunkBulkResponse.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)
+
+
+## getVersionChunkIds
+
+> VersionChunkIdsResponse getVersionChunkIds(documentVersionId, ksUat)
+
+Get Version Chunk Ids Handler
+
+Get all chunk IDs belonging to a document version.  Used by the embedding pipeline to discover chunks for a version.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  ChunksApi,
+} from '@knowledge-stack/ksapi';
+import type { GetVersionChunkIdsRequest } from '@knowledge-stack/ksapi';
+
+async function example() {
+  console.log("🚀 Testing @knowledge-stack/ksapi SDK...");
+  const api = new ChunksApi();
+
+  const body = {
+    // string | Document version ID
+    documentVersionId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
+    // string (optional)
+    ksUat: ksUat_example,
+  } satisfies GetVersionChunkIdsRequest;
+
+  try {
+    const data = await api.getVersionChunkIds(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **documentVersionId** | `string` | Document version ID | [Defaults to `undefined`] |
+| **ksUat** | `string` |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**VersionChunkIdsResponse**](VersionChunkIdsResponse.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)
+
+
+## searchChunks
+
+> Array&lt;ScoredChunkResponse&gt; searchChunks(chunkSearchRequest, ksUat)
+
+Search Chunks Handler
+
+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.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  ChunksApi,
+} from '@knowledge-stack/ksapi';
+import type { SearchChunksRequest } from '@knowledge-stack/ksapi';
+
+async function example() {
+  console.log("🚀 Testing @knowledge-stack/ksapi SDK...");
+  const api = new ChunksApi();
+
+  const body = {
+    // ChunkSearchRequest
+    chunkSearchRequest: ...,
+    // string (optional)
+    ksUat: ksUat_example,
+  } satisfies SearchChunksRequest;
+
+  try {
+    const data = await api.searchChunks(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **chunkSearchRequest** | [ChunkSearchRequest](ChunkSearchRequest.md) |  | |
+| **ksUat** | `string` |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**Array&lt;ScoredChunkResponse&gt;**](ScoredChunkResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **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)
+
+
+## updateChunkContent
+
+> ChunkResponse updateChunkContent(chunkId, updateChunkContentRequest, ksUat)
+
+Update Chunk Content Handler
+
+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.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  ChunksApi,
+} from '@knowledge-stack/ksapi';
+import type { UpdateChunkContentOperationRequest } 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,
+    // UpdateChunkContentRequest
+    updateChunkContentRequest: ...,
+    // string (optional)
+    ksUat: ksUat_example,
+  } satisfies UpdateChunkContentOperationRequest;
+
+  try {
+    const data = await api.updateChunkContent(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`] |
+| **updateChunkContentRequest** | [UpdateChunkContentRequest](UpdateChunkContentRequest.md) |  | |
+| **ksUat** | `string` |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**ChunkResponse**](ChunkResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **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)
+
+
+## updateChunkMetadata
+
+> ChunkResponse updateChunkMetadata(chunkId, updateChunkMetadataRequest, ksUat)
+
+Update Chunk Metadata Handler
+
+Update chunk metadata by merging with existing metadata.  The provided metadata is shallow-merged into the existing chunk_metadata.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  ChunksApi,
+} from '@knowledge-stack/ksapi';
+import type { UpdateChunkMetadataOperationRequest } 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,
+    // UpdateChunkMetadataRequest
+    updateChunkMetadataRequest: ...,
+    // string (optional)
+    ksUat: ksUat_example,
+  } satisfies UpdateChunkMetadataOperationRequest;
+
+  try {
+    const data = await api.updateChunkMetadata(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`] |
+| **updateChunkMetadataRequest** | [UpdateChunkMetadataRequest](UpdateChunkMetadataRequest.md) |  | |
+| **ksUat** | `string` |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**ChunkResponse**](ChunkResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **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)
+

package/docs/ClearVersionContentsResponse.md

@@ -0,0 +1,35 @@
+
+# ClearVersionContentsResponse
+
+Response model for the clear version contents endpoint.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`deleted` | number
+
+## Example
+
+```typescript
+import type { ClearVersionContentsResponse } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "deleted": null,
+} satisfies ClearVersionContentsResponse
+
+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 ClearVersionContentsResponse
+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/CreateChunkLineageRequest.md

@@ -0,0 +1,37 @@
+
+# CreateChunkLineageRequest
+
+Request to batch-create lineage edges for a child chunk.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`chunkId` | string
+`parentChunkIds` | Array<string>
+
+## Example
+
+```typescript
+import type { CreateChunkLineageRequest } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "chunkId": null,
+  "parentChunkIds": null,
+} satisfies CreateChunkLineageRequest
+
+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 CreateChunkLineageRequest
+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/CreateChunkRequest.md

@@ -0,0 +1,43 @@
+
+# CreateChunkRequest
+
+Request to create a new chunk.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`parentPathId` | string
+`content` | string
+`chunkType` | [ChunkType](ChunkType.md)
+`chunkMetadata` | [ChunkMetadataInput](ChunkMetadataInput.md)
+`prevSiblingPathId` | string
+
+## Example
+
+```typescript
+import type { CreateChunkRequest } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "parentPathId": null,
+  "content": null,
+  "chunkType": null,
+  "chunkMetadata": null,
+  "prevSiblingPathId": null,
+} satisfies CreateChunkRequest
+
+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 CreateChunkRequest
+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)
+
+