Module tools 

Tool system — trait, registry, and built-in tool implementations.

All tools implement the Tool trait and are registered in ToolRegistry. Subagents get ToolRegistry::without_subagent() to prevent recursion.

Re-exports

pub use crate::runtime::subagent::SubagentDisplayRow;

pub use crate::runtime::subagent::SubagentHandle;

pub use crate::runtime::subagent::SubagentRegistry;

pub use crate::runtime::subagent::SubagentResult;

pub use crate::runtime::subagent::SubagentState;

pub use crate::runtime::subagent::SubagentStatus;

pub use discovery::ActivateToolsTool;

pub use discovery::SearchToolsTool;

pub use respond::RespondTool;

pub use secret_prompt::PromptKind;

pub use secret_prompt::SecretPromptHandle;

pub use secret_prompt::SecretPromptRequest;

pub use send_channel::SendChannelTool;

pub use shell::ShellEndTool;

pub use shell::ShellSendTool;

pub use shell::ShellStartTool;

pub use watcher_exit::WatcherExitTool;

Modules

activation

SessionToolSet — per-session core + exact activated tools (Task 15, spec §7.1, §4.2).

catalog

ToolCatalog — all locally known capabilities (spec §7.1, Task 14).

discovery

Model-facing discovery and exact-activation builtins (Task 17, spec §4.2, §7.2, §7.3, §7.7): search_tools and activate_tools.

forum

Explicit, project-wide peer notes through the captured host memory binding.

ledger

Task 25 — typed tool-call ledger (spec §8.3).

memory

Model-facing repository memory and explicitly opted-in user notes.

output

Task 26 — bounded tool-output delta channels with an explicit backpressure/coalescing policy (spec §8.4).

respond

RespondTool — reply to an event through its original source channel.

send_channel

SendChannelTool — proactively send a message to a specific channel.

shell

Interactive PTY-based shell sessions for agents.

watcher_exit

Structs

BashIntermediarySnapshot

BashTool

EditTool

ExtensionTool

FindTool

GrepTool

LsTool

MemoryContextTool

Control the continuous-memory context of the current session (spec §7.2).

PowerShellTool

ReadTool

SecretPromptHandle

UI-only secret prompt plumbing for interactive tools.

SecretPromptQueue

SecretPromptRequest

SessionSchemaProjection

Typed projection report for ToolRegistry::session_tools_schema: the projected schema entries PLUS every pinned session member that was dropped fail-closed, with the typed reason. Metadata-only reasons: bounded identities, never schema bytes. Callers can surface dropped for audit/telemetry instead of losing the signal to a log line.

SubagentCollectTool

SubagentModelAuthorizeTool

SubagentModelsTool

SubagentResumeTool

SubagentStartTool

SubagentStatusTool

SubagentSteerTool

SubagentTool

ToolCapabilities

Runtime capability handles — shared services a tool may require.

ToolChannels

Streaming channels — carry partial tool output and stream events.

ToolContext

Context passed to tool execution — composition of channels, capabilities, and limits.

ToolLimits

Configuration limits and timeouts.

ToolRegistry

Registry of available tools. Maintains a name→tool map and a cached JSON schema array that gets sent to the API. Thread-safe via Arc<RwLock<ToolRegistry>>.

WriteTool

Enums

ConcurrencyKey

DroppedSessionMember

Why a pinned session member was dropped from a schema projection.

ToolOrigin

Explicit runtime-origin identity of a registered tool implementation.

ToolOutput

Structured tool output. Text is the legacy contract (what execute returns). Blocks carries Anthropic-shaped content blocks destined for tool_result.content, plus a plain-text summary used everywhere a String is expected today: UI preview, after_tool_call hooks, trace ledger byte counts, headless logs, and providers that cannot carry the blocks. INVARIANT: blocks[0] MUST be a {"type":"text"} block whose text == summary (compaction reads blocks[0].text; non-Anthropic translators join only text sub-blocks).

Traits

Tool

The core trait for all tools. Implement this to add a new tool.

Functions

bash_intermediary_snapshot

resolve_agent_prompt

Resolve an agent name to a system prompt.