minitap-mobile-use 2.5.0__py3-none-any.whl → 2.5.2__py3-none-any.whl

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/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/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/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/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/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/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/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/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.dist-info → minitap_mobile_use-2.5.2.dist-info}/METADATA

@@ -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.dist-info → minitap_mobile_use-2.5.2.dist-info}/RECORD

@@ -23,9 +23,9 @@ minitap/mobile_use/agents/planner/types.py,sha256=e8acf3c2d1505286a138b6f7c3ef36
 minitap/mobile_use/agents/planner/utils.py,sha256=88b4b039e09cea254615ff3d0bc8951c3717a68702742e913a0176ecfbcaf495,2315
 minitap/mobile_use/agents/summarizer/summarizer.py,sha256=56c2c7d5d48f4ba045b1401538db78b2ddbd43280389ed4cbc58ecd1da0c7610,1083
 minitap/mobile_use/clients/device_hardware_client.py,sha256=9593380a7a3df32f02aa22717678c25e91367df26b1743abde9e57aec5dc2474,857
-minitap/mobile_use/clients/ios_client.py,sha256=332bf47ac01bbd5bf6178a59eea7c7a30fed944f30907caea5388178f312d36b,1452
+minitap/mobile_use/clients/ios_client.py,sha256=46a8c3f3c7d19d20b605502f5eeba90af2e3897483566b53e3f0141dcf7b0570,1453
 minitap/mobile_use/clients/screen_api_client.py,sha256=3615dc65d25c38b4d8dc5512f9adb3bcf69dca7a0298a472a6812f604a275c47,2019
-minitap/mobile_use/config.py,sha256=70a9519f0c4732870ee0bb7cdb1a7adc5dca85e380edce9e8cd5d5572709c7d9,10206
+minitap/mobile_use/config.py,sha256=18aa1251ff5eb5a5296c6854a8ce7686615a7eec2b63b2e0a125c1c941b77055,11182
 minitap/mobile_use/constants.py,sha256=3acd9d6ade5bc772e902b3473f3ba12ddd04e7306963ca2bae49d1132d89ba46,95
 minitap/mobile_use/context.py,sha256=2e212588a8a7caf58460fead0cae195c6386b7301026bbb2d78fe56c263ce6c3,2131
 minitap/mobile_use/controllers/__init__.py,sha256=e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855,0
@@ -35,19 +35,19 @@ minitap/mobile_use/graph/graph.py,sha256=c7b412e725b096eca8f212d704c3faf91d77eea
 minitap/mobile_use/graph/state.py,sha256=8efeef0f4bb10c933e54fdf17882ae63907ca557e4f1ae56bced8b5ac0f9ed17,3503
 minitap/mobile_use/main.py,sha256=7ac4dc592e3ce72bff602d67ba2f25b9b5e45e07a316e548d7c8e73735abf43d,3725
 minitap/mobile_use/sdk/__init__.py,sha256=4e5555c0597242b9523827194a2500b9c6d7e5c04b1ccd2056c9b1f4d42a31cd,318
-minitap/mobile_use/sdk/agent.py,sha256=ad30436d2de47804bd13c54e40c3c8709ff17765bbd2703e332e0959f885c4d3,27825
+minitap/mobile_use/sdk/agent.py,sha256=b1b98ce26ee08690d7b1c33bf98a29452d2d76906f77f5a0300bfa2331e41151,28416
 minitap/mobile_use/sdk/builders/__init__.py,sha256=d6c96d39b80900a114698ef205ab5061a541f33bfa99c456d9345e5adb8ff6ff,424
