dsh-vitals 0.1.0 → 0.1.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Johannes Tebbert
+
+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,6 +1,31 @@
-# dsh-vitals
+<p align="center">
+  <img src="https://raw.githubusercontent.com/JoblessJoe/dsh-vitals/main/.github/assets/banner.svg" alt="dsh-vitals: live CPU, memory, temperature and GPU load inside the DeepSeek Harness web GUI" width="100%">
+</p>
 
-A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) Web-GUI plugin that shows **live hardware load** right in the web GUI — a self-contained, dependency-free companion to `btop`. Opens as a full tab next to Chat/Trajectory, or docked beside a session in the right sidebar.
+<p align="center">
+  <a href="https://www.npmjs.com/package/dsh-vitals"><img src="https://img.shields.io/npm/v/dsh-vitals?color=34d399&label=npm" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/dsh-vitals"><img src="https://img.shields.io/npm/dm/dsh-vitals?color=34d399" alt="npm downloads"></a>
+  <img src="https://img.shields.io/badge/dependencies-0-34d399" alt="zero runtime dependencies">
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/JoblessJoe/dsh-vitals?color=34d399" alt="MIT license"></a>
+  <a href="https://github.com/awesome-dsh-plugin/awesome-dsh-plugin"><img src="https://img.shields.io/badge/awesome-dsh--plugin-fc60a8" alt="listed on awesome-dsh-plugin"></a>
+</p>
+
+A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) web GUI plugin that shows **live hardware load** right where you work: a self-contained, dependency-free companion to `btop`. Watch your GPU while your local model thinks, without leaving the chat.
+
+```bash
+dsh plugin --profile web add dsh-vitals
+```
+
+Restart dsh: CPU and GPU load appear in the session header, and the full **Hardware** tab sits next to Chat / Trajectory. Full details under [Install](#install).
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/JoblessJoe/dsh-vitals/main/.github/assets/hardware-tab.png" alt="The Hardware tab: per-core CPU load, memory and two GPUs" width="100%">
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/JoblessJoe/dsh-vitals/main/.github/assets/header-widget.png" alt="Mini CPU and GPU load widget in the session header" width="520">
+  <br><sub>The mini widget in the session header: always visible while you chat. Click it to jump to the full Hardware tab.</sub>
+</p>
 
 ## What it shows
 
@@ -22,46 +47,46 @@ Data is sampled host-side on every poll (~0.5 s) and rendered live.
 
 Two access points, both live the moment the plugin is bundled — no setup:
 
+- **A mini widget in the session header**, next to the "⋯" menu: CPU and
+  per-GPU load as tiny bars, always visible while you chat. Hover for temps
+  and VRAM; click to jump to the full tab.
 - **A full `Hardware` tab** next to **Chat** / **Trajectory** at the top of
-  the conversation view. The dedicated way to watch the box while you're not
-  actively chatting.
-- **Docked in the right sidebar**, alongside a session: open the right
-  sidebar, click **+** (add tab), pick **Hardware** from the Guide list. Lets
-  you chat and watch load at the same time. (Every dsh "page type" plugin
-  opens this way — nothing dsh-vitals-specific about the click path.)
+  the conversation view: per-core CPU, memory, temperatures and every GPU.
 
 ### Platform support
 
-| Signal | Primary source | Fallback |
-| ------ | -------------- | -------- |
-| CPU load | `/proc/stat` (Linux) | `os.cpus()` deltas (macOS / other) |
-| Memory | `/proc/meminfo` (Linux) | `os.totalmem()` / `os.freemem()` |
-| CPU temp | `/sys/class/thermal` | hidden when absent |
-| GPUs | `nvidia-smi` (any count) | hidden when absent |
+Linux, macOS and Windows. Each signal uses the best unprivileged source the OS
+offers and hides itself when there is none:
+
+| Signal | Linux | macOS | Windows |
+| ------ | ----- | ----- | ------- |
+| CPU load (overall + per core) | `/proc/stat` | `os.cpus()` | `os.cpus()` |
+| Memory | `/proc/meminfo` | `vm_stat` (counts cache as available, like Activity Monitor) | `os.freemem()` |
+| CPU temperature | `/sys/class/thermal` | hidden (needs root) | WMI thermal zones, when the board exposes them |
+| NVIDIA GPUs | `nvidia-smi` | `nvidia-smi` | `nvidia-smi.exe` (PATH or `NVSMI` folder) |
+| Apple / other GPUs | — | `ioreg` utilisation + memory in use | — |
 
-Everything degrades gracefully: a missing source simply hides that panel or
-shows a placeholder rather than breaking the tab. Any number of GPUs is
-supported; any CPU (core count and vendor) is handled.
+Everything degrades gracefully: a missing source hides that panel or shows a
+placeholder instead of breaking the tab. Any number of GPUs and any CPU core
+count is supported.
 
 ## Install
 
-Not on the npm registry (yet) — install straight from GitHub, into your dsh
-**web profile** (`web` below is the profile name; use whichever profile backs
-your web GUI):
+From your dsh **web profile** (`web` below is the profile name; use whichever
+profile backs your web GUI):
 
 ```bash
-dsh plugin --profile web add github:JoblessJoe/dsh-vitals
+dsh plugin --profile web add dsh-vitals
 ```
 
 This installs the package into the profile and adds it to
 `dsh.profile.bundles` for you — no manual `package.json` editing. (No local
 `dsh` binary? Run the equivalent by hand from the profile directory, e.g.
-`~/.dsh/profiles/web/`: `pnpm add github:JoblessJoe/dsh-vitals`, then add
-`"dsh-vitals"` to that `package.json`'s `dsh.profile.bundles` array
-yourself.)
+`~/.dsh/profiles/web/`: `pnpm add dsh-vitals`, then add `"dsh-vitals"` to
+that `package.json`'s `dsh.profile.bundles` array yourself.)
 
-The repo ships its built `lib/` output committed, so no build step runs on
-install — nothing else to do before restarting.
+The published package ships its built `lib/` output, so no build step runs
+on install — nothing else to do before restarting.
 
 Restart your dsh web service and open the web GUI — see
 [Where it shows up](#where-it-shows-up) above for how to find it.

package/lib/client.js

@@ -24,7 +24,6 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   HARDWARE_ID: () => HARDWARE_ID,
-  HARDWARE_KIND: () => HARDWARE_KIND,
   apply: () => apply,
   inject: () => inject
 });
