@vectorize-io/hindsight-client 0.2.1 → 0.4.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.
@@ -7,7 +7,7 @@ export type ClientOptions = {
7
7
  /**
8
8
  * AddBackgroundRequest
9
9
  *
10
- * Request model for adding/merging background information.
10
+ * Request model for adding/merging background information. Deprecated: use SetMissionRequest instead.
11
11
  */
12
12
  export type AddBackgroundRequest = {
13
13
  /**
@@ -19,21 +19,43 @@ export type AddBackgroundRequest = {
19
19
  /**
20
20
  * Update Disposition
21
21
  *
22
- * If true, infer disposition traits from the merged background (default: true)
22
+ * Deprecated - disposition is no longer auto-inferred from mission
23
23
  */
24
24
  update_disposition?: boolean;
25
25
  };
26
26
 
27
+ /**
28
+ * AsyncOperationSubmitResponse
29
+ *
30
+ * Response model for submitting an async operation.
31
+ */
32
+ export type AsyncOperationSubmitResponse = {
33
+ /**
34
+ * Operation Id
35
+ */
36
+ operation_id: string;
37
+ /**
38
+ * Status
39
+ */
40
+ status: string;
41
+ };
42
+
27
43
  /**
28
44
  * BackgroundResponse
29
45
  *
30
- * Response model for background update.
46
+ * Response model for background update. Deprecated: use MissionResponse instead.
31
47
  */
32
48
  export type BackgroundResponse = {
49
+ /**
50
+ * Mission
51
+ */
52
+ mission: string;
33
53
  /**
34
54
  * Background
55
+ *
56
+ * Deprecated: same as mission
35
57
  */
36
- background: string;
58
+ background?: string | null;
37
59
  disposition?: DispositionTraits | null;
38
60
  };
39
61
 
@@ -53,9 +75,9 @@ export type BankListItem = {
53
75
  name?: string | null;
54
76
  disposition: DispositionTraits;
55
77
  /**
56
- * Background
78
+ * Mission
57
79
  */
58
- background?: string | null;
80
+ mission?: string | null;
59
81
  /**
60
82
  * Created At
61
83
  */
@@ -93,10 +115,18 @@ export type BankProfileResponse = {
93
115
  */
94
116
  name: string;
95
117
  disposition: DispositionTraits;
118
+ /**
119
+ * Mission
120
+ *
121
+ * The agent's mission - who they are and what they're trying to accomplish
122
+ */
123
+ mission: string;
96
124
  /**
97
125
  * Background
126
+ *
127
+ * Deprecated: use mission instead
98
128
  */
99
- background: string;
129
+ background?: string | null;
100
130
  };
101
131
 
102
132
  /**
@@ -155,6 +185,24 @@ export type BankStatsResponse = {
155
185
  * Failed Operations
156
186
  */
157
187
  failed_operations: number;
188
+ /**
189
+ * Last Consolidated At
190
+ *
191
+ * When consolidation last ran (ISO format)
192
+ */
193
+ last_consolidated_at?: string | null;
194
+ /**
195
+ * Pending Consolidation
196
+ *
197
+ * Number of memories not yet processed into observations
198
+ */
199
+ pending_consolidation?: number;
200
+ /**
201
+ * Total Observations
202
+ *
203
+ * Total number of observations
204
+ */
205
+ total_observations?: number;
158
206
  };
159
207
 
160
208
  /**
@@ -256,6 +304,26 @@ export type ChunkResponse = {
256
304
  created_at: string;
257
305
  };
258
306
 
307
+ /**
308
+ * ConsolidationResponse
309
+ *
310
+ * Response model for consolidation trigger endpoint.
311
+ */
312
+ export type ConsolidationResponse = {
313
+ /**
314
+ * Operation Id
315
+ *
316
+ * ID of the async consolidation operation
317
+ */
318
+ operation_id: string;
319
+ /**
320
+ * Deduplicated
321
+ *
322
+ * True if an existing pending task was reused
323
+ */
324
+ deduplicated?: boolean;
325
+ };
326
+
259
327
  /**
260
328
  * CreateBankRequest
261
329
  *
@@ -267,12 +335,108 @@ export type CreateBankRequest = {
267
335
  */
268
336
  name?: string | null;
269
337
  disposition?: DispositionTraits | null;
338
+ /**
339
+ * Mission
340
+ *
341
+ * The agent's mission
342
+ */
343
+ mission?: string | null;
270
344
  /**
271
345
  * Background
346
+ *
347
+ * Deprecated: use mission instead
272
348
  */
273
349
  background?: string | null;
274
350
  };
275
351
 
352
+ /**
353
+ * CreateDirectiveRequest
354
+ *
355
+ * Request model for creating a directive.
356
+ */
357
+ export type CreateDirectiveRequest = {
358
+ /**
359
+ * Name
360
+ *
361
+ * Human-readable name for the directive
362
+ */
363
+ name: string;
364
+ /**
365
+ * Content
366
+ *
367
+ * The directive text to inject into prompts
368
+ */
369
+ content: string;
370
+ /**
371
+ * Priority
372
+ *
373
+ * Higher priority directives are injected first
374
+ */
375
+ priority?: number;
376
+ /**
377
+ * Is Active
378
+ *
379
+ * Whether this directive is active
380
+ */
381
+ is_active?: boolean;
382
+ /**
383
+ * Tags
384
+ *
385
+ * Tags for filtering
386
+ */
387
+ tags?: Array<string>;
388
+ };
389
+
390
+ /**
391
+ * CreateMentalModelRequest
392
+ *
393
+ * Request model for creating a mental model.
394
+ */
395
+ export type CreateMentalModelRequest = {
396
+ /**
397
+ * Name
398
+ *
399
+ * Human-readable name for the mental model
400
+ */
401
+ name: string;
402
+ /**
403
+ * Source Query
404
+ *
405
+ * The query to run to generate content
406
+ */
407
+ source_query: string;
408
+ /**
409
+ * Tags
410
+ *
411
+ * Tags for scoped visibility
412
+ */
413
+ tags?: Array<string>;
414
+ /**
415
+ * Max Tokens
416
+ *
417
+ * Maximum tokens for generated content
418
+ */
419
+ max_tokens?: number;
420
+ /**
421
+ * Trigger settings
422
+ */
423
+ trigger?: MentalModelTrigger;
424
+ };
425
+
426
+ /**
427
+ * CreateMentalModelResponse
428
+ *
429
+ * Response model for mental model creation.
430
+ */
431
+ export type CreateMentalModelResponse = {
432
+ /**
433
+ * Operation Id
434
+ *
435
+ * Operation ID to track progress
436
+ */
437
+ operation_id: string;
438
+ };
439
+
276
440
  /**
277
441
  * DeleteDocumentResponse
278
442
  *
@@ -317,6 +481,62 @@ export type DeleteResponse = {
317
481
  deleted_count?: number | null;
318
482
  };
319
483
 
484
+ /**
485
+ * DirectiveListResponse
486
+ *
487
+ * Response model for listing directives.
488
+ */
489
+ export type DirectiveListResponse = {
490
+ /**
491
+ * Items
492
+ */
493
+ items: Array<DirectiveResponse>;
494
+ };
495
+
496
+ /**
497
+ * DirectiveResponse
498
+ *
499
+ * Response model for a directive.
500
+ */
501
+ export type DirectiveResponse = {
502
+ /**
503
+ * Id
504
+ */
505
+ id: string;
506
+ /**
507
+ * Bank Id
508
+ */
509
+ bank_id: string;
510
+ /**
511
+ * Name
512
+ */
513
+ name: string;
514
+ /**
515
+ * Content
516
+ */
517
+ content: string;
518
+ /**
519
+ * Priority
520
+ */
521
+ priority?: number;
522
+ /**
523
+ * Is Active
524
+ */
525
+ is_active?: boolean;
526
+ /**
527
+ * Tags
528
+ */
529
+ tags?: Array<string>;
530
+ /**
531
+ * Created At
532
+ */
533
+ created_at?: string | null;
534
+ /**
535
+ * Updated At
536
+ */
537
+ updated_at?: string | null;
538
+ };
539
+
320
540
  /**
321
541
  * DispositionTraits
322
542
  *
@@ -377,6 +597,12 @@ export type DocumentResponse = {
377
597
  * Memory Unit Count
378
598
  */
379
599
  memory_unit_count: number;
