@vectorize-io/hindsight-client 0.2.0 → 0.3.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.
@@ -43,10 +43,15 @@ export interface MemoryItemInput {
43
43
  metadata?: Record<string, string>;
44
44
  document_id?: string;
45
45
  entities?: EntityInput[];
46
+ tags?: string[];
46
47
  }
47
48
  export declare class HindsightClient {
48
49
  private client;
49
50
  constructor(options: HindsightClientOptions);
51
+ /**
52
+ * Validates the API response and throws an error if the request failed.
53
+ */
54
+ private validateResponse;
50
55
  /**
51
56
  * Retain a single memory for a bank.
52
57
  */
@@ -63,6 +68,7 @@ export declare class HindsightClient {
63
68
  */
64
69
  retainBatch(bankId: string, items: MemoryItemInput[], options?: {
65
70
  documentId?: string;
71
+ documentTags?: string[];
66
72
  async?: boolean;
67
73
  }): Promise<RetainResponse>;
68
74
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,OAAO,KAAK,EACR,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,YAAY,EACZ,cAAc,EACd,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,MAAM,EACT,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,sBAAsB;IAW3C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACG,MAAM,CACR,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACN,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;KAC5B,GACF,OAAO,CAAC,cAAc,CAAC;IAqC1B;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAiCjK;;OAEG;IACG,MAAM,CACR,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,cAAc,CAAC,EAAE,MAAM,CAAC;KAC3B,GACF,OAAO,CAAC,cAAc,CAAC;IAqB1B;;OAEG;IACG,OAAO,CACT,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAChD,OAAO,CAAC,eAAe,CAAC;IAc3B;;OAEG;IACG,YAAY,CACd,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GACzE,OAAO,CAAC,uBAAuB,CAAC;IAenC;;OAEG;IACG,UAAU,CACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,GAAG,CAAA;KAAE,GACnE,OAAO,CAAC,mBAAmB,CAAC;IAc/B;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAQrE;AAGD,YAAY,EACR,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,YAAY,EACZ,cAAc,EACd,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,MAAM,GACT,CAAC;AAGF,OAAO,KAAK,GAAG,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACjE,YAAY,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC"}
package/dist/src/index.js CHANGED
@@ -71,6 +71,15 @@ class HindsightClient {
71
71
  : undefined,
72
72
  }));
73
73
  }
74
+ /**
75
+ * Validates the API response and throws an error if the request failed.
76
+ */
77
+ validateResponse(response, operation) {
78
+ if (!response.data) {
79
+ throw new Error(`${operation} failed: ${JSON.stringify(response.error || 'Unknown error')}`);
80
+ }
81
+ return response.data;
82
+ }
74
83
  /**
75
84
  * Retain a single memory for a bank.
76
85
  */
@@ -99,7 +108,7 @@ class HindsightClient {
99
108
  path: { bank_id: bankId },
100
109
  body: { items: [item], async: options?.async },
101
110
  });
102
- return response.data;
111
+ return this.validateResponse(response, 'retain');
103
112
  }