@@ -33,8 +32,6 @@ module.exports = __toCommonJS(index_exports);
 // src/client/locales.ts
 var zh = {
   "tab.title": "\u786C\u4EF6",
-  "guide.title": "\u786C\u4EF6\u76D1\u63A7",
-  "guide.description": "\u5B9E\u65F6 CPU / \u5185\u5B58 / \u6E29\u5EA6 / GPU \u8D1F\u8F7D",
   "section.cpu": "CPU",
   "section.mem": "\u5185\u5B58",
   "section.temp": "CPU \u6E29\u5EA6",
@@ -50,12 +47,11 @@ var zh = {
   "gpu.temp": "\u6E29\u5EA6",
   "loading": "\u8BFB\u53D6\u4E2D\u2026",
   "error": "\u8BFB\u53D6\u5931\u8D25",
-  "retry": "\u91CD\u8BD5"
+  "retry": "\u91CD\u8BD5",
+  "mini.open": "\u6253\u5F00\u786C\u4EF6\u76D1\u63A7"
 };
 var en = {
   "tab.title": "Hardware",
-  "guide.title": "Hardware",
-  "guide.description": "Live CPU / memory / temps / GPU load",
   "section.cpu": "CPU",
   "section.mem": "Memory",
   "section.temp": "CPU Temp",
@@ -71,28 +67,10 @@ var en = {
   "gpu.temp": "Temp",
   "loading": "Loading\u2026",
   "error": "Read failed",
-  "retry": "Retry"
+  "retry": "Retry",
+  "mini.open": "Open hardware monitor"
 };
 
-// src/client/definition.ts
-var HARDWARE_KIND = "hardware";
-var HARDWARE_ID = "dsh-vitals";
-function hardwareDefinition(t) {
-  return {
-    id: HARDWARE_ID,
-    kind: HARDWARE_KIND,
-    priority: "extension",
-    title: () => t("tab.title"),
-    guide: [
-      {
-        order: 1e3,
-        title: () => t("guide.title"),
-        description: () => t("guide.description")
-      }
-    ]
-  };
-}
-
 // src/client/body.tsx
 var import_react = require("react");
 var import_jsx_runtime = require("react/jsx-runtime");
@@ -157,8 +135,8 @@ var gb = (kb) => (kb / 1024 / 1024).toFixed(1);
 var pct1 = (n) => n == null ? "\u2014" : `${Math.round(n)}%`;
 var n1 = (n) => n == null ? "\u2014" : n.toFixed(1);
 var mb = (mbv) => mbv == null ? "\u2014" : `${Math.round(mbv)} MB`;
-function Bar({ pct, color }) {
-  const c = color != null ? color : barColor(pct);
+function Bar({ pct, color: color2 }) {
+  const c = color2 != null ? color2 : barColor(pct);
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: S.track, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: { ...S.fill, width: `${Math.max(0, Math.min(100, pct))}%`, background: c } }) });
 }
 function Sparkline({ samples }) {
@@ -349,23 +327,96 @@ function HardwareBody({ t }) {
   ] });
 }
 
