Skip to main content

Built-in Tools

Authoritative for the Go daemon. Schemas live in internal/runtime/context/injection/builtin.go and internal/compiler/catalog/system_modules.go, plus registered modules under internal/modules/*/.

Discovery and primitives (context_builder)

ToolNotes
search_toolsquery = search; category = list domain tools; no args = list domains
get_toolFull schema for one FQN
execute_toolname + params object
run_parallelPrefer tasks: [{tool, args}]
background_runLaunch / status / wait / cancel / list; notify_when, wait_for; watch + command + interval (+ optional until); signal, stdin

Injection of the first five depends on runtime.tool_injection and catalog size (see Tools).

Conditionally injected

ToolGate
ask_userAsk-user enabled
call_appCall-app enabled
use_skillSkills enabled
memory.*Memory enabled
agent + kvAgent spawn enabled

kv: write key+value, read key, delete: true, list: true.

There are no separate tools named list_categories, browse_category, watch_start, ... Use search_tools modes and background_run(watch=true, ...).

Session cron: scheduler.schedule

Declare tools.modules.scheduler. Params: schedule (5-field cron), message, optional context, reply, reports. See scheduler.

cron_native is a stub. runtime.scheduler / runtime.watchers booleans do not load tools by themselves.

Memory

set_goal, remember, task_create, task_update.

Agent spawn

One tool agent with modes (spawn / batch / wait / status / list / cancel). Coordinator only. See agent_spawn.

File tools (filesystem)

read, write, edit, multi_edit, glob, grep, delete. Primary path param is path (file_path accepted as alias).

YAML alias tools.modules.workspace (file I/O) → filesystem. Git change-tracking module id remains workspace.

Preview

preview (inspect, snapshot), previewshot (screenshot). No web_preview module.

Other short aliases

ShortFQN
Bashbash.run (also pty bool)
WebSearch / WebFetchweb.search / web.fetch
LintChecklsp.diagnostics

Database: connect, query, disconnect. HTTP: request, download, upload.