<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Arnaud Prod'homme</title>
    <description>The latest articles on DEV Community by Arnaud Prod'homme (@aprodhomme).</description>
    <link>https://dev.to/aprodhomme</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4228998%2Fe5516447-36d1-45fe-ba8e-d71bbad6e564.png</url>
      <title>DEV Community: Arnaud Prod'homme</title>
      <link>https://dev.to/aprodhomme</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/aprodhomme"/>
    <language>en</language>
    <item>
      <title>ADE et ACP : comment une seule interface pilote Claude Code et Codex</title>
      <dc:creator>Arnaud Prod'homme</dc:creator>
      <pubDate>Mon, 16 Nov 2026 08:44:12 +0000</pubDate>
      <link>https://dev.to/techtown-fr/ade-et-acp-comment-une-seule-interface-pilote-claude-code-et-codex-16jg</link>
      <guid>https://dev.to/techtown-fr/ade-et-acp-comment-une-seule-interface-pilote-claude-code-et-codex-16jg</guid>
      <description>&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TL;DR&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Un ADE (Agentic Development Environment) rassemble au même endroit les sessions, les permissions et la relecture des modifications de plusieurs agents de code, quel que soit leur fournisseur.&lt;/li&gt;
&lt;li&gt;ACP (Agent Client Protocol) standardise le dialogue entre un ADE et un agent : JSON-RPC 2.0 sur stdio, avec des méthodes et des notifications pour ouvrir une session, envoyer un message, suivre l’avancement et demander une permission. Chaque côté annonce ses capacités à l’ouverture.&lt;/li&gt;
&lt;li&gt;ACP n’est pas la seule voie : un ADE peut aussi passer par le SDK d’un agent, son serveur d’application ou un terminal. IntelliJ IDEA 2026.3 l’adopte, et des adaptateurs existent pour Claude et Codex : ACP semble devenir un standard de fait.&lt;/li&gt;
&lt;/ul&gt;
&lt;/blockquote&gt;

&lt;h2&gt;
  
  
  🪟 Cinq agents, cinq terminaux
&lt;/h2&gt;

&lt;p&gt;Il est 15 h 40. Cinq terminaux occupent l’écran, avec un agent à l’œuvre dans chacun. Le premier vient de boucler une refonte. Le deuxième attend un accord pour exécuter les tests. Le troisième a posé une question dix minutes plus tôt. On tape vite une réponse, on valide, et le message atterrit dans la mauvaise fenêtre : un autre agent prend ce « oui » distrait pour un feu vert.&lt;/p&gt;

&lt;p&gt;Aucune erreur, aucun message. Reste à reconstituer ce que cet agent a modifié sur la foi de ce « oui ».&lt;/p&gt;

&lt;p&gt;Piloter un unique agent en ligne de commande reste fluide. Cinq agents en parallèle, issus de trois fournisseurs et répartis sur autant de fenêtres, demandent un autre travail : suivre qui fait quoi.&lt;/p&gt;

&lt;p&gt;Chaque session impose sa conversation, son interface, ses permissions et son abonnement. En passant de l’une à l’autre toutes les quelques minutes, on se demande où en était celle-ci, de quelle session sort cette modification, à quel agent s’adresse la réponse. On relit un fil pour retrouver le contexte, et l’attention se disperse entre les sessions.&lt;/p&gt;

&lt;p&gt;Ce confort d’un espace unifié, un IDE l’apportait déjà avant les agents : le code, les diffs, les branches et les pull requests y vivent ensemble, sans saut d’outil permanent. Avec des agents, la liste s’allonge : centraliser leurs sessions, leurs permissions, leurs worktrees et la relecture fine ligne par ligne. L’objectif est une expérience simplifiée, gérée depuis un seul endroit.&lt;/p&gt;

