/**
 * Tool argument validation — validates that exec/bash commands contain
 * valid shell syntax after model token sanitization.
 *
 * Gated on ModelProfile.filters.validateToolArgs — only active for
 * models known to leak control tokens into structured output (Gemma, Ollama).
 *
 * @module
 */
export type ShellValidationResult = {
    valid: true;
    cleaned: string;
} | {
    valid: false;
    cleaned: string;
    reason: string;
};
/**
 * Validate that a command string contains extractable valid shell syntax.
 * Returns the cleaned command if valid, or an error reason if not.
 *
 * Does NOT attempt to parse the full shell grammar — just checks for
 * obvious corruption (residual control tokens, empty commands).
 * Preserves heredocs, redirects, pipes, and other legitimate shell syntax.
 */
export declare function validateShellCommand(command: string): ShellValidationResult;