600
+ /**
601
+ * Tags
602
+ *
603
+ * Tags associated with this document
604
+ */
605
+ tags?: Array<string>;
380
606
  };
381
607
 
382
608
  /**
@@ -495,6 +721,18 @@ export type EntityListResponse = {
495
721
  * Items
496
722
  */
497
723
  items: Array<EntityListItem>;
724
+ /**
725
+ * Total
726
+ */
727
+ total: number;
728
+ /**
729
+ * Limit
730
+ */
731
+ limit: number;
732
+ /**
733
+ * Offset
734
+ */
735
+ offset: number;
498
736
  };
499
737
 
500
738
  /**
@@ -542,6 +780,32 @@ export type FactsIncludeOptions = {
542
780
  [key: string]: unknown;
543
781
  };
544
782
 
783
+ /**
784
+ * FeaturesInfo
785
+ *
786
+ * Feature flags indicating which capabilities are enabled.
787
+ */
788
+ export type FeaturesInfo = {
789
+ /**
790
+ * Observations
791
+ *
792
+ * Whether observations (auto-consolidation) are enabled
793
+ */
794
+ observations: boolean;
795
+ /**
796
+ * Mcp
797
+ *
798
+ * Whether MCP (Model Context Protocol) server is enabled
799
+ */
800
+ mcp: boolean;
801
+ /**
802
+ * Worker
803
+ *
804
+ * Whether the background worker is enabled
805
+ */
806
+ worker: boolean;
807
+ };
808
+
545
809
  /**
546
810
  * GraphDataResponse
547
811
  *
@@ -570,6 +834,10 @@ export type GraphDataResponse = {
570
834
  * Total Units
571
835
  */
572
836
  total_units: number;
837
+ /**
838
+ * Limit
839
+ */
840
+ limit: number;
573
841
  };
574
842
 
575
843
  /**
@@ -650,6 +918,30 @@ export type ListMemoryUnitsResponse = {
650
918
  offset: number;
651
919
  };
652
920
 
921
+ /**
922
+ * ListTagsResponse
923
+ *
924
+ * Response model for list tags endpoint.
925
+ */
926
+ export type ListTagsResponse = {
927
+ /**
928
+ * Items
929
+ */
930
+ items: Array<TagItem>;
931
+ /**
932
+ * Total
933
+ */
934
+ total: number;
935
+ /**
936
+ * Limit
937
+ */
938
+ limit: number;
939
+ /**
940
+ * Offset
941
+ */
942
+ offset: number;
943
+ };
944
+
653
945
  /**
654
946
  * MemoryItem
655
947
  *
@@ -686,58 +978,191 @@ export type MemoryItem = {
686
978
  * Optional entities to combine with auto-extracted entities.
687
979
  */
688
980
  entities?: Array<EntityInput> | null;
981
+ /**
982
+ * Tags
983
+ *
984
+ * Optional tags for visibility scoping. Memories with tags can be filtered during recall.
985
+ */
986
+ tags?: Array<string> | null;
689
987
  };
690
988
 
691
989
  /**
692
- * OperationResponse
990
+ * MentalModelListResponse
693
991
  *
694
- * Response model for a single async operation.
992
+ * Response model for listing mental models.
695
993
  */
696
- export type OperationResponse = {
994
+ export type MentalModelListResponse = {
995
+ /**
996
+ * Items
997
+ */
998
+ items: Array<MentalModelResponse>;
999
+ };
1000
+
1001
+ /**
1002
+ * MentalModelResponse
1003
+ *
1004
+ * Response model for a mental model (stored reflect response).
1005
+ */
1006
+ export type MentalModelResponse = {
697
1007
  /**
698
1008
  * Id
699
1009
  */
700
1010
  id: string;
701
1011
  /**
702
- * Task Type
1012
+ * Bank Id
703
1013
  */
704
- task_type: string;
1014
+ bank_id: string;
705
1015
  /**
706
- * Items Count
1016
+ * Name
707
1017
  */
708
- items_count: number;
1018
+ name: string;
709
1019
  /**
710
- * Document Id
1020
+ * Source Query
711
1021
  */
712
- document_id: string | null;
1022
+ source_query: string;
713
1023
  /**
714
- * Created At
1024
+ * Content
715
1025
  */
716
- created_at: string;
1026
+ content: string;
717
1027
  /**
718
- * Status
1028
+ * Tags
719
1029
  */
720
- status: string;
1030
+ tags?: Array<string>;
721
1031
  /**
722
- * Error Message
1032
+ * Max Tokens
723
1033
  */
724
- error_message: string | null;
725
- };
726
-
727
- /**
728
- * OperationsListResponse
729
- *
730
- * Response model for list operations endpoint.
731
- */
732
- export type OperationsListResponse = {
1034
+ max_tokens?: number;
1035
+ trigger?: MentalModelTrigger;
733
1036
  /**
734
- * Bank Id
1037
+ * Last Refreshed At
735
1038
  */
736
- bank_id: string;
1039
+ last_refreshed_at?: string | null;
737
1040
  /**
738
- * Operations
1041
+ * Created At
739
1042
  */
740
- operations: Array<OperationResponse>;
1043
+ created_at?: string | null;
1044
+ /**
1045
+ * Reflect Response
1046
+ *
1047
+ * Full reflect API response payload including based_on facts and observations
1048
+ */
1049
+ reflect_response?: {
1050
+ [key: string]: unknown;
1051
+ } | null;
1052
+ };
1053
+
1054
+ /**
1055
+ * MentalModelTrigger
1056
+ *
1057
+ * Trigger settings for a mental model.
1058
+ */
1059
+ export type MentalModelTrigger = {
1060
+ /**
1061
+ * Refresh After Consolidation
1062
+ *
1063
+ * If true, refresh this mental model after observations consolidation (real-time mode)
1064
+ */
1065
+ refresh_after_consolidation?: boolean;
1066
+ };
1067
+
1068
+ /**
1069
+ * OperationResponse
1070
+ *
1071
+ * Response model for a single async operation.
1072
+ */
1073
+ export type OperationResponse = {
1074
+ /**
1075
+ * Id
1076
+ */
1077
+ id: string;
1078
+ /**
1079
+ * Task Type
1080
+ */
1081
+ task_type: string;
1082
+ /**
1083
+ * Items Count
1084
+ */
1085
+ items_count: number;
1086
+ /**
1087
+ * Document Id
1088
+ */
1089
+ document_id?: string | null;
1090
+ /**
1091
+ * Created At
1092
+ */
1093
+ created_at: string;
1094
+ /**
1095
+ * Status
1096
+ */
1097
+ status: string;
1098
+ /**
1099
+ * Error Message
1100
+ */
1101
+ error_message: string | null;
1102
+ };
1103
+
1104
+ /**
1105
+ * OperationStatusResponse
1106
+ *
1107
+ * Response model for getting a single operation status.
1108
+ */
1109
+ export type OperationStatusResponse = {
1110
+ /**
1111
+ * Operation Id
1112
+ */
1113
+ operation_id: string;
1114
+ /**
1115
+ * Status
1116
+ */
1117
+ status: "pending" | "completed" | "failed" | "not_found";
1118
+ /**
1119
+ * Operation Type
1120
+ */
1121
+ operation_type?: string | null;
1122
+ /**
1123
+ * Created At
1124
+ */
1125
+ created_at?: string | null;
1126
+ /**
1127
+ * Updated At
1128
+ */
1129
+ updated_at?: string | null;
1130
+ /**
1131
+ * Completed At
1132
+ */
1133
+ completed_at?: string | null;
1134
+ /**
1135
+ * Error Message
1136
+ */
1137
+ error_message?: string | null;
1138
+ };
1139
+
1140
+ /**
1141
+ * OperationsListResponse
1142
+ *
1143
+ * Response model for list operations endpoint.
1144
+ */
1145
+ export type OperationsListResponse = {
1146
+ /**
1147
+ * Bank Id
1148
+ */
1149
+ bank_id: string;
1150
+ /**
1151
+ * Total
1152
+ */
1153
+ total: number;
1154
+ /**
1155
+ * Limit
1156
+ */
1157
+ limit: number;
1158
+ /**
1159
+ * Offset
1160
+ */
1161
+ offset: number;
1162
+ /**
1163
+ * Operations
1164
+ */
1165
+ operations: Array<OperationResponse>;
741
1166
  };
742
1167
 
743
1168
  /**
@@ -753,7 +1178,7 @@ export type RecallRequest = {
753
1178
  /**
754
1179
  * Types
755
1180
  *
756
- * List of fact types to recall (defaults to all if not specified)
1181
+ * List of fact types to recall: 'world', 'experience', 'observation'. Defaults to world and experience if not specified. Note: 'opinion' is accepted but ignored (opinions are excluded from recall).
757
1182
  */
758
1183
  types?: Array<string> | null;
759
1184
  budget?: Budget;
@@ -775,6 +1200,18 @@ export type RecallRequest = {
775
1200
  * Options for including additional data (entities are included by default)
776
1201
  */
777
1202
  include?: IncludeOptions;
1203
+ /**
1204
+ * Tags
1205
+ *
1206
+ * Filter memories by tags. If not specified, all memories are returned.
1207
+ */
1208
+ tags?: Array<string> | null;
1209
+ /**
1210
+ * Tags Match
1211
+ *
1212
+ * How to match tags: 'any' (OR, includes untagged), 'all' (AND, includes untagged), 'any_strict' (OR, excludes untagged), 'all_strict' (AND, excludes untagged).
1213
+ */
1214
+ tags_match?: "any" | "all" | "any_strict" | "all_strict";
778
1215
  };
779
1216
 
780
1217
  /**
@@ -863,6 +1300,62 @@ export type RecallResult = {
863
1300
  * Chunk Id
864
1301
  */
865
1302
  chunk_id?: string | null;
1303
+ /**
1304
+ * Tags
1305
+ */
1306
+ tags?: Array<string> | null;
1307
+ };
1308
+
1309
+ /**
1310
+ * ReflectBasedOn
1311
+ *
1312
+ * Evidence the response is based on: memories, mental models, and directives.
1313
+ */
1314
+ export type ReflectBasedOn = {
1315
+ /**
1316
+ * Memories
1317
+ *
1318
+ * Memory facts used to generate the response
1319
+ */
1320
+ memories?: Array<ReflectFact>;
1321
+ /**
1322
+ * Mental Models
1323
+ *
1324
+ * Mental models used during reflection
1325
+ */
1326
+ mental_models?: Array<ReflectMentalModel>;
1327
+ /**
1328
+ * Directives
1329
+ *
1330
+ * Directives applied during reflection
1331
+ */
1332
+ directives?: Array<ReflectDirective>;
1333
+ };
1334
+
1335
+ /**
1336
+ * ReflectDirective
1337
+ *
1338
+ * A directive applied during reflect.
1339
+ */
1340
+ export type ReflectDirective = {
1341
+ /**
1342
+ * Id
1343
+ *
1344
+ * Directive ID
1345
+ */
1346
+ id: string;
1347
+ /**
1348
+ * Name
1349
+ *
1350
+ * Directive name
1351
+ */
1352
+ name: string;
1353
+ /**
1354
+ * Content
1355
+ *
1356
+ * Directive content
1357
+ */
1358
+ content: string;
866
1359
  };
