dsh-transfer-hud 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xiuerhuahuazi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,182 @@
-# Temporary Holding Version
+# dsh-transfer-hud
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+English | [中文](#中文)
+
+A thin strip below the message composer that shows what DeepSeek Harness is downloading
+right now. Zero runtime dependencies; a Host half (`index.js`) plus a Web Client half
+(`client.js`). Also stops (background) downloads from the strip.
+
+> **Version:** this npm release is **1.0.0** and packages the workspace HUD revision
+> **v1.1.1** (refined download classifier). The first public release renumbers the
+> internal revision to 1.0.0.
+
+## English
+
+### What it shows
+
+| Source | Row | Progress |
+|---|---|---|
+| **Background jobs** (`ctx.jobs`: `pwsh`/`bash` jobs started with `run_in_background`, or promoted after a timeout) | real job row: label, status, **Stop** button | percent / bytes / rate / ETA when the output ring carries a meter (curl, wget, aria2, tqdm / `hf download`, huggingface, modelscope, `git` counters, …), parsed from **stdout and stderr** — most downloaders print their meter to stderr |
+| **Foreground shell commands** (`pwsh`, `bash`, `ops_bash`, `terminal_send`, …) | indeterminate row (`foreground: true`, no Stop button) | none — the Host only sees the call, not its live output; the row proves a download is running and disappears shortly after the tool result |
+
+When a foreground call starts a background job (`run_in_background: true`, or a
+foreground command promoted on timeout), the job row replaces the foreground row: the
+Host reads `job/registered`'s `toolCall.callId` and dedupes.
+
+### What counts as a download
+
+The classifier is deliberately narrow so ordinary API traffic never shows a row:
+
+- **Unambiguous downloaders** in command position (optional `sudo`/`nohup`/`time`/
+  `timeout`/`VAR=` wrappers): `aria2c`, `yt-dlp`, `youtube-dl`, `scp`, `sftp`, `rsync`,
+  `axel`, `hf` / `huggingface-cli` / `snapshot_download` / `modelscope`,
+  `git clone` / `git lfs`, `pip download` / `pip install`, PowerShell
+  `Start-BitsTransfer` / `bitsadmin` / `DownloadFile` / `DownloadString` / `DownloadData`,
+  `[System.Net.WebClient]` / `[System.Net.HttpClient]`.
+- **Dual-use `curl` / `wget` / `Invoke-WebRequest` / `iwr`** count only with real download
+  intent: an explicit output flag (`-o`, `-O`, `--output`, `--remote-name`,
+  `--remote-header-name`, `-J`, or a short-flag cluster like `-sSLo`; `-OutFile` for
+  `iwr`), **or** a non-loopback URL whose path ends in a file-like extension
+  (`.bin .zip .tar .tgz .gz .bz2 .xz .zst .7z .rar .whl .exe .msi .iso .dmg .pkg .deb .rpm
+  .apk .safetensors .gguf .ckpt .onnx .pt .pth .model .mp4 .mkv .webm .npy .npz .parquet
+  .arrow .h5 .hdf5 .tflite .mlmodel`).
+- **Ignored on purpose:** loopback / `localhost` / `127.*` / `::1` / `0.0.0.0` URLs without
+  an output flag (API polls), and JSON / JSONL / CSV responses — those are API payloads,
+  not downloads.
+- The downloader must sit in command position, so `grep -r curl src/` or `cat download.md`
+  are ignored. An opaque call such as `python fetch.py` is recognised only when the call's
+  description says "download/fetch/…" or its file/URL matches a known artifact pattern.
+
+### Install
+
+Requires DeepSeek Harness `>=0.2.1-rc.2 <0.3.0-0` and a Web or Desktop profile
+(the plugin has a Host half and a browser Client half).
+
+1. Open **Settings → Plugins**, install bundle `dsh-transfer-hud@1.0.0`.
+2. Or ask the agent: `plugin_manager` → `action: "install_bundle"`,
+   `target: "dsh-transfer-hud@1.0.0"`.
+
+**Restart the app after installing or upgrading.** HMR applies a new bundle, but the
+profile's Host watch roots are empty (`root: []`) and a replaced package needs a fresh
+JavaScript module generation, so the new Host code is loaded on restart; the Client half
+then follows with the usual client HMR / page refresh. Verification: after the restart,
+run a foreground download (e.g. `curl -o file.bin <url>`) or a background job
+(`run_in_background: true`) and the strip appears below the composer. Remove the bundle to
+uninstall.
+
+### Configuration
+
+None. The row takes no config; the strip is automatic and only reads activity that
+already belongs to this Harness.
+
+### Limits
+
+- **Foreground downloads are indeterminate.** A foreground tool call exposes no live
+  output to the Host, so there is no percent/rate/ETA — only "a download is running".
+- **Session-scoped.** Rows belong to the session the strip is mounted in. A download
+  started by a subagent/teammate session is not shown in the parent conversation.
+- **Opaque scripts need a hint.** See "What counts as a download" above.
+- **No progress output, no meter.** `Invoke-WebRequest` with
+  `$ProgressPreference = 'SilentlyContinue'` prints nothing to parse; the row still
+  appears from the label hint but stays indeterminate.
+- **Stop only stops background jobs.** A foreground command cannot be killed from the
+  HUD; it follows its own approval/timeout/cancellation path.
+- UI rendering (strip/panel layout) can only be verified in a browser.
+
+### Development
+
+Host and Client test harnesses live in `test/` in the source repository and are excluded
+from the published tarball:
+
+```sh
+node plugins/dsh-transfer-hud/test/host.test.mjs
+node plugins/dsh-transfer-hud/test/client.test.mjs
+```
+
+### License
+
+MIT.
+
+## 中文
+
+消息输入框下方的一条细长下载进度条，显示本 Harness 当前正在下载的内容，并可从进度条上
+停止（后台）任务。零运行时依赖，由 Host 半（`index.js`）与 Web Client 半（`client.js`）组成。
+
+> **版本**：本次 npm 发布为 **1.0.0**，打包的是工作区 HUD **v1.1.1**（细化后的下载分类器）；
+> 首次公开发布将内部修订号重编为 1.0.0。
+
+### 显示内容
+
+| 来源 | 行 | 进度 |
+|---|---|---|
+| **后台任务**（`ctx.jobs`：用 `run_in_background` 启动、或超时转后台的 `pwsh`/`bash` 任务） | 真实任务行：标签、状态、**停止**按钮 | 输出环携带进度时显示百分比/字节/速度/剩余时间（curl、wget、aria2、tqdm / `hf download`、huggingface、modelscope、`git` 计数……），同时解析 **stdout 与 stderr**——多数下载器把进度打印到 stderr |
+| **前台 shell 命令**（`pwsh`、`bash`、`ops_bash`、`terminal_send`……） | 不确定行（`foreground: true`，无停止按钮） | 无——Host 只能看到调用，看不到其运行中的输出；该行用于表明正在下载，并在工具结果返回后不久消失 |
+
+当前台调用启动后台任务（`run_in_background: true`，或超时转后台）时，任务行会替换前台行：
+Host 读取 `job/registered` 的 `toolCall.callId` 去重。
+
+### 什么算作下载
+
+分类器刻意收窄，普通 API 流量不会出现行：
+
+- **无歧义下载器**（位于命令位置，可带 `sudo`/`nohup`/`time`/`timeout`/`VAR=` 前缀）：
+  `aria2c`、`yt-dlp`、`youtube-dl`、`scp`、`sftp`、`rsync`、`axel`、`hf` /
+  `huggingface-cli` / `snapshot_download` / `modelscope`、`git clone` / `git lfs`、
+  `pip download` / `pip install`、PowerShell `Start-BitsTransfer` / `bitsadmin` /
+  `DownloadFile` / `DownloadString` / `DownloadData`、`[System.Net.WebClient]` /
+  `[System.Net.HttpClient]`。
+- **两用的 `curl` / `wget` / `Invoke-WebRequest` / `iwr`** 只有具备真实下载意图才计入：
+  显式输出参数（`-o`、`-O`、`--output`、`--remote-name`、`--remote-header-name`、`-J`，
+  或 `-sSLo` 这类短参数组合；`iwr` 的 `-OutFile`），**或**非回环 URL 的路径以文件类扩展名
+  结尾（`.bin .zip .tar .tgz .gz .bz2 .xz .zst .7z .rar .whl .exe .msi .iso .dmg .pkg
+  .deb .rpm .apk .safetensors .gguf .ckpt .onnx .pt .pth .model .mp4 .mkv .webm .npy .npz
+  .parquet .arrow .h5 .hdf5 .tflite .mlmodel`）。
+- **有意忽略**：无输出参数时访问回环/`localhost`/`127.*`/`::1`/`0.0.0.0` 的 URL（API 轮询），
+  以及 JSON / JSONL / CSV 响应——那是 API 载荷而不是下载。
+- 下载器必须位于命令位置，因此 `grep -r curl src/`、`cat download.md` 不会被误判。
+  `python fetch.py` 这类不透明调用只有描述包含 download/fetch 等词、或文件/URL 命中已知
+  产物模式时才会被识别。
+
+### 安装
+
+需要 DeepSeek Harness `>=0.2.1-rc.2 <0.3.0-0`，以及 Web 或 Desktop profile
+（插件同时包含 Host 半与浏览器 Client 半）。
+
+1. 打开 **设置 → 插件**，安装 bundle `dsh-transfer-hud@1.0.0`。
+2. 或让 agent 调用：`plugin_manager` → `action: "install_bundle"`，
+   `target: "dsh-transfer-hud@1.0.0"`。
+
+**安装或升级后请重启应用。** HMR 会应用新的 bundle，但该 profile 的 Host watch root 为空
+（`root: []`），且替换已安装的包需要新的 JavaScript 模块代号，因此新的 Host 代码要重启后
+才加载；Client 半随后走常规的 client HMR / 页面刷新。验证方式：重启后运行一个前台下载
+（如 `curl -o file.bin <url>`）或后台任务（`run_in_background: true`），输入框下方会出现
+进度条。移除该 bundle 即卸载。
+
+### 配置
+
+无。该行不需要配置，进度条自动出现，且只读取本 Harness 自身已有的活动。
+
+### 限制
+
+- **前台下载是不确定的**：前台工具调用不向 Host 暴露运行中输出，所以没有百分比/速度/
+  剩余时间，只表示“正在下载”。
+- **按会话隔离**：行属于进度条挂载的会话；子代理/队友会话发起的下载不会显示在父会话中。
+- **不透明脚本需要提示**：见上文“什么算作下载”。
+- **没有进度输出就没有进度**：`Invoke-WebRequest` 在
+  `$ProgressPreference = 'SilentlyContinue'` 下不打印可解析内容；行仍会按标签提示出现，
+  但保持不确定状态。
+- **停止只作用于后台任务**：前台命令无法从进度条取消，它遵循自身的审批/超时/取消机制。
+- 界面渲染（进度条/浮层布局）只能在浏览器中验证。
+
+### 开发
+
+Host 与 Client 的测试位于源码仓库的 `test/`，不包含在发布的 tarball 中：
+
+```sh
+node plugins/dsh-transfer-hud/test/host.test.mjs
+node plugins/dsh-transfer-hud/test/client.test.mjs
+```
+
+### 许可证
+
+MIT。

package/client.js

@@ -0,0 +1,445 @@
+/**
+ * Download HUD — Client half.
+ *
+ * A thin, space-free strip below the message composer that appears only while a
+ * background job looks like a download. Clicking it opens a details popover with
+ * per-job progress, throughput, remaining time and a stop action.
+ *
+ * Data comes from the Host half's same-origin route; this module renders only.
+ */
+
+window.__ModuleLoader__.load({
+  id: 'dsh-transfer-hud',
+  factory(require) {
+    const React = require('react')
+    const h = React.createElement
+    const { useCallback, useEffect, useMemo, useRef, useState } = React
+
+    const STATE_URL = '/dsh-download-hud/state'
+    const KILL_URL = '/dsh-download-hud/kill'
+    const POLL_MS = 1000
+    const LINGER_MS = 15000
+    const PANEL_MAX_WIDTH = 520
+
+    const TEXT = {
+      en: {
+        live: 'Downloading',
+        jobs: 'downloads',
+        stopped: 'Stopped',
+        done: 'Done',
+        failed: 'Failed',
+        eta: 'left',
+        stop: 'Stop',
+        stopping: 'Stopping…',
+        noProgress: 'running',
+        details: 'Downloads',
+        elapsed: 'elapsed',
+        command: 'command',
+      },
+      zh: {
+        live: '下载中',
+        jobs: '个下载',
+        stopped: '已停止',
+        done: '已完成',
+        failed: '失败',
+        eta: '剩余',
+        stop: '取消',
+        stopping: '正在停止…',
+        noProgress: '运行中',
+        details: '下载任务',
+        elapsed: '已用时',
+        command: '命令',
+      },
+    }
+
+    const CSS = `
+.ddh-strip{position:relative;display:flex;align-items:center;gap:6px;box-sizing:border-box;flex:1 1 auto;min-width:220px;max-width:680px;padding:3px 2px 3px;color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px;cursor:pointer;background:transparent;border:0;border-radius:5px;text-align:left;font-family:inherit}
+.ddh-strip:hover{color:var(--dsw-alias-label-primary)}
+.ddh-line{display:flex;align-items:center;gap:6px;min-width:0;flex:1}
+.ddh-icon{flex:none;display:inline-flex;color:var(--dsw-alias-brand-primary)}
+.ddh-label{flex:none;font-weight:500}
+.ddh-meta{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--dsw-alias-label-secondary)}
+.ddh-chevron{flex:none;display:inline-flex;transition:transform .12s ease}
+.ddh-chevron-open{transform:rotate(180deg)}
+.ddh-track{position:absolute;left:2px;bottom:1px;height:2px;border-radius:1px;max-width:calc(100% - 4px);background:var(--dsw-alias-brand-primary);transition:width .25s ease}
+.ddh-track-done{background:var(--dsw-alias-state-success-primary)}
+.ddh-track-failed{background:var(--dsw-alias-state-error-primary)}
+.ddh-fill{height:100%;border-radius:2px;background:var(--dsw-alias-brand-primary);transition:width .25s ease}
+.ddh-fill-done{background:var(--dsw-alias-state-success-primary)}
+.ddh-fill-failed{background:var(--dsw-alias-state-error-primary)}
+.ddh-panel{position:fixed;z-index:120;display:flex;flex-direction:column;box-sizing:border-box;background:var(--dsw-alias-bg-layer-1);border:0.5px solid var(--dsw-alias-border-l2);border-radius:10px;box-shadow:0 10px 32px rgba(0,0,0,.28);overflow:hidden;font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary)}
+.ddh-panel-head{display:flex;align-items:center;justify-content:space-between;gap:8px;padding:8px 12px 6px;color:var(--dsw-alias-label-tertiary);font-size:11px;border-bottom:0.5px solid var(--dsw-alias-border-l1)}
+.ddh-rows{display:flex;flex-direction:column;max-height:min(420px,60vh);overflow:auto;padding:2px 0}
+.ddh-row{display:flex;flex-direction:column;gap:2px;padding:7px 12px;min-width:0}
+.ddh-row + .ddh-row{border-top:0.5px solid var(--dsw-alias-border-l1)}
+.ddh-row-top{display:flex;align-items:center;gap:8px;min-width:0}
+.ddh-dot{flex:none;width:6px;height:6px;border-radius:50%;background:var(--dsw-alias-brand-primary)}
+.ddh-dot-done{background:var(--dsw-alias-state-success-primary)}
+.ddh-dot-failed{background:var(--dsw-alias-state-error-primary)}
+.ddh-dot-idle{background:var(--dsw-alias-state-idle-primary)}
+.ddh-row-name{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--dsw-alias-label-primary)}
+.ddh-row-pct{flex:none;font-variant-numeric:tabular-nums;color:var(--dsw-alias-label-secondary)}
+.ddh-stop{flex:none;border:0;background:transparent;color:var(--dsw-alias-label-tertiary);cursor:pointer;font:inherit;padding:1px 6px;border-radius:5px}
+.ddh-stop:hover{background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-state-error-primary)}
+.ddh-stop:disabled{opacity:.5;cursor:default}
+.ddh-row-sub{display:flex;gap:10px;min-width:0;overflow:hidden;white-space:nowrap;text-overflow:ellipsis;color:var(--dsw-alias-label-tertiary);font-size:11px;font-variant-numeric:tabular-nums}
+.ddh-row-bar{height:2px;border-radius:1px;background:var(--dsw-alias-border-l1);overflow:hidden;margin-top:2px}
+.ddh-note{padding:8px 12px;color:var(--dsw-alias-state-error-primary);font-size:11px}
+`
+
+    function pickLocale(ctx) {
+      const language = (() => {
+        try {
+          const snapshot = ctx.locale.getLocale()
+          const id = snapshot && (snapshot.id || snapshot.locale || snapshot.current)
+          if (typeof id === 'string' && id) return id
+        } catch {}
+        try {
+          return navigator.language || 'en'
+        } catch {
+          return 'en'
+        }
+      })()
+      return String(language).toLowerCase().startsWith('zh') ? 'zh' : 'en'
+    }
+
+    function formatBytes(value) {
+      if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) return ''
+      const units = ['B', 'KB', 'MB', 'GB', 'TB']
+      let amount = value
+      let index = 0
+      while (amount >= 1024 && index < units.length - 1) {
+        amount /= 1024
+        index += 1
+      }
+      const digits = index === 0 ? 0 : amount >= 100 ? 0 : 1
+      return `${amount.toFixed(digits)} ${units[index]}`
+    }
+
+    function formatDuration(seconds) {
+      if (typeof seconds !== 'number' || !Number.isFinite(seconds) || seconds < 0) return ''
+      const total = Math.round(seconds)
+      if (total < 60) return `${total}s`
+      const minutes = Math.floor(total / 60)
+      if (minutes < 60) return `${minutes}m ${String(total % 60).padStart(2, '0')}s`
+      const hours = Math.floor(minutes / 60)
+      return `${hours}h ${String(minutes % 60).padStart(2, '0')}m`
+    }
+
+    function isLive(job) {
+      return job.status === 'running' || job.status === 'stopping'
+    }
+
+    function statusText(job, text) {
+      if (job.status === 'completed') return text.done
+      if (job.status === 'failed') return text.failed
+      if (job.status === 'killed') return text.stopped
+      if (job.status === 'stopping') return text.stopping
+      return text.live
+    }
+
+    function visibleJobs(state, now) {
+      const jobs = state && Array.isArray(state.jobs) ? state.jobs : []
+      return jobs.filter((job) => {
+        if (!job || job.download !== true) return false
+        if (isLive(job)) return true
+        const finishedAt = typeof job.finishedAt === 'number' ? job.finishedAt : 0
+        return finishedAt > 0 && now - finishedAt < LINGER_MS
+      })
+    }
+
+    function aggregate(jobs) {
+      const live = jobs.filter(isLive)
+      let done = 0
+      let total = 0
+      let percentSum = 0
+      let percentCount = 0
+      let rate = 0
+      let eta = 0
+      for (const job of live) {
+        if (typeof job.done === 'number' && typeof job.total === 'number' && job.total > 0) {
+          done += job.done
+          total += job.total
+        } else if (typeof job.percent === 'number') {
+          percentSum += job.percent
+          percentCount += 1
+        }
+        if (typeof job.rateBps === 'number') rate += job.rateBps
+        if (typeof job.etaSeconds === 'number' && job.etaSeconds > eta) eta = job.etaSeconds
+      }
+      let percent = null
+      if (total > 0) percent = Math.round((done / total) * 1000) / 10
+      else if (percentCount > 0) percent = Math.round((percentSum / percentCount) * 10) / 10
+      return { live, done, total, percent, rate, eta }
+    }
+
+    function createDownloadHud(ctx, text) {
+      return function DownloadHud(props) {
+        const sessionId = useMemo(() => {
+          const candidates = [props && props.sessionId, props && props.session && props.session.id]
+          for (const candidate of candidates) {
+            if (typeof candidate === 'string' && candidate) return candidate
+          }
+          return ''
+        }, [props && props.sessionId])
+
+        const [state, setState] = useState(null)
+        const [open, setOpen] = useState(false)
+        const [busyId, setBusyId] = useState('')
+        const [nowTick, setNowTick] = useState(() => Date.now())
+        const stripRef = useRef(null)
+        const panelRef = useRef(null)
+        const [anchor, setAnchor] = useState(null)
+
+        const url = useMemo(() => {
+          return sessionId ? `${STATE_URL}?sessionId=${encodeURIComponent(sessionId)}` : STATE_URL
+        }, [sessionId])
+
+        useEffect(() => {
+          let cancelled = false
+          let timer = 0
+          const tick = () => {
+            if (typeof document !== 'undefined' && document.hidden) return
+            fetch(url, { headers: { accept: 'application/json' }, cache: 'no-store' })
+              .then((response) => (response.ok ? response.json() : null))
+              .then((data) => {
+                if (cancelled || !data) return
+                setState(data)
+                setNowTick(Date.now())
+              })
+              .catch(() => {})
+          }
+          tick()
+          timer = setInterval(tick, POLL_MS)
+          // A hidden tab pauses polling; catch up as soon as it is visible so a
+          // download that started while the window was in the background shows.
+          const onVisible = () => {
+            if (typeof document === 'undefined' || document.hidden) return
+            tick()
+          }
+          if (typeof document !== 'undefined') document.addEventListener('visibilitychange', onVisible)
+          return () => {
+            cancelled = true
+            clearInterval(timer)
+            if (typeof document !== 'undefined') document.removeEventListener('visibilitychange', onVisible)
+          }
+        }, [url])
+
+        const jobs = visibleJobs(state, nowTick)
+        const totals = aggregate(jobs)
+
+        const measure = useCallback(() => {
+          const node = stripRef.current
+          if (!node) return
+          const rect = node.getBoundingClientRect()
+          const width = Math.min(PANEL_MAX_WIDTH, Math.max(260, rect.width))
+          const left = Math.min(
+            Math.max(8, rect.left),
+            Math.max(8, (typeof window === 'undefined' ? rect.left + width : window.innerWidth) - width - 8),
+          )
+          setAnchor({
+            left,
+            width,
+            bottom: typeof window === 'undefined' ? 0 : window.innerHeight - rect.top + 6,
+          })
+        }, [])
+
+        useEffect(() => {
+          if (!open) return undefined
+          measure()
+          const onResize = () => measure()
+          window.addEventListener('resize', onResize)
+          window.addEventListener('scroll', onResize, true)
+          const onDown = (event) => {
+            const node = event.target
+            if (stripRef.current && stripRef.current.contains(node)) return
+            if (panelRef.current && panelRef.current.contains(node)) return
+            setOpen(false)
+          }
+          const onKey = (event) => {
+            if (event.key === 'Escape') setOpen(false)
+          }
+          document.addEventListener('mousedown', onDown)
+          document.addEventListener('keydown', onKey)
+          return () => {
+            window.removeEventListener('resize', onResize)
+            window.removeEventListener('scroll', onResize, true)
+            document.removeEventListener('mousedown', onDown)
+            document.removeEventListener('keydown', onKey)
+          }
+        }, [open, measure])
+
+        const stop = useCallback((job) => {
+          if (!job || !job.id || busyId) return
+          setBusyId(job.id)
+          fetch(KILL_URL, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ id: job.id, sessionId: job.owner || sessionId || undefined }),
+          })
+            .catch(() => {})
+            .finally(() => setBusyId(''))
+        }, [busyId, sessionId])
+
+        if (jobs.length === 0) return null
+
+        const single = totals.live.length === 1 ? totals.live[0] : null
+        const percent = totals.percent === null ? (single && single.percent !== null ? single.percent : null) : totals.percent
+        const parts = []
+        if (jobs.length === 1) {
+          parts.push(`${totals.live.length === 0 ? statusText(jobs[0], text) : text.live} · ${jobs[0].label}`)
+        } else {
+          parts.push(`${text.live} ${totals.live.length || jobs.length} ${text.jobs}`)
+        }
+        if (typeof percent === 'number') parts.push(`${percent}%`)
+        if (totals.total > 0) parts.push(`${formatBytes(totals.done)} / ${formatBytes(totals.total)}`)
+        if (totals.rate > 0 && totals.live.length > 0) parts.push(`${formatBytes(totals.rate)}/s`)
+        if (totals.eta > 0 && totals.live.length > 0) parts.push(`${text.eta} ${formatDuration(totals.eta)}`)
+
+        const worst = jobs.some((job) => job.status === 'failed')
+          ? 'failed'
+          : jobs.every((job) => job.status === 'completed')
+            ? 'done'
+            : 'live'
+        const barWidth = typeof percent === 'number' ? Math.max(1.5, Math.min(100, percent)) : 12
+        const barClass = worst === 'failed' ? 'ddh-fill ddh-fill-failed' : worst === 'done' ? 'ddh-fill ddh-fill-done' : 'ddh-fill'
+        const trackClass = worst === 'failed' ? 'ddh-track ddh-track-failed' : worst === 'done' ? 'ddh-track ddh-track-done' : 'ddh-track'
+        const chevronClass = open ? 'ddh-chevron ddh-chevron-open' : 'ddh-chevron'
+
+        const panel = open && anchor
+          ? h('div', {
+            ref: panelRef,
+            className: 'ddh-panel',
+            role: 'dialog',
+            'aria-label': text.details,
+            style: { left: `${anchor.left}px`, bottom: `${anchor.bottom}px`, width: `${anchor.width}px` },
+          }, [
+            h('div', { key: 'head', className: 'ddh-panel-head' }, [
+              h('span', { key: 'title' }, text.details),
+              h('span', { key: 'count' }, `${jobs.length}`),
+            ]),
+            h('div', { key: 'rows', className: 'ddh-rows' }, jobs.map((job) => {
+              const dotSuffix = job.status === 'completed' ? ' ddh-dot-done'
+                : job.status === 'failed' ? ' ddh-dot-failed'
+                  : isLive(job) ? '' : ' ddh-dot-idle'
+              const rowPercent = typeof job.percent === 'number'
+                ? `${Math.round(job.percent * 10) / 10}%`
+                : (isLive(job) ? text.noProgress : '')
+              const sub = []
+              if (job.foreground) sub.push(text.command)
+              if (typeof job.done === 'number' && typeof job.total === 'number' && job.total > 0) {
+                sub.push(`${formatBytes(job.done)} / ${formatBytes(job.total)}`)
+              }
+              if (typeof job.rateBps === 'number' && job.rateBps > 0) sub.push(`${formatBytes(job.rateBps)}/s`)
+              if (typeof job.etaSeconds === 'number' && job.etaSeconds > 0 && isLive(job)) {
+                sub.push(`${text.eta} ${formatDuration(job.etaSeconds)}`)
+              }
+              if (!isLive(job)) sub.push(statusText(job, text))
+              else sub.push(`${text.elapsed} ${formatDuration((job.elapsedMs || 0) / 1000)}`)
+              const rowPercentValue = typeof job.percent === 'number' ? Math.max(1.5, Math.min(100, job.percent)) : 0
+              return h('div', { key: job.id, className: 'ddh-row' }, [
+                h('div', { key: 'top', className: 'ddh-row-top' }, [
+                  h('span', { key: 'dot', className: `ddh-dot${dotSuffix}` }),
+                  h('span', { key: 'name', className: 'ddh-row-name', title: job.fullLabel || job.label }, job.label),
+                  rowPercent ? h('span', { key: 'pct', className: 'ddh-row-pct' }, rowPercent) : null,
+                  isLive(job) && job.killable !== false
+                    ? h('button', {
+                      key: 'stop',
+                      type: 'button',
+                      className: 'ddh-stop',
+                      disabled: busyId === job.id,
+                      onClick: (event) => {
+                        event.stopPropagation()
+                        stop(job)
+                      },
+                    }, text.stop)
+                    : null,
+                ]),
+                h('div', { key: 'sub', className: 'ddh-row-sub' }, sub.join(' · ')),
+                rowPercentValue > 0
+                  ? h('div', { key: 'bar', className: 'ddh-row-bar' }, [
+                    h('div', {
+                      className: job.status === 'failed' ? 'ddh-fill ddh-fill-failed' : 'ddh-fill',
+                      style: { width: `${rowPercentValue}%` },
+                    }),
+                  ])
+                  : null,
+              ])
+            })),
+            state && Array.isArray(state.warnings) && state.warnings.length > 0
+              ? h('div', { key: 'note', className: 'ddh-note' }, String(state.warnings[state.warnings.length - 1]))
+              : null,
+          ])
+          : null
+
+        return h(React.Fragment, null, [
+          h('button', {
+            key: 'strip',
+            ref: stripRef,
+            type: 'button',
+            className: 'ddh-strip',
+            'aria-expanded': open ? 'true' : 'false',
+            onClick: () => setOpen((previous) => !previous),
+          }, [
+            h('span', { key: 'line', className: 'ddh-line' }, [
+              h('span', { key: 'icon', className: 'ddh-icon', 'aria-hidden': 'true' }, [
+                h('svg', { key: 'svg', width: 14, height: 14, viewBox: '0 0 16 16', fill: 'none' }, [
+                  h('path', {
+                    d: 'M8 2v7', stroke: 'currentColor', strokeWidth: '1.6', strokeLinecap: 'round',
+                  }),
+                  h('path', {
+                    d: 'M4.8 6.4 8 9.6l3.2-3.2', stroke: 'currentColor', strokeWidth: '1.6',
+                    strokeLinecap: 'round', strokeLinejoin: 'round',
+                  }),
+                  h('path', {
+                    d: 'M3 12.5h10', stroke: 'currentColor', strokeWidth: '1.6', strokeLinecap: 'round',
+                  }),
+                ]),
+              ]),
+              h('span', { key: 'meta', className: 'ddh-meta' }, parts.join(' · ')),
+              h('span', { key: 'chevron', className: chevronClass, 'aria-hidden': 'true' }, [
+                h('svg', { key: 'svg', width: 12, height: 12, viewBox: '0 0 16 16', fill: 'none' }, [
+                  h('path', {
+                    d: 'M4 6.5 8 10.5l4-4', stroke: 'currentColor', strokeWidth: '1.5',
+                    strokeLinecap: 'round', strokeLinejoin: 'round',
+                  }),
+                ]),
+              ]),
+            ]),
+            typeof percent === 'number'
+              ? h('span', {
+                key: 'track',
+                className: trackClass,
+                style: { width: `${barWidth}%` },
+              })
+              : null,
+          ]),
+          panel,
+        ])
+      }
+    }
+
+    return {
+      inject: ['slots', 'locale'],
+      apply(ctx) {
+        const text = TEXT[pickLocale(ctx)]
+        const Component = createDownloadHud(ctx, text)
+        ctx.effect(() => {
+          const tag = document.createElement('style')
+          tag.dataset.plugin = 'dsh-transfer-hud'
+          tag.dataset.pluginCss = 'dsh-transfer-hud/hud.css'
+          tag.textContent = CSS
+          document.head.appendChild(tag)
+          return () => {
+            if (tag.parentNode) tag.parentNode.removeChild(tag)
+          }
+        })
+        ctx.slots.inject('conversation.composer.dock', () => ctx.slots.register({
+          name: 'conversation.composer.dock',
+          id: 'dsh-download-hud',
+          order: 20,
+        }, Component))
+      },
+    }
+  },
+})

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-download-hud
+      name: 'dsh-transfer-hud'

package/icon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <rect x="5" y="5" width="54" height="54" rx="13" fill="#1f6feb" opacity="0.12"/>
+  <path d="M32 15.5V36" stroke="#1f6feb" stroke-width="5.5" stroke-linecap="round"/>
+  <path d="M21.5 27.5 32 38l10.5-10.5" fill="none" stroke="#1f6feb" stroke-width="5.5" stroke-linecap="round" stroke-linejoin="round"/>
+  <path d="M18 46.5h28" stroke="#1f6feb" stroke-width="5.5" stroke-linecap="round"/>
+</svg>