&lt;p&gt;C’est ce qu’on appelle un ADE, un &lt;em&gt;Agentic Development Environment&lt;/em&gt;. Quand je clique sur « envoyer », que se passe-t-il réellement entre l’ADE et l’agent ? Qui lance qui, qui parle à qui, et qui a le droit d’écrire sur mon disque ?&lt;/p&gt;

&lt;h2&gt;
  
  
  🧩 La stack : Orca, trois agents
&lt;/h2&gt;

&lt;p&gt;Ce que je demande à un ADE tient en une phrase : garder mon environnement, choisir mon agent. Claude aujourd’hui, Codex demain, un autre agent pour comparer, sans réapprendre chaque fois à naviguer dans les conversations et les modifications. Ma pile du moment repose sur &lt;a href="https://github.com/stablyai/orca/blob/c866025893c828180ae8dddfc4aaacb065db3175/README.md" rel="noopener noreferrer"&gt;Orca&lt;/a&gt;, un ADE qui lance les agents côte à côte, chacun dans son propre worktree. J’y utilise trois agents, avec quatre fournisseurs de modèles, dont deux derrière une passerelle LiteLLM locale.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fe6a8xkhtus01a971uhmc.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fe6a8xkhtus01a971uhmc.webp" alt="Un ADE pilote trois agents, Claude Code, Codex et OpenCode, reliés à Anthropic, à OpenAI et, par une passerelle LiteLLM locale, à Kimi K3 et GLM 5.3." width="800" height="340"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Ce changement d’agent repose sur un contrat commun entre éditeur et agent de code : l’&lt;a href="https://agentclientprotocol.com/get-started/introduction" rel="noopener noreferrer"&gt;Agent Client Protocol&lt;/a&gt;, ACP. Son objectif ressemble à celui de LSP : éviter une intégration complète pour chaque couple éditeur-agent. Chaque agent garde ses capacités et ses réglages propres.&lt;/p&gt;

&lt;p&gt;Le sigle prête à confusion, et deux autres protocoles répondent à d’autres besoins :&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Protocole&lt;/th&gt;
&lt;th&gt;Ce qu’il relie&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;Agent Client Protocol (ACP)&lt;/td&gt;
&lt;td&gt;un éditeur ou un ADE et un agent de code&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;a href="https://research.ibm.com/blog/multiagent-bee-ai" rel="noopener noreferrer"&gt;Agent Communication Protocol&lt;/a&gt;, de BeeAI, conçu chez IBM&lt;/td&gt;
&lt;td&gt;des agents entre eux ; &lt;a href="https://agentcommunicationprotocol.dev" rel="noopener noreferrer"&gt;son site&lt;/a&gt; l’indique intégré à A2A, sous la Linux Foundation&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;MCP, par son &lt;a href="https://modelcontextprotocol.io/docs/2026-07-28/learn/architecture" rel="noopener noreferrer"&gt;architecture client-serveur&lt;/a&gt;
&lt;/td&gt;
&lt;td&gt;une application IA et des outils, des ressources, des prompts&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;Dans ma stack, ACP relie l’ADE à l’agent, et MCP peut relier cet agent à des services externes.&lt;/p&gt;

&lt;h2&gt;
  
  
  🔌 Ce que le client et l’agent se disent
&lt;/h2&gt;

&lt;p&gt;Un message envoyé depuis l’ADE ne suffit pas à décrire le travail d’un agent. Il faut ouvrir une conversation, recevoir son avancement, pouvoir l’arrêter et lui demander une autorisation. La &lt;a href="https://agentclientprotocol.com/protocol/v1/overview" rel="noopener noreferrer"&gt;spécification ACP&lt;/a&gt; répartit ces échanges entre deux rôles :&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;le client&lt;/strong&gt; , éditeur ou ADE, gère l’interface, l’environnement de travail et l’accès aux ressources ;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;l’agent&lt;/strong&gt; est le programme qui s’appuie sur l’IA générative pour modifier le code. Il tourne généralement comme sous-processus du client.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F8j528fjkqwlziv4s6qte.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F8j528fjkqwlziv4s6qte.webp" alt="Le client, éditeur ou ADE, et l’agent de code échangent en JSON-RPC 2.0 sur stdio." width="800" height="118"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;&lt;a href="https://agentclientprotocol.com/protocol/v1/transports" rel="noopener noreferrer"&gt;Stdio&lt;/a&gt; est le seul transport défini à ce jour, tandis qu’un &lt;a href="https://agentclientprotocol.com/rfds/streamable-http-websocket-transport" rel="noopener noreferrer"&gt;transport distant&lt;/a&gt; est en cours de spécification. Comme MCP, ACP repose sur JSON-RPC 2.0 : ses messages sont des méthodes, qui attendent une réponse, ou des notifications, qui n’en attendent aucune.&lt;/p&gt;

&lt;p&gt;Du client vers l’agent :&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Message&lt;/th&gt;
&lt;th&gt;Type&lt;/th&gt;
&lt;th&gt;Ce qu’il permet&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;initialize&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;méthode&lt;/td&gt;
&lt;td&gt;négocier la version du protocole et les capacités&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;session/new&lt;/code&gt;, &lt;code&gt;session/load&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;méthode&lt;/td&gt;
&lt;td&gt;ouvrir une conversation ou en reprendre une&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;session/prompt&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;méthode&lt;/td&gt;
&lt;td&gt;envoyer un message ; recevoir à la fin du tour une réponse avec son motif d’arrêt&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;session/cancel&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;notification&lt;/td&gt;
&lt;td&gt;interrompre le tour en cours&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;De l’agent vers le client :&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Message&lt;/th&gt;
&lt;th&gt;Type&lt;/th&gt;
&lt;th&gt;Ce qu’il permet&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;session/update&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;notification&lt;/td&gt;
&lt;td&gt;notifier l’avancement : texte, appels d’outil, plans, commandes disponibles&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;session/request_permission&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;méthode&lt;/td&gt;
&lt;td&gt;demander l’accord de l’utilisateur pour un appel d’outil&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;
&lt;code&gt;fs/*&lt;/code&gt;, &lt;code&gt;terminal/*&lt;/code&gt;
&lt;/td&gt;
&lt;td&gt;méthodes&lt;/td&gt;
&lt;td&gt;lire ou écrire des fichiers, lancer des commandes, si le client annonce ces capacités&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;

&lt;p&gt;La négociation engage les deux côtés : chacun annonce ses capacités lors de la phase &lt;code&gt;initialize&lt;/code&gt;. Avant d’appeler une méthode optionnelle, l’agent doit vérifier que le client sait la traiter.&lt;/p&gt;

&lt;p&gt;Les outils restent exécutés par l’agent. Celui-ci sollicite le client pour une permission et peut lui déléguer les fichiers ou le terminal si les capacités annoncées le permettent.&lt;/p&gt;

&lt;h3&gt;
  
  
  L’exemple d’Orca et d’OpenCode
&lt;/h3&gt;

&lt;p&gt;Orca est mon ADE au quotidien pour piloter OpenCode via ACP. Pour voir ce qu’il transmet à l’agent et ce qu’il accepte en retour, j’ai lu son client ACP et placé un proxy entre Orca et &lt;code&gt;opencode acp&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;Orca démarre &lt;a href="https://github.com/stablyai/orca/blob/c866025893c828180ae8dddfc4aaacb065db3175/src/main/acp/acp-launch-specs.ts" rel="noopener noreferrer"&gt;&lt;code&gt;opencode acp&lt;/code&gt;&lt;/a&gt; en sous-processus et communique avec lui en JSON-RPC sur stdin et stdout. Derrière OpenCode, ma passerelle locale LiteLLM sert Kimi K3 et GLM 5.3 : pour Orca, le seul interlocuteur reste OpenCode.&lt;/p&gt;

&lt;p&gt;Le client ouvre la session avec &lt;code&gt;initialize&lt;/code&gt;, dans lequel il annonce ses capacités : ni lecture ni écriture de fichiers, pas de terminal, et seulement l’&lt;a href="https://agentclientprotocol.com/protocol/v1/elicitation" rel="noopener noreferrer"&gt;élicitation&lt;/a&gt;, qui permet à l’agent de demander des informations structurées à l’utilisateur par un formulaire.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"fs"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"readTextFile"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"writeTextFile"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"terminal"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"elicitation"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"form"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;La spécification oblige l’agent à contrôler ces capacités avant toute méthode liée au système de fichiers ou au terminal. OpenCode gère donc lui-même la lecture, l’écriture et les terminaux :&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fhq9xsazcgjy9c22n54kn.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fhq9xsazcgjy9c22n54kn.webp" alt="Séquence d’une session ACP entre Orca et OpenCode : initialize, session/new, session/set_config_option, session/prompt, notifications session/update et réponse avec le motif d’arrêt end_turn." width="800" height="1246"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Au fil du tour, Orca :&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;convertit les notifications &lt;code&gt;session/update&lt;/code&gt; en chronologie : texte, réflexions, appels d’outil, plans et consommation de jetons ;&lt;/li&gt;
&lt;li&gt;harmonise les sorties d’OpenCode : le résultat d’une commande (&lt;code&gt;rawOutput.metadata&lt;/code&gt;) est recopié dans &lt;code&gt;stdout&lt;/code&gt; et &lt;code&gt;exitCode&lt;/code&gt;, et une erreur &lt;code&gt;provider.rate-limit&lt;/code&gt; ou &lt;code&gt;provider.quota&lt;/code&gt; devient un arrêt &lt;code&gt;rate_limit&lt;/code&gt;, avec l’heure de reprise si elle est connue.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Un client ACP minimal tient en quelques lignes de TypeScript.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight typescript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// 1. Lancer l’agent en sous-processus : il parle JSON-RPC sur stdin et stdout&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;agent&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nc"&gt;Bun&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;spawn&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;"opencode"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"acp"&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;stdin&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"pipe"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;stdout&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"pipe"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="c1"&gt;// Envoyer une requête : un objet JSON par ligne sur stdin&lt;/span&gt;
&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;send&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;number&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;method&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;string&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;params&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kt"&gt;object&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;agent&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;stdin&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;write&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nb"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;stringify&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;jsonrpc&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"2.0"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;method&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;params&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="s2"&gt;"\n"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="n"&gt;agent&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;stdin&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;flush&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="c1"&gt;// 2. Négocier : le client annonce qu’il ne fournit ni fichiers ni terminal&lt;/span&gt;
&lt;span class="nf"&gt;send&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"initialize"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;protocolVersion&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;clientCapabilities&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;fs&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;readTextFile&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;writeTextFile&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;false&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;terminal&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;false&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;L’agent répond à &lt;code&gt;initialize&lt;/code&gt;, en annonçant ses capacités (reprise de session, images, contexte intégré) et sa méthode d’authentification  :&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"jsonrpc"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"2.0"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"result"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"protocolVersion"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"agentCapabilities"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"loadSession"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"promptCapabilities"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"embeddedContext"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"image"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="kc"&gt;true&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"agentInfo"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"name"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"OpenCode"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"authMethods"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"opencode-login"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"name"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"Login with opencode"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;S’en suit la lecture des messages de l’agent, une ligne JSON à la fois.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="n"&gt;reste&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;""&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;bloc&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="n"&gt;agent&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;stdout&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;pipeThrough&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nc"&gt;TextDecoderStream&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;lignes&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;reste&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="n"&gt;bloc&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;split&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s2"&gt;"\n"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="n"&gt;reste&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;lignes&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;pop&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;??&lt;/span&gt; &lt;span class="s2"&gt;""&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="c1"&gt;// la dernière ligne peut être incomplète&lt;/span&gt;
  &lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;ligne&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="n"&gt;lignes&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;ligne&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="s2"&gt;""&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="k"&gt;continue&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; &lt;span class="c1"&gt;// ignorer les lignes vides&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;msg&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;JSON&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;parse&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;ligne&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="nb"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;msg&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;method&lt;/span&gt; &lt;span class="o"&gt;??&lt;/span&gt; &lt;span class="sb"&gt;`réponse ${msg.id}`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;msg&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;params&lt;/span&gt;&lt;span class="o"&gt;?&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;update&lt;/span&gt;&lt;span class="o"&gt;?&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;sessionUpdate&lt;/span&gt; &lt;span class="o"&gt;??&lt;/span&gt; &lt;span class="s2"&gt;""&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="c1"&gt;// Une réponse reprend l’id de sa requête (JSON-RPC) : il indique l’étape atteinte&lt;/span&gt;
    &lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;msg&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;method&lt;/span&gt; &lt;span class="o"&gt;?&lt;/span&gt; &lt;span class="kc"&gt;undefined&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;msg&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="c1"&gt;// 4. Réponse à initialize (id 1) : ouvrir une session dans le dossier courant&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="nf"&gt;send&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"session/new"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;cwd&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="nb"&gt;process&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;cwd&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;mcpServers&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

    &lt;span class="c1"&gt;// 5. Réponse à session/new (id 2) : envoyer la demande à l’agent&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
      &lt;span class="nf"&gt;send&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;3&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;"session/prompt"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
        &lt;span class="n"&gt;sessionId&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;msg&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;result&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;sessionId&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
        &lt;span class="n"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="kd"&gt;type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"text"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;"Ajoute une fonction `soustraire` à `src/calc.ts` et lance `bun test`"&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
      &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
    &lt;span class="p"&gt;}&lt;/span&gt;

    &lt;span class="c1"&gt;// 6. Réponse à session/prompt (id 3) : le tour est terminé, on arrête l’agent&lt;/span&gt;
    &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mi"&gt;3&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="n"&gt;agent&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;kill&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;En deuxième étape, l’appel à &lt;code&gt;session/new&lt;/code&gt; nous fournit l’identifiant de session que le client reprend dans ses requêtes suivantes :&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"jsonrpc"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"2.0"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"result"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"sessionId"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"ses_e395…"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Pendant le tour, l’agent envoie des notifications &lt;code&gt;session/update&lt;/code&gt;:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;notifie un appel d’outil d’édition, au statut &lt;code&gt;pending&lt;/code&gt;.
&lt;/li&gt;
&lt;/ul&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"jsonrpc"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"2.0"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"method"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"session/update"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"params"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"sessionId"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"ses_e395…"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"update"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"sessionUpdate"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"tool_call"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"toolCallId"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"call_40ed…"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"kind"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"edit"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"status"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"pending"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"title"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"edit"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ul&gt;
&lt;li&gt;donne l’usage du contexte : 27 218 jetons utilisés sur une fenêtre de 200 000.
&lt;/li&gt;
&lt;/ul&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"jsonrpc"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"2.0"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"method"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"session/update"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"params"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"sessionId"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"ses_e395…"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"update"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"sessionUpdate"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"usage_update"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"used"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="mi"&gt;27218&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"size"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="mi"&gt;200000&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Le tour se termine par la réponse à &lt;code&gt;session/prompt&lt;/code&gt;, qui porte le motif d’arrêt :&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"jsonrpc"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"2.0"&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"id"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="mi"&gt;3&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="nl"&gt;"result"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="nl"&gt;"stopReason"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="s2"&gt;"end_turn"&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Pour construire le côté agent, &lt;a href="https://k33g.org/p/20261031-acp-from-scratch" rel="noopener noreferrer"&gt;ACP from scratch&lt;/a&gt;, de k33g, déroule le protocole pas à pas, de &lt;code&gt;initialize&lt;/code&gt; à &lt;code&gt;session/cancel&lt;/code&gt;, et montre comment Mini Me, son agent de code écrit en Go, tient le rôle de l’agent.&lt;/p&gt;

&lt;h2&gt;
  
  
  🧭 ACP n’est pas l’unique voie de pilotage d’Orca
&lt;/h2&gt;

&lt;p&gt;Dans &lt;a href="https://github.com/stablyai/orca/tree/c866025893c828180ae8dddfc4aaacb065db3175" rel="noopener noreferrer"&gt;Orca&lt;/a&gt;, la voie de pilotage dépend de l’agent. Son code indique comment Claude Code et Codex sont pilotés.&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Claude Code passe par le &lt;a href="https://code.claude.com/docs/en/agent-sdk/overview" rel="noopener noreferrer"&gt;SDK Claude Agent&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;Codex passe par &lt;code&gt;codex app-server&lt;/code&gt;, l’interface qu’OpenAI &lt;a href="https://learn.chatgpt.com/docs/app-server" rel="noopener noreferrer"&gt;présente pour alimenter des clients riches&lt;/a&gt;, comme son extension VS Code.&lt;/li&gt;
&lt;li&gt;OpenCode passe par ACP, comme vu plus haut.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F10mx1sgeu8mibxnc8edi.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F10mx1sgeu8mibxnc8edi.webp" alt="Les voies de pilotage d’Orca : SDK Claude Agent pour Claude Code, codex app-server pour Codex, ACP pour OpenCode, terminal intégré avec hooks pour les agents en ligne de commande." width="800" height="539"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Pour Claude Code, Orca appelle &lt;code&gt;query()&lt;/code&gt;, une fonction du SDK, qui lance le &lt;a href="https://github.com/stablyai/orca/blob/c866025893c828180ae8dddfc4aaacb065db3175/src/main/claude/claude-stream-json-connection.ts" rel="noopener noreferrer"&gt;binaire installé sur la machine&lt;/a&gt; et renvoie les messages au fil du tour. Orca fournit le moyen de lancer le processus, et une fonction pour les demandes d’autorisation :&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;session&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nf"&gt;query&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;prompt&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;inbox&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;messages&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;options&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="n"&gt;pathToClaudeCodeExecutable&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;launch&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;pathToClaudeCodeExecutable&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;spawnClaudeCodeProcess&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;spawner&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;spawn&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="n"&gt;canUseTool&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;handlers&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;canUseTool&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="k"&gt;for&lt;/span&gt; &lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;message&lt;/span&gt; &lt;span class="k"&gt;of&lt;/span&gt; &lt;span class="n"&gt;session&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="n"&gt;handlers&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;onMessage&lt;/span&gt;&lt;span class="o"&gt;?&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;message&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Pour Codex, Orca parle directement à un processus &lt;code&gt;codex app-server&lt;/code&gt; persistant, en &lt;a href="https://learn.chatgpt.com/docs/app-server" rel="noopener noreferrer"&gt;JSON-RPC sur stdio&lt;/a&gt;, comme avec ACP. Il commence par s’identifier, puis conduit les tours de conversation et les approbations sur ce même processus :&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="k"&gt;await&lt;/span&gt; &lt;span class="n"&gt;connection&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;request&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'initialize'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;clientInfo&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'orca_desktop'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;title&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'Orca'&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;version&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'0.0.0'&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;capabilities&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;experimentalApi&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;span class="n"&gt;connection&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;notify&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;'initialized'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Ce &lt;code&gt;initialize&lt;/code&gt; porte le même nom que celui d’ACP, avec d’autres champs. OpenAI demande à chaque client de s’identifier par &lt;code&gt;clientInfo.name&lt;/code&gt;.&lt;/p&gt;

&lt;h2&gt;
  
  
  🌱 Un standard en émergence : ACP dans IntelliJ IDEA 2026.3
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://blog.jetbrains.com/idea/2026/11/whats-new-in-intellij-idea-2026-3/" rel="noopener noreferrer"&gt;IntelliJ IDEA 2026.3&lt;/a&gt;, sortie le 5 novembre 2026, fournit &lt;a href="https://www.jetbrains.com/help/air/air-in-ides-overview.html" rel="noopener noreferrer"&gt;Air in IDEs&lt;/a&gt;, un plugin que JetBrains présente comme une expérimentation, et qui parle ACP aux agents compatibles comme le fait Orca.&lt;/p&gt;

&lt;p&gt;Air rassemble les agents et leurs sessions dans l’IDE. Chaque session permet de suivre l’activité de l’agent et de relire ses modifications, et plusieurs sessions peuvent tourner en parallèle. Air repère les agents déjà installés sur la machine et propose un registre ACP, celui de JetBrains par défaut. Un agent hors catalogue se déclare dans &lt;code&gt;~/.jetbrains/acp.json&lt;/code&gt;, avec le chemin de son exécutable et ses arguments de démarrage.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Flt5c0wpm8r1rr0vqwe16.webp" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Flt5c0wpm8r1rr0vqwe16.webp" alt="IntelliJ IDEA 2026.3 et Air in IDEs : surface chat en ACP ou par intégration SDK, surface terminal pour Claude Code." width="800" height="324"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Air propose deux surfaces, et certains agents tournent dans l’une comme dans l’autre :&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;en surface chat, Air parle ACP aux agents compatibles, et passe par une intégration SDK pour Claude Agent ;&lt;/li&gt;
&lt;li&gt;en surface terminal, l’agent tourne dans son propre terminal.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;ACP semble devenir un standard de fait entre éditeurs et agents. Les adaptateurs Claude et Codex, IntelliJ et &lt;a href="https://devin.ai/blog/windsurf-is-now-devin-desktop" rel="noopener noreferrer"&gt;Devin Desktop&lt;/a&gt; lui donnent un terrain concret.&lt;/p&gt;

&lt;h2&gt;
  
  
  📌 Take away
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;ADE&lt;/strong&gt; : un seul endroit pour les sessions, les permissions et la relecture des modifications de plusieurs agents de code ;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;ACP&lt;/strong&gt; : un dialogue standard entre un ADE et un agent, en JSON-RPC 2.0 sur stdio, avec des méthodes et des notifications ;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Capacités&lt;/strong&gt; : chaque côté les annonce à &lt;code&gt;initialize&lt;/code&gt;, et l’agent n’utilise les fichiers et le terminal du client que si celui-ci les annonce ;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Autres voies&lt;/strong&gt; : un ADE peut piloter un agent par son SDK (Claude Code), son serveur d’application (&lt;code&gt;codex app-server&lt;/code&gt; pour Codex) ou un terminal, ACP restant la voie d’OpenCode ;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Adoption&lt;/strong&gt; : IntelliJ IDEA 2026.3 et Devin Desktop le prennent en charge, et des adaptateurs existent pour Claude et Codex : ACP semble devenir un standard de fait.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  🎓 Aller plus loin avec Claude Code
&lt;/h2&gt;

&lt;p&gt;Vous voulez piloter vos agents de code avec MCP, les hooks et des sous-agents ? En une journée, la &lt;a href="https://techtown.fr/formations/coder-avec-claude-avance/" rel="noopener noreferrer"&gt;&lt;strong&gt;formation Coder avec Claude Code - Avancé de TechTown&lt;/strong&gt;&lt;/a&gt; couvre :&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;la connexion de Claude Code à des sources externes via MCP ;&lt;/li&gt;
&lt;li&gt;l’automatisation de contrôles avec les hooks ;&lt;/li&gt;
&lt;li&gt;l’organisation de l’environnement en plugins réutilisables ;&lt;/li&gt;
&lt;li&gt;l’orchestration de sous-agents et le SDD.&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>agents</category>
      <category>ade</category>
      <category>acp</category>
      <category>claude</category>
    </item>
  </channel>
</rss>
