TypeScript SDK - Conare

bun add @conare/sdk   # або: npm i @conare/sdk

Працює в Node 18+, Bun, Deno та Cloudflare Workers через глобальний fetch. Без залежностей. Тримайте ключ cint_... у server-side secret manager.

Setup

import { Conare, ConareError, hasAnswer } from "@conare/sdk";

const conare = new Conare({
  apiKey: process.env.CONARE_API_KEY!,
});

// Side-effect-free deploy smoke-тест: ключ, конфіг namespace, hop до backend.
await conare.status();

Recall на старті сесії

const recalled = await conare.recall({
  endUserId: "u_123",
  query: "what matters to this user right now",
});
if (hasAnswer(recalled)) {
  systemPrompt += `\n\nWhat we know about this user:\n${recalled.answer}`;
}

hasAnswer звужує union: плани, що вичерпали квоту deep-recall, деградують до raw-результатів замість викидання винятку, тож ваша збірка prompt’а ніколи не ламається.

Save спостережень

await conare.memories.save({
  endUserId: "u_123",
  content: "User prefers smaller islands and wants to avoid crowds.",
  containerTag: "conversation-observation",
});

Поверхня клієнта

Метод	Призначення
`status`	Автентифікована readiness-перевірка без побічних ефектів
`memories.save`, `memories.saveBatch`	Append-only дистильовані спостереження
`memories.search`	Швидкий сирий гібридний retrieval, без синтезу
`memories.getSource`, `upsertSource`, `deleteSource`	Source-owned lifecycle
`memories.lifecycleBatch`	Versioned bulk bootstrap з per-item результатами
`recall`	Підкріплена цитуванням персоналізована відповідь
`suggestions`	До п’яти вкорінених проактивних дій
`deleteContainer`	Скинути спогади одного контейнера
`deleteUser`	Повне видалення кінцевого користувача (GDPR)

Обмеження retrieval scope’ом

search, recall і suggestions приймають опціональний containerTag, який обмежує retrieval одним контейнером до будь-якого синтезу. Тегуйте кожен запис ID вашого workspace і обмежуйте scope кожного читання тим самим тегом — факти одного workspace ніколи не спливають у відповідях іншого.

Observability

Кожен запит надсилає безпечний X-Request-Id (повтори його зберігають); кожна відповідь його повертає, і ConareError.requestId виставляє його для support-кореляції. Передайте хук onResponse, щоб живити ваші метрики:

const conare = new Conare({
  apiKey: process.env.CONARE_API_KEY!,
  onResponse(meta) {
    metrics.timing("conare.request", meta.durationMs, {
      status: String(meta.status),
      requestId: meta.requestId,
    });
  },
});