meerkat-tools 0.4.1

Tool validation and dispatch for Meerkat
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

//! Sub-agent tools for hierarchical agent workflows
//!
//! This module provides tools that allow LLM agents to spawn and manage sub-agents,
//! enabling hierarchical agent workflows. Sub-agents can use different providers/models
//! (e.g., Claude spawning Gemini/GPT).
//!
//! ## Key Semantics
//!
//! - **Spawn**: Create sub-agent with clean context (just the prompt)
//! - **Fork**: Create sub-agent with continued context (inherits full conversation history)
//!
//! ## Available Tools
//!
//! - `agent_spawn`: Create sub-agent with clean context
//! - `agent_fork`: Clone current agent with full history
//! - `agent_status`: Get status/output of sub-agent by ID
//! - `agent_cancel`: Cancel a running sub-agent
//! - `agent_list`: List all sub-agents with their states
//!
//! Note: For sending messages to sub-agents, use `comms_send` instead of a dedicated steer tool.

mod config;
mod runner;
mod state;

mod cancel;
mod fork;
mod list;
mod spawn;
mod status;
mod tool_set;

pub use config::{SubAgentConfig, SubAgentError};
#[cfg(feature = "comms")]
pub use meerkat_comms::runtime::ParentCommsContext;
pub use runner::{
    DynSubAgentSpec, SubAgentHandle, SubAgentRunnerError, SubAgentSpec, create_fork_session,
    create_spawn_session, spawn_sub_agent, spawn_sub_agent_dyn,
};
#[cfg(feature = "comms")]
pub use runner::{
    SubAgentCommsConfig, create_child_comms_config, create_child_peer_entry,
    create_child_trusted_peers, setup_child_comms,
};
pub use state::SubAgentToolState;
pub use tool_set::SubAgentToolSet;

pub use cancel::AgentCancelTool;
pub use fork::AgentForkTool;
pub use list::AgentListTool;
pub use spawn::AgentSpawnTool;
pub use status::AgentStatusTool;