Tools

Tools Reference

49 built-in tools available to agents. Each implements the Tool trait and auto-registers in the ToolRegistry.

Overview

Parallel Research agents have access to a comprehensive toolkit spanning web search, file operations, browser automation, OSINT pipelines, Git integration, and more. Tools are classified by parallelism safety for optimal concurrent execution.

🌐 Web 2 📁 Files 5 ⚡ Shell 3 🖥 Browser 5 👁 Vision 1 🔀 Git 6 📄 PDF 1 🔍 OSINT 6 ✅ Verification 3 💎 Enrichment 2 🧠 Meta 2

Web

`web_search`

Parallel-safe

Search the internet via the configured backend (Linkup/Exa/Tavily/Serper/Brave/Parallel/DuckDuckGo).

Parameter	Type	Description
`query`	string	Search query
`limit`	u32	Max results (default 10)

Returns: List of results (title, URL, snippet).

`web_fetch`

Parallel-safe

Download a page and convert HTML to readable text.

Parameter	Type	Description
`url`	string	Page URL
`extract_text`	bool	Extract text only (default true)

Returns: Page text (truncated to 50K chars).

Files

`file_read`

Parallel-safe

Read a file with optional partial reading support.

Parameter	Type	Description
`path`	string	File path
`offset`	u32?	Start line
`limit`	u32?	Number of lines

Note: Tracks read files for read-before-write validation.

`file_write`

Sequential

Write a file (creates directories automatically).

Parameter	Type	Description
`path`	string	File path
`content`	string	Content to write

Note: Per-path locking, updates file history.

`file_edit`

Sequential

Find/replace edit (surgical replacement).

Parameter	Type	Description
`path`	string	File path
`old_string`	string	What to replace
`new_string`	string	Replacement text

Validation: read-before-write, staleness check, size guard.

`glob`

Parallel-safe

Search files by glob pattern.

Parameter	Type	Description
`pattern`	string	Glob pattern (e.g. `*/.rs`)

`grep`

Parallel-safe

Search file contents with regex. Uses ripgrep when available.

Parameter	Type	Description
`pattern`	string	Regex pattern
`path`	string?	Search directory
`file_pattern`	string?	File filter

Shell

`shell`

Sequential

Execute a bash command.

Parameter	Type	Description
`command`	string	Command to execute
`timeout`	u64	Timeout in seconds (default 120)

Protection: Blocks destructive commands (rm -rf /, mkfs, fork bombs).

`python_exec`

Sequential

Execute Python code.

Parameter	Type	Description
`code`	string	Python code
`timeout`	u64?	Timeout

`node_exec`

Sequential

Execute Node.js code.

Parameter	Type	Description
`code`	string	JavaScript code
`timeout`	u64?	Timeout

Browser (CDP)

Requires Chrome running with --remote-debugging-port=9222. CDP availability is detected automatically.

`browser_navigate`

Sequential

Open a URL in the browser.

Parameter	Type	Description
`url`	string	URL to open

`browser_screenshot`

Sequential

Take a screenshot of the current page.

Returns: base64 image in metadata.base64.

`browser_click`

Sequential

Click an element by CSS selector.

Parameter	Type	Description
`selector`	string	CSS selector

`browser_type`

Sequential

Type text into an element.

Parameter	Type	Description
`selector`	string	CSS selector
`text`	string	Text to enter

`browser_extract`

Sequential

Extract text content from page (with JS rendering).

Returns: Page text (truncated to 50K).

Vision

`analyze_image`

Parallel-safe

Analyze an image via vision model (Qwen 3.8).

Parameter	Type	Description
`image`	string	File path or image URL
`prompt`	string?	What to analyze

Config: PARALLEL_VISION_API_BASE, PARALLEL_VISION_API_KEY, PARALLEL_VISION_MODEL.

Git

`git_status`

Parallel-safe

Show working tree status.

`git_diff`

Parallel-safe

Show changes.

Parameter	Type	Description
`staged`	bool?	Staged changes only
`path`	string?	Specific file

`git_log`

Parallel-safe

Commit history.

Parameter	Type	Description
`limit`	u32?	Max commits

`git_add`

Sequential

Add files to staging.

Parameter	Type	Description
`paths`	string[]	Files to add

`git_commit`

Sequential

Create a commit.

Parameter	Type	Description
`message`	string	Commit message

`git_push`

Sequential

Push to remote.

Parameter	Type	Description
`remote`	string?	Remote (default: origin)
`branch`	string?	Branch name

PDF

`pdf_extract`

Parallel-safe

Extract text from a PDF file.

Parameter	Type	Description
`path`	string	PDF file path

Returns: Text + page count. Supports ToUnicode CMaps, encryption (empty password).

OSINT / Lead Generation

`extract_contacts`

Parallel-safe

Extract contacts from text, HTML, or URL.

Parameter	Type	Description
`text`	string?	Text to analyze
`html`	string?	HTML to analyze
`url`	string?	URL to download and analyze

Returns: Emails, phones (E.164), social profiles, persons, companies — each with confidence and source.

`find_leads`

Parallel-safe

High-level lead search. Orchestrates business directories → corporate sites → social networks → contact extraction → deduplication.

