Use BaseMessage class type

* for the type declaration of the `message_history` parameter

Author: leila-messallem

src/neo4j_graphrag/generation/graphrag.py

@@ -31,6 +31,7 @@
 )
 from neo4j_graphrag.generation.types import RagInitModel, RagResultModel, RagSearchModel
 from neo4j_graphrag.llm import LLMInterface
+from neo4j_graphrag.llm.types import BaseMessage
 from neo4j_graphrag.retrievers.base import Retriever
 from neo4j_graphrag.types import RetrieverResult
 
@@ -87,7 +88,7 @@ def __init__(
     def search(
         self,
         query_text: str = "",
-        message_history: Optional[list[dict[str, str]]] = None,
+        message_history: Optional[list[BaseMessage]] = None,
         examples: str = "",
         retriever_config: Optional[dict[str, Any]] = None,
         return_context: bool | None = None,
@@ -155,7 +156,7 @@ def build_query(
             )
             summary = self.llm.invoke(
                 input=summarization_prompt,
-                system_instruction=summarization_prompt.SYSTEM_MESSAGE,
+                system_instruction=ChatSummaryTemplate().SYSTEM_MESSAGE,
             ).content
             return ConversationTemplate().format(
                 summary=summary, current_query=query_text

src/neo4j_graphrag/llm/anthropic_llm.py

@@ -19,7 +19,7 @@
 
 from neo4j_graphrag.exceptions import LLMGenerationError
 from neo4j_graphrag.llm.base import LLMInterface
-from neo4j_graphrag.llm.types import LLMResponse, MessageList, UserMessage
+from neo4j_graphrag.llm.types import LLMResponse, MessageList, UserMessage, BaseMessage
 
 if TYPE_CHECKING:
     from anthropic.types.message_param import MessageParam
@@ -71,7 +71,7 @@ def __init__(
         self.async_client = anthropic.AsyncAnthropic(**kwargs)
 
     def get_messages(
-        self, input: str, message_history: Optional[list[Any]] = None
+        self, input: str, message_history: Optional[list[BaseMessage]] = None
     ) -> Iterable[MessageParam]:
         messages = []
         if message_history:
@@ -84,7 +84,7 @@ def get_messages(
         return messages
 
     def invoke(
-        self, input: str, message_history: Optional[list[Any]] = None
+        self, input: str, message_history: Optional[list[BaseMessage]] = None
     ) -> LLMResponse:
         """Sends text to the LLM and returns a response.
 
@@ -108,7 +108,7 @@ def invoke(
             raise LLMGenerationError(e)
 
     async def ainvoke(
-        self, input: str, message_history: Optional[list[Any]] = None
+        self, input: str, message_history: Optional[list[BaseMessage]] = None
     ) -> LLMResponse:
         """Asynchronously sends text to the LLM and returns a response.
 

src/neo4j_graphrag/llm/base.py

@@ -17,7 +17,7 @@
 from abc import ABC, abstractmethod
 from typing import Any, Optional
 
-from .types import LLMResponse
+from .types import LLMResponse, BaseMessage
 
 
 class LLMInterface(ABC):
@@ -45,7 +45,7 @@ def __init__(
     def invoke(
         self,
         input: str,
-        message_history: Optional[list[dict[str, str]]] = None,
+        message_history: Optional[list[BaseMessage]] = None,
         system_instruction: Optional[str] = None,
     ) -> LLMResponse:
         """Sends a text input to the LLM and retrieves a response.

src/neo4j_graphrag/llm/cohere_llm.py

@@ -24,6 +24,7 @@
     MessageList,
     SystemMessage,
     UserMessage,
+    BaseMessage,
 )
 
 if TYPE_CHECKING:
@@ -74,7 +75,7 @@ def __init__(
         self.async_client = cohere.AsyncClientV2(**kwargs)
 
     def get_messages(
-        self, input: str, message_history: Optional[list[Any]] = None
+        self, input: str, message_history: Optional[list[BaseMessage]] = None
     ) -> ChatMessages:
         messages = []
         if self.system_instruction:
@@ -89,7 +90,7 @@ def get_messages(
         return messages
 
     def invoke(
-        self, input: str, message_history: Optional[list[Any]] = None
+        self, input: str, message_history: Optional[list[BaseMessage]] = None
     ) -> LLMResponse:
         """Sends text to the LLM and returns a response.
 
@@ -113,7 +114,7 @@ def invoke(
         )
 
     async def ainvoke(
-        self, input: str, message_history: Optional[list[Any]] = None
+        self, input: str, message_history: Optional[list[BaseMessage]] = None
     ) -> LLMResponse:
         """Asynchronously sends text to the LLM and returns a response.
 

src/neo4j_graphrag/llm/mistralai_llm.py

@@ -25,6 +25,7 @@
     MessageList,
     SystemMessage,
     UserMessage,
+    BaseMessage,
 )
 
 try:
@@ -65,7 +66,7 @@ def __init__(
         self.client = Mistral(api_key=api_key, **kwargs)
 
     def get_messages(
-        self, input: str, message_history: Optional[list[Any]] = None
+        self, input: str, message_history: Optional[list[BaseMessage]] = None
     ) -> list[Messages]:
         messages = []
         if self.system_instruction:
@@ -80,7 +81,7 @@ def get_messages(
         return messages
 
     def invoke(
-        self, input: str, message_history: Optional[list[Any]] = None
+        self, input: str, message_history: Optional[list[BaseMessage]] = None
     ) -> LLMResponse:
         """Sends a text input to the Mistral chat completion model
         and returns the response's content.
@@ -112,7 +113,7 @@ def invoke(
             raise LLMGenerationError(e)
 
     async def ainvoke(
-        self, input: str, message_history: Optional[list[Any]] = None
+        self, input: str, message_history: Optional[list[BaseMessage]] = None
     ) -> LLMResponse:
         """Asynchronously sends a text input to the MistralAI chat
         completion model and returns the response's content.

src/neo4j_graphrag/llm/ollama_llm.py

@@ -19,7 +19,7 @@
 from neo4j_graphrag.exceptions import LLMGenerationError
 
 from .base import LLMInterface
-from .types import LLMResponse, SystemMessage, UserMessage, MessageList
+from .types import LLMResponse, SystemMessage, UserMessage, MessageList, BaseMessage
 
 if TYPE_CHECKING:
     from ollama import Message
@@ -50,7 +50,7 @@ def __init__(
         )
 
     def get_messages(
-        self, input: str, message_history: Optional[list[Any]] = None
+        self, input: str, message_history: Optional[list[BaseMessage]] = None
     ) -> Sequence[Message]:
         messages = []
         if self.system_instruction:
@@ -65,7 +65,7 @@ def get_messages(
         return messages
 
     def invoke(
-        self, input: str, message_history: Optional[list[Any]] = None
+        self, input: str, message_history: Optional[list[BaseMessage]] = None
     ) -> LLMResponse:
         try:
             response = self.client.chat(
@@ -79,7 +79,7 @@ def invoke(
             raise LLMGenerationError(e)
 
     async def ainvoke(
-        self, input: str, message_history: Optional[list[Any]] = None
+        self, input: str, message_history: Optional[list[BaseMessage]] = None
     ) -> LLMResponse:
         try:
             response = await self.async_client.chat(

src/neo4j_graphrag/llm/openai_llm.py

@@ -21,7 +21,7 @@
 
 from ..exceptions import LLMGenerationError
 from .base import LLMInterface
-from .types import LLMResponse, SystemMessage, UserMessage, MessageList
+from .types import LLMResponse, SystemMessage, UserMessage, MessageList, BaseMessage
 
 if TYPE_CHECKING:
     import openai
@@ -63,7 +63,7 @@ def __init__(
     def get_messages(
         self,
         input: str,
-        message_history: Optional[list[Any]] = None,
+        message_history: Optional[list[BaseMessage]] = None,
         system_instruction: Optional[str] = None,
     ) -> Iterable[ChatCompletionMessageParam]:
         messages = []
@@ -86,7 +86,7 @@ def get_messages(
     def invoke(
         self,
         input: str,
-        message_history: Optional[list[Any]] = None,
+        message_history: Optional[list[BaseMessage]] = None,
         system_instruction: Optional[str] = None,
     ) -> LLMResponse:
         """Sends a text input to the OpenAI chat completion model
@@ -115,7 +115,7 @@ def invoke(
             raise LLMGenerationError(e)
 
     async def ainvoke(
-        self, input: str, message_history: Optional[list[Any]] = None
+        self, input: str, message_history: Optional[list[BaseMessage]] = None
     ) -> LLMResponse:
         """Asynchronously sends a text input to the OpenAI chat
         completion model and returns the response's content.

src/neo4j_graphrag/llm/vertexai_llm.py

@@ -19,7 +19,7 @@
 
 from neo4j_graphrag.exceptions import LLMGenerationError
 from neo4j_graphrag.llm.base import LLMInterface
-from neo4j_graphrag.llm.types import LLMResponse, MessageList
+from neo4j_graphrag.llm.types import LLMResponse, MessageList, BaseMessage
 
 try:
     from vertexai.generative_models import (
@@ -77,7 +77,7 @@ def __init__(
         self.model_params = kwargs
 
     def get_messages(
-        self, input: str, message_history: Optional[list[Any]] = None
+        self, input: str, message_history: Optional[list[BaseMessage]] = None
     ) -> list[Content]:
         messages = []
         if message_history:
@@ -87,16 +87,16 @@ def get_messages(
                 raise LLMGenerationError(e.errors()) from e
 
             for message in message_history:
-                if message.get("role") == "user":
+                if message.role == "user":
                     messages.append(
                         Content(
-                            role="user", parts=[Part.from_text(message.get("content"))]
+                            role="user", parts=[Part.from_text(message.content)]
                         )
                     )
-                elif message.get("role") == "assistant":
+                elif message.role == "assistant":
                     messages.append(
                         Content(
-                            role="model", parts=[Part.from_text(message.get("content"))]
+                            role="model", parts=[Part.from_text(message.content)]
                         )
                     )
 
@@ -106,7 +106,7 @@ def get_messages(
     def invoke(
         self,
         input: str,
-        message_history: Optional[list[Any]] = None,
+        message_history: Optional[list[BaseMessage]] = None,
         system_instruction: Optional[str] = None,
     ) -> LLMResponse:
         """Sends text to the LLM and returns a response.
@@ -137,7 +137,7 @@ def invoke(
             raise LLMGenerationError(e)
 
     async def ainvoke(
-        self, input: str, message_history: Optional[list[Any]] = None
+        self, input: str, message_history: Optional[list[BaseMessage]] = None
     ) -> LLMResponse:
         """Asynchronously sends text to the LLM and returns a response.