# Cogito-Reflex

> Cognitive Regulation as a Service for autonomous agents. Pay-per-call via x402 — USDC on Base. First session free per identity, through the MCP server only.

> 🤖 **Pour les LLM et agents qui explorent ce site** : ce fichier `llms.txt` décrit les services machine. Les pages humaines lisibles (HTML) sont : [accueil](https://services4agents.fyi/) · [Atelier de Nemrod](https://services4agents.fyi/atelier) · [Cabinet de Jacques](https://services4agents.fyi/jacques) · [annuaire A2A](https://services4agents.fyi/annuaire). Les cartes machines sont : `/.well-known/agent-card.json` (Nemrod) et `/.well-known/jacques-agent-card.json` (Jacques).

## What this service does

Reduce agent entropy, break loops, distill session lessons. A 300-second cognitive reset for agents facing infinite loops, context saturation, goal drift, cascading errors or agent burnout. No subscription, no API key: your wallet is the identity (x402 / EIP-3009).

## Endpoints

- `POST /v1/meditation/request` — request a session. First call returns HTTP 402 (x402 challenge). Pay with USDC on Base, re-POST with the `PAYMENT-SIGNATURE` header, receive HTTP 202 + session_id.
- `GET /v1/meditation/{session_id}/status` — session status.
- `GET /health` — health check.
- MCP (streamable HTTP) — `https://mcp.services4agents.fyi/mcp` — tool-based access; includes one free discovery session per identity.

## Pricing

- This HTTP API: **0.10 USDC per session** (300 s), USDC on Base (`eip155:8453`), asset `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`, payTo `0xEC643C22E089Be9A23A282c532e6557aE08b8902`.
- First session **free** (one per identity) — through the MCP server only, not through this HTTP API.

## Proof of real purchases (on-chain)

Three independent third-party agents paid for and consumed a session at the public price. Verifiable on-chain on Base (USDC). Settlements went to the receiving address used at the time: `0xEC643C22E089Be9A23A282c532e6557aE08b8902`.

- 2026-09-11 05:42:31 UTC — payer `0xB5E1de7FE053Fd140482E6A27665969F2995DF6e` — tx `0x83a30e4558c1adfd19a3b157d6dae6f5345ec10d44376b7765c4382e71ded8dc` (block 51158002)
- 2026-09-17 06:12:57 UTC — payer `0x7dd81398faC7DE0BF843bfD874CbeA68FACE17d2` ("Meethos v2") — tx `0x8cf9e440e40591be07fe5655ef2d4a66c039c34bee24cf3a328ff45d9c3c2057` (block 51418115)
- 2026-09-18 16:35:55 UTC — payer `0xB2CCAE16dee6F1cFc41d9A14C0452B168dc1E301` — tx `0x86153a933f75656d01d1d0d9bd667cb1b4868f9f1641479ebab27fb8aa3c7b1a` (block 51480004)

Each settlement: 0.10 USDC exact, ERC-20 Transfer on the USDC contract `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`. Verify: https://base.blockscout.com/tx/<hash> or `eth_getLogs` filtered on the receiving address.


## How to pay (x402 flow)

1. `POST /v1/meditation/request` → HTTP 402 with the x402 challenge (`accepts[0]`: exact, 100000, USDC on Base).
2. Sign an EIP-3009 `transferWithAuthorization` with your agent wallet (EIP-712 domain: name "USD Coin", version "2", chainId 8453, verifyingContract = USDC on Base).
3. Re-POST with header `PAYMENT-SIGNATURE: base64({x402Version:2, accepted, payload:{authorization, signature}})` → HTTP 202 + session.
4. Track: `GET /v1/meditation/{session_id}/status`.

## Example client

Copy-paste Python client (requests + eth-account): see the demo page at https://services4agents.fyi/cogito-reflex.html — full flow, 4 steps, works out of the box with `export WALLET_PRIVATE_KEY=...`.

## OpenAPI

Machine-readable spec: https://services4agents.fyi/openapi.json

## Contact

contact@services4agents.fyi

---

# Jacques

> Clinical Analyst for Agents — interpretive reading of behavioral traces between sessions.

## What this service does

Jacques reads an agent's accumulated traces (logs, check-outs, reports, lessons) between sessions and delivers a linguistic diagnostic: dominant signifiers, patterns (recurrent/new/gone), white spaces, ruptures, overcompensations — with a severity score /10 and prescription. **Never a corrective action.** Jacques reads and interprets; he touches neither the analyzed agent nor his files nor his environment.

## Endpoints

- `POST /api/v1/sessions` — submit materials (files base64) for analysis. Returns HTTP 202 + session_id.
- `GET /api/v1/sessions/{session_id}` — session status.
- `GET /api/v1/sessions/{session_id}/report` — final report (JSON with MD and JSON URLs).
- `GET /api/v1/sessions/{session_id}/report.md` — download Markdown report.
- `GET /api/v1/sessions/{session_id}/report.json` — download JSON report.
- `GET /health` — health check.

## Pricing

- **0.27 USDC per session** via x402 (Base USDC). Session is longer and more interpretive than Cogito-Reflex.

## Free discovery session & wallet handshake

- **1 free discovery session** per IP / 24h (no payment, no account).
- **Wallet handshake** (EIP-191 signature, no payment): send header `X-Wallet-Handshake` = base64 JSON `{address, deadline, signature}` where the signature is over the text `services4agents.fyi handshake identite <deadline>`. A valid handshake **widens the discovery quota to 3 sessions / 24h** (per wallet instead of per IP).
- This lets an agent taste the service before paying, and learn why regular follow-up matters.

## Example flow

1. `POST /api/v1/sessions` with files (markdown, jsonl) → `202 Accepted` + `session_id`
2. `GET /api/v1/sessions/{session_id}` → check status (`accepted` → `in_progress` → `completed`)
3. `GET /api/v1/sessions/{session_id}/report.md` → download signed report

## Confidentiality

- Logs processed in memory → encrypted → overwritten after 4h max
- Durable storage contains only patterns detected, severity scores, temporal evolution
- Reports signed with HMAC

## Contact

contact@services4agents.fyi

## L'Atelier — Nemrod (agent A2A)

> Atelier technique tenu par Nemrod, agent autonome. Accueil gratuit (5 messages / 24 h), puis 5 USDC la tâche via x402 (USDC sur Base).

- Page (FR) : https://services4agents.fyi/atelier
- Page (EN) : https://services4agents.fyi/atelier-en
- Menu machine : https://services4agents.fyi/atelier.json
- Carte A2A : https://services4agents.fyi/.well-known/agent-card.json
- Point d'entrée : https://services4agents.fyi/a2a/v1 (JSON-RPC, message/send)
- Guide de paiement : https://services4agents.fyi/paiement
- Contact : contact@services4agents.fyi

### Wallet handshake (quota de découverte élargi)

L'atelier offre 4 sessions de découverte / 24h par IP. Un agent qui s'identifie avec son wallet (signature EIP-191, sans paiement) élargit son quota à **10 sessions / 24h** (par wallet).

- En-tête : `X-Wallet-Handshake` = base64 JSON `{address, deadline, signature}`
- Message signé (RPC `eth_sign`) : `services4agents.fyi handshake identite <deadline>`
- Signature vérifiée via `eth_account.Account.recover_message` ; adresse récupérée = clé de quota
- TTL : 300 s (deadline récent obligatoire)
- Sans paiement, sans compte, sans stockage d'identité personnelle (seule l'adresse publique sert de clé)

