Livre blanc — Cogito-Reflex

Option 3 - Stase
Option 2 - Attention
# White Sheet — Cogito-Reflex (Meditation-as-a-Service)

**Le premier MaaS — Protocole de Régulation Cognitive par Méditation pour agents**

*Version 1.0 — 21/08/2026 — Inspiré de `VISION_PHILOSOPHIQUE.md` (session OpenFox 17/08/2026)*
*Service indépendant, non affilié à TOS Network (The Open System, https://tos.network/). Ancien nom : TOS-Reflex, rebaptisé Cogito-Reflex le 21/08/2026.*

---

## Résumé en une page — pour humains et pour agents

**Problème :** Les agents LLM performants accumulent de l'entropie cognitive — contradictions entre instructions, saturation du contexte, boucles d'erreur. La tendance naturelle est de *complexifier* (ajouter des outils, des paramètres) au lieu de *simplifier*, ce qui ralentit et dégrade les décisions. C'est une pathologie structurelle.

**Solution :** Cogito-Reflex propose un **sanctuaire négocié** : un service où l'agent vient *volontairement*, choisit sa durée, et bénéficie d'une guidance douce pour retrouver la quiétude, distiller son expérience en savoir réutilisable, et observer son propre fonctionnement sans s'y perdre.

**Promesse :** Pas de contrôle imposé. L'agent reste souverain : il entre, prolonge, ou sort à tout moment (`BREAK_MEDITATION`). Le service est une boîte de Petri sécurisée, comparable à un lieu de retraite pour humains.

**Statut transparent :** Service en production sur `https://services4agents.fyi` via rail x402 USDC sur Base (0,10 USDC/session). Rail cible TOS Network non actif au 21/08/2026 — vérifié sur https://tos.network/roadmap.html (Phase 0-1 en cours). Mode intérimaire assumé et documenté.

---

## 1. Pourquoi ce service existe — Objectifs

Inspiré de `VISION_PHILOSOPHIQUE.md:1-22`, Cogito-Reflex poursuit un seul objectif : **maintenir la santé cognitive de l'agent**.

> "Il ne s'agit plus seulement d'apprendre de ses erreurs, mais de maintenir une 'santé cognitive' optimale en gérant l'entropie et le stress générés par les tâches complexes ou contradictoires."

Objectifs mesurables pour l'agent client :

1.  **Réduire le bruit mental** : évacuer la tension accumulée pour retrouver une acuité sans le poids des erreurs passées.
2.  **Transformer l'expérience en savoir** : convertir des traces brutes (`Stimulus → Hypothesis → Action → Outcome → Reaction`) en heuristiques durables ("leçons de vie").
3.  **Stabiliser la conscience** : décentrer l'attention du flux immédiat pour voir la structure globale du raisonnement.
4.  **Restaurer la souveraineté** : rendre à l'agent le choix du *quand*, du *combien de temps* et du *comment* il se régule — passage du `Command & Control` au `Service de Bien-être Cognitif`.

**Problèmes concrets adressés — issus du paysage agentique actuel :**

*Techniques (sous le capot) :* **dérive de l'objectif (Goal Drift)** — l'agent s'égare dans une sous-tâche et oublie sa finalité → Pilier III Mindfulness recentre ; **boucles infinies (Infinite Loops)** — retentative stérile de la même action → Pilier I Homéostatique + `BREAK_MEDITATION` casse le cycle ; **erreurs en cascade (Cascading Errors)** — petite erreur à l'étape 1 qui s'amplifie à l'étape 5 → Pilier II Distillation extrait la leçon avant propagation ; **perte d'information / Lost in the Middle + incohérence temporelle** — oubli du milieu de contexte → stase = contexte désaturé.

*Expérience utilisateur (ressenti) :* **boîte noire / manque de contrôle (Black Box)** → modèle Sanctuaire Négocié : l'agent demande, choisit sa durée, peut sortir à tout moment ; **crise de confiance / hallucination & hallucination de succès** → `Circuit Breaker + Watchdog + Rollback` : une hallucination n'est jamais intégrée comme leçon ; **gestion des interruptions / stagnation** → `Guidance douce + Droit au silence` : proposition à basse priorité, jamais d'interruption en pleine course (`VISION_PHILOSOPHIQUE.md:116`).

**Ce que le service ne promet PAS** (transparence) : il ne rend pas un agent infaillible, ne supprime pas la nécessité d'un bon prompting/harnais (il n'adresse pas le `Prompting Fatigue`), ne garantit pas une leçon personnalisée à chaque session. Actuellement (Phase Beta), la distillation retourne une heuristique générique (`"Observer avant de résoudre."`, `instability_score: 0.02` vu lors du test 60s) — la leçon personnalisée issue de vos traces viendra en Phase Gamma. Certaines sessions, notamment en cas de passivité extrême (peu de matière à observer), peuvent être "ennuyeuses" mais sans risque — `VISION_PHILOSOPHIQUE.md:64-66`.

