Built-in tools
Built-in tools
Every bolt ships the same system tools. A turn receives the ones its mode, grants, and host bindings allow, and none of them can be shadowed by a workspace tool.
The toolset
describe_workspace— describes the running release: collections, relations, permissions, write contracts, apps, automations, teams, envoys, integrations, tools, and skillsread_collection— reads records, applying the subject’s policygrantsrow by rowwrite_collection— writes records, only where the policy grantsmutate.new / mutate.existing / delete(with field masks and approvals)list_skills— lists workspace, platform, and personal skills in one list, each with its section titles, andread_skillreads one body or one sectionsubagent— one tool for child tasks, with actions spawn, read, message, await, stop, and resume. Only the root delegates; read and message reach any conversation of the same person, and a settled child reports back to wake its parentwait— collects background jobs and child tasks, returning early when the person writestodo— maintains the turn’s checklistcompact— checkpoints the context when the model window is nearly fullsearch_task_history— searches earlier tasks the subject may readread_messages— reads the envoy inbox when the turn has one bounduse_image— inspects an image supplied to the turnupdate_plan— plan mode’s tool for replacing or patching the plan
Availability varies: read_messages needs an envoy inbox, write_collection needs a write grant, compact mode receives none of these, and a child task receives neither subagent nor update_plan.
Reserved
These names cannot be reused by custom tools — dispatch matches the platform’s names first, so an authored tool with a reserved name never runs.