alita-sdk 0.3.150__tar.gz → 0.3.151__tar.gz

{alita_sdk-0.3.150 → alita_sdk-0.3.151}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alita_sdk
-Version: 0.3.150
+Version: 0.3.151
 Summary: SDK for building langchain agents using resources from Alita
 Author-email: Artem Rozumenko <artyom.rozumenko@gmail.com>, Mikalai Biazruchka <mikalai_biazruchka@epam.com>, Roman Mitusov <roman_mitusov@epam.com>, Ivan Krakhmaliuk <lifedjik@gmail.com>
 License-Expression: Apache-2.0

{alita_sdk-0.3.150 → alita_sdk-0.3.151}/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-0.3.151/alita_sdk/runtime/__init__.py

@@ -0,0 +1,33 @@
+"""
+Alita SDK Runtime Module
+
+This module contains the core runtime functionality for building langchain agents.
+Includes agents, clients, language models, and utilities.
+"""
+
+import importlib
+
+_modules = [
+    "agents",
+    "clients",
+    "langchain",
+    "llamaindex",
+    "llms",
+    "toolkits",
+    "tools",
+    "utils",
+]
+
+__all__ = _modules + ["get_tools", "get_toolkits"]
+
+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-0.3.151/alita_sdk/runtime/clients/__init__.py

