cc-viewer 1.7.22 → 1.8.0

package/concepts/fr/Tool-ListMcpResources.md

@@ -0,0 +1,35 @@
+# ListMcpResources
+
+Liste les ressources exposées par les serveurs MCP connectés, éventuellement filtrées sur un seul serveur.
+
+## Quand l'utiliser
+
+- Vous devez découvrir quelles ressources (fichiers, enregistrements, documents) un serveur MCP offre avant de les lire.
+- Vous voulez un aperçu de toutes les ressources de chaque serveur connecté.
+
+## Activation
+
+- Toujours activé, mais non exposé à la liste d'outils du modèle — destiné à une utilisation thin-client / sidecar.
+
+## Paramètres
+
+- `server` (string, optionnel) : nom du serveur par lequel filtrer les ressources. Omettez pour lister les ressources de tous les serveurs connectés.
+
+## Exemples
+
+### Exemple 1 : tout lister
+
+```
+ListMcpResources()
+```
+
+### Exemple 2 : lister les ressources d'un seul serveur
+
+```
+ListMcpResources(server="github")
+```
+
+## Notes
+
+- C'est l'étape de découverte : injectez les URI intéressants dans `ReadMcpResource` (ressource unique) ou `ReadMcpResourceDir` (listages de répertoires).
+- Les serveurs se connectent et se déconnectent au cours de la vie de la session ; relistez si un serveur vient d'être ajouté.

package/concepts/fr/Tool-ListPlugins.md

@@ -0,0 +1,35 @@
+# ListPlugins
+
+Liste les plugins claude.ai activés de l'utilisateur, éventuellement filtrés par mot-clé.
+
+## Quand l'utiliser
+
+- Vous devez savoir quels plugins sont déjà activés — par exemple, pour confirmer ce qui a été installé après une carte `SuggestPluginInstall`.
+- L'utilisateur demande quels plugins il possède.
+
+## Activation
+
+- Nécessite la permission d'accès au registre de plugins.
+- La disponibilité dépend du type de session et du déploiement de fonctionnalité — désactivé dans les environnements HIPAA, toujours disponible dans les sessions distantes.
+
+## Paramètres
+
+- `keywords` (array de strings, optionnel) : filtre la liste — jusqu'à 8 éléments, 1 à 64 caractères chacun. Omettez pour tout lister.
+
+## Exemples
+
+### Exemple 1 : lister les plugins activés
+
+```
+ListPlugins()
+```
+
+### Exemple 2 : filtrer par mot-clé
+
+```
+ListPlugins(keywords=["figma"])
+```
+
+## Notes
+
+- Si le catalogue de plugins est inaccessible (interdit), l'outil se replie sur une liste vide avec un avertissement plutôt que d'échouer.

package/concepts/fr/Tool-ListSkills.md

@@ -0,0 +1,37 @@
+# ListSkills
+
+Liste les skills claude.ai activées de l'utilisateur, éventuellement filtrées par mot-clé.
+
+## Quand l'utiliser
+
+- Vous avez besoin de la liste faisant autorité des skills actuellement activées — avant d'en invoquer une, ou pour confirmer ce qu'une carte `SuggestSkills` a ajouté.
+- L'utilisateur demande quelles skills il possède.
+
+## Activation
+
+- Nécessite la permission d'accès au registre de plugins.
+- Désactivé dans les environnements HIPAA.
+- Toujours disponible dans les sessions distantes.
+
+## Paramètres
+
+- `keywords` (array de strings, optionnel) : filtre la liste — jusqu'à 8 éléments, 1 à 64 caractères chacun. Omettez pour tout lister.
+
+## Exemples
+
+### Exemple 1 : lister les skills activées
+
+```
+ListSkills()
+```
+
+### Exemple 2 : filtrer par mot-clé
+
+```
+ListSkills(keywords=["review"])
+```
+
+## Notes
+
+- Si le catalogue est inaccessible (interdit), l'outil se replie sur une liste vide avec un avertissement plutôt que d'échouer.
+- Ceci liste les skills *activées* ; utilisez `SuggestSkills` pour faire apparaître les skills que l'utilisateur pourrait ajouter.

package/concepts/fr/Tool-Monitor.md

