minitap-mobile-use 2.5.0__tar.gz → 2.5.2__tar.gz

{minitap_mobile_use-2.5.0 → minitap_mobile_use-2.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: minitap-mobile-use
-Version: 2.5.0
+Version: 2.5.2
 Summary: AI-powered multi-agent system that automates real Android and iOS devices through low-level control using LangGraph.
 Author: Pierre-Louis Favreau, Jean-Pierre Lo, Nicolas Dehandschoewercker
 License: MIT License

{minitap_mobile_use-2.5.0 → minitap_mobile_use-2.5.2}/minitap/mobile_use/clients/ios_client.py

@@ -14,7 +14,7 @@ def get_ios_devices() -> tuple[bool, list[str], str]:
         - list[str]: A list of iOS device UDIDs.
         - str: An error message if any.
     """
-    if platform.system() != "Linux":
+    if platform.system() != "Darwin":
         return False, [], "xcrun is only available on macOS."
 
     try:

{minitap_mobile_use-2.5.0 → minitap_mobile_use-2.5.2}/minitap/mobile_use/config.py

@@ -26,7 +26,7 @@ class Settings(BaseSettings):
     MINITAP_API_KEY: SecretStr | None = None
 
     OPENAI_BASE_URL: str | None = None
-    MINITAP_API_BASE_URL: str = "https://platform.minitap.ai"
+    MINITAP_BASE_URL: str = "https://platform.minitap.ai"
 
     DEVICE_SCREEN_API_BASE_URL: str | None = None
     DEVICE_HARDWARE_BRIDGE_BASE_URL: str | None = None
@@ -211,6 +211,33 @@ def get_default_llm_config() -> LLMConfig:
         )
 
 
+def get_default_minitap_llm_config() -> LLMConfig | None:
+    """
+    Returns a default LLM config using the Minitap provider.
+    Only returns a config if MINITAP_API_KEY is available.
+
+    Returns:
+        LLMConfig with minitap provider if API key is available, None otherwise
+    """
+    if not settings.MINITAP_API_KEY:
+        return None
+
+    return LLMConfig(
+        planner=LLM(provider="minitap", model="meta-llama/llama-4-scout"),
+        orchestrator=LLM(provider="minitap", model="openai/gpt-oss-120b"),
+        cortex=LLMWithFallback(
+            provider="minitap",
+            model="google/gemini-2.5-pro",
+            fallback=LLM(provider="minitap", model="openai/gpt-5"),
+        ),
+        executor=LLM(provider="minitap", model="meta-llama/llama-3.3-70b-instruct"),
+        utils=LLMConfigUtils(
+            outputter=LLM(provider="minitap", model="openai/gpt-4.1"),
+            hopper=LLM(provider="minitap", model="openai/gpt-5-nano"),
+        ),
+    )
+
+
 def deep_merge_llm_config(default: LLMConfig, override: dict) -> LLMConfig:
     def _deep_merge_dict(base: dict, extra: dict):
         for key, value in extra.items():

{minitap_mobile_use-2.5.0 → minitap_mobile_use-2.5.2}/minitap/mobile_use/sdk/agent.py

@@ -409,6 +409,21 @@ class Agent:
             self._finalize_tracing(task=task, context=context)
         return output
 
+    def is_healthy(self):
+        """
+        Check if the agent is healthy by verifying the streaming connection status.
+        Uses the configured Screen API base URL instead of hardcoding localhost.
+        """
+        try:
+            response = self._screen_api_client.get_with_retry("/streaming-status", timeout=2)
+            if response.status_code == 200:
+                data = response.json()
+                is_connected = data.get("is_streaming_connected", False)
+                return is_connected
+            return False
+        except Exception:
+            return False
+
     def clean(self, force: bool = False):
         if not self._initialized and not force:
             return

{minitap_mobile_use-2.5.0 → minitap_mobile_use-2.5.2}/minitap/mobile_use/sdk/builders/agent_config_builder.py

@@ -6,7 +6,7 @@ import copy
 
 from langchain_core.callbacks.base import Callbacks
 
-from minitap.mobile_use.config import get_default_llm_config
+from minitap.mobile_use.config import get_default_llm_config, get_default_minitap_llm_config
 from minitap.mobile_use.context import DevicePlatform
 from minitap.mobile_use.sdk.constants import (
     DEFAULT_HW_BRIDGE_BASE_URL,
@@ -187,9 +187,10 @@ class AgentConfigBuilder:
             if default_profile.name not in self._agent_profiles:
                 self.add_profile(default_profile)
         elif nb_profiles <= 0:
+            llm_config = get_default_minitap_llm_config() or get_default_llm_config()
             default_profile = AgentProfile(
                 name=DEFAULT_PROFILE_NAME,
-                llm_config=get_default_llm_config(),
+                llm_config=llm_config,
             )
             self.add_profile(default_profile)
         elif nb_profiles == 1:

{minitap_mobile_use-2.5.0 → minitap_mobile_use-2.5.2}/minitap/mobile_use/sdk/examples/platform_manual_task_example.py

@@ -31,7 +31,7 @@ async def main() -> None:
     Main execution function demonstrating manual task creation pattern.
 
     Visit https://platform.minitap.ai to get your API key.
-    Set MINITAP_API_KEY and MINITAP_API_BASE_URL environment variables.
+    Set MINITAP_API_KEY and MINITAP_BASE_URL environment variables.
     """
     agent = Agent()
     agent.init()

{minitap_mobile_use-2.5.0 → minitap_mobile_use-2.5.2}/minitap/mobile_use/sdk/examples/platform_minimal_example.py

@@ -28,7 +28,7 @@ async def main() -> None:
 
     Visit https://platform.minitap.ai to create a task, customize your profiles,
     and get your API key.
-    Set MINITAP_API_KEY and MINITAP_API_BASE_URL environment variables.
+    Set MINITAP_API_KEY and MINITAP_BASE_URL environment variables.
     """
     agent = Agent()
     agent.init()

{minitap_mobile_use-2.5.0 → minitap_mobile_use-2.5.2}/minitap/mobile_use/sdk/services/platform.py

@@ -37,7 +37,7 @@ DEFAULT_PROFILE = "default"
 
 class PlatformService:
     def __init__(self, api_key: str | None = None):
-        self._base_url = settings.MINITAP_API_BASE_URL
+        self._base_url = settings.MINITAP_BASE_URL
 
         if api_key:
             self._api_key = api_key

{minitap_mobile_use-2.5.0 → minitap_mobile_use-2.5.2}/minitap/mobile_use/servers/device_screen_api.py

@@ -8,21 +8,24 @@ import requests
 import uvicorn
 from fastapi import FastAPI, HTTPException
 from fastapi.responses import JSONResponse
+from sseclient import SSEClient
+
 from minitap.mobile_use.servers.config import server_settings
 from minitap.mobile_use.servers.utils import is_port_in_use
-from sseclient import SSEClient
 
 DEVICE_HARDWARE_BRIDGE_BASE_URL = server_settings.DEVICE_HARDWARE_BRIDGE_BASE_URL
 DEVICE_HARDWARE_BRIDGE_API_URL = f"{DEVICE_HARDWARE_BRIDGE_BASE_URL}/api"
 
 _latest_screen_data = None
+_is_streaming_connected = False
+
 _data_lock = threading.Lock()
 _stream_thread = None
 _stop_event = threading.Event()
 
 
 def _stream_worker():
-    global _latest_screen_data
+    global _latest_screen_data, _is_streaming_connected
     sse_url = f"{DEVICE_HARDWARE_BRIDGE_API_URL}/device-screen/sse"
     headers = {"Accept": "text/event-stream"}
 
@@ -31,6 +34,8 @@ def _stream_worker():
             with requests.get(sse_url, stream=True, headers=headers) as response:
                 response.raise_for_status()
                 print("--- Stream connected, listening for events... ---")
+                with _data_lock:
+                    _is_streaming_connected = True
                 event_source = (chunk for chunk in response.iter_content())
                 client = SSEClient(event_source)
                 for event in client.events():
@@ -59,10 +64,12 @@ def _stream_worker():
                                 "platform": platform,
                             }
 
-        except requests.exceptions.RequestException as e:
+        except Exception as e:
             print(f"Connection error in stream worker: {e}. Retrying in 2 seconds...")
             with _data_lock:
+                _is_streaming_connected = False
                 _latest_screen_data = None
+
             time.sleep(2)
 
 
@@ -76,9 +83,11 @@ def start_stream():
 
 
 def stop_stream():
-    global _stream_thread
+    global _stream_thread, _is_streaming_connected
     if _stream_thread and _stream_thread.is_alive():
         _stop_event.set()
+        with _data_lock:
+            _is_streaming_connected = False
         _stream_thread.join(timeout=2)
         print("--- Background screen streaming stopped ---")
 
@@ -135,6 +144,18 @@ async def health_check():
         raise HTTPException(status_code=503, detail=f"Maestro Studio not available: {e}")
 
 
+@app.get("/streaming-status")
+async def streaming_status():
+    """Check if the SSE streaming connection is active."""
+    with _data_lock:
+        return JSONResponse(
+            content={
+                "is_streaming_connected": _is_streaming_connected,
+                "has_screen_data": _latest_screen_data is not None,
+            }
+        )
+
+
 def start():
     if not is_port_in_use(server_settings.DEVICE_SCREEN_API_PORT):
         uvicorn.run(app, host="0.0.0.0", port=server_settings.DEVICE_SCREEN_API_PORT)

{minitap_mobile_use-2.5.0 → minitap_mobile_use-2.5.2}/minitap/mobile_use/services/llm.py

@@ -71,10 +71,10 @@ def get_minitap_llm(
     else:
         raise ValueError("MINITAP_API_KEY must be provided or set in environment")
 
-    if settings.MINITAP_API_BASE_URL is None:
-        raise ValueError("MINITAP_API_BASE_URL must be set in environment")
+    if settings.MINITAP_BASE_URL is None:
+        raise ValueError("MINITAP_BASE_URL must be set in environment")
 
-    llm_base_url = f"{settings.MINITAP_API_BASE_URL}/api/v1"
+    llm_base_url = f"{settings.MINITAP_BASE_URL}/api/v1"
 
     if max_retries is None and model.startswith("google/"):
         max_retries = 2

{minitap_mobile_use-2.5.0 → minitap_mobile_use-2.5.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "minitap-mobile-use"
-version = "2.5.0"
+version = "2.5.2"
 description = "AI-powered multi-agent system that automates real Android and iOS devices through low-level control using LangGraph."
 readme = "README.md"
 license = { file = "LICENSE" }