Le hook agent signale les runtimes d'agent qui bouclent sans limite de tours, de budget ni de temps, la faille d'autonomie incontrôlée qui transforme une entrée forgée en coût illimité ou en escalade par injection de prompt. Il est adapté au langage et couvre les deux écosystèmes de frameworks d'agents : JavaScript (le runtime query du SDK d'agent de Claude) et Python (LangChain, LangGraph, CrewAI, OpenAI Agents). C'est le moteur déterministe derrière la spécialisation llm, que vous pouvez exécuter vous-même en mode scan ou check.
Exécution
- Analyser la base de code
- Vérifier un appel
npx lagune read agent # scans the whole project
npx lagune read agent --dir src/ai # scans a directory
npx lagune read agent --file chat.ts # scans a single file
npx lagune read agent --lang javascript --pattern 'query({ prompt })' # => uncapped
npx lagune read agent --lang javascript --pattern 'query({ prompt, options: { maxTurns: 5 } })' # => safe
npx lagune read agent --lang python --pattern 'AgentExecutor(agent=a, max_iterations=None)' # => uncapped
Chaque ligne sous Uncapped agent loops found correspond, dans un fichier qui importe un SDK d'agent, soit au runtime query du SDK d'agent de Claude appelé sans limite de tours, de budget ni de temps (JavaScript, illimité par défaut), soit à la suppression explicite de la limite par défaut d'un framework, comme max_iterations=None / max_turns=None (Python, limité par défaut). Dans les deux cas, le hook se termine avec un code non nul. generateText/streamText du Vercel AI SDK se limitent par défaut à une seule étape (stopWhen: stepCountIs(1)), donc un appel nu ne peut pas y boucler et n'est pas signalé, et un db.query(...) ordinaire n'est jamais pris pour un appel d'agent. Une analyse propre affiche no uncapped agent loops found.
Lire le verdict
| Verdict | Signification |
|---|---|
uncapped | Un appel au runtime query sans limite (JS), ou une suppression explicite de la limite (=None, Py). |
safe | Un appel query qui fixe une limite, une génération en une seule étape ou un appel de framework limité par défaut. |
invalid | L'extrait ne contient aucun appel d'agent reconnaissable à juger. |
Options de la CLI
| Option | Valeur | Description |
|---|---|---|
--pattern | un extrait de code | Vérifie un appel. Répétez-la pour en vérifier plusieurs, un verdict par ligne. |
--lang | un langage | Requise avec --pattern : javascript ou python. |
--dir | un répertoire | Limite l'analyse à un répertoire. Peut être répétée et combinée avec --file. |
--file | un fichier | Limite l'analyse à un seul fichier. Peut être répétée et combinée avec --dir. |
Sans option, il analyse tout le projet. --pattern exige --lang et ne peut pas être combinée avec --dir ou --file.
Une boucle d'agent écrite à la main, dans n'importe quel langage, échappe à une analyse statique. Considérez ceci comme un socle solide, pas comme un inventaire complet.
Le hook ne tranche que la limite : le périmètre des capacités, le mélange de niveaux de confiance et l'autorisation relèvent du jugement que couvre toujours la spécialisation llm.
Questions fréquentes
Un agent sans limite peut être entraîné dans une récursion, un coût ou une escalade par injection de prompt sans fin. Fixer maxTurns/maxBudgetUsd/stopWhen/signal le borne, et le hook agent signale un appel au runtime query qui n'en fixe aucun.