# AGENTS.md

## Project overview
- `pi-web-search` is a Pi extension package that exposes Exa-backed `web_search` and `web_fetch`.
- Entry point: `index.ts`.
- Runtime/config loading: `src/runtime.ts`, `src/config.ts`.
- Tool/input schemas: `src/schema.ts`.
- Exa SDK adapter helpers: `src/providers/exa.ts`.
- Tool adapters: `src/tools/`.
- Output formatting: `src/format.ts`.

## Commands
- Install deps: `npm install`
- Run tests: `npm test`

## Working conventions
- The package is Exa-only. Do not reintroduce provider registries, fallback graphs, or provider-specific option blocks.
- `web_search` should stay Exa-shaped and map closely to `exa.search(query, options)`.
- `web_fetch` should stay Exa-shaped and map closely to `exa.getContents(urls, options)`.
- Keep tool `details` close to raw Exa responses; keep human-readable formatting compact in `src/format.ts`.
- Prefer focused tests next to the changed modules.
- Update `README.md` and config examples when Exa config/schema or tool parameters change.

## Docs
- Design specs live under `docs/superpowers/specs/`.
- Use `YYYY-MM-DD-<topic>-design.md` naming for design specs.
- If a new spec supersedes an older one, say that explicitly in the newer file.