dsh-web-search-enhanced 0.1.3 → 0.1.4

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 记录 `dsh-web-search-enhanced` 的用户可见变化。历史条目描述对应版本，不代表当前行为。
 
+## [Unreleased]
+
+## [0.1.4] - 2026-09-24
+
+### DSH 0.1.7-rc.2 兼容性
+
+- 最低宿主版本提升至 `0.1.7-rc.2`；DSH peer 依赖下限、精确开发依赖、锁文件及预发布安装白名单同步对齐。
+- 核对动态工具更新、DeepSeek Provider 拆包、模型选择校验、Schedule 与审批变更；插件不调用 selectModel，不依赖被移除的 Schedule API，无需修改搜索运行时代码。
+- 跟随模型仍仅支持可解析的 API Key 路由，不因宿主支持官方账号而自动支持账号 / OAuth 搜索；固定连接及结构化搜索不受模型选择校验影响。
+- 设置格式 version 2、会话 Storage Domain version 1 保持不变；完整边界见 [rc.2 影响评估](docs/upstream-0.1.7-rc.2-assessment.zh-CN.md)。
+
+### 搜索选择器请求优化
+
+- 移除每 2 秒常驻轮询；首次加载、模型实际变化、展开菜单及页面恢复可见/焦点时按需读取，关闭菜单和普通重渲染不请求。
+- 增加按会话隔离的 30 秒客户端缓存与并发请求合并，最多保留 64 个空闲会话项；TTL 到期本身不会触发请求。
+- 写入成功直接复用返回值；手动重试和写入冲突刷新绕过缓存，模型/配置失效发生在请求期间时合并补读，防止旧响应覆盖新状态。
+- 插件配置变化及本插件保存凭据后使缓存失效；连接断开/重建与插件卸载清理缓存并隔离旧请求。
+- 本阶段不增加服务端推送：其他窗口的修改在后续缓存过期的按需刷新时同步，不再保证两秒内自动同步；版本冲突保护保留。
+
 ## [0.1.3] - 2026-09-24
 
 ### 界面细节对齐

package/README.md

