@knowledge-stack/ksapi 1.56.0 → 1.57.0

package/dist/models/ThreadMessageContent.d.ts

@@ -10,6 +10,7 @@
  * Do not edit the class manually.
  */
 import type { Citation } from './Citation';
+import type { ResolvedReferenceInput } from './ResolvedReferenceInput';
 /**
  *
  * @export
@@ -22,12 +23,24 @@ export interface ThreadMessageContent {
      * @memberof ThreadMessageContent
      */
     text: string;
+    /**
+     * Whether this message represents a terminal assistant error
+     * @type {boolean}
+     * @memberof ThreadMessageContent
+     */
+    isError?: boolean | null;
     /**
      * A list of citations from the message
      * @type {Array<Citation>}
      * @memberof ThreadMessageContent
      */
     citations?: Array<Citation> | null;
+    /**
+     * Resolved inline references attached to this message
+     * @type {Array<ResolvedReferenceInput>}
+     * @memberof ThreadMessageContent
+     */
+    references?: Array<ResolvedReferenceInput> | null;
 }
 /**
  * Check if a given object implements the ThreadMessageContent interface.

package/dist/models/ThreadMessageContent.js

@@ -20,6 +20,7 @@ exports.ThreadMessageContentFromJSONTyped = ThreadMessageContentFromJSONTyped;
 exports.ThreadMessageContentToJSON = ThreadMessageContentToJSON;
 exports.ThreadMessageContentToJSONTyped = ThreadMessageContentToJSONTyped;
 const Citation_1 = require("./Citation");
+const ResolvedReferenceInput_1 = require("./ResolvedReferenceInput");
 /**
  * Check if a given object implements the ThreadMessageContent interface.
  */
@@ -37,7 +38,9 @@ function ThreadMessageContentFromJSONTyped(json, ignoreDiscriminator) {
     }
     return {
         'text': json['text'],
+        'isError': json['is_error'] == null ? undefined : json['is_error'],
         'citations': json['citations'] == null ? undefined : (json['citations'].map(Citation_1.CitationFromJSON)),
+        'references': json['references'] == null ? undefined : (json['references'].map(ResolvedReferenceInput_1.ResolvedReferenceInputFromJSON)),
     };
 }
 function ThreadMessageContentToJSON(json) {
@@ -49,7 +52,9 @@ function ThreadMessageContentToJSONTyped(value, ignoreDiscriminator = false) {
     }
     return {
         'text': value['text'],
+        'is_error': value['isError'],
         'citations': value['citations'] == null ? undefined : (value['citations'].map(Citation_1.CitationToJSON)),
+        'references': value['references'] == null ? undefined : (value['references'].map(ResolvedReferenceInput_1.ResolvedReferenceInputToJSON)),
     };
 }
 exports.ThreadMessageContentPropertyValidationAttributesMap = {};

package/dist/models/index.d.ts

@@ -33,6 +33,7 @@ export * from './DocumentResponse';
 export * from './DocumentType';
 export * from './DocumentVersionAction';
 export * from './DocumentVersionActionResponse';
+export * from './DocumentVersionContentTypeFilter';
 export * from './DocumentVersionMetadata';
 export * from './DocumentVersionMetadataUpdate';
 export * from './DocumentVersionResponse';
@@ -60,6 +61,7 @@ export * from './LineageGraphResponse';
 export * from './LineageNodeResponse';
 export * from './LocationInner';
 export * from './MessageRole';
+export * from './NonFilesystemReferenceType';
 export * from './OAuth2Config';
 export * from './PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator';
 export * from './PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator';
@@ -87,6 +89,9 @@ export * from './PipelineState';
 export * from './PipelineStatus';
 export * from './Polygon';
 export * from './PolygonReference';
+export * from './ReferenceType';
+export * from './ResolvedReferenceInput';
+export * from './ResolvedReferenceOutput';
 export * from './RootResponse';
 export * from './SSOInitiateResponse';
 export * from './ScoredChunkResponse';

package/dist/models/index.js

@@ -51,6 +51,7 @@ __exportStar(require("./DocumentResponse"), exports);
 __exportStar(require("./DocumentType"), exports);
 __exportStar(require("./DocumentVersionAction"), exports);
 __exportStar(require("./DocumentVersionActionResponse"), exports);
+__exportStar(require("./DocumentVersionContentTypeFilter"), exports);
 __exportStar(require("./DocumentVersionMetadata"), exports);
 __exportStar(require("./DocumentVersionMetadataUpdate"), exports);
 __exportStar(require("./DocumentVersionResponse"), exports);
