@vectorize-io/hindsight-client 0.0.14 → 0.0.16
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.
- package/README.md +66 -34
- package/dist/src/index.d.ts +3 -11
- package/dist/src/index.d.ts.map +1 -1
- package/dist/src/index.js +4 -21
- package/dist/src/index.js.map +1 -1
- package/package.json +1 -1
- package/src/index.ts +7 -35
package/README.md
CHANGED
|
@@ -1,57 +1,89 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Hindsight TypeScript Client
|
|
2
2
|
|
|
3
|
-
TypeScript client for Hindsight
|
|
4
|
-
|
|
5
|
-
**Auto-generated from OpenAPI spec** - provides type-safe access to all Hindsight API endpoints.
|
|
3
|
+
TypeScript client library for the Hindsight API.
|
|
6
4
|
|
|
7
5
|
## Installation
|
|
8
6
|
|
|
9
7
|
```bash
|
|
10
|
-
npm install @hindsight
|
|
8
|
+
npm install @vectorize-io/hindsight-client
|
|
11
9
|
# or
|
|
12
|
-
yarn add @hindsight
|
|
10
|
+
yarn add @vectorize-io/hindsight-client
|
|
13
11
|
```
|
|
14
12
|
|
|
15
|
-
##
|
|
13
|
+
## Usage
|
|
16
14
|
|
|
17
15
|
```typescript
|
|
18
|
-
import {
|
|
16
|
+
import { HindsightClient } from '@vectorize-io/hindsight-client';
|
|
19
17
|
|
|
20
|
-
|
|
21
|
-
OpenAPI.BASE = 'http://localhost:8888';
|
|
18
|
+
const client = new HindsightClient({ baseUrl: 'http://localhost:8888' });
|
|
22
19
|
|
|
23
|
-
//
|
|
24
|
-
await
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
20
|
+
// Retain information
|
|
21
|
+
await client.retain('my-bank', 'Alice works at Google in Mountain View.');
|
|
22
|
+
|
|
23
|
+
// Recall memories
|
|
24
|
+
const results = await client.recall('my-bank', 'Where does Alice work?');
|
|
25
|
+
|
|
26
|
+
// Reflect and get an opinion
|
|
27
|
+
const response = await client.reflect('my-bank', 'What do you think about Alice\'s career?');
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## API Reference
|
|
31
|
+
|
|
32
|
+
### `retain(bankId, content, options?)`
|
|
28
33
|
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
+
Store a single memory.
|
|
35
|
+
|
|
36
|
+
```typescript
|
|
37
|
+
await client.retain('my-bank', 'User prefers dark mode', {
|
|
38
|
+
timestamp: new Date(),
|
|
39
|
+
context: 'Settings conversation',
|
|
40
|
+
metadata: { source: 'chat' }
|
|
34
41
|
});
|
|
42
|
+
```
|
|
35
43
|
|
|
36
|
-
|
|
44
|
+
### `retainBatch(bankId, items, options?)`
|
|
45
|
+
|
|
46
|
+
Store multiple memories in batch.
|
|
47
|
+
|
|
48
|
+
```typescript
|
|
49
|
+
await client.retainBatch('my-bank', [
|
|
50
|
+
{ content: 'Alice loves hiking' },
|
|
51
|
+
{ content: 'Alice visited Paris last summer' }
|
|
52
|
+
], { async: true });
|
|
37
53
|
```
|
|
38
54
|
|
|
39
|
-
|
|
55
|
+
### `recall(bankId, query, options?)`
|
|
40
56
|
|
|
41
|
-
|
|
42
|
-
- `SearchService` - Semantic and temporal search
|
|
43
|
-
- `ReasoningService` - Personality-driven thinking
|
|
44
|
-
- `VisualizationService` - Memory graphs and statistics
|
|
45
|
-
- `ManagementService` - Agent profiles and configuration
|
|
46
|
-
- `DocumentsService` - Document tracking
|
|
57
|
+
Recall memories matching a query.
|
|
47
58
|
|
|
48
|
-
|
|
59
|
+
```typescript
|
|
60
|
+
const results = await client.recall('my-bank', 'What are Alice\'s hobbies?', {
|
|
61
|
+
budget: 'mid'
|
|
62
|
+
});
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### `reflect(bankId, query, options?)`
|
|
66
|
+
|
|
67
|
+
Generate a contextual answer using the bank's identity and memories.
|
|
68
|
+
|
|
69
|
+
```typescript
|
|
70
|
+
const response = await client.reflect('my-bank', 'What should I do this weekend?', {
|
|
71
|
+
budget: 'low'
|
|
72
|
+
});
|
|
73
|
+
console.log(response.text);
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
### `createBank(bankId, options)`
|
|
49
77
|
|
|
50
|
-
|
|
78
|
+
Create or update a memory bank with personality.
|
|
51
79
|
|
|
52
|
-
|
|
80
|
+
```typescript
|
|
81
|
+
await client.createBank('my-bank', {
|
|
82
|
+
name: 'My Assistant',
|
|
83
|
+
background: 'A helpful assistant that remembers everything.'
|
|
84
|
+
});
|
|
85
|
+
```
|
|
53
86
|
|
|
54
|
-
##
|
|
87
|
+
## Documentation
|
|
55
88
|
|
|
56
|
-
|
|
57
|
-
- [Full Documentation](https://github.com/vectorize-io/hindsight/blob/main/README.md)
|
|
89
|
+
For full documentation, visit [hindsight](https://github.com/vectorize-io/hindsight).
|
package/dist/src/index.d.ts
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
*
|
|
4
4
|
* Example:
|
|
5
5
|
* ```typescript
|
|
6
|
-
* import { HindsightClient } from '@hindsight
|
|
6
|
+
* import { HindsightClient } from '@vectorize-io/hindsight-client';
|
|
7
7
|
*
|
|
8
8
|
* const client = new HindsightClient({ baseUrl: 'http://localhost:8888' });
|
|
9
9
|
*
|
|
@@ -38,6 +38,7 @@ export declare class HindsightClient {
|
|
|
38
38
|
timestamp?: Date | string;
|
|
39
39
|
context?: string;
|
|
40
40
|
metadata?: Record<string, string>;
|
|
41
|
+
async?: boolean;
|
|
41
42
|
}): Promise<RetainResponse>;
|
|
42
43
|
/**
|
|
43
44
|
* Retain multiple memories in batch.
|
|
@@ -48,21 +49,12 @@ export declare class HindsightClient {
|
|
|
48
49
|
}): Promise<RetainResponse>;
|
|
49
50
|
/**
|
|
50
51
|
* Recall memories with a natural language query.
|
|
51
|
-
* Returns a simplified list of recall results.
|
|
52
52
|
*/
|
|
53
53
|
recall(bankId: string, query: string, options?: {
|
|
54
|
-
maxTokens?: number;
|
|
55
|
-
budget?: Budget;
|
|
56
|
-
}): Promise<RecallResult[]>;
|
|
57
|
-
/**
|
|
58
|
-
* Recall memories with full options and response.
|
|
59
|
-
*/
|
|
60
|
-
recallMemories(bankId: string, options: {
|
|
61
|
-
query: string;
|
|
62
54
|
types?: string[];
|
|
63
55
|
maxTokens?: number;
|
|
64
|
-
trace?: boolean;
|
|
65
56
|
budget?: Budget;
|
|
57
|
+
trace?: boolean;
|
|
66
58
|
}): Promise<RecallResponse>;
|
|
67
59
|
/**
|
|
68
60
|
* Reflect and generate a contextual answer using the bank's identity and memories.
|
package/dist/src/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;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;CACnB;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;CACxB;AAED,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,sBAAsB;IAQ3C;;OAEG;IACG,MAAM,CACR,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/src/index.js
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
*
|
|
5
5
|
* Example:
|
|
6
6
|
* ```typescript
|
|
7
|
-
* import { HindsightClient } from '@hindsight
|
|
7
|
+
* import { HindsightClient } from '@vectorize-io/hindsight-client';
|
|
8
8
|
*
|
|
9
9
|
* const client = new HindsightClient({ baseUrl: 'http://localhost:8888' });
|
|
10
10
|
*
|
|
@@ -81,7 +81,7 @@ class HindsightClient {
|
|
|
81
81
|
const response = await sdk.retainMemories({
|
|
82
82
|
client: this.client,
|
|
83
83
|
path: { bank_id: bankId },
|
|
84
|
-
body: { items: [item] },
|
|
84
|
+
body: { items: [item], async: options?.async },
|
|
85
85
|
});
|
|
86
86
|
return response.data;
|
|
87
87
|
}
|
|
@@ -115,7 +115,6 @@ class HindsightClient {
|
|
|
115
115
|
}
|
|
116
116
|
/**
|
|
117
117
|
* Recall memories with a natural language query.
|
|
118
|
-
* Returns a simplified list of recall results.
|
|
119
118
|
*/
|
|
120
119
|
async recall(bankId, query, options) {
|
|
121
120
|
const response = await sdk.recallMemories({
|
|
@@ -123,29 +122,13 @@ class HindsightClient {
|
|
|
123
122
|
path: { bank_id: bankId },
|
|
124
123
|
body: {
|
|
125
124
|
query,
|
|
125
|
+
types: options?.types,
|
|
126
126
|
max_tokens: options?.maxTokens,
|
|
127
127
|
budget: options?.budget || 'mid',
|
|
128
|
-
|
|
129
|
-
});
|
|
130
|
-
return response.data?.results ?? [];
|
|
131
|
-
}
|
|
132
|
-
/**
|
|
133
|
-
* Recall memories with full options and response.
|
|
134
|
-
*/
|
|
135
|
-
async recallMemories(bankId, options) {
|
|
136
|
-
const response = await sdk.recallMemories({
|
|
137
|
-
client: this.client,
|
|
138
|
-
path: { bank_id: bankId },
|
|
139
|
-
body: {
|
|
140
|
-
query: options.query,
|
|
141
|
-
types: options.types,
|
|
142
|
-
max_tokens: options.maxTokens,
|
|
143
|
-
trace: options.trace,
|
|
144
|
-
budget: options.budget || 'mid',
|
|
128
|
+
trace: options?.trace,
|
|
145
129
|
},
|
|
146
130
|
});
|
|
147
131
|
if (!response.data) {
|
|
148
|
-
console.error('recallMemories: No data in response', { response, error: response.error });
|
|
149
132
|
throw new Error(`API returned no data: ${JSON.stringify(response.error || 'Unknown error')}`);
|
|
150
133
|
}
|
|
151
134
|
return response.data;
|
package/dist/src/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,gDAAiE;AAEjE,0DAA4C;AA2B5C,MAAa,eAAe;IAGxB,YAAY,OAA+B;QACvC,IAAI,CAAC,MAAM,GAAG,IAAA,qBAAY,EACtB,IAAA,qBAAY,EAAC;YACT,OAAO,EAAE,OAAO,CAAC,OAAO;SAC3B,CAAC,CACL,CAAC;IACN,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACR,MAAc,EACd,OAAe,EACf,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vectorize-io/hindsight-client",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.16",
|
|
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",
|
package/src/index.ts
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
*
|
|
4
4
|
* Example:
|
|
5
5
|
* ```typescript
|
|
6
|
-
* import { HindsightClient } from '@hindsight
|
|
6
|
+
* import { HindsightClient } from '@vectorize-io/hindsight-client';
|
|
7
7
|
*
|
|
8
8
|
* const client = new HindsightClient({ baseUrl: 'http://localhost:8888' });
|
|
9
9
|
*
|
|
@@ -64,7 +64,7 @@ export class HindsightClient {
|
|
|
64
64
|
async retain(
|
|
65
65
|
bankId: string,
|
|
66
66
|
content: string,
|
|
67
|
-
options?: { timestamp?: Date | string; context?: string; metadata?: Record<string, string
|
|
67
|
+
options?: { timestamp?: Date | string; context?: string; metadata?: Record<string, string>; async?: boolean }
|
|
68
68
|
): Promise<RetainResponse> {
|
|
69
69
|
const item: { content: string; timestamp?: string; context?: string; metadata?: Record<string, string> } = { content };
|
|
70
70
|
if (options?.timestamp) {
|
|
@@ -83,7 +83,7 @@ export class HindsightClient {
|
|
|
83
83
|
const response = await sdk.retainMemories({
|
|
84
84
|
client: this.client,
|
|
85
85
|
path: { bank_id: bankId },
|
|
86
|
-
body: { items: [item] },
|
|
86
|
+
body: { items: [item], async: options?.async },
|
|
87
87
|
});
|
|
88
88
|
|
|
89
89
|
return response.data!;
|
|
@@ -124,53 +124,25 @@ export class HindsightClient {
|
|
|
124
124
|
|
|
125
125
|
/**
|
|
126
126
|
* Recall memories with a natural language query.
|
|
127
|
-
* Returns a simplified list of recall results.
|
|
128
127
|
*/
|
|
129
128
|
async recall(
|
|
130
129
|
bankId: string,
|
|
131
130
|
query: string,
|
|
132
|
-
options?: { maxTokens?: number; budget?: Budget }
|
|
133
|
-
): Promise<
|
|
131
|
+
options?: { types?: string[]; maxTokens?: number; budget?: Budget; trace?: boolean }
|
|
132
|
+
): Promise<RecallResponse> {
|
|
134
133
|
const response = await sdk.recallMemories({
|
|
135
134
|
client: this.client,
|
|
136
135
|
path: { bank_id: bankId },
|
|
137
136
|
body: {
|
|
138
137
|
query,
|
|
138
|
+
types: options?.types,
|
|
139
139
|
max_tokens: options?.maxTokens,
|
|
140
140
|
budget: options?.budget || 'mid',
|
|
141
|
-
|
|
142
|
-
});
|
|
143
|
-
|
|
144
|
-
return response.data?.results ?? [];
|
|
145
|
-
}
|
|
146
|
-
|
|
147
|
-
/**
|
|
148
|
-
* Recall memories with full options and response.
|
|
149
|
-
*/
|
|
150
|
-
async recallMemories(
|
|
151
|
-
bankId: string,
|
|
152
|
-
options: {
|
|
153
|
-
query: string;
|
|
154
|
-
types?: string[];
|
|
155
|
-
maxTokens?: number;
|
|
156
|
-
trace?: boolean;
|
|
157
|
-
budget?: Budget;
|
|
158
|
-
}
|
|
159
|
-
): Promise<RecallResponse> {
|
|
160
|
-
const response = await sdk.recallMemories({
|
|
161
|
-
client: this.client,
|
|
162
|
-
path: { bank_id: bankId },
|
|
163
|
-
body: {
|
|
164
|
-
query: options.query,
|
|
165
|
-
types: options.types,
|
|
166
|
-
max_tokens: options.maxTokens,
|
|
167
|
-
trace: options.trace,
|
|
168
|
-
budget: options.budget || 'mid',
|
|
141
|
+
trace: options?.trace,
|
|
169
142
|
},
|
|
170
143
|
});
|
|
171
144
|
|
|
172
145
|
if (!response.data) {
|
|
173
|
-
console.error('recallMemories: No data in response', { response, error: response.error });
|
|
174
146
|
throw new Error(`API returned no data: ${JSON.stringify(response.error || 'Unknown error')}`);
|
|
175
147
|
}
|
|
176
148
|
|