@knowledge-stack/ksapi 1.8.0 → 1.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (98) hide show
  1. package/.openapi-generator/FILES +14 -0
  2. package/README.md +2 -2
  3. package/dist/apis/DocumentVersionsApi.d.ts +36 -1
  4. package/dist/apis/DocumentVersionsApi.js +41 -0
  5. package/dist/apis/FoldersApi.d.ts +38 -1
  6. package/dist/apis/FoldersApi.js +44 -0
  7. package/dist/apis/PathPartsApi.d.ts +4 -6
  8. package/dist/apis/PathPartsApi.js +2 -5
  9. package/dist/apis/ThreadMessagesApi.d.ts +123 -0
  10. package/dist/apis/ThreadMessagesApi.js +147 -0
  11. package/dist/apis/ThreadsApi.d.ts +177 -0
  12. package/dist/apis/ThreadsApi.js +203 -0
  13. package/dist/apis/index.d.ts +2 -0
  14. package/dist/apis/index.js +2 -0
  15. package/dist/esm/apis/DocumentVersionsApi.d.ts +36 -1
  16. package/dist/esm/apis/DocumentVersionsApi.js +42 -1
  17. package/dist/esm/apis/FoldersApi.d.ts +38 -1
  18. package/dist/esm/apis/FoldersApi.js +45 -1
  19. package/dist/esm/apis/PathPartsApi.d.ts +4 -6
  20. package/dist/esm/apis/PathPartsApi.js +2 -5
  21. package/dist/esm/apis/ThreadMessagesApi.d.ts +123 -0
  22. package/dist/esm/apis/ThreadMessagesApi.js +143 -0
  23. package/dist/esm/apis/ThreadsApi.d.ts +177 -0
  24. package/dist/esm/apis/ThreadsApi.js +199 -0
  25. package/dist/esm/apis/index.d.ts +2 -0
  26. package/dist/esm/apis/index.js +2 -0
  27. package/dist/esm/models/CreateThreadMessageRequest.d.ts +58 -0
  28. package/dist/esm/models/CreateThreadMessageRequest.js +50 -0
  29. package/dist/esm/models/CreateThreadRequest.d.ts +53 -0
  30. package/dist/esm/models/CreateThreadRequest.js +49 -0
  31. package/dist/esm/models/DocumentContentPathPart.d.ts +119 -0
  32. package/dist/esm/models/DocumentContentPathPart.js +83 -0
  33. package/dist/esm/models/FolderDocumentResponse.d.ts +138 -0
  34. package/dist/esm/models/FolderDocumentResponse.js +88 -0
  35. package/dist/esm/models/MessageRole.d.ts +26 -0
  36. package/dist/esm/models/MessageRole.js +44 -0
  37. package/dist/esm/models/PaginatedResponseDocumentContentPathPart.d.ts +66 -0
  38. package/dist/esm/models/PaginatedResponseDocumentContentPathPart.js +70 -0
  39. package/dist/esm/models/PaginatedResponseFolderDocumentResponse.d.ts +66 -0
  40. package/dist/esm/models/PaginatedResponseFolderDocumentResponse.js +70 -0
  41. package/dist/esm/models/PaginatedResponseThreadMessageResponse.d.ts +66 -0
  42. package/dist/esm/models/PaginatedResponseThreadMessageResponse.js +70 -0
  43. package/dist/esm/models/PaginatedResponseThreadResponse.d.ts +66 -0
  44. package/dist/esm/models/PaginatedResponseThreadResponse.js +70 -0
  45. package/dist/esm/models/ThreadMessageResponse.d.ts +100 -0
  46. package/dist/esm/models/ThreadMessageResponse.js +78 -0
  47. package/dist/esm/models/ThreadResponse.d.ts +83 -0
  48. package/dist/esm/models/ThreadResponse.js +66 -0
  49. package/dist/esm/models/UpdateThreadRequest.d.ts +53 -0
  50. package/dist/esm/models/UpdateThreadRequest.js +49 -0
  51. package/dist/esm/models/index.d.ts +12 -0
  52. package/dist/esm/models/index.js +12 -0
  53. package/dist/models/CreateThreadMessageRequest.d.ts +58 -0
  54. package/dist/models/CreateThreadMessageRequest.js +58 -0
  55. package/dist/models/CreateThreadRequest.d.ts +53 -0
  56. package/dist/models/CreateThreadRequest.js +57 -0
  57. package/dist/models/DocumentContentPathPart.d.ts +119 -0
  58. package/dist/models/DocumentContentPathPart.js +91 -0
  59. package/dist/models/FolderDocumentResponse.d.ts +138 -0
  60. package/dist/models/FolderDocumentResponse.js +96 -0
  61. package/dist/models/MessageRole.d.ts +26 -0
  62. package/dist/models/MessageRole.js +52 -0
  63. package/dist/models/PaginatedResponseDocumentContentPathPart.d.ts +66 -0
  64. package/dist/models/PaginatedResponseDocumentContentPathPart.js +78 -0
  65. package/dist/models/PaginatedResponseFolderDocumentResponse.d.ts +66 -0
  66. package/dist/models/PaginatedResponseFolderDocumentResponse.js +78 -0
  67. package/dist/models/PaginatedResponseThreadMessageResponse.d.ts +66 -0
  68. package/dist/models/PaginatedResponseThreadMessageResponse.js +78 -0
  69. package/dist/models/PaginatedResponseThreadResponse.d.ts +66 -0
  70. package/dist/models/PaginatedResponseThreadResponse.js +78 -0
  71. package/dist/models/ThreadMessageResponse.d.ts +100 -0
  72. package/dist/models/ThreadMessageResponse.js +86 -0
  73. package/dist/models/ThreadResponse.d.ts +83 -0
  74. package/dist/models/ThreadResponse.js +74 -0
  75. package/dist/models/UpdateThreadRequest.d.ts +53 -0
  76. package/dist/models/UpdateThreadRequest.js +57 -0
  77. package/dist/models/index.d.ts +12 -0
  78. package/dist/models/index.js +12 -0
  79. package/package.json +1 -1
  80. package/src/apis/DocumentVersionsApi.ts +82 -0
  81. package/src/apis/FoldersApi.ts +88 -0
  82. package/src/apis/PathPartsApi.ts +4 -10
  83. package/src/apis/ThreadMessagesApi.ts +271 -0
  84. package/src/apis/ThreadsApi.ts +377 -0
  85. package/src/apis/index.ts +2 -0
  86. package/src/models/CreateThreadMessageRequest.ts +105 -0
  87. package/src/models/CreateThreadRequest.ts +94 -0
  88. package/src/models/DocumentContentPathPart.ts +205 -0
  89. package/src/models/FolderDocumentResponse.ts +234 -0
  90. package/src/models/MessageRole.ts +54 -0
  91. package/src/models/PaginatedResponseDocumentContentPathPart.ts +130 -0
  92. package/src/models/PaginatedResponseFolderDocumentResponse.ts +130 -0
  93. package/src/models/PaginatedResponseThreadMessageResponse.ts +130 -0
  94. package/src/models/PaginatedResponseThreadResponse.ts +130 -0
  95. package/src/models/ThreadMessageResponse.ts +168 -0
  96. package/src/models/ThreadResponse.ts +136 -0
  97. package/src/models/UpdateThreadRequest.ts +94 -0
  98. package/src/models/index.ts +12 -0
