@deepseek-ai/dsh-client-ui-commands 0.1.2-rc.1 → 0.1.5-alpha.1

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # 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-commands/README.md
-README.md: b27c795eaf9a7954925961bde81872307b9f3d97
-README.zh.md: 65d31d0f390fce0ea341bf3391903539d3e0d0f7
+README.md: e1264d10bd8ff807d8f348339e0c055607579407
+README.zh.md: c5323149aea1e38ff09262db9bd2aacad7b284ea

package/README.md

@@ -31,9 +31,9 @@ Mount this plugin alongside `ui-input-trigger` and `ui-conversation`; the `/` so
 
 A contribution is a client-owned command — a host-name collision fails loud. A decoration adds a bare-invocation popup to an EXISTING host command: the host command keeps its catalog row, its argument claim, and its lifecycle logging, and a decorated name with no host row in the session's directory never fires. Menu queries fuzzy-match ordered, case-insensitive subsequences of command names; prefixes rank first.
 
-### Image-carrying submissions
+### Attachment-carrying submissions
 
-When the composer submits with image attachments, only a host command declaring `input.images` proceeds; every other command route throws the localized `imagesUnsupported` refusal, which renders as a transient toast while the draft and images stay in place — a command can never consume the text and strand the images.
+When the composer submits with images or generic files, only a host command declaring `input.attachments` proceeds. Every other command route throws the localized `attachmentsUnsupported` refusal, rendered as a transient toast while the draft and attachment cards stay in place. Handler errors preserve the same draft state for retry.
 
 -----
 
@@ -43,7 +43,7 @@ When the composer submits with image attachments, only a host command declaring
 <details>
 <summary>Implementation internals — click to expand</summary>
 
-`src/client/contract.ts` is the fixed business contract: `CommandUiContract.register(name, spec)` and `decorate(name, spec)` are everything a business package consumes. `CommandDirectory` is the one wire-derived cache, keyed by session: ordinary sessions fetch through `command.list({sessionId})`, entries are soft-invalidated by the forwarded `commands/change` owner event and hard-invalidated by `connection/reset`, and epoch-guarded so a superseded pull can never overwrite a newer one. `matchSpace` answers synchronously from this cache only; `matchEnter` strong-waits it on the SubmitAttempt signal and rejects on warmup failure. After `command.execute` returns a matched result, the browser emits a local `command/executed` acknowledgment; other clients receive the durable command nodes through the Host event stream but never this acknowledgment. `PopupSelectController` is the headless shell state; `PopupSelectView` self-registers into `conversation.input.overlay` with per-session resolution. Decision record: the [web command surfaces note](../../../.agents/notes/implemented/architecture/2026-07-25-web-command-surfaces-and-assembly.md); the [fuzzy discovery note](../../../.agents/notes/implemented/feature/2026-08-04-web-slash-command-fuzzy-discovery.md) covers menu ranking.
+`src/client/contract.ts` is the fixed business contract: `CommandUiContract.register(name, spec)` and `decorate(name, spec)` are everything a business package consumes. `CommandDirectory` is the one wire-derived cache, keyed by session: ordinary sessions fetch through `command.list({sessionId})`, entries are soft-invalidated by the forwarded `commands/change` owner event and hard-invalidated by `connection/reset`, and epoch-guarded so a superseded pull can never overwrite a newer one. `matchSpace` answers synchronously from this cache only; `matchEnter` strong-waits it on the SubmitAttempt signal and rejects on warmup failure. After `command.execute` returns a matched result, the browser emits a local `command/executed` acknowledgment; other clients receive the durable command nodes through the Host event stream but never this acknowledgment. `PopupSelectController` is the headless shell state; `PopupSelectView` self-registers into `conversation.input.overlay` with per-session resolution.
 
 </details>
 
@@ -56,8 +56,6 @@ Read these pages when the command surface is not enough. They move from the comm
 
 - [ui-input-trigger](../ui-input-trigger/README.md) — the pipeline the `/` source registers into.
 - [ui-conversation](../ui-conversation/README.md) — declares the input overlay slot and owns the composer.
