Crate meerkat_tools 

meerkat-tools - Tool validation and dispatch for Meerkat

This crate provides tool registry and dispatch functionality.

Built-in Tools

The builtin module provides built-in tools for task management and utilities. Use CompositeDispatcher to combine built-in tools with external MCP tools.

use meerkat_tools::{
    CompositeDispatcher, BuiltinToolConfig, FileTaskStore,
    find_project_root, ensure_rkat_dir,
};

let project_root = find_project_root(&std::env::current_dir().unwrap())
    .expect("no .rkat directory found");
ensure_rkat_dir(&project_root).unwrap();
let store = Arc::new(FileTaskStore::in_project(&project_root));
let dispatcher = CompositeDispatcher::new(
    store,
    &BuiltinToolConfig::default(),
    Some(project_root),
    None,
    None,
    None,
)?;

Re-exports

pub use builder::CommsDispatcherConfig;

pub use builder::McpDispatcherConfig;

pub use builder::BuiltinDispatcherConfig;

pub use builder::ToolDispatcherBuilder;

pub use builder::build_builtin_dispatcher;

pub use builtin::CommsToolSurface;

pub use builtin::BuiltinTool;

pub use builtin::BuiltinToolConfig;

pub use builtin::BuiltinToolEntry;

pub use builtin::BuiltinToolError;

pub use builtin::CompositeDispatcher;

pub use builtin::CompositeDispatcherError;

pub use builtin::EnforcedToolPolicy;

pub use builtin::MemoryTaskStore;

pub use builtin::ResolvedToolPolicy;

pub use builtin::TaskStore;

pub use builtin::ToolMode;

pub use builtin::ToolPolicyLayer;

pub use builtin::FileTaskStore;

pub use builtin::ensure_rkat_dir;

pub use builtin::ensure_rkat_dir_async;

pub use builtin::find_project_root;

pub use control_plane::CatalogControlDispatcher;

pub use control_plane::CatalogControlVisibilityProvider;

pub use dispatcher::ToolDispatcher;

pub use dispatcher::EmptyToolDispatcher;

pub use dispatcher::FilteredDispatcher;

pub use error::DispatchError;

pub use registry::validate_tool_def;

pub use schema::empty_object_schema;

pub use schema::schema_for;

pub use timeout::ToolTimeoutPolicy;

Modules

builder

Shared tool dispatcher builders.

builtin

Built-in tools for Meerkat

control_plane

dispatcher

Tool dispatcher implementation

error

Tool error types for Meerkat.

registry

Tool registry for tracking and validating tools

schema

Shared JSON schema helpers for tool definitions.

timeout

Single typed owner for tool-execution timeout policy.

Structs

CommsToolDispatcher

Tool dispatcher that provides comms tools.

DynCommsToolDispatcher

NoOpDispatcher

Enums

ToolError

Error returned by tool dispatch operations.

ToolValidationError

Errors that can occur during tool validation