104
113
  /**
105
114
  * Retain multiple memories in batch.
@@ -111,6 +120,7 @@ class HindsightClient {
111
120
  metadata: item.metadata,
112
121
  document_id: item.document_id,
113
122
  entities: item.entities,
123
+ tags: item.tags,
114
124
  timestamp: item.timestamp instanceof Date
115
125
  ? item.timestamp.toISOString()
116
126
  : item.timestamp,
@@ -125,10 +135,11 @@ class HindsightClient {
125
135
  path: { bank_id: bankId },
126
136
  body: {
127
137
  items: itemsWithDocId,
138
+ document_tags: options?.documentTags,
128
139
  async: options?.async,
129
140
  },
130
141
  });
131
- return response.data;
142
+ return this.validateResponse(response, 'retainBatch');
132
143
  }
133
144
  /**
134
145
  * Recall memories with a natural language query.
@@ -150,10 +161,7 @@ class HindsightClient {
150
161
  },
151
162
  },
152
163
  });
153
- if (!response.data) {
154
- throw new Error(`API returned no data: ${JSON.stringify(response.error || 'Unknown error')}`);
155
- }
156
- return response.data;
164
+ return this.validateResponse(response, 'recall');
157
165
  }
158
166
  /**
159
167
  * Reflect and generate a contextual answer using the bank's identity and memories.
@@ -168,7 +176,7 @@ class HindsightClient {
168
176
  budget: options?.budget || 'low',
169
177
  },
170
178
  });
171
- return response.data;
179
+ return this.validateResponse(response, 'reflect');
172
180
  }
173
181
  /**
174
182
  * List memories with pagination.
@@ -184,7 +192,7 @@ class HindsightClient {
184
192
  q: options?.q,
185
193
  },
186
194
  });
187
- return response.data;
195
+ return this.validateResponse(response, 'listMemories');
188
196
  }
189
197
  /**
190
198
  * Create or update a bank with disposition and background.
@@ -199,7 +207,7 @@ class HindsightClient {
199
207
  disposition: options.disposition,
200
208
  },
201
209
  });
202
- return response.data;
210
+ return this.validateResponse(response, 'createBank');
203
211
  }
204
212
  /**
205
213
  * Get a bank's profile.
@@ -209,7 +217,7 @@ class HindsightClient {
209
217
  client: this.client,
210
218
  path: { bank_id: bankId },
211
219
  });
212
- return response.data;
220
+ return this.validateResponse(response, 'getBankProfile');
213
221
  }
214
222
  }
215
223
  exports.HindsightClient = HindsightClient;
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
@@ -39,6 +39,9 @@ import type {
39
39
  GetGraphData,
40
40
  GetGraphErrors,
41
41
  GetGraphResponses,
42
+ GetMemoryData,
43
+ GetMemoryErrors,
44
+ GetMemoryResponses,
42
45
  HealthEndpointHealthGetData,
43
46
  HealthEndpointHealthGetResponses,
44
47
  ListBanksData,
@@ -56,6 +59,9 @@ import type {
56
59
  ListOperationsData,
57
60
  ListOperationsErrors,
58
61
  ListOperationsResponses,
62
+ ListTagsData,
63
+ ListTagsErrors,
64
+ ListTagsResponses,
59
65
  MetricsEndpointMetricsGetData,
60
66
  MetricsEndpointMetricsGetResponses,
61
67
  RecallMemoriesData,
@@ -123,7 +129,7 @@ export const metricsEndpointMetricsGet = <ThrowOnError extends boolean = false>(
123
129
  /**
124
130
  * Get memory graph data
125
131
  *
126
- * Retrieve graph data for visualization, optionally filtered by type (world/experience/opinion). Limited to 1000 most recent items.
132
+ * Retrieve graph data for visualization, optionally filtered by type (world/experience/opinion).
127
133
  */
