Skip to content

tool

The search, universal_search, and (opt-in) add_documents, create_index, and sync_index Mastra tools.

All three read the shared runtime primed by the plugin, so a tool spread into an agent uses the deployment’s default index, columns, page size, and mode without any per-tool wiring. They run under the caller’s OBO scope (the client resolves the execution context’s workspace client), so search runs as the requesting user and Unity Catalog ACLs apply.

The same tools are exposed to AppKit’s own agents through the plugin’s ToolProvider (see plugin.ts); this module is the Mastra half.