O hook agent sinaliza runtimes de agente que entram em loop sem limite de turnos, de orçamento ou de tempo, a brecha de autonomia descontrolada que transforma uma entrada manipulada em custo ilimitado ou em escalada de prompt injection. Ele reconhece a linguagem e cobre os dois ecossistemas de frameworks de agentes: JavaScript (o runtime query do SDK de agentes do Claude) e Python (LangChain, LangGraph, CrewAI, OpenAI Agents). Ele é o engine determinístico por trás da especialização llm, e você mesmo pode executá-lo no modo scan ou check.

Como executar

Varrer o código

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

Verificar uma chamada

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

Cada linha em Uncapped agent loops found é, em um arquivo que importa um SDK de agentes, ou o runtime query do SDK de agentes do Claude chamado sem limite de turnos, de orçamento ou de tempo (JavaScript, sem limite por padrão), ou a remoção explícita do limite padrão de um framework, como max_iterations=None / max_turns=None (Python, com limite por padrão). Qualquer um dos dois termina com código diferente de zero. No Vercel AI SDK, generateText/streamText usam por padrão um único passo (stopWhen: stepCountIs(1)), então uma chamada simples ali não entra em loop e não é sinalizada, e um db.query(...) comum nunca é confundido com uma chamada de agente. Uma execução sem achados imprime no uncapped agent loops found.

Como ler o veredito

Veredito	Significado
uncapped	Uma chamada ao runtime query sem limite (JS), ou a remoção explícita de um limite (=None, Py).
safe	Uma chamada query que define um limite, uma geração de passo único ou a chamada de um framework com limite por padrão.
invalid	O trecho não contém nenhuma chamada de agente reconhecível para avaliar.

Opções da CLI

Opção	Valor	Descrição
--pattern	um trecho de código	Verifica uma chamada. Repita para verificar várias, com um veredito por linha.
--lang	uma linguagem	Obrigatória com --pattern: javascript ou python.
--dir	um diretório	Restringe a varredura a um diretório. Pode ser repetida e combinada com --file.
--file	um arquivo	Restringe a varredura a um único arquivo. Pode ser repetida e combinada com --dir.

Sem nenhuma opção, ele varre o projeto inteiro. --pattern exige --lang e não pode ser combinada com --dir nem com --file.

Melhor esforço, não exaustivo

Um loop de agente feito à mão, em qualquer linguagem, está além do alcance de uma varredura estática. Trate isso como uma base sólida, não como um inventário completo.

dica

O hook decide apenas o limite: o escopo de capacidades, a mistura de níveis de confiança e a autorização são questões de julgamento que a especialização llm continua cobrindo.

Perguntas frequentes

Um agente sem limite pode ser levado a recursão, custo ou escalada de prompt injection sem fim. Definir maxTurns/maxBudgetUsd/stopWhen/signal impõe esse limite, e o hook agent sinaliza uma chamada ao runtime query que não define nenhum deles.