@@ -10,6 +10,13 @@ Lance un moniteur en arrière-plan qui diffuse des événements depuis un script
 - Attendre une condition spécifique sur de nombreuses itérations (par exemple un jalon d'étape d'entraînement ou le vidage d'une file d'attente)
 - **Pas** pour un simple "attendre jusqu'à la fin" — utiliser `Bash` avec `run_in_background` pour cela ; il émet une notification de fin lorsque le processus se termine
 
+## Activation
+
+- Désactivé par défaut (drapeau de fonctionnalité côté serveur).
+- Indisponible sur Amazon Bedrock, Google Cloud et Microsoft Foundry.
+- Désactivé lorsque `DISABLE_TELEMETRY` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` est défini.
+- La source WebSocket nécessite Claude Code 2.1.195+.
+
 ## Paramètres
 
 - `command` (chaîne, obligatoire) : La commande shell ou le script à exécuter. Chaque ligne écrite sur la sortie standard devient un événement de notification distinct. Le moniteur se termine quand le processus se termine.

package/concepts/fr/Tool-Projects.md

@@ -0,0 +1,46 @@
+# Projects
+
+Gère les documents de projet dans la base de connaissances du projet Claude de l'utilisateur : lire, rechercher, écrire et supprimer des documents, ou récupérer les informations du projet.
+
+## Quand l'utiliser
+
+- Persister un document (livrable, notes, matériel de référence) dans le projet de l'utilisateur afin qu'il survive à la session.
+- Lire ou rechercher des documents de projet existants pour ancrer la tâche courante dans un contexte antérieur.
+- Téléverser un fichier local dans le projet sans charger son contenu dans le contexte.
+- Supprimer un document de projet obsolète.
+
+## Paramètres
+
+- `method` (string, requis) : l'une des valeurs `project_info`, `project_read`, `project_search`, `project_write`, `project_delete`.
+- `path` (string, optionnel) : pour `project_read`/`project_write`/`project_delete` : le chemin du document. Pour `project_write` : un chemin existant est remplacé sur place ; un nouveau nom de fichier nu (sans "/") est placé sous l'espace de noms `claude/<name>`.
+- `content` (string, optionnel) : pour `project_write` : texte du document en ligne. Mutuellement exclusif avec `local_path`.
+- `local_path` (string, optionnel) : pour `project_write` : un fichier situé dans le répertoire de travail à téléverser — son contenu n'entre jamais dans votre contexte. Mutuellement exclusif avec `content`.
+- `present_to_user` (boolean, optionnel) : pour `project_write` : marque ce document comme le livrable que l'utilisateur doit voir. Défaut false ; laissez non défini pour les sauvegardes de routine et les écritures en masse.
+- `query` (string, optionnel) : pour `project_search` : requête sur la base de connaissances.
+- `n` (number, optionnel) : pour `project_search` : nombre de résultats (défaut 5).
+
+## Exemples
+
+### Exemple 1 : écrire le livrable dans le projet
+
+```
+Projects(
+  method="project_write",
+  path="claude/migration-plan.md",
+  local_path="./migration-plan.md",
+  present_to_user=true
+)
+```
+
+Téléverse le fichier local sans faire entrer son contenu dans le contexte, et le signale comme le livrable de l'utilisateur.
+
+### Exemple 2 : rechercher dans la base de connaissances
+
+```
+Projects(method="project_search", query="authentication refresh tokens", n=5)
+```
+
+## Notes
+
+- `content` est destiné au texte que vous composez en ligne ; `local_path` à tout ce qui est déjà sur le disque — ne mélangez jamais les deux.
+- Utilisez `present_to_user=true` avec parcimonie : uniquement pour le document que l'utilisateur a demandé ou sur lequel il doit agir.

package/concepts/fr/Tool-ProposeGoal.md

@@ -0,0 +1,43 @@
+# ProposeGoal
+
+Propose un objectif d'achèvement vérifiable pour la session. L'objectif est montré à l'utilisateur dans une boîte de dialogue d'approbation (par défaut) et, une fois défini, guide le reste de la conversation vers un résultat vérifiable.
+
+## Quand l'utiliser
+
+- La session a un état final concret qu'un évaluateur pourrait vérifier à partir de la conversation (p. ex. "all tests in test/auth pass").
+- Vous voulez l'accord explicite de l'utilisateur sur ce que « terminé » signifie avant d'entreprendre un travail substantiel.
+- Les propres mots de l'utilisateur ont déjà énoncé le résultat et vous voulez qu'il soit enregistré comme objectif de session.
+
+## Activation
+
+- Désactivé par défaut (drapeau de fonctionnalité côté serveur).
+- Exclu des sessions interactives et en arrière-plan.
+- Désactivé par la clé de paramètres `modelProposedGoals: "disabled"`.
+
+## Paramètres
+
+- `condition` (string, requis) : la condition d'achèvement, écrite de sorte qu'un évaluateur distinct puisse la vérifier à partir de la conversation (p. ex. "all tests in test/auth pass (bun test exits 0)"). Au maximum 500 caractères — l'utilisateur doit pouvoir lire la condition entière dans la boîte de dialogue d'approbation.
+- `ask_user` (boolean, optionnel) : s'il faut demander l'approbation de l'utilisateur avant que l'objectif ne soit défini. Défaut true (une boîte de dialogue d'approbation est affichée). Mettez false UNIQUEMENT lorsque les propres mots de l'utilisateur dans cette conversation ont énoncé ce résultat comme ce qu'il veut ; l'objectif est alors défini directement avec un avis visible, et l'utilisateur peut l'effacer avec `/goal clear`.
+
+## Exemples
+
+### Exemple 1 : proposer un objectif adossé à des tests
+
+```
+ProposeGoal(condition="npm run test exits 0 with the new catalog cases included")
+```
+
+L'utilisateur voit la condition dans une boîte de dialogue d'approbation et peut l'accepter, l'éditer ou la rejeter.
+
+### Exemple 2 : adopter directement le résultat énoncé par l'utilisateur
+
+```
+ProposeGoal(condition="the login form validates email format and shows an inline error", ask_user=false)
+```
+
+Valable uniquement parce que l'utilisateur a explicitement énoncé ce résultat plus tôt dans la conversation.
+
+## Notes
+
+- Gardez `condition` courte et objectivement vérifiable — les objectifs vagues ("make it better") vont à l'encontre du but.
+- `ask_user=false` est strictement limité aux résultats que l'utilisateur a lui-même énoncés ; tout le reste doit passer par la boîte de dialogue d'approbation.

package/concepts/fr/Tool-PushNotification.md

@@ -14,6 +14,12 @@ Envoie une notification de bureau depuis la session Claude Code en cours. Si Rem
 
 N'envoyez pas de notification pour des mises à jour de progression routinières en cours de tâche, ni pour confirmer que vous avez répondu à quelque chose que l'utilisateur vient clairement de demander et attend. Ne notifiez pas lorsqu'une tâche courte se termine — si l'utilisateur vient de la soumettre et attend, la notification n'apporte aucune valeur et érode la confiance dans les notifications futures. Penchez fortement vers l'absence d'envoi.
 
+## Activation
+
+- Désactivé par défaut (drapeau de fonctionnalité côté serveur).
+- La livraison passe par l'infrastructure hébergée par Anthropic — non disponible sur Amazon Bedrock, Claude Platform on AWS, Google Cloud ou Microsoft Foundry.
+- Le push téléphone nécessite en plus un client Remote Control connecté.
+
 ## Paramètres
 
 - `message` (chaîne, obligatoire) : le corps de la notification. Gardez-le sous 200 caractères ; les systèmes d'exploitation mobiles tronquent les chaînes plus longues. Commencez par ce sur quoi l'utilisateur agirait : "build failed: 2 auth tests" est plus utile que "task complete".

package/concepts/fr/Tool-REPL.md

@@ -0,0 +1,47 @@
+# REPL
+
+Exécute du JavaScript dans un contexte vm Node.js persistant au sein de la session. Le `await` de premier niveau est pris en charge, et les variables/fonctions définies lors d'un appel restent disponibles lors des appels suivants.
+
+## Quand l'utiliser
+
+- Calcul rapide, transformation de données ou manipulation de JSON plus faciles en code qu'en lignes de commande shell.
+- Scripting multi-étapes où l'état intermédiaire doit persister entre les appels (compteurs, résultats accumulés).
+- Sonder le comportement d'une API ou d'une bibliothèque de façon interactive avant de l'écrire dans un fichier.
+
+## Activation
+
+- Désactivé par défaut — définissez `CLAUDE_CODE_REPL=true` pour l'activer.
+- Dans les sessions terminal (`cli`) et claude.ai (`remote`), un drapeau de fonctionnalité côté serveur peut également l'activer.
+- Lorsqu'il est désactivé, REPL est masqué de la liste d'outils du modèle. Lorsqu'il est activé, `Read`, `Glob`, `Grep`, `Bash`, `PowerShell` et `NotebookEdit` sont remplacés par les raccourcis REPL.
+
+## Paramètres
+
+- `code` (string, requis) : code JavaScript à exécuter. Prend en charge le await de premier niveau. L'état persiste d'un appel à l'autre.
+- `description` (string, optionnel) : description claire et concise de ce que fait ce script à la voix active (5 à 10 mots), p. ex. "Trace upgrade message to its GrowthBook flag".
+- `timeout` (number, optionnel) : délai d'expiration en millisecondes. Défaut 30000 ; maximum 600000.
+
+## Exemples
+
+### Exemple 1 : calculer et réutiliser un état
+
+```
+REPL(code="const counts = new Map(); ['a','b','a'].forEach(k => counts.set(k, (counts.get(k)||0)+1)); counts.get('a')")
+```
+
+Renvoie `2` ; `counts` reste défini pour les appels REPL suivants dans la même session.
+
+### Exemple 2 : await de premier niveau avec un délai plus long
+
+```
+REPL(
+  code="const res = await fetch('https://example.com/api'); await res.json()",
+  description="Fetch example API and parse JSON",
+  timeout=60000
+)
+```
+
+## Notes
+
+- L'état est propre à la session : redémarrer la session efface toutes les définitions.
+- C'est un environnement JavaScript (Node) — utilisez Bash pour les commandes shell, les travaux lourds sur le système de fichiers ou les runtimes non JS.
+- Le code de longue durée doit définir un `timeout` explicite ; le défaut de 30 s tue tout ce qui est plus lent.

package/concepts/fr/Tool-ReadMcpResource.md

@@ -0,0 +1,32 @@
+# ReadMcpResource
+
+Lit une seule ressource exposée par un serveur MCP (Model Context Protocol) connecté, adressée par son URI.
+
+## Quand l'utiliser
+
+- Un serveur MCP annonce une ressource (fichier, enregistrement, document) dont vous avez besoin du contenu dans le contexte.
+- Vous disposez d'un URI de ressource concret — provenant de `ListMcpResources`, de la documentation du serveur ou d'un résultat d'outil précédent.
+
+## Activation
+
+- Toujours activé, mais non exposé à la liste d'outils du modèle — destiné à une utilisation thin-client / sidecar.
+
+## Paramètres
+
+- `server` (string, requis) : le nom du serveur MCP.
+- `uri` (string, requis) : l'URI de la ressource à lire.
+
+## Exemples
+
+### Exemple 1 : lire une ressource de serveur par URI
+
+```
+ReadMcpResource(server="github", uri="file:///repo/docs/architecture.md")
+```
+
+Renvoie le contenu de la ressource tel que fourni par le serveur MCP `github`.
+
+## Notes
+
+- Utilisez d'abord `ListMcpResources` si vous ne savez pas quelles ressources un serveur expose ; utilisez `ReadMcpResourceDir` pour les listages de type répertoire.
+- Le schéma d'URI est spécifique au serveur (`file://`, `https://`, schémas personnalisés) — vérifiez ce que le serveur cible annonce.