-- [Web command surfaces and assembly](../../../.agents/notes/implemented/architecture/2026-07-25-web-command-surfaces-and-assembly.md) — the design decision behind the command surfaces.
-- [Web slash-command fuzzy discovery](../../../.agents/notes/implemented/feature/2026-08-04-web-slash-command-fuzzy-discovery.md) — the menu ranking rationale.
 - [Client package map](../README.md) — adjacent browser UI packages.
 
 -----

package/README.zh.md

@@ -31,9 +31,9 @@ kind: "package-reference"
 
 贡献项是客户端自有命令——与宿主命令同名会明确报错。装饰为**已存在的**宿主命令添加裸调用弹窗：宿主命令保留其目录行、参数声明与生命周期记账，被装饰的名字在会话目录中无宿主行时永不触发。菜单查询按顺序且不区分大小写地模糊匹配命令名的子序列；前缀排名最高。
 
-### 带图提交
+### 带附件提交
 
-composer 携带图片附件提交时，只有声明了 `input.images` 的宿主命令继续；其余每条命令路径都会抛出本地化的 `imagesUnsupported` 拒绝，以瞬态 toast 呈现，草稿与图片保持原位——命令绝不消费文本却抛下图片。
+composer 携带图片或通用文件提交时，只有声明了 `input.attachments` 的宿主命令继续。其余命令路径都会抛出本地化的 `attachmentsUnsupported` 拒绝，以瞬态 toast 呈现，草稿与附件卡保持原位。处理器返回错误时保留相同草稿状态供用户重试。
 
 -----
 
@@ -43,7 +43,7 @@ composer 携带图片附件提交时，只有声明了 `input.images` 的宿主
 <details>
 <summary>实现细节——点击展开</summary>
 
-`src/client/contract.ts` 是固定的业务约定：`CommandUiContract.register(name, spec)` 与 `decorate(name, spec)` 是业务包消费的全部内容。`CommandDirectory` 是唯一的 wire 派生缓存，以会话为 key：普通会话经 `command.list({sessionId})` 拉取；条目由转发的 `commands/change` owner 事件软失效、由 `connection/reset` 硬失效，并以 epoch 把关，被取代的旧拉取永远无法覆盖更新的结果。`matchSpace` 只凭该缓存同步应答；`matchEnter` 在 SubmitAttempt 信号上强等缓存，预热失败即拒绝。`command.execute` 返回匹配结果后，浏览器发布本地 `command/executed` 确认；其他客户端经宿主事件流收到持久命令节点，但收不到这条确认。`PopupSelectController` 是不含界面的外壳状态；`PopupSelectView` 自注册进 `conversation.input.overlay`，按会话解析。决策记录：[Web 命令表面笔记](../../../.agents/notes/implemented/architecture/2026-07-25-web-command-surfaces-and-assembly.zh.md)；[模糊发现笔记](../../../.agents/notes/implemented/feature/2026-08-04-web-slash-command-fuzzy-discovery.zh.md) 说明菜单排名。
+`src/client/contract.ts` 是固定的业务约定：`CommandUiContract.register(name, spec)` 与 `decorate(name, spec)` 是业务包消费的全部内容。`CommandDirectory` 是唯一的 wire 派生缓存，以会话为 key：普通会话经 `command.list({sessionId})` 拉取；条目由转发的 `commands/change` owner 事件软失效、由 `connection/reset` 硬失效，并以 epoch 把关，被取代的旧拉取永远无法覆盖更新的结果。`matchSpace` 只凭该缓存同步应答；`matchEnter` 在 SubmitAttempt 信号上强等缓存，预热失败即拒绝。`command.execute` 返回匹配结果后，浏览器发布本地 `command/executed` 确认；其他客户端经宿主事件流收到持久命令节点，但收不到这条确认。`PopupSelectController` 是不含界面的外壳状态；`PopupSelectView` 自注册进 `conversation.input.overlay`，按会话解析。
 
 </details>
 
