@mofeng2223/dsh-claude-provider 0.1.0 → 0.2.1

package/README.md

@@ -1,16 +1,28 @@
 # DSH Claude Provider
 
-`@mofeng2223/dsh-claude-provider` adds a visible Custom Claude provider type to
-DeepSeek Harness and fixes Anthropic Messages routes that still
+English | [简体中文](./README.zh-CN.md)
+
+`@mofeng2223/dsh-claude-provider` adds a visible, reusable Claude provider type
+to DeepSeek Harness and fixes its routes when an Anthropic Messages adapter still
 serialize reasoning as `thinking.type: enabled` with `budget_tokens`. For the
-configured provider/model pairs, it converts the outgoing request to
+explicitly registered provider/model pairs, it converts the outgoing request to
 `thinking.type: adaptive` plus `output_config.effort`.
 
-The bundled defaults recognize every `claude-*` model on every provider route.
-At request time the plugin reads the model's configured effort list: four- and
-five-level profiles use adaptive thinking, while an On/Off profile keeps the
-legacy budget-based path. This lets future Claude model IDs work without a
-plugin update.
+Use **Add Claude provider** to create any number of Provider IDs under this one
+type. Membership is stored explicitly in the plugin's own settings namespace.
+The plugin never infers membership from the `anthropic-messages` protocol, a
+`claude-*` model ID, or a default reasoning value. Generic custom providers and
+built-in providers are therefore untouched even when they use the same wire
+protocol.
+
+Only explicitly typed providers receive the Claude badge, native model
+discovery, recorded capacity defaults, per-model thinking modes, and adaptive
+request conversion. At request time the plugin reads the selected model's
+configured effort list: four- and five-level profiles use adaptive thinking,
+while an On/Off profile keeps the legacy budget-based path. Newly entered
+models default to five levels, so future model IDs can be configured without a
+plugin update. Claude providers select High by default; toggle-only models are
+shown as On/Off and default to On, without an extra provider-default choice.
 
 The same package supplies both the Host request adapter and the Web settings
 client. The client marks its model-directory request with a private discovery