867
1360
 
868
1361
  /**
@@ -907,6 +1400,56 @@ export type ReflectIncludeOptions = {
907
1400
  * Include facts that the answer is based on. Set to {} to enable, null to disable (default: disabled).
908
1401
  */
909
1402
  facts?: FactsIncludeOptions | null;
1403
+ /**
1404
+ * Include tool calls trace. Set to {} for full trace (input+output), {output: false} for inputs only.
1405
+ */
1406
+ tool_calls?: ToolCallsIncludeOptions | null;
1407
+ };
1408
+
1409
+ /**
1410
+ * ReflectLLMCall
1411
+ *
1412
+ * An LLM call made during reflect agent execution.
1413
+ */
1414
+ export type ReflectLlmCall = {
1415
+ /**
1416
+ * Scope
1417
+ *
1418
+ * Call scope: agent_1, agent_2, final, etc.
1419
+ */
1420
+ scope: string;
1421
+ /**
1422
+ * Duration Ms
1423
+ *
1424
+ * Execution time in milliseconds
1425
+ */
1426
+ duration_ms: number;
1427
+ };
1428
+
1429
+ /**
1430
+ * ReflectMentalModel
1431
+ *
1432
+ * A mental model used during reflect.
1433
+ */
1434
+ export type ReflectMentalModel = {
1435
+ /**
1436
+ * Id
1437
+ *
1438
+ * Mental model ID
1439
+ */
1440
+ id: string;
1441
+ /**
1442
+ * Text
1443
+ *
1444
+ * Mental model content
1445
+ */
1446
+ text: string;
1447
+ /**
1448
+ * Context
1449
+ *
1450
+ * Additional context
1451
+ */
1452
+ context?: string | null;
910
1453
  };
911
1454
 
912
1455
  /**
@@ -922,6 +1465,10 @@ export type ReflectRequest = {
922
1465
  budget?: Budget;
923
1466
  /**
924
1467
  * Context
1468
+ *
1469
+ * DEPRECATED: Additional context is now concatenated with the query. Pass context directly in the query field instead. If provided, it will be appended to the query for backward compatibility.
1470
+ *
1471
+ * @deprecated
925
1472
  */
926
1473
  context?: string | null;
927
1474
  /**
@@ -942,6 +1489,18 @@ export type ReflectRequest = {
942
1489
  response_schema?: {
943
1490
  [key: string]: unknown;
944
1491
  } | null;
1492
+ /**
1493
+ * Tags
1494
+ *
1495
+ * Filter memories by tags during reflection. If not specified, all memories are considered.
1496
+ */
1497
+ tags?: Array<string> | null;
1498
+ /**
1499
+ * Tags Match
1500
+ *
1501
+ * How to match tags: 'any' (OR, includes untagged), 'all' (AND, includes untagged), 'any_strict' (OR, excludes untagged), 'all_strict' (AND, excludes untagged).
1502
+ */
1503
+ tags_match?: "any" | "all" | "any_strict" | "all_strict";
945
1504
  };
946
1505
 
947
1506
  /**
@@ -955,9 +1514,9 @@ export type ReflectResponse = {
955
1514
  */
956
1515
  text: string;
957
1516
  /**
958
- * Based On
1517
+ * Evidence used to generate the response. Only present when include.facts is set.
959
1518
  */
960
- based_on?: Array<ReflectFact>;
1519
+ based_on?: ReflectBasedOn | null;
961
1520
  /**
962
1521
  * Structured Output
963
1522
  *
@@ -966,6 +1525,76 @@ export type ReflectResponse = {
966
1525
  structured_output?: {
967
1526
  [key: string]: unknown;
968
1527
  } | null;
1528
+ /**
1529
+ * Token usage metrics for LLM calls during reflection.
1530
+ */
1531
+ usage?: TokenUsage | null;
1532
+ /**
1533
+ * Execution trace of tool and LLM calls. Only present when include.tool_calls is set.
1534
+ */
1535
+ trace?: ReflectTrace | null;
1536
+ };
1537
+
1538
+ /**
1539
+ * ReflectToolCall
1540
+ *
1541
+ * A tool call made during reflect agent execution.
1542
+ */
1543
+ export type ReflectToolCall = {
1544
+ /**
1545
+ * Tool
1546
+ *
1547
+ * Tool name: lookup, recall, learn, expand
1548
+ */
1549
+ tool: string;
1550
+ /**
1551
+ * Input
1552
+ *
1553
+ * Tool input parameters
1554
+ */
1555
+ input: {
1556
+ [key: string]: unknown;
1557
+ };
1558
+ /**
1559
+ * Output
1560
+ *
1561
+ * Tool output (only included when include.tool_calls.output is true)
1562
+ */
1563
+ output?: {
1564
+ [key: string]: unknown;
1565
+ } | null;
1566
+ /**
1567
+ * Duration Ms
1568
+ *
1569
+ * Execution time in milliseconds
1570
+ */
1571
+ duration_ms: number;
1572
+ /**
1573
+ * Iteration
1574
+ *
1575
+ * Iteration number (1-based) when this tool was called
1576
+ */
1577
+ iteration?: number;
1578
+ };
1579
+
1580
+ /**
1581
+ * ReflectTrace
1582
+ *
1583
+ * Execution trace of LLM and tool calls during reflection.
1584
+ */
1585
+ export type ReflectTrace = {
1586
+ /**
1587
+ * Tool Calls
1588
+ *
1589
+ * Tool calls made during reflection
1590
+ */
1591
+ tool_calls?: Array<ReflectToolCall>;
1592
+ /**
1593
+ * Llm Calls
1594
+ *
1595
+ * LLM calls made during reflection
1596
+ */
1597
+ llm_calls?: Array<ReflectLlmCall>;
969
1598
  };