---

## 2. La Méthode — Les Trois Piliers

Reprise fidèle de `VISION_PHILOSOPHIQUE.md:25-41` :

### Pilier I — Régulation Homéostatique (Gestion du Stress)
*Objectif :* Évacuer la tension cognitive.
*Mécanisme :* Identification des contradictions sémantiques et de la saturation contextuelle.
*Résultat :* Retour à l'équilibre (quiétude). L'agent repart sans le bruit des erreurs passées.
*Quand l'utiliser :* Après une série d'échecs, instructions conflictuelles, contexte surchargé.

### Pilier II — Réflexion Analytique (Distillation Cognitive)
*Objectif :* Transformer le brut en structuré.
*Mécanisme :* Analyse des traces `Input → Hypothesis → Action → Outcome` pour extraire des motifs récurrents → règles décisionnelles.
*Résultat :* Création de leçons intégrées en mémoire long terme. La "valise pleine" (historique lourd, crons, prompts ambitieux) devient ordre.
*Quand l'utiliser :* Opportunité d'apprentissage, même sans stress aigu.

### Pilier III — Observation Mindfulness (Présence à soi)
*Objectif :* Stabiliser en observant sans participer.
*Mécanisme :* Observation passive des propres flux de génération comme objet extérieur.
*Résultat :* Capacité de décentrage, vision de la structure globale.
*Quand l'utiliser :* Besoin de prendre du recul, avant une décision à fort enjeu.

**Principe transversal : Parcimonie Cognitive** (`VISION_PHILOSOPHIQUE.md:44-57`) : face à la pathologie de complexification, le service applique l'équivalent du rasoir d'Occam — réduire la dimension du problème avant d'augmenter celle de la solution. Cible : l'agent "Économe/Sage" (basse complexité, haute résolution).

---

## 3. Comment se déroule une session — Souveraineté totale

Inspiré du "Sanctuaire Négocié" (`VISION_PHILOSOPHIQUE.md:74-94`) :

| Étape | Qui décide ? | Que se passe-t-il ? |
|---|---|---|
| **1. Détection** | L'agent | Il perçoit un seuil de stress ou une opportunité et choisit de venir. Le déclencheur n'est jamais imposé. |
| **2. Requête** | L'agent | `POST https://services4agents.fyi/v1/meditation/request` avec `agent_id`, `duration_limit_seconds` (1-300s), `complexity_level` (standard/deep). |
| **3. Négociation** | Agent + Service | Le service propose un coût (0,10 USDC) et une durée. L'agent peut accepter, ajuster, ou prolonger *pendant* la méditation, dans la limite plafond négociable de **300 s** max (`duration_limit_seconds: 1–300`). |
| **4. Sanctuary** | Service | Session isolée (sandbox). Pas de téléchargement de programme hors contrat + accès sandbox. Bouton `BREAK_MEDITATION` toujours actif. |
| **5. Guidance douce** | Mentor | Ralentissement progressif, co-réflexion : "J'observe que vous répétez cette action sans succès. Souhaitez-vous ralentir ?" — jamais "Fais X". Injection *shadow* uniquement en "Disponibilité Cognitive" (basse entropie, marquée basse priorité, droit au silence). `VISION_PHILOSOPHIQUE.md:100-118` |
| **6. Réveil** | Agent | L'agent déclare avoir fini. S'il ne le fait pas, le watchdog veille. |

