@abot-ai/runtime 1.7.0 → 1.8.1

package/plugins/system-probe/plugin.json

@@ -2,8 +2,12 @@
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "system-probe",
   "version": "1.0.0",
-  "description": "Inspect current machine health and disk capacity.",
+  "description": "Inspect machine health and available disk capacity.",
   "extensions": {
+    "ai.abot.compatibility": {
+      "version": 1,
+      "runtimePlatforms": ["linux", "darwin", "win32"]
+    },
     "ai.abot.runtime": {
       "version": 1,
       "entrypoint": "./src/index.cjs",
@@ -17,9 +21,11 @@
             "metadata": {
               "path": {
                 "param": "path",
-                "kind": "string",
-                "default": "/"
+                "kind": "string"
               }
+            },
+            "resultMetadata": {
+              "path": { "path": "data.diskPath", "kind": "preview" }
             }
           },
           "skills": [],

package/plugins/system-probe/source/disk-path.ts

@@ -0,0 +1,8 @@
+/** The Windows default follows the runtime root's actual filesystem volume. */
+export function defaultDiskProbePath(
+  runtimeRoot: string,
+  platform: NodeJS.Platform = process.platform,
+): string {
+  if (platform === "win32") return runtimeRoot;
+  return "/";
+}

package/plugins/system-probe/source/index.ts

@@ -9,6 +9,7 @@ import {
   successResult,
 } from "../../../src/plugin-sdk/index.js";
 
+import { defaultDiskProbePath } from "./disk-path.js";
 import { bytesToGiB, formatDuration, readMachineMetrics } from "./metrics.js";
 
 const ALLOWED_PATH_LOCATIONS = Object.freeze([
@@ -35,10 +36,14 @@ export default defineRuntimePlugin((context) => ({
           executionContext?.runtimePathResolver ?? context.runtimePathResolver,
       };
       try {
-        const target = resolvePluginPath(pathContext, explicitPath ?? "/", {
-          requirePath: true,
-          allowedLocations: ALLOWED_PATH_LOCATIONS,
-        });
+        const target = resolvePluginPath(
+          pathContext,
+          explicitPath ?? defaultDiskProbePath(context.runtimePaths.rootDir),
+          {
+            requirePath: true,
+            allowedLocations: ALLOWED_PATH_LOCATIONS,
+          },
+        );
         let disk:
           | Readonly<{
               totalBytes: number;
@@ -90,7 +95,7 @@ export default defineRuntimePlugin((context) => ({
           `uptime: ${formatDuration(machine.uptimeSeconds)}`,
           `cpu_count: ${machine.cpuCount}`,
           `load_level: ${machine.loadLevel}`,
-          `load_average: ${machine.loadAverage.map((value) => value.toFixed(2)).join(" ")}`,
+          `load_average: ${machine.loadAverage?.map((value) => value.toFixed(2)).join(" ") ?? "unsupported"}`,
           `memory_used: ${bytesToGiB(machine.memoryUsedBytes)} / ${bytesToGiB(machine.memoryTotalBytes)}`,
           `memory_free: ${bytesToGiB(machine.memoryFreeBytes)}`,
           `disk_path: ${target.logicalPath}`,

package/plugins/system-probe/source/machine-load.ts

@@ -0,0 +1,33 @@
+import os from "node:os";
+
+type MachineLoad = Readonly<{
+  loadAverage: readonly number[] | null;
+  loadLevel: "low" | "moderate" | "high" | "unsupported";
+}>;
+
+function supportsLoadAverage(platform: NodeJS.Platform): boolean {
+  return platform !== "win32";
+}
+
+function classifyLoadPerCpu(loadAverage: readonly number[], cpuCount: number) {
+  const average = loadAverage[0] ?? 0;
+  const loadPerCpu = cpuCount > 0 ? average / cpuCount : average;
+  if (loadPerCpu < 0.5) return "low";
+  if (loadPerCpu < 1) return "moderate";
+  return "high";
+}
+
+export function readMachineLoad(
+  platform: NodeJS.Platform,
+  cpuCount: number,
+  readLoadAverage: () => number[] = () => os.loadavg(),
+): MachineLoad {
+  if (!supportsLoadAverage(platform)) {
+    return Object.freeze({ loadAverage: null, loadLevel: "unsupported" });
+  }
+  const loadAverage = Object.freeze(readLoadAverage());
+  return Object.freeze({
+    loadAverage,
+    loadLevel: classifyLoadPerCpu(loadAverage, cpuCount),
+  });
+}

package/plugins/system-probe/source/metrics.ts

@@ -1,5 +1,7 @@
 import os from "node:os";
 
+import { readMachineLoad } from "./machine-load.js";
+
 export function bytesToGiB(bytes: number): string {
   return `${(bytes / 1024 / 1024 / 1024).toFixed(1)} GiB`;
 }
@@ -19,19 +21,15 @@ export function formatDuration(totalSeconds: number): string {
 export function readMachineMetrics() {
   const memoryTotalBytes = os.totalmem();
   const memoryFreeBytes = os.freemem();
-  const loadAverage = os.loadavg();
   const cpuCount = os.cpus().length;
-  const loadPerCpu =
-    cpuCount > 0 ? (loadAverage[0] ?? 0) / cpuCount : (loadAverage[0] ?? 0);
-  const loadLevel =
-    loadPerCpu < 0.5 ? "low" : loadPerCpu < 1 ? "moderate" : "high";
+  const platform = os.platform();
+  const load = readMachineLoad(platform, cpuCount);
   return Object.freeze({
-    platform: os.platform(),
+    platform,
     architecture: os.arch(),
     uptimeSeconds: os.uptime(),
     cpuCount,
-    loadAverage: Object.freeze(loadAverage),
-    loadLevel,
+    ...load,
     memoryTotalBytes,
     memoryFreeBytes,
     memoryUsedBytes: Math.max(0, memoryTotalBytes - memoryFreeBytes),

package/plugins/system-probe/src/index.cjs

@@ -225,8 +225,39 @@ function failureFromError(error, options) {
 // src/capabilities/tool-media.ts
 var TOOL_IMAGE_MAX_BYTES = 10 * 1024 * 1024;
 
+// plugins/system-probe/source/disk-path.ts
+function defaultDiskProbePath(runtimeRoot, platform = process.platform) {
+  if (platform === "win32") return runtimeRoot;
+  return "/";
+}
+
 // plugins/system-probe/source/metrics.ts
+var import_node_os2 = __toESM(require("node:os"), 1);
+
+// plugins/system-probe/source/machine-load.ts
 var import_node_os = __toESM(require("node:os"), 1);
+function supportsLoadAverage(platform) {
+  return platform !== "win32";
+}
+function classifyLoadPerCpu(loadAverage, cpuCount) {
+  const average = loadAverage[0] ?? 0;
+  const loadPerCpu = cpuCount > 0 ? average / cpuCount : average;
+  if (loadPerCpu < 0.5) return "low";
+  if (loadPerCpu < 1) return "moderate";
+  return "high";
+}
+function readMachineLoad(platform, cpuCount, readLoadAverage = () => import_node_os.default.loadavg()) {
+  if (!supportsLoadAverage(platform)) {
+    return Object.freeze({ loadAverage: null, loadLevel: "unsupported" });
+  }
+  const loadAverage = Object.freeze(readLoadAverage());
+  return Object.freeze({
+    loadAverage,
+    loadLevel: classifyLoadPerCpu(loadAverage, cpuCount)
+  });
+}
+
+// plugins/system-probe/source/metrics.ts
 function bytesToGiB(bytes) {
   return `${(bytes / 1024 / 1024 / 1024).toFixed(1)} GiB`;
 }
@@ -242,19 +273,17 @@ function formatDuration(totalSeconds) {
   return parts.join(" ");
 }
 function readMachineMetrics() {
-  const memoryTotalBytes = import_node_os.default.totalmem();
-  const memoryFreeBytes = import_node_os.default.freemem();
-  const loadAverage = import_node_os.default.loadavg();
-  const cpuCount = import_node_os.default.cpus().length;
-  const loadPerCpu = cpuCount > 0 ? (loadAverage[0] ?? 0) / cpuCount : loadAverage[0] ?? 0;
-  const loadLevel = loadPerCpu < 0.5 ? "low" : loadPerCpu < 1 ? "moderate" : "high";
+  const memoryTotalBytes = import_node_os2.default.totalmem();
+  const memoryFreeBytes = import_node_os2.default.freemem();
+  const cpuCount = import_node_os2.default.cpus().length;
+  const platform = import_node_os2.default.platform();
+  const load = readMachineLoad(platform, cpuCount);
   return Object.freeze({
-    platform: import_node_os.default.platform(),
-    architecture: import_node_os.default.arch(),
-    uptimeSeconds: import_node_os.default.uptime(),
+    platform,
+    architecture: import_node_os2.default.arch(),
+    uptimeSeconds: import_node_os2.default.uptime(),
     cpuCount,
-    loadAverage: Object.freeze(loadAverage),
-    loadLevel,
+    ...load,
     memoryTotalBytes,
     memoryFreeBytes,
     memoryUsedBytes: Math.max(0, memoryTotalBytes - memoryFreeBytes)
@@ -281,10 +310,14 @@ var index_default = defineRuntimePlugin((context) => ({
         runtimePathResolver: executionContext?.runtimePathResolver ?? context.runtimePathResolver
       };
       try {
-        const target = resolvePluginPath(pathContext, explicitPath ?? "/", {
-          requirePath: true,
-          allowedLocations: ALLOWED_PATH_LOCATIONS
-        });
+        const target = resolvePluginPath(
+          pathContext,
+          explicitPath ?? defaultDiskProbePath(context.runtimePaths.rootDir),
+          {
+            requirePath: true,
+            allowedLocations: ALLOWED_PATH_LOCATIONS
+          }
+        );
         let disk;
         let diskStatus = "available";
         try {
@@ -328,7 +361,7 @@ var index_default = defineRuntimePlugin((context) => ({
           `uptime: ${formatDuration(machine.uptimeSeconds)}`,
           `cpu_count: ${machine.cpuCount}`,
           `load_level: ${machine.loadLevel}`,
-          `load_average: ${machine.loadAverage.map((value) => value.toFixed(2)).join(" ")}`,
+          `load_average: ${machine.loadAverage?.map((value) => value.toFixed(2)).join(" ") ?? "unsupported"}`,
           `memory_used: ${bytesToGiB(machine.memoryUsedBytes)} / ${bytesToGiB(machine.memoryTotalBytes)}`,
           `memory_free: ${bytesToGiB(machine.memoryFreeBytes)}`,
           `disk_path: ${target.logicalPath}`,

package/plugins/web/plugin.json

@@ -2,8 +2,12 @@
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "web",
   "version": "0.1.0",
-  "description": "Search the public web and fetch readable content from public URLs.",
+  "description": "Search the public web and read content from public URLs.",
   "extensions": {
+    "ai.abot.compatibility": {
+      "version": 1,
+      "runtimePlatforms": ["linux", "darwin", "win32"]
+    },
     "ai.abot.runtime": {
       "version": 1,
       "entrypoint": "./src/index.cjs",