@deepseek-ai/dsh-client-ui-commands 0.1.5-alpha.1 → 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

@@ -658,12 +658,12 @@ window.__ModuleLoader__.load({
 				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. */
+			/** 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
 					});
@@ -673,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
 					});
@@ -703,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();
@@ -722,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
 					});
@@ -735,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
 						});
@@ -756,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);

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
@@ -46,7 +62,7 @@ export interface CommandContribution {
     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/service.d.ts

@@ -78,7 +78,7 @@ export declare class CommandUiRuntime extends Service implements CommandUiContra
     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. */
+    /** 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;
@@ -89,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.5-alpha.1",
+  "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.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",
+    "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.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"
+    "@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",