@@ -56,8 +56,6 @@ composer 携带图片附件提交时，只有声明了 `input.images` 的宿主
 
 - [ui-input-trigger](../ui-input-trigger/README.zh.md)——`/` source 注册进的流水线。
 - [ui-conversation](../ui-conversation/README.zh.md)——声明输入浮层槽位并拥有 composer。
-- [Web 命令表面与组装](../../../.agents/notes/implemented/architecture/2026-07-25-web-command-surfaces-and-assembly.zh.md)——命令表面背后的设计决策。
-- [Web 斜杠命令模糊发现](../../../.agents/notes/implemented/feature/2026-08-04-web-slash-command-fuzzy-discovery.zh.md)——菜单排名的原理。
 - [客户端包映射](../README.zh.md)——相邻的浏览器 UI 包。
 
 -----

package/lib/client.js

@@ -5,10 +5,10 @@ window.__ModuleLoader__.load({
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 		let _deepseek_ai_cordis = require("@deepseek-ai/cordis");
+		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 		let _deepseek_ai_dsh_client_store = require("@deepseek-ai/dsh-client-store");
 		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 key's cache cell. */
 		var Entry = class {
@@ -159,6 +159,43 @@ window.__ModuleLoader__.load({
 			return signal.reason instanceof Error ? signal.reason : /* @__PURE__ */ new Error("command directory wait aborted");
 		}
 		//#endregion
+		//#region lib/types/client/locales.js
+		/** `command` namespace dictionaries (the popupSelect shell's copy). */
+		/** Simplified Chinese dictionary (the key-set source of truth). */
+		const zh = {
+			"description.compact": "压缩以上对话内容",
+			"description.export": "将当前会话内容导出为 ZIP",
+			"description.feedback": "发送关于当前会话的反馈",
+			"description.goal": "设置或查看长期任务目标",
+			"description.permission": "切换权限预设（沙箱模式与审批策略）",
+			"description.plan": "进入或退出计划模式",
+			"search.placeholder": "搜索…",
+			"search.aria": "筛选选项",
+			"status.loading": "正在加载选项…",
+			"status.applying": "正在应用…",
+			"status.empty": "无选项",
+			"overlay.aria": "/{command} 选项",
+			"listbox.aria": "/{command} 匹配项",
+			"notice.attachmentsUnsupported": "/{command} 不接受附件，请先移除附件"
+		};
+		/** English dictionary, checked complete against the zh key set. */
+		const en = {
+			"description.compact": "Compact older conversation history",
+			"description.export": "Download this Session log as a ZIP archive",
+			"description.feedback": "record feedback about this session",
+			"description.goal": "set or view the goal for a long-running task",
+			"description.permission": "Switch the permission preset (sandbox mode + approval policy)",
+			"description.plan": "Enter or leave plan mode",
+			"search.placeholder": "Search…",
+			"search.aria": "Filter options",
+			"status.loading": "Loading options…",
+			"status.applying": "Applying…",
+			"status.empty": "No options",
+			"overlay.aria": "/{command} options",
+			"listbox.aria": "/{command} matches",
+			"notice.attachmentsUnsupported": "/{command} does not accept attachments; remove them first"
+		};
+		//#endregion
 		//#region lib/types/client/popup.js
 		/**
 		* Headless popupSelect shell state: one controller per client
@@ -432,8 +469,9 @@ window.__ModuleLoader__.load({
 		* CommandUiRuntime (`ctx.commandUi`): the '/' command source over the
 		* session-keyed directory, the client-contribution registry, and the
 		* per-session popupSelect controllers. Candidate synthesis merges the host
-		* catalog with contributions by availability, then fuzzy query/position
-		* filtering; a host/contribution name collision fails loud. Every execute
+		* catalog with contributions by availability, then position filtering and
+		* the `/` menu's shared name ranking (ui-primitives `rankByName`); a
+		* host/contribution name collision fails loud. Every execute
 		* addresses the session's agent by sessionId — sessions are always
 		* agent-backed.
 		*/
@@ -443,60 +481,15 @@ window.__ModuleLoader__.load({
 			const separator = trimmed.search(/\s/u);
 			return (separator === -1 ? trimmed : trimmed.slice(0, separator)).slice(1);
 		}
-		/** Extra weight for command-name starts and separator boundaries. */
-		function boundaryBonus(name, index) {
-			return index === 0 || name.charAt(index - 1) === "-" || name.charAt(index - 1) === "_" ? 8 : 0;
-		}
-		/**
-		* Score the strongest ordered-subsequence alignment in O(name × query).
-		* Boundary and adjacent matches earn weight; skipped and leading characters
-		* cost weight.
-		*/
-		function fuzzyScore(name, query) {
-			if (query === "") return 0;
-			if (query.length > name.length) return void 0;
-			const noMatch = Number.NEGATIVE_INFINITY;
-			let previous = Array(name.length).fill(noMatch);
-			for (let index = 0; index < name.length; index++) if (name.charAt(index) === query.charAt(0)) previous[index] = 1 + boundaryBonus(name, index) - index;
-			for (let queryIndex = 1; queryIndex < query.length; queryIndex++) {
-				const current = Array(name.length).fill(noMatch);
-				let bestGapped = noMatch;
-				for (let index = 0; index < name.length; index++) {
-					const gappedIndex = index - 2;
-					if (gappedIndex >= 0) {
-						const prior = previous[gappedIndex] ?? noMatch;
-						if (prior !== noMatch) bestGapped = Math.max(bestGapped, prior + gappedIndex);
-					}
-					if (name.charAt(index) !== query.charAt(queryIndex)) continue;
-					const bonus = 1 + boundaryBonus(name, index);
-					const adjacent = index > 0 ? previous[index - 1] ?? noMatch : noMatch;
-					if (adjacent !== noMatch) current[index] = adjacent + bonus + 4;
-					if (bestGapped !== noMatch) current[index] = Math.max(current[index] ?? noMatch, bestGapped + bonus + 1 - index);
-				}
-				previous = current;
-			}
-			let best = noMatch;
-			for (const score of previous) best = Math.max(best, score);
-			return best === noMatch ? void 0 : best;
-		}
-		/** Case-insensitive fuzzy filtering with stable ordering for equal matches. */
-		function fuzzyCandidates(candidates, rawQuery) {
-			const query = rawQuery.toLowerCase();
-			if (query === "") return candidates;
-			const ranked = [];
-			candidates.forEach((candidate, index) => {
-				const name = candidate.name.toLowerCase();
-				const score = fuzzyScore(name, query);
-				if (score !== void 0) ranked.push({
-					candidate,
-					index,
-					prefix: name.startsWith(query),
-					score
-				});
-			});
-			ranked.sort((left, right) => Number(right.prefix) - Number(left.prefix) || right.score - left.score || left.index - right.index);
-			return ranked.map((match) => match.candidate);
-		}
+		/** Locale keys for the canonical first-party Host command descriptions. */
+		const HOST_DESCRIPTION_KEYS = new Map([
+			["compact", "description.compact"],
+			["export", "description.export"],
+			["feedback", "description.feedback"],
+			["goal", "description.goal"],
+			["permission", "description.permission"],
+			["plan", "description.plan"]
+		]);
 		/** Command surface: session-keyed directory + '/' source + contribution registry + per-session popups. */
 		var CommandUiRuntime = class extends _deepseek_ai_cordis.Service {
 			static inject = [
@@ -637,7 +630,7 @@ window.__ModuleLoader__.load({
 					if (this.focusHooks.get(id) === focus) this.focusHooks.delete(id);
 				};
 			}
-			/** Menu candidates: host catalog + contribution availability, then position filtering and fuzzy name ranking. */
+			/** Menu candidates: host catalog + contribution availability, then position filtering and the shared name ranking. */
 			async candidates(session, req) {
 				const list = await this.directory.ensureReady(session.sessionId, req.signal);
 				const rows = [];
@@ -646,7 +639,7 @@ window.__ModuleLoader__.load({
 					seen.add(c.name);
 					rows.push({
 						name: c.name,
-						description: c.description,
+						description: this.hostDescription(c),
 						...c.input !== void 0 ? { hint: c.input.hint } : {}
 					});
 				}
@@ -655,10 +648,15 @@ window.__ModuleLoader__.load({
 					if (seen.has(contribution.name)) throw new Error(`ui-commands: contribution /${contribution.name} collides with a host command`);
 					rows.push({
 						name: contribution.name,
-						description: contribution.description
+						description: contribution.description()
 					});
 				}
-				return fuzzyCandidates(rows.filter((c) => req.position === "leading" || c.hint === void 0), req.query);
+				return (0, _deepseek_ai_dsh_client_ui_primitives.rankByName)(rows.filter((c) => req.position === "leading" || c.hint === void 0), req.query);
+			}
+			/** Translate exact built-in Host copy while preserving scoped or third-party descriptors verbatim. */
+			hostDescription(command) {
+				const key = HOST_DESCRIPTION_KEYS.get(command.name);
+				return key !== void 0 && command.description === en[key] ? this.t(key) : command.description;
 			}
 			/** Decision table, menu column: contribution/decorated-host → popup; host input → claim; host bare → detached execute. */
 			dispatch(pick) {
@@ -704,10 +702,10 @@ window.__ModuleLoader__.load({
 			* bare host commands act on the bare token only; leadingInput claims
 			* args-tolerant.
 			*
-			* Envelope policy: an enter submission carrying images resolves only
-			* through a command declaring image acceptance. Every other command route —
+			* Envelope policy: an enter submission carrying attachments resolves only
+			* through a command declaring attachment acceptance. Every other command route —
 			* popup, non-accepting claim, bare detached execute — throws the refusal
-			* so the machine surfaces one composer notice and the draft and images
+			* so the machine surfaces one composer notice and the draft and attachments
 			* stay in place; nothing executes and nothing is dropped.
 			*/
 			async matchEnter(session, line, signal, envelope) {
@@ -718,13 +716,13 @@ window.__ModuleLoader__.load({
 				const bare = ws === -1;
 				const name = token.slice(1);
 				if (name === "") return void 0;
-				const refuseImages = () => {
-					throw new Error(this.t("notice.imagesUnsupported", { command: name }));
+				const refuseAttachments = () => {
+					throw new Error(this.t("notice.attachmentsUnsupported", { command: name }));
 				};
 				const contribution = this.live.contributions.get(name);
 				if (contribution !== void 0 && contribution.available(session)) {
 					if (!bare) return void 0;
-					if (envelope.images > 0) refuseImages();
+					if (envelope.attachments > 0) refuseAttachments();
 					this.openPopup(name, contribution.ui, session, {
 						via: "enter",
 						token
@@ -737,7 +735,7 @@ window.__ModuleLoader__.load({
 				if (bare) {
 					const decoration = this.live.decorations.get(name);
 					if (decoration !== void 0 && decoration.available(session)) {
-						if (envelope.images > 0) refuseImages();
+						if (envelope.attachments > 0) refuseAttachments();
 						this.openPopup(name, decoration.ui, session, {
 							via: "enter",
 							token
@@ -746,11 +744,11 @@ window.__ModuleLoader__.load({
 					}
 				}
 				if (desc.input !== void 0) {
-					if (envelope.images > 0 && desc.input.images !== true) refuseImages();
+					if (envelope.attachments > 0 && desc.input.attachments !== true) refuseAttachments();
 					return { claim: this.leadingClaim(desc, session) };
 				}
 				if (!bare) return void 0;
-				if (envelope.images > 0) refuseImages();
+				if (envelope.attachments > 0) refuseAttachments();
 				this.consumeVia(session.sessionId, {
 					via: "enter",
 					token
@@ -770,8 +768,8 @@ window.__ModuleLoader__.load({
 				return {
 					token,
 					...desc.input !== void 0 ? { hint: desc.input.hint } : {},
-					...desc.input?.images === true ? { images: true } : {},
-					submit: (args, _actx, images) => this.execute(session, token + args, images)
+					...desc.input?.attachments === true ? { attachments: true } : {},
+					submit: (args, _actx, attachments) => this.execute(session, token + args, attachments)
 				};
 			}
 			/**
@@ -782,18 +780,18 @@ window.__ModuleLoader__.load({
 			* executor durably logged the lifecycle (`command/run`/`command/done`) and
 			* the outcome renders as a persistent flow node — the composer never
 			* echoes it. A handler error result reports an error outcome so the
-			* composer keeps the submission (draft and images) for correction.
+			* composer keeps the draft and attachments for correction.
 			* A refused call throws.
 			*/
-			async execute(session, line, images = []) {
-				const result = await this.ctx.remote.commands.execute(session.sessionId, line, images);
+			async execute(session, line, attachments = []) {
+				const result = await this.ctx.remote.commands.execute(session.sessionId, line, attachments);
 				if (!result.ok) throw new Error(`command.execute failed: ${result.error.code}: ${result.error.message}`);
 				if (result.value === void 0) return {
 					kind: "error",
 					text: `unknown or malformed command: ${line}`
 				};
 				this.notifyExecuted(session.sessionId, submittedCommandName(line), result.value.result);
-				if (images.length > 0 && result.value.result.kind === "error") return {
+				if (attachments.length > 0 && result.value.result.kind === "error") return {
 					kind: "error",
 					text: result.value.result.text
 				};
@@ -1076,31 +1074,6 @@ window.__ModuleLoader__.load({
 			})] });
 		}
 		//#endregion
-		//#region lib/types/client/locales.js
-		/** `command` namespace dictionaries (the popupSelect shell's copy). */
-		/** Simplified Chinese dictionary (the key-set source of truth). */
-		const zh = {
-			"search.placeholder": "搜索…",
-			"search.aria": "筛选选项",
-			"status.loading": "正在加载选项…",
-			"status.applying": "正在应用…",
-			"status.empty": "无选项",
-			"overlay.aria": "/{command} 选项",
-			"listbox.aria": "/{command} 匹配项",
-			"notice.imagesUnsupported": "/{command} 不接受图片附件，请先移除图片"
-		};
-		/** English dictionary, checked complete against the zh key set. */
-		const en = {
-			"search.placeholder": "Search…",
-			"search.aria": "Filter options",
-			"status.loading": "Loading options…",
-			"status.applying": "Applying…",
-			"status.empty": "No options",
-			"overlay.aria": "/{command} options",
-			"listbox.aria": "/{command} matches",
-			"notice.imagesUnsupported": "/{command} does not accept image attachments; remove them first"
-		};
-		//#endregion
 		//#region lib/types/client/index.js
 		/** Dictionary namespace owned by this plugin. */
 		const NS = "command";

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

@@ -42,8 +42,8 @@ export type CommandUiSpec = {
 export interface CommandContribution {
     /** Command name without the leading slash (unique across contributions). */
     readonly name: string;
-    /** Menu row description. */
-    readonly description: string;
+    /** Resolve the localized menu row description when candidates are requested. */
+    readonly description: () => string;
     /** Capability filter, called with a fresh projection per candidate pass. */
     available(session: ClientSessionContext): boolean;
     /** The command's UI behavior (this phase: popupSelect only). */

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

@@ -1,6 +1,12 @@
 /** `command` namespace dictionaries (the popupSelect shell's copy). */
 /** Simplified Chinese dictionary (the key-set source of truth). */
 export declare const zh: {
+    'description.compact': string;
+    'description.export': string;
+    'description.feedback': string;
+    'description.goal': string;
+    'description.permission': string;
+    'description.plan': string;
     'search.placeholder': string;
     'search.aria': string;
     'status.loading': string;
@@ -8,12 +14,18 @@ export declare const zh: {
     'status.empty': string;
     'overlay.aria': string;
     'listbox.aria': string;
-    'notice.imagesUnsupported': string;
+    'notice.attachmentsUnsupported': string;
 };
 /** The command namespace key union. */
 export type CommandKey = keyof typeof zh;
 /** English dictionary, checked complete against the zh key set. */
 export declare const en: {
+    'description.compact': string;
+    'description.export': string;
+    'description.feedback': string;
+    'description.goal': string;
+    'description.permission': string;
+    'description.plan': string;
     'search.placeholder': string;
     'search.aria': string;
     'status.loading': string;
@@ -21,6 +33,6 @@ export declare const en: {
     'status.empty': string;
     'overlay.aria': string;
     'listbox.aria': string;
-    'notice.imagesUnsupported': string;
+    'notice.attachmentsUnsupported': string;
 };
 //# sourceMappingURL=locales.d.ts.map

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

@@ -2,8 +2,9 @@
  * CommandUiRuntime (`ctx.commandUi`): the '/' command source over the
  * session-keyed directory, the client-contribution registry, and the
  * per-session popupSelect controllers. Candidate synthesis merges the host
- * catalog with contributions by availability, then fuzzy query/position
- * filtering; a host/contribution name collision fails loud. Every execute
+ * catalog with contributions by availability, then position filtering and
+ * the `/` menu's shared name ranking (ui-primitives `rankByName`); a
+ * host/contribution name collision fails loud. Every execute
  * addresses the session's agent by sessionId — sessions are always
  * agent-backed.
  */
@@ -73,8 +74,10 @@ export declare class CommandUiRuntime extends Service implements CommandUiContra
      * @returns the unbind disposer.
      */
     bindComposerFocus(id: SessionId, focus: () => void): () => void;
-    /** Menu candidates: host catalog + contribution availability, then position filtering and fuzzy name ranking. */
+    /** Menu candidates: host catalog + contribution availability, then position filtering and the shared name ranking. */
     private candidates;
+    /** Translate exact built-in Host copy while preserving scoped or third-party descriptors verbatim. */
+    private hostDescription;
     /** Decision table, menu column: contribution/decorated-host → popup; host input → claim; host bare → detached execute. */
     private dispatch;
     /** Decision table, space column: hot-key sync check; only host leadingInput claims. */
@@ -85,10 +88,10 @@ export declare class CommandUiRuntime extends Service implements CommandUiContra
      * bare host commands act on the bare token only; leadingInput claims
      * args-tolerant.
      *
-     * Envelope policy: an enter submission carrying images resolves only
-     * through a command declaring image acceptance. Every other command route —
+     * Envelope policy: an enter submission carrying attachments resolves only
+     * through a command declaring attachment acceptance. Every other command route —
      * popup, non-accepting claim, bare detached execute — throws the refusal
-     * so the machine surfaces one composer notice and the draft and images
+     * so the machine surfaces one composer notice and the draft and attachments
      * stay in place; nothing executes and nothing is dropped.
      */
     private matchEnter;
@@ -104,7 +107,7 @@ export declare class CommandUiRuntime extends Service implements CommandUiContra
      * executor durably logged the lifecycle (`command/run`/`command/done`) and
      * the outcome renders as a persistent flow node — the composer never
      * echoes it. A handler error result reports an error outcome so the
-     * composer keeps the submission (draft and images) for correction.
+     * composer keeps the draft and attachments for correction.
      * A refused call throws.
      */
     private execute;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-commands",
   "description": "Client command surface: global directory cache, '/' source, three command UI kinds, popupSelect registry",
-  "version": "0.1.2-rc.1",
+  "version": "0.1.5-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -46,21 +46,21 @@
   "devDependencies": {
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-connection": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-input-trigger": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-commands": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-input-trigger": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-commands": "^0.1.5-alpha.1",
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-store": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-session": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.2-rc.1"
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.5-alpha.1"
   },
   "files": [
     "lib/index.js",