import fs from "node:fs/promises"; import path from "node:path"; import { afterEach, describe, expect, it, vi } from "vitest"; import { withTempDir } from "../test-helpers/temp-dir.js"; import { isExecutableFile, resolveExecutable, resolveExecutableFromPathEnv, resolveExecutablePath, } from "./executable-path.js"; function restoreEnvValue(name: string, value: string | undefined): void { if (value === undefined) { delete process.env[name]; } else { process.env[name] = value; } } describe("executable path helpers", () => { it("detects executable files and rejects directories or non-executables", async () => { await withTempDir({ prefix: "openclaw-exec-path-" }, async (base) => { const execPath = path.join(base, "tool"); const filePath = path.join(base, "plain.txt"); const dirPath = path.join(base, "dir"); await fs.writeFile(execPath, "#!/bin/sh\nexit 0\n", "utf8"); await fs.chmod(execPath, 0o755); await fs.writeFile(filePath, "nope", "utf8"); await fs.mkdir(dirPath); expect(isExecutableFile(execPath)).toBe(true); expect(isExecutableFile(filePath)).toBe(false); expect(isExecutableFile(dirPath)).toBe(false); expect(isExecutableFile(path.join(base, "missing"))).toBe(false); }); }); it("resolves executables from PATH entries and cwd-relative paths", async () => { await withTempDir({ prefix: "openclaw-exec-path-" }, async (base) => { const binDir = path.join(base, "bin"); const cwd = path.join(base, "cwd"); await fs.mkdir(binDir, { recursive: true }); await fs.mkdir(cwd, { recursive: true }); const pathTool = path.join(binDir, "runner"); const cwdTool = path.join(cwd, "local-tool"); await fs.writeFile(pathTool, "#!/bin/sh\nexit 0\n", "utf8"); await fs.writeFile(cwdTool, "#!/bin/sh\nexit 0\n", "utf8"); await fs.chmod(pathTool, 0o755); await fs.chmod(cwdTool, 0o755); expect(resolveExecutableFromPathEnv("runner", `${binDir}${path.delimiter}/usr/bin`)).toBe( pathTool, ); expect(resolveExecutableFromPathEnv("missing", binDir)).toBeUndefined(); expect(resolveExecutablePath("./local-tool", { cwd })).toBe(cwdTool); expect(resolveExecutablePath("runner", { env: { PATH: binDir } })).toBe(pathTool); expect(resolveExecutablePath("missing", { env: { PATH: binDir } })).toBeUndefined(); }); }); it("resolves absolute, home-relative, and Path-cased env executables", async () => { await withTempDir({ prefix: "openclaw-exec-path-" }, async (base) => { const homeDir = path.join(base, "home"); const binDir = path.join(base, "bin"); await fs.mkdir(homeDir, { recursive: true }); await fs.mkdir(binDir, { recursive: true }); const homeTool = path.join(homeDir, "home-tool"); const absoluteTool = path.join(base, "absolute-tool"); const pathTool = path.join(binDir, "runner"); await fs.writeFile(homeTool, "#!/bin/sh\nexit 0\n", "utf8"); await fs.writeFile(absoluteTool, "#!/bin/sh\nexit 0\n", "utf8"); await fs.writeFile(pathTool, "#!/bin/sh\nexit 0\n", "utf8"); await fs.chmod(homeTool, 0o755); await fs.chmod(absoluteTool, 0o755); await fs.chmod(pathTool, 0o755); expect(resolveExecutablePath(absoluteTool)).toBe(absoluteTool); expect( path.normalize(resolveExecutablePath("~/home-tool", { env: { HOME: homeDir } }) ?? ""), ).toBe(path.normalize(homeTool)); expect(path.normalize(resolveExecutablePath("runner", { env: { Path: binDir } }) ?? "")).toBe( path.normalize(pathTool), ); expect(resolveExecutablePath("~/missing-tool", { env: { HOME: homeDir } })).toBeUndefined(); }); }); it("does not treat drive-less rooted windows paths as cwd-relative executables", () => { if (process.platform !== "win32") { return; } expect( resolveExecutablePath(String.raw`:\Users\demo\AI\system\openclaw\git.exe`, { cwd: String.raw`C:\Users\demo\AI\system\openclaw`, }), ).toBeUndefined(); expect( resolveExecutablePath(String.raw`:/Users/demo/AI/system/openclaw/git.exe`, { cwd: String.raw`C:\Users\demo\AI\system\openclaw`, }), ).toBeUndefined(); }); }); describe("resolveExecutable", () => { afterEach(() => { vi.restoreAllMocks(); }); it("returns cmd unchanged on non-Windows platforms", () => { const platformSpy = vi.spyOn(process, "platform", "get").mockReturnValue("linux"); expect(resolveExecutable("gcloud")).toBe("gcloud"); platformSpy.mockRestore(); }); it("returns cmd unchanged when it already carries a known PATHEXT extension on Windows", () => { const platformSpy = vi.spyOn(process, "platform", "get").mockReturnValue("win32"); expect(resolveExecutable("gcloud.cmd")).toBe("gcloud.cmd"); expect(resolveExecutable("gcloud.exe")).toBe("gcloud.exe"); expect(resolveExecutable("gcloud.bat")).toBe("gcloud.bat"); expect(resolveExecutable("gcloud.com")).toBe("gcloud.com"); platformSpy.mockRestore(); }); it("resolves to the first .cmd result from PATH on Windows without executing where.exe", async () => { const platformSpy = vi.spyOn(process, "platform", "get").mockReturnValue("win32"); await withTempDir({ prefix: "openclaw-exec-path-" }, async (base) => { const binDir = path.join(base, "bin"); await fs.mkdir(binDir, { recursive: true }); const cmdPath = path.join(binDir, "gcloud.cmd"); const exePath = path.join(binDir, "gcloud.exe"); await fs.writeFile(cmdPath, "@echo off\n", "utf8"); await fs.writeFile(exePath, "exe\n", "utf8"); const originalPath = process.env.PATH; const originalPathext = process.env.PATHEXT; process.env.PATH = binDir; process.env.PATHEXT = ".EXE;.CMD;.BAT;.COM"; try { expect(resolveExecutable("gcloud")).toBe(cmdPath); } finally { restoreEnvValue("PATH", originalPath); restoreEnvValue("PATHEXT", originalPathext); } }); platformSpy.mockRestore(); }); it("falls back to .exe when no .cmd match exists on Windows", async () => { const platformSpy = vi.spyOn(process, "platform", "get").mockReturnValue("win32"); await withTempDir({ prefix: "openclaw-exec-path-" }, async (base) => { const binDir = path.join(base, "bin"); await fs.mkdir(binDir, { recursive: true }); const exePath = path.join(binDir, "tailscale.exe"); await fs.writeFile(exePath, "exe\n", "utf8"); const originalPath = process.env.PATH; process.env.PATH = binDir; try { expect(resolveExecutable("tailscale")).toBe(exePath); } finally { restoreEnvValue("PATH", originalPath); } }); platformSpy.mockRestore(); }); it("falls back to first PATH result when no .cmd or .exe match exists on Windows", async () => { const platformSpy = vi.spyOn(process, "platform", "get").mockReturnValue("win32"); await withTempDir({ prefix: "openclaw-exec-path-" }, async (base) => { const binDir = path.join(base, "bin"); await fs.mkdir(binDir, { recursive: true }); const ps1Path = path.join(binDir, "gcloud.ps1"); await fs.writeFile(ps1Path, "Write-Output ok\n", "utf8"); const originalPath = process.env.PATH; const originalPathext = process.env.PATHEXT; process.env.PATH = binDir; process.env.PATHEXT = ".PS1"; try { expect(resolveExecutable("gcloud")).toBe(ps1Path); } finally { restoreEnvValue("PATH", originalPath); restoreEnvValue("PATHEXT", originalPathext); } }); platformSpy.mockRestore(); }); it("returns original cmd when no PATH match exists on Windows", () => { const platformSpy = vi.spyOn(process, "platform", "get").mockReturnValue("win32"); expect(resolveExecutable("gog")).toBe("gog"); platformSpy.mockRestore(); }); });