besser-agentic-framework 4.3.0__tar.gz → 4.3.2__tar.gz

{besser_agentic_framework-4.3.0/besser_agentic_framework.egg-info → besser_agentic_framework-4.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: besser-agentic-framework
-Version: 4.3.0
+Version: 4.3.2
 Summary: BESSER Agentic Framework (BAF)
 Author: Luxembourg Institute of Science and Technology
 License: MIT
@@ -152,13 +152,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.0 → besser_agentic_framework-4.3.2}/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.0/besser/agent → besser_agentic_framework-4.3.2/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.0/besser/agent → besser_agentic_framework-4.3.2/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
+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()))
@@ -564,7 +566,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
@@ -669,7 +671,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 +689,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 +699,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 +709,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 +719,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 +729,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.0/besser/agent → besser_agentic_framework-4.3.2/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.0/besser/agent → besser_agentic_framework-4.3.2/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.0/besser/agent → besser_agentic_framework-4.3.2/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.0/besser/agent → besser_agentic_framework-4.3.2/baf}/core/message.py

@@ -24,6 +24,7 @@ def get_message_type(value: str):
     for message_type in MessageType:
         if message_type.value == value:
             return message_type
+    return None
 
 
 class Message:

{besser_agentic_framework-4.3.0/besser/agent → besser_agentic_framework-4.3.2/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.0/besser/agent → besser_agentic_framework-4.3.2/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.0/besser/agent → besser_agentic_framework-4.3.2/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.0/besser/agent → besser_agentic_framework-4.3.2/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):

{besser_agentic_framework-4.3.0/besser/agent → besser_agentic_framework-4.3.2/baf}/core/session.py

@@ -10,22 +10,22 @@ from datetime import datetime
 from pandas import DataFrame
 from websocket import WebSocketApp
 
-from besser.agent import CHECK_TRANSITIONS_DELAY
-from besser.agent.core.transition.event import Event
-from besser.agent.core.transition.transition import Transition
-from besser.agent.library.transition.conditions import IntentMatcher
-from besser.agent.library.transition.events.base_events import ReceiveMessageEvent, ReceiveTextEvent
-from besser.agent.core.message import Message, get_message_type
-from besser.agent.exceptions.logger import logger
-from besser.agent.db import DB_MONITORING
-from besser.agent.nlp.rag.rag import RAGMessage
-from besser.agent.platforms.payload import PayloadEncoder, Payload, PayloadAction
+from baf import CHECK_TRANSITIONS_DELAY
+from baf.core.transition.event import Event
+from baf.core.transition.transition import Transition
+from baf.library.transition.conditions import IntentMatcher
+from baf.library.transition.events.base_events import ReceiveMessageEvent, ReceiveTextEvent
+from baf.core.message import Message, get_message_type
+from baf.exceptions.logger import logger
+from baf.db import DB_MONITORING
+from baf.nlp.rag.rag import RAGMessage
+from baf.platforms.payload import PayloadEncoder, Payload, PayloadAction
 
 if TYPE_CHECKING:
-    from besser.agent.core.agent import Agent
-    from besser.agent.db.db_handler import DBHandler
-    from besser.agent.core.state import State
-    from besser.agent.platforms.platform import Platform
+    from baf.core.agent import Agent
+    from baf.db.db_handler import DBHandler
+    from baf.core.state import State
+    from baf.platforms.platform import Platform
 
 
 class Session:
@@ -318,7 +318,7 @@ class Session:
                 will be used
             num_previous_messages (int): number of previous messages of the conversation to add to the prompt context.
                 If none is provided, the RAG's default value will be used. Necessary a connection to
-                :class:`~besser.agent.db.monitoring_db.MonitoringDB`
+                :class:`~baf.db.monitoring_db.MonitoringDB`
 
         Returns:
             RAGMessage: the answer generated by the RAG engine

{besser_agentic_framework-4.3.0/besser/agent → besser_agentic_framework-4.3.2/baf}/core/state.py

@@ -3,25 +3,25 @@ import traceback
 from collections import deque
 from typing import Any, Callable, TYPE_CHECKING, Union
 
-from besser.agent.core.transition.event import Event
-from besser.agent.core.transition.transition import Transition
-from besser.agent.core.transition.transition_builder import TransitionBuilder
-from besser.agent.library.intent.intent_library import fallback_intent
-from besser.agent.library.transition.events.base_events import ReceiveTextEvent, ReceiveFileEvent, WildcardEvent, ReceiveJSONEvent
-from besser.agent.library.transition.conditions import IntentMatcher, VariableOperationMatcher
-from besser.agent.core.transition.condition import Condition
-from besser.agent.core.intent.intent import Intent
-from besser.agent.core.session import Session
-from besser.agent.exceptions.exceptions import BodySignatureError, DuplicatedIntentMatchingTransitionError, \
+from baf.core.transition.event import Event
+from baf.core.transition.transition import Transition
+from baf.core.transition.transition_builder import TransitionBuilder
+from baf.library.intent.intent_library import fallback_intent
+from baf.library.transition.events.base_events import ReceiveTextEvent, ReceiveFileEvent, WildcardEvent, ReceiveJSONEvent
+from baf.library.transition.conditions import IntentMatcher, VariableOperationMatcher
+from baf.core.transition.condition import Condition
+from baf.core.intent.intent import Intent
+from baf.core.session import Session
+from baf.exceptions.exceptions import BodySignatureError, DuplicatedIntentMatchingTransitionError, \
     IntentNotFound
