alita-sdk 0.3.149__py3-none-any.whl → 0.3.151__py3-none-any.whl

alita_sdk/__init__.py

@@ -9,13 +9,13 @@ This package contains three main modules:
 
 __version__ = "0.3.142"
 
-# Import key components
-from .runtime import *
-from .tools import *
-from .community import *
+__all__ = ["runtime", "tools", "community"]
 
-__all__ = [
-    "runtime",
-    "tools",
-    "community",
-]
+import importlib
+
+def __getattr__(name):
+    if name in __all__:
+        module = importlib.import_module(f".{name}", __name__)
+        globals()[name] = module
+        return module
+    raise AttributeError(f"module {__name__} has no attribute {name}")

alita_sdk/runtime/__init__.py

@@ -7,23 +7,27 @@ Includes agents, clients, language models, and utilities.
 
 import importlib
 
-# Import available runtime modules
-__all__ = []
+_modules = [
+    "agents",
+    "clients",
+    "langchain",
+    "llamaindex",
+    "llms",
+    "toolkits",
+    "tools",
+    "utils",
+]
 
-# Standard imports with fallback
-_modules = ['agents', 'clients', 'langchain', 'llamaindex', 'llms', 'toolkits', 'tools', 'utils']
+__all__ = _modules + ["get_tools", "get_toolkits"]
 
-for module_name in _modules:
-    try:
-        module = importlib.import_module(f'.{module_name}', package=__name__)
-        globals()[module_name] = module
-        __all__.append(module_name)
-    except ImportError:
-        pass
-
-# Always try to export core functions from toolkits
-try:
-    from .toolkits.tools import get_tools, get_toolkits
-    __all__.extend(["get_tools", "get_toolkits"])
-except ImportError:
-    pass
+def __getattr__(name):
+    if name in _modules:
+        module = importlib.import_module(f".{name}", __name__)
+        globals()[name] = module
+        return module
+    if name in {"get_tools", "get_toolkits"}:
+        toolkits = importlib.import_module(".toolkits.tools", __name__)
+        value = getattr(toolkits, name)
+        globals()[name] = value
+        return value
+    raise AttributeError(f"module {__name__} has no attribute {name}")

alita_sdk/runtime/clients/__init__.py

@@ -1 +1,12 @@
-from .client import AlitaClient
+"""
+Runtime clients package.
+"""
+
+try:
+    from .client import AlitaClient
+    __all__ = ['AlitaClient']
+except ImportError as e:
+    # Handle case where dependencies are not available
+    import logging
+    logging.getLogger(__name__).debug(f"Failed to import AlitaClient: {e}")
+    __all__ = []

alita_sdk/runtime/clients/client.py

@@ -9,6 +9,7 @@ from langchain_core.messages import (
     SystemMessage, BaseMessage,
 )
 from langchain_core.tools import ToolException
+from langgraph.store.base import BaseStore
 
 from ..langchain.assistant import Assistant as LangChainAssistant
 # from ..llamaindex.assistant import Assistant as LLamaAssistant
@@ -178,7 +179,7 @@ class AlitaClient:
                     tools: Optional[list] = None, chat_history: Optional[List[Any]] = None,
                     app_type=None, memory=None, runtime='langchain',
                     application_variables: Optional[dict] = None,
-                    version_details: Optional[dict] = None):
+                    version_details: Optional[dict] = None, store: Optional[BaseStore] = None):
         if tools is None:
             tools = []
         if chat_history is None:
@@ -210,11 +211,11 @@ class AlitaClient:
             app_type = "openai"
         if runtime == 'nonrunnable':
             return LangChainAssistant(self, data, client, chat_history, app_type,
-                                      tools=tools, memory=memory)
+                                      tools=tools, memory=memory, store=store)
         if runtime == 'langchain':
             return LangChainAssistant(self, data, client,
                                       chat_history, app_type,
-                                      tools=tools, memory=memory).runnable()
+                                      tools=tools, memory=memory, store=store).runnable()
         elif runtime == 'llama':
             raise NotImplementedError("LLama runtime is not supported")
 

alita_sdk/runtime/langchain/assistant.py

@@ -5,8 +5,9 @@ from typing import Any, Optional
 from langchain.agents import (
     AgentExecutor, create_openai_tools_agent,
     create_json_chat_agent)
+from langgraph.store.base import BaseStore
+
 from .agents.xml_chat import create_xml_chat_agent