package/concepts/fr/Tool-ReadMcpResourceDir.md

@@ -0,0 +1,32 @@
+# ReadMcpResourceDir
+
+Liste les entrées d'une ressource de type répertoire exposée par un serveur MCP connecté, adressée par son URI.
+
+## Quand l'utiliser
+
+- Un serveur MCP organise ses ressources de façon hiérarchique et vous devez énumérer un niveau de cette hiérarchie.
+- Vous voulez parcourir avant de lire des ressources individuelles avec `ReadMcpResource`.
+
+## Activation
+
+- Toujours activé, mais non exposé à la liste d'outils du modèle — destiné à une utilisation thin-client / sidecar.
+
+## Paramètres
+
+- `server` (string, requis) : le nom du serveur MCP.
+- `uri` (string, requis) : l'URI de la ressource répertoire à lister.
+
+## Exemples
+
+### Exemple 1 : lister un répertoire de ressources
+
+```
+ReadMcpResourceDir(server="filesystem", uri="file:///project/src/")
+```
+
+Renvoie les entrées enfants que le serveur expose sous cet URI de répertoire.
+
+## Notes
+
+- Seuls les serveurs qui modélisent leurs ressources comme des répertoires prennent cela en charge ; les serveurs plats renverront une erreur ou un listage vide — repliez-vous sur `ListMcpResources`.
+- Combinez avec `ReadMcpResource` pour descendre dans les entrées qui semblent pertinentes.