@@ -10,7 +10,7 @@
 
 [![Release](https://img.shields.io/github/v/release/Yurzi/dsh-web-search-enhanced?style=flat-square)](https://github.com/Yurzi/dsh-web-search-enhanced/releases)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=flat-square)](LICENSE)
-[![DSH](https://img.shields.io/badge/DSH-0.1.7--rc.1%2B-536DFE?style=flat-square)](package.json)
+[![DSH](https://img.shields.io/badge/DSH-0.1.7--rc.2%2B-536DFE?style=flat-square)](package.json)
 [![Node.js](https://img.shields.io/badge/Node.js-22.19%2B%20%7C%2024%2B-green?style=flat-square)](package.json)
 
 [🚀 快速上手](#-快速上手) · [✨ 核心特性](#-核心特性) · [🔍 搜索引擎推荐](#-选哪种搜索服务) · [⚙️ 进阶配置](#️-进阶配置与个人-key) · [❓ 常见问题](#-常见问题-faq) · [📖 详细文档](#-想了解更多)
@@ -60,27 +60,27 @@
 
 ### 环境要求
 
-- **DeepSeek Harness**：≥ `0.1.7-rc.1`
+- **DeepSeek Harness**：≥ `0.1.7-rc.2`
 - **Node.js**：`^22.19.0 || >=24.0.0`
 
-本版已对齐 DSH 0.1.7-rc.1 的动态配置、插件设置页和会话 projection 架构，详见[上游适配记录](docs/upstream-0.1.7-adaptation.zh-CN.md)。升级前请备份 profile 和旧设置。
+本版将 DSH 基线提升到 0.1.7-rc.2，保留动态配置、插件设置页和会话 projection 架构，详见[rc.2 影响评估](docs/upstream-0.1.7-rc.2-assessment.zh-CN.md)。升级前请备份 profile 和旧设置。
 
 ### 步骤 1：安装插件
 
 **方式 A：通过 GitHub Release 离线包安装（推荐）**
 
-当前版本为 **0.1.3**，最低支持 **DSH 0.1.7-rc.1**。从 [v0.1.3 Release](https://github.com/Yurzi/dsh-web-search-enhanced/releases/tag/v0.1.3) 下载安装包及 SHA256 校验文件；也可执行 `pnpm install --frozen-lockfile && pnpm run check && pnpm pack` 自行构建。使用绝对路径安装：
+当前版本为 **0.1.4**，最低支持 **DSH 0.1.7-rc.2**。发布后可从 [Releases](https://github.com/Yurzi/dsh-web-search-enhanced/releases) 下载对应版本安装包及 SHA256 校验文件；也可执行 `pnpm install --frozen-lockfile && pnpm run check && pnpm pack` 自行构建。使用绝对路径安装：
 
 ```sh
-dsh plugin --profile web add /path/to/dsh-web-search-enhanced-0.1.3.tgz
+dsh plugin --profile web add /path/to/dsh-web-search-enhanced-0.1.4.tgz
 ```
 
 **方式 B：通过 npm 在线安装**
 
-也可从 npm 直接安装：
+该版本发布到 npm 后，也可直接安装：
 
 ```sh
-dsh plugin --profile web add dsh-web-search-enhanced@0.1.3
+dsh plugin --profile web add dsh-web-search-enhanced@0.1.4
 ```
 
 ### 步骤 2：生效与刷新

package/docs/configuration.zh-CN.md

@@ -1,6 +1,6 @@
-# 0.1.3 配置参考
+# 0.1.4 配置参考
 
-本指南面向安装版插件。包版本为 **0.1.3**，配置格式的 `version` 为 **2**；两者不是同一版本号。快速开始见 [README](../README.md)，旧版用户先读[升级指南](migration.zh-CN.md)。
+本指南面向安装版插件。包版本为 **0.1.4**，配置格式的 `version` 为 **2**；两者不是同一版本号。快速开始见 [README](../README.md)，旧版用户先读[升级指南](migration.zh-CN.md)。
 
 ## 配置入口与作用范围
 

package/docs/design-v2.converged.zh-CN.md

@@ -1,4 +1,4 @@
-# 0.1.3 当前架构与实现边界
+# 0.1.4 当前架构与实现边界
 
 本文描述已存在的源码契约，不是未来设计提案或历史验收记录。为避免外部链接失效，保留原文件名。用户配置见[配置参考](configuration.zh-CN.md)，验证方法见[开发验证指南](v2-implementation.zh-CN.md)。
 
@@ -46,7 +46,7 @@ tools/execute 的 exec.agent → 私有 AsyncLocalStorage → enhanced-search
 
 ## 3. 配置和秘密分离
 
-当前设置格式为 version 2，包版本为 0.1.3。内置目录只做默认值；用户保存差异，不把目录整表复制到用户层。四种结构化内置连接默认 keyless，访问方式为显式选择，不根据已保存 Key 猜测。自定义连接只允许支持的 adapter 或固定模型协议；新 endpoint 需要信任确认。
+当前设置格式为 version 2，包版本为 0.1.4。内置目录只做默认值；用户保存差异，不把目录整表复制到用户层。四种结构化内置连接默认 keyless，访问方式为显式选择，不根据已保存 Key 猜测。自定义连接只允许支持的 adapter 或固定模型协议；新 endpoint 需要信任确认。
 
 内置结构化连接不能重定向地址或改变 adapter。自定义结构化连接只能使用个人 Key；固定模型总是需要显式信任。校验拒绝任意 headers/body、缓存参数、秘密字段等不受支持的 options。禁用连接也参与配置校验。
 

package/docs/migration.zh-CN.md

@@ -1,10 +1,10 @@
-# 升级到 0.1.3 / DSH 0.1.7-rc.1
+# 升级到 0.1.4 / DSH 0.1.7-rc.2
 
-0.1.3 将最低宿主版本提高为 **0.1.7-rc.1**，对齐 Loader 动态配置、profile-backed SettingsForms、ConfigForms 客户端、惰性 Typert codec 和新版 PTC。旧版已采用的**会话级搜索连接**保持不变：包版本 0.1.3、设置格式 version 2、会话 Storage Domain version 1 是三个不同概念。完整参数见[配置参考](configuration.zh-CN.md)。
+0.1.4 将最低宿主版本提高为 **0.1.7-rc.2**，沿用 0.1.3 已完成的 Loader 动态配置、profile-backed SettingsForms、ConfigForms 客户端、惰性 Typert codec 和新版 PTC 适配。从 0.1.3 升级不需要新的配置或存储迁移；详见 [rc.2 影响评估](upstream-0.1.7-rc.2-assessment.zh-CN.md)。旧版已采用的**会话级搜索连接**保持不变：包版本 0.1.4、设置格式 version 2、会话 Storage Domain version 1 是三个不同概念。完整参数见[配置参考](configuration.zh-CN.md)。
 
 ## 1. 升级前准备
 
-- 确认 DSH 满足 `>=0.1.7-rc.1`，Node 满足 `^22.19.0 || >=24.0.0`。实现基线是 0.1.7-rc.1 契约，不代表对所有未来宿主版本均完成验证。
+- 确认 DSH 满足 `>=0.1.7-rc.2`，Node 满足 `^22.19.0 || >=24.0.0`。实现基线是 0.1.7-rc.2 契约，不代表对所有未来宿主版本均完成验证。
 - 备份当前插件版本、Web profile / 插件配置和 DSH 持久存储。凭据使用宿主安全备份方式，不复制到公开 Issue 或仓库。
 - 记录旧 `modelMode`、协议、模型、endpoint、凭据引用，以及希望保留的会话选择。
 - 推荐升级前先将明文 `apiKey` 移到 DSH Credentials 并从配置来源删除。兼容导入仅允许旧格式短暂携带 Key：先验证转换结果，再写 Credentials，最后 CAS 替换 profile 配置。V2 配置仍拒绝明文 Key；已有不同值的同名凭据不会被自动覆盖。
@@ -12,16 +12,16 @@
 
 ## 2. 安装发行包
 
-从当前源码运行 `pnpm install --frozen-lockfile && pnpm run check && pnpm pack`，或使用 [Releases](https://github.com/Yurzi/dsh-web-search-enhanced/releases) 中实际发布的 0.1.3 构建包。使用绝对路径交给 DSH 插件管理器：
+从当前源码运行 `pnpm install --frozen-lockfile && pnpm run check && pnpm pack`，或使用 [Releases](https://github.com/Yurzi/dsh-web-search-enhanced/releases) 中实际发布的 0.1.4 构建包。使用绝对路径交给 DSH 插件管理器：
 
 ```sh
-dsh plugin --profile web add /absolute/path/to/dsh-web-search-enhanced-0.1.3.tgz
+dsh plugin --profile web add /absolute/path/to/dsh-web-search-enhanced-0.1.4.tgz
 ```
 
 若该版本已在 npm 发布，也可安装固定版本：
 
 ```sh
-dsh plugin --profile web add dsh-web-search-enhanced@0.1.3
+dsh plugin --profile web add dsh-web-search-enhanced@0.1.4
 ```
 
 发布附件中的构建 tgz 与 GitHub 自动生成的 Source code archive 不同：后者是源码，不能假定含 `lib/` 构建产物。npm 可用性须以 registry 实际发布结果为准，GitHub 标签 / Release 存在不代表 npm 已完成。

package/docs/upstream-0.1.7-rc.2-assessment.zh-CN.md

@@ -0,0 +1,35 @@
+# DSH 0.1.7-rc.2 对插件 0.1.4 的影响评估
+
+## 范围与结论
+
+根据上游 rc.1 → rc.2 版本分析，逐项核对本插件实际调用路径，并将开发依赖切换到发布的 rc.2 包验证。上游范围为 [dsh-v0.1.7-rc.1 … dsh-v0.1.7-rc.2](https://github.com/deepseek-ai/deepseek-harness/compare/dsh-v0.1.7-rc.1...dsh-v0.1.7-rc.2)。本文不是对上游全部提交的重新审计。
+
+结论：升级风险低，未发现需要修改本插件运行时代码的直接破坏性变更；跟随模型存在原有认证与私有 adapter 兼容边界，不能据此承诺所有 Provider 均可搜索。
+
+- 插件：`0.1.3` → `0.1.4`（patch）。
+- 最低 DSH：`>=0.1.7-rc.2`；DSH peer 范围：`^0.1.7-rc.2`；直接 DSH 开发依赖：精确 `0.1.7-rc.2`。
+- 设置格式仍为 version 2，Storage Domain 仍为 version 1，不重写宿主会话历史。
+- 原 Unreleased 中的选择器按需刷新、缓存与并发合并优化一并归入 0.1.4。
+
+## 逐项影响
+
+| 上游变化 | 插件实际依赖与结论 |
+| --- | --- |
+| 动态工具增删、ToolHistory 与历史投影 | [bridge](../src/dsh/bridge.ts) 只注册 `enhanced-search` Web provider，使用 `agent/request` 和 `tools/execute` 捕获请求上下文；不构造工具增删消息、不重写历史。继续由宿主原生 `web_search` 和 PTC 链执行，无需自行接入投影协议。 |
+| DeepSeek Provider 拆分为 API Key / Account 插件 | 依赖、测试和 [安装补丁](../cordis.patch.yml) 均不把旧 `dsh-llm-deepseek` 作为 Cordis 插件加载。补丁中的 `web-search-deepseek` 是原生搜索插件条目，不是被拆分的 LLM 插件，不能误改成新 Provider 包名。用户自行维护的宿主 profile 仍需按上游规则迁移。 |
+| `selectModel` 严格校验 `listModels` | 插件不调用 `selectModel`，也不通过切换聊天模型执行辅助搜索。[跟随模型](../src/dsh/session-model.ts) 读取实际请求头与公开配置目录；固定模型直接使用显式 binding。因此不是所有固定搜索模型都要注册到宿主。用户切换聊天模型时则须确保模型在宿主目录中，否则会先被宿主拒绝。 |
+| Schedule 存储导出删除、默认禁用 schedule/time-context | 插件不依赖 Schedule 或时间上下文服务。自身选择存储通过 Storage Domain，不涉及计划任务存储；实时性参数是缓存年龄偏好，也不依赖注入时钟。 |
+| `PreToolDecision.displayReason`、Auto Review 调整 | 插件不构造该准入决策，不接管审批；`tools/execute` 钩子继续调用 next，保留宿主授权与审批链。新增可选展示字段无需适配。 |
+| 快捷键中心、代码语言与系统提示词调整 | 插件不导入旧快捷键内部 API、不使用代码语言内部模块、不解析系统提示词。设置页、会话 projection 与插件配置槽的类型和构建由 rc.2 依赖验证；不能以编译通过替代真实 GUI 验收。 |
+
+## 跟随模型边界
+
+[session-model.ts](../src/dsh/session-model.ts) 仍通过 `listConfigurableProviders()` 的 settings namespace/path 获取非秘密路由信息，要求受支持的 HTTP 协议、endpoint 和显式 `apiKeyEnv`。官方账号、OAuth、订阅凭据不会被重建或借用。新官方 API Key Provider 也不能仅因包名包含 API Key 就视为自动兼容，仍须满足这些路由条件。
+
+adapter identity 的 `registration()` 及可选 pi-ai catalog 是原有兼容 shim，并非稳定公共契约；缺失或发生替换时保持 fail-closed，不隐式改用其他连接或凭据。遇到跟随不可用可显式选择内置结构化连接或受支持的固定搜索连接。
+
+## 升级与验收
+
+先升级 DSH，再安装 0.1.4，重新加载服务端插件并刷新 Web 页面。从 0.1.3 升级应保留连接选择、凭据和实时性偏好，无需清空存储。选择器不再常驻两秒轮询；跨窗口修改在后续缓存过期的按需刷新时同步。
+
+本次验证通过：冻结锁文件安装、TypeScript 类型检查、服务端 / 客户端构建、22 个测试文件共 339 项测试，以及 0.1.4 实际打包契约检查。执行命令为 `PNPM_HOME="$PWD/.pnpm-home" pnpm install --frozen-lockfile` 与 `PNPM_HOME="$PWD/.pnpm-home" pnpm run check`；显式设置工作区 PNPM_HOME 是为解决本机默认 pnpm 状态数据库打开失败，不是插件运行要求。自动测试使用模拟网络，不证明外部搜索服务实时可用；本次版本更新不等于 npm/GitHub 发布，也不等于运行中的 DSH 已安装新版本。

package/docs/v2-implementation.zh-CN.md

@@ -1,12 +1,12 @@
-# 0.1.3 开发与验证指南
+# 0.1.4 开发与验证指南
 
 本文件保留原路径以避免断链，内容改为可重复的开发、验证与交付方法。架构见[当前架构](design-v2.converged.zh-CN.md)，用户使用见[配置参考](configuration.zh-CN.md)，版本升级见[升级指南](migration.zh-CN.md)。测试存在、测试通过、供应商在线可用、运行实例完成部署是四种不同结论，不能互相替代。
 
 ## 环境与开发入口
 
 - Node.js：`^22.19.0 || >=24.0.0`；pnpm：按 packageManager 使用 `11.7.0`。
-- DSH：包要求 `>=0.1.7-rc.1`，源码以 0.1.7-rc.1 服务契约为基线。依赖声明与锁文件是构建依据，不修改宿主安装的依赖来让测试通过。
-- 当前开发主线为 `main`，旧版代码线为 `legacy/v0.0.x`。包版本 `0.1.3` 与 settings schema 的 `version: 2` 不同。
+- DSH：包要求 `>=0.1.7-rc.2`，源码以 0.1.7-rc.2 服务契约为基线。依赖声明与锁文件是构建依据，不修改宿主安装的依赖来让测试通过。
+- 当前开发主线为 `main`，旧版代码线为 `legacy/v0.0.x`。包版本 `0.1.4` 与 settings schema 的 `version: 2` 不同。
 
 在仓库根执行：
 
@@ -101,7 +101,7 @@ preview-ui 写 `.dsh-smoke-home/settings-preview.html`，不会启动第二个 D
 
 1. 对最终待发提交运行 check 和所需浏览器 / 网络验证，记录版本与退出状态。
 2. 使用 `pnpm pack` 生成构建包；检查包版本、入口、声明、patch、README 与 docs 完整性。GitHub 自动 Source code archive 不是含 lib 的发行 tgz。
-3. 用户可用 `dsh plugin --profile web add /absolute/path/to/dsh-web-search-enhanced-0.1.3.tgz` 安装 Release 构建附件。
+3. 用户可用 `dsh plugin --profile web add /absolute/path/to/dsh-web-search-enhanced-0.1.4.tgz` 安装 Release 构建附件。
 4. Git 操作、远端分支调整、标签、Release 和 npm 发布分别需要授权与结果核验；不要把本地构建当作已发布。主线为 main，旧代码保留 legacy/v0.0.x，不需要把历史文档反复改成当前成功记录。
 5. 标签触发发布流程后，单独确认 workflow 和 npm registry 的版本 / 包内容，再宣称 npm 可安装。
 

package/lib/client.js

@@ -6288,71 +6288,85 @@ window.__ModuleLoader__.load({
 		}
 		function SessionSelector({ sessionId, getSelection, setSelection, useProjection, t }) {
 			const modelSelection = useProjection("modelSelection");
+			const modelKey = JSON.stringify(modelSelection ? [
+				modelSelection.lastUsed?.provider,
+				modelSelection.lastUsed?.model,
+				modelSelection.lastUsed?.reasoningEffort,
+				modelSelection.next?.provider,
+				modelSelection.next?.model,
+				modelSelection.next?.reasoningEffort
+			] : null);
+			const latest = (0, react.useRef)({
+				getSelection,
+				setSelection,
+				t,
+				modelKey
+			});
+			latest.current = {
+				getSelection,
+				setSelection,
+				t,
+				modelKey
+			};
 			const [value, setValue] = (0, react.useState)();
 			const [error, setError] = (0, react.useState)("");
 			const [notice, setNotice] = (0, react.useState)("");
 			const [pending, setPending] = (0, react.useState)(false);
 			const controller = (0, react.useRef)();
 			(0, react.useEffect)(() => {
-				const guard = createResponseGuard();
+				const reads = createResponseGuard();
+				const writes = createResponseGuard();
 				let writing = false;
-				let reading = false;
-				setValue(void 0);
-				setError("");
-				setNotice("");
-				setPending(false);
-				const refresh = async (clearError = false) => {
-					if (writing || reading) return;
-					reading = true;
-					const token = guard.begin();
+				const refresh = async (force = false, clearError = true) => {
+					const token = reads.begin();
 					try {
-						const result = await getSelection();
-						if (!guard.accepts(token)) return;
+						const result = await latest.current.getSelection({
+							force,
+							modelKey: latest.current.modelKey
+						});
+						if (!reads.accepts(token)) return;
 						if (result.ok) {
 							setValue(result.value);
 							if (clearError) setError("");
 						} else setError(result.error.message);
 					} catch {
-						if (guard.accepts(token)) setError(t("selectionReadFailed"));
-					} finally {
-						reading = false;
+						if (reads.accepts(token)) setError(latest.current.t("selectionReadFailed"));
 					}
 				};
 				const select = async (connectionId, expectedRevision, freshness) => {
 					if (writing) return;
 					writing = true;
-					const token = guard.begin();
+					reads.begin();
+					const token = writes.begin();
+					const writeModelKey = latest.current.modelKey;
 					setPending(true);
 					setError("");
 					setNotice("");
 					let refreshAfterFailure = false;
 					try {
-						const result = await setSelection({
+						const result = await latest.current.setSelection({
 							...connectionId !== void 0 ? { connectionId } : {},
 							...freshness !== void 0 ? { freshness } : {},
 							expectedRevision
 						});
-						if (!guard.accepts(token)) return;
+						if (!writes.accepts(token)) return;
 						if (result.ok) {
-							setValue(result.value);
-							setNotice(t("selectionSaved"));
+							if (writeModelKey === latest.current.modelKey) setValue(result.value);
+							setNotice(latest.current.t("selectionSaved"));
 						} else {
-							setError(result.error.message + t("selectionRefreshed"));
+							setError(result.error.message + latest.current.t("selectionRefreshed"));
 							refreshAfterFailure = true;
 						}
 					} catch {
-						if (guard.accepts(token)) {
-							setError(t("selectionWriteFailed"));
+						if (writes.accepts(token)) {
+							setError(latest.current.t("selectionWriteFailed"));
 							refreshAfterFailure = true;
 						}
 					} finally {
 						writing = false;
-						if (guard.accepts(token)) {
+						if (writes.accepts(token)) {
 							setPending(false);
-							if (refreshAfterFailure) {
-								reading = false;
-								refresh();
-							}
+							if (refreshAfterFailure) refresh(true, false);
 						}
 					}
 				};
@@ -6360,29 +6374,22 @@ window.__ModuleLoader__.load({
 					refresh,
 					select
 				};
-				refresh();
-				const timer = window.setInterval(() => {
-					refresh();
-				}, 2e3);
 				const focus = () => {
-					refresh();
+					if (document.visibilityState === "visible") refresh();
 				};
 				window.addEventListener("focus", focus);
+				document.addEventListener("visibilitychange", focus);
 				return () => {
-					guard.cancel();
+					reads.cancel();
+					writes.cancel();
 					controller.current = void 0;
-					window.clearInterval(timer);
 					window.removeEventListener("focus", focus);
+					document.removeEventListener("visibilitychange", focus);
 				};
-			}, [
-				sessionId,
-				getSelection,
-				setSelection,
-				t
-			]);
+			}, [sessionId]);
 			(0, react.useEffect)(() => {
-				controller.current?.refresh(true);
-			}, [modelSelection]);
+				controller.current?.refresh();
+			}, [sessionId, modelKey]);
 			const connections = (0, react.useMemo)(() => discoverableConnections(value?.connections ?? []), [value?.connections]);
 			(0, react.useEffect)(() => {
 				if (!notice) return;
@@ -6402,13 +6409,16 @@ window.__ModuleLoader__.load({
 				onFreshness: (freshness) => {
 					if (value) controller.current?.select(void 0, value.selection.revision, freshness);
 				},
+				onOpen: () => {
+					controller.current?.refresh();
+				},
 				onRefresh: () => {
 					controller.current?.refresh(true);
 				}
 			});
 		}
 		/** Native popovers live in the top layer, outside the composer's clipping boundary. */
-		function SearchSelectorControl({ t, value, connections, pending, error, notice, onSelect, onFreshness, onRefresh }) {
+		function SearchSelectorControl({ t, value, connections, pending, error, notice, onSelect, onFreshness, onOpen, onRefresh }) {
 			const id = (0, react.useId)();
 			const panel = (0, react.useRef)(null);
 			const trigger = (0, react.useRef)(null);
@@ -6431,13 +6441,13 @@ window.__ModuleLoader__.load({
 				};
 			}, []);
 			const toggle = () => {
-				onRefresh();
 				const node = panel.current, button = trigger.current;
 				if (!node || !button) return;
 				if (node.matches(":popover-open")) {
 					node.hidePopover();
 					return;
 				}
+				(onOpen ?? onRefresh)();
 				const rect = button.getBoundingClientRect();
 				const width = Math.min(280, window.innerWidth - 32);
 				node.style.width = width + "px";
@@ -8214,25 +8224,165 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region lib/types/client/bindings.js
 		/** Services stay in the apply world; the renderer binds this bare source to useSettings. */
-		function settingsInjection(form, credentials) {
+		function settingsInjection(form, credentials, credentialsChanged) {
 			return {
 				hooks: { settings: form },
 				mutateSettings: (operations, revision) => form.mutate(operations, revision),
 				describeCredentials: (refs) => credentials.describe(refs),
-				setCredential: (ref, value) => credentials.set(ref, value)
+				setCredential: async (ref, value) => {
+					const result = await credentials.set(ref, value);
+					if (result.ok) credentialsChanged?.();
+					return result;
+				}
 			};
 		}
 		/** Bind each callback to its slot's Session, rather than exposing a remote service. */
-		function selectionInjection(remote, sessionId) {
+		function selectionInjection(client, sessionId) {
 			return {
-				getSelection: () => remote.get({ sessionId }),
-				setSelection: (request) => remote.set({
-					...request,
-					sessionId
-				})
+				getSelection: (options) => client.get(sessionId, options),
+				setSelection: (request) => client.set(sessionId, request)
 			};
 		}
 		//#endregion
+		//#region lib/types/client/selection-client.js
+		/** One instance per mounted Remote namespace, never a process-global/session-only cache. */
+		var SelectionClient = class {
+			remote;
+			ttl;
+			capacity;
+			entries = /* @__PURE__ */ new Map();
+			disposed = false;
+			epoch = 0;
+			constructor(remote, ttl = 3e4, capacity = 64) {
+				this.remote = remote;
+				this.ttl = ttl;
+				this.capacity = capacity;
+			}
+			entry(sessionId) {
+				this.assertActive();
+				let entry = this.entries.get(sessionId);
+				if (!entry) entry = {
+					expires: 0,
+					generation: 0
+				};
+				this.entries.delete(sessionId);
+				this.entries.set(sessionId, entry);
+				return entry;
+			}
+			prune() {
+				for (const [id, entry] of this.entries) {
+					if (this.entries.size <= this.capacity) break;
+					if (!entry.reading && !entry.writing) this.entries.delete(id);
+				}
+			}
+			assertActive(epoch = this.epoch) {
+				if (this.disposed) throw new Error("Search selection client disposed");
+				if (epoch !== this.epoch) throw new Error("Search connection changed");
+			}
+			invalidate() {
+				for (const entry of this.entries.values()) {
+					entry.expires = 0;
+					++entry.generation;
+				}
+			}
+			/** Transport loss/replacement must not reuse or replay work from the old Host. */
+			reset() {
+				++this.epoch;
+				this.entries.clear();
+			}
+			dispose() {
+				this.disposed = true;
+				this.reset();
+			}
+			get(sessionId, options = {}) {
+				const entry = this.entry(sessionId);
+				const epoch = this.epoch;
+				if (options.modelKey !== void 0 && options.modelKey !== entry.modelKey) {
+					entry.modelKey = options.modelKey;
+					entry.expires = 0;
+					++entry.generation;
+				}
+				if (options.force) entry.expires = 0;
+				if (entry.reading) return entry.reading;
+				if (!entry.writing && entry.value && Date.now() < entry.expires) {
+					this.prune();
+					return Promise.resolve({
+						ok: true,
+						value: entry.value
+					});
+				}
+				const read = async () => {
+					for (;;) {
+						this.assertActive(epoch);
+						if (entry.writing) {
+							await entry.writing.catch(() => {});
+							continue;
+						}
+						if (entry.value && Date.now() < entry.expires) {
+							entry.reading = void 0;
+							return {
+								ok: true,
+								value: entry.value
+							};
+						}
+						const generation = entry.generation;
+						let result;
+						try {
+							result = await this.remote.get({ sessionId });
+						} catch (error) {
+							this.assertActive(epoch);
+							if (generation !== entry.generation) continue;
+							entry.reading = void 0;
+							throw error;
+						}
+						this.assertActive(epoch);
+						if (generation !== entry.generation) continue;
+						if (result.ok) {
+							entry.value = result.value;
+							entry.expires = Date.now() + this.ttl;
+						}
+						entry.reading = void 0;
+						return result;
+					}
+				};
+				const pending = read().finally(() => {
+					if (entry.reading === pending) entry.reading = void 0;
+					this.prune();
+				});
+				entry.reading = pending;
+				this.prune();
+				return pending;
+			}
+			set(sessionId, request) {
+				const entry = this.entry(sessionId);
+				const epoch = this.epoch;
+				const generation = ++entry.generation;
+				entry.expires = 0;
+				const previous = entry.writing;
+				const write = async () => {
+					if (previous) await previous.catch(() => {});
+					this.assertActive(epoch);
+					const result = await this.remote.set({
+						...request,
+						sessionId
+					});
+					this.assertActive(epoch);
+					if (generation === entry.generation && result.ok) {
+						entry.value = result.value;
+						entry.expires = Date.now() + this.ttl;
+					}
+					return result;
+				};
+				const pending = write().finally(() => {
+					if (entry.writing === pending) entry.writing = void 0;
+					this.prune();
+				});
+				entry.writing = pending;
+				this.prune();
+				return pending;
+			}
+		};
+		//#endregion
 		//#region node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/core.js
 		var _a$1;
 		function $constructor(name, initializer, params) {
@@ -12459,6 +12609,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		const NS = "web-search-enhanced";
 		const LOCALE = "settings.webSearchEnhanced";
 		const inject = [
+			"connection",
 			"slots",
 			"locale",
 			"configForms",
@@ -12470,7 +12621,9 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				en,
 				zh
 			}), "search dictionaries");
-			const settings = settingsInjection(ctx.configForms.get(NS), ctx.remote.credentials);
+			const form = ctx.configForms.get(NS);
+			let selectionClient;
+			const settings = settingsInjection(form, ctx.remote.credentials, () => selectionClient?.invalidate());
 			ctx.effect(() => ctx.configForms.whileServed([NS], () => ctx.slots.inject("plugins.bundle.config", () => ctx.slots.register({
 				name: "plugins.bundle.config",
 				key: "dsh-web-search-enhanced",
@@ -12480,12 +12633,21 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			const dispose = await ctx.remote.$mount(searchContribution);
 			ctx.effect(() => dispose, "search selection remote");
 			ctx.inject(["remote.searchConnections"], (searchCtx) => {
+				const client = new SelectionClient(searchCtx.remote.searchConnections);
+				selectionClient = client;
+				searchCtx.effect(() => () => {
+					client.dispose();
+					if (selectionClient === client) selectionClient = void 0;
+				}, "search selection cache");
+				searchCtx.effect(() => form.subscribe(() => client.invalidate()), "search settings invalidation");
+				const connection = searchCtx.get("connection");
+				searchCtx.effect(() => connection.generation.subscribe(() => client.reset()), "search connection invalidation");
 				searchCtx.slots.inject("conversation.input.right", () => searchCtx.slots.register({
 					name: "conversation.input.right",
 					id: "search-connection",
 					order: 20,
 					locale: LOCALE,
-					inject: (sessionId) => selectionInjection(searchCtx.remote.searchConnections, sessionId)
+					inject: (sessionId) => selectionInjection(client, sessionId)
 				}, SearchConnectionSelector));
 			});
 		}