Skip to main content

Crate caliban_tools_builtin

Crate caliban_tools_builtin 

Source
Expand description

Built-in tools for the caliban agent harness.

Each tool implements caliban_agent_core::Tool with a JSON Schema for its input. All tools share a WorkspaceRoot for path resolution.

Modules are grouped by capability:

  • fs — filesystem tools (Read, Write, Edit, MultiEdit, NotebookEdit).
  • shell — shell execution (Bash) plus background-job tools.
  • webWebFetch / WebSearch.
  • memory — auto-memory ReadMemoryTopic / WriteMemoryTopic.
  • agent — sub-agent orchestration (AgentTool) and TodoWrite.
  • searchGlob and Grep.
  • planEnterPlanMode / ExitPlanMode.
  • workspace — shared WorkspaceRoot path-resolution type.

Re-exports§

pub use agent::AgentFactory;
pub use agent::AgentTool;
pub use agent::AgentToolInput;
pub use agent::BackgroundSpawnResult;
pub use agent::BackgroundSpawner;
pub use agent::IsolationMode;
pub use agent::TodoWriteTool;
pub use agent::WorktreeOptions;
pub use fs::EditTool;
pub use fs::MultiEditTool;
pub use fs::NotebookEditTool;
pub use fs::ReadTool;
pub use fs::WriteTool;
pub use input::parse_input;
pub use memory::ReadMemoryTopicTool;
pub use memory::WriteMemoryTopicTool;
pub use plan::EnterPlanModeTool;
pub use plan::ExitPlanModeTool;
pub use search::GlobTool;
pub use search::GrepTool;
pub use shell::BashBgRegistry;
pub use shell::BashJob;
pub use shell::BashOutputTool;
pub use shell::BashStatus;
pub use shell::BashTool;
pub use shell::KillShellTool;
pub use shell::RingBuffer;
pub use shell::global_registry;
pub use web::Provider as WebSearchProvider;
pub use web::SearchHit;
pub use web::WebFetchTool;
pub use web::WebSearchTool;
pub use workspace::WorkspaceRoot;

Modules§

agent
Agent-orchestration tools — sub-agent invocation (AgentTool) and TodoWrite.
fs
Filesystem tools — Read, Write, Edit, MultiEdit, NotebookEdit.
input
Shared tool-input deserialization.
memory
Built-in tools for reading and writing per-project auto-memory.
plan
Plan-mode tools — EnterPlanMode / ExitPlanMode.
search
File-search tools — Glob (filename pattern matching) and Grep (content search via ripgrep).
shell
Shell tools — Bash (foreground exec) plus the background-job registry and its companion tools (BashOutput, KillShell).
tool_search
ToolSearch built-in tool (ADR-0046).
web
Web tools — WebFetch (URL → markdown) and WebSearch (provider-backed web search).
workspace
WorkspaceRoot — resolves and optionally restricts paths for built-in tools.