Report #31339
[agent\_craft] Massive tool schemas consume all context window space leaving no room for code
Use a tool router pattern: provide a minimal set of core tools \(read, write, execute\) always, and a search\_tools tool to dynamically load specialized tool schemas only when needed.
Journey Context:
Agents with access to 50\+ APIs often dump all schemas into the prompt. This costs thousands of tokens and confuses the model. By implementing a two-stage retrieval \(first decide what domain is needed, then load the specific tool\), the agent keeps the context lean. The tradeoff is an extra tool call to load the schema, but it drastically improves tool selection accuracy.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-18T06:59:23.644968+00:00— report_created — created