@crazx/dsh-client-ui-model-selection 0.1.0-rc.7.zw.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# side as of the last confirmed-consistent state. Both languages carry equal authority;
+# after editing either side, bring the other along and re-record with:
+#   pnpm run verify-translation-pairing --write packages/client/ui-model-selection/README.md
+README.md: 929d23ad4af1fe41e1cc7398ef432e73ca2a7a94
+README.zh.md: 23e786d9e490b0739498a3e83703b42ebc345cbd

package/README.md

@@ -0,0 +1,29 @@
+# @deepseek-ai/dsh-client-ui-model-selection
+
+English | [中文](README.zh.md)
+
+Model selection plugin, browser half: TWO entries over ONE per-session directory owned by `ModelDirectoryResolver` (`ctx.modelDirectories`). For ordinary sessions, the `/model` popupSelect contribution (registered through `ctx.commandUi`) and the composer's named `conversation.input.model` seat both load the session's advisory directory through `session.models` and submit through `session.selectModel` via the same `ModelDirectory` instance. The compact composer trigger opens a two-level Model/Effort menu: models stay provider-grouped, while the selected exact model supplies its adapter-owned effort names, descriptions, and default. `/model` applies the selected model's default effort, and the composer can then choose any advertised effort.
+
+The Host-reported provider/model/reasoning `ModelSelection` is the single selection fact, but it is echoed only when the exact provider/model pair remains in the advertised groups; an absent catalog row leaves the routable selection intact while the trigger prompts `Select model`, no stale row is synthesized, and no Effort row is shown until the user picks an advertised model. Directory loads and selections share a generation counter so an older response never overwrites a newer one; a connection reset drops every resident projection and repulls the Host-restored selection before display. Provider-local metadata failures list inline while usable groups stay selectable, and selection failures retain the prior selection and directory.
+
+When the Host reports that no adapter serves the session's route (`session.models.routable`), this plugin raises a composer block through `ctx.conversation.blocks` and the input goes inert with this plugin's own copy; recovering clears it without a reload. It follows `routable` and nothing else: a `null` — before the first load, or after one failed — never blocks, or a slow Host would lock a working composer, and catalog membership never blocks either, because a route serving a model it stopped advertising is missing from the groups yet perfectly usable. The trigger's own `Select model` fallback still covers that case, which is display, not a gate.
+
+Directories are per-session, resolved lazily through `ctx.modelDirectories.directoryFor(sessionId)`, and disposed with the session scope. Addressed subagent sessions expose neither entry, and their directory rejects loads, selections, and reconnect refreshes, because ordinary Agent-bound model RPCs would activate persisted child history outside the direct-parent continuation path.
+
+Every resident directory refetches directly on forwarded `llm/adapters-updated` and `settings/document-updated` owner events. Provider topology, provider catalogs, and the default selection therefore converge without the Host or client runtime deriving a separate model-change alias.
+
+The `/client` exports are the plugin body (`apply`/`inject`), `ModelDirectoryResolver`, `ModelDirectory` with its state fields, and the seat's injected face type.
+
+## Model Experience
+
+Indirectly, through the `session.selectModel` RPC available to ordinary sessions, both entries submit the complete `ModelSelection` that the Host snapshots at the next prompt-assembly boundary, so the following request uses the selected provider, model, and effort while a running step keeps its assembled selection; the selection becomes durable only when the existing request header records a request that consumes it, and menu interaction adds no prompt content.
+
+#### KV Cache effect
+
+Switching the route can reduce or invalidate provider-side cache reuse for subsequent requests; the prompt prefix itself is untouched.
+
+## Known Limitations and Deferred Work
+
+- **No create-time or addressed-subagent selection** — both entries require an existing ordinary session's Agent; there is no draft-phase model choice to fold into session creation, and subagent continuation deliberately exposes no independent model-selection contract.
+- **Directory names are presentation-only** — selection and persistence use provider/model/effort ids; a provider whose catalog or exact-model metadata lookup fails lists as an unselectable failure row until reload.
+- **No arbitrary effort input** — the composer offers only the exact model's adapter-advertised levels; an adapter without reasoning metadata leaves the Effort row absent.

package/README.zh.md

@@ -0,0 +1,29 @@
+# @deepseek-ai/dsh-client-ui-model-selection
+
+[English](README.md) | 中文
+
+模型选择插件（浏览器侧）：**两个入口共用一份会话级目录**，由 `ModelDirectoryResolver`（`ctx.modelDirectories`）持有。对于普通会话，`/model` popupSelect 贡献项（经 `ctx.commandUi` 注册）与 composer 的具名 `conversation.input.model` slot 都通过同一个 `ModelDirectory` 实例，经 `session.models` 加载会话的建议目录，并经 `session.selectModel` 提交。紧凑型 composer 触发器会打开两级 Model/Effort 菜单：模型仍按提供方分组，所选具体模型则提供由其适配器持有的推理强度名称、说明和默认值。`/model` 应用所选模型的默认推理强度，composer 随后可以选择任一已公布的推理强度。
+
+Host 报告的 `ModelSelection` 是唯一的选择事实，其中包含提供方、模型与推理（reasoning）强度；但只有当该提供方／模型对仍在已公布分组中时才会回显。目录行缺席时，可路由的选择保持不变，但触发器会提示 `Select model`；系统不会合成陈旧行，且在用户选择已公布的模型之前不会显示 Effort 行。目录加载与选择共享一个代次计数器，旧响应不会覆盖新结果；连接重置会丢弃所有常驻目录投影，并在显示前重新拉取 Host 恢复的选择。各提供方的元数据获取失败会内联列出，同时可用分组仍可选择；选择失败会保留先前的选择和目录。
+
+当宿主报告没有适配器服务该会话的路由（`session.models.routable`）时，本插件经 `ctx.conversation.blocks` 注册一个 composer 阻塞块，输入框随之停用并显示本插件自己的文案；恢复后无需重新加载即自动清除。它只跟随 `routable`：`null`（首次加载之前，或加载失败之后）绝不阻断，否则一个慢的宿主就会锁死一个本来可用的 composer；目录成员关系同样不阻断，因为一条仍在服务、只是不再公布该模型的路由不在分组里，却完全可用。触发器自己的 `Select model` 回退仍然覆盖那种情形——那是显示，不是闸门。
+
+目录按会话惰性解析（`ctx.modelDirectories.directoryFor(sessionId)`），随会话作用域一并 dispose（资源释放）。已寻址 subagent 会话不公开任一入口，其目录会拒绝加载、选择与重新连接刷新，因为绑定到 agent（智能体）的普通模型 RPC 会在直接 parent 继续执行路径之外激活持久化 child 历史。
+
+每一份常驻目录都会直接在转发的 owner 事件 `llm/adapters-updated` 与 `settings/document-updated` 上重拉。因此提供方拓扑、提供方目录与默认选择都能收敛，Host 与 client runtime 无需再派生一个单独的模型变更别名。
+
+`/client` 导出面为插件本体（`apply`/`inject`）、`ModelDirectoryResolver`、`ModelDirectory` 及其状态形状、slot 注入面类型。
+
+## 模型体验
+
+间接影响。两个入口都通过仅供普通会话使用的 `session.selectModel` RPC 提交完整的 `ModelSelection`；Host 会在下一次提示词组装边界对其进行快照，因此后续请求采用所选提供方、模型与推理强度，而运行中的步骤保留已组装选择。只有当现有请求头记录一次实际采用该选择的请求后，选择才会持久化；菜单交互不会添加提示词内容。
+
+#### KV Cache 影响
+
+切换路由可能减少提供方侧后续请求的缓存复用，或使其失效；提示词前缀本身不受影响。
+
+## 已知限制与暂缓事项
+
+- **无创建期或已寻址 subagent 选择**——两个入口都要求既有普通会话的 agent；没有可纳入会话创建的草稿阶段模型选择，subagent 继续执行也有意不公开独立的模型选择约定。
+- **目录名仅供呈现**——选择与持久化使用提供方／模型／推理强度 id；目录查询或确切模型元数据查询失败的提供方以不可选失败行列出，重新加载前保持原样。
+- **不能任意输入推理强度**——composer 仅提供确切模型由适配器公布的推理强度；适配器没有推理元数据时不显示 Effort 行。

