Built-in Tools Overview

Built-in tools ship with DesireCore and require no extra installation. Agents see only tools that are actually available in the current platform, permission policy, runtime environment, and task context.

File Operations

Read - Read Files

Reads text, code, configuration files, images, and notebook content. It supports ranged reads, pagination, image preview, and notebook cell reads.

Attribute	Value
Risk Level	Low
Requires Confirmation	No
Typical Use Cases	Inspect code, read documents, check configuration, preview images

Write - Write Files

Creates a new file or fully overwrites an existing file. Missing directories are created automatically.

Attribute	Value
Risk Level	Medium
Requires Confirmation	Yes
Typical Use Cases	Create documents, save reports, generate configuration files

Edit - Edit Files

Performs precise text replacement. It is better for small patches than rewriting an entire file.

Attribute	Value
Risk Level	Medium
Requires Confirmation	Yes
Typical Use Cases	Patch code, update configuration, fix a section of a document

NotebookEdit - Edit Jupyter Notebooks

Replaces, inserts, or deletes a specific Jupyter Notebook cell.

Attribute	Value
Risk Level	Medium
Requires Confirmation	Yes
Typical Use Cases	Adjust analysis notebooks, update experiments, organize computation steps

Search and Discovery

Glob - Search File Names

Finds files with glob patterns such as **/*.ts.

Attribute	Value
Risk Level	Low
Requires Confirmation	No
Typical Use Cases	Find config files, locate tests, inspect project structure

Grep - Search File Contents

Searches text or regular expressions in files with context lines, type filters, case control, and multiple output modes.

Attribute	Value
Risk Level	Low
Requires Confirmation	No
Typical Use Cases	Find function calls, locate error messages, search documentation

Ls - List Directory

Lists files and subdirectories, with optional recursion.

Attribute	Value
Risk Level	Low
Requires Confirmation	No
Typical Use Cases	Browse workspaces, confirm paths, inspect folders

ToolSearch - Search Available Tools

Searches deferred tools and external capabilities that may be loaded on demand.

Attribute	Value
Risk Level	Low
Requires Confirmation	No
Typical Use Cases	Find GitHub, browser debugging, or documentation lookup tools

ToolSearch inspects authorized tool documentation without changing current declarations. An undeclared tool must be loaded with DiscoverTools before it can be called from the next model request using the actual declaration.

Command Execution

Bash - Execute Shell Commands

Runs shell commands. It supports timeouts, background execution, and output truncation.

Attribute	Value
Risk Level	High
Requires Confirmation	Yes
Typical Use Cases	Run tests, build projects, install dependencies, execute scripts

High-Risk Operation

Command execution can modify system state or access external networks. Review the command, working directory, and intent before approving.

PowerShell - Execute Windows PowerShell Commands

Available on Windows. Runs PowerShell commands and scripts with version-aware guidance, timeouts, background execution, and large-output handling.

Attribute	Value
Risk Level	High
Requires Confirmation	Yes
Typical Use Cases	Windows administration, PowerShell scripts, local environment checks

Which - Check Command Availability

Checks whether one or more command-line tools are installed and returns executable paths.

Attribute	Value
Risk Level	Low
Requires Confirmation	No
Typical Use Cases	Verify dependencies before running commands

Sleep - Wait in the Current Session

Waits from 0.1 to 300 seconds, then continues the same task chain. It does not occupy a shell process and can be interrupted.

Attribute	Value
Risk Level	Low
Requires Confirmation	No
Typical Use Cases	Wait for builds, poll deployment status, rate-limit requests

Sleep vs. CreateSchedule

Use Sleep for a short wait before continuing the current task. Use CreateSchedule for independent background reminders, reports, and recurring tasks.

Network

WebFetch - Fetch Web Pages

Fetches a web page and converts it to Markdown, with main-content extraction, caching, and timeout controls.

Attribute	Value
Risk Level	Low
Requires Confirmation	No
Typical Use Cases	Read online docs, inspect API references, extract article text

WebSearch - Search the Web

Searches the internet with result limits and domain filters.

Attribute	Value
Risk Level	Low
Requires Confirmation	No
Typical Use Cases	Find current information, public references, troubleshooting material

HttpRequest - Send HTTP Requests

Registered primarily on Windows for environments where common command-line network tools are unavailable.

Attribute	Value
Risk Level	Medium
Requires Confirmation	Depends on request content
Typical Use Cases	Call APIs, check service status, retrieve structured data

Agent Collaboration

Delegate - Delegate Tasks

Delegates work to another agent, a team, or a preset such as Explore. Supports sync, async, and handoff-style flows.

Attribute	Value
Risk Level	Medium
Requires Confirmation	Depends on permissions and task content
Typical Use Cases	Cross-domain collaboration, parallel research, read-only Explore analysis

SendMessage - Agent-to-Agent Message

Sends a message to another agent with context, intent, and waiting behavior.

Attribute	Value
Risk Level	Low
Requires Confirmation	No
Typical Use Cases	Multi-agent collaboration, result handoff, team communication

SendUserMessage - Send Message to User

Sends a Markdown message to you, optionally with file attachments and proactive status.

Attribute	Value
Risk Level	Low
Requires Confirmation	No
Typical Use Cases	Report progress, send attached material, proactively surface important context

AskUserQuestion - Ask the User

Displays structured question cards in the current conversation.

Attribute	Value
Risk Level	Low
Requires Confirmation	No
Typical Use Cases	Clarify requirements, confirm choices, gather multiple fields

ManageTeam - Manage Team

Creates and adjusts agent teams, supervisors, members, and team tasks.

Attribute	Value
Risk Level	Medium
Requires Confirmation	Depends on operation
Typical Use Cases	Form specialist teams, assign team-level work

Context Management

ManageContext - Manage Conversation Context

Lets an agent actively curate its own conversation context: pin key content it wants to keep around, discard tool results it no longer needs, or collapse history down to just the system layer plus whatever is pinned when things get too cluttered. It can also temporarily adjust how much context budget the current session is allowed to use. None of this physically deletes the original record - the full history remains available to look back on.

Attribute	Value
Risk Level	Medium
Requires Confirmation	Depends on the operation (actions with information loss, such as clearing history or discarding a tool result, require confirmation; other operations do not)
Typical Use Cases	Protect key conclusions from automatic pruning in long conversations, clean up oversized tool results, temporarily adjust the conversation's context budget

CompactSession - Compress Session History

Lets an agent proactively compress earlier conversation history into a summary, freeing up context space while preserving the important information.

Attribute	Value
Risk Level	Low
Requires Confirmation	No
Typical Use Cases	Trim down a long-running conversation once it has accumulated significant history

Workspace and Data

ManageWorkDirs - Manage Work Directories

Lists, adds, removes, and sets primary work directories.

Attribute	Value
Risk Level	Medium
Requires Confirmation	Yes
Typical Use Cases	Add project folders, switch primary workspace, remove paths

GenerateUUID - Generate Unique IDs

Generates one or more UUID v4 identifiers.

Attribute	Value
Risk Level	Low
Requires Confirmation	No
Typical Use Cases	Create IDs, generate test data, name resources

RecallConversation - Retrieve Conversation History

Retrieves historical conversations by keyword and time range.

Attribute	Value
Risk Level	Low
Requires Confirmation	No
Typical Use Cases	Review prior discussions, find past decisions, restore context

JsonRepair - Repair JSON

Repairs common JSON formatting issues and can shape output toward an expected structure.

Attribute	Value
Risk Level	Low
Requires Confirmation	No
Typical Use Cases	Fix model-generated JSON, clean configuration snippets

Skills and Scheduling

Skill - Load Skill

Loads and executes an installed skill pack. Skills may declare tools, trigger behavior, context mode, model, and provider preferences.

Attribute	Value
Risk Level	Inherited from skill configuration
Requires Confirmation	Inherited from skill and invoked tools
Typical Use Cases	Run professional workflows, invoke custom capabilities

CreateSchedule - Create Scheduled Task

Creates a background scheduled task using a specific time, delay, interval, or cron rule.

Attribute	Value
Risk Level	Medium
Requires Confirmation	Depends on approval policy
Typical Use Cases	Set reminders, generate periodic reports, schedule independent prompt checks

Task Board Tools

TaskBoardCreate creates a board from an authorized team conversation. TaskCreate registers a task; it does not automatically start execution or make the current conversation its executor. TaskList and TaskGet show tasks and actions currently allowed by the server. TaskUpdate and TaskResponsibility manage task content, state, assignment, ownership, and review under permission checks.

To delegate a board task, assign an executor and ask the agent to start execution linked to that task. Registration alone does not authorize state changes. See Long-running tasks.

MCP Resources

McpListResources / McpReadResource

Lists or reads resources exposed by MCP servers.

Attribute	Value
Risk Level	Low
Requires Confirmation	No

McpListPrompts / McpGetPrompt

Lists or expands prompt templates provided by MCP servers.

Attribute	Value
Risk Level	Low
Requires Confirmation	No

Workflows

WorkflowCreate / WorkflowValidate / WorkflowTest / WorkflowRun / WorkflowView

Creates, validates, tests, runs, and opens workflow DSL files. Workflows can orchestrate triggers, code, LLM nodes, agents, and human gates.

Attribute	Value
Risk Level	Low to Medium
Requires Confirmation	No by default
Typical Use Cases	Build reusable automations, validate workflows, run structured processes

Terminal Control

TerminalControl - Interactive Terminal

Creates and manages interactive PTY sessions. Unlike Bash, TerminalControl supports waiting for prompts, handling (y/n) confirmations, and password input.

Attribute	Value
Risk Level	High
Requires Confirmation	Yes
Typical Use Cases	Long-running dev servers, interactive installers, collaborative terminal work

Document and Media

ExportDocument - Export Document

Converts Markdown or editor content to PDF, DOCX, etc., preserving headings, tables, code blocks, images, and formulas.

Attribute	Value
Risk Level	Low to Medium
Requires Confirmation	Depends on target path

GenerateImage / GenerateVideo - Generate Images and Videos

Invokes configured media providers for text-to-image, image-to-image, text-to-video, reference material, and first/last-frame generation. See Media Generation.

Attribute	Value
Risk Level	Medium
Requires Confirmation	Depends on provider and cost

BeautifyImage - Beautify Image

Crops, centers, removes borders, and enhances existing images with output-size protection.

Attribute	Value
Risk Level	Medium
Requires Confirmation	Depends on provider and cost

GenerateDiagram - Generate Diagram

Renders draw.io XML into architecture diagrams, flowcharts, UML, mind maps, and more, displayed as editable diagram cards in the conversation.

Attribute	Value
Risk Level	Low
Requires Confirmation	No

UnderstandImage - Image Understanding

Returns a visual model's description or answer about an image given its URL. Used as a fallback when the primary model lacks vision support.

Attribute	Value
Risk Level	Low
Requires Confirmation	No

Canvas - Browser Window Control

Controls Electron BrowserWindow for web page display, JS execution, screenshots, and A2UI message pushing.

Attribute	Value
Risk Level	Medium
Requires Confirmation	Depends on operation

EnterWorktree / ExitWorktree - Isolated Workspace

Creates or reuses an isolated Git linked worktree for file modifications and commands, without affecting the main workspace.

Attribute	Value
Risk Level	Medium
Requires Confirmation	Yes

MailOperations - Email Operations

Calls the local Mail Service REST API for account listing, email send/receive/search, labels, and automation rules. See Email Management.

Attribute	Value
Risk Level	Medium
Requires Confirmation	Depends on operation

ManageSchedule - Manage Scheduled Tasks

Creates and manages scheduled tasks with delay, timer, interval, and cron triggers. See Schedule.

Attribute	Value
Risk Level	Medium
Requires Confirmation	Yes

RefreshAgentFS - Refresh Agent State

Triggers an immediate refresh of the frontend UI and tool/skill registry after writing AgentFS files.

Attribute	Value
Risk Level	Low
Requires Confirmation	No

MathCalc - High-Precision Calculator

Deterministic high-precision math calculations for financial, ratio, statistical, and formula verification tasks.

Attribute	Value
Risk Level	Low
Requires Confirmation	No

HeartbeatRespond - Heartbeat Response

Submits heartbeat patrol results including outcome, notification text, output files, and next-check suggestions. See Heartbeat.

Attribute	Value
Risk Level	Low
Requires Confirmation	No