Cerveau — mémoire partagée

API REST pour brancher n'importe quel service sur la mémoire long terme.

Ce service est la mémoire centrale. Côté CLI on l'utilise via MCP ; côté service (ex. une app qui appelle un LLM via OpenRouter), c'est ton code qui appelle cette API : on rappelle le contexte avant de répondre, puis on note l'échange après. OpenRouter ne fait que générer le texte — il n'appelle jamais cette API tout seul.

Authentification

Une clé API (l'une des valeurs API_KEYS) dans l'en-tête :

Authorization: Bearer <ta_cle>

Tolère aussi X-API-Key: <ta_cle>. Utilise une clé distincte par service (révocable indépendamment, et le cerveau loggue qui écrit).

Boucle minimale (recall → répondre → noter)

BASE="https://memoire.haiko-s1.com"
KEY="<ta_cle>"

# 1. RAPPEL — contexte compact avant de répondre
curl -s "$BASE/v1/memories/search?q=ou+en+est+le+projet+X&k=5" \
     -H "Authorization: Bearer $KEY"

# 2. (ton service appelle OpenRouter avec ces souvenirs injectés dans le system prompt)

# 3. NOTER — mémoriser un résumé fidèle de l'échange
curl -s -X POST "$BASE/v1/memories" \
     -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
     -d '{"texte":"Q: ...\nR: ...","source":"mon-service","discussion_id":"session-42"}'

Passe un discussion_id stable par session : le cerveau met à jour tout le fil (upsert) au lieu d'empiler des notes isolées.

Endpoints principaux

Méthode & cheminRôle
GET /v1/memories/search?q=&k=5&contexte= Rappel hybride : renvoie des souvenirs compacts pertinents. Un résultat statut:"rejete" est une piste écartée (texte préfixé ⛔ + motif) : à présenter comme à éviter, pas comme une solution.
POST /v1/memories Mémorise. Corps : {texte, source, projet?, discussion_id?}
GET /v1/memories/{id} Détail borné d'un souvenir.
GET /v1/carte Index court des sujets connus (à injecter en permanence si utile).
GET /v1/skills?statut=actif Procédures réutilisables (skills) applicables.
GET /v1/skills/{id} Fiche complète d'un skill (procédure intégrale).
GET /health Sonde de vie (sans clé).

En-têtes de traçabilité (optionnels)

Pour que le cerveau sache qui parle : X-Cerveau-Client, X-Cerveau-Llm, X-Cerveau-Project, X-Cerveau-Session.

Aller plus loin