+// src/client/mini.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
+var ok = "#3fb950";
+var warn = "#d29922";
+var bad = "#f85149";
+var color = (pct) => pct >= 85 ? bad : pct >= 60 ? warn : ok;
+var S2 = {
+  button: {
+    display: "inline-flex",
+    alignItems: "center",
+    gap: 10,
+    height: 26,
+    padding: "0 8px",
+    background: "transparent",
+    border: "1px solid transparent",
+    borderRadius: 6,
+    color: "inherit",
+    cursor: "pointer",
+    opacity: 0.85,
+    fontFamily: "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace",
+    fontSize: 11
+  },
+  cell: { display: "inline-flex", alignItems: "center", gap: 5 },
+  label: { opacity: 0.6 },
+  track: { width: 28, height: 5, borderRadius: 3, background: "rgba(127,127,127,0.25)", overflow: "hidden" },
+  value: { minWidth: 28, textAlign: "right" }
+};
+function Cell({ label, pct }) {
+  const p = Math.max(0, Math.min(100, pct));
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("span", { style: S2.cell, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: S2.label, children: label }),
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: S2.track, children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("span", { style: { display: "block", height: "100%", width: `${p}%`, background: color(p), transition: "width 0.3s ease" } }) }),
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("span", { style: S2.value, children: [
+      Math.round(p),
+      "%"
+    ] })
+  ] });
+}
+function openHardwareTab(e, label) {
+  var _a, _b;
+  const header = e.currentTarget.closest("header");
+  const tabs = (_a = header == null ? void 0 : header.querySelectorAll('[role="tab"]')) != null ? _a : [];
+  for (const tab of tabs) if (((_b = tab.textContent) == null ? void 0 : _b.trim()) === label) {
+    tab.click();
+    return;
+  }
+}
+function HeaderVitals({ t }) {
+  const { data, cpuPct } = useHardwareData();
+  if (!data) return null;
+  const multi = data.gpus.length > 1;
+  const tip = [
+    `CPU ${Math.round(cpuPct)}%${data.temp.overall == null ? "" : ` \xB7 ${Math.round(data.temp.overall)}\xB0C`}`,
+    `${t("section.mem")} ${Math.round(data.mem.usedPct)}%`,
+    ...data.gpus.map((g) => {
+      var _a;
+      return `GPU ${g.index} ${g.name}: ${(_a = g.util) != null ? _a : "\u2014"}%${g.temp == null ? "" : ` \xB7 ${Math.round(g.temp)}\xB0C`}` + (g.memUsedMb == null || g.memTotalMb == null ? "" : ` \xB7 ${Math.round(g.memUsedMb)} / ${Math.round(g.memTotalMb)} MB`);
+    }),
+    t("mini.open")
+  ].join("\n");
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("button", { type: "button", style: S2.button, title: tip, "aria-label": t("mini.open"), onClick: (e) => {
+    openHardwareTab(e, t("tab.title"));
+  }, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Cell, { label: "CPU", pct: cpuPct }),
+    data.gpus.map((g) => {
+      var _a;
+      return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Cell, { label: multi ? `GPU${g.index}` : "GPU", pct: (_a = g.util) != null ? _a : 0 }, g.index);
+    })
+  ] });
+}
+
 // src/client/index.tsx
