@qilin-agent/client-ui-settings-plugins 3.1.4 → 3.1.6

package/README.i18n.yaml

@@ -36,8 +36,8 @@
   en: 8e21487b8251d057
   zh: 9679617bac069cd3
 /qilin-agent-client-ui-settings-plugins/further-exploration:
-  en: dd6103dffd4af94a
-  zh: dd7e1dbffaf1aa5a
+  en: a9aea28be1bad3d8
+  zh: 5318cda666425a89
 /qilin-agent-client-ui-settings-plugins/model-experience:
   en: 6b7c6f82ab6c8435
   zh: 3328550d96a6368b

package/README.md

@@ -72,7 +72,7 @@ Saving writes staged fields through the client configuration form, which fences
 
 These pages cover the Plugins page, the settings base, the inventory tab, and the durable seams behind the forms.
 
-- [ui-plugin-manager](../ui-plugin-manager/README.md) — the section's management tab, whose `plugins.item`, `plugins.bundle.config`, and `plugins.row.config` slots host configuration pages.
+- [ui-plugin-manager](../ui-plugin-manager/README.md) — the Plugins page where official plugins are configured.
 - [ui-settings](../ui-settings/README.md) — the domain base declaring `settings.section` and the shared configuration forms.
 - [ui-settings-plugin-inventory](../ui-settings-plugin-inventory/README.md) — the read-only inventory the section shows.
 - [settings](../../settings/README.md) — the durable user-settings seam and its file provider.

package/README.zh.md

@@ -72,7 +72,7 @@ kind: "package-reference"
 
 以下页面覆盖插件页、设置底座、清单标签页与表单背后的持久化 seam。
 
-- [ui-plugin-manager](../ui-plugin-manager/README.zh.md)——分区的「插件管理」标签页，其 `plugins.item`、`plugins.bundle.config` 与 `plugins.row.config` slot 承载配置页。
+- [ui-plugin-manager](../ui-plugin-manager/README.zh.md)——配置官方插件的插件页。
 - [ui-settings](../ui-settings/README.zh.md)——声明 `settings.section` 与共享配置表单的领域底座。
 - [ui-settings-plugin-inventory](../ui-settings-plugin-inventory/README.zh.md)——分区显示的只读插件列表。
 - [settings](../../settings/README.zh.md)——持久化用户设置 seam 及其文件提供方。

package/lib/client.js

@@ -10,13 +10,13 @@ window.__ModuleLoader__.load({
 		let react = require("react");
 		let _qilin_agent_client_store = require("@qilin-agent/client-store");
 		//#region \0qilin-css:/home/runner/work/QiLin/QiLin/packages/client/ui-settings-plugins/src/client/PluginConfigForm.module.css.mjs
-		const css$4 = ".PuF0xa_form{flex-direction:column;display:flex}.PuF0xa_readOnly,.PuF0xa_unavailable{color:var(--qilin-alias-label-tertiary);margin:0 0 12px;font-size:12px;line-height:1.5}.PuF0xa_footer{align-items:center;gap:8px;padding-top:16px;display:flex}.PuF0xa_failed{min-width:0;color:var(--qilin-alias-label-error);flex:1;margin:0;font-size:12px;line-height:1.5}.PuF0xa_save{appearance:none;font:inherit;cursor:pointer;background:var(--qilin-alias-label-primary);color:var(--qilin-alias-bg-layer-3);border:1px solid #0000;border-radius:8px;padding:5px 14px;font-size:13px;line-height:1.5}.PuF0xa_save:disabled{opacity:.4;cursor:default}.PuF0xa_save:focus-visible{outline:var(--qilin-focus-ring-width) solid var(--qilin-focus-ring-color,var(--qilin-alias-state-business-primary));outline-offset:1px}";
-		const tagId$4 = "@qilin-agent/client-ui-settings-plugins/PluginConfigForm.module.css";
-		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$4) + "]") === null) {
+		const css$5 = ".PuF0xa_form{flex-direction:column;display:flex}.PuF0xa_readOnly,.PuF0xa_unavailable{color:var(--qilin-alias-label-tertiary);margin:0 0 12px;font-size:12px;line-height:1.5}.PuF0xa_footer{align-items:center;gap:8px;padding-top:16px;display:flex}.PuF0xa_failed{min-width:0;color:var(--qilin-alias-label-error);flex:1;margin:0;font-size:12px;line-height:1.5}.PuF0xa_save{appearance:none;font:inherit;cursor:pointer;background:var(--qilin-alias-label-primary);color:var(--qilin-alias-bg-layer-3);border:1px solid #0000;border-radius:8px;padding:5px 14px;font-size:13px;line-height:1.5}.PuF0xa_save:disabled{opacity:.4;cursor:default}.PuF0xa_save:focus-visible{outline:var(--qilin-focus-ring-width) solid var(--qilin-focus-ring-color,var(--qilin-alias-state-business-primary));outline-offset:1px}";
+		const tagId$5 = "@qilin-agent/client-ui-settings-plugins/PluginConfigForm.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$5) + "]") === null) {
 			const tag = document.createElement("style");
 			tag.dataset.plugin = "@qilin-agent/client-ui-settings-plugins";
-			tag.dataset.pluginCss = tagId$4;
-			tag.textContent = css$4;
+			tag.dataset.pluginCss = tagId$5;
+			tag.textContent = css$5;
 			document.head.appendChild(tag);
 		}
 		var PluginConfigForm_module_css_default = {
@@ -173,13 +173,13 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0qilin-css:/home/runner/work/QiLin/QiLin/packages/client/ui-settings-plugins/src/client/PluginsSettingsSection.module.css.mjs
-		const css$3 = "._2gTzQa_section{color:var(--qilin-alias-label-primary);flex-direction:column;gap:12px;display:flex}._2gTzQa_heading{margin:0;font-size:18px;font-weight:600}._2gTzQa_intro{color:var(--qilin-alias-label-tertiary);margin:0;font-size:13px}._2gTzQa_tabs{border-bottom:.5px solid var(--qilin-alias-border-l2);align-items:flex-end;gap:22px;margin-top:2px;display:flex}._2gTzQa_tab{color:var(--qilin-alias-label-tertiary);font:inherit;cursor:pointer;background:0 0;border:0;padding:7px 1px 9px;font-size:13px;line-height:20px;position:relative}._2gTzQa_tab:hover,._2gTzQa_tab[data-active=true]{color:var(--qilin-alias-label-primary)}._2gTzQa_tab[data-active=true]:after,._2gTzQa_tab:focus-visible:after{background:var(--qilin-alias-label-primary);content:\"\";border-radius:2px 2px 0 0;height:2px;position:absolute;bottom:-1px;left:0;right:0}._2gTzQa_tab:focus-visible{outline:var(--qilin-focus-ring-width) solid var(--qilin-focus-ring-color,var(--qilin-alias-state-business-primary));outline-offset:2px;color:var(--qilin-alias-label-primary);border-radius:2px}._2gTzQa_panel{min-width:0;padding-top:2px}._2gTzQa_cards{flex-direction:column;gap:10px;margin:0;padding:0;list-style:none;display:flex}._2gTzQa_empty{color:var(--qilin-alias-label-tertiary);margin:0;font-size:13px}._2gTzQa_configurable{flex-direction:column;gap:10px;display:flex}._2gTzQa_presetSettings{flex-direction:column;gap:8px;display:flex}._2gTzQa_presetSettingsTitle{margin:0;font-size:15px;font-weight:600;line-height:22px}";
-		const tagId$3 = "@qilin-agent/client-ui-settings-plugins/PluginsSettingsSection.module.css";
-		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$3) + "]") === null) {
+		const css$4 = "._2gTzQa_section{color:var(--qilin-alias-label-primary);flex-direction:column;gap:12px;display:flex}._2gTzQa_heading{margin:0;font-size:18px;font-weight:600}._2gTzQa_intro{color:var(--qilin-alias-label-tertiary);margin:0;font-size:13px}._2gTzQa_tabs{border-bottom:.5px solid var(--qilin-alias-border-l2);align-items:flex-end;gap:22px;margin-top:2px;display:flex}._2gTzQa_tab{color:var(--qilin-alias-label-tertiary);font:inherit;cursor:pointer;background:0 0;border:0;padding:7px 1px 9px;font-size:13px;line-height:20px;position:relative}._2gTzQa_tab:hover,._2gTzQa_tab[data-active=true]{color:var(--qilin-alias-label-primary)}._2gTzQa_tab[data-active=true]:after,._2gTzQa_tab:focus-visible:after{background:var(--qilin-alias-label-primary);content:\"\";border-radius:2px 2px 0 0;height:2px;position:absolute;bottom:-1px;left:0;right:0}._2gTzQa_tab:focus-visible{outline:var(--qilin-focus-ring-width) solid var(--qilin-focus-ring-color,var(--qilin-alias-state-business-primary));outline-offset:2px;color:var(--qilin-alias-label-primary);border-radius:2px}._2gTzQa_panel{min-width:0;padding-top:2px}._2gTzQa_cards{flex-direction:column;gap:10px;margin:0;padding:0;list-style:none;display:flex}._2gTzQa_empty{color:var(--qilin-alias-label-tertiary);margin:0;font-size:13px}._2gTzQa_configurable{flex-direction:column;gap:10px;display:flex}._2gTzQa_presetSettings{flex-direction:column;gap:8px;display:flex}._2gTzQa_presetSettingsTitle{margin:0;font-size:15px;font-weight:600;line-height:22px}";
+		const tagId$4 = "@qilin-agent/client-ui-settings-plugins/PluginsSettingsSection.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$4) + "]") === null) {
 			const tag = document.createElement("style");
 			tag.dataset.plugin = "@qilin-agent/client-ui-settings-plugins";
