besser-agentic-framework 4.3.1__tar.gz → 4.3.3__tar.gz

{besser_agentic_framework-4.3.1/besser_agentic_framework.egg-info → besser_agentic_framework-4.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: besser-agentic-framework
-Version: 4.3.1
+Version: 4.3.3
 Summary: BESSER Agentic Framework (BAF)
 Author: Luxembourg Institute of Science and Technology
 License: MIT
@@ -18,7 +18,8 @@ Requires-Dist: dateparser==1.1.8
 Requires-Dist: langdetect==1.0.9
 Requires-Dist: markdownify==1.2.2
 Requires-Dist: nltk==3.9.1
-Requires-Dist: numpy==1.26.4
+Requires-Dist: numpy==1.26.4; python_version < "3.13"
+Requires-Dist: numpy<3,>=2.1; python_version >= "3.13"
 Requires-Dist: pandas==2.3.3
 Requires-Dist: python-telegram-bot==21.0
 Requires-Dist: psycopg2-binary>=2.9.10
@@ -27,7 +28,8 @@ Requires-Dist: pyvis==0.3.2
 Requires-Dist: PyYAML==6.0.2
 Requires-Dist: requests==2.31.0
 Requires-Dist: snowballstemmer==2.2.0
-Requires-Dist: sqlalchemy==2.0.29
+Requires-Dist: sqlalchemy==2.0.29; python_version < "3.13"
+Requires-Dist: sqlalchemy<2.1,>=2.0.31; python_version >= "3.13"
 Requires-Dist: streamlit==1.40.0
 Requires-Dist: streamlit-antd-components==0.3.2
 Requires-Dist: text2num==2.5.0
@@ -35,16 +37,19 @@ Requires-Dist: websocket-client==1.6.4
 Requires-Dist: websockets==11.0.3
 Requires-Dist: bcrypt==4.0.1
 Provides-Extra: extras
-Requires-Dist: spacy==3.7.2; extra == "extras"
+Requires-Dist: spacy==3.8.7; extra == "extras"
 Requires-Dist: scikit-learn>=1.7.0; extra == "extras"
 Requires-Dist: librosa==0.10.1; extra == "extras"
 Requires-Dist: SpeechRecognition==3.10.0; extra == "extras"
 Requires-Dist: soundfile==0.13.1; extra == "extras"
 Requires-Dist: opencv-python==4.10.0.84; extra == "extras"
 Requires-Dist: plotly==5.18.0; extra == "extras"
-Requires-Dist: chromadb==0.5.4; extra == "extras"
-Requires-Dist: langchain==0.2.9; extra == "extras"
-Requires-Dist: langchain-community==0.2.7; extra == "extras"
+Requires-Dist: chromadb==0.5.4; python_version < "3.13" and extra == "extras"
+Requires-Dist: chromadb==1.0.0; python_version >= "3.13" and extra == "extras"
+Requires-Dist: langchain==0.2.9; python_version < "3.13" and extra == "extras"
+Requires-Dist: langchain-community==0.2.7; python_version < "3.13" and extra == "extras"
+Requires-Dist: langchain==0.3.10; python_version >= "3.13" and extra == "extras"
+Requires-Dist: langchain-community==0.3.10; python_version >= "3.13" and extra == "extras"
 Requires-Dist: pypdf==4.3.1; extra == "extras"
 Requires-Dist: tiktoken==0.9.0; extra == "extras"
 Provides-Extra: llms
@@ -53,9 +58,9 @@ Requires-Dist: replicate==0.23.1; extra == "llms"
 Requires-Dist: transformers==4.53.0; extra == "llms"
 Provides-Extra: tensorflow
 Requires-Dist: keras==3.12.0; extra == "tensorflow"
-Requires-Dist: tensorflow==2.20.0; extra == "tensorflow"
+Requires-Dist: tensorflow-cpu==2.20.0; extra == "tensorflow"
 Provides-Extra: torch
-Requires-Dist: torch==2.5.1; extra == "torch"
+Requires-Dist: torch==2.6.0+cpu; extra == "torch"
 Requires-Dist: scikit-learn>=1.7.0; extra == "torch"
 Provides-Extra: docs
 Requires-Dist: sphinx==7.2.3; extra == "docs"
@@ -64,24 +69,27 @@ Requires-Dist: sphinx-paramlinks==0.6.0; extra == "docs"
 Requires-Dist: furo==2023.8.19; extra == "docs"
 Requires-Dist: m2r2==0.3.3; extra == "docs"
 Provides-Extra: all
-Requires-Dist: spacy==3.7.2; extra == "all"
+Requires-Dist: spacy==3.8.7; extra == "all"
 Requires-Dist: scikit-learn>=1.7.0; extra == "all"
 Requires-Dist: librosa==0.10.1; extra == "all"
 Requires-Dist: SpeechRecognition==3.10.0; extra == "all"
 Requires-Dist: soundfile==0.13.1; extra == "all"
 Requires-Dist: opencv-python==4.10.0.84; extra == "all"
 Requires-Dist: plotly==5.18.0; extra == "all"
-Requires-Dist: chromadb==0.5.4; extra == "all"
-Requires-Dist: langchain==0.2.9; extra == "all"
-Requires-Dist: langchain-community==0.2.7; extra == "all"
+Requires-Dist: chromadb==0.5.4; python_version < "3.13" and extra == "all"
+Requires-Dist: chromadb==1.0.0; python_version >= "3.13" and extra == "all"
+Requires-Dist: langchain==0.2.9; python_version < "3.13" and extra == "all"
+Requires-Dist: langchain-community==0.2.7; python_version < "3.13" and extra == "all"
+Requires-Dist: langchain==0.3.10; python_version >= "3.13" and extra == "all"
+Requires-Dist: langchain-community==0.3.10; python_version >= "3.13" and extra == "all"
 Requires-Dist: pypdf==4.3.1; extra == "all"
 Requires-Dist: tiktoken==0.9.0; extra == "all"
 Requires-Dist: openai==1.93.0; extra == "all"
 Requires-Dist: replicate==0.23.1; extra == "all"
 Requires-Dist: transformers==4.53.0; extra == "all"
 Requires-Dist: keras==3.12.0; extra == "all"
-Requires-Dist: tensorflow==2.20.0; extra == "all"
-Requires-Dist: torch==2.5.1; extra == "all"
+Requires-Dist: tensorflow-cpu==2.20.0; extra == "all"
+Requires-Dist: torch==2.6.0+cpu; extra == "all"
 Requires-Dist: scikit-learn>=1.7.0; extra == "all"
 Dynamic: license-file
 Dynamic: provides-extra
@@ -152,13 +160,13 @@ Note that if you want to set your agent's language to **Luxembourgish**, you wil
 
 ### Example agents
 
-- [greetings_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/besser/agent/test/examples/greetings_agent.py): Very simple agent for the first contact with the framework
-- [weather_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/besser/agent/test/examples/weather_agent.py): Introducing [entities](https://besser-agentic-framework.readthedocs.io/latest/wiki/core/entities.html)
-- [llm_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/besser/agent/test/examples/llm_agent.py): Introducing [Large Language Models (LLMs)](https://besser-agentic-framework.readthedocs.io/latest/wiki/nlp/llm.html)
-- [rag_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/besser/agent/test/examples/rag_agent.py): Introducing [Retrieval Augmented Generation (RAG)](https://besser-agentic-framework.readthedocs.io/latest/wiki/nlp/rag.html)
-- [telegram_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/besser/agent/test/examples/telegram_agent.py): Introducing the [TelegramPlatform](https://besser-agentic-framework.readthedocs.io/latest/wiki/platforms/telegram_platform.html)
-- [github_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/besser/agent/test/examples/github_agent.py): Introducing [GitHubPlatform](https://besser-agentic-framework.readthedocs.io/latest/wiki/platforms/github_platform.html)
-- [gitlab_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/besser/agent/test/examples/gitlab_agent.py): Introducing the [GitLabPlatform](https://besser-agentic-framework.readthedocs.io/latest/wiki/platforms/gitlab_platform.html)
-- [a2a_multiagent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/besser/agent/test/examples/a2a_multiagent.py): Introducing the [A2APlatform](https://besser-agentic-framework.readthedocs.io/latest/wiki/platforms/a2a_platform.html)
+- [greetings_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/baf/test/examples/greetings_agent.py): Very simple agent for the first contact with the framework
+- [weather_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/baf/test/examples/weather_agent.py): Introducing [entities](https://besser-agentic-framework.readthedocs.io/latest/wiki/core/entities.html)
+- [llm_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/baf/test/examples/llm_agent.py): Introducing [Large Language Models (LLMs)](https://besser-agentic-framework.readthedocs.io/latest/wiki/nlp/llm.html)
+- [rag_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/baf/test/examples/rag_agent.py): Introducing [Retrieval Augmented Generation (RAG)](https://besser-agentic-framework.readthedocs.io/latest/wiki/nlp/rag.html)
+- [telegram_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/baf/test/examples/telegram_agent.py): Introducing the [TelegramPlatform](https://besser-agentic-framework.readthedocs.io/latest/wiki/platforms/telegram_platform.html)
+- [github_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/baf/test/examples/github_agent.py): Introducing [GitHubPlatform](https://besser-agentic-framework.readthedocs.io/latest/wiki/platforms/github_platform.html)
+- [gitlab_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/baf/test/examples/gitlab_agent.py): Introducing the [GitLabPlatform](https://besser-agentic-framework.readthedocs.io/latest/wiki/platforms/gitlab_platform.html)
+- [a2a_multiagent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/baf/test/examples/a2a_multiagent.py): Introducing the [A2APlatform](https://besser-agentic-framework.readthedocs.io/latest/wiki/platforms/a2a_platform.html)
 
 For more example agents, check out the [BAF-agent-examples](https://github.com/BESSER-PEARL/BAF-agent-examples) repository!

{besser_agentic_framework-4.3.1 → besser_agentic_framework-4.3.3}/README.md

@@ -63,13 +63,13 @@ Note that if you want to set your agent's language to **Luxembourgish**, you wil
 
 ### Example agents
 
-- [greetings_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/besser/agent/test/examples/greetings_agent.py): Very simple agent for the first contact with the framework
-- [weather_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/besser/agent/test/examples/weather_agent.py): Introducing [entities](https://besser-agentic-framework.readthedocs.io/latest/wiki/core/entities.html)
-- [llm_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/besser/agent/test/examples/llm_agent.py): Introducing [Large Language Models (LLMs)](https://besser-agentic-framework.readthedocs.io/latest/wiki/nlp/llm.html)
-- [rag_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/besser/agent/test/examples/rag_agent.py): Introducing [Retrieval Augmented Generation (RAG)](https://besser-agentic-framework.readthedocs.io/latest/wiki/nlp/rag.html)
-- [telegram_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/besser/agent/test/examples/telegram_agent.py): Introducing the [TelegramPlatform](https://besser-agentic-framework.readthedocs.io/latest/wiki/platforms/telegram_platform.html)
-- [github_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/besser/agent/test/examples/github_agent.py): Introducing [GitHubPlatform](https://besser-agentic-framework.readthedocs.io/latest/wiki/platforms/github_platform.html)
-- [gitlab_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/besser/agent/test/examples/gitlab_agent.py): Introducing the [GitLabPlatform](https://besser-agentic-framework.readthedocs.io/latest/wiki/platforms/gitlab_platform.html)
-- [a2a_multiagent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/besser/agent/test/examples/a2a_multiagent.py): Introducing the [A2APlatform](https://besser-agentic-framework.readthedocs.io/latest/wiki/platforms/a2a_platform.html)
+- [greetings_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/baf/test/examples/greetings_agent.py): Very simple agent for the first contact with the framework
+- [weather_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/baf/test/examples/weather_agent.py): Introducing [entities](https://besser-agentic-framework.readthedocs.io/latest/wiki/core/entities.html)
+- [llm_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/baf/test/examples/llm_agent.py): Introducing [Large Language Models (LLMs)](https://besser-agentic-framework.readthedocs.io/latest/wiki/nlp/llm.html)
+- [rag_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/baf/test/examples/rag_agent.py): Introducing [Retrieval Augmented Generation (RAG)](https://besser-agentic-framework.readthedocs.io/latest/wiki/nlp/rag.html)
+- [telegram_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/baf/test/examples/telegram_agent.py): Introducing the [TelegramPlatform](https://besser-agentic-framework.readthedocs.io/latest/wiki/platforms/telegram_platform.html)
+- [github_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/baf/test/examples/github_agent.py): Introducing [GitHubPlatform](https://besser-agentic-framework.readthedocs.io/latest/wiki/platforms/github_platform.html)
+- [gitlab_agent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/baf/test/examples/gitlab_agent.py): Introducing the [GitLabPlatform](https://besser-agentic-framework.readthedocs.io/latest/wiki/platforms/gitlab_platform.html)
+- [a2a_multiagent](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework/blob/main/baf/test/examples/a2a_multiagent.py): Introducing the [A2APlatform](https://besser-agentic-framework.readthedocs.io/latest/wiki/platforms/a2a_platform.html)
 
 For more example agents, check out the [BAF-agent-examples](https://github.com/BESSER-PEARL/BAF-agent-examples) repository!

{besser_agentic_framework-4.3.1/besser/agent → besser_agentic_framework-4.3.3/baf}/__init__.py

@@ -1,6 +1,6 @@
 """Definition of the agent properties within the ``agent`` section:"""
 
-from besser.agent.core.property import Property
+from baf.core.property import Property
 
 CHECK_TRANSITIONS_DELAY = Property('agent.check_transitions_delay', float, 1.0)
 """

{besser_agentic_framework-4.3.1/besser/agent → besser_agentic_framework-4.3.3/baf}/core/agent.py

@@ -8,33 +8,33 @@ from typing import Any, Callable, get_type_hints
 
 import yaml
 
-from besser.agent.core.transition.event import Event
-from besser.agent.core.message import Message, MessageType
-from besser.agent.core.entity.entity import Entity
-from besser.agent.core.intent.intent import Intent
-from besser.agent.core.intent.intent_parameter import IntentParameter
-from besser.agent.core.property import Property
-from besser.agent.core.processors.processor import Processor
-from besser.agent.core.session import Session
-from besser.agent.core.state import State
-from besser.agent.core.transition.transition import Transition
-from besser.agent.db import DB_MONITORING
-from besser.agent.db.db_handler import DBHandler
-from besser.agent.db.monitoring_db import MonitoringDB
-from besser.agent.exceptions.exceptions import AgentNotTrainedError, DuplicatedEntityError, DuplicatedInitialStateError, \
+from baf.core.transition.event import Event
+from baf.core.message import Message, MessageType
+from baf.core.entity.entity import Entity
+from baf.core.intent.intent import Intent
+from baf.core.intent.intent_parameter import IntentParameter
+from baf.core.property import Property
+from baf.core.processors.processor import Processor
+from baf.core.session import Session
+from baf.core.state import State
+from baf.core.transition.transition import Transition
+from baf.db import DB_MONITORING
+from baf.db.db_handler import DBHandler
+from baf.db.monitoring_db import MonitoringDB
+from baf.exceptions.exceptions import AgentNotTrainedError, DuplicatedEntityError, DuplicatedInitialStateError, \
     DuplicatedIntentError, DuplicatedStateError, InitialStateNotFound
-from besser.agent.exceptions.logger import logger
-from besser.agent.library.transition.events.base_events import ReceiveMessageEvent, ReceiveJSONEvent
-from besser.agent.nlp.intent_classifier.intent_classifier_configuration import IntentClassifierConfiguration, \
+from baf.exceptions.logger import logger
+from baf.library.transition.events.base_events import ReceiveMessageEvent, ReceiveJSONEvent, ReceiveFileEvent
+from baf.nlp.intent_classifier.intent_classifier_configuration import IntentClassifierConfiguration, \
     SimpleIntentClassifierConfiguration
-from besser.agent.nlp.intent_classifier.intent_classifier_prediction import IntentClassifierPrediction
-from besser.agent.nlp.nlp_engine import NLPEngine
-from besser.agent.platforms.platform import Platform
-from besser.agent.platforms.telegram.telegram_platform import TelegramPlatform
-from besser.agent.platforms.websocket.websocket_platform import WebSocketPlatform
-from besser.agent.platforms.github.github_platform import GitHubPlatform
-from besser.agent.platforms.gitlab.gitlab_platform import GitLabPlatform
-from besser.agent.platforms.a2a.a2a_platform import A2APlatform
+from baf.nlp.intent_classifier.intent_classifier_prediction import IntentClassifierPrediction
+from baf.nlp.nlp_engine import NLPEngine
+from baf.platforms.platform import Platform
+from baf.platforms.telegram.telegram_platform import TelegramPlatform
+from baf.platforms.websocket.websocket_platform import WebSocketPlatform
+from baf.platforms.github.github_platform import GitHubPlatform
+from baf.platforms.gitlab.gitlab_platform import GitLabPlatform
+from baf.platforms.a2a.a2a_platform import A2APlatform
 
 
 class Agent:
@@ -123,7 +123,7 @@ class Agent:
 
         Example YAML properties file, ``config.yaml``:
 
-        .. literalinclude:: ../../../../besser/agent/test/examples/config.yaml
+        .. literalinclude:: ../../../../baf/agent/test/examples/config.yaml
 
         Args:
             path (str): the path to the properties file
@@ -146,6 +146,8 @@ class Agent:
             return
 
         if isinstance(data, list):
+            if prefix:
+                self._config[prefix] = data
             for index, item in enumerate(data):
                 if isinstance(item, dict) and len(item) == 1:
                     item_key, item_value = next(iter(item.items()))
@@ -532,6 +534,9 @@ class Agent:
             else:
                 t = MessageType.STR
             session.save_message(Message(t=t, content=event.message, is_user=True, timestamp=datetime.now()))
+        if isinstance(event, ReceiveFileEvent):
+            session.save_message(Message(t=MessageType.FILE, content=event.file.get_json_string(), is_user=True, timestamp=datetime.now()))
+
         logger.info(f'Received event: {event.log()}')
 
     def process(self, session: Session, message: Any, is_user_message: bool) -> Any:
@@ -564,7 +569,7 @@ class Agent:
         same fallback body to all agent states.
 
         See also:
-            :func:`~besser.agent.core.state.State.set_fallback_body`
+            :func:`~baf.core.state.State.set_fallback_body`
 
         Args:
             body (Callable[[Session], None]): the fallback body
@@ -600,12 +605,14 @@ class Agent:
         else:
             return None
 
-    def _new_session(self, session_id: str, platform: Platform) -> Session:
+    def _new_session(self, session_id: str, platform: Platform, username: str or None = None, session_name: str or None = None) -> Session:
         """Create a new session for the agent.
 
         Args:
             session_id (str): the session id
             platform (Platform): the platform where the session is to be created and used
+            username (str): the name of the session user (optional)
+            session_name (str): the name of the session (optional)
 
         Returns:
             Session: the session
@@ -614,7 +621,7 @@ class Agent:
             raise ValueError(f'Trying to create a new session with an existing id" {session_id}')
         if platform not in self._platforms:
             raise ValueError(f"Platform {platform.__class__.__name__} not found in agent '{self.name}'")
-        session = Session(session_id, self, platform)
+        session = Session(session_id, self, platform, username, session_name)
         self._sessions[session_id] = session
         if self._persist_sessions and self._monitoring_db_session_exists(session_id, platform):
             dest_state = self._monitoring_db_get_last_state_of_session(session_id, platform)
@@ -633,10 +640,10 @@ class Agent:
         session._run_event_thread()
         return session
 
-    def get_or_create_session(self, session_id: str, platform: Platform) -> Session:
+    def get_or_create_session(self, session_id: str, platform: Platform, username: str or None = None, session_name: str or None = None) -> Session:
         session = self._get_session(session_id)
         if session is None:
-            session = self._new_session(session_id, platform)
+            session = self._new_session(session_id, platform, username, session_name)
         return session
 
     def close_session(self, session_id: str) -> None:
@@ -669,7 +676,7 @@ class Agent:
             use_ui: bool = True,
             authenticate_users: bool = False,
     ) -> WebSocketPlatform:
-        """Use the :class:`~besser.agent.platforms.websocket.websocket_platform.WebSocketPlatform` on this agent.
+        """Use the :class:`~baf.platforms.websocket.websocket_platform.WebSocketPlatform` on this agent.
 
         Args:
             use_ui (bool): if true, the default UI will be run to use this platform
@@ -687,7 +694,7 @@ class Agent:
         return websocket_platform
 
     def use_telegram_platform(self) -> TelegramPlatform:
-        """Use the :class:`~besser.agent.platforms.telegram.telegram_platform.TelegramPlatform` on this agent.
+        """Use the :class:`~baf.platforms.telegram.telegram_platform.TelegramPlatform` on this agent.
 
         Returns:
             TelegramPlatform: the telegram platform
@@ -697,7 +704,7 @@ class Agent:
         return telegram_platform
 
     def use_github_platform(self) -> GitHubPlatform:
-        """Use the :class:`~besser.agent.platforms.github.github_platform.GitHubPlatform` on this agent.
+        """Use the :class:`~baf.platforms.github.github_platform.GitHubPlatform` on this agent.
 
         Returns:
             GitHubPlatform: the GitHub platform
@@ -707,7 +714,7 @@ class Agent:
         return github_platform
 
     def use_gitlab_platform(self) -> GitLabPlatform:
-        """Use the :class:`~besser.agent.platforms.gitlab.gitlab_platform.GitLabPlatform` on this agent.
+        """Use the :class:`~baf.platforms.gitlab.gitlab_platform.GitLabPlatform` on this agent.
 
         Returns:
             GitLabPlatform: the GitLab platform
@@ -717,7 +724,7 @@ class Agent:
         return gitlab_platform
     
     def use_a2a_platform(self) -> A2APlatform:
-        """Use the :class: `~besser.agent.platforms.a2a.a2a_platform.A2APlatform` on this agent.
+        """Use the :class: `~baf.platforms.a2a.a2a_platform.A2APlatform` on this agent.
 
         Returns:
             A2APlatform: the A2A platform
@@ -727,7 +734,7 @@ class Agent:
         return a2a_platform
 
     def use_db_handler(self) -> DBHandler:
-        """Use the :class:`~besser.agent.db.db_handler.DBHandler` on this agent.
+        """Use the :class:`~baf.db.db_handler.DBHandler` on this agent.
 
         DB connections are established lazily, when the first query is executed.
 

{besser_agentic_framework-4.3.1/besser/agent → besser_agentic_framework-4.3.3/baf}/core/entity/entity.py

@@ -1,10 +1,10 @@
 from typing import TYPE_CHECKING
 
-from besser.agent.core.entity.entity_entry import EntityEntry
-from besser.agent.nlp.preprocessing.text_preprocessing import process_text
+from baf.core.entity.entity_entry import EntityEntry
+from baf.nlp.preprocessing.text_preprocessing import process_text
 
 if TYPE_CHECKING:
-    from besser.agent.nlp.nlp_engine import NLPEngine
+    from baf.nlp.nlp_engine import NLPEngine
 
 
 class Entity:

{besser_agentic_framework-4.3.1/besser/agent → besser_agentic_framework-4.3.3/baf}/core/intent/intent.py

@@ -1,13 +1,13 @@
 from typing import TYPE_CHECKING
 
-from besser.agent.core.entity.entity import Entity
-from besser.agent.core.intent.intent_parameter import IntentParameter
-from besser.agent.exceptions.exceptions import DuplicatedIntentParameterError
-from besser.agent.nlp.preprocessing.text_preprocessing import process_text
-from besser.agent.nlp.utils import replace_value_in_sentence
+from baf.core.entity.entity import Entity
+from baf.core.intent.intent_parameter import IntentParameter
+from baf.exceptions.exceptions import DuplicatedIntentParameterError
+from baf.nlp.preprocessing.text_preprocessing import process_text
+from baf.nlp.utils import replace_value_in_sentence
 
 if TYPE_CHECKING:
-    from besser.agent.nlp.nlp_engine import NLPEngine
+    from baf.nlp.nlp_engine import NLPEngine
 
 
 class Intent:

{besser_agentic_framework-4.3.1/besser/agent → besser_agentic_framework-4.3.3/baf}/core/intent/intent_parameter.py

@@ -1,4 +1,4 @@
-from besser.agent.core.entity.entity import Entity
+from baf.core.entity.entity import Entity
 
 
 class IntentParameter:

besser_agentic_framework-4.3.3/baf/core/message.py

@@ -0,0 +1,114 @@
+from datetime import datetime
+from enum import Enum
+from typing import Any
+
+from baf.platforms.payload import PayloadAction
+
+
+class MessageType(Enum):
+    """Enumeration of the different message types in :class:`Message`."""
+
+    STR = 'str'
+    JSON = 'json'
+    MARKDOWN = 'markdown'
+    HTML = 'html'
+    FILE = 'file'
+    IMAGE = 'image'
+    DATAFRAME = 'dataframe'
+    PLOTLY = 'plotly'
+    LOCATION = 'location'
+    OPTIONS = 'options'
+    AUDIO = 'audio'
+    RAG_ANSWER = 'rag_answer'
+    UI = 'ui'
+
+
+def get_message_type(value: str):
+    for message_type in MessageType:
+        if message_type.value == value:
+            return message_type
+    return None
+
+
+class Message:
+    """
+    A conversation message. It is used by the streamlit UI to display the messages properly, depending on the sender
+    (i.e., user or agent) and the type (string, audio, file, DataFrame, plot, etc.)
+
+    Args:
+        t (MessageType): The type of the message
+        content (Any): The message content
+        is_user (bool): Whether the message comes from the user (true) or the agent (false)
+        timestamp (datetime): The timestamp of the message (when the message was sent)
+
+    Attributes:
+        type (MessageType): The type of the message
+        content (Any): The message content
+        is_user (bool): Whether the message comes from the user (true) or the agent (false)
+        timestamp (datetime): The timestamp of the message (when the message was sent)
+    """
+
+    def __init__(self, t: MessageType, content: Any, is_user: bool, timestamp: datetime):
+        self.type: MessageType = t
+        self.content: Any = content
+        self.is_user: bool = is_user
+        self.timestamp: datetime = timestamp
+        # TODO: Parse content to specific type (in DB, messages are stored a str)
+
+    def get_action(self):
+        if self.is_user:
+            match self.type:
+                case MessageType.STR:
+                    return PayloadAction.USER_MESSAGE
+                case MessageType.JSON:
+                    return PayloadAction.USER_MESSAGE  # TODO: Not implemented
+                case MessageType.MARKDOWN:
+                    return PayloadAction.USER_MESSAGE  # TODO: Not implemented
+                case MessageType.HTML:
+                    return PayloadAction.USER_MESSAGE  # TODO: Not implemented
+                case MessageType.FILE:
+                    return PayloadAction.USER_FILE
+                case MessageType.IMAGE:
+                    return PayloadAction.USER_FILE  # TODO: Not implemented
+                case MessageType.DATAFRAME:
+                    return PayloadAction.USER_MESSAGE  # TODO: Not implemented
+                case MessageType.PLOTLY:
+                    return PayloadAction.USER_MESSAGE  # TODO: Not implemented
+                case MessageType.LOCATION:
+                    return PayloadAction.USER_MESSAGE  # TODO: Not implemented
+                case MessageType.OPTIONS:
+                    return PayloadAction.USER_MESSAGE  # TODO: Not implemented
+                case MessageType.AUDIO:
+                    return PayloadAction.USER_VOICE
+                case MessageType.RAG_ANSWER:
+                    return PayloadAction.USER_MESSAGE  # TODO: Not implemented
+                case MessageType.UI:
+                    return PayloadAction.USER_MESSAGE  # TODO: Not implemented
+        else:
+            match self.type:
+                case MessageType.STR:
+                    return PayloadAction.AGENT_REPLY_STR
+                case MessageType.JSON:
+                    return PayloadAction.AGENT_REPLY_STR  # TODO: Not implemented
+                case MessageType.MARKDOWN:
+                    return PayloadAction.AGENT_REPLY_MARKDOWN
+                case MessageType.HTML:
+                    return PayloadAction.AGENT_REPLY_HTML
+                case MessageType.FILE:
+                    return PayloadAction.AGENT_REPLY_FILE
+                case MessageType.IMAGE:
+                    return PayloadAction.AGENT_REPLY_IMAGE
+                case MessageType.DATAFRAME:
+                    return PayloadAction.AGENT_REPLY_DF
+                case MessageType.PLOTLY:
+                    return PayloadAction.AGENT_REPLY_PLOTLY
+                case MessageType.LOCATION:
+                    return PayloadAction.AGENT_REPLY_LOCATION
+                case MessageType.OPTIONS:
+                    return PayloadAction.AGENT_REPLY_OPTIONS
+                case MessageType.AUDIO:
+                    return PayloadAction.AGENT_REPLY_AUDIO
+                case MessageType.RAG_ANSWER:
+                    return PayloadAction.AGENT_REPLY_RAG
+                case MessageType.UI:
+                    return PayloadAction.AGENT_REPLY_UI

{besser_agentic_framework-4.3.1/besser/agent → besser_agentic_framework-4.3.3/baf}/core/processors/audio_language_detection_processor.py

@@ -5,18 +5,18 @@ import soundfile as sf
 import numpy as np
 
 
-from besser.agent.core.processors.processor import Processor
-from besser.agent.core.session import Session
-from besser.agent.nlp.nlp_engine import NLPEngine
-from besser.agent.nlp.llm.llm import LLM
+from baf.core.processors.processor import Processor
+from baf.core.session import Session
+from baf.nlp.nlp_engine import NLPEngine
+from baf.nlp.llm.llm import LLM
 
-from besser.agent.exceptions.logger import logger
+from baf.exceptions.logger import logger
 
-from besser.agent.nlp.speech2text.speech2text import Speech2Text
+from baf.nlp.speech2text.speech2text import Speech2Text
 
 
 if TYPE_CHECKING:
-    from besser.agent.core.agent import Agent
+    from baf.core.agent import Agent
 
 
 class AudioLanguageDetectionProcessor(Processor):

{besser_agentic_framework-4.3.1/besser/agent → besser_agentic_framework-4.3.3/baf}/core/processors/language_detection_processor.py

@@ -2,11 +2,11 @@ from typing import TYPE_CHECKING
 
 from langdetect import detect
 
-from besser.agent.core.processors.processor import Processor
-from besser.agent.core.session import Session
+from baf.core.processors.processor import Processor
+from baf.core.session import Session
 
 if TYPE_CHECKING:
-    from besser.agent.core.agent import Agent
+    from baf.core.agent import Agent
 
 
 class LanguageDetectionProcessor(Processor):

{besser_agentic_framework-4.3.1/besser/agent → besser_agentic_framework-4.3.3/baf}/core/processors/processor.py

@@ -1,11 +1,11 @@
 from abc import ABC, abstractmethod
 from typing import Any, TYPE_CHECKING
 
-from besser.agent.core.session import Session
-from besser.agent.exceptions.exceptions import ProcessorTargetUndefined
+from baf.core.session import Session
+from baf.exceptions.exceptions import ProcessorTargetUndefined
 
 if TYPE_CHECKING:
-    from besser.agent.core.agent import Agent
+    from baf.core.agent import Agent
 
 
 class Processor(ABC):

{besser_agentic_framework-4.3.1/besser/agent → besser_agentic_framework-4.3.3/baf}/core/processors/user_adaptation_processor.py

@@ -1,8 +1,8 @@
-from besser.agent.core.processors.processor import Processor
-from besser.agent.nlp.llm.llm import LLM
-from besser.agent.core.agent import Agent
-from besser.agent.core.session import Session
-from besser.agent.nlp.nlp_engine import NLPEngine
+from baf.core.processors.processor import Processor
+from baf.nlp.llm.llm import LLM
+from baf.core.agent import Agent
+from baf.core.session import Session
+from baf.nlp.nlp_engine import NLPEngine
 
 
 class UserAdaptationProcessor(Processor):