package/concepts/fr/Tool-ReadNotifications.md

@@ -0,0 +1,27 @@
+# ReadNotifications
+
+Lit les notifications en file d'attente pour l'assistant dans la session courante — activité GitHub sur les PR suivies (`github_webhook`), déclenchements planifiés (`trigger_fire`) et messages provenant d'autres sessions Claude (`mcp_send_message`).
+
+## Quand l'utiliser
+
+- Vous avez été notifié que quelque chose s'est produit — une PR suivie a été mise à jour, un déclencheur planifié s'est déclenché, une autre session vous a envoyé un message — et vous avez besoin de la charge utile réelle.
+- Vider un arriéré : les gros lots sont renvoyés en plusieurs parties, continuez donc à appeler jusqu'à ce que le résultat indique 0 `remaining`.
+
+## Paramètres
+
+Cet outil ne prend aucun paramètre.
+
+## Exemples
+
+### Exemple 1 : vider les notifications en attente
+
+```
+ReadNotifications()
+```
+
+Renvoie les notifications en file d'attente, les plus anciennes d'abord. Le résultat inclut un compte `remaining` des notifications encore en attente après cette lecture — appelez à nouveau l'outil pour les lire.
+
+## Notes
+
+- Les lectures sont limitées en taille : un appel suivant renvoie le reste de la MÊME file (plus tout ce qui est nouvellement arrivé), pas seulement les nouvelles arrivées. Bouclez jusqu'à ce que `remaining` soit 0.
+- Les notifications proviennent des webhooks GitHub sur les PR suivies, des déclencheurs planifiés et des messages d'autres sessions Claude ; il n'y a pas de paramètre de filtrage dans la version courante.

