opencode-system-metrics-tui 0.1.10 → 0.1.11

package/README.md

@@ -3,7 +3,7 @@
 ## Install globally in OpenCode
 
 ```powershell
-opencode plugin -g opencode-system-metrics-tui@0.1.10 --force
+opencode plugin -g opencode-system-metrics-tui@0.1.11 --force
 ```
 
 This is the primary installation path. The version must match `package.json`; `--force` asks OpenCode to refresh its package cache. The helper below skips OpenCode when the expected artifact is already current. Verify the actual installed artifact afterward:
@@ -40,7 +40,8 @@ The README is available in **Español**, **English**, and **Português**.
 - Soporte para Linux, macOS y Windows cuando el sistema expone las métricas.
 - En macOS, la utilización de GPU usa `ioreg` y las temperaturas usan el helper de Stats si está instalado; si cualquiera de ellos falta, esa métrica queda como no disponible sin interrumpir el plugin. En Intel se conserva el fallback de GPU discreta de `systeminformation`.
 - En Windows, la temperatura de CPU requiere LibreHardwareMonitor ejecutándose como administrador con **Remote Web Server** activo en `http://127.0.0.1:8085`.
-- En Windows, la velocidad de red usa PowerShell y `Get-NetAdapterStatistics`; no agrega una dependencia npm.
+- En Windows, la velocidad de red usa una llamada nativa `GetIfTable2` de `iphlpapi.dll` mediante Koffi; la ruta PowerShell queda como fallback acotado si la API nativa no está disponible.
+- La agregación nativa incluye interfaces de hardware activas, excluye interfaces de filtro, loopback y túnel, y suma sus contadores `InOctets`/`OutOctets`.
 - Las lecturas opcionales de Windows se hacen bajo demanda, con timeout y caché; no hay timers globales de PowerShell.
 - La detección de Nerd Font en Linux/macOS está limitada a rutas conocidas, 2 niveles de profundidad y 256 entradas por directorio; una ruta ausente o inaccesible usa Unicode. Windows no escanea fuentes salvo con `OPENCODE_MONITOR_NERD_FONT=1`.
 - Si una fuente de métricas no responde a tiempo, su intento en caché se abandona de forma segura para permitir reintentos sin cancelar APIs que no aceptan `AbortSignal`.
@@ -93,7 +94,7 @@ npm publish --access public
 En otro equipo:
 
 ```bash
-opencode plugin opencode-system-metrics-tui@0.1.10
+opencode plugin opencode-system-metrics-tui@0.1.11
 ```
 
 El paquete exporta tanto la raíz (`opencode-system-metrics-tui`) como `./tui`; ambas rutas cargan el mismo bundle TUI.
@@ -103,8 +104,8 @@ El instalador de OpenCode configura el plugin TUI automáticamente. Reinicia Ope
 Publicar en npm e instalar en OpenCode son pasos distintos:
 
 - `npm publish --access public` publica el paquete en npm.
-- `opencode plugin opencode-system-metrics-tui@0.1.10` lo instala solo en el proyecto actual.
-- `opencode plugin -g opencode-system-metrics-tui@0.1.10 --force` lo instala globalmente para todos los proyectos.
+- `opencode plugin opencode-system-metrics-tui@0.1.11` lo instala solo en el proyecto actual.
+- `opencode plugin -g opencode-system-metrics-tui@0.1.11 --force` lo instala globalmente para todos los proyectos.
 
 ### Verificación
 
@@ -135,7 +136,8 @@ npm run build
 - Supports Linux, macOS, and Windows when the operating system exposes the metrics.
 - On macOS, GPU utilization uses `ioreg` and temperatures use the Stats helper when installed; missing helpers leave only that metric unavailable without interrupting the plugin. Intel retains the discrete-GPU `systeminformation` fallback.
 - On Windows, CPU temperature requires LibreHardwareMonitor running as administrator with **Remote Web Server** enabled at `http://127.0.0.1:8085`.
-- On Windows, network speed uses PowerShell and `Get-NetAdapterStatistics`; it adds no npm dependency.
+- On Windows, network speed uses one native `GetIfTable2` call from `iphlpapi.dll` through Koffi; the PowerShell path remains only as a bounded fallback when the native API cannot load.
+- Native aggregation includes active hardware interfaces, excludes filter, loopback, and tunnel interfaces, and sums their `InOctets`/`OutOctets` counters.
 - Optional Windows reads are on demand, timeout-bounded, and cached; no global PowerShell timers are used.
 - Linux/macOS Nerd Font detection is limited to known paths, two directory levels, and 256 entries per directory; missing or inaccessible paths safely fall back to Unicode. Windows does not scan fonts unless `OPENCODE_MONITOR_NERD_FONT=1` is set.
 - When a metric source does not respond in time, its cache attempt is safely abandoned so retries remain possible without cancelling APIs that do not accept `AbortSignal`.
