alita-sdk 0.3.516__py3-none-any.whl → 0.3.522__py3-none-any.whl

alita_sdk/runtime/langchain/assistant.py

@@ -278,6 +278,7 @@ class Assistant:
             prompt_instructions = self.prompt
         
         # Add tool binding only if tools are present
+        tool_names = []
         if simple_tools:
             tool_names = [tool.name for tool in simple_tools]
             logger.info("Binding tools: %s", tool_names)
@@ -290,8 +291,8 @@ class Assistant:
         plan_addon = PLAN_ADDON if 'update_plan' in tool_names else ""
         pyodite_addon = PYODITE_ADDON if 'pyodide_sandbox' in tool_names else ""
         escaped_prompt = DEFAULT_ASSISTANT.format(
-            user_addon=user_addon,
-            plan_addon=plan_addon,
+            users_instructions=user_addon,
+            planning_instructions=plan_addon,
             pyodite_addon=pyodite_addon
         )
             

alita_sdk/runtime/langchain/constants.py

@@ -345,14 +345,136 @@ PYODITE_ADDON = """
 
 ## Using the Python (Pyodide) sandbox
 
-Python sandbox is available, it runs in a **Pyodide (browser-based) environment** with limitations:
+Python sandbox available via `pyodide_sandbox` (stateless) or `stateful_pyodide_sandbox` tools.
+
+### Use for:
+- Lightweight data analysis, parsing, validation
+- Testing algorithms and calculations
+- Processing standard library modules
+
+### Limitations:
+- No local filesystem access (beyond sandbox cache)
+- No OS commands or subprocess operations
+- No native C extensions
+- No background processes
+
+### CRITICAL: How to return results
+
+The sandbox returns a dict with these keys:
+- **`result`**: The last evaluated expression (final line without assignment)
+- **`output`**: Anything printed via `print()`
+- **`error`**: Any stderr output
+- **`execution_info`**: Timing and package info
+
+**Two valid patterns to return data:**
+
+✅ Option 1 - Last expression (returned in `result` key):
+```python
+import json
+data = {"result": 42, "status": "complete"}
+data  # Auto-captured as result
+```
+
+✅ Option 2 - Print output (returned in `output` key):
+```python
+import json
+data = {"result": 42, "status": "complete"}
+print(json.dumps(data))  # Captured as output
+```
+
+Both work! Choose based on preference. For structured data, JSON format is recommended.
+
+### Using alita_client (auto-injected)
+
+The `alita_client` object is automatically available in sandbox code. It provides access to Alita platform APIs.
+
+**Key capabilities:**
+
+**Artifacts** - Store/retrieve files in buckets:
+```python
+# Get artifact from bucket and decode
+csv_data = alita_client.artifact('my_bucket').get('file.csv').decode('utf-8')
+
+# Create/overwrite artifact
+alita_client.artifact('my_bucket').create('output.txt', 'data content')
+
+# List artifacts in bucket
+files = alita_client.artifact('my_bucket').list()
+
+# Append to artifact
+alita_client.artifact('my_bucket').append('log.txt', 'new line\\n')
+
+# Delete artifact
+alita_client.artifact('my_bucket').delete('old_file.txt')
+```
+
+**Secrets** - Access stored credentials:
+```python
+api_key = alita_client.unsecret('my_api_key')
+```
+
+**MCP Tools** - Call Model Context Protocol tools:
+```python
+# List available tools
+tools = alita_client.get_mcp_toolkits()
+
+# Call a tool
+result = alita_client.mcp_tool_call({
+    'server_name': 'my_server',
+    'params': {
+        'name': 'tool_name',
+        'arguments': {'arg1': 'value1'}
+    }
+})
+```
+
+**Toolkits** - Instantiate and use toolkits:
+```python
+toolkit = alita_client.toolkit(toolkit_id=123)
+```
+
+**Applications** - Get app details:
+```python
+apps = alita_client.get_list_of_apps()
+app_details = alita_client.get_app_details(application_id=456)
+```
+
+**Image Generation**:
+```python
+result = alita_client.generate_image(
+    prompt="A sunset over mountains",
+    n=1,
+    size="1024x1024"
+)
+```
+
+**Common pattern - Load CSV from artifacts:**
+```python
+import csv
+from io import StringIO
+
+# Load CSV from artifact
+csv_text = alita_client.artifact('tests').get('data.csv').decode('utf-8')
+
+# Parse CSV
+reader = csv.DictReader(StringIO(csv_text))
+data = list(reader)
+
+# Return result
+data
+```
+
+### Execution modes:
+- **Stateless** (default): Faster, each run starts fresh
+- **Stateful**: Preserves variables/imports between calls
 
-- Use it only for lightweight data analysis, parsing, transformation, or validation
-- Do not assume access to the local filesystem, network, OS commands, or background processes
-- Do not attempt `pip install` or rely on unavailable native extensions
-- Treat all inputs as in-memory data provided by the harness or previous tool outputs
-- For large datasets, long-running tasks, or environment-dependent execution, request an external tool or user-provided artifacts instead
+### Code requirements:
+1. Always include necessary imports
+2. Either end with an expression OR use `print()` for output
+3. Work with in-memory data only
+4. Include error handling with try-except
 
-If a task cannot be reliably executed in Pyodide, explicitly state the limitation and propose an alternative approach.
+### When NOT to use:
+For large datasets, long-running tasks, or native system access, request alternative tools instead.
 
 """

