igbot-base 0.0.10__tar.gz → 0.0.12__tar.gz

{igbot_base-0.0.10 → igbot_base-0.0.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: igbot_base
-Version: 0.0.10
+Version: 0.0.12
 Summary: Base classes for igbot
 Author-email: Igor Kopeć <igor.kopec95@gmail.com>
 License: LGPL-3.0-or-later

igbot_base-0.0.12/igbot_base/agent.py

@@ -0,0 +1,33 @@
+from abc import ABC, abstractmethod
+
+from igbot_base.agent_response import AgentResponse
+
+from igbot_base.exception_handler import ExceptionHandler, ReturnFailedResponseGracefully
+from igbot_base.logging_adapter import get_logger
+
+logger = get_logger("application")
+
+
+class Agent(ABC):
+
+    def __init__(self, name, exception_handler: ExceptionHandler = ReturnFailedResponseGracefully):
+        self.__name = name
+        self.__ex_handler = exception_handler
+
+    def invoke(self, query) -> AgentResponse:
+        try:
+            return self._invoke(query)
+        except Exception as e:
+            logger.exception("Exception occurred at %s for query %s: %s", self.describe(), query, e)
+            return self.__ex_handler.handle(e)
+
+    @abstractmethod
+    def _invoke(self, query) -> AgentResponse:
+        pass
+
+    @abstractmethod
+    def describe(self):
+        pass
+
+    def __str__(self):
+        return self.describe()

igbot_base-0.0.12/igbot_base/exception/agent_exception.py

@@ -0,0 +1,14 @@
+from igbot_base.agent import Agent
+from igbot_base.exception.base_exception import IgBotBaseException
+
+
+class BaseAgentException(IgBotBaseException):
+
+    def __init__(self, message, agent: Agent, cause: Exception = None):
+        super().__init__(message, cause)
+        self.agent = agent
+
+    def __str__(self):
+        result = super().__str__()
+        result += f" at agent {self.agent}"
+

igbot_base-0.0.12/igbot_base/exception/base_exception.py

@@ -0,0 +1,12 @@
+class IgBotBaseException(Exception):
+
+    def __init__(self, message, cause: Exception = None):
+        super().__init__(message)
+        self.cause = cause
+
+    def __str__(self):
+        result = self.args[0]
+        if self.cause:
+            result += f" Caused by: {self.cause}"
+
+        return result

igbot_base-0.0.12/igbot_base/exception/llm_exception.py

@@ -0,0 +1,13 @@
+from igbot_base.exception.base_exception import IgBotBaseException
+from igbot_base.llm import Llm
+
+
+class BaseLlmException(IgBotBaseException):
+
+    def __init__(self, message, llm: Llm,  cause: Exception = None):
+        super().__init__(message, cause)
+        self.llm = llm
+
+    def __str__(self):
+        result = super().__str__()
+        result += f" at llm {self.llm}"

igbot_base-0.0.12/igbot_base/exception/memory_exception.py

@@ -0,0 +1,14 @@
+from igbot_base.exception.base_exception import IgBotBaseException
+from igbot_base.llmmemory import LlmMemory
+
+
+class BaseMemoryException(IgBotBaseException):
+
+    def __init__(self, message, memory: LlmMemory, cause: Exception = None):
+        super().__init__(message, cause)
+        self.memory = memory
+
+    def __str__(self):
+        result = super().__str__()
+        result += f" at memory {self.memory}"
+

igbot_base-0.0.12/igbot_base/exception/prompt_exception.py

@@ -0,0 +1,14 @@
+from igbot_base.exception.base_exception import IgBotBaseException
+from igbot_base.prompt_template import Prompt
+
+
+class BasePromptException(IgBotBaseException):
+
+    def __init__(self, message, prompt: Prompt, cause: Exception = None):
+        super().__init__(message, cause)
+        self.prompt = prompt
+
+    def __str__(self):
+        result = super().__str__()
+        result += f" at prompt {self.prompt}"
+

igbot_base-0.0.12/igbot_base/exception/retriever_exception.py

@@ -0,0 +1,14 @@
+from igbot_base.exception.base_exception import IgBotBaseException
+from igbot_base.retriever import Retriever
+
+
+class BaseRetrieverException(IgBotBaseException):
+
+    def __init__(self, message, retriever: Retriever, cause: Exception = None):
+        super().__init__(message, cause)
+        self.retriever = retriever
+
+    def __str__(self):
+        result = super().__str__()
+        result += f" at retriever {self.retriever}"
+

igbot_base-0.0.12/igbot_base/exception/tool_exception.py

@@ -0,0 +1,14 @@
+from igbot_base.exception.base_exception import IgBotBaseException
+from igbot_base.tool import Tool
+
+
+class BaseToolException(IgBotBaseException):
+
+    def __init__(self, message, tool: Tool, cause: Exception = None):
+        super().__init__(message, cause)
+        self.tool = tool
+
+    def __str__(self):
+        result = super().__str__()
+        result += f" at tool {self.tool}"
+

{igbot_base-0.0.10 → igbot_base-0.0.12}/igbot_base/exception_handler.py

@@ -1,5 +1,7 @@
 from abc import ABC, abstractmethod
 
+from igbot_base.agent_response import AgentResponse
+
 
 class ExceptionHandler(ABC):
 
@@ -18,3 +20,9 @@ class PrintingExceptionHandler(ExceptionHandler):
 
     def handle(self, e: Exception):
         print(e)
+
+
+class ReturnFailedResponseGracefully(ExceptionHandler):
+
+    def handle(self, e: Exception):
+        return AgentResponse.error(str(e), e)

{igbot_base-0.0.10 → igbot_base-0.0.12}/igbot_base/llm.py

@@ -25,6 +25,9 @@ class Llm(ABC):
         self._format = response_format
         self._exception_handler = llm_exception_handler
 
+    def __str__(self):
+        return f"Llm({self._name} {self._model.get_name()})"
+
     @abstractmethod
     def _call(self, user_query: str, history: LlmMemory, params: dict) -> str:
         pass
@@ -33,6 +36,7 @@ class Llm(ABC):
         history.revert_to_snapshot()
 
     def call(self, user_query: str, history: LlmMemory, params: dict) -> str:
+        logger.debug("Call to %s with question: %s", self.__str__(), user_query)
         history.set_snapshot()
         try:
             response = self._call(user_query, history, params)
@@ -52,3 +56,4 @@ class Llm(ABC):
             args["response_format"] = self._format
 
         return args
+

{igbot_base-0.0.10 → igbot_base-0.0.12}/igbot_base/llmmemory.py

@@ -50,3 +50,10 @@ class LlmMemory(ABC):
     @abstractmethod
     def set_snapshot(self):
         pass
+
+    @abstractmethod
+    def describe(self):
+        pass
+
+    def __str__(self):
+        return self.describe()

{igbot_base-0.0.10 → igbot_base-0.0.12}/igbot_base/prompt_template.py

@@ -18,6 +18,9 @@ class Prompt:
         self.__variables = variables
         self.__exception_handler = exception_handler
 
+    def __str__(self):
+        return f"Prompt({self.__get_content_short()} ({",".join(self.__variables)}))"
+
     @staticmethod
     def replace_placeholders(text: str, values: dict) -> str:
         def replacer(match):

{igbot_base-0.0.10 → igbot_base-0.0.12}/igbot_base/retriever.py

@@ -22,3 +22,10 @@ class Retriever(ABC):
     @abstractmethod
     def get_relevant_data(self, query: str) -> RetrieverResponse:
         pass
+
+    @abstractmethod
+    def describe(self):
+        pass
+
+    def __str__(self):
+        return self.describe()

{igbot_base-0.0.10 → igbot_base-0.0.12}/igbot_base/tool.py

@@ -18,3 +18,10 @@ class Tool(ABC):
     @abstractmethod
     def get_definition(self):
         pass
+
+    @abstractmethod
+    def describe(self):
+        pass
+
+    def __str__(self):
+        return self.describe()

{igbot_base-0.0.10 → igbot_base-0.0.12}/igbot_base.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: igbot_base
-Version: 0.0.10
+Version: 0.0.12
 Summary: Base classes for igbot
 Author-email: Igor Kopeć <igor.kopec95@gmail.com>
 License: LGPL-3.0-or-later

{igbot_base-0.0.10 → igbot_base-0.0.12}/igbot_base.egg-info/SOURCES.txt

@@ -17,4 +17,11 @@ igbot_base.egg-info/PKG-INFO
 igbot_base.egg-info/SOURCES.txt
 igbot_base.egg-info/dependency_links.txt
 igbot_base.egg-info/requires.txt
-igbot_base.egg-info/top_level.txt
+igbot_base.egg-info/top_level.txt
+igbot_base/exception/agent_exception.py
+igbot_base/exception/base_exception.py
+igbot_base/exception/llm_exception.py
+igbot_base/exception/memory_exception.py
+igbot_base/exception/prompt_exception.py
+igbot_base/exception/retriever_exception.py
+igbot_base/exception/tool_exception.py

{igbot_base-0.0.10 → igbot_base-0.0.12}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "igbot_base"
-version = "0.0.10"
+version = "0.0.12"
 description = "Base classes for igbot"
 authors = [{name = "Igor Kopeć", email = "igor.kopec95@gmail.com"}]
 license={text="LGPL-3.0-or-later"}

igbot_base-0.0.10/igbot_base/agent.py

@@ -1,10 +0,0 @@
-from abc import ABC, abstractmethod
-
-from igbot_base.agent_response import AgentResponse
-
-
-class Agent(ABC):
-
-    @abstractmethod
-    def invoke(self, query) -> AgentResponse:
-        pass