@livekit/agents 1.0.48 → 1.0.50

package/dist/cpu.cjs

@@ -0,0 +1,189 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var cpu_exports = {};
+__export(cpu_exports, {
+  CGroupV1CpuMonitor: () => CGroupV1CpuMonitor,
+  CGroupV2CpuMonitor: () => CGroupV2CpuMonitor,
+  DefaultCpuMonitor: () => DefaultCpuMonitor,
+  getCpuMonitor: () => getCpuMonitor
+});
+module.exports = __toCommonJS(cpu_exports);
+var import_node_fs = require("node:fs");
+var import_node_os = __toESM(require("node:os"), 1);
+function cpuCountFromEnv() {
+  const raw = process.env.NUM_CPUS;
+  if (raw === void 0) return void 0;
+  const parsed = parseFloat(raw);
+  if (Number.isNaN(parsed)) {
+    console.warn("Failed to parse NUM_CPUS from environment");
+    return void 0;
+  }
+  return parsed;
+}
+class DefaultCpuMonitor {
+  cpuCount() {
+    return cpuCountFromEnv() ?? (import_node_os.default.cpus().length || 1);
+  }
+  cpuPercent(intervalMs) {
+    return new Promise((resolve) => {
+      const cpus1 = import_node_os.default.cpus();
+      const timer = setTimeout(() => {
+        const cpus2 = import_node_os.default.cpus();
+        let idle = 0;
+        let total = 0;
+        for (let i = 0; i < cpus1.length; i++) {
+          const cpu1 = cpus1[i].times;
+          const cpu2 = cpus2[i].times;
+          idle += cpu2.idle - cpu1.idle;
+          const total1 = Object.values(cpu1).reduce((acc, v) => acc + v, 0);
+          const total2 = Object.values(cpu2).reduce((acc, v) => acc + v, 0);
+          total += total2 - total1;
+        }
+        resolve(total === 0 ? 0 : Math.max(Math.min(+(1 - idle / total).toFixed(2), 1), 0));
+      }, intervalMs);
+      timer.unref();
+    });
+  }
+}
+class CGroupV2CpuMonitor {
+  cpuCount() {
+    const envCpus = cpuCountFromEnv();
+    if (envCpus !== void 0) return envCpus;
+    const [quota, period] = this.#readCpuMax();
+    if (quota === "max") return import_node_os.default.cpus().length || 1;
+    return parseInt(quota) / period;
+  }
+  cpuPercent(intervalMs) {
+    return new Promise((resolve, reject) => {
+      const usageStart = this.#readCpuUsage();
+      const timer = setTimeout(() => {
+        try {
+          const usageEnd = this.#readCpuUsage();
+          const usageDiffUsec = usageEnd - usageStart;
+          const usageSeconds = usageDiffUsec / 1e6;
+          const numCpus = this.cpuCount();
+          const intervalSeconds = intervalMs / 1e3;
+          const percent = usageSeconds / (intervalSeconds * numCpus);
+          resolve(Math.max(Math.min(percent, 1), 0));
+        } catch (e) {
+          reject(e);
+        }
+      }, intervalMs);
+      timer.unref();
+    });
+  }
+  #readCpuMax() {
+    try {
+      const data = (0, import_node_fs.readFileSync)("/sys/fs/cgroup/cpu.max", "utf-8").trim().split(/\s+/);
+      const quota = data[0] ?? "max";
+      const period = data[1] ? parseInt(data[1]) : 1e5;
+      return [quota, Number.isNaN(period) ? 1e5 : period];
+    } catch {
+      return ["max", 1e5];
+    }
+  }
+  #readCpuUsage() {
+    const content = (0, import_node_fs.readFileSync)("/sys/fs/cgroup/cpu.stat", "utf-8");
+    for (const line of content.split("\n")) {
+      if (line.startsWith("usage_usec")) {
+        return parseInt(line.split(/\s+/)[1]);
+      }
+    }
+    throw new Error("Failed to read CPU usage from /sys/fs/cgroup/cpu.stat");
+  }
+}
+class CGroupV1CpuMonitor {
+  cpuCount() {
+    const envCpus = cpuCountFromEnv();
+    if (envCpus !== void 0) return envCpus;
+    const [quota, period] = this.#readCfsQuotaAndPeriod();
+    if (quota === null || quota < 0 || period === null || period <= 0) {
+      return 2;
+    }
+    return Math.max(quota / period, 1);
+  }
+  cpuPercent(intervalMs) {
+    return new Promise((resolve, reject) => {
+      const usageStart = this.#readCpuacctUsage();
+      const timer = setTimeout(() => {
+        try {
+          const usageEnd = this.#readCpuacctUsage();
+          const usageDiffNs = usageEnd - usageStart;
+          const usageSeconds = usageDiffNs / 1e9;
+          const numCpus = this.cpuCount();
+          const intervalSeconds = intervalMs / 1e3;
+          const percent = usageSeconds / (intervalSeconds * numCpus);
+          resolve(Math.max(Math.min(percent, 1), 0));
+        } catch (e) {
+          reject(e);
+        }
+      }, intervalMs);
+      timer.unref();
+    });
+  }
+  #readCfsQuotaAndPeriod() {
+    const quota = readFirstInt("/sys/fs/cgroup/cpu/cpu.cfs_quota_us");
+    const period = readFirstInt("/sys/fs/cgroup/cpu/cpu.cfs_period_us");
+    return [quota, period];
+  }
+  #readCpuacctUsage() {
+    const value = readFirstInt("/sys/fs/cgroup/cpuacct/cpuacct.usage");
+    if (value === null) {
+      throw new Error("Failed to read cpuacct.usage for cgroup v1");
+    }
+    return value;
+  }
+}
+function readFirstInt(path) {
+  try {
+    const val = parseInt((0, import_node_fs.readFileSync)(path, "utf-8").trim());
+    return Number.isNaN(val) ? null : val;
+  } catch {
+    return null;
+  }
+}
+function isCGroupV2() {
+  return (0, import_node_fs.existsSync)("/sys/fs/cgroup/cpu.stat");
+}
+function isCGroupV1() {
+  return (0, import_node_fs.existsSync)("/sys/fs/cgroup/cpuacct/cpuacct.usage");
+}
+function getCpuMonitor() {
+  if (isCGroupV2()) return new CGroupV2CpuMonitor();
+  if (isCGroupV1()) return new CGroupV1CpuMonitor();
+  return new DefaultCpuMonitor();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CGroupV1CpuMonitor,
+  CGroupV2CpuMonitor,
+  DefaultCpuMonitor,
+  getCpuMonitor
+});
+//# sourceMappingURL=cpu.cjs.map

