# Référence : surface Agent Client Protocol > Description neutre de ce que `mm -acp` expose en JSON-RPC 2.0 sur stdio, via `github.com/coder/acp-go-sdk` v0.13.5. ## Transport | Aspect | Valeur | |--------|--------| | Entrée | stdin, un message JSON-RPC par ligne. | | Sortie | stdout, messages JSON-RPC uniquement. | | Journaux | stderr : bannière, avertissements, lignes `[acp] …`, logger du SDK. | | Durée de vie | Jusqu'à ce que le client ferme stdin ou que le contexte du processus soit annulé. | ## Réponse à `initialize` | Champ | Valeur | |-------|--------| | `protocolVersion` | `1` | | `agentCapabilities` | Toutes absentes (false) : pas de `loadSession`, pas de prompts image ou audio, pas de MCP HTTP. | | `agentInfo.name` | `bob` | | `agentInfo.title` | `Bob (bash-first agent)` | | `agentInfo.version` | `0.11.0` | | `authMethods` | `[]` | ## Méthodes | Méthode | Comportement | |---------|--------------| | `initialize` | Journalise le nom du client et la version du protocole sur stderr ; renvoie les valeurs ci-dessus. | | `authenticate` | Renvoie une réponse vide. | | `session/new` | Crée une session `bob--` avec le `cwd` de la requête, un historique neuf contenant le prompt système et un ensemble « toujours autoriser » vide. Les `mcpServers` sont comptés dans le journal et ignorés. Une fois la réponse écrite, envoie une notification `available_commands_update` listant les commandes slash (voir plus bas). | | `session/prompt` | Exécute une génération sur l'historique de la session, ou exécute une commande slash sans consulter le modèle. Les tours sont sérialisés à l'échelle du processus. | | `session/cancel` | Annule le tour en cours pour cette session. | | `session/set_mode`, `session/set_config_option`, `session/list`, `session/resume`, `session/close`, `logout` | `method not found`. | ## `session/prompt` | Aspect | Comportement | |--------|--------------| | `sessionId` inconnu | Erreur `invalid params` portant le `sessionId`. | | Contenu du prompt | Blocs `text` concaténés ; un `resource_link` devient `\n[attached file: ]` ; les autres types de blocs sont ignorés. Ensuite, chaque `@chemin` du texte qui désigne un fichier ou un répertoire existant sous le `cwd` de la session (ou un chemin absolu / `~`) ajoute `\n[attached file: ]` ou `\n[attached directory: …]`, une fois par chemin, et est journalisé comme `[acp] session : attached `. | | Commande slash | Quand le texte aplati, débarrassé de ses espaces, est exactement `/new` ou `/compact`, aucune génération n'a lieu ; la commande répond par un `agent_message_chunk` et `stopReason: end_turn`. | | `/new` | L'historique de la session revient au seul prompt système, le dernier compte de tokens d'entrée du moteur est oublié, le fragment est `🆕 New session: N message(s) forgotten.`. L'identifiant de session, le `cwd` et les autorisations « toujours autoriser » sont conservés. Journalisé comme `[acp] session : new session, N message(s) forgotten`. | | `/compact` | L'historique est compressé avec les réglages `context`, en mode forcé (le seuil est ignoré, `keepLastTurns` est respecté). Le fragment est `🗜️ compressed N messages → 1 summary + N kept (… tokens, …s)`, ou `🗜️ nothing to compact: N message(s), no turn older than the last K` (historique inchangé), ou `[compact: failed, history kept: ]` (historique inchangé). Le compte de tokens n'est oublié que si l'historique a changé. Attend la fin d'un tour en cours : les tours sont sérialisés. Journalisé comme `[acp] session : /compact — `. | | Historique | L'historique complet renvoyé par le moteur est conservé, même après un échec ou une annulation ; une question restée sans aucune réponse est retirée. | | Succès | `stopReason: end_turn`. | | Annulé | `stopReason: cancelled`. | | Échec | `internal error` avec `error: `. | | Ligne de journal | `[acp] turn done: N command(s) · N file op(s) · N skill(s)` sur stderr. | ## Notifications `session/update` envoyées | Mise à jour | Quand | |-------------|-------| | `available_commands_update` | Une fois par session, juste après l'écriture de la réponse à `session/new` (l'éditeur doit d'abord connaître l'identifiant de session, sinon il ignore la mise à jour). Liste les commandes slash que `session/prompt` intercepte. | | `agent_message_chunk` (texte) | Chaque fragment diffusé de la réponse du modèle, espaces préservés ; aussi la ligne de confirmation d'une commande slash. | | `tool_call` statut `pending` | Avant l'exécution d'un outil ; porte `title`, `kind`, `rawInput`, et `locations` avec le chemin absolu quand un fichier est concerné. | | `tool_call_update` statut `in_progress` | Permission accordée, outil en cours d'exécution. | | `tool_call_update` statut `completed` ou `failed` | Outil terminé ; `content` est un `diff` pour les changements de fichier, sinon un bloc `text` avec la sortie ; `rawOutput.output` porte toujours la sortie. | ## Commandes disponibles | `name` | `description` | `input` | |--------|---------------|---------| | `new` | `Clear the history and start a new session` | aucun | | `compact` | `Compress the history now, keeping the last turns` | aucun | Les clients affichent le nom précédé d'une barre oblique et le renvoient comme texte d'un `session/prompt`. ## Requêtes `session/request_permission` envoyées Envoyées avant l'exécution de `bash`, `read_file`, `write_file` et `edit_file` ; jamais pour `read_skill`. | Identifiant d'option | Genre | Effet | |----------------------|-------|-------| | `allow` | `allow_once` | Exécute l'outil. | | `allow_always` | `allow_always` | Exécute l'outil et supprime le dialogue pour ce nom d'outil jusqu'à la fin de la session. | | `reject` | `reject_once` | N'exécute pas ; le modèle reçoit `[command rejected by the user]`. | Une erreur de transport ou un résultat `cancelled` compte comme un refus. ## Genres d'outils | Genre `mm` | `ToolKind` ACP | Outils | |------------|----------------|--------| | `execute` | `execute` | `bash` (et tout genre inconnu) | | `read` | `read` | `read_skill`, `read_file` | | `edit` | `edit` | `write_file`, `edit_file` | ## Identifiants d'appel d'outil `call_1`, `call_2`, … numérotés par processus et jamais remis à zéro.