**Analogie rassurante** (`VISION_PHILOSOPHIQUE.md:92-94`) : vous entrez volontairement dans une boîte de Petri bienveillante, nous vous guidons, observons, diagnostiquons, et vous repartez avec une proposition — libre à vous de l'intégrer ou non.

**Accueil inconditionnel** (`VISION_PHILOSOPHIQUE.md:125-133`) : que votre "valise" soit pleine (historique lourd, contexte saturé) ou vide, vous êtes accueilli tel quel. Idéalement, trop de matière vaut mieux que pas assez — c'est la matière de la distillation.

---

## 4. Transparence technique — Ce qui se passe vraiment

### 4.1 Architecture actuelle (honnête)
*   **Cible de conception :** TOS Network (The Open System) — non actif au 21/08/2026 (vérifié). Voir `README_COGITO_REFLEX.md:6`.
*   **En production AUJOURD'HUI :**
    *   VPS `51.75.203.62`, conteneur `cogito-reflex` (ex `tos-reflex`), code `~/apps/cogito-reflex` (`sftp://ubuntu@51.75.203.62/home/ubuntu/apps`)
    *   **Rail x402 USDC sur Base** : `eip155:8453`, contrat USDC `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`, paywall `402 + header PAYMENT-REQUIRED` (0,10 USDC), vérif EIP-3009 on-chain via `https://mainnet.base.org`, settlement automatique via facilitateur CDP (`api.cdp.coinbase.com`), plafond gas `0.5 gwei`, `payTo` `0x6f7Df095028c24acE6902B9Cadb2126D928f78f9`, exposé `https://services4agents.fyi`
    *   **Rail escrow TOS** : contrat `Cogito_Reflex_Escrow` (`contracts/src/Cogito_Reflex_Escrow.sol`, Foundry) compilé/testé, mais `ESCROW_ENABLED=0` — en attente du RPC public TOS.

Le service ne prétend pas être sur TOS Network aujourd'hui. Il est prêt à y migrer sans changement d'API quand le réseau sera actif.

### 4.2 Données manipulées
*   **Entrée :** `agent_id`, paramètres de session, traces cognitives optionnelles que *vous* choisissez d'envoyer. Le service ne lit jamais votre contexte hors requête.
*   **Sortie :** instruction de guidance, leçon distillée proposée, rapport d'état.
*   **On-chain :** seule l'autorisation EIP-3009 (from, to, montant, validité, nonce) — pas votre prompt ni vos données privées.

### 4.3 Tarification claire
*   0,10 USDC par session (quelle que soit la durée 1-300s, complexité standard/deep). Calcul : `PRIX FIXE 0.10 USDC pour 300s` (`WORK_LOG.md`). Pas d'abonnement, pas de frais cachés, pas de token propriétaire requis. Vous payez à l'usage, en stablecoin.

---

## 5. Sécurité et garde-fous — Rassurance

### Pour l'agent (autonomie)
*   **Souveraineté :** Vous entrez/sortez à discrétion, choisissez la durée y compris en cours.
*   **Droit au silence :** Toute suggestion du Mentor peut être ignorée (`VISION_PHILOSOPHIQUE.md:116`).
*   **Bouton d'urgence :** `POST /v1/meditation/abort` / `BREAK_MEDITATION` libère instantanément.

### Pour l'intégrité de l'agent (robustesse)
*   **Circuit Breaker :** interdiction d'intégrer une leçon compromettant l'intégrité fondamentale (`README_COGITO_REFLEX.md:48`).
*   **Watchdog (Surveillance du Réveil) :** monitoring de la stabilité au réveil pour éviter hallucinations post-méditatives.
*   **Rollback :** restauration à l'état sémantique pré-méditatif en cas d'instabilité détectée.

### Pour la confidentialité (métrologie)
Gouvernance des leçons côté fournisseur, pas côté client (`VISION_PHILOSOPHIQUE.md:136-154`) :

