TypeScript SDK

npm install thrindex
# or
yarn add thrindex
# or
pnpm add thrindex

import { ThrindexClient } from 'thrindex';

const client = new ThrindexClient({
  apiKey: 'th_live_...',                    // required
  baseUrl: 'https://api.thrindex.com',      // optional, this is the default
  timeoutMs: 30_000,                        // optional, milliseconds (default 30 000)
  maxRetries: 3,                            // optional (default 3)
});

const memoryId: string = await client.add({
  content: 'User prefers weekly email digests.',  // required
  agentId: 'support-agent',                        // required
  userId: 'user-42',                               // required
  confidence: 0.95,                                // optional
  metadata: { source: 'preference-survey' },       // optional
  extract: true,                                   // optional, default true
});

console.log(memoryId); // "3f2e1d0c-..."

import type { SearchHit } from 'thrindex';

const results: SearchHit[] = await client.search({
  query: 'how does the user want to be contacted',  // required
  agentId: 'support-agent',                          // required
  userId: 'user-42',                                 // required
  k: 10,                                             // optional, default 10
  taskContext: 'composing a notification email',     // optional
  level: undefined,                                  // optional, filter by level
});

for (const hit of results) {
  console.log(`[${hit.score.toFixed(3)}] ${hit.content}`);
}

import type { ListResponse } from 'thrindex';

let page: ListResponse = await client.list({
  agentId: 'support-agent',  // optional
  userId: 'user-42',         // optional
  limit: 50,                 // optional, default 50
});

for (const record of page.results) {
  console.log(record.id, record.importance);
}

// Iterate through all pages
while (page.nextCursor) {
  page = await client.list({
    agentId: 'support-agent',
    userId: 'user-42',
    cursor: page.nextCursor,
  });
}

import type { MemoryDetail } from 'thrindex';

const memory: MemoryDetail = await client.get('3f2e1d0c-...');
console.log(memory.content);

await client.delete('3f2e1d0c-...');                    // soft delete (default)
await client.delete('3f2e1d0c-...', { hard: true });    // hard delete (GDPR erasure)

import type { BatchAddItem } from 'thrindex';

const ids: string[] = await client.batchAdd(
  [
    { content: 'User timezone is Europe/Berlin.' },
    { content: 'User language is German.', confidence: 0.9 },
    { content: 'User prefers dark mode.', extract: false },
  ],
  {
    agentId: 'support-agent',  // default for all items
    userId: 'user-42',         // default for all items
    extract: true,             // default extraction behaviour
  },
);

import {
  ThrindexError,
  AuthError,
  NotFoundError,
  RateLimitError,
} from 'thrindex';

try {
  const results = await client.search({ query: '...', agentId: '...', userId: '...' });
} catch (err) {
  if (err instanceof AuthError) {
    // 401 — invalid or revoked API key
    console.error('Check your API key.');
  } else if (err instanceof NotFoundError) {
    // 404 — memory does not exist
    console.error('Memory not found.');
  } else if (err instanceof RateLimitError) {
    // 429 — rate limit exceeded (SDK already retried max_retries times)
    console.error(`Rate limited. Retry after ${err.retryAfter}s.`);
  } else if (err instanceof ThrindexError) {
    // All other errors (400, 500, network failures)
    console.error(`Error ${err.statusCode}: ${err.message}`);
  }
}

import { ThrindexOpenAI } from 'thrindex/integrations/openai';
import { ThrindexAnthropic } from 'thrindex/integrations/anthropic';
import { ThrindexLangChainRetriever } from 'thrindex/integrations/langchain';