@@ -78,6 +79,7 @@ __exportStar(require("./LineageGraphResponse"), exports);
 __exportStar(require("./LineageNodeResponse"), exports);
 __exportStar(require("./LocationInner"), exports);
 __exportStar(require("./MessageRole"), exports);
+__exportStar(require("./NonFilesystemReferenceType"), exports);
 __exportStar(require("./OAuth2Config"), exports);
 __exportStar(require("./PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator"), exports);
 __exportStar(require("./PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator"), exports);
@@ -105,6 +107,9 @@ __exportStar(require("./PipelineState"), exports);
 __exportStar(require("./PipelineStatus"), exports);
 __exportStar(require("./Polygon"), exports);
 __exportStar(require("./PolygonReference"), exports);
+__exportStar(require("./ReferenceType"), exports);
+__exportStar(require("./ResolvedReferenceInput"), exports);
+__exportStar(require("./ResolvedReferenceOutput"), exports);
 __exportStar(require("./RootResponse"), exports);
 __exportStar(require("./SSOInitiateResponse"), exports);
 __exportStar(require("./ScoredChunkResponse"), exports);

package/docs/CreateThreadMessageRequest.md

@@ -7,6 +7,7 @@ Request to create a new thread message.
 
 Name | Type
 ------------ | -------------
+`messageId` | string
 `role` | [MessageRole](MessageRole.md)
 `content` | [ThreadMessageContent](ThreadMessageContent.md)
 `details` | [ThreadMessageDetailsInput](ThreadMessageDetailsInput.md)
@@ -18,6 +19,7 @@ import type { CreateThreadMessageRequest } from '@knowledge-stack/ksapi'
 
 // TODO: Update the object below with actual values
 const example = {
+  "messageId": null,
   "role": null,
   "content": null,
   "details": null,

package/docs/DocumentVersionContentTypeFilter.md

@@ -0,0 +1,33 @@
+
+# DocumentVersionContentTypeFilter
+
+Filter for the type of content rows to return.
+
+## Properties
+
+Name | Type
+------------ | -------------
+
+## Example
+
+```typescript
+import type { DocumentVersionContentTypeFilter } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+} satisfies DocumentVersionContentTypeFilter
+
+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 DocumentVersionContentTypeFilter
+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/DocumentVersionsApi.md

@@ -390,11 +390,11 @@ No authorization required
 
 ## getDocumentVersionContents
 
-> PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator getDocumentVersionContents(versionId, sectionId, limit, offset, authorization, ksUat)
+> PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator getDocumentVersionContents(versionId, sectionId, contentType, limit, offset, authorization, ksUat)
 
 Get Document Version Contents Handler
 
-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).
 
 ### Example
 
@@ -414,6 +414,8 @@ async function example() {
     versionId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
     // string | Optional section ID to scope traversal to a subtree (optional)
     sectionId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
+    // DocumentVersionContentTypeFilter | Filter by content type: SECTION or CHUNK. Omit to return both types. (optional)
+    contentType: ...,
     // number | Number of items per page (optional)
     limit: 56,
     // number | Number of items to skip (optional)
@@ -443,6 +445,7 @@ example().catch(console.error);
 |------------- | ------------- | ------------- | -------------|
 | **versionId** | `string` | DocumentVersion ID | [Defaults to `undefined`] |
 | **sectionId** | `string` | Optional section ID to scope traversal to a subtree | [Optional] [Defaults to `undefined`] |
+| **contentType** | `DocumentVersionContentTypeFilter` | Filter by content type: SECTION or CHUNK. Omit to return both types. | [Optional] [Defaults to `undefined`] [Enum: SECTION, CHUNK] |
 | **limit** | `number` | Number of items per page | [Optional] [Defaults to `20`] |
 | **offset** | `number` | Number of items to skip | [Optional] [Defaults to `0`] |
 | **authorization** | `string` |  | [Optional] [Defaults to `undefined`] |

package/docs/EnrichedThreadMessageContent.md

@@ -8,7 +8,9 @@ ThreadMessageContent with enriched citations for API responses.
 Name | Type
 ------------ | -------------
 `text` | string
+`isError` | boolean
 `citations` | [Array<EnrichedCitation>](EnrichedCitation.md)
+`references` | [Array<ResolvedReferenceOutput>](ResolvedReferenceOutput.md)
 
 ## Example
 
@@ -18,7 +20,9 @@ import type { EnrichedThreadMessageContent } from '@knowledge-stack/ksapi'
 // TODO: Update the object below with actual values
 const example = {
   "text": null,
+  "isError": null,
   "citations": null,
+  "references": null,
 } satisfies EnrichedThreadMessageContent
 
 console.log(example)

package/docs/NonFilesystemReferenceType.md

@@ -0,0 +1,33 @@
+
+# NonFilesystemReferenceType
+
+Supported reference types that do not map to filesystem PartType.
+
+## Properties
+
+Name | Type
+------------ | -------------
+
+## Example
+
+```typescript
+import type { NonFilesystemReferenceType } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+} satisfies NonFilesystemReferenceType
+
+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 NonFilesystemReferenceType
+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/ReferenceType.md

