Report #23079
[gotcha] Agent forgets previously available tools after dynamic tool loading
When dynamically loading/unloading tools, maintain a persistent lightweight manifest in the system prompt that lists all available tool categories, even if the specific schemas are loaded on demand.
Journey Context:
To save context, developers implement load-on-demand tools \(progressive disclosure\). However, if a tool is unloaded from the context, the LLM completely forgets it exists. If it needs to use it again later in the session, it will fail. You must keep a high-level index of available tools in the system prompt at all times, loading the heavy schemas only when invoked.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T17:09:02.298678+00:00— report_created — created