@@ -17,6 +17,7 @@ import * as runtime from '../runtime';
17
17
  import type {
18
18
  DocumentVersionResponse,
19
19
  HTTPValidationError,
20
+ PaginatedResponseDocumentContentPathPart,
20
21
  PaginatedResponseDocumentVersionResponse,
21
22
  } from '../models/index';
22
23
  import {
@@ -24,6 +25,8 @@ import {
24
25
  DocumentVersionResponseToJSON,
25
26
  HTTPValidationErrorFromJSON,
26
27
  HTTPValidationErrorToJSON,
28
+ PaginatedResponseDocumentContentPathPartFromJSON,
29
+ PaginatedResponseDocumentContentPathPartToJSON,
27
30
  PaginatedResponseDocumentVersionResponseFromJSON,
28
31
  PaginatedResponseDocumentVersionResponseToJSON,
29
32
  } from '../models/index';
@@ -43,6 +46,14 @@ export interface GetDocumentVersionRequest {
43
46
  ksUat?: string;
44
47
  }
45
48
 
49
+ export interface GetDocumentVersionContentsRequest {
50
+ versionId: string;
51
+ sectionId?: string;
52
+ limit?: number;
53
+ offset?: number;
54
+ ksUat?: string;
55
+ }
56
+
46
57
  export interface ListDocumentVersionsRequest {
47
58
  documentId: string;
48
59
  limit?: number;
@@ -108,6 +119,26 @@ export interface DocumentVersionsApiInterface {
108
119
  */
109
120
  getDocumentVersion(requestParameters: GetDocumentVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionResponse>;
110
121
 
122
+ /**
123
+ * List all sections and chunks for a document version in depth-first logical order. Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
124
+ * @summary Get Document Version Contents Handler
125
+ * @param {string} versionId DocumentVersion ID
126
+ * @param {string} [sectionId] Optional section ID to scope traversal to a subtree
127
+ * @param {number} [limit] Number of items per page
128
+ * @param {number} [offset] Number of items to skip
129
+ * @param {string} [ksUat]
130
+ * @param {*} [options] Override http request option.
131
+ * @throws {RequiredError}
132
+ * @memberof DocumentVersionsApiInterface
133
+ */
134
+ getDocumentVersionContentsRaw(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseDocumentContentPathPart>>;
135
+
136
+ /**
137
+ * List all sections and chunks for a document version in depth-first logical order. Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
138
+ * Get Document Version Contents Handler
139
+ */
140
+ getDocumentVersionContents(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseDocumentContentPathPart>;
141
+
111
142
  /**
112
143
  * List all versions for a document. Returns versions ordered by version number ascending (v0, v1, v2...).
113
144
  * @summary List Document Versions Handler
@@ -250,6 +281,57 @@ export class DocumentVersionsApi extends runtime.BaseAPI implements DocumentVers
250
281
  return await response.value();
251
282
  }
252
283
 
284
+ /**
285
+ * List all sections and chunks for a document version in depth-first logical order. Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
286
+ * Get Document Version Contents Handler
287
+ */
288
+ async getDocumentVersionContentsRaw(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseDocumentContentPathPart>> {
289
+ if (requestParameters['versionId'] == null) {
290
+ throw new runtime.RequiredError(
291
+ 'versionId',
292
+ 'Required parameter "versionId" was null or undefined when calling getDocumentVersionContents().'
293
+ );
294
+ }
295
+
296
+ const queryParameters: any = {};
297
+
298
+ if (requestParameters['sectionId'] != null) {
299
+ queryParameters['section_id'] = requestParameters['sectionId'];
300
+ }
301
+
302
+ if (requestParameters['limit'] != null) {
303
+ queryParameters['limit'] = requestParameters['limit'];
304
+ }
305
+
306
+ if (requestParameters['offset'] != null) {
307
+ queryParameters['offset'] = requestParameters['offset'];
308
+ }
309
+
310
+ const headerParameters: runtime.HTTPHeaders = {};
311
+
312
+
313
+ let urlPath = `/v1/document_versions/{version_id}/contents`;
314
+ urlPath = urlPath.replace(`{${"version_id"}}`, encodeURIComponent(String(requestParameters['versionId'])));
315
+
316
+ const response = await this.request({
317
+ path: urlPath,
318
+ method: 'GET',
319
+ headers: headerParameters,
320
+ query: queryParameters,
321
+ }, initOverrides);
322
+
323
+ return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseDocumentContentPathPartFromJSON(jsonValue));
324
+ }
325
+
326
+ /**
327
+ * List all sections and chunks for a document version in depth-first logical order. Returns a flat paginated list that can be used to reconstruct the section/chunk hierarchy with content. Sections include page_number; chunks include content, chunk_type, and chunk_metadata.
328
+ * Get Document Version Contents Handler
329
+ */
330
+ async getDocumentVersionContents(requestParameters: GetDocumentVersionContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseDocumentContentPathPart> {
331
+ const response = await this.getDocumentVersionContentsRaw(requestParameters, initOverrides);
332
+ return await response.value();
333
+ }
334
+
253
335
  /**
254
336
  * List all versions for a document. Returns versions ordered by version number ascending (v0, v1, v2...).
255
337
  * List Document Versions Handler
@@ -18,6 +18,7 @@ import type {
18
18
  CreateFolderRequest,
19
19
  FolderResponse,
20
20
  HTTPValidationError,
21
+ PaginatedResponseFolderDocumentResponse,
21
22
  PaginatedResponseFolderResponse,
22
23
  PathOrder,
23
24
  UpdateFolderRequest,
@@ -29,6 +30,8 @@ import {
29
30
  FolderResponseToJSON,
30
31
  HTTPValidationErrorFromJSON,
31
32
  HTTPValidationErrorToJSON,
33
+ PaginatedResponseFolderDocumentResponseFromJSON,
34
+ PaginatedResponseFolderDocumentResponseToJSON,
32
35
  PaginatedResponseFolderResponseFromJSON,
33
36
  PaginatedResponseFolderResponseToJSON,
34
37
  PathOrderFromJSON,
@@ -52,6 +55,15 @@ export interface GetFolderRequest {
52
55
  ksUat?: string;
53
56
  }
54
57
 
58
+ export interface ListFolderContentsRequest {
59
+ folderId: string;
60
+ maxDepth?: number;
61
+ sortOrder?: PathOrder;
62
+ limit?: number;
63
+ offset?: number;
64
+ ksUat?: string;
65
+ }
66
+
55
67
  export interface ListFoldersRequest {
56
68
  parentId?: string;
57
69
  sortOrder?: PathOrder;
@@ -124,6 +136,27 @@ export interface FoldersApiInterface {
124
136
  */
125
137
  getFolder(requestParameters: GetFolderRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FolderResponse>;
126
138
 
139
+ /**
140
+ * List all contents (folders and documents) under a folder. Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
141
+ * @summary List Folder Contents Handler
142
+ * @param {string} folderId
143
+ * @param {number} [maxDepth] Maximum depth to traverse (1&#x3D;direct children, default: 1)
144
+ * @param {PathOrder} [sortOrder] Sort order for results (default: LOGICAL)
145
+ * @param {number} [limit] Number of items per page
146
+ * @param {number} [offset] Number of items to skip
147
+ * @param {string} [ksUat]
148
+ * @param {*} [options] Override http request option.
149
+ * @throws {RequiredError}
150
+ * @memberof FoldersApiInterface
151
+ */
152
+ listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseFolderDocumentResponse>>;
153
+
154
+ /**
155
+ * List all contents (folders and documents) under a folder. Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
156
+ * List Folder Contents Handler
157
+ */
158
+ listFolderContents(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseFolderDocumentResponse>;
159
+
127
160
  /**
128
161
  * List child folders of a parent folder. Returns only direct child folders (depth=1) of the specified parent. If parent_id is not provided, lists folders in the root folder.
129
162
  * @summary List Folders Handler
@@ -287,6 +320,61 @@ export class FoldersApi extends runtime.BaseAPI implements FoldersApiInterface {
287
320
  return await response.value();
288
321
  }
289
322
 
323
+ /**
324
+ * List all contents (folders and documents) under a folder. Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
325
+ * List Folder Contents Handler
326
+ */
327
+ async listFolderContentsRaw(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseFolderDocumentResponse>> {
328
+ if (requestParameters['folderId'] == null) {
329
+ throw new runtime.RequiredError(
330
+ 'folderId',
331
+ 'Required parameter "folderId" was null or undefined when calling listFolderContents().'
332
+ );
333
+ }
334
+
335
+ const queryParameters: any = {};
336
+
337
+ if (requestParameters['maxDepth'] != null) {
338
+ queryParameters['max_depth'] = requestParameters['maxDepth'];
339
+ }
340
+
341
+ if (requestParameters['sortOrder'] != null) {
342
+ queryParameters['sort_order'] = requestParameters['sortOrder'];
343
+ }
344
+
345
+ if (requestParameters['limit'] != null) {
346
+ queryParameters['limit'] = requestParameters['limit'];
347
+ }
348
+
349
+ if (requestParameters['offset'] != null) {
350
+ queryParameters['offset'] = requestParameters['offset'];
351
+ }
352
+
353
+ const headerParameters: runtime.HTTPHeaders = {};
354
+
355
+
356
+ let urlPath = `/v1/folders/{folder_id}/contents`;
357
+ urlPath = urlPath.replace(`{${"folder_id"}}`, encodeURIComponent(String(requestParameters['folderId'])));
358
+
359
+ const response = await this.request({
360
+ path: urlPath,
361
+ method: 'GET',
362
+ headers: headerParameters,
363
+ query: queryParameters,
364
+ }, initOverrides);
365
+
366
+ return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseFolderDocumentResponseFromJSON(jsonValue));
367
+ }
368
+
369
+ /**
370
+ * List all contents (folders and documents) under a folder. Returns enriched responses with: - Folders: basic folder metadata - Documents: full document metadata including document_type, document_origin, active_version This is the preferred way to list folder contents when you need document metadata. For generic path traversal of folders only, use GET /path-parts.
371
+ * List Folder Contents Handler
372
+ */
373
+ async listFolderContents(requestParameters: ListFolderContentsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseFolderDocumentResponse> {
374
+ const response = await this.listFolderContentsRaw(requestParameters, initOverrides);
375
+ return await response.value();
376
+ }
377
+
290
378
  /**
291
379
  * List child folders of a parent folder. Returns only direct child folders (depth=1) of the specified parent. If parent_id is not provided, lists folders in the root folder.
292
380
  * List Folders Handler
@@ -38,7 +38,6 @@ export interface GetPathPartRequest {
38
38
 
39
39
  export interface ListPathPartsRequest {
40
40
  parentId?: string;
41
- includeDocuments?: boolean;
42
41
  maxDepth?: number;
43
42
  sortOrder?: PathOrder;
44
43
  limit?: number;
@@ -71,10 +70,9 @@ export interface PathPartsApiInterface {
71
70
  getPathPart(requestParameters: GetPathPartRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartResponse>;
72
71
 
73
72
  /**
74
- * List path parts under a parent with flexible filtering and traversal. This is a generic endpoint for traversing the path hierarchy. It can return folders, documents, or both depending on the filters provided. - If parent_id is not provided, lists contents of the root folder. - If include_documents is True, includes both FOLDER and DOCUMENT types. Documents act as traversal boundaries (their children are not traversed). - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.
73
+ * List path parts (folders) under a parent with traversal. This is a generic endpoint for traversing the folder hierarchy. It returns only FOLDER type path parts. - If parent_id is not provided, lists contents of the root folder. - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT. For listing folder contents that includes documents with enriched metadata, use GET /folders/{folder_id}/contents instead.
75
74
  * @summary List Path Parts Handler
76
75
  * @param {string} [parentId] Parent PathPart ID (defaults to root)
77
- * @param {boolean} [includeDocuments] Include documents in results (default: False, folders only)
78
76
  * @param {number} [maxDepth] Maximum depth to traverse (1 &#x3D; direct children, default: 1)
79
77
  * @param {PathOrder} [sortOrder] Sort order for results (default: LOGICAL)
80
78
  * @param {number} [limit] Number of items per page
@@ -87,7 +85,7 @@ export interface PathPartsApiInterface {
87
85
  listPathPartsRaw(requestParameters: ListPathPartsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponsePathPartResponse>>;
88
86
 
89
87
  /**
90
- * List path parts under a parent with flexible filtering and traversal. This is a generic endpoint for traversing the path hierarchy. It can return folders, documents, or both depending on the filters provided. - If parent_id is not provided, lists contents of the root folder. - If include_documents is True, includes both FOLDER and DOCUMENT types. Documents act as traversal boundaries (their children are not traversed). - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.
88
+ * List path parts (folders) under a parent with traversal. This is a generic endpoint for traversing the folder hierarchy. It returns only FOLDER type path parts. - If parent_id is not provided, lists contents of the root folder. - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT. For listing folder contents that includes documents with enriched metadata, use GET /folders/{folder_id}/contents instead.
91
89
  * List Path Parts Handler
92
90
  */
93
91
  listPathParts(requestParameters: ListPathPartsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponsePathPartResponse>;
@@ -139,7 +137,7 @@ export class PathPartsApi extends runtime.BaseAPI implements PathPartsApiInterfa
139
137
  }
140
138
 
141
139
  /**
142
- * List path parts under a parent with flexible filtering and traversal. This is a generic endpoint for traversing the path hierarchy. It can return folders, documents, or both depending on the filters provided. - If parent_id is not provided, lists contents of the root folder. - If include_documents is True, includes both FOLDER and DOCUMENT types. Documents act as traversal boundaries (their children are not traversed). - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.
140
+ * List path parts (folders) under a parent with traversal. This is a generic endpoint for traversing the folder hierarchy. It returns only FOLDER type path parts. - If parent_id is not provided, lists contents of the root folder. - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT. For listing folder contents that includes documents with enriched metadata, use GET /folders/{folder_id}/contents instead.
143
141
  * List Path Parts Handler
144
142
  */
145
143
  async listPathPartsRaw(requestParameters: ListPathPartsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponsePathPartResponse>> {
@@ -149,10 +147,6 @@ export class PathPartsApi extends runtime.BaseAPI implements PathPartsApiInterfa
149
147
  queryParameters['parent_id'] = requestParameters['parentId'];
150
148
  }
151
149
 
152
- if (requestParameters['includeDocuments'] != null) {
153
- queryParameters['include_documents'] = requestParameters['includeDocuments'];
154
- }
155
-
156
150
  if (requestParameters['maxDepth'] != null) {
157
151
  queryParameters['max_depth'] = requestParameters['maxDepth'];
158
152
  }
@@ -185,7 +179,7 @@ export class PathPartsApi extends runtime.BaseAPI implements PathPartsApiInterfa
185
179
  }
186
180
 
187
181
  /**
188
- * List path parts under a parent with flexible filtering and traversal. This is a generic endpoint for traversing the path hierarchy. It can return folders, documents, or both depending on the filters provided. - If parent_id is not provided, lists contents of the root folder. - If include_documents is True, includes both FOLDER and DOCUMENT types. Documents act as traversal boundaries (their children are not traversed). - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT.
182
+ * List path parts (folders) under a parent with traversal. This is a generic endpoint for traversing the folder hierarchy. It returns only FOLDER type path parts. - If parent_id is not provided, lists contents of the root folder. - max_depth controls how deep to traverse (1 = direct children only). - sort_order controls the ordering: LOGICAL (linked-list), NAME, UPDATED_AT, CREATED_AT. For listing folder contents that includes documents with enriched metadata, use GET /folders/{folder_id}/contents instead.
189
183
  * List Path Parts Handler
190
184
  */
191
185
  async listPathParts(requestParameters: ListPathPartsRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponsePathPartResponse> {
@@ -0,0 +1,271 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * Knowledge Stack API
5
+ * Knowledge Stack backend API for authentication and knowledge management
6
+ *
7
+ * The version of the OpenAPI document: 0.1.0
8
+ *
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+
15
+
16
+ import * as runtime from '../runtime';
17
+ import type {
18
+ CreateThreadMessageRequest,
19
+ HTTPValidationError,
20
+ PaginatedResponseThreadMessageResponse,
21
+ ThreadMessageResponse,
22
+ } from '../models/index';
23
+ import {
24
+ CreateThreadMessageRequestFromJSON,
25
+ CreateThreadMessageRequestToJSON,
26
+ HTTPValidationErrorFromJSON,
27
+ HTTPValidationErrorToJSON,
28
+ PaginatedResponseThreadMessageResponseFromJSON,
29
+ PaginatedResponseThreadMessageResponseToJSON,
30
+ ThreadMessageResponseFromJSON,
31
+ ThreadMessageResponseToJSON,
32
+ } from '../models/index';
33
+
34
+ export interface CreateThreadMessageOperationRequest {
35
+ threadId: string;
36
+ createThreadMessageRequest: CreateThreadMessageRequest;
37
+ ksUat?: string;
38
+ }
39
+
40
+ export interface GetThreadMessageRequest {
41
+ threadId: string;
42
+ messageId: string;
43
+ ksUat?: string;
44
+ }
45
+
46
+ export interface ListThreadMessagesRequest {
47
+ threadId: string;
48
+ before?: Date;
49
+ limit?: number;
50
+ offset?: number;
51
+ ksUat?: string;
52
+ }
53
+
54
+ /**
55
+ * ThreadMessagesApi - interface
56
+ *
57
+ * @export
58
+ * @interface ThreadMessagesApiInterface
59
+ */
60
+ export interface ThreadMessagesApiInterface {
61
+ /**
62
+ * Create a new message in a thread.
63
+ * @summary Create Thread Message Handler
64
+ * @param {string} threadId
65
+ * @param {CreateThreadMessageRequest} createThreadMessageRequest
66
+ * @param {string} [ksUat]
67
+ * @param {*} [options] Override http request option.
68
+ * @throws {RequiredError}
69
+ * @memberof ThreadMessagesApiInterface
70
+ */
71
+ createThreadMessageRaw(requestParameters: CreateThreadMessageOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ThreadMessageResponse>>;
72
+
73
+ /**
74
+ * Create a new message in a thread.
75
+ * Create Thread Message Handler
76
+ */
77
+ createThreadMessage(requestParameters: CreateThreadMessageOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ThreadMessageResponse>;
78
+
79
+ /**
80
+ * Get a specific message by its ID.
81
+ * @summary Get Thread Message Handler
82
+ * @param {string} threadId
83
+ * @param {string} messageId
84
+ * @param {string} [ksUat]
85
+ * @param {*} [options] Override http request option.
86
+ * @throws {RequiredError}
87
+ * @memberof ThreadMessagesApiInterface
88
+ */
89
+ getThreadMessageRaw(requestParameters: GetThreadMessageRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ThreadMessageResponse>>;
90
+
91
+ /**
92
+ * Get a specific message by its ID.
93
+ * Get Thread Message Handler
94
+ */
95
+ getThreadMessage(requestParameters: GetThreadMessageRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ThreadMessageResponse>;
96
+
97
+ /**
98
+ * 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`.
99
+ * @summary List Thread Messages Handler
100
+ * @param {string} threadId
101
+ * @param {Date} [before] Cursor for keyset pagination: only return messages with created_at &lt; this value
102
+ * @param {number} [limit] Number of items per page
103
+ * @param {number} [offset] Number of items to skip
104
+ * @param {string} [ksUat]
105
+ * @param {*} [options] Override http request option.
106
+ * @throws {RequiredError}
107
+ * @memberof ThreadMessagesApiInterface
108
+ */
109
+ listThreadMessagesRaw(requestParameters: ListThreadMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseThreadMessageResponse>>;
110
+
111
+ /**
112
+ * 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`.
113
+ * List Thread Messages Handler
114
+ */
115
+ listThreadMessages(requestParameters: ListThreadMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseThreadMessageResponse>;
116
+
117
+ }
118
+
119
+ /**
120
+ *
121
+ */
122
+ export class ThreadMessagesApi extends runtime.BaseAPI implements ThreadMessagesApiInterface {
123
+
124
+ /**
125
+ * Create a new message in a thread.
126
+ * Create Thread Message Handler
127
+ */
128
+ async createThreadMessageRaw(requestParameters: CreateThreadMessageOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ThreadMessageResponse>> {
129
+ if (requestParameters['threadId'] == null) {
130
+ throw new runtime.RequiredError(
131
+ 'threadId',
132
+ 'Required parameter "threadId" was null or undefined when calling createThreadMessage().'
133
+ );
134
+ }
135
+
136
+ if (requestParameters['createThreadMessageRequest'] == null) {
137
+ throw new runtime.RequiredError(
138
+ 'createThreadMessageRequest',
139
+ 'Required parameter "createThreadMessageRequest" was null or undefined when calling createThreadMessage().'
140
+ );
141
+ }
142
+
143
+ const queryParameters: any = {};
144
+
145
+ const headerParameters: runtime.HTTPHeaders = {};
146
+
147
+ headerParameters['Content-Type'] = 'application/json';
148
+
149
+
150
+ let urlPath = `/v1/threads/{thread_id}/messages`;
151
+ urlPath = urlPath.replace(`{${"thread_id"}}`, encodeURIComponent(String(requestParameters['threadId'])));
152
+
153
+ const response = await this.request({
154
+ path: urlPath,
155
+ method: 'POST',
156
+ headers: headerParameters,
157
+ query: queryParameters,
158
+ body: CreateThreadMessageRequestToJSON(requestParameters['createThreadMessageRequest']),
159
+ }, initOverrides);
160
+
161
+ return new runtime.JSONApiResponse(response, (jsonValue) => ThreadMessageResponseFromJSON(jsonValue));
162
+ }
163
+
164
+ /**
165
+ * Create a new message in a thread.
166
+ * Create Thread Message Handler
167
+ */
168
+ async createThreadMessage(requestParameters: CreateThreadMessageOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ThreadMessageResponse> {
169
+ const response = await this.createThreadMessageRaw(requestParameters, initOverrides);
170
+ return await response.value();
171
+ }
172
+
173
+ /**
174
+ * Get a specific message by its ID.
175
+ * Get Thread Message Handler
176
+ */
177
+ async getThreadMessageRaw(requestParameters: GetThreadMessageRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ThreadMessageResponse>> {
178
+ if (requestParameters['threadId'] == null) {
179
+ throw new runtime.RequiredError(
180
+ 'threadId',
181
+ 'Required parameter "threadId" was null or undefined when calling getThreadMessage().'
182
+ );
183
+ }
184
+
185
+ if (requestParameters['messageId'] == null) {
186
+ throw new runtime.RequiredError(
187
+ 'messageId',
188
+ 'Required parameter "messageId" was null or undefined when calling getThreadMessage().'
189
+ );
190
+ }
191
+
192
+ const queryParameters: any = {};
193
+
194
+ const headerParameters: runtime.HTTPHeaders = {};
195
+
196
+
197
+ let urlPath = `/v1/threads/{thread_id}/messages/{message_id}`;
198
+ urlPath = urlPath.replace(`{${"thread_id"}}`, encodeURIComponent(String(requestParameters['threadId'])));
199
+ urlPath = urlPath.replace(`{${"message_id"}}`, encodeURIComponent(String(requestParameters['messageId'])));
200
+
201
+ const response = await this.request({
202
+ path: urlPath,
203
+ method: 'GET',
204
+ headers: headerParameters,
205
+ query: queryParameters,
206
+ }, initOverrides);
207
+
208
+ return new runtime.JSONApiResponse(response, (jsonValue) => ThreadMessageResponseFromJSON(jsonValue));
209
+ }
210
+
211
+ /**
212
+ * Get a specific message by its ID.
213
+ * Get Thread Message Handler
214
+ */
215
+ async getThreadMessage(requestParameters: GetThreadMessageRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ThreadMessageResponse> {
216
+ const response = await this.getThreadMessageRaw(requestParameters, initOverrides);
217
+ return await response.value();
218
+ }
219
+
220
+ /**
221
+ * 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`.
222
+ * List Thread Messages Handler
223
+ */
224
+ async listThreadMessagesRaw(requestParameters: ListThreadMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseThreadMessageResponse>> {
225
+ if (requestParameters['threadId'] == null) {
226
+ throw new runtime.RequiredError(
227
+ 'threadId',
228
+ 'Required parameter "threadId" was null or undefined when calling listThreadMessages().'
229
+ );
230
+ }
231
+
232
+ const queryParameters: any = {};
233
+
234
+ if (requestParameters['before'] != null) {
235
+ queryParameters['before'] = (requestParameters['before'] as any).toISOString();
236
+ }
237
+
238
+ if (requestParameters['limit'] != null) {
239
+ queryParameters['limit'] = requestParameters['limit'];
240
+ }
241
+
242
+ if (requestParameters['offset'] != null) {
243
+ queryParameters['offset'] = requestParameters['offset'];
244
+ }
245
+
246
+ const headerParameters: runtime.HTTPHeaders = {};
247
+
248
+
249
+ let urlPath = `/v1/threads/{thread_id}/messages`;
250
+ urlPath = urlPath.replace(`{${"thread_id"}}`, encodeURIComponent(String(requestParameters['threadId'])));
251
+
252
+ const response = await this.request({
253
+ path: urlPath,
254
+ method: 'GET',
255
+ headers: headerParameters,
256
+ query: queryParameters,
257
+ }, initOverrides);
258
+
259
+ return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseThreadMessageResponseFromJSON(jsonValue));
260
+ }
261
+
262
+ /**
263
+ * 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`.
264
+ * List Thread Messages Handler
265
+ */
266
+ async listThreadMessages(requestParameters: ListThreadMessagesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseThreadMessageResponse> {
267
+ const response = await this.listThreadMessagesRaw(requestParameters, initOverrides);
268
+ return await response.value();
269
+ }
270
+
271
+ }