alita-sdk 0.3.162__py3-none-any.whl → 0.3.164__py3-none-any.whl

alita_sdk/tools/carrier/update_ui_test_schedule_tool.py

@@ -0,0 +1,278 @@
+import logging
+import json
+import traceback
+import re
+from typing import Type
+from langchain_core.tools import BaseTool, ToolException
+from pydantic.fields import Field
+from pydantic import create_model, BaseModel
+from .api_wrapper import CarrierAPIWrapper
+
+
+logger = logging.getLogger(__name__)
+
+
+class UpdateUITestScheduleTool(BaseTool):
+    api_wrapper: CarrierAPIWrapper = Field(..., description="Carrier API Wrapper instance")
+    name: str = "update_ui_test_schedule"
+    description: str = ("Update UI test schedule on the Carrier platform. Use this tool when user wants to update, modify, or change a UI test schedule. "
+                        "Provide test_id, schedule_name, and cron_timer, or leave empty to see available tests.")
+    args_schema: Type[BaseModel] = create_model(
+        "UpdateUITestScheduleInput",
+        test_id=(str, Field(default="", description="Test ID to update schedule for")),
+        schedule_name=(str, Field(default="", description="Name for the new schedule")),
+        cron_timer=(str, Field(default="", description="Cron expression for schedule timing (e.g., '0 2 * * *')")),
+    )
+    
+    def _run(self, test_id: str = "", schedule_name: str = "", cron_timer: str = ""):
+        try:
+            # Check if no parameters provided - show available tests
+            if (not test_id or test_id.strip() == "") and (not schedule_name or schedule_name.strip() == "") and (not cron_timer or cron_timer.strip() == ""):
+                return self._show_available_tests_and_instructions()
+            
+            # Check if test_id is missing but other params provided
+            if (not test_id or test_id.strip() == ""):
+                return self._show_missing_test_id_message()
+            
+            # Check if schedule_name or cron_timer is missing
+            if (not schedule_name or schedule_name.strip() == "") or (not cron_timer or cron_timer.strip() == ""):
+                return self._show_missing_parameters_message(test_id, schedule_name, cron_timer)
+            
+            # Validate cron timer format
+            if not self._validate_cron_timer(cron_timer):
+                return self._show_invalid_cron_message(cron_timer)
+            
+            # Get UI tests list to verify test exists
+            ui_tests = self.api_wrapper.get_ui_tests_list()
+            test_data = None
+            test_id_int = None
+            
+            # Try to find test by ID
+            if test_id.isdigit():
+                test_id_int = int(test_id)
+                for test in ui_tests:
+                    if test.get("id") == test_id_int:
+                        test_data = test
+                        break
+            
+            if not test_data:
+                available_tests = []
+                for test in ui_tests:
+                    available_tests.append(f"ID: {test.get('id')}, Name: {test.get('name')}")
+                
+                return f"❌ **Test not found for ID: {test_id}**\n\n**Available UI tests:**\n" + "\n".join([f"- {test}" for test in available_tests])
+            
+            # Get detailed test configuration
+            test_details = self.api_wrapper.get_ui_test_details(str(test_id_int))
+            
+            if not test_details:
+                return f"❌ **Could not retrieve test details for test ID {test_id_int}.**"
+            
+            # Parse and update the test configuration
+            updated_config = self._parse_and_update_test_data(test_details, schedule_name, cron_timer)
+            
+            # Execute the PUT request to update the test
+            result = self.api_wrapper.update_ui_test(str(test_id_int), updated_config)
+            
+            return self._format_success_message(test_data.get('name', 'Unknown'), test_id_int, schedule_name, cron_timer)
+            
+        except Exception:
+            stacktrace = traceback.format_exc()
+            logger.error(f"Error updating UI test schedule: {stacktrace}")
+            raise ToolException(stacktrace)
+    
+    def _show_available_tests_and_instructions(self):
+        """Show available tests and instructions when no parameters provided."""
+        try:
+            ui_tests = self.api_wrapper.get_ui_tests_list()
+            
+            if not ui_tests:
+                return "❌ **No UI tests found.**"
+            
+            message = ["# 📋 Update UI Test Schedule\n"]
+            message.append("## Available UI Tests:")
+            
+            for test in ui_tests:
+                message.append(f"- **ID: {test.get('id')}**, Name: `{test.get('name')}`, Runner: `{test.get('runner')}`")
+            
+            message.append("\n## 📝 Instructions:")
+            message.append("For updating UI test schedule, please provide me:")
+            message.append("- **`test_id`** - The ID of the test you want to update")
+            message.append("- **`schedule_name`** - A name for your new schedule")
+            message.append("- **`cron_timer`** - Cron expression for timing (e.g., `0 2 * * *` for daily at 2 AM)")
+            
+            message.append("\n## 💡 Example:")
+            message.append("```")
+            message.append("test_id: 42")
+            message.append("schedule_name: Daily Morning Test")
+            message.append("cron_timer: 0 2 * * *")
+            message.append("```")
+            
+            return "\n".join(message)
+            
+        except Exception:
+            stacktrace = traceback.format_exc()
+            logger.error(f"Error fetching UI tests list: {stacktrace}")
+            raise ToolException(stacktrace)
+    
+    def _show_missing_test_id_message(self):
+        """Show message when test_id is missing."""
+        return """# ❌ Missing Test ID
+
+**For updating UI test schedule, please provide me:**
+- **`test_id`** - The ID of the test you want to update  
+- **`schedule_name`** - A name for your new schedule
+- **`cron_timer`** - Cron expression for timing
+
+Use the tool without parameters to see available tests."""
+    
+    def _show_missing_parameters_message(self, test_id: str, schedule_name: str, cron_timer: str):
+        """Show message when some parameters are missing."""
+        missing = []
+        if not schedule_name or schedule_name.strip() == "":
+            missing.append("**`schedule_name`**")
+        if not cron_timer or cron_timer.strip() == "":
+            missing.append("**`cron_timer`**")
+        
+        message = [f"# ❌ Missing Parameters for Test ID: {test_id}\n"]
+        message.append("**Missing parameters:**")
+        for param in missing:
+            message.append(f"- {param}")
+        
+        message.append("\n**For updating UI test schedule, please provide:**")
+        message.append("- **`test_id`** ✅ (provided)")
+        message.append("- **`schedule_name`** - A name for your new schedule")
+        message.append("- **`cron_timer`** - Cron expression for timing (e.g., `0 2 * * *`)")
+        
+        return "\n".join(message)
+    
+    def _validate_cron_timer(self, cron_timer: str) -> bool:
+        """Validate cron timer format."""
+        # Basic cron validation - should have 5 parts separated by spaces
+        parts = cron_timer.strip().split()
+        if len(parts) != 5:
+            return False
+        
+        # Each part should contain only digits, *, /, -, or ,
+        cron_pattern = re.compile(r'^[0-9*,/-]+$')
+        return all(cron_pattern.match(part) for part in parts)
+    
+    def _show_invalid_cron_message(self, cron_timer: str):
+        """Show message for invalid cron timer."""
+        return f"""# ❌ Invalid Cron Timer Format
+
+**Provided:** `{cron_timer}`
+
+**Cron format should be:** `minute hour day month weekday`
+
+## Valid Examples:
+- `0 2 * * *` - Daily at 2:00 AM
+- `30 14 * * 1` - Every Monday at 2:30 PM  
+- `0 */6 * * *` - Every 6 hours
+- `15 10 1 * *` - First day of every month at 10:15 AM
+- `0 9 * * 1-5` - Weekdays at 9:00 AM
+
+## Format Rules:
+- **Minute:** 0-59
+- **Hour:** 0-23
+- **Day:** 1-31
+- **Month:** 1-12
+- **Weekday:** 0-7 (0 and 7 are Sunday)
+- Use **`*`** for "any value"
+- Use **`,`** for multiple values
+- Use **`-`** for ranges
+- Use **`/`** for step values"""
+    
+    def _parse_and_update_test_data(self, get_data: dict, schedule_name: str, cron_timer: str) -> dict:
+        """Parse GET response data and transform it into the required format for PUT request."""
+        
+        # Extract environment and test type from test parameters
+        env_type = ""
+        test_type = ""
+        for param in get_data.get("test_parameters", []):
+            if param.get("name") == "env_type":
+                env_type = param.get("default", "")
+            elif param.get("name") == "test_type":
+                test_type = param.get("default", "")
+        
+        # Construct common_params from GET data
+        common_params = {
+            "aggregation": get_data.get("aggregation", "max"),
+            "cc_env_vars": get_data.get("cc_env_vars", {}),
+            "entrypoint": get_data.get("entrypoint", ""),
+            "env_type": env_type,
+            "env_vars": get_data.get("env_vars", {}),
+            "location": get_data.get("location", ""),
+            "loops": get_data.get("loops", 1),
+            "name": get_data.get("name", ""),
+            "parallel_runners": get_data.get("parallel_runners", 1),
+            "runner": get_data.get("runner", ""),
+            "source": get_data.get("source", {}),
+            "test_type": test_type
+        }
+        
+        # Extract only required integrations (reporters and system)
+        integrations = {
+            "reporters": get_data.get("integrations", {}).get("reporters", {}),
+            "system": get_data.get("integrations", {}).get("system", {})
+        }
+        
+        # Process existing schedules and add the new one
+        schedules = []
+        
+        # Keep existing schedules
+        for schedule in get_data.get("schedules", []):
+            existing_schedule = {
+                "active": schedule.get("active", False),
+                "cron": schedule.get("cron", ""),
+                "cron_radio": "custom",
+                "errors": {},
+                "id": schedule.get("id"),
+                "name": schedule.get("name", ""),
+                "project_id": schedule.get("project_id"),
+                "rpc_kwargs": schedule.get("rpc_kwargs"),
+                "test_id": schedule.get("test_id"),
+                "test_params": schedule.get("test_params", [])
+            }
+            schedules.append(existing_schedule)
+        
+        # Add the new schedule
+        new_schedule = {
+            "active": True,
+            "cron": cron_timer,
+            "cron_radio": "custom",
+            "errors": {},
+            "id": None,  # New schedule, no ID yet
+            "name": schedule_name,
+            "test_params": []
+        }
+        schedules.append(new_schedule)
+        
+        # Assemble the final PUT request data
+        put_data = {
+            "common_params": common_params,
+            "integrations": integrations,
+            "run_test": False,
+            "schedules": schedules,
+            "test_parameters": []  # Empty as required in PUT request
+        }
+        
+        return put_data
+    
+    def _format_success_message(self, test_name: str, test_id: int, schedule_name: str, cron_timer: str) -> str:
+        """Format success message in markdown."""
+        return f"""# ✅ UI Test Schedule Updated Successfully!
+
+## Test Information:
+- **Test Name:** `{test_name}`
+- **Test ID:** `{test_id}`
+
+## New Schedule Added:
+- **Schedule Name:** `{schedule_name}`
+- **Cron Timer:** `{cron_timer}`
+- **Status:** Active ✅
+
+## 🎯 What happens next:
+The test will now run automatically according to the specified schedule. You can view and manage schedules in the Carrier platform UI.
+
+**Schedule will execute:** Based on cron expression `{cron_timer}`"""