-var inject = ["slots", "locale", "sidebarRightTabs"];
+var HARDWARE_ID = "dsh-vitals";
+var inject = ["slots", "locale"];
 function apply(ctx) {
   const t = ctx.locale.bind("hardwareMonitor");
   ctx.effect(() => ctx.locale.register("hardwareMonitor", { zh, en }), "dsh-vitals: dictionaries");
-  ctx.effect(
-    () => ctx.sidebarRightTabs.register(hardwareDefinition(t)),
-    "dsh-vitals: hardware type"
-  );
-  ctx.effect(
-    () => ctx.slots.inject("sidebar.right.pane.tab", () => ctx.slots.register({ name: "sidebar.right.pane.tab", key: HARDWARE_ID, locale: "hardwareMonitor" }, HardwareBody)),
-    "dsh-vitals: body seat"
-  );
   ctx.effect(
     () => ctx.slots.inject("conversation.view", () => ctx.slots.register({ name: "conversation.view", id: HARDWARE_ID, order: 20, locale: "hardwareMonitor", label: () => t("tab.title") }, HardwareBody)),
     "dsh-vitals: conversation tab"
   );
+  ctx.effect(
+    () => ctx.slots.inject("conversation.session.header.utilities", () => ctx.slots.register({
+      name: "conversation.session.header.utilities",
+      id: HARDWARE_ID,
+      order: -20,
+      locale: "hardwareMonitor"
+    }, HeaderVitals)),
+    "dsh-vitals: header mini view"
+  );
 }
 
 return module.exports;

package/lib/index.js

@@ -1,7 +1,67 @@
 // src/index.ts
 import { readdirSync, readFileSync } from "node:fs";
-import { execFile } from "node:child_process";
 import { cpus, freemem, totalmem } from "node:os";