-			tag.dataset.pluginCss = tagId$3;
-			tag.textContent = css$3;
+			tag.dataset.pluginCss = tagId$4;
+			tag.textContent = css$4;
 			document.head.appendChild(tag);
 		}
 		var PluginsSettingsSection_module_css_default = {
@@ -294,13 +294,13 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0qilin-css:/home/runner/work/QiLin/QiLin/packages/client/ui-settings-plugins/src/client/SubagentLimitsFields.module.css.mjs
-		const css$2 = ".ilBR6W_limits{grid-template-columns:repeat(auto-fit,minmax(min(220px,100%),1fr));gap:16px;display:grid}.ilBR6W_limit{min-width:0}.ilBR6W_limit input{font-variant-numeric:tabular-nums;min-width:0}.ilBR6W_depthTable{border-collapse:collapse;border-block:.5px solid var(--qilin-alias-border-l2);width:100%;font:inherit;text-align:left;margin:8px 0}.ilBR6W_depthTable th,.ilBR6W_depthTable td{vertical-align:top;padding:6px 0}.ilBR6W_depthTable th{font-variant-numeric:tabular-nums;width:24px;color:var(--qilin-alias-label-primary);padding-right:8px;font-weight:500}.ilBR6W_depthTable tr+tr{border-top:.5px solid var(--qilin-alias-border-l2)}";
-		const tagId$2 = "@qilin-agent/client-ui-settings-plugins/SubagentLimitsFields.module.css";
-		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$2) + "]") === null) {
+		const css$3 = ".ilBR6W_limits{grid-template-columns:repeat(auto-fit,minmax(min(220px,100%),1fr));gap:16px;display:grid}.ilBR6W_limit{min-width:0}.ilBR6W_limit input{font-variant-numeric:tabular-nums;min-width:0}.ilBR6W_depthTable{border-collapse:collapse;border-block:.5px solid var(--qilin-alias-border-l2);width:100%;font:inherit;text-align:left;margin:8px 0}.ilBR6W_depthTable th,.ilBR6W_depthTable td{vertical-align:top;padding:6px 0}.ilBR6W_depthTable th{font-variant-numeric:tabular-nums;width:24px;color:var(--qilin-alias-label-primary);padding-right:8px;font-weight:500}.ilBR6W_depthTable tr+tr{border-top:.5px solid var(--qilin-alias-border-l2)}";
+		const tagId$3 = "@qilin-agent/client-ui-settings-plugins/SubagentLimitsFields.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$3) + "]") === null) {
 			const tag = document.createElement("style");
 			tag.dataset.plugin = "@qilin-agent/client-ui-settings-plugins";
-			tag.dataset.pluginCss = tagId$2;
-			tag.textContent = css$2;
+			tag.dataset.pluginCss = tagId$3;
+			tag.textContent = css$3;
 			document.head.appendChild(tag);
 		}
 		var SubagentLimitsFields_module_css_default = {
@@ -382,13 +382,13 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0qilin-css:/home/runner/work/QiLin/QiLin/packages/client/ui-settings-plugins/src/client/SubagentModelSelectionFields.module.css.mjs
-		const css$1 = ".USzyAq_permission{gap:6px;padding:12px 0;display:grid}.USzyAq_toggleRow{color:var(--qilin-alias-label-primary);justify-content:space-between;align-items:flex-start;gap:16px;font-size:13px;line-height:1.5;display:flex}.USzyAq_toggleLabel{flex:1;min-width:0}.USzyAq_selection{gap:10px;display:grid}.USzyAq_hint,.USzyAq_notice,.USzyAq_invalid,.USzyAq_conflict{margin:0;font-size:12px;line-height:1.5}.USzyAq_hint,.USzyAq_notice{color:var(--qilin-alias-label-tertiary)}.USzyAq_invalid,.USzyAq_conflict{color:var(--qilin-alias-state-error-primary)}.USzyAq_catalogError{color:var(--qilin-alias-state-error-primary);justify-content:space-between;align-items:center;gap:12px;font-size:12px;display:flex}.USzyAq_catalogError button{color:var(--qilin-alias-brand-primary);cursor:pointer;background:0 0;border:0;padding:0}.USzyAq_models{border:.5px solid var(--qilin-alias-border-l4);border-radius:8px;gap:6px;min-width:0;max-height:280px;margin:0;padding:10px;display:grid;overflow:auto}.USzyAq_models legend{color:var(--qilin-alias-label-secondary);padding:0 4px;font-size:12px}.USzyAq_modelGroup{gap:6px;display:grid}.USzyAq_modelGroup+.USzyAq_modelGroup{border-top:.5px solid var(--qilin-alias-border-l3);margin-top:4px;padding-top:10px}.USzyAq_providerName{color:var(--qilin-alias-label-tertiary);padding:0 6px;font-size:11px;font-weight:500}.USzyAq_model{cursor:pointer;border-radius:6px;grid-template-columns:auto minmax(0,1fr) auto;align-items:center;gap:8px;min-width:0;padding:6px;display:grid}.USzyAq_model:hover{background:var(--qilin-alias-bg-layer-4)}.USzyAq_modelName,.USzyAq_route{text-overflow:ellipsis;white-space:nowrap;display:block;overflow:hidden}.USzyAq_modelName{color:var(--qilin-alias-label-primary);font-size:13px}.USzyAq_route{color:var(--qilin-alias-label-tertiary);margin-top:2px;font-size:11px}.USzyAq_unavailable{color:var(--qilin-alias-label-tertiary);font-size:11px}";
-		const tagId$1 = "@qilin-agent/client-ui-settings-plugins/SubagentModelSelectionFields.module.css";
-		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$1) + "]") === null) {
+		const css$2 = ".USzyAq_permission{gap:6px;padding:12px 0;display:grid}.USzyAq_toggleRow{color:var(--qilin-alias-label-primary);justify-content:space-between;align-items:flex-start;gap:16px;font-size:13px;line-height:1.5;display:flex}.USzyAq_toggleLabel{flex:1;min-width:0}.USzyAq_selection{gap:10px;display:grid}.USzyAq_hint,.USzyAq_notice,.USzyAq_invalid,.USzyAq_conflict{margin:0;font-size:12px;line-height:1.5}.USzyAq_hint,.USzyAq_notice{color:var(--qilin-alias-label-tertiary)}.USzyAq_invalid,.USzyAq_conflict{color:var(--qilin-alias-state-error-primary)}.USzyAq_catalogError{color:var(--qilin-alias-state-error-primary);justify-content:space-between;align-items:center;gap:12px;font-size:12px;display:flex}.USzyAq_catalogError button{color:var(--qilin-alias-brand-primary);cursor:pointer;background:0 0;border:0;padding:0}.USzyAq_models{border:.5px solid var(--qilin-alias-border-l4);border-radius:8px;gap:6px;min-width:0;max-height:280px;margin:0;padding:10px;display:grid;overflow:auto}.USzyAq_models legend{color:var(--qilin-alias-label-secondary);padding:0 4px;font-size:12px}.USzyAq_modelGroup{gap:6px;display:grid}.USzyAq_modelGroup+.USzyAq_modelGroup{border-top:.5px solid var(--qilin-alias-border-l3);margin-top:4px;padding-top:10px}.USzyAq_providerName{color:var(--qilin-alias-label-tertiary);padding:0 6px;font-size:11px;font-weight:500}.USzyAq_model{cursor:pointer;border-radius:6px;grid-template-columns:auto minmax(0,1fr) auto;align-items:center;gap:8px;min-width:0;padding:6px;display:grid}.USzyAq_model:hover{background:var(--qilin-alias-bg-layer-4)}.USzyAq_modelName,.USzyAq_route{text-overflow:ellipsis;white-space:nowrap;display:block;overflow:hidden}.USzyAq_modelName{color:var(--qilin-alias-label-primary);font-size:13px}.USzyAq_route{color:var(--qilin-alias-label-tertiary);margin-top:2px;font-size:11px}.USzyAq_unavailable{color:var(--qilin-alias-label-tertiary);font-size:11px}";
+		const tagId$2 = "@qilin-agent/client-ui-settings-plugins/SubagentModelSelectionFields.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$2) + "]") === null) {
 			const tag = document.createElement("style");
 			tag.dataset.plugin = "@qilin-agent/client-ui-settings-plugins";