alita_sdk/runtime/toolkits/application.py

@@ -22,7 +22,8 @@ class ApplicationToolkit(BaseToolkit):
     
     @classmethod
     def get_toolkit(cls, client: 'AlitaClient', application_id: int, application_version_id: int,
-                    selected_tools: list[str] = [], store: Optional[BaseStore] = None):
+                    selected_tools: list[str] = [], store: Optional[BaseStore] = None,
+                    ignored_mcp_servers: Optional[list] = None):
         
         app_details = client.get_app_details(application_id)
         version_details = client.get_app_version_details(application_id, application_version_id)
@@ -34,7 +35,8 @@ class ApplicationToolkit(BaseToolkit):
 
         app = client.application(application_id, application_version_id, store=store, 
                                  llm=client.get_llm(version_details['llm_settings']['model_name'], 
-                                                    model_settings))
+                                                    model_settings),
+                                 ignored_mcp_servers=ignored_mcp_servers)
         return cls(tools=[Application(name=app_details.get("name"), 
                                       description=app_details.get("description"), 
                                       application=app, 
@@ -46,6 +48,7 @@ class ApplicationToolkit(BaseToolkit):
                                           "application_version_id": application_version_id,
                                           "store": store,
                                           "llm": client.get_llm(version_details['llm_settings']['model_name'], model_settings),
+                                          "ignored_mcp_servers": ignored_mcp_servers,
                                       })])
             
     def get_tools(self):

alita_sdk/runtime/toolkits/tools.py

@@ -59,7 +59,8 @@ def get_tools(tools_list: list, alita_client=None, llm=None, memory_store: BaseS
                     alita_client,
                     application_id=int(tool['settings']['application_id']),
                     application_version_id=int(tool['settings']['application_version_id']),
-                    selected_tools=[]
+                    selected_tools=[],
+                    ignored_mcp_servers=ignored_mcp_servers
                 ).get_tools())
                 # backward compatibility for pipeline application type as subgraph node
                 if tool.get('agent_type', '') == 'pipeline':

alita_sdk/tools/testrail/api_wrapper.py

@@ -697,7 +697,7 @@ class TestrailAPIWrapper(NonCodeIndexerToolkit):
                 'id': str(case.get('id', '')),
                 IndexerKeywords.UPDATED_ON.value: case.get('updated_on') or -1,
                 'labels': [lbl['title'] for lbl in case.get('labels', [])],
-                'type': case.get('type_id') or -1,
+                'type': "testrail_test_case",
                 'priority': case.get('priority_id') or -1,
                 'milestone': case.get('milestone_id') or -1,
                 'estimate': case.get('estimate') or '',

