@knowledge-stack/ksapi 1.83.0 → 1.84.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 (127) hide show
  1. package/.openapi-generator/FILES +18 -0
  2. package/README.md +17 -2
  3. package/dist/apis/PathPartsApi.d.ts +110 -1
  4. package/dist/apis/PathPartsApi.js +111 -0
  5. package/dist/apis/WorkflowMemoryApi.d.ts +249 -0
  6. package/dist/apis/WorkflowMemoryApi.js +299 -0
  7. package/dist/apis/index.d.ts +1 -0
  8. package/dist/apis/index.js +1 -0
  9. package/dist/esm/apis/PathPartsApi.d.ts +110 -1
  10. package/dist/esm/apis/PathPartsApi.js +112 -1
  11. package/dist/esm/apis/WorkflowMemoryApi.d.ts +249 -0
  12. package/dist/esm/apis/WorkflowMemoryApi.js +262 -0
  13. package/dist/esm/apis/index.d.ts +1 -0
  14. package/dist/esm/apis/index.js +1 -0
  15. package/dist/esm/models/AppendEventRequest.d.ts +62 -0
  16. package/dist/esm/models/AppendEventRequest.js +51 -0
  17. package/dist/esm/models/AppendMemoryChunkRequest.d.ts +54 -0
  18. package/dist/esm/models/AppendMemoryChunkRequest.js +52 -0
  19. package/dist/esm/models/ChunkBulkResponse.d.ts +4 -4
  20. package/dist/esm/models/ChunkContentItem.d.ts +2 -2
  21. package/dist/esm/models/ChunkResponse.d.ts +4 -4
  22. package/dist/esm/models/CreateThreadMessageRequest.d.ts +2 -2
  23. package/dist/esm/models/CreateWorkflowDefinitionRequest.d.ts +1 -1
  24. package/dist/esm/models/DocumentVersionMetadata.d.ts +4 -4
  25. package/dist/esm/models/DocumentVersionMetadataUpdate.d.ts +2 -2
  26. package/dist/esm/models/EditMemoryChunkRequest.d.ts +47 -0
  27. package/dist/esm/models/EditMemoryChunkRequest.js +49 -0
  28. package/dist/esm/models/EventResponse.d.ts +83 -0
  29. package/dist/esm/models/EventResponse.js +64 -0
  30. package/dist/esm/models/ListMemoryChunksResponse.d.ts +48 -0
  31. package/dist/esm/models/ListMemoryChunksResponse.js +45 -0
  32. package/dist/esm/models/MemoryChunkResponse.d.ts +60 -0
  33. package/dist/esm/models/MemoryChunkResponse.js +53 -0
  34. package/dist/esm/models/MemoryKind.d.ts +29 -0
  35. package/dist/esm/models/MemoryKind.js +47 -0
  36. package/dist/esm/models/PaginatedResponseEventResponse.d.ts +66 -0
  37. package/dist/esm/models/PaginatedResponseEventResponse.js +70 -0
  38. package/dist/esm/models/ScoredChunkResponse.d.ts +4 -4
  39. package/dist/esm/models/SectionSystemMetadata.d.ts +1 -1
  40. package/dist/esm/models/TenantSettingsUpdate.d.ts +2 -2
  41. package/dist/esm/models/ThreadMessageDetailsInput.d.ts +2 -2
  42. package/dist/esm/models/ThreadMessageDetailsOutput.d.ts +2 -2
  43. package/dist/esm/models/ThreadMessageResponse.d.ts +2 -2
  44. package/dist/esm/models/UpdateChunkMetadataRequest.d.ts +2 -2
  45. package/dist/esm/models/UpdateTenantRequest.d.ts +4 -4
  46. package/dist/esm/models/UpdateWorkflowDefinitionRequest.d.ts +1 -1
  47. package/dist/esm/models/WorkflowDefinitionResponse.d.ts +1 -1
  48. package/dist/esm/models/WorkflowRunSnapshot.d.ts +1 -1
  49. package/dist/esm/models/index.d.ts +8 -0
  50. package/dist/esm/models/index.js +8 -0
  51. package/dist/models/AppendEventRequest.d.ts +62 -0
  52. package/dist/models/AppendEventRequest.js +59 -0
  53. package/dist/models/AppendMemoryChunkRequest.d.ts +54 -0
  54. package/dist/models/AppendMemoryChunkRequest.js +60 -0
  55. package/dist/models/ChunkBulkResponse.d.ts +4 -4
  56. package/dist/models/ChunkContentItem.d.ts +2 -2
  57. package/dist/models/ChunkResponse.d.ts +4 -4
  58. package/dist/models/CreateThreadMessageRequest.d.ts +2 -2
  59. package/dist/models/CreateWorkflowDefinitionRequest.d.ts +1 -1
  60. package/dist/models/DocumentVersionMetadata.d.ts +4 -4
  61. package/dist/models/DocumentVersionMetadataUpdate.d.ts +2 -2
  62. package/dist/models/EditMemoryChunkRequest.d.ts +47 -0
  63. package/dist/models/EditMemoryChunkRequest.js +57 -0
  64. package/dist/models/EventResponse.d.ts +83 -0
  65. package/dist/models/EventResponse.js +72 -0
  66. package/dist/models/ListMemoryChunksResponse.d.ts +48 -0
  67. package/dist/models/ListMemoryChunksResponse.js +53 -0
  68. package/dist/models/MemoryChunkResponse.d.ts +60 -0
  69. package/dist/models/MemoryChunkResponse.js +61 -0
  70. package/dist/models/MemoryKind.d.ts +29 -0
  71. package/dist/models/MemoryKind.js +55 -0
  72. package/dist/models/PaginatedResponseEventResponse.d.ts +66 -0
  73. package/dist/models/PaginatedResponseEventResponse.js +78 -0
  74. package/dist/models/ScoredChunkResponse.d.ts +4 -4
  75. package/dist/models/SectionSystemMetadata.d.ts +1 -1
  76. package/dist/models/TenantSettingsUpdate.d.ts +2 -2
  77. package/dist/models/ThreadMessageDetailsInput.d.ts +2 -2
  78. package/dist/models/ThreadMessageDetailsOutput.d.ts +2 -2
  79. package/dist/models/ThreadMessageResponse.d.ts +2 -2
  80. package/dist/models/UpdateChunkMetadataRequest.d.ts +2 -2
  81. package/dist/models/UpdateTenantRequest.d.ts +4 -4
  82. package/dist/models/UpdateWorkflowDefinitionRequest.d.ts +1 -1
  83. package/dist/models/WorkflowDefinitionResponse.d.ts +1 -1
  84. package/dist/models/WorkflowRunSnapshot.d.ts +1 -1
  85. package/dist/models/index.d.ts +8 -0
  86. package/dist/models/index.js +8 -0
  87. package/docs/AppendEventRequest.md +37 -0
  88. package/docs/AppendMemoryChunkRequest.md +36 -0
  89. package/docs/EditMemoryChunkRequest.md +34 -0
  90. package/docs/EventResponse.md +45 -0
  91. package/docs/ListMemoryChunksResponse.md +34 -0
  92. package/docs/MemoryChunkResponse.md +39 -0
  93. package/docs/MemoryKind.md +33 -0
  94. package/docs/PaginatedResponseEventResponse.md +40 -0
  95. package/docs/PathPartsApi.md +171 -0
  96. package/docs/WorkflowMemoryApi.md +390 -0
  97. package/package.json +1 -1
  98. package/src/apis/PathPartsApi.ts +234 -0
  99. package/src/apis/WorkflowMemoryApi.ts +522 -0
  100. package/src/apis/index.ts +1 -0
  101. package/src/models/AppendEventRequest.ts +102 -0
  102. package/src/models/AppendMemoryChunkRequest.ts +105 -0
  103. package/src/models/ChunkBulkResponse.ts +4 -4
  104. package/src/models/ChunkContentItem.ts +2 -2
  105. package/src/models/ChunkResponse.ts +4 -4
  106. package/src/models/CreateThreadMessageRequest.ts +2 -2
  107. package/src/models/CreateWorkflowDefinitionRequest.ts +1 -1
  108. package/src/models/DocumentVersionMetadata.ts +4 -4
  109. package/src/models/DocumentVersionMetadataUpdate.ts +2 -2
  110. package/src/models/EditMemoryChunkRequest.ts +87 -0
  111. package/src/models/EventResponse.ts +132 -0
  112. package/src/models/ListMemoryChunksResponse.ts +91 -0
  113. package/src/models/MemoryChunkResponse.ts +111 -0
  114. package/src/models/MemoryKind.ts +57 -0
  115. package/src/models/PaginatedResponseEventResponse.ts +130 -0
  116. package/src/models/ScoredChunkResponse.ts +4 -4
  117. package/src/models/SectionSystemMetadata.ts +1 -1
  118. package/src/models/TenantSettingsUpdate.ts +2 -2
  119. package/src/models/ThreadMessageDetailsInput.ts +2 -2
  120. package/src/models/ThreadMessageDetailsOutput.ts +2 -2
  121. package/src/models/ThreadMessageResponse.ts +2 -2
  122. package/src/models/UpdateChunkMetadataRequest.ts +2 -2
  123. package/src/models/UpdateTenantRequest.ts +4 -4
  124. package/src/models/UpdateWorkflowDefinitionRequest.ts +1 -1
  125. package/src/models/WorkflowDefinitionResponse.ts +1 -1
  126. package/src/models/WorkflowRunSnapshot.ts +1 -1
  127. package/src/models/index.ts +8 -0