-# from ..langchain.mixedAgentRenderes import render_react_text_description_and_args
 from .langraph_agent import create_graph
 from langchain_core.messages import (
     BaseMessage, SystemMessage, HumanMessage
@@ -28,7 +29,8 @@ class Assistant:
                  chat_history: list[BaseMessage] = [],
                  app_type: str = "openai",
                  tools: Optional[list] = [],
-                 memory: Optional[Any] = None):
+                 memory: Optional[Any] = None,
+                 store: Optional[BaseStore] = None):
 
         self.client = copy(client)
         self.client.max_tokens = data['llm_settings']['max_tokens']
@@ -40,6 +42,7 @@ class Assistant:
 
         self.app_type = app_type
         self.memory = memory
+        self.store = store
 
         logger.debug("Data for agent creation: %s", data)
         logger.info("App type: %s", app_type)
@@ -58,7 +61,10 @@ class Assistant:
             raise ToolException("Non-pipeline agents cannot have pipelines as a toolkits. "
                                 "Review toolkits configuration or use pipeline as master agent.")
 
-        self.tools = get_tools(data['tools'], alita_client=alita, llm=self.client)
+        # configure memory store if memory tool is defined
+        memory_tool = next((tool for tool in data['tools'] if tool['type'] == 'memory'), None)
+        self._configure_store(memory_tool)
+        self.tools = get_tools(data['tools'], alita_client=alita, llm=self.client, memory_store=self.store)
         if app_type == "pipeline":
             self.prompt = data['instructions']
         else:
@@ -94,6 +100,18 @@ class Assistant:
             except Exception as e:
                 logger.info(f"Client was created with client setting: temperature - {self.client.temperature} : {self.client.max_tokens}")
 
+    def _configure_store(self, memory_tool: dict | None) -> None:
+        """
+        Configure the memory store based on a memory_tool definition.
+        Only creates a new store if one does not already exist.
+        """
+        if not memory_tool or self.store is not None:
+            return
+        from .store_manager import get_manager
+        conn_str = memory_tool.get('settings', {}).get('connection_string', '')
+        store = get_manager().get_store(conn_str)
+        self.store = store
+
     def runnable(self):
         if self.app_type == 'pipeline':
             return self.pipeline()

alita_sdk/runtime/langchain/store_manager.py

@@ -0,0 +1,46 @@
+import threading
+import atexit
+import logging
+from psycopg import Connection
+from langgraph.store.postgres import PostgresStore
+
+logger = logging.getLogger(__name__)
+
+class StoreManager:
+    _instance = None
+    _lock = threading.Lock()
+
+    def __new__(cls):
+        if cls._instance is None:
+            with cls._lock:
+                if cls._instance is None:
+                    cls._instance = super().__new__(cls)
+                    cls._instance._stores = {}
+        return cls._instance
+
+    def get_store(self, conn_str: str) -> PostgresStore:
+        store = self._stores.get(conn_str)
+        if store is None:
+            logger.info(f"Creating new PostgresStore for connection: {conn_str}")
+            conn = Connection.connect(conn_str, autocommit=True, prepare_threshold=0)
+            store = PostgresStore(conn)
+            store.setup()
+            self._stores[conn_str] = store
+        return store
+
+    def shutdown(self) -> None:
+        logger.info("Shutting down StoreManager and closing all stores")
+        for store in list(self._stores.values()):
+            try:
+                conn = getattr(store, 'conn', None)
+                if conn:
+                    conn.close()
+            except Exception:
+                pass
+        self._stores.clear()
+
+_store_manager = StoreManager()
+atexit.register(_store_manager.shutdown)
+
+def get_manager() -> StoreManager:
+    return _store_manager

alita_sdk/runtime/llms/preloaded.py

@@ -30,7 +30,11 @@ from langchain_core.language_models import BaseChatModel  # pylint: disable=E040
 from langchain_core.messages import AIMessage, AIMessageChunk  # pylint: disable=E0401
 from langchain_core.outputs import ChatGeneration, ChatGenerationChunk, ChatResult  # pylint: disable=E0401
 
-from ..langchain.tools import log
+try:
+    from ..langchain.tools import log
+except ImportError:
+    import logging as _logging
+    log = _logging.getLogger(__name__)
 
 
 class PreloadedEmbeddings(Embeddings):

alita_sdk/runtime/toolkits/application.py

@@ -1,4 +1,6 @@
 from typing import List, Any, Optional
+
+from langgraph.store.base import BaseStore
 from pydantic import create_model, BaseModel, Field
 from langchain_community.agent_toolkits.base import BaseToolkit
 from langchain_core.tools import BaseTool
@@ -19,8 +21,8 @@ class ApplicationToolkit(BaseToolkit):
         )
     
     @classmethod
