E-TOOLS-005
Your catalog extracted more tools than the agent can actually use. Nothing is broken. This names the gap so you decide, instead of finding out later when the assistant cannot answer a question and will not say why.check tools/live-surface · error_code E-TOOLS-005 · doctor exits 0 (warning only)
What you’re seeing
A host tool’s final state is three layers stacked in order: the extracted skeleton in.vendo/tools.json, then the AI judge’s call in
.vendo/judgments.json, then your own .vendo/overrides.json, which wins last.
Doctor compares the number of tools that survive that stack against the number
in tools.json. When they differ, it names each missing tool and the layer that
turned it off.
Why a tool is off
Graded for operators or staff. The judge decides who a tool is for. A tool gradedoperator or internal is switched off for the embedded agent by
default. This is deliberate and fail-closed. An endpoint that returns your whole
customer book with revenue is not something an end user’s assistant should read,
so Vendo hides it unless you say otherwise.
Turned off in judgments.json. The judge read the handler and disabled the
tool outright.
Turned off in overrides.json. You did this. Nothing to explain.
The fix
Usually there is nothing to fix. A staff tool staying hidden is the system working. If you have looked at a tool and you want the agent to have it, say so explicitly in.vendo/overrides.json. Your file is the last word, so this beats
both the grade and the judge:
vendo sync. Then the judge can grade it for end users
honestly, and you will not need an override at all.
Related errors
E-TOOLS-001
every tool disabled
E-TOOLS-002
tool surface is empty
E-TOOLS-003
tools ungraded
E-TOOLS-004
tools declare no shape