import abc
from enum import Enum
from typing import Optional, List, Iterable, Sequence
from council.contexts import ChatMessage, ChatMessageKind
[docs]
class LLMMessageRole(str, Enum):
"""
Enum representing the roles of messages in a conversation or dialogue.
"""
User = "user"
"""
Represents a message from the user.
"""
System = "system"
"""
Represents a system-generated message.
"""
Assistant = "assistant"
"""
Represents a message from the assistant.
"""
[docs]
class LLMMessage:
"""
Represents chat messages. Used in the payload
Args:
role (LLMMessageRole): the role/persona the message is coming from. Could be either user, system or assistant
content (str): the message content
"""
_role: LLMMessageRole
_content: str
[docs]
def __init__(self, role: LLMMessageRole, content: str, name: Optional[str] = None):
"""Initialize a new instance"""
self._role = role
self._content = content
self._name = name
[docs]
@staticmethod
def system_message(content: str, name: Optional[str] = None) -> "LLMMessage":
"""
Create a new system message
Parameters:
content (str): the message content
name (str): name of the author of this message
"""
return LLMMessage(role=LLMMessageRole.System, content=content, name=name)
[docs]
@staticmethod
def user_message(content: str, name: Optional[str] = None) -> "LLMMessage":
"""
Create a new user message
Parameters:
content (str): the message content
name (str): name of the author of this message
"""
return LLMMessage(role=LLMMessageRole.User, content=content, name=name)
[docs]
@staticmethod
def assistant_message(content: str, name: Optional[str] = None) -> "LLMMessage":
"""
Create a new assistant message
Parameters:
content (str): the message content
name (str): name of the author of this message
"""
return LLMMessage(role=LLMMessageRole.Assistant, content=content, name=name)
def dict(self) -> dict[str, str]:
result = {"role": self._role.value, "content": self._content}
if self._name is not None:
result["name"] = self._name
return result
@property
def content(self) -> str:
"""Retrieve the content of this instance"""
return self._content
@property
def name(self) -> Optional[str]:
"""Retrieve the name authoring the content of this instance"""
return self._name
@property
def role(self) -> LLMMessageRole:
"""Retrieve the role of this instance"""
return self._role
[docs]
def is_of_role(self, role: LLMMessageRole) -> bool:
"""Check the role of this instance"""
return self._role == role
[docs]
@staticmethod
def from_chat_message(chat_message: ChatMessage) -> Optional["LLMMessage"]:
"""Convert :class:`~.ChatMessage` into :class:`.LLMMessage`"""
if chat_message.kind == ChatMessageKind.User:
return LLMMessage.user_message(chat_message.message)
elif chat_message.kind == ChatMessageKind.Agent:
return LLMMessage.assistant_message(chat_message.message)
return None
@staticmethod
def from_chat_messages(messages: Iterable[ChatMessage]) -> List["LLMMessage"]:
m = map(LLMMessage.from_chat_message, messages)
return [msg for msg in m if msg is not None]
class LLMessageTokenCounterBase(abc.ABC):
@abc.abstractmethod
def count_messages_token(self, messages: Sequence[LLMMessage]) -> int:
"""
Counts the total number of tokens in a list of LLM messages, including assistant tokens.
Args:
messages (Sequence[LLMMessage]): A list of LLMMessage objects representing the messages.
Returns:
int: The total number of tokens, including assistant tokens.
Raises:
LLMTokenLimitException: If a token limit is set (0 < limit < result) and the token count exceeds the limit.
"""
pass