128
134
  export const getGraph = <ThrowOnError extends boolean = false>(
129
135
  options: Options<GetGraphData, ThrowOnError>,
@@ -148,6 +154,20 @@ export const listMemories = <ThrowOnError extends boolean = false>(
148
154
  ThrowOnError
149
155
  >({ url: "/v1/default/banks/{bank_id}/memories/list", ...options });
150
156
 
157
+ /**
158
+ * Get memory unit
159
+ *
160
+ * Get a single memory unit by ID with all its metadata including entities and tags.
161
+ */
162
+ export const getMemory = <ThrowOnError extends boolean = false>(
163
+ options: Options<GetMemoryData, ThrowOnError>,
164
+ ) =>
165
+ (options.client ?? client).get<
166
+ GetMemoryResponses,
167
+ GetMemoryErrors,
168
+ ThrowOnError
169
+ >({ url: "/v1/default/banks/{bank_id}/memories/{memory_id}", ...options });
170
+
151
171
  /**
152
172
  * Recall memory
153
173
  *
@@ -236,7 +256,7 @@ export const getAgentStats = <ThrowOnError extends boolean = false>(
236
256
  /**
237
257
  * List entities
238
258
  *
239
- * List all entities (people, organizations, etc.) known by the bank, ordered by mention count.
259
+ * List all entities (people, organizations, etc.) known by the bank, ordered by mention count. Supports pagination.
240
260
  */
241
261
  export const listEntities = <ThrowOnError extends boolean = false>(
242
262
  options: Options<ListEntitiesData, ThrowOnError>,
@@ -329,6 +349,20 @@ export const getDocument = <ThrowOnError extends boolean = false>(
329
349
  ThrowOnError
330
350
  >({ url: "/v1/default/banks/{bank_id}/documents/{document_id}", ...options });
331
351
 
352
+ /**
353
+ * List tags
354
+ *
355
+ * List all unique tags in a memory bank with usage counts. Supports wildcard search using '*' (e.g., 'user:*', '*-fred', 'tag*-2'). Case-insensitive.
356
+ */
357
+ export const listTags = <ThrowOnError extends boolean = false>(
358
+ options: Options<ListTagsData, ThrowOnError>,
359
+ ) =>
360
+ (options.client ?? client).get<
361
+ ListTagsResponses,
362
+ ListTagsErrors,
363
+ ThrowOnError
364
+ >({ url: "/v1/default/banks/{bank_id}/tags", ...options });
365
+
332
366
  /**
333
367
  * Get chunk details
334
368
  *
@@ -377,6 +377,12 @@ export type DocumentResponse = {
377
377
  * Memory Unit Count
378
378
  */
379
379
  memory_unit_count: number;
380
+ /**
381
+ * Tags
382
+ *
383
+ * Tags associated with this document
384
+ */
385
+ tags?: Array<string>;
380
386
  };
381
387
 
382
388
  /**
@@ -431,6 +437,26 @@ export type EntityIncludeOptions = {
431
437
  max_tokens?: number;
432
438
  };
433
439
 
440
+ /**
441
+ * EntityInput
442
+ *
443
+ * Entity to associate with retained content.
444
+ */
445
+ export type EntityInput = {
446
+ /**
447
+ * Text
448
+ *
449
+ * The entity name/text
450
+ */
451
+ text: string;
452
+ /**
453
+ * Type
454
+ *
455
+ * Optional entity type (e.g., 'PERSON', 'ORG', 'CONCEPT')
456
+ */
457
+ type?: string | null;
458
+ };
459
+
434
460
  /**
435
461
  * EntityListItem
436
462
  *
@@ -475,6 +501,18 @@ export type EntityListResponse = {
475
501
  * Items
476
502
  */
477
503
  items: Array<EntityListItem>;
504
+ /**
505
+ * Total
506
+ */
507
+ total: number;
508
+ /**
509
+ * Limit
510
+ */
511
+ limit: number;
512
+ /**
513
+ * Offset
514
+ */
515
+ offset: number;
478
516
  };
479
517
 
480
518
  /**
@@ -550,6 +588,10 @@ export type GraphDataResponse = {
550
588
  * Total Units
551
589
  */
552
590
  total_units: number;
591
+ /**
592
+ * Limit
593
+ */
594
+ limit: number;
553
595
  };
554
596
 
555
597
  /**
@@ -630,6 +672,30 @@ export type ListMemoryUnitsResponse = {
630
672
  offset: number;
631
673
  };
632
674
 
675
+ /**
676
+ * ListTagsResponse
677
+ *
678
+ * Response model for list tags endpoint.
679
+ */
680
+ export type ListTagsResponse = {
681
+ /**
682
+ * Items
683
+ */
684
+ items: Array<TagItem>;
685
+ /**
686
+ * Total
687
+ */
688
+ total: number;
689
+ /**
690
+ * Limit
691
+ */
692
+ limit: number;
693
+ /**
694
+ * Offset
695
+ */
696
+ offset: number;
697
+ };
698
+
633
699
  /**
634
700
  * MemoryItem
635
701
  *
@@ -660,6 +726,18 @@ export type MemoryItem = {
660
726
  * Optional document ID for this memory item.
661
727
  */
662
728
  document_id?: string | null;
729
+ /**
730
+ * Entities
731
+ *
732
+ * Optional entities to combine with auto-extracted entities.
733
+ */
734
+ entities?: Array<EntityInput> | null;
735
+ /**
736
+ * Tags
737
+ *
738
+ * Optional tags for visibility scoping. Memories with tags can be filtered during recall.
739
+ */
740
+ tags?: Array<string> | null;
663
741
  };
664
742
 
665
743
  /**
@@ -749,6 +827,18 @@ export type RecallRequest = {
749
827
  * Options for including additional data (entities are included by default)
750
828
  */
751
829
  include?: IncludeOptions;
830
+ /**
831
+ * Tags
832
+ *
833
+ * Filter memories by tags. If not specified, all memories are returned.
834
+ */
835
+ tags?: Array<string> | null;
836
+ /**
837
+ * Tags Match
838
+ *
839
+ * How to match tags: 'any' (OR, includes untagged), 'all' (AND, includes untagged), 'any_strict' (OR, excludes untagged), 'all_strict' (AND, excludes untagged).
840
+ */
841
+ tags_match?: "any" | "all" | "any_strict" | "all_strict";
752
842
  };
753
843
 
754
844
  /**
@@ -837,6 +927,10 @@ export type RecallResult = {
837
927
  * Chunk Id
838
928
  */
839
929
  chunk_id?: string | null;
930
+ /**
931
+ * Tags
932
+ */
933
+ tags?: Array<string> | null;
840
934
  };
841
935
 
