FileOperationError = Literal['file_not_found', 'permission_denied', 'is_directory', 'invalid_path']Standardized error codes for file upload/download operations.
These represent common, recoverable errors that an LLM can understand and potentially fix:
file_not_found: The requested file doesn't exist (download)permission_denied: Access denied for the operationis_directory: Attempted to download a directory as a fileinvalid_path: Path syntax is malformed or contains invalid characters