@knowledge-stack/ksapi 1.56.0 → 1.57.0

package/.openapi-generator/FILES

@@ -42,6 +42,7 @@ docs/DocumentResponse.md
 docs/DocumentType.md
 docs/DocumentVersionAction.md
 docs/DocumentVersionActionResponse.md
+docs/DocumentVersionContentTypeFilter.md
 docs/DocumentVersionMetadata.md
 docs/DocumentVersionMetadataUpdate.md
 docs/DocumentVersionResponse.md
@@ -74,6 +75,7 @@ docs/LineageGraphResponse.md
 docs/LineageNodeResponse.md
 docs/LocationInner.md
 docs/MessageRole.md
+docs/NonFilesystemReferenceType.md
 docs/OAuth2Config.md
 docs/PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator.md
 docs/PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator.md
@@ -102,6 +104,9 @@ docs/PipelineState.md
 docs/PipelineStatus.md
 docs/Polygon.md
 docs/PolygonReference.md
+docs/ReferenceType.md
+docs/ResolvedReferenceInput.md
+docs/ResolvedReferenceOutput.md
 docs/RootResponse.md
 docs/SSOInitiateResponse.md
 docs/ScoredChunkResponse.md
@@ -214,6 +219,7 @@ src/models/DocumentResponse.ts
 src/models/DocumentType.ts
 src/models/DocumentVersionAction.ts
 src/models/DocumentVersionActionResponse.ts
+src/models/DocumentVersionContentTypeFilter.ts
 src/models/DocumentVersionMetadata.ts
 src/models/DocumentVersionMetadataUpdate.ts
 src/models/DocumentVersionResponse.ts
@@ -241,6 +247,7 @@ src/models/LineageGraphResponse.ts
 src/models/LineageNodeResponse.ts
 src/models/LocationInner.ts
 src/models/MessageRole.ts
+src/models/NonFilesystemReferenceType.ts
 src/models/OAuth2Config.ts
 src/models/PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator.ts
 src/models/PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator.ts
@@ -268,6 +275,9 @@ src/models/PipelineState.ts
 src/models/PipelineStatus.ts
 src/models/Polygon.ts
 src/models/PolygonReference.ts
+src/models/ReferenceType.ts
+src/models/ResolvedReferenceInput.ts
+src/models/ResolvedReferenceOutput.ts
 src/models/RootResponse.ts
 src/models/SSOInitiateResponse.ts
 src/models/ScoredChunkResponse.ts

package/README.md

@@ -1,4 +1,4 @@
-# @knowledge-stack/ksapi@1.56.0
+# @knowledge-stack/ksapi@1.57.0
 
 A TypeScript SDK client for the localhost API.
 
@@ -189,6 +189,7 @@ All URIs are relative to *http://localhost:8000*
 - [DocumentType](docs/DocumentType.md)
 - [DocumentVersionAction](docs/DocumentVersionAction.md)
 - [DocumentVersionActionResponse](docs/DocumentVersionActionResponse.md)
+- [DocumentVersionContentTypeFilter](docs/DocumentVersionContentTypeFilter.md)
 - [DocumentVersionMetadata](docs/DocumentVersionMetadata.md)
 - [DocumentVersionMetadataUpdate](docs/DocumentVersionMetadataUpdate.md)
 - [DocumentVersionResponse](docs/DocumentVersionResponse.md)
@@ -216,6 +217,7 @@ All URIs are relative to *http://localhost:8000*
 - [LineageNodeResponse](docs/LineageNodeResponse.md)
 - [LocationInner](docs/LocationInner.md)
 - [MessageRole](docs/MessageRole.md)
+- [NonFilesystemReferenceType](docs/NonFilesystemReferenceType.md)
 - [OAuth2Config](docs/OAuth2Config.md)
 - [PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator](docs/PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator.md)
 - [PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator](docs/PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator.md)
@@ -243,6 +245,9 @@ All URIs are relative to *http://localhost:8000*
 - [PipelineStatus](docs/PipelineStatus.md)
 - [Polygon](docs/Polygon.md)
 - [PolygonReference](docs/PolygonReference.md)
