chore: enable ANN ruff ruleset for cometapi integration (#2984)

* chore: enable ANN ruff ruleset for cometapi integration

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs: add docstring to CometAPIChatGenerator.__init__

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: julian-risch

integrations/cometapi/pyproject.toml

@@ -84,6 +84,7 @@ line-length = 120
 [tool.ruff.lint]
 select = [
   "A",
+  "ANN",
   "ARG",
   "B",
   "C",
@@ -110,6 +111,7 @@ select = [
   "YTT",
 ]
 ignore = [
+  "ANN401",  # Allow Any - used legitimately for dynamic types and SDK boundaries
   # Allow non-abstract empty methods in abstract base classes
   "B027",
   # Allow boolean positional values in function calls, like `dict.get(... True)`
@@ -140,7 +142,7 @@ ban-relative-imports = "parents"
 
 [tool.ruff.lint.per-file-ignores]
 # Tests can use magic values, assertions, and relative imports
-"tests/**/*" = ["PLR2004", "S101", "TID252"]
+"tests/**/*" = ["PLR2004", "S101", "TID252", "ANN"]
 # Examples can use print statements
 "examples/**/*" = ["T201"]
 

integrations/cometapi/src/haystack_integrations/components/generators/cometapi/chat/chat_generator.py

@@ -18,20 +18,6 @@ class CometAPIChatGenerator(OpenAIChatGenerator):
     This class extends Haystack's OpenAIChatGenerator to specifically interact with the CometAPI.
     It sets the `api_base_url` to the CometAPI endpoint and allows for all the
     standard configurations available in the OpenAIChatGenerator.
-
-    :param api_key: The API key for authenticating with the CometAPI. Defaults to
-                    loading from the "COMET_API_KEY" environment variable.
-    :param model: The name of the model to use for chat generation (e.g., "gpt-5-mini", "grok-3-mini").
-                  Defaults to "gpt-5-mini".
-    :param streaming_callback: An optional callable that will be called with each chunk of
-                                a streaming response.
-    :param generation_kwargs: Optional keyword arguments to pass to the underlying generation
-                              API call.
-    :param timeout: The maximum time in seconds to wait for a response from the API.
-    :param max_retries: The maximum number of times to retry a failed API request.
-    :param tools: An optional list of tool definitions that the model can use.
-    :param tools_strict: If True, the model is forced to use one of the provided tools if a tool call is made.
-    :param http_client_kwargs: Optional keyword arguments to pass to the HTTP client.
     """
 
     def __init__(
@@ -46,7 +32,20 @@ def __init__(
         tools: list[Tool | Toolset] | Toolset | None = None,
         tools_strict: bool = False,
         http_client_kwargs: dict[str, Any] | None = None,
-    ):
+    ) -> None:
+        """
+        Creates a `CometAPIChatGenerator` instance.
+
+        :param api_key: The API key for authenticating with the CometAPI.
+        :param model: The name of the model to use for chat generation (e.g., `"gpt-5-mini"`, `"grok-3-mini"`).
+        :param streaming_callback: An optional callable invoked with each chunk of a streaming response.
+        :param generation_kwargs: Optional keyword arguments passed to the underlying generation API call.
+        :param timeout: The maximum time in seconds to wait for a response from the API.
+        :param max_retries: The maximum number of times to retry a failed API request.
+        :param tools: An optional list of tools the model can use.
+        :param tools_strict: If `True`, the model is forced to use one of the provided tools.
+        :param http_client_kwargs: Optional keyword arguments passed to the HTTP client.
+        """
         api_base_url = "https://api.cometapi.com/v1"
 
         super().__init__(