packages/web/README.md

# web/ — web capability family

English | [中文](README.zh.md)

This family provides provider-neutral web search and fetch operations plus the model-facing tools that consume them.

| Package | Role | ctx key |
|---|---|---|
| [`web/`](web/README.md) | Defines web provider registration, selection, and shared errors | `ctx.web` |
| [`web-search-exa/`](web-search-exa/README.md) | Provides web search through Exa | registers on `ctx.web` |
| [`web-search-perplexity/`](web-search-perplexity/README.md) | Provides web search through Perplexity | registers on `ctx.web` |
| [`web-search-deepseek/`](web-search-deepseek/README.md) | Provides native DeepSeek web search | registers on `ctx.web` |
| [`web-fetch-local/`](web-fetch-local/README.md) | Fetches public HTTP and HTTPS resources | registers on `ctx.web` |
| [`tool-web/`](tool-web/README.md) | Exposes web search and fetch to the model | registers on `ctx.tools` |

The [web capability decision](../../.agents/notes/implemented/architecture/2026-06-24-web-capability-seam.md) records why search and fetch share one provider-selection service.

The subsystem reference — search/fetch requests and results, availability, `WebError` — is [docs/subsystems/web.md](../../docs/subsystems/web.md); rationale (including deferred SSRF protection) in the [web capability seam Agent Note](../../.agents/notes/implemented/architecture/2026-06-24-web-capability-seam.md).
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`# web/ — web capability family`
Add web capability seam: ctx.web, search/fetch providers, web tools 2026-06-25 15:04:12 +08:00
docs: translate remaining READMEs 2026-07-26 05:03:53 +08:00			`English \| [中文](README.zh.md)`

docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`This family provides provider-neutral web search and fetch operations plus the model-facing tools that consume them.`
Add web capability seam: ctx.web, search/fetch providers, web tools 2026-06-25 15:04:12 +08:00
			`\| Package \| Role \| ctx key \|`
			`\|---\|---\|---\|`
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			\| [`web/`](web/README.md) \| Defines web provider registration, selection, and shared errors \| `ctx.web` \|
			\| [`web-search-exa/`](web-search-exa/README.md) \| Provides web search through Exa \| registers on `ctx.web` \|
			\| [`web-search-perplexity/`](web-search-perplexity/README.md) \| Provides web search through Perplexity \| registers on `ctx.web` \|
			\| [`web-search-deepseek/`](web-search-deepseek/README.md) \| Provides native DeepSeek web search \| registers on `ctx.web` \|
			\| [`web-fetch-local/`](web-fetch-local/README.md) \| Fetches public HTTP and HTTPS resources \| registers on `ctx.web` \|
			\| [`tool-web/`](tool-web/README.md) \| Exposes web search and fetch to the model \| registers on `ctx.tools` \|
Add web capability seam: ctx.web, search/fetch providers, web tools 2026-06-25 15:04:12 +08:00
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`The [web capability decision](../../.agents/notes/implemented/architecture/2026-06-24-web-capability-seam.md) records why search and fetch share one provider-selection service.`
docs: anchor each subsystem page to its package group; make group READMEs thin tables 2026-08-02 05:54:15 +08:00
			The subsystem reference — search/fetch requests and results, availability, `WebError` — is [docs/subsystems/web.md](../../docs/subsystems/web.md); rationale (including deferred SSRF protection) in the [web capability seam Agent Note](../../.agents/notes/implemented/architecture/2026-06-24-web-capability-seam.md).