deepseek-web-retrieval 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to this project are documented here, one sentence per item.
 
+## 0.9.0
+
+- Accept an optional per-call `count` (1–50) on the MCP and Pi search tools and an optional per-call `maxChars` (0–1,000,000) on every adapter's fetch, each overriding the configured value for that one call.
+- Open the search result text with `Searched for: <effective query>` whenever domain or language operators — or fitting the query-length limit — changed what was actually searched, so the model can attribute what it sees.
+- Degrade gracefully instead of failing when search operators push a combined query past the API's 128-character limit: the query body truncates first, the language filter drops next, the include list last, and blocked domains never drop.
+- Align user-facing installer wording with the domain glossary: the secrets refusal and record-repair guidance now say "install record" instead of "state file" or "undo state".
+- Add the `baseUrl` knob (`DEEPSEEK_BASE_URL` environment variable or shared-file key) so every retrieval request can be routed through a proxy, enterprise gateway, or mock upstream; only an http(s) URL is accepted and anything else drops back to `https://api.deepseek.com`.
+- Add keyless `pi-mock` and `opencode-mock` Docker e2e scenarios that run real host session loops (pi via a custom `models.json` provider, OpenCode via a custom provider) against an in-container mock upstream, invoking both retrieval tools and asserting the tool results reached the model — closing CI's tool-execution blind spot without a billed key — and document the keyless (CI) versus billed (local, real API) e2e responsibilities with a `test:e2e:billed` script.
+
 ## 0.8.0
 
 - Add Claude Code as a supported host: an MCP-only integration registered in `.mcp.json` (project scope) or `~/.claude.json` (user scope), with a full installer host module (plan/apply/uninstall, both scopes), a `docs/agents/claude-code.md` guide, a version probe with drift note, and managed-policy detection that reports a `managed-settings.json` layer outranking the install.

package/README.md

@@ -127,10 +127,15 @@ binary files, per-request billing) are documented there.
 ### Search
 
 - Requests summaries only (`need_content: false`, falling back from `summary` to
-  `snippet`); full page content never enters the results.
+  `snippet`); full page content never enters the results. A summary the cap shortens ends
+  with an ellipsis.
 - Deduplicates URLs; an empty result set is normal, not an error.
-- Builds `blockedDomains`, `includeDomains`, and `language` into query operators, and
-  rejects the final query locally when it exceeds the API's 128-character limit.
+- Builds `blockedDomains`, `includeDomains`, and `language` into query operators (part of
+  DeepSeek's documented search syntax). A combined query over the API's 128-character limit
+  degrades instead of failing — the query body truncates first, the language filter drops
+  next, the include list last, and blocked domains never drop — and whenever operators or
+  degradation changed the query, the result text opens with `Searched for: <effective query>`
+  so the model can attribute what it sees.
 - Optional `rerank_score` and `authority` thresholds are off by default — the default
   returns exactly what DeepSeek ranked. A positive threshold drops results below it.
   A missing `rerank_score` is dropped too; an unknown `authority` stays unless
@@ -139,12 +144,15 @@ binary files, per-request billing) are documented there.
   the Pi extension), the tool accepts an optional `original_question`: the user's
   question in their own words. It is forwarded as DeepSeek's `ori_question`, trimmed
   and truncated to 128 characters; on the Pi extension, a blank input falls back to the
-  most recent user message in the session.
+  most recent user message in the session. Those paths also take an optional per-call
+  `count` (1–50) overriding the configured result count for that call.
 
 ### Fetch
 
 - Output is capped per the table above, title included; a `[content truncated]` marker
-  is added when the limit leaves room for it.
+  is added when the limit leaves room for it. An optional per-call `maxChars` parameter
+  (0–1,000,000) on every adapter overrides the configured cap for one call — a model that
+  sees the marker can widen the budget and re-fetch.
 - A page that already opens with its title as a top-level heading does not get a
   duplicate title.
 - URLs must be absolute `http://` or `https://`, credential-free, and at most 8,192