@agent-sh/computer-use-linux 0.7.2 → 0.7.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-sh/computer-use-linux",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "Linux desktop-control MCP server: AT-SPI accessibility trees, Wayland/X11 input, screenshots, and compositor window targeting.",
   "license": "MIT",
   "type": "commonjs",

package/pi/extension/generated-tools.ts

@@ -7,7 +7,7 @@ export interface GeneratedMcpToolDefinition {
 	annotations: Record<string, unknown>;
 }
 
-export const GENERATED_SERVER_VERSION = "0.7.2";
+export const GENERATED_SERVER_VERSION = "0.7.3";
 export const GENERATED_TOOL_CATALOG_HASH = "a28811e528ada60c60d5e493d3680249428a65037cbd741ab0efa4711dd91837";
 export const GENERATED_SHELL_TOOL_CATALOG_HASH = "3e5700e7be824d965170c202204cb512ee41b7162088050a8d7f479d617d15d3";
 export const GENERATED_MCP_TOOLS =

package/pi/extension/index.ts

@@ -18,10 +18,11 @@ import {
 	constants,
 	existsSync,
 	readFileSync,
+	statSync,
 } from "node:fs";
 import { createRequire } from "node:module";
 import { homedir } from "node:os";
-import { join } from "node:path";
+import { delimiter, join } from "node:path";
 import { Type, type TSchema } from "typebox";
 import {
 	GENERATED_MCP_TOOLS,
@@ -154,6 +155,8 @@ function isRecord(value: unknown): value is Record<string, unknown> {
 
 function executable(path: string): boolean {
 	try {
+		// A directory on PATH also passes X_OK; only a regular file can be spawned.
+		if (!statSync(path).isFile()) return false;
 		accessSync(path, constants.X_OK);
 		return true;
 	} catch {
@@ -161,6 +164,23 @@ function executable(path: string): boolean {
 	}
 }
 
+/**
+ * First executable `name` in a PATH-style list, or `null`. Empty segments are
+ * skipped rather than read as the current directory.
+ */
+export function findExecutableOnPath(
+	pathValue: string | undefined,
+	name: string,
+	isExecutable: (path: string) => boolean = executable,
+): string | null {
+	for (const dir of (pathValue ?? "").split(delimiter)) {
+		if (!dir) continue;
+		const candidate = join(dir, name);
+		if (isExecutable(candidate)) return candidate;
+	}
+	return null;
+}
+
 function runtimeEnvironment(): Record<string, string> {
 	const allowed = new Set([
 		"PATH",
@@ -247,6 +267,15 @@ function defaultFindBinary(): BinaryLaunch | null {
 		return { binaryPath: bundledBinary, env };
 	}
 
+	// A temporary extension (`pi -e npm:@agent-sh/computer-use-linux`) is staged
+	// without the postinstall-downloaded platform binary, so fall back to a
+	// global npm or cargo install. The MCP client still checks the server
+	// version and tool catalog, so a mismatched install fails with that reason.
+	const onPath = findExecutableOnPath(process.env.PATH, "computer-use-linux");
+	if (onPath) {
+		return { binaryPath: onPath, env };
+	}
+
 	return null;
 }
 
@@ -504,7 +533,7 @@ export function createComputerUseLinuxExtension(
 			if (!resolved) {
 				throw new Error(
 					"computer-use-linux binary was not found. Reinstall " +
-						`${PACKAGE_NAME} or set COMPUTER_USE_LINUX_BIN.`,
+						`${PACKAGE_NAME}, install computer-use-linux on PATH, or set COMPUTER_USE_LINUX_BIN.`,
 				);
 			}
 			const { ComputerUseMcpClient } = loadClientModule();
@@ -622,7 +651,7 @@ export function createComputerUseLinuxExtension(
 
 			if (!resolveLaunch() && ctx.hasUI) {
 				ctx.ui.notify(
-					`${PACKAGE_NAME}: binary not found; reinstall the package or set COMPUTER_USE_LINUX_BIN.`,
+					`${PACKAGE_NAME}: binary not found; reinstall the package, install computer-use-linux on PATH, or set COMPUTER_USE_LINUX_BIN.`,
 					"warning",
 				);
 			}

package/skills/computer-use-linux/references/pi-setup.md

@@ -102,6 +102,12 @@ The extension looks for `computer-use-linux` in this order:
 
 1. `COMPUTER_USE_LINUX_BIN`
 2. The binary downloaded inside the installed npm package
+3. `computer-use-linux` on `PATH`, from `npm install -g` or `cargo install`
+
+A temporary extension (`pi -e npm:@agent-sh/computer-use-linux`) is staged
+without the downloaded binary, so it relies on the `PATH` step. The extension
+still checks that the server version and tool catalog match, so a mismatched
+install fails with that reason instead of starting.
 
 Reinstall the package if the bundled binary is missing: