[{"data":1,"prerenderedAt":21},["ShallowReactive",2],{"doc:fr:plugins\u002Fharnesses":3},{"title":4,"lede":5,"html":6,"headings":7},"Un harness ACP décrit","Un agent qui parle ACP (Agent Client Protocol) devient un harness d’Escouade par un plugin déclaratif : son manifeste le décrit, sans une ligne de code, et le plugin ACP livré avec Escouade fait le reste.","\u003Cp>Ce plugin (\u003Ccode class=\"key\">dev.escouade.acp\u003C\u002Fcode>) lance l’agent, lui parle et montre sa conversation, ses permissions, ses diffs et ses fins de tour, comme pour Claude Code. L’agent apparaît dans le menu « Harness » à côté de « Nouvel agent ».\u003C\u002Fp>\n\u003Ch2 id=\"le-manifeste\">Le manifeste\u003C\u002Fh2>\n\u003Cp>Le plugin Goose (\u003Ccode class=\"key\">plugins\u002Fgoose\u002F\u003C\u002Fcode> du dépôt d’Escouade), essayé avec Goose 1.57 :\u003C\u002Fp>\n\u003Cp>\u003Ccode>plugins\u002Fgoose\u002Fescouade-plugin.json\u003C\u002Fcode>\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  "$schema": "https:\u002F\u002Fescouade.dev\u002Fschemas\u002Fplugin-1.json",\n  "id": "dev.escouade.goose",\n  "name": "Goose",\n  "version": "1.0.0",\n  "description": {\n    "fr": "Goose, l'agent open source de Block, comme harness : décrit par ACP, sans code.",\n    "en": "Goose, Block's open source agent, as a harness: described over ACP, no code."\n  },\n  "author": { "name": "Escouade", "url": "https:\u002F\u002Fescouade.dev" },\n  "license": "MIT",\n  "repository": "https:\u002F\u002Fgithub.com\u002Fguillaume-gagnaire\u002Fescouade\u002Ftree\u002Fmain\u002Fplugins\u002Fgoose",\n  "escouade": { "api": "1", "min": "2.1.0" },\n  "contributes": {\n    "harnesses": [\n      {\n        "id": "goose",\n        "name": "Goose",\n        "speaker": "Goose",\n        "writer": "Goose",\n        "locate": { "names": ["goose"] },\n        "tested": { "oldest": "1.57.0", "newest": "1.57.0" },\n        "caps": {\n          "modes": [\n            {\n              "id": "default",\n              "meaning": {\n                "fr": "Goose demande avant chaque outil (son mode approve). Il écrit les fichiers lui-même, sans les faire passer par Escouade.",\n                "en": "Goose asks before each tool (its approve mode). It writes files by itself, without passing them through Escouade."\n              }\n            },\n            {\n              "id": "acceptEdits",\n              "meaning": {\n                "fr": "Goose ne demande que pour ce qu'il juge sensible (son mode smart_approve) ; Escouade accepte ses écritures dans le dossier de l'agent.",\n                "en": "Goose asks only for what it deems sensitive (its smart_approve mode); Escouade accepts its writes in the agent's folder."\n              }\n            },\n            {\n              "id": "bypassPermissions",\n              "meaning": {\n                "fr": "Goose ne demande rien (son mode auto) : commandes, fichiers, tout le disque. Pas de bac à sable.",\n                "en": "Goose asks nothing (its auto mode): commands, files, the whole disk. No sandbox."\n              }\n            }\n          ],\n          "readOnly": true\n        },\n        "accountVar": "GOOSE_PATH_ROOT",\n        "install": {\n          "windows": "Invoke-WebRequest -Uri https:\u002F\u002Fraw.githubusercontent.com\u002Faaif-goose\u002Fgoose\u002Fmain\u002Fdownload_cli.ps1 -OutFile download_cli.ps1; .\u002Fdownload_cli.ps1",\n          "unix": "curl -fsSL https:\u002F\u002Fgithub.com\u002Faaif-goose\u002Fgoose\u002Freleases\u002Fdownload\u002Fstable\u002Fdownload_cli.sh | CONFIGURE=false bash"\n        },\n        "updateCommand": "goose update",\n        "acp": {\n          "args": ["acp"],\n          "fs": false,\n          "modes": { "default": "approve", "acceptEdits": "smart_approve", "bypassPermissions": "auto" },\n          "readOnlyMode": "chat",\n          "modelOption": "model",\n          "questionsInText": true,\n          "tools": { "shell": "Bash", "write": "Write", "edit": "Edit", "text_editor": "Edit", "read": "Read", "tree": "Glob" }\n        }\n      }\n    ]\n  }\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Chaque entrée de \u003Ccode>contributes.harnesses\u003C\u002Fcode> avec un objet \u003Ccode class=\"key\">acp\u003C\u002Fcode> est un harness décrit :\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Ccode class=\"key\">id\u003C\u002Fcode>, \u003Ccode class=\"key\">name\u003C\u002Fcode>, \u003Ccode class=\"key\">speaker\u003C\u002Fcode> (le nom de ses agents dans les textes), \u003Ccode class=\"key\">writer\u003C\u002Fcode> (qui rédige les textes) ;\u003C\u002Fli>\n\u003Cli>\u003Ccode class=\"key\">locate.names\u003C\u002Fcode> : les noms de son programme, cherchés dans le PATH ; un plugin déclaratif ne donne jamais de chemin ;\u003C\u002Fli>\n\u003Cli>\u003Ccode class=\"key\">versionArgs\u003C\u002Fcode> (par défaut \u003Ccode class=\"key\">--version\u003C\u002Fcode>) et \u003Ccode class=\"key\">tested\u003C\u002Fcode> : la version lue et les versions essayées, comme pour les harness d’Escouade ;\u003C\u002Fli>\n\u003Cli>\u003Ccode class=\"key\">caps\u003C\u002Fcode> : ses modes, chacun par son id ou avec son sens (\u003Ccode class=\"key\">meaning\u003C\u002Fcode>, ce que dit le menu des modes), et ce qu’il sait faire (\u003Ccode class=\"key\">images\u003C\u002Fcode>, \u003Ccode class=\"key\">pdf\u003C\u002Fcode>, \u003Ccode class=\"key\">readOnly\u003C\u002Fcode>…) ; ce qui n’est pas dit, il ne le fait pas ;\u003C\u002Fli>\n\u003Cli>\u003Ccode class=\"key\">models\u003C\u002Fcode> : les modèles de son menu (\u003Ccode class=\"key\">id\u003C\u002Fcode>, \u003Ccode class=\"key\">label\u003C\u002Fcode>) ;\u003C\u002Fli>\n\u003Cli>\u003Ccode class=\"key\">accountVar\u003C\u002Fcode> : la variable qui donne à chaque compte son dossier de configuration ;\u003C\u002Fli>\n\u003Cli>\u003Ccode class=\"key\">install\u003C\u002Fcode> et \u003Ccode class=\"key\">updateCommand\u003C\u002Fcode> : sa commande d’installation (Windows, Unix) et de mise à jour.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"l-objet-acp\">L’objet \u003Ccode class=\"key\">acp\u003C\u002Fcode>\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Ccode class=\"key\">args\u003C\u002Fcode> : ses arguments (\u003Ccode class=\"key\">["acp"]\u003C\u002Fcode>) ; \u003Ccode class=\"key\">env\u003C\u002Fcode> et \u003Ccode class=\"key\">removeEnv\u003C\u002Fcode> : des variables à lui (jamais un secret : un manifeste se lit), et celles de l’app qu’il ne doit pas recevoir ;\u003C\u002Fli>\n\u003Cli>\u003Ccode class=\"key\">fs\u003C\u002Fcode> : il lit et écrit les fichiers \u003Cstrong>par Escouade\u003C\u002Fstrong> (\u003Ccode class=\"key\">fs\u002Fread_text_file\u003C\u002Fcode>, \u003Ccode class=\"key\">fs\u002Fwrite_text_file\u003C\u002Fcode>), vrai par défaut. Mets \u003Ccode class=\"key\">false\u003C\u002Fcode> pour un agent qui les lit et écrit lui-même, comme Goose ou Cursor CLI, même quand Escouade le lui propose ;\u003C\u002Fli>\n\u003Cli>\u003Ccode class=\"key\">modes\u003C\u002Fcode> : le mode ACP (\u003Ccode class=\"key\">session\u002Fset_mode\u003C\u002Fcode>) de chaque mode d’Escouade ; \u003Ccode class=\"key\">readOnlyMode\u003C\u002Fcode> : celui qui ne change rien, pour les discussions de l’onglet Docs ;\u003C\u002Fli>\n\u003Cli>\u003Ccode class=\"key\">modelOption\u003C\u002Fcode> : l’option de configuration du modèle (\u003Ccode>session\u002Fset_config_option\u003C\u002Fcode>), sinon \u003Ccode class=\"key\">session\u002Fset_model\u003C\u002Fcode> ;\u003C\u002Fli>\n\u003Cli>\u003Ccode class=\"key\">questionsInText\u003C\u002Fcode> : l’agent n’a pas d’outil pour poser une question ; son premier message lui dit de finir son tour sur un bloc \u003Ccode class=\"key\"><escouade_question>\u003C\u002Fcode>, qu’Escouade montre comme une carte de question ;\u003C\u002Fli>\n\u003Cli>\u003Ccode class=\"key\">tools\u003C\u002Fcode> : le nom d’Escouade (celui de Claude Code) de ses outils de genre \u003Ccode class=\"key\">other\u003C\u002Fcode> (\u003Ccode>{ "shell": "Bash" }\u003C\u002Fcode>), lus dans \u003Ccode>_meta.<agent>.toolCall.toolName\u003C\u002Fcode> ou dans leur titre avant « · » ; \u003Ccode class=\"key\">subagentTools\u003C\u002Fcode> : ceux qui lancent un sous-agent ;\u003C\u002Fli>\n\u003Cli>\u003Ccode class=\"key\">extensions\u003C\u002Fcode> : \u003Ccode class=\"key\">cursor\u003C\u002Fcode> pour les extensions \u003Ccode class=\"key\">cursor\u002F*\u003C\u002Fcode> de Cursor CLI.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"ce-qu-escouade-tient\">Ce qu’Escouade tient\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Le lancement.\u003C\u002Fstrong> Escouade trouve le programme, demande au plugin ACP comment le lancer, vérifie la description et le lance lui-même. Le serveur MCP d’Escouade est donné à la session (\u003Ccode class=\"key\">mcpServers\u003C\u002Fcode>), son jeton dans un en-tête, sur l’entrée de l’agent : jamais dans ses arguments.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Les permissions.\u003C\u002Fstrong> Chaque permission demandée est une carte, avec son diff pour une écriture. « Édits auto » laisse passer les écritures dans le dossier de l’agent, « Bypass » tout ce qu’il demande.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Les projets privés.\u003C\u002Fstrong> Escouade refuse les fichiers d’un autre projet que l’agent lit ou écrit par lui. Quand l’agent lit ou écrit un fichier lui-même pendant qu’une clôture tient, la conversation le dit : la clôture ne tient pas pour ces accès. Un harness déclaré \u003Ccode>"fs": false\u003C\u002Fcode> ne démarre pas dans un projet privé.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Ce qu’ACP ne dit pas\u003C\u002Fstrong> reste inconnu : le quota, le coût, les comptes. Les jetons d’un tour sont comptés quand l’agent les donne.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Un plugin désinstallé ou désactivé (ou le plugin ACP lui-même) : ses agents restent, marqués « Harness absent », avec leurs conversations. Ils reviennent avec lui. L’id d’un harness décrit est \u003Ccode>plugin:<plugin>:<harness>\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp>Pour l’instant, un harness décrit n’a pas de vue terminal ni de textes rédigés.\u003C\u002Fp>\n\u003Cp>Un harness qui n’est pas décrit par ACP s’écrit en Rust : voir \u003Ca href=\"\u002Fdocs\u002Fplugins\u002Frust\u002F#ecrire-un-harness\">écrire un harness\u003C\u002Fa>.\u003C\u002Fp>\n\u003Ch2 id=\"l-essayer\">L’essayer\u003C\u002Fh2>\n\u003Cp>Installe le dossier de ton plugin depuis la vue Plugins (« En développement »), puis choisis son harness dans le menu « Harness ». Avant l’installation, la fenêtre montre le programme que ses agents lanceront (\u003Ccode>goose acp\u003C\u002Fcode>). Le banc des harness d’Escouade joue le même client sur un faux agent ACP décrit par un manifeste (\u003Ccode>tests\u002Ffixtures\u002Fplugins\u002Ffake-acp\u002F\u003C\u002Fcode>).\u003C\u002Fp>\n",[8,12,15,18],{"id":9,"text":10,"depth":11},"le-manifeste","Le manifeste",2,{"id":13,"text":14,"depth":11},"l-objet-acp","L’objet acp",{"id":16,"text":17,"depth":11},"ce-qu-escouade-tient","Ce qu’Escouade tient",{"id":19,"text":20,"depth":11},"l-essayer","L’essayer",1793889379659]