@@ -188,7 +190,7 @@ npm publish --access public
 On another machine:
 
 ```bash
-opencode plugin opencode-system-metrics-tui@0.1.10
+opencode plugin opencode-system-metrics-tui@0.1.11
 ```
 
 The package exports both the root (`opencode-system-metrics-tui`) and `./tui`; both paths load the same TUI bundle.
@@ -198,8 +200,8 @@ The OpenCode installer configures the TUI plugin automatically. Restart OpenCode
 Publishing to npm and installing in OpenCode are separate steps:
 
 - `npm publish --access public` publishes the package to npm.
-- `opencode plugin opencode-system-metrics-tui@0.1.10` installs it for the current project only.
-- `opencode plugin -g opencode-system-metrics-tui@0.1.10 --force` installs it globally for all projects.
+- `opencode plugin opencode-system-metrics-tui@0.1.11` installs it for the current project only.
+- `opencode plugin -g opencode-system-metrics-tui@0.1.11 --force` installs it globally for all projects.
 
 ### Verification
 
@@ -229,7 +231,8 @@ npm run build
 - No Windows, ícones Unicode visíveis são usados por padrão porque o OpenCode não consegue detectar a fonte ativa do terminal.
 - Suporte para Linux, macOS e Windows quando o sistema disponibiliza as métricas.
 - No Windows, a temperatura da CPU requer o LibreHardwareMonitor executado como administrador com o **Remote Web Server** ativo em `http://127.0.0.1:8085`.
-- No Windows, a velocidade da rede usa o PowerShell e `Get-NetAdapterStatistics`; nenhuma dependência npm é adicionada.
+- No Windows, a velocidade da rede usa uma chamada nativa `GetIfTable2` de `iphlpapi.dll` via Koffi; o PowerShell permanece apenas como fallback limitado quando a API nativa não pode ser carregada.
+- A agregação nativa inclui interfaces de hardware ativas, exclui interfaces de filtro, loopback e túnel, e soma os contadores `InOctets`/`OutOctets`.
 - As leituras opcionais do Windows são sob demanda, têm timeout e cache; não há timers globais do PowerShell.
 - A detecção de Nerd Font no Linux/macOS é limitada a caminhos conhecidos, dois níveis de profundidade e 256 entradas por diretório; caminhos ausentes ou inacessíveis usam Unicode. O Windows não verifica fontes sem `OPENCODE_MONITOR_NERD_FONT=1`.
 - Quando uma fonte de métricas não responde a tempo, a tentativa em cache é abandonada com segurança para permitir novas tentativas sem cancelar APIs que não aceitam `AbortSignal`.
@@ -282,7 +285,7 @@ npm publish --access public
 Em outro computador:
 
 ```bash
-opencode plugin opencode-system-metrics-tui@0.1.10
+opencode plugin opencode-system-metrics-tui@0.1.11
 ```
 
 O pacote exporta tanto a raiz (`opencode-system-metrics-tui`) quanto `./tui`; os dois caminhos carregam o mesmo bundle TUI.
@@ -292,8 +295,8 @@ O instalador do OpenCode configura o plugin TUI automaticamente. Reinicie o Open
 Publicar no npm e instalar no OpenCode são etapas diferentes:
 
 - `npm publish --access public` publica o pacote no npm.
-- `opencode plugin opencode-system-metrics-tui@0.1.10` instala o plugin apenas no projeto atual.
-- `opencode plugin -g opencode-system-metrics-tui@0.1.10 --force` instala o plugin globalmente para todos os projetos.
+- `opencode plugin opencode-system-metrics-tui@0.1.11` instala o plugin apenas no projeto atual.
+- `opencode plugin -g opencode-system-metrics-tui@0.1.11 --force` instala o plugin globalmente para todos os projetos.
 
 ### Verificação
 

package/dist/tui.js

