Tools
Tools
Discover, inspect, and invoke tool plugins through /v1/tools.
Catalog first
client.tools.list() (GET /v1/tools) returns the plugin catalog and client.tools.get(pluginId) (GET /v1/tools/{pluginId}) reads one plugin definition. Reads need seatool:read.
const catalog = await client.tools.list();
const plugin = await client.tools.get("image.caption");Invoke a tool
client.tools.invoke(pluginId, toolName, body?) posts to /v1/tools/{pluginId}/{toolName}/invoke and requires tool:invoke. The body is { input, version?, mode? }.
const result = await client.tools.invoke("image.caption", "caption_image", {
input: { imageUrl: "https://example.com/image.png" },
});