+- [ReferenceType](docs/ReferenceType.md)
+- [ResolvedReferenceInput](docs/ResolvedReferenceInput.md)
+- [ResolvedReferenceOutput](docs/ResolvedReferenceOutput.md)
 - [RootResponse](docs/RootResponse.md)
 - [SSOInitiateResponse](docs/SSOInitiateResponse.md)
 - [ScoredChunkResponse](docs/ScoredChunkResponse.md)
@@ -303,7 +308,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `0.1.0`
-- Package version: `1.56.0`
+- Package version: `1.57.0`
 - Generator version: `7.20.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

package/dist/apis/DocumentVersionsApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { ClearVersionContentsResponse, DocumentVersionAction, DocumentVersionActionResponse, DocumentVersionMetadataUpdate, DocumentVersionResponse, PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator, PaginatedResponseDocumentVersionResponse } from '../models/index';
+import type { ClearVersionContentsResponse, DocumentVersionAction, DocumentVersionActionResponse, DocumentVersionContentTypeFilter, DocumentVersionMetadataUpdate, DocumentVersionResponse, PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator, PaginatedResponseDocumentVersionResponse } from '../models/index';
 export interface ClearDocumentVersionContentsRequest {
     versionId: string;
     authorization?: string | null;
@@ -40,6 +40,7 @@ export interface GetDocumentVersionRequest {
 export interface GetDocumentVersionContentsRequest {
     versionId: string;
     sectionId?: string | null;
+    contentType?: DocumentVersionContentTypeFilter;
     limit?: number;
     offset?: number;
     authorization?: string | null;
@@ -196,6 +197,7 @@ export interface DocumentVersionsApiInterface {
      * Creates request options for getDocumentVersionContents without sending the request
      * @param {string} versionId DocumentVersion ID
      * @param {string} [sectionId] Optional section ID to scope traversal to a subtree
+     * @param {DocumentVersionContentTypeFilter} [contentType] Filter by content type: SECTION or CHUNK. Omit to return both types.
      * @param {number} [limit] Number of items per page
      * @param {number} [offset] Number of items to skip
      * @param {string} [authorization]
@@ -205,10 +207,11 @@ export interface DocumentVersionsApiInterface {
      */
     getDocumentVersionContentsRequestOpts(requestParameters: GetDocumentVersionContentsRequest): Promise<runtime.RequestOpts>;
     /**
-     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").  Use `content_type` to return only one type (e.g. `content_type=CHUNK` for chunk-only pagination where offset/limit apply only to chunks).
      * @summary Get Document Version Contents Handler
      * @param {string} versionId DocumentVersion ID
      * @param {string} [sectionId] Optional section ID to scope traversal to a subtree
+     * @param {DocumentVersionContentTypeFilter} [contentType] Filter by content type: SECTION or CHUNK. Omit to return both types.
      * @param {number} [limit] Number of items per page
      * @param {number} [offset] Number of items to skip
      * @param {string} [authorization]
@@ -219,7 +222,7 @@ export interface DocumentVersionsApiInterface {
      */
     getDocumentVersionContentsRaw(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator>>;
     /**
-     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").  Use `content_type` to return only one type (e.g. `content_type=CHUNK` for chunk-only pagination where offset/limit apply only to chunks).
      * Get Document Version Contents Handler
      */
     getDocumentVersionContents(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator>;
@@ -359,12 +362,12 @@ export declare class DocumentVersionsApi extends runtime.BaseAPI implements Docu
      */
     getDocumentVersionContentsRequestOpts(requestParameters: GetDocumentVersionContentsRequest): Promise<runtime.RequestOpts>;
     /**
-     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").  Use `content_type` to return only one type (e.g. `content_type=CHUNK` for chunk-only pagination where offset/limit apply only to chunks).
      * Get Document Version Contents Handler
      */
     getDocumentVersionContentsRaw(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator>>;
     /**
-     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").  Use `content_type` to return only one type (e.g. `content_type=CHUNK` for chunk-only pagination where offset/limit apply only to chunks).
      * Get Document Version Contents Handler
      */
     getDocumentVersionContents(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator>;

package/dist/apis/DocumentVersionsApi.js

@@ -266,6 +266,9 @@ class DocumentVersionsApi extends runtime.BaseAPI {
             if (requestParameters['sectionId'] != null) {
                 queryParameters['section_id'] = requestParameters['sectionId'];
             }
+            if (requestParameters['contentType'] != null) {
+                queryParameters['content_type'] = requestParameters['contentType'];
+            }
             if (requestParameters['limit'] != null) {
                 queryParameters['limit'] = requestParameters['limit'];
             }
@@ -287,7 +290,7 @@ class DocumentVersionsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").  Use `content_type` to return only one type (e.g. `content_type=CHUNK` for chunk-only pagination where offset/limit apply only to chunks).
      * Get Document Version Contents Handler
      */
     getDocumentVersionContentsRaw(requestParameters, initOverrides) {
@@ -298,7 +301,7 @@ class DocumentVersionsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").  Use `content_type` to return only one type (e.g. `content_type=CHUNK` for chunk-only pagination where offset/limit apply only to chunks).
      * Get Document Version Contents Handler
      */
     getDocumentVersionContents(requestParameters, initOverrides) {

package/dist/apis/ThreadMessagesApi.d.ts

@@ -100,7 +100,7 @@ export interface ThreadMessagesApiInterface {
      * Creates request options for listThreadMessages without sending the request
      * @param {string} threadId
      * @param {Date} [before] Cursor for keyset pagination: only return messages with created_at < this value
-     * @param {boolean} [withDetails] Include execution steps in response (default false to reduce payload size)
+     * @param {boolean} [withDetails] Include execution steps in response (default true)
      * @param {number} [limit] Number of items per page
      * @param {number} [offset] Number of items to skip
      * @param {string} [authorization]
@@ -110,11 +110,11 @@ export interface ThreadMessagesApiInterface {
      */
     listThreadMessagesRequestOpts(requestParameters: ListThreadMessagesRequest): Promise<runtime.RequestOpts>;
     /**
-     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=true` to include execution step data. Details are excluded by default to avoid loading large TOAST data.
+     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=false` to exclude execution step data and reduce payload size.
      * @summary List Thread Messages Handler
      * @param {string} threadId
      * @param {Date} [before] Cursor for keyset pagination: only return messages with created_at &lt; this value
-     * @param {boolean} [withDetails] Include execution steps in response (default false to reduce payload size)
+     * @param {boolean} [withDetails] Include execution steps in response (default true)
      * @param {number} [limit] Number of items per page
      * @param {number} [offset] Number of items to skip
      * @param {string} [authorization]
@@ -125,7 +125,7 @@ export interface ThreadMessagesApiInterface {
      */
     listThreadMessagesRaw(requestParameters: ListThreadMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseThreadMessageResponse>>;
     /**
-     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=true` to include execution step data. Details are excluded by default to avoid loading large TOAST data.
+     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=false` to exclude execution step data and reduce payload size.
      * List Thread Messages Handler
      */
     listThreadMessages(requestParameters: ListThreadMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseThreadMessageResponse>;
@@ -167,12 +167,12 @@ export declare class ThreadMessagesApi extends runtime.BaseAPI implements Thread
      */
     listThreadMessagesRequestOpts(requestParameters: ListThreadMessagesRequest): Promise<runtime.RequestOpts>;
     /**
-     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=true` to include execution step data. Details are excluded by default to avoid loading large TOAST data.
+     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=false` to exclude execution step data and reduce payload size.
      * List Thread Messages Handler
      */
     listThreadMessagesRaw(requestParameters: ListThreadMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseThreadMessageResponse>>;
     /**
-     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=true` to include execution step data. Details are excluded by default to avoid loading large TOAST data.
+     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=false` to exclude execution step data and reduce payload size.
      * List Thread Messages Handler
      */
     listThreadMessages(requestParameters: ListThreadMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseThreadMessageResponse>;

package/dist/apis/ThreadMessagesApi.js

@@ -165,7 +165,7 @@ class ThreadMessagesApi extends runtime.BaseAPI {
         });
     }
     /**
-     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=true` to include execution step data. Details are excluded by default to avoid loading large TOAST data.
+     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=false` to exclude execution step data and reduce payload size.
      * List Thread Messages Handler
      */
     listThreadMessagesRaw(requestParameters, initOverrides) {
@@ -176,7 +176,7 @@ class ThreadMessagesApi extends runtime.BaseAPI {
         });
     }
     /**
-     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=true` to include execution step data. Details are excluded by default to avoid loading large TOAST data.
+     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=false` to exclude execution step data and reduce payload size.
      * List Thread Messages Handler
      */
     listThreadMessages(requestParameters, initOverrides) {

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

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { ClearVersionContentsResponse, DocumentVersionAction, DocumentVersionActionResponse, DocumentVersionMetadataUpdate, DocumentVersionResponse, PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator, PaginatedResponseDocumentVersionResponse } from '../models/index';
+import type { ClearVersionContentsResponse, DocumentVersionAction, DocumentVersionActionResponse, DocumentVersionContentTypeFilter, DocumentVersionMetadataUpdate, DocumentVersionResponse, PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator, PaginatedResponseDocumentVersionResponse } from '../models/index';
 export interface ClearDocumentVersionContentsRequest {
     versionId: string;
     authorization?: string | null;
@@ -40,6 +40,7 @@ export interface GetDocumentVersionRequest {
 export interface GetDocumentVersionContentsRequest {
     versionId: string;
     sectionId?: string | null;
+    contentType?: DocumentVersionContentTypeFilter;
     limit?: number;
     offset?: number;
     authorization?: string | null;
@@ -196,6 +197,7 @@ export interface DocumentVersionsApiInterface {
      * Creates request options for getDocumentVersionContents without sending the request
      * @param {string} versionId DocumentVersion ID
      * @param {string} [sectionId] Optional section ID to scope traversal to a subtree
+     * @param {DocumentVersionContentTypeFilter} [contentType] Filter by content type: SECTION or CHUNK. Omit to return both types.
      * @param {number} [limit] Number of items per page
      * @param {number} [offset] Number of items to skip
      * @param {string} [authorization]
@@ -205,10 +207,11 @@ export interface DocumentVersionsApiInterface {
      */
     getDocumentVersionContentsRequestOpts(requestParameters: GetDocumentVersionContentsRequest): Promise<runtime.RequestOpts>;
     /**
-     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").  Use `content_type` to return only one type (e.g. `content_type=CHUNK` for chunk-only pagination where offset/limit apply only to chunks).
      * @summary Get Document Version Contents Handler
      * @param {string} versionId DocumentVersion ID
      * @param {string} [sectionId] Optional section ID to scope traversal to a subtree
+     * @param {DocumentVersionContentTypeFilter} [contentType] Filter by content type: SECTION or CHUNK. Omit to return both types.
      * @param {number} [limit] Number of items per page
      * @param {number} [offset] Number of items to skip
      * @param {string} [authorization]
@@ -219,7 +222,7 @@ export interface DocumentVersionsApiInterface {
      */
     getDocumentVersionContentsRaw(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator>>;
     /**
-     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").  Use `content_type` to return only one type (e.g. `content_type=CHUNK` for chunk-only pagination where offset/limit apply only to chunks).
      * Get Document Version Contents Handler
      */
     getDocumentVersionContents(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator>;
@@ -359,12 +362,12 @@ export declare class DocumentVersionsApi extends runtime.BaseAPI implements Docu
      */
     getDocumentVersionContentsRequestOpts(requestParameters: GetDocumentVersionContentsRequest): Promise<runtime.RequestOpts>;
     /**
-     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").  Use `content_type` to return only one type (e.g. `content_type=CHUNK` for chunk-only pagination where offset/limit apply only to chunks).
      * Get Document Version Contents Handler
      */
     getDocumentVersionContentsRaw(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator>>;
     /**
-     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").  Use `content_type` to return only one type (e.g. `content_type=CHUNK` for chunk-only pagination where offset/limit apply only to chunks).
      * Get Document Version Contents Handler
      */
     getDocumentVersionContents(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator>;

package/dist/esm/apis/DocumentVersionsApi.js

@@ -263,6 +263,9 @@ export class DocumentVersionsApi extends runtime.BaseAPI {
             if (requestParameters['sectionId'] != null) {
                 queryParameters['section_id'] = requestParameters['sectionId'];
             }
+            if (requestParameters['contentType'] != null) {
+                queryParameters['content_type'] = requestParameters['contentType'];
+            }
             if (requestParameters['limit'] != null) {
                 queryParameters['limit'] = requestParameters['limit'];
             }
@@ -284,7 +287,7 @@ export class DocumentVersionsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").  Use `content_type` to return only one type (e.g. `content_type=CHUNK` for chunk-only pagination where offset/limit apply only to chunks).
      * Get Document Version Contents Handler
      */
     getDocumentVersionContentsRaw(requestParameters, initOverrides) {
@@ -295,7 +298,7 @@ export class DocumentVersionsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").
+     * List all sections and chunks for a document version in depth-first logical order.  Returns a discriminated union of SectionContentItem and ChunkContentItem, distinguished by the `part_type` field (\"SECTION\" or \"CHUNK\").  Use `content_type` to return only one type (e.g. `content_type=CHUNK` for chunk-only pagination where offset/limit apply only to chunks).
      * Get Document Version Contents Handler
      */
     getDocumentVersionContents(requestParameters, initOverrides) {

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

@@ -100,7 +100,7 @@ export interface ThreadMessagesApiInterface {
      * Creates request options for listThreadMessages without sending the request
      * @param {string} threadId
      * @param {Date} [before] Cursor for keyset pagination: only return messages with created_at < this value
-     * @param {boolean} [withDetails] Include execution steps in response (default false to reduce payload size)
+     * @param {boolean} [withDetails] Include execution steps in response (default true)
      * @param {number} [limit] Number of items per page
      * @param {number} [offset] Number of items to skip
      * @param {string} [authorization]
@@ -110,11 +110,11 @@ export interface ThreadMessagesApiInterface {
      */
     listThreadMessagesRequestOpts(requestParameters: ListThreadMessagesRequest): Promise<runtime.RequestOpts>;
     /**
-     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=true` to include execution step data. Details are excluded by default to avoid loading large TOAST data.
+     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=false` to exclude execution step data and reduce payload size.
      * @summary List Thread Messages Handler
      * @param {string} threadId
      * @param {Date} [before] Cursor for keyset pagination: only return messages with created_at &lt; this value
-     * @param {boolean} [withDetails] Include execution steps in response (default false to reduce payload size)
+     * @param {boolean} [withDetails] Include execution steps in response (default true)
      * @param {number} [limit] Number of items per page
      * @param {number} [offset] Number of items to skip
      * @param {string} [authorization]
@@ -125,7 +125,7 @@ export interface ThreadMessagesApiInterface {
      */
     listThreadMessagesRaw(requestParameters: ListThreadMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseThreadMessageResponse>>;
     /**
-     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=true` to include execution step data. Details are excluded by default to avoid loading large TOAST data.
+     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=false` to exclude execution step data and reduce payload size.
      * List Thread Messages Handler
      */
     listThreadMessages(requestParameters: ListThreadMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseThreadMessageResponse>;
@@ -167,12 +167,12 @@ export declare class ThreadMessagesApi extends runtime.BaseAPI implements Thread
      */
     listThreadMessagesRequestOpts(requestParameters: ListThreadMessagesRequest): Promise<runtime.RequestOpts>;
     /**
-     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=true` to include execution step data. Details are excluded by default to avoid loading large TOAST data.
+     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=false` to exclude execution step data and reduce payload size.
      * List Thread Messages Handler
      */
     listThreadMessagesRaw(requestParameters: ListThreadMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseThreadMessageResponse>>;
     /**
-     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=true` to include execution step data. Details are excluded by default to avoid loading large TOAST data.
+     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=false` to exclude execution step data and reduce payload size.
      * List Thread Messages Handler
      */
     listThreadMessages(requestParameters: ListThreadMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseThreadMessageResponse>;

package/dist/esm/apis/ThreadMessagesApi.js

@@ -162,7 +162,7 @@ export class ThreadMessagesApi extends runtime.BaseAPI {
         });
     }
     /**
-     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=true` to include execution step data. Details are excluded by default to avoid loading large TOAST data.
+     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=false` to exclude execution step data and reduce payload size.
      * List Thread Messages Handler
      */
     listThreadMessagesRaw(requestParameters, initOverrides) {
@@ -173,7 +173,7 @@ export class ThreadMessagesApi extends runtime.BaseAPI {
         });
     }
     /**
-     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=true` to include execution step data. Details are excluded by default to avoid loading large TOAST data.
+     * List messages in a thread, ordered by created_at descending.  Supports cursor-based pagination via `before` parameter and standard offset-based pagination via `limit`/`offset`.  Use `with_details=false` to exclude execution step data and reduce payload size.
      * List Thread Messages Handler
      */
     listThreadMessages(requestParameters, initOverrides) {

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

@@ -18,6 +18,12 @@ import type { ThreadMessageContent } from './ThreadMessageContent';
  * @interface CreateThreadMessageRequest
  */
 export interface CreateThreadMessageRequest {
+    /**
+     * Optional caller-supplied ThreadMessage ID for idempotent creates.
+     * @type {string}
+     * @memberof CreateThreadMessageRequest
+     */
+    messageId?: string | null;
     /**
      *
      * @type {MessageRole}

package/dist/esm/models/CreateThreadMessageRequest.js

@@ -32,6 +32,7 @@ export function CreateThreadMessageRequestFromJSONTyped(json, ignoreDiscriminato
         return json;
     }
     return {
+        'messageId': json['message_id'] == null ? undefined : json['message_id'],
         'role': MessageRoleFromJSON(json['role']),
         'content': ThreadMessageContentFromJSON(json['content']),
         'details': json['details'] == null ? undefined : ThreadMessageDetailsInputFromJSON(json['details']),
@@ -45,6 +46,7 @@ export function CreateThreadMessageRequestToJSONTyped(value, ignoreDiscriminator
         return value;
     }
     return {
+        'message_id': value['messageId'],
         'role': MessageRoleToJSON(value['role']),
         'content': ThreadMessageContentToJSON(value['content']),
         'details': ThreadMessageDetailsInputToJSON(value['details']),

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

@@ -0,0 +1,25 @@
+/**
+ * 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.
+ */
+/**
+ * Filter for the type of content rows to return.
+ * @export
+ */
+export declare const DocumentVersionContentTypeFilter: {
+    readonly Section: "SECTION";
+    readonly Chunk: "CHUNK";
+};
+export type DocumentVersionContentTypeFilter = typeof DocumentVersionContentTypeFilter[keyof typeof DocumentVersionContentTypeFilter];
+export declare function instanceOfDocumentVersionContentTypeFilter(value: any): boolean;
+export declare function DocumentVersionContentTypeFilterFromJSON(json: any): DocumentVersionContentTypeFilter;
+export declare function DocumentVersionContentTypeFilterFromJSONTyped(json: any, ignoreDiscriminator: boolean): DocumentVersionContentTypeFilter;
+export declare function DocumentVersionContentTypeFilterToJSON(value?: DocumentVersionContentTypeFilter | null): any;
+export declare function DocumentVersionContentTypeFilterToJSONTyped(value: any, ignoreDiscriminator: boolean): DocumentVersionContentTypeFilter;

package/dist/esm/models/DocumentVersionContentTypeFilter.js

@@ -0,0 +1,43 @@
+/* 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.
+ */
+/**
+ * Filter for the type of content rows to return.
+ * @export
+ */
+export const DocumentVersionContentTypeFilter = {
+    Section: 'SECTION',
+    Chunk: 'CHUNK'
+};
+export function instanceOfDocumentVersionContentTypeFilter(value) {
+    for (const key in DocumentVersionContentTypeFilter) {
+        if (Object.prototype.hasOwnProperty.call(DocumentVersionContentTypeFilter, key)) {
+            if (DocumentVersionContentTypeFilter[key] === value) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+export function DocumentVersionContentTypeFilterFromJSON(json) {
+    return DocumentVersionContentTypeFilterFromJSONTyped(json, false);
+}
+export function DocumentVersionContentTypeFilterFromJSONTyped(json, ignoreDiscriminator) {
+    return json;
+}
+export function DocumentVersionContentTypeFilterToJSON(value) {
+    return value;
+}
+export function DocumentVersionContentTypeFilterToJSONTyped(value, ignoreDiscriminator) {
+    return value;
+}

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

@@ -9,6 +9,7 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
+import type { ResolvedReferenceOutput } from './ResolvedReferenceOutput';
 import type { EnrichedCitation } from './EnrichedCitation';
 /**
  * ThreadMessageContent with enriched citations for API responses.
@@ -22,12 +23,24 @@ export interface EnrichedThreadMessageContent {
      * @memberof EnrichedThreadMessageContent
      */
     text: string;
+    /**
+     * Whether this message represents a terminal assistant error
+     * @type {boolean}
+     * @memberof EnrichedThreadMessageContent
+     */
+    isError?: boolean | null;
     /**
      * A list of citations with document context
      * @type {Array<EnrichedCitation>}
      * @memberof EnrichedThreadMessageContent
      */
     citations?: Array<EnrichedCitation> | null;
+    /**
+     * Resolved inline references attached to this message
+     * @type {Array<ResolvedReferenceOutput>}
+     * @memberof EnrichedThreadMessageContent
+     */
+    references?: Array<ResolvedReferenceOutput> | null;
 }
 /**
  * Check if a given object implements the EnrichedThreadMessageContent interface.

package/dist/esm/models/EnrichedThreadMessageContent.js

@@ -11,6 +11,7 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
+import { ResolvedReferenceOutputFromJSON, ResolvedReferenceOutputToJSON, } from './ResolvedReferenceOutput';
 import { EnrichedCitationFromJSON, EnrichedCitationToJSON, } from './EnrichedCitation';
 /**
  * Check if a given object implements the EnrichedThreadMessageContent interface.
@@ -29,7 +30,9 @@ export function EnrichedThreadMessageContentFromJSONTyped(json, ignoreDiscrimina
     }
     return {
         'text': json['text'],
+        'isError': json['is_error'] == null ? undefined : json['is_error'],
         'citations': json['citations'] == null ? undefined : (json['citations'].map(EnrichedCitationFromJSON)),
+        'references': json['references'] == null ? undefined : (json['references'].map(ResolvedReferenceOutputFromJSON)),
     };
 }
 export function EnrichedThreadMessageContentToJSON(json) {
@@ -41,7 +44,9 @@ export function EnrichedThreadMessageContentToJSONTyped(value, ignoreDiscriminat
     }
     return {
         'text': value['text'],
+        'is_error': value['isError'],
         'citations': value['citations'] == null ? undefined : (value['citations'].map(EnrichedCitationToJSON)),
+        'references': value['references'] == null ? undefined : (value['references'].map(ResolvedReferenceOutputToJSON)),
     };
 }
 export const EnrichedThreadMessageContentPropertyValidationAttributesMap = {};

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

@@ -0,0 +1,27 @@
+/**
+ * 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.
+ */
+/**
+ * Supported reference types that do not map to filesystem PartType.
+ * @export
+ */
+export declare const NonFilesystemReferenceType: {
+    readonly Image: "image";
+    readonly Memory: "memory";
+    readonly Tag: "tag";
+    readonly User: "user";
+};
+export type NonFilesystemReferenceType = typeof NonFilesystemReferenceType[keyof typeof NonFilesystemReferenceType];
+export declare function instanceOfNonFilesystemReferenceType(value: any): boolean;
+export declare function NonFilesystemReferenceTypeFromJSON(json: any): NonFilesystemReferenceType;
+export declare function NonFilesystemReferenceTypeFromJSONTyped(json: any, ignoreDiscriminator: boolean): NonFilesystemReferenceType;
+export declare function NonFilesystemReferenceTypeToJSON(value?: NonFilesystemReferenceType | null): any;
+export declare function NonFilesystemReferenceTypeToJSONTyped(value: any, ignoreDiscriminator: boolean): NonFilesystemReferenceType;