dsh-web-search-enhanced 0.2.1 → 0.2.2

package/README.md

@@ -9,7 +9,7 @@ row `web-search-enhanced` and selects its provider in the shared `web` row.
 | Row id | `web-search-enhanced` |
 | Provider id in `ctx.web` | `search-enhanced` |
 | Model surface | DSH's own `web_search` (tool-web), unchanged; with the row's Enhanced tools switch on, also `web_search_enhanced` and `list_web_search_providers` |
-| Per conversation | one connection or Off, from the composer menu or `/setup-search` |
+| Per conversation | one connection or Off, from the composer menu or the Host command `/setup-search` (Web GUI and dsh-TUI) |
 | Settings | row settings page on the Plugins page (`plugins.row.config`) |
 
 ## What it does
@@ -30,6 +30,13 @@ only their error messages are restated.
   queries go to it. DeepSeek Messages (the default) and the conversation model
   stay on; custom connections are on when created. When every remote service
   is off, the composer menu says more services can be turned on in settings.
+- **`/setup-search`.** A Host command, so it works in the Web GUI and in
+  dsh-TUI. `off`, a connection id or `freshness auto|fresh|realtime` change
+  the choice from the next model request; dsh-TUI completes these arguments.
+  Without arguments the Web GUI opens the chooser, and dsh-TUI prints the
+  current choice, routing and the enabled connections (0.16.1 shows only the
+  start of that, as a one-line notice). Its description and output are
+  English.
 - **Enhanced tools (optional).** With the row's Enhanced tools switch on (off
   by default; turning it on agrees that the query goes to the service the
   Agent picks), the Agent also gets `web_search_enhanced` (`queries` plus a

package/lib/client.cjs

@@ -37,7 +37,8 @@ window.__ModuleLoader__.load({
 			tools: {
 				action: "web_search_enhanced",
 				list: "list_web_search_providers"
-			}
+			},
+			command: "setup-search"
 		};
 		/**
 		* Key of a row's configuration page on the Plugins page (`plugins.row.config`).
@@ -1520,7 +1521,11 @@ window.__ModuleLoader__.load({
 			if (id.startsWith("connection:") && id.length > 11) return { connectionId: id.slice(11) };
 			return parseOptions?.(id);
 		}
-		/** A keyboard entry to the same per-session store the composer menu uses. */
+		/**
+		* The browser's bare invocation of the capability's Host command: a popup over
+		* the same per-session store the composer menu uses. The Host command keeps its
+		* menu row and runs every line with arguments.
+		*/
 		function selectionCommand(selections, spec) {
 			const t = (key) => spec.t(spec.keys[key]);
 			const read = async (sessionId) => {
@@ -1530,9 +1535,6 @@ window.__ModuleLoader__.load({
 			};
 			return {
 				name: spec.name,
-				label: () => t("label"),
-				description: () => t("description"),
-				icon: spec.icon,
 				available: () => true,
 				ui: {
 					kind: "popupSelect",
@@ -1580,6 +1582,19 @@ window.__ModuleLoader__.load({
 				}
 			};
 		}
+		/**
+		* Call `ran` after this browser ran the Host command `name` in a Session. A line
+		* with arguments (`/setup-search off`) writes on the Host without the selection
+		* store, so that Session's views must read again. DSH reports each Host command
+		* this browser executed with `command/executed`, without its arguments, so every
+		* run counts; runs from another browser or the TUI are not reported here.
+		* @returns the listener's disposer; it also ends with `ctx`'s fiber.
+		*/
+		function followHostCommand(ctx, name, ran) {
+			return ctx.on("command/executed", (sessionId, executed) => {
+				if (executed === name) ran(sessionId);
+			});
+		}
 		//#endregion
 		//#region ../core/src/client/selection.ts
 		var ConnectionSelectionStore = class {
@@ -1660,10 +1675,16 @@ window.__ModuleLoader__.load({
 			* read again, the others read on their next load.
 			*/
 			invalidate() {
-				for (const entry of this.entries.values()) {
-					this.outdate(entry);
-					if (entry.observers > 0) this.read(entry);
-				}
+				for (const entry of this.entries.values()) this.reread(entry);
+			}
+			/**
+			* The Session's selection changed without this store (its Host command ran):
+			* its views read again, at once when observed, otherwise on their next load.
+			* A read already in flight reads once more.
+			*/
+			invalidateSession(sessionId) {
+				const entry = this.entries.get(sessionId);
+				if (entry !== void 0) this.reread(entry);
 			}
 			entry(sessionId) {
 				const existing = this.entries.get(sessionId);
@@ -1696,6 +1717,10 @@ window.__ModuleLoader__.load({
 				this.entries.set(sessionId, entry);
 				return entry;
 			}
+			reread(entry) {
+				this.outdate(entry);
+				if (entry.observers > 0) this.read(entry);
+			}
 			outdate(entry) {
 				entry.stale = true;
 				entry.epoch += 1;
@@ -4277,7 +4302,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/command.ts
-		const SEARCH_COMMAND = "setup-search";
+		const SEARCH_COMMAND = SEARCH.command;
 		const FRESHNESS_PREFIX = "freshness:";
 		const parseFreshness = (id) => {
 			const freshness = FRESHNESS.find((mode) => id === FRESHNESS_PREFIX + mode);
@@ -4286,11 +4311,8 @@ window.__ModuleLoader__.load({
 		function searchCommand(selections, t) {
 			return selectionCommand(selections, {
 				name: SEARCH_COMMAND,
-				icon: _deepseek_ai_dsh_client_ui_primitives.IconGlobeOutlineRegular,
 				t,
 				keys: {
-					label: "command.label",
-					description: "command.description",
 					placeholder: "command.placeholder",
 					empty: "command.empty",
 					noResults: "command.noResults",
@@ -4558,7 +4580,7 @@ window.__ModuleLoader__.load({
 			"status.modelReady": "{access} · model search · sent to {name}",
 			"status.sessionModelNeedsKey": "The conversation model's API key isn't set",
 			"status.sessionModelNeedsSignIn": "Sign in to the DeepSeek account again",
-			"status.reason.no-model": "No model chosen for this conversation yet",
+			"status.reason.no-model": "The model for this conversation's next request isn't known yet",
 			"status.reason.unknown-route": "Can't read the settings of this model's provider",
 			"status.reason.protocol": "Its route declares no supported api",
 			"status.reason.endpoint": "Its route has no fixed endpoint",
@@ -4819,7 +4841,7 @@ window.__ModuleLoader__.load({
 			"status.modelReady": "{access} · 模型搜索 · 查询发送给 {name}",
 			"status.sessionModelNeedsKey": "会话模型的 API Key 未设置",
 			"status.sessionModelNeedsSignIn": "请重新登录 DeepSeek 账号",
-			"status.reason.no-model": "本会话还没有选择模型",
+			"status.reason.no-model": "还不知道本会话下一次请求用哪个模型",
 			"status.reason.unknown-route": "无法读取会话模型服务商的设置",
 			"status.reason.protocol": "该路由在模型设置里没有声明支持的 api",
 			"status.reason.endpoint": "该路由在模型设置里没有固定的接口地址",
@@ -4903,11 +4925,11 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(style);
 		}
 		var Section_module_css_default = {
-			"caption": "La6KHG_caption",
 			"container": "La6KHG_container",
-			"segmented": "La6KHG_segmented",
+			"label": "La6KHG_label",
+			"caption": "La6KHG_caption",
 			"error": "La6KHG_error",
-			"label": "La6KHG_label"
+			"segmented": "La6KHG_segmented"
 		};
 		//#endregion
 		//#region src/client/section.ts
@@ -4974,73 +4996,73 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(style);
 		}
 		var Settings_module_css_default = {
-			"optionGroup": "o9fCSq_optionGroup",
-			"selectCompact": "o9fCSq_selectCompact",
-			"hint": "o9fCSq_hint",
-			"actions": "o9fCSq_actions",
-			"editorTitle": "o9fCSq_editorTitle",
-			"section": "o9fCSq_section",
-			"prefix": "o9fCSq_prefix",
-			"error": "o9fCSq_error",
-			"disclosure": "o9fCSq_disclosure",
-			"fieldHead": "o9fCSq_fieldHead",
-			"page": "o9fCSq_page",
-			"rowActions": "o9fCSq_rowActions",
-			"segmented": "o9fCSq_segmented",
-			"settingLead": "o9fCSq_settingLead",
-			"optionGroupTitle": "o9fCSq_optionGroupTitle",
-			"rowTitle": "o9fCSq_rowTitle",
-			"formField": "o9fCSq_formField",
 			"intro": "o9fCSq_intro",
-			"settingText": "o9fCSq_settingText",
-			"prefixedDisabled": "o9fCSq_prefixedDisabled",
-			"settingControl": "o9fCSq_settingControl",
+			"disclosureOpen": "o9fCSq_disclosureOpen",
+			"optionGroup": "o9fCSq_optionGroup",
 			"trustCheck": "o9fCSq_trustCheck",
-			"prefixed": "o9fCSq_prefixed",
+			"trust": "o9fCSq_trust",
+			"field": "o9fCSq_field",
+			"optionKey": "o9fCSq_optionKey",
+			"success": "o9fCSq_success",
 			"sectionHead": "o9fCSq_sectionHead",
-			"select": "o9fCSq_select",
-			"fieldError": "o9fCSq_fieldError",
+			"confirmText": "o9fCSq_confirmText",
+			"confirmRow": "o9fCSq_confirmRow",
 			"inline": "o9fCSq_inline",
-			"link": "o9fCSq_link",
-			"field": "o9fCSq_field",
-			"option": "o9fCSq_option",
+			"prefixedInput": "o9fCSq_prefixedInput",
+			"rowTitle": "o9fCSq_rowTitle",
+			"rowMain": "o9fCSq_rowMain",
+			"rowActions": "o9fCSq_rowActions",
+			"page": "o9fCSq_page",
+			"selectValue": "o9fCSq_selectValue",
+			"prefixedDisabled": "o9fCSq_prefixedDisabled",
+			"rowMeta": "o9fCSq_rowMeta",
+			"reset": "o9fCSq_reset",
+			"actions": "o9fCSq_actions",
+			"settingControl": "o9fCSq_settingControl",
+			"fieldLabel": "o9fCSq_fieldLabel",
+			"section": "o9fCSq_section",
+			"formGrid": "o9fCSq_formGrid",
+			"formWide": "o9fCSq_formWide",
+			"selectCompact": "o9fCSq_selectCompact",
 			"textarea": "o9fCSq_textarea",
+			"prefix": "o9fCSq_prefix",
+			"fieldError": "o9fCSq_fieldError",
 			"sectionActions": "o9fCSq_sectionActions",
+			"optionName": "o9fCSq_optionName",
+			"row": "o9fCSq_row",
+			"editorTitle": "o9fCSq_editorTitle",
+			"optionWide": "o9fCSq_optionWide",
 			"sectionTitle": "o9fCSq_sectionTitle",
-			"rowMeta": "o9fCSq_rowMeta",
-			"empty": "o9fCSq_empty",
+			"fieldHead": "o9fCSq_fieldHead",
+			"optionGrid": "o9fCSq_optionGrid",
+			"input": "o9fCSq_input",
+			"list": "o9fCSq_list",
+			"optionGroupTitle": "o9fCSq_optionGroupTitle",
 			"fieldState": "o9fCSq_fieldState",
-			"row": "o9fCSq_row",
+			"settingText": "o9fCSq_settingText",
 			"note": "o9fCSq_note",
 			"settingRow": "o9fCSq_settingRow",
-			"selectChevron": "o9fCSq_selectChevron",
-			"list": "o9fCSq_list",
-			"trust": "o9fCSq_trust",
-			"status": "o9fCSq_status",
-			"input": "o9fCSq_input",
-			"confirmRow": "o9fCSq_confirmRow",
-			"fieldLabel": "o9fCSq_fieldLabel",
+			"error": "o9fCSq_error",
+			"rowLine": "o9fCSq_rowLine",
+			"formField": "o9fCSq_formField",
+			"link": "o9fCSq_link",
 			"danger": "o9fCSq_danger",
-			"formGrid": "o9fCSq_formGrid",
-			"selectAnchor": "o9fCSq_selectAnchor",
-			"formWide": "o9fCSq_formWide",
-			"success": "o9fCSq_success",
+			"select": "o9fCSq_select",
+			"status": "o9fCSq_status",
 			"editor": "o9fCSq_editor",
 			"panel": "o9fCSq_panel",
-			"disclosureOpen": "o9fCSq_disclosureOpen",
-			"reset": "o9fCSq_reset",
-			"prefixedInput": "o9fCSq_prefixedInput",
-			"optionKey": "o9fCSq_optionKey",
-			"optionName": "o9fCSq_optionName",
-			"selectValue": "o9fCSq_selectValue",
-			"rowMain": "o9fCSq_rowMain",
-			"confirmText": "o9fCSq_confirmText",
-			"optionWide": "o9fCSq_optionWide",
-			"warning": "o9fCSq_warning",
+			"selectAnchor": "o9fCSq_selectAnchor",
+			"segmented": "o9fCSq_segmented",
+			"disclosure": "o9fCSq_disclosure",
+			"hint": "o9fCSq_hint",
+			"option": "o9fCSq_option",
+			"selectChevron": "o9fCSq_selectChevron",
 			"settingTitle": "o9fCSq_settingTitle",
-			"rowLine": "o9fCSq_rowLine",
-			"optionGrid": "o9fCSq_optionGrid",
-			"disclosureIcon": "o9fCSq_disclosureIcon"
+			"empty": "o9fCSq_empty",
+			"settingLead": "o9fCSq_settingLead",
+			"prefixed": "o9fCSq_prefixed",
+			"disclosureIcon": "o9fCSq_disclosureIcon",
+			"warning": "o9fCSq_warning"
 		};
 		//#endregion
 		//#region src/client/settings/CredentialEditor.tsx
@@ -5777,7 +5799,11 @@ window.__ModuleLoader__.load({
 					}, "search: composer section");
 				});
 				scope.inject(["commandUi"], (command) => {
-					command.effect(() => command.commandUi.register(searchCommand(selection, t)), "search: /setup-search");
+					command.effect(() => command.commandUi.decorate(searchCommand(selection, t)), "search: /setup-search");
+					followHostCommand(command, SEARCH.command, (sessionId) => {
+						selection.invalidateSession(sessionId);
+						pairings.invalidate();
+					});
 				});
 				const invalidate = () => {
 					selection.invalidate();