TypeScript / JavaScript Client

npminstall @vectorize-io/hindsight-client

import{ HindsightClient }from"npm:@vectorize-io/hindsight-client";

import{ HindsightClient }from'@vectorize-io/hindsight-client';

const client =newHindsightClient({ baseUrl:'http://localhost:8888'});

// Retain a memory
await client.retain('my-bank','Alice works at Google');

// Recall memories
const response =await client.recall('my-bank','What does Alice do?');
for(const r of response.results){
console.log(r.text);
}

// Reflect - generate response with disposition
const answer =await client.reflect('my-bank','Tell me about Alice');
console.log(answer.text);

import{ HindsightClient }from'@vectorize-io/hindsight-client';

const client =newHindsightClient({
 baseUrl:'http://localhost:8888',
});

const version =await client.getVersion();

console.log(version.api_version);

if(!version.features.mcp){
thrownewError('This server does not expose the MCP endpoint');
}

// Simple
await client.retain('my-bank','Alice works at Google');

// With options
await client.retain('my-bank','Alice got promoted',{
 timestamp:newDate('2024年01月15日'),
 context:'career update',
 metadata:{ source:'slack'},
 async:false,// Set true for background processing
});

await client.retainBatch('my-bank',[
{ content:'Alice works at Google', context:'career'},
{ content:'Bob is a data scientist', context:'career'},
],{
 async:false,
});

// Simple - returns RecallResponse
const response =await client.recall('my-bank','What does Alice do?');

for(const r of response.results){
console.log(`${r.text} (type: ${r.type})`);
}

// With options
const response =await client.recall('my-bank','What does Alice do?',{
 types:['world','observation'],// Filter by fact type
maxTokens:4096,
 budget:'high',// 'low', 'mid', or 'high'
});

const answer =await client.reflect('my-bank','What should I know about Alice?',{
 budget:'low',// 'low', 'mid', or 'high'
 context:'preparing for a meeting',
});

console.log(answer.text);// Generated response

await client.createBank('my-bank',{
 name:'Assistant',
 mission:"You're a helpful AI assistant - keep track of user preferences and conversation history.",
 disposition:{
 skepticism:3,// 1-5: trusting to skeptical
 literalism:3,// 1-5: flexible to literal
 empathy:3,// 1-5: detached to empathetic
},
});

const response =await client.listMemories('my-bank',{
 type:'world',// Optional filter
 q:'Alice',// Optional text search
 limit:100,
 offset:0,
});
console.log(response)

const doc =await client.getDocument('my-bank','conversation_001');
if(doc){
console.log(doc);// null when document not found
}

const response =await client.listDocuments('my-bank',{
 limit:50,
 offset:0,
});
console.log(response);

await client.updateDocument('my-bank','conversation_001',{
 tags:['important','meeting-notes'],
});

await client.deleteDocument('my-bank','conversation_001');