@nocoo/bat 3.3.0 → 3.4.0

package/dist/bat.js

@@ -3093,7 +3093,7 @@ var init_connect = () => {};
 var init_settings = () => {};
 
 // ../shared/dist/version.js
-var BAT_VERSION = "3.3.0";
+var BAT_VERSION = "3.4.0";
 
 // ../shared/dist/workstations.js
 function fail(error) {
@@ -3726,7 +3726,7 @@ function validateWorkstationPairStart(input) {
     }
   };
 }
-var WORKSTATION_INTERVAL_SECONDS = 600, WORKSTATION_PING_COUNT = 3, WORKSTATION_MAX_TARGETS = 100, WORKSTATION_BODY_MAX_BYTES = 65536, WORKSTATION_REPORT_SKEW_SECONDS = 300, WORKSTATION_MAX_RUN_MS = 120000, WORKSTATION_STALE_AFTER_SECONDS, WORKSTATION_NAME_MAX_LENGTH = 64, WORKSTATION_PAIRING_TTL_SECONDS = 300, WORKSTATION_PAIRING_ALPHABET = "ABCDEFGHJKMNPQRSTVWXYZ23456789", WORKSTATION_PAIRING_LENGTH = 8, WORKSTATION_LIMITS, WORKSTATION_CONNECTIVITY_STATUSES, UUID_PATTERN, IPV4_PATTERN, PKCE_CHALLENGE_PATTERN, PKCE_VERIFIER_PATTERN, WORKSTATION_TOKEN_PATTERN, IPV6_CHARS, REPORT_KEYS, CPU_KEYS, MEM_KEYS, DISK_KEYS, NETWORK_KEYS, INTERFACE_KEYS, ADDRESS_KEYS, CONNECTIVITY_KEYS, TARGET_KEYS, TARGETS_RESPONSE_KEYS, LOGIN_EXCHANGE_KEYS, PAIR_START_KEYS;
+var WORKSTATION_INTERVAL_SECONDS = 600, WORKSTATION_PING_COUNT = 3, WORKSTATION_MAX_TARGETS = 100, WORKSTATION_BODY_MAX_BYTES = 65536, WORKSTATION_REPORT_SKEW_SECONDS = 300, WORKSTATION_MAX_RUN_MS = 120000, WORKSTATION_STALE_AFTER_SECONDS, WORKSTATION_NAME_MAX_LENGTH = 64, WORKSTATION_PAIRING_TTL_SECONDS = 300, WORKSTATION_PAIRING_ALPHABET = "ABCDEFGHJKMNPQRSTVWXYZ23456789", WORKSTATION_PAIRING_LENGTH = 8, WORKSTATION_LIMITS, WORKSTATION_CONNECTIVITY_STATUSES, WORKSTATION_REPORTS_MAX_LIMIT = 20, WORKSTATION_REPORTS_DEFAULT_LIMIT = 3, UUID_PATTERN, IPV4_PATTERN, PKCE_CHALLENGE_PATTERN, PKCE_VERIFIER_PATTERN, WORKSTATION_TOKEN_PATTERN, IPV6_CHARS, REPORT_KEYS, CPU_KEYS, MEM_KEYS, DISK_KEYS, NETWORK_KEYS, INTERFACE_KEYS, ADDRESS_KEYS, CONNECTIVITY_KEYS, TARGET_KEYS, TARGETS_RESPONSE_KEYS, LOGIN_EXCHANGE_KEYS, PAIR_START_KEYS;
 var init_workstations = __esm(() => {
   WORKSTATION_STALE_AFTER_SECONDS = WORKSTATION_INTERVAL_SECONDS * 3;
   WORKSTATION_LIMITS = {
@@ -4544,7 +4544,7 @@ async function exchangeLogin(origins, input, options = {}) {
   if (!validated.ok) {
     throw new Error(`invalid exchange request: ${validated.error}`);
   }
-  const client = new HttpClient(origins.machine, undefined, options.timeoutMs ?? REQUEST_TIMEOUT_MS, options.signal);
+  const client = new HttpClient(origins.machine, undefined, options.timeoutMs ?? REQUEST_TIMEOUT_MS, options.signal, options.fetchImpl);
   const raw = await client.post("/api/workstation-auth/exchange", validated.value);
   return parseExchangeOutput(raw, origins.machine);
 }
@@ -4627,7 +4627,7 @@ async function startPairing(origins, input, options = {}) {
   if (!validated.ok) {
     throw new Error(`invalid pairing request: ${validated.error}`);
   }
-  const client = new HttpClient(origins.machine, undefined, options.timeoutMs ?? REQUEST_TIMEOUT_MS, options.signal);
+  const client = new HttpClient(origins.machine, undefined, options.timeoutMs ?? REQUEST_TIMEOUT_MS, options.signal, options.fetchImpl);
   const raw = await client.post("/api/workstation-auth/pair", validated.value);
   if (typeof raw !== "object" || raw === null) {
     throw new Error("pairing start returned no object");
@@ -4654,7 +4654,7 @@ async function pairingStatus(origins, pairingCode, options = {}) {
   if (normalized === null) {
     throw new Error("invalid pairing code");
   }
-  const client = new HttpClient(origins.machine, undefined, options.timeoutMs ?? REQUEST_TIMEOUT_MS, options.signal);
+  const client = new HttpClient(origins.machine, undefined, options.timeoutMs ?? REQUEST_TIMEOUT_MS, options.signal, options.fetchImpl);
   const raw = await client.get(`/api/workstation-auth/pair/${normalized}`);
   if (typeof raw !== "object" || raw === null) {
     throw new Error("pairing status returned no object");
@@ -4670,6 +4670,14 @@ async function pairingStatus(origins, pairingCode, options = {}) {
     expires_at: typeof record.expires_at === "number" ? record.expires_at : 0
   };
 }
+async function fetchReports(workerUrl, token, limit, options = {}) {
+  const client = new HttpClient(workerUrl, token, options.timeoutMs ?? REQUEST_TIMEOUT_MS, options.signal, options.fetchImpl);
+  const raw = await client.get(`/api/workstation-probe/reports?limit=${encodeURIComponent(String(limit))}`);
+  if (typeof raw !== "object" || raw === null || !Array.isArray(raw.data)) {
+    throw new Error("report readback returned no data array");
+  }
+  return raw;
+}
 var REQUEST_TIMEOUT_MS = 30000, UPLOAD_ATTEMPTS = 3, RETRY_BASE_MS = 500;
 var init_api2 = __esm(() => {
   init_dist4();
@@ -5137,6 +5145,143 @@ var init_scheduler = __esm(() => {
 `);
 });
 
+// src/workstation/detail.ts
+function describeLimit(limit) {
+  if (limit === undefined) {
+    return WORKSTATION_REPORTS_DEFAULT_LIMIT;
+  }
+  if (!Number.isInteger(limit) || limit < 1 || limit > WORKSTATION_REPORTS_MAX_LIMIT) {
+    throw new Error(`--limit must be an integer between 1 and ${WORKSTATION_REPORTS_MAX_LIMIT}`);
+  }
+  return limit;
+}
+function answering(connectivity) {
+  return connectivity.filter((entry) => entry.status === "reachable" || entry.status === "partial").length;
+}
+function averageRtt(entry) {
+  const values = entry.rtts_ms.filter((value) => value !== null);
+  if (values.length === 0) {
+    return "—";
+  }
+  const mean = values.reduce((total, value) => total + value, 0) / values.length;
+  return `${Math.round(mean * 10) / 10} ms`;
+}
+function loss(entry) {
+  if (entry.status === "error" || entry.status === "unsupported") {
+    return "—";
+  }
+  if (entry.sent <= 0) {
+    return "—";
+  }
+  return `${Math.round((entry.sent - entry.received) / entry.sent * 1000) / 10}%`;
+}
+function clock(seconds) {
+  return new Date(seconds * 1000).toLocaleString();
+}
+async function runWorkstationDetail(deps) {
+  const credential = deps.credential ?? readCredential(deps.paths);
+  if (!credential) {
+    error("Not logged in — run 'bat workstation login' first.");
+    return 1;
+  }
+  let limit;
+  try {
+    limit = describeLimit(deps.limit);
+  } catch (err) {
+    error(err.message);
+    return 1;
+  }
+  let response;
+  try {
+    response = await (deps.fetch ?? fetchReports)(credential.worker_url, credential.token, limit);
+  } catch (err) {
+    const message = err.message;
+    error(`Could not read reports: ${message}`);
+    if (/Route not allowed|404|not support/i.test(message)) {
+      info("This deployment does not expose report readback yet; upgrade the server first.");
+    }
+    return 1;
+  }
+  if (deps.json === true) {
+    console.log(JSON.stringify({
+      workstation_id: credential.workstation_id,
+      worker_url: credential.worker_url,
+      limit: response.limit,
+      reports: response.data
+    }, null, 2));
+    return 0;
+  }
+  info(`Workstation ${credential.workstation_id} · ${credential.worker_url}`);
+  const latest = response.data[0];
+  if (!latest) {
+    error("No reports stored yet — run 'bat workstation probe' once.");
+    return 1;
+  }
+  success(`Newest report ${clock(latest.finished_at)} · CPU ${latest.cpu_usage_pct ?? "—"}% · memory ${latest.mem_used_pct}% · ${answering(latest.connectivity)}/${latest.connectivity.length} answering`);
+  table(["Target", "Address", "ICMP", "Average", "Loss", "RTTs"], latest.connectivity.map((entry) => [
+    entry.server_id,
+    `${entry.address} v${entry.family}`,
+    entry.status,
+    averageRtt(entry),
+    loss(entry),
+    entry.rtts_ms.map((value) => value === null ? "—" : `${Math.round(value * 10) / 10}`).join(" / ")
+  ]));
+  if (response.data.length > 1) {
+    info("");
+    info(`Earlier reports (${response.data.length - 1})`);
+    table(["Finished", "CPU", "Memory", "Answering"], response.data.slice(1).map((entry) => [
+      clock(entry.finished_at),
+      entry.cpu_usage_pct === null ? "—" : `${entry.cpu_usage_pct}%`,
+      `${entry.mem_used_pct}%`,
+      `${answering(entry.connectivity)}/${entry.connectivity.length}`
+    ]));
+  }
+  return 0;
+}
+var init_detail = __esm(() => {
+  init_dist4();
+  init_output();
+  init_api2();
+  init_store();
+});
+
+// src/commands/workstation/detail.ts
+async function runDetailCommand(deps = {}) {
+  return await runWorkstationDetail({
+    paths: deps.paths ?? getWorkstationPaths(),
+    ...deps.limit !== undefined ? { limit: deps.limit } : {},
+    ...deps.json ? { json: true } : {}
+  });
+}
+var detail_default;
+var init_detail2 = __esm(() => {
+  init_dist3();
+  init_detail();
+  init_store();
+  detail_default = defineCommand({
+    meta: {
+      name: "detail",
+      description: "Show the newest reports and per-target probe results"
+    },
+    args: {
+      limit: {
+        type: "string",
+        description: "How many recent reports to read (1-20, default 3)"
+      },
+      json: {
+        type: "boolean",
+        description: "Print the raw report payload"
+      }
+    },
+    async run({ args }) {
+      process.exitCode = await runDetailCommand({
+        ...typeof args.limit === "string" && args.limit !== "" ? { limit: Number(args.limit) } : {},
+        ...args.json ? { json: true } : {}
+      });
+    }
+  });
+});
+
 // src/workstation/headless.ts
 async function performHeadlessLogin(deps) {
   const now = deps.now ?? (() => Math.floor(Date.now() / 1000));
@@ -7957,6 +8102,7 @@ var init_status = __esm(() => {
 var workstation_default;
 var init_workstation = __esm(() => {
   init_dist3();
+  init_detail2();
   init_login3();
   init_logout();
   init_probe();
@@ -7969,6 +8115,7 @@ var init_workstation = __esm(() => {
     },
     subCommands: {
       login: login_default2,
+      detail: detail_default,
       setup: setup_default,
       probe: probe_default,
       status: status_default3,
@@ -9496,7 +9643,7 @@ function runChecks(facts) {
       id: "assets-profile",
       label: "Assets profile",
       status: "warn",
-      detail: `not configured at ${facts.assetsConfigPath} (optional; run 'bat login')`
+      detail: `not configured at ${facts.assetsConfigPath} — only agent, asset, binding and heartbeat commands need it (run 'bat login')`
     });
   } else {
     const invalid = validateConfig(facts.assetsConfig);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nocoo/bat",
-	"version": "3.3.0",
+	"version": "3.4.0",
 	"description": "bat CLI — manage agents, assets and bindings for bat.hexly.ai",
 	"type": "module",
 	"bin": {