Agent Mode & Built-in Tools

1. What is Agent Mode in ZeroChat?

Agent Mode transforms the standard question-answer conversation into an autonomous, multi-turn reasoning loop (Agentic Loop).

When you submit a complex task, the model determines which tools it needs, issues structured function calls, ZeroChat runs the tool in your browser, and feeds the result back to the model until the goal is accomplished.

Max Turn Safety Limit (maxAgentTurns): In Settings, choose the maximum consecutive agent turns from 5 to 35 (15 by default) to limit loops and token use.

2. Built-in Tools Catalog

Tool Name	Description & Capabilities	Runtime Environment
`execute_javascript`	Runs local JavaScript for calculations, algorithmic logic, data restructuring, or string parsing under technical user supervision.	Local Web Worker with execution limits
`search_web`	Searches the live internet for recent news, technical documentation, or real-time data.	SearXNG or DuckDuckGo with zero API keys
`fetch_web_page`	Downloads a web page URL and converts it into clean, readable Markdown stripping ads and boilerplate.	HTTP client with anti-SSRF protections
`download_pdf`	Downloads PDF documents from URLs and extracts their textual content for LLM inspection.	In-browser client PDF parser
`render_chart`	Generates interactive native SVG charts (line, bar, scatter, etc.) rendered inline within the chat stream.	Client SVG renderer (`charts.js`)
`list_documents` `search_knowledge_base` `read_knowledge_chunk` `read_knowledge_image`	Inspects, searches, and reads document chunks from your local RAG knowledge branches.	Orama & IndexedDB client engine

agent_checkpoint lets the agent summarize findings and decide whether to continue researching or respond.

3. JavaScript Execution Under Technical Supervision

execute_javascript is a supporting tool for calculations, data processing, and algorithms. It is intended for use with the awareness and active supervision of a technical user, who can enable or disable it in Settings.

Web Worker execution: It normally runs in a separate thread to keep the interface responsive during calculations or heavier algorithms.
Time limit: If a script exceeds the configured time, ZeroChat stops the Worker.
Output limits: Excessive results are truncated and console messages are limited to preserve responsiveness.
Restricted APIs for calculations: The Worker neutralizes network and sub-worker APIs that are unnecessary for this tool.

4. Interactive Tool Cards

When an agent calls a tool, ZeroChat renders a dedicated Tool Card directly in the chat message flow:

Live status indicator: Displays an animated spinner while processing and a green checkmark or error alert upon completion.
Collapsible input & output: Expand the card to inspect the exact arguments passed to the function and the data returned.
Full session persistence: Tool cards and their expanded/collapsed state are preserved across session reloads.