The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.
Rust agent-orchestrationai-agentsai-assistantdesktopllmlocal-firstmcppersonal-aiprivacyrustsecond-braintauri
/**
* How each core tool is presented: icon, phrase, category, target chip and
* the rich body its detail panel renders.
*
* Resolution order lives in `toolPresentation.ts`; this file is only data.
* Three layers:
*
* - {@link EXACT_TOOL_SPECS}: one entry per registered tool name.
* - {@link ACTION_TOOL_SPECS}: collapsed tools that switch on an argument
* (`memory { action: "recall" }`, `browser { action: "click" }`).
* - {@link FAMILY_TOOL_SPECS}: prefix rules for tool families whose members
* share a meaning (`hosting_*`, `wallet_*`), so a new member of a known
* family is labelled without an edit here.
*
* `toolPresentation.catalog.test.ts` walks every name the core registers
* (`__fixtures__/coreToolNames.json`) and fails if any falls through to the
* generic fallback, so a new core tool cannot ship unlabelled.
*/
import {
AppWindowIcon,
ArchiveRestoreIcon,
ArrowLeftRightIcon,
BellIcon,
BlocksIcon,
BookOpenIcon,
BotIcon,
BrainCircuitIcon,
BrainIcon,
CalendarClockIcon,
CameraIcon,
ChartBarIcon,
ClapperboardIcon,
ClipboardCheckIcon,
ClockIcon,
CodeIcon,
CoinsIcon,
DatabaseIcon,
DownloadIcon,
EraserIcon,
FilePenIcon,
FilePlusIcon,
FileSpreadsheetIcon,
FileTextIcon,
FlagIcon,
FolderOpenIcon,
FolderSearchIcon,
GitBranchIcon,
GitCompareIcon,
GlobeIcon,
GraduationCapIcon,
HardDriveIcon,
HeartIcon,
HourglassIcon,
ImageIcon,
ImagePlusIcon,
KeyboardIcon,
LayersIcon,
Link2Icon,
LinkIcon,
ListChecksIcon,
ListTodoIcon,
type LucideIcon,
MailXIcon,
MapPinIcon,
MessageCircleQuestionIcon,
MousePointerClickIcon,
NetworkIcon,
NewspaperIcon,
PackageIcon,
PackagePlusIcon,
PackageSearchIcon,
PlugIcon,
PowerIcon,
PresentationIcon,
ReceiptIcon,
RocketIcon,
SaveIcon,
ScanEyeIcon,
ScanSearchIcon,
ScrollTextIcon,
ServerIcon,
SettingsIcon,
ShieldIcon,
SparklesIcon,
SquareTerminalIcon,
StethoscopeIcon,
TargetIcon,
TelescopeIcon,
TextSearchIcon,
TrendingUpIcon,
UserRoundIcon,
VideoIcon,
WalletIcon,
WorkflowIcon,
WrenchIcon,
} from 'lucide-react';
import { chip, type ChipRule } from './toolChips';
import type { ToolPhraseId } from './toolPhrases';
/** Broad activity category, used for grouping summaries and the timeline. */
export type ToolCategory =
| 'file'
| 'code'
| 'shell'
| 'web'
| 'browser'
| 'media'
| 'memory'
| 'agent'
| 'plan'
| 'schedule'
| 'app'
| 'mcp'
| 'storage'
| 'wallet'
| 'skill'
| 'system'
| 'other';
/** Which rich body the expanded row renders. `generic` is the Input/Output view. */
export type ToolBodyKind = 'webSearch' | 'webFetch' | 'shell' | 'file' | 'mcp' | 'generic';
export interface ToolSpec {
phrase: ToolPhraseId;
icon: LucideIcon;
category: ToolCategory;
chip?: ChipRule;
body?: ToolBodyKind;
}
const spec = (
phrase: ToolPhraseId,
icon: LucideIcon,
category: ToolCategory,
extra: Partial<Pick<ToolSpec, 'chip' | 'body'>> = {}
): ToolSpec => ({ phrase, icon, category, ...extra });
const webSearch = (phrase: ToolPhraseId, icon: LucideIcon = GlobeIcon) =>
spec(phrase, icon, 'web', { chip: chip.query(), body: 'webSearch' });
const readPages = spec('readPages', LinkIcon, 'web', { chip: chip.url(), body: 'webFetch' });
export const FALLBACK_ICON = WrenchIcon;
export const INTEGRATION_ICON = PlugIcon;
export const EXACT_TOOL_SPECS: Record<string, ToolSpec> = {
// ── Files and code ──────────────────────────────────────────────────────
file_read: spec('readFile', FileTextIcon, 'file', { chip: chip.path(), body: 'file' }),
file_write: spec('writeFile', FilePlusIcon, 'file', { chip: chip.path(), body: 'file' }),
edit: spec('editFile', FilePenIcon, 'file', { chip: chip.path(), body: 'file' }),
apply_patch: spec('applyEdits', FilePenIcon, 'file', { chip: chip.editsPath(), body: 'file' }),
vault_write_markdown: spec('writeFile', FilePlusIcon, 'file', { chip: chip.path() }),
// Older and foreign spellings of the file tools, seen in persisted
// transcripts and other harnesses' tool names.
read_file: spec('readFile', FileTextIcon, 'file', { chip: chip.path(), body: 'file' }),
write_file: spec('writeFile', FilePlusIcon, 'file', { chip: chip.path(), body: 'file' }),
grep: spec('searchCode', TextSearchIcon, 'code', { chip: chip.text('pattern') }),
glob: spec('findFiles', FolderSearchIcon, 'file', { chip: chip.text('pattern') }),
list: spec('listFolder', FolderOpenIcon, 'file', { chip: chip.path() }),
csv_export: spec('exportCsv', FileSpreadsheetIcon, 'file', { chip: chip.text('filename') }),
update_memory_md: spec('updateMemoryNotes', ScrollTextIcon, 'memory', {
chip: chip.text('file'),
}),
git_operations: spec('runGit', GitBranchIcon, 'code', {
chip: chip.text('operation', 'command'),
}),
read_diff: spec('readChanges', GitCompareIcon, 'code', { chip: chip.path() }),
run_linter: spec('runLinter', ListChecksIcon, 'code'),
run_tests: spec('runTests', ListChecksIcon, 'code'),
lsp: spec('analyzeCode', CodeIcon, 'code', { chip: chip.path() }),
// ── Shell and system ────────────────────────────────────────────────────
shell: spec('runCommand', SquareTerminalIcon, 'shell', { chip: chip.command(), body: 'shell' }),
// Follows a `shell` command left running past its yield point.
shell_process: spec('wait', SquareTerminalIcon, 'shell', { chip: chip.text('process') }),
detect_tools: spec('checkInstalledTools', ScanSearchIcon, 'system'),
install_tool: spec('installTool', PackagePlusIcon, 'system', {
chip: chip.text('package', 'tool_name'),
}),
current_time: spec('checkTime', ClockIcon, 'system'),
resolve_time: spec('resolveDate', ClockIcon, 'system', { chip: chip.text('expr') }),
retrieve_tool_output: spec('retrieveOutput', ArchiveRestoreIcon, 'system'),
juice_retrieve: spec('retrieveOutput', ArchiveRestoreIcon, 'system'),
// REPL tools over a stored (handle) tool result; they reuse existing phrases.
juice_find: spec('searchCode', TextSearchIcon, 'system', { chip: chip.text('query') }),
juice_extract: spec('extractDetails', LayersIcon, 'system'),
juice_summarize: spec('extractDetails', LayersIcon, 'system'),
read_workspace_state: spec('reviewWorkspace', FolderOpenIcon, 'system'),
proxy_config: spec('configureProxy', SettingsIcon, 'system', { chip: chip.text('action') }),
update_check: spec('checkUpdates', DownloadIcon, 'system'),
update_apply: spec('installUpdate', DownloadIcon, 'system'),
pushover: spec('sendNotification', BellIcon, 'system', { chip: chip.text('title', 'message') }),
tool_stats: spec('reviewToolUsage', ChartBarIcon, 'system'),
keyboard: spec('typeKeys', KeyboardIcon, 'browser', { chip: chip.text('text', 'key') }),
mouse: spec('click', MousePointerClickIcon, 'browser'),
// ── Web ─────────────────────────────────────────────────────────────────
web_search: webSearch('searchWeb'),
web_search_tool: webSearch('searchWeb'),
// Role tools: `web_answer_tool` returns a grounded answer with citations
// (and runs deep research on `depth: "deep"`); `web_contents_tool` reads
// the given URLs.
web_answer_tool: webSearch('askTheWeb'),
web_contents_tool: readPages,
gemini_agentic_search: webSearch('askTheWeb'),
gemini_deep_research: webSearch('research', TelescopeIcon),
exa_answer: webSearch('askTheWeb'),
exa_search: webSearch('searchWeb'),
tavily_search: webSearch('searchWeb'),
querit_search: webSearch('searchWeb'),
parallel_search: webSearch('searchWeb'),
tinyfish_search: webSearch('searchWeb'),
searxng_search: webSearch('searchWeb'),
seltz_search: webSearch('searchWeb'),
brave_news_search: webSearch('searchNews', NewspaperIcon),
brave_image_search: webSearch('searchImages', ImageIcon),
brave_video_search: webSearch('searchVideos', VideoIcon),
exa_find_similar: spec('findSimilarPages', GlobeIcon, 'web', {
chip: chip.url(),
body: 'webSearch',
}),
exa_get_contents: readPages,
tavily_extract: readPages,
parallel_extract: readPages,
tinyfish_fetch: readPages,
// Parallel was removed from the core; these stay so old transcripts still
// render with a meaningful label.
parallel_research: spec('research', TelescopeIcon, 'web', { chip: chip.query() }),
parallel_chat: spec('askTheWeb', GlobeIcon, 'web', { chip: chip.query() }),
parallel_enrich: spec('enrichData', SparklesIcon, 'web', { chip: chip.query() }),
parallel_dataset: spec('buildDataset', DatabaseIcon, 'web', { chip: chip.query() }),
tinyfish_agent_run: spec('browseForYou', MousePointerClickIcon, 'web', {
chip: chip.text('goal', 'url'),
}),
web_fetch: spec('readWebpage', LinkIcon, 'web', { chip: chip.url(), body: 'webFetch' }),
http_request: spec('callApi', ArrowLeftRightIcon, 'web', { chip: chip.url(), body: 'webFetch' }),
curl: spec('downloadFile', DownloadIcon, 'web', { chip: chip.url() }),
x402_request: spec('makePaidRequest', CoinsIcon, 'web', { chip: chip.url() }),
gitbooks_search: spec('searchDocs', BookOpenIcon, 'web', { chip: chip.query() }),
gitbooks_get_page: spec('readDocs', BookOpenIcon, 'web', { chip: chip.url() }),
// ── Browser ─────────────────────────────────────────────────────────────
browser: spec('useBrowser', AppWindowIcon, 'browser', { chip: chip.url() }),
browser_open: spec('openPage', AppWindowIcon, 'browser', { chip: chip.url() }),
// ── Native desktop ───────────────────────────────────────────────────────
desktop_list_apps: spec('inspectDesktop', AppWindowIcon, 'app'),
desktop_list_windows: spec('inspectDesktop', AppWindowIcon, 'app', { chip: chip.text('app') }),
desktop_launch: spec('controlDesktop', AppWindowIcon, 'app', { chip: chip.text('app') }),
desktop_snapshot: spec('inspectDesktop', ScanEyeIcon, 'app', { chip: chip.text('app') }),
desktop_find: spec('inspectDesktop', ScanSearchIcon, 'app', { chip: chip.text('app') }),
desktop_goal: spec('controlDesktop', MousePointerClickIcon, 'app', { chip: chip.text('app') }),
desktop_continue_goal: spec('controlDesktop', MousePointerClickIcon, 'app'),
// ── Media and documents ────────────────────────────────────────────────
image_info: spec('analyzeImage', ScanEyeIcon, 'media', { chip: chip.path() }),
media_generate_image: spec('generateImage', ImagePlusIcon, 'media', {
chip: chip.text('prompt'),
}),
media_generate_video: spec('generateVideo', ClapperboardIcon, 'media', {
chip: chip.text('prompt'),
}),
media_list_models: spec('checkMediaModels', ImageIcon, 'media'),
generate_document: spec('createDocument', FileTextIcon, 'media', { chip: chip.text('title') }),
show_ui: spec('showView', AppWindowIcon, 'skill'),
generate_presentation: spec('createPresentation', PresentationIcon, 'media', {
chip: chip.text('title'),
}),
// ── Memory ──────────────────────────────────────────────────────────────
// The single memory tool: recall asks a `question`, fetch a `query`, learn stores `text`.
memory: spec('searchMemory', BrainIcon, 'memory', {
chip: chip.text('question', 'query', 'text'),
}),
memory_store: spec('saveToMemory', SaveIcon, 'memory', { chip: chip.text('key', 'content') }),
memory_recall: spec('recallMemories', BrainCircuitIcon, 'memory', { chip: chip.query() }),
memory_forget: spec('forgetMemory', EraserIcon, 'memory', { chip: chip.text('key') }),
memory_hybrid_search: spec('searchMemory', BrainIcon, 'memory', { chip: chip.query() }),
memory_vector_search: spec('searchMemory', BrainIcon, 'memory', { chip: chip.query() }),
memory_chunk_context: spec('inspectMemory', BrainIcon, 'memory'),
memory_store_raw_search: spec('searchMemory', BrainIcon, 'memory', { chip: chip.query() }),
memory_store_raw_chunks: spec('inspectMemory', BrainIcon, 'memory'),
memory_store_kinds: spec('inspectMemory', BrainIcon, 'memory'),
memory_doctor: spec('inspectMemory', StethoscopeIcon, 'memory'),
memory_flavour: spec('inspectMemory', BrainIcon, 'memory'),
memory_tree: spec('exploreMemory', NetworkIcon, 'memory', { chip: chip.query() }),
goals: spec('reviewGoals', TargetIcon, 'memory'),
remember_preference: spec('savePreference', HeartIcon, 'memory', {
chip: chip.text('preference', 'key'),
}),
save_preference: spec('savePreference', HeartIcon, 'memory', {
chip: chip.text('preference', 'key'),
}),
flow_memory_recall: spec('recallMemories', BrainCircuitIcon, 'memory', { chip: chip.query() }),
flow_memory_remember: spec('saveToMemory', SaveIcon, 'memory', { chip: chip.text('key') }),
memory_tools_list: spec('inspectMemory', BrainIcon, 'memory'),
memory_tools_put: spec('saveToMemory', SaveIcon, 'memory'),
call_memory_agent: spec('searchMemory', BrainIcon, 'memory', { chip: chip.query() }),
// ── Agents and delegation ──────────────────────────────────────────────
spawn_subagent: spec('delegateTask', BotIcon, 'agent', { chip: chip.text('agent_id') }),
// Kept for recorded transcripts from before the single-spawn contract.
spawn_async_subagent: spec('delegateTask', BotIcon, 'agent', { chip: chip.text('agent_id') }),
ask_user_clarification: spec('askQuestion', MessageCircleQuestionIcon, 'agent', {
chip: chip.text('question'),
}),
extract_from_result: spec('extractDetails', LayersIcon, 'agent'),
// ── Planning ────────────────────────────────────────────────────────────
todo: spec('updateTodos', ListTodoIcon, 'plan'),
request_plan_review: spec('requestPlanReview', ClipboardCheckIcon, 'plan'),
plan_exit: spec('finishPlan', ClipboardCheckIcon, 'plan'),
goal_set: spec('setGoal', FlagIcon, 'plan', { chip: chip.text('objective') }),
goal_get: spec('checkGoal', FlagIcon, 'plan'),
goal_complete: spec('completeGoal', FlagIcon, 'plan'),
goal_resume: spec('resumeGoal', FlagIcon, 'plan'),
// ── Scheduling ──────────────────────────────────────────────────────────
cron: spec('checkSchedules', CalendarClockIcon, 'schedule'),
cron_add: spec('scheduleTask', CalendarClockIcon, 'schedule', { chip: chip.text('name') }),
cron_list: spec('checkSchedules', CalendarClockIcon, 'schedule'),
cron_update: spec('updateSchedule', CalendarClockIcon, 'schedule', { chip: chip.text('name') }),
cron_remove: spec('removeSchedule', CalendarClockIcon, 'schedule'),
cron_run: spec('runScheduledTask', CalendarClockIcon, 'schedule'),
cron_runs: spec('checkRunHistory', CalendarClockIcon, 'schedule'),
schedule: spec('scheduleTask', CalendarClockIcon, 'schedule'),
// ── Connected apps ─────────────────────────────────────────────────────
composio_list_toolkits: spec('checkAvailableApps', PlugIcon, 'app'),
composio_list_connections: spec('checkConnections', PlugIcon, 'app'),
composio_connect: spec('connectApp', Link2Icon, 'app', { chip: chip.text('toolkit') }),
composio_authorize: spec('authorizeApp', Link2Icon, 'app', { chip: chip.text('toolkit') }),
composio_list_tools: spec('findAppActions', PlugIcon, 'app', {
chip: chip.text('toolkits', 'toolkit'),
}),
composio_execute: spec('runAppAction', PlugIcon, 'app', { chip: chip.text('tool') }),
tool_search: spec('findTools', PackageSearchIcon, 'system', { chip: chip.query() }),
// The deferred-tool bridge is described as the tool it calls
// (`toolPresentation.ts`); this entry covers it before its args arrive.
tool_call: spec('useTools', WrenchIcon, 'system', { chip: chip.text('name') }),
search_tool_catalog: spec('findTools', PackageSearchIcon, 'system', { chip: chip.query() }),
gmail_unsubscribe: spec('unsubscribe', MailXIcon, 'app', { chip: chip.text('sender', 'email') }),
google_places_search: spec('searchPlaces', MapPinIcon, 'app', { chip: chip.query() }),
google_places_details: spec('lookUpPlace', MapPinIcon, 'app', { chip: chip.text('place_id') }),
// ── MCP ─────────────────────────────────────────────────────────────────
mcp_list_servers: spec('checkMcpServers', ServerIcon, 'mcp'),
mcp_list_tools: spec('checkMcpTools', BlocksIcon, 'mcp', { chip: chip.text('server') }),
mcp_call_tool: spec('callMcpTool', BlocksIcon, 'mcp', { chip: chip.text('server'), body: 'mcp' }),
mcp_registry_tool_call: spec('callMcpTool', BlocksIcon, 'mcp', {
chip: chip.text('server_id'),
body: 'mcp',
}),
mcp_registry_search: spec('searchMcpServers', ServerIcon, 'mcp', { chip: chip.query() }),
mcp_registry_get: spec('checkMcpServers', ServerIcon, 'mcp', {
chip: chip.text('qualified_name'),
}),
mcp_registry_installed_list: spec('checkMcpServers', ServerIcon, 'mcp'),
mcp_registry_status: spec('checkMcpServers', ServerIcon, 'mcp'),
mcp_registry_list_tools: spec('checkMcpTools', BlocksIcon, 'mcp', {
chip: chip.text('server_id'),
}),
mcp_registry_connect: spec('connectMcpServer', ServerIcon, 'mcp', {
chip: chip.text('qualified_name', 'server_id'),
}),
mcp_registry_disconnect: spec('disconnectMcpServer', ServerIcon, 'mcp', {
chip: chip.text('server_id'),
}),
mcp_registry_uninstall: spec('removeMcpServer', ServerIcon, 'mcp', {
chip: chip.text('server_id'),
}),
// ── Storage and hosting ────────────────────────────────────────────────
storage_upload_file: spec('uploadFile', HardDriveIcon, 'storage', { chip: chip.path() }),
storage_download_file: spec('downloadFile', HardDriveIcon, 'storage', {
chip: chip.text('key', 'name'),
}),
storage_list_files: spec('listStoredFiles', HardDriveIcon, 'storage'),
storage_get_link: spec('createShareLink', LinkIcon, 'storage', {
chip: chip.text('key', 'name'),
}),
storage_delete_file: spec('deleteFile', HardDriveIcon, 'storage', {
chip: chip.text('key', 'name'),
}),
storage_set_visibility: spec('updateFileAccess', HardDriveIcon, 'storage', {
chip: chip.text('key', 'name'),
}),
hosting_launch_site: spec('deploySite', RocketIcon, 'storage', { chip: chip.text('name') }),
hosting_rollback: spec('rollBackDeployment', RocketIcon, 'storage'),
// ── Wallet ──────────────────────────────────────────────────────────────
wallet_prepare_transfer: spec('prepareTransfer', WalletIcon, 'wallet', { chip: chip.text('to') }),
web3_swap_quote: spec('getSwapQuote', ArrowLeftRightIcon, 'wallet'),
web3_swap_routes: spec('getSwapQuote', ArrowLeftRightIcon, 'wallet'),
web3_swap_execute: spec('swapTokens', ArrowLeftRightIcon, 'wallet'),
web3_bridge_quote: spec('getBridgeQuote', ArrowLeftRightIcon, 'wallet'),
web3_bridge_execute: spec('bridgeTokens', ArrowLeftRightIcon, 'wallet'),
web3_dapp_call: spec('callDapp', CoinsIcon, 'wallet'),
web3_dapp_execute: spec('callDapp', CoinsIcon, 'wallet'),
// ── Skills and workflows ───────────────────────────────────────────────
use_skill: spec('useSkill', SparklesIcon, 'skill', { chip: chip.text('skill') }),
skill_search: spec('searchSkills', SparklesIcon, 'skill', { chip: chip.query() }),
create_skill: spec('createSkill', SparklesIcon, 'skill', { chip: chip.text('name') }),
install_workflow_from_url: spec('installSkill', SparklesIcon, 'skill', { chip: chip.url() }),
uninstall_workflow: spec('removeSkill', SparklesIcon, 'skill', { chip: chip.text('name', 'id') }),
run_workflow: spec('runWorkflow', WorkflowIcon, 'skill', { chip: chip.text('workflow_id') }),
await_workflow: spec('waitForWorkflow', HourglassIcon, 'skill'),
run_flow: spec('runWorkflow', WorkflowIcon, 'skill', { chip: chip.text('name', 'flow_id') }),
propose_workflow: spec('designWorkflow', WorkflowIcon, 'skill', { chip: chip.text('name') }),
revise_workflow: spec('designWorkflow', WorkflowIcon, 'skill'),
edit_workflow: spec('designWorkflow', WorkflowIcon, 'skill'),
create_workflow: spec('designWorkflow', WorkflowIcon, 'skill', { chip: chip.text('name') }),
duplicate_flow: spec('saveWorkflow', WorkflowIcon, 'skill'),
save_workflow: spec('saveWorkflow', WorkflowIcon, 'skill', { chip: chip.text('name') }),
validate_workflow: spec('validateWorkflow', WorkflowIcon, 'skill'),
dry_run_workflow: spec('testWorkflow', WorkflowIcon, 'skill'),
cancel_flow_run: spec('cancelWorkflow', WorkflowIcon, 'skill'),
resume_flow_run: spec('runWorkflow', WorkflowIcon, 'skill'),
suggest_workflows: spec('suggestWorkflows', WorkflowIcon, 'skill'),
// ── Settings and platform ──────────────────────────────────────────────
security_policy_info: spec('checkSecurity', ShieldIcon, 'system'),
credential_list: spec('checkSecurity', ShieldIcon, 'system'),
session_state: spec('checkSecurity', ShieldIcon, 'system'),
oauth_connect_url: spec('connectApp', Link2Icon, 'app', { chip: chip.text('provider') }),
oauth_list: spec('checkConnections', PlugIcon, 'app'),
dashboard_model_health: spec('runDiagnostics', StethoscopeIcon, 'system'),
workspace_read_persona: spec('readPersona', UserRoundIcon, 'system'),
workspace_update_persona: spec('updatePersona', UserRoundIcon, 'system'),
workspace_reset_persona: spec('updatePersona', UserRoundIcon, 'system'),
workspace_init: spec('setUpWorkspace', FolderOpenIcon, 'system'),
create_artifact: spec('createArtifact', PackageIcon, 'system'),
update_artifact: spec('updateArtifact', PackageIcon, 'system'),
read_artifact: spec('checkArtifacts', PackageIcon, 'system'),
list_artifacts: spec('checkArtifacts', PackageIcon, 'system'),
delete_artifact: spec('deleteArtifact', PackageIcon, 'system'),
share_artifact: spec('shareArtifact', PackageIcon, 'system'),
};
/**
* Collapsed tools that do different things per argument. Keyed by tool name,
* then by the argument named in `arg`. A value the table does not list falls
* back to the tool's {@link EXACT_TOOL_SPECS} entry.
*/
export const ACTION_TOOL_SPECS: Record<string, { arg: string; specs: Record<string, ToolSpec> }> = {
memory: {
arg: 'action',
specs: {
// Memory v2 actions.
recall: spec('recallMemories', BrainCircuitIcon, 'memory', {
chip: chip.text('question', 'query'),
}),
fetch: spec('searchMemory', BrainIcon, 'memory', { chip: chip.query() }),
learn: spec('saveToMemory', SaveIcon, 'memory', { chip: chip.text('text') }),
forget: spec('forgetMemory', EraserIcon, 'memory', { chip: chip.text('key') }),
// v1 actions, kept so persisted transcripts still render.
store: spec('saveToMemory', SaveIcon, 'memory', { chip: chip.text('key', 'content') }),
hybrid_search: spec('searchMemory', BrainIcon, 'memory', { chip: chip.query() }),
vector_search: spec('searchMemory', BrainIcon, 'memory', { chip: chip.query() }),
raw_search: spec('searchMemory', BrainIcon, 'memory', { chip: chip.query() }),
chunk_context: spec('inspectMemory', BrainIcon, 'memory'),
raw_chunks: spec('inspectMemory', BrainIcon, 'memory'),
kinds: spec('inspectMemory', BrainIcon, 'memory'),
flavour: spec('inspectMemory', BrainIcon, 'memory'),
doctor: spec('inspectMemory', StethoscopeIcon, 'memory'),
},
},
memory_tree: {
arg: 'mode',
specs: {
ingest_document: spec('saveDocumentToMemory', SaveIcon, 'memory', {
chip: chip.text('title', 'path'),
}),
},
},
goals: {
arg: 'op',
specs: {
list: spec('reviewGoals', TargetIcon, 'memory'),
add: spec('updateGoals', TargetIcon, 'memory', { chip: chip.text('text', 'goal') }),
edit: spec('updateGoals', TargetIcon, 'memory', { chip: chip.text('text', 'goal') }),
delete: spec('updateGoals', TargetIcon, 'memory'),
},
},
cron: {
arg: 'action',
specs: {
list: spec('checkSchedules', CalendarClockIcon, 'schedule'),
add: spec('scheduleTask', CalendarClockIcon, 'schedule', { chip: chip.text('name') }),
update: spec('updateSchedule', CalendarClockIcon, 'schedule', { chip: chip.text('name') }),
remove: spec('removeSchedule', CalendarClockIcon, 'schedule'),
run: spec('runScheduledTask', CalendarClockIcon, 'schedule'),
runs: spec('checkRunHistory', CalendarClockIcon, 'schedule'),
},
},
schedule: {
arg: 'action',
specs: {
list: spec('checkSchedules', CalendarClockIcon, 'schedule'),
get: spec('checkSchedules', CalendarClockIcon, 'schedule'),
cancel: spec('removeSchedule', CalendarClockIcon, 'schedule'),
remove: spec('removeSchedule', CalendarClockIcon, 'schedule'),
pause: spec('updateSchedule', CalendarClockIcon, 'schedule'),
resume: spec('updateSchedule', CalendarClockIcon, 'schedule'),
},
},
browser: {
arg: 'action',
specs: {
open: spec('openPage', AppWindowIcon, 'browser', { chip: chip.url() }),
snapshot: spec('takeScreenshot', CameraIcon, 'browser'),
click: spec('click', MousePointerClickIcon, 'browser', { chip: chip.text('selector') }),
mouse_click: spec('click', MousePointerClickIcon, 'browser'),
hover: spec('click', MousePointerClickIcon, 'browser', { chip: chip.text('selector') }),
fill: spec('typeKeys', KeyboardIcon, 'browser', { chip: chip.text('selector') }),
type: spec('typeKeys', KeyboardIcon, 'browser', { chip: chip.text('selector') }),
key_type: spec('typeKeys', KeyboardIcon, 'browser'),
key_press: spec('typeKeys', KeyboardIcon, 'browser', { chip: chip.text('key') }),
press: spec('typeKeys', KeyboardIcon, 'browser', { chip: chip.text('key') }),
scroll: spec('scrollPage', AppWindowIcon, 'browser'),
get_text: spec('readPage', AppWindowIcon, 'browser'),
get_title: spec('readPage', AppWindowIcon, 'browser'),
get_url: spec('readPage', AppWindowIcon, 'browser'),
find: spec('readPage', AppWindowIcon, 'browser', { chip: chip.text('value', 'selector') }),
is_visible: spec('readPage', AppWindowIcon, 'browser'),
wait: spec('wait', HourglassIcon, 'browser'),
},
},
};
/**
* Prefix families. Ordered: the first matching rule wins, so a narrower rule
* must precede a broader one that shares its prefix.
*/
export const FAMILY_TOOL_SPECS: ReadonlyArray<{ test: RegExp; spec: ToolSpec }> = [
{ test: /^memory_/, spec: spec('searchMemory', BrainIcon, 'memory', { chip: chip.query() }) },
{
test: /^learning_(update|pin|unpin|forget|rebuild|reset|save|enrich)/,
spec: spec('updateLearnings', GraduationCapIcon, 'memory'),
},
{ test: /^learning_/, spec: spec('reviewLearnings', GraduationCapIcon, 'memory') },
{
test: /^skill_registry_(install)/,
spec: spec('installSkill', SparklesIcon, 'skill', { chip: chip.text('name', 'id') }),
},
{ test: /^skill_registry_uninstall/, spec: spec('removeSkill', SparklesIcon, 'skill') },
{
test: /^skill_registry_search/,
spec: spec('searchSkills', SparklesIcon, 'skill', { chip: chip.query() }),
},
{ test: /^(skill_|skill_runtime_)/, spec: spec('checkSkills', SparklesIcon, 'skill') },
{
test: /^(list_workflows|describe_workflow|read_workflow_|list_workflow_runs|list_flows|get_flow|list_flow_|get_tool_|list_agent_definitions|list_connectable_toolkits|list_node_kinds|get_node_kind_contract)/,
spec: spec('checkWorkflows', WorkflowIcon, 'skill'),
},
{
test: /^task_source_(add|update|remove)/,
spec: spec('updateTaskSources', ListChecksIcon, 'app'),
},
{ test: /^task_source_(fetch|list_tasks)/, spec: spec('fetchTasks', ListChecksIcon, 'app') },
{ test: /^task_source_/, spec: spec('checkTaskSources', ListChecksIcon, 'app') },
{ test: /^hosting_(set_env|add_domain)/, spec: spec('updateHosting', RocketIcon, 'storage') },
{ test: /^hosting_/, spec: spec('checkHosting', RocketIcon, 'storage') },
{ test: /^storage_/, spec: spec('listStoredFiles', HardDriveIcon, 'storage') },
{
test: /^stock_/,
spec: spec('checkMarkets', TrendingUpIcon, 'app', { chip: chip.text('symbol') }),
},
{
test: /^wallet_(tx_|lookup_tx)/,
spec: spec('checkTransaction', WalletIcon, 'wallet', { chip: chip.text('tx_hash', 'hash') }),
},
{ test: /^(wallet_|web3_)/, spec: spec('checkWallet', WalletIcon, 'wallet') },
{ test: /^composio_/, spec: spec('runAppAction', PlugIcon, 'app') },
{ test: /^mcp_/, spec: spec('checkMcpServers', ServerIcon, 'mcp') },
{ test: /^config_/, spec: spec('checkSettings', SettingsIcon, 'system') },
{ test: /^(daemon_host_prefs_|service_)/, spec: spec('manageService', PowerIcon, 'system') },
{ test: /^(doctor_|health_)/, spec: spec('runDiagnostics', StethoscopeIcon, 'system') },
{ test: /^cost_/, spec: spec('checkUsageCosts', ReceiptIcon, 'system') },
{ test: /^artifact_/, spec: spec('checkArtifacts', PackageIcon, 'system') },
{ test: /^cron_/, spec: spec('checkSchedules', CalendarClockIcon, 'schedule') },
{ test: /^goal_/, spec: spec('checkGoal', FlagIcon, 'plan') },
];
/**
* Named agents, reached as `subagent:<id>`, as `spawn_subagent { agent_id }`,
* as `delegate_<id>`, or as the custom delegate tool names agent TOMLs
* declare (`delegate_name`).
*
* Some entries name specialists the core no longer ships (`code_executor`,
* `tools_agent`, `do_crypto`, `manage_settings`, `schedule_task`,
* `use_mcp_server`, `ask_docs`, `run_code`, `review_code`, `plan`): they are
* now inline skills, but existing transcripts still replay those calls, so the
* labels stay for history.
*/
export const AGENT_SPECS: Record<string, ToolSpec> = {
orchestrator: spec('planNextSteps', BotIcon, 'agent'),
plan: spec('planNextSteps', BotIcon, 'agent'),
planner: spec('planNextSteps', BotIcon, 'agent'),
critic: spec('reviewWork', ClipboardCheckIcon, 'agent'),
review_code: spec('reviewWork', ClipboardCheckIcon, 'agent'),
tools_agent: spec('useTools', WrenchIcon, 'agent'),
code_executor: spec('runCode', SquareTerminalIcon, 'agent'),
run_code: spec('runCode', SquareTerminalIcon, 'agent'),
ask_docs: spec('searchDocs', BookOpenIcon, 'agent'),
create_image: spec('generateImage', ImagePlusIcon, 'agent'),
create_video: spec('generateVideo', ClapperboardIcon, 'agent'),
analyze_image: spec('analyzeImage', ScanEyeIcon, 'agent'),
make_presentation: spec('createPresentation', PresentationIcon, 'agent'),
do_crypto: spec('checkWallet', WalletIcon, 'agent'),
schedule_task: spec('scheduleTask', CalendarClockIcon, 'agent'),
manage_tasks: spec('checkTaskSources', ListChecksIcon, 'agent'),
manage_settings: spec('checkSettings', SettingsIcon, 'agent'),
use_mcp_server: spec('checkMcpTools', BlocksIcon, 'agent'),
curate_goals: spec('updateGoals', TargetIcon, 'agent'),
manage_profile_memory: spec('updateLearnings', GraduationCapIcon, 'agent'),
archive_session: spec('saveToMemory', SaveIcon, 'agent'),
retrieve_flow_context: spec('prepareContext', LayersIcon, 'agent'),
};
/** The integrations agent: labelled by the app it works in, when known. */
export const INTEGRATIONS_AGENT_ID = 'integrations_agent';