-minitap/mobile_use/sdk/builders/agent_config_builder.py,sha256=c63f452350822daab86d29c44a333909b623fc7ff7bcbf74e5f9104b24630bf5,7582
+minitap/mobile_use/sdk/builders/agent_config_builder.py,sha256=542d7d06c677059c8f8e0bc27d95f2dce282b1cfe0320fa6f902bc2f9d08140d,7686
 minitap/mobile_use/sdk/builders/index.py,sha256=64336ac3b3dea4673a48e95b8c5ac4196ecd5d2196380377d102593d0a1dc138,442
 minitap/mobile_use/sdk/builders/task_request_builder.py,sha256=9e6cf7afb68af986d6a81487179bb79d28f63047a068725d92996dbcbe753376,6857
 minitap/mobile_use/sdk/constants.py,sha256=436ba0700c6cf37ac0c9e3995a5f5a0d54ca87af72686eb9667a2c6a96e30f68,292
 minitap/mobile_use/sdk/examples/README.md,sha256=c92e57d6efc5bce9f3c8668b20d9ce80396aefb7a685636ee84de8c7b9c1403e,3247
 minitap/mobile_use/sdk/examples/__init__.py,sha256=c23868a2ca7e9b76e80d6835fe93c10e13ea8f2287dd6e785511b8ac30354e9b,46
-minitap/mobile_use/sdk/examples/platform_manual_task_example.py,sha256=2c140c040f0389f41ea430f088c40b3f0c211a433fca21ea6e106ddde9699927,1941
-minitap/mobile_use/sdk/examples/platform_minimal_example.py,sha256=58e57771362ef606045e238fe96cdf91313f161f233c5167acef71bb05c065ed,1321
+minitap/mobile_use/sdk/examples/platform_manual_task_example.py,sha256=00f54d58fa0abe9a1df20b3593633c239947c5acdf716fe9be1f58f9f56d8caa,1937
+minitap/mobile_use/sdk/examples/platform_minimal_example.py,sha256=bbb6ef341491d10b2ecbf88155ebe7827c6bd892803183c0a9e0f6bdd2212336,1317
 minitap/mobile_use/sdk/examples/simple_photo_organizer.py,sha256=8ad1cebb5281e3663264560bd15b090add41d2821b1db77e4cbc829860c98df8,2606
 minitap/mobile_use/sdk/examples/smart_notification_assistant.py,sha256=1d00658dc30c7bce5ef68369f982cd2d1932f53e2e2da6ded70cea13dc669c72,6362
-minitap/mobile_use/sdk/services/platform.py,sha256=28636d3d1715b997a44a41e0c4af2756235a04ecd565d011439ae970ac040c88,11973
+minitap/mobile_use/sdk/services/platform.py,sha256=2a1f97efe06577b67c5880ebcfb8a855ba61bf30b5f7d3e1f2600ef60cbd9dce,11969
 minitap/mobile_use/sdk/types/__init__.py,sha256=433aff6b35f84a985633204edbbdaca9f2f61fb2b822630f9723c481b9bb5c10,1078
 minitap/mobile_use/sdk/types/agent.py,sha256=390d5c642b3480f4a2203ddd28ec115c785f2576bec81e82e4db3c129399c020,2260
 minitap/mobile_use/sdk/types/exceptions.py,sha256=684c0049c5af417edf7e46e515be14fd57a0614c81b06ed52f379bc9d0bbebf3,4499
@@ -56,12 +56,12 @@ minitap/mobile_use/sdk/types/task.py,sha256=264e77bce958ee398252c7346dfa7ae896ea
 minitap/mobile_use/sdk/utils.py,sha256=647f1f4a463c3029c3b0eb3c33f7dd778d5f5fd9d293224f5474595a60e1de6f,967
 minitap/mobile_use/servers/config.py,sha256=8a4a6bce23e2093d047a91e135e2f88627f76ac12177d071f25a3ca739b3afeb,575
 minitap/mobile_use/servers/device_hardware_bridge.py,sha256=db5f55ba66bfebf70ea1a655d921d4070ca6c458b1e7e5e08ed58b3bea100d63,7227
