Skip to main content
SCAIRE

Agent Tools

Tune Faire's internal tools: host-command output limits, visual rendering, and the active toolset.

Host Commands
~125
run_command tool, per turn
Render Visual
~18
lazy-mode tool description
Eager Mode
~1116
full visual-aids guide, per turn
Deliver
~51
result handoff tool, per turn

Host Commands

Active

Faire runs shell commands on the Proxmox host through this tool. Output past the size limit is trimmed so a single noisy command cannot bury the conversation.

Approximate cost: about 125 tokens per turn for the tool description.

Configuration

Caps each command's stdout at this many characters. Per command only; results still add up across a turn. Default 8000.

Which end of a command's output to keep when it exceeds the cap. Head (default) keeps the end where recent output lives.

Edit description on AI Context Capability Map Agent Tiers

Visual Rendering

Enabled

Lets Faire emit charts, widgets, and diagrams inline on the web chat and diagnostic reports. Non-web channels (email, Telegram) always see the fallback data table.

Approximate cost: in lazy mode, about 30 tokens for the brief mention plus about 18 for the tool description. In eager mode, about 1116 tokens per turn for the full guide in every system prompt.

Configuration

Let Faire emit charts, widgets, and diagrams in chat and diagnostics

Off by default to save tokens. When enabled, Faire can emit visual syntax that renders inline on the web chat and diagnostic reports. Non-web channels (email/Telegram) always see the fallback data table.

How visual syntax reaches Faire

Edit visual-aids guide on AI Context

Sub-Agent Delegation

Active

Faire can call user-built mini-agents as tools to delegate focused work. Each configured sub-agent adds its own description and schema to the tool list.

Approximate cost: varies per sub-agent. See the Sub-Agents page for the active set.

Configuration

Total tools Faire holds at once: run_command + MCP + sub-agents. Extra sub-agents drop first (default 30).

Manage Sub-Agents

Result Delivery

Internal

The deliver tool is the completion signal sub-agents call to hand their result back to Faire. It is injected automatically for sub-agent turns and has no page-level configuration.

Approximate cost: about 51 tokens per turn when the tool is active.

Edit description on AI Context

Visual PNG Delivery

Enabled

Renders each chart, widget, and diagram to a PNG server-side so email and Telegram receive real images instead of the fallback data table. Requires Node 22+, Chromium system libraries, and the puppeteer project dependency. Degrades silently to the table or text fallback when a prerequisite is missing. See docs/visual-rendering.md.

Configuration

Render charts, widgets, and diagrams to PNG for email and Telegram

Off by default. When enabled, SCAIRE renders each visual block server-side into a PNG so email and Telegram receive real images instead of the fallback data table or text. Requires host prerequisites (Node 22+, Chromium system libraries, the AppArmor namespace fix) plus the puppeteer project dependency. Degrades to the table or text fallback when a prerequisite is missing. See docs/visual-rendering.md.

Which delivery channels receive PNG images

Override the Chrome binary (blank = puppeteer auto-detect)

Node binary for the render worker (blank = PATH)

npm binary for the render worker (blank = PATH)

Seconds per visual block (default 30)