-from besser.agent.exceptions.logger import logger
-from besser.agent.library.transition.condition_functions import file_type
-from besser.agent.library.state.state_library import default_body, default_fallback_body
-from besser.agent.nlp.intent_classifier.intent_classifier_configuration import IntentClassifierConfiguration, \
+from baf.exceptions.logger import logger
+from baf.library.transition.condition_functions import file_type
+from baf.library.state.state_library import default_body, default_fallback_body
+from baf.nlp.intent_classifier.intent_classifier_configuration import IntentClassifierConfiguration, \
     SimpleIntentClassifierConfiguration
 
 if TYPE_CHECKING:
-    from besser.agent.core.agent import Agent
+    from baf.core.agent import Agent
 
 
 class State:
@@ -41,9 +41,9 @@ class State:
         _name (str): The state name
         _initial (bool): Whether the state is initial or not
         _body (Callable[[Session], None]): The state body. It is a callable that takes as argument a
-            :class:`~besser.agent.core.session.Session`. It will be run whenever the agent moves to this state.
+            :class:`~baf.core.session.Session`. It will be run whenever the agent moves to this state.
         _fallback_body (Callable[[Session], None]): The state fallback body. It is a callable that takes as argument a
-            :class:`~besser.agent.core.session.Session`. It will be run whenever the agent tries to move to another state,
+            :class:`~baf.core.session.Session`. It will be run whenever the agent tries to move to another state,
             but it can't (e.g. an intent is matched but none of the current state's transitions are triggered on that
             intent)
         _ic_config (IntentClassifierConfiguration): the intent classifier configuration of the state
@@ -192,11 +192,11 @@ class State:
 
         Args:
             function (Union[Callable[[Session], bool], Callable[[Session, dict], bool]]): the condition function to add
-                to the transition. Allowed function arguments are (:class:`~besser.agent.core.session.Session`) or
-                (:class:`~besser.agent.core.session.Session`, dict) to add parameters within the dict argument. The
+                to the transition. Allowed function arguments are (:class:`~baf.core.session.Session`) or
+                (:class:`~baf.core.session.Session`, dict) to add parameters within the dict argument. The
                 function must return a boolean value
             params (dict, optional): the parameters for the condition function, necessary if the function has
-                (:class:`~besser.agent.core.session.Session`, dict) arguments
+                (:class:`~baf.core.session.Session`, dict) arguments
         Returns:
             TransitionBuilder: the transition builder
         """

{besser_agentic_framework-4.3.0/besser/agent → besser_agentic_framework-4.3.2/baf}/core/transition/condition.py

@@ -2,7 +2,7 @@ import functools
 from typing import Callable, TYPE_CHECKING
 
 if TYPE_CHECKING:
-    from besser.agent.core.session import Session
+    from baf.core.session import Session
 
 
 class Condition:

{besser_agentic_framework-4.3.0/besser/agent → besser_agentic_framework-4.3.2/baf}/core/transition/transition.py

@@ -1,13 +1,13 @@
 import traceback
 from typing import TYPE_CHECKING
 
-from besser.agent.core.transition.event import Event
-from besser.agent.core.transition.condition import Condition
-from besser.agent.exceptions.logger import logger
+from baf.core.transition.event import Event
+from baf.core.transition.condition import Condition
+from baf.exceptions.logger import logger
 
 if TYPE_CHECKING:
-    from besser.agent.core.session import Session
-    from besser.agent.core.state import State
+    from baf.core.session import Session
+    from baf.core.state import State
 
 
 class Transition:

{besser_agentic_framework-4.3.0/besser/agent → besser_agentic_framework-4.3.2/baf}/core/transition/transition_builder.py

@@ -2,14 +2,14 @@ import inspect
 from functools import partial
 from typing import Union, Callable, TYPE_CHECKING
 
-from besser.agent.core.transition.event import Event
-from besser.agent.core.transition.condition import Condition, Conjunction
-from besser.agent.core.transition.transition import Transition
-from besser.agent.exceptions.exceptions import StateNotFound, ConflictingAutoTransitionError
+from baf.core.transition.event import Event
+from baf.core.transition.condition import Condition, Conjunction
+from baf.core.transition.transition import Transition
+from baf.exceptions.exceptions import StateNotFound, ConflictingAutoTransitionError
 
 if TYPE_CHECKING:
-    from besser.agent.core.session import Session
-    from besser.agent.core.state import State
+    from baf.core.session import Session
+    from baf.core.state import State
 
 
 class TransitionBuilder:
@@ -46,11 +46,11 @@ class TransitionBuilder:
 
         Args:
             function (Union[Callable[[Session], bool], Callable[[Session, dict], bool]]): the condition function to add
-                to the transition. Allowed function arguments are (:class:`~besser.agent.core.session.Session`) or
-                (:class:`~besser.agent.core.session.Session`, dict) to add parameters within the dict argument. The
+                to the transition. Allowed function arguments are (:class:`~baf.core.session.Session`) or
+                (:class:`~baf.core.session.Session`, dict) to add parameters within the dict argument. The
                 function must return a boolean value
             params (dict, optional): the parameters for the condition function, necessary if the function has
-                (:class:`~besser.agent.core.session.Session`, dict) arguments
+                (:class:`~baf.core.session.Session`, dict) arguments
 
         Returns:
             TransitionBuilder: the transition builder with the new condition added

{besser_agentic_framework-4.3.0/besser/agent → besser_agentic_framework-4.3.2/baf}/db/__init__.py

@@ -1,6 +1,6 @@
 """Definition of the agent properties within the ``db`` (Database) section"""
 
-from besser.agent.core.property import Property
+from baf.core.property import Property
 
 DB_MONITORING = Property('db.monitoring.enabled', bool, False)
 """

