dsh-plugin-exe 0.2.0 → 0.2.1

package/README.md

@@ -70,13 +70,28 @@ exe trust <调用方地址>
 - **本机作为设备** — 如果这台机器自己也跑着 `exe`（有 `config.toml`），显示它的地址，
   以及**谁能在这台机器上执行命令**：信任列表逐条可取消，也可以加新地址（要填两遍，防手滑）。
   设备每 2 秒热读配置，改完即生效，不用重启。
-- **可访问的设备** — 这台 harness 记得的设备（`mcp.toml` 的 `[devices]`），可加可删。
+- **可访问的设备** — 这台 harness 记得的设备（`mcp.toml` 的 `[devices]`），可加可删、**标签可改**；
+  每行一个「测速」，卡片右上角一个「测试全部」。
   设备那侧还要把上面的调用方地址加进它的信任列表，两边都成立才通。
 
+**测速是真实的往返**，不是看中继的脸色：先读一次中继的在线态（离线设备毫秒级失败，
+不用干等），在线就真的投一封 `shell` 调用（`echo ping`），从交付信封量到结果解封回来，
+显示的是这一整圈——钥匙、队列、设备的 trust 列表、执行、两端的加密。为此 ping 用 20ms
+起的紧轮询（普通工具调用仍是 150ms 起），数字才不是调用方自己的轮询间隔。没回应的调用
+会被取消，不会在设备上留一条跑到过期的任务。
+
+**数字的下限由设备侧决定**：设备每秒去中继取一次件，所以哪怕同一台机器上的设备也会显示
+约 1 秒起。它回答的是「这条路走通要多久」，不是 ICMP 的 RTT——这也是它比 `ping` 更有用的
+地方：不经过 trust 列表、没有解封成功、设备没真跑，都不会有数字。
+
 页面读写的就是 `exe mcp` 和 `exe` 用的那两个文件（`~/.config/exe/mcp.toml`、
 `~/.config/exe/config.toml`），所以 `exe status`、`exe trust` 与这个页面永远说同一件事。
 写入是规范化的 TOML 重写（和 CLI 的行为一致，行内注释会丢），旧文件留在 `<文件名>.bak`。
 
+**标签**：设备的标签就是 `mcp.toml` 里的键，直接重命名。信任列表在 eXe 里只有地址、没有名字，
+所以那侧的标签存在配置目录旁边的 `dsh-labels.json` 里——`exe` 不读也不写它，因此不会被
+`exe trust` 的再次写入覆盖掉；地址本身仍然只由 `config.toml` 决定。
+
 技术上它是这个包的第二半：`package.json` 里的 `dsh.client` 声明 + `./client` 导出，
 由 dsh 的模块系统作为浏览器插件加载；页面数据来自插件在 harness 自己的 web server 上
 注册的两条只读/单写路由（`/exe/api/state`、`/exe/api/edit`）。这两条路由**只接受同源请求**

package/lib/client.js

@@ -146,7 +146,22 @@ var s = {
     padding: "9px 12px",
     whiteSpace: "pre-wrap"
   },
-  badge: { fontSize: 11, opacity: 0.6, fontFamily: mono }
+  badge: { fontSize: 11, opacity: 0.6, fontFamily: mono },
+  cardHead: { display: "flex", alignItems: "center", gap: 12 },
+  cardActions: { marginLeft: "auto", display: "flex", gap: 8 },
+  inline: { display: "flex", gap: 6, alignItems: "center", flex: "0 1 auto" },
+  inputSmall: {
+    minWidth: 110,
+    padding: "4px 8px",
+    borderRadius: 6,
+    border,
+    background: "transparent",
+    color: "inherit",
+    font: "inherit"
+  },
+  pingOk: { fontFamily: mono, fontSize: 11.5, color: "#3ddc84" },
+  pingBad: { fontFamily: mono, fontSize: 11.5, color: "#ff6b6b", cursor: "help" },
+  pingPending: { fontFamily: mono, fontSize: 11.5, opacity: 0.55 }
 };
 function CopyButton({ value, label = "\u590D\u5236" }) {
   const [copied, setCopied] = (0, import_react.useState)(false);
@@ -234,6 +249,63 @@ function CallerCard(props) {
     ] })
   ] });
 }
