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

package/lib/client.js

@@ -6,8 +6,277 @@ window.__ModuleLoader__.load({
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 		let react_jsx_runtime = require("react/jsx-runtime");
 		let react = require("react");
-		let react_dom = require("react-dom");
 		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");
+		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-message-feedback/src/client/FeedbackDialog.module.css.mjs
+		const css$1 = "._6_jNJa_dialog._6_jNJa_dialog{border-radius:18px;gap:38px;width:min(488px,100%)}._6_jNJa_categories{flex-wrap:wrap;gap:8px;margin-top:-14px;display:flex}._6_jNJa_chip{border:.5px solid var(--dsw-alias-border-l4);corner-shape:round;height:28px;color:var(--dsw-alias-label-primary);font:inherit;cursor:pointer;background:0 0;border-radius:14px;padding:0 12px;font-size:13px;line-height:18px;transition:background-color .12s,border-color .12s,color .12s}._6_jNJa_chip:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary)}._6_jNJa_chip:disabled{cursor:default;opacity:.4}._6_jNJa_chip:focus-visible{outline:2px solid var(--dsw-alias-button-primary-fill);outline-offset:2px}._6_jNJa_chipActive,._6_jNJa_chipActive:hover:not(:disabled){border-color:var(--dsw-alias-button-primary-fill);background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground)}._6_jNJa_detail{box-sizing:border-box;border:.5px solid var(--dsw-alias-border-l4);background:var(--dsw-alias-bg-layer-1);width:100%;min-height:116px;max-height:280px;color:var(--dsw-alias-label-primary);font:inherit;field-sizing:content;resize:none;border-radius:16px;margin-top:18px;padding:12px 14px;font-size:14px;line-height:22px;transition:border-color .12s,box-shadow .12s;display:block}._6_jNJa_detail::placeholder{color:var(--dsw-alias-label-caption)}._6_jNJa_detail:focus{border-color:var(--dsw-alias-border-l3);box-shadow:0 0 0 1px var(--dsw-alias-border-l3);outline:none}._6_jNJa_failure{color:var(--dsw-alias-label-tertiary);margin-top:8px;font-size:13px;line-height:20px;display:block}._6_jNJa_submit{border-radius:18px;width:100%;height:44px;font-size:14px;font-weight:500}._6_jNJa_toastIcon{border:1.5px solid var(--dsw-alias-state-success-primary);corner-shape:round;width:18px;height:18px;color:var(--dsw-alias-state-success-primary);border-radius:50%;place-items:center;display:grid}@media (prefers-reduced-motion:reduce){._6_jNJa_chip,._6_jNJa_detail{transition:none}}";
+		const tagId$1 = "@deepseek-ai/dsh-client-ui-message-feedback/FeedbackDialog.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$1) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@deepseek-ai/dsh-client-ui-message-feedback";
+			tag.dataset.pluginCss = tagId$1;
+			tag.textContent = css$1;
+			document.head.appendChild(tag);
+		}
+		var FeedbackDialog_module_css_default = {
+			"categories": "_6_jNJa_categories",
+			"chip": "_6_jNJa_chip",
+			"chipActive": "_6_jNJa_chipActive",
+			"detail": "_6_jNJa_detail",
+			"dialog": "_6_jNJa_dialog",
+			"failure": "_6_jNJa_failure",
+			"submit": "_6_jNJa_submit",
+			"toastIcon": "_6_jNJa_toastIcon"
+		};
+		//#endregion
+		//#region lib/types/client/FeedbackDialog.js
+		/**
+		* The feedback dialog and its acknowledgement toast, rendered as one entry
+		* of `conversation.input.overlay` so each Session owns exactly one of each.
+		* The Modal and the Toast both portal to `document.body`; the overlay slot
+		* only supplies the per-session controller and the composer card the toast
+		* centers over.
+		* @module @deepseek-ai/dsh-client-ui-message-feedback/client/FeedbackDialog
+		*/
+		const CATEGORIES = Object.keys({
+			"task-result": true,
+			"instruction-following": true,
+			"product-interaction": true,
+			"service-stability": true,
+			"resource-cost": true,
+			"security-privacy-permission": true,
+			"other": true
+		});
+		/** Failure codes with their own copy; every other code reads the generic line. */
+		const FAILURE_COPY = {
+			"version-conflict": "error.conflict",
+			"note-too-large": "error.noteTooLarge"
+		};
+		/**
+		* Render one Session's feedback dialog and toast.
+		* @param props - the dialog hook, the draft verbs, and the locale seat.
+		* @returns the modal while a target is open, the toast while one is showing.
+		*/
+		function FeedbackDialog({ useDialog, edit, submit, dismiss, dismissToast, t }) {
+			const state = useDialog((s) => s);
+			const probeRef = (0, react.useRef)(null);
+			const [card, setCard] = (0, react.useState)(null);
+			(0, react.useLayoutEffect)(() => {
+				setCard(probeRef.current?.closest("[data-composer-card]") ?? null);
+			}, []);
+			const toast = state.toast;
+			const onToastDone = (0, react.useCallback)(() => {
+				dismissToast(toast);
+			}, [dismissToast, toast]);
+			(0, react.useEffect)(() => () => {
+				dismissToast(toast);
+			}, [dismissToast, toast]);
+			const failure = state.failure === null ? null : t(FAILURE_COPY[state.failure] ?? "error.generic");
+			return (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				(0, react_jsx_runtime.jsx)("span", {
+					ref: probeRef,
+					hidden: true
+				}),
+				toast > 0 && (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Toast, {
+					text: t("toast.recorded"),
+					icon: (0, react_jsx_runtime.jsx)("span", {
+						className: FeedbackDialog_module_css_default.toastIcon,
+						children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCheckOutline16, { size: 12 })
+					}),
+					anchor: card,
+					onDone: onToastDone
+				}, toast),
+				(0, react_jsx_runtime.jsxs)(_deepseek_ai_dsh_client_ui_primitives.Modal, {
+					open: state.target !== null,
+					title: t("dialog.title"),
+					closeLabel: t("close"),
+					onClose: dismiss,
+					className: FeedbackDialog_module_css_default.dialog,
+					footer: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+						variant: "primary",
+						className: FeedbackDialog_module_css_default.submit,
+						disabled: state.submitting,
+						onClick: () => {
+							submit();
+						},
+						children: state.submitting ? t("submitting") : t("submit")
+					}),
+					children: [
+						(0, react_jsx_runtime.jsx)("div", {
+							className: FeedbackDialog_module_css_default.categories,
+							role: "group",
+							"aria-label": t("dialog.categories"),
+							children: CATEGORIES.map((category) => (0, react_jsx_runtime.jsx)("button", {
+								type: "button",
+								className: state.category === category ? `${FeedbackDialog_module_css_default.chip} ${FeedbackDialog_module_css_default.chipActive}` : FeedbackDialog_module_css_default.chip,
+								"aria-pressed": state.category === category,
+								disabled: state.submitting,
+								onClick: () => {
+									edit({ category: state.category === category ? null : category });
+								},
+								children: t(`category.${category}`)
+							}, category))
+						}),
+						(0, react_jsx_runtime.jsx)("textarea", {
+							className: FeedbackDialog_module_css_default.detail,
+							"aria-label": t("dialog.detail"),
+							placeholder: t("dialog.hint"),
+							value: state.text,
+							readOnly: state.submitting,
+							onChange: (event) => {
+								edit({ text: event.target.value });
+							}
+						}),
+						failure !== null && (0, react_jsx_runtime.jsx)("span", {
+							className: FeedbackDialog_module_css_default.failure,
+							role: "status",
+							children: failure
+						})
+					]
+				})
+			] });
+		}
+		//#endregion
+		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-message-feedback/src/client/MessageFeedbackActions.module.css.mjs
+		const css = "._8_XoUG_action{width:calc(28px + var(--dsh-content-font-delta,0px));height:calc(28px + var(--dsh-content-font-delta,0px));color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:none;border-radius:28px;justify-content:center;align-items:center;padding:6px;display:inline-flex}._8_XoUG_action svg{width:calc(15px + var(--dsh-content-font-delta,0px));height:calc(15px + var(--dsh-content-font-delta,0px))}._8_XoUG_action:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}._8_XoUG_action:disabled{cursor:default;opacity:.4}._8_XoUG_action[data-active]{color:var(--dsw-alias-label-tertiary)}._8_XoUG_failure{color:var(--dsw-alias-label-tertiary);padding-left:4px;font-size:13px;line-height:20px}";
+		const tagId = "@deepseek-ai/dsh-client-ui-message-feedback/MessageFeedbackActions.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-message-feedback";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var MessageFeedbackActions_module_css_default = {
+			"action": "_8_XoUG_action",
+			"failure": "_8_XoUG_failure"
+		};
+		//#endregion
+		//#region lib/types/client/MessageFeedbackActions.js
+		/**
+		* Per-message feedback controls: the Like/Dislike pair inside the assistant
+		* message's IconActions row, between copy and branch. Like records at once
+		* and raises the Session's acknowledgement toast; Dislike opens the Session's
+		* feedback dialog, whose submission records the negative judgment with its
+		* category and text. Clicking the recorded rating retracts it. A recorded
+		* rating shows the filled glyph so the signal survives a pointer leaving the row.
+		* @module @deepseek-ai/dsh-client-ui-message-feedback/client/MessageFeedbackActions
+		*/
+		/**
+		* One message's feedback controls.
+		* @param props - the owner's message identity, the injected verbs, and the
+		* shared feedback hook.
+		* @returns the rating buttons with any failure notice beside them.
+		*/
+		function MessageFeedbackActions({ messageId, ensure, current, toggle, openDialog, acknowledge, useFeedback, t }) {
+			const item = useFeedback((view) => view.items.get(messageId));
+			const loadFailed = useFeedback((view) => view.status === "error");
+			const rating = item?.rating;
+			const [pending, setPending] = (0, react.useState)(false);
+			const [failure, setFailure] = (0, react.useState)(null);
+			const seeded = (0, react.useRef)(false);
+			const seed = (0, react.useCallback)(() => {
+				if (seeded.current) return;
+				seeded.current = true;
+				ensure();
+			}, [ensure]);
+			const alive = (0, react.useRef)(true);
+			(0, react.useEffect)(() => () => {
+				alive.current = false;
+			}, []);
+			const errorCopy = (0, react.useCallback)((result) => {
+				return result.error.code === "version-conflict" ? t("error.conflict") : t("error.generic");
+			}, [t]);
+			const onLike = (0, react.useCallback)(() => {
+				setPending(true);
+				setFailure(null);
+				toggle(messageId, "positive").then((result) => {
+					if (!alive.current) return;
+					setPending(false);
+					if (!result.ok) {
+						setFailure(errorCopy(result));
+						return;
+					}
+					if (result.rating === "positive") acknowledge();
+				});
+			}, [
+				acknowledge,
+				errorCopy,
+				messageId,
+				toggle
+			]);
+			const onDislike = (0, react.useCallback)(() => {
+				setPending(true);
+				setFailure(null);
+				ensure().then((loaded) => {
+					if (!alive.current) return;
+					if (!loaded.ok || current(messageId)?.rating !== "negative") {
+						setPending(false);
+						openDialog(messageId);
+						return;
+					}
+					toggle(messageId, "negative").then((result) => {
+						if (!alive.current) return;
+						setPending(false);
+						if (!result.ok) setFailure(errorCopy(result));
+					});
+				});
+			}, [
+				current,
+				ensure,
+				errorCopy,
+				messageId,
+				openDialog,
+				toggle
+			]);
+			const likeLabel = rating === "positive" ? t("action.likeActive") : t("action.like");
+			const dislikeLabel = rating === "negative" ? t("action.dislikeActive") : t("action.dislike");
+			return (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+					label: likeLabel,
+					side: "bottom",
+					children: (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						className: MessageFeedbackActions_module_css_default.action,
+						"aria-label": likeLabel,
+						"aria-pressed": rating === "positive",
+						"data-active": rating === "positive" || void 0,
+						disabled: pending,
+						onFocus: seed,
+						onPointerEnter: seed,
+						onClick: onLike,
+						children: rating === "positive" ? (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconLikeFill16, {}) : (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconLikeOutline16, {})
+					})
+				}),
+				(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+					label: dislikeLabel,
+					side: "bottom",
+					children: (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						className: MessageFeedbackActions_module_css_default.action,
+						"aria-label": dislikeLabel,
+						"aria-pressed": rating === "negative",
+						"data-active": rating === "negative" || void 0,
+						disabled: pending,
+						onFocus: seed,
+						onPointerEnter: seed,
+						onClick: onDislike,
+						children: rating === "negative" ? (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconDislikeFill16, {}) : (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconDislikeOutline16, {})
+					})
+				}),
+				failure === null && loadFailed && (0, react_jsx_runtime.jsx)("span", {
+					className: MessageFeedbackActions_module_css_default.failure,
+					role: "status",
+					children: t("error.load")
+				}),
+				failure !== null && (0, react_jsx_runtime.jsx)("span", {
+					className: MessageFeedbackActions_module_css_default.failure,
+					role: "status",
+					children: failure
+				})
+			] });
+		}
+		//#endregion
 		//#region lib/types/client/controller.js
 		const INITIAL_VIEW = Object.freeze({
 			status: "cold",
@@ -22,7 +291,11 @@ window.__ModuleLoader__.load({
 				message: "feedback controller is disposed"
 			})
 		});