-    def get_toolkit(cls, client: Any, application_id: int, application_version_id: int, app_api_key: str, 
-                    selected_tools: list[str] = []):
+    def get_toolkit(cls, client: Any, application_id: int, application_version_id: int, app_api_key: str,
+                    selected_tools: list[str] = [], store: Optional[BaseStore] = None):
         from ..llms.alita import AlitaChatModel
         
         app_details = client.get_app_details(application_id)
@@ -37,7 +39,7 @@ class ApplicationToolkit(BaseToolkit):
             "temperature": version_details['llm_settings']['temperature'],
         }
 
-        app = client.application(AlitaChatModel(**settings), application_id, application_version_id)
+        app = client.application(AlitaChatModel(**settings), application_id, application_version_id, store=store)
         return cls(tools=[Application(name=app_details.get("name"), 
                                       description=app_details.get("description"), 
                                       application=app, 

alita_sdk/runtime/toolkits/tools.py

@@ -1,19 +1,20 @@
 import logging
 
+from langchain_core.tools import ToolException
+from langgraph.store.base import BaseStore
+
 from alita_sdk.tools import get_toolkits as alita_toolkits
 from alita_sdk.tools import get_tools as alita_tools
-
 from .application import ApplicationToolkit
 from .artifact import ArtifactToolkit
 from .datasource import DatasourcesToolkit
 from .prompt import PromptToolkit
 from .subgraph import SubgraphToolkit
 from .vectorstore import VectorStoreToolkit
-
+from ..tools.mcp_server_tool import McpServerTool
 # Import community tools
 from ...community import get_toolkits as community_toolkits, get_tools as community_tools
-
-from ..tools.mcp_server_tool import McpServerTool
+from ...tools.memory import MemoryToolkit
 
 logger = logging.getLogger(__name__)
 
@@ -24,13 +25,14 @@ def get_toolkits():
         # DatasourcesToolkit.toolkit_config_schema(),
         # ApplicationToolkit.toolkit_config_schema(),
         ArtifactToolkit.toolkit_config_schema(),
+        MemoryToolkit.toolkit_config_schema(),
         VectorStoreToolkit.toolkit_config_schema()
     ]
 
     return core_toolkits + community_toolkits() + alita_toolkits()
 
 
-def get_tools(tools_list: list, alita_client, llm) -> list:
+def get_tools(tools_list: list, alita_client, llm, memory_store: BaseStore = None) -> list:
     prompts = []
     tools = []
 
@@ -65,6 +67,14 @@ def get_tools(tools_list: list, alita_client, llm) -> list:
                 selected_tools=[],
                 llm=llm
             ))
+        elif tool['type'] == 'memory':
+            if memory_store is None:
+                raise ToolException(f"Memory store is not provided for memory tool: {tool['name']}")
+            tools += MemoryToolkit.get_toolkit(
+                namespace=tool['settings'].get('namespace', str(tool['id'])),
+                store=memory_store,
+                toolkit_name=tool.get('toolkit_name', '')
+            ).get_tools()
         elif tool['type'] == 'artifact':
             tools.extend(ArtifactToolkit.get_toolkit(
                 client=alita_client,

alita_sdk/runtime/utils/logging.py

@@ -1,7 +1,12 @@
 import logging
 from functools import wraps
 
-from langchain_core.callbacks import dispatch_custom_event
+try:
+    from langchain_core.callbacks import dispatch_custom_event
+except ImportError:
+    # Fallback stub if langchain_core is unavailable
+    def dispatch_custom_event(name: str, data: dict):  # pragma: no cover
+        pass
 
 
 class StreamlitCallbackHandler(logging.Handler):
@@ -42,6 +47,7 @@ def setup_streamlit_logging(
         formatter = logging.Formatter("%(asctime)s - %(levelname)s - %(message)s")
         handler.setFormatter(formatter)
         logger.addHandler(handler)
+        logger.setLevel(logging.INFO)
 
     return handler
 

alita_sdk/runtime/utils/save_dataframe.py

@@ -6,13 +6,16 @@ from typing import Any, Dict, Optional
 from langchain_core.tools import ToolException
 import pandas as pd
 
-from ..tools.artifact import ArtifactWrapper
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:  # pragma: no cover - avoid heavy imports at runtime
+    from ..tools.artifact import ArtifactWrapper
 
 logger = logging.getLogger(__name__)
 
 
 def save_dataframe_to_artifact(
-    artifacts_wrapper: ArtifactWrapper,
+    artifacts_wrapper: 'ArtifactWrapper',
     df: pd.DataFrame,
     target_file: str,
     csv_options: Optional[Dict[str, Any]] = None,