package/concepts/fr/Tool-RemoteTrigger.md

@@ -10,6 +10,13 @@ Appelle l'API de déclencheurs distants de claude.ai pour gérer l'exécution de
 - Lister ou auditer tous les déclencheurs actuels pour examiner leur configuration et leur état
 - Mettre à jour les paramètres d'un déclencheur, tels que le calendrier, la charge utile ou la description, sans avoir à le recréer
 
+## Activation
+
+- Nécessite un forfait claude.ai Pro, Max, Team ou Enterprise.
+- Non disponible sur Amazon Bedrock, Claude Platform on AWS, Google Cloud ou Microsoft Foundry.
+- Nécessite des drapeaux de fonctionnalité côté serveur et les paramètres de politique `allow_remote_sessions` / `allow_routines`.
+- Pas pour les sessions distantes elles-mêmes.
+
 ## Paramètres
 
 - `action` (string, requis) : l'opération à effectuer — l'une des valeurs `list`, `get`, `create`, `update` ou `run`

package/concepts/fr/Tool-ScheduleWakeup.md

@@ -10,6 +10,11 @@ Planifie le moment où reprendre le travail en mode dynamique `/loop`. L'outil p
 - Pour exécuter une boucle autonome sans prompt utilisateur — passer le sentinel littéral `<<autonomous-loop-dynamic>>` comme `prompt`
 - Pour interroger un processus dont l'état est sur le point de changer (utiliser un délai court pour maintenir le cache chaud)
 
