dsh-search-enhance 0.1.12 → 0.2.0

package/README.md

@@ -4,7 +4,7 @@ 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.
 
-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.
 
@@ -17,16 +17,16 @@ The plugin handles search, source retention, and page retrieval as separate step
 - `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`.
+- 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 +73,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
 
@@ -93,13 +93,13 @@ Separately, select the **extraction Providers** available to the Agent. Each `we
 
 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

@@ -4,7 +4,7 @@
 
 `dsh-search-enhance` 是 DeepSeek Harness 的搜索增强插件。它使用 Grok-compatible Search API 生成普通网页搜索的主要回答，并可选用 Context7、Exa、Tavily 和 Firecrawl 完成文档检索、补充来源、网页正文提取和站点页面发现。
 
-插件将搜索、来源保留和页面读取作为不同步骤处理。`web_search` 和 `docs_search` 返回搜索回答或文档片段以及可见来源；完整来源记录可通过 `source_ref` 保存并继续分页读取；需要核对重要内容时，再由 `web_extract` 获取选中页面。因此，搜索 snippet 与实际读取的网页正文会保持明确区分。
+插件将搜索结果、参考来源和网页正文分开呈现。搜索时先给出回答或文档片段及来源链接，需要更多来源时可以继续追问；核对重要内容时，再要求读取原网页。搜索摘要与实际读取的正文会明确区分。
 
 > 你需要自行提供所选服务的端点和凭据，插件不内置任何 API Key。`web_search` 需要 Grok-compatible 端点；Context7、Exa、Tavily 和 Firecrawl 均为可选 Provider。
 
@@ -17,16 +17,16 @@
 - `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` 按需披露。
+- 需要时可继续查看更多来源，或查找某个网站下的相关页面，无需手动加载工具。
 - 补充搜索默认不选择任何 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 +73,7 @@ dsh web
 - “查找 FastAPI 当前 JWT 认证 API，并根据官方文档给出最小示例。”
 - “读取并总结 `https://example.com/article`，区分页面原文与推断。”
 
-需要完整来源分页、站点发现、研究计划或 Provider 诊断时，请明确提出。
+需要更多参考来源或网站内的相关页面时，可以继续追问；服务配置状态可在插件设置中查看。
 
 ## Provider
 
