Skip to main content

Module tools

Module tools 

Source
Expand description

Tool name constants to avoid hardcoding strings throughout the codebase

Constants§

AGENT
Unified subagent lifecycle tool (action: spawn | spawn_subprocess | send_input | resume | wait | close). wait_agent/close_agent are now aliases routed to agent (action=‘wait’/‘close’); LIFECYCLE_CLEANUP_TOOLS still lists their names so the policy layer keeps treating them as always-allowed cleanup calls regardless of the active primary agent’s restricted tool policy.
ALWAYS_AVAILABLE_WORKFLOW_TOOLS
Workflow-coordination tools that must remain available regardless of the [automation.full_auto].allowed_tools allow-list, so planning, checklist, and interview coordination keep working in Auto mode and other full-auto runs. These are control-plane (not execution blast radius): task_tracker owns only its session tracker file, start_planning only flips the planning-workflow state, and request_user_input still resolves through the interactive-session gate at execution time. Callers must pass the canonical tool name (see canonical_tool_name); matching is exact.
APPLY_PATCH
Canonical patch application tool exposed to the model.
ASK_QUESTIONS
Legacy alias routed to request_user_input.
ASK_USER_QUESTION
Legacy alias routed to request_user_input (deprecated tabbed shape).
CLOSE_AGENT
Close a delegated child agent.
CLOSE_PTY_SESSION
CODE_SEARCH
Advanced bounded syntactic code search tool for VTCode-specific profiles.
COPY_FILE
CREATE_FILE
CREATE_PTY_SESSION
CRON
Unified scheduled-prompt tool (action: create | list | delete).
CRON_CREATE
Legacy alias for cron action=create.
CRON_DELETE
Delete a session-scoped scheduled task by id.
CRON_LIST
List session-scoped scheduled tasks.
DEFUDDLE_FETCH
Defuddle-backed markdown extraction for a single URL. The hosted defuddle.md/{link} service is rate-limited, so this tool is hard-capped at one call per tool instance (treat one tool instance as one session).
DELETE_FILE
EDIT_FILE
EXECUTE_CODE
EXEC_COMMAND
Canonical shell execution tool exposed to the model.
EXEC_PTY_CMD
FETCH
FETCH_URL
FILE_OP
GET_ERRORS
GREP
GREP_FILE
LIFECYCLE_CLEANUP_TOOLS
Cleanup-only child-agent tools that must remain available regardless of the active primary agent’s tool policy, so restricted primaries can still join or close already-running child work. Add new lifecycle-only cleanup tools here.
LIST
LIST_FILES
LIST_PTY_SESSIONS
LIST_SKILLS
List all available skills (local and dormant system utilities)
LOAD_SKILL
Load a skill’s instructions and activate its tools
LOAD_SKILL_RESOURCE
Load resources from a skill (scripts, templates, docs)
MATRIX
Durable scheduler control for coordinators and assignment-owned worker reports.
MCP
Unified MCP tool (action: search_tools | get_tool_details | list_servers | connect | disconnect). connect/disconnect are config-gated lifecycle ops evaluated under the action-qualified policy keys mcp:connect / mcp:disconnect (default Prompt) so they keep their human-in-the-loop confirmation even though the base mcp tool is ToolPolicy::Allow.
MCP_CONNECT_SERVER
MCP_DISCONNECT_SERVER
MCP_GET_TOOL_DETAILS
MCP_LIST_SERVERS
MCP_SEARCH_TOOLS
MEMORY
Canonical memory tool name for Anthropic native memory sessions.
MOVE_FILE
READ_FILE
READ_PTY_SESSION
RECORD_DECISION
Optional public rationale recording within the canonical current task.
REQUEST_USER_INPUT
Canonical HITL tool name for structured user input.
RESIZE_PTY_SESSION
RESUME_AGENT
Resume a delegated child agent without sending a message.
RUN_PTY_CMD
SEARCH_REPLACE
SEARCH_TOOLS
SEND_INPUT
Send follow-up input to a delegated child agent.
SEND_PTY_INPUT
SHELL
SPAWN_AGENT
Spawn a delegated child agent.
SPAWN_BACKGROUND_SUBPROCESS
Launch a managed background subprocess that hosts a background-enabled subagent.
START_PLANNING
Start planning - enables read-only tools and planning workflow.
TASK_TRACKER
Task tracker / plan manager - tracks checklist progress during complex tasks.
THINK
UNIFIED_EXEC
Internal shell execution and code execution dispatcher retained behind public tools.
UNIFIED_FILE
Internal file operations dispatcher retained behind public tools.
UNIFIED_SEARCH
Internal search and discovery dispatcher retained behind public tools.
WAIT_AGENT
Wait for one or more delegated child agents to finish.
WEB_FETCH
WEB_SEARCH
WILDCARD_ALL
WRITE_FILE
WRITE_STDIN
Canonical stdin writer for active execution sessions.

Functions§

is_workflow_coordination_tool
Returns true for workflow-coordination tools that bypass the full-auto allow-list (see ALWAYS_AVAILABLE_WORKFLOW_TOOLS).