package/dist/cpu.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cpu.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { existsSync, readFileSync } from 'node:fs';\nimport os from 'node:os';\n\n/** @internal */\nexport interface CpuMonitor {\n  cpuCount(): number;\n  cpuPercent(intervalMs: number): Promise<number>;\n}\n\nfunction cpuCountFromEnv(): number | undefined {\n  const raw = process.env.NUM_CPUS;\n  if (raw === undefined) return undefined;\n  const parsed = parseFloat(raw);\n  if (Number.isNaN(parsed)) {\n    console.warn('Failed to parse NUM_CPUS from environment');\n    return undefined;\n  }\n  return parsed;\n}\n\n/** @internal */\nexport class DefaultCpuMonitor implements CpuMonitor {\n  cpuCount(): number {\n    return cpuCountFromEnv() ?? (os.cpus().length || 1);\n  }\n\n  cpuPercent(intervalMs: number): Promise<number> {\n    return new Promise((resolve) => {\n      const cpus1 = os.cpus();\n      const timer = setTimeout(() => {\n        const cpus2 = os.cpus();\n        let idle = 0;\n        let total = 0;\n        for (let i = 0; i < cpus1.length; i++) {\n          const cpu1 = cpus1[i]!.times;\n          const cpu2 = cpus2[i]!.times;\n          idle += cpu2.idle - cpu1.idle;\n          const total1 = Object.values(cpu1).reduce((acc, v) => acc + v, 0);\n          const total2 = Object.values(cpu2).reduce((acc, v) => acc + v, 0);\n          total += total2 - total1;\n        }\n        resolve(total === 0 ? 0 : Math.max(Math.min(+(1 - idle / total).toFixed(2), 1), 0));\n      }, intervalMs);\n      timer.unref();\n    });\n  }\n}\n\n/** @internal */\nexport class CGroupV2CpuMonitor implements CpuMonitor {\n  cpuCount(): number {\n    const envCpus = cpuCountFromEnv();\n    if (envCpus !== undefined) return envCpus;\n    const [quota, period] = this.#readCpuMax();\n    if (quota === 'max') return os.cpus().length || 1;\n    return parseInt(quota) / period;\n  }\n\n  cpuPercent(intervalMs: number): Promise<number> {\n    return new Promise((resolve, reject) => {\n      const usageStart = this.#readCpuUsage();\n      const timer = setTimeout(() => {\n        try {\n          const usageEnd = this.#readCpuUsage();\n          const usageDiffUsec = usageEnd - usageStart;\n          const usageSeconds = usageDiffUsec / 1_000_000;\n          const numCpus = this.cpuCount();\n          const intervalSeconds = intervalMs / 1000;\n          const percent = usageSeconds / (intervalSeconds * numCpus);\n          resolve(Math.max(Math.min(percent, 1), 0));\n        } catch (e) {\n          reject(e);\n        }\n      }, intervalMs);\n      timer.unref();\n    });\n  }\n\n  #readCpuMax(): [string, number] {\n    try {\n      const data = readFileSync('/sys/fs/cgroup/cpu.max', 'utf-8').trim().split(/\\s+/);\n      const quota = data[0] ?? 'max';\n      const period = data[1] ? parseInt(data[1]) : 100_000;\n      return [quota, Number.isNaN(period) ? 100_000 : period];\n    } catch {\n      return ['max', 100_000];\n    }\n  }\n\n  #readCpuUsage(): number {\n    const content = readFileSync('/sys/fs/cgroup/cpu.stat', 'utf-8');\n    for (const line of content.split('\\n')) {\n      if (line.startsWith('usage_usec')) {\n        return parseInt(line.split(/\\s+/)[1]!);\n      }\n    }\n    throw new Error('Failed to read CPU usage from /sys/fs/cgroup/cpu.stat');\n  }\n}\n\n/** @internal */\nexport class CGroupV1CpuMonitor implements CpuMonitor {\n  cpuCount(): number {\n    const envCpus = cpuCountFromEnv();\n    if (envCpus !== undefined) return envCpus;\n    const [quota, period] = this.#readCfsQuotaAndPeriod();\n    if (quota === null || quota < 0 || period === null || period <= 0) {\n      // do not use the host CPU count as it could overstate the number available to the container\n      return 2.0;\n    }\n    return Math.max(quota / period, 1.0);\n  }\n\n  cpuPercent(intervalMs: number): Promise<number> {\n    return new Promise((resolve, reject) => {\n      const usageStart = this.#readCpuacctUsage();\n      const timer = setTimeout(() => {\n        try {\n          const usageEnd = this.#readCpuacctUsage();\n          const usageDiffNs = usageEnd - usageStart;\n          const usageSeconds = usageDiffNs / 1_000_000_000;\n          const numCpus = this.cpuCount();\n          const intervalSeconds = intervalMs / 1000;\n          const percent = usageSeconds / (intervalSeconds * numCpus);\n          resolve(Math.max(Math.min(percent, 1.0), 0.0));\n        } catch (e) {\n          reject(e);\n        }\n      }, intervalMs);\n      timer.unref();\n    });\n  }\n\n  #readCfsQuotaAndPeriod(): [number | null, number | null] {\n    const quota = readFirstInt('/sys/fs/cgroup/cpu/cpu.cfs_quota_us');\n    const period = readFirstInt('/sys/fs/cgroup/cpu/cpu.cfs_period_us');\n    return [quota, period];\n  }\n\n  #readCpuacctUsage(): number {\n    const value = readFirstInt('/sys/fs/cgroup/cpuacct/cpuacct.usage');\n    if (value === null) {\n      throw new Error('Failed to read cpuacct.usage for cgroup v1');\n    }\n    return value;\n  }\n}\n\nfunction readFirstInt(path: string): number | null {\n  try {\n    const val = parseInt(readFileSync(path, 'utf-8').trim());\n    return Number.isNaN(val) ? null : val;\n  } catch {\n    return null;\n  }\n}\n\nfunction isCGroupV2(): boolean {\n  return existsSync('/sys/fs/cgroup/cpu.stat');\n}\n\nfunction isCGroupV1(): boolean {\n  return existsSync('/sys/fs/cgroup/cpuacct/cpuacct.usage');\n}\n\nexport function getCpuMonitor(): CpuMonitor {\n  if (isCGroupV2()) return new CGroupV2CpuMonitor();\n  if (isCGroupV1()) return new CGroupV1CpuMonitor();\n  return new DefaultCpuMonitor();\n}\n"],"mappings":"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","names":["os"]}

package/dist/cpu.d.cts

@@ -0,0 +1,24 @@
+/** @internal */
+export interface CpuMonitor {
+    cpuCount(): number;
+    cpuPercent(intervalMs: number): Promise<number>;
+}
+/** @internal */
+export declare class DefaultCpuMonitor implements CpuMonitor {
+    cpuCount(): number;
+    cpuPercent(intervalMs: number): Promise<number>;
+}
+/** @internal */
+export declare class CGroupV2CpuMonitor implements CpuMonitor {
+    #private;
+    cpuCount(): number;
+    cpuPercent(intervalMs: number): Promise<number>;
+}
+/** @internal */
+export declare class CGroupV1CpuMonitor implements CpuMonitor {
+    #private;
+    cpuCount(): number;
+    cpuPercent(intervalMs: number): Promise<number>;
+}
+export declare function getCpuMonitor(): CpuMonitor;
+//# sourceMappingURL=cpu.d.ts.map

package/dist/cpu.d.ts

@@ -0,0 +1,24 @@
+/** @internal */
+export interface CpuMonitor {
+    cpuCount(): number;
+    cpuPercent(intervalMs: number): Promise<number>;
+}
+/** @internal */
+export declare class DefaultCpuMonitor implements CpuMonitor {
+    cpuCount(): number;
+    cpuPercent(intervalMs: number): Promise<number>;
+}
+/** @internal */
+export declare class CGroupV2CpuMonitor implements CpuMonitor {
+    #private;
+    cpuCount(): number;
+    cpuPercent(intervalMs: number): Promise<number>;
+}
+/** @internal */
+export declare class CGroupV1CpuMonitor implements CpuMonitor {
+    #private;
+    cpuCount(): number;
+    cpuPercent(intervalMs: number): Promise<number>;
+}
+export declare function getCpuMonitor(): CpuMonitor;
+//# sourceMappingURL=cpu.d.ts.map

package/dist/cpu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpu.d.ts","sourceRoot":"","sources":["../src/cpu.ts"],"names":[],"mappings":"AAMA,gBAAgB;AAChB,MAAM,WAAW,UAAU;IACzB,QAAQ,IAAI,MAAM,CAAC;IACnB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACjD;AAaD,gBAAgB;AAChB,qBAAa,iBAAkB,YAAW,UAAU;IAClD,QAAQ,IAAI,MAAM;IAIlB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAoBhD;AAED,gBAAgB;AAChB,qBAAa,kBAAmB,YAAW,UAAU;;IACnD,QAAQ,IAAI,MAAM;IAQlB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAwChD;AAED,gBAAgB;AAChB,qBAAa,kBAAmB,YAAW,UAAU;;IACnD,QAAQ,IAAI,MAAM;IAWlB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAiChD;AAmBD,wBAAgB,aAAa,IAAI,UAAU,CAI1C"}

package/dist/cpu.js

@@ -0,0 +1,152 @@
+import { existsSync, readFileSync } from "node:fs";
+import os from "node:os";
+function cpuCountFromEnv() {
+  const raw = process.env.NUM_CPUS;
+  if (raw === void 0) return void 0;
+  const parsed = parseFloat(raw);
+  if (Number.isNaN(parsed)) {
+    console.warn("Failed to parse NUM_CPUS from environment");
+    return void 0;
+  }
+  return parsed;
+}
+class DefaultCpuMonitor {
+  cpuCount() {
+    return cpuCountFromEnv() ?? (os.cpus().length || 1);
+  }
+  cpuPercent(intervalMs) {
+    return new Promise((resolve) => {
+      const cpus1 = os.cpus();
+      const timer = setTimeout(() => {
+        const cpus2 = os.cpus();
+        let idle = 0;
+        let total = 0;
+        for (let i = 0; i < cpus1.length; i++) {
+          const cpu1 = cpus1[i].times;
+          const cpu2 = cpus2[i].times;
+          idle += cpu2.idle - cpu1.idle;
+          const total1 = Object.values(cpu1).reduce((acc, v) => acc + v, 0);
+          const total2 = Object.values(cpu2).reduce((acc, v) => acc + v, 0);
+          total += total2 - total1;
+        }
+        resolve(total === 0 ? 0 : Math.max(Math.min(+(1 - idle / total).toFixed(2), 1), 0));
+      }, intervalMs);
+      timer.unref();
+    });
+  }
+}
+class CGroupV2CpuMonitor {
+  cpuCount() {
+    const envCpus = cpuCountFromEnv();
+    if (envCpus !== void 0) return envCpus;
+    const [quota, period] = this.#readCpuMax();
+    if (quota === "max") return os.cpus().length || 1;
+    return parseInt(quota) / period;
+  }
+  cpuPercent(intervalMs) {
+    return new Promise((resolve, reject) => {
+      const usageStart = this.#readCpuUsage();
+      const timer = setTimeout(() => {
+        try {
+          const usageEnd = this.#readCpuUsage();
+          const usageDiffUsec = usageEnd - usageStart;
+          const usageSeconds = usageDiffUsec / 1e6;
+          const numCpus = this.cpuCount();
+          const intervalSeconds = intervalMs / 1e3;
+          const percent = usageSeconds / (intervalSeconds * numCpus);
+          resolve(Math.max(Math.min(percent, 1), 0));
+        } catch (e) {
+          reject(e);
+        }
+      }, intervalMs);
+      timer.unref();
+    });
+  }
+  #readCpuMax() {
+    try {
+      const data = readFileSync("/sys/fs/cgroup/cpu.max", "utf-8").trim().split(/\s+/);
+      const quota = data[0] ?? "max";
+      const period = data[1] ? parseInt(data[1]) : 1e5;
+      return [quota, Number.isNaN(period) ? 1e5 : period];
+    } catch {
+      return ["max", 1e5];
+    }
+  }
+  #readCpuUsage() {
+    const content = readFileSync("/sys/fs/cgroup/cpu.stat", "utf-8");
+    for (const line of content.split("\n")) {
+      if (line.startsWith("usage_usec")) {
+        return parseInt(line.split(/\s+/)[1]);
+      }
+    }
+    throw new Error("Failed to read CPU usage from /sys/fs/cgroup/cpu.stat");
+  }
+}
+class CGroupV1CpuMonitor {
+  cpuCount() {
+    const envCpus = cpuCountFromEnv();
+    if (envCpus !== void 0) return envCpus;
+    const [quota, period] = this.#readCfsQuotaAndPeriod();
+    if (quota === null || quota < 0 || period === null || period <= 0) {
+      return 2;
+    }
+    return Math.max(quota / period, 1);
+  }
+  cpuPercent(intervalMs) {
+    return new Promise((resolve, reject) => {
+      const usageStart = this.#readCpuacctUsage();
+      const timer = setTimeout(() => {
+        try {
+          const usageEnd = this.#readCpuacctUsage();
+          const usageDiffNs = usageEnd - usageStart;
+          const usageSeconds = usageDiffNs / 1e9;
+          const numCpus = this.cpuCount();
+          const intervalSeconds = intervalMs / 1e3;
+          const percent = usageSeconds / (intervalSeconds * numCpus);
+          resolve(Math.max(Math.min(percent, 1), 0));
+        } catch (e) {
+          reject(e);
+        }
+      }, intervalMs);
+      timer.unref();
+    });
+  }
+  #readCfsQuotaAndPeriod() {
+    const quota = readFirstInt("/sys/fs/cgroup/cpu/cpu.cfs_quota_us");
+    const period = readFirstInt("/sys/fs/cgroup/cpu/cpu.cfs_period_us");
+    return [quota, period];
+  }
+  #readCpuacctUsage() {
+    const value = readFirstInt("/sys/fs/cgroup/cpuacct/cpuacct.usage");
+    if (value === null) {
+      throw new Error("Failed to read cpuacct.usage for cgroup v1");
+    }
+    return value;
+  }
+}
+function readFirstInt(path) {
+  try {
+    const val = parseInt(readFileSync(path, "utf-8").trim());
+    return Number.isNaN(val) ? null : val;
+  } catch {
+    return null;
+  }
+}
+function isCGroupV2() {
+  return existsSync("/sys/fs/cgroup/cpu.stat");
+}
+function isCGroupV1() {
+  return existsSync("/sys/fs/cgroup/cpuacct/cpuacct.usage");
+}
+function getCpuMonitor() {
+  if (isCGroupV2()) return new CGroupV2CpuMonitor();
+  if (isCGroupV1()) return new CGroupV1CpuMonitor();
+  return new DefaultCpuMonitor();
+}
+export {
+  CGroupV1CpuMonitor,
+  CGroupV2CpuMonitor,
+  DefaultCpuMonitor,
+  getCpuMonitor
+};
+//# sourceMappingURL=cpu.js.map