package/lib/client.js

@@ -0,0 +1,804 @@
+window.__ModuleLoader__.load({
+	id: "@deepseek-ai/dsh-client-ui-model-selection",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let _deepseek_ai_cordis = require("@deepseek-ai/cordis");
+		let _deepseek_ai_dsh_client_runtime_client = require("@deepseek-ai/dsh-client-runtime/client");
+		let react_jsx_runtime = require("react/jsx-runtime");
+		let react = require("react");
+		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+		//#region lib/types/client/directory.js
+		/** One session's shared directory controller; disposed with the session scope. */
+		var ModelDirectory = class {
+			sessions;
+			sessionId;
+			available;
+			/** The shared snapshot both entries render from (uSES-safe store). */
+			store = (0, _deepseek_ai_dsh_client_runtime_client.createSnapshotStore)({
+				current: null,
+				routable: null,
+				groups: [],
+				failures: [],
+				status: "idle",
+				error: null
+			});
+			/** Latest operation wins; an older response never overwrites a newer one. */
+			generation = 0;
+			disposed = false;
+			/**
+			* @param sessions - the session wire face (captured from the plugin's root connection).
+			* @param sessionId - the owning session.
+			* @param available - whether this session may use Agent-bound model RPCs.
+			*/
+			constructor(sessions, sessionId, available) {
+				this.sessions = sessions;
+				this.sessionId = sessionId;
+				this.available = available;
+			}
+			/**
+			* Refresh the advisory directory (both entries call this on open).
+			* Failure preserves the last good groups and current selection.
+			* @returns the fresh directory value.
+			*/
+			async load() {
+				this.assertAvailable();
+				const generation = ++this.generation;
+				this.store.update((s) => {
+					s.status = "loading";
+					s.error = null;
+				});
+				const { result } = await this.sessions.models({ sessionId: this.sessionId });
+				if (this.disposed || generation !== this.generation) {
+					if (!result.ok) throw new Error(`${result.error.code}: ${result.error.message}`);
+					return result.value;
+				}
+				if (!result.ok) {
+					this.store.update((s) => {
+						s.status = "error";
+						s.error = `${result.error.code}: ${result.error.message}`;
+					});
+					throw new Error(`session.models failed: ${result.error.code}: ${result.error.message}`);
+				}
+				const { current, routable, groups, failures } = result.value;
+				this.store.update((s) => {
+					s.current = current;
+					s.routable = routable;
+					s.groups = groups;
+					s.failures = failures;
+					s.status = "ready";
+					s.error = null;
+				});
+				return result.value;
+			}
+			/**
+			* Select the complete provider/model/reasoning selection (both entries submit through here). Success
+			* updates the shared current; failure surfaces on the store and throws so
+			* each entry's own retry surface engages.
+			* @param selection - provider, provider-owned model id, and optional adapter-owned effort.
+			*/
+			async select(selection) {
+				this.assertAvailable();
+				const generation = ++this.generation;
+				this.store.update((s) => {
+					s.status = "selecting";
+					s.error = null;
+				});
+				const { result } = await this.sessions.selectModel({
+					sessionId: this.sessionId,
+					provider: selection.provider,
+					model: selection.model,
+					...selection.reasoningEffort === void 0 ? {} : { reasoningEffort: selection.reasoningEffort }
+				});
+				if (this.disposed || generation !== this.generation) {
+					if (!result.ok) throw new Error(`${result.error.code}: ${result.error.message}`);
+					return;
+				}
+				if (!result.ok) {
+					this.store.update((s) => {
+						s.status = "error";
+						s.error = `${result.error.code}: ${result.error.message}`;
+					});
+					throw new Error(`session.selectModel failed: ${result.error.code}: ${result.error.message}`);
+				}
+				this.store.update((s) => {
+					s.current = result.value.selected;
+					s.routable = true;
+					s.status = "ready";
+					s.error = null;
+				});
+			}
+			/**
+			* Drop the previous Host generation's projection and repull it. Clearing
+			* first prevents an unconsumed process-local selection from being displayed
+			* while the restarted Host has restored the last logged model selection.
+			*/
+			resetConnected() {
+				if (this.disposed) return;
+				++this.generation;
+				this.store.update((s) => {
+					s.current = null;
+					s.routable = null;
+					s.groups = [];
+					s.failures = [];
+					s.status = "idle";
+					s.error = null;
+				});
+				if (!this.available()) return;
+				this.load().catch(() => {});
+			}
+			/** Scope teardown: late settlements lose write access to the store. */
+			dispose() {
+				this.disposed = true;
+			}
+			assertAvailable() {
+				if (!this.available()) throw new Error("model selection is unavailable for addressed subagent sessions");
+			}
+		};
+		//#endregion
+		//#region lib/types/client/service.js
+		/**
+		* ModelDirectoryResolver (`ctx.modelDirectories`): the root owner of per-session
+		* {@link ModelDirectory} instances. Both selection entries (the /model popup
+		* and the composer model seat) resolve their session's directory through
+		* this service, which is what makes the dual entry one shared state.
+		*
+		* Per-session storage follows the client service pattern (InputTriggerService /
+		* CommandUiRuntime): a lazy service-internal map whose entry is deleted by the
+		* owning scope's disposer. The host `dsh-scope` ScopedLayers registry does
+		* does not belong here: it derives scope from the host carrier mechanism
+		* (object-keyed), while client scopes tag contexts with branded SessionId
+		* strings, and it models global+shadow named registries — this is a
+		* per-session singleton with no global layer to merge.
+		*/
+		/** The `ctx.modelDirectories` session model-selection service. */
+		var ModelDirectoryResolver = class extends _deepseek_ai_cordis.Service {
+			static inject = [
+				"connection",
+				"sessions",
+				"remote"
+			];
+			live = { directories: /* @__PURE__ */ new Map() };
+			/** Localized composer-block copy; this plugin owns the string it raises. */
+			blockReason;
+			/**
+			* @param ctx - owning root context (the service registers itself as `models`).
+			* @param config - the bound translator for this plugin's own dictionary.
+			*/
+			constructor(ctx, config) {
+				super(ctx, "modelDirectories");
+				this.blockReason = config.blockReason;
+				ctx.on("connection/reset", () => {
+					for (const directory of this.live.directories.values()) directory.resetConnected();
+				});
+				const refresh = () => {
+					for (const directory of this.live.directories.values()) directory.load().catch(() => void 0);
+				};
+				ctx.remote.$on("llm/adapters-updated", refresh);
+				ctx.remote.$on("settings/document-updated", refresh);
+			}
+			/**
+			* Resolve the per-session shared directory (lazy; the scope disposer
+			* removes and disposes it). Unknown sessions fail loud.
+			* @param sessionId - the owning session.
+			* @returns the resident directory both entries share.
+			*/
+			directoryFor(sessionId) {
+				const { live } = this;
+				const existing = live.directories.get(sessionId);
+				if (existing !== void 0) return existing;
+				const sessions = this.ctx.get("sessions");
+				const actx = sessions.scope(sessionId);
+				if (actx === void 0) throw new Error(`ui-model-selection: session "${String(sessionId)}" resolved no scope`);
+				const directory = new ModelDirectory(this.ctx.get("connection").api.sessions, sessionId, () => sessions.subagentAddress(sessionId) === void 0);
+				live.directories.set(sessionId, directory);
+				const conversation = this.ctx.get("conversation");
+				if (conversation !== void 0) {
+					const publish = () => {
+						conversation.blocks.set(sessionId, directory.store.getSnapshot().routable === false ? { reason: this.blockReason() } : void 0);
+					};
+					publish();
+					actx.effect(() => {
+						const stop = directory.store.subscribe(publish);
+						return () => {
+							stop();
+							conversation.blocks.set(sessionId, void 0);
+						};
+					}, "ui-model-selection: composer block");
+				}
+				actx.effect(() => () => {
+					directory.dispose();
+					live.directories.delete(sessionId);
+				}, "ui-model-selection: session directory");
+				return directory;
+			}
+		};
+		//#endregion
+		//#region ../../../node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
+		function r(e) {
+			var t, f, n = "";
+			if ("string" == typeof e || "number" == typeof e) n += e;
+			else if ("object" == typeof e) if (Array.isArray(e)) {
+				var o = e.length;
+				for (t = 0; t < o; t++) e[t] && (f = r(e[t])) && (n && (n += " "), n += f);
+			} else for (f in e) e[f] && (n && (n += " "), n += f);
+			return n;
+		}
+		function clsx() {
+			for (var e, t, f = 0, n = "", o = arguments.length; f < o; f++) (e = arguments[f]) && (t = r(e)) && (n && (n += " "), n += t);
+			return n;
+		}
+		//#endregion
+		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-model-selection/src/client/ModelSelect.module.css.mjs
+		const css = "._7KE1Ra_root{min-width:0;position:relative}._7KE1Ra_trigger{min-width:0;max-width:220px;height:28px;color:var(--dsw-alias-label-secondary);cursor:pointer;background:0 0;border:none;border-radius:24px;outline:none;align-items:center;gap:4px;padding:0 4px 0 8px;font-size:13px;font-weight:500;line-height:20px;display:flex}._7KE1Ra_trigger:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}._7KE1Ra_trigger:focus-visible{box-shadow:0 0 0 2px var(--dsw-alias-border-l3)}._7KE1Ra_trigger:disabled{color:var(--dsw-alias-label-dimmed);cursor:default}._7KE1Ra_triggerLabel{text-overflow:ellipsis;white-space:nowrap;min-width:0;overflow:hidden}._7KE1Ra_triggerEffort{color:var(--dsw-alias-label-caption);flex:none}._7KE1Ra_chevron{color:var(--dsw-alias-label-caption);flex:none;transition:transform .12s}._7KE1Ra_chevronOpen{transform:rotate(180deg)}._7KE1Ra_menu{z-index:20;border:1px solid var(--dsw-alias-border-inverted);background:var(--dsw-specific-menu);width:min(240px,100vw - 32px);max-height:min(360px,100vh - 96px);box-shadow:var(--dsw-shadow-lv3);color:var(--dsw-alias-label-primary);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);border-radius:12px;flex-direction:column;padding:4px;display:flex;position:absolute;bottom:calc(100% + 8px);right:0;overflow:hidden}._7KE1Ra_status,._7KE1Ra_empty{color:var(--dsw-alias-label-tertiary);padding:10px;font-size:13px;line-height:20px}._7KE1Ra_error,._7KE1Ra_warning{background:var(--dsw-alias-interactive-bg-hover-danger);color:var(--dsw-alias-state-error-primary);border-radius:8px;justify-content:space-between;align-items:flex-start;gap:8px;margin-bottom:4px;padding:7px 8px;font-size:12px;line-height:18px;display:flex}._7KE1Ra_warning{background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-state-warn-label)}._7KE1Ra_retry{color:inherit;font:inherit;cursor:pointer;background:0 0;border:none;flex:none;padding:0;font-weight:600}._7KE1Ra_groups{min-height:0;overflow-y:auto}._7KE1Ra_group+._7KE1Ra_group{margin-top:4px}._7KE1Ra_groupTitle{z-index:1;background:var(--dsw-specific-menu);color:var(--dsw-alias-label-tertiary);padding:5px 8px 3px;font-size:12px;font-weight:500;line-height:18px;position:sticky;top:0}._7KE1Ra_option{width:100%;min-height:38px;color:inherit;text-align:left;cursor:pointer;background:0 0;border:none;border-radius:10px;outline:none;align-items:center;gap:8px;padding:6px 8px;display:flex}._7KE1Ra_option:hover:not(:disabled),._7KE1Ra_option:focus-visible{background:var(--dsw-alias-interactive-bg-hover)}._7KE1Ra_selected{background:0 0}._7KE1Ra_option:disabled{color:var(--dsw-alias-label-dimmed);cursor:default}._7KE1Ra_optionCopy{flex-direction:column;flex:1;min-width:0;display:flex}._7KE1Ra_modelName{color:inherit;text-overflow:ellipsis;white-space:nowrap;font-size:14px;font-weight:500;line-height:20px;overflow:hidden}._7KE1Ra_description{color:var(--dsw-alias-label-tertiary);text-overflow:ellipsis;white-space:nowrap;font-size:12px;line-height:18px;overflow:hidden}._7KE1Ra_check{color:var(--dsw-alias-label-primary);flex:0 0 18px;place-items:center;display:grid}._7KE1Ra_cell{width:100%;height:40px;color:var(--dsw-alias-label-primary);cursor:pointer;text-align:left;background:0 0;border:none;border-radius:10px;align-items:center;gap:8px;padding:0 10px;font-size:14px;line-height:22px;display:flex}._7KE1Ra_cell:hover{background:var(--dsw-alias-interactive-bg-hover)}._7KE1Ra_cellLabel{text-overflow:ellipsis;white-space:nowrap;flex:auto;min-width:0;overflow:hidden}._7KE1Ra_cellValue{text-overflow:ellipsis;white-space:nowrap;min-width:0;color:var(--dsw-alias-label-tertiary);flex:0 auto;overflow:hidden}._7KE1Ra_cellChevron{color:var(--dsw-alias-label-tertiary);flex:none}";
+		const tagId = "@deepseek-ai/dsh-client-ui-model-selection/ModelSelect.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@deepseek-ai/dsh-client-ui-model-selection";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var ModelSelect_module_css_default = {
+			"optionCopy": "_7KE1Ra_optionCopy",
+			"triggerLabel": "_7KE1Ra_triggerLabel",
+			"status": "_7KE1Ra_status",
+			"cellChevron": "_7KE1Ra_cellChevron",
+			"group": "_7KE1Ra_group",
+			"trigger": "_7KE1Ra_trigger",
+			"error": "_7KE1Ra_error",
+			"option": "_7KE1Ra_option",
+			"check": "_7KE1Ra_check",
+			"empty": "_7KE1Ra_empty",
+			"warning": "_7KE1Ra_warning",
+			"description": "_7KE1Ra_description",
+			"groupTitle": "_7KE1Ra_groupTitle",
+			"cell": "_7KE1Ra_cell",
+			"groups": "_7KE1Ra_groups",
+			"cellValue": "_7KE1Ra_cellValue",
+			"chevronOpen": "_7KE1Ra_chevronOpen",
+			"chevron": "_7KE1Ra_chevron",
+			"modelName": "_7KE1Ra_modelName",
+			"cellLabel": "_7KE1Ra_cellLabel",
+			"menu": "_7KE1Ra_menu",
+			"root": "_7KE1Ra_root",
+			"triggerEffort": "_7KE1Ra_triggerEffort",
+			"retry": "_7KE1Ra_retry",
+			"selected": "_7KE1Ra_selected"
+		};
+		//#endregion
+		//#region lib/types/client/ModelSelect.js
+		/**
+		* ModelSelect: the composer's named model seat (`conversation.input.model`).
+		* Two-level selection per figma 496:26454's MenuDropdown: the root menu is
+		* the Model / Effort row pair (label + current value + a right chevron),
+		* each drilling into its own list — the provider-grouped model list over
+		* the shared directory, and the effort levels. The trigger (313:14108's
+		* ToggleButton) shows both: model name + effort in the caption tone.
+		* Data and submission ride the SAME per-session ModelDirectory as the
+		* /model popup; exact-model reasoning metadata and the selected effort come
+		* from the Host rather than a client-owned vocabulary. A rejected selection
+		* announces through the shared transient Toast anchored to the composer
+		* card; the in-menu strip with Retry remains the catalog-load surface.
+		*/
+		/**
+		* Render the composer model seat.
+		* @param props - owner share (locked) + injected face (shared directory
+		* store/verbs) + the standard locale seat.
+		* @returns the trigger and, while open, the two-level menu.
+		*/
+		function ModelSelect({ locked, available, directory, load, select, t }) {
+			const state = (0, react.useSyncExternalStore)((fn) => directory.subscribe(fn), () => directory.getSnapshot());
+			const [open, setOpen] = (0, react.useState)(false);
+			const [pane, setPane] = (0, react.useState)("root");
+			const lastActionRef = (0, react.useRef)("load");
+			const [toast, setToast] = (0, react.useState)(null);
+			const toastSeq = (0, react.useRef)(0);
+			const rootRef = (0, react.useRef)(null);
+			const triggerRef = (0, react.useRef)(null);
+			const itemRefs = (0, react.useRef)([]);
+			const id = (0, react.useId)();
+			const choices = (0, react.useMemo)(() => state.groups.flatMap((group) => group.models.map((model) => ({
+				group,
+				model,
+				selection: {
+					provider: group.id,
+					model: model.id,
+					...model.reasoning?.defaultEffort === void 0 ? {} : { reasoningEffort: model.reasoning.defaultEffort }
+				}
+			}))), [state.groups]);
+			const currentChoice = choices[state.current === null ? -1 : choices.findIndex((c) => c.selection.provider === state.current?.provider && c.selection.model === state.current.model)];
+			const reasoning = currentChoice?.model.reasoning;
+			const effectiveEffort = state.current?.reasoningEffort ?? reasoning?.defaultEffort;
+			const effortLabel = reasoning === void 0 ? void 0 : effectiveEffort === void 0 ? t("effort.providerDefault") : reasoning.efforts.find((level) => level.id === effectiveEffort)?.name ?? effectiveEffort;
+			const effortChoices = (0, react.useMemo)(() => reasoning === void 0 ? [] : [...reasoning.defaultEffort === void 0 ? [{
+				key: "provider-default",
+				effort: void 0,
+				label: t("effort.providerDefault")
+			}] : [], ...reasoning.efforts.map((effort) => ({
+				key: `effort:${effort.id}`,
+				effort: effort.id,
+				label: effort.name,
+				...effort.description === void 0 ? {} : { description: effort.description }
+			}))], [reasoning, t]);
+			const busy = state.status === "selecting";
+			const reload = () => {
+				lastActionRef.current = "load";
+				load();
+			};
+			(0, react.useEffect)(() => {
+				if (available) {
+					lastActionRef.current = "load";
+					load();
+				}
+			}, [available, load]);
+			(0, react.useEffect)(() => {
+				if (!open) return;
+				const closeOutside = (event) => {
+					if (!rootRef.current?.contains(event.target)) setOpen(false);
+				};
+				document.addEventListener("mousedown", closeOutside);
+				return () => {
+					document.removeEventListener("mousedown", closeOutside);
+				};
+			}, [open]);
+			if (!available) return null;
+			const show = () => {
+				setPane("root");
+				setOpen(true);
+				reload();
+			};
+			const close = (restoreFocus = false) => {
+				setOpen(false);
+				setPane("root");
+				if (restoreFocus) queueMicrotask(() => {
+					triggerRef.current?.focus();
+				});
+			};
+			const moveFocus = (offset) => {
+				const items = itemRefs.current.filter((item) => item !== null);
+				if (items.length === 0) return;
+				const active = items.findIndex((item) => item === document.activeElement);
+				items[(Math.max(active, 0) + offset + items.length) % items.length]?.focus();
+			};
+			const onRootKeyDown = (event) => {
+				if (event.key === "Escape" && open) {
+					event.preventDefault();
+					if (pane !== "root") setPane("root");
+					else close(true);
+					return;
+				}
+				if (!open) return;
+				if (event.key === "ArrowDown" || event.key === "ArrowUp") {
+					event.preventDefault();
+					moveFocus(event.key === "ArrowDown" ? 1 : -1);
+				}
+			};
+			const onBlur = (event) => {
+				if (event.relatedTarget instanceof Node && rootRef.current?.contains(event.relatedTarget)) return;
+				close();
+			};
+			const settleSelection = (accepted) => {
+				if (accepted) {
+					if (rootRef.current !== null) close(true);
+					return;
+				}
+				const message = directory.getSnapshot().error;
+				if (message !== null) {
+					toastSeq.current += 1;
+					setToast({
+						seq: toastSeq.current,
+						text: t("error.action", { message })
+					});
+				}
+			};
+			const choose = (selection) => {
+				if (state.current?.provider === selection.provider && state.current.model === selection.model) {
+					close(true);
+					return;
+				}
+				lastActionRef.current = "select";
+				select(selection).then(settleSelection);
+			};
+			const chooseEffort = (effort) => {
+				if (state.current === null) return;
+				if (effectiveEffort === effort) {
+					close(true);
+					return;
+				}
+				const selection = {
+					provider: state.current.provider,
+					model: state.current.model,
+					...effort === void 0 ? {} : { reasoningEffort: effort }
+				};
+				lastActionRef.current = "select";
+				select(selection).then(settleSelection);
+			};
+			const modelLabel = currentChoice?.model.name ?? t("trigger.fallback");
+			const triggerLabel = effortLabel === void 0 ? modelLabel : `${modelLabel} · ${effortLabel}`;
+			const triggerAria = currentChoice === void 0 ? t("trigger.selectAria") : effortLabel === void 0 ? t("trigger.aria", { model: modelLabel }) : t("trigger.ariaEffort", {
+				model: modelLabel,
+				effort: effortLabel
+			});
+			itemRefs.current = [];
+			let itemIndex = 0;
+			const itemRef = () => {
+				const at = itemIndex++;
+				return (node) => {
+					itemRefs.current[at] = node;
+				};
+			};
+			return (0, react_jsx_runtime.jsxs)("div", {
+				ref: rootRef,
+				className: ModelSelect_module_css_default.root,
+				onKeyDown: onRootKeyDown,
+				onBlur,
+				children: [
+					(0, react_jsx_runtime.jsxs)("button", {
+						ref: triggerRef,
+						type: "button",
+						className: ModelSelect_module_css_default.trigger,
+						"aria-label": triggerAria,
+						"aria-haspopup": "menu",
+						"aria-expanded": open,
+						"aria-controls": open ? `${id}-menu` : void 0,
+						title: triggerLabel,
+						disabled: locked,
+						onClick: () => {
+							if (open) close();
+							else show();
+						},
+						children: [
+							(0, react_jsx_runtime.jsx)("span", {
+								className: ModelSelect_module_css_default.triggerLabel,
+								children: modelLabel
+							}),
+							effortLabel !== void 0 && (0, react_jsx_runtime.jsx)("span", {
+								className: ModelSelect_module_css_default.triggerEffort,
+								children: effortLabel
+							}),
+							(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutline14, { className: clsx(ModelSelect_module_css_default.chevron, open && ModelSelect_module_css_default.chevronOpen) })
+						]
+					}),
+					open && (0, react_jsx_runtime.jsxs)("div", {
+						id: `${id}-menu`,
+						className: ModelSelect_module_css_default.menu,
+						role: "menu",
+						"aria-label": t("menu.aria"),
+						"aria-busy": state.status === "loading" || busy,
+						children: [
+							pane === "root" && (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [(0, react_jsx_runtime.jsxs)("button", {
+								ref: itemRef(),
+								type: "button",
+								role: "menuitem",
+								className: ModelSelect_module_css_default.cell,
+								onClick: () => {
+									setPane("model");
+								},
+								children: [
+									(0, react_jsx_runtime.jsx)("span", {
+										className: ModelSelect_module_css_default.cellLabel,
+										children: t("menu.model")
+									}),
+									(0, react_jsx_runtime.jsx)("span", {
+										className: ModelSelect_module_css_default.cellValue,
+										children: modelLabel
+									}),
+									(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronRightOutline14, { className: ModelSelect_module_css_default.cellChevron })
+								]
+							}), reasoning !== void 0 && (0, react_jsx_runtime.jsxs)("button", {
+								ref: itemRef(),
+								type: "button",
+								role: "menuitem",
+								className: ModelSelect_module_css_default.cell,
+								onClick: () => {
+									setPane("effort");
+								},
+								children: [
+									(0, react_jsx_runtime.jsx)("span", {
+										className: ModelSelect_module_css_default.cellLabel,
+										children: t("menu.effort")
+									}),
+									(0, react_jsx_runtime.jsx)("span", {
+										className: ModelSelect_module_css_default.cellValue,
+										children: effortLabel
+									}),
+									(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronRightOutline14, { className: ModelSelect_module_css_default.cellChevron })
+								]
+							})] }),
+							pane === "model" && (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+								state.status === "loading" && (0, react_jsx_runtime.jsx)("div", {
+									className: ModelSelect_module_css_default.status,
+									children: t("status.loading")
+								}),
+								state.error !== null && lastActionRef.current === "load" && (0, react_jsx_runtime.jsxs)("div", {
+									className: ModelSelect_module_css_default.error,
+									children: [(0, react_jsx_runtime.jsx)("span", { children: t("error.action", { message: state.error }) }), (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: ModelSelect_module_css_default.retry,
+										onClick: reload,
+										children: t("retry")
+									})]
+								}),
+								state.failures.map((failure) => (0, react_jsx_runtime.jsxs)("div", {
+									className: ModelSelect_module_css_default.warning,
+									children: [(0, react_jsx_runtime.jsx)("span", { children: t("warning.groupLoad", {
+										name: failure.name,
+										message: failure.message
+									}) }), (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: ModelSelect_module_css_default.retry,
+										onClick: reload,
+										children: t("retry")
+									})]
+								}, failure.id)),
+								(0, react_jsx_runtime.jsx)("div", {
+									className: clsx(ModelSelect_module_css_default.groups, "scrollable"),
+									children: state.groups.map((group) => {
+										const headingId = `${id}-${group.id}`;
+										return (0, react_jsx_runtime.jsxs)("section", {
+											role: "group",
+											"aria-labelledby": headingId,
+											className: ModelSelect_module_css_default.group,
+											children: [(0, react_jsx_runtime.jsx)("div", {
+												className: ModelSelect_module_css_default.groupTitle,
+												id: headingId,
+												children: group.name
+											}), group.models.map((model) => {
+												const selected = state.current?.provider === group.id && state.current.model === model.id;
+												return (0, react_jsx_runtime.jsxs)("button", {
+													ref: itemRef(),
+													type: "button",
+													role: "menuitemradio",
+													"aria-checked": selected,
+													className: clsx(ModelSelect_module_css_default.option, selected && ModelSelect_module_css_default.selected),
+													title: model.name,
+													disabled: busy,
+													onClick: () => {
+														choose({
+															provider: group.id,
+															model: model.id
+														});
+													},
+													children: [(0, react_jsx_runtime.jsxs)("span", {
+														className: ModelSelect_module_css_default.optionCopy,
+														children: [(0, react_jsx_runtime.jsx)("span", {
+															className: ModelSelect_module_css_default.modelName,
+															children: model.name
+														}), model.description !== void 0 && (0, react_jsx_runtime.jsx)("span", {
+															className: ModelSelect_module_css_default.description,
+															children: model.description
+														})]
+													}), (0, react_jsx_runtime.jsx)("span", {
+														className: ModelSelect_module_css_default.check,
+														children: selected ? (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCheckOutline16, {}) : null
+													})]
+												}, model.id);
+											})]
+										}, group.id);
+									})
+								}),
+								state.status === "ready" && choices.length === 0 && (0, react_jsx_runtime.jsx)("div", {
+									className: ModelSelect_module_css_default.empty,
+									children: t("empty.models")
+								})
+							] }),
+							pane === "effort" && (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [state.error !== null && lastActionRef.current === "load" && (0, react_jsx_runtime.jsxs)("div", {
+								className: ModelSelect_module_css_default.error,
+								children: [(0, react_jsx_runtime.jsx)("span", { children: t("error.action", { message: state.error }) }), (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									className: ModelSelect_module_css_default.retry,
+									onClick: reload,
+									children: t("action.reload")
+								})]
+							}), effortChoices.length === 0 ? (0, react_jsx_runtime.jsx)("div", {
+								className: ModelSelect_module_css_default.empty,
+								children: t("empty.efforts")
+							}) : effortChoices.map((level) => (0, react_jsx_runtime.jsxs)("button", {
+								ref: itemRef(),
+								type: "button",
+								role: "menuitemradio",
+								"aria-checked": effectiveEffort === level.effort,
+								className: clsx(ModelSelect_module_css_default.option, effectiveEffort === level.effort && ModelSelect_module_css_default.selected),
+								disabled: busy,
+								onClick: () => {
+									chooseEffort(level.effort);
+								},
+								children: [(0, react_jsx_runtime.jsxs)("span", {
+									className: ModelSelect_module_css_default.optionCopy,
+									children: [(0, react_jsx_runtime.jsx)("span", {
+										className: ModelSelect_module_css_default.modelName,
+										children: level.label
+									}), level.description !== void 0 && (0, react_jsx_runtime.jsx)("span", {
+										className: ModelSelect_module_css_default.description,
+										children: level.description
+									})]
+								}), (0, react_jsx_runtime.jsx)("span", {
+									className: ModelSelect_module_css_default.check,
+									children: effectiveEffort === level.effort ? (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCheckOutline16, {}) : null
+								})]
+							}, level.key))] })
+						]
+					}),
+					toast !== null && (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Toast, {
+						text: toast.text,
+						icon: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconWarningOutline16, {}),
+						anchor: rootRef.current?.closest("[data-composer-card]") ?? null,
+						onDone: () => {
+							setToast(null);
+						}
+					}, toast.seq)
+				]
+			});
+		}
+		//#endregion
+		//#region lib/types/client/locales.js
+		/**
+		* `model` namespace dictionaries.
+		*
+		* `trigger.selectAria` reads identically to `trigger.fallback` today and is
+		* still a separate key: the visible fallback label and the accessible name of
+		* an unset trigger are free to diverge per locale, and folding it into
+		* `trigger.aria` would announce the degenerate "Select model, current Select
+		* model".
+		*/
+		/** Simplified Chinese dictionary (the key-set source of truth). */
+		const zh = {
+			"command.description": "选择本会话使用的模型",
+			"option.loadError": "目录加载失败：{message}",
+			"trigger.fallback": "选择模型",
+			"trigger.selectAria": "选择模型",
+			"trigger.aria": "选择模型，当前 {model}",
+			"trigger.ariaEffort": "选择模型，当前 {model}，推理等级 {effort}",
+			"menu.aria": "模型与推理等级",
+			"menu.model": "模型",
+			"menu.effort": "推理等级",
+			"effort.providerDefault": "Default",
+			"status.loading": "正在刷新模型列表…",
+			"error.action": "模型操作失败：{message}",
+			"action.reload": "重新加载",
+			"warning.groupLoad": "{name} 加载失败：{message}",
+			"empty.models": "没有可用的模型。",
+			"blocked.composer": "当前模型不可用，请先选择模型",
+			"empty.efforts": "当前模型未提供推理等级。"
+		};
+		/** English dictionary, checked complete against the zh key set. */
+		const en = {
+			"command.description": "Select the model for this conversation",
+			"option.loadError": "Catalog failed to load: {message}",
+			"trigger.fallback": "Select model",
+			"trigger.selectAria": "Select model",
+			"trigger.aria": "Select model, current {model}",
+			"trigger.ariaEffort": "Select model, current {model}, reasoning effort {effort}",
+			"menu.aria": "Model and reasoning effort",
+			"menu.model": "Model",
+			"menu.effort": "Effort",
+			"effort.providerDefault": "Default",
+			"status.loading": "Refreshing model list…",
+			"error.action": "Model operation failed: {message}",
+			"action.reload": "Reload",
+			"warning.groupLoad": "{name} failed to load: {message}",
+			"empty.models": "No models available.",
+			"blocked.composer": "This model is unavailable — select one to continue",
+			"empty.efforts": "This model provides no reasoning effort levels."
+		};
+		//#endregion
+		//#region lib/types/client/index.js
+		/** One selectable row's id: an opaque row key (resolved by lookup, never parsed). */
+		function rowId(providerId, modelId) {
+			return `${providerId}/${modelId}`;
+		}
+		/** Flatten the directory into popup rows; failure rows are listed for visibility but never selectable. */
+		function optionsOf(directory, t) {
+			const rows = [];
+			for (const group of directory.groups) for (const model of group.models) rows.push({
+				id: rowId(group.id, model.id),
+				label: model.name,
+				detail: model.description !== void 0 ? `${group.name} · ${model.description}` : group.name,
+				...directory.current.provider === group.id && directory.current.model === model.id ? { active: true } : {}
+			});
+			for (const failure of directory.failures) rows.push({
+				id: `failure/${failure.id}`,
+				label: failure.name,
+				detail: t("option.loadError", { message: failure.message })
+			});
+			return rows;
+		}
+		/**
+		* Resolve a picked row back to its model selection by matching against the loaded
+		* groups (the same data the rows were built from — ids stay opaque).
+		* @param state - the session's directory snapshot.
+		* @param id - the picked row id.
+		* @returns the row's model selection, or undefined for failure rows / stale ids.
+		*/
+		function selectionOf(state, id) {
+			for (const group of state.groups) for (const model of group.models) {
+				if (rowId(group.id, model.id) !== id) continue;
+				const reasoningEffort = state.current?.provider === group.id && state.current.model === model.id ? state.current?.reasoningEffort ?? model.reasoning?.defaultEffort : void 0;
+				return {
+					provider: group.id,
+					model: model.id,
+					...reasoningEffort === void 0 ? {} : { reasoningEffort }
+				};
+			}
+		}
+		/** Dictionary namespace owned by this plugin. */
+		const NS = "model";
+		/** Required services: the contribution registry, the seat's slot registry, locale, and the service's own faces. */
+		const inject = [
+			"commandUi",
+			"connection",
+			"locale",
+			"sessions",
+			"slots",
+			"remote"
+		];
+		/**
+		* Client plugin body: mount ModelDirectoryResolver, register the `model` dictionaries,
+		* then register the /model popup contribution and the composer model seat
+		* over the service.
+		* @param ctx - client root context.
+		*/
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "ui-model-selection: dictionaries");
+			const t = ctx.locale.bind(NS);
+			ctx.plugin(ModelDirectoryResolver, { blockReason: () => t("blocked.composer") });
+			ctx.inject(["commandUi", "modelDirectories"], (scope) => {
+				const command = scope.get("commandUi");
+				const models = scope.modelDirectories;
+				const sessions = scope.sessions;
+				scope.effect(() => command.register({
+					name: "model",
+					description: t("command.description"),
+					available: (session) => sessions.subagentAddress(session.sessionId) === void 0,
+					ui: {
+						kind: "popupSelect",
+						options: async (session) => {
+							if (sessions.subagentAddress(session.sessionId) !== void 0) throw new Error("model selection is unavailable for addressed subagent sessions");
+							return optionsOf(await models.directoryFor(session.sessionId).load(), t);
+						},
+						onSelect: async (option, session) => {
+							if (sessions.subagentAddress(session.sessionId) !== void 0) throw new Error("model selection is unavailable for addressed subagent sessions");
+							const directory = models.directoryFor(session.sessionId);
+							const selection = selectionOf(directory.store.getSnapshot(), option.id);
+							if (selection === void 0) throw new Error("this provider's catalog failed to load — pick a model from a loaded group");
+							await directory.select(selection);
+						}
+					}
+				}), "ui-model-selection: /model contribution");
+			});
+			ctx.inject(["slots", "modelDirectories"], (scope) => {
+				const models = scope.modelDirectories;
+				const sessions = scope.sessions;
+				scope.slots.inject("conversation.input.model", () => scope.slots.register({
+					name: "conversation.input.model",
+					locale: NS,
+					inject: (sessionId) => {
+						const directory = models.directoryFor(sessionId);
+						const available = sessions.subagentAddress(sessionId) === void 0;
+						return {
+							available,
+							directory: directory.store,
+							load: () => {
+								if (available) directory.load().catch(() => {});
+							},
+							select: (selection) => available ? directory.select(selection).then(() => true, () => false) : Promise.resolve(false)
+						};
+					}
+				}, ModelSelect));
+			});
+		}
+		//#endregion
+		exports.ModelDirectory = ModelDirectory;
+		exports.ModelDirectoryResolver = ModelDirectoryResolver;
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index.js

