import { execFile } from "node:child_process" import { promisify } from "node:util" import { NEMOCLAW_BIN, NODE_BIN, commandExists, hostCommandEnv } from "./hostCommands" const execFileAsync = promisify(execFile) const NEMOCLAW_LIFECYCLE_MIN_VERSION = "0.0.37" type NemoClawInvocation = { file: string args: string[] display: string[] } type NemoClawRunResult = { ok: boolean stdout: string stderr: string exitCode: number | null error: string | null } export type NemoClawDoctorCheck = { group: string label: string status: "ok" | "warn" | "fail" | "info" detail: string hint?: string } export type NemoClawDoctorReport = { schemaVersion: number sandbox: string status: "ok" | "warn" | "fail" | "info" failed: number warnings: number checks: NemoClawDoctorCheck[] } function buildNemoClawInvocation(args: string[]): NemoClawInvocation | null { if (!commandExists(NEMOCLAW_BIN)) return null if (/\.(?:c?m?js|ts)$/i.test(NEMOCLAW_BIN)) { return { file: NODE_BIN, args: [NEMOCLAW_BIN, ...args], display: [NODE_BIN, NEMOCLAW_BIN, ...args], } } return { file: NEMOCLAW_BIN, args, display: [NEMOCLAW_BIN, ...args], } } function parseVersion(value: string) { return value.match(/v?(\d+\.\d+\.\d+)/)?.[1] ?? null } function versionGte(left: string, right: string) { const leftParts = left.split(".").map((part) => Number.parseInt(part, 10) || 0) const rightParts = right.split(".").map((part) => Number.parseInt(part, 10) || 0) const length = Math.max(leftParts.length, rightParts.length) for (let index = 0; index < length; index += 1) { const a = leftParts[index] || 0 const b = rightParts[index] || 0 if (a > b) return true if (a < b) return false } return true } function parseJsonObject(value: string) { const trimmed = value.trim() if (!trimmed) return null try { return JSON.parse(trimmed) } catch { const start = trimmed.indexOf("{") const end = trimmed.lastIndexOf("}") if (start === -1 || end === -1 || end <= start) return null return JSON.parse(trimmed.slice(start, end + 1)) } } async function runNemoClaw(args: string[], timeout = 30000): Promise { const invocation = buildNemoClawInvocation(args) if (!invocation) { return { ok: false, stdout: "", stderr: "", exitCode: null, error: "NemoClaw CLI is not available", command: [NEMOCLAW_BIN, ...args], } } try { const { stdout, stderr } = await execFileAsync(invocation.file, invocation.args, { env: hostCommandEnv({ OPENSHELL_GATEWAY: process.env.OPENSHELL_GATEWAY?.trim() || undefined, NO_COLOR: "1", CLICOLOR: "0", CLICOLOR_FORCE: "0", }), timeout, maxBuffer: 8 * 1024 * 1024, }) return { ok: true, stdout: String(stdout).trim(), stderr: String(stderr).trim(), exitCode: 0, error: null, command: invocation.display, } } catch (error: any) { return { ok: false, stdout: String(error?.stdout || "").trim(), stderr: String(error?.stderr || "").trim(), exitCode: typeof error?.code === "number" ? error.code : null, error: error instanceof Error ? error.message : String(error ?? "NemoClaw command failed"), command: invocation.display, } } } export async function getNemoClawVersion() { const result = await runNemoClaw(["--version"], 10000) const version = parseVersion(`${result.stdout}\n${result.stderr}`) return { available: result.ok || Boolean(version), version, stdout: result.stdout, stderr: result.stderr, error: result.ok ? null : result.error, command: result.command, } } async function hasModernNemoClawSurface() { const version = await getNemoClawVersion() return { ...version, supported: version.version ? versionGte(version.version, NEMOCLAW_LIFECYCLE_MIN_VERSION) : false, minimumVersion: NEMOCLAW_LIFECYCLE_MIN_VERSION, } } export async function getNemoClawDoctorReport(sandboxName: string) { const capability = await hasModernNemoClawSurface() if (!capability.supported) { return { available: capability.available, supported: false, attempted: false, version: capability.version, minimumVersion: capability.minimumVersion, report: null as NemoClawDoctorReport | null, error: capability.available ? `NemoClaw ${capability.version || "unknown"} does not expose doctor --json` : capability.error || "NemoClaw CLI is not available", } } const result = await runNemoClaw([sandboxName, "doctor", "--json"], 30000) const parsed = result.ok ? parseJsonObject(result.stdout) : null const report = parsed && typeof parsed === "object" ? parsed as NemoClawDoctorReport : null return { available: true, supported: true, attempted: true, version: capability.version, minimumVersion: capability.minimumVersion, report, error: report ? null : result.error || result.stderr || "NemoClaw doctor did not return JSON", stdout: result.stdout, stderr: result.stderr, exitCode: result.exitCode, } } export async function restartSandboxGatewayWithNemoClaw(sandboxName: string) { const capability = await hasModernNemoClawSurface() if (!capability.supported) { return { available: capability.available, supported: false, attempted: false, version: capability.version, minimumVersion: capability.minimumVersion, ok: false, stdout: "", stderr: "", exitCode: null as number | null, error: capability.available ? `NemoClaw ${capability.version || "unknown"} does not expose sandbox gateway restart` : capability.error || "NemoClaw CLI is not available", } } const result = await runNemoClaw(["sandbox", "gateway", "restart", sandboxName], 90000) return { available: true, supported: true, attempted: true, version: capability.version, minimumVersion: capability.minimumVersion, ok: result.ok, stdout: result.stdout, stderr: result.stderr, exitCode: result.exitCode, error: result.error, } }