Parameter	Type	Description
`industry`	string?	Industry
`location`	string?	Location
`company_size`	string?	Company size
`role_titles`	string[]?	Roles (CEO, CTO...)
`limit`	u32?	Max leads

`search_business_directory`

Parallel-safe

Search business directories (2GIS, Google Maps, Yandex Maps, Yellow Pages).

Parameter	Type	Description
`query`	string	What to search for
`city`	string?	City

Returns: Name, category, address, phone, website, email, rating.

`search_social`

Parallel-safe

Search people/companies on social networks (Twitter, Telegram, LinkedIn).

Parameter	Type	Description
`query`	string	Search query
`platform`	string?	Specific platform

`parse_corporate_site`

Parallel-safe

Parse corporate website: company info, team, contacts.

Parameter	Type	Description
`url`	string	Website URL

Returns: Company name, description, industry, size, contacts, team page URL, social profiles.

`search_news`

Parallel-safe

Search news/mentions (Serper News or Google News RSS).

Parameter	Type	Description
`query`	string	Who/what to search
`limit`	u32?	Max articles (default 10)

Returns: Title, URL, source, date, snippet + extracted persons/companies.

Verification

`verify_email`

Parallel-safe

Verify email: syntax, MX records, disposable, role-based checks.

Parameter	Type	Description
`email`	string	Email to verify

Returns: is_valid_syntax, domain_exists, mx_records, is_disposable, is_role_based, confidence.

`verify_phone`

Parallel-safe

Validate and normalize phone number (E.164).

Parameter	Type	Description
`phone`	string	Phone number

Returns: Normalized (E.164), country_code, country_name, is_valid, is_mobile.

`verify_social_profile`

Parallel-safe

Check if a social media profile exists.

Parameter	Type	Description
`url`	string	Profile URL

Returns: exists, platform, username, name, followers.

Enrichment

`enrich_company`

Parallel-safe

Enrich company data.

Parameter	Type	Description
`company_name`	string	Company name
`website`	string?	Website

Returns: Industry, size, revenue, founded, headquarters, description, technologies.

`enrich_person`

Parallel-safe

Enrich person data.

Parameter	Type	Description
`name`	string	Person name
`company`	string?	Company

Returns: Title, company, linkedin, twitter, email, phone, location, bio.

Parameter	Type	Description
`task`	string	Task for the sub-agent
`role`	string?	Role (default: researcher)

Parameter	Type	Description
`action`	string	`add` \| `replace` \| `remove` \| `batch`
`target`	string	`memory` \| `user`
`content`	string?	Content to write
`old_text`	string?	For replace/remove
`operations`	array?	For batch operations

Parallelism Safety

Tools are classified for smart parallelism:

Class	Tools	Behavior
Parallel-safe	web_search, web_fetch, file_read, glob, grep, pdf_extract, analyze_image, verify_, enrich_, search_*, extract_contacts, git_status, git_diff, git_log	Can execute in parallel
Sequential	file_write, file_edit, shell, python_exec, node_exec, browser_*, git_add, git_commit, git_push, spawn_agent, memory	Execute sequentially (exclusive access)

Path-overlap detection: Two file tools targeting the same path are automatically serialized.

Search Backends

Seven search backends are supported. Each is configured via [search.*] sub-sections in config.toml.

Backend	API Format	Key Required
`linkup`	Linkup Search API	Yes
`exa`	Exa Neural Search API	Yes
`tavily`	Tavily Search API	Yes
`serper`	Serper (Google) API	Yes
`brave`	Brave Search API	Yes
`parallel`	Parallel Search API	Yes
`duckduckgo`	DuckDuckGo Instant Answer	No

Hybrid & Smart Modes

`hybrid`

Tries configured backends in order (linkup → exa → tavily → serper → brave → parallel → duckduckgo). Returns results from the first backend that responds.

`smart`

Queries all configured backends in parallel. Deduplicates results by URL, then ranks using reciprocal rank fusion for optimal relevance.

Tools Reference

Overview

Web

web_search

web_fetch

Files

file_read

file_write

file_edit

glob

grep

Shell

shell

python_exec

node_exec

Browser (CDP)

browser_navigate

browser_screenshot

browser_click

browser_type

browser_extract

Vision

analyze_image

Git

git_status

git_diff

git_log

git_add

git_commit

git_push

PDF

pdf_extract

OSINT / Lead Generation

extract_contacts

find_leads

search_business_directory

search_social

parse_corporate_site

search_news

Verification

verify_email

verify_phone

verify_social_profile

Enrichment

enrich_company

enrich_person

Meta

spawn_agent

memory

Parallelism Safety

Search Backends

Hybrid & Smart Modes

hybrid

smart

`web_search`

`web_fetch`

`file_read`

`file_write`

`file_edit`

`glob`

`grep`

`shell`

`python_exec`

`node_exec`

`browser_navigate`

`browser_screenshot`

`browser_click`

`browser_type`

`browser_extract`

`analyze_image`

`git_status`

`git_diff`

`git_log`

`git_add`

`git_commit`

`git_push`

`pdf_extract`

`extract_contacts`

`find_leads`

`search_business_directory`

`search_social`

`parse_corporate_site`

`search_news`

`verify_email`

`verify_phone`

`verify_social_profile`

`enrich_company`

`enrich_person`

`spawn_agent`

`memory`

`hybrid`

`smart`