@qilin-agent/web-search-deepseek 3.1.5 → 3.1.6

package/README.i18n.yaml

@@ -9,8 +9,8 @@
   en: aa06ab491048f724
   zh: 255a26ae5442f646
 /qilin-agent-web-search-deepseek/summary:
-  en: 0714f1b61d880505
-  zh: 55121a46e47152c0
+  en: b756d856ed56c0ee
+  zh: 2012556cb73fa871
 /qilin-agent-web-search-deepseek/table-of-contents:
   en: d152484eb41ac6b4
   zh: 09388d293f9be9cb
@@ -30,8 +30,8 @@
   en: 467b8238cf7e140c
   zh: 85a519c8811557aa
 /qilin-agent-web-search-deepseek/use-this-package/failures-and-recovery:
-  en: 8b9211a88d2927dd
-  zh: a2b6bbaa8c4e1996
+  en: e8b3d05fa39ccf47
+  zh: 7fd9e51f4497244a
 /qilin-agent-web-search-deepseek/understand-the-implementation:
   en: 9842c69ad3636bb3
   zh: 3cdc3f816cbdd0cb
@@ -45,8 +45,8 @@
   en: c62da1892ded8f3b
   zh: 3b9d7f7604c286cb
 /qilin-agent-web-search-deepseek/further-exploration:
-  en: 64f11eda556037c1
-  zh: 34c83ec83c4cb941
+  en: c513c5c2a7ad8c93
+  zh: 8111ac4a85fecc93
 /qilin-agent-web-search-deepseek/model-experience:
   en: 215e7ba838619b7b
   zh: a311da3843709f90
@@ -54,11 +54,11 @@
   en: 722e4bf02953e236
   zh: b3432958beb7b60f
 /qilin-agent-web-search-deepseek/model-experience/auxiliary-deepseek-search-request/what-the-model-sees:
-  en: cac44ad2353afadd
-  zh: 23b27f833e47bf7e
+  en: 6b2b2909347efee8
+  zh: 664c3e210ec75cfd
 /qilin-agent-web-search-deepseek/model-experience/auxiliary-deepseek-search-request/token-effect:
-  en: f244b4dd6c9e6ad4
-  zh: 50f2434d5119296b
+  en: 9b079b978c305dd8
+  zh: af2c3f39976b34de
 /qilin-agent-web-search-deepseek/model-experience/auxiliary-deepseek-search-request/kv-cache-effect:
   en: 2bac9662f1792a79
   zh: 556d9baabd79f9cb
@@ -75,11 +75,11 @@
   en: f5d5f97a153f7c70
   zh: f681f89596f500f5
 /qilin-agent-web-search-deepseek/known-limitations-and-deferred-work:
-  en: c9fa522bcfa7bfef
-  zh: f95aeb879603bb62
+  en: 970efa0b6540b4df
+  zh: 03584df5a7ec2a8e
 /qilin-agent-web-search-deepseek/known-limitations-and-deferred-work/dev-note:
   en: 7f775cc79dbce94b
   zh: 12b8f68f9e7c48ca
-/qilin-agent-web-search-deepseek/known-limitations-and-deferred-work/dev-note/future-dedicated-retrieval-endpoint:
-  en: 5cfe3e3773c0abe7
-  zh: a97e11f22b7a0434
+/qilin-agent-web-search-deepseek/known-limitations-and-deferred-work/dev-note/dedicated-retrieval-endpoint:
+  en: e8a9d9e70da86ce5
+  zh: 33ca8102965d1d0f

package/README.md

