Metadata-Version: 2.4
Name: docketeer-web
Version: 0.0.8
Summary: Web tools plugin for Docketeer
Project-URL: Homepage, https://github.com/chrisguidry/docketeer
Project-URL: Repository, https://github.com/chrisguidry/docketeer
Project-URL: Issues, https://github.com/chrisguidry/docketeer/issues
Author-email: Chris Guidry <guid@omg.lol>
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.12
Requires-Dist: docketeer
Requires-Dist: httpx
Description-Content-Type: text/markdown

# docketeer-web

Web tools plugin for [Docketeer](https://pypi.org/project/docketeer/). Gives
the agent the ability to search the web, make HTTP requests, and download files
into its workspace.

Install `docketeer-web` alongside `docketeer` and the tools are automatically
available.

## Tools

- **`web_search`** — search the web via the [Brave Search API](https://brave.com/search/api/)
- **`web_request`** — make HTTP requests with content-aware body handling (HTML
  text extraction, large response summarization)
- **`download_file`** — download a file from a URL into the agent's workspace

## Configuration

| Variable                  | Default   | Description                                                            |
|---------------------------|-----------|------------------------------------------------------------------------|
| `DOCKETEER_BRAVE_API_KEY` | _(empty)_ | Brave Search API key. Without this, `web_search` won't return results. |

The `web_request` and `download_file` tools work without any additional
configuration.