alita_sdk/tools/memory/__init__.py

@@ -15,6 +15,13 @@ from pydantic import create_model, BaseModel, ConfigDict, Field, SecretStr
 
 name = "memory"
 
+def get_tools(tool):
+    return MemoryToolkit().get_toolkit(
+        namespace=tool['settings'].get('namespace', str(tool['id'])),
+        store=tool['settings'].get('store', None),
+        toolkit_name=tool.get('toolkit_name', '')
+).get_tools()
+
 class MemoryToolkit(BaseToolkit):
     tools: List[BaseTool] = []
 

alita_sdk/tools/postman/__init__.py

@@ -1,4 +1,5 @@
 from typing import List, Literal, Optional, Type
+import json
 
 import requests
 from langchain_core.tools import BaseToolkit, BaseTool
@@ -25,6 +26,8 @@ class PostmanAction(BaseAction):
         return v.replace(' ', '')
 
 def get_tools(tool):
+    # Parse environment_config if it's a string (from UI)
+    environment_config = tool['settings'].get('environment_config', {})
     toolkit = PostmanToolkit.get_toolkit(
         selected_tools=tool['settings'].get('selected_tools', []),
         api_key=tool['settings'].get('api_key', None),
@@ -32,6 +35,7 @@ def get_tools(tool):
             'base_url', 'https://api.getpostman.com'),
         collection_id=tool['settings'].get('collection_id', None),
         workspace_id=tool['settings'].get('workspace_id', None),
+        environment_config=environment_config,
         toolkit_name=tool.get('toolkit_name')
     )
     return toolkit.tools
@@ -57,6 +61,9 @@ class PostmanToolkit(BaseToolkit):
                            'toolkit_name': True, 'max_toolkit_length': PostmanToolkit.toolkit_max_length})),
             workspace_id=(str, Field(description="Default workspace ID",
                           default="", json_schema_extra={'configuration': True})),
+            environment_config=(dict, Field(
+                description="JSON configuration for request execution (auth headers, project IDs, base URLs, etc.)",
+                default={})),
             selected_tools=(List[Literal[tuple(selected_tools)]], Field(
                 default=[], json_schema_extra={'args_schemas': selected_tools})),
             __config__=ConfigDict(json_schema_extra={'metadata': {