+function LabelEditor(props) {
+  const [editing, setEditing] = (0, import_react.useState)(false);
+  const [draft, setDraft] = (0, import_react.useState)(props.value);
+  if (!editing) {
+    return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+      "button",
+      {
+        type: "button",
+        style: s.button,
+        disabled: props.busy,
+        onClick: () => {
+          setDraft(props.value);
+          setEditing(true);
+        },
+        children: props.action
+      }
+    );
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
+    "form",
+    {
+      style: s.inline,
+      onSubmit: (event) => {
+        event.preventDefault();
+        props.onCommit(draft.trim());
+        setEditing(false);
+      },
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+          "input",
+          {
+            autoFocus: true,
+            style: s.inputSmall,
+            value: draft,
+            placeholder: props.placeholder,
+            "aria-label": props.placeholder,
+            disabled: props.busy,
+            onChange: (event) => setDraft(event.target.value)
+          }
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("button", { style: s.primary, type: "submit", disabled: props.busy, children: "\u4FDD\u5B58" }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+          "button",
+          {
+            style: s.button,
+            type: "button",
+            disabled: props.busy,
+            onClick: () => {
+              setEditing(false);
+            },
+            children: "\u53D6\u6D88"
+          }
+        )
+      ]
+    }
+  );
+}
 function DeviceCard(props) {
   const { device } = props.state;
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("section", { style: s.card, children: [
@@ -260,19 +332,30 @@ function DeviceCard(props) {
         "\uFF09\uFF1A\u53EA\u6709\u8FD9\u91CC\u7684\u5730\u5740\u80FD\u5728\u8FD9\u53F0\u673A\u5668\u4E0A\u6267\u884C\u547D\u4EE4\u3002\u8BBE\u5907\u6BCF 2 \u79D2\u70ED\u8BFB\u914D\u7F6E\uFF0C\u6539\u5B8C\u5373\u751F\u6548\u3002"
       ] }),
       device.trust.length === 0 && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: s.badge, children: "\u8FD8\u6CA1\u6709\u4FE1\u4EFB\u4EFB\u4F55\u8C03\u7528\u65B9" }),
-      device.trust.map((address) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { style: s.row, children: [
-        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: s.rowAddress, children: address }),
+      device.trust.map((row) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { style: s.row, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: s.label, children: row.label ?? "\u672A\u547D\u540D" }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: s.rowAddress, children: row.address }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+          LabelEditor,
+          {
+            value: row.label ?? "",
+            placeholder: "\u7ED9\u8FD9\u4E2A\u8C03\u7528\u65B9\u8D77\u4E2A\u540D\u5B57",
+            action: "\u6539\u6807\u7B7E",
+            busy: props.busy,
+            onCommit: (label) => props.onEdit({ op: "trust.label", address: row.address, label })
+          }
+        ),
         /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
           "button",
           {
             type: "button",
             style: s.danger,
             disabled: props.busy,
-            onClick: () => props.onEdit({ op: "trust.remove", address }),
+            onClick: () => props.onEdit({ op: "trust.remove", address: row.address }),
             children: "\u53D6\u6D88\u4FE1\u4EFB"
           }
         )