@@ -93,13 +93,13 @@ dsh web
 
 对于 `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"
 		];
@@ -109,6 +112,26 @@ window.__ModuleLoader__.load({
 				"firecrawl",
 				"timeoutMs"
 			],
+			[
+				"providers",
+				"parallel",
+				"baseUrl"
+			],
+			[
+				"providers",
+				"parallel",
+				"credentialRef"
+			],
+			[
+				"providers",
+				"parallel",
+				"timeoutMs"
+			],
+			[
+				"providers",
+				"parallel",
+				"mode"
+			],
 			[
 				"webExtract",
 				"smartDirect",
@@ -220,7 +243,8 @@ window.__ModuleLoader__.load({
 			"context7",
 			"exa",
 			"tavily",
-			"firecrawl"
+			"firecrawl",
+			"parallel"
 		];
 		const PROXY_ROUTES = [["smartDirect", "smartDirectProxy"], ["direct", "directProxy"]];
 		const CREDENTIAL_NAME_KEYS = {
@@ -228,7 +252,8 @@ window.__ModuleLoader__.load({
 			context7: "context7",
 			exa: "exa",
 			tavily: "tavily",
-			firecrawl: "firecrawl"
+			firecrawl: "firecrawl",
+			parallel: "parallel"
 		};
 		const cardStyle = {
 			overflow: "hidden",
@@ -414,11 +439,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 }
 				}
@@ -1027,30 +1054,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 +1143,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",
@@ -1383,8 +1444,9 @@ window.__ModuleLoader__.load({
 			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 +1456,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",
@@ -1461,8 +1525,9 @@ window.__ModuleLoader__.load({
 			toolDiscoveryMode: "工具披露模式",
 			toolTimeoutMs: "工具总超时（毫秒）",
 			extraSourcesHeading: "补充搜索服务",
-			extraSourcesIntro: "可多选 Exa、Tavily、Firecrawl；每次搜索都会并行请求选中项。",
+			extraSourcesIntro: "可多选 Exa、Tavily、Firecrawl、Parallel；每次搜索都会并行请求选中项。",
 			selectProviders: "选择服务（可多选）",
+			parallelSearchMode: "Parallel 搜索模式",
 			maxSourcesPerProvider: "每个选中服务的来源上限",
 			extractHeading: "可用网页提取服务",
 			extractIntro: "可多选允许 Agent 使用的服务。每次 web_extract 必须明确指定其中一家；失败不自动回退。",
@@ -1472,6 +1537,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 代理",

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

@@ -23,8 +23,9 @@ export declare const en: {
     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 +35,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";

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;
@@ -42,6 +42,9 @@ export interface WebEditableConfig {
         exa: WebDiscoveryProviderConfig;
         tavily: WebDiscoveryProviderConfig;
         firecrawl: WebDiscoveryProviderConfig;
+        parallel: WebDiscoveryProviderConfig & {
+            mode: string;
+        };
     };
     webExtract: {
         tavily: {
@@ -50,6 +53,9 @@ export interface WebEditableConfig {
         firecrawl: {
             enabled: boolean;
         };
+        parallel: {
+            enabled: boolean;
+        };
         smartDirect: WebProxyConfig;
         direct: WebProxyConfig;
     };
@@ -67,6 +73,7 @@ export interface WebConfigOptions {
     protocols: readonly string[];
     thinkingLevels: readonly string[];
     toolDiscoveryModes: readonly string[];
+    parallelSearchModes: readonly string[];
     proxyUrlMaxCharacters: number;
     supplementalSearchMaxSources: number;
 }

package/lib/config.d.ts

@@ -8,7 +8,7 @@ export type SearchDepth = (typeof SEARCH_DEPTHS)[number];
 export declare const TOOL_DISCOVERY_MODES: readonly ["progressive", "all"];
 export type ToolDiscoveryMode = (typeof TOOL_DISCOVERY_MODES)[number];
 export interface ToolDiscoveryConfig {
-    /** progressive gates deferred operations per Agent; all activates every operation. */
+    /** progressive loads real tools per Agent on demand; all registers them at attachment. */
     readonly mode: ToolDiscoveryMode;
 }
 /** Stable high-level docs_search default; the Settings cap is independently bounded. */
@@ -20,9 +20,6 @@ export declare const SITE_MAP_DEFAULT_MAX_BREADTH = 10;
 export declare const SITE_MAP_DEFAULT_LIMIT = 30;
 export declare const SITE_MAP_MAX_DEPTH = 5;
 export declare const SITE_MAP_MAX_LINKS = 500;
-/** Hard model-contract bounds for the one-shot offline research planner. */
-export declare const RESEARCH_PLAN_MAX_KNOWN_URLS = 10;
-export declare const RESEARCH_PLAN_MAX_SUB_QUERIES = 6;
 export declare const SEARCH_API_PROTOCOLS: readonly ["completions", "responses"];
 export type SearchApiProtocol = (typeof SEARCH_API_PROTOCOLS)[number];
 export declare const THINKING_LEVELS: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
@@ -40,7 +37,7 @@ export interface OutputBudget {
 }
 export type ProfileBudgets = Record<SearchDepth, OutputBudget>;
 export type SearchBudgets = Record<SearchProfile, ProfileBudgets>;
-export declare const SUPPLEMENTAL_SEARCH_PROVIDERS: readonly ["exa", "tavily", "firecrawl"];
+export declare const SUPPLEMENTAL_SEARCH_PROVIDERS: readonly ["exa", "tavily", "firecrawl", "parallel"];
 export type SupplementalSearchProvider = (typeof SUPPLEMENTAL_SEARCH_PROVIDERS)[number];
 export type SupplementalSearchConfig = Record<SupplementalSearchProvider, boolean> & {
     readonly maxSourcesPerProvider: number;
@@ -51,6 +48,7 @@ export interface CredentialReferences {
     readonly exa: CredentialRef;
     readonly tavily: CredentialRef;
     readonly firecrawl: CredentialRef;
+    readonly parallel: CredentialRef;
 }
 export interface SearchApiConfig {
     readonly baseUrl: string;
@@ -65,11 +63,17 @@ export interface DiscoveryProviderConfig {
     readonly credentialRef: CredentialRef;
     readonly timeoutMs: number;
 }
+export declare const PARALLEL_SEARCH_MODES: readonly ["turbo", "fast", "basic", "advanced"];
+export type ParallelSearchMode = (typeof PARALLEL_SEARCH_MODES)[number];
+export interface ParallelProviderConfig extends DiscoveryProviderConfig {
+    readonly mode: ParallelSearchMode;
+}
 export interface ProviderConfig {
     readonly context7: DiscoveryProviderConfig;
     readonly exa: DiscoveryProviderConfig;
     readonly tavily: DiscoveryProviderConfig;
     readonly firecrawl: DiscoveryProviderConfig;
+    readonly parallel: ParallelProviderConfig;
 }
 export interface RetryConfig {
     /** Total calls, including the first call. */
@@ -226,15 +230,10 @@ export interface WebExtractConfig {
     /** Independent remote route controls. */
     readonly tavily: RemoteExtractConfig;
     readonly firecrawl: FirecrawlExtractConfig;
+    readonly parallel: RemoteExtractConfig;
     readonly smartDirect: SmartDirectConfig;
     readonly direct: DirectFetchConfig;
 }
-/** @deprecated Accepted for one compatibility cycle but ignored by tool registration and visibility. */
-export interface OptionalToolsConfig {
-    readonly webMap: boolean;
-    readonly researchPlan: boolean;
-    readonly diagnostics: boolean;
-}
 export interface DiagnosticsConfig {
     /** Unified wall-clock budget for status inspection and all concurrent probes. */
     readonly timeoutMs: number;
@@ -249,24 +248,6 @@ export interface DiagnosticsConfig {
     /** Independent maximum UTF-8 bytes rendered into model text. */
     readonly modelTextMaxBytes: number;
 }
-export interface ResearchPlanConfig {
-    /** Unicode code-point ceiling for the required top-level research question. */
-    readonly maxQuestionCharacters: number;
-    /** Unicode code-point ceiling for each sub-question and stable sub-question id. */
-    readonly maxSubQueryCharacters: number;
-    /** Unicode code-point ceiling for each optional explicit tool query. */
-    readonly maxQueryCharacters: number;
-    /** Unicode code-point ceiling for each sub-question reason. */
-    readonly maxReasonCharacters: number;
-    /** Unicode code-point ceiling for each known or tool-target HTTP(S) URL. */
-    readonly maxKnownUrlCharacters: number;
-    /** Deployment count cap within the model contract's ten-URL hard limit. */
-    readonly maxKnownUrls: number;
-    /** Complete canonical research-plan JSON envelope byte ceiling. */
-    readonly maxOutputBytes: number;
-    /** Independent UTF-8 ceiling for the pure Native model-text projection. */
-    readonly modelTextMaxBytes: number;
-}
 export interface SiteMapConfig {
     /** Tavily Map processing and per-attempt transport timeout; sent as whole seconds. */
     readonly timeoutMs: number;
@@ -298,12 +279,8 @@ export interface Config {
     readonly cache: CacheConfig;
     /** Agent tool-discovery policy; changes take effect after the automatic plugin reload. */
     readonly toolDiscovery: ToolDiscoveryConfig;
-    /** @deprecated Accepted and validated for compatibility, but ignored. */
-    readonly optionalTools: OptionalToolsConfig;
     /** Independent resource controls for the diagnostics Consumer. */
     readonly diagnostics: DiagnosticsConfig;
-    /** Stage-4 deterministic offline research-planning resource controls. */
-    readonly researchPlan: ResearchPlanConfig;
     /** Stage-3 extraction tool and route controls. */
     readonly webExtract: WebExtractConfig;
     /** Stage-4 Tavily Map collection and output controls. */

package/lib/config.js

@@ -20,9 +20,6 @@ export const SITE_MAP_DEFAULT_MAX_BREADTH = 10;
 export const SITE_MAP_DEFAULT_LIMIT = 30;
 export const SITE_MAP_MAX_DEPTH = 5;
 export const SITE_MAP_MAX_LINKS = 500;
-/** Hard model-contract bounds for the one-shot offline research planner. */
-export const RESEARCH_PLAN_MAX_KNOWN_URLS = 10;
-export const RESEARCH_PLAN_MAX_SUB_QUERIES = 6;
 export const SEARCH_API_PROTOCOLS = ['completions', 'responses'];
 export const THINKING_LEVELS = [
     'off',
@@ -37,13 +34,15 @@ export const FALLBACK_MODES = ['auto', 'off'];
 export const MINIMUM_CAPABILITY_PROFILES = ['standard', 'off'];
 /** Shared deployment bound for explicit local-route HTTP proxy URLs. */
 export const WEB_EXTRACT_PROXY_URL_MAX_CHARACTERS = 2048;
-export const SUPPLEMENTAL_SEARCH_PROVIDERS = ['exa', 'tavily', 'firecrawl'];
+export const SUPPLEMENTAL_SEARCH_PROVIDERS = ['exa', 'tavily', 'firecrawl', 'parallel'];
+export const PARALLEL_SEARCH_MODES = ['turbo', 'fast', 'basic', 'advanced'];
 export const DEFAULT_CREDENTIAL_REFS = Object.freeze({
     searchApi: credentialRef('SEARCH_API_KEY'),
     context7: credentialRef('CONTEXT7_API_KEY'),
     exa: credentialRef('EXA_API_KEY'),
     tavily: credentialRef('TAVILY_API_KEY'),
     firecrawl: credentialRef('FIRECRAWL_API_KEY'),
+    parallel: credentialRef('PARALLEL_API_KEY'),
 });
 export const DEFAULT_SEARCH_BUDGETS = {
     auto: {
@@ -155,6 +154,12 @@ export const Config = Schema.object({
         exa: discoveryProvider('https://api.exa.ai', DEFAULT_CREDENTIAL_REFS.exa),
         tavily: discoveryProvider('https://api.tavily.com', DEFAULT_CREDENTIAL_REFS.tavily),
         firecrawl: discoveryProvider('https://api.firecrawl.dev/v2', DEFAULT_CREDENTIAL_REFS.firecrawl),
+        parallel: Schema.object({
+            baseUrl: httpUrl('https://api.parallel.ai'),
+            credentialRef: credentialReference(DEFAULT_CREDENTIAL_REFS.parallel),
+            timeoutMs: positiveInteger(120_000, 600_000),
+            mode: Schema.union(PARALLEL_SEARCH_MODES).default('basic'),
+        }),
     }),
     fallbackMode: Schema.union(['auto', 'off']).default('auto'),
     minimumProfile: Schema.union(['standard', 'off']).default('standard'),
@@ -179,6 +184,7 @@ export const Config = Schema.object({
         exa: Schema.boolean().default(false),
         tavily: Schema.boolean().default(false),
         firecrawl: Schema.boolean().default(false),
+        parallel: Schema.boolean().default(false),
         maxSourcesPerProvider: positiveInteger(5, SUPPLEMENTAL_SEARCH_MAX_SOURCES),
     }),
     retention: Schema.object({
@@ -212,13 +218,6 @@ export const Config = Schema.object({
     toolDiscovery: Schema.object({
         mode: Schema.union(TOOL_DISCOVERY_MODES).default('progressive'),
     }),
-    optionalTools: Schema.object({
-        webMap: Schema.boolean().default(false),
-        researchPlan: Schema.boolean().default(false),
-        diagnostics: Schema.boolean().default(false),
-    })
-        .description('Deprecated compatibility input. Values are validated but ignored; use toolDiscovery.mode.')
-        .deprecated(),
     diagnostics: Schema.object({
         timeoutMs: positiveInteger(30_000, 120_000),
         maxProbeAttempts: positiveInteger(1, 3),
@@ -231,20 +230,6 @@ export const Config = Schema.object({
             .default(64 * 1024),
         modelTextMaxBytes: positiveInteger(16 * 1024, 1024 * 1024),
     }),
-    researchPlan: Schema.object({
-        maxQuestionCharacters: positiveInteger(32_000, 1_000_000),
-        maxSubQueryCharacters: positiveInteger(10_000, 100_000),
-        maxQueryCharacters: positiveInteger(10_000, 100_000),
-        maxReasonCharacters: positiveInteger(10_000, 100_000),
-        maxKnownUrlCharacters: positiveInteger(8192, 65_536),
-        maxKnownUrls: Schema.number()
-            .step(1)
-            .min(1)
-            .max(RESEARCH_PLAN_MAX_KNOWN_URLS)
-            .default(RESEARCH_PLAN_MAX_KNOWN_URLS),
-        maxOutputBytes: positiveInteger(256 * 1024, 4 * 1024 * 1024),
-        modelTextMaxBytes: positiveInteger(64 * 1024, 1024 * 1024),
-    }),
     siteMap: Schema.object({
         timeoutMs: Schema.number().step(1000).min(10_000).max(150_000).default(150_000),
         maxResponseBytes: positiveInteger(2 * 1024 * 1024, 32 * 1024 * 1024),
@@ -270,6 +255,12 @@ export const Config = Schema.object({
             maxEmptyAttempts: positiveInteger(3, 10),
             waitForBaseMs: nonNegativeInteger(1500, 30_000),
         }),
+        parallel: Schema.object({
+            enabled: Schema.boolean().default(false),
+            timeoutMs: positiveInteger(120_000, 600_000),
+            maxResponseBytes: positiveInteger(2 * 1024 * 1024, 32 * 1024 * 1024),
+            maxContentCharacters: positiveInteger(50_000, 1_000_000),
+        }),
         smartDirect: Schema.object({
             enabled: Schema.boolean().default(true),
             proxyUrl: proxyUrl(),

package/lib/contracts/sources.d.ts

@@ -1,5 +1,5 @@
 import type { SearchDepth, SearchProfile } from '../config.js';
-export declare const SOURCE_PROVIDERS: readonly ["search-api", "context7", "exa", "tavily", "firecrawl", "smart-direct", "direct"];
+export declare const SOURCE_PROVIDERS: readonly ["search-api", "context7", "exa", "tavily", "firecrawl", "smart-direct", "direct", "parallel"];
 export type SourceProvider = (typeof SOURCE_PROVIDERS)[number];
 export declare const SOURCE_CATEGORIES: readonly ["official", "primary", "documentation", "code", "academic", "news", "community", "aggregate", "unknown"];
 export type SourceCategory = (typeof SOURCE_CATEGORIES)[number];

package/lib/contracts/sources.js

@@ -6,6 +6,7 @@ export const SOURCE_PROVIDERS = [
     'firecrawl',
     'smart-direct',
     'direct',
+    'parallel',
 ];
 export const SOURCE_CATEGORIES = [
     'official',

package/lib/diagnostics/orchestrator.js

@@ -54,6 +54,10 @@ function probeConfig(config) {
                 ...config.providers.firecrawl,
                 timeoutMs: Math.min(config.providers.firecrawl.timeoutMs, timeoutMs),
             },
+            parallel: {
+                ...config.providers.parallel,
+                timeoutMs: Math.min(config.providers.parallel.timeoutMs, timeoutMs),
+            },
         },
         retry: {
             ...config.retry,

package/lib/diagnostics/probes.d.ts

@@ -29,9 +29,9 @@ export declare class Context7ResolveDiagnosticProbe implements DiagnosticProbe {
  */
 export declare class SourceSearchDiagnosticProbe implements DiagnosticProbe {
     readonly capability: Extract<DiagnosticCapability, 'main_search' | 'docs_search'>;
-    readonly provider: Extract<DiagnosticProviderName, 'exa' | 'tavily_search' | 'firecrawl_search'>;
+    readonly provider: Extract<DiagnosticProviderName, 'exa' | 'tavily_search' | 'firecrawl_search' | 'parallel_search'>;
     private readonly source;
-    constructor(capability: Extract<DiagnosticCapability, 'main_search' | 'docs_search'>, provider: Extract<DiagnosticProviderName, 'exa' | 'tavily_search' | 'firecrawl_search'>, source: Pick<BoundedSourceProvider, 'search'>);
+    constructor(capability: Extract<DiagnosticCapability, 'main_search' | 'docs_search'>, provider: Extract<DiagnosticProviderName, 'exa' | 'tavily_search' | 'firecrawl_search' | 'parallel_search'>, source: Pick<BoundedSourceProvider, 'search'>);
     probe(input: DiagnosticProbeInput): Promise<Readonly<DiagnosticProbeResult>>;
 }
 //# sourceMappingURL=probes.d.ts.map