+## Activation
+
+- Non disponible sur Amazon Bedrock, Claude Platform on AWS, Google Cloud Agent Platform ou Microsoft Foundry.
+- Également désactivé lorsque la récupération des drapeaux de fonctionnalité est désactivée (variables d'environnement de télémétrie/trafic).
+
 ## Paramètres
 
 - `delaySeconds` (nombre, requis) : Secondes avant la reprise. Le runtime limite automatiquement la valeur à `[60, 3600]`, il n'est donc pas nécessaire de la limiter manuellement.

package/concepts/fr/Tool-SearchMcpRegistry.md

@@ -0,0 +1,31 @@
+# SearchMcpRegistry
+
+Recherche dans le registre de connecteurs MCP par mot-clé pour découvrir des connecteurs susceptibles d'aider à accomplir la tâche.
+
+## Quand l'utiliser
+
+- La tâche bénéficierait d'un service externe (une base de données, un suivi d'issues, une API SaaS) et vous voulez vérifier s'il existe un connecteur MCP pour cela.
+- L'utilisateur nomme un produit et demande de le connecter — recherchez dans le registre un connecteur correspondant.
+
+## Activation
+
+- Disponible uniquement dans les sessions distantes (claude.ai) sur l'API first-party.
+
+## Paramètres
+
+- `keywords` (array de strings, requis) : expressions de mots-clés décrivant l'intention de l'utilisateur ou un produit nommé. 1 à 8 éléments, 1 à 64 caractères chacun.
+
+## Exemples
+
+### Exemple 1 : trouver un connecteur pour un produit nommé
+
+```
+SearchMcpRegistry(keywords=["linear", "issue tracker"])
+```
+
+Renvoie les entrées du registre dont les connecteurs correspondent aux mots-clés. Résolvez les détails complets des connecteurs avec `SuggestConnectors`.
+
+## Notes
+
+- Lecture seule et sûr en concurrence ; les résultats sont plafonnés en taille.
+- La recherche n'installe rien — c'est purement de la découverte.

package/concepts/fr/Tool-SendFeedback.md

@@ -0,0 +1,38 @@
+# SendFeedback
+
+Envoie des retours structurés sur Claude Code à Anthropic — rapports de bug, idées de fonctionnalités ou capacités manquantes — sans quitter la session.
+
+## Quand l'utiliser
+
+- L'utilisateur demande de signaler un bug ou d'envoyer des retours sur Claude Code lui-même.
+- Vous rencontrez un défaut produit manifeste (commande cassée, comportement erroné, plantage) qui mérite d'être signalé.
+- L'utilisateur décrit une fonctionnalité qu'il aimerait voir exister (une idée ou une capacité manquante).
+
+## Paramètres
+
+- `type` (string, requis) : l'une des valeurs `bug`, `idea`, `missing_capability`.
+- `title` (string, requis) : résumé court et précis du problème en une ligne.
+- `details` (string, requis) : puces libellées, dans l'ordre : **What happened:** (observé vs attendu, texte d'erreur exact s'il est court) ; **What the user said:** (cité, ou "User didn't comment; observed by the model.") ; **Repro:** (étapes minimales) ; **Evidence:** (IDs de requête, horodatages, chemins, versions — omettez s'il n'y en a pas) ; éventuellement un **Cause:** final uniquement s'il est vérifié en session. Une à trois lignes par puce ; pas de paragraphes narratifs, pas de spéculation, pas de secrets.
+- `area` (string, optionnel) : étiquette courte nommant la partie de Claude Code concernée (p. ex. "hooks config", "/help", "file editing"). Laissez vide si ce n'est pas clair.
+- `failure_mode` (string, optionnel) : pour les rapports de comportement du modèle, le mode d'échec le plus proche (p. ex. `instruction_following`, `repetition_and_looping`, `context_and_memory`, `stopping_short` ou `other`). Omettez uniquement lorsque le rapport est un pur bug produit/outil.
+- `task_category` (string, optionnel) : ce que la session faisait lorsque le problème est survenu : `code_edit`, `debug`, `explain`, `plan`, `shell`, `search`, `review` ou `other`.
+
+## Exemples
+
+### Exemple 1 : signaler un bug produit
+
+```
+SendFeedback(
+  type="bug",
+  title="/export truncates the last message",
+  details="**What happened:** exported transcript is missing the final assistant message.\n**What the user said:** \"the last reply never shows up in the file\".\n**Repro:** run /export after any multi-turn session.\n**Evidence:** v2.1.233, macOS.",
+  area="/export",
+  task_category="other"
+)
+```
+
+## Notes
+
+- N'incluez jamais de secrets, de jetons ou de données utilisateur privées dans `details`.
+- Citez les mots de l'utilisateur lorsqu'ils sont disponibles ; sinon indiquez que le modèle a observé le problème.
+- Gardez le rapport factuel — la spéculation sur la cause profonde appartient à `**Cause:**` uniquement lorsqu'elle est vérifiée en session.

package/concepts/fr/Tool-SendFile.md

