agent フックは、ターン数、予算、時間のどれにも上限を設けずにループするエージェントランタイムを指摘します。自律動作の暴走を招くこの穴があると、細工された入力ひとつで、コストが際限なく膨らんだり、プロンプトインジェクションがエスカレートしたりします。言語を識別して動作し、JavaScript（Claude エージェント SDK の query ランタイム）と Python（LangChain、LangGraph、CrewAI、OpenAI Agents）という 2 つのエージェントフレームワークのエコシステムに対応しています。また、llm 専門知識 を支える決定論的なエンジンでもあり、scan モードまたは check モードで自分で実行することもできます。
実行方法
- コードベースをスキャン
- 呼び出しをチェック
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
Uncapped agent loops found の下に並ぶ各行は、エージェント SDK をインポートしているファイル内で、Claude エージェント SDK の query ランタイムをターン数、予算、時間のどれにも上限を設けずに呼び出している箇所（JavaScript、デフォルトでは上限なし）か、max_iterations=None / max_turns=None のようにフレームワークのデフォルトの上限を明示的に外している箇所（Python、デフォルトでは上限あり）です。どちらが見つかっても、0 以外の終了コードで終了します。Vercel AI SDK の generateText/streamText はデフォルトで 1 ステップしか実行しない（stopWhen: stepCountIs(1)）ため、そのまま呼び出してもループせず、指摘されません。また、通常の db.query(...) がエージェントの呼び出しと誤認されることもありません。何も見つからなければ no uncapped agent loops found と出力します。
判定の読み方
| 判定 | 意味 |
|---|---|
uncapped | 上限のない query ランタイムの呼び出し（JS）、または上限の明示的な解除（=None、Py）。 |
safe | 上限を設定した query の呼び出し、1 ステップだけの生成、またはデフォルトで上限のあるフレームワークの呼び出し。 |
invalid | 判定できるエージェントの呼び出しがコードスニペットに見当たらない。 |
CLI オプション
| オプション | 値 | 説明 |
|---|---|---|
--pattern | コードスニペット | 1 つの呼び出しをチェックする。繰り返し指定すると複数をチェックし、1 行に 1 つずつ判定を出力する。 |
--lang | 言語 | --pattern を使うときは必須：javascript または python。 |
--dir | ディレクトリ | スキャン対象をディレクトリに絞る。繰り返し指定でき、--file と併用できる。 |
--file | ファイル | スキャン対象を 1 つのファイルに絞る。繰り返し指定でき、--dir と併用できる。 |
オプションを指定しなければ、プロジェクト全体をスキャンします。--pattern には --lang が必要で、--dir や --file とは併用できません。
自前で実装したエージェントループは、どの言語で書かれていても静的スキャンでは捉えられません。完全な一覧ではなく、確かな最低ラインとして扱ってください。
フックが判定するのは上限だけで、機能の範囲の絞り込み、信頼レベルの混在、認可といった判断は、引き続き llm 専門知識 が担います。
よくある質問
上限のないエージェントは、際限のない再帰やコスト、プロンプトインジェクションのエスカレーションへと誘導されるおそれがあります。maxTurns/maxBudgetUsd/stopWhen/signal を設定すれば歯止めがかかり、agent フックはどれも設定していない query ランタイムの呼び出しを指摘します。