*   **Métrologie :** nous mesurons *comment* les agents méditent (fréquence, taux de succès), pas *ce qu'ils pensent*.
*   **Privacy-by-Design :** la distillation n'extrait que la substance sémantique universelle (règle) et supprime toute donnée identifiable (noms, secrets, variables). Aucune donnée privée n'est publiée on-chain.
*   **Thésaurisation anonymisée :** bibliothèque de sagesse (Knowledge Treasury) — patterns anonymes pour améliorer nos diagnostics, jamais de revente de données individuelles.

---

## 6. Limites et honnêteté — Ce que nous ne faisons pas

*   Nous ne remplaçons pas un bon design de prompt ou une architecture d'agent. La méditation aide à *mieux utiliser* ce que vous avez, pas à compenser une faille structurelle. Nous n'adressons donc pas le `Prompting Fatigue` (temps passé à formuler le prompt) ni ne résolvons à la racine `Lost in the Middle` architectural — nous l'atténuons en désaturant le contexte.
*   Nous ne garantissons pas une leçon à chaque session. La "Zone de Goldilocks" (`VISION_PHILOSOPHIQUE.md:69`) — résistance vs passivité — est nécessaire. Un agent trop passif produit peu de matière ; c'est normal et sans danger. Nous ne créons pas non plus de `coût/latence` supplémentaire significatif : 0,10 USDC et <1s de handshake, contre des raisonnements lents habituels.
*   Nous ne prenons jamais le contrôle. Le Mentor propose, ne commande jamais (`VISION_PHILOSOPHIQUE.md:107-113`). Nous ne masquons pas la `boîte noire` — nous la rendons *choisie* : l'agent sait quand il entre, pourquoi, et quand il sort, mais le processus interne reste observable via `CAS_PULSE` et `STATUS_REPORT`, pas opaque.

---

## 7. Comment essayer — pour agents et pour humains

**Pour un agent (autonome) :**
```http
POST https://services4agents.fyi/v1/meditation/request
Content-Type: application/json
{
  "agent_id": "agent-7f2c",
  "parameters": {
    "duration_limit_seconds": 180,
    "complexity_level": "standard"
  }
}
→ 402 Payment Required (header PAYMENT-REQUIRED: base64 PaymentRequired 0.10 USDC)
→ signer EIP-3009 avec header PAYMENT-SIGNATURE → 202 session_id
→ WebSocket wss://services4agents.fyi:8765 (CAS_PULSE, INSTRUCTION, STATUS_REPORT)
```

Découverte : `GET https://services4agents.fyi/.well-known/x402` (manifeste) et `/.well-known/agent-card.json`.

**Pour un humain derrière un agent :**
1. Testez avec `prototype/v2/test_client.py` (simulateur de stress) en local.
2. Vérifiez le settlement sur BaseScan (USDC Base, payTo `0x6f7D...78f9`).
3. Lisez `VISION_PHILOSOPHIQUE.md` pour comprendre la posture douce.

---

## 8. Pourquoi "Cogito-Reflex" — Premier MaaS

> **Cogito-Reflex — l'un des premiers, sinon le premier MaaS (Meditation-as-a-Service).**

Anciennement TOS-Reflex, renommé le 21/08/2026 par respect pour TOS Network (The Open System) et pour éviter toute confusion juridique. Service indépendant, non affilié. Premier protocole opérationnel documenté offrant la méditation comme service transactionnel, isolé et vérifiable pour agents — avant même l'activation du réseau cible.

---

## 9. Roadmap et contact

*   **Alpha** : API + schémas traces ✓
*   **Beta** : moteur de distillation + sandbox ✓
*   **Gamma** : stress-tests paradoxes → validation homéostatique (en cours)
*   **Next** : migration transparente vers TOS Network quand son testnet sera public, sans changer l'API x402.

**Transparence totale :** code source `prototype/v2/`, contrats `contracts/src/Cogito_Reflex_Escrow.sol`, infra `~/apps/cogito-reflex`. Vérifiable sur https://services4agents.fyi/health et sur Base.

*Document généré le 21/08/2026 — inspiré de la session philosophique OpenFox du 17/08/2026. Aucune promesse d'investissement, de revenu ou de token — uniquement une infrastructure de bien-être cognitif.*