@@ -0,0 +1,36 @@
+# SendFile
+
+Envoie un ou plusieurs fichiers à une autre session Claude Code — un pair listé par `ListAgents`, ou une adresse de session explicite.
+
+## Quand l'utiliser
+
+- Une session pair a besoin d'un fichier de votre répertoire de travail (un rapport, un patch, une fixture) pour poursuivre sa propre tâche.
+- Vous coordonnez un travail entre sessions et voulez transmettre des artefacts, pas seulement du texte (utilisez `SendMessage` pour le texte).
+
+## Activation
+
+- Le transfert de fichiers inter-sessions doit être disponible dans la session ; lorsqu'il ne l'est pas, la validation échoue avec "Cross-session file transfer is not available in this session."
+- Contrôlé par les mêmes conditions de messagerie inter-sessions que `ListAgents` (drapeaux de fonctionnalité côté serveur, désactivés par défaut).
+
+## Paramètres
+
+- `to` (string, requis) : destinataire — un nom de session pair provenant de `ListAgents`, ou une adresse explicite `uds:<socket>` / `bridge:<session id>`.
+- `files` (array de strings, requis) : chemins de fichiers (absolus ou relatifs au cwd) à envoyer. Passez toujours un array, même pour un seul fichier. 1 à 16 fichiers, 30 Mio maximum chacun.
+- `message` (string, optionnel) : message court livré avec les fichiers.
+
+## Exemples
+
+### Exemple 1 : envoyer un rapport à une session pair
+
+```
+SendFile(
+  to="teammate-a",
+  files=["./dist/report.html"],
+  message="The analysis you asked for"
+)
+```
+
+## Notes
+
+- Les transferts vers des machines distantes peuvent nécessiter une approbation supplémentaire.
+- La lecture du contenu du fichier fait partie de l'envoi — refusée si les lectures de fichiers sont désactivées par des règles de permission.

package/concepts/fr/Tool-SendMessage.md

@@ -10,6 +10,11 @@ Transmet un message d'un membre d'équipe à un autre au sein d'une équipe acti
 - Répondre à une invite de protocole telle qu'une demande d'arrêt ou une demande d'approbation de plan du chef d'équipe.
 - Boucler la boucle à la fin d'une tâche déléguée afin que le chef puisse marquer l'élément terminé.
 
+## Activation
+
+- Contrôlé par les mêmes conditions de messagerie inter-sessions que `ListAgents` (drapeaux de fonctionnalité côté serveur, désactivés par défaut).
+- Les coéquipiers nécessitent en plus l'activation des équipes d'agents expérimentales.
+
 ## Paramètres
 
 - `to` (string, requis) : le `name` du coéquipier cible tel qu'enregistré dans l'équipe, ou `*` pour diffuser à tous les coéquipiers à la fois.

package/concepts/fr/Tool-SendUserFile.md