@@ -0,0 +1,12 @@
+"""
+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-0.3.150 → alita_sdk-0.3.151}/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-0.3.150 → alita_sdk-0.3.151}/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-0.3.150 → alita_sdk-0.3.151}/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,

alita_sdk-0.3.151/alita_sdk/tools/__init__.py

@@ -0,0 +1,205 @@
+import logging
+from importlib import import_module
+
+logger = logging.getLogger(__name__)
+
+# Available tools and toolkits - populated by safe imports
+AVAILABLE_TOOLS = {}
+AVAILABLE_TOOLKITS = {}
+FAILED_IMPORTS = {}
+
+def _safe_import_tool(tool_name, module_path, get_tools_name=None, toolkit_class_name=None):
+    """Safely import a tool module and register available functions/classes."""
+    try:
+        module = __import__(f'alita_sdk.tools.{module_path}', fromlist=[''])
+        
+        imported = {}
+        if get_tools_name and hasattr(module, get_tools_name):
+            imported['get_tools'] = getattr(module, get_tools_name)
+            
+        if toolkit_class_name and hasattr(module, toolkit_class_name):
+            imported['toolkit_class'] = getattr(module, toolkit_class_name)
+            AVAILABLE_TOOLKITS[toolkit_class_name] = getattr(module, toolkit_class_name)
+            
+        if imported:
+            AVAILABLE_TOOLS[tool_name] = imported
+            logger.debug(f"Successfully imported {tool_name}")
+        
+    except Exception as e:
+        FAILED_IMPORTS[tool_name] = str(e)
+        logger.debug(f"Failed to import {tool_name}: {e}")
+
+# Safe imports for all tools
+_safe_import_tool('github', 'github', 'get_tools', 'AlitaGitHubToolkit')
+_safe_import_tool('openapi', 'openapi', 'get_tools')
+_safe_import_tool('jira', 'jira', 'get_tools', 'JiraToolkit')
+_safe_import_tool('confluence', 'confluence', 'get_tools', 'ConfluenceToolkit')
+_safe_import_tool('service_now', 'servicenow', 'get_tools', 'ServiceNowToolkit')
+_safe_import_tool('gitlab', 'gitlab', 'get_tools', 'AlitaGitlabToolkit')
+_safe_import_tool('gitlab_org', 'gitlab_org', 'get_tools', 'AlitaGitlabSpaceToolkit')
+_safe_import_tool('zephyr', 'zephyr', 'get_tools', 'ZephyrToolkit')
+_safe_import_tool('browser', 'browser', 'get_tools', 'BrowserToolkit')
+_safe_import_tool('report_portal', 'report_portal', 'get_tools', 'ReportPortalToolkit')
+_safe_import_tool('bitbucket', 'bitbucket', 'get_tools', 'AlitaBitbucketToolkit')
+_safe_import_tool('testrail', 'testrail', 'get_tools', 'TestrailToolkit')
+_safe_import_tool('testio', 'testio', 'get_tools', 'TestIOToolkit')
+_safe_import_tool('xray_cloud', 'xray', 'get_tools', 'XrayToolkit')
+_safe_import_tool('sharepoint', 'sharepoint', 'get_tools', 'SharepointToolkit')
+_safe_import_tool('qtest', 'qtest', 'get_tools', 'QtestToolkit')
+_safe_import_tool('zephyr_scale', 'zephyr_scale', 'get_tools', 'ZephyrScaleToolkit')
+_safe_import_tool('zephyr_enterprise', 'zephyr_enterprise', 'get_tools', 'ZephyrEnterpriseToolkit')
+_safe_import_tool('ado', 'ado', 'get_tools')
+_safe_import_tool('ado_repos', 'ado.repos', 'get_tools', 'AzureDevOpsReposToolkit')
+_safe_import_tool('ado_plans', 'ado.test_plan', None, 'AzureDevOpsPlansToolkit')
+_safe_import_tool('ado_work_items', 'ado.work_item', None, 'AzureDevOpsWorkItemsToolkit')
+_safe_import_tool('ado_wiki', 'ado.wiki', None, 'AzureDevOpsWikiToolkit')
+_safe_import_tool('rally', 'rally', 'get_tools', 'RallyToolkit')
+_safe_import_tool('sql', 'sql', 'get_tools', 'SQLToolkit')
+_safe_import_tool('sonar', 'code.sonar', 'get_tools', 'SonarToolkit')
+_safe_import_tool('google_places', 'google_places', 'get_tools', 'GooglePlacesToolkit')
+_safe_import_tool('yagmail', 'yagmail', 'get_tools', 'AlitaYagmailToolkit')
+_safe_import_tool('aws', 'cloud.aws', None, 'AWSToolkit')
+_safe_import_tool('azure', 'cloud.azure', None, 'AzureToolkit')
+_safe_import_tool('gcp', 'cloud.gcp', None, 'GCPToolkit')
+_safe_import_tool('k8s', 'cloud.k8s', None, 'KubernetesToolkit')
+_safe_import_tool('custom_open_api', 'custom_open_api', None, 'OpenApiToolkit')
+_safe_import_tool('elastic', 'elastic', None, 'ElasticToolkit')
+_safe_import_tool('keycloak', 'keycloak', None, 'KeycloakToolkit')
+_safe_import_tool('localgit', 'localgit', None, 'AlitaLocalGitToolkit')
+_safe_import_tool('pandas', 'pandas', 'get_tools', 'PandasToolkit')
+_safe_import_tool('azure_search', 'azure_ai.search', 'get_tools', 'AzureSearchToolkit')
+_safe_import_tool('figma', 'figma', 'get_tools', 'FigmaToolkit')
+_safe_import_tool('salesforce', 'salesforce', 'get_tools', 'SalesforceToolkit')
+_safe_import_tool('carrier', 'carrier', 'get_tools', 'AlitaCarrierToolkit')
+_safe_import_tool('ocr', 'ocr', 'get_tools', 'OCRToolkit')
+_safe_import_tool('pptx', 'pptx', 'get_tools', 'PPTXToolkit')
+_safe_import_tool('postman', 'postman', 'get_tools', 'PostmanToolkit')
+
+# Log import summary
+available_count = len(AVAILABLE_TOOLS)
+total_attempted = len(AVAILABLE_TOOLS) + len(FAILED_IMPORTS)
+logger.info(f"Tool imports completed: {available_count}/{total_attempted} successful")
+
+def get_tools(tools_list, alita, llm, *args, **kwargs):
+    tools = []
+    for tool in tools_list:
+        # validate tool name syntax - it cannot be started with _
+        for tool_name in tool.get('settings', {}).get('selected_tools', []):
+            if isinstance(tool_name, str) and tool_name.startswith('_'):
+                raise ValueError(f"Tool name '{tool_name}' from toolkit '{tool.get('type', '')}' cannot start with '_'")
+        
+        tool['settings']['alita'] = alita
+        tool['settings']['llm'] = llm
+        tool_type = tool['type']
+        
+        # Check if tool is available and has get_tools function
+        if tool_type in AVAILABLE_TOOLS and 'get_tools' in AVAILABLE_TOOLS[tool_type]:
+            try:
+                get_tools_func = AVAILABLE_TOOLS[tool_type]['get_tools']
+                
+                # Handle special cases for ADO tools
+                if tool_type in ['ado_boards', 'ado_wiki', 'ado_plans']:
+                    tools.extend(get_tools_func(tool_type, tool))
+                else:
+                    tools.extend(get_tools_func(tool))
+                    
+            except Exception as e:
+                logger.error(f"Error getting tools for {tool_type}: {e}")
+                
+        # Handle ADO repos special case (it might be requested as azure_devops_repos)
+        elif tool_type in ['ado_repos', 'azure_devops_repos'] and 'ado_repos' in AVAILABLE_TOOLS:
+            try:
+                get_tools_func = AVAILABLE_TOOLS['ado_repos']['get_tools']
+                tools.extend(get_tools_func(tool))
+            except Exception as e:
+                logger.error(f"Error getting ADO repos tools: {e}")
+                
+        # Handle custom modules
+        elif tool.get("settings", {}).get("module"):
+            try:
+                settings = tool.get("settings", {})
+                mod = import_module(settings.pop("module"))
+                tkitclass = getattr(mod, settings.pop("class"))
+                toolkit = tkitclass.get_toolkit(**tool["settings"])
+                tools.extend(toolkit.get_tools())
+            except Exception as e:
+                logger.error(f"Error in getting custom toolkit: {e}")
+                
+        else:
+            # Tool not available or not found
+            if tool_type in FAILED_IMPORTS:
+                logger.warning(f"Tool '{tool_type}' is not available: {FAILED_IMPORTS[tool_type]}")
+            else:
+                logger.warning(f"Unknown tool type: {tool_type}")
+                
+    return tools
+
+def get_toolkits():
+    """Return toolkit configurations for all successfully imported toolkits."""
+    toolkit_configs = []
+    
+    for toolkit_name, toolkit_class in AVAILABLE_TOOLKITS.items():
+        try:
+            if hasattr(toolkit_class, 'toolkit_config_schema'):
+                toolkit_configs.append(toolkit_class.toolkit_config_schema())
+            else:
+                logger.debug(f"Toolkit {toolkit_name} does not have toolkit_config_schema method")
+        except Exception as e:
+            logger.error(f"Error getting config schema for {toolkit_name}: {e}")
+    
+    logger.info(f"Successfully loaded {len(toolkit_configs)} toolkit configurations")
+    return toolkit_configs
+
+def get_available_tools():
+    """Return list of available tool types."""
+    return list(AVAILABLE_TOOLS.keys())
+
+def get_failed_imports():
+    """Return dictionary of failed imports and their error messages."""
+    return FAILED_IMPORTS.copy()
+
+def get_available_toolkits():
+    """Return list of available toolkit class names."""
+    return list(AVAILABLE_TOOLKITS.keys())
+
+def diagnose_imports():
+    """Print diagnostic information about tool imports."""
+    available_count = len(AVAILABLE_TOOLS)
+    failed_count = len(FAILED_IMPORTS)
+    total_count = available_count + failed_count
+    
+    print(f"=== Tool Import Diagnostic ===")
+    print(f"Total tools: {total_count}")
+    print(f"Successfully imported: {available_count}")
+    print(f"Failed imports: {failed_count}")
+    print(f"Success rate: {(available_count/total_count*100):.1f}%")
+    
+    if AVAILABLE_TOOLS:
+        print(f"\n✅ Available tools ({len(AVAILABLE_TOOLS)}):")
+        for tool_name in sorted(AVAILABLE_TOOLS.keys()):
+            functions = []
+            if 'get_tools' in AVAILABLE_TOOLS[tool_name]:
+                functions.append('get_tools')
+            if 'toolkit_class' in AVAILABLE_TOOLS[tool_name]:
+                functions.append('toolkit')
+            print(f"  - {tool_name}: {', '.join(functions)}")
+    
+    if FAILED_IMPORTS:
+        print(f"\n❌ Failed imports ({len(FAILED_IMPORTS)}):")
+        for tool_name, error in FAILED_IMPORTS.items():
+            print(f"  - {tool_name}: {error}")
+    
+    if AVAILABLE_TOOLKITS:
+        print(f"\n🔧 Available toolkits ({len(AVAILABLE_TOOLKITS)}):")
+        for toolkit_name in sorted(AVAILABLE_TOOLKITS.keys()):
+            print(f"  - {toolkit_name}")
+
+# Export useful functions
+__all__ = [
+    'get_tools',
+    'get_toolkits',
+    'get_available_tools',
+    'get_failed_imports', 
+    'get_available_toolkits',
+    'diagnose_imports'
+]

{alita_sdk-0.3.150 → alita_sdk-0.3.151}/alita_sdk/tools/memory/__init__.py

@@ -2,7 +2,15 @@ from typing import Optional, List
 
 from langchain_core.tools import BaseToolkit, BaseTool
 from langgraph.store.postgres import PostgresStore
-from langmem import create_manage_memory_tool, create_search_memory_tool
+try:
+    from langmem import create_manage_memory_tool, create_search_memory_tool
+except ImportError:
+    # langmem is optional; define stubs to avoid import errors
+    def create_manage_memory_tool(*args, **kwargs):  # pragma: no cover
+        raise ImportError("langmem is required for MemoryToolkit")
+
+    def create_search_memory_tool(*args, **kwargs):  # pragma: no cover
+        raise ImportError("langmem is required for MemoryToolkit")
 from pydantic import create_model, BaseModel, ConfigDict, Field, SecretStr
 
 name = "memory"

alita_sdk-0.3.151/alita_sdk/tools/postman/__init__.py

@@ -0,0 +1,103 @@
+from typing import List, Literal, Optional, Type
+
+import requests
+from langchain_core.tools import BaseToolkit, BaseTool
+from pydantic import create_model, BaseModel, ConfigDict, Field, SecretStr, field_validator
+from ..base.tool import BaseAction
+
+from .api_wrapper import PostmanApiWrapper
+from ..utils import clean_string, get_max_toolkit_length, TOOLKIT_SPLITTER, check_connection_response
+
+name = "postman"
+
+class PostmanAction(BaseAction):
+    """Tool for interacting with the Postman API."""
+
+    api_wrapper: PostmanApiWrapper = Field(default_factory=PostmanApiWrapper)
+    name: str
+    mode: str = ""
+    description: str = ""
+    args_schema: Optional[Type[BaseModel]] = None
+
+    @field_validator('name', mode='before')
+    @classmethod
+    def remove_spaces(cls, v):
+        return v.replace(' ', '')
+
+def get_tools(tool):
+    toolkit = PostmanToolkit.get_toolkit(
+        selected_tools=tool['settings'].get('selected_tools', []),
+        api_key=tool['settings'].get('api_key', None),
+        base_url=tool['settings'].get(
+            'base_url', 'https://api.getpostman.com'),
+        collection_id=tool['settings'].get('collection_id', None),
+        workspace_id=tool['settings'].get('workspace_id', None),
+        toolkit_name=tool.get('toolkit_name')
+    )
+    return toolkit.tools
+
+
+class PostmanToolkit(BaseToolkit):
+    tools: List[BaseTool] = []
+    toolkit_max_length: int = 0
+
+    @staticmethod
+    def toolkit_config_schema() -> BaseModel:
+        selected_tools = {x['name']: x['args_schema'].schema(
+        ) for x in PostmanApiWrapper.model_construct().get_available_tools()}
+        PostmanToolkit.toolkit_max_length = get_max_toolkit_length(
+            selected_tools)
+        m = create_model(
+            name,
+            api_key=(SecretStr, Field(description="Postman API key",
+                     json_schema_extra={'secret': True, 'configuration': True})),
+            base_url=(str, Field(description="Postman API base URL",
+                      default="https://api.getpostman.com", json_schema_extra={'configuration': True})),
+            collection_id=(str, Field(description="Default collection ID", json_schema_extra={
+                           'toolkit_name': True, 'max_toolkit_length': PostmanToolkit.toolkit_max_length})),
+            workspace_id=(str, Field(description="Default workspace ID",
+                          default="", json_schema_extra={'configuration': True})),
+            selected_tools=(List[Literal[tuple(selected_tools)]], Field(
+                default=[], json_schema_extra={'args_schemas': selected_tools})),
+            __config__=ConfigDict(json_schema_extra={'metadata': {
+                                  "label": "Elitea Postman", "icon_url": "postman.svg"}})
+        )
+
+        @check_connection_response
+        def check_connection(self):
+            response = requests.get(
+                f'{self.base_url}/collections',
+                headers={
+                    'X-API-Key': self.api_key.get_secret_value(),
+                    'Content-Type': 'application/json'
+                },
+                timeout=5
+            )
+            return response
+        m.check_connection = check_connection
+        return m
+
+    @classmethod
+    def get_toolkit(cls, selected_tools: list[str] | None = None, toolkit_name: Optional[str] = None, **kwargs):
+        if selected_tools is None:
+            selected_tools = []
+        postman_api_wrapper = PostmanApiWrapper(**kwargs)
+        prefix = clean_string(str(toolkit_name), cls.toolkit_max_length) + \
+            TOOLKIT_SPLITTER if toolkit_name else ''
+        available_tools = postman_api_wrapper.get_available_tools()
+        tools = []
+        for tool in available_tools:
+            if selected_tools:
+                if tool["name"] not in selected_tools:
+                    continue
+            tools.append(PostmanAction(
+                api_wrapper=postman_api_wrapper,
+                name=prefix + tool["name"],
+                mode=tool["mode"],
+                description=f"{tool['description']}\nAPI URL: {postman_api_wrapper.base_url}",
+                args_schema=tool["args_schema"]
+            ))
+        return cls(tools=tools)
+
+    def get_tools(self):
+        return self.tools