pi-web-search/AGENTS.md

AGENTS.md

Project overview

• pi-web-search is a Pi extension package that exposes web_search and web_fetch.
• Entry point: index.ts.
• Runtime/provider selection: src/runtime.ts.
• Config/schema: src/config.ts, src/schema.ts.
• Provider adapters and provider-specific tests: src/providers/.
• Tool adapters: src/tools/.
• Interactive config command: src/commands/web-search-config.ts.

Commands

• Install deps: npm install
• Run tests: npm test

Working conventions

• Keep the public tool contract stable unless the current design/spec explicitly changes it.
• Add provider-specific request controls in nested blocks (for example tavily, firecrawl) instead of new top-level params.
• Normalize provider responses through src/providers/types.ts before formatting/output.
• Prefer focused tests next to the changed modules.
• Update README.md, config examples, and command flows when provider/config schema changes.

Docs

• Design specs live under docs/superpowers/specs/.
• Use YYYY-MM-DD-<topic>-design.md naming for design specs.