842
936
  /**
@@ -916,6 +1010,18 @@ export type ReflectRequest = {
916
1010
  response_schema?: {
917
1011
  [key: string]: unknown;
918
1012
  } | null;
1013
+ /**
1014
+ * Tags
1015
+ *
1016
+ * Filter memories by tags during reflection. If not specified, all memories are considered.
1017
+ */
1018
+ tags?: Array<string> | null;
1019
+ /**
1020
+ * Tags Match
1021
+ *
1022
+ * How to match tags: 'any' (OR, includes untagged), 'all' (AND, includes untagged), 'any_strict' (OR, excludes untagged), 'all_strict' (AND, excludes untagged).
1023
+ */
1024
+ tags_match?: "any" | "all" | "any_strict" | "all_strict";
919
1025
  };
920
1026
 
921
1027
  /**
@@ -940,6 +1046,10 @@ export type ReflectResponse = {
940
1046
  structured_output?: {
941
1047
  [key: string]: unknown;
942
1048
  } | null;
1049
+ /**
1050
+ * Token usage metrics for LLM calls during reflection.
1051
+ */
1052
+ usage?: TokenUsage | null;
943
1053
  };
944
1054
 
945
1055
  /**
@@ -958,6 +1068,12 @@ export type RetainRequest = {
958
1068
  * If true, process asynchronously in background. If false, wait for completion (default: false)
959
1069
  */
960
1070
  async?: boolean;
1071
+ /**
1072
+ * Document Tags
1073
+ *
1074
+ * Tags applied to all items in this request. These are merged with any item-level tags.
1075
+ */
1076
+ document_tags?: Array<string> | null;
961
1077
  };
962
1078
 
963
1079
  /**
@@ -984,6 +1100,65 @@ export type RetainResponse = {
984
1100
  * Whether the operation was processed asynchronously
985
1101
  */
986
1102
  async: boolean;
1103
+ /**
1104
+ * Operation Id
1105
+ *
1106
+ * 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.
1107
+ */
1108
+ operation_id?: string | null;
1109
+ /**
1110
+ * Token usage metrics for LLM calls during fact extraction (only present for synchronous operations)
1111
+ */
1112
+ usage?: TokenUsage | null;
1113
+ };
1114
+
1115
+ /**
1116
+ * TagItem
1117
+ *
1118
+ * Single tag with usage count.
1119
+ */
1120
+ export type TagItem = {
1121
+ /**
1122
+ * Tag
1123
+ *
1124
+ * The tag value
1125
+ */
1126
+ tag: string;
1127
+ /**
1128
+ * Count
1129
+ *
1130
+ * Number of memories with this tag
1131
+ */
1132
+ count: number;
1133
+ };
1134
+
1135
+ /**
1136
+ * TokenUsage
1137
+ *
1138
+ * Token usage metrics for LLM calls.
1139
+ *
1140
+ * Tracks input/output tokens for a single request to enable
1141
+ * per-request cost tracking and monitoring.
1142
+ */
1143
+ export type TokenUsage = {
1144
+ /**
1145
+ * Input Tokens
1146
+ *
1147
+ * Number of input/prompt tokens consumed
1148
+ */
1149
+ input_tokens?: number;
1150
+ /**
1151
+ * Output Tokens
1152
+ *
1153
+ * Number of output/completion tokens generated
1154
+ */
1155
+ output_tokens?: number;
1156
+ /**
1157
+ * Total Tokens
1158
+ *
1159
+ * Total tokens (input + output)
1160
+ */
1161
+ total_tokens?: number;
987
1162
  };
988
1163
 
989
1164
  /**
@@ -1060,6 +1235,10 @@ export type GetGraphData = {
1060
1235
  * Type
1061
1236
  */
1062
1237
  type?: string | null;
1238
+ /**
1239
+ * Limit
1240
+ */
1241
+ limit?: number;
1063
1242
  };
1064
1243
  url: "/v1/default/banks/{bank_id}/graph";
1065
1244
  };