{besser_agentic_framework-4.3.0/besser/agent → besser_agentic_framework-4.3.2/baf}/db/db_handler.py

@@ -6,11 +6,11 @@ from typing import TYPE_CHECKING, Any
 from sqlalchemy import create_engine, inspect, text
 from sqlalchemy.engine import Connection, Engine, URL
 
-from besser.agent.exceptions.logger import logger
+from baf.exceptions.logger import logger
 
 if TYPE_CHECKING:
-    from besser.agent.core.agent import Agent
-    from besser.agent.nlp.llm.llm import LLM
+    from baf.core.agent import Agent
+    from baf.nlp.llm.llm import LLM
 
 
 class DBHandler:
@@ -20,7 +20,11 @@ class DBHandler:
     configuration and opens connections lazily when they are first needed.
     """
 
-    _REQUIRED_DB_FIELDS = {'dialect', 'host', 'port', 'database', 'username', 'password'}
+    _DEFAULT_REQUIRED_DB_FIELDS = {'dialect', 'host', 'port', 'database', 'username', 'password'}
+    _DIALECT_REQUIRED_DB_FIELDS = {
+        'sqlite': {'dialect', 'file'},
+        'postgres': {'dialect', 'host', 'port', 'database', 'username', 'password'}
+    }
     _SQL_COMMAND_PATTERN = re.compile(r'^\s*(?:/\*.*?\*/\s*|--.*?(?:\n|\r\n?)\s*)*([a-zA-Z]+)', re.DOTALL)
 
     def __init__(self, agent: 'Agent'):
@@ -50,24 +54,36 @@ class DBHandler:
         return db_configs
 
     def _validate_db_config(self, db_name: str, db_config: dict[str, Any]) -> bool:
-        missing = sorted(field for field in self._REQUIRED_DB_FIELDS if db_config.get(field) is None)
+        required_fields = self._required_db_fields(db_config)
+        missing = sorted(field for field in required_fields if db_config.get(field) is None)
         if missing:
+            dialect = db_config.get('dialect')
             logger.error(
-                "Missing required DB properties for '%s': %s. Expected under 'db.sql.%s'.",
+                "Missing required DB properties for '%s' (dialect=%s): %s. Expected under 'db.sql.%s'. Required fields: %s.",
                 db_name,
+                dialect,
                 ', '.join(missing),
                 db_name,
+                ', '.join(sorted(required_fields)),
             )
             return False
         return True
 
+    def _required_db_fields(self, db_config: dict[str, Any]) -> set[str]:
+        dialect = db_config.get('dialect')
+        if dialect is None:
+            return {'dialect'}
+
+        dialect_name = str(dialect).split('+', 1)[0].lower()
+        return self._DIALECT_REQUIRED_DB_FIELDS.get(dialect_name, self._DEFAULT_REQUIRED_DB_FIELDS)
+
     def _build_db_url(self, db_name: str) -> URL | str | None:
         try:
             db_config = self._db_configs[db_name]
             dialect = str(db_config['dialect'])
 
             if dialect.startswith('sqlite'):
-                return URL.create(drivername=dialect, database=str(db_config['database']))
+                return URL.create(drivername=dialect, database=str(db_config['file']))
 
             return URL.create(
                 drivername=dialect,