Files
deepseek-harness/packages/web
Yichen Jiang ca119b0e10 fix(web-plugin-config): address review — one options snapshot per search, no public value exports
Three findings from review survived against the staged-save head:

The search provider read its options thunk per property, so a settings write
landing inside credential resolution sent the key resolved from the old
section to the endpoint named by the new one. Each operation now snapshots
once at its entry and threads that snapshot into credential resolution; a
regression test drives a commit into the middle of a search and pins that the
endpoint, model, and key all come from the section the search started on.

The /client entry exported components, controllers, and namespace constants
with no consumer, which the client export discipline allows only with sign-off.
Only types remain. The duplicate per-card Injected/Face interface pairs are
one declaration each now, so a member added to one side cannot silently miss
the other.

The credential state carries the reference it describes and its writability: a
reference change no longer projects the old answer onto the new name, an
out-of-order response for a stale reference is dropped, and a key that a
deployment sources from the process environment disables the control instead
of inviting a write the Host must refuse.

Also corrected three prose claims against the code they describe: the card's
fields do not differ by platform (the served schema does), the section's empty
line counts registered rather than visible cards and is read once, and the
search README overstated what a configuration surface learns about a key.
2026-08-11 11:16:42 +08:00
..
2026-08-11 03:20:36 +08:00
2026-08-11 03:20:36 +08:00
2026-08-11 03:20:36 +08:00
2026-08-11 03:20:36 +08:00

web/ — web capability family

English | 中文

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

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

The web capability decision 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; rationale (including deferred SSRF protection) in the web capability seam Agent Note.