@@ -0,0 +1,32 @@
+
+# ReferenceType
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+
+## Example
+
+```typescript
+import type { ReferenceType } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+} satisfies ReferenceType
+
+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 ReferenceType
+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/ResolvedReferenceInput.md

@@ -0,0 +1,41 @@
+
+# ResolvedReferenceInput
+
+A parsed reference enriched with display name and path from the database.  Uses ``extra=\"ignore\"`` (not ``\"forbid\"``) because SDK dicts may contain fields not yet modelled here.  Adding ``\"forbid\"`` would cause runtime deserialization failures whenever the SDK adds a new field.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`refType` | [ReferenceType](ReferenceType.md)
+`entityId` | string
+`displayName` | string
+`materializedPath` | string
+
+## Example
+
+```typescript
+import type { ResolvedReferenceInput } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "refType": null,
+  "entityId": null,
+  "displayName": null,
+  "materializedPath": null,
+} satisfies ResolvedReferenceInput
+
+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 ResolvedReferenceInput
+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/ResolvedReferenceOutput.md

@@ -0,0 +1,41 @@
+
+# ResolvedReferenceOutput
+
+A parsed reference enriched with display name and path from the database.  Uses ``extra=\"ignore\"`` (not ``\"forbid\"``) because SDK dicts may contain fields not yet modelled here.  Adding ``\"forbid\"`` would cause runtime deserialization failures whenever the SDK adds a new field.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`refType` | string
+`entityId` | string
+`displayName` | string
+`materializedPath` | string
+
+## Example
+
+```typescript
+import type { ResolvedReferenceOutput } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "refType": null,
+  "entityId": null,
+  "displayName": null,
+  "materializedPath": null,
+} satisfies ResolvedReferenceOutput
+
+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 ResolvedReferenceOutput
+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/StepInput.md

@@ -6,6 +6,7 @@
 
 Name | Type
 ------------ | -------------
+`id` | string
 `name` | string
 `kind` | [StepKind](StepKind.md)
 `args` | [Args](Args.md)
@@ -21,6 +22,7 @@ import type { StepInput } from '@knowledge-stack/ksapi'
 
 // TODO: Update the object below with actual values
 const example = {
+  "id": null,
   "name": null,
   "kind": null,
   "args": null,

package/docs/StepOutput.md

@@ -6,6 +6,7 @@
 
 Name | Type
 ------------ | -------------
+`id` | string
 `name` | string
 `kind` | [StepKind](StepKind.md)
 `args` | [Args](Args.md)
@@ -21,6 +22,7 @@ import type { StepOutput } from '@knowledge-stack/ksapi'
 
 // TODO: Update the object below with actual values
 const example = {
+  "id": null,
   "name": null,
   "kind": null,
   "args": null,

package/docs/ThreadMessageContent.md

@@ -7,7 +7,9 @@
 Name | Type
 ------------ | -------------
 `text` | string
+`isError` | boolean
 `citations` | [Array<Citation>](Citation.md)
+`references` | [Array<ResolvedReferenceInput>](ResolvedReferenceInput.md)
 
 ## Example
 
@@ -17,7 +19,9 @@ import type { ThreadMessageContent } from '@knowledge-stack/ksapi'
 // TODO: Update the object below with actual values
 const example = {
   "text": null,
+  "isError": null,
   "citations": null,
+  "references": null,
 } satisfies ThreadMessageContent
 
 console.log(example)

package/docs/ThreadMessagesApi.md

@@ -173,7 +173,7 @@ No authorization required
 
 List Thread Messages Handler
 
-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.
 
 ### Example
 
@@ -193,7 +193,7 @@ async function example() {
     threadId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
     // Date | Cursor for keyset pagination: only return messages with created_at < this value (optional)
     before: 2013-10-20T19:20:30+01:00,
-    // boolean | Include execution steps in response (default false to reduce payload size) (optional)
+    // boolean | Include execution steps in response (default true) (optional)
     withDetails: true,
     // number | Number of items per page (optional)
     limit: 56,
@@ -224,7 +224,7 @@ example().catch(console.error);
 |------------- | ------------- | ------------- | -------------|
 | **threadId** | `string` |  | [Defaults to `undefined`] |
 | **before** | `Date` | Cursor for keyset pagination: only return messages with created_at &lt; this value | [Optional] [Defaults to `undefined`] |
-| **withDetails** | `boolean` | Include execution steps in response (default false to reduce payload size) | [Optional] [Defaults to `false`] |
+| **withDetails** | `boolean` | Include execution steps in response (default true) | [Optional] [Defaults to `true`] |
 | **limit** | `number` | Number of items per page | [Optional] [Defaults to `20`] |
 | **offset** | `number` | Number of items to skip | [Optional] [Defaults to `0`] |
 | **authorization** | `string` |  | [Optional] [Defaults to `undefined`] |

package/package.json

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

package/src/apis/DocumentVersionsApi.ts

@@ -18,6 +18,7 @@ import type {
   ClearVersionContentsResponse,
   DocumentVersionAction,
   DocumentVersionActionResponse,
+  DocumentVersionContentTypeFilter,
   DocumentVersionMetadataUpdate,
   DocumentVersionResponse,
   HTTPValidationError,
@@ -31,6 +32,8 @@ import {
     DocumentVersionActionToJSON,
     DocumentVersionActionResponseFromJSON,
     DocumentVersionActionResponseToJSON,
+    DocumentVersionContentTypeFilterFromJSON,
+    DocumentVersionContentTypeFilterToJSON,
     DocumentVersionMetadataUpdateFromJSON,
     DocumentVersionMetadataUpdateToJSON,
     DocumentVersionResponseFromJSON,
@@ -77,6 +80,7 @@ export interface GetDocumentVersionRequest {
 export interface GetDocumentVersionContentsRequest {
     versionId: string;
     sectionId?: string | null;
+    contentType?: DocumentVersionContentTypeFilter;
     limit?: number;
     offset?: number;
     authorization?: string | null;
@@ -251,6 +255,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] 
@@ -261,10 +266,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] 
@@ -276,7 +282,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>;
@@ -632,6 +638,10 @@ export class DocumentVersionsApi extends runtime.BaseAPI implements DocumentVers
             queryParameters['section_id'] = requestParameters['sectionId'];
         }
 
+        if (requestParameters['contentType'] != null) {
+            queryParameters['content_type'] = requestParameters['contentType'];
+        }
+
         if (requestParameters['limit'] != null) {
             queryParameters['limit'] = requestParameters['limit'];
         }
@@ -659,7 +669,7 @@ export class DocumentVersionsApi extends runtime.BaseAPI implements DocumentVers
     }
 
     /**
-     * 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
      */
     async getDocumentVersionContentsRaw(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator>> {
@@ -670,7 +680,7 @@ export class DocumentVersionsApi extends runtime.BaseAPI implements DocumentVers
     }
 
     /**
-     * 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
      */
     async getDocumentVersionContents(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator> {

package/src/apis/ThreadMessagesApi.ts

@@ -129,7 +129,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] 
@@ -140,11 +140,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] 
@@ -156,7 +156,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>;
@@ -340,7 +340,7 @@ export class ThreadMessagesApi extends runtime.BaseAPI implements ThreadMessages
     }
 
     /**
-     * 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
      */
     async listThreadMessagesRaw(requestParameters: ListThreadMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseThreadMessageResponse>> {
@@ -351,7 +351,7 @@ export class ThreadMessagesApi extends runtime.BaseAPI implements ThreadMessages
     }
 
     /**
-     * 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
      */
     async listThreadMessages(requestParameters: ListThreadMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseThreadMessageResponse> {

package/src/models/CreateThreadMessageRequest.ts

@@ -41,6 +41,12 @@ import {
  * @interface CreateThreadMessageRequest
  */
 export interface CreateThreadMessageRequest {
+    /**
+     * Optional caller-supplied ThreadMessage ID for idempotent creates.
+     * @type {string}
+     * @memberof CreateThreadMessageRequest
+     */
+    messageId?: string | null;
     /**
      * 
      * @type {MessageRole}
@@ -82,6 +88,7 @@ export function CreateThreadMessageRequestFromJSONTyped(json: any, ignoreDiscrim
     }
     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']),
@@ -99,6 +106,7 @@ export function CreateThreadMessageRequestToJSONTyped(value?: CreateThreadMessag
 
     return {
         
+        'message_id': value['messageId'],
         'role': MessageRoleToJSON(value['role']),
         'content': ThreadMessageContentToJSON(value['content']),
         'details': ThreadMessageDetailsInputToJSON(value['details']),