Built-in Tools

tether.tools.done

Mandatory explicit task completion tool (done).

tether.tools.bash

Sandboxed shell execution tool (bash).

tether.tools.edit

Workspace-jailed file viewing and stdin patching tool (edit).

tether.tools.web

Zero-config web search (DuckDuckGo Lite + Brave/Tavily/SearXNG env override) and reader.

PrivateAddressError

Bases: PermissionError

Raised when web fetch targets a loopback/private/link-local address (SSRF guard).

assert_public_url(request) async

Block fetches that resolve to non-global IPs (localhost, RFC1918, cloud metadata).

Runs as an httpx request hook, so every redirect hop is checked too. Opt out with TETHER_WEB_ALLOW_PRIVATE=1.

html_to_markdown(raw_html, max_chars=8000)

Convert raw HTML into compact markdown-friendly text.

search_web_backend(query, max_results=5) async

Search the web via SearXNG/Brave/Tavily if configured, else DuckDuckGo HTML.

tether.tools.mem

Working scratchpad (pin/unpin), FTS5 BM25 RAG (search), and observation recall.

tether.tools.agent

Always-async multi-agent orchestration and SQLite FTS5 BM25 RAG (agent).