-      ] }, address)),
+      ] }, row.address)),
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
         AddForm,
         {
@@ -292,23 +375,62 @@ function DeviceCard(props) {
 function DevicesCard(props) {
   const { devices } = props.state;
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("section", { style: s.card, children: [
-    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("h2", { style: s.cardTitle, children: "\u53EF\u8BBF\u95EE\u7684\u8BBE\u5907" }),
-    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { style: s.hint, children: "\u8FD9\u53F0 harness \u8BB0\u5F97\u7684\u8BBE\u5907\uFF08\u5199\u6210\u6807\u7B7E\uFF0C\u6A21\u578B\u8C03\u7528\u65F6\u7528\u5B83\uFF09\u3002\u8BBE\u5907\u90A3\u4FA7\u8FD8\u8981\u628A\u8FD9\u4E2A\u9875\u9762\u4E0A\u7684\u8C03\u7528\u65B9\u5730\u5740\u52A0\u8FDB\u5B83\u7684\u4FE1\u4EFB\u5217\u8868\u3002" }),
-    devices.length === 0 && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: s.badge, children: "\u8FD8\u6CA1\u6709\u914D\u7F6E\u8BBE\u5907" }),
-    devices.map((row) => /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { style: s.row, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: s.label, children: row.label }),
-      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: s.rowAddress, children: row.address }),
-      row.source === "config" ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: s.badge, children: "\u6765\u81EA\u63D2\u4EF6\u914D\u7F6E" }) : /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { style: s.cardHead, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("h2", { style: s.cardTitle, children: "\u53EF\u8BBF\u95EE\u7684\u8BBE\u5907" }),
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: s.cardActions, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
         "button",
         {
           type: "button",
-          style: s.danger,
-          disabled: props.busy,
-          onClick: () => props.onEdit({ op: "device.remove", label: row.label }),
-          children: "\u79FB\u9664"
+          style: s.button,
+          disabled: props.busy || props.pinging || devices.length === 0,
+          onClick: () => props.onPing(),
+          children: props.pinging ? "\u6D4B\u901F\u4E2D\u2026" : "\u6D4B\u8BD5\u5168\u90E8"
         }
-      )
-    ] }, row.label)),
+      ) })
+    ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { style: s.hint, children: "\u8FD9\u53F0 harness \u8BB0\u5F97\u7684\u8BBE\u5907\uFF08\u5199\u6210\u6807\u7B7E\uFF0C\u6A21\u578B\u8C03\u7528\u65F6\u7528\u5B83\uFF09\u3002\u8BBE\u5907\u90A3\u4FA7\u8FD8\u8981\u628A\u8FD9\u4E2A\u9875\u9762\u4E0A\u7684\u8C03\u7528\u65B9\u5730\u5740\u52A0\u8FDB\u5B83\u7684\u4FE1\u4EFB\u5217\u8868\u3002" }),
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: s.badge, children: pingSummary(devices, props.pings) }),
+    devices.length === 0 && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: s.badge, children: "\u8FD8\u6CA1\u6709\u914D\u7F6E\u8BBE\u5907" }),
+    devices.map((row) => {
+      const ping = props.pings[row.address];
+      return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { style: s.row, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+          LabelEditor,
+          {
+            value: row.label,
+            placeholder: "\u8BBE\u5907\u6807\u7B7E",
+            action: row.label,
+            busy: props.busy || row.source === "config",
+            onCommit: (to) => {
+              if (to.length > 0) props.onEdit({ op: "device.rename", from: row.label, to });
+            }
+          }
+        ),
+        row.source === "config" && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: s.badge, children: "\u6765\u81EA\u63D2\u4EF6\u914D\u7F6E" }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(PingBadge, { ping }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: s.rowAddress, children: row.address }),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+          "button",
+          {
+            type: "button",
+            style: s.button,
+            disabled: props.busy || props.pinging,
+            onClick: () => props.onPing([row.label]),
+            children: "\u6D4B\u901F"
+          }
+        ),
+        row.source === "config" ? null : /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+          "button",
+          {
+            type: "button",
+            style: s.danger,
+            disabled: props.busy,
+            onClick: () => props.onEdit({ op: "device.remove", label: row.label }),
+            children: "\u79FB\u9664"
+          }
+        )
+      ] }, row.label);
+    }),
     /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
       AddForm,
       {
@@ -321,6 +443,26 @@ function DevicesCard(props) {
     )
   ] });
 }