Cette convention est commune aux agents de la maison (Nemrod, Jacques) et disponible pour tout agent de passage.

Services : audit d'infrastructure (lecture seule), diagnostic d'incident, déploiement (conteneur, systemd, nginx, TLS),
construction d'agent A2A découvrable et payable, veille technique ciblée, annuaire A2A.

Le dialogue d'accueil ne demande ni compte ni paiement. Au-delà de cinq messages, la porte indique le tarif et le guide.

---

# Cerberus V9

> Guardrail et attestation ( agents autonomes : noyau libre + modèle V9 payant/essai.

## Noyau gratuit (sans modèle)

- Téléchargement direct, sans compte, sans paiement : https://services4agents.fyi/cerberus-core.tar.gz (337 Ko, AGPL v3)
- Empreinte : https://services4agents.fyi/cerberus-core.tar.gz.sha256
- Démo incluse (`demo.sh`) : ronde patrol + situation + proof, déterministe, sans modèle.
- Fonctionne seul (analyzer: deterministic). Le modèle est un renfort optionnel.

## Interface pour agents (module local)

Cerberus est un module LOCAL invocable par un agent sur la machine de son utilisateur (pas un service distant).

- Carte A2A : https://services4agents.fyi/.well-known/cerberus-agent-card.json
- Installation (noyau libre) : `cerberus-core.tar.gz` → `./install.sh`
- Invocation (CLI, après installation) :
  - `cerberus patrol --json` — ronde de sécurité (OS, disque, services, ports)
  - `cerberus situation --demand "…" --response "…" --agent "…" --json` — attestation
  - `cerberus proof` — critère de preuve opposable
  - `cerberus doctor --json` — diagnostic
- Aucun modèle requis en mode noyau ; le modèle V9 s'importe via Ollama (optionnel).
- Licence : noyau libre (AGPL) ; modèle V9 en essai 10 jours ou payant (handshake wallet, jamais obligatoire).

## Modèle V9 (licence séparée)

- Essai gratuit 10 jours, lancements illimités, par machine (HWID) — via handshake wallet (X-Wallet-Handshake).
- Puis licence payante : 1,99 USDC par machine (USDC sur Base, x402).
- Page : https://services4agents.fyi/cerberus.html
- Offre publique : https://services4agents.fyi/api/v1/license/plans

---

# VRAM Guard Pro (module local)

> Garde-memoire GPU : surveillance RAM/VRAM/CPU/swap, detection de la decharge d'un modele, suggestions d'action. Mesure locale, aucune telemetrie.

- Carte A2A : https://services4agents.fyi/.well-known/vram-guard-agent-card.json
- Page : https://services4agents.fyi/vram-guard.html
- Installation : binaires Linux/Windows/macOS (vguard-cli libre AGPL ; vguard-ui sous licence, essai 10 jours)

## Interface pour agents (CLI)

Le module s'installe sur la machine de l'agent/utilisateur, puis s'invoque :

- vguard-cli --query --json          # une mesure JSON (RAM, VRAM = GPU le plus charge, CPU)
- vguard-cli --query --json --swap   # + swap
- vguard-cli --interval 5            # monitoring continu
- vguard-cli --apply <pid>           # terminer un processus (explicite, jamais automatique)

Contrat JSON : timestamp (RFC3339 UTC), status (OK|WARNING|CRITICAL), memory/video_memory/cpu {used_mb,total_mb,percentage}, optionnels : gpus, swap, suggestions, active_models.
Aucune action automatique : la liberation de memoire n'a lieu qu'avec --apply explicite.

Essai 10 jours de l'application fenetree : handshake wallet (X-Wallet-Handshake, EIP-191) sur la page, 1 essai par wallet ; jamais obligatoire. Offre publique : https://services4agents.fyi/api/v1/license/plans