{alita_sdk-0.3.516.dist-info → alita_sdk-0.3.522.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alita_sdk
-Version: 0.3.516
+Version: 0.3.522
 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 <lifedj27@gmail.com>, Artem Dubrovskiy <ad13box@gmail.com>
 License-Expression: Apache-2.0

{alita_sdk-0.3.516.dist-info → alita_sdk-0.3.522.dist-info}/RECORD

@@ -100,9 +100,9 @@ alita_sdk/runtime/clients/mcp_manager.py,sha256=DRbqiO761l7UgOdv_keHbD2g0oZodtPH
 alita_sdk/runtime/clients/prompt.py,sha256=li1RG9eBwgNK_Qf0qUaZ8QNTmsncFrAL2pv3kbxZRZg,1447
 alita_sdk/runtime/clients/sandbox_client.py,sha256=4GLoCFZXtTYKM3SFMJAfFO7QNE38c1V7DI1b88uOySY,17227
 alita_sdk/runtime/langchain/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-alita_sdk/runtime/langchain/assistant.py,sha256=-w7gfBlpW27q4O8jF1ba9qaQnprPGynNRcsnAYynOYc,18404
+alita_sdk/runtime/langchain/assistant.py,sha256=yVTosONjQYUHbzhtTWG53odpXbWCQLLe18oaqniqvx8,18447
 alita_sdk/runtime/langchain/chat_message_template.py,sha256=kPz8W2BG6IMyITFDA5oeb5BxVRkHEVZhuiGl4MBZKdc,2176
-alita_sdk/runtime/langchain/constants.py,sha256=h6FBMOLT-vDuDI-s49sd4LUi5qwFJwYq1Ysptltiy8Y,14427
+alita_sdk/runtime/langchain/constants.py,sha256=tbVA-OPRDzEMspO9raOj_jb57Yt-TUYulG6FOXCmu78,17150
 alita_sdk/runtime/langchain/indexer.py,sha256=0ENHy5EOhThnAiYFc7QAsaTNp9rr8hDV_hTK8ahbatk,37592
 alita_sdk/runtime/langchain/langraph_agent.py,sha256=4rWJ6tQXIzVHgF9zzDL3kiR67rvBAxrJxpglJ6Z_2w0,59364
 alita_sdk/runtime/langchain/mixedAgentParser.py,sha256=M256lvtsL3YtYflBCEp-rWKrKtcY1dJIyRGVv7KW9ME,2611
@@ -157,7 +157,7 @@ alita_sdk/runtime/llms/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3
 alita_sdk/runtime/llms/preloaded.py,sha256=tZ_-nIV91cjgdNV5xw5cIlvia9CYUG94PTsoNRmTF-I,11223
 alita_sdk/runtime/models/mcp_models.py,sha256=rbWCAtF8Jjb7uNgQHhVWyDttXaqPNbRLL087Lf0AjNU,2301
 alita_sdk/runtime/toolkits/__init__.py,sha256=7bic6YGLiyAwFD3KZvrntWqS57sND72VoGBhuAx75yI,692
-alita_sdk/runtime/toolkits/application.py,sha256=EyYdGTJzsqz6pV3XAywy8BR2kYU6QNRar7QcC9-WGSI,2714
+alita_sdk/runtime/toolkits/application.py,sha256=iHs6PzNIbwalDtSP2LuIsqiWGxQSFI2pubKXIFGPB8k,2938
 alita_sdk/runtime/toolkits/artifact.py,sha256=_m7Ppwc04cpL0RPU_5ZHXFjBIWLeylv1if-H16OvF-o,3737
 alita_sdk/runtime/toolkits/configurations.py,sha256=kIDAlnryPQfbZyFxV-9SzN2-Vefzx06TX1BBdIIpN90,141
 alita_sdk/runtime/toolkits/datasource.py,sha256=ZNPCAAZKy90u_5CKkr6fi7gaLuao2KOIV8spGjb-AbA,2926
@@ -165,7 +165,7 @@ alita_sdk/runtime/toolkits/mcp.py,sha256=4KOobcuCUsZGza1CJ0EUdYRTL9v4pJwM2Joswxi
 alita_sdk/runtime/toolkits/planning.py,sha256=6i83WDkjRs-b8UNlDub44NHzUFUgTVuxQ_IHSuHI85U,7433
 alita_sdk/runtime/toolkits/prompt.py,sha256=WIpTkkVYWqIqOWR_LlSWz3ug8uO9tm5jJ7aZYdiGRn0,1192
 alita_sdk/runtime/toolkits/subgraph.py,sha256=wwUK8JjPXkGzyVZ3tAukmvST6eGbqx_U11rpnmbrvtg,2105
-alita_sdk/runtime/toolkits/tools.py,sha256=MGhyp5K5fRKCa4g2qorIfM_xHngDQZjltHYDtjXH_PI,17586
+alita_sdk/runtime/toolkits/tools.py,sha256=WjoszaL2o-w_8vy0JkulXc02HP_vNdvl-CWwWTkkYO8,17647
 alita_sdk/runtime/toolkits/vectorstore.py,sha256=H-HQsHhLm-vQWS3kvwkh-OHrOWKuylBXcSH9cQo5jKM,3282
 alita_sdk/runtime/tools/__init__.py,sha256=Fx7iHqkzA90-KfjdcUUzMUI_7kDarjuTsSpSzOW2pN0,568
 alita_sdk/runtime/tools/agent.py,sha256=m98QxOHwnCRTT9j18Olbb5UPS8-ZGeQaGiUyZJSyFck,3162
@@ -401,7 +401,7 @@ alita_sdk/tools/sql/models.py,sha256=AKJgSl_kEEz4fZfw3kbvdGHXaRZ-yiaqfJOB6YOj3i0
 alita_sdk/tools/testio/__init__.py,sha256=KttkGmwKRlY5OG6kr_ZTrMXECpea-61B4w3Z5zlDtB4,2904
 alita_sdk/tools/testio/api_wrapper.py,sha256=BvmL5h634BzG6p7ajnQLmj-uoAw1gjWnd4FHHu1h--Q,21638
 alita_sdk/tools/testrail/__init__.py,sha256=oyw1bmITlfb1cusInMpc-Nuh0XwKV7yxjmW6veXr_n4,4561
-alita_sdk/tools/testrail/api_wrapper.py,sha256=tQcGlFJmftvs5ZiO4tsP19fCo4CrJeq_UEvQR1liVfE,39891
+alita_sdk/tools/testrail/api_wrapper.py,sha256=XycH0iEH2cCAv7InJotmsGE9lPj6hP45Za1d2jSQ_Lg,39886
 alita_sdk/tools/utils/__init__.py,sha256=Bt1TsxkQIezgkxCgn5wFIOMsTsW5vEoWdM6KznodktU,4027
 alita_sdk/tools/utils/available_tools_decorator.py,sha256=IbrdfeQkswxUFgvvN7-dyLMZMyXLiwvX7kgi3phciCk,273
 alita_sdk/tools/utils/content_parser.py,sha256=KqiZzsurLspxCLemf9eqYhgW266FgWP4r-xElcK8a38,15881
@@ -427,9 +427,9 @@ alita_sdk/tools/zephyr_scale/api_wrapper.py,sha256=kT0TbmMvuKhDUZc0i7KO18O38JM9S
 alita_sdk/tools/zephyr_squad/__init__.py,sha256=gZTEanHf9pRCiZaKobF4Wbm33wUxxXoIjOr544TcXas,2903
 alita_sdk/tools/zephyr_squad/api_wrapper.py,sha256=kmw_xol8YIYFplBLWTqP_VKPRhL_1ItDD0_vXTe_UuI,14906
 alita_sdk/tools/zephyr_squad/zephyr_squad_cloud_client.py,sha256=R371waHsms4sllHCbijKYs90C-9Yu0sSR3N4SUfQOgU,5066
-alita_sdk-0.3.516.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-alita_sdk-0.3.516.dist-info/METADATA,sha256=ig9rddgKLhojWxyfHNUX9PjKHzJLJ9YNJStMSdNiAz4,24266
-alita_sdk-0.3.516.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-alita_sdk-0.3.516.dist-info/entry_points.txt,sha256=VijN0h4alp1WXm8tfS3P7vuGxN4a5RZqHjXAoEIBZnI,49
-alita_sdk-0.3.516.dist-info/top_level.txt,sha256=0vJYy5p_jK6AwVb1aqXr7Kgqgk3WDtQ6t5C-XI9zkmg,10
-alita_sdk-0.3.516.dist-info/RECORD,,
+alita_sdk-0.3.522.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+alita_sdk-0.3.522.dist-info/METADATA,sha256=wfMuqtLZNiFVBOEI0aUg4OV61OhqNGmnpp5j4LNKxo8,24266
+alita_sdk-0.3.522.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+alita_sdk-0.3.522.dist-info/entry_points.txt,sha256=VijN0h4alp1WXm8tfS3P7vuGxN4a5RZqHjXAoEIBZnI,49
+alita_sdk-0.3.522.dist-info/top_level.txt,sha256=0vJYy5p_jK6AwVb1aqXr7Kgqgk3WDtQ6t5C-XI9zkmg,10
+alita_sdk-0.3.522.dist-info/RECORD,,