-		/** Human-readable text for one business failure code. */
+		/**
+		* Human-readable text for one business failure code.
+		* @param code - the Host's business failure code.
+		* @returns the developer-facing description carried in the failure branch.
+		*/
 		function describe(code) {
 			switch (code) {
 				case "session-not-found": return "this session is no longer persisted";
@@ -123,22 +396,17 @@ window.__ModuleLoader__.load({
 			}
 			/**
 			* Create or replace feedback for one message, comparing against the version
-			* this controller last observed.
-			*
-			* The note is resolved here rather than by the caller: `mutate` awaits the
-			* one list read first, so this body always sees the committed item, while a
-			* control that rendered before that read completed would still be holding
-			* `undefined`. Omitting `note` therefore keeps whatever is stored; only
-			* {@link clearNote} removes one.
+			* this controller last observed. The item stores exactly `entry`: an entry
+			* without a note or category replaces whatever the stored item carried.
 			* @param messageId - target assistant message.
 			* @param rating - desired judgment.
-			* @param note - replacement explanation; omitted keeps the stored note.
+			* @param entry - explanation and category to store with the judgment.
 			* @returns the settled mutation result.
 			*/
-			rate(messageId, rating, note) {
+			rate(messageId, rating, entry = {}) {
 				return this.mutate(async () => {
 					const observed = this.view.items.get(messageId);
-					return await this.putCommitted(messageId, rating, note ?? observed?.note, observed);
+					return await this.putCommitted(messageId, rating, entry, observed);
 				});
 			}
 			/**
@@ -146,50 +414,31 @@ window.__ModuleLoader__.load({
 			* the committed rating already matches. The decision reads the committed item
 			* inside the serialized mutation, so a click that lands before the first list
 			* read still toggles against the stored value rather than the empty view a
-			* cold control rendered.
+			* cold control rendered. A replacement stores the bare judgment; the note
+			* and category of the judgment it replaces do not carry over.
 			* @param messageId - target assistant message.
 			* @param rating - the judgment the human asked for.
-			* @returns the settled mutation result.
+			* @returns the settled mutation result with the rating now committed.
 			*/
 			toggle(messageId, rating) {
 				return this.mutate(async () => {
 					const observed = this.view.items.get(messageId);
-					if (observed?.rating === rating) return await this.deleteCommitted(messageId, observed);
-					return await this.putCommitted(messageId, rating, observed?.note, observed);
-				});
-			}
-			/**
-			* Drop the note while keeping the rating. Absent feedback needs no call.
-			* @param messageId - target assistant message.
-			* @returns the settled mutation result.
-			*/
-			clearNote(messageId) {
-				return this.mutate(async () => {
-					const observed = this.view.items.get(messageId);
-					if (observed === void 0 || observed.note === void 0) return OK;
-					return await this.putCommitted(messageId, observed.rating, void 0, observed);
-				});
-			}
-			/**
-			* Remove feedback for one message. A message with no known item is already
-			* in the requested state, so no call is made.
-			* @param messageId - target assistant message.
-			* @returns the settled mutation result.
-			*/
-			clear(messageId) {
-				return this.mutate(async () => {
-					const observed = this.view.items.get(messageId);
-					if (observed === void 0) return OK;
-					return await this.deleteCommitted(messageId, observed);
+					const retract = observed?.rating === rating;
+					const result = retract ? await this.deleteCommitted(messageId, observed) : await this.putCommitted(messageId, rating, {}, observed);
+					return result.ok ? {
+						ok: true,
+						rating: retract ? null : rating
+					} : result;
 				});
 			}
 			/** Commit one put against the observed version and reconcile a conflict. */
-			async putCommitted(messageId, rating, note, observed) {
+			async putCommitted(messageId, rating, entry, observed) {
 				const carried = await this.ctx.remote.messageFeedback.put({
 					sessionId: this.sessionId,
 					messageId,
 					rating,
-					...note === void 0 ? {} : { note },
+					...entry.text === void 0 ? {} : { note: entry.text },
+					...entry.category === void 0 ? {} : { category: entry.category },
 					ifVersion: observed?.version ?? null
 				});
 				if (!carried.ok) return carrierFailure(carried.error);
@@ -297,297 +546,185 @@ window.__ModuleLoader__.load({
 			}
 		};
 		//#endregion
-		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-message-feedback/src/client/MessageFeedbackActions.module.css.mjs
-		const css = "._8_XoUG_action{width:calc(28px + var(--dsh-content-font-delta,0px));height:calc(28px + var(--dsh-content-font-delta,0px));color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:none;border-radius:28px;justify-content:center;align-items:center;padding:6px;display:inline-flex}._8_XoUG_action svg{width:calc(15px + var(--dsh-content-font-delta,0px));height:calc(15px + var(--dsh-content-font-delta,0px))}._8_XoUG_action:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}._8_XoUG_action:disabled{cursor:default;opacity:.4}._8_XoUG_action[data-active]{color:var(--dsw-alias-label-primary)}._8_XoUG_noteOpen{max-width:220px;color:var(--dsw-alias-label-tertiary);font-size:var(--dsh-content-font-size-secondary,13px);line-height:calc(28px + var(--dsh-content-font-delta,0px));white-space:nowrap;text-overflow:ellipsis;cursor:pointer;background:0 0;border:none;border-radius:14px;padding:0 8px;overflow:hidden}._8_XoUG_noteOpen:hover,._8_XoUG_noteOpen[aria-expanded=true]{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}._8_XoUG_notePanel{z-index:1100;box-sizing:border-box;background:var(--dsw-specific-menu);--dsw-elevation-stroke-color:var(--dsw-alias-border-l1);width:320px;max-width:min(360px,100vw - 24px);max-height:calc(100vh - 24px);box-shadow:var(--dsw-elevation-prominent);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);border:0;border-radius:12px;flex-direction:column;gap:8px;padding:8px;display:flex;position:fixed;overflow-y:auto}._8_XoUG_noteInput{box-sizing:border-box;border:.5px solid var(--dsw-alias-border-l4);background:var(--dsw-alias-bg-layer-1);width:100%;color:var(--dsw-alias-label-primary);font:inherit;resize:vertical;border-radius:8px;padding:6px 8px;font-size:13px}._8_XoUG_noteActions{justify-content:flex-end;gap:6px;display:flex}._8_XoUG_noteSave,._8_XoUG_noteCancel{cursor:pointer;border:none;border-radius:14px;height:28px;padding:0 10px;font-size:13px}._8_XoUG_noteSave{background:var(--dsw-alias-button-primary-fill);color:var(--dsw-alias-label-primary-foreground)}._8_XoUG_noteSave:hover:not(:disabled){background:var(--dsw-alias-button-primary-hover)}._8_XoUG_noteSave:disabled{cursor:default;opacity:.4}._8_XoUG_noteCancel{color:var(--dsw-alias-label-tertiary);background:0 0}._8_XoUG_noteCancel:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}._8_XoUG_failure{color:var(--dsw-alias-label-tertiary);padding-left:4px;font-size:13px;line-height:20px}";
-		const tagId = "@deepseek-ai/dsh-client-ui-message-feedback/MessageFeedbackActions.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-message-feedback";
-			tag.dataset.pluginCss = tagId;
-			tag.textContent = css;
-			document.head.appendChild(tag);
-		}
-		var MessageFeedbackActions_module_css_default = {
-			"action": "_8_XoUG_action",
-			"failure": "_8_XoUG_failure",
-			"noteActions": "_8_XoUG_noteActions",
-			"noteCancel": "_8_XoUG_noteCancel",
-			"noteInput": "_8_XoUG_noteInput",
-			"noteOpen": "_8_XoUG_noteOpen",
-			"notePanel": "_8_XoUG_notePanel",
-			"noteSave": "_8_XoUG_noteSave"
-		};
-		//#endregion
-		//#region lib/types/client/MessageFeedbackActions.js
+		//#region lib/types/client/dialog.js
 		/**
-		* Per-message feedback controls: a Like/Dislike pair plus an optional note.
-		* The buttons render inside the assistant message's IconActions row, so they
-		* reuse that row's chrome and sit between copy and branch. The note editor is
-		* a popover (portaled to `document.body`) anchored to the note trigger, not an
-		* inline expansion: a 260px textarea plus buttons cannot fit the row at any
-		* viewport, and an inline element pushed the branch action and clock out of the
-		* conversation column. Portaling out of the column also escapes its `overflow`
-		* clip, so the panel cannot be cropped or detached from the message it annotates.
-		* @module @deepseek-ai/dsh-client-ui-message-feedback/client/MessageFeedbackActions
-		*/
-		/** Safe distance kept between the panel and the viewport edges (the Menu portal margin). */
-		const PANEL_MARGIN = 12;
-		/** Distance between the trigger's bottom edge and the panel's top. */
-		const PANEL_GAP = 4;
-		/**
-		* Unplaced portal panel: hidden but laid out so `offsetWidth` is real for the
-		* clamp. The explicit insets match `Menu`'s measure style — a `position: fixed`
-		* element with auto insets otherwise sits at its static position, a different
-		* origin than the one the first placement measures from.
+		* Headless state of one Session's feedback dialog and its acknowledgement
+		* toast. One form serves two targets: the Session itself (a bare `/feedback`)
+		* and one assistant message (Dislike). The overlay view renders from the
+		* store; the message controls raise the toast after a Like through
+		* {@link FeedbackDialogController.acknowledge}.
+		* @module @deepseek-ai/dsh-client-ui-message-feedback/client/dialog
 		*/
-		const MEASURE_STYLE = {
-			visibility: "hidden",
-			left: 0,
-			top: 0
+		const CLOSED = {
+			target: null,
+			category: null,
+			text: "",
+			submitting: false,
+			failure: null
 		};
-		/**
-		* One message's feedback controls.
-		* @param props - the owner's message identity, the injected verbs, and the
-		* shared feedback hook.
-		* @returns the rating buttons and the note trigger, with the note editor
-		* portal-open beneath the trigger while it is open.
-		*/
-		function MessageFeedbackActions({ messageId, ensure, rate, toggle, clearNote, useFeedback, t }) {
-			const item = useFeedback((view) => view.items.get(messageId));
-			const loadFailed = useFeedback((view) => view.status === "error");
-			const rating = item?.rating;
-			const [noteOpen, setNoteOpen] = (0, react.useState)(false);
-			const [draft, setDraft] = (0, react.useState)("");
-			const [pending, setPending] = (0, react.useState)(false);
-			const [rowFailure, setRowFailure] = (0, react.useState)(null);
-			const [noteFailure, setNoteFailure] = (0, react.useState)(null);
-			const triggerRef = (0, react.useRef)(null);
-			const panelRef = (0, react.useRef)(null);
-			const inputRef = (0, react.useRef)(null);
-			const seeded = (0, react.useRef)(false);
-			const seed = (0, react.useCallback)(() => {
-				if (seeded.current) return;
-				seeded.current = true;
-				ensure();
-			}, [ensure]);
-			const alive = (0, react.useRef)(true);
-			(0, react.useEffect)(() => () => {
-				alive.current = false;
-			}, []);
-			/** Bumped whenever an editing session ends, so a late save can tell it is stale. */
-			const noteGeneration = (0, react.useRef)(0);
-			/** Current panel open-state, readable from a stale closure via a ref. */
-			const noteOpenRef = (0, react.useRef)(false);
-			(0, react.useEffect)(() => {
-				noteOpenRef.current = noteOpen;
-			}, [noteOpen]);
-			const errorCopy = (0, react.useCallback)((result) => {
-				return result.error?.code === "version-conflict" ? t("error.conflict") : t("error.generic");
-			}, [t]);
-			const settleRating = (0, react.useCallback)((result) => {
-				if (!alive.current) return;
-				setPending(false);
-				setRowFailure(result.ok ? null : errorCopy(result));
-			}, [errorCopy]);
-			const closeNote = (0, react.useCallback)(() => {
-				noteGeneration.current += 1;
-				setNoteOpen(false);
-			}, []);
-			const onRate = (0, react.useCallback)((next) => {
-				setPending(true);
-				setRowFailure(null);
-				closeNote();
-				toggle(messageId, next).then(settleRating);
-			}, [
-				closeNote,
-				messageId,
-				settleRating,
-				toggle
-			]);
-			const onSaveNote = (0, react.useCallback)((current) => {
-				const trimmed = draft.trim();
-				setPending(true);
-				setNoteFailure(null);
-				const generation = noteGeneration.current;
-				const staleSeed = item?.note ?? "";
-				(trimmed.length === 0 ? clearNote(messageId) : rate(messageId, current, trimmed)).then((result) => {
-					if (!alive.current) return;
-					setPending(false);
-					if (result.ok) {
-						if (generation === noteGeneration.current) {
-							setNoteFailure(null);
-							setNoteOpen(false);
-							return;
-						}
-						setDraft((draftNow) => draftNow === staleSeed ? trimmed : draftNow);
-						return;
-					}
-					if (generation === noteGeneration.current || !noteOpenRef.current) setNoteFailure(errorCopy(result));
+		/** Per-session dialog controller; one instance backs the overlay entry and every message control. */
+		var FeedbackDialogController = class {
+			submit;
+			/** Dialog state store (the overlay entry subscribes here). */
+			state = (0, _deepseek_ai_dsh_client_store.createSnapshotStore)({
+				...CLOSED,
+				toast: 0
+			});
+			/** Bumped by every open, dismiss, and dispose so a late settlement can tell its draft is gone. */
+			generation = 0;
+			toastSeq = 0;
+			/**
+			* @param submit - records one submission; the owner routes it by target.
+			*/
+			constructor(submit) {
+				this.submit = submit;
+			}
+			/**
+			* Open the dialog with an empty draft, replacing any open draft.
+			* @param target - what the submission records against.
+			*/
+			open(target) {
+				this.generation += 1;
+				this.state.set({
+					...CLOSED,
+					target,
+					toast: this.state.getSnapshot().toast
 				});
-			}, [
-				clearNote,
-				draft,
-				errorCopy,
-				item?.note,
-				messageId,
-				noteOpenRef,
-				rate
-			]);
-			const toggleNote = (0, react.useCallback)(() => {
-				if (noteOpen) {
-					closeNote();
+			}
+			/** Close the dialog and discard the draft; a toast on screen stays. */
+			dismiss() {
+				this.generation += 1;
+				this.state.set({
+					...CLOSED,
+					toast: this.state.getSnapshot().toast
+				});
+			}
+			/**
+			* Replace part of the draft while it is editable.
+			* @param draft - the category (null clears it) or the text as typed.
+			*/
+			edit(draft) {
+				const s = this.state.getSnapshot();
+				if (s.target === null || s.submitting) return;
+				this.state.set({
+					...s,
+					...draft
+				});
+			}
+			/**
+			* Submit the draft; an empty draft is a valid submission. Success closes the
+			* dialog and raises the toast; a failure keeps the dialog open with its code.
+			* @returns after the submission settles.
+			*/
+			async submitDraft() {
+				const s = this.state.getSnapshot();
+				if (s.target === null || s.submitting) return;
+				const generation = this.generation;
+				this.state.set({
+					...s,
+					submitting: true,
+					failure: null
+				});
+				const text = s.text.trim();
+				const result = await this.submit(s.target, {
+					...text.length === 0 ? {} : { text },
+					...s.category === null ? {} : { category: s.category }
+				});
+				if (result.ok) {
+					if (generation === this.generation) this.dismiss();
+					this.acknowledge();
 					return;
 				}
-				setDraft(item?.note ?? "");
-				setNoteFailure(null);
-				setNoteOpen(true);
-			}, [
-				noteOpen,
-				closeNote,
-				item?.note
-			]);
-			const pos = (0, _deepseek_ai_dsh_client_ui_primitives.useAnchoredPosition)({
-				open: noteOpen,
-				anchorRef: triggerRef,
-				panelRef,
-				gap: PANEL_GAP,
-				margin: PANEL_MARGIN
-			});
-			(0, react.useEffect)(() => {
-				if (!noteOpen) return;
-				inputRef.current?.focus();
-				const onPointerDown = (e) => {
-					if (!(e.target instanceof Node)) return;
-					if (triggerRef.current?.contains(e.target) === true) return;
-					if (panelRef.current?.contains(e.target) === true) return;
-					closeNote();
-				};
-				const onKeyDown = (e) => {
-					if (e.key === "Escape") closeNote();
+				if (generation !== this.generation) return;
+				this.state.set({
+					...this.state.getSnapshot(),
+					submitting: false,
+					failure: result.error.code
+				});
+			}
+			/** Show the acknowledgement toast; a toast already on screen restarts. */
+			acknowledge() {
+				this.toastSeq += 1;
+				this.state.set({
+					...this.state.getSnapshot(),
+					toast: this.toastSeq
+				});
+			}
+			/**
+			* Retire one toast after its fade; a newer toast is left alone.
+			* @param seq - the toast sequence the view finished showing.
+			*/
+			dismissToast(seq) {
+				const s = this.state.getSnapshot();
+				if (s.toast === seq) this.state.set({
+					...s,
+					toast: 0
+				});
+			}
+			/** Scope-teardown disposer: drop the draft and the toast, orphan in-flight work. */
+			dispose() {
+				this.generation += 1;
+				this.state.set({
+					...CLOSED,
+					toast: 0
+				});
+			}
+		};
+		//#endregion
+		//#region lib/types/client/surface.js
+		/**
+		* One Session's feedback surface: the message-feedback object layer and the
+		* dialog controller, plus the routing between them. A message target puts a
+		* negative judgment through the message controller; the Session target
+		* records through the `sessionFeedback` Remote.
+		* @module @deepseek-ai/dsh-client-ui-message-feedback/client/surface
+		*/
+		/** The per-session pair behind every entry of one Session. */
+		var FeedbackSurface = class {
+			ctx;
+			sessionId;
+			/** The Session's message-feedback object layer, shared by every message control. */
+			feedback;
+			/** The Session's dialog and toast state, shared by the overlay entry and the message controls. */
+			dialog;
+			/**
+			* @param ctx - the browser plugin context carrying both feedback Remotes.
+			* @param sessionId - Session owning the transcript and the remark.
+			*/
+			constructor(ctx, sessionId) {
+				this.ctx = ctx;
+				this.sessionId = sessionId;
+				this.feedback = new MessageFeedbackController(ctx, sessionId);
+				this.dialog = new FeedbackDialogController((target, entry) => target.kind === "message" ? this.feedback.rate(target.messageId, "negative", entry) : this.recordSession(entry));
+			}
+			/** Record one Session-level remark through the sessionFeedback Remote. */
+			async recordSession(entry) {
+				const carried = await this.ctx.remote.sessionFeedback.record({
+					sessionId: this.sessionId,
+					...entry
+				});
+				if (!carried.ok) return {
+					ok: false,
+					error: {
+						code: carried.error.code,
+						message: carried.error.message
+					}
 				};
-				document.addEventListener("pointerdown", onPointerDown);
-				document.addEventListener("keydown", onKeyDown);
-				return () => {
-					document.removeEventListener("pointerdown", onPointerDown);
-					document.removeEventListener("keydown", onKeyDown);
+				if (carried.value.ok) return { ok: true };
+				return {
+					ok: false,
+					error: {
+						code: carried.value.error.code,
+						message: describe(carried.value.error.code)
+					}
 				};
-			}, [noteOpen, closeNote]);
-			const wasOpen = (0, react.useRef)(false);
-			(0, react.useEffect)(() => {
-				if (noteOpen) {
-					wasOpen.current = true;
-					return;
-				}
-				if (wasOpen.current) triggerRef.current?.focus();
-				wasOpen.current = false;
-			}, [noteOpen]);
-			const likeLabel = rating === "positive" ? t("action.likeActive") : t("action.like");
-			const dislikeLabel = rating === "negative" ? t("action.dislikeActive") : t("action.dislike");
-			return (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
-				(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
-					label: likeLabel,
-					side: "bottom",
-					children: (0, react_jsx_runtime.jsx)("button", {
-						type: "button",
-						className: MessageFeedbackActions_module_css_default.action,
-						"aria-label": likeLabel,
-						"aria-pressed": rating === "positive",
-						"data-active": rating === "positive" || void 0,
-						disabled: pending,
-						onFocus: seed,
-						onPointerEnter: seed,
-						onClick: () => {
-							onRate("positive");
-						},
-						children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconLikeOutline16, {})
-					})
-				}),
-				(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
-					label: dislikeLabel,
-					side: "bottom",
-					children: (0, react_jsx_runtime.jsx)("button", {
-						type: "button",
-						className: MessageFeedbackActions_module_css_default.action,
-						"aria-label": dislikeLabel,
-						"aria-pressed": rating === "negative",
-						"data-active": rating === "negative" || void 0,
-						disabled: pending,
-						onFocus: seed,
-						onPointerEnter: seed,
-						onClick: () => {
-							onRate("negative");
-						},
-						children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconDislikeOutline16, {})
-					})
-				}),
-				rating !== void 0 && (0, react_jsx_runtime.jsx)("button", {
-					ref: triggerRef,
-					type: "button",
-					className: MessageFeedbackActions_module_css_default.noteOpen,
-					"aria-haspopup": "dialog",
-					"aria-expanded": noteOpen,
-					onClick: toggleNote,
-					children: item?.note === void 0 ? t("note.open") : item.note
-				}),
-				rowFailure === null && loadFailed && (0, react_jsx_runtime.jsx)("span", {
-					className: MessageFeedbackActions_module_css_default.failure,
-					role: "status",
-					children: t("error.load")
-				}),
-				rowFailure !== null && (0, react_jsx_runtime.jsx)("span", {
-					className: MessageFeedbackActions_module_css_default.failure,
-					role: "status",
-					children: rowFailure
-				}),
-				!(rating !== void 0 && noteOpen) && noteFailure !== null && (0, react_jsx_runtime.jsx)("span", {
-					className: MessageFeedbackActions_module_css_default.failure,
-					role: "status",
-					children: noteFailure
-				}),
-				rating !== void 0 && noteOpen && (0, react_dom.createPortal)((0, react_jsx_runtime.jsxs)("div", {
-					ref: panelRef,
-					className: MessageFeedbackActions_module_css_default.notePanel,
-					role: "dialog",
-					"aria-label": t("note.dialog"),
-					style: pos ?? MEASURE_STYLE,
-					children: [
-						(0, react_jsx_runtime.jsx)("textarea", {
-							ref: inputRef,
-							className: MessageFeedbackActions_module_css_default.noteInput,
-							"aria-label": t("note.aria"),
-							placeholder: t("note.placeholder"),
-							value: draft,
-							rows: 3,
-							onChange: (event) => {
-								setDraft(event.target.value);
-							}
-						}),
-						(0, react_jsx_runtime.jsxs)("div", {
-							className: MessageFeedbackActions_module_css_default.noteActions,
-							children: [(0, react_jsx_runtime.jsx)("button", {
-								type: "button",
-								className: MessageFeedbackActions_module_css_default.noteSave,
-								disabled: pending,
-								onClick: () => {
-									onSaveNote(rating);
-								},
-								children: t("note.save")
-							}), (0, react_jsx_runtime.jsx)("button", {
-								type: "button",
-								className: MessageFeedbackActions_module_css_default.noteCancel,
-								onClick: closeNote,
-								children: t("note.cancel")
-							})]
-						}),
-						noteFailure !== null && (0, react_jsx_runtime.jsx)("span", {
-							className: MessageFeedbackActions_module_css_default.failure,
-							role: "status",
-							children: noteFailure
-						})
-					]
-				}), document.body)
-			] });
-		}
+			}
+			/** Drop both controllers when the owning fiber unloads. */
+			dispose() {
+				this.feedback.dispose();
+				this.dialog.dispose();
+			}
+		};
 		//#endregion
 		//#region lib/types/client/locales.js
 		/** `feedback` namespace dictionaries. */
@@ -597,15 +734,22 @@ window.__ModuleLoader__.load({
 			"action.likeActive": "取消标记",
 			"action.dislike": "有问题的回答",
 			"action.dislikeActive": "取消标记",
-			"note.open": "补充说明",
-			"note.dialog": "反馈",
-			"note.placeholder": "这条回答哪里好，或哪里有问题？（可选）",
-			"note.save": "保存",
-			"note.cancel": "取消",
-			"note.aria": "反馈说明",
+			"dialog.title": "提交反馈",
+			"dialog.categories": "反馈分类",
+			"dialog.detail": "反馈详情",
+			"dialog.hint": "填写详情以帮助我们改进体验，提交内容会包括当前对话的日志",
+			"category.task-result": "任务结果",
+			"category.instruction-following": "指令理解与遵循",
+			"category.product-interaction": "产品功能与交互",
+			"category.service-stability": "服务稳定性",
+			"category.resource-cost": "资源使用与费用",
+			"category.security-privacy-permission": "安全隐私与权限",
+			"category.other": "其他",
+			"toast.recorded": "感谢你的反馈",
 			"error.conflict": "这条反馈已在别处改动，已显示最新状态",
 			"error.load": "反馈状态加载失败",
-			"error.generic": "反馈保存失败"
+			"error.generic": "反馈保存失败",
+			"error.noteTooLarge": "描述太长，请缩短后再提交"
 		};
 		/** English dictionary, checked complete against the zh key set. */
 		const en = {
@@ -613,38 +757,46 @@ window.__ModuleLoader__.load({
 			"action.likeActive": "Remove rating",
 			"action.dislike": "Bad response",
 			"action.dislikeActive": "Remove rating",
-			"note.open": "Add a note",
-			"note.dialog": "Feedback",
-			"note.placeholder": "What was good, or what went wrong? (optional)",
-			"note.save": "Save",
-			"note.cancel": "Cancel",
-			"note.aria": "Feedback note",
+			"dialog.title": "Submit feedback",
+			"dialog.categories": "Feedback category",
+			"dialog.detail": "Feedback details",
+			"dialog.hint": "Add details to help us improve. Your submission will include the current conversation log.",
+			"category.task-result": "Task result",
+			"category.instruction-following": "Instruction understanding and following",
+			"category.product-interaction": "Product features and interaction",
+			"category.service-stability": "Service stability",
+			"category.resource-cost": "Resource usage and cost",
+			"category.security-privacy-permission": "Security, privacy, and permissions",
+			"category.other": "Other",
+			"toast.recorded": "Thanks for your feedback",
 			"error.conflict": "This feedback changed elsewhere; the latest state is shown",
 			"error.load": "Could not load feedback",
-			"error.generic": "Could not save feedback"
+			"error.generic": "Could not save feedback",
+			"error.noteTooLarge": "The description is too long; shorten it and submit again"
 		};
 		//#endregion
 		//#region lib/types/client/index.js
 		/**
-		* Message feedback plugin, browser half: the Like/Dislike entry in the
-		* conversation.chat.assistant-actions strip. One MessageFeedbackController per
-		* Session backs every message control in that Session, so a single list read
-		* seeds the whole transcript. Mutations go through the generated
-		* messageFeedback Remote; the Host owns per-item compare-and-set.
+		* Feedback surface plugin, browser half: the Like/Dislike entry in the
+		* conversation.chat.assistant-actions strip, the feedback dialog and its
+		* acknowledgement toast in conversation.input.overlay, and the `/feedback`
+		* decoration that opens the dialog from the composer menu or a bare typed
+		* command. One FeedbackSurface per Session backs every entry in that Session.
 		* @module @deepseek-ai/dsh-client-ui-message-feedback/client
 		*/
 		/** Dictionary namespace owned by this plugin. */
 		const NS = "feedback";
-		/** Required services: the slot registry, the Remote namespace, and the copy. */
+		/** Required services: the slot registry, the two Remote namespaces, and the copy. */
 		const inject = [
 			"slots",
 			"remote",
 			"remote.messageFeedback",
+			"remote.sessionFeedback",
 			"locale"
 		];
 		/**
-		* Client plugin body: the per-message feedback entry and its per-session
-		* object layer.
+		* Client plugin body: the per-message feedback entry, the Session's dialog
+		* entry, the `/feedback` decoration, and their per-session surfaces.
 		* @param ctx - client root context.
 		*/
 		function apply(ctx) {
@@ -652,41 +804,79 @@ window.__ModuleLoader__.load({
 				zh,
 				en
 			}), "ui-message-feedback: dictionaries");
-			const controllers = /* @__PURE__ */ new Map();
-			const controllerFor = (sessionId) => {
-				let controller = controllers.get(sessionId);
-				if (controller === void 0) {
-					controller = new MessageFeedbackController(ctx, sessionId);
-					controllers.set(sessionId, controller);
+			const surfaces = /* @__PURE__ */ new Map();
+			const surfaceFor = (sessionId) => {
+				let surface = surfaces.get(sessionId);
+				if (surface === void 0) {
+					surface = new FeedbackSurface(ctx, sessionId);
+					surfaces.set(sessionId, surface);
 				}
-				return controller;
+				return surface;
 			};
+			ctx.effect(() => () => {
+				for (const surface of surfaces.values()) surface.dispose();
+				surfaces.clear();
+			}, "ui-message-feedback: per-session surfaces");
 			ctx.on("connection/reset", () => {
-				for (const controller of controllers.values()) if (controller.getSnapshot().status !== "cold") controller.resync();
+				for (const { feedback } of surfaces.values()) if (feedback.getSnapshot().status !== "cold") feedback.resync();
 			});
-			ctx.slots.inject("conversation.chat.assistant-actions", () => {
-				const dispose = ctx.slots.register({
-					name: "conversation.chat.assistant-actions",
-					id: "feedback",
-					order: 10,
-					locale: NS,
-					inject: (sessionId) => {
-						const controller = controllerFor(sessionId);
-						return {
-							hooks: { feedback: controller },
-							ensure: () => controller.ensure(),
-							rate: (messageId, rating, note) => controller.rate(messageId, rating, note),
-							toggle: (messageId, rating) => controller.toggle(messageId, rating),
-							clearNote: (messageId) => controller.clearNote(messageId),
-							clear: (messageId) => controller.clear(messageId)
-						};
+			ctx.slots.inject("conversation.chat.assistant-actions", () => ctx.slots.register({
+				name: "conversation.chat.assistant-actions",
+				id: "feedback",
+				order: 10,
+				locale: NS,
+				inject: (sessionId) => {
+					const { feedback, dialog } = surfaceFor(sessionId);
+					return {
+						hooks: { feedback },
+						ensure: () => feedback.ensure(),
+						current: (messageId) => feedback.getSnapshot().items.get(messageId),
+						toggle: (messageId, rating) => feedback.toggle(messageId, rating),
+						openDialog: (messageId) => {
+							dialog.open({
+								kind: "message",
+								messageId
+							});
+						},
+						acknowledge: () => {
+							dialog.acknowledge();
+						}
+					};
+				}
+			}, MessageFeedbackActions));
+			ctx.slots.inject("conversation.input.overlay", () => ctx.slots.register({
+				name: "conversation.input.overlay",
+				id: "feedback-dialog",
+				order: 2,
+				locale: NS,
+				inject: (sessionId) => {
+					const { dialog } = surfaceFor(sessionId);
+					return {
+						hooks: { dialog: dialog.state },
+						edit: (draft) => {
+							dialog.edit(draft);
+						},
+						submit: () => dialog.submitDraft(),
+						dismiss: () => {
+							dialog.dismiss();
+						},
+						dismissToast: (seq) => {
+							dialog.dismissToast(seq);
+						}
+					};
+				}
+			}, FeedbackDialog));
+			ctx.inject(["commandUi"], (scope) => {
+				scope.effect(() => scope.commandUi.decorate({
+					name: "feedback",
+					available: () => true,
+					ui: {
+						kind: "action",
+						run: (session) => {
+							surfaceFor(session.sessionId).dialog.open({ kind: "session" });
+						}
 					}
-				}, MessageFeedbackActions);
-				return () => {
-					dispose();
-					for (const controller of controllers.values()) controller.dispose();
-					controllers.clear();
-				};
+				}), "ui-message-feedback: /feedback decoration");
 			});
 		}
 		//#endregion