feat: LlamaCppChatGenerator update tools param to ToolsType

[vblagoje]

Why:

Adopts Haystack's ToolsType to enable flexible tool composition, developers can now mix individual Tool objects and Toolset instances in a single list

part of:

• Update Chat Generators to support mixed Tools and Toolsets #2409

What:

• Updated tools parameter from Union[List[Tool], Toolset] to ToolsType in constructor and all methods
• Replaced manual isinstance(tools, Toolset) checks with flatten_tools_or_toolsets() utility
• Haystack dependency to 2.19.0 for ToolsType support
• Added tests for mixed tool collection initialization and request parameter formatting

How can it be used:

from haystack.tools import Tool, Toolset
from haystack_integrations.components.generators.llama_cpp import LlamaCppChatGenerator

weather_tool = Tool(name="weather", ...)
population_toolset = Toolset([...])

# NEW: Mix Tool and Toolset freely
generator = LlamaCppChatGenerator(tools=[weather_tool, population_toolset])

How did you test it:

• Unit tests verify mixed tool initialization and correct llama.cpp tools formatting
• Backward compatibility validated for existing patterns (list of tools, single toolset)

Notes for the reviewer:

• Centralizes tool normalization logic with flatten_tools_or_toolsets()—eliminates duplicate handling code
• Fully backward compatible; no migration needed
• Added integration test test_run_with_mixed_tools() demonstrates end-to-end LLM tool invocation from mixed collections

[mpangrazzi]

Looks good!