@kvbox/server 0.5.10 → 0.5.11

package/dist/kvbox-server.js

@@ -484,6 +484,23 @@ var MachineUsageSchema = z3.object({
   estimatedStops: z3.number().int(),
   historyFrom: z3.string().nullable()
 });
+var GuestStatsSchema = z3.object({
+  /** Load average over 1, 5 and 15 minutes. */
+  load: z3.tuple([z3.number(), z3.number(), z3.number()]),
+  cpus: z3.number().int(),
+  memTotalMib: z3.number().int(),
+  /** Total minus available: page cache counts as free. */
+  memUsedMib: z3.number().int(),
+  /** The box's root, which is its overlay disk: the box's own writes, not the shared base. */
+  diskTotalBytes: z3.number().int(),
+  diskUsedBytes: z3.number().int(),
+  uptimeSec: z3.number().int()
+});
+var MachineStatsSchema = z3.object({
+  name: z3.string(),
+  owner: z3.string(),
+  stats: GuestStatsSchema.nullable()
+});
 var UsageStatusSchema = z3.enum([...BoxStatusSchema.options, "removed"]);
 var BoxUsageSchema = MachineUsageSchema.omit({ window: true, status: true }).extend({
   /** The host's box id; a name removed and recreated appears twice, with two ids. */
@@ -943,7 +960,13 @@ function setIdentity(udsPath, id, timeoutMs) {
 function setAuthorizedKeys(udsPath, lines, timeoutMs) {
   return agentCall(udsPath, { op: "authorizedKeys", lines: [...lines] }, timeoutMs);
 }
+async function stats(udsPath, timeoutMs) {
+  const reply = GuestStatsSchema.safeParse(await agentCall(udsPath, { op: "stats" }, timeoutMs));
+  if (!reply.success) throw new KvboxError(`kvbox-agent sent stats kvbox does not understand: ${reply.error.issues[0]?.message ?? "invalid"}`);
+  return reply.data;
+}
 var isUnknownOp = (err) => /unknown op/.test(err.message ?? "");
+var isNoAgent = (err) => /vsock connect refused|vsock connection closed before the guest accepted|kvbox-agent unreachable: connect (ENOENT|ECONNREFUSED)/.test(err.message ?? "");
 
 // src/core/capacity.ts
 import { cpus, totalmem } from "node:os";
@@ -2548,7 +2571,7 @@ function versionOf(srcFileUrl, injected) {
 }
 
 // src/version.ts
-var VERSION = versionOf(import.meta.url, true ? "0.5.10" : void 0);
+var VERSION = versionOf(import.meta.url, true ? "0.5.11" : void 0);
 
 // src/caller.ts
 import { createHash as createHash2, timingSafeEqual } from "node:crypto";
@@ -2600,6 +2623,19 @@ function capacityRoutes() {
 // src/routes/machines.ts
 import { Hono as Hono2 } from "hono";
 
+// src/core/stats.ts
+var STATS_REPLY_MS = 3e3;
+async function machineStats(ref, p = paths()) {
+  const m = await getMachine(ref, p);
+  if (m.status !== "running") throw new KvboxError(`${stateMessage(ref, m.status)}; only a running box can say how it is doing`);
+  try {
+    return { name: m.name, owner: m.owner, stats: await stats(p.machine(m.owner, m.name).vsock, STATS_REPLY_MS) };
+  } catch (err) {
+    if (isUnknownOp(err) || isNoAgent(err)) return { name: m.name, owner: m.owner, stats: null };
+    throw err;
+  }
+}
+
 // src/core/usage.ts
 async function machineUsage(ref, since, p = paths()) {
   const box = await getMachine(ref, p);
@@ -2655,6 +2691,7 @@ function machineRoutes() {
     }
     return c.json(await machineUsage(parseRef(c.req.param("name"), c.get("owner")), from));
   });
+  r.get("/:name/stats", async (c) => c.json(await machineStats(parseRef(c.req.param("name"), c.get("owner")))));
   r.delete("/:name", async (c) => {
     await destroyMachine(parseRef(c.req.param("name"), c.get("owner")));
     return c.body(null, 204);