@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-With `qilin-web-search-deepseek`, the harness searches the web through DeepSeek's native search using an existing `DEEPSEEK_API_KEY`. Choose it when a deployment wants DeepSeek native search and accepts that one search costs a full model turn in latency and tokens, because DeepSeek exposes no dedicated search endpoint. Results come from the structured search blocks DeepSeek returns, never from scraping text out of a reply. A missing credential fails the call with a structured error; a response without a search-result block fails loudly rather than degrading. The model-facing `web_search` tool lives in `qilin-tool-web`.
+With `qilin-web-search-deepseek`, the harness searches the web through DeepSeek's native search using an existing `DEEPSEEK_API_KEY`. Choose it when a deployment wants DeepSeek native search and accepts that one search costs a full model turn in latency and tokens; the DeepSeek Search and Fetch APIs in [qilin-web-deepseek-api](../web-deepseek-api/README.md) retrieve without one. Results come from the structured search blocks DeepSeek returns, never from scraping text out of a reply. A missing credential fails the call with a structured error; a response without a search-result block fails loudly rather than degrading. The model-facing `web_search` tool lives in `qilin-tool-web`.
 
 ## Table of Contents
 
@@ -65,7 +65,7 @@ A search running under an initiating agent appends the log-only `web/deepseek-se
 
 ### Failures and recovery
 
-Failures throw `WebError` with a machine-routable code: a missing credential is `WEB_PROVIDER_CREDENTIAL_MISSING`, caller cancellation is `WEB_ABORTED`, and provider or transport failures — including a response with no `web_search_tool_result` block — are `WEB_PROVIDER_ERROR`. HTTP redirects are rejected before the `Location` target is contacted. Every failure after dispatch names the resolved search endpoint and explains that search endpoint configuration is separate from chat. If the endpoint is unintended, the message tells the conversation model to guide the user to the Endpoint field under Settings > Plugins > Plugin configuration > Web search and save the change. When that page is unavailable, it names `DEEPSEEK_SEARCH_BASE_URL` and `web-search-deepseek.baseURL` as deployment configuration alternatives. The model must not choose or change the endpoint. The model-facing `web_search` tool surfaces this text under its own error wrapper.
+Failures throw `WebError` with a machine-routable code: a missing credential is `WEB_PROVIDER_CREDENTIAL_MISSING`, caller cancellation is `WEB_ABORTED`, and provider or transport failures — including a response with no `web_search_tool_result` block — are `WEB_PROVIDER_ERROR`. HTTP redirects are rejected before the `Location` target is contacted. Every failure after dispatch names the resolved search endpoint and explains that search endpoint configuration is separate from chat. If the endpoint is unintended, the message tells the conversation model to guide the user to the Messages API base URL field under Plugins > Built-in plugin settings > Web search and save the change. When that page is unavailable, it names `web-search-deepseek.baseURL` as the deployment configuration alternative. The model must not choose or change the endpoint. The model-facing `web_search` tool surfaces this text under its own error wrapper.
 
 -----
 
@@ -106,7 +106,7 @@ Each search projects the current Settings section into provider options — endp
 Read these pages when the package-level contract is not enough. They move from the shared vocabulary to the service, the model-facing tools, and the design rationale.
 
 - [Web subsystem](../../../docs/subsystems/web.md) — the exhaustive search request/result vocabulary and error codes.
-- [Web package map](../README.md) — the six-package family and each role.
+- [Web package map](../README.md) — the seven-package family and each role.
 - [qilin-web](../web/README.md) — the web service this provider registers into.
 - [qilin-tool-web](../tool-web/README.md) — the model-facing `web_search` tool that renders this provider's sources.
 - [Generated configuration catalog](../../../docs/config-catalog.md#qilin-agentweb-search-deepseek) — every accepted config field and its source declaration.
@@ -121,11 +121,11 @@ Read these pages when the package-level contract is not enough. They move from t
 
 #### What the model sees
 
-A separate DeepSeek model receives exactly `Perform a web search for the query: <query>` as its user text and one native `web_search` server-tool definition. This request is not part of the conversation model's context.
+A separate DeepSeek model receives exactly `Perform a web search for the query: <query>` as its user text and one native `web_search` server-tool definition, with thinking disabled. This request is not part of the conversation model's context.
 
 #### Token effect
 
-Separate provider input and output tokens are incurred for each search; `maxTokens` caps generated output and `maxUses` caps native search uses.
+Separate provider input and output tokens are incurred for each search; disabled thinking adds no reasoning tokens, `maxTokens` caps generated output, and `maxUses` caps native search uses.
 
 #### KV Cache effect
 
@@ -152,10 +152,10 @@ Append-only; newly visible content follows the reusable request prefix and does
 
 These limits define when the provider is expensive or incomplete. They are current package constraints.
 
-- **One search costs a full Messages model turn** — latency plus generated tokens, with up to `maxUses` server-side searches; DeepSeek exposes no dedicated retrieval endpoint.
+- **One search costs a full Messages model turn** — latency plus generated tokens, with up to `maxUses` server-side searches; [qilin-web-deepseek-api](../web-deepseek-api/README.md) uses the dedicated Search API instead.
 - **Dynamic credential availability resolves inside the operation** — the synchronous availability check can establish that a resolver exists but cannot query an asynchronous credential store, so a selected keyless provider fails the search with `WEB_PROVIDER_CREDENTIAL_MISSING`; the stable `web_search` schema stays registered.
 - **Over-returned sources still cost tokens** — with no result-count knob on the wire, `maxResults` is enforced only post-hoc by service truncation.
-- **Uncited results carry no `snippet`** — a source gains one only when a text-block citation (`cited_text`) matches its URL.
+- **Sources usually carry no `snippet`** — a source gains one only when a text-block citation (`cited_text`) matches its URL, and DeepSeek's Anthropic-compatible endpoint returns text blocks without `citations`.
 
 <a id="dev-note"></a>
 ### Dev Note
@@ -165,8 +165,8 @@ These limits define when the provider is expensive or incomplete. They are curre
 
 This Dev Note is working context for maintainers: open questions and undecided directions. It is explicitly non-authoritative — shipped behavior, limits, and rationale live in the sections above and the linked Agent Notes.
 
-#### Future: dedicated retrieval endpoint
+#### Dedicated retrieval endpoint
 
-A native DeepSeek search endpoint that avoids the full model turn would remove the dominant cost; until DeepSeek exposes one, this provider stays a Messages-call adapter.
+DeepSeek's Search and Fetch APIs, which avoid the full model turn, live in [qilin-web-deepseek-api](../web-deepseek-api/README.md) and are selected by the Web search settings switch; this provider stays the default until the Search API launch is announced.
 
 </details>

package/README.zh.md

@@ -9,7 +9,7 @@ kind: "package-reference"
 
 ## 概述
 
-有了 `qilin-web-search-deepseek`，harness 可以通过 DeepSeek 原生搜索检索 web，使用部署已有的 `DEEPSEEK_API_KEY`。当部署希望使用 DeepSeek 原生搜索、并接受一次搜索在延迟与 token 上消耗一个完整模型轮次时选择它，因为 DeepSeek 不提供专用搜索端点。结果来自 DeepSeek 返回的结构化搜索块，绝不会从回复文本中抓取。凭据缺失时调用以结构化错误失败；响应缺少搜索结果块时会明确报错，而非降级。面向模型的 `web_search` 工具位于 `qilin-tool-web`。
+有了 `qilin-web-search-deepseek`，harness 可以通过 DeepSeek 原生搜索检索 web，使用部署已有的 `DEEPSEEK_API_KEY`。当部署希望使用 DeepSeek 原生搜索、并接受一次搜索在延迟与 token 上消耗一个完整模型轮次时选择它；[qilin-web-deepseek-api](../web-deepseek-api/README.zh.md) 中的 DeepSeek Search 与 Fetch API 无需模型轮次即可检索。结果来自 DeepSeek 返回的结构化搜索块，绝不会从回复文本中抓取。凭据缺失时调用以结构化错误失败；响应缺少搜索结果块时会明确报错，而非降级。面向模型的 `web_search` 工具位于 `qilin-tool-web`。
 
 ## 目录
 
@@ -65,7 +65,7 @@ kind: "package-reference"
 
 ### 失败与恢复
 
-失败抛出携带可按机器路由 code 的 `WebError`：凭据缺失为 `WEB_PROVIDER_CREDENTIAL_MISSING`，调用方取消为 `WEB_ABORTED`，提供方或传输失败，包括响应中没有 `web_search_tool_result` 块，为 `WEB_PROVIDER_ERROR`。HTTP 重定向会在接触 `Location` 指向的目标之前被拒绝。请求发出后的每项失败都会指出已解析的搜索端点，并说明搜索端点配置独立于聊天端点。如果该端点不符合用户预期，错误消息会要求会话模型指导用户进入 Settings > Plugins > Plugin configuration > Web search，修改 Endpoint 字段并保存。该页面不可用时，消息会把 `DEEPSEEK_SEARCH_BASE_URL` 和 `web-search-deepseek.baseURL` 作为部署配置方式。模型不得替用户选择或修改端点。面向模型的 `web_search` 工具会在自己的错误包装层内呈现这段文本。
+失败抛出携带可按机器路由 code 的 `WebError`：凭据缺失为 `WEB_PROVIDER_CREDENTIAL_MISSING`，调用方取消为 `WEB_ABORTED`，提供方或传输失败，包括响应中没有 `web_search_tool_result` 块，为 `WEB_PROVIDER_ERROR`。HTTP 重定向会在接触 `Location` 指向的目标之前被拒绝。请求发出后的每项失败都会指出已解析的搜索端点，并说明搜索端点配置独立于聊天端点。如果该端点不符合用户预期，错误消息会要求会话模型指导用户进入 Plugins > Built-in plugin settings > Web search，修改 Messages API 基础地址字段并保存。该页面不可用时，消息会把 `web-search-deepseek.baseURL` 作为部署配置方式。模型不得替用户选择或修改端点。面向模型的 `web_search` 工具会在自己的错误包装层内呈现这段文本。
 
 -----
 
@@ -106,7 +106,7 @@ kind: "package-reference"
 当包级约定不够用时阅读以下页面。它们从共享词汇逐步进入服务、面向模型的工具与设计依据。
 
 - [web 子系统](../../../docs/subsystems/web.zh.md)——穷尽式的搜索请求／结果词汇与错误码。
-- [web 包映射](../README.zh.md)——六包家族与各角色。
+- [web 包映射](../README.zh.md)——七包家族与各角色。
 - [qilin-web](../web/README.zh.md)——本提供方注册进入的 web 服务。
 - [qilin-tool-web](../tool-web/README.zh.md)——渲染本提供方来源的面向模型 `web_search` 工具。
 - [生成配置目录](../../../docs/config-catalog.zh.md#qilin-agentweb-search-deepseek)——每个受支持配置字段及其源声明。
@@ -121,11 +121,11 @@ kind: "package-reference"
 
 #### 模型看到的内容
 
-独立的 DeepSeek 模型会原样接收 `Perform a web search for the query: <query>` 作为用户文本，并收到一个原生 `web_search` 服务器工具定义。该请求不属于会话模型上下文。
+独立的 DeepSeek 模型会原样接收 `Perform a web search for the query: <query>` 作为用户文本，并收到一个原生 `web_search` 服务器工具定义，思考模式关闭。该请求不属于会话模型上下文。
 
 #### Token 影响
 
-每次搜索都会产生独立的提供方输入与输出 token；`maxTokens` 限制生成输出，`maxUses` 限制原生搜索次数。
+每次搜索都会产生独立的提供方输入与输出 token；关闭思考模式不产生推理 token，`maxTokens` 限制生成输出，`maxUses` 限制原生搜索次数。
 
 #### KV Cache 影响
 
@@ -152,10 +152,10 @@ kind: "package-reference"
 
 这些限制说明提供方在哪些情况下昂贵或不完整。它们是当前包约束。
 
-- **一次搜索消耗一个完整的 Messages 模型轮次**——产生延迟与生成 token，最多执行 `maxUses` 次服务端搜索；DeepSeek 不公开专用检索端点。
+- **一次搜索消耗一个完整的 Messages 模型轮次**——产生延迟与生成 token，最多执行 `maxUses` 次服务端搜索；[qilin-web-deepseek-api](../web-deepseek-api/README.zh.md) 改用专用的 Search API。
 - **动态凭据的可用性在操作内部解析**——同步可用性检查可以确认解析器存在，但无法查询异步凭据存储，因此选中的无密钥提供方会使搜索以 `WEB_PROVIDER_CREDENTIAL_MISSING` 失败；稳定的 `web_search` schema 仍保持注册。
 - **超量返回的来源仍消耗 token**——协议没有结果数量旋钮，`maxResults` 只能由服务在事后截断。
-- **未引用的结果没有 `snippet`**——只有当文本块引用（`cited_text`）匹配其 URL 时，来源才会获得 snippet。
+- **来源通常没有 `snippet`**——只有当文本块引用（`cited_text`）匹配其 URL 时，来源才会获得 snippet，而 DeepSeek 的 Anthropic 兼容端点返回的文本块不带 `citations`。
 
 <a id="dev-note"></a>
 ### 开发备注
@@ -165,8 +165,8 @@ kind: "package-reference"
 
 本开发备注是维护者的工作上下文：开放问题与尚未决定的探索方向。它明确不具权威性——已交付的行为、限制与既定理由以上文和相关 Agent Note 为准。
 
-#### 未来：专用检索端点
+#### 专用检索端点
 
-能够避免完整模型轮次的 DeepSeek 原生搜索端点将消除主要成本；在 DeepSeek 公开此类端点之前，本提供方仍是 Messages 调用适配器。
+无需完整模型轮次的 DeepSeek Search 与 Fetch API 位于 [qilin-web-deepseek-api](../web-deepseek-api/README.zh.md)，由网页搜索设置页的开关选择；在 Search API 正式发布公告之前，本提供方仍是默认值。
 
 </details>

package/lib/index.js

@@ -119,7 +119,8 @@ var DeepSeekSearchProvider = class {
 				type: "web_search_20250305",
 				name: "web_search",
 				max_uses: options.maxUses
-			}]
+			}],
+			thinking: { type: "disabled" }
 		};
 		options.recordRequest?.({
 			endpoint,
@@ -187,7 +188,7 @@ var DeepSeekSearchProvider = class {
 };
 /** Add endpoint recovery instructions to failures that occur after request dispatch begins. */
 function searchEndpointError(endpoint, message, cause) {
-	return new WebError(`${message}\n\nThe web search request used endpoint ${JSON.stringify(endpoint)}. Search endpoint configuration is separate from chat. If that endpoint is not intended, guide the user to Settings > Plugins > Plugin configuration > Web search, where they can change and save Endpoint. If that settings page is unavailable, the user can set DEEPSEEK_SEARCH_BASE_URL or configure web-search-deepseek.baseURL to a trusted Anthropic-compatible Messages API base. Only the user should choose or change the endpoint.`, "WEB_PROVIDER_ERROR", cause === void 0 ? void 0 : { cause });
+	return new WebError(`${message}\n\nThe web request used endpoint ${JSON.stringify(endpoint)}. Search endpoint configuration is separate from chat. If that endpoint is not intended, guide the user to Plugins > Built-in plugin settings > Web search, where they can change and save Messages API base URL. If that settings page is unavailable, the user can set web-search-deepseek.baseURL to a trusted DeepSeek endpoint. Only the user should choose or change the endpoint.`, "WEB_PROVIDER_ERROR", cause === void 0 ? void 0 : { cause });
 }
 /**
 * Race a same-process asynchronous preflight against caller cancellation. The
@@ -239,23 +240,20 @@ function isPositiveInteger(value) {
 const name = "web-search-deepseek";
 /** The web seam this provider registers into. */
 const inject = ["web"];
-const DEFAULT_API_KEY_ENV = "DEEPSEEK_API_KEY";
 const Config = z.object({
-	apiKey: z.string().role("secret"),
-	apiKeyEnv: z.string().role("credential-ref").default(DEFAULT_API_KEY_ENV),
-	baseURL: z.string(),
-	model: z.string().default(DEEPSEEK_DEFAULT_MODEL),
-	apiVersion: z.string().default(DEEPSEEK_DEFAULT_API_VERSION),
-	maxTokens: z.number().step(1).min(1).default(DEEPSEEK_DEFAULT_MAX_TOKENS),
-	maxUses: z.number().step(1).min(1).default(5)
+	apiKey: z.string().role("secret").volatile(),
+	apiKeyEnv: z.string().role("credential-ref").default("DEEPSEEK_API_KEY").volatile(),
+	baseURL: z.string().volatile(),
+	model: z.string().default(DEEPSEEK_DEFAULT_MODEL).volatile(),
+	apiVersion: z.string().default(DEEPSEEK_DEFAULT_API_VERSION).volatile(),
+	maxTokens: z.number().step(1).min(1).default(DEEPSEEK_DEFAULT_MAX_TOKENS).volatile(),
+	maxUses: z.number().step(1).min(1).default(5).volatile()
 });
 /**
 * Auxiliary-search endpoint, independent of the conversation adapter's
 * `$DEEPSEEK_BASE_URL` and selected protocol.
 */
 const SEARCH_BASE_URL_ENV = "DEEPSEEK_SEARCH_BASE_URL";
-/** Settings namespace carrying this provider's endpoint, model, and key reference. */
-const WEB_SEARCH_DEEPSEEK_SETTINGS_NAMESPACE = "web-search-deepseek";
 /**
 * Project one resolved section into the options the provider serves its next
 * search with. Environment fallbacks stay here rather than in the provider:
@@ -265,7 +263,7 @@ const WEB_SEARCH_DEEPSEEK_SETTINGS_NAMESPACE = "web-search-deepseek";
 * @returns options for one search.
 */
 function resolveOptions(ctx, config) {
-	const apiKeyEnv = credentialRef(config.apiKeyEnv ?? DEFAULT_API_KEY_ENV);
+	const apiKeyEnv = credentialRef(config.apiKeyEnv);
 	const literalApiKey = config.apiKey !== void 0 && config.apiKey.length > 0 ? config.apiKey : void 0;
 	return {
 		...literalApiKey === void 0 ? {} : { apiKey: literalApiKey },
@@ -277,10 +275,10 @@ function resolveOptions(ctx, config) {
 		},
 		apiKeyEnv,
 		baseURL: config.baseURL ?? launchEnvironmentOf(ctx).get(SEARCH_BASE_URL_ENV)?.value ?? "https://api.deepseek.com/anthropic/v1",
-		model: config.model ?? "deepseek-v4-flash",
-		apiVersion: config.apiVersion ?? "2023-06-01",
-		maxTokens: config.maxTokens ?? 4096,
-		maxUses: config.maxUses ?? 5,
+		model: config.model,
+		apiVersion: config.apiVersion,
+		maxTokens: config.maxTokens,
+		maxUses: config.maxUses,
 		recordRequest: (request) => {
 			ctx.get("agents")?.currentInitiator()?.session.append("web/deepseek-search-llm-request", request);
 		}
@@ -288,16 +286,15 @@ function resolveOptions(ctx, config) {
 }
 /** Register the DeepSeek search provider with `ctx.web`. */
 function apply(ctx, config) {
-	let current = () => config;
-	ctx.inject(["settings"], (settingsCtx) => {
-		settingsCtx.settings.installSection(ctx, WEB_SEARCH_DEEPSEEK_SETTINGS_NAMESPACE, Config, config, {
-			setSource: (source) => {
-				current = source;
-			},
-			onChange: () => {}
-		});
-	});
-	ctx.web.registerSearchProvider(new DeepSeekSearchProvider(() => resolveOptions(ctx, current())));
+	ctx.web.registerSearchProvider(new DeepSeekSearchProvider(() => resolveOptions(ctx, {
+		apiKey: config.apiKey.get(),
+		apiKeyEnv: config.apiKeyEnv.get(),
+		baseURL: config.baseURL.get(),
+		model: config.model.get(),
+		apiVersion: config.apiVersion.get(),
+		maxTokens: config.maxTokens.get(),
+		maxUses: config.maxUses.get()
+	})));
 }
 //#endregion
-export { Config, DEEPSEEK_DEFAULT_API_VERSION, DEEPSEEK_DEFAULT_BASE_URL, DEEPSEEK_DEFAULT_MAX_TOKENS, DEEPSEEK_DEFAULT_MAX_USES, DEEPSEEK_DEFAULT_MODEL, DEEPSEEK_PROVIDER_ID, DeepSeekSearchProvider, WEB_SEARCH_DEEPSEEK_SETTINGS_NAMESPACE, apply, inject, name };
+export { Config, DEEPSEEK_DEFAULT_API_VERSION, DEEPSEEK_DEFAULT_BASE_URL, DEEPSEEK_DEFAULT_MAX_TOKENS, DEEPSEEK_DEFAULT_MAX_USES, DEEPSEEK_DEFAULT_MODEL, DEEPSEEK_PROVIDER_ID, DeepSeekSearchProvider, apply, inject, name };

package/lib/types/index.d.ts

@@ -6,32 +6,47 @@
  */
 import type { Context } from '@qilin-agent/kylin';
 import z from '@qilin-agent/schemastery';
+import type { Volatile } from '@qilin-agent/kylin';
 export { DeepSeekSearchProvider, DEEPSEEK_DEFAULT_API_VERSION, DEEPSEEK_DEFAULT_BASE_URL, DEEPSEEK_DEFAULT_MAX_TOKENS, DEEPSEEK_DEFAULT_MAX_USES, DEEPSEEK_DEFAULT_MODEL, DEEPSEEK_PROVIDER_ID, } from './provider.ts';
 export type { DeepSeekSearchLlmRequest, DeepSeekSearchProviderOptions } from './provider.ts';
 /** Cordis plugin name used by loader diagnostics. */
 export declare const name = "web-search-deepseek";
 /** The web seam this provider registers into. */
 export declare const inject: string[];
-/** Plugin config (all optional — `apply` fills env-var and constant defaults). */
+/** Plugin config, live without remounting. */
 export interface Config {
     /** Literal DeepSeek API key; prefer {@link apiKeyEnv} so no secret enters configuration files. */
-    apiKey?: string;
+    apiKey: Volatile<string | undefined>;
     /** Credential reference resolved for each search; defaults to `DEEPSEEK_API_KEY`. */
-    apiKeyEnv?: string;
+    apiKeyEnv: Volatile<string>;
     /** Anthropic-compatible endpoint base; `/messages` is appended. */
-    baseURL?: string;
+    baseURL: Volatile<string | undefined>;
     /** Anthropic-format model name. Defaults to `deepseek-v4-flash`. */
-    model?: string;
+    model: Volatile<string>;
     /** `anthropic-version` header value. Defaults to `2023-06-01`. */
-    apiVersion?: string;
+    apiVersion: Volatile<string>;
     /** Upper bound on generated tokens for the Messages request. Defaults to 4096. */
-    maxTokens?: number;
+    maxTokens: Volatile<number>;
     /** Maximum `web_search` server-tool uses per request. Defaults to 5. */
-    maxUses?: number;
+    maxUses: Volatile<number>;
 }
-export declare const Config: z<Config>;
-/** Settings namespace carrying this provider's endpoint, model, and key reference. */
-export declare const WEB_SEARCH_DEEPSEEK_SETTINGS_NAMESPACE = "web-search-deepseek";
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    apiKey: z<string, string, "volatile">;
+    apiKeyEnv: z<string, string, "volatile-defined">;
+    baseURL: z<string, string, "volatile">;
+    model: z<string, string, "volatile-defined">;
+    apiVersion: z<string, string, "volatile-defined">;
+    maxTokens: z<number, number, "volatile-defined">;
+    maxUses: z<number, number, "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    apiKey: z<string, string, "volatile">;
+    apiKeyEnv: z<string, string, "volatile-defined">;
+    baseURL: z<string, string, "volatile">;
+    model: z<string, string, "volatile-defined">;
+    apiVersion: z<string, string, "volatile-defined">;
+    maxTokens: z<number, number, "volatile-defined">;
+    maxUses: z<number, number, "volatile-defined">;
+}>>, "plain">;
 /** Register the DeepSeek search provider with `ctx.web`. */
 export declare function apply(ctx: Context, config: Config): void;
 //# sourceMappingURL=index.d.ts.map

package/lib/types/provider.d.ts

@@ -55,6 +55,15 @@ export interface DeepSeekSearchLlmRequest {
                 readonly max_uses: number;
             }
         ];
+        /**
+         * Thinking mode for the auxiliary turn. The provider always sends
+         * `disabled`: it discards the generated text, so reasoning tokens have no
+         * consumer. Absent means the request omitted the field and the provider
+         * applied its default.
+         */
+        readonly thinking?: {
+            readonly type: 'disabled';
+        };
     };
 }
 declare module '@qilin-agent/session/types' {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/web-search-deepseek",
   "description": "DeepSeek-backed search provider (native web_search via the Anthropic-compatible API) for the QiLin web capability seam (ctx.web)",
-  "version": "3.1.5",
+  "version": "3.1.6",
   "publishConfig": {
     "access": "public"
   },
@@ -30,26 +30,26 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@qilin-agent/agent": "3.1.5",
-    "@qilin-agent/web": "3.1.5",
-    "@qilin-agent/credentials": "3.1.5",
-    "@qilin-agent/launch-environment": "3.1.5",
-    "@qilin-agent/session": "3.1.5",
-    "@qilin-agent/settings": "3.1.5",
-    "@qilin-agent/kylin": "~4.0.3"
+    "@qilin-agent/agent": "3.1.6",
+    "@qilin-agent/launch-environment": "3.1.6",
+    "@qilin-agent/session": "3.1.6",
+    "@qilin-agent/web": "3.1.6",
+    "@qilin-agent/kylin": "~4.0.5",
+    "@qilin-agent/settings": "3.1.6",
+    "@qilin-agent/credentials": "3.1.6"
   },
   "dependencies": {
-    "@qilin-agent/schemastery": "~3.18.3"
+    "@qilin-agent/schemastery": "~3.18.5"
   },
   "devDependencies": {
-    "@qilin-agent/agent": "3.1.5",
-    "@qilin-agent/credentials-local": "3.1.5",
-    "@qilin-agent/credentials": "3.1.5",
-    "@qilin-agent/session": "3.1.5",
-    "@qilin-agent/launch-environment": "3.1.5",
-    "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/web": "3.1.5",
-    "@qilin-agent/settings": "3.1.5",
-    "@qilin-agent/http-proxy": "3.1.5"
+    "@qilin-agent/agent": "3.1.6",
+    "@qilin-agent/credentials": "3.1.6",
+    "@qilin-agent/credentials-local": "3.1.6",
+    "@qilin-agent/launch-environment": "3.1.6",
+    "@qilin-agent/session": "3.1.6",
+    "@qilin-agent/web": "3.1.6",
+    "@qilin-agent/kylin": "~4.0.5",
+    "@qilin-agent/settings": "3.1.6",
+    "@qilin-agent/http-proxy": "3.1.6"
   }
 }