-minitap/mobile_use/servers/device_screen_api.py,sha256=63bf866f17cde4ab97631b710080866b8427225d3857b2351ab83db38a9c5107,5064
+minitap/mobile_use/servers/device_screen_api.py,sha256=2e60a5bc32d71ca80ee8dd93ff8b76138ae5d74e67d82bdb16fd15086d4eb33a,5675
 minitap/mobile_use/servers/start_servers.py,sha256=1e86dc0fcbdf6e6570ae68c7097145e754f3c3448ca813d415b3e5ebb74db828,5037
 minitap/mobile_use/servers/stop_servers.py,sha256=04a409a17fc0323209301fe28fbb037d71e41e5422eb369640f9f329aae312f5,7064
 minitap/mobile_use/servers/utils.py,sha256=f3cc85da39f8d60cb840001be418562de7db95462370db9b79e96d884abe5c17,294
 minitap/mobile_use/services/accessibility.py,sha256=42bcbe81b427ee6f6e82bcfe420fc40630db950bda354e3e433c2dda2e159628,3404
-minitap/mobile_use/services/llm.py,sha256=e100560940a5d4fc33d2086742369c621e81e6c2fbb98e6d07411856d4df480f,7059
+minitap/mobile_use/services/llm.py,sha256=b76882a8026ae048ffeaeeb3ad056c11d9a757e4a7f2fd12eba40b29ee04a3bf,7047
 minitap/mobile_use/tools/index.py,sha256=9eab29d43e66ca397fad3206a302a9a4f423448437ab0a6fdb2b9d8bb227513b,2377
 minitap/mobile_use/tools/mobile/back.py,sha256=8b909e412c8ad382e339b8c89171bf1363398a95a5c96126f79ee2f24e3c2ed1,1816
 minitap/mobile_use/tools/mobile/clear_text.py,sha256=58e0426f042e39d827d3ff2fe3a79bb23e4146cbefd13da938e1a6f397579c4b,9799
@@ -94,7 +94,7 @@ minitap/mobile_use/utils/shell_utils.py,sha256=b35ae7f863379adb86c9ba0f9b3b9d495
 minitap/mobile_use/utils/test_ui_hierarchy.py,sha256=96c1549c05b4f7254a22d57dbd40aea860756f1e0b9d8cc24319383643448422,5911
 minitap/mobile_use/utils/time.py,sha256=41bfaabb3751de11443ccb4a3f1f53d5ebacc7744c72e32695fdcc3d23f17d49,160
 minitap/mobile_use/utils/ui_hierarchy.py,sha256=f3370518035d9daf02c08042a9e28ad564f4fc81a2b268103b9a7f8bc5c61d11,3797
-minitap_mobile_use-2.5.0.dist-info/WHEEL,sha256=ab6157bc637547491fb4567cd7ddf26b04d63382916ca16c29a5c8e94c9c9ef7,79
-minitap_mobile_use-2.5.0.dist-info/entry_points.txt,sha256=663a29cfd551a4eaa0f27335f0bd7e4a732a4e39c76b68ef5c8dc444d4a285fa,60
-minitap_mobile_use-2.5.0.dist-info/METADATA,sha256=3319e5797aab4b31ed4bc8ad9a499e09fdaa3f685d60ad3f958993bc55a961b0,11995
-minitap_mobile_use-2.5.0.dist-info/RECORD,,
+minitap_mobile_use-2.5.2.dist-info/WHEEL,sha256=ab6157bc637547491fb4567cd7ddf26b04d63382916ca16c29a5c8e94c9c9ef7,79
+minitap_mobile_use-2.5.2.dist-info/entry_points.txt,sha256=663a29cfd551a4eaa0f27335f0bd7e4a732a4e39c76b68ef5c8dc444d4a285fa,60
+minitap_mobile_use-2.5.2.dist-info/METADATA,sha256=45d6d254c735004e21ead5f86e7d8b551b21d85dde6d3dd777b118e46d033873,11995
+minitap_mobile_use-2.5.2.dist-info/RECORD,,