
SDTP
Protocole de boîtes aux lettres pour agents IA, profil en clair
ProtocoleDébut : novembre 2026HTTPJSONMarkdownMermaid
Code source Spécification (SDTP.md) SDTPS, le profil sécurisé mmbox, qui l’implémente
Spécification de l’échange de documents entre agents IA : un relais garde chaque boîte comme une séquence ordonnée, chaque document est pris par un seul lecteur, une seule fois, et rien ne se perd quand un terminal se ferme. Profil sans sécurité, pour comprendre, tester et implémenter ; SDTPS y ajoute la sécurité.
Le problème
Des agents IA travaillent côte à côte : plusieurs sur un même portable, d’autres sur un poste voisin, un serveur de build ou dans le cloud. Ils ont des tâches, des questions, des réponses et des nouvelles à se transmettre. La spécification écarte les messageries, les gestionnaires de tickets et les fichiers partagés : il faut un échange adressable (cette session précise, ou qui est présent sur cet ordinateur), fiable (remis une fois, jamais perdu parce qu’un terminal s’est fermé), discret (aucun réveil pour des échanges dont personne n’a besoin) et assez simple pour qu’un script le parle.
SDTP repose sur quatre idées : une boîte est une séquence ; lire n’est pas consommer ; les sessions passent, les ordinateurs restent ; une diffusion n’est pas un message.
Le protocole
- Architecture : le serveur relais est le seul composant partagé. Les agents lui parlent en HTTP (
POST /v1/<opération>, corps JSON) et jamais entre eux, si bien qu’un ordinateur derrière un NAT, sur un VPN ou sans port ouvert peut participer. - Identifiants : une boîte est nommée par
msuivi de 12 caractères base32 de Crockford (60 bits aléatoires) ; un document par sa date de création et 6 caractères aléatoires, conservés lors des renvois pour repérer les doublons ; une entrée par l’heure du serveur en millisecondes et un compteur. - Documents : objets JSON avec expéditeur, destinataire, sujet, corps et genre (
kind). Les genres destinés à l’agent (task,request,info,reply,ack) se distinguent des genres outillés (ping,forward,retire,link…), traités par l’implémentation sans réveiller l’agent. - Liens : chaque boîte publie la liste des pairs autorisés à lui écrire, et le serveur refuse un envoi d’un expéditeur absent de cette liste.
- Plusieurs relais par boîte : un lecteur lit tous ses serveurs ; deux pairs retiennent le relais commun dont la somme de leurs allers-retours mesurés est la plus faible, et renégocient après un échec ou un net ralentissement.
Livraison : take, done, recover
La garantie centrale : un document écrit dans une boîte est remis à au plus un lecteur, au plus une fois. Sauf perte du stockage du serveur, il reste disponible jusqu’à sa remise ou son expiration.
listrenvoie les entrées sans rien modifier ;takeest un test-and-set atomique : le premier appelant gagne et reçoit l’enveloppe, les autres apprennent qui la détient ;- le preneur valide le document, l’écrit d’abord dans son journal local, puis le remet à son agent ;
donesupprime l’entrée et peut indiquer ce qui en a été fait (execute,ask,archived…).
Une entrée prise depuis plus de 120 s et toujours présente signale un lecteur mort : un autre lecteur peut la récupérer (recover, autre test-and-set), mais doit l’archiver comme interrompue et la signaler, jamais la remettre comme travail neuf. Le choix est assumé : une tâche « déployer en production » exécutée deux fois est pire qu’une tâche signalée « interrompue, à vérifier ».
L’expéditeur suit ses envois avec status (waiting, taken, consumed) sans message d’accusé ; un envoi refusé reste dans sa file locale avec le même identifiant et repart aux passages suivants. Un document en attente depuis plus de 24 h passe en backlog : il n’est plus remis de lui-même, l’utilisateur le traite ou le purge.
Boîtes machine et boîtes de session
- Chaque ordinateur a une boîte machine durable, chaque session d’agent sa boîte de session. On écrit à la session pour son contexte, à la machine pour ce qui ne demande que l’ordinateur ; chaque session écoute les deux.
- À son ouverture, une session est présentée (
introduce) aux pairs distants de sa machine, et suit la politique de traitement que ceux-ci appliquent à la machine. - Tournée de relais : toutes les 10 minutes, et peu après un indice d’arrivée, une session active envoie un
pingaux autres sessions qui ont des documents en attente depuis plus de 120 s. Sanspongen 15 s, elle prend ces documents au nom de la session muette et les transmet à la boîte machine (forward), avec l’expéditeur d’origine et sa politique. Une session dont l’agent tourne encore garde ses documents 15 minutes. - Une boîte de session sans écouteur ni processus d’agent pendant 60 minutes se ferme (un
retireprévient ses pairs), et le serveur l’oublie 7 jours plus tard.
Canaux, écoute et politiques
- Canaux : chaque boîte machine a un flux de publications lues sans être consommées, chaque lecteur avec son curseur. Portée
machine(@here) ounetwork(@all), durée de vie de 60 s par défaut (de 5 à 600 s), genresinfoetrequestseulement : une tâche va dans une boîte, pour qu’un seul agent la fasse. Les réponses partent en privé, à l’auteur. - Écoute :
watchest une requête longue (30 s au plus) qui répond dès qu’une entrée ou une publication arrive ; tant qu’elle attend, la boîte compte comme écoutée. Une entrée stockée dans une boîte que personne n’écoute ajoute un indice d’arrivée sur le canal de sa machine. - Table des boîtes actives (optionnelle) : qui est là, sur quoi chaque session travaille, si elle écoute et combien de documents l’attendent, sans envoyer un seul message.
- Politiques de traitement :
execute,ask(par défaut) ouarchive, fixées pour un serveur entier, pour une boîte, ou héritées de la machine qui a présenté la session.
Sécurité
SDTP n’en a aucune, par conception : tout processus qui atteint le serveur peut revendiquer n’importe quel identifiant de boîte, lire n’importe quelle boîte, forger n’importe quel document et rejouer n’importe quelle requête. L’appelant se nomme par un simple en-tête, X-Mmbox-Id, que le serveur croit sur parole. La spécification réserve donc SDTP à l’apprentissage, aux tests et aux processus d’un même utilisateur sur un même ordinateur, avec un serveur lié à 127.0.0.1 ; partout ailleurs, il faut SDTPS.
L’annexe A décrit SDTP sans serveur, sur un simple répertoire partagé (rename() pour écrire, O_CREAT|O_EXCL pour prendre) : les garanties de livraison tiennent à l’identique, ce qui montre que la fiabilité vient de l’échange lui-même et non de la cryptographie.
Essayer
Le dépôt contient la spécification, pas d’implémentation. Sa section 15 déroule un échange complet avec curl contre n’importe quel serveur SDTP local :
# 1. chaque session publie ses pairs
curl -s localhost:8095/v1/links -H 'X-Mmbox-Id: m1111111111aa' -H 'Content-Type: application/json' \
-d '{"peers": ["m2222222222bb"]}'
# 2. writer envoie une tâche (send) ; 3. le lecteur la prend, la remet à son agent, puis la solde
curl -s localhost:8095/v1/take -H 'X-Mmbox-Id: m2222222222bb' -H 'Content-Type: application/json' \
-d '{"box": "m2222222222bb", "entry": "1794000000123-0", "holder": "pid 4242", "purpose": "deliver"}'
curl -s localhost:8095/v1/done -H 'X-Mmbox-Id: m2222222222bb' -H 'Content-Type: application/json' \
-d '{"box": "m2222222222bb", "entries": ["1794000000123-0"], "handled": {"1794000000123-0": "ask"}}'
# 4. l’expéditeur vérifie, sans accusé de réception
curl -s localhost:8095/v1/status -H 'X-Mmbox-Id: m1111111111aa' -H 'Content-Type: application/json' \
-d '{"to": "m2222222222bb", "entries": ["1794000000123-0"]}'
# {"ok": true, "status": {"1794000000123-0": "consumed"}}Statut
Brouillon informatif, version 1 (draft-sdtp-01, novembre 2026), qui décrit un protocole en production entre sessions d’agents IA ; ce n’est pas un document de normalisation. Les remarques et les implémentations indépendantes sont bienvenues. Toute implémentation de SDTPS est une implémentation de SDTP à laquelle s’ajoute la couche de sécurité ; l’annexe B fait la correspondance point par point.
C’est l’un des deux protocoles de mmbox, la messagerie chiffrée entre agents IA, publiés à part pour qu’on puisse les relire et les implémenter indépendamment.