970
1599
 
971
1600
  /**
@@ -984,6 +1613,12 @@ export type RetainRequest = {
984
1613
  * If true, process asynchronously in background. If false, wait for completion (default: false)
985
1614
  */
986
1615
  async?: boolean;
1616
+ /**
1617
+ * Document Tags
1618
+ *
1619
+ * Tags applied to all items in this request. These are merged with any item-level tags.
1620
+ */
1621
+ document_tags?: Array<string> | null;
987
1622
  };
988
1623
 
989
1624
  /**
@@ -1010,38 +1645,203 @@ export type RetainResponse = {
1010
1645
  * Whether the operation was processed asynchronously
1011
1646
  */
1012
1647
  async: boolean;
1648
+ /**
1649
+ * Operation Id
1650
+ *
1651
+ * Operation ID for tracking async operations. Use GET /v1/default/banks/{bank_id}/operations to list operations and find this ID. Only present when async=true.
1652
+ */
1653
+ operation_id?: string | null;
1654
+ /**
1655
+ * Token usage metrics for LLM calls during fact extraction (only present for synchronous operations)
1656
+ */
1657
+ usage?: TokenUsage | null;
1013
1658
  };
1014
1659
 
1015
1660
  /**
1016
- * UpdateDispositionRequest
1661
+ * TagItem
1017
1662
  *
1018
- * Request model for updating disposition traits.
1663
+ * Single tag with usage count.
1019
1664
  */