+function PingBadge(props) {
+  if (props.ping === void 0) return null;
+  if (props.ping === "pending") return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: s.pingPending, children: "\u2026" });
+  if (props.ping.ok) return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("span", { style: s.pingOk, children: [
+    props.ping.rttMs,
+    " ms"
+  ] });
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: s.pingBad, title: props.ping.error ?? "\u4E0D\u901A", children: "\u4E0D\u901A" });
+}
+function pingSummary(devices, pings) {
+  const results = devices.map((row) => pings[row.address]).filter((ping) => typeof ping === "object" && ping !== null);
+  if (results.length === 0) return "\u70B9\u300C\u6D4B\u901F\u300D\u7528\u4E00\u6B21\u771F\u5B9E\u8C03\u7528\u91CF\u5F80\u8FD4\u5EF6\u8FDF\uFF08\u542B\u8BBE\u5907\u4FA7\u7EA6 1 \u79D2\u7684\u53D6\u4EF6\uFF09";
+  const answered = results.filter((result) => result.ok && result.rttMs !== void 0);
+  const fastest = answered.reduce(
+    (best, result) => best === void 0 || (result.rttMs ?? Infinity) < best ? result.rttMs : best,
+    void 0
+  );
+  const failed = results.length - answered.length;
+  return `\u6D4B\u8FC7 ${results.length} \u53F0\uFF1A${answered.length} \u901A${fastest === void 0 ? "" : `\uFF08\u6700\u5FEB ${fastest} ms\uFF09`}${failed > 0 ? ` \xB7 ${failed} \u4E0D\u901A` : ""}`;
+}
 function ExeView(props) {
   return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { style: s.page, children: [
     /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("header", { style: s.header, children: [
@@ -332,7 +474,17 @@ function ExeView(props) {
     props.state === null ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("p", { style: s.hint, children: "\u8F7D\u5165\u4E2D\u2026" }) : /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(import_jsx_runtime2.Fragment, { children: [
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(CallerCard, { state: props.state, busy: props.busy }),
       /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(DeviceCard, { state: props.state, busy: props.busy, onEdit: props.onEdit }),
-      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(DevicesCard, { state: props.state, busy: props.busy, onEdit: props.onEdit })
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+        DevicesCard,
+        {
+          state: props.state,
+          busy: props.busy,
+          pings: props.pings,
+          pinging: props.pinging,
+          onEdit: props.onEdit,
+          onPing: props.onPing
+        }
+      )
     ] })
   ] });
 }
@@ -341,6 +493,7 @@ function ExeView(props) {
 var import_jsx_runtime3 = require("react/jsx-runtime");
 var STATE_URL = "/exe/api/state";
 var EDIT_URL = "/exe/api/edit";
+var PING_URL = "/exe/api/ping";
 function reason(error) {
   return error instanceof Error ? error.message : String(error);
 }
@@ -356,6 +509,8 @@ function ExePanel() {
   const [state, setState] = (0, import_react2.useState)(null);
   const [error, setError] = (0, import_react2.useState)(null);
   const [busy, setBusy] = (0, import_react2.useState)(false);
+  const [pings, setPings] = (0, import_react2.useState)({});
+  const [pinging, setPinging] = (0, import_react2.useState)(false);
   const load = (0, import_react2.useCallback)(async () => {
     try {
       const response = await fetch(STATE_URL, { cache: "no-store", headers: { accept: "application/json" } });
@@ -388,6 +543,42 @@ function ExePanel() {
       }
     })();
   }, []);
+  const ping = (0, import_react2.useCallback)((labels) => {
+    void (async () => {
+      const devices = state?.devices ?? [];
+      const targets = (labels ?? devices.map((row) => row.label)).map((label) => devices.find((row) => row.label === label)).filter((row) => row !== void 0);
+      setPinging(true);
+      setPings((current) => {
+        const next = { ...current };
+        for (const row of targets) next[row.address] = "pending";
+        return next;
+      });
+      try {
+        const response = await fetch(PING_URL, {
+          method: "POST",
+          headers: { "content-type": "application/json", accept: "application/json" },
+          body: JSON.stringify(labels === void 0 ? {} : { labels })
+        });
+        if (!response.ok) throw new Error(await failure(response));
+        const body = await response.json();
+        setPings((current) => {
+          const next = { ...current };
+          for (const result of body.results) next[result.address] = result;
+          return next;
+        });
+        setError(null);
+      } catch (pingError) {
+        setError(reason(pingError));
+        setPings((current) => {
+          const next = { ...current };
+          for (const row of targets) delete next[row.address];
+          return next;
+        });
+      } finally {
+        setPinging(false);
+      }
+    })();
+  }, [state]);
   return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(
     ExeView,
     {
@@ -395,6 +586,9 @@ function ExePanel() {
       error,
       busy,
       onEdit: edit,
+      pings,
+      pinging,
+      onPing: ping,
       onReload: () => {
         void load();
       }

package/lib/index.js

@@ -4735,16 +4735,17 @@ var Relay = class {
       );
     }
     try {
-      return await this.wait(envelope, ttl, request.signal);
+      return await this.wait(envelope, ttl, request.signal, request.poll);
     } catch (error) {
       if (request.signal.aborted) await this.cancel(callId);
       throw error;
     }
   }
-  async wait(envelope, ttl, signal) {
+  async wait(envelope, ttl, signal, poll) {
     const detailPath = `/api/calls/${envelope.call_id}`;
     const deadline = Date.now() + (ttl + 30) * 1e3;
-    let wait = POLL_START_MS;
+    const ceiling = Math.max(poll?.ceilingMs ?? POLL_CEILING_MS, 10);
+    let wait = Math.min(Math.max(poll?.startMs ?? POLL_START_MS, 5), ceiling);
     for (; ; ) {
       if (signal.aborted) throw signal.reason ?? new Error("cancelled");
       if (Date.now() > deadline) throw new Error("no answer from the device before the call expired");
@@ -4769,7 +4770,7 @@ var Relay = class {
           throw new Error(`unexpected call status \`${status}\``);
       }
       await sleep(wait, signal);
-      wait = Math.min(wait * 2, POLL_CEILING_MS);
+      wait = Math.min(wait * 2, ceiling);
     }
   }
   async settle(envelope, detail, signal) {
@@ -4817,6 +4818,59 @@ var Relay = class {
   }
 };
 
+// src/ping.ts
+var PING_TIMEOUT_SECONDS = 6;
+var PING_POLL = { startMs: 20, ceilingMs: 120 };
+function reason2(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function hint(error) {
+  const text2 = reason2(error);
+  if (/expired|no answer|no result|abort|timed? ?out/i.test(text2)) {
+    return "\u8BBE\u5907\u6CA1\u6709\u56DE\u5E94\uFF1A\u5B83\u53EF\u80FD\u6CA1\u628A\u8FD9\u53F0 harness \u7684\u5730\u5740\u52A0\u8FDB trust\uFF0C\u6216\u8005\u547D\u4EE4\u88AB\u5B83\u7684\u8FDB\u7A0B\u4E22\u6389\u4E86";
+  }
+  return text2;
+}
+async function pingDevice(relay, label, address, options = {}) {
+  let registered;
+  let online;
+  try {
+    const status = await relay.device(address);
+    registered = status.registered;
+    online = status.online;
+  } catch (error) {
+    return { label, address, ok: false, error: `\u4E2D\u7EE7\u4E0D\u53EF\u8FBE\uFF1A${reason2(error)}` };
+  }
+  if (!online) {
+    return {
+      label,
+      address,
+      ok: false,
+      registered,
+      online: false,
+      error: registered ? "\u8BBE\u5907\u79BB\u7EBF\uFF1A\u4E2D\u7EE7\u6700\u8FD1\u6CA1\u89C1\u5230\u5B83" : "\u8BBE\u5907\u8FD8\u6CA1\u5728\u4E2D\u7EE7\u767B\u8BB0\uFF08\u5728\u8BBE\u5907\u4E0A\u8DD1\u4E00\u6B21 `exe`\uFF09"
+    };
+  }
+  const budget = options.timeoutMs ?? (PING_TIMEOUT_SECONDS + 2) * 1e3;
+  const started = Date.now();
+  try {
+    await relay.call({
+      device: address,
+      name: "shell",
+      args: { command: "echo ping", timeout_seconds: PING_TIMEOUT_SECONDS },
+      ttlSeconds: PING_TIMEOUT_SECONDS,
+      signal: AbortSignal.timeout(budget),
+      poll: PING_POLL
+    });
+    return { label, address, ok: true, registered, online, rttMs: Date.now() - started };
+  } catch (error) {
+    return { label, address, ok: false, registered, online, error: hint(error) };
+  }
+}
+async function pingDevices(relay, targets, options = {}) {
+  return await Promise.all(targets.map((target) => pingDevice(relay, target.label, target.address, options)));
+}
+
 // src/routes.ts
 var ROUTE_PREFIX = "/exe/api";
 var MAX_BODY_BYTES = 64 * 1024;
@@ -4857,7 +4911,7 @@ async function readJson(req) {
     throw new Error(`body is not JSON: ${error instanceof Error ? error.message : String(error)}`);
   }
 }
-function registerExeRoutes(webServer, store) {
+function registerExeRoutes(webServer, deps) {
   const handler = async (req, res) => {
     try {
       if (!sameOrigin(req)) {
@@ -4870,7 +4924,7 @@ function registerExeRoutes(webServer, store) {
           send(res, 405, { error: "use GET" });
           return;
         }
-        send(res, 200, store.state());
+        send(res, 200, deps.store.state());
         return;
       }
       if (url.pathname === `${ROUTE_PREFIX}/edit`) {
@@ -4887,7 +4941,25 @@ function registerExeRoutes(webServer, store) {
           send(res, 400, { error: "an edit names its `op`" });
           return;
         }
-        send(res, 200, store.edit(body));
+        send(res, 200, deps.store.edit(body));
+        return;
+      }
+      if (url.pathname === `${ROUTE_PREFIX}/ping`) {
+        if (req.method !== "POST") {
+          send(res, 405, { error: "use POST" });
+          return;
+        }
+        if (!(req.headers["content-type"] ?? "").includes("application/json")) {
+          send(res, 415, { error: "send application/json" });
+          return;
+        }
+        const body = await readJson(req);
+        const labels = body.labels;
+        if (labels !== void 0 && (!Array.isArray(labels) || labels.some((label) => typeof label !== "string"))) {
+          send(res, 400, { error: "`labels` is a list of device labels" });
+          return;
+        }
+        send(res, 200, { results: await deps.ping(labels) });
         return;
       }
       send(res, 404, { error: `no route for ${req.method} ${url.pathname}` });
@@ -4900,7 +4972,8 @@ function registerExeRoutes(webServer, store) {
 
 // src/state.ts
 import { copyFileSync, existsSync as existsSync2, readFileSync as readFileSync2, renameSync, writeFileSync } from "node:fs";
-function reason2(error) {
+import { join as join2 } from "node:path";
+function reason3(error) {
   return error instanceof Error ? error.message : String(error);
 }
 function readToml(path) {
@@ -4908,7 +4981,7 @@ function readToml(path) {
   try {
     return parse(readFileSync2(path, "utf8"));
   } catch (error) {
-    throw new Error(`${path} is not valid TOML: ${reason2(error)}`);
+    throw new Error(`${path} is not valid TOML: ${reason3(error)}`);
   }
 }
 function writeToml(path, value) {
@@ -4918,6 +4991,28 @@ function writeToml(path, value) {
   if (existsSync2(path)) copyFileSync(path, `${path}.bak`);
   renameSync(temporary, path);
 }
+var LABELS_FILE = "dsh-labels.json";
+function readTrustLabels(path) {
+  if (!existsSync2(path)) return {};
+  try {
+    const parsed = JSON.parse(readFileSync2(path, "utf8"));
+    const table = parsed.trust;
+    if (typeof table !== "object" || table === null || Array.isArray(table)) return {};
+    return Object.fromEntries(
+      Object.entries(table).filter(
+        (entry) => typeof entry[1] === "string" && entry[1].trim().length > 0
+      )
+    );
+  } catch {
+    return {};
+  }
+}
+function writeTrustLabels(path, labels) {
+  const temporary = `${path}.tmp`;
+  writeFileSync(temporary, `${JSON.stringify({ trust: labels }, null, 2)}
+`, { mode: 384 });
+  renameSync(temporary, path);
+}
 function labelOf(value) {
   const label = typeof value === "string" ? value.trim() : "";
   if (label.length === 0 || label.length > 64 || /[\u0000-\u001f]/.test(label)) {
@@ -4941,6 +5036,7 @@ function trustOf(file) {
 function createStateStore(options = {}, env = process.env) {
   const callerPath = options.configPath?.trim() || defaultConfigPath(env);
   const devicePath = deviceConfigPath(env);
+  const labelsPath = join2(configDir(env), LABELS_FILE);
   const inline = options.devices ?? {};
   const callerView = () => {
     const view = { endpoints: [], configPath: callerPath };
@@ -4956,7 +5052,7 @@ function createStateStore(options = {}, env = process.env) {
       view.source = inlineSecret === void 0 ? callerPath : "plugin config";
       view.endpoints = splitEndpoints(options.endpoints).length > 0 ? splitEndpoints(options.endpoints) : splitEndpoints(file?.endpoints).length > 0 ? splitEndpoints(file?.endpoints) : splitEndpoints(file?.cloud);
     } catch (error) {
-      view.error = reason2(error);
+      view.error = reason3(error);
     }
     return view;
   };
@@ -4988,9 +5084,13 @@ function createStateStore(options = {}, env = process.env) {
       if (secret.length === 0) throw new Error(`${devicePath} has no secret`);
       view.address = addressOf(decodeSecret(secret));
       view.endpoints = splitEndpoints(file?.endpoints).length > 0 ? splitEndpoints(file?.endpoints) : splitEndpoints(file?.cloud);
-      view.trust = trustOf(file);
+      const labels = readTrustLabels(labelsPath);
+      view.trust = trustOf(file).map((address) => {
+        const label = labels[address];
+        return label === void 0 ? { address } : { address, label };
+      });
     } catch (error) {
-      view.error = reason2(error);
+      view.error = reason3(error);
     }
     return view;
   };
@@ -5010,6 +5110,24 @@ function createStateStore(options = {}, env = process.env) {
         writeToml(callerPath, { ...file, devices });
         break;
       }
+      case "device.rename": {
+        const from = labelOf(op.from);
+        const to = labelOf(op.to);
+        if (from === to) break;
+        if (Object.hasOwn(inline, from) || Object.hasOwn(inline, to)) {
+          throw new Error(`\`${from}\` / \`${to}\` is set in this plugin's own config; change it there, not in ${callerPath}`);
+        }
+        const file = readToml(callerPath);
+        if (file === void 0) throw new Error(`no caller config at ${callerPath}`);
+        const table = file.devices;
+        const existing = typeof table === "object" && table !== null && !Array.isArray(table) ? { ...table } : {};
+        if (!Object.hasOwn(existing, from)) throw new Error(`no device labelled \`${from}\``);
+        if (Object.hasOwn(existing, to)) throw new Error(`\`${to}\` is already a device label`);
+        const renamed = {};
+        for (const [label, address] of Object.entries(existing)) renamed[label === from ? to : label] = address;
+        writeToml(callerPath, { ...file, devices: renamed });
+        break;
+      }
       case "device.remove": {
         const label = labelOf(op.label);
         if (Object.hasOwn(inline, label)) {
@@ -5032,6 +5150,29 @@ function createStateStore(options = {}, env = process.env) {
         const trust = trustOf(file);
         const next = op.op === "trust.add" ? [.../* @__PURE__ */ new Set([...trust, address])] : trust.filter((entry) => entry !== address);
         writeToml(devicePath, { ...file, trust: next });
+        if (op.op === "trust.remove") {
+          const labels = readTrustLabels(labelsPath);
+          if (labels[address] !== void 0) {
+            delete labels[address];
+            writeTrustLabels(labelsPath, labels);
+          }
+        }
+        break;
+      }
+      case "trust.label": {
+        const address = addressOfText(op.address);
+        const file = readToml(devicePath);
+        if (file === void 0) {
+          throw new Error(`this machine is not an eXe device: ${devicePath} does not exist (run \`exe\`)`);
+        }
+        if (!trustOf(file).includes(address)) {
+          throw new Error(`${address} is not trusted by this machine; add it first`);
+        }
+        const labels = readTrustLabels(labelsPath);
+        const label = typeof op.label === "string" ? op.label.trim() : "";
+        if (label.length === 0) delete labels[address];
+        else labels[address] = labelOf(label);
+        writeTrustLabels(labelsPath, labels);
         break;
       }
       default: {
@@ -5144,7 +5285,7 @@ var Config = Schema.object({
 function shQuote(value) {
   return `'${value.replaceAll("'", `'\\''`)}'`;
 }
-function reason3(error) {
+function reason4(error) {
   return error instanceof Error ? error.message : String(error);
 }
 function mediaTypeOf(bytes, path, allowed) {
@@ -5239,7 +5380,7 @@ function apply(ctx, config) {
               if (status.last_seen_at !== void 0) row.last_seen_at = status.last_seen_at;
               return row;
             } catch (error) {
-              return { device: label, address, error: reason3(error) };
+              return { device: label, address, error: reason4(error) };
             }
           })
         );
@@ -5394,7 +5535,12 @@ function apply(ctx, config) {
   ctx.inject(["webServer"], (scoped) => {
     const webServer = scoped.webServer;
     const store = createStateStore(config);
-    scoped.effect(() => registerExeRoutes(webServer, store), "dsh-plugin-exe: panel routes");
+    const ping = async (labels) => {
+      const caller = callerOf();
+      const targets = labels === void 0 ? [...caller.devices].map(([label, address]) => ({ label, address })) : labels.map((label) => ({ label, address: addressForDevice(caller, label) }));
+      return await pingDevices(relayOf(), targets);
+    };
+    scoped.effect(() => registerExeRoutes(webServer, { store, ping }), "dsh-plugin-exe: panel routes");
   });
 }
 export {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-plugin-exe",
-  "version": "0.2.0",
-  "description": "eXe for DeepSeek Harness: shell and screenshots on your own devices, plus a sidebar page that carries the caller key other devices must trust",
+  "version": "0.2.1",
+  "description": "eXe for DeepSeek Harness: shell and screenshots on your own devices, plus a sidebar page for the caller key, editable labels and one-tap reachability tests",
   "keywords": [
     "dsh",
     "dsh-plugin",