@@ -1136,6 +1315,44 @@ export type ListMemoriesResponses = {
1136
1315
  export type ListMemoriesResponse =
1137
1316
  ListMemoriesResponses[keyof ListMemoriesResponses];
1138
1317
 
1318
+ export type GetMemoryData = {
1319
+ body?: never;
1320
+ headers?: {
1321
+ /**
1322
+ * Authorization
1323
+ */
1324
+ authorization?: string | null;
1325
+ };
1326
+ path: {
1327
+ /**
1328
+ * Bank Id
1329
+ */
1330
+ bank_id: string;
1331
+ /**
1332
+ * Memory Id
1333
+ */
1334
+ memory_id: string;
1335
+ };
1336
+ query?: never;
1337
+ url: "/v1/default/banks/{bank_id}/memories/{memory_id}";
1338
+ };
1339
+
1340
+ export type GetMemoryErrors = {
1341
+ /**
1342
+ * Validation Error
1343
+ */
1344
+ 422: HttpValidationError;
1345
+ };
1346
+
1347
+ export type GetMemoryError = GetMemoryErrors[keyof GetMemoryErrors];
1348
+
1349
+ export type GetMemoryResponses = {
1350
+ /**
1351
+ * Successful Response
1352
+ */
1353
+ 200: unknown;
1354
+ };
1355
+
1139
1356
  export type RecallMemoriesData = {
1140
1357
  body: RecallRequest;
1141
1358
  headers?: {
@@ -1243,6 +1460,12 @@ export type ListBanksResponse = ListBanksResponses[keyof ListBanksResponses];
1243
1460
 
1244
1461
  export type GetAgentStatsData = {
1245
1462
  body?: never;
1463
+ headers?: {
1464
+ /**
1465
+ * Authorization
1466
+ */
1467
+ authorization?: string | null;
1468
+ };
1246
1469
  path: {
1247
1470
  /**
1248
1471
  * Bank Id
@@ -1293,6 +1516,12 @@ export type ListEntitiesData = {
1293
1516
  * Maximum number of entities to return
1294
1517
  */
1295
1518
  limit?: number;
1519
+ /**
1520
+ * Offset
1521
+ *
1522
+ * Offset for pagination
1523
+ */
1524
+ offset?: number;
1296
1525
  };
1297
1526
  url: "/v1/default/banks/{bank_id}/entities";
1298
1527
  };
@@ -1531,6 +1760,61 @@ export type GetDocumentResponses = {
1531
1760
  export type GetDocumentResponse =
1532
1761
  GetDocumentResponses[keyof GetDocumentResponses];
1533
1762
 
1763
+ export type ListTagsData = {
1764
+ body?: never;
1765
+ headers?: {
1766
+ /**
1767
+ * Authorization
1768
+ */
1769
+ authorization?: string | null;
1770
+ };
1771
+ path: {
1772
+ /**
1773
+ * Bank Id
1774
+ */
1775
+ bank_id: string;
1776
+ };
1777
+ query?: {
1778
+ /**
1779
+ * Q
1780
+ *
1781
+ * Wildcard pattern to filter tags (e.g., 'user:*' for user:alice, '*-admin' for role-admin). Use '*' as wildcard. Case-insensitive.
1782
+ */
1783
+ q?: string | null;
1784
+ /**
1785
+ * Limit
1786
+ *
1787
+ * Maximum number of tags to return
1788
+ */
1789
+ limit?: number;
1790
+ /**
1791
+ * Offset
1792
+ *
1793
+ * Offset for pagination
1794
+ */
1795
+ offset?: number;
1796
+ };
1797
+ url: "/v1/default/banks/{bank_id}/tags";
1798
+ };
1799
+
1800
+ export type ListTagsErrors = {
1801
+ /**
1802
+ * Validation Error
1803
+ */
1804
+ 422: HttpValidationError;
1805
+ };
1806
+
1807
+ export type ListTagsError = ListTagsErrors[keyof ListTagsErrors];
1808
+
1809
+ export type ListTagsResponses = {
1810
+ /**
1811
+ * Successful Response
1812
+ */
1813
+ 200: ListTagsResponse;
1814
+ };
1815
+
1816
+ export type ListTagsResponse2 = ListTagsResponses[keyof ListTagsResponses];
1817
+
1534
1818
  export type GetChunkData = {
1535
1819
  body?: never;
1536
1820
  headers?: {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vectorize-io/hindsight-client",
3
- "version": "0.2.0",
3
+ "version": "0.3.0",
4
4
  "description": "TypeScript client for Hindsight - Semantic memory system with personality-driven thinking",
5
5
  "main": "./dist/src/index.js",
6
6
  "types": "./dist/src/index.d.ts",
@@ -26,7 +26,7 @@
26
26
  "directory": "hindsight-clients/typescript"
27
27
  },
28
28
  "devDependencies": {
29
- "@hey-api/openapi-ts": "^0.88.0",
29
+ "@hey-api/openapi-ts": "0.88.0",
30
30
  "@types/jest": "^29.0.0",
31
31
  "@types/node": "^20.0.0",
32
32
  "jest": "^29.0.0",