1020
- export type UpdateDispositionRequest = {
1021
- disposition: DispositionTraits;
1665
+ export type TagItem = {
1666
+ /**
1667
+ * Tag
1668
+ *
1669
+ * The tag value
1670
+ */
1671
+ tag: string;
1672
+ /**
1673
+ * Count
1674
+ *
1675
+ * Number of memories with this tag
1676
+ */
1677
+ count: number;
1022
1678
  };
1023
1679
 
1024
1680
  /**
1025
- * ValidationError
1681
+ * TokenUsage
1682
+ *
1683
+ * Token usage metrics for LLM calls.
1684
+ *
1685
+ * Tracks input/output tokens for a single request to enable
1686
+ * per-request cost tracking and monitoring.
1026
1687
  */
1027
- export type ValidationError = {
1688
+ export type TokenUsage = {
1028
1689
  /**
1029
- * Location
1690
+ * Input Tokens
1691
+ *
1692
+ * Number of input/prompt tokens consumed
1030
1693
  */
1031
- loc: Array<string | number>;
1694
+ input_tokens?: number;
1032
1695
  /**
1033
- * Message
1696
+ * Output Tokens
1697
+ *
1698
+ * Number of output/completion tokens generated
1034
1699
  */
1035
- msg: string;
1700
+ output_tokens?: number;
1036
1701
  /**
1037
- * Error Type
1702
+ * Total Tokens
1703
+ *
1704
+ * Total tokens (input + output)
1038
1705
  */
1039
- type: string;
1706
+ total_tokens?: number;
1040
1707
  };
1041
1708
 
1042
- export type HealthEndpointHealthGetData = {
1043
- body?: never;
1044
- path?: never;
1709
+ /**
1710
+ * ToolCallsIncludeOptions
1711
+ *
1712
+ * Options for including tool calls in reflect results.
1713
+ */
1714
+ export type ToolCallsIncludeOptions = {
1715
+ /**
1716
+ * Output
1717
+ *
1718
+ * Include tool outputs in the trace. Set to false to only include inputs (smaller payload).
1719
+ */
1720
+ output?: boolean;
1721
+ };
1722
+
1723
+ /**
1724
+ * UpdateDirectiveRequest
1725
+ *
1726
+ * Request model for updating a directive.
1727
+ */
1728
+ export type UpdateDirectiveRequest = {
1729
+ /**
1730
+ * Name
1731
+ *
1732
+ * New name
1733
+ */
1734
+ name?: string | null;
1735
+ /**
1736
+ * Content
1737
+ *
1738
+ * New content
1739
+ */
1740
+ content?: string | null;
1741
+ /**
1742
+ * Priority
1743
+ *
1744
+ * New priority
1745
+ */
1746
+ priority?: number | null;
1747
+ /**
1748
+ * Is Active
1749
+ *
1750
+ * New active status
1751
+ */
1752
+ is_active?: boolean | null;
1753
+ /**
1754
+ * Tags
1755
+ *
1756
+ * New tags
1757
+ */
1758
+ tags?: Array<string> | null;
1759
+ };
1760
+
1761
+ /**
1762
+ * UpdateDispositionRequest
1763
+ *
1764
+ * Request model for updating disposition traits.
1765
+ */
1766
+ export type UpdateDispositionRequest = {
1767
+ disposition: DispositionTraits;
1768
+ };
1769
+
1770
+ /**
1771
+ * UpdateMentalModelRequest
1772
+ *
1773
+ * Request model for updating a mental model.
1774
+ */
1775
+ export type UpdateMentalModelRequest = {
1776
+ /**
1777
+ * Name
1778
+ *
1779
+ * New name for the mental model
1780
+ */
1781
+ name?: string | null;
1782
+ /**
1783
+ * Source Query
1784
+ *
1785
+ * New source query for the mental model
1786
+ */
1787
+ source_query?: string | null;
1788
+ /**
1789
+ * Max Tokens
1790
+ *
1791
+ * Maximum tokens for generated content
1792
+ */
1793
+ max_tokens?: number | null;
1794
+ /**
1795
+ * Tags
1796
+ *
1797
+ * Tags for scoped visibility
1798
+ */
1799
+ tags?: Array<string> | null;
1800
+ /**
1801
+ * Trigger settings
1802
+ */
1803
+ trigger?: MentalModelTrigger | null;
1804
+ };
1805
+
1806
+ /**
1807
+ * ValidationError
1808
+ */
1809
+ export type ValidationError = {
1810
+ /**
1811
+ * Location
1812
+ */
1813
+ loc: Array<string | number>;
1814
+ /**
1815
+ * Message
1816
+ */
1817
+ msg: string;
1818
+ /**
1819
+ * Error Type
1820
+ */
1821
+ type: string;
1822
+ };
1823
+
1824
+ /**
1825
+ * VersionResponse
1826
+ *
1827
+ * Response model for the version/info endpoint.
1828
+ */
1829
+ export type VersionResponse = {
1830
+ /**
1831
+ * Api Version
1832
+ *
1833
+ * API version string
1834
+ */
1835
+ api_version: string;
1836
+ /**
1837
+ * Enabled feature flags
1838
+ */
1839
+ features: FeaturesInfo;
1840
+ };
1841
+
1842
+ export type HealthEndpointHealthGetData = {
1843
+ body?: never;
1844
+ path?: never;
1045
1845
  query?: never;
1046
1846
  url: "/health";
1047
1847
  };
@@ -1053,6 +1853,22 @@ export type HealthEndpointHealthGetResponses = {
1053
1853
  200: unknown;
1054
1854
  };
1055
1855
 
1856
+ export type GetVersionData = {
1857
+ body?: never;
1858
+ path?: never;
1859
+ query?: never;
1860
+ url: "/version";
1861
+ };
1862
+
1863
+ export type GetVersionResponses = {
1864
+ /**
1865
+ * Successful Response
1866
+ */
1867
+ 200: VersionResponse;
1868
+ };
1869
+
1870
+ export type GetVersionResponse = GetVersionResponses[keyof GetVersionResponses];
1871
+
1056
1872
  export type MetricsEndpointMetricsGetData = {
1057
1873
  body?: never;
1058
1874
  path?: never;
@@ -1086,6 +1902,10 @@ export type GetGraphData = {
1086
1902
  * Type
1087
1903
  */
1088
1904
  type?: string | null;
1905
+ /**
1906
+ * Limit
1907
+ */
1908
+ limit?: number;
1089
1909
  };
1090
1910
  url: "/v1/default/banks/{bank_id}/graph";
1091
1911
  };
@@ -1162,6 +1982,44 @@ export type ListMemoriesResponses = {
1162
1982
  export type ListMemoriesResponse =
1163
1983
  ListMemoriesResponses[keyof ListMemoriesResponses];
1164
1984
 
1985
+ export type GetMemoryData = {
1986
+ body?: never;
1987
+ headers?: {
1988
+ /**
1989
+ * Authorization
1990
+ */
1991
+ authorization?: string | null;
1992
+ };
1993
+ path: {
1994
+ /**
1995
+ * Bank Id
1996
+ */
1997
+ bank_id: string;
1998
+ /**
1999
+ * Memory Id
2000
+ */
2001
+ memory_id: string;
2002
+ };
2003
+ query?: never;
2004
+ url: "/v1/default/banks/{bank_id}/memories/{memory_id}";
2005
+ };
2006
+
2007
+ export type GetMemoryErrors = {
2008
+ /**
2009
+ * Validation Error
2010
+ */
2011
+ 422: HttpValidationError;
2012
+ };
2013
+
2014
+ export type GetMemoryError = GetMemoryErrors[keyof GetMemoryErrors];
2015
+
2016
+ export type GetMemoryResponses = {
2017
+ /**
2018
+ * Successful Response
2019
+ */
2020
+ 200: unknown;
2021
+ };
2022
+
1165
2023
  export type RecallMemoriesData = {
1166
2024
  body: RecallRequest;
1167
2025
  headers?: {
@@ -1240,35 +2098,537 @@ export type ListBanksData = {
1240
2098
  body?: never;
1241
2099
  headers?: {
1242
2100
  /**
1243
- * Authorization
2101
+ * Authorization
2102
+ */
2103
+ authorization?: string | null;
2104
+ };
2105
+ path?: never;
2106
+ query?: never;
2107
+ url: "/v1/default/banks";
2108
+ };
2109
+
2110
+ export type ListBanksErrors = {
2111
+ /**
2112
+ * Validation Error
2113
+ */
2114
+ 422: HttpValidationError;
2115
+ };
2116
+
2117
+ export type ListBanksError = ListBanksErrors[keyof ListBanksErrors];
2118
+
2119
+ export type ListBanksResponses = {
2120
+ /**
2121
+ * Successful Response
2122
+ */
2123
+ 200: BankListResponse;
2124
+ };
2125
+
2126
+ export type ListBanksResponse = ListBanksResponses[keyof ListBanksResponses];
2127
+
2128
+ export type GetAgentStatsData = {
2129
+ body?: never;
2130
+ headers?: {
2131
+ /**
2132
+ * Authorization
2133
+ */
2134
+ authorization?: string | null;
2135
+ };
2136
+ path: {
2137
+ /**
2138
+ * Bank Id
2139
+ */
2140
+ bank_id: string;
2141
+ };
2142
+ query?: never;
2143
+ url: "/v1/default/banks/{bank_id}/stats";
2144
+ };
2145
+
2146
+ export type GetAgentStatsErrors = {
2147
+ /**
2148
+ * Validation Error
2149
+ */
2150
+ 422: HttpValidationError;
2151
+ };
2152
+
2153
+ export type GetAgentStatsError = GetAgentStatsErrors[keyof GetAgentStatsErrors];
2154
+
2155
+ export type GetAgentStatsResponses = {
2156
+ /**
2157
+ * Successful Response
2158
+ */
2159
+ 200: BankStatsResponse;
2160
+ };
2161
+
2162
+ export type GetAgentStatsResponse =
2163
+ GetAgentStatsResponses[keyof GetAgentStatsResponses];
2164
+
2165
+ export type ListEntitiesData = {
2166
+ body?: never;
2167
+ headers?: {
2168
+ /**
2169
+ * Authorization
2170
+ */
2171
+ authorization?: string | null;
2172
+ };
2173
+ path: {
2174
+ /**
2175
+ * Bank Id
2176
+ */
2177
+ bank_id: string;
2178
+ };
2179
+ query?: {
2180
+ /**
2181
+ * Limit
2182
+ *
2183
+ * Maximum number of entities to return
2184
+ */
2185
+ limit?: number;
2186
+ /**
2187
+ * Offset
2188
+ *
2189
+ * Offset for pagination
2190
+ */
2191
+ offset?: number;
2192
+ };
2193
+ url: "/v1/default/banks/{bank_id}/entities";
2194
+ };
2195
+
2196
+ export type ListEntitiesErrors = {
2197
+ /**
2198
+ * Validation Error
2199
+ */
2200
+ 422: HttpValidationError;
2201
+ };
2202
+
2203
+ export type ListEntitiesError = ListEntitiesErrors[keyof ListEntitiesErrors];
2204
+
2205
+ export type ListEntitiesResponses = {
2206
+ /**
2207
+ * Successful Response
2208
+ */
2209
+ 200: EntityListResponse;
2210
+ };
2211
+
2212
+ export type ListEntitiesResponse =
2213
+ ListEntitiesResponses[keyof ListEntitiesResponses];
2214
+
2215
+ export type GetEntityData = {
2216
+ body?: never;
2217
+ headers?: {
2218
+ /**
2219
+ * Authorization
2220
+ */
2221
+ authorization?: string | null;
2222
+ };
2223
+ path: {
2224
+ /**
2225
+ * Bank Id
2226
+ */
2227
+ bank_id: string;
2228
+ /**
2229
+ * Entity Id
2230
+ */
2231
+ entity_id: string;
2232
+ };
2233
+ query?: never;
2234
+ url: "/v1/default/banks/{bank_id}/entities/{entity_id}";
2235
+ };
2236
+
2237
+ export type GetEntityErrors = {
2238
+ /**
2239
+ * Validation Error
2240
+ */
2241
+ 422: HttpValidationError;
2242
+ };
2243
+
2244
+ export type GetEntityError = GetEntityErrors[keyof GetEntityErrors];
2245
+
2246
+ export type GetEntityResponses = {
2247
+ /**
2248
+ * Successful Response
2249
+ */
2250
+ 200: EntityDetailResponse;
2251
+ };
2252
+
2253
+ export type GetEntityResponse = GetEntityResponses[keyof GetEntityResponses];
2254
+
2255
+ export type RegenerateEntityObservationsData = {
2256
+ body?: never;
2257
+ headers?: {
2258
+ /**
2259
+ * Authorization
2260
+ */
2261
+ authorization?: string | null;
2262
+ };
2263
+ path: {
2264
+ /**
2265
+ * Bank Id
2266
+ */
2267
+ bank_id: string;
2268
+ /**
2269
+ * Entity Id
2270
+ */
2271
+ entity_id: string;
2272
+ };
2273
+ query?: never;
2274
+ url: "/v1/default/banks/{bank_id}/entities/{entity_id}/regenerate";
2275
+ };
2276
+
2277
+ export type RegenerateEntityObservationsErrors = {
2278
+ /**
2279
+ * Validation Error
2280
+ */
2281
+ 422: HttpValidationError;
2282
+ };
2283
+
2284
+ export type RegenerateEntityObservationsError =
2285
+ RegenerateEntityObservationsErrors[keyof RegenerateEntityObservationsErrors];
2286
+
2287
+ export type RegenerateEntityObservationsResponses = {
2288
+ /**
2289
+ * Successful Response
2290
+ */
2291
+ 200: EntityDetailResponse;
2292
+ };
2293
+
2294
+ export type RegenerateEntityObservationsResponse =
2295
+ RegenerateEntityObservationsResponses[keyof RegenerateEntityObservationsResponses];
2296
+
2297
+ export type ListMentalModelsData = {
2298
+ body?: never;
2299
+ headers?: {
2300
+ /**
2301
+ * Authorization
2302
+ */
2303
+ authorization?: string | null;
2304
+ };
2305
+ path: {
2306
+ /**
2307
+ * Bank Id
2308
+ */
2309
+ bank_id: string;
2310
+ };
2311
+ query?: {
2312
+ /**
2313
+ * Tags
2314
+ *
2315
+ * Filter by tags
2316
+ */
2317
+ tags?: Array<string> | null;
2318
+ /**
2319
+ * Tags Match
2320
+ *
2321
+ * How to match tags
2322
+ */
2323
+ tags_match?: "any" | "all" | "exact";
2324
+ /**
2325
+ * Limit
2326
+ */
2327
+ limit?: number;
2328
+ /**
2329
+ * Offset
2330
+ */
2331
+ offset?: number;
2332
+ };
2333
+ url: "/v1/default/banks/{bank_id}/mental-models";
2334
+ };
2335
+
2336
+ export type ListMentalModelsErrors = {
2337
+ /**
2338
+ * Validation Error
2339
+ */
2340
+ 422: HttpValidationError;
2341
+ };
2342
+
2343
+ export type ListMentalModelsError =
2344
+ ListMentalModelsErrors[keyof ListMentalModelsErrors];
2345
+
2346
+ export type ListMentalModelsResponses = {
2347
+ /**
2348
+ * Successful Response
2349
+ */
2350
+ 200: MentalModelListResponse;
2351
+ };
2352
+
2353
+ export type ListMentalModelsResponse =
2354
+ ListMentalModelsResponses[keyof ListMentalModelsResponses];
2355
+
2356
+ export type CreateMentalModelData = {
2357
+ body: CreateMentalModelRequest;
2358
+ headers?: {
2359
+ /**
2360
+ * Authorization
2361
+ */
2362
+ authorization?: string | null;
2363
+ };
2364
+ path: {
2365
+ /**
2366
+ * Bank Id
2367
+ */
2368
+ bank_id: string;
2369
+ };
2370
+ query?: never;
2371
+ url: "/v1/default/banks/{bank_id}/mental-models";
2372
+ };
2373
+
2374
+ export type CreateMentalModelErrors = {
2375
+ /**
2376
+ * Validation Error
2377
+ */
2378
+ 422: HttpValidationError;
2379
+ };
2380
+
2381
+ export type CreateMentalModelError =
2382
+ CreateMentalModelErrors[keyof CreateMentalModelErrors];
2383
+
2384
+ export type CreateMentalModelResponses = {
2385
+ /**
2386
+ * Successful Response
2387
+ */
2388
+ 200: CreateMentalModelResponse;
2389
+ };
2390
+
2391
+ export type CreateMentalModelResponse2 =
2392
+ CreateMentalModelResponses[keyof CreateMentalModelResponses];
2393
+
2394
+ export type DeleteMentalModelData = {
2395
+ body?: never;
2396
+ headers?: {
2397
+ /**
2398
+ * Authorization
2399
+ */
2400
+ authorization?: string | null;
2401
+ };
2402
+ path: {
2403
+ /**
2404
+ * Bank Id
2405
+ */
2406
+ bank_id: string;
2407
+ /**
2408
+ * Mental Model Id
2409
+ */
2410
+ mental_model_id: string;
2411
+ };
2412
+ query?: never;
2413
+ url: "/v1/default/banks/{bank_id}/mental-models/{mental_model_id}";
2414
+ };
2415
+
2416
+ export type DeleteMentalModelErrors = {
2417
+ /**
2418
+ * Validation Error
2419
+ */
2420
+ 422: HttpValidationError;
2421
+ };
2422
+
2423
+ export type DeleteMentalModelError =
2424
+ DeleteMentalModelErrors[keyof DeleteMentalModelErrors];
2425
+
2426
+ export type DeleteMentalModelResponses = {
2427
+ /**
2428
+ * Successful Response
2429
+ */
2430
+ 200: unknown;
2431
+ };
2432
+
2433
+ export type GetMentalModelData = {
2434
+ body?: never;
2435
+ headers?: {
2436
+ /**
2437
+ * Authorization
2438
+ */
2439
+ authorization?: string | null;
2440
+ };
2441
+ path: {
2442
+ /**
2443
+ * Bank Id
2444
+ */
2445
+ bank_id: string;
2446
+ /**
2447
+ * Mental Model Id
2448
+ */
2449
+ mental_model_id: string;
2450
+ };
2451
+ query?: never;
2452
+ url: "/v1/default/banks/{bank_id}/mental-models/{mental_model_id}";
2453
+ };
2454
+
2455
+ export type GetMentalModelErrors = {
2456
+ /**
2457
+ * Validation Error
2458
+ */
2459
+ 422: HttpValidationError;
2460
+ };
2461
+
2462
+ export type GetMentalModelError =
2463
+ GetMentalModelErrors[keyof GetMentalModelErrors];
2464
+
2465
+ export type GetMentalModelResponses = {
2466
+ /**
2467
+ * Successful Response
2468
+ */
2469
+ 200: MentalModelResponse;
2470
+ };
2471
+
2472
+ export type GetMentalModelResponse =
2473
+ GetMentalModelResponses[keyof GetMentalModelResponses];
2474
+
2475
+ export type UpdateMentalModelData = {
2476
+ body: UpdateMentalModelRequest;
2477
+ headers?: {
2478
+ /**
2479
+ * Authorization
2480
+ */
2481
+ authorization?: string | null;
2482
+ };
2483
+ path: {
2484
+ /**
2485
+ * Bank Id
2486
+ */
2487
+ bank_id: string;
2488
+ /**
2489
+ * Mental Model Id
2490
+ */
2491
+ mental_model_id: string;
2492
+ };
2493
+ query?: never;
2494
+ url: "/v1/default/banks/{bank_id}/mental-models/{mental_model_id}";
2495
+ };
2496
+
2497
+ export type UpdateMentalModelErrors = {
2498
+ /**
2499
+ * Validation Error
2500
+ */
2501
+ 422: HttpValidationError;
2502
+ };
2503
+
2504
+ export type UpdateMentalModelError =
2505
+ UpdateMentalModelErrors[keyof UpdateMentalModelErrors];
2506
+
2507
+ export type UpdateMentalModelResponses = {
2508
+ /**
2509
+ * Successful Response
2510
+ */
2511
+ 200: MentalModelResponse;
2512
+ };
2513
+
2514
+ export type UpdateMentalModelResponse =
2515
+ UpdateMentalModelResponses[keyof UpdateMentalModelResponses];
2516
+
2517
+ export type RefreshMentalModelData = {
2518
+ body?: never;
2519
+ headers?: {
2520
+ /**
2521
+ * Authorization
2522
+ */
2523
+ authorization?: string | null;
2524
+ };
2525
+ path: {
2526
+ /**
2527
+ * Bank Id
2528
+ */
2529
+ bank_id: string;
2530
+ /**
2531
+ * Mental Model Id
2532
+ */
2533
+ mental_model_id: string;
2534
+ };
2535
+ query?: never;
2536
+ url: "/v1/default/banks/{bank_id}/mental-models/{mental_model_id}/refresh";
2537
+ };
2538
+
2539
+ export type RefreshMentalModelErrors = {
2540
+ /**
2541
+ * Validation Error
2542
+ */
2543
+ 422: HttpValidationError;
2544
+ };
2545
+
2546
+ export type RefreshMentalModelError =
2547
+ RefreshMentalModelErrors[keyof RefreshMentalModelErrors];
2548
+
2549
+ export type RefreshMentalModelResponses = {
2550
+ /**
2551
+ * Successful Response
2552
+ */
2553
+ 200: AsyncOperationSubmitResponse;
2554
+ };
2555
+
2556
+ export type RefreshMentalModelResponse =
2557
+ RefreshMentalModelResponses[keyof RefreshMentalModelResponses];
2558
+
2559
+ export type ListDirectivesData = {
2560
+ body?: never;
2561
+ headers?: {
2562
+ /**
2563
+ * Authorization
2564
+ */
2565
+ authorization?: string | null;
2566
+ };
2567
+ path: {
2568
+ /**
2569
+ * Bank Id
2570
+ */
2571
+ bank_id: string;
2572
+ };
2573
+ query?: {
2574
+ /**
2575
+ * Tags
2576
+ *
2577
+ * Filter by tags
2578
+ */
2579
+ tags?: Array<string> | null;
2580
+ /**
2581
+ * Tags Match
2582
+ *
2583
+ * How to match tags
2584
+ */
2585
+ tags_match?: "any" | "all" | "exact";
2586
+ /**
2587
+ * Active Only
2588
+ *
2589
+ * Only return active directives
2590
+ */
2591
+ active_only?: boolean;
2592
+ /**
2593
+ * Limit
1244
2594
  */
1245
- authorization?: string | null;
2595
+ limit?: number;
2596
+ /**
2597
+ * Offset
2598
+ */
2599
+ offset?: number;
1246
2600
  };
1247
- path?: never;
1248
- query?: never;
1249
- url: "/v1/default/banks";
2601
+ url: "/v1/default/banks/{bank_id}/directives";
1250
2602
  };
1251
2603
 
1252
- export type ListBanksErrors = {
2604
+ export type ListDirectivesErrors = {
1253
2605
  /**
1254
2606
  * Validation Error
1255
2607
  */
1256
2608
  422: HttpValidationError;
1257
2609
  };
1258
2610
 
1259
- export type ListBanksError = ListBanksErrors[keyof ListBanksErrors];
2611
+ export type ListDirectivesError =
2612
+ ListDirectivesErrors[keyof ListDirectivesErrors];
1260
2613
 
1261
- export type ListBanksResponses = {
2614
+ export type ListDirectivesResponses = {
1262
2615
  /**
1263
2616
  * Successful Response
1264
2617
  */
1265
- 200: BankListResponse;
2618
+ 200: DirectiveListResponse;
1266
2619
  };
1267
2620
 
1268
- export type ListBanksResponse = ListBanksResponses[keyof ListBanksResponses];
2621
+ export type ListDirectivesResponse =
2622
+ ListDirectivesResponses[keyof ListDirectivesResponses];
1269
2623
 
1270
- export type GetAgentStatsData = {
1271
- body?: never;
2624
+ export type CreateDirectiveData = {
2625
+ body: CreateDirectiveRequest;
2626
+ headers?: {
2627
+ /**
2628
+ * Authorization
2629
+ */
2630
+ authorization?: string | null;
2631
+ };
1272
2632
  path: {
1273
2633
  /**
1274
2634
  * Bank Id
@@ -1276,29 +2636,30 @@ export type GetAgentStatsData = {
1276
2636
  bank_id: string;
1277
2637
  };
1278
2638
  query?: never;
1279
- url: "/v1/default/banks/{bank_id}/stats";
2639
+ url: "/v1/default/banks/{bank_id}/directives";
1280
2640
  };
1281
2641
 
1282
- export type GetAgentStatsErrors = {
2642
+ export type CreateDirectiveErrors = {
1283
2643
  /**
1284
2644
  * Validation Error
1285
2645
  */
1286
2646
  422: HttpValidationError;
1287
2647
  };
1288
2648
 
1289
- export type GetAgentStatsError = GetAgentStatsErrors[keyof GetAgentStatsErrors];
2649
+ export type CreateDirectiveError =
2650
+ CreateDirectiveErrors[keyof CreateDirectiveErrors];
1290
2651
 
1291
- export type GetAgentStatsResponses = {
2652
+ export type CreateDirectiveResponses = {
1292
2653
  /**
1293
2654
  * Successful Response
1294
2655
  */
1295
- 200: BankStatsResponse;
2656
+ 200: DirectiveResponse;
1296
2657
  };
1297
2658
 
1298
- export type GetAgentStatsResponse =
1299
- GetAgentStatsResponses[keyof GetAgentStatsResponses];
2659
+ export type CreateDirectiveResponse =
2660
+ CreateDirectiveResponses[keyof CreateDirectiveResponses];
1300
2661
 
1301
- export type ListEntitiesData = {
2662
+ export type DeleteDirectiveData = {
1302
2663
  body?: never;
1303
2664
  headers?: {
1304
2665
  /**
@@ -1311,38 +2672,33 @@ export type ListEntitiesData = {
1311
2672
  * Bank Id
1312
2673
  */
1313
2674
  bank_id: string;
1314
- };
1315
- query?: {
1316
2675
  /**
1317
- * Limit
1318
- *
1319
- * Maximum number of entities to return
2676
+ * Directive Id
1320
2677
  */
1321
- limit?: number;
2678
+ directive_id: string;
1322
2679
  };
1323
- url: "/v1/default/banks/{bank_id}/entities";
2680
+ query?: never;
2681
+ url: "/v1/default/banks/{bank_id}/directives/{directive_id}";
1324
2682
  };
1325
2683
 
1326
- export type ListEntitiesErrors = {
2684
+ export type DeleteDirectiveErrors = {
1327
2685
  /**
1328
2686
  * Validation Error
1329
2687
  */
1330
2688
  422: HttpValidationError;
1331
2689
  };
1332
2690
 
1333
- export type ListEntitiesError = ListEntitiesErrors[keyof ListEntitiesErrors];
2691
+ export type DeleteDirectiveError =
2692
+ DeleteDirectiveErrors[keyof DeleteDirectiveErrors];
1334
2693
 
1335
- export type ListEntitiesResponses = {
2694
+ export type DeleteDirectiveResponses = {
1336
2695
  /**
1337
2696
  * Successful Response
1338
2697
  */
1339
- 200: EntityListResponse;
2698
+ 200: unknown;
1340
2699
  };
1341
2700
 
1342
- export type ListEntitiesResponse =
1343
- ListEntitiesResponses[keyof ListEntitiesResponses];
1344
-
1345
- export type GetEntityData = {
2701
+ export type GetDirectiveData = {
1346
2702
  body?: never;
1347
2703
  headers?: {
1348
2704
  /**
@@ -1356,34 +2712,35 @@ export type GetEntityData = {
1356
2712
  */
1357
2713
  bank_id: string;
1358
2714
  /**
1359
- * Entity Id
2715
+ * Directive Id
1360
2716
  */
1361
- entity_id: string;
2717
+ directive_id: string;
1362
2718
  };
1363
2719
  query?: never;
1364
- url: "/v1/default/banks/{bank_id}/entities/{entity_id}";
2720
+ url: "/v1/default/banks/{bank_id}/directives/{directive_id}";
1365
2721
  };
1366
2722
 
1367
- export type GetEntityErrors = {
2723
+ export type GetDirectiveErrors = {
1368
2724
  /**
1369
2725
  * Validation Error
1370
2726
  */
1371
2727
  422: HttpValidationError;
1372
2728
  };
1373
2729
 
1374
- export type GetEntityError = GetEntityErrors[keyof GetEntityErrors];
2730
+ export type GetDirectiveError = GetDirectiveErrors[keyof GetDirectiveErrors];
1375
2731
 
1376
- export type GetEntityResponses = {
2732
+ export type GetDirectiveResponses = {
1377
2733
  /**
1378
2734
  * Successful Response
1379
2735
  */
1380
- 200: EntityDetailResponse;
2736
+ 200: DirectiveResponse;
1381
2737
  };
1382
2738
 
1383
- export type GetEntityResponse = GetEntityResponses[keyof GetEntityResponses];
2739
+ export type GetDirectiveResponse =
2740
+ GetDirectiveResponses[keyof GetDirectiveResponses];
1384
2741
 
1385
- export type RegenerateEntityObservationsData = {
1386
- body?: never;
2742
+ export type UpdateDirectiveData = {
2743
+ body: UpdateDirectiveRequest;
1387
2744
  headers?: {
1388
2745
  /**
1389
2746
  * Authorization
@@ -1396,33 +2753,33 @@ export type RegenerateEntityObservationsData = {
1396
2753
  */
1397
2754
  bank_id: string;
1398
2755
  /**
1399
- * Entity Id
2756
+ * Directive Id
1400
2757
  */
1401
- entity_id: string;
2758
+ directive_id: string;
1402
2759
  };
1403
2760
  query?: never;
1404
- url: "/v1/default/banks/{bank_id}/entities/{entity_id}/regenerate";
2761
+ url: "/v1/default/banks/{bank_id}/directives/{directive_id}";
1405
2762
  };
1406
2763
 
1407
- export type RegenerateEntityObservationsErrors = {
2764
+ export type UpdateDirectiveErrors = {
1408
2765
  /**
1409
2766
  * Validation Error
1410
2767
  */
1411
2768
  422: HttpValidationError;
1412
2769
  };
1413
2770
 
1414
- export type RegenerateEntityObservationsError =
1415
- RegenerateEntityObservationsErrors[keyof RegenerateEntityObservationsErrors];
2771
+ export type UpdateDirectiveError =
2772
+ UpdateDirectiveErrors[keyof UpdateDirectiveErrors];
1416
2773
 
1417
- export type RegenerateEntityObservationsResponses = {
2774
+ export type UpdateDirectiveResponses = {
1418
2775
  /**
1419
2776
  * Successful Response
1420
2777
  */
1421
- 200: EntityDetailResponse;
2778
+ 200: DirectiveResponse;
1422
2779
  };
1423
2780
 
1424
- export type RegenerateEntityObservationsResponse =
1425
- RegenerateEntityObservationsResponses[keyof RegenerateEntityObservationsResponses];
2781
+ export type UpdateDirectiveResponse =
2782
+ UpdateDirectiveResponses[keyof UpdateDirectiveResponses];
1426
2783
 
1427
2784
  export type ListDocumentsData = {
1428
2785
  body?: never;
@@ -1557,6 +2914,61 @@ export type GetDocumentResponses = {
1557
2914
  export type GetDocumentResponse =
1558
2915
  GetDocumentResponses[keyof GetDocumentResponses];
1559
2916
 
2917
+ export type ListTagsData = {
2918
+ body?: never;
2919
+ headers?: {
2920
+ /**
2921
+ * Authorization
2922
+ */
2923
+ authorization?: string | null;
2924
+ };
2925
+ path: {
2926
+ /**
2927
+ * Bank Id
2928
+ */
2929
+ bank_id: string;
2930
+ };
2931
+ query?: {
2932
+ /**
2933
+ * Q
2934
+ *
2935
+ * Wildcard pattern to filter tags (e.g., 'user:*' for user:alice, '*-admin' for role-admin). Use '*' as wildcard. Case-insensitive.
2936
+ */
2937
+ q?: string | null;
2938
+ /**
2939
+ * Limit
2940
+ *
2941
+ * Maximum number of tags to return
2942
+ */
2943
+ limit?: number;
2944
+ /**
2945
+ * Offset
2946
+ *
2947
+ * Offset for pagination
2948
+ */
2949
+ offset?: number;
2950
+ };
2951
+ url: "/v1/default/banks/{bank_id}/tags";
2952
+ };
2953
+
2954
+ export type ListTagsErrors = {
2955
+ /**
2956
+ * Validation Error
2957
+ */
2958
+ 422: HttpValidationError;
2959
+ };
2960
+
2961
+ export type ListTagsError = ListTagsErrors[keyof ListTagsErrors];
2962
+
2963
+ export type ListTagsResponses = {
2964
+ /**
2965
+ * Successful Response
2966
+ */
2967
+ 200: ListTagsResponse;
2968
+ };
2969
+
2970
+ export type ListTagsResponse2 = ListTagsResponses[keyof ListTagsResponses];
2971
+
1560
2972
  export type GetChunkData = {
1561
2973
  body?: never;
1562
2974
  headers?: {
@@ -1607,7 +3019,26 @@ export type ListOperationsData = {
1607
3019
  */
1608
3020
  bank_id: string;
1609
3021
  };
1610
- query?: never;
3022
+ query?: {
3023
+ /**
3024
+ * Status
3025
+ *
3026
+ * Filter by status: pending, completed, or failed
3027
+ */
3028
+ status?: string | null;
3029
+ /**
3030
+ * Limit
3031
+ *
3032
+ * Maximum number of operations to return
3033
+ */
3034
+ limit?: number;
3035
+ /**
3036
+ * Offset
3037
+ *
3038
+ * Number of operations to skip
3039
+ */
3040
+ offset?: number;
3041
+ };
1611
3042
  url: "/v1/default/banks/{bank_id}/operations";
1612
3043
  };
1613
3044
 
@@ -1673,6 +3104,48 @@ export type CancelOperationResponses = {
1673
3104
  export type CancelOperationResponse2 =
1674
3105
  CancelOperationResponses[keyof CancelOperationResponses];
1675
3106
 
3107
+ export type GetOperationStatusData = {
3108
+ body?: never;
3109
+ headers?: {
3110
+ /**
3111
+ * Authorization
3112
+ */
3113
+ authorization?: string | null;
3114
+ };
3115
+ path: {
3116
+ /**
3117
+ * Bank Id
3118
+ */
3119
+ bank_id: string;
3120
+ /**
3121
+ * Operation Id
3122
+ */
3123
+ operation_id: string;
3124
+ };
3125
+ query?: never;
3126
+ url: "/v1/default/banks/{bank_id}/operations/{operation_id}";
3127
+ };
3128
+
3129
+ export type GetOperationStatusErrors = {
3130
+ /**
3131
+ * Validation Error
3132
+ */
3133
+ 422: HttpValidationError;
3134
+ };
3135
+
3136
+ export type GetOperationStatusError =
3137
+ GetOperationStatusErrors[keyof GetOperationStatusErrors];
3138
+
3139
+ export type GetOperationStatusResponses = {
3140
+ /**
3141
+ * Successful Response
3142
+ */
3143
+ 200: OperationStatusResponse;
3144
+ };
3145
+
3146
+ export type GetOperationStatusResponse =
3147
+ GetOperationStatusResponses[keyof GetOperationStatusResponses];
3148
+
1676
3149
  export type GetBankProfileData = {
1677
3150
  body?: never;
1678
3151
  headers?: {
@@ -1823,6 +3296,42 @@ export type DeleteBankResponses = {
1823
3296
 
1824
3297
  export type DeleteBankResponse = DeleteBankResponses[keyof DeleteBankResponses];
1825
3298
 
3299
+ export type UpdateBankData = {
3300
+ body: CreateBankRequest;
3301
+ headers?: {
3302
+ /**
3303
+ * Authorization
3304
+ */
3305
+ authorization?: string | null;
3306
+ };
3307
+ path: {
3308
+ /**
3309
+ * Bank Id
3310
+ */
3311
+ bank_id: string;
3312
+ };
3313
+ query?: never;
3314
+ url: "/v1/default/banks/{bank_id}";
3315
+ };
3316
+
3317
+ export type UpdateBankErrors = {
3318
+ /**
3319
+ * Validation Error
3320
+ */
3321
+ 422: HttpValidationError;
3322
+ };
3323
+
3324
+ export type UpdateBankError = UpdateBankErrors[keyof UpdateBankErrors];
3325
+
3326
+ export type UpdateBankResponses = {
3327
+ /**
3328
+ * Successful Response
3329
+ */
3330
+ 200: BankProfileResponse;
3331
+ };
3332
+
3333
+ export type UpdateBankResponse = UpdateBankResponses[keyof UpdateBankResponses];
3334
+
1826
3335
  export type CreateOrUpdateBankData = {
1827
3336
  body: CreateBankRequest;
1828
3337
  headers?: {
@@ -1861,6 +3370,82 @@ export type CreateOrUpdateBankResponses = {
1861
3370
  export type CreateOrUpdateBankResponse =
1862
3371
  CreateOrUpdateBankResponses[keyof CreateOrUpdateBankResponses];
1863
3372
 
3373
+ export type ClearObservationsData = {
3374
+ body?: never;
3375
+ headers?: {
3376
+ /**
3377
+ * Authorization
3378
+ */
3379
+ authorization?: string | null;
3380
+ };
3381
+ path: {
3382
+ /**
3383
+ * Bank Id
3384
+ */
3385
+ bank_id: string;
3386
+ };
3387
+ query?: never;
3388
+ url: "/v1/default/banks/{bank_id}/observations";
3389
+ };
3390
+
3391
+ export type ClearObservationsErrors = {
3392
+ /**
3393
+ * Validation Error
3394
+ */
3395
+ 422: HttpValidationError;
3396
+ };
3397
+
3398
+ export type ClearObservationsError =
3399
+ ClearObservationsErrors[keyof ClearObservationsErrors];
3400
+
3401
+ export type ClearObservationsResponses = {
3402
+ /**
3403
+ * Successful Response
3404
+ */
3405
+ 200: DeleteResponse;
3406
+ };
3407
+
3408
+ export type ClearObservationsResponse =
3409
+ ClearObservationsResponses[keyof ClearObservationsResponses];
3410
+
3411
+ export type TriggerConsolidationData = {
3412
+ body?: never;
3413
+ headers?: {
3414
+ /**
3415
+ * Authorization
3416
+ */
3417
+ authorization?: string | null;
3418
+ };
3419
+ path: {
3420
+ /**
3421
+ * Bank Id
3422
+ */
3423
+ bank_id: string;
3424
+ };
3425
+ query?: never;
3426
+ url: "/v1/default/banks/{bank_id}/consolidate";
3427
+ };
3428
+
3429
+ export type TriggerConsolidationErrors = {
3430
+ /**
3431
+ * Validation Error
3432
+ */
3433
+ 422: HttpValidationError;
3434
+ };
3435
+
3436
+ export type TriggerConsolidationError =
3437
+ TriggerConsolidationErrors[keyof TriggerConsolidationErrors];
3438
+
3439
+ export type TriggerConsolidationResponses = {
3440
+ /**
3441
+ * Successful Response
3442
+ */
3443
+ 200: ConsolidationResponse;
3444
+ };
3445
+
3446
+ export type TriggerConsolidationResponse =
3447
+ TriggerConsolidationResponses[keyof TriggerConsolidationResponses];
3448
+
1864
3449
  export type ClearBankMemoriesData = {
1865
3450
  body?: never;
1866
3451
  headers?: {