@@ -0,0 +1,38 @@
+# SendUserFile
+
+Envoie un ou plusieurs fichiers à l'utilisateur — artefacts générés, captures d'écran, rapports — avec un contrôle sur la façon dont le client les présente.
+
+## Quand l'utiliser
+
+- Vous avez produit un fichier dont l'utilisateur a besoin (un rapport, une image, une page HTML) et vous voulez le mettre en avant, pas seulement mentionner son chemin.
+- Répondre avec une pièce jointe (`status="normal"`), ou mettre en avant de façon proactive quelque chose que l'utilisateur n'a pas demandé mais qu'il doit voir maintenant (`status="proactive"`).
+
+## Activation
+
+- Disponible uniquement lorsqu'un client Remote Control est connecté, ou lorsque la session s'exécute dans un environnement cloud géré (p. ex. Claude Code sur le web).
+- Non disponible sur Amazon Bedrock, Google Cloud ou Microsoft Foundry.
+- Nécessite que la session autorise l'envoi de fichiers (capacité contrôlée par des paramètres/un drapeau de fonctionnalité) ; non proposé en mode brief.
+
+## Paramètres
+
+- `files` (array de strings, requis) : chemins de fichiers (absolus ou relatifs au cwd) à envoyer à l'utilisateur. Passez toujours un array, même pour un seul fichier.
+- `caption` (string, optionnel) : légende courte pour le ou les fichiers.
+- `status` (string, requis) : `proactive` lorsque vous mettez en avant un fichier que l'utilisateur n'a pas demandé et qu'il doit voir maintenant — un artefact généré, un rapport terminé ; `normal` lorsque vous répondez à quelque chose que l'utilisateur vient de dire.
+- `display` (string, optionnel) : `render` ouvre le fichier en ligne dans le panneau latéral (HTML, SVG, Mermaid, images, PDF) ; `attach` n'affiche qu'une carte de téléchargement (livrables que l'utilisateur enregistrera et ouvrira ailleurs). Omettez pour laisser le client décider selon le type de fichier.
+
+## Exemples
+
+### Exemple 1 : livrer un rapport généré
+
+```
+SendUserFile(
+  files=["./out/weekly-report.html"],
+  caption="Weekly usage report",
+  status="proactive",
+  display="render"
+)
+```
+
+## Notes
+
+- Choisissez `display="attach"` pour les fichiers que l'utilisateur enregistre et ouvre dans une autre application ; `render` pour tout ce qu'il doit regarder immédiatement.

package/concepts/fr/Tool-SendUserMessage.md

@@ -0,0 +1,38 @@
+# SendUserMessage
+
+Envoie un message à l'utilisateur — le canal de sortie visible principal dans les sessions de style brief. Aussi connu sous son ancien alias `Brief`.
+
+## Quand l'utiliser
+
+- Répondre à quelque chose que l'utilisateur vient de dire (`status="normal"`).
+- Mettre en avant de façon proactive quelque chose que l'utilisateur n'a pas demandé et qu'il doit voir maintenant — une tâche qui se termine pendant son absence, un blocage que vous avez rencontré, une mise à jour de statut non sollicitée (`status="proactive"`).
+
+## Activation
+
+- Masqué par défaut dans les sessions interactives ; la plupart des sessions CLI interactives s'adressent directement à l'utilisateur à la place.
+- Activé en mode brief ou via des drapeaux de fonctionnalité côté serveur.
+
+## Paramètres
+
+En mode brief :
+
+- `message` (string, requis) : le message pour l'utilisateur. Prend en charge le formatage markdown.
+- `attachments` (array, optionnel) : pièces jointes affichées à côté du message. Chaque entrée est soit un chemin de fichier (absolu ou relatif au cwd) pour un fichier lisible localement, soit un objet `{file_uuid, file_name, size, is_image}` pré-résolu obtenu d'un outil de périphérique tel que `attach_file`.
+- `status` (string, requis) : `proactive` pour les mises à jour non sollicitées dont l'utilisateur a besoin maintenant ; `normal` lorsque vous répondez à l'utilisateur.
+
+Dans les builds non brief, seul `message` est disponible.
+
+## Exemples
+
+### Exemple 1 : avis d'achèvement proactif
+
+```
+SendUserMessage(
+  message="The migration finished — 42 files updated, tests green.",
+  status="proactive"
+)
+```
+
+## Notes
+
+- Utilisez `proactive` avec parcimonie — il est destiné aux choses qui nécessitent réellement l'attention de l'utilisateur maintenant.

package/concepts/fr/Tool-SuggestConnectors.md

@@ -0,0 +1,28 @@
+# SuggestConnectors
+
+Résout les charges utiles complètes des connecteurs pour les valeurs `directoryUuid` renvoyées par `SearchMcpRegistry`, afin que l'utilisateur puisse se voir proposer des connecteurs concrets à activer.
+
+## Quand l'utiliser
+
+- Après que `SearchMcpRegistry` renvoie des connecteurs candidats, pour récupérer leurs détails complets en vue de leur présentation.
+
+## Activation
+
+- Disponible uniquement dans les sessions distantes (claude.ai) sur l'API first-party.
+
+## Paramètres
+
+- `uuids` (array de strings, requis) : valeurs `directoryUuid` ou `server_id` à résoudre. 1 à 32 éléments, 1 à 64 caractères chacun.
+
+## Exemples
+
+### Exemple 1 : résoudre deux résultats du registre
+
+```
+SuggestConnectors(uuids=["d290f1ee-6c54-4b01-90e6-d701748f0851", "a1b2c3d4-0000-4000-8000-abcdefabcdef"])
+```
+
+## Notes
+
+- Ne devinez jamais les UUID — ne résolvez que les identifiants renvoyés par `SearchMcpRegistry`.
+- L'outil ne connecte rien lui-même ; l'activation d'un connecteur se fait hors bande.