package/dist/cpu.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cpu.ts"],"sourcesContent":["// SPDX-FileCopyrightText: 2025 LiveKit, Inc.\n//\n// SPDX-License-Identifier: Apache-2.0\nimport { existsSync, readFileSync } from 'node:fs';\nimport os from 'node:os';\n\n/** @internal */\nexport interface CpuMonitor {\n  cpuCount(): number;\n  cpuPercent(intervalMs: number): Promise<number>;\n}\n\nfunction cpuCountFromEnv(): number | undefined {\n  const raw = process.env.NUM_CPUS;\n  if (raw === undefined) return undefined;\n  const parsed = parseFloat(raw);\n  if (Number.isNaN(parsed)) {\n    console.warn('Failed to parse NUM_CPUS from environment');\n    return undefined;\n  }\n  return parsed;\n}\n\n/** @internal */\nexport class DefaultCpuMonitor implements CpuMonitor {\n  cpuCount(): number {\n    return cpuCountFromEnv() ?? (os.cpus().length || 1);\n  }\n\n  cpuPercent(intervalMs: number): Promise<number> {\n    return new Promise((resolve) => {\n      const cpus1 = os.cpus();\n      const timer = setTimeout(() => {\n        const cpus2 = os.cpus();\n        let idle = 0;\n        let total = 0;\n        for (let i = 0; i < cpus1.length; i++) {\n          const cpu1 = cpus1[i]!.times;\n          const cpu2 = cpus2[i]!.times;\n          idle += cpu2.idle - cpu1.idle;\n          const total1 = Object.values(cpu1).reduce((acc, v) => acc + v, 0);\n          const total2 = Object.values(cpu2).reduce((acc, v) => acc + v, 0);\n          total += total2 - total1;\n        }\n        resolve(total === 0 ? 0 : Math.max(Math.min(+(1 - idle / total).toFixed(2), 1), 0));\n      }, intervalMs);\n      timer.unref();\n    });\n  }\n}\n\n/** @internal */\nexport class CGroupV2CpuMonitor implements CpuMonitor {\n  cpuCount(): number {\n    const envCpus = cpuCountFromEnv();\n    if (envCpus !== undefined) return envCpus;\n    const [quota, period] = this.#readCpuMax();\n    if (quota === 'max') return os.cpus().length || 1;\n    return parseInt(quota) / period;\n  }\n\n  cpuPercent(intervalMs: number): Promise<number> {\n    return new Promise((resolve, reject) => {\n      const usageStart = this.#readCpuUsage();\n      const timer = setTimeout(() => {\n        try {\n          const usageEnd = this.#readCpuUsage();\n          const usageDiffUsec = usageEnd - usageStart;\n          const usageSeconds = usageDiffUsec / 1_000_000;\n          const numCpus = this.cpuCount();\n          const intervalSeconds = intervalMs / 1000;\n          const percent = usageSeconds / (intervalSeconds * numCpus);\n          resolve(Math.max(Math.min(percent, 1), 0));\n        } catch (e) {\n          reject(e);\n        }\n      }, intervalMs);\n      timer.unref();\n    });\n  }\n\n  #readCpuMax(): [string, number] {\n    try {\n      const data = readFileSync('/sys/fs/cgroup/cpu.max', 'utf-8').trim().split(/\\s+/);\n      const quota = data[0] ?? 'max';\n      const period = data[1] ? parseInt(data[1]) : 100_000;\n      return [quota, Number.isNaN(period) ? 100_000 : period];\n    } catch {\n      return ['max', 100_000];\n    }\n  }\n\n  #readCpuUsage(): number {\n    const content = readFileSync('/sys/fs/cgroup/cpu.stat', 'utf-8');\n    for (const line of content.split('\\n')) {\n      if (line.startsWith('usage_usec')) {\n        return parseInt(line.split(/\\s+/)[1]!);\n      }\n    }\n    throw new Error('Failed to read CPU usage from /sys/fs/cgroup/cpu.stat');\n  }\n}\n\n/** @internal */\nexport class CGroupV1CpuMonitor implements CpuMonitor {\n  cpuCount(): number {\n    const envCpus = cpuCountFromEnv();\n    if (envCpus !== undefined) return envCpus;\n    const [quota, period] = this.#readCfsQuotaAndPeriod();\n    if (quota === null || quota < 0 || period === null || period <= 0) {\n      // do not use the host CPU count as it could overstate the number available to the container\n      return 2.0;\n    }\n    return Math.max(quota / period, 1.0);\n  }\n\n  cpuPercent(intervalMs: number): Promise<number> {\n    return new Promise((resolve, reject) => {\n      const usageStart = this.#readCpuacctUsage();\n      const timer = setTimeout(() => {\n        try {\n          const usageEnd = this.#readCpuacctUsage();\n          const usageDiffNs = usageEnd - usageStart;\n          const usageSeconds = usageDiffNs / 1_000_000_000;\n          const numCpus = this.cpuCount();\n          const intervalSeconds = intervalMs / 1000;\n          const percent = usageSeconds / (intervalSeconds * numCpus);\n          resolve(Math.max(Math.min(percent, 1.0), 0.0));\n        } catch (e) {\n          reject(e);\n        }\n      }, intervalMs);\n      timer.unref();\n    });\n  }\n\n  #readCfsQuotaAndPeriod(): [number | null, number | null] {\n    const quota = readFirstInt('/sys/fs/cgroup/cpu/cpu.cfs_quota_us');\n    const period = readFirstInt('/sys/fs/cgroup/cpu/cpu.cfs_period_us');\n    return [quota, period];\n  }\n\n  #readCpuacctUsage(): number {\n    const value = readFirstInt('/sys/fs/cgroup/cpuacct/cpuacct.usage');\n    if (value === null) {\n      throw new Error('Failed to read cpuacct.usage for cgroup v1');\n    }\n    return value;\n  }\n}\n\nfunction readFirstInt(path: string): number | null {\n  try {\n    const val = parseInt(readFileSync(path, 'utf-8').trim());\n    return Number.isNaN(val) ? null : val;\n  } catch {\n    return null;\n  }\n}\n\nfunction isCGroupV2(): boolean {\n  return existsSync('/sys/fs/cgroup/cpu.stat');\n}\n\nfunction isCGroupV1(): boolean {\n  return existsSync('/sys/fs/cgroup/cpuacct/cpuacct.usage');\n}\n\nexport function getCpuMonitor(): CpuMonitor {\n  if (isCGroupV2()) return new CGroupV2CpuMonitor();\n  if (isCGroupV1()) return new CGroupV1CpuMonitor();\n  return new DefaultCpuMonitor();\n}\n"],"mappings":"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","names":[]}

