@deepseek-ai/dsh-web-search-deepseek 0.1.6-alpha.2 → 0.1.7-alpha.2

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/web/web-search-deepseek/README.md
-README.md: 1fa8153b55e40edc869d6d332e3c35a46de0cd1b
-README.zh.md: a38c1e126a23033cd40ef468f98b35d7cc56d869
+README.md: 6ac35d899ebfc281a3d830bd6050be46309f4ec9
+README.zh.md: 7693a7470872b59065e66cdf2d71e41bb9a1e016

package/README.md

@@ -33,7 +33,7 @@ Choose this backend when a deployment wants DeepSeek's native server-side web se
 
 ### Minimal configuration
 
-Load the web service and the provider; the key resolves from `ctx.credentials` when that service is mounted, otherwise from the process environment. The auxiliary search call has its own endpoint setting and uses the Anthropic-compatible base `https://api.deepseek.com/anthropic/v1`, with `/messages` appended. It reads `$DEEPSEEK_SEARCH_BASE_URL`, independently of the conversation adapter’s `$DEEPSEEK_BASE_URL` and protocol.
+Load the web service and the provider; the key resolves from `ctx.credentials` when that service is mounted, otherwise from the process environment. The auxiliary search call has its own endpoint setting and uses the Anthropic-compatible base `https://api.deepseek.com/anthropic/v1`, with `/messages` appended. It reads `$DEEPSEEK_SEARCH_BASE_URL`, independently of the conversation adapter’s `$DEEPSEEK_BASE_URL`.
 
 ```yaml
 - name: '@deepseek-ai/dsh-web'
@@ -53,7 +53,7 @@ Load the web service and the provider; the key resolves from `ctx.credentials` w
 | `maxTokens` | `4096` | Positive-integer upper bound on generated tokens for the Messages request |
 | `maxUses` | `5` | Positive-integer maximum `web_search` server-tool uses per request |
 
-The generated [configuration catalog](../../../docs/config-catalog.md#deepseek-aidsh-web-search-deepseek) is the exhaustive source for every accepted field and its JSDoc. The entry above is the base layer of the provider's Settings section; a user layer over it reaches the next search, because the provider projects the section per call rather than capturing it at registration.
+The generated [configuration catalog](../../../docs/config-catalog.md#deepseek-aidsh-web-search-deepseek) lists every accepted field. Each search captures options from the live Config references.
 
 ### What a search returns
 
@@ -88,14 +88,14 @@ The provider is built on two commitments:
 
 | File | Role |
 |---|---|
-| [`src/index.ts`](src/index.ts) | Plugin entry: config schema, Settings section installation, per-search option projection |
+| [`src/index.ts`](src/index.ts) | Config schema and per-search option capture |
 | [`src/provider.ts`](src/provider.ts) | The `DeepSeekSearchProvider`: Messages request dispatch, block parsing, citation joining, credential resolution |
 | [`src/types.ts`](src/types.ts) | Anthropic wire types for the search response |
 | — | No runtime invariant companion is published; the package emits a pre-dispatch log event but owns no later authoritative dispatch event to relate it to. Exact envelope equality is pinned at the provider boundary instead. |
 
 ### Request flow
 
-Each search projects the current Settings section into provider options — endpoint, model, key reference, limits — then resolves the credential reference through `ctx.credentials` (or the environment), appends the log-only session event, and dispatches the Messages request with the native `web_search` server tool. The response's `web_search_tool_result` blocks become `sources[]`; `cited_text` entries from text blocks are joined to their URLs as snippets; results are deduplicated by URL; and the service enforces the requested source bound on the way back.
+Each search captures the current Config values into provider options — endpoint, model, key reference, limits — then resolves the credential reference through `ctx.credentials` (or the environment), appends the log-only session event, and dispatches the Messages request with the native `web_search` server tool. The response's `web_search_tool_result` blocks become `sources[]`; `cited_text` entries from text blocks are joined to their URLs as snippets; results are deduplicated by URL; and the service enforces the requested source bound on the way back.
 
 </details>
 

package/README.zh.md

@@ -33,7 +33,7 @@ kind: "package-reference"
 
 ### 最小配置
 
-加载 web 服务与本提供方；密钥在已挂载 `ctx.credentials` 服务时从其解析，否则从进程环境解析。辅助搜索调用有独立的端点设置，使用 Anthropic 兼容基址 `https://api.deepseek.com/anthropic/v1`，并追加 `/messages`。它读取 `$DEEPSEEK_SEARCH_BASE_URL`，与会话适配器的 `$DEEPSEEK_BASE_URL` 和协议相互独立。
+加载 web 服务与本提供方；密钥在已挂载 `ctx.credentials` 服务时从其解析，否则从进程环境解析。辅助搜索调用有独立的端点设置，使用 Anthropic 兼容基址 `https://api.deepseek.com/anthropic/v1`，并追加 `/messages`。它读取 `$DEEPSEEK_SEARCH_BASE_URL`，与会话适配器的 `$DEEPSEEK_BASE_URL` 相互独立。
 
 ```yaml
 - name: '@deepseek-ai/dsh-web'
@@ -53,7 +53,7 @@ kind: "package-reference"
 | `maxTokens` | `4096` | Messages 请求生成 token 的正整数上限 |
 | `maxUses` | `5` | 每次请求使用 `web_search` 服务器工具的正整数上限 |
 
-生成的[配置目录](../../../docs/config-catalog.zh.md#deepseek-aidsh-web-search-deepseek)是每个受支持字段及其 JSDoc 的穷尽式真源。上面的条目是提供方 Settings 段的 base 层；叠加其上的用户层会作用于下一次搜索，因为提供方是按次投影该段，而不是在注册时固化它。
+生成的[配置目录](../../../docs/config-catalog.zh.md#deepseek-aidsh-web-search-deepseek) 列出所有接受的字段。每次搜索从即时 Config 引用捕获选项。
 
 ### 搜索返回什么
 
@@ -88,14 +88,14 @@ kind: "package-reference"
 
 | 文件 | 职责 |
 |---|---|
-| [`src/index.ts`](src/index.ts) | 插件入口：配置 schema、Settings 段安装、逐次选项投影 |
+| [`src/index.ts`](src/index.ts) | Config schema 与每次搜索的选项捕获 |
 | [`src/provider.ts`](src/provider.ts) | `DeepSeekSearchProvider`：Messages 请求分发、块解析、引用拼接、凭据解析 |
 | [`src/types.ts`](src/types.ts) | 搜索响应的 Anthropic 协议类型 |
 | — | 不发布运行时不变量配套入口；本包会在分发前发出日志事件，但没有后续的权威分发事件可与之关联；精确的请求包络相等性改由提供方边界保障。 |
 
 ### 请求流程
 
-每次搜索先把当前 Settings 段投影为提供方选项——端点、模型、密钥引用、上限——然后通过 `ctx.credentials`（或环境）解析凭据引用，追加仅用于日志的会话事件，并以原生 `web_search` 服务器工具分发 Messages 请求。响应中的 `web_search_tool_result` 块变为 `sources[]`；文本块中的 `cited_text` 条目按其 URL 拼接为 snippet；结果按 URL 去重；服务在返回路径上强制执行请求的来源上限。
+每次搜索先把当前 Config 段投影为提供方选项——端点、模型、密钥引用、上限——然后通过 `ctx.credentials`（或环境）解析凭据引用，追加仅用于日志的会话事件，并以原生 `web_search` 服务器工具分发 Messages 请求。响应中的 `web_search_tool_result` 块变为 `sources[]`；文本块中的 `cited_text` 条目按其 URL 拼接为 snippet；结果按 URL 去重；服务在返回路径上强制执行请求的来源上限。
 
 </details>
 

package/lib/index.js

@@ -229,25 +229,18 @@ function isPositiveInteger(value) {
 }
 //#endregion
 //#region lib/types/index.js
-/**
-* Register a DeepSeek-backed provider in `ctx.web`. It calls the Anthropic-compatible Messages API
-* with native `web_search_20250305`. The provider reuses `DEEPSEEK_API_KEY` but not
-* `DEEPSEEK_BASE_URL`; auxiliary search has its own endpoint configuration.
-* @module @deepseek-ai/dsh-web-search-deepseek
-*/
 /** Cordis plugin name used by loader diagnostics. */
 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
@@ -265,7 +258,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 +270,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 +281,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 };

package/lib/types/index.d.ts

@@ -4,6 +4,7 @@
  * `DEEPSEEK_BASE_URL`; auxiliary search has its own endpoint configuration.
  * @module @deepseek-ai/dsh-web-search-deepseek
  */
+import type { Volatile } from '@deepseek-ai/cordis';
 import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 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';
@@ -15,21 +16,37 @@ export declare const inject: string[];
 /** Plugin config (all optional — `apply` fills env-var and constant defaults). */
 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>;
+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">;
 /** Settings namespace carrying this provider's endpoint, model, and key reference. */
 export declare const WEB_SEARCH_DEEPSEEK_SETTINGS_NAMESPACE = "web-search-deepseek";
 /** Register the DeepSeek search provider with `ctx.web`. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-web-search-deepseek",
   "description": "DeepSeek-backed search provider (native web_search via the Anthropic-compatible API) for the DeepSeek Harness web capability seam (ctx.web)",
-  "version": "0.1.6-alpha.2",
+  "version": "0.1.7-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -27,26 +27,24 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-credentials": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-launch-environment": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.6-alpha.2",
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-web": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.6-alpha.2"
+    "@deepseek-ai/dsh-credentials": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-agent": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-launch-environment": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-session": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-web": "0.1.7-alpha.2",
+    "@deepseek-ai/cordis": "~4.0.4"
   },
   "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.2"
+    "@deepseek-ai/schemastery": "~3.18.4"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-credentials": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-agent": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-credentials-local": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-launch-environment": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-web": "^0.1.6-alpha.2",
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-settings": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-http-proxy": "^0.1.6-alpha.2"
+    "@deepseek-ai/dsh-credentials": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-agent": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-credentials-local": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-session": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-launch-environment": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-web": "0.1.7-alpha.2",
+    "@deepseek-ai/cordis": "~4.0.4",
+    "@deepseek-ai/dsh-http-proxy": "0.1.7-alpha.2"
   }
 }