@@ -10,7 +10,13 @@
10
10
  * Do not edit the class manually.
11
11
  */
12
12
  import * as runtime from '../runtime';
13
- import type { AncestryResponse, BulkTagRequest, PaginatedResponsePathPartResponse, PathOrder, PathPartResponse, PathPartTagsResponse, SubtreeChunksResponse } from '../models/index';
13
+ import type { AncestryResponse, AppendEventRequest, BulkTagRequest, EventResponse, PaginatedResponseEventResponse, PaginatedResponsePathPartResponse, PathOrder, PathPartResponse, PathPartTagsResponse, SubtreeChunksResponse } from '../models/index';
14
+ export interface AppendPathPartEventRequest {
15
+ pathPartId: string;
16
+ appendEventRequest: AppendEventRequest;
17
+ authorization?: string | null;
18
+ ksUat?: string | null;
19
+ }
14
20
  export interface BulkRemovePathPartTagsRequest {
15
21
  pathPartId: string;
16
22
  bulkTagRequest: BulkTagRequest;
@@ -38,6 +44,17 @@ export interface GetPathPartTagsRequest {
38
44
  authorization?: string | null;
39
45
  ksUat?: string | null;
40
46
  }
47
+ export interface ListPathPartEventsRequest {
48
+ pathPartId: string;
49
+ kind?: string | null;
50
+ since?: Date | null;
51
+ until?: Date | null;
52
+ recursive?: boolean;
53
+ limit?: number;
54
+ offset?: number;
55
+ authorization?: string | null;
56
+ ksUat?: string | null;
57
+ }
41
58
  export interface ListPathPartsRequest {
42
59
  parentPathId?: string | null;
43
60
  maxDepth?: number;
@@ -60,6 +77,33 @@ export interface SetPathPartTagsRequest {
60
77
  * @interface PathPartsApiInterface
61
78
  */
62
79
  export interface PathPartsApiInterface {
80
+ /**
81
+ * Creates request options for appendPathPartEvent without sending the request
82
+ * @param {string} pathPartId
83
+ * @param {AppendEventRequest} appendEventRequest
84
+ * @param {string} [authorization]
85
+ * @param {string} [ksUat]
86
+ * @throws {RequiredError}
87
+ * @memberof PathPartsApiInterface
88
+ */
89
+ appendPathPartEventRequestOpts(requestParameters: AppendPathPartEventRequest): Promise<runtime.RequestOpts>;
90
+ /**
91
+ * Record an event for a subject path_part from the frontend. Auth: caller must hold ``can_write`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Server stamps ``actor_user_id`` from the caller\'s identity — callers cannot impersonate other users on the audit trail. ``kind`` is free-form text but reserved server namespaces (``workflow.``, ``document.``, ``folder.``, ``permission.``, ``connector.``, ``query.``, ``auth.``, ``tenant.``) are rejected at 422 so clients cannot forge server-emitted audit events. Clients should namespace under ``client.*``. ``payload`` is capped at 64KB encoded JSON.
92
+ * @summary Append Path Part Event Handler
93
+ * @param {string} pathPartId
94
+ * @param {AppendEventRequest} appendEventRequest
95
+ * @param {string} [authorization]
96
+ * @param {string} [ksUat]
97
+ * @param {*} [options] Override http request option.
98
+ * @throws {RequiredError}
99
+ * @memberof PathPartsApiInterface
100
+ */
101
+ appendPathPartEventRaw(requestParameters: AppendPathPartEventRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<EventResponse>>;
102
+ /**
103
+ * Record an event for a subject path_part from the frontend. Auth: caller must hold ``can_write`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Server stamps ``actor_user_id`` from the caller\'s identity — callers cannot impersonate other users on the audit trail. ``kind`` is free-form text but reserved server namespaces (``workflow.``, ``document.``, ``folder.``, ``permission.``, ``connector.``, ``query.``, ``auth.``, ``tenant.``) are rejected at 422 so clients cannot forge server-emitted audit events. Clients should namespace under ``client.*``. ``payload`` is capped at 64KB encoded JSON.
104
+ * Append Path Part Event Handler
105
+ */
106
+ appendPathPartEvent(requestParameters: AppendPathPartEventRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EventResponse>;
63
107
  /**
64
108
  * Creates request options for bulkRemovePathPartTags without sending the request
65
109
  * @param {string} pathPartId
@@ -189,6 +233,43 @@ export interface PathPartsApiInterface {
189
233
  * Get Path Part Tags Handler
190
234
  */
191
235
  getPathPartTags(requestParameters: GetPathPartTagsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartTagsResponse>;
236
+ /**
237
+ * Creates request options for listPathPartEvents without sending the request
238
+ * @param {string} pathPartId
239
+ * @param {string} [kind] Filter to a single event kind
240
+ * @param {Date} [since] Only events at or after this timestamp
241
+ * @param {Date} [until] Only events strictly before this timestamp
242
+ * @param {boolean} [recursive] Include events from descendant path_parts as well as the subject itself
243
+ * @param {number} [limit] Number of items per page
244
+ * @param {number} [offset] Number of items to skip
245
+ * @param {string} [authorization]
246
+ * @param {string} [ksUat]
247
+ * @throws {RequiredError}
248
+ * @memberof PathPartsApiInterface
249
+ */
250
+ listPathPartEventsRequestOpts(requestParameters: ListPathPartEventsRequest): Promise<runtime.RequestOpts>;
251
+ /**
252
+ * List events anchored to a specific path_part subject. Subject permission is enforced via the existing ``PathPermissionService`` — caller must have ``can_read`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Events are ordered newest-first by ``ts`` and paginated. When ``recursive=True``, events on any descendant of the subject are included — useful for \"all events under this folder\" or \"all events under this workflow definition\".
253
+ * @summary List Path Part Events Handler
254
+ * @param {string} pathPartId
255
+ * @param {string} [kind] Filter to a single event kind
256
+ * @param {Date} [since] Only events at or after this timestamp
257
+ * @param {Date} [until] Only events strictly before this timestamp
258
+ * @param {boolean} [recursive] Include events from descendant path_parts as well as the subject itself
259
+ * @param {number} [limit] Number of items per page
260
+ * @param {number} [offset] Number of items to skip
261
+ * @param {string} [authorization]
262
+ * @param {string} [ksUat]
263
+ * @param {*} [options] Override http request option.
264
+ * @throws {RequiredError}
265
+ * @memberof PathPartsApiInterface
266
+ */
267
+ listPathPartEventsRaw(requestParameters: ListPathPartEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseEventResponse>>;
268
+ /**
269
+ * List events anchored to a specific path_part subject. Subject permission is enforced via the existing ``PathPermissionService`` — caller must have ``can_read`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Events are ordered newest-first by ``ts`` and paginated. When ``recursive=True``, events on any descendant of the subject are included — useful for \"all events under this folder\" or \"all events under this workflow definition\".
270
+ * List Path Part Events Handler
271
+ */
272
+ listPathPartEvents(requestParameters: ListPathPartEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseEventResponse>;
192
273
  /**
193
274
  * Creates request options for listPathParts without sending the request
194
275
  * @param {string} [parentPathId] Parent PathPart ID (defaults to root)
@@ -254,6 +335,20 @@ export interface PathPartsApiInterface {
254
335
  *
255
336
  */
256
337
  export declare class PathPartsApi extends runtime.BaseAPI implements PathPartsApiInterface {
338
+ /**
339
+ * Creates request options for appendPathPartEvent without sending the request
340
+ */
341
+ appendPathPartEventRequestOpts(requestParameters: AppendPathPartEventRequest): Promise<runtime.RequestOpts>;
342
+ /**
343
+ * Record an event for a subject path_part from the frontend. Auth: caller must hold ``can_write`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Server stamps ``actor_user_id`` from the caller\'s identity — callers cannot impersonate other users on the audit trail. ``kind`` is free-form text but reserved server namespaces (``workflow.``, ``document.``, ``folder.``, ``permission.``, ``connector.``, ``query.``, ``auth.``, ``tenant.``) are rejected at 422 so clients cannot forge server-emitted audit events. Clients should namespace under ``client.*``. ``payload`` is capped at 64KB encoded JSON.
344
+ * Append Path Part Event Handler
345
+ */
346
+ appendPathPartEventRaw(requestParameters: AppendPathPartEventRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<EventResponse>>;
347
+ /**
348
+ * Record an event for a subject path_part from the frontend. Auth: caller must hold ``can_write`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Server stamps ``actor_user_id`` from the caller\'s identity — callers cannot impersonate other users on the audit trail. ``kind`` is free-form text but reserved server namespaces (``workflow.``, ``document.``, ``folder.``, ``permission.``, ``connector.``, ``query.``, ``auth.``, ``tenant.``) are rejected at 422 so clients cannot forge server-emitted audit events. Clients should namespace under ``client.*``. ``payload`` is capped at 64KB encoded JSON.
349
+ * Append Path Part Event Handler
350
+ */
351
+ appendPathPartEvent(requestParameters: AppendPathPartEventRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EventResponse>;
257
352
  /**
258
353
  * Creates request options for bulkRemovePathPartTags without sending the request
259
354
  */
@@ -324,6 +419,20 @@ export declare class PathPartsApi extends runtime.BaseAPI implements PathPartsAp
324
419
  * Get Path Part Tags Handler
325
420
  */
326
421
  getPathPartTags(requestParameters: GetPathPartTagsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartTagsResponse>;
422
+ /**
423
+ * Creates request options for listPathPartEvents without sending the request
424
+ */
425
+ listPathPartEventsRequestOpts(requestParameters: ListPathPartEventsRequest): Promise<runtime.RequestOpts>;
426
+ /**
427
+ * List events anchored to a specific path_part subject. Subject permission is enforced via the existing ``PathPermissionService`` — caller must have ``can_read`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Events are ordered newest-first by ``ts`` and paginated. When ``recursive=True``, events on any descendant of the subject are included — useful for \"all events under this folder\" or \"all events under this workflow definition\".
428
+ * List Path Part Events Handler
429
+ */
430
+ listPathPartEventsRaw(requestParameters: ListPathPartEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseEventResponse>>;
431
+ /**
432
+ * List events anchored to a specific path_part subject. Subject permission is enforced via the existing ``PathPermissionService`` — caller must have ``can_read`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Events are ordered newest-first by ``ts`` and paginated. When ``recursive=True``, events on any descendant of the subject are included — useful for \"all events under this folder\" or \"all events under this workflow definition\".
433
+ * List Path Part Events Handler
434
+ */
435
+ listPathPartEvents(requestParameters: ListPathPartEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseEventResponse>;
327
436
  /**
328
437
  * Creates request options for listPathParts without sending the request
329
438
  */
@@ -21,11 +21,60 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
21
21
  });
22
22
  };
23
23
  import * as runtime from '../runtime';
24
- import { AncestryResponseFromJSON, BulkTagRequestToJSON, PaginatedResponsePathPartResponseFromJSON, PathPartResponseFromJSON, PathPartTagsResponseFromJSON, SubtreeChunksResponseFromJSON, } from '../models/index';
24
+ import { AncestryResponseFromJSON, AppendEventRequestToJSON, BulkTagRequestToJSON, EventResponseFromJSON, PaginatedResponseEventResponseFromJSON, PaginatedResponsePathPartResponseFromJSON, PathPartResponseFromJSON, PathPartTagsResponseFromJSON, SubtreeChunksResponseFromJSON, } from '../models/index';
25
25
  /**
26
26
  *
27
27
  */
28
28
  export class PathPartsApi extends runtime.BaseAPI {
29
+ /**
30
+ * Creates request options for appendPathPartEvent without sending the request
31
+ */
32
+ appendPathPartEventRequestOpts(requestParameters) {
33
+ return __awaiter(this, void 0, void 0, function* () {
34
+ if (requestParameters['pathPartId'] == null) {
35
+ throw new runtime.RequiredError('pathPartId', 'Required parameter "pathPartId" was null or undefined when calling appendPathPartEvent().');
36
+ }
37
+ if (requestParameters['appendEventRequest'] == null) {
38
+ throw new runtime.RequiredError('appendEventRequest', 'Required parameter "appendEventRequest" was null or undefined when calling appendPathPartEvent().');
39
+ }
40
+ const queryParameters = {};
41
+ const headerParameters = {};
42
+ headerParameters['Content-Type'] = 'application/json';
43
+ if (requestParameters['authorization'] != null) {
44
+ headerParameters['authorization'] = String(requestParameters['authorization']);
45
+ }
46
+ let urlPath = `/v1/path-parts/{path_part_id}/events`;
47
+ urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
48
+ return {
49
+ path: urlPath,
50
+ method: 'POST',
51
+ headers: headerParameters,
52
+ query: queryParameters,
53
+ body: AppendEventRequestToJSON(requestParameters['appendEventRequest']),
54
+ };
55
+ });
56
+ }
57
+ /**
58
+ * Record an event for a subject path_part from the frontend. Auth: caller must hold ``can_write`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Server stamps ``actor_user_id`` from the caller\'s identity — callers cannot impersonate other users on the audit trail. ``kind`` is free-form text but reserved server namespaces (``workflow.``, ``document.``, ``folder.``, ``permission.``, ``connector.``, ``query.``, ``auth.``, ``tenant.``) are rejected at 422 so clients cannot forge server-emitted audit events. Clients should namespace under ``client.*``. ``payload`` is capped at 64KB encoded JSON.
59
+ * Append Path Part Event Handler
60
+ */
61
+ appendPathPartEventRaw(requestParameters, initOverrides) {
62
+ return __awaiter(this, void 0, void 0, function* () {
63
+ const requestOptions = yield this.appendPathPartEventRequestOpts(requestParameters);
64
+ const response = yield this.request(requestOptions, initOverrides);
65
+ return new runtime.JSONApiResponse(response, (jsonValue) => EventResponseFromJSON(jsonValue));
66
+ });
67
+ }
68
+ /**
69
+ * Record an event for a subject path_part from the frontend. Auth: caller must hold ``can_write`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Server stamps ``actor_user_id`` from the caller\'s identity — callers cannot impersonate other users on the audit trail. ``kind`` is free-form text but reserved server namespaces (``workflow.``, ``document.``, ``folder.``, ``permission.``, ``connector.``, ``query.``, ``auth.``, ``tenant.``) are rejected at 422 so clients cannot forge server-emitted audit events. Clients should namespace under ``client.*``. ``payload`` is capped at 64KB encoded JSON.
70
+ * Append Path Part Event Handler
71
+ */
72
+ appendPathPartEvent(requestParameters, initOverrides) {
73
+ return __awaiter(this, void 0, void 0, function* () {
74
+ const response = yield this.appendPathPartEventRaw(requestParameters, initOverrides);
75
+ return yield response.value();
76
+ });
77
+ }
29
78
  /**
30
79
  * Creates request options for bulkRemovePathPartTags without sending the request
31
80
  */
@@ -254,6 +303,68 @@ export class PathPartsApi extends runtime.BaseAPI {
254
303
  return yield response.value();
255
304
  });
256
305
  }
306
+ /**
307
+ * Creates request options for listPathPartEvents without sending the request
308
+ */
309
+ listPathPartEventsRequestOpts(requestParameters) {
310
+ return __awaiter(this, void 0, void 0, function* () {
311
+ if (requestParameters['pathPartId'] == null) {
312
+ throw new runtime.RequiredError('pathPartId', 'Required parameter "pathPartId" was null or undefined when calling listPathPartEvents().');
313
+ }
314
+ const queryParameters = {};
315
+ if (requestParameters['kind'] != null) {
316
+ queryParameters['kind'] = requestParameters['kind'];
317
+ }
318
+ if (requestParameters['since'] != null) {
319
+ queryParameters['since'] = requestParameters['since'].toISOString();
320
+ }
321
+ if (requestParameters['until'] != null) {
322
+ queryParameters['until'] = requestParameters['until'].toISOString();
323
+ }
324
+ if (requestParameters['recursive'] != null) {
325
+ queryParameters['recursive'] = requestParameters['recursive'];
326
+ }
327
+ if (requestParameters['limit'] != null) {
328
+ queryParameters['limit'] = requestParameters['limit'];
329
+ }
330
+ if (requestParameters['offset'] != null) {
331
+ queryParameters['offset'] = requestParameters['offset'];
332
+ }
333
+ const headerParameters = {};
334
+ if (requestParameters['authorization'] != null) {
335
+ headerParameters['authorization'] = String(requestParameters['authorization']);
336
+ }
337
+ let urlPath = `/v1/path-parts/{path_part_id}/events`;
338
+ urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
339
+ return {
340
+ path: urlPath,
341
+ method: 'GET',
342
+ headers: headerParameters,
343
+ query: queryParameters,
344
+ };
345
+ });
346
+ }
347
+ /**
348
+ * List events anchored to a specific path_part subject. Subject permission is enforced via the existing ``PathPermissionService`` — caller must have ``can_read`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Events are ordered newest-first by ``ts`` and paginated. When ``recursive=True``, events on any descendant of the subject are included — useful for \"all events under this folder\" or \"all events under this workflow definition\".
349
+ * List Path Part Events Handler
350
+ */
351
+ listPathPartEventsRaw(requestParameters, initOverrides) {
352
+ return __awaiter(this, void 0, void 0, function* () {
353
+ const requestOptions = yield this.listPathPartEventsRequestOpts(requestParameters);
354
+ const response = yield this.request(requestOptions, initOverrides);
355
+ return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseEventResponseFromJSON(jsonValue));
356
+ });
357
+ }
358
+ /**
359
+ * List events anchored to a specific path_part subject. Subject permission is enforced via the existing ``PathPermissionService`` — caller must have ``can_read`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Events are ordered newest-first by ``ts`` and paginated. When ``recursive=True``, events on any descendant of the subject are included — useful for \"all events under this folder\" or \"all events under this workflow definition\".
360
+ * List Path Part Events Handler
361
+ */
362
+ listPathPartEvents(requestParameters, initOverrides) {
363
+ return __awaiter(this, void 0, void 0, function* () {
364
+ const response = yield this.listPathPartEventsRaw(requestParameters, initOverrides);
365
+ return yield response.value();
366
+ });
367
+ }
257
368
  /**
258
369
  * Creates request options for listPathParts without sending the request
259
370
  */
@@ -0,0 +1,249 @@
1
+ /**
2
+ * Knowledge Stack API
3
+ * Knowledge Stack backend API for authentication and knowledge management
4
+ *
5
+ * The version of the OpenAPI document: 0.1.0
6
+ *
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ import * as runtime from '../runtime';
13
+ import type { AppendMemoryChunkRequest, EditMemoryChunkRequest, ListMemoryChunksResponse, MemoryChunkResponse } from '../models/index';
14
+ export interface AppendWorkflowMemoryChunkRequest {
15
+ definitionId: string;
16
+ appendMemoryChunkRequest: AppendMemoryChunkRequest;
17
+ authorization?: string | null;
18
+ ksUat?: string | null;
19
+ }
20
+ export interface EditWorkflowMemoryChunkRequest {
21
+ definitionId: string;
22
+ chunkId: string;
23
+ editMemoryChunkRequest: EditMemoryChunkRequest;
24
+ authorization?: string | null;
25
+ ksUat?: string | null;
26
+ }
27
+ export interface ForgetWorkflowMemoryChunkRequest {
28
+ definitionId: string;
29
+ chunkId: string;
30
+ authorization?: string | null;
31
+ ksUat?: string | null;
32
+ }
33
+ export interface GetWorkflowMemoryChunkRequest {
34
+ definitionId: string;
35
+ chunkId: string;
36
+ authorization?: string | null;
37
+ ksUat?: string | null;
38
+ }
39
+ export interface ListWorkflowMemoryChunksRequest {
40
+ definitionId: string;
41
+ authorization?: string | null;
42
+ ksUat?: string | null;
43
+ }
44
+ /**
45
+ * WorkflowMemoryApi - interface
46
+ *
47
+ * @export
48
+ * @interface WorkflowMemoryApiInterface
49
+ */
50
+ export interface WorkflowMemoryApiInterface {
51
+ /**
52
+ * Creates request options for appendWorkflowMemoryChunk without sending the request
53
+ * @param {string} definitionId
54
+ * @param {AppendMemoryChunkRequest} appendMemoryChunkRequest
55
+ * @param {string} [authorization]
56
+ * @param {string} [ksUat]
57
+ * @throws {RequiredError}
58
+ * @memberof WorkflowMemoryApiInterface
59
+ */
60
+ appendWorkflowMemoryChunkRequestOpts(requestParameters: AppendWorkflowMemoryChunkRequest): Promise<runtime.RequestOpts>;
61
+ /**
62
+ * Append a new memory chunk. Exposed for external agents (e.g. self-hosted runners) that need to capture learnings without touching the DB directly. The new chunk\'s ``chunk_id`` is server-assigned. Each call snapshots a new DocumentVersion, just like edit/forget.
63
+ * @summary Append Workflow Memory Chunk Handler
64
+ * @param {string} definitionId
65
+ * @param {AppendMemoryChunkRequest} appendMemoryChunkRequest
66
+ * @param {string} [authorization]
67
+ * @param {string} [ksUat]
68
+ * @param {*} [options] Override http request option.
69
+ * @throws {RequiredError}
70
+ * @memberof WorkflowMemoryApiInterface
71
+ */
72
+ appendWorkflowMemoryChunkRaw(requestParameters: AppendWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MemoryChunkResponse>>;
73
+ /**
74
+ * Append a new memory chunk. Exposed for external agents (e.g. self-hosted runners) that need to capture learnings without touching the DB directly. The new chunk\'s ``chunk_id`` is server-assigned. Each call snapshots a new DocumentVersion, just like edit/forget.
75
+ * Append Workflow Memory Chunk Handler
76
+ */
77
+ appendWorkflowMemoryChunk(requestParameters: AppendWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MemoryChunkResponse>;
78
+ /**
79
+ * Creates request options for editWorkflowMemoryChunk without sending the request
80
+ * @param {string} definitionId
81
+ * @param {string} chunkId
82
+ * @param {EditMemoryChunkRequest} editMemoryChunkRequest
83
+ * @param {string} [authorization]
84
+ * @param {string} [ksUat]
85
+ * @throws {RequiredError}
86
+ * @memberof WorkflowMemoryApiInterface
87
+ */
88
+ editWorkflowMemoryChunkRequestOpts(requestParameters: EditWorkflowMemoryChunkRequest): Promise<runtime.RequestOpts>;
89
+ /**
90
+ *
91
+ * @summary Edit Workflow Memory Chunk Handler
92
+ * @param {string} definitionId
93
+ * @param {string} chunkId
94
+ * @param {EditMemoryChunkRequest} editMemoryChunkRequest
95
+ * @param {string} [authorization]
96
+ * @param {string} [ksUat]
97
+ * @param {*} [options] Override http request option.
98
+ * @throws {RequiredError}
99
+ * @memberof WorkflowMemoryApiInterface
100
+ */
101
+ editWorkflowMemoryChunkRaw(requestParameters: EditWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MemoryChunkResponse>>;
102
+ /**
103
+ * Edit Workflow Memory Chunk Handler
104
+ */
105
+ editWorkflowMemoryChunk(requestParameters: EditWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MemoryChunkResponse>;
106
+ /**
107
+ * Creates request options for forgetWorkflowMemoryChunk without sending the request
108
+ * @param {string} definitionId
109
+ * @param {string} chunkId
110
+ * @param {string} [authorization]
111
+ * @param {string} [ksUat]
112
+ * @throws {RequiredError}
113
+ * @memberof WorkflowMemoryApiInterface
114
+ */
115
+ forgetWorkflowMemoryChunkRequestOpts(requestParameters: ForgetWorkflowMemoryChunkRequest): Promise<runtime.RequestOpts>;
116
+ /**
117
+ *
118
+ * @summary Forget Workflow Memory Chunk Handler
119
+ * @param {string} definitionId
120
+ * @param {string} chunkId
121
+ * @param {string} [authorization]
122
+ * @param {string} [ksUat]
123
+ * @param {*} [options] Override http request option.
124
+ * @throws {RequiredError}
125
+ * @memberof WorkflowMemoryApiInterface
126
+ */
127
+ forgetWorkflowMemoryChunkRaw(requestParameters: ForgetWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
128
+ /**
129
+ * Forget Workflow Memory Chunk Handler
130
+ */
131
+ forgetWorkflowMemoryChunk(requestParameters: ForgetWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
132
+ /**
133
+ * Creates request options for getWorkflowMemoryChunk without sending the request
134
+ * @param {string} definitionId
135
+ * @param {string} chunkId
136
+ * @param {string} [authorization]
137
+ * @param {string} [ksUat]
138
+ * @throws {RequiredError}
139
+ * @memberof WorkflowMemoryApiInterface
140
+ */
141
+ getWorkflowMemoryChunkRequestOpts(requestParameters: GetWorkflowMemoryChunkRequest): Promise<runtime.RequestOpts>;
142
+ /**
143
+ *
144
+ * @summary Get Workflow Memory Chunk Handler
145
+ * @param {string} definitionId
146
+ * @param {string} chunkId
147
+ * @param {string} [authorization]
148
+ * @param {string} [ksUat]
149
+ * @param {*} [options] Override http request option.
150
+ * @throws {RequiredError}
151
+ * @memberof WorkflowMemoryApiInterface
152
+ */
153
+ getWorkflowMemoryChunkRaw(requestParameters: GetWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MemoryChunkResponse>>;
154
+ /**
155
+ * Get Workflow Memory Chunk Handler
156
+ */
157
+ getWorkflowMemoryChunk(requestParameters: GetWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MemoryChunkResponse>;
158
+ /**
159
+ * Creates request options for listWorkflowMemoryChunks without sending the request
160
+ * @param {string} definitionId
161
+ * @param {string} [authorization]
162
+ * @param {string} [ksUat]
163
+ * @throws {RequiredError}
164
+ * @memberof WorkflowMemoryApiInterface
165
+ */
166
+ listWorkflowMemoryChunksRequestOpts(requestParameters: ListWorkflowMemoryChunksRequest): Promise<runtime.RequestOpts>;
167
+ /**
168
+ *
169
+ * @summary List Workflow Memory Chunks Handler
170
+ * @param {string} definitionId
171
+ * @param {string} [authorization]
172
+ * @param {string} [ksUat]
173
+ * @param {*} [options] Override http request option.
174
+ * @throws {RequiredError}
175
+ * @memberof WorkflowMemoryApiInterface
176
+ */
177
+ listWorkflowMemoryChunksRaw(requestParameters: ListWorkflowMemoryChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListMemoryChunksResponse>>;
178
+ /**
179
+ * List Workflow Memory Chunks Handler
180
+ */
181
+ listWorkflowMemoryChunks(requestParameters: ListWorkflowMemoryChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListMemoryChunksResponse>;
182
+ }
183
+ /**
184
+ *
185
+ */
186
+ export declare class WorkflowMemoryApi extends runtime.BaseAPI implements WorkflowMemoryApiInterface {
187
+ /**
188
+ * Creates request options for appendWorkflowMemoryChunk without sending the request
189
+ */
190
+ appendWorkflowMemoryChunkRequestOpts(requestParameters: AppendWorkflowMemoryChunkRequest): Promise<runtime.RequestOpts>;
191
+ /**
192
+ * Append a new memory chunk. Exposed for external agents (e.g. self-hosted runners) that need to capture learnings without touching the DB directly. The new chunk\'s ``chunk_id`` is server-assigned. Each call snapshots a new DocumentVersion, just like edit/forget.
193
+ * Append Workflow Memory Chunk Handler
194
+ */
195
+ appendWorkflowMemoryChunkRaw(requestParameters: AppendWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MemoryChunkResponse>>;
196
+ /**
197
+ * Append a new memory chunk. Exposed for external agents (e.g. self-hosted runners) that need to capture learnings without touching the DB directly. The new chunk\'s ``chunk_id`` is server-assigned. Each call snapshots a new DocumentVersion, just like edit/forget.
198
+ * Append Workflow Memory Chunk Handler
199
+ */
200
+ appendWorkflowMemoryChunk(requestParameters: AppendWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MemoryChunkResponse>;
201
+ /**
202
+ * Creates request options for editWorkflowMemoryChunk without sending the request
203
+ */
204
+ editWorkflowMemoryChunkRequestOpts(requestParameters: EditWorkflowMemoryChunkRequest): Promise<runtime.RequestOpts>;
205
+ /**
206
+ * Edit Workflow Memory Chunk Handler
207
+ */
208
+ editWorkflowMemoryChunkRaw(requestParameters: EditWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MemoryChunkResponse>>;
209
+ /**
210
+ * Edit Workflow Memory Chunk Handler
211
+ */
212
+ editWorkflowMemoryChunk(requestParameters: EditWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MemoryChunkResponse>;
213
+ /**
214
+ * Creates request options for forgetWorkflowMemoryChunk without sending the request
215
+ */
216
+ forgetWorkflowMemoryChunkRequestOpts(requestParameters: ForgetWorkflowMemoryChunkRequest): Promise<runtime.RequestOpts>;
217
+ /**
218
+ * Forget Workflow Memory Chunk Handler
219
+ */
220
+ forgetWorkflowMemoryChunkRaw(requestParameters: ForgetWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
221
+ /**
222
+ * Forget Workflow Memory Chunk Handler
223
+ */
224
+ forgetWorkflowMemoryChunk(requestParameters: ForgetWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
225
+ /**
226
+ * Creates request options for getWorkflowMemoryChunk without sending the request
227
+ */
228
+ getWorkflowMemoryChunkRequestOpts(requestParameters: GetWorkflowMemoryChunkRequest): Promise<runtime.RequestOpts>;
229
+ /**
230
+ * Get Workflow Memory Chunk Handler
231
+ */
232
+ getWorkflowMemoryChunkRaw(requestParameters: GetWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MemoryChunkResponse>>;
233
+ /**
234
+ * Get Workflow Memory Chunk Handler
235
+ */
236
+ getWorkflowMemoryChunk(requestParameters: GetWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MemoryChunkResponse>;
237
+ /**
238
+ * Creates request options for listWorkflowMemoryChunks without sending the request
239
+ */
240
+ listWorkflowMemoryChunksRequestOpts(requestParameters: ListWorkflowMemoryChunksRequest): Promise<runtime.RequestOpts>;
241
+ /**
242
+ * List Workflow Memory Chunks Handler
243
+ */
244
+ listWorkflowMemoryChunksRaw(requestParameters: ListWorkflowMemoryChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListMemoryChunksResponse>>;
245
+ /**
246
+ * List Workflow Memory Chunks Handler
247
+ */
248
+ listWorkflowMemoryChunks(requestParameters: ListWorkflowMemoryChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListMemoryChunksResponse>;
249
+ }