@@ -39,6 +39,128 @@ function formatRate(bytesPerSecond) {
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import si from "systeminformation";
+
+// src/windows-network.ts
+var IF_TYPE_SOFTWARE_LOOPBACK = 24;
+var IF_TYPE_TUNNEL = 131;
+var IF_OPER_STATUS_UP = 1;
+var NET_IF_ACCESS_LOOPBACK = 1;
+var ROWS_OFFSET = 8;
+var nativeReader;
+function toUint64(value) {
+  if (typeof value === "bigint" && value >= 0n)
+    return value;
+  if (typeof value === "number" && Number.isSafeInteger(value) && value >= 0)
+    return BigInt(value);
+  return 0n;
+}
+function mapWindowsNetworkRows(rows) {
+  return rows.reduce((total, row) => {
+    const flags = row.InterfaceAndOperStatusFlags;
+    const isHardware = typeof flags === "number" ? (flags & 1) !== 0 : flags?.HardwareInterface === 1;
+    const isFilter = typeof flags === "number" ? (flags & 2) !== 0 : flags?.FilterInterface === 1;
+    const isUsable = row.OperStatus === IF_OPER_STATUS_UP && row.AccessType !== NET_IF_ACCESS_LOOPBACK && row.Type !== IF_TYPE_SOFTWARE_LOOPBACK && row.Type !== IF_TYPE_TUNNEL;
+    if (!isHardware || isFilter || !isUsable)
+      return total;
+    return { rx: total.rx + toUint64(row.InOctets), tx: total.tx + toUint64(row.OutOctets) };
+  }, { rx: 0n, tx: 0n });
+}
+async function readWithFallback(primary, fallback) {
+  try {
+    return { value: await primary(), usedFallback: false };
+  } catch {
+    return { value: await fallback(), usedFallback: true };
+  }
+}
+function networkRate(current, previous, elapsedMs) {
+  if (previous === undefined)
+    return { rx: undefined, tx: undefined };
+  const seconds = Math.max(elapsedMs / 1000, 0.001);
+  const rx = current.rx >= previous.rx ? current.rx - previous.rx : 0n;
+  const tx = current.tx >= previous.tx ? current.tx - previous.tx : 0n;
+  return { rx: Number(rx) / seconds, tx: Number(tx) / seconds };
+}
+function defineNativeReader(koffi) {
+  const guid = koffi.struct("MIB_GUID", {
+    Data1: "uint32",
+    Data2: "uint16",
+    Data3: "uint16",
+    Data4: koffi.array("uint8", 8)
+  });
+  const row = koffi.struct("MIB_IF_ROW2", {
+    InterfaceLuid: "uint64",
+    InterfaceIndex: "uint32",
+    InterfaceGuid: guid,
+    Alias: koffi.array("char16_t", 257),
+    Description: koffi.array("char16_t", 257),
+    PhysicalAddressLength: "uint32",
+    PhysicalAddress: koffi.array("uint8", 32),
+    PermanentPhysicalAddress: koffi.array("uint8", 32),
+    Mtu: "uint32",
+    Type: "uint32",
+    TunnelType: "uint32",
+    MediaType: "uint32",
+    PhysicalMediumType: "uint32",
+    AccessType: "uint32",
+    DirectionType: "uint32",
+    InterfaceAndOperStatusFlags: "uint8",
+    OperStatus: "uint32",
+    AdminStatus: "uint32",
+    MediaConnectState: "uint32",
+    NetworkGuid: guid,
+    ConnectionType: "uint32",
+    TransmitLinkSpeed: "uint64",
+    ReceiveLinkSpeed: "uint64",
+    InOctets: "uint64",
+    InUcastPkts: "uint64",
+    InNUcastPkts: "uint64",
+    InDiscards: "uint64",
+    InErrors: "uint64",
+    InUnknownProtos: "uint64",
+    InUcastOctets: "uint64",
+    InMulticastOctets: "uint64",
+    InBroadcastOctets: "uint64",
+    OutOctets: "uint64",
+    OutUcastPkts: "uint64",
+    OutNUcastPkts: "uint64",
+    OutDiscards: "uint64",
+    OutErrors: "uint64",
+    OutUcastOctets: "uint64",
+    OutMulticastOctets: "uint64",
+    OutBroadcastOctets: "uint64",
+    OutQLen: "uint64"
+  });
+  if (koffi.sizeof(row) !== 1352)
+    throw new Error(`Unexpected MIB_IF_ROW2 size: ${koffi.sizeof(row)}`);
+  const iphlpapi = koffi.load("iphlpapi.dll");
+  const getIfTable2 = iphlpapi.func("uint32 __stdcall GetIfTable2(_Out_ void **Table)");
+  const freeMibTable = iphlpapi.func("void __stdcall FreeMibTable(void *Memory)");
+  return () => {
+    const output = [null];
+    const result = getIfTable2(output);
+    if (result !== 0 || output[0] === null)
+      throw new Error(`GetIfTable2 failed: ${result}`);
+    const table = output[0];
+    try {
+      const count = Number(koffi.decode(table, 0, "uint32"));
+      if (!Number.isSafeInteger(count) || count < 0 || count > 4096)
+        throw new Error(`Invalid interface count: ${count}`);
+      return Array.from({ length: count }, (_, index) => koffi.decode(table, ROWS_OFFSET + index * koffi.sizeof(row), row));
+    } finally {
+      freeMibTable(table);
+    }
+  };
+}
+async function loadNativeReader() {
+  const loaded = await import("koffi");
+  return defineNativeReader(loaded.default ?? loaded);
+}
+async function readWindowsNetworkCounters() {
+  nativeReader ??= loadNativeReader();
+  return mapWindowsNetworkRows((await nativeReader)());
+}
+
+// src/metrics.ts
 var execFileAsync = promisify(execFile);
 var DEFAULT_METRIC_TIMEOUT_MS = 1500;
 var WINDOWS_MEMORY_TIMEOUT_MS = 5000;
@@ -139,7 +261,7 @@ function parseWindowsNetworkOutput(stdout) {
     tx_bytes: finite(item.SentBytes) ?? 0
   }));
 }
