chore: add ANN type annotations to google_genai, hanlp, jina, langfuse, lara (#2990)

Enable ruff ANN ruleset (excluding ANN401) for five integrations and fix
all resulting violations by adding missing return type annotations.

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

Author: julian-risch

integrations/google_genai/pyproject.toml

@@ -91,6 +91,7 @@ line-length = 120
 [tool.ruff.lint]
 select = [
   "A",
+  "ANN",
   "ARG",
   "B",
   "C",
@@ -137,6 +138,8 @@ ignore = [
   "ARG005",
   # Allow function call argument defaults e.g. `Secret.from_env_var`
   "B008",
+  # Allow `Any` - used legitimately for dynamic types and SDK boundaries
+  "ANN401",
 ]
 
 [tool.ruff.lint.isort]
@@ -147,7 +150,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/google_genai/src/haystack_integrations/components/generators/google_genai/chat/chat_generator.py

@@ -203,7 +203,7 @@ def __init__(
         tools: ToolsType | None = None,
         timeout: float | None = None,
         max_retries: int | None = None,
-    ):
+    ) -> None:
         """
         Initialize a GoogleGenAIChatGenerator instance.
 

integrations/hanlp/pyproject.toml

@@ -96,6 +96,7 @@ line-length = 120
 [tool.ruff.lint]
 select = [
   "A",
+  "ANN",
   "ARG",
   "B",
   "C",
@@ -139,6 +140,8 @@ ignore = [
   "ARG005",
   "RUF001",
   "RUF002",
+  # Allow `Any` - used legitimately for dynamic types and SDK boundaries
+  "ANN401",
 ]
 
 [tool.ruff.lint.isort]
@@ -149,7 +152,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"]
 
 [tool.coverage.run]
 source = ["haystack_integrations"]

integrations/jina/pyproject.toml

@@ -84,6 +84,7 @@ line-length = 120
 [tool.ruff.lint]
 select = [
   "A",
+  "ANN",
   "ARG",
   "B",
   "C",
@@ -121,6 +122,8 @@ ignore = [
   "PLR0912",
   "PLR0913",
   "PLR0915",
+  # Allow `Any` - used legitimately for dynamic types and SDK boundaries
+  "ANN401",
 ]
 
 [tool.ruff.lint.isort]
@@ -131,7 +134,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 contain "print" commands
 "examples/**/*" = ["T201"]
 

integrations/jina/src/haystack_integrations/components/connectors/jina/reader.py

@@ -45,7 +45,7 @@ def __init__(
         mode: JinaReaderMode | str,
         api_key: Secret = Secret.from_env_var("JINA_API_KEY"),  # noqa: B008
         json_response: bool = True,
-    ):
+    ) -> None:
         """
         Initialize a JinaReader instance.
 

integrations/jina/src/haystack_integrations/components/connectors/jina/reader_mode.py

@@ -19,7 +19,7 @@ class JinaReaderMode(Enum):
     SEARCH = "search"
     GROUND = "ground"
 
-    def __str__(self):
+    def __str__(self) -> str:
         return self.value
 
     @classmethod

integrations/jina/src/haystack_integrations/components/embedders/jina/document_embedder.py

@@ -49,7 +49,7 @@ def __init__(
         task: str | None = None,
         dimensions: int | None = None,
         late_chunking: bool | None = None,
-    ):
+    ) -> None:
         """
         Create a JinaDocumentEmbedder component.
 

integrations/jina/src/haystack_integrations/components/embedders/jina/document_image_embedder.py

@@ -62,7 +62,7 @@ def __init__(
         embedding_dimension: int | None = None,
         image_size: tuple[int, int] | None = None,
         batch_size: int = 5,
-    ):
+    ) -> None:
         """
         Create a JinaDocumentImageEmbedder component.
 

integrations/jina/src/haystack_integrations/components/embedders/jina/text_embedder.py

@@ -42,7 +42,7 @@ def __init__(
         task: str | None = None,
         dimensions: int | None = None,
         late_chunking: bool | None = None,
-    ):
+    ) -> None:
         """
         Create a JinaTextEmbedder component.
 

integrations/jina/src/haystack_integrations/components/rankers/jina/ranker.py

@@ -36,7 +36,7 @@ def __init__(
         api_key: Secret = Secret.from_env_var("JINA_API_KEY"),  # noqa: B008,
         top_k: int | None = None,
         score_threshold: float | None = None,
-    ):
+    ) -> None:
         """
         Creates an instance of JinaRanker.
 
@@ -110,7 +110,7 @@ def run(
         documents: list[Document],
         top_k: int | None = None,
         score_threshold: float | None = None,
-    ):
+    ) -> dict[str, list[Document]]:
         """
         Returns a list of Documents ranked by their similarity to the given query.