+
+// src/platform.ts
+import { execFile } from "node:child_process";
+function run(cmd, args, timeout = 1500) {
+  return new Promise((resolve) => {
+    execFile(cmd, args, { timeout, windowsHide: true }, (err, stdout) => {
+      resolve(err ? null : String(stdout));
+    });
+  });
+}
+function parseVmStat(out) {
+  const page = Number(out.match(/page size of (\d+) bytes/)?.[1]);
+  if (!Number.isFinite(page) || page <= 0) return null;
+  const pages = (key) => Number(out.match(new RegExp(`^${key}:\\s+(\\d+)`, "m"))?.[1] ?? 0);
+  const avail = pages("Pages free") + pages("Pages inactive") + pages("Pages speculative") + pages("Pages purgeable");
+  return avail > 0 ? avail * page : null;
+}
+function parseIoreg(out) {
+  const gpus = [];
+  for (const block of out.split(/^\+-o /m).slice(1)) {
+    const util = block.match(/"Device Utilization %"=(\d+)/);
+    if (!util) continue;
+    const model = block.match(/"model"\s*=\s*"([^"]+)"/)?.[1] ?? block.match(/^(\S+)/)?.[1] ?? "GPU";
+    const used = block.match(/"In use system memory"=(\d+)/);
+    gpus.push({
+      name: model,
+      util: Number(util[1]),
+      memUsedMb: used ? Math.round(Number(used[1]) / 1024 / 1024) : null
+    });
+  }
+  return gpus;
+}
+function parseWmiTemps(out) {
+  return out.split(/\r?\n/).map((s) => Number(s.trim())).filter((n) => Number.isFinite(n) && n > 0).map((dk) => Math.round((dk / 10 - 273.15) * 10) / 10).filter((c) => c > 0 && c < 150);
+}
+var WMI_TEMP = [
+  "-NoProfile",
+  "-NonInteractive",
+  "-Command",
+  "Get-CimInstance -Namespace root/wmi -ClassName MSAcpi_ThermalZoneTemperature | ForEach-Object { $_.CurrentTemperature }"
+];
+var winTemps = [];
+var winTempAt = 0;
+var winTempOff = false;
+var winTempBusy = false;
+function windowsTemps() {
+  if (!winTempOff && !winTempBusy && Date.now() - winTempAt > 1e4) {
+    winTempBusy = true;
+    void run("powershell.exe", WMI_TEMP, 5e3).then((out) => {
+      const temps = out ? parseWmiTemps(out) : [];
+      if (temps.length === 0) winTempOff = true;
+      winTemps = temps;
+      winTempAt = Date.now();
+      winTempBusy = false;
+    });
+  }
+  return winTemps;
+}
+var NVIDIA_SMI = process.platform === "win32" ? ["nvidia-smi", "C:\\Program Files\\NVIDIA Corporation\\NVSMI\\nvidia-smi.exe"] : ["nvidia-smi"];
+
+// src/index.ts
 var inject = ["webServer"];
 function parseStat(raw) {
   const cores = [];
@@ -65,7 +125,7 @@ function sampleCpu() {
     return { total, cores, model: cpuModelOnce() };
   }
 }