-async function readWindowsNetworkSample() {
+async function readWindowsNetworkFallback() {
   const { stdout } = await execFileAsync("powershell.exe", [
     "-NoProfile",
     "-NonInteractive",
@@ -286,20 +408,28 @@ var cachedNetwork = {
   inFlight: undefined
 };
 var previousWindowsNetwork;
+var previousNativeWindowsNetwork;
 async function readWindowsNetworkMetrics() {
-  const samples = await readWindowsNetworkSample();
   const timestamp = Date.now();
-  const rx = samples.reduce((total, item) => total + (finite(item.rx_bytes) ?? 0), 0);
-  const tx = samples.reduce((total, item) => total + (finite(item.tx_bytes) ?? 0), 0);
+  const fallback = async () => {
+    const samples = await readWindowsNetworkFallback();
+    const rx = samples.reduce((total, item) => total + (finite(item.rx_bytes) ?? 0), 0);
+    const tx = samples.reduce((total, item) => total + (finite(item.tx_bytes) ?? 0), 0);
+    return { rx: BigInt(rx), tx: BigInt(tx) };
+  };
+  const { value: counters, usedFallback } = await readWithFallback(readWindowsNetworkCounters, fallback);
+  if (!usedFallback) {
+    const rate = networkRate(counters, previousNativeWindowsNetwork?.counters, previousNativeWindowsNetwork === undefined ? 0 : timestamp - previousNativeWindowsNetwork.timestamp);
+    previousNativeWindowsNetwork = { timestamp, counters };
+    return [{ rx_bytes: Number(counters.rx), tx_bytes: Number(counters.tx), rx_sec: rate.rx, tx_sec: rate.tx }];
+  }
   const seconds = previousWindowsNetwork === undefined ? undefined : Math.max((timestamp - previousWindowsNetwork.timestamp) / 1000, 0.001);
-  const result = [{
-    rx_bytes: rx,
-    tx_bytes: tx,
-    rx_sec: seconds === undefined ? undefined : Math.max(0, rx - previousWindowsNetwork.rx) / seconds,
-    tx_sec: seconds === undefined ? undefined : Math.max(0, tx - previousWindowsNetwork.tx) / seconds
-  }];
+  const rx = Number(counters.rx);
+  const tx = Number(counters.tx);
+  const rxSec = seconds === undefined ? undefined : Math.max(0, rx - previousWindowsNetwork.rx) / seconds;
+  const txSec = seconds === undefined ? undefined : Math.max(0, tx - previousWindowsNetwork.tx) / seconds;
   previousWindowsNetwork = { timestamp, rx, tx };
-  return result;
+  return [{ rx_bytes: rx, tx_bytes: tx, rx_sec: rxSec, tx_sec: txSec }];
 }
 async function readWindowsCpuTemperature() {
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-system-metrics-tui",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "OpenCode TUI sidebar plugin for live system metrics",
   "license": "MIT",
   "type": "module",
@@ -33,7 +33,7 @@
   "dependencies": {
     "@opentui/core": "^0.5.10",
     "@opentui/solid": "^0.5.10",
-    "opencode-system-metrics-tui": "^0.1.8",
+    "koffi": "^3.2.1",
     "solid-js": "^1.9.12",
     "systeminformation": "^5.33.8"
   },

package/scripts/build.ts

@@ -6,7 +6,7 @@ const result = await Bun.build({
   target: "node",
   format: "esm",
   plugins: [solidPlugin],
-  external: ["@opencode-ai/plugin/tui", "@opentui/core", "@opentui/solid", "solid-js", "systeminformation"],
+  external: ["@opencode-ai/plugin/tui", "@opentui/core", "@opentui/solid", "koffi", "solid-js", "systeminformation"],
   naming: "[name].js",
 })