{"id":"shell-argv-quote","version":"1.0.0","description":"Quote inert argv strings for POSIX sh or PowerShell 7, returning a command and its per-argument fragments.","supported_operations":["quote argv for POSIX shell","escape command arguments for sh","quote argv for PowerShell 7","build a shell command string safely","preserve empty shell arguments","render command line arguments"],"unsupported_operations":["execute or launch a shell command","parse a command string into arguments","quote for cmd.exe or non-POSIX shells"],"semantics":["Input strings are inert data; the tool never starts or invokes a shell.","posix-sh wraps every argument in single quotes; an embedded apostrophe becomes the adjacent quoted fragments ' followed by \"'\" followed by '.","powershell-7 wraps every argument in single quotes and represents an embedded apostrophe by two apostrophes.","Empty argv returns an empty command and empty fragments; otherwise command joins fragments with one ASCII space.","NUL and lone surrogate code units are rejected with invalid_input; byte and item caps return limit_exceeded."],"limits":{"max_arguments":128,"max_argument_bytes":4096,"max_total_input_bytes":16384,"max_output_bytes":32768},"pricing":{"status":"unpriced","charge_usd":null},"input_schema":{"type":"object","additionalProperties":false,"required":["profile","argv"],"properties":{"profile":{"type":"string","enum":["posix-sh","powershell-7"]},"argv":{"type":"array","maxItems":128,"items":{"type":"string","maxLength":4096}}}},"output_schema":{"type":"object","additionalProperties":false,"required":["command","fragments"],"properties":{"command":{"type":"string","maxLength":32768},"fragments":{"type":"array","maxItems":128,"items":{"type":"string","maxLength":20482}}}},"examples":[{"input":{"profile":"posix-sh","argv":["printf","%s\\n","it's ready",""]},"output":{"command":"'printf' '%s\\n' 'it'\"'\"'s ready' ''","fragments":["'printf'","'%s\\n'","'it'\"'\"'s ready'","''"]}},{"input":{"profile":"powershell-7","argv":["Write-Output","it's ready","$HOME"]},"output":{"command":"'Write-Output' 'it''s ready' '$HOME'","fragments":["'Write-Output'","'it''s ready'","'$HOME'"]}}],"execute_url":"/v1/tools/shell-argv-quote/versions/1.0.0/execute"}