Tools
Tools are reusable, versioned definitions for external actions or data access. They have a stable tool_key, a version history, and optional capability metadata (toolRecordSchema, toolVersionSchema).
API
GET /api/tools/GET /api/tools/:id- list and detail for an org.POST /api/tools,POST /api/tools/:id/versions,PATCH /api/tools/:id- create, version, and update.
Capabilities
Optional toolCapabilitySchema on records and versions describes category, accessMode, sideEffectProfile, riskLevel, domainTags, and intendedUse. This metadata is used in UI policy surfaces and echoed in run detail when tools execute.