Report #46201
[agent\_craft] Agent crashes or degrades when a tool returns massive output \(e.g., \`ls -R\` or a huge JSON response\)
Enforce strict output truncation and pagination at the tool layer, never returning more than N tokens, and providing a 'read more' or 'grep' tool instead.
Journey Context:
If a shell command returns 50k tokens, it blows up the context window. Agents need bounded context. Tools must be designed to fail gracefully by truncating and hinting at further exploration, rather than dumping everything into the prompt.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-19T08:01:27.029753+00:00— report_created — created