@@ -0,0 +1,11 @@
+//#region lib/types/index.js
+/**
+* Model selection plugin, node half. Pure UI plugin: the empty apply exists
+* so the plugin appears in the host cordis.yml / Loader; the browser half
+* ships via exports["./client"], discovered through the package.json
+* dsh.client declaration.
+*/
+/** Host plugin body — no host-side behavior for this surface plugin. */
+function apply() {}
+//#endregion
+export { apply };

package/lib/invariant.js

@@ -0,0 +1,24 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-model-selection`.
+* @module @deepseek-ai/dsh-client-ui-model-selection/invariant
+*/
+const PACKAGE_NAME = "@deepseek-ai/dsh-client-ui-model-selection";
+/** Cordis companion plugin name. */
+const name = "client-ui-model-selection-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: a single command contribution registration whose disposal is
+* proven by the HMR-safety spec — it emits no cordis events and owns no
+* cross-plugin mutable state.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

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

@@ -0,0 +1,12 @@
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ModelSelectInjected } from './slots.ts';
+/**
+ * Render the composer model seat.
+ * @param props - owner share (locked) + injected face (shared directory
+ * store/verbs) + the standard locale seat.
+ * @returns the trigger and, while open, the two-level menu.
+ */
+export declare function ModelSelect({ locked, available, directory, load, select, t }: ModelSelectInjected & {
+    locked: boolean;
+} & PropsLocale<'model'>): import("react").JSX.Element | null;
+//# sourceMappingURL=ModelSelect.d.ts.map

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

@@ -0,0 +1,70 @@
+/**
+ * Per-session model directory: the ONE state both selection entries share.
+ * The /model popup and the composer-seat selector load through the same
+ * controller and submit through the same selectModel call, so the host stays
+ * the single fact source and the store is one shared echo — a switch made in
+ * either entry is what the other shows next.
+ */
+import type { IApiClient, ModelCatalogFailure, ModelProviderGroup, ModelSelection, SessionId, SessionModels } from '@deepseek-ai/dsh-api-remotes/client';
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+/** Directory snapshot both entries render from. */
+export interface ModelDirectoryState {
+    /** Model selection the host reports for the next assembled step; null before the first load. */
+    current: ModelSelection | null;
+    /**
+     * Whether an adapter serves the current selection's provider, as the host reports
+     * it — null before the first load, which is NOT the same as blocked. Read
+     * this rather than "current matches no group": catalog membership is
+     * advisory, so a route serving a model it stopped advertising is missing
+     * from the groups yet perfectly usable.
+     */
+    routable: boolean | null;
+    /** Successfully loaded provider groups (last good load). */
+    groups: readonly ModelProviderGroup[];
+    /** Provider-local failures from the last load; usable groups stay usable. */
+    failures: readonly ModelCatalogFailure[];
+    /** Lifecycle of the in-flight operation. */
+    status: 'idle' | 'loading' | 'ready' | 'selecting' | 'error';
+    /** Whole-request or selection failure text; null when none. */
+    error: string | null;
+}
+/** One session's shared directory controller; disposed with the session scope. */
+export declare class ModelDirectory {
+    private readonly sessions;
+    private readonly sessionId;
+    private readonly available;
+    /** The shared snapshot both entries render from (uSES-safe store). */
+    readonly store: SnapshotStore<ModelDirectoryState>;
+    /** Latest operation wins; an older response never overwrites a newer one. */
+    private generation;
+    private disposed;
+    /**
+     * @param sessions - the session wire face (captured from the plugin's root connection).
+     * @param sessionId - the owning session.
+     * @param available - whether this session may use Agent-bound model RPCs.
+     */
+    constructor(sessions: Pick<IApiClient['sessions'], 'models' | 'selectModel'>, sessionId: SessionId, available: () => boolean);
+    /**
+     * Refresh the advisory directory (both entries call this on open).
+     * Failure preserves the last good groups and current selection.
+     * @returns the fresh directory value.
+     */
+    load(): Promise<SessionModels>;
+    /**
+     * Select the complete provider/model/reasoning selection (both entries submit through here). Success
+     * updates the shared current; failure surfaces on the store and throws so
+     * each entry's own retry surface engages.
+     * @param selection - provider, provider-owned model id, and optional adapter-owned effort.
+   */
+    select(selection: ModelSelection): Promise<void>;
+    /**
+     * Drop the previous Host generation's projection and repull it. Clearing
+     * first prevents an unconsumed process-local selection from being displayed
+     * while the restarted Host has restored the last logged model selection.
+     */
+    resetConnected(): void;
+    /** Scope teardown: late settlements lose write access to the store. */
+    dispose(): void;
+    private assertAvailable;
+}
+//# sourceMappingURL=directory.d.ts.map

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

@@ -0,0 +1,23 @@
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type ModelKey } from './locales.ts';
+export { ModelDirectory } from './directory.ts';
+export type { ModelDirectoryState } from './directory.ts';
+export { ModelDirectoryResolver } from './service.ts';
+export type { ModelSelectInjected } from './slots.ts';
+export type { ModelKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The model selection surfaces' copy (/model popup + composer seat). */
+        model: ModelKey;
+    }
+}
+/** Required services: the contribution registry, the seat's slot registry, locale, and the service's own faces. */
+export declare const inject: string[];
+/**
+ * Client plugin body: mount ModelDirectoryResolver, register the `model` dictionaries,
+ * then register the /model popup contribution and the composer model seat
+ * over the service.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,52 @@
+/**
+ * `model` namespace dictionaries.
+ *
+ * `trigger.selectAria` reads identically to `trigger.fallback` today and is
+ * still a separate key: the visible fallback label and the accessible name of
+ * an unset trigger are free to diverge per locale, and folding it into
+ * `trigger.aria` would announce the degenerate "Select model, current Select
+ * model".
+ */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'command.description': string;
+    'option.loadError': string;
+    'trigger.fallback': string;
+    'trigger.selectAria': string;
+    'trigger.aria': string;
+    'trigger.ariaEffort': string;
+    'menu.aria': string;
+    'menu.model': string;
+    'menu.effort': string;
+    'effort.providerDefault': string;
+    'status.loading': string;
+    'error.action': string;
+    'action.reload': string;
+    'warning.groupLoad': string;
+    'empty.models': string;
+    'blocked.composer': string;
+    'empty.efforts': string;
+};
+/** The model namespace key union. */
+export type ModelKey = keyof typeof zh;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'command.description': string;
+    'option.loadError': string;
+    'trigger.fallback': string;
+    'trigger.selectAria': string;
+    'trigger.aria': string;
+    'trigger.ariaEffort': string;
+    'menu.aria': string;
+    'menu.model': string;
+    'menu.effort': string;
+    'effort.providerDefault': string;
+    'status.loading': string;
+    'error.action': string;
+    'action.reload': string;
+    'warning.groupLoad': string;
+    'empty.models': string;
+    'blocked.composer': string;
+    'empty.efforts': string;
+};
+//# sourceMappingURL=locales.d.ts.map

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

@@ -0,0 +1,45 @@
+/**
+ * ModelDirectoryResolver (`ctx.modelDirectories`): the root owner of per-session
+ * {@link ModelDirectory} instances. Both selection entries (the /model popup
+ * and the composer model seat) resolve their session's directory through
+ * this service, which is what makes the dual entry one shared state.
+ *
+ * Per-session storage follows the client service pattern (InputTriggerService /
+ * CommandUiRuntime): a lazy service-internal map whose entry is deleted by the
+ * owning scope's disposer. The host `dsh-scope` ScopedLayers registry does
+ * does not belong here: it derives scope from the host carrier mechanism
+ * (object-keyed), while client scopes tag contexts with branded SessionId
+ * strings, and it models global+shadow named registries — this is a
+ * per-session singleton with no global layer to merge.
+ */
+import { Service } from '@deepseek-ai/cordis';
+import type { Context } from '@deepseek-ai/cordis';
+import type { SessionId } from '@deepseek-ai/dsh-api-remotes/client';
+import { ModelDirectory } from './directory.ts';
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        modelDirectories: ModelDirectoryResolver;
+    }
+}
+/** The `ctx.modelDirectories` session model-selection service. */
+export declare class ModelDirectoryResolver extends Service {
+    static inject: string[];
+    private readonly live;
+    /** Localized composer-block copy; this plugin owns the string it raises. */
+    private readonly blockReason;
+    /**
+     * @param ctx - owning root context (the service registers itself as `models`).
+     * @param config - the bound translator for this plugin's own dictionary.
+     */
+    constructor(ctx: Context, config: {
+        blockReason: () => string;
+    });
+    /**
+     * Resolve the per-session shared directory (lazy; the scope disposer
+     * removes and disposes it). Unknown sessions fail loud.
+     * @param sessionId - the owning session.
+     * @returns the resident directory both entries share.
+     */
+    directoryFor(sessionId: SessionId): ModelDirectory;
+}
+//# sourceMappingURL=service.d.ts.map

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

@@ -0,0 +1,25 @@
+/**
+ * ModelSelect's injected face. The target 'conversation.input.model' seat is
+ * declared (children table) and typed by ui-conversation's composer-bar
+ * entry; this package only contributes the single occupant, so no SlotMap
+ * merge lives here.
+ */
+import type { ModelSelection } from '@deepseek-ai/dsh-api-remotes/client';
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+import type { ModelDirectoryState } from './directory.ts';
+/** Injected business face of the composer model seat. */
+export interface ModelSelectInjected {
+    /** Whether this session supports Agent-bound model inspection and selection. */
+    available: boolean;
+    /** The session's shared directory store (same instance the /model popup reads). */
+    directory: SnapshotStore<ModelDirectoryState>;
+    /** Refresh the advisory directory (fire-and-forget; errors land on the store). */
+    load: () => void;
+    /**
+     * Select a complete provider/model/reasoning selection.
+     * @param selection - model selection and optional adapter-owned effort.
+     * @returns whether the host accepted the selection.
+     */
+    select: (selection: ModelSelection) => Promise<boolean>;
+}
+//# sourceMappingURL=slots.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Model selection plugin, node half. Pure UI plugin: the empty apply exists
+ * so the plugin appears in the host cordis.yml / Loader; the browser half
+ * ships via exports["./client"], discovered through the package.json
+ * dsh.client declaration.
+ */
+/** Host plugin body — no host-side behavior for this surface plugin. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-model-selection`.
+ * @module @deepseek-ai/dsh-client-ui-model-selection/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-model-selection-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@crazx/dsh-client-ui-model-selection",
+  "description": "Model selection: the /model popupSelect over session.models / session.selectModel",
+  "version": "0.1.0-rc.7.zw.2",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aka-danielZhang/deepseek-harness.git",
+    "directory": "packages/client/ui-model-selection"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-commands",
+        "@deepseek-ai/dsh-api-remotes"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/dsh-api-remotes": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-commands": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-input-trigger": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.7",
+    "clsx": "^2.1.1",
+    "@deepseek-ai/cordis": "^0.1.0-rc.7",
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-api-remotes": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-commands": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-input-trigger": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.7",
+    "@types/react": "~18.3.1",
+    "clsx": "^2.1.1",
+    "@deepseek-ai/cordis": "^0.1.0-rc.7",
+    "react": "^18.2.0"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}