Du premier accès au déploiement.

Mémoire : consentement prouvé obligatoire

Effectif dans le cerveau déployé : sans preuve, l'écriture est refusée. Le SDK l'exige aussi : sans preuve, rien n'est envoyé.

ELYSÉA n'écrit aucune mémoire sans une preuve de consentement fournie par vous, le constructeur. Le consentToken authentifie l'opération (P7) ; il ne vaut pas consentement.

Ce que vous devez montrer — un texte de consentement mémoire explicite et séparé (pas noyé dans des conditions générales), accepté par un geste positif de l'utilisateur.

Ce que vous devez conserver — le texte exact affiché, sa version, l'horodatage de l'accord et l'utilisateur concerné, pour pouvoir prouver l'accord.

Ce que vous devez envoyer — à chaque memory.write, une preuve MemoryConsentProof. Tous les champs sont obligatoires et non vides ; le SDK n'en remplit aucun à votre place.

import { libelleSha256, ElyseaSDKError, ElyseaNetworkError, type MemoryConsentProof } from '@elysea/core';

// Votre enregistrement de l'accord (texte exact affiché, version, horodatage)
const preuve: MemoryConsentProof = {
  granted: true,
  consent_text_version: accord.version,
  libelle_sha256: libelleSha256(accord.texteAffiche),
  consent_granted_at: accord.accepteLe,
  constructor_legal_entity: 'Votre Société SAS',
  app_id: 'votre-app',
};

try {
  await elysea.memory.write(
    coreUserId,
    { type: 'preferences_communication', content: 'Réponses courtes.', expires_at: '2027-01-01T00:00:00Z' },
    consentToken,
    preuve,
  );
} catch (e) {
  if ((e instanceof ElyseaSDKError || e instanceof ElyseaNetworkError) && e.errorCode === 'CONSENT_PROOF_REQUIRED') {
    // Mémoire désactivée pour cet utilisateur : ne pas réessayer sans preuve complète.
  }
}

Retrait — dès que l'utilisateur retire son accord, cessez d'envoyer la preuve (aucune nouvelle écriture n'est alors possible) et effacez les éléments déjà écrits avec memory.delete(coreUserId, itemId, consentToken). Le cerveau n'expose pas encore de route SDK pour retirer l'accord lui-même.

// elysea.ts — intégration complète ELYSEA CERVEAU
import { createElyseaClient, type PipelineResult } from '@elysea/core';

const elysea = createElyseaClient({
  baseUrl:     process.env.ELYSEA_BASE_URL!,
  auth: {
    apiKey:    process.env.ELYSEA_API_KEY!,
    apiSecret: process.env.ELYSEA_API_SECRET!,
  },
  appId:       process.env.ELYSEA_APP_ID!,
  countryCode: 'FR',
  region:      'EU',
});

type Message = { role: 'user' | 'assistant'; content: string };

export async function chat(
  userJwt:  string,
  message:  string,
  history:  Message[] = [],
): Promise<PipelineResult> {
  // 1. Résoudre l'identité — jamais l'email, jamais les données réelles
  const { coreUserId } = await elysea.identity.resolve({ userJwt });

  // 2. Appel pipeline cognitif — éthique appliquée par le pipeline, pas configurée
  const result = await elysea.pipeline.run({
    userInput:           message,
    coreUserId,
    conversationHistory: history,
  });

  // result.response         → réponse canon-conforme, prête à afficher
  // result.posture          → posture runtime (present_neutral, firm_safety…)
  // result.guardianAction   → 'pass'|'warn'|'block' (si block : errorCode + errorMessage)
  // result.canonConformance → true si conforme aux canons ELYSÉA
  return result;
}

// Utilisation dans votre handler API :
// const result = await chat(req.headers.authorization, req.body.message, history);
// res.json({ reply: result.response });