@deepseek-ai/dsh-client-ui-commands 0.1.3-alpha.2 → 0.1.5-alpha.2

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: e1264d10bd8ff807d8f348339e0c055607579407
-README.zh.md: c5323149aea1e38ff09262db9bd2aacad7b284ea
+README.md: c5f3c55c08a6df8e6c3f122d0c5e341721c2b41a
+README.zh.md: f728c03e067f74ba5142464adc17531225034aad

package/README.md

@@ -1,5 +1,5 @@
 ---
-description: "Client command API for the Web GUI: the / command source, three dispatch kinds, the per-session command directory, and popupSelect registration for business packages; for users and maintainers of slash commands."
+description: "Client command API for the Web GUI: the / command source, three dispatch kinds, the per-session command directory, and popupSelect and action registration for business packages; for users and maintainers of slash commands."
 kind: "package-reference"
 ---
 
@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-Typing a `/` command in the composer opens the matching surface — a registered popup, a host command's input, or a direct execution — and a command line is never silently downgraded to a plain prompt. Business packages contribute command surfaces through `ctx.commandUi`, registering a popupSelect spec (`/model`, `/permission`) or decorating an existing host command with a picker while the host keeps its catalog row and argument claim. Space and Enter resolve the line against the session's directory: a host descriptor with `input` is `leadingInput`, a registered `CommandUiSpec` is `popupSelect`, and everything else is `execute`.
+Typing a `/` command in the composer opens the matching surface — a registered popup, a host command's input, or a direct execution — and a command line is never silently downgraded to a plain prompt. Business packages contribute command surfaces through `ctx.commandUi`: a popupSelect spec (`/model`, `/permission`) or an action (`/feedback`), registered as a command or decorating an existing host command while the host keeps its catalog row and argument claim. Space and Enter resolve the line against the session's directory: a host descriptor with `input` is `leadingInput`, a registered `CommandUiSpec` is its kind, and everything else is `execute`.
 
 ## Table of Contents
 

package/README.zh.md

@@ -1,5 +1,5 @@
 ---
-description: "Web GUI 的客户端命令 API：/ 命令 source、三类派发、会话级命令目录，以及面向业务包的 popupSelect 注册；供斜杠命令的用户与维护者阅读。"
+description: "Web GUI 的客户端命令 API：/ 命令 source、三类派发、会话级命令目录，以及面向业务包的 popupSelect 与 action 注册；供斜杠命令的用户与维护者阅读。"
 kind: "package-reference"
 ---
 
@@ -9,7 +9,7 @@ kind: "package-reference"
 
 ## 概述
 
-在 composer 中键入 `/` 命令会打开匹配的表面——已注册的弹窗、宿主命令的输入或直接执行——命令行绝不会被静默降级为普通提示词。业务包经 `ctx.commandUi` 贡献命令表面：注册 popupSelect 贡献项（`/model`、`/permission`），或用选择器装饰既有宿主命令，宿主保留其目录行与参数声明。空格与回车对照会话目录解析命令行：带 `input` 的宿主描述符是 `leadingInput`，注册了 `CommandUiSpec` 的是 `popupSelect`，其余全部是 `execute`。
+在 composer 中键入 `/` 命令会打开匹配的表面——已注册的弹窗、宿主命令的输入或直接执行——命令行绝不会被静默降级为普通提示词。业务包经 `ctx.commandUi` 贡献命令表面：popupSelect 贡献项（`/model`、`/permission`）或 action（`/feedback`），既可注册为命令，也可装饰既有宿主命令，宿主保留其目录行与参数声明。空格与回车对照会话目录解析命令行：带 `input` 的宿主描述符是 `leadingInput`，注册了 `CommandUiSpec` 的按其种类派发，其余全部是 `execute`。
 
 ## 目录
 

package/lib/client.js

