SDK TypeScript - Conare

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

Fonctionne dans Node 18+, Bun, Deno et Cloudflare Workers via fetch global. Zéro dépendance. Gardez la clé cint_... dans un gestionnaire de secrets côté serveur.

Mise en place

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

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

// Side-effect-free deploy smoke test: key, namespace config, backend hop.
await conare.status();

Recall au début de session

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 restreint l’union : les plans qui épuisent leur quota de deep recall dégradent vers des résultats bruts au lieu de lever une exception, de sorte que l’assemblage de votre prompt ne se casse jamais.

Enregistrer des observations

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

Surface client

Méthode	Objectif
`status`	Contrôle de disponibilité authentifié et sans effet de bord
`memories.save`, `memories.saveBatch`	Observations distillées en append-only
`memories.search`	Récupération hybride brute rapide, sans synthèse
`memories.getSource`, `upsertSource`, `deleteSource`	Cycle de vie appartenant à une source
`memories.lifecycleBatch`	Amorçage en masse versionné avec résultats par élément
`recall`	Réponse personnalisée étayée par des citations
`suggestions`	Jusqu’à cinq actions proactives étayées
`deleteContainer`	Supprimer les mémoires d’un conteneur
`deleteUser`	Suppression complète de l’utilisateur final (GDPR)

Restreindre la récupération

search, recall et suggestions acceptent un containerTag optionnel qui borne la récupération à un conteneur avant toute synthèse. Taguez chaque écriture avec votre ID d’espace de travail et bornez chaque lecture avec le même tag — les faits d’un espace de travail ne peuvent jamais remonter dans les réponses d’un autre.

Observabilité

Chaque requête envoie un X-Request-Id sûr (les retries le conservent) ; chaque réponse le renvoie, et ConareError.requestId l’expose pour la corrélation avec le support. Passez un hook onResponse pour alimenter vos métriques :

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