-function sampleMem() {
+async function sampleMem() {
   let totalKb = null, availKb = null;
   try {
     const g = {};
@@ -76,9 +136,9 @@ function sampleMem() {
     totalKb = g.MemTotal ?? null;
     availKb = g.MemAvailable ?? (g.MemFree ?? 0) + (g.Buffers ?? 0) + (g.Cached ?? 0);
   } catch {
-    const t = totalmem(), f = freemem();
-    totalKb = Math.round(t / 1024);
-    availKb = Math.round(f / 1024);
+    const mac = process.platform === "darwin" ? parseVmStat(await run("vm_stat", []) ?? "") : null;
+    totalKb = Math.round(totalmem() / 1024);
+    availKb = Math.round((mac ?? freemem()) / 1024);
   }
   if (totalKb == null || totalKb <= 0 || availKb == null) {
     return { totalKb: 0, availKb: 0, usedKb: 0, usedPct: 0 };
@@ -104,26 +164,40 @@ async function sampleTemp() {
     }
   } catch {
   }
+  if (process.platform === "win32") windowsTemps().forEach((temp, i) => zones.push({ name: `zone ${i}`, temp }));
   const overall = zones.length ? Math.max(...zones.map((z) => z.temp)) : null;
   return { overall, zones };
 }
-function nvidiaSmi() {
-  return new Promise((resolve) => {
-    const args = [
-      "--query-gpu=index,name,temperature.gpu,utilization.gpu,power.draw,memory.used,memory.total",
-      "--format=csv,noheader,nounits"
-    ];
-    execFile("nvidia-smi", args, { timeout: 800 }, (err, stdout) => {
-      if (err) {
-        resolve(null);
-        return;
-      }
-      resolve(stdout.trim());
-    });
-  });
+var SMI_ARGS = [
+  "--query-gpu=index,name,temperature.gpu,utilization.gpu,power.draw,memory.used,memory.total",
+  "--format=csv,noheader,nounits"
+];
+var smiPath = null;
+async function nvidiaSmi() {
+  for (const cmd of smiPath ? [smiPath] : NVIDIA_SMI) {
+    const out = await run(cmd, SMI_ARGS, 800);
+    if (out !== null) {
+      smiPath = cmd;
+      return out.trim();
+    }
+  }
+  return null;
+}
+async function macGpus() {
+  const out = await run("ioreg", ["-r", "-d", "1", "-c", "IOAccelerator"]);
+  return (out ? parseIoreg(out) : []).map((g, index) => ({
+    index,
+    name: g.name,
+    temp: null,
+    util: g.util,
+    powerW: null,
+    memUsedMb: g.memUsedMb,
+    memTotalMb: null
+  }));
 }
 async function sampleGpus() {
   const out = await nvidiaSmi();
+  if ((out === null || out.length === 0) && process.platform === "darwin") return { gpus: await macGpus(), gpuError: null };
   if (out === null || out.length === 0) return { gpus: [], gpuError: null };
   const gpus = [];
   for (const line of out.split("\n")) {
@@ -155,7 +229,7 @@ async function sample() {
     errors.push(`cpu: ${e.message}`);
   }
   try {
-    mem = sampleMem();
+    mem = await sampleMem();
   } catch (e) {
     errors.push(`mem: ${e.message}`);
   }
@@ -180,6 +254,12 @@ async function sample() {
     errors
   };
 }
+var SAMPLE_TTL_MS = 400;
+var last = null;
+function sharedSample() {
+  if (!last || Date.now() - last.at > SAMPLE_TTL_MS) last = { at: Date.now(), data: sample() };
+  return last.data;
+}
 var DATA_ENDPOINT = "/plugins/dsh-vitals/data";
 function send(res, code, body) {
   res.writeHead(code, {
@@ -202,7 +282,7 @@ function apply(ctx, _config) {
           send(res, 405, JSON.stringify({ ok: false, error: "method not allowed" }));
           return;
         }
-        const data = await sample();
+        const data = await sharedSample();
         send(res, 200, JSON.stringify(data));
       }
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vitals",
-  "version": "0.1.0",
+  "version": "0.1.8",
   "description": "Live hardware load panel for the DeepSeek Harness web GUI: a btop-style tab showing CPU load per core and overall, DRAM usage, CPU temperatures, and per-GPU temperature/load/power/VRAM. Reads /proc and nvidia-smi on the host and polls ~1s in the browser.",
   "type": "module",
   "main": "lib/index.js",
@@ -28,10 +28,24 @@
     "schemaVersion": 1,
     "displayName": "Vitals",
     "summary": "Live btop-style hardware monitor tab: CPU per-core + overall load, DRAM, CPU temps, and per-GPU temp/load/power/VRAM.",
-    "categories": ["System", "Web UI", "Observability"],
-    "surfaces": ["host", "web"],
-    "capabilities": { "provides": ["service:vitals"] },
-    "compatibility": { "dsh": ">=0.1.0-rc.5", "node": ">=20" },
+    "categories": [
+      "System",
+      "Web UI",
+      "Observability"
+    ],
+    "surfaces": [
+      "host",
+      "web"
+    ],
+    "capabilities": {
+      "provides": [
+        "service:vitals"
+      ]
+    },
+    "compatibility": {
+      "dsh": ">=0.1.0-rc.5",
+      "node": ">=20"
+    },
     "permissions": {}
   },
   "files": [
@@ -63,9 +77,14 @@
   "engines": {
     "node": ">=20"
   },
-  "os": ["darwin", "linux"],
+  "os": [
+    "darwin",
+    "linux"
+  ],
   "scripts": {
-    "build": "node scripts/build.mjs"
+    "build": "node scripts/build.mjs",
+    "release": "git pull origin main && npm publish",
+    "test": "node test/platform.test.ts"
   },
   "devDependencies": {
     "esbuild": "^0.28.2"