refactor

# What does this PR do?


## Test Plan

docs/openapi_generator/pyopenapi/generator.py

@@ -769,24 +769,30 @@ class Generator:
             first = next(iter(op.request_params))
             request_name, request_type = first
 
-            op_name = "".join(word.capitalize() for word in op.name.split("_"))
-            request_name = f"{op_name}Request"
-            fields = [
-                (
-                    name,
-                    type_,
-                )
-                for name, type_ in op.request_params
-            ]
-            request_type = make_dataclass(
-                request_name,
-                fields,
-                namespace={
-                    "__doc__": create_docstring_for_request(
-                        request_name, fields, doc_params
+            # HACK ALERT
+            # Special case: if there's a single parameter named "params" that's already a BaseModel,
+            # unwrap it to show the flat structure in the OpenAPI spec (matches FastAPI's embed=False behavior)
+            if len(op.request_params) == 1 and request_name == "params" and inspect.isclass(request_type) and issubclass(request_type, BaseModel):
+                pass 
+            else:
+                op_name = "".join(word.capitalize() for word in op.name.split("_"))
+                request_name = f"{op_name}Request"
+                fields = [
+                    (
+                        name,
+                        type_,
                     )
-                },
-            )
+                    for name, type_ in op.request_params
+                ]
+                request_type = make_dataclass(
+                    request_name,
+                    fields,
+                    namespace={
+                        "__doc__": create_docstring_for_request(
+                            request_name, fields, doc_params
+                        )
+                    },
+                )
 
             requestBody = RequestBody(
                 content={

docs/openapi_generator/pyopenapi/utility.py

@@ -11,6 +11,7 @@ from pathlib import Path
 from typing import TextIO
 from typing import Any, List, Optional, Union, get_type_hints, get_origin, get_args
 
+from pydantic import BaseModel
 from llama_stack.strong_typing.schema import object_to_json, StrictJsonType
 from llama_stack.core.resolver import api_protocol_map
 
@@ -205,6 +206,14 @@ def _validate_has_return_in_docstring(method) -> str | None:
 def _validate_has_params_in_docstring(method) -> str | None:
     source = inspect.getsource(method)
     sig = inspect.signature(method)
+
+    params_list = [p for p in sig.parameters.values() if p.name != "self"]
+    if len(params_list) == 1:
+        param = params_list[0]
+        param_type = param.annotation
+        if inspect.isclass(param_type) and issubclass(param_type, BaseModel):
+            return
+                
     # Only check if the method has more than one parameter
     if len(sig.parameters) > 1 and ":param" not in source:
         return "does not have a ':param' in its docstring"