import { extractShellWrapperCommand } from "./exec-wrapper-resolution.js"; export type SystemRunCommandValidation = | { ok: true; shellCommand: string | null; cmdText: string; } | { ok: false; message: string; details?: Record; }; export type ResolvedSystemRunCommand = | { ok: true; argv: string[]; rawCommand: string | null; shellCommand: string | null; cmdText: string; } | { ok: false; message: string; details?: Record; }; export function formatExecCommand(argv: string[]): string { return argv .map((arg) => { const trimmed = arg.trim(); if (!trimmed) { return '""'; } const needsQuotes = /\s|"/.test(trimmed); if (!needsQuotes) { return trimmed; } return `"${trimmed.replace(/"/g, '\\"')}"`; }) .join(" "); } export function extractShellCommandFromArgv(argv: string[]): string | null { return extractShellWrapperCommand(argv).command; } export function validateSystemRunCommandConsistency(params: { argv: string[]; rawCommand?: string | null; }): SystemRunCommandValidation { const raw = typeof params.rawCommand === "string" && params.rawCommand.trim().length > 0 ? params.rawCommand.trim() : null; const shellCommand = extractShellWrapperCommand(params.argv).command; const inferred = shellCommand !== null ? shellCommand.trim() : formatExecCommand(params.argv); if (raw && raw !== inferred) { return { ok: false, message: "INVALID_REQUEST: rawCommand does not match command", details: { code: "RAW_COMMAND_MISMATCH", rawCommand: raw, inferred, }, }; } return { ok: true, // Only treat this as a shell command when argv is a recognized shell wrapper. // For direct argv execution, rawCommand is purely display/approval text and // must match the formatted argv. shellCommand: shellCommand !== null ? (raw ?? shellCommand) : null, cmdText: raw ?? shellCommand ?? inferred, }; } export function resolveSystemRunCommand(params: { command?: unknown; rawCommand?: unknown; }): ResolvedSystemRunCommand { const raw = typeof params.rawCommand === "string" && params.rawCommand.trim().length > 0 ? params.rawCommand.trim() : null; const command = Array.isArray(params.command) ? params.command : []; if (command.length === 0) { if (raw) { return { ok: false, message: "rawCommand requires params.command", details: { code: "MISSING_COMMAND" }, }; } return { ok: true, argv: [], rawCommand: null, shellCommand: null, cmdText: "", }; } const argv = command.map((v) => String(v)); const validation = validateSystemRunCommandConsistency({ argv, rawCommand: raw, }); if (!validation.ok) { return { ok: false, message: validation.message, details: validation.details ?? { code: "RAW_COMMAND_MISMATCH" }, }; } return { ok: true, argv, rawCommand: raw, shellCommand: validation.shellCommand, cmdText: validation.cmdText, }; }