TypeScript-SDK - Conare

bun add @conare/sdk   # oder: npm i @conare/sdk

Funktioniert in Node 18+, Bun, Deno und Cloudflare Workers über globales fetch. Keine Abhängigkeiten. Bewahren Sie den cint_...-Schlüssel in einem serverseitigen Secret Manager auf.

Einrichtung

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

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

// Nebenwirkungsfreier Deploy-Smoke-Test: Schlüssel, Namespace-Konfiguration, Backend-Hop.
await conare.status();

Recall zum Session-Start

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 verengt die Union: Tarife, denen das Deep-Recall-Kontingent ausgeht, degradieren zu Roh-Ergebnissen, statt zu werfen, sodass Ihr Prompt-Zusammenbau nie bricht.

Beobachtungen speichern

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

Client-Oberfläche

Methode	Zweck
`status`	Authentifizierter, nebenwirkungsfreier Bereitschaftscheck
`memories.save`, `memories.saveBatch`	Append-only destillierte Beobachtungen
`memories.search`	Schnelles rohes hybrides Retrieval, ohne Synthese
`memories.getSource`, `upsertSource`, `deleteSource`	Quell-eigener Lebenszyklus
`memories.lifecycleBatch`	Versionierter Bulk-Bootstrap mit Ergebnissen pro Item
`recall`	Mit Zitaten belegte personalisierte Antwort
`suggestions`	Bis zu fünf fundierte proaktive Aktionen
`deleteContainer`	Erinnerungen eines Containers löschen
`deleteUser`	Vollständige Endnutzer-Löschung (GDPR)

Retrieval scopen

search, recall und suggestions akzeptieren einen optionalen containerTag, der das Retrieval vor jeder Synthese auf einen Container einzäunt. Taggen Sie jeden Schreibvorgang mit Ihrer Workspace-ID und scopen Sie jeden Lesevorgang mit demselben Tag – Fakten eines Workspaces können niemals in den Antworten eines anderen auftauchen.

Beobachtbarkeit

Jede Anfrage sendet eine sichere X-Request-Id (Wiederholungen behalten sie); jede Antwort gibt sie zurück, und ConareError.requestId legt sie zur Support-Korrelation offen. Übergeben Sie einen onResponse-Hook, um Ihre Metriken zu speisen:

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,
    });
  },
});