-			tag.dataset.pluginCss = tagId$1;
-			tag.textContent = css$1;
+			tag.dataset.pluginCss = tagId$2;
+			tag.textContent = css$2;
 			document.head.appendChild(tag);
 		}
 		var SubagentModelSelectionFields_module_css_default = {
@@ -588,13 +588,13 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0qilin-css:/home/runner/work/QiLin/QiLin/packages/client/ui-settings-plugins/src/client/SubagentCard.module.css.mjs
-		const css = ".NLp0wG_section{min-width:0;padding:16px 0}.NLp0wG_heading{color:var(--qilin-alias-label-primary);margin:0;font-size:13px;font-weight:600;line-height:1.5}";
-		const tagId = "@qilin-agent/client-ui-settings-plugins/SubagentCard.module.css";
-		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+		const css$1 = ".NLp0wG_section{min-width:0;padding:16px 0}.NLp0wG_heading{color:var(--qilin-alias-label-primary);margin:0;font-size:13px;font-weight:600;line-height:1.5}";
+		const tagId$1 = "@qilin-agent/client-ui-settings-plugins/SubagentCard.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$1) + "]") === null) {
 			const tag = document.createElement("style");
 			tag.dataset.plugin = "@qilin-agent/client-ui-settings-plugins";
-			tag.dataset.pluginCss = tagId;
-			tag.textContent = css;
+			tag.dataset.pluginCss = tagId$1;
+			tag.textContent = css$1;
 			document.head.appendChild(tag);
 		}
 		var SubagentCard_module_css_default = {
@@ -834,6 +834,23 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
+		//#region \0qilin-css:/home/runner/work/QiLin/QiLin/packages/client/ui-settings-plugins/src/client/WebSearchCard.module.css.mjs
+		const css = ".zhjlca_feature{gap:6px;display:grid}.zhjlca_toggleRow{color:var(--qilin-alias-label-primary);justify-content:space-between;align-items:flex-start;gap:16px;font-size:13px;line-height:1.5;display:flex}.zhjlca_hint{color:var(--qilin-alias-label-tertiary);margin:0;font-size:12px;line-height:1.5}.zhjlca_link{color:var(--qilin-alias-link);text-decoration:none}.zhjlca_link:hover{text-decoration:underline}";
+		const tagId = "@qilin-agent/client-ui-settings-plugins/WebSearchCard.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@qilin-agent/client-ui-settings-plugins";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var WebSearchCard_module_css_default = {
+			"feature": "zhjlca_feature",
+			"hint": "zhjlca_hint",
+			"link": "zhjlca_link",
+			"toggleRow": "zhjlca_toggleRow"
+		};
+		//#endregion
 		//#region lib/types/client/WebSearchCard.js
 		/**
 		* Render the web-search provider's one-liner or its configuration form, as the Plugins page asks.
@@ -844,13 +861,38 @@ window.__ModuleLoader__.load({
 			const { t } = props;
 			const state = props.useWebSearchCard((snapshot) => snapshot);
 			if (props.view === "summary") return t("webSearchDescription");
-			const disabled = !state.writable;
+			const disabled = !state.writable || state.saving;
+			const searchApi = state.useSearchApi;
+			const limitField = searchApi ? "count" : "maxUses";
 			return (0, react_jsx_runtime.jsxs)(PluginConfigForm, {
 				t,
 				state,
 				onSave: props.save,
 				onDiscard: props.discard,
 				children: [
+					state.apiSwitchAvailable && (0, react_jsx_runtime.jsxs)("div", {
+						className: WebSearchCard_module_css_default.feature,
+						children: [(0, react_jsx_runtime.jsxs)("label", {
+							className: WebSearchCard_module_css_default.toggleRow,
+							children: [(0, react_jsx_runtime.jsx)("span", { children: t("webSearchUseApi") }), (0, react_jsx_runtime.jsx)(_qilin_agent_client_ui_primitives.Switch, {
+								checked: searchApi,
+								label: t("webSearchUseApi"),
+								disabled: disabled || state.apiSwitchBlocked,
+								onChange: (checked) => {
+									props.setSearchApi(checked);
+								}
+							})]
+						}), (0, react_jsx_runtime.jsxs)("p", {
+							className: WebSearchCard_module_css_default.hint,
+							children: [t("webSearchUseApiHint"), (0, react_jsx_runtime.jsx)("a", {
+								className: WebSearchCard_module_css_default.link,
+								href: t("webSearchGuideUrl"),
+								target: "_blank",
+								rel: "noopener noreferrer",
+								children: t("webSearchGuide")
+							})]
+						})]
+					}),
 					(0, react_jsx_runtime.jsx)(_qilin_agent_client_ui_primitives.SettingsSecretField, {
 						id: "plugin-config-web-search-key",
 						label: t("webSearchApiKey"),
@@ -865,8 +907,8 @@ window.__ModuleLoader__.load({
 					}),
 					(0, react_jsx_runtime.jsx)(_qilin_agent_client_ui_primitives.SettingsValueField, {
 						id: "plugin-config-web-search-endpoint",
-						label: t("webSearchBaseUrl"),
-						hint: t("webSearchBaseUrlHint"),
+						label: t(searchApi ? "webSearchSearchApiBaseUrl" : "webSearchBaseUrl"),
+						hint: t(searchApi ? "webSearchSearchApiBaseUrlHint" : "webSearchBaseUrlHint"),
 						overriddenLabel: t("overridden"),
 						resetLabel: t("reset"),
 						invalidLabel: t("invalidNumber"),
@@ -880,20 +922,20 @@ window.__ModuleLoader__.load({
 						}
 					}),
 					(0, react_jsx_runtime.jsx)(_qilin_agent_client_ui_primitives.SettingsValueField, {
-						id: "plugin-config-web-search-max-uses",
-						label: t("webSearchMaxUses"),
-						hint: t("webSearchMaxUsesHint"),
+						id: searchApi ? "plugin-config-web-search-count" : "plugin-config-web-search-max-uses",
+						label: t(limitField === "count" ? "webSearchCount" : "webSearchMaxUses"),
+						hint: t(searchApi ? "webSearchCountHint" : "webSearchMaxUsesHint"),
 						overriddenLabel: t("overridden"),
 						resetLabel: t("reset"),
-						invalidLabel: t("invalidNumber"),
+						invalidLabel: t(searchApi ? "webSearchInvalidCount" : "invalidNumber"),
 						numeric: true,
 						disabled,
-						...state.maxUses,
+						...state[limitField],
 						onEdit: (text) => {
-							props.edit("maxUses", text);
+							props.edit(limitField, text);
 						},
 						onReset: () => {
-							props.resetField("maxUses");
+							props.resetField(limitField);
 						}
 					})
 				]
@@ -941,7 +983,7 @@ window.__ModuleLoader__.load({
 		* client package must not depend on a Host package, and the executor families
 		* that own it spell the same value.
 		*/
-		const SHELL_NS = "shell";
+		const SHELL_NS = "bash-sandbox";
 		/** Bridges the `bash` scope onto the shell card's staged form. */
 		var BashCardController = class {
 			form;
@@ -1024,7 +1066,7 @@ window.__ModuleLoader__.load({
 		//#region lib/types/client/subagent-model-selection-card-controller.js
 		/** Staged editor for the Host-owned subagent model allowlist. */
 		/** Namespace of the Host-owned subagent model-selection preference. */
-		const SUBAGENT_MODEL_SELECTION_NS = "subagent-model-selection";
+		const SUBAGENT_MODEL_SELECTION_NS = "subagent-model-selection-settings";
 		/**
 		* Stable identity for one exact route; callers resolve it by lookup and never parse it.
 		* @param route - Provider/model route to identify.
@@ -1298,73 +1340,149 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region lib/types/client/web-search-card-controller.js
 		/**
-		* The web-search card's staged form over the `web-search-deepseek` settings
-		* namespace.
+		* The web-search page's staged form over three settings namespaces: `web`,
+		* whose provider selection the Search API switch writes, `web-search-deepseek`
+		* for Messages search, and `web-deepseek-api` for the Search and Fetch APIs.
+		*
+		* The switch selects `deepseek-search-api` and `deepseek-fetch-api` together, or
+		* Messages search with local HTTP fetch. A selection equal to the deployment's
+		* composed value clears the override instead of storing a copy of it.
 		*
-		* The key is the one control that does not live in the section: its literal
-		* never rides a response, so the card learns only whether one is configured
+		* The key is the one control that does not live in a section: its literal
+		* never rides a response, so the page learns only whether one is configured
 		* and writes it through the credentials domain, addressed by the reference the
-		* section names. It is still staged with the rest of the form, so one save
-		* covers everything the card shows.
+		* selected API's section names. It is still staged with the rest of the form,
+		* so one save covers everything the page shows.
 		*/
 		/**
-		* Namespace of the DeepSeek search provider. Spelled here rather than
+		* Namespace of the DeepSeek Messages search provider. Spelled here rather than
 		* imported: a client package must not depend on a Host package.
 		*/
 		const WEB_SEARCH_NS = "web-search-deepseek";
-		/** Credential reference the provider resolves when the section names none. */
+		/** Namespace of the DeepSeek Search and Fetch API providers. */
+		const WEB_API_NS = "web-deepseek-api";
+		/** Provider ids the switch writes into the web service's selection. */
+		const PROVIDERS = {
+			searchProvider: {
+				api: "deepseek-search-api",
+				messages: "deepseek-official"
+			},
+			fetchProvider: {
+				api: "deepseek-fetch-api",
+				messages: "http"
+			}
+		};
+		/** Credential reference the providers resolve when a section names none. */
 		const DEFAULT_API_KEY_REF = "DEEPSEEK_API_KEY";
 		/** Form field the credential control stages under. */
 		const API_KEY_FIELD = "apiKey";
-		/** Bridges the `web-search-deepseek` scope and the credentials domain onto the card. */
+		/** Bridges the three settings scopes and the credentials domain onto the page. */
 		var WebSearchCardController = class {
-			scope;
+			scopes;
 			ctx;
-			form;
+			selection;
+			messages;
+			api;
 			store;
+			unsubscribe;
 			credential = {
 				ref: "",
 				configured: false,
 				writable: true
 			};
 			/**
-			* @param scope - the bound settings scope for the `web-search-deepseek` namespace.
-			* @param ctx - the card plugin's context, whose `remote.credentials` namespace
-			* answers for the credential the section references.
+			* @param scopes - the bound settings scopes for the page's namespaces.
+			* @param ctx - the page plugin's context, whose `remote.credentials` namespace
+			* answers for the credential the selected section references.
 			*/
-			constructor(scope, ctx) {
-				this.scope = scope;
+			constructor(scopes, ctx) {
+				this.scopes = scopes;
 				this.ctx = ctx;
-				this.form = new _qilin_agent_client_ui_primitives.SettingsFormModel(scope, [(0, _qilin_agent_client_ui_primitives.settingsTextField)("baseURL"), (0, _qilin_agent_client_ui_primitives.settingsNumberField)("maxUses")], [{
+				this.selection = new _qilin_agent_client_ui_primitives.SettingsFormModel(scopes.web, [(0, _qilin_agent_client_ui_primitives.settingsTextField)("searchProvider"), (0, _qilin_agent_client_ui_primitives.settingsTextField)("fetchProvider")], [{
 					field: API_KEY_FIELD,
 					write: (text) => this.writeKey(text)
 				}]);
-				this.store = this.form.bind(() => this.projection());
-				scope.subscribe(() => {
+				this.messages = new _qilin_agent_client_ui_primitives.SettingsFormModel(scopes.messages, [(0, _qilin_agent_client_ui_primitives.settingsTextField)("baseURL"), (0, _qilin_agent_client_ui_primitives.settingsNumberField)("maxUses")]);
+				this.api = new _qilin_agent_client_ui_primitives.SettingsFormModel(scopes.api, [(0, _qilin_agent_client_ui_primitives.settingsTextField)("baseURL"), {
+					...(0, _qilin_agent_client_ui_primitives.settingsNumberField)("count"),
+					parse: (text) => {
+						if (text.trim() === "") return { kind: "clear" };
+						const value = Number(text);
+						return Number.isInteger(value) && value >= 1 && value <= 50 ? {
+							kind: "set",
+							value
+						} : void 0;
+					}
+				}]);
+				this.store = (0, _qilin_agent_client_store.createSnapshotStore)(this.projection());
+				const publish = () => {
+					this.store.set(this.projection());
+					if (this.ref() !== this.credential.ref) this.readCredential();
+				};
+				this.unsubscribe = [...[
+					this.selection,
+					this.messages,
+					this.api
+				].map((form) => form.bind(() => form.shell()).subscribe(publish)), ...[
+					scopes.web,
+					scopes.messages,
+					scopes.api
+				].map((scope) => scope.subscribe(() => {
 					this.readCredential();
-				});
+				}))];
 				this.readCredential();
 			}
+			/** Whether the Host serves both sections the switch needs. */
+			switchAvailable() {
+				return this.selection.shell().available && this.api.shell().available;
+			}
+			/** The staged switch position, read from the staged search selection. */
+			searchApi() {
+				return this.switchAvailable() && this.selection.field("searchProvider").text === PROVIDERS.searchProvider.api;
+			}
 			projection() {
+				const primary = this.messages.shell();
+				const served = [
+					primary,
+					this.selection.shell(),
+					this.api.shell()
+				].filter((item) => item.available);
+				const shell = {
+					available: primary.available,
+					writable: served.every((item) => item.writable),
+					dirty: served.some((item) => item.dirty),
+					invalid: served.some((item) => item.invalid),
+					saving: served.some((item) => item.saving),
+					failed: served.some((item) => item.failed)
+				};
+				const searchApi = this.searchApi();
 				return {
-					...this.form.shell(),
-					baseURL: this.form.field("baseURL"),
-					maxUses: this.form.field("maxUses"),
-					apiKey: this.form.field(API_KEY_FIELD),
+					...shell,
+					apiSwitchAvailable: this.switchAvailable(),
+					apiSwitchBlocked: shell.invalid || shell.failed,
+					useSearchApi: searchApi,
+					baseURL: (searchApi ? this.api : this.messages).field("baseURL"),
+					maxUses: this.messages.field("maxUses"),
+					count: this.api.field("count"),
+					apiKey: this.selection.field(API_KEY_FIELD),
 					apiKeyConfigured: this.credential.configured,
 					apiKeyWritable: this.credential.writable
 				};
 			}
+			/** The reference the selected API's section names, or the providers' default. */
+			ref() {
+				return refOf(this.searchApi() ? this.scopes.api.getSnapshot() : this.scopes.messages.getSnapshot());
+			}
 			/**
-			* Ask the credentials domain about the reference the section currently names.
+			* Ask the credentials domain about the reference the selected section currently names.
 			*
-			* The answer is stored with the reference it describes: `apiKeyEnv` can
-			* change between the request and its response, and two reads can settle out
-			* of order, so a response is published only while it still answers for the
-			* reference in force.
+			* The answer is stored with the reference it describes: `apiKeyEnv` and the
+			* switch can change between the request and its response, and two reads can
+			* settle out of order, so a response is published only while it still
+			* answers for the reference in force.
 			*/
 			async readCredential() {
-				const ref = refOf(this.scope.getSnapshot());
+				const ref = this.ref();
 				if (ref !== this.credential.ref) {
 					this.credential = {
 						ref,
@@ -1374,7 +1492,7 @@ window.__ModuleLoader__.load({
 					this.store.set(this.projection());
 				}
 				const response = await this.ctx.remote.credentials.describe([ref]);
-				if (!response.ok || ref !== refOf(this.scope.getSnapshot())) return;
+				if (!response.ok || ref !== this.ref()) return;
 				const view = response.value[ref];
 				const next = {
 					ref,
@@ -1386,11 +1504,11 @@ window.__ModuleLoader__.load({
 				this.store.set(this.projection());
 			}
 			/**
-			* Re-read after the Host reports a change to the reference this card watches.
+			* Re-read after the Host reports a change to the reference this page watches.
 			*
 			* A key can be written from somewhere else — the Models page addresses the
-			* same reference — and the settings section does not change when it is, so
-			* without this the badge keeps reporting a state the Host already replaced.
+			* same reference — and no settings section changes when it is, so without
+			* this the badge keeps reporting a state the Host already replaced.
 			* @param ref - the reference the Host reports as changed.
 			*/
 			refreshCredential(ref) {
@@ -1398,29 +1516,94 @@ window.__ModuleLoader__.load({
 				this.readCredential();
 			}
 			/**
-			* Build the face the card's slot registration injects.
-			* @returns the card's snapshot and its form actions.
+			* Build the face the page's slot registration injects. `baseURL` edits the
+			* selected API's endpoint; `maxUses` and `count` edit their own sections.
+			* @returns the page's snapshot and its form actions.
 			*/
 			inject() {
+				const formOf = (field) => {
+					if (field === API_KEY_FIELD) return this.selection;
+					if (field === "maxUses") return this.messages;
+					if (field === "count") return this.api;
+					return this.searchApi() ? this.api : this.messages;
+				};
 				return {
 					hooks: { webSearchCard: this.store },
-					...this.form.actions()
+					edit: (field, text) => {
+						formOf(field).actions().edit(field, text);
+					},
+					resetField: (field) => {
+						formOf(field).actions().resetField(field);
+					},
+					setSearchApi: (enabled) => {
+						this.select(enabled);
+					},
+					save: () => {
+						this.save();
+					},
+					discard: () => {
+						for (const form of [
+							this.selection,
+							this.messages,
+							this.api
+						]) form.actions().discard();
+					}
 				};
 			}
 			/**
+			* Stage both provider selections for one switch position. A target equal to
+			* the composed value clears the override so the deployment default keeps
+			* applying.
+			* @param enabled - true for the Search and Fetch APIs.
+			*/
+			select(enabled) {
+				const base = this.scopes.web.getSnapshot().base;
+				const actions = this.selection.actions();
+				for (const field of ["searchProvider", "fetchProvider"]) {
+					const target = PROVIDERS[field][enabled ? "api" : "messages"];
+					if (base?.[field] === target) actions.resetField(field);
+					else actions.edit(field, target);
+				}
+			}
+			/**
+			* Save the provider sections before the selection, so a switch takes effect
+			* only after the endpoint it uses has landed. A refused section stops the
+			* selection from saving and keeps every remaining draft for correction.
+			* @returns settlement after every attempted write.
+			*/
+			async save() {
+				const state = this.projection();
+				if (!state.available || state.invalid || state.saving) return;
+				for (const form of [this.messages, this.api]) {
+					if (!form.shell().available || !form.shell().dirty) continue;
+					await form.save();
+					if (form.shell().failed) return;
+				}
+				if (this.selection.shell().dirty) await this.selection.save();
+			}
+			/**
 			* Write the staged key, then re-read whether the Host now holds one.
 			* @param value - the staged credential literal.
 			* @returns whether the Host reports a configured credential afterwards.
 			*/
 			async writeKey(value) {
-				await this.ctx.remote.credentials.set(refOf(this.scope.getSnapshot()), value);
+				await this.ctx.remote.credentials.set(this.ref(), value);
 				await this.readCredential();
 				return this.credential.configured;
 			}
+			/** Release configuration subscriptions. */
+			dispose() {
+				for (const off of this.unsubscribe) off();
+				for (const form of [
+					this.selection,
+					this.messages,
+					this.api
+				]) form.dispose();
+			}
 		};
 		/**
-		* The credential reference the section names, or the provider's default.
-		* @param snapshot - the current scope snapshot.
+		* The credential reference a section names, or the providers' default.
+		* @param snapshot - the section's current scope snapshot.
 		* @returns the reference to address.
 		*/
 		function refOf(snapshot) {
@@ -1474,15 +1657,24 @@ window.__ModuleLoader__.load({
 			gitMaxListEntries: "List cap (entries)",
 			gitMaxListEntriesHint: "Upper bound on branches or pull requests one list answer returns.",
 			webSearchTitle: "Web search",
-			webSearchDescription: "The DeepSeek search provider.",
+			webSearchDescription: "Set up the DeepSeek search provider.",
+			webSearchUseApi: "Use the new Web Search API",
+			webSearchUseApiHint: "Off by default: search runs through DeepSeek Messages. For the new Web Search API's features and pricing, see the ",
+			webSearchGuide: "Search & Fetch guide",
+			webSearchGuideUrl: "https://api-docs.deepseek.com/guides/search",
 			webSearchApiKey: "API key",
 			webSearchApiKeyHint: "Stored outside the settings file. Leave blank to keep the current key.",
 			webSearchApiKeySet: "A key is configured.",
 			webSearchApiKeyUnset: "No key is configured; search is unavailable until one is.",
-			webSearchBaseUrl: "Endpoint",
-			webSearchBaseUrlHint: "Leave blank to use the provider default.",
+			webSearchBaseUrl: "Messages API base URL",
+			webSearchBaseUrlHint: "Include the API prefix, such as https://api.deepseek.com/anthropic/v1. The provider appends /messages. Leave blank to restore the default.",
 			webSearchMaxUses: "Max searches per request",
-			webSearchMaxUsesHint: "How many times one request may search before it must answer.",
+			webSearchMaxUsesHint: "How many searches the auxiliary model may run within one Messages request. Applies only to the Messages API.",
+			webSearchSearchApiBaseUrl: "Search / Fetch API base URL",
+			webSearchSearchApiBaseUrlHint: "Include the API prefix, such as https://api.deepseek.com/v1/tools. The provider appends /search or /fetch. Leave blank to restore the default.",
+			webSearchCount: "Results per search",
+			webSearchCountHint: "Results returned per query: an integer from 1 to 50, default 10. This controls result count, not search calls. web_search keeps no more sources than its own result limit.",
+			webSearchInvalidCount: "Enter an integer from 1 to 50, or leave blank to use the default.",
 			subagentTitle: "Subagent",
 			subagentDescription: "Set Subagent recursion depth, count, and models.",
 			subagentLimitsTitle: "Limits",
@@ -1556,15 +1748,24 @@ window.__ModuleLoader__.load({
 			gitMaxListEntries: "列表上限（条）",
 			gitMaxListEntriesHint: "一次列表应答最多返回多少分支或拉取请求。",
 			webSearchTitle: "网页搜索",
-			webSearchDescription: "DeepSeek 搜索提供方。",
+			webSearchDescription: "设置 DeepSeek 的搜索提供方。",
+			webSearchUseApi: "启用新版 Web 搜索 API",
+			webSearchUseApiHint: "默认关闭，搜索通过 DeepSeek Messages 完成。新版 Web 搜索 API 功能与计费详见",
+			webSearchGuide: "网页搜索与抓取指南",
+			webSearchGuideUrl: "https://api-docs.deepseek.com/zh-cn/guides/search",
 			webSearchApiKey: "API Key",
 			webSearchApiKeyHint: "不写入设置文件。留空表示保持当前密钥。",
 			webSearchApiKeySet: "已配置密钥。",
 			webSearchApiKeyUnset: "未配置密钥；配置之前搜索不可用。",
-			webSearchBaseUrl: "接口地址",
-			webSearchBaseUrlHint: "留空则使用提供方默认地址。",
+			webSearchBaseUrl: "Messages API 基础地址",
+			webSearchBaseUrlHint: "填写含 API 前缀的地址，例如 https://api.deepseek.com/anthropic/v1；程序追加 /messages，留空恢复默认。",
 			webSearchMaxUses: "单次请求最多搜索次数",
-			webSearchMaxUsesHint: "一次请求在必须作答前最多可以搜索多少次。",
+			webSearchMaxUsesHint: "辅助模型在一次 Messages 请求内最多可执行的搜索次数，仅适用于 Messages API。",
+			webSearchSearchApiBaseUrl: "Search / Fetch API 基础地址",
+			webSearchSearchApiBaseUrlHint: "填写含 API 前缀的地址，例如 https://api.deepseek.com/v1/tools；程序追加 /search 或 /fetch，留空恢复默认。",
+			webSearchCount: "每次搜索结果数",
+			webSearchCountHint: "每个查询返回的结果条数，须为 1–50 的整数，默认 10；不控制搜索调用次数。web_search 保留的来源数不超过其自身的结果上限。",
+			webSearchInvalidCount: "请填 1–50 的整数；留空表示使用默认值。",
 			subagentTitle: "Subagent",
 			subagentDescription: "设置 Subagent 的递归层级、数量和模型。",
 			subagentLimitsTitle: "运行限制",
@@ -1630,7 +1831,11 @@ window.__ModuleLoader__.load({
 			const bash = new BashCardController(ctx.configForms.get(SHELL_NS));
 			const git = new GitCardController(ctx.configForms.get(GIT_NS));
 			const agentLoop = new AgentLoopCardController(ctx.configForms.get(AGENT_LOOP_NS));
-			const webSearch = new WebSearchCardController(ctx.configForms.get(WEB_SEARCH_NS), ctx);
+			const webSearch = new WebSearchCardController({
+				web: ctx.configForms.get("web"),
+				messages: ctx.configForms.get(WEB_SEARCH_NS),
+				api: ctx.configForms.get(WEB_API_NS)
+			}, ctx);
 			const subagentLimits = new SubagentLimitsCardController(ctx.configForms.get("subagent"));
 			const subagentModelSelection = new SubagentModelSelectionCardController(ctx.configForms.get(SUBAGENT_MODEL_SELECTION_NS), ctx);
 			const subagentLimitsFace = subagentLimits.inject();
@@ -1650,6 +1855,9 @@ window.__ModuleLoader__.load({
 			ctx.effect(() => () => {
 				subagentModelSelection.dispose();
 			}, "ui-settings-plugins: subagent preference");
+			ctx.effect(() => () => {
+				webSearch.dispose();
+			}, "ui-settings-plugins: web-search form subscription");
 			const pages = [
 				[[SHELL_NS], () => ctx.slots.inject("plugins.item", () => ctx.slots.register({
 					name: "plugins.item",

package/lib/types/client/WebSearchCard.d.ts

@@ -1,7 +1,8 @@
 /**
- * The web-search provider's configuration page: its endpoint, its per-request
- * search budget, and the key — which is written through the credentials
- * domain, never into the settings section, so the literal never rides a response.
+ * The web-search settings page: the switch between Messages search and the
+ * Search and Fetch APIs, the selected API's endpoint and per-search limit, and
+ * the key — which is written through the credentials domain, never into the
+ * settings section, so the literal never rides a response.
  */
 import type { InjectFace, PropsLocale, PropsRuntime } from '@qilin-agent/client-ui-slots';
 import type { WebSearchCardFace } from './web-search-card-controller.ts';

package/lib/types/client/bash-card-controller.d.ts

@@ -7,7 +7,7 @@ import { type SettingsFormActions, type SettingsFieldState, type SettingsFormShe
  * client package must not depend on a Host package, and the executor families
  * that own it spell the same value.
  */
-export declare const SHELL_NS = "shell";
+export declare const SHELL_NS = "bash-sandbox";
 /** The shell fields this card edits — a subset of the served schema by design. */
 export interface BashSettings {
     /** Foreground command timeout in milliseconds. */

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

@@ -1,6 +1,6 @@
 /** Locale bundles for the built-in plugins settings section and the plugin configuration pages. */
 /** Locale keys these surfaces render. */
-export type PluginsSettingsLocaleKey = 'nav' | 'title' | 'intro' | 'tabs' | 'empty' | 'overridden' | 'reset' | 'readOnly' | 'unavailable' | 'save' | 'saving' | 'saveFailed' | 'invalidNumber' | 'bashTitle' | 'bashDescription' | 'bashTimeoutMs' | 'bashTimeoutMsHint' | 'bashMaxOutputBytes' | 'bashMaxOutputBytesHint' | 'agentLoopTitle' | 'agentLoopDescription' | 'agentLoopMaxParallel' | 'agentLoopMaxParallelHint' | 'webSearchTitle' | 'webSearchDescription' | 'webSearchApiKey' | 'webSearchApiKeyHint' | 'webSearchApiKeySet' | 'webSearchApiKeyUnset' | 'webSearchBaseUrl' | 'webSearchBaseUrlHint' | 'webSearchMaxUses' | 'webSearchMaxUsesHint' | 'gitTitle' | 'gitDescription' | 'gitBin' | 'gitBinHint' | 'ghBin' | 'ghBinHint' | 'gitTimeoutMs' | 'gitTimeoutMsHint' | 'gitDiscoveryTimeoutMs' | 'gitDiscoveryTimeoutMsHint' | 'ghTimeoutMs' | 'ghTimeoutMsHint' | 'gitMaxDiffBytes' | 'gitMaxDiffBytesHint' | 'gitMaxStderrChars' | 'gitMaxStderrCharsHint' | 'gitMaxListEntries' | 'gitMaxListEntriesHint' | 'subagentTitle' | 'subagentDescription' | 'subagentLimitsTitle' | 'subagentMaxDepth' | 'subagentDepthHelpLabel' | 'subagentDepthHelp' | 'subagentDepthZero' | 'subagentDepthOne' | 'subagentDepthOverride' | 'subagentMaxActive' | 'subagentCapacityHelpLabel' | 'subagentCapacityHelp' | 'subagentDepthInvalid' | 'subagentCapacityInvalid' | 'subagentModelSelectionTitle' | 'subagentModelSelectionToggle' | 'subagentModelSelectionChoose' | 'subagentModelSelectionAllowed' | 'subagentModelSelectionLoading' | 'subagentModelSelectionLoadFailed' | 'subagentModelSelectionRetry' | 'subagentModelSelectionPartial' | 'subagentModelSelectionUnavailable' | 'subagentModelSelectionUnavailableGroup' | 'subagentModelSelectionEmpty' | 'subagentModelSelectionRequired' | 'subagentModelSelectionConflict' | 'subagentModelSelectionOff';
+export type PluginsSettingsLocaleKey = 'nav' | 'title' | 'intro' | 'tabs' | 'empty' | 'overridden' | 'reset' | 'readOnly' | 'unavailable' | 'save' | 'saving' | 'saveFailed' | 'invalidNumber' | 'bashTitle' | 'bashDescription' | 'bashTimeoutMs' | 'bashTimeoutMsHint' | 'bashMaxOutputBytes' | 'bashMaxOutputBytesHint' | 'agentLoopTitle' | 'agentLoopDescription' | 'agentLoopMaxParallel' | 'agentLoopMaxParallelHint' | 'webSearchTitle' | 'webSearchDescription' | 'webSearchUseApi' | 'webSearchUseApiHint' | 'webSearchGuide' | 'webSearchGuideUrl' | 'webSearchApiKey' | 'webSearchApiKeyHint' | 'webSearchApiKeySet' | 'webSearchApiKeyUnset' | 'webSearchBaseUrl' | 'webSearchBaseUrlHint' | 'webSearchMaxUses' | 'webSearchMaxUsesHint' | 'webSearchSearchApiBaseUrl' | 'webSearchSearchApiBaseUrlHint' | 'webSearchCount' | 'webSearchCountHint' | 'webSearchInvalidCount' | 'gitTitle' | 'gitDescription' | 'gitBin' | 'gitBinHint' | 'ghBin' | 'ghBinHint' | 'gitTimeoutMs' | 'gitTimeoutMsHint' | 'gitDiscoveryTimeoutMs' | 'gitDiscoveryTimeoutMsHint' | 'ghTimeoutMs' | 'ghTimeoutMsHint' | 'gitMaxDiffBytes' | 'gitMaxDiffBytesHint' | 'gitMaxStderrChars' | 'gitMaxStderrCharsHint' | 'gitMaxListEntries' | 'gitMaxListEntriesHint' | 'subagentTitle' | 'subagentDescription' | 'subagentLimitsTitle' | 'subagentMaxDepth' | 'subagentDepthHelpLabel' | 'subagentDepthHelp' | 'subagentDepthZero' | 'subagentDepthOne' | 'subagentDepthOverride' | 'subagentMaxActive' | 'subagentCapacityHelpLabel' | 'subagentCapacityHelp' | 'subagentDepthInvalid' | 'subagentCapacityInvalid' | 'subagentModelSelectionTitle' | 'subagentModelSelectionToggle' | 'subagentModelSelectionChoose' | 'subagentModelSelectionAllowed' | 'subagentModelSelectionLoading' | 'subagentModelSelectionLoadFailed' | 'subagentModelSelectionRetry' | 'subagentModelSelectionPartial' | 'subagentModelSelectionUnavailable' | 'subagentModelSelectionUnavailableGroup' | 'subagentModelSelectionEmpty' | 'subagentModelSelectionRequired' | 'subagentModelSelectionConflict' | 'subagentModelSelectionOff';
 /** English copy. */
 export declare const en: Record<PluginsSettingsLocaleKey, string>;
 /** Simplified Chinese copy. */

package/lib/types/client/subagent-model-selection-card-controller.d.ts

@@ -5,7 +5,7 @@ import { type SnapshotStore } from '@qilin-agent/client-store';
 import type { ConfigForm } from '@qilin-agent/client-ui-settings/client';
 import type { SettingsFormShell } from '@qilin-agent/client-ui-primitives';
 /** Namespace of the Host-owned subagent model-selection preference. */
-export declare const SUBAGENT_MODEL_SELECTION_NS = "subagent-model-selection";
+export declare const SUBAGENT_MODEL_SELECTION_NS = "subagent-model-selection-settings";
 /** One exact provider/model route stored as user authorization. */
 export interface AllowedSubagentModel {
     provider: string;

package/lib/types/client/web-search-card-controller.d.ts

@@ -1,37 +1,70 @@
 /**
- * The web-search card's staged form over the `web-search-deepseek` settings
- * namespace.
+ * The web-search page's staged form over three settings namespaces: `web`,
+ * whose provider selection the Search API switch writes, `web-search-deepseek`
+ * for Messages search, and `web-deepseek-api` for the Search and Fetch APIs.
  *
- * The key is the one control that does not live in the section: its literal
- * never rides a response, so the card learns only whether one is configured
+ * The switch selects `deepseek-search-api` and `deepseek-fetch-api` together, or
+ * Messages search with local HTTP fetch. A selection equal to the deployment's
+ * composed value clears the override instead of storing a copy of it.
+ *
+ * The key is the one control that does not live in a section: its literal
+ * never rides a response, so the page learns only whether one is configured
  * and writes it through the credentials domain, addressed by the reference the
- * section names. It is still staged with the rest of the form, so one save
- * covers everything the card shows.
+ * selected API's section names. It is still staged with the rest of the form,
+ * so one save covers everything the page shows.
  */
 import type { Context as ClientContext } from '@qilin-agent/kylin';
-import type { SnapshotStore } from '@qilin-agent/client-store';
+import { type SnapshotStore } from '@qilin-agent/client-store';
 import type { ConfigForm } from '@qilin-agent/client-ui-settings/client';
-import { type SettingsFormActions, type SettingsFieldState, type SettingsFormShell } from '@qilin-agent/client-ui-primitives';
+import { type SettingsFieldState, type SettingsFormActions, type SettingsFormShell } from '@qilin-agent/client-ui-primitives';
 /**
- * Namespace of the DeepSeek search provider. Spelled here rather than
+ * Namespace of the DeepSeek Messages search provider. Spelled here rather than
  * imported: a client package must not depend on a Host package.
  */
 export declare const WEB_SEARCH_NS = "web-search-deepseek";
-/** The search-provider fields this card edits. */
+/** Namespace of the DeepSeek Search and Fetch API providers. */
+export declare const WEB_API_NS = "web-deepseek-api";
+/** Namespace of the web service's provider selection. */
+export declare const WEB_NS = "web";
+/** The web service's provider selection. */
+export interface WebProviderSelection {
+    /** Search provider id. */
+    searchProvider?: string;
+    /** Fetch provider id. */
+    fetchProvider?: string;
+}
+/** The Messages search fields this page edits. */
 export interface WebSearchSettings {
     /** Credential reference naming the environment key. */
     apiKeyEnv?: string;
-    /** Provider endpoint; blank inherits the provider default. */
+    /** Messages endpoint; blank inherits the provider default. */
     baseURL?: string;
-    /** Maximum searches served within one request. */
+    /** Maximum Messages server-tool uses. */
     maxUses?: number;
 }
-/** What the web-search card renders. */
+/** The Search and Fetch API fields this page edits. */
+export interface WebApiSettings {
+    /** Credential reference naming the environment key. */
+    apiKeyEnv?: string;
+    /** Search and Fetch API base with its path prefix; blank inherits the provider default. */
+    baseURL?: string;
+    /** Search API results per search. */
+    count?: number;
+}
+/** What the web-search page renders. */
 export interface WebSearchCardState extends SettingsFormShell {
-    /** Provider endpoint. */
+    /** Whether the Host serves both the selection and the Search / Fetch API section. */
+    apiSwitchAvailable: boolean;
+    /** Invalid edits or failed saves that switching APIs must keep visible. */
+    apiSwitchBlocked: boolean;
+    /** Staged switch position: true selects the Search and Fetch APIs. */
+    useSearchApi: boolean;
+    /** Endpoint of the selected API. */
     baseURL: SettingsFieldState;
-    /** Searches allowed per request. */
+    /** Maximum Messages server-tool uses. */
     maxUses: SettingsFieldState;
+    /** Search API results per search. */
+    count: SettingsFieldState;
     /** The staged credential, which starts blank on every load. */
     apiKey: SettingsFieldState;
     /** Whether the Host reports a credential configured for the referenced key. */
@@ -39,55 +72,92 @@ export interface WebSearchCardState extends SettingsFormShell {
     /** Whether the credentials domain accepts a write for it; false disables the control. */
     apiKeyWritable: boolean;
 }
-/** The registration-side face the web-search card's slot entry injects. */
+/** The registration-side face the web-search page's slot entry injects. */
 export interface WebSearchCardFace extends SettingsFormActions {
     hooks: {
-        /** Card snapshot bound by the renderer as useWebSearchCard. */
+        /** Page snapshot bound by the renderer as useWebSearchCard. */
         webSearchCard: SnapshotStore<WebSearchCardState>;
     };
+    /** Stage the API switch: true selects the Search and Fetch APIs, false Messages search with local fetch. */
+    setSearchApi: (enabled: boolean) => void;
 }
-/** Bridges the `web-search-deepseek` scope and the credentials domain onto the card. */
+/** Settings scopes for the namespaces the page edits. */
+export interface WebSearchCardScopes {
+    /** The web service's provider selection. */
+    web: ConfigForm<WebProviderSelection>;
+    /** Messages search settings. */
+    messages: ConfigForm<WebSearchSettings>;
+    /** Search and Fetch API settings. */
+    api: ConfigForm<WebApiSettings>;
+}
+/** Bridges the three settings scopes and the credentials domain onto the page. */
 export declare class WebSearchCardController {
-    private readonly scope;
+    private readonly scopes;
     private readonly ctx;
-    private readonly form;
+    private readonly selection;
+    private readonly messages;
+    private readonly api;
     private readonly store;
+    private readonly unsubscribe;
     private credential;
     /**
-     * @param scope - the bound settings scope for the `web-search-deepseek` namespace.
-     * @param ctx - the card plugin's context, whose `remote.credentials` namespace
-     * answers for the credential the section references.
+     * @param scopes - the bound settings scopes for the page's namespaces.
+     * @param ctx - the page plugin's context, whose `remote.credentials` namespace
+     * answers for the credential the selected section references.
      */
-    constructor(scope: ConfigForm<WebSearchSettings>, ctx: ClientContext);
+    constructor(scopes: WebSearchCardScopes, ctx: ClientContext);
+    /** Whether the Host serves both sections the switch needs. */
+    private switchAvailable;
+    /** The staged switch position, read from the staged search selection. */
+    private searchApi;
     private projection;
+    /** The reference the selected API's section names, or the providers' default. */
+    private ref;
     /**
-     * Ask the credentials domain about the reference the section currently names.
+     * Ask the credentials domain about the reference the selected section currently names.
      *
-     * The answer is stored with the reference it describes: `apiKeyEnv` can
-     * change between the request and its response, and two reads can settle out
-     * of order, so a response is published only while it still answers for the
-     * reference in force.
+     * The answer is stored with the reference it describes: `apiKeyEnv` and the
+     * switch can change between the request and its response, and two reads can
+     * settle out of order, so a response is published only while it still
+     * answers for the reference in force.
      */
     private readCredential;
     /**
-     * Re-read after the Host reports a change to the reference this card watches.
+     * Re-read after the Host reports a change to the reference this page watches.
      *
      * A key can be written from somewhere else — the Models page addresses the
-     * same reference — and the settings section does not change when it is, so
-     * without this the badge keeps reporting a state the Host already replaced.
+     * same reference — and no settings section changes when it is, so without
+     * this the badge keeps reporting a state the Host already replaced.
      * @param ref - the reference the Host reports as changed.
      */
     refreshCredential(ref: string): void;
     /**
-     * Build the face the card's slot registration injects.
-     * @returns the card's snapshot and its form actions.
+     * Build the face the page's slot registration injects. `baseURL` edits the
+     * selected API's endpoint; `maxUses` and `count` edit their own sections.
+     * @returns the page's snapshot and its form actions.
      */
     inject(): WebSearchCardFace;
+    /**
+     * Stage both provider selections for one switch position. A target equal to
+     * the composed value clears the override so the deployment default keeps
+     * applying.
+     * @param enabled - true for the Search and Fetch APIs.
+     */
+    private select;
+    /**
+     * Save the provider sections before the selection, so a switch takes effect
+     * only after the endpoint it uses has landed. A refused section stops the
+     * selection from saving and keeps every remaining draft for correction.
+     * @returns settlement after every attempted write.
+     */
+    private save;
     /**
      * Write the staged key, then re-read whether the Host now holds one.
      * @param value - the staged credential literal.
      * @returns whether the Host reports a configured credential afterwards.
      */
     private writeKey;
+    /** Release configuration subscriptions. */
+    dispose(): void;
 }
 //# sourceMappingURL=web-search-card-controller.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/client-ui-settings-plugins",
   "description": "Plugins settings section with feature-owned tabs and configurable host-plane plugin cards",
-  "version": "3.1.4",
+  "version": "3.1.6",
   "publishConfig": {
     "access": "public"
   },
@@ -40,22 +40,22 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@qilin-agent/kylin": "~4.0.3"
+    "@qilin-agent/kylin": "~4.0.5"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
     "clsx": "^2.0.0",
     "react": "^18.2.0",
-    "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/api-remotes": "3.1.4",
-    "@qilin-agent/client-test-runtime": "3.1.4",
-    "@qilin-agent/client-store": "3.1.4",
-    "@qilin-agent/client-locale": "3.1.4",
-    "@qilin-agent/client-ui-plugin-manager": "3.1.4",
-    "@qilin-agent/client-ui-primitives": "3.1.4",
-    "@qilin-agent/client-ui-renderer": "3.1.4",
-    "@qilin-agent/client-ui-settings": "3.1.4",
-    "@qilin-agent/client-ui-slots": "3.1.4"
+    "@qilin-agent/kylin": "~4.0.5",
+    "@qilin-agent/api-remotes": "3.1.6",
+    "@qilin-agent/client-test-runtime": "3.1.6",
+    "@qilin-agent/client-locale": "3.1.6",
+    "@qilin-agent/client-ui-plugin-manager": "3.1.6",
+    "@qilin-agent/client-store": "3.1.6",
+    "@qilin-agent/client-ui-primitives": "3.1.6",
+    "@qilin-agent/client-ui-renderer": "3.1.6",
+    "@qilin-agent/client-ui-settings": "3.1.6",
+    "@qilin-agent/client-ui-slots": "3.1.6"
   },
   "files": [
     "lib/index.js",