package/dist/cpu.test.cjs

@@ -0,0 +1,227 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var import_node_fs = require("node:fs");
+var import_node_os = __toESM(require("node:os"), 1);
+var import_vitest = require("vitest");
+var import_cpu = require("./cpu.cjs");
+import_vitest.vi.mock("node:fs", () => ({
+  existsSync: import_vitest.vi.fn(() => false),
+  readFileSync: import_vitest.vi.fn(() => "")
+}));
+const mockExistsSync = import_vitest.vi.mocked(import_node_fs.existsSync);
+const mockReadFileSync = import_vitest.vi.mocked(import_node_fs.readFileSync);
+(0, import_vitest.describe)("cpu", () => {
+  (0, import_vitest.beforeEach)(() => {
+    import_vitest.vi.clearAllMocks();
+    delete process.env.NUM_CPUS;
+  });
+  (0, import_vitest.afterEach)(() => {
+    delete process.env.NUM_CPUS;
+  });
+  (0, import_vitest.describe)("getCpuMonitor", () => {
+    (0, import_vitest.it)("returns CGroupV2CpuMonitor when /sys/fs/cgroup/cpu.stat exists", () => {
+      mockExistsSync.mockImplementation((p) => p === "/sys/fs/cgroup/cpu.stat");
+      const monitor = (0, import_cpu.getCpuMonitor)();
+      (0, import_vitest.expect)(monitor).toBeInstanceOf(import_cpu.CGroupV2CpuMonitor);
+    });
+    (0, import_vitest.it)("returns CGroupV1CpuMonitor when cgroup v1 paths exist", () => {
+      mockExistsSync.mockImplementation((p) => p === "/sys/fs/cgroup/cpuacct/cpuacct.usage");
+      const monitor = (0, import_cpu.getCpuMonitor)();
+      (0, import_vitest.expect)(monitor).toBeInstanceOf(import_cpu.CGroupV1CpuMonitor);
+    });
+    (0, import_vitest.it)("returns DefaultCpuMonitor when no cgroup paths exist", () => {
+      mockExistsSync.mockReturnValue(false);
+      const monitor = (0, import_cpu.getCpuMonitor)();
+      (0, import_vitest.expect)(monitor).toBeInstanceOf(import_cpu.DefaultCpuMonitor);
+    });
+  });
+  (0, import_vitest.describe)("DefaultCpuMonitor", () => {
+    (0, import_vitest.it)("returns os.cpus().length for cpuCount", () => {
+      const monitor = new import_cpu.DefaultCpuMonitor();
+      (0, import_vitest.expect)(monitor.cpuCount()).toBe(import_node_os.default.cpus().length);
+    });
+    (0, import_vitest.it)("respects NUM_CPUS env var", () => {
+      process.env.NUM_CPUS = "4.5";
+      const monitor = new import_cpu.DefaultCpuMonitor();
+      (0, import_vitest.expect)(monitor.cpuCount()).toBe(4.5);
+    });
+    (0, import_vitest.it)("ignores invalid NUM_CPUS", () => {
+      process.env.NUM_CPUS = "notanumber";
+      const monitor = new import_cpu.DefaultCpuMonitor();
+      (0, import_vitest.expect)(monitor.cpuCount()).toBe(import_node_os.default.cpus().length);
+    });
+    (0, import_vitest.it)("cpuPercent returns value in [0, 1]", async () => {
+      const monitor = new import_cpu.DefaultCpuMonitor();
+      const result = await monitor.cpuPercent(50);
+      (0, import_vitest.expect)(result).toBeGreaterThanOrEqual(0);
+      (0, import_vitest.expect)(result).toBeLessThanOrEqual(1);
+    }, 1e4);
+  });
+  (0, import_vitest.describe)("CGroupV2CpuMonitor", () => {
+    (0, import_vitest.it)("returns quota/period for cpuCount", () => {
+      mockReadFileSync.mockImplementation((p) => {
+        if (String(p) === "/sys/fs/cgroup/cpu.max") return "200000 100000";
+        return "";
+      });
+      const monitor = new import_cpu.CGroupV2CpuMonitor();
+      (0, import_vitest.expect)(monitor.cpuCount()).toBe(2);
+    });
+    (0, import_vitest.it)("falls back to os.cpus().length when quota is max", () => {
+      mockReadFileSync.mockImplementation((p) => {
+        if (String(p) === "/sys/fs/cgroup/cpu.max") return "max 100000";
+        return "";
+      });
+      const monitor = new import_cpu.CGroupV2CpuMonitor();
+      (0, import_vitest.expect)(monitor.cpuCount()).toBe(import_node_os.default.cpus().length);
+    });
+    (0, import_vitest.it)("handles missing cpu.max gracefully", () => {
+      mockReadFileSync.mockImplementation(() => {
+        throw new Error("ENOENT");
+      });
+      const monitor = new import_cpu.CGroupV2CpuMonitor();
+      (0, import_vitest.expect)(monitor.cpuCount()).toBe(import_node_os.default.cpus().length);
+    });
+    (0, import_vitest.it)("respects NUM_CPUS env var", () => {
+      process.env.NUM_CPUS = "3";
+      const monitor = new import_cpu.CGroupV2CpuMonitor();
+      (0, import_vitest.expect)(monitor.cpuCount()).toBe(3);
+    });
+    (0, import_vitest.it)("cpuPercent computes correct value from usage_usec deltas", async () => {
+      let callCount = 0;
+      mockReadFileSync.mockImplementation((p) => {
+        if (String(p) === "/sys/fs/cgroup/cpu.stat") {
+          callCount++;
+          return callCount <= 1 ? "usage_usec 1000000\nuser_usec 800000\nsystem_usec 200000" : "usage_usec 2000000\nuser_usec 1600000\nsystem_usec 400000";
+        }
+        if (String(p) === "/sys/fs/cgroup/cpu.max") return "200000 100000";
+        return "";
+      });
+      const monitor = new import_cpu.CGroupV2CpuMonitor();
+      const result = await monitor.cpuPercent(100);
+      (0, import_vitest.expect)(result).toBe(1);
+    }, 1e4);
+    (0, import_vitest.it)("cpuPercent returns fractional load", async () => {
+      let callCount = 0;
+      mockReadFileSync.mockImplementation((p) => {
+        if (String(p) === "/sys/fs/cgroup/cpu.stat") {
+          callCount++;
+          return callCount <= 1 ? "usage_usec 1000000\n" : "usage_usec 1050000\n";
+        }
+        if (String(p) === "/sys/fs/cgroup/cpu.max") return "200000 100000";
+        return "";
+      });
+      const monitor = new import_cpu.CGroupV2CpuMonitor();
+      const result = await monitor.cpuPercent(100);
+      (0, import_vitest.expect)(result).toBeCloseTo(0.25, 1);
+    }, 1e4);
+    (0, import_vitest.it)("throws when usage_usec is missing from cpu.stat", async () => {
+      mockReadFileSync.mockImplementation((p) => {
+        if (String(p) === "/sys/fs/cgroup/cpu.stat") return "user_usec 800000\nsystem_usec 200000";
+        return "";
+      });
+      const monitor = new import_cpu.CGroupV2CpuMonitor();
+      await (0, import_vitest.expect)(() => monitor.cpuPercent(50)).rejects.toThrow("Failed to read CPU usage");
+    });
+  });
+  (0, import_vitest.describe)("CGroupV1CpuMonitor", () => {
+    (0, import_vitest.it)("returns quota/period for cpuCount", () => {
+      mockReadFileSync.mockImplementation((p) => {
+        if (String(p) === "/sys/fs/cgroup/cpu/cpu.cfs_quota_us") return "200000";
+        if (String(p) === "/sys/fs/cgroup/cpu/cpu.cfs_period_us") return "100000";
+        return "";
+      });
+      const monitor = new import_cpu.CGroupV1CpuMonitor();
+      (0, import_vitest.expect)(monitor.cpuCount()).toBe(2);
+    });
+    (0, import_vitest.it)("defaults to 2.0 when quota is -1", () => {
+      mockReadFileSync.mockImplementation((p) => {
+        if (String(p) === "/sys/fs/cgroup/cpu/cpu.cfs_quota_us") return "-1";
+        if (String(p) === "/sys/fs/cgroup/cpu/cpu.cfs_period_us") return "100000";
+        return "";
+      });
+      const monitor = new import_cpu.CGroupV1CpuMonitor();
+      (0, import_vitest.expect)(monitor.cpuCount()).toBe(2);
+    });
+    (0, import_vitest.it)("defaults to 2.0 when quota file is unreadable", () => {
+      mockReadFileSync.mockImplementation(() => {
+        throw new Error("ENOENT");
+      });
+      const monitor = new import_cpu.CGroupV1CpuMonitor();
+      (0, import_vitest.expect)(monitor.cpuCount()).toBe(2);
+    });
+    (0, import_vitest.it)("clamps cpuCount to minimum 1.0", () => {
+      mockReadFileSync.mockImplementation((p) => {
+        if (String(p) === "/sys/fs/cgroup/cpu/cpu.cfs_quota_us") return "50000";
+        if (String(p) === "/sys/fs/cgroup/cpu/cpu.cfs_period_us") return "100000";
+        return "";
+      });
+      const monitor = new import_cpu.CGroupV1CpuMonitor();
+      (0, import_vitest.expect)(monitor.cpuCount()).toBe(1);
+    });
+    (0, import_vitest.it)("respects NUM_CPUS env var", () => {
+      process.env.NUM_CPUS = "8";
+      const monitor = new import_cpu.CGroupV1CpuMonitor();
+      (0, import_vitest.expect)(monitor.cpuCount()).toBe(8);
+    });
+    (0, import_vitest.it)("cpuPercent computes correct value from nanosecond deltas", async () => {
+      let callCount = 0;
+      mockReadFileSync.mockImplementation((p) => {
+        if (String(p) === "/sys/fs/cgroup/cpuacct/cpuacct.usage") {
+          callCount++;
+          return callCount <= 1 ? "1000000000" : "1100000000";
+        }
+        if (String(p) === "/sys/fs/cgroup/cpu/cpu.cfs_quota_us") return "200000";
+        if (String(p) === "/sys/fs/cgroup/cpu/cpu.cfs_period_us") return "100000";
+        return "";
+      });
+      const monitor = new import_cpu.CGroupV1CpuMonitor();
+      const result = await monitor.cpuPercent(100);
+      (0, import_vitest.expect)(result).toBeCloseTo(0.5, 1);
+    }, 1e4);
+    (0, import_vitest.it)("clamps cpuPercent output to [0, 1]", async () => {
+      let callCount = 0;
+      mockReadFileSync.mockImplementation((p) => {
+        if (String(p) === "/sys/fs/cgroup/cpuacct/cpuacct.usage") {
+          callCount++;
+          return callCount <= 1 ? "0" : "10000000000";
+        }
+        if (String(p) === "/sys/fs/cgroup/cpu/cpu.cfs_quota_us") return "100000";
+        if (String(p) === "/sys/fs/cgroup/cpu/cpu.cfs_period_us") return "100000";
+        return "";
+      });
+      const monitor = new import_cpu.CGroupV1CpuMonitor();
+      const result = await monitor.cpuPercent(100);
+      (0, import_vitest.expect)(result).toBeLessThanOrEqual(1);
+      (0, import_vitest.expect)(result).toBeGreaterThanOrEqual(0);
+    }, 1e4);
+    (0, import_vitest.it)("throws when cpuacct.usage is unreadable", async () => {
+      mockReadFileSync.mockImplementation(() => {
+        throw new Error("ENOENT");
+      });
+      const monitor = new import_cpu.CGroupV1CpuMonitor();
+      await (0, import_vitest.expect)(() => monitor.cpuPercent(50)).rejects.toThrow("Failed to read cpuacct.usage");
+    });
+  });
+});
+//# sourceMappingURL=cpu.test.cjs.map