@@ -57,7 +69,7 @@ npx @deepseek-ai/dsh plugin --profile headless remove @mofeng2223/dsh-claude-pro
 ```
 
 Uninstall intentionally leaves `~/.dsh/settings.yaml` and stored credentials
-alone. Existing custom providers therefore remain visible as ordinary custom
+alone. Existing Claude-type providers therefore remain visible as ordinary custom
 `anthropic-messages` routes, but lose this plugin's Claude badge, per-model
 thinking-mode controls, native Anthropic model discovery, and adaptive request
 rewrite.
@@ -65,8 +77,8 @@ rewrite.
 The plugin never stores or logs API keys. Model discovery uses the one-shot key
 typed into the form or resolves the existing route's credential through DSH;
 the value is sent only to that route's Anthropic Models API. Its request
-transformer runs only inside matching `llm/stream` calls and leaves nonmatching
-providers and models untouched.
+transformer runs only inside `llm/stream` calls for Provider IDs explicitly
+registered under this plugin's type and leaves every other provider untouched.
 
 The generated `.tgz` package is portable. Copy it to Windows and install it by
 its local path; no source build or platform-specific dependency is required.

package/README.zh-CN.md

@@ -0,0 +1,56 @@
+# DSH Claude Provider
+
+[English](./README.md) | 简体中文
+
+`@mofeng2223/dsh-claude-provider` 为 DeepSeek Harness 增加一个可见且可复用的“Claude 提供方”类型，并修正其 Anthropic Messages 适配器仍将思考参数序列化为 `thinking.type: enabled` 与 `budget_tokens` 的问题。对于明确登记在此类型下的提供方和模型组合，插件会将请求转换为 `thinking.type: adaptive` 与 `output_config.effort`。
+
+通过“添加 Claude 提供方”可以在同一个类型下创建任意多个 Provider ID。类型归属会明确保存在插件自己的设置命名空间中。插件不会根据 `anthropic-messages` 协议、`claude-*` 模型 ID 或默认思考强度推断类型。因此，即使通用自定义提供方或内置提供方使用相同协议，插件也不会修改它们。
+
+只有明确登记为此类型的提供方才会获得 Claude 标识、原生模型发现、已记录容量预填、按模型设置思考模式以及 adaptive 请求转换。发送请求时，插件会读取所选模型配置的思考档位：四档和五档配置使用 adaptive thinking；开启/关闭配置继续使用旧版基于预算的思考方式。手动新增的模型默认使用五档，因此未来新增的模型 ID 也可以直接配置。Claude 提供方默认选择 High；仅支持开关的模型显示为 On/Off，并默认选择 On，不再额外显示 Default。
+
+同一个 npm 包同时提供 Host 请求适配器和 Web 设置客户端。客户端会使用内部发现协议标记“获取模型目录”请求，再由 Host 部分处理。只有这个请求会调用 Anthropic 原生的 `GET /v1/models` 接口，并使用 `x-api-key` 和 `anthropic-version` 请求头。
+
+插件支持 Anthropic 游标分页，并会在提供方返回相关字段时读取 `display_name`、`max_input_tokens` 和 `max_tokens`。插件不会尝试使用 OpenAI 兼容的模型列表接口，也不会回退到 Bearer 鉴权。
+
+## 安装
+
+直接安装 npm 上发布的插件：
+
+```sh
+npx @deepseek-ai/dsh plugin --profile web add @mofeng2223/dsh-claude-provider
+npx @deepseek-ai/dsh plugin --profile headless add @mofeng2223/dsh-claude-provider
+```
+
+安装完成后，重启对应的 Harness 进程。
+
+修改插件源码后，可以重新构建 Web 客户端并生成单一分发包：
+
+```sh
+npm run build
+npm pack --pack-destination dist
+```
+
+日常安装不建议直接使用源码目录。直接安装源码目录会创建 pnpm `link:` 依赖；在目前的 DSH/pnpm 版本中，移除依赖和 bundle 注册后，顶层符号链接仍有可能残留。通过 npm 或 `.tgz` 归档安装时，文件由包管理器管理，卸载后不会留下这类链接。
+
+## 调试
+
+临时设置 `DSH_CLAUDE_PROVIDER_DEBUG=1`，可以为每个被改写的请求输出一行经过脱敏的诊断信息。诊断内容只包含提供方、模型和所选思考强度，不包含 API 密钥。
+
+## 卸载
+
+```sh
+npx @deepseek-ai/dsh plugin --profile web remove @mofeng2223/dsh-claude-provider
+npx @deepseek-ai/dsh plugin --profile headless remove @mofeng2223/dsh-claude-provider
+```
+
+卸载插件时会保留 `~/.dsh/settings.yaml` 和已经保存的凭据。现有的 Claude 类型提供方仍会作为普通的 `anthropic-messages` 自定义路由显示，但会失去本插件提供的 Claude 标识、按模型配置思考模式、Anthropic 原生模型发现以及 adaptive 请求改写功能。
+
+## 安全与隐私
+
+插件不会存储或记录 API 密钥。获取模型列表时，插件会使用表单中临时输入的密钥，或者通过 DSH 解析现有路由保存的凭据。密钥只会发送到该路由对应的 Anthropic Models API。
+
+请求转换器只会在明确登记到本插件类型的 Provider ID 所对应的 `llm/stream` 调用中运行，不会修改任何其他提供方。
+
+## Windows 支持
+
+发布到 npm 的插件和生成的 `.tgz` 包均可跨平台使用。Windows 可以直接通过 npm 包名或本地 `.tgz` 路径安装，无需在目标电脑上重新构建，也不依赖平台专用的原生模块。

package/cordis.patch.yml

@@ -3,10 +3,6 @@
       name: '@mofeng2223/dsh-claude-provider'
       config:
         debug: !!js process.env.DSH_CLAUDE_PROVIDER_DEBUG === '1'
-        routes:
-          - provider: '*'
-            models: &adaptive_claude_models
-              - claude-*
         effortMap:
           minimal: low
           low: low

package/lib/client.js

@@ -542,7 +542,7 @@ window.__ModuleLoader__.load({
 					const [providersResponse, settingsResponse] = await Promise.all([this.api.llm.providers({}), this.api.settings.describe({})]);
 					if (!providersResponse.result.ok) throw new Error(providersResponse.result.error.message);
 					if (!settingsResponse.result.ok) throw new Error(settingsResponse.result.error.message);
-					providers = providersResponse.result.value.providers;
+					providers = providersResponse.result.value.providers.filter((entry) => entry.provider !== CLAUDE_PROVIDER_DIRECTORY_SENTINEL);
 					writable = settingsResponse.result.value.writable;
 					views = settingsResponse.result.value.namespaces;
 				} catch (error) {
@@ -1088,9 +1088,9 @@ window.__ModuleLoader__.load({
 			const [route, setRoute] = (0, react.useState)("");
 			const [displayName, setDisplayName] = (0, react.useState)("");
 			const [baseURL, setBaseURL] = (0, react.useState)("");
-			const [providerType, setProviderType] = (0, react.useState)("generic");
-			const isAdaptiveClaude = providerType === "claude-adaptive";
-			const [protocol, setProtocol] = (0, react.useState)(protocols[0] ?? "");
+			const providerType = props.providerType ?? "generic";
+			const isAdaptiveClaude = providerType === CLAUDE_PROVIDER_TYPE;
+			const [protocol, setProtocol] = (0, react.useState)(isAdaptiveClaude ? "anthropic-messages" : protocols[0] ?? "");
 			const [keyDraft, setKeyDraft] = (0, react.useState)("");
 			const [models, setModels] = (0, react.useState)([]);
 			const [busy, setBusy] = (0, react.useState)(false);
@@ -1136,6 +1136,13 @@ window.__ModuleLoader__.load({
 					if (!response.result.ok) return response.result.error.message;
 					setCommitted(true);
 				}
+				if (isAdaptiveClaude) {
+					const typed = await api.settings.mutate({
+						ns: CLAUDE_PROVIDER_SETTINGS_NS,
+						ops: [{ op: "set", path: ["providerTypes", route], value: CLAUDE_PROVIDER_TYPE }]
+					});
+					if (!typed.result.ok) return typed.result.error.message;
+				}
 				if (storesKey) {
 					const stored = await api.credentials.set({
 						ref: keyRef,
@@ -1167,30 +1174,9 @@ window.__ModuleLoader__.load({
 						className: ModelsSection_module_css_default["editorHeader"],
 						children: (0, react_jsx_runtime.jsx)("span", {
 							className: ModelsSection_module_css_default["editorTitle"],
-							children: t("customTitle")
+							children: t(isAdaptiveClaude ? "claudeCustomTitle" : "customTitle")
 						})
 					}),
-					(0, react_jsx_runtime.jsxs)("div", {
-						className: ModelsSection_module_css_default["field"],
-						children: [(0, react_jsx_runtime.jsx)("span", {
-							className: ModelsSection_module_css_default["fieldLabel"],
-							children: t("customProviderType")
-						}), (0, react_jsx_runtime.jsxs)("select", {
-							className: `${ModelsSection_module_css_default["input"]} ${ModelsSection_module_css_default["selectInput"]}`,
-							value: providerType,
-							"aria-label": t("customProviderType"),
-							disabled: profileDisabled,
-							onChange: (event) => {
-								const nextType = event.target.value;
-								setProviderType(nextType);
-								if (nextType === "claude-adaptive") {
-									setProtocol("anthropic-messages");
-									setModels((current) => current.map(withDefaultClaudeReasoning));
-								}
-							},
-							children: [(0, react_jsx_runtime.jsx)("option", { value: "generic", children: t("customProviderTypeGeneric") }), (0, react_jsx_runtime.jsx)("option", { value: "claude-adaptive", children: t("customProviderTypeClaude") })]
-						})]
-					}),
 					isAdaptiveClaude ? (0, react_jsx_runtime.jsxs)("p", {
 						className: ModelsSection_module_css_default["savedNotice"],
 						role: "status",
@@ -1662,7 +1648,7 @@ window.__ModuleLoader__.load({
 								...catalogProps,
 								probe,
 								probeBlocked: keyFailure,
-								thinkingPresets: probeApi === "anthropic-messages",
+								thinkingPresets: props.thinkingPresets === true,
 								api
 							})
 						]
@@ -1761,6 +1747,11 @@ window.__ModuleLoader__.load({
 					}]
 				});
 				if (!response.result.ok) return response.result.error.message;
+				const typeResponse = await api.settings.mutate({
+					ns: CLAUDE_PROVIDER_SETTINGS_NS,
+					ops: [{ op: "unset", path: ["providerTypes", target.provider] }]
+				});
+				if (!typeResponse.result.ok) return typeResponse.result.error.message;
 			} catch (error) {
 				return messageOf$1(error);
 			}
@@ -1793,6 +1784,9 @@ window.__ModuleLoader__.load({
 			};
 		}
 		const CLAUDE_DISCOVERY_API = "mofeng-anthropic-models";
+		const CLAUDE_PROVIDER_SETTINGS_NS = "dsh-claude-provider";
+		const CLAUDE_PROVIDER_TYPE = "claude-adaptive";
+		const CLAUDE_PROVIDER_DIRECTORY_SENTINEL = "dsh-claude-provider-type";
 		const CLAUDE_FIVE_EFFORTS = Object.freeze({ low: "low", medium: "medium", high: "high", xhigh: "xhigh", max: "max" });
 		const CLAUDE_FOUR_EFFORTS = Object.freeze({ low: "low", medium: "medium", high: "high", max: "max" });
 		const CLAUDE_TOGGLE_EFFORTS = Object.freeze({ off: null, high: "high" });
@@ -1881,11 +1875,8 @@ window.__ModuleLoader__.load({
 			});
 		}
 		function isClaudeProvider(row, state) {
-			if (row.entry.settingsNs !== "llm-pi-ai") return false;
-			const namespace = state.namespaces.get("llm-pi-ai");
-			if (namespace === void 0) return false;
-			const profile = (0, _deepseek_ai_dsh_client_schema_form.getPath)(namespace.value, row.entry.settingsPath);
-			return profile !== null && typeof profile === "object" && profile.api === "anthropic-messages" && Array.isArray(profile.models) && profile.models.length > 0;
+			const namespace = state.namespaces.get(CLAUDE_PROVIDER_SETTINGS_NS);
+			return namespace?.value?.providerTypes?.[row.entry.provider] === CLAUDE_PROVIDER_TYPE;
 		}
 		/** Stable visible and accessible identity for one provider target. */
 		function providerTargetLabel(target) {
@@ -1919,7 +1910,7 @@ window.__ModuleLoader__.load({
 			const [deleting, setDeleting] = (0, react.useState)(false);
 			const [deleteFailure, setDeleteFailure] = (0, react.useState)(void 0);
 			const [savedTarget, setSavedTarget] = (0, react.useState)(void 0);
-			const [declaring, setDeclaring] = (0, react.useState)(false);
+			const [declaringType, setDeclaringType] = (0, react.useState)(void 0);
 			const [dismissedSetup, setDismissedSetup] = (0, react.useState)(() => /* @__PURE__ */ new Set());
 			const announceSaved = (target) => {
 				controller.load().then(() => {
@@ -1929,7 +1920,7 @@ window.__ModuleLoader__.load({
 			const closeEditor = (changed, target) => {
 				setEditing(void 0);
 				setAdding(false);
-				setDeclaring(false);
+				setDeclaringType(void 0);
 				if (changed) announceSaved(target);
 			};
 			/**
@@ -2026,6 +2017,7 @@ window.__ModuleLoader__.load({
 								children: renderProviderEditor({
 									target,
 									namespace,
+									thinkingPresets: isClaudeProvider(row, state),
 									api,
 									t,
 									readOnly: !state.writable,
@@ -2055,7 +2047,7 @@ window.__ModuleLoader__.load({
 											}) : null,
 											adaptiveClaude ? (0, react_jsx_runtime.jsx)("span", {
 												className: ModelsSection_module_css_default["rowTag"],
-												children: t("adaptiveClaudeTag")
+												children: t("claudeTypeTag")
 											}) : null,
 											credentialConfigured ? (0, react_jsx_runtime.jsx)("span", {
 												className: `${ModelsSection_module_css_default["credentialDot"]} ${ModelsSection_module_css_default["credentialDotConfigured"]}`,
@@ -2077,7 +2069,7 @@ window.__ModuleLoader__.load({
 											"aria-label": providerCopy(t("editProvider"), target),
 											onClick: () => {
 												setSavedTarget(void 0);
-												setDeclaring(false);
+												setDeclaringType(void 0);
 												setAdding(false);
 												setEditing(open ? void 0 : target);
 											},
@@ -2098,6 +2090,7 @@ window.__ModuleLoader__.load({
 								}), open ? renderProviderEditor({
 									target,
 									namespace,
+									thinkingPresets: isClaudeProvider(row, state),
 									api,
 									t,
 									readOnly: !state.writable,
@@ -2145,18 +2138,19 @@ window.__ModuleLoader__.load({
 									closeEditor(changed, addTarget);
 								}
 							}, addTarget.provider)]
-						}) : declaring ? (0, react_jsx_runtime.jsx)("div", {
+						}) : declaringType !== void 0 ? (0, react_jsx_runtime.jsx)("div", {
 							className: ModelsSection_module_css_default["addCard"],
 							children: (0, react_jsx_runtime.jsx)(CustomProviderCard, {
 								taken: state.rows.map((row) => row.entry.provider),
 								protocols,
+								providerType: declaringType,
 								/* v8 ignore next -- the card only opens from a button disabled without this namespace */
 								revision: state.namespaces.get("llm-pi-ai")?.revision ?? 0,
 								api,
 								t,
 								readOnly: !state.writable,
 								onClose: (changed) => {
-									setDeclaring(false);
+									setDeclaringType(void 0);
 									if (changed) controller.load();
 								}
 							})
@@ -2171,7 +2165,7 @@ window.__ModuleLoader__.load({
 									/* v8 ignore next -- the button is disabled while nothing is addable */
 									if (first === void 0) return;
 									setSavedTarget(void 0);
-									setDeclaring(false);
+									setDeclaringType(void 0);
 									setAdding(true);
 									setEditing(targetOf(first));
 								},
@@ -2184,9 +2178,20 @@ window.__ModuleLoader__.load({
 									setSavedTarget(void 0);
 									setAdding(false);
 									setEditing(void 0);
-									setDeclaring(true);
+									setDeclaringType("generic");
 								},
 								children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconPlusOutline16, { size: 14 }), t("customAdd")]
+							}), (0, react_jsx_runtime.jsxs)("button", {
+								type: "button",
+								className: ModelsSection_module_css_default["addButton"],
+								disabled: !state.namespaces.has(CLAUDE_PROVIDER_SETTINGS_NS) || !state.writable,
+								onClick: () => {
+									setSavedTarget(void 0);
+									setAdding(false);
+									setEditing(void 0);
+									setDeclaringType(CLAUDE_PROVIDER_TYPE);
+								},
+								children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconPlusOutline16, { size: 14 }), t("claudeCustomAdd")]
 							})]
 						})
 					}),
@@ -2662,9 +2667,11 @@ window.__ModuleLoader__.load({
 			customAdd: "Add a custom provider",
 			customTitle: "Custom provider",
 			customTag: "Custom",
-			customProviderType: "Provider type",
-			customProviderTypeGeneric: "Generic custom provider",
-			customProviderTypeClaude: "Custom Claude provider",
+			claudeCustomAdd: "Add Claude provider",
+			claudeCustomTitle: "Claude provider",
+			claudeTypeUnavailable: "Claude provider type storage is unavailable.",
+			claudeTypeTag: "Claude provider",
+			claudeTypeIntro: "Only this provider type enables Claude model discovery, recorded capacities, thinking modes, and adaptive request conversion.",
 			adaptiveClaudeEnabled: "Choose a thinking mode for each model. New models default to five levels.",
 			adaptiveClaudeHelpLabel: "Thinking mode help",
 			adaptiveClaudeHelp: "Five (low / medium / high / xhigh / max): Fable 5, Opus 5, Opus 4.8, Opus 4.7, Sonnet 5\nFour (low / medium / high / max): Opus 4.6, Sonnet 4.6\nOn / Off: Haiku 4.5",
@@ -2769,9 +2776,11 @@ window.__ModuleLoader__.load({
 			customAdd: "添加自定义提供方",
 			customTitle: "自定义提供方",
 			customTag: "自定义",
-			customProviderType: "供应商类型",
-			customProviderTypeGeneric: "通用自定义供应商",
-			customProviderTypeClaude: "自定义 Claude 供应商",
+			claudeCustomAdd: "添加 Claude 提供方",
+			claudeCustomTitle: "Claude 提供方",
+			claudeTypeUnavailable: "Claude 提供方类型存储不可用。",
+			claudeTypeTag: "Claude 提供方",
+			claudeTypeIntro: "只有此提供方类型会启用 Claude 模型发现、已记录容量、思考模式和 adaptive 请求转换。",
 			adaptiveClaudeEnabled: "每个模型可单独选择思考模式；新增模型默认使用五档。",
 			adaptiveClaudeHelpLabel: "思考模式说明",
 			adaptiveClaudeHelp: "五档（低 / 中 / 高 / 超高 / 最大）：Fable 5、Opus 5、Opus 4.8、Opus 4.7、Sonnet 5\n四档（低 / 中 / 高 / 最大）：Opus 4.6、Sonnet 4.6\n开启 / 关闭：Haiku 4.5",

package/package.json

@@ -1,9 +1,17 @@
 {
   "name": "@mofeng2223/dsh-claude-provider",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Custom Claude provider support for DeepSeek Harness",
   "author": "mofeng2223",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MoFeng2223/dsh-claude-provider.git"
+  },
+  "homepage": "https://github.com/MoFeng2223/dsh-claude-provider#readme",
+  "bugs": {
+    "url": "https://github.com/MoFeng2223/dsh-claude-provider/issues"
+  },
   "keywords": [
     "deepseek-harness",
     "dsh-plugin",
@@ -15,6 +23,10 @@
     "registry": "https://registry.npmjs.org/"
   },
   "type": "module",
+  "dependencies": {
+    "@deepseek-ai/dsh-settings": "0.1.0-rc.6",
+    "@deepseek-ai/schemastery": "3.18.1"
+  },
   "exports": {
     ".": "./src/index.js",
     "./client": "./lib/client.js",
@@ -25,6 +37,7 @@
     "lib/client.js",
     "cordis.patch.yml",
     "README.md",
+    "README.zh-CN.md",
     "LICENSE"
   ],
   "scripts": {

package/src/index.js

@@ -1,7 +1,17 @@
 import { AsyncLocalStorage } from 'node:async_hooks'
+import z from '@deepseek-ai/schemastery'
+import { settingsNamespace } from '@deepseek-ai/dsh-settings'
 
 export const name = 'claude-provider'
-export const inject = ['llm']
+export const inject = ['llm', 'settings']
+
+export const CLAUDE_PROVIDER_TYPE = 'claude-adaptive'
+export const CLAUDE_PROVIDER_SETTINGS_NS = settingsNamespace('dsh-claude-provider')
+export const CLAUDE_PROVIDER_DIRECTORY_SENTINEL = 'dsh-claude-provider-type'
+
+const ProviderTypeSettings = z.object({
+  providerTypes: z.dict(z.const(CLAUDE_PROVIDER_TYPE)).default({}),
+})
 
 const DEFAULT_EFFORT_MAP = Object.freeze({
   minimal: 'low',
@@ -235,36 +245,55 @@ function installClaudeModelDiscovery(ctx) {
 }
 
 function resolveConfig(config = {}) {
-  if (!Array.isArray(config.routes) || config.routes.length === 0) {
-    throw new Error('claude-provider: routes must contain at least one provider')
-  }
-
-  const targets = new Map()
-  for (const [routeIndex, route] of config.routes.entries()) {
-    const provider = requireNonEmptyString(route?.provider, `routes[${routeIndex}].provider`)
-    if (!Array.isArray(route.models) || route.models.length === 0) {
-      throw new Error(`claude-provider: route "${provider}" must contain at least one model`)
-    }
-    if (targets.has(provider)) {
-      throw new Error(`claude-provider: duplicate provider route "${provider}"`)
-    }
-    targets.set(provider, new Set(route.models.map((model, modelIndex) =>
-      requireNonEmptyString(model, `routes[${routeIndex}].models[${modelIndex}]`))))
-  }
-
   const effortMap = { ...DEFAULT_EFFORT_MAP, ...config.effortMap }
   for (const [level, effort] of Object.entries(effortMap)) {
     requireNonEmptyString(level, 'effortMap key')
     requireNonEmptyString(effort, `effortMap.${level}`)
   }
 
-  return { targets, effortMap, debug: config.debug === true }
+  return { effortMap, debug: config.debug === true }
+}
+
+/** Whether an explicitly registered provider belongs to this plugin's Claude type. */
+export function isClaudeProviderType(settings, provider) {
+  if (typeof provider !== 'string' || provider.length === 0) return false
+  return settings?.providerTypes?.[provider] === CLAUDE_PROVIDER_TYPE
+}
+
+/** Give typed Claude routes a concrete default and readable labels for toggle-only models. */
+export function withClaudeProviderReasoningDefaults(modelInfo) {
+  const reasoning = modelInfo?.reasoning
+  if (reasoning === undefined || !Array.isArray(reasoning.efforts)) return modelInfo
+  const ids = new Set(reasoning.efforts.map(effort => String(effort.id)))
+  const toggleOnly = ids.size === 2 && ids.has('off') && ids.has('high')
+  return {
+    ...modelInfo,
+    reasoning: {
+      ...reasoning,
+      defaultEffort: 'high',
+      efforts: toggleOnly
+        ? reasoning.efforts.map(effort => ({
+            ...effort,
+            name: effort.id === 'off' ? 'Off' : effort.id === 'high' ? 'On' : effort.name,
+          }))
+        : reasoning.efforts,
+    },
+  }
 }
 
-function isTarget(targets, provider, model) {
-  const matches = patterns => patterns !== undefined && [...patterns].some(pattern =>
-    pattern === '*' || pattern === model || pattern.endsWith('*') && model.startsWith(pattern.slice(0, -1)))
-  return matches(targets.get(provider)) || matches(targets.get('*'))
+function installClaudeModelInfoDefaults(ctx, providerTypes) {
+  const llm = ctx.llm
+  const upstream = llm.resolveModelInfo
+  const wrapped = async function (provider, model, signal) {
+    const info = await upstream.call(this, provider, model, signal)
+    return isClaudeProviderType(providerTypes.get(), provider)
+      ? withClaudeProviderReasoningDefaults(info)
+      : info
+  }
+  llm.resolveModelInfo = wrapped
+  ctx.effect(() => () => {
+    if (llm.resolveModelInfo === wrapped) llm.resolveModelInfo = upstream
+  })
 }
 
 /** Four- and five-level model profiles are adaptive; the two-level toggle is legacy budget thinking. */
@@ -418,6 +447,18 @@ async function* modelAwareStream(ctx, storage, resolved, options, next) {
 
 export function apply(ctx, config) {
   const resolved = resolveConfig(config)
+  const providerTypes = ctx.settings.register(
+    CLAUDE_PROVIDER_SETTINGS_NS,
+    ProviderTypeSettings,
+    { base: { providerTypes: {} } },
+  )
+  ctx.llm.registerConfigurableProviders([{
+    provider: CLAUDE_PROVIDER_DIRECTORY_SENTINEL,
+    displayName: 'Claude Provider Type',
+    settingsNs: CLAUDE_PROVIDER_SETTINGS_NS,
+    settingsPath: ['providerTypes'],
+  }])
+  installClaudeModelInfoDefaults(ctx, providerTypes)
   installClaudeModelDiscovery(ctx)
   const storage = new AsyncLocalStorage()
   const upstreamFetch = globalThis.fetch
@@ -447,7 +488,7 @@ export function apply(ctx, config) {
   })
 
   ctx.on('llm/stream', (options, next) => {
-    if (!isTarget(resolved.targets, options.provider, options.model)) return next()
+    if (!isClaudeProviderType(providerTypes.get(), options.provider)) return next()
     return modelAwareStream(ctx, storage, resolved, options, next)
   })
 }