@@ -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
@@ -444,6 +481,15 @@ window.__ModuleLoader__.load({
 			const separator = trimmed.search(/\s/u);
 			return (separator === -1 ? trimmed : trimmed.slice(0, separator)).slice(1);
 		}
+		/** 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 = [
@@ -593,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 } : {}
 					});
 				}
@@ -602,17 +648,22 @@ 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 (0, _deepseek_ai_dsh_client_ui_primitives.rankByName)(rows.filter((c) => req.position === "leading" || c.hint === void 0), req.query);
 			}
-			/** Decision table, menu column: contribution/decorated-host → popup; host input → claim; host bare → detached execute. */
+			/** 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 or action; host input → claim; host bare → detached execute. */
 			dispatch(pick) {
 				const name = pick.candidate.name;
 				const contribution = this.live.contributions.get(name);
 				if (contribution !== void 0 && contribution.available(pick.session)) {
-					this.openPopup(name, contribution.ui, pick.session, {
+					this.invoke(name, contribution.ui, pick.session, {
 						via: "menu",
 						span: pick.span
 					});
@@ -622,7 +673,7 @@ window.__ModuleLoader__.load({
 				if (desc === void 0) return void 0;
 				const decoration = this.live.decorations.get(name);
 				if (decoration !== void 0 && decoration.available(pick.session)) {
-					this.openPopup(name, decoration.ui, pick.session, {
+					this.invoke(name, decoration.ui, pick.session, {
 						via: "menu",
 						span: pick.span
 					});
@@ -652,10 +703,11 @@ window.__ModuleLoader__.load({
 			* args-tolerant.
 			*
 			* 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 attachments
-			* stay in place; nothing executes and nothing is dropped.
+			* through a command declaring attachment acceptance. Every other submitting
+			* route — popup, non-accepting claim, bare detached execute — throws the
+			* refusal so the machine surfaces one composer notice and the draft and
+			* attachments stay in place; nothing executes and nothing is dropped. An
+			* action submits nothing and runs regardless.
 			*/
 			async matchEnter(session, line, signal, envelope) {
 				const trimmed = line.trim();
@@ -671,8 +723,8 @@ window.__ModuleLoader__.load({
 				const contribution = this.live.contributions.get(name);
 				if (contribution !== void 0 && contribution.available(session)) {
 					if (!bare) return void 0;
-					if (envelope.attachments > 0) refuseAttachments();
-					this.openPopup(name, contribution.ui, session, {
+					if (envelope.attachments > 0 && contribution.ui.kind !== "action") refuseAttachments();
+					this.invoke(name, contribution.ui, session, {
 						via: "enter",
 						token
 					});
@@ -684,8 +736,8 @@ window.__ModuleLoader__.load({
 				if (bare) {
 					const decoration = this.live.decorations.get(name);
 					if (decoration !== void 0 && decoration.available(session)) {
-						if (envelope.attachments > 0) refuseAttachments();
-						this.openPopup(name, decoration.ui, session, {
+						if (envelope.attachments > 0 && decoration.ui.kind !== "action") refuseAttachments();
+						this.invoke(name, decoration.ui, session, {
 							via: "enter",
 							token
 						});
@@ -705,8 +757,16 @@ window.__ModuleLoader__.load({
 				this.runDetached(desc, session, trimmed);
 				return "handled";
 			}
-			/** Open the session's popup for one contribution or decoration (menu pick / bare enter). */
-			openPopup(name, ui, session, segment) {
+			/**
+			* Invoke one contribution or decoration (menu pick / bare enter): open the
+			* session's popup, or consume the token and run the action.
+			*/
+			invoke(name, ui, session, segment) {
+				if (ui.kind === "action") {
+					this.consumeVia(session.sessionId, segment);
+					ui.run(session);
+					return;
+				}
 				const actx = this.scopeFor(session.sessionId);
 				if (actx === void 0) return;
 				this.popupFor(actx).open(name, ui, session, segment);
@@ -1023,31 +1083,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.attachmentsUnsupported": "/{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.attachmentsUnsupported": "/{command} does not accept 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

@@ -28,11 +28,27 @@ export interface SelectOption {
  * The shell component is owned by ui-commands; business never sees it. Both
  * callbacks receive the ClientSessionContext captured at popup open.
  */
-export type CommandUiSpec = {
+export interface PopupSelectSpec {
     readonly kind: 'popupSelect';
     options(session: ClientSessionContext, signal: AbortSignal): Promise<readonly SelectOption[]>;
     onSelect(option: SelectOption, session: ClientSessionContext): void | Promise<void>;
-};
+}
+/**
+ * Business registration for the action command kind: a bare invocation
+ * consumes the trigger token and runs one client-side callback (the Feedback
+ * row opens the feedback dialog). It submits nothing, so an
+ * attachment-carrying draft never refuses it.
+ */
+export interface ActionSpec {
+    readonly kind: 'action';
+    /**
+     * Run the action for one session.
+     * @param session - the ClientSessionContext captured at invocation.
+     */
+    run(session: ClientSessionContext): void;
+}
+/** The UI behavior of a contribution or decoration. */
+export type CommandUiSpec = PopupSelectSpec | ActionSpec;
 /**
  * One client-owned command contribution: a slash-menu entry whose behavior
  * lives entirely on the client (no host descriptor). Merged with the host
@@ -42,11 +58,11 @@ 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). */
+    /** The command's UI behavior. */
     readonly ui: CommandUiSpec;
 }
 /**
@@ -63,7 +79,7 @@ export interface CommandDecoration {
     readonly name: string;
     /** Capability filter, called with a fresh projection per bare invocation. */
     available(session: ClientSessionContext): boolean;
-    /** The bare-invocation UI (this phase: popupSelect only). */
+    /** The bare-invocation UI. */
     readonly ui: CommandUiSpec;
 }
 /** The `ctx.commandUi` service face visible to business packages. */

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

@@ -14,7 +14,7 @@ export type { CommandDescriptor, DirectoryStatus } from './directory.ts';
 export { filterOptions, PopupSelectController } from './popup.ts';
 export type { PopupSelectDeps, PopupSpec, PopupState, TokenSegment } from './popup.ts';
 export type { PopupSelectInjected, PopupSelectViewProps } from './PopupSelectView.tsx';
-export type { CommandContribution, CommandDecoration, CommandUiContract, CommandUiSpec, SelectConfirmation, SelectOption, } from './contract.ts';
+export type { ActionSpec, CommandContribution, CommandDecoration, CommandUiContract, CommandUiSpec, PopupSelectSpec, SelectConfirmation, SelectOption, } from './contract.ts';
 export type { CommandKey } from './locales.ts';
 declare module '@deepseek-ai/cordis' {
     interface Context {

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;
@@ -14,6 +20,12 @@ export declare const zh: {
 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;

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

@@ -76,7 +76,9 @@ export declare class CommandUiRuntime extends Service implements CommandUiContra
     bindComposerFocus(id: SessionId, focus: () => void): () => void;
     /** Menu candidates: host catalog + contribution availability, then position filtering and the shared name ranking. */
     private candidates;
-    /** Decision table, menu column: contribution/decorated-host → popup; host input → claim; host bare → detached execute. */
+    /** Translate exact built-in Host copy while preserving scoped or third-party descriptors verbatim. */
+    private hostDescription;
+    /** Decision table, menu column: contribution/decorated-host → popup or action; host input → claim; host bare → detached execute. */
     private dispatch;
     /** Decision table, space column: hot-key sync check; only host leadingInput claims. */
     private matchSpace;
@@ -87,14 +89,18 @@ export declare class CommandUiRuntime extends Service implements CommandUiContra
      * args-tolerant.
      *
      * 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 attachments
-     * stay in place; nothing executes and nothing is dropped.
+     * through a command declaring attachment acceptance. Every other submitting
+     * route — popup, non-accepting claim, bare detached execute — throws the
+     * refusal so the machine surfaces one composer notice and the draft and
+     * attachments stay in place; nothing executes and nothing is dropped. An
+     * action submits nothing and runs regardless.
      */
     private matchEnter;
-    /** Open the session's popup for one contribution or decoration (menu pick / bare enter). */
-    private openPopup;
+    /**
+     * Invoke one contribution or decoration (menu pick / bare enter): open the
+     * session's popup, or consume the token and run the action.
+     */
+    private invoke;
     /** Build the leadingInput claim: token `/name ` + the command.execute submit transaction. */
     private leadingClaim;
     /**

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.3-alpha.2",
+  "version": "0.1.5-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -37,30 +37,28 @@
     }
   },
   "license": "MIT",
-  "dependencies": {
-    "clsx": "^2.0.0"
-  },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-input-trigger": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.3-alpha.2",
+    "clsx": "^2.0.0",
+    "@deepseek-ai/dsh-client-connection": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-commands": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-alpha.2",
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-store": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-commands": "^0.1.3-alpha.2"
+    "@deepseek-ai/dsh-client-ui-input-trigger": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-store": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.5-alpha.2"
   },
   "files": [
     "lib/index.js",