dsh-search-enhance 0.1.13 → 0.2.1

package/README.md

@@ -2,31 +2,29 @@
 
 English | [简体中文](README.zh.md)
 
-`dsh-search-enhance` is a search extension for DeepSeek Harness. It uses a Grok-compatible Search API for primary web answers and can optionally use Context7, Exa, Tavily, and Firecrawl for documentation lookup, supplementary discovery, page extraction, and site mapping.
+`dsh-search-enhance` is a search extension for DeepSeek Harness. It uses a Grok-compatible Search API for primary web answers and can optionally use Context7, Exa, Tavily, Firecrawl, and Parallel for documentation lookup, supplementary discovery, page extraction, and site mapping.
 
-The plugin handles search, source retention, and page retrieval as separate steps. `web_search` and `docs_search` return an answer or documentation snippets with visible sources; the complete source record can be stored under a `source_ref` and paged later. Important pages can then be retrieved with `web_extract`, so search snippets remain distinct from fetched page content.
+The plugin presents search results, sources, and page content separately. Searches return an answer or documentation snippets with source links; you can ask for more sources when needed. To check important details, ask it to read the original page. Search snippets remain distinct from fetched page content.
 
-> Bring your own endpoints and credentials. The plugin ships no API keys. A Grok-compatible endpoint is required for `web_search`; Context7, Exa, Tavily, and Firecrawl are optional.
-
-![A DSH Web session that searches, checks documentation, extracts an official page, and returns a sourced answer](https://raw.githubusercontent.com/umineko987/dsh-search-enhance/main/assets/search-workflow.png)
+> Bring your own endpoints and credentials. The plugin ships no API keys. A Grok-compatible endpoint is required for `web_search`; Context7, Exa, Tavily, Firecrawl, and Parallel are optional.
 
 ## Key characteristics
 
-- `web_search` uses the Grok-compatible endpoint for the main answer and runs all user-selected supplemental Providers (Exa, Tavily, Firecrawl) in parallel, with an independent per-Provider source limit.
+- `web_search` uses the Grok-compatible endpoint for the main answer and runs all user-selected supplemental Providers (Exa, Tavily, Firecrawl, Parallel) in parallel, with an independent per-Provider source limit.
 - Sources are normalized, de-duplicated, and reordered using source category, requested version, and publication-time signals before they are shown.
 - `source_ref` keeps the complete source record in private durable storage, allowing the Agent to paginate beyond the links included in the initial result.
 - `docs_search` uses Context7 only with an explicit `library_name` or `library_id`; requests without a library identity use Exa discovery.
-- `web_extract` requires one explicit `provider` from the user-enabled set: `tavily_extract`, `firecrawl_scrape`, `smart_direct`, or `direct`. It reports the route, evidence level, and available page metadata; failures never switch Providers.
-- Source pagination, Context7 detail operations, site mapping, research planning, and diagnostics are disclosed on demand through `search_tools` and `search_call`.
+- `web_extract` requires one explicit `provider` from the user-enabled set: `tavily_extract`, `firecrawl_scrape`, `parallel_extract`, `smart_direct`, or `direct`. It reports the route, evidence level, and available page metadata; failures never switch Providers.
+- Ask for more sources or related pages on a specific website when needed; no manual tool loading is required.
 - Supplemental search defaults to no Providers selected. Unselected Providers are never requested; missing credentials and failures of selected Providers remain visible as warnings.
 
-For the complete routing, evidence, and progressive-disclosure flow, see [Search workflow architecture](https://github.com/umineko987/dsh-search-enhance/blob/main/guides/search-workflow.md).
+For implementation details, see [Search workflow architecture](https://github.com/umineko987/dsh-search-enhance/blob/main/guides/search-workflow.md).
 
 ## Quick start
 
 ### 1. Install
 
-Supports DSH `0.1.7-rc.2`. DSH dependencies are pinned to this exact release.
+Supports DSH `0.2.0-rc.2`. DSH dependencies are pinned to this exact release; upgrade the DSH CLI first if you are running an older version.
 
 Install the [published npm bundle](https://www.npmjs.com/package/dsh-search-enhance) into the DSH `web` profile:
 
@@ -73,7 +71,7 @@ Use normal language; the plugin gives the Agent routing guidance.
 - “Look up the current FastAPI JWT authentication API and show a minimal example from the official documentation.”
 - “Read and summarize `https://example.com/article`, separating what the page states from your inference.”
 
-Ask explicitly when you need complete source pagination, site discovery, a research plan, or Provider diagnostics.
+Ask explicitly when you need more sources or pages from a specific website. Check the plugin settings for service configuration status.
 
 ## Providers
 
@@ -86,20 +84,21 @@ Configure only the routes you need.
 | Exa | Broad documentation and supplementary discovery | `EXA_API_KEY` | No |
 | Tavily | Supplementary search, page extraction, and site mapping | `TAVILY_API_KEY` | No |
 | Firecrawl | Supplementary search and page extraction | `FIRECRAWL_API_KEY` | No |
+| Parallel | Supplementary search and Markdown page extraction | `PARALLEL_API_KEY` | No |
 
 In the plugin settings, select any combination of **supplemental search Providers**. Each selected Provider runs alongside the main search, using `supplementalSearch.maxSourcesPerProvider` (default `5`, maximum `100`). This selection applies to all search profiles.
 
-Separately, select the **extraction Providers** available to the Agent. Each `web_extract` call must choose exactly one enabled Provider, for example `{ "url": "https://example.com/", "provider": "direct", "format": "markdown" }`. Disabled, unconfigured, unsupported, or failed Providers do not trigger automatic fallback. Extraction Providers are enabled by default; disable any you do not want the Agent to use.
+Separately, select the **extraction Providers** available to the Agent. Each `web_extract` call must choose exactly one enabled Provider, for example `{ "url": "https://example.com/", "provider": "direct", "format": "markdown" }`. Disabled, unconfigured, unsupported, or failed Providers do not trigger automatic fallback. Parallel extraction supports Markdown only and is disabled by default; enable it explicitly. Other extraction Providers are enabled by default; disable any you do not want the Agent to use.
 
 For `docs_search`, Context7 requires an explicit `library_name` or `library_id`. Without one, `provider: "auto"` uses Exa instead of guessing a package name from the full question.
 
-## Tool disclosure
+## On-demand features
 
-The model-facing surface has five tools: `web_search`, `docs_search`, `web_extract`, `search_tools`, and `search_call`. Advanced operations are disclosed through manifests rather than registered as additional model tools.
+To see more sources from a search, ask: “Show me the other sources from this search.”
 
-The default `progressive` mode activates a newly disclosed capability on the next model step. In `all` mode, deferred operations are active immediately. Native Tool Mode and Code Mode use the same schemas, execution policy, and canonical outputs.
+To find relevant pages on a website, ask: “Find pages about authentication on this website.” This feature requires Tavily to be configured.
 
-When `web_search` or `docs_search` returns a `source_ref`, the plugin automatically activates source pagination and appends its real operation manifest.
+The assistant uses these features when needed. You do not have to call tools manually or switch modes. To verify an important claim, you can then ask it to read the original pages.
 
 ## Update and uninstall
 

package/README.zh.md

@@ -2,31 +2,29 @@
 
 [English](README.md) | 简体中文
 
-`dsh-search-enhance` 是 DeepSeek Harness 的搜索增强插件。它使用 Grok-compatible Search API 生成普通网页搜索的主要回答，并可选用 Context7、Exa、Tavily 和 Firecrawl 完成文档检索、补充来源、网页正文提取和站点页面发现。
+`dsh-search-enhance` 是 DeepSeek Harness 的搜索增强插件。它使用 Grok-compatible Search API 生成普通网页搜索的主要回答，并可选用 Context7、Exa、Tavily、Firecrawl 和 Parallel 完成文档检索、补充来源、网页正文提取和站点页面发现。
 
-插件将搜索、来源保留和页面读取作为不同步骤处理。`web_search` 和 `docs_search` 返回搜索回答或文档片段以及可见来源；完整来源记录可通过 `source_ref` 保存并继续分页读取；需要核对重要内容时，再由 `web_extract` 获取选中页面。因此，搜索 snippet 与实际读取的网页正文会保持明确区分。
+插件将搜索结果、参考来源和网页正文分开呈现。搜索时先给出回答或文档片段及来源链接，需要更多来源时可以继续追问；核对重要内容时，再要求读取原网页。搜索摘要与实际读取的正文会明确区分。
 
-> 你需要自行提供所选服务的端点和凭据，插件不内置任何 API Key。`web_search` 需要 Grok-compatible 端点；Context7、Exa、Tavily 和 Firecrawl 均为可选 Provider。
-
-![DSH Web 会话：搜索、检索文档、提取官方页面并生成带来源的回答](https://raw.githubusercontent.com/umineko987/dsh-search-enhance/main/assets/search-workflow.png)
+> 你需要自行提供所选服务的端点和凭据，插件不内置任何 API Key。`web_search` 需要 Grok-compatible 端点；Context7、Exa、Tavily、Firecrawl 和 Parallel 均为可选 Provider。
 
 ## 主要特点
 
-- `web_search` 使用 Grok-compatible 端点生成主要回答，并行调用用户勾选的全部补充搜索 Provider（Exa、Tavily、Firecrawl），每家使用独立的来源数量上限。
+- `web_search` 使用 Grok-compatible 端点生成主要回答，并行调用用户勾选的全部补充搜索 Provider（Exa、Tavily、Firecrawl、Parallel），每家使用独立的来源数量上限。
 - 来源在展示前会经过 URL 标准化、去重，并根据来源类别、目标版本和发布时间信号重新排序。
 - `source_ref` 将完整来源记录保存在插件私有持久存储中，Agent 可以继续分页读取首次结果未展示的来源。
 - `docs_search` 只在提供明确 `library_name` 或 `library_id` 时使用 Context7；没有库身份的请求使用 Exa 发现。
-- `web_extract` 每次必须通过 `provider` 指定一家用户已启用的服务：`tavily_extract`、`firecrawl_scrape`、`smart_direct` 或 `direct`。结果报告提取路径、证据等级和页面元数据，失败不自动换服务。
-- 来源分页、Context7 精细操作、站点映射、研究计划和诊断通过 `search_tools` 与 `search_call` 按需披露。
+- `web_extract` 每次必须通过 `provider` 指定一家用户已启用的服务：`tavily_extract`、`firecrawl_scrape`、`parallel_extract`、`smart_direct` 或 `direct`。结果报告提取路径、证据等级和页面元数据，失败不自动换服务。
+- 需要时可继续查看更多来源，或查找某个网站下的相关页面，无需手动加载工具。
 - 补充搜索默认不选择任何 Provider。未选中的服务不会被请求；选中服务缺少凭据或执行失败会在结果中显示警告。
 
-完整的路由、证据处理和渐进披露流程见[搜索链路架构](https://github.com/umineko987/dsh-search-enhance/blob/main/guides/search-workflow.zh.md)。
+实现细节见[搜索链路架构](https://github.com/umineko987/dsh-search-enhance/blob/main/guides/search-workflow.zh.md)。
 
 ## 快速开始
 
 ### 1. 安装
 
-支持 DSH `0.1.7-rc.2`，DSH 依赖精确锁定到该版本。
+支持 DSH `0.2.0-rc.2`，DSH 依赖精确锁定到该版本；使用旧版本时，请先升级 DSH CLI。
 
 将 [npm 上发布的 bundle](https://www.npmjs.com/package/dsh-search-enhance) 安装到 DSH `web` profile：
 
@@ -73,7 +71,7 @@ dsh web
 - “查找 FastAPI 当前 JWT 认证 API，并根据官方文档给出最小示例。”
 - “读取并总结 `https://example.com/article`，区分页面原文与推断。”
 
-需要完整来源分页、站点发现、研究计划或 Provider 诊断时，请明确提出。
+需要更多参考来源或网站内的相关页面时，可以继续追问；服务配置状态可在插件设置中查看。
 
 ## Provider
 
@@ -86,20 +84,21 @@ dsh web
 | Exa | 广泛文档发现和补充发现 | `EXA_API_KEY` | 否 |
 | Tavily | 补充搜索、网页提取和站点映射 | `TAVILY_API_KEY` | 否 |
 | Firecrawl | 补充搜索和网页提取 | `FIRECRAWL_API_KEY` | 否 |
+| Parallel | 补充搜索和 Markdown 网页提取 | `PARALLEL_API_KEY` | 否 |
 
 在插件设置中，可以多选 **补充搜索 Provider**。选中项与主搜索并行执行，每家使用 `supplementalSearch.maxSourcesPerProvider` 限制来源数量（默认 `5`，最大 `100`）。选择对所有搜索 profile 生效。
 
-另外，多选 **网页提取 Provider** 可以限制 Agent 可用的服务范围。每次 `web_extract` 必须明确选择一家已启用服务，例如 `{ "url": "https://example.com/", "provider": "direct", "format": "markdown" }`。服务被禁用、缺少凭据、不支持格式或执行失败时，直接报告错误，不自动回退。提取服务默认全部启用，可取消勾选不希望使用的服务。
+另外，多选 **网页提取 Provider** 可以限制 Agent 可用的服务范围。每次 `web_extract` 必须明确选择一家已启用服务，例如 `{ "url": "https://example.com/", "provider": "direct", "format": "markdown" }`。服务被禁用、缺少凭据、不支持格式或执行失败时，直接报告错误，不自动回退。Parallel 提取仅支持 Markdown，默认关闭，需要手动启用；其他提取服务默认启用，可取消勾选不希望使用的服务。
 
 对于 `docs_search`，Context7 需要明确的 `library_name` 或 `library_id`。两者都未提供时，`provider: "auto"` 使用 Exa，不会根据完整问题猜测包名。
 
-## 工具披露
+## 按需功能
 
-模型可见入口始终是五个工具：`web_search`、`docs_search`、`web_extract`、`search_tools` 和 `search_call`。高级 operation 通过 manifest 披露，不会注册成更多模型工具。
+想查看更多搜索来源时，可以直接追问：“把这次搜索的其他来源也列出来。”
 
-默认 `progressive` 模式下，新披露的能力从下一模型 step 开始可调用。`all` 模式让延迟 operation 立即处于 active 状态。Native Tool Mode 与 Code Mode 使用相同 schema、执行策略和规范输出。
+想查找某个网站下的相关页面时，可以提出：“查找这个网站下与认证有关的页面。”该功能需要先配置 Tavily。
 
-`web_search` 或 `docs_search` 返回 `source_ref` 时，插件会自动激活来源分页，并追加对应的真实 operation manifest。
+助手会按需使用这些功能，你不必手动调用工具或切换模式。核对重要结论时，还可以继续要求读取原网页。
 
 ## 更新与卸载
 

package/client/client.js

@@ -18,16 +18,19 @@ window.__ModuleLoader__.load({
 			"context7",
 			"exa",
 			"tavily",
-			"firecrawl"
+			"firecrawl",
+			"parallel"
 		];
 		const WEB_SUPPLEMENTAL_SEARCH_PROVIDERS = [
 			"exa",
 			"tavily",
-			"firecrawl"
+			"firecrawl",
+			"parallel"
 		];
 		const WEB_EXTRACT_PROVIDER_KEYS = [
 			"tavily",
 			"firecrawl",
+			"parallel",
 			"smartDirect",
 			"direct"
 		];
@@ -35,6 +38,24 @@ window.__ModuleLoader__.load({
 			["defaultProfile"],
 			["defaultDepth"],
 			["toolTimeoutMs"],
+			["retention", "docsSearchMaxResults"],
+			...[
+				"auto",
+				"coding_docs",
+				"code_examples",
+				"project_research",
+				"academic",
+				"fact_check"
+			].flatMap((profile) => [
+				"compact",
+				"normal",
+				"deep"
+			].map((depth) => [
+				"budgets",
+				profile,
+				depth,
+				"maxVisibleSources"
+			])),
 			["toolDiscovery", "mode"],
 			...WEB_SUPPLEMENTAL_SEARCH_PROVIDERS.map((provider) => ["supplementalSearch", provider]),
 			["supplementalSearch", "maxSourcesPerProvider"],
@@ -109,6 +130,26 @@ window.__ModuleLoader__.load({
 				"firecrawl",
 				"timeoutMs"
 			],
+			[
+				"providers",
+				"parallel",
+				"baseUrl"
+			],
+			[
+				"providers",
+				"parallel",
+				"credentialRef"
+			],
+			[
+				"providers",
+				"parallel",
+				"timeoutMs"
+			],
+			[
+				"providers",
+				"parallel",
+				"mode"
+			],
 			[
 				"webExtract",
 				"smartDirect",
@@ -220,7 +261,8 @@ window.__ModuleLoader__.load({
 			"context7",
 			"exa",
 			"tavily",
-			"firecrawl"
+			"firecrawl",
+			"parallel"
 		];
 		const PROXY_ROUTES = [["smartDirect", "smartDirectProxy"], ["direct", "directProxy"]];
 		const CREDENTIAL_NAME_KEYS = {
@@ -228,7 +270,8 @@ window.__ModuleLoader__.load({
 			context7: "context7",
 			exa: "exa",
 			tavily: "tavily",
-			firecrawl: "firecrawl"
+			firecrawl: "firecrawl",
+			parallel: "parallel"
 		};
 		const cardStyle = {
 			overflow: "hidden",
@@ -407,6 +450,8 @@ window.__ModuleLoader__.load({
 				defaultProfile: config.defaultProfile,
 				defaultDepth: config.defaultDepth,
 				toolTimeoutMs: config.toolTimeoutMs,
+				retention: { ...config.retention },
+				budgets: Object.fromEntries(Object.entries(config.budgets).map(([profile, depths]) => [profile, Object.fromEntries(Object.entries(depths).map(([depth, budget]) => [depth, { ...budget }]))])),
 				toolDiscovery: { ...config.toolDiscovery },
 				supplementalSearch: { ...config.supplementalSearch },
 				searchApi: { ...config.searchApi },
@@ -414,11 +459,13 @@ window.__ModuleLoader__.load({
 					context7: { ...config.providers.context7 },
 					exa: { ...config.providers.exa },
 					tavily: { ...config.providers.tavily },
-					firecrawl: { ...config.providers.firecrawl }
+					firecrawl: { ...config.providers.firecrawl },
+					parallel: { ...config.providers.parallel }
 				},
 				webExtract: {
 					tavily: { ...config.webExtract.tavily },
 					firecrawl: { ...config.webExtract.firecrawl },
+					parallel: { ...config.webExtract.parallel },
 					smartDirect: { ...config.webExtract.smartDirect },
 					direct: { ...config.webExtract.direct }
 				}
@@ -667,7 +714,7 @@ window.__ModuleLoader__.load({
 			]);
 			const mutations = (0, react.useMemo)(() => snapshot === void 0 || draft === void 0 ? [] : mutationsFor(snapshot.value, draft), [draft, snapshot]);
 			const dirty = mutations.length > 0;
-			const valid = draft !== void 0 && snapshot !== void 0 && validTimeouts(draft) && validSupplementalSearch(draft, snapshot.options.supplementalSearchMaxSources);
+			const valid = draft !== void 0 && snapshot !== void 0 && validTimeouts(draft) && validSupplementalSearch(draft, snapshot.options.supplementalSearchMaxSources) && Number.isInteger(draft.retention.docsSearchMaxResults) && draft.retention.docsSearchMaxResults >= snapshot.options.docsSearchMinResults && draft.retention.docsSearchMaxResults <= snapshot.options.docsSearchMaxResults && Object.values(draft.budgets).every((depths) => Object.values(depths).every((budget) => Number.isInteger(budget.maxVisibleSources) && budget.maxVisibleSources >= 0 && budget.maxVisibleSources <= snapshot.options.visibleSourcesMax));
 			const editable = phase === "ready" && snapshot?.writable === true && !saving;
 			const updateProvider = (provider, value) => {
 				setDraft((current) => current === void 0 ? current : provider === "searchApi" ? {
@@ -989,6 +1036,60 @@ window.__ModuleLoader__.load({
 												}
 											})
 										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+											label: t("maxVisibleSources"),
+											overridden: isOverridden(snapshot.user, [
+												"budgets",
+												draft.defaultProfile,
+												draft.defaultDepth,
+												"maxVisibleSources"
+											]),
+											t,
+											hint: t("maxVisibleSourcesHint"),
+											children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NumberInput, {
+												label: t("maxVisibleSources"),
+												value: draft.budgets[draft.defaultProfile][draft.defaultDepth].maxVisibleSources,
+												min: 0,
+												max: snapshot.options.visibleSourcesMax,
+												disabled: !editable,
+												onChange: (maxVisibleSources) => {
+													setDraft((current) => current === void 0 ? current : {
+														...current,
+														budgets: {
+															...current.budgets,
+															[current.defaultProfile]: {
+																...current.budgets[current.defaultProfile],
+																[current.defaultDepth]: { maxVisibleSources }
+															}
+														}
+													});
+													setFeedback("idle");
+												}
+											})
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+											label: t("docsSearchMaxResults"),
+											overridden: isOverridden(snapshot.user, ["retention", "docsSearchMaxResults"]),
+											t,
+											hint: t("docsSearchMaxResultsHint"),
+											children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NumberInput, {
+												label: t("docsSearchMaxResults"),
+												value: draft.retention.docsSearchMaxResults,
+												min: snapshot.options.docsSearchMinResults,
+												max: snapshot.options.docsSearchMaxResults,
+												disabled: !editable,
+												onChange: (docsSearchMaxResults) => {
+													setDraft((current) => current === void 0 ? current : {
+														...current,
+														retention: {
+															...current.retention,
+															docsSearchMaxResults
+														}
+													});
+													setFeedback("idle");
+												}
+											})
+										}),
 										/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
 											label: t("toolTimeoutMs"),
 											overridden: isOverridden(snapshot.user, ["toolTimeoutMs"]),
@@ -1027,30 +1128,60 @@ window.__ModuleLoader__.load({
 										...gridStyle,
 										alignItems: "end"
 									},
-									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ProviderSelect, {
-										label: t("extraSourcesHeading"),
-										providers: WEB_SUPPLEMENTAL_SEARCH_PROVIDERS,
-										selected: WEB_SUPPLEMENTAL_SEARCH_PROVIDERS.filter((provider) => draft.supplementalSearch[provider]),
-										disabled: !editable,
-										t,
-										onToggle: (provider) => {
-											updateSupplementalSearch({ [provider]: !draft.supplementalSearch[provider] });
-										}
-									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
-										label: t("maxSourcesPerProvider"),
-										overridden: isOverridden(snapshot.user, ["supplementalSearch", "maxSourcesPerProvider"]),
-										t,
-										children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NumberInput, {
-											label: t("maxSourcesPerProvider"),
-											value: draft.supplementalSearch.maxSourcesPerProvider,
-											min: 1,
-											max: snapshot.options.supplementalSearchMaxSources,
+									children: [
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ProviderSelect, {
+											label: t("extraSourcesHeading"),
+											providers: WEB_SUPPLEMENTAL_SEARCH_PROVIDERS,
+											selected: WEB_SUPPLEMENTAL_SEARCH_PROVIDERS.filter((provider) => draft.supplementalSearch[provider]),
 											disabled: !editable,
-											onChange: (value) => {
-												updateSupplementalSearch({ maxSourcesPerProvider: value });
+											t,
+											onToggle: (provider) => {
+												updateSupplementalSearch({ [provider]: !draft.supplementalSearch[provider] });
 											}
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+											label: t("maxSourcesPerProvider"),
+											overridden: isOverridden(snapshot.user, ["supplementalSearch", "maxSourcesPerProvider"]),
+											t,
+											children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NumberInput, {
+												label: t("maxSourcesPerProvider"),
+												value: draft.supplementalSearch.maxSourcesPerProvider,
+												min: 1,
+												max: snapshot.options.supplementalSearchMaxSources,
+												disabled: !editable,
+												onChange: (value) => {
+													updateSupplementalSearch({ maxSourcesPerProvider: value });
+												}
+											})
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+											label: t("parallelSearchMode"),
+											overridden: isOverridden(snapshot.user, [
+												"providers",
+												"parallel",
+												"mode"
+											]),
+											t,
+											children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Select, {
+												value: draft.providers.parallel.mode,
+												options: snapshot.options.parallelSearchModes,
+												disabled: !editable,
+												onChange: (mode) => {
+													setDraft((current) => current === void 0 ? current : {
+														...current,
+														providers: {
+															...current.providers,
+															parallel: {
+																...current.providers.parallel,
+																mode
+															}
+														}
+													});
+													setFeedback("idle");
+												}
+											})
 										})
-									})]
+									]
 								})]
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
@@ -1086,6 +1217,10 @@ window.__ModuleLoader__.load({
 											setFeedback("idle");
 										}
 									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+										style: noteStyle,
+										children: t("parallelExtractHint")
+									}),
 									/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 										style: sectionStyle,
 										"aria-labelledby": "search-enhance-proxy-heading",
@@ -1380,11 +1515,16 @@ window.__ModuleLoader__.load({
 			strategyIntro: "Defaults used when a tool call does not choose its own profile or depth.",
 			defaultProfile: "Default profile",
 			defaultDepth: "Default depth",
+			maxVisibleSources: "Initial web_search source limit",
+			maxVisibleSourcesHint: "Applies to the profile/depth selected above, not Provider collection or storage. Use source_ref for retained sources; model-text byte limits still apply.",
+			docsSearchMaxResults: "docs_search request ceiling",
+			docsSearchMaxResultsHint: "Allows max_results values from 1 up to this ceiling (default call: 6). Does not override an explicit smaller value. Collect more by increasing max_results and rerunning; pagination reads only retained records.",
 			toolDiscoveryMode: "Tool discovery",
 			toolTimeoutMs: "Whole tool timeout (ms)",
 			extraSourcesHeading: "Supplemental search providers",
-			extraSourcesIntro: "Select any of Exa, Tavily, and Firecrawl. Every selected provider searches in parallel.",
+			extraSourcesIntro: "Select any of Exa, Tavily, Firecrawl, and Parallel. Every selected provider searches in parallel.",
 			selectProviders: "Select providers (multiple allowed)",
+			parallelSearchMode: "Parallel search mode",
 			maxSourcesPerProvider: "Maximum sources per selected provider",
 			extractHeading: "Available extraction providers",
 			extractIntro: "Select the providers the Agent may use. Each web_extract call must explicitly choose one enabled provider. Failure never triggers automatic fallback.",
@@ -1394,6 +1534,8 @@ window.__ModuleLoader__.load({
 			exa: "Exa",
 			tavily: "Tavily",
 			firecrawl: "Firecrawl",
+			parallel: "Parallel",
+			parallelExtractHint: "Parallel returns Markdown only. It may use indexed content up to 10 minutes old, but does not fall back to older cached content when live fetching fails.",
 			proxyHeading: "Web extraction proxies",
 			proxyIntro: "Optional HTTP proxies for the local smart_direct and direct extraction routes. Leave a field blank to remove its user override.",
 			smartDirectProxy: "smart_direct HTTP proxy",
@@ -1432,7 +1574,7 @@ window.__ModuleLoader__.load({
 			conflict: "The configuration changed elsewhere. Reload before saving again.",
 			saveFailed: "The configuration could not be saved.",
 			readOnly: "The Settings document is read-only.",
-			invalidNumber: "Timeouts must be positive whole numbers, and supplementary source counts must be whole numbers within their allowed range.",
+			invalidNumber: "Timeouts must be positive whole numbers; source and request limits must be whole numbers within their allowed range.",
 			overridden: "User override",
 			inherited: "Inherited"
 		};
@@ -1458,11 +1600,16 @@ window.__ModuleLoader__.load({
 			strategyIntro: "工具调用未显式选择 profile 或 depth 时使用这些默认值。",
 			defaultProfile: "默认 Profile",
 			defaultDepth: "默认深度",
+			maxVisibleSources: "web_search 首次展示来源上限",
+			maxVisibleSourcesHint: "只影响上方所选 Profile / 深度的首次展示，不限制服务收集或存储；已保留来源可通过 source_ref 分页，模型文本仍受字节上限约束。",
+			docsSearchMaxResults: "docs_search 请求数量最高值",
+			docsSearchMaxResultsHint: "允许 max_results 从 1 到此最高值（调用默认 6 条），不会覆盖模型明确传入的较小值。需要更多结果时提高 max_results 后重搜；分页只能读取已保留记录。",
 			toolDiscoveryMode: "工具披露模式",
 			toolTimeoutMs: "工具总超时（毫秒）",
 			extraSourcesHeading: "补充搜索服务",
-			extraSourcesIntro: "可多选 Exa、Tavily、Firecrawl；每次搜索都会并行请求选中项。",
+			extraSourcesIntro: "可多选 Exa、Tavily、Firecrawl、Parallel；每次搜索都会并行请求选中项。",
 			selectProviders: "选择服务（可多选）",
+			parallelSearchMode: "Parallel 搜索模式",
 			maxSourcesPerProvider: "每个选中服务的来源上限",
 			extractHeading: "可用网页提取服务",
 			extractIntro: "可多选允许 Agent 使用的服务。每次 web_extract 必须明确指定其中一家；失败不自动回退。",
@@ -1472,6 +1619,8 @@ window.__ModuleLoader__.load({
 			exa: "Exa",
 			tavily: "Tavily",
 			firecrawl: "Firecrawl",
+			parallel: "Parallel",
+			parallelExtractHint: "Parallel 仅返回 Markdown 正文，可能使用最近 10 分钟内的缓存；实时读取失败时不退回更旧的缓存。",
 			proxyHeading: "网页提取代理",
 			proxyIntro: "分别为本地 smart_direct 与 direct 提取路线设置可选 HTTP 代理；留空会删除对应的用户覆盖。",
 			smartDirectProxy: "smart_direct HTTP 代理",
@@ -1510,7 +1659,7 @@ window.__ModuleLoader__.load({
 			conflict: "配置已在其他位置发生变化。请重新读取后再保存。",
 			saveFailed: "无法保存配置。",
 			readOnly: "Settings 文档为只读。",
-			invalidNumber: "超时必须是正整数；补充来源数量必须是允许范围内的整数。",
+			invalidNumber: "超时必须是正整数；来源与请求数量上限必须是允许范围内的整数。",
 			overridden: "用户覆盖",
 			inherited: "继承值"
 		};

package/client/types/client/locales.d.ts

@@ -20,11 +20,16 @@ export declare const en: {
     readonly strategyIntro: "Defaults used when a tool call does not choose its own profile or depth.";
     readonly defaultProfile: "Default profile";
     readonly defaultDepth: "Default depth";
+    readonly maxVisibleSources: "Initial web_search source limit";
+    readonly maxVisibleSourcesHint: "Applies to the profile/depth selected above, not Provider collection or storage. Use source_ref for retained sources; model-text byte limits still apply.";
+    readonly docsSearchMaxResults: "docs_search request ceiling";
+    readonly docsSearchMaxResultsHint: "Allows max_results values from 1 up to this ceiling (default call: 6). Does not override an explicit smaller value. Collect more by increasing max_results and rerunning; pagination reads only retained records.";
     readonly toolDiscoveryMode: "Tool discovery";
     readonly toolTimeoutMs: "Whole tool timeout (ms)";
     readonly extraSourcesHeading: "Supplemental search providers";
-    readonly extraSourcesIntro: "Select any of Exa, Tavily, and Firecrawl. Every selected provider searches in parallel.";
+    readonly extraSourcesIntro: "Select any of Exa, Tavily, Firecrawl, and Parallel. Every selected provider searches in parallel.";
     readonly selectProviders: "Select providers (multiple allowed)";
+    readonly parallelSearchMode: "Parallel search mode";
     readonly maxSourcesPerProvider: "Maximum sources per selected provider";
     readonly extractHeading: "Available extraction providers";
     readonly extractIntro: "Select the providers the Agent may use. Each web_extract call must explicitly choose one enabled provider. Failure never triggers automatic fallback.";
@@ -34,6 +39,8 @@ export declare const en: {
     readonly exa: "Exa";
     readonly tavily: "Tavily";
     readonly firecrawl: "Firecrawl";
+    readonly parallel: "Parallel";
+    readonly parallelExtractHint: "Parallel returns Markdown only. It may use indexed content up to 10 minutes old, but does not fall back to older cached content when live fetching fails.";
     readonly proxyHeading: "Web extraction proxies";
     readonly proxyIntro: "Optional HTTP proxies for the local smart_direct and direct extraction routes. Leave a field blank to remove its user override.";
     readonly smartDirectProxy: "smart_direct HTTP proxy";
@@ -72,7 +79,7 @@ export declare const en: {
     readonly conflict: "The configuration changed elsewhere. Reload before saving again.";
     readonly saveFailed: "The configuration could not be saved.";
     readonly readOnly: "The Settings document is read-only.";
-    readonly invalidNumber: "Timeouts must be positive whole numbers, and supplementary source counts must be whole numbers within their allowed range.";
+    readonly invalidNumber: "Timeouts must be positive whole numbers; source and request limits must be whole numbers within their allowed range.";
     readonly overridden: "User override";
     readonly inherited: "Inherited";
 };

package/client/types/web-config/contracts.d.ts

@@ -4,10 +4,10 @@ export declare const WEB_BASE_URL_MAX_CHARACTERS = 8192;
 export declare const WEB_MODEL_MAX_CHARACTERS = 4096;
 export declare const WEB_CREDENTIAL_REF_MAX_CHARACTERS = 256;
 export declare const WEB_CREDENTIAL_VALUE_MAX_CHARACTERS: number;
-export declare const WEB_CREDENTIAL_SLOTS: readonly ["searchApi", "context7", "exa", "tavily", "firecrawl"];
+export declare const WEB_CREDENTIAL_SLOTS: readonly ["searchApi", "context7", "exa", "tavily", "firecrawl", "parallel"];
 export type WebCredentialSlot = (typeof WEB_CREDENTIAL_SLOTS)[number];
-export declare const WEB_SUPPLEMENTAL_SEARCH_PROVIDERS: readonly ["exa", "tavily", "firecrawl"];
-export declare const WEB_EXTRACT_PROVIDER_KEYS: readonly ["tavily", "firecrawl", "smartDirect", "direct"];
+export declare const WEB_SUPPLEMENTAL_SEARCH_PROVIDERS: readonly ["exa", "tavily", "firecrawl", "parallel"];
+export declare const WEB_EXTRACT_PROVIDER_KEYS: readonly ["tavily", "firecrawl", "parallel", "smartDirect", "direct"];
 export declare const WEB_EDITABLE_PATHS: readonly (readonly string[])[];
 export interface WebSearchApiConfig {
     baseUrl: string;
@@ -30,6 +30,12 @@ export interface WebEditableConfig {
     defaultProfile: string;
     defaultDepth: string;
     toolTimeoutMs: number;
+    retention: {
+        docsSearchMaxResults: number;
+    };
+    budgets: Record<string, Record<string, {
+        maxVisibleSources: number;
+    }>>;
     toolDiscovery: {
         mode: string;
     };
@@ -42,6 +48,9 @@ export interface WebEditableConfig {
         exa: WebDiscoveryProviderConfig;
         tavily: WebDiscoveryProviderConfig;
         firecrawl: WebDiscoveryProviderConfig;
+        parallel: WebDiscoveryProviderConfig & {
+            mode: string;
+        };
     };
     webExtract: {
         tavily: {
@@ -50,6 +59,9 @@ export interface WebEditableConfig {
         firecrawl: {
             enabled: boolean;
         };
+        parallel: {
+            enabled: boolean;
+        };
         smartDirect: WebProxyConfig;
         direct: WebProxyConfig;
     };
@@ -67,8 +79,12 @@ export interface WebConfigOptions {
     protocols: readonly string[];
     thinkingLevels: readonly string[];
     toolDiscoveryModes: readonly string[];
+    parallelSearchModes: readonly string[];
     proxyUrlMaxCharacters: number;
     supplementalSearchMaxSources: number;
+    docsSearchMinResults: number;
+    docsSearchMaxResults: number;
+    visibleSourcesMax: number;
 }
 export interface WebCredentialState {
     ref: string;