dsh-sidecard-ask 1.8.4 → 2.0.0

package/client.js

@@ -47,7 +47,7 @@ window.__ModuleLoader__.load({
      * the Host and the module's `api.version` both read it, so a report can
      * never claim a generation the browser is not actually running.
      */
-    const CLIENT_VERSION = '1.8.4'
+    const CLIENT_VERSION = '2.0.0'
 
     /**
      * Tab kind served by the DSH native right rail (also its implementation id).
@@ -120,6 +120,17 @@ window.__ModuleLoader__.load({
       customPersona: '',
       // 1.8.0 P2-4: model-written follow-up chips (opt-in).
       followUpSuggestions: false,
+      // Empty by design: a maintainer mailbox is injected at run time (the
+      // settings field or DSH_SIDECARD_FEEDBACK_TO), never shipped in a repo.
+      feedbackAddress: '',
+      // SMTP transport, editable in the settings page. The password is
+      // write-only: `/state` never returns it, so this default is always ''.
+      feedbackSmtpHost: '',
+      feedbackSmtpPort: 465,
+      feedbackSmtpSecure: true,
+      feedbackSmtpUser: '',
+      feedbackSmtpPass: '',
+      feedbackSmtpFrom: '',
     }
 
     /**
@@ -134,6 +145,26 @@ window.__ModuleLoader__.load({
       shortcutLength: 40,
     }
 
+    /**
+     * Fallback bounds for the feedback form. `/state` reports the live limits
+     * (`capabilities.feedback.limits`) and those win; these exist only so an
+     * older Host that reports nothing still gets sane Client-side checks.
+     */
+    const FEEDBACK_DEFAULTS = {
+      titleMin: 4,
+      titleMax: 120,
+      bodyMin: 10,
+      bodyMax: 4000,
+      contactMax: 120,
+    }
+
+    /**
+     * The Host's mailbox rule, mirrored so the form refuses a bad `Reply-To`
+     * before the round trip. Kept deliberately simple: the relay is the final
+     * authority, and this only has to reject obvious non-addresses.
+     */
+    const FEEDBACK_EMAIL_PATTERN = /^[^\s@<>()[\]\\,;:"/]{1,64}@[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)+$/
+
     /**
      * Built-in quick actions. The config list only carries `builtin:<id>`;
      * the localized label and question live HERE so the wire/config layers
@@ -445,6 +476,12 @@ window.__ModuleLoader__.load({
         answerEmpty: '（没有内容）',
         cardClosed: '该卡片已关闭',
         cardMovedToFlow: '该卡片已移至浮层显示',
+        cardDelete: '删除这条追问对话',
+        cardDeleteTitle: '删除这条追问对话？',
+        cardDeleteBody: '会同时从浮层和追问历史里移除，且不可撤销。',
+        cardDeleteRounds: '含 {n} 轮追问',
+        cardDeleteConfirm: '删除',
+        cardDeleted: '已删除这条追问对话',
         reasoningTitle: '思考过程',
         copy: '复制',
         copied: '已复制',
@@ -465,6 +502,7 @@ window.__ModuleLoader__.load({
         errorNoSideEngine: '这台 DSH 组合没有可用的子代理，无法在侧边卡片作答；可以改到主对话提问。',
         errorTooLarge: '请求体过大',
         errorBadRequest: '请求无效（问题或选中文本为空）',
+      errorFeedbackInvalid: '反馈内容不符合要求，检查标题与详细描述的长度',
         errorUnloaded: '插件正在卸载，无法受理新的追问',
         errorDuplicate: '该追问已在处理中，请等它完成',
         errorBusy: '并发追问已达上限（{n}），请稍后再试',
@@ -496,7 +534,6 @@ window.__ModuleLoader__.load({
         setFloatMode: '浮层默认形态',
         setFloatModeCapsule: '胶囊（不遮挡对话，可随时展开）',
         setFloatModeFull: '直接展开成卡片',
-        setFloatModeOff: '关闭浮层（只留小圆点）',
         setFloatModeHint: '浮层贴右侧边缘，只在空间不足时才可能压到对话区',
         setFloatMaxWidth: '浮层宽度上限（px）',
         setFloatMaxWidthHint: '空间不足时自动收窄，不会硬顶',
@@ -505,9 +542,6 @@ window.__ModuleLoader__.load({
         floatDocked: '已占满右侧栏',
         floatExpand: '展开侧边卡片',
         floatCollapse: '收起为胶囊（不遮挡对话）',
-        floatHide: '隐藏浮层（只留小圆点）',
-        floatRestore: '恢复浮层',
-        floatCount: '{n} 条追问回答',
         floatStreaming: '正在作答…',
         floatDone: '已完成 {n} 条',
         setShortcut: '快捷键',
@@ -656,6 +690,38 @@ window.__ModuleLoader__.load({
         suggestionsLabel: '建议追问',
         familyLegacyDiag: '旧版共载',
         familyPeers: '同页实例',
+        setFeedback: '反馈',
+        setFeedbackHint: '遇到问题或有建议，在这里直接发邮件给我；邮件会自动附带插件版本与运行环境（不含聊天内容）',
+        feedbackOpen: '反馈问题',
+        feedbackClose: '关闭',
+        feedbackDialogTitle: '发送反馈',
+        feedbackKind: '问题类型',
+        feedbackKindBug: '缺陷',
+        feedbackKindIdea: '建议',
+        feedbackKindQuestion: '疑问',
+        feedbackKindOther: '其他',
+        feedbackTitle: '标题',
+        feedbackTitlePlaceholder: '一句话说明问题（4–120 字）',
+        feedbackBody: '详细描述',
+        feedbackBodyPlaceholder: '复现步骤 / 期望结果 / 实际结果（10–4000 字）',
+        feedbackContact: '你的邮箱（选填，作为回信地址）',
+        feedbackContactPlaceholder: 'you@example.com',
+        feedbackContactHint: '填了维护者就能直接回信给你；留空即匿名。',
+        feedbackContactInvalid: '请填写正确的邮箱地址，或留空',
+        feedbackSend: '发送邮件',
+        feedbackSending: '发送中…',
+        feedbackSent: '已发送，谢谢反馈',
+        feedbackCopy: '复制内容',
+        feedbackCopied: '已复制到剪贴板',
+        feedbackUnconfigured: '没有可用的发信服务，暂时不能直接寄出；可用“复制内容”自己发给我',
+        feedbackNoCredentials: '收件人已填好，只缺发信凭据（SMTP 账号与授权码，由环境变量或用户层配置提供）；可用“复制内容”自己发给我',
+        feedbackNeedsTitle: '标题至少 4 个字',
+        feedbackNeedsBody: '详细描述至少 10 个字',
+        feedbackContactTooLong: '联系方式太长（≤{n} 字）',
+        feedbackFailed: '发送失败：{message}',
+        feedbackEnvNote: '自动附带：插件版本、Node/平台、发送时间',
+        feedbackTooFast: '刚发过一封，请稍等半分钟',
+        feedbackTooMany: '发送过于频繁，请稍后再试',
       },
       en: {
         triggerLabel: 'Ask about selection',
@@ -686,6 +752,12 @@ window.__ModuleLoader__.load({
         answerEmpty: '(empty)',
         cardClosed: 'This card was closed',
         cardMovedToFlow: 'This card moved to the floating stack',
+        cardDelete: 'Delete this follow-up conversation',
+        cardDeleteTitle: 'Delete this follow-up conversation?',
+        cardDeleteBody: 'It will be removed from both the floating layer and the follow-up history. This cannot be undone.',
+        cardDeleteRounds: 'Includes {n} follow-up turn(s)',
+        cardDeleteConfirm: 'Delete',
+        cardDeleted: 'Deleted this follow-up conversation',
         reasoningTitle: 'Reasoning',
         copy: 'Copy',
         copied: 'Copied',
@@ -706,6 +778,7 @@ window.__ModuleLoader__.load({
         errorNoSideEngine: 'This DSH composition has no usable subagent, so the side card cannot answer; ask in the main chat instead.',
         errorTooLarge: 'The request body is too large',
         errorBadRequest: 'Invalid request (empty question or empty selection)',
+      errorFeedbackInvalid: 'The report does not meet the length limits — check the title and details',
         errorUnloaded: 'The plugin is unloading and cannot take new follow-ups',
         errorDuplicate: 'This follow-up is already being answered; wait for it to finish',
         errorBusy: 'Too many concurrent answers (limit {n}); try again shortly',
@@ -737,7 +810,6 @@ window.__ModuleLoader__.load({
         setFloatMode: 'Floating layer default',
         setFloatModeCapsule: 'Capsule (never covers the conversation)',
         setFloatModeFull: 'Expanded card stack',
-        setFloatModeOff: 'Hidden (small launcher only)',
         setFloatModeHint: 'The layer is anchored to the right edge and only overlaps on very narrow frames',
         setFloatMaxWidth: 'Floating layer max width (px)',
         setFloatMaxWidthHint: 'Narrows automatically when there is not enough room',
@@ -746,9 +818,6 @@ window.__ModuleLoader__.load({
         floatDocked: 'Filled the right rail',
         floatExpand: 'Expand the side cards',
         floatCollapse: 'Collapse to a capsule (stops covering the conversation)',
-        floatHide: 'Hide the layer (leaves a small launcher)',
-        floatRestore: 'Restore the floating layer',
-        floatCount: '{n} follow-up answers',
         floatStreaming: 'Answering…',
         floatDone: '{n} done',
         setShortcut: 'Shortcut',
@@ -897,6 +966,38 @@ window.__ModuleLoader__.load({
         suggestionsLabel: 'Suggested follow-ups',
         familyLegacyDiag: 'Legacy co-load',
         familyPeers: 'Copies on page',
+        setFeedback: 'Feedback',
+        setFeedbackHint: 'Report a bug or send a suggestion by mail from here; the plugin version and runtime details are attached automatically (no chat content)',
+        feedbackOpen: 'Send feedback',
+        feedbackClose: 'Close',
+        feedbackDialogTitle: 'Send feedback',
+        feedbackKind: 'Kind',
+        feedbackKindBug: 'Bug',
+        feedbackKindIdea: 'Idea',
+        feedbackKindQuestion: 'Question',
+        feedbackKindOther: 'Other',
+        feedbackTitle: 'Title',
+        feedbackTitlePlaceholder: 'One line (4–120 characters)',
+        feedbackBody: 'Details',
+        feedbackBodyPlaceholder: 'Steps to reproduce / expected / actual (10–4000 characters)',
+        feedbackContact: 'Your email (optional, used as the reply address)',
+        feedbackContactPlaceholder: 'you@example.com',
+        feedbackContactHint: 'Filled in, a reply reaches you directly; leave it empty to stay anonymous.',
+        feedbackContactInvalid: 'Enter a valid email address, or leave it empty',
+        feedbackSend: 'Send mail',
+        feedbackSending: 'Sending…',
+        feedbackSent: 'Sent — thank you',
+        feedbackCopy: 'Copy text',
+        feedbackCopied: 'Copied to the clipboard',
+        feedbackUnconfigured: 'No mail service is configured, so the report cannot be sent from here; use “Copy text” and send it yourself',
+        feedbackNoCredentials: 'The recipient is set; only the SMTP credentials (environment variables or the user config) are missing, so use “Copy text” and send it yourself',
+        feedbackNeedsTitle: 'The title needs at least 4 characters',
+        feedbackNeedsBody: 'The details need at least 10 characters',
+        feedbackContactTooLong: 'The contact line is too long (max {n} characters)',
+        feedbackFailed: 'Send failed: {message}',
+        feedbackEnvNote: 'Attached automatically: plugin version, Node/platform, send time',
+        feedbackTooFast: 'One mail just went out — wait half a minute',
+        feedbackTooMany: 'Too many reports for now — try again later',
       },
     }
 
@@ -967,6 +1068,12 @@ window.__ModuleLoader__.load({
       'bad-response': { key: 'errorBadResponseBody' },
       'stream-broken': { key: 'errorStreamBrokenBody' },
       'stream-ended': { key: 'errorStreamEndedBody' },
+      // Feedback endpoints: these four are fully known Client-side, so an
+      // English UI never shows the Host's Chinese line for them.
+      'feedback-invalid': { key: 'errorFeedbackInvalid' },
+      'feedback-unconfigured': { key: 'feedbackUnconfigured' },
+      'feedback-too-fast': { key: 'feedbackTooFast' },
+      'feedback-too-many': { key: 'feedbackTooMany' },
     }
 
     /** One localized line for a wire error; unknown codes keep the Host text. */
@@ -1113,8 +1220,8 @@ window.__ModuleLoader__.load({
         surface: 'flow',
         surfaceNote: null,
         /**
-         * In-session override of `config.floatMode`, set by the layer's own
-         * collapse/hide buttons. `null` = follow the configured default.
+         * In-session override of `config.floatMode`, set by the card header's
+         * collapse button. `null` = follow the configured default.
          */
         floatMode: null,
         sessionId: null,
@@ -1259,10 +1366,10 @@ window.__ModuleLoader__.load({
      * NOT persisted: the settings page owns the durable default, and a reload
      * should return to it (a pill hidden by accident must not stay hidden
      * across sessions).
-     * @param {string} mode - `capsule` | `full` | `off`.
+     * @param {string} mode - `capsule` | `full`.
      */
     function setFloatMode(mode) {
-      if (mode !== 'capsule' && mode !== 'full' && mode !== 'off') return
+      if (mode !== 'capsule' && mode !== 'full') return
       store.set({ floatMode: mode })
     }
 
@@ -1639,6 +1746,54 @@ window.__ModuleLoader__.load({
       }
     }
 
+    /**
+     * Validate a feedback draft BEFORE posting it, so the Host's 400 never
+     * comes back as a surprise. The bounds are the live Host ones (see
+     * {@link FEEDBACK_DEFAULTS}); the CR/LF rule mirrors the Host's own
+     * header-injection fence.
+     * @param {{kind?: string, title?: string, body?: string, contact?: string}} draft
+     * @param {{titleMin: number, titleMax: number, bodyMin: number, bodyMax: number, contactMax?: number}} [limits]
+     * @returns {{ok: true}|{ok: false, key: string}}
+     */
+    function validateFeedbackDraft(draft, limits) {
+      const bound = limits ?? FEEDBACK_DEFAULTS
+      const title = typeof draft?.title === 'string' ? draft.title.trim() : ''
+      const body = typeof draft?.body === 'string' ? draft.body.trim() : ''
+      const chars = text => Array.from(text).length
+      if (title.includes('\n') || title.includes('\r')) return { ok: false, key: 'feedbackNeedsTitle' }
+      if (chars(title) < bound.titleMin || chars(title) > bound.titleMax) return { ok: false, key: 'feedbackNeedsTitle' }
+      if (chars(body) < bound.bodyMin || chars(body) > bound.bodyMax) return { ok: false, key: 'feedbackNeedsBody' }
+      const contact = typeof draft?.contact === 'string' ? draft.contact.trim() : ''
+      if (bound.contactMax !== undefined && chars(contact) > bound.contactMax) return { ok: false, key: 'feedbackContactTooLong' }
+      // Same pragmatic mailbox rule as the Host: the value becomes `Reply-To:`,
+      // so anything that is not an address would be rejected by the relay.
+      if (contact !== '' && !FEEDBACK_EMAIL_PATTERN.test(contact)) return { ok: false, key: 'feedbackContactInvalid' }
+      return { ok: true }
+    }
+
+    /** One-line subject for the report. */
+    function feedbackSubjectFor({ version, draft }) {
+      const title = typeof draft?.title === 'string' ? draft.title.trim() : ''
+      const kind = typeof draft?.kind === 'string' && draft.kind !== '' ? draft.kind : 'other'
+      return `[dsh-sidecard-ask ${version}] ${kind}: ${title === '' ? 'feedback' : title}`
+    }
+
+    /** The report as plain text: what the copy button puts on the clipboard. */
+    function feedbackPlainTextFor({ version, draft, userAgent }) {
+      const contact = typeof draft?.contact === 'string' ? draft.contact.trim() : ''
+      const body = typeof draft?.body === 'string' ? draft.body.trim() : ''
+      return [
+        `kind: ${typeof draft?.kind === 'string' && draft.kind !== '' ? draft.kind : 'other'}`,
+        `title: ${typeof draft?.title === 'string' ? draft.title.trim() : ''}`,
+        `contact: ${contact === '' ? '(not provided)' : contact}`,
+        '',
+        body,
+        '',
+        `plugin: ${version}`,
+        `user agent: ${typeof userAgent === 'string' ? userAgent : ''}`,
+      ].join('\n')
+    }
+
     /**
      * Validate a settings-page quick-action draft BEFORE posting it, so the
      * Host's all-or-nothing refusal never comes back as a surprise. Also
@@ -2043,7 +2198,7 @@ window.__ModuleLoader__.load({
    (\`html[data-platform] body>[data-dsh-better-sidebar]{-webkit-app-region:initial}\`
    plus \`[data-dsh-panel-host]>*{-webkit-app-region:no-drag}\`).
    Every surface we draw declares it. The property is inert in a browser. */
-.dsa-layer,.dsa-trigger,.dsa-quickbar,.dsa-pop,.dsa-ctxmenu,.dsa-float,.dsa-stack,.dsa-card,.dsa-toast,.dsa-settings{-webkit-app-region:no-drag}
+.dsa-layer,.dsa-trigger,.dsa-quickbar,.dsa-pop,.dsa-ctxmenu,.dsa-float,.dsa-stack,.dsa-card,.dsa-toast,.dsa-settings,.dsa-confirm{-webkit-app-region:no-drag}
 .dsa-layer{pointer-events:none;position:relative;z-index:60}
 .dsa-trigger{pointer-events:auto;position:fixed;display:flex;align-items:center;gap:4px;
   padding:4px 8px;border-radius:8px;border:1px solid var(--dsw-alias-border-l2, rgba(127,127,127,.35));
@@ -2155,10 +2310,22 @@ body[data-ds-dark-theme] .dsa-quickbar .dsa-trigger-embedded{color:#0a1428}
 .dsa-btn:hover{border-color:var(--dsw-alias-brand-primary, #4c8dff)}
 .dsa-btn-primary{background:var(--dsw-alias-brand-primary, #4c8dff);border-color:var(--dsw-alias-brand-primary, #4c8dff);
   color:#fff;font-weight:500}
+/* Same reason as the segmented chips and the quick-bar primary: the uiskin dark
+   brand is a light blue (#5b9cf5) where white text measures 2.79:1. Dark ink
+   lands at 6.57:1 and keeps the button reading as "filled". */
+html[data-ds-dark-theme] .dsa-btn-primary,
+body[data-ds-dark-theme] .dsa-btn-primary{color:#0a1428}
 .dsa-btn:disabled{opacity:.55;cursor:default}
-/* Icon-only variant (the floating layer's collapse/hide controls): square and
-   quiet so the card title bar stays one line and the title keeps the weight. */
+/* Icon-only variant (the floating layer's collapse / delete controls): square
+   and quiet so the card title bar stays one line and the title keeps the weight. */
 .dsa-btn-icon{padding:4px 7px;line-height:1;font-size:13px;color:var(--dsw-alias-label-secondary, #666)}
+/* Destructive confirmation only: the irreversible button carries the error token
+   so it can never be mistaken for the safe one rendered next to it. Placed after
+   .dsa-btn-icon on purpose — same specificity, so source order decides. */
+.dsa-btn-danger{border-color:var(--dsw-alias-state-error-primary, #c0392b);
+  background:var(--dsw-alias-state-error-primary, #c0392b);color:#fff;font-weight:500}
+.dsa-btn-danger:hover{border-color:var(--dsw-alias-state-error-primary, #c0392b);
+  background:var(--dsw-alias-state-error-primary, #c0392b)}
 /* Segmented control (main chat / side card). These are the two destinations an
    answer can land in, so the pair has to read as a radio choice, not as two
    quiet labels: the group gets a recessed track with an explicit mid-grey edge
@@ -2244,11 +2411,18 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
 .dsa-capsule-q{min-width:0;flex:1;color:var(--dsw-alias-label-secondary, #666);
   white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
 .dsa-capsule-chev{flex:none;color:var(--dsw-alias-label-secondary, #888)}
-.dsa-launcher{display:inline-flex;align-items:center;gap:6px;align-self:flex-start;padding:6px 11px;
-  border-radius:999px;cursor:pointer;font:inherit;font-size:12px;line-height:18px;
-  border:1px dashed var(--dsw-alias-border-l2, rgba(127,127,127,.45));
-  background:var(--dsw-alias-bg-overlay, #fff);color:var(--dsw-alias-label-secondary, #666)}
-.dsa-launcher:hover{border-color:var(--dsw-alias-brand-primary, #4c8dff)}
+/* Delete confirmation (2.0.0). Fixed, not inline: a card docked into the right
+   rail lives inside an overflow:hidden page, which would clip a sheet anchored
+   to the card. Same backdrop recipe as the feedback dialog. */
+.dsa-confirm-backdrop{position:fixed;inset:0;z-index:1100;display:flex;align-items:center;
+  justify-content:center;padding:24px;background:rgba(0,0,0,.42)}
+.dsa-confirm{display:flex;flex-direction:column;gap:8px;width:min(360px, 100%);padding:14px 16px;
+  border-radius:12px;border:1px solid var(--dsw-alias-border-l1, rgba(127,127,127,.3));
+  background:var(--dsw-alias-bg-overlay, #fff);color:var(--dsw-alias-label-primary, #111);
+  box-shadow:0 18px 48px rgba(0,0,0,.28)}
+.dsa-confirm-title{font-size:13px;font-weight:600}
+.dsa-confirm-body{font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary, #666)}
+.dsa-confirm > .dsa-row{justify-content:flex-end}
 .dsa-answer{max-height:44vh;overflow:auto;word-break:break-word}
 .dsa-answer .dsa-p{margin:0 0 6px}
 .dsa-answer .dsa-ul{margin:0 0 6px;padding-left:18px}
@@ -2315,6 +2489,42 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
 .dsa-hist-meta{font-size:11px;color:var(--dsw-alias-label-secondary, #777)}
 .dsa-diag{display:flex;flex-direction:column;gap:2px;font-size:12px;
   color:var(--dsw-alias-label-secondary, #555)}
+/* Feedback (settings page), v1.9.1 rebuild: one compact banner at the very top
+   of the page, and a centered dialog for the form. The form used to be an
+   always-visible inline panel here, which pushed every real setting below the
+   fold; the SMTP transport form is gone from the page entirely — the Host reads
+   it from the environment / user config, so there is nothing for an end user to
+   fill in. The dialog is position:fixed with a high z-index because this
+   section is rendered INSIDE the app's settings modal. */
+.dsa-feedback-bar{display:flex;align-items:center;gap:12px;flex-wrap:wrap;padding:12px 14px;
+  border-radius:12px;border:1px solid var(--dsw-alias-brand-primary, #4c8dff);
+  background:var(--dsw-alias-bg-layer-1, rgba(127,127,127,.06))}
+.dsa-feedback-bar-text{display:flex;flex-direction:column;gap:2px;min-width:0;flex:1 1 240px}
+.dsa-feedback-bar-title{font-weight:600;color:var(--dsw-alias-label-primary, #111)}
+.dsa-feedback-bar-hint{font-size:12px;line-height:1.5;
+  color:var(--dsw-alias-label-secondary, #666)}
+.dsa-feedback-bar > .dsa-btn{flex:0 0 auto;margin-left:auto}
+.dsa-feedback-backdrop{position:fixed;inset:0;z-index:1200;display:flex;align-items:center;
+  justify-content:center;padding:24px;background:rgba(0,0,0,.45)}
+.dsa-feedback-dialog{display:flex;flex-direction:column;gap:10px;width:min(560px, 100%);
+  max-height:calc(100vh - 48px);overflow:auto;padding:16px 18px;border-radius:14px;
+  border:1px solid var(--dsw-alias-border-l1, rgba(127,127,127,.3));
+  background:var(--dsw-alias-bg-overlay, rgba(127,127,127,.03));color:inherit;
+  box-shadow:0 18px 48px rgba(0,0,0,.28)}
+.dsa-feedback-dialog-head{display:flex;align-items:center;gap:8px}
+.dsa-feedback-dialog-head > strong{flex:1;min-width:0;font-size:14px}
+.dsa-feedback-dialog-head > .dsa-feedback-close{flex:0 0 auto;width:28px;height:28px;
+  padding:0;line-height:1;font-size:16px}
+.dsa-feedback-dialog-field{display:flex;flex-direction:column;gap:4px}
+.dsa-feedback-dialog-field > label{font-size:12px;
+  color:var(--dsw-alias-label-secondary, #555)}
+.dsa-feedback-dialog-field > textarea{min-height:120px;resize:vertical}
+.dsa-feedback-dialog-actions{display:flex;align-items:center;gap:8px;flex-wrap:wrap}
+.dsa-feedback-dialog-hint{font-size:12px;line-height:1.5;
+  color:var(--dsw-alias-label-secondary, #666)}
+.dsa-feedback-state{font-size:12px;color:var(--dsw-alias-label-secondary, #666)}
+.dsa-feedback-state[data-state="sent"]{color:var(--dsw-alias-state-success-primary, #1a7f37)}
+.dsa-feedback-state[data-state="error"]{color:var(--dsw-alias-state-error-primary, #c0392b)}
 /* §4.5 legacy coexistence: an unmarked dsa-layer can only be the old
    dsh-selection-followup ≤1.0.x build. When this build is the elected
    leader it hides the old build's whole interaction surface so exactly
@@ -3793,15 +4003,70 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
         }, t('close')))
     }
 
+    /**
+     * The confirmation gate for an irreversible action.
+     *
+     * A component rather than an inline block for two reasons: every
+     * destructive control can reuse it, and the test harness cannot drive a
+     * click-driven state change, so rendering it directly is the only way this
+     * markup gets asserted (same seam as {@link FeedbackDialog}).
+     *
+     * The safe choice is the default: Cancel takes focus, Escape aborts, and
+     * only a click on the backdrop itself dismisses — a click that lands on the
+     * dialog must not throw away the decision the user is making.
+     */
+    function DeleteConfirmDialog({ title, body, detail, cancelLabel, confirmLabel, onCancel, onConfirm }) {
+      return h('div', {
+        className: 'dsa-confirm-backdrop',
+        onClick: event => {
+          if (event.target === event.currentTarget) onCancel()
+        },
+        onKeyDown: event => {
+          if (event.key !== 'Escape') return
+          // Escape is the safe exit, so it stops here: the card's own Esc
+          // handler and the global shortcut layer must not also react.
+          event.stopPropagation()
+          onCancel()
+        },
+      },
+      h('div', {
+        className: 'dsa-confirm',
+        role: 'dialog',
+        'aria-modal': 'true',
+        'aria-label': title,
+      },
+      h('strong', { className: 'dsa-confirm-title' }, title),
+      h('div', { className: 'dsa-confirm-body' }, body),
+      detail !== null && detail !== undefined && detail !== '' ? h('div', { className: 'dsa-muted' }, detail) : null,
+      h('div', { className: 'dsa-row' },
+        h('button', {
+          type: 'button',
+          className: 'dsa-btn',
+          // Safe default: a stray Enter on an unreviewed dialog must not
+          // destroy anything.
+          autoFocus: true,
+          onClick: onCancel,
+        }, cancelLabel),
+        h('button', {
+          type: 'button',
+          className: 'dsa-btn dsa-btn-danger',
+          onClick: onConfirm,
+        }, confirmLabel))))
+    }
+
     /**
      * One answer card; `embedded` is true inside a host's tab.
      *
-     * `onFloatMode` is passed ONLY by the floating layer: it renders the
-     * collapse/hide controls that let the user get the layer out of the way
-     * (the layer is the only surface that can cover the conversation). A host
-     * tab that embeds the same card passes no callback and gets no buttons.
+     * `onFloatMode` / `onDelete` are passed ONLY by the floating layer. The
+     * first renders the "collapse to a capsule" control that gets the layer out
+     * of the way (the layer is the only surface that can cover the
+     * conversation); the second renders the × that DELETES this follow-up
+     * conversation — its live card *and* its durable history entry — after a
+     * confirmation. A host tab that embeds the same card passes neither and
+     * keeps its own tab close plus the footer Close button, which by design
+     * detaches the card without touching the history.
      */
-    function AnswerCard({ card, surfaceLabel, onCopy, onFollowUp, onRetry, onRetryEdit, onClose, onCancel, onSendToMain, onFloatMode, onLocate, onExport, onInsert, onReplace, onViewVersion }) {
+    function AnswerCard({ card, surfaceLabel, onCopy, onFollowUp, onRetry, onRetryEdit, onClose, onCancel, onSendToMain, onFloatMode, onDelete, onLocate, onExport, onInsert, onReplace, onViewVersion }) {
       const [followOpen, setFollowOpen] = React.useState(false)
       const [draft, setDraft] = React.useState('')
       // Edit-&-retry editor: prefilled with the card's CURRENT question and
@@ -3809,6 +4074,12 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
       // edit-retry regenerates THIS turn, keeping the card's earlier turns).
       const [editOpen, setEditOpen] = React.useState(false)
       const [editDraft, setEditDraft] = React.useState('')
+      // Deleting a follow-up conversation is irreversible, so it goes through an
+      // in-plugin confirmation — EXCEPT for a card that holds nothing: no
+      // follow-up turn, no answer text, no reasoning, no run in flight. There is
+      // nothing to lose there, and prompting on an empty card only trains the
+      // user to dismiss the prompt that matters.
+      const [deleteOpen, setDeleteOpen] = React.useState(false)
       const answerRef = React.useRef(null)
       const config = store.state.config
       // P2-5b: an older version is READ-ONLY content swapped into the same
@@ -3843,6 +4114,9 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
       // without modifiers and never while composing or inside an editor.
       const onCardKeyDown = (event) => {
         if (event.ctrlKey || event.altKey || event.metaKey || event.isComposing) return
+        // The confirmation is modal: R/C must not act on a card the user is
+        // currently deciding to delete.
+        if (deleteOpen) return
         const tag = String(event.target?.tagName ?? '')
         if (tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'BUTTON'
           || event.target?.closest?.('[contenteditable=""],[contenteditable="true"]') !== null) {
@@ -3871,6 +4145,19 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
       if (typeof card.elapsedMs === 'number' && Number.isFinite(card.elapsedMs) && formatElapsed(card.elapsedMs) !== '') {
         metaBits.push(`${t('metaElapsed')} ${formatElapsed(card.elapsedMs)}`)
       }
+      // "Empty" is judged on the card's own content, never on how it got here.
+      const turns = Array.isArray(card.history) ? card.history.length : 0
+      const busy = card.status === 'pending' || card.status === 'streaming'
+      const nothingToLose = turns === 0
+        && String(card.text ?? '').trim() === ''
+        && String(card.reasoning ?? '').trim() === ''
+      const requestDelete = () => {
+        if (!busy && nothingToLose) {
+          onDelete?.()
+          return
+        }
+        setDeleteOpen(true)
+      }
       return h('section', {
         className: 'dsa-card',
         'aria-label': t('answerTitle'),
@@ -3883,10 +4170,20 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
           h('span', { className: 'dsa-badge' }, zoneLabel(card)),
           surfaceLabel !== null ? h('span', { className: 'dsa-badge' }, surfaceLabel) : null,
           card.truncated ? h('span', { className: 'dsa-badge dsa-badge-warn' }, t('truncatedBadge', { n: card.droppedChars })) : null,
-          typeof onFloatMode === 'function'
+          typeof onFloatMode === 'function' || typeof onDelete === 'function'
             ? h('span', { className: 'dsa-row', style: { marginLeft: 'auto' } },
-              floatControl('capsule', 'floatCollapse', '⇥'),
-              floatControl('off', 'floatHide', '×'))
+              typeof onFloatMode === 'function'
+                ? floatControl('capsule', 'floatCollapse', '⇥')
+                : null,
+              typeof onDelete === 'function'
+                ? h('button', {
+                  type: 'button',
+                  className: 'dsa-btn dsa-btn-icon',
+                  title: t('cardDelete'),
+                  'aria-label': t('cardDelete'),
+                  onClick: () => requestDelete(),
+                }, '×')
+                : null)
             : null),
         h('pre', { className: 'dsa-quote' }, shown.question),
         versions.length > 0
@@ -4037,17 +4334,34 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
           onFollowUp: () => setFollowOpen(open => !open),
           onClose,
         }),
-        surfaceLabel === null ? h('div', { className: 'dsa-muted' }, `${t('carrierSide')} · max ${config.maxChars}`) : null)
+        surfaceLabel === null ? h('div', { className: 'dsa-muted' }, `${t('carrierSide')} · max ${config.maxChars}`) : null,
+        deleteOpen
+          ? h(DeleteConfirmDialog, {
+            title: t('cardDeleteTitle'),
+            body: t('cardDeleteBody'),
+            detail: turns > 0 ? t('cardDeleteRounds', { n: turns }) : null,
+            cancelLabel: t('askCancel'),
+            confirmLabel: t('cardDeleteConfirm'),
+            onCancel: () => setDeleteOpen(false),
+            onConfirm: () => {
+              setDeleteOpen(false)
+              onDelete?.()
+            },
+          })
+          : null)
     }
 
     /**
      * The flow surface, i.e. the floating layer (A).
      *
-     * Three shapes, all sharing one right-anchored container:
+     * Two shapes, both sharing one right-anchored container:
      *   - `capsule`: a single ~34px pill (status + truncated question). The
      *     default, because a one-line pill cannot bury the conversation.
      *   - `full`: the classic card stack, collapsed on demand.
-     *   - `off`: only a small launcher, so nothing covers the page until asked.
+     *
+     * The former `off` shape (hide the layer behind a small launcher) is gone
+     * as of 2.0.0: the card header's × deletes that follow-up conversation
+     * instead, and "hide everything" was never a state this layer needed.
      *
      * The width comes from {@link floatPlacement}, so the layer stops growing
      * left as soon as it would cross the conversation column's right boundary.
@@ -4248,17 +4562,9 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
         onReplace: target => actions.insertAnswer(target ?? card, { replace: true }),
         onViewVersion: index => actions.viewVersion(card, index),
         onFloatMode: setFloatMode,
+        onDelete: () => actions.deleteCard(card),
       }))
 
-      if (mode === 'off') {
-        return container(h('button', {
-          type: 'button',
-          className: 'dsa-launcher',
-          title: t('floatRestore'),
-          onClick: () => setFloatMode('full'),
-        }, dot, t('floatCount', { n: total })))
-      }
-
       if (mode === 'capsule') {
         return container(h('button', {
           type: 'button',
@@ -4272,8 +4578,8 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
 
       // Docked: the card takes the rail's whole rectangle, so it reads as one of
       // the rail's pages rather than a 340px card hovering over it. The card
-      // keeps its own header (title + badges + collapse/hide controls), which is
-      // what makes the page dismissible without leaving the rail.
+      // keeps its own header (title + badges + collapse / delete controls),
+      // which is what makes the page dismissible without leaving the rail.
       return container(h('div', {
         className: 'dsa-stack',
         'data-dsa-dock-body': docked ? String(dock.width) : undefined,
@@ -4328,6 +4634,136 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
         state.toast !== null ? h('div', { className: 'dsa-toast' }, state.toast) : null)
     }
 
+    /**
+     * The feedback dialog (`role="dialog"`).
+     *
+     * Module scope on purpose: the settings page only mounts it while open, and
+     * the contract test renders it directly — the test React shim has no working
+     * setState, so a click-driven open cannot be exercised through the page.
+     * Everything it needs arrives through props, so it is also the one surface
+     * that can be checked without a Host.
+     */
+    function FeedbackDialog(props) {
+      const {
+        t, limits, draft, onChange, status, error, ready, reason, hasRecipient,
+        onClose, onSubmit, onCopy,
+      } = props
+      const sending = status === 'sending'
+      // Escape closes it: a modal without a keyboard exit is a trap.
+      React.useEffect(() => {
+        if (typeof document === 'undefined' || typeof document.addEventListener !== 'function') {
+          return undefined
+        }
+        const onKey = event => { if (event !== null && event?.key === 'Escape') onClose() }
+        document.addEventListener('keydown', onKey)
+        return () => { document.removeEventListener('keydown', onKey) }
+      }, [onClose])
+
+      const field = (label, control) => h('div', { className: 'dsa-feedback-dialog-field' },
+        h('label', null, label),
+        control)
+
+      return h('div', {
+        className: 'dsa-feedback-backdrop',
+        'data-dsa-feedback-dialog': '',
+        onClick: event => {
+          // Only a click on the backdrop itself closes; clicks inside the card
+          // bubble here and must not dismiss a half-written report.
+          if (event !== null && event !== undefined && event.target === event.currentTarget) onClose()
+        },
+      },
+      h('div', {
+        className: 'dsa-feedback-dialog',
+        role: 'dialog',
+        'aria-modal': 'true',
+        'aria-label': t('feedbackDialogTitle'),
+      },
+      h('div', { className: 'dsa-feedback-dialog-head' },
+        h('strong', null, t('feedbackDialogTitle')),
+        h('button', {
+          type: 'button',
+          className: 'dsa-btn dsa-feedback-close',
+          'data-feedback-close': '',
+          title: t('feedbackClose'),
+          'aria-label': t('feedbackClose'),
+          onClick: onClose,
+        }, '×')),
+      h('div', { className: 'dsa-feedback-dialog-field' },
+        h('label', null, t('feedbackKind')),
+        h('select', {
+          className: 'dsa-input',
+          'data-feedback-field': 'kind',
+          value: draft.kind,
+          onChange: event => onChange({ kind: event.target.value }),
+        }, [
+          ['bug', t('feedbackKindBug')],
+          ['idea', t('feedbackKindIdea')],
+          ['question', t('feedbackKindQuestion')],
+          ['other', t('feedbackKindOther')],
+        ].map(([value, label]) => h('option', { key: value, value }, label)))),
+      field(t('feedbackTitle'), h('input', {
+        className: 'dsa-input',
+        'data-feedback-field': 'title',
+        placeholder: t('feedbackTitlePlaceholder'),
+        maxLength: limits.titleMax,
+        value: draft.title,
+        onChange: event => onChange({ title: event.target.value }),
+      })),
+      field(t('feedbackBody'), h('textarea', {
+        className: 'dsa-textarea',
+        'data-feedback-field': 'body',
+        placeholder: t('feedbackBodyPlaceholder'),
+        maxLength: limits.bodyMax,
+        value: draft.body,
+        onChange: event => onChange({ body: event.target.value }),
+      })),
+      // The reporter's own address becomes the mail's `Reply-To:`, never its
+      // `From:` — the relay authenticates as the owner's account and would
+      // reject a foreign sender.
+      field(t('feedbackContact'), h('input', {
+        className: 'dsa-input',
+        'data-feedback-field': 'contact',
+        type: 'email',
+        inputMode: 'email',
+        autoComplete: 'email',
+        placeholder: t('feedbackContactPlaceholder'),
+        maxLength: limits.contactMax,
+        value: draft.contact,
+        onChange: event => onChange({ contact: event.target.value }),
+      })),
+      h('span', { className: 'dsa-feedback-dialog-hint' }, t('feedbackContactHint')),
+      h('span', { className: 'dsa-feedback-dialog-hint' }, t('feedbackEnvNote')),
+      // Readiness: two states, not one. No recipient at all, or a recipient
+      // but no usable transport. When the Host explains why, print its
+      // sentence verbatim.
+      ready === true
+        ? null
+        : h('span', { className: 'dsa-feedback-dialog-hint', 'data-feedback-readiness': 'unready' },
+          String(reason ?? '') !== ''
+            ? String(reason)
+            : (hasRecipient === true ? t('feedbackNoCredentials') : t('feedbackUnconfigured'))),
+      h('div', { className: 'dsa-feedback-dialog-actions' },
+        h('button', {
+          type: 'button',
+          className: 'dsa-btn dsa-btn-primary',
+          'data-feedback-submit': '',
+          disabled: sending,
+          title: ready === true ? undefined : t('feedbackUnconfigured'),
+          onClick: onSubmit,
+        }, sending ? t('feedbackSending') : t('feedbackSend')),
+        h('button', {
+          type: 'button',
+          className: 'dsa-btn',
+          'data-feedback-copy': '',
+          onClick: onCopy,
+        }, t('feedbackCopy'))),
+      status === 'sent'
+        ? h('span', { className: 'dsa-feedback-state', 'data-state': 'sent', role: 'status' }, t('feedbackSent'))
+        : status === 'error'
+          ? h('span', { className: 'dsa-feedback-state', 'data-state': 'error', role: 'status' }, error)
+          : null))
+    }
+
     /** The settings page (`settings.section`). */
     function SettingsSection({ actions }) {
       const state = useStoreState()
@@ -4335,6 +4771,24 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
       const [status, setStatus] = React.useState('idle')
       const [diag, setDiag] = React.useState(null)
       const [historyQuery, setHistoryQuery] = React.useState('')
+      // ── feedback form ──────────────────────────────────────────────────
+      // `idle` → typing; `sending` → one POST in flight (button locked);
+      // `sent` → the draft was cleared; `error` → the draft is KEPT, so a
+      // relay failure never eats what the user just wrote.
+      // Closed by default: the entry must be the first thing on the page and
+      // one click away, but an always-open form pushed every real setting below
+      // the fold (the previous version did exactly that and read as clutter).
+      const [feedbackOpen, setFeedbackOpen] = React.useState(false)
+      const [feedbackDraft, setFeedbackDraft] = React.useState({ kind: 'bug', title: '', body: '', contact: '' })
+      const [feedbackStatus, setFeedbackStatus] = React.useState('idle')
+      const [feedbackError, setFeedbackError] = React.useState('')
+      // Editing is write-only: the saved address is never sent back to this page
+      // (the Host strips it from `/state`), so the form can only replace it.
+      const feedbackInfo = state.capabilities?.feedback ?? null
+      const feedbackSmtp = feedbackInfo?.smtp ?? null
+      const feedbackLimits = feedbackInfo?.limits ?? {
+        titleMin: 4, titleMax: 120, bodyMin: 10, bodyMax: 4000, contactMax: 120,
+      }
       const [notifyPerm, setNotifyPerm] = React.useState(
         typeof notificationPermission === 'function' ? notificationPermission() : 'unsupported')
       const config = state.config
@@ -4362,6 +4816,44 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
         control,
         hint !== undefined ? h('span', { className: 'dsa-muted' }, hint) : null)
 
+      // ── feedback actions ───────────────────────────────────────────────
+      const feedbackUserAgent = typeof navigator === 'undefined' ? '' : String(navigator.userAgent ?? '')
+
+      const submitFeedback = async () => {
+        if (feedbackStatus === 'sending') return
+        const verdict = validateFeedbackDraft(feedbackDraft, feedbackLimits)
+        if (verdict.ok !== true) {
+          setFeedbackStatus('error')
+          setFeedbackError(t(verdict.key, { n: feedbackLimits.contactMax ?? FEEDBACK_DEFAULTS.contactMax }))
+          return
+        }
+        setFeedbackStatus('sending')
+        setFeedbackError('')
+        try {
+          await postJson('feedback', {
+            kind: feedbackDraft.kind,
+            title: feedbackDraft.title.trim(),
+            body: feedbackDraft.body.trim(),
+            contact: feedbackDraft.contact.trim(),
+          })
+          setFeedbackStatus('sent')
+          setFeedbackDraft({ kind: feedbackDraft.kind, title: '', body: '', contact: '' })
+        } catch (error) {
+          setFeedbackStatus('error')
+          setFeedbackError(t('feedbackFailed', { message: localizeError(error) }))
+        }
+      }
+
+      const copyFeedbackDraft = async () => {
+        const text = feedbackPlainTextFor({
+          version: state.version ?? CLIENT_VERSION,
+          draft: feedbackDraft,
+          userAgent: feedbackUserAgent,
+        })
+        const result = await copyText(text, null)
+        toast(result === 'copied' ? t('feedbackCopied') : t('copyFailed'))
+      }
+
       const select = (key, options) => h('select', {
         className: 'dsa-input',
         value: String(draft[key]),
@@ -4588,6 +5080,44 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
           ? h('div', { className: 'dsa-family-notice', role: 'status' }, t('familyLegacyToast'))
           : null)
 
+      // ── feedback entry ─────────────────────────────────────────────────
+      // One compact banner at the very top of the page, and a dialog for the
+      // form. Nothing else about feedback lives on this page: the transport is
+      // the Host's business (environment / user config), so an end user has
+      // nothing to fill in before writing a report. The banner also works when
+      // no SMTP endpoint is configured — the dialog says so in one line and
+      // points at the copy path instead of looking broken.
+      const feedbackConfigured = feedbackInfo !== null && feedbackInfo.configured === true
+      const feedbackBanner = h('div', { className: 'dsa-feedback-bar', 'data-dsa-feedback-section': '' },
+        h('div', { className: 'dsa-feedback-bar-text' },
+          h('div', { className: 'dsa-feedback-bar-title' }, t('setFeedback')),
+          h('div', { className: 'dsa-feedback-bar-hint' }, t('setFeedbackHint'))),
+        h('button', {
+          type: 'button',
+          className: 'dsa-btn dsa-btn-primary',
+          'data-feedback-open': '',
+          'aria-haspopup': 'dialog',
+          'aria-expanded': feedbackOpen ? 'true' : 'false',
+          onClick: () => setFeedbackOpen(true),
+        }, t('feedbackOpen')))
+
+      const feedbackDialog = feedbackOpen !== true
+        ? null
+        : h(FeedbackDialog, {
+          t,
+          limits: feedbackLimits,
+          draft: feedbackDraft,
+          onChange: patch => setFeedbackDraft({ ...feedbackDraft, ...patch }),
+          status: feedbackStatus,
+          error: feedbackError,
+          ready: feedbackConfigured,
+          reason: String(feedbackInfo?.reason ?? ''),
+          hasRecipient: feedbackInfo?.hasRecipient === true,
+          onClose: () => setFeedbackOpen(false),
+          onSubmit: () => { void submitFeedback() },
+          onCopy: () => { void copyFeedbackDraft() },
+        })
+
       // NOT marked `data-dsa-rail-host`: the settings page is not a rail page,
       // and marking it would let the floating layer dock over the settings panel.
       return h('div', { className: 'dsa-settings', 'data-dsa-root': '' },
@@ -4595,6 +5125,7 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
         h('div', null,
           h('div', { className: 'dsa-title' }, t('settingsTitle')),
           h('div', { className: 'dsa-muted' }, t('settingsDesc'))),
+        feedbackBanner,
         familyBanner,
         h('div', { className: 'dsa-grid' },
           field(t('setTrigger'), select('trigger', [
@@ -4622,7 +5153,6 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
           field(t('setFloatMode'), select('floatMode', [
             ['capsule', t('setFloatModeCapsule')],
             ['full', t('setFloatModeFull')],
-            ['off', t('setFloatModeOff')],
           ]), t('setFloatModeHint')),
           field(t('setFloatMaxWidth'), number('floatMaxWidth', 240, 560), t('setFloatMaxWidthHint')),
           field(t('setMinChars'), number('minChars', 0, 200)),
@@ -4753,7 +5283,8 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
                 h('div', { key: 'sidecard' }, `${t('diagSidecard')}: ${describeSurfaces()}`),
                 h('div', { key: 'path' }, `${t('settingsTitle')} → ${diag.provenance?.persistedPath ?? ''}`),
               ])
-          : null)
+          : null,
+        feedbackDialog)
     }
 
     /** Session probe: an invisible entry in the composer tool row. */
@@ -5092,7 +5623,7 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
             } else {
               store.set({ cards: [historyEntryToCard(entry), ...store.state.cards] })
             }
-            // A hidden (off/capsule) layer would swallow the restored card;
+            // A collapsed (capsule) layer would swallow the restored card;
             // this is a session-only override, exactly like clicking expand.
             setFloatMode('full')
             toast(t('historyRestored'))
@@ -5110,6 +5641,57 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
             })
             toast(t('historyDeleted'))
           },
+          /**
+           * Delete ONE follow-up conversation: the live card AND its durable
+           * history entry. This is the card header's ×.
+           *
+           * Deliberately stronger than {@link actions.close}: closing only
+           * detaches the card from the live surface and keeps the history entry
+           * on purpose (#6), while this removes the same id from both stores and
+           * persists immediately, so a reload cannot resurrect it.
+           *
+           * An in-flight run is released first: the browser stream is aborted,
+           * the Host child is told to cancel, and the card's buffered deltas are
+           * dropped — a late flush would otherwise re-append text to a card that
+           * no longer exists.
+           */
+          deleteCard(card) {
+            const id = card?.id
+            if (typeof id !== 'string' || id === '') return false
+            const controller = controllers.get(id)
+            if (controller !== undefined) {
+              controller.abort()
+              void postJson('cancel', { id }).catch(() => {})
+            }
+            controllers.delete(id)
+            pendingDeltas.delete(id)
+            pendingReasonings.delete(id)
+            // Every surface gets the same chance to close its own container as
+            // it does on close(): an orphaned tab reads to the user as a card
+            // that refused to die.
+            if (card.surface === 'better-sidebar') {
+              try {
+                surfaces.better.close(card)
+              } catch { /* the host may already be gone */ }
+            } else if (card.surface === 'native-rightbar') {
+              try {
+                surfaces.native.close(card)
+              } catch { /* the right rail owns its lifecycle */ }
+            }
+            const next = store.state.history
+              .filter(item => item.id !== id)
+              .slice(0, historyCap())
+            // cap === 0 means "nothing is persisted": leave the stored key alone
+            // rather than writing an empty payload over it (same rule as
+            // syncPersisted).
+            if (historyCap() > 0) writePersisted(next)
+            store.set({
+              history: next,
+              cards: store.state.cards.filter(item => item.id !== id),
+            })
+            toast(t('cardDeleted'))
+            return true
+          },
           /**
            * Empty the durable history without touching running cards.
            *
@@ -5491,6 +6073,15 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
               problems: value.problems ?? [],
               provenance: value.provenance ?? null,
             })
+            // Readiness hints (the feedback card's "缺的只是发信凭据", the surface
+            // list, → live in `capabilities`, which only `/state` reports. Without
+            // this refresh the page kept telling the user the transport was
+            // missing right after they had saved it.
+            try {
+              await refreshState()
+            } catch {
+              // The save itself succeeded; a failed re-read must not undo that.
+            }
             return value
           },
           async resetConfig() {
@@ -6271,6 +6862,14 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
         }, 'sidecard-ask: client activation')
       },
 
+      /**
+       * Test seam: components that can be rendered on their own. The feedback
+       * dialog and the delete confirmation both live here because their host
+       * mounts them only while open and the test shim has no working setState,
+       * so a simulated click cannot reach them.
+       */
+      components: Object.freeze({ FeedbackDialog, DeleteConfirmDialog }),
+
       /**
        * Test seam: pure helpers, frozen. The DSH client runtime only reads
        * `inject`/`apply`; `test/*.mjs` loads this file with a synthetic
@@ -6294,6 +6893,10 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
           quickActionsOf,
           renderActionQuestion,
           validateQuickActionsDraft,
+          validateFeedbackDraft,
+          feedbackSubjectFor,
+          feedbackPlainTextFor,
+            FEEDBACK_DEFAULTS,
           shortcutFingerprint,
           followUpChips,
           formatElapsed,