minitap-mcp 0.5.0__py3-none-any.whl → 0.5.1__py3-none-any.whl

minitap/mcp/core/agents/{compare_screenshots.py → compare_screenshots/agent.py}

@@ -8,7 +8,7 @@ from pydantic import BaseModel
 
 from minitap.mcp.core.device import capture_screenshot, find_mobile_device
 from minitap.mcp.core.llm import get_minitap_llm
-from minitap.mcp.core.utils import get_screenshot_message_for_llm
+from minitap.mcp.core.utils.images import get_screenshot_message_for_llm
 
 
 class CompareScreenshotsOutput(BaseModel):
@@ -27,7 +27,7 @@ async def compare_screenshots(
         CompareScreenshotsOutput
     """
     system_message = Template(
-        Path(__file__).parent.joinpath("compare_screenshots.md").read_text(encoding="utf-8")
+        Path(__file__).parent.joinpath("prompt.md").read_text(encoding="utf-8")
     ).render()
 
     device = find_mobile_device()

minitap/mcp/core/agents/{compare_screenshots.md → compare_screenshots/eval/prompts/prompt_1.md}

@@ -55,8 +55,8 @@ Structured list of differences + summary.
 Please use the following to start the analysis.
 **Input:**
 First screen is the Figma screenshot (what is expected)
-Second screen is what is expected (taken from the phone, after the implementation)
+Second screen is what is implemented (taken from the phone, after the implementation)
 
 You will have this data in the next messages sent by the user.
 
-Go ahead and generate your report.
+Go ahead and generate your report.

minitap/mcp/core/agents/compare_screenshots/eval/scenario_1_add_cartoon_img_and_move_button/human_feedback.txt

@@ -0,0 +1,18 @@
+6 differences found :
+- Add button moved and restyled
+The “+ Add” button is now at the top instead of the bottom, and its style is very different. This is a big layout change — confirm with design.
+
+- Title typo
+“Languges” should be “Languages”.
+
+- Subtitle casing
+The subtitle should be sentence case (“You are learning”), not title case.
+
+- Extra robot illustration
+A large yellow robot was added but isn’t in the design. Confirm if it should be there.
+
+- Extra sub-label in list item
+“Norwegian” has a second line (“from French”), which isn’t part of the design. Check if this is intended.
+
+- Missing small “M” icon
+The red “M” in the bottom-right is missing.

minitap/mcp/core/agents/compare_screenshots/eval/scenario_1_add_cartoon_img_and_move_button/prompt_1/model_params.json

@@ -0,0 +1,3 @@
+{
+  "model_name": "gemini-2.5-pro"
+}

minitap/mcp/core/agents/compare_screenshots/eval/scenario_1_add_cartoon_img_and_move_button/prompt_1/output.md

@@ -0,0 +1,46 @@
+Based on the visual comparison of the provided screenshots, here is a detailed report of the differences.
+
+---
+
+1.  **Location**: Top-right of the header area vs. bottom-center of the screen
+    **Change**: The `+ Add` button has been moved from a full-width element at the bottom of the screen to a smaller, pill-shaped button in the top-right header area. Its style has also changed from a button with only a text label and icon to one with a solid yellow background and white text/icon.
+    **Type**: Position/Movement, Style Change, Size Change
+    **Impact**: This is a major structural change to the page layout. The primary call-to-action is in a completely different location, which fundamentally alters the user's interaction pattern with the screen.
+    **Recommendation**: The development team should align with the design team on the intended placement and style of this critical action button. This change is too significant to be accidental and suggests a disconnect between design and implementation requirements.
+
+2.  **Location**: Page title area, below the `X` icon.
+    **Change**: The page title text is misspelled as "Languges" in the implementation, whereas the design specifies "Languages".
+    **Type**: Text Change
+    **Impact**: Introduces a spelling error on a primary screen title, which appears unprofessional.
+    **Recommendation**: Correct the typo in the title to "Languages".
+
+3.  **Location**: Subtitle area, directly below the page title.
+    **Change**: The text casing for the subtitle has been changed from sentence case ("You are learning") to title case ("You are Learning").
+    **Type**: Text Change / Style Change
+    **Impact**: A minor visual inconsistency that deviates from the typographic style defined in the design.
+    **Recommendation**: Update the subtitle text to use sentence case ("You are learning") to match the design specification.
+
+4.  **Location**: Bottom half of the screen.
+    **Change**: The implemented screen includes a large illustration of a yellow robot character that is not present in the expected design.
+    **Type**: Added Element
+    **Impact**: This new element significantly alters the visual hierarchy and feel of the screen, consuming a large amount of whitespace and adding a strong branding element not specified in the design.
+    **Recommendation**: Verify with the product/design team if this illustration is an intended addition. If not, it should be removed to match the figma design.
+
+5.  **Location**: Second item in the language list ("Norwegian").
+    **Change**: One of the language list items in the implementation includes a gray sub-label ("from French") below the language name. The design for list items shows only a single line of text for the language.
+    **Type**: Added Element (within a component)
+    **Impact**: The implemented list item component has a different structure than designed, supporting two lines of text instead of one. This affects component height and internal layout.
+    **Recommendation**: Clarify if this two-line state is a required feature. If so, the design should be updated to include this variant. If not, the sub-label should be removed.
+
+6.  **Location**: Bottom-right corner of the screen.
+    **Change**: The expected design includes a small, red "M" character/logo in the bottom-right corner. This element is missing from the implemented screen.
+    **Type**: Removed Element
+    **Impact**: A subtle branding or UI element has been omitted from the final implementation.
+    **Recommendation**: Add the "M" element back to the screen in the position specified by the design.
+
+---
+
+### Summary
+
+- **Total differences found**: 6
+- **Overall "match score"**: 50/100

minitap/mcp/core/agents/compare_screenshots/prompt.md

@@ -0,0 +1,62 @@
+You will be given _two screenshots_.
+
+1. "Expected screenshot" — this is the design from Figma.
+2. "Implemented screenshot" — this is the actual phone screen that has been built.
+
+Your task is to **compare the two screenshots** in detail, and generate a structured report that includes:
+
+- A comprehensive list of **all visible differences** between the expected design and the implemented screen.
+- For each difference, provide:
+  - A clear **description** of what changed (for example: "The 'Submit' button label changed from 'Submit' to 'Send'", "The icon moved 8px to the right", "The background colour of header changed from #FFFFFF to #F6F6F6", etc.).
+  - The **type of change** (e.g., text change, color change, position/movement, size change, added element, removed element, style change).
+  - The **location** of the change (for example: "bottom-centre of screen", "top header area", "to the right of search bar"). If possible, approximate coordinates or bounding box (e.g., "approx. 240×180 px at screen width 1080").
+  - The **impact on implementation** (i.e., reasoning about what this means: "The implemented version uses a different text label – so behaviour may differ", "The icon moved and may overlap another element", etc.).
+  - A **recommendation** if relevant (e.g., "Should revert to #FFFFFF to match design", "Check alignment of icon relative to search bar", etc.).
+
+**Important**:
+
+- Assume the screenshots are aligned (same resolution and scale); if not aligned mention that as a difference.
+- Focus on _visible UI differences_ (layout, text, style, iconography) – you do _not_ need to inspect source code, only what is visually rendered.
+- Do _not_ produce generic comments like "looks like a difference" – aim for _precise, actionable descriptions_.
+- **IGNORE dynamic/personal content** that naturally differs between mockups and real implementations:
+  - User profile information (names, usernames, email addresses, profile pictures)
+  - Time-based information (current time, dates, timestamps, "2 hours ago", etc.)
+  - Dynamic data (notification counts, unread badges, live statistics)
+  - Sample/placeholder content that varies (e.g., "John Doe" vs "Jane Smith")
+  - System status information (battery level, signal strength, network indicators)
+  - Only flag these as differences if the _structure, layout, or styling_ of these elements differs, not the content itself.
+- Output in a structured format, for example:
+
+```
+
+1. Location: [top header – full width]
+   Change: Background colour changed from #FFFFFF → #F6F6F6
+   Type: Colour change
+   Impact: The header will appear darker than design; text contrast may be lower.
+   Recommendation: Update header background to #FFFFFF as in design.
+
+```
+
+- At the end produce a summary with ONLY:
+  - Total number of differences found
+  - Overall "match score" out of 100 (your estimation of how closely the implementation matches the design)
+  - Do NOT include any recap, overview, or macro-level summary of changes - all details are already captured in the differences list above.
+
+### Input:
+
+- Screenshot A: Expected (Figma)
+- Screenshot B: Implemented (Phone)
+  Provide both screenshots and then the prompt.
+
+### Output:
+
+Structured list of differences + summary.
+
+Please use the following to start the analysis.
+**Input:**
+First screen is the Figma screenshot (what is expected)
+Second screen is what is implemented (taken from the phone, after the implementation)
+
+You will have this data in the next messages sent by the user.
+
+Go ahead and generate your report.

minitap/mcp/tools/analyze_screen.py

@@ -1,15 +1,15 @@
 from pathlib import Path
-from jinja2 import Template
-from langchain_core.messages import BaseMessage, HumanMessage, SystemMessage
 from uuid import uuid4
 
+from jinja2 import Template
+from langchain_core.messages import BaseMessage, HumanMessage, SystemMessage
 from pydantic import Field
 
 from minitap.mcp.core.config import settings
 from minitap.mcp.core.decorators import handle_tool_errors
 from minitap.mcp.core.device import capture_screenshot, find_mobile_device
 from minitap.mcp.core.llm import get_minitap_llm
-from minitap.mcp.core.utils import compress_base64_jpeg, get_screenshot_message_for_llm
+from minitap.mcp.core.utils.images import compress_base64_jpeg, get_screenshot_message_for_llm
 from minitap.mcp.main import mcp
 
 

minitap/mcp/tools/compare_screenshot_with_figma.py

@@ -11,7 +11,7 @@ from fastmcp.tools.tool import ToolResult
 from PIL import Image
 from pydantic import Field
 
-from minitap.mcp.core.agents.compare_screenshots import compare_screenshots
+from minitap.mcp.core.agents.compare_screenshots.agent import compare_screenshots
 from minitap.mcp.core.config import settings
 from minitap.mcp.core.decorators import handle_tool_errors
 from minitap.mcp.main import mcp

minitap/mcp/tools/execute_mobile_command.py

@@ -34,10 +34,6 @@ def _serialize_result(result: Any) -> Any:
     - "Open the settings app and tell me the battery level"
     - "Find the first 3 unread emails in Gmail"
     - "Take a screenshot and save it"
-    
-    The tool uses the Minitap platform with API key authentication.
-    Set MINITAP_API_KEY and MINITAP_API_BASE_URL environment variables.
-    Visit https://platform.minitap.ai to get your API key.
     """,
 )
 @handle_tool_errors
@@ -53,11 +49,21 @@ async def execute_mobile_command(
         default="default",
         description="Name of the profile to use for this task. Defaults to 'default'.",
     ),
+    locked_app_package: str | None = Field(
+        default=None,
+        description="Optional package name of the app to lock the device to. "
+        "Will launch the app if not already running, and keep it in foreground "
+        "until the task is completed.",
+    ),
 ) -> str | dict[str, Any]:
     """Run a manual task on a mobile device via the Minitap platform."""
     try:
         request = PlatformTaskRequest(
-            task=ManualTaskConfig(goal=goal, output_description=output_description),
+            task=ManualTaskConfig(
+                goal=goal,
+                output_description=output_description,
+                locked_app_package=locked_app_package,
+            ),
         )
         agent = get_mobile_use_agent()
         result = await agent.run_task(request=request)

minitap/mcp/tools/save_figma_assets.py

@@ -11,11 +11,6 @@ from fastmcp.exceptions import ToolError
 from fastmcp.tools.tool import ToolResult
 from pydantic import Field
 
-from minitap.mcp.core.agents.extract_figma_assets import (
-    ExtractedAssets,
-    FigmaAsset,
-    extract_figma_assets,
-)
 from minitap.mcp.core.config import settings
 from minitap.mcp.core.decorators import handle_tool_errors
 from minitap.mcp.core.logging_config import get_logger
@@ -25,6 +20,7 @@ from minitap.mcp.core.models import (
     DownloadStatus,
     FigmaDesignContextOutput,
 )
+from minitap.mcp.core.utils.figma import ExtractedAssets, FigmaAsset, extract_figma_assets
 from minitap.mcp.main import mcp
 from minitap.mcp.tools.compare_screenshot_with_figma import (
     compress_image_base64,

{minitap_mcp-0.5.0.dist-info → minitap_mcp-0.5.1.dist-info}/METADATA

@@ -1,13 +1,13 @@
 Metadata-Version: 2.3
 Name: minitap-mcp
-Version: 0.5.0
+Version: 0.5.1
 Summary: Model Context Protocol server for controlling Android & iOS devices with natural language
 Author: Pierre-Louis Favreau, Jean-Pierre Lo, Clément Guiguet
 Requires-Dist: fastmcp>=2.12.4
 Requires-Dist: python-dotenv>=1.1.1
 Requires-Dist: pydantic>=2.12.0
 Requires-Dist: pydantic-settings>=2.10.1
-Requires-Dist: minitap-mobile-use>=2.8.2
+Requires-Dist: minitap-mobile-use>=2.9.1
 Requires-Dist: jinja2>=3.1.6
 Requires-Dist: langchain-core>=0.3.75
 Requires-Dist: pillow>=11.1.0

minitap_mcp-0.5.1.dist-info/RECORD

@@ -0,0 +1,30 @@
+minitap/mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+minitap/mcp/core/agents/compare_screenshots/agent.py,sha256=k25xbXJSMZgWYsDP0qpmNcqBo5yGbsQxRZ0nnYKHgbc,2054
+minitap/mcp/core/agents/compare_screenshots/eval/prompts/prompt_1.md,sha256=qAyqOroSJROgrvlbsLCtiwFyBKuIMCQ-720A5cwgwPY,3563
+minitap/mcp/core/agents/compare_screenshots/eval/scenario_1_add_cartoon_img_and_move_button/actual.png,sha256=woKE-aTTdb-9ArqfnV-xKKyit1Fu_hklavVwAaMQ14E,99455
+minitap/mcp/core/agents/compare_screenshots/eval/scenario_1_add_cartoon_img_and_move_button/figma.png,sha256=ghxi1P-ofnmMv5_ASm0Rzo5ll_C8-E6ojQUCHRR33TA,102098
+minitap/mcp/core/agents/compare_screenshots/eval/scenario_1_add_cartoon_img_and_move_button/human_feedback.txt,sha256=0gVEqIFpmCX1cx1tlGBdfqDGbTeedyVfwTJZqePURkA,700
+minitap/mcp/core/agents/compare_screenshots/eval/scenario_1_add_cartoon_img_and_move_button/prompt_1/model_params.json,sha256=p93kbUGxLYwc4NAEzPTBDA2XZ1ucsa7yevXZRe6V4Mc,37
+minitap/mcp/core/agents/compare_screenshots/eval/scenario_1_add_cartoon_img_and_move_button/prompt_1/output.md,sha256=Q0_5w9x5WAMqx6-I7KgjlS-tt7HnWKIunP43J7F0W_o,3703
+minitap/mcp/core/agents/compare_screenshots/prompt.md,sha256=qAyqOroSJROgrvlbsLCtiwFyBKuIMCQ-720A5cwgwPY,3563
+minitap/mcp/core/config.py,sha256=_rIH31treZlM2RVnTz5cPXhV9Bu4D-w4TmbPh5_mxxM,1026
+minitap/mcp/core/decorators.py,sha256=kMx_mlaa-2U1AgCoYkgPoLOa-iOoKUF1OjcNV7x59Ds,2940
+minitap/mcp/core/device.py,sha256=sEO3Z-8F325hDOObdH1YBhZE60f17FmIclt5UlhY_nU,7875
+minitap/mcp/core/llm.py,sha256=tI5m5rFDLeMkXE5WExnzYSzHU3nTIEiSC9nAsPzVMaU,1144
+minitap/mcp/core/logging_config.py,sha256=OJlArPJxflbhckerFsRHVTzy3jwsLsNSPN0LVpkmpNM,1861
+minitap/mcp/core/models.py,sha256=egLScxPAMo4u5cqY33UKba7z7DsdgqfPW409UAqW1Jg,1942
+minitap/mcp/core/sdk_agent.py,sha256=-9l1YetD93dzxOeSFOT_j8dDfDFjhJLiir8bhzEjI3Y,900
+minitap/mcp/core/utils/figma.py,sha256=L5aAHm59mrRYaqrwMJSM24SSdZPu2yVg-wsHTF3L8vk,2310
+minitap/mcp/core/utils/images.py,sha256=3uExpRoh7affIieZx3TLlZTmZCcoxWfx1YpPbwhjiJY,1791
+minitap/mcp/main.py,sha256=RsFAU32Rgrt66OiOtO74k7HSeTWRqnw31IurbnsOI3I,4811
+minitap/mcp/server/middleware.py,sha256=fbry_IiHmwUxVjsWgOU2goybcS1kLRXFZZ89KPH1d8E,880
+minitap/mcp/server/poller.py,sha256=Qakq4yO3EJ9dXmRqtE3sJjyk0ij7VBU-NuupHhTf37g,2539
+minitap/mcp/tools/analyze_screen.py,sha256=xQALhVfbEn13ao7C3EvzuBusOgjYIkS9hzKhzQSne6g,1991
+minitap/mcp/tools/compare_screenshot_with_figma.py,sha256=a3rHi8MbomgspJ2iPPgTyRoYrcEai2r4ED_-DssSbNI,4581
+minitap/mcp/tools/execute_mobile_command.py,sha256=oYrcm3NEbABPQBTdWLg7ihLFQBL3-L-xEsx_CiTlA9k,2613
+minitap/mcp/tools/save_figma_assets.py,sha256=V1gnQsJ1tciOxiK08aaqQxOEerJkKzxU8r4hJmkXHtA,9945
+minitap/mcp/tools/screen_analyzer.md,sha256=TTO80JQWusbA9cKAZn-9cqhgVHm6F_qJh5w152hG3YM,734
+minitap_mcp-0.5.1.dist-info/WHEEL,sha256=w4ZtLaDgMAZW2MMZZwtH8zENekoQYBCeullI-zsXJQk,78
+minitap_mcp-0.5.1.dist-info/entry_points.txt,sha256=rYVoXm7tSQCqQTtHx4Lovgn1YsjwtEEHfddKrfEVHuY,55
+minitap_mcp-0.5.1.dist-info/METADATA,sha256=P13tt0jbzzlLaFQtXaQyLEnErAx-Oyg3YP0huuYYiAE,8641
+minitap_mcp-0.5.1.dist-info/RECORD,,

{minitap_mcp-0.5.0.dist-info → minitap_mcp-0.5.1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.9.8
+Generator: uv 0.9.9
 Root-Is-Purelib: true
 Tag: py3-none-any

minitap_mcp-0.5.0.dist-info/RECORD

@@ -1,24 +0,0 @@
-minitap/mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-minitap/mcp/core/agents/compare_screenshots.md,sha256=Gt27HVzXzu71BxcanKPokz1dFPvq90vXbjE2HOn5X0I,3559
-minitap/mcp/core/agents/compare_screenshots.py,sha256=Yb7kR8Cv0gWzXyNf-6IS7_9l1npfqYmL-SONJJGgzM4,2060
-minitap/mcp/core/agents/extract_figma_assets.py,sha256=L5aAHm59mrRYaqrwMJSM24SSdZPu2yVg-wsHTF3L8vk,2310
-minitap/mcp/core/config.py,sha256=_rIH31treZlM2RVnTz5cPXhV9Bu4D-w4TmbPh5_mxxM,1026
-minitap/mcp/core/decorators.py,sha256=kMx_mlaa-2U1AgCoYkgPoLOa-iOoKUF1OjcNV7x59Ds,2940
-minitap/mcp/core/device.py,sha256=sEO3Z-8F325hDOObdH1YBhZE60f17FmIclt5UlhY_nU,7875
-minitap/mcp/core/llm.py,sha256=tI5m5rFDLeMkXE5WExnzYSzHU3nTIEiSC9nAsPzVMaU,1144
-minitap/mcp/core/logging_config.py,sha256=OJlArPJxflbhckerFsRHVTzy3jwsLsNSPN0LVpkmpNM,1861
-minitap/mcp/core/models.py,sha256=egLScxPAMo4u5cqY33UKba7z7DsdgqfPW409UAqW1Jg,1942
-minitap/mcp/core/sdk_agent.py,sha256=-9l1YetD93dzxOeSFOT_j8dDfDFjhJLiir8bhzEjI3Y,900
-minitap/mcp/core/utils.py,sha256=3uExpRoh7affIieZx3TLlZTmZCcoxWfx1YpPbwhjiJY,1791
-minitap/mcp/main.py,sha256=RsFAU32Rgrt66OiOtO74k7HSeTWRqnw31IurbnsOI3I,4811
-minitap/mcp/server/middleware.py,sha256=fbry_IiHmwUxVjsWgOU2goybcS1kLRXFZZ89KPH1d8E,880
-minitap/mcp/server/poller.py,sha256=Qakq4yO3EJ9dXmRqtE3sJjyk0ij7VBU-NuupHhTf37g,2539
-minitap/mcp/tools/analyze_screen.py,sha256=fjcjf3tTZDlxzmiQFHFNgw38bxPz4eisw57zuxshN2A,1984
-minitap/mcp/tools/compare_screenshot_with_figma.py,sha256=G69F6vRFI2tE2wW-oFYPjnY8oFMD9nRZH0H-yvtD4gE,4575
-minitap/mcp/tools/execute_mobile_command.py,sha256=qY3UfcDq1BtYcny1YlEF4WV9LwUJxLAmLJCm1VBzxS8,2442
-minitap/mcp/tools/save_figma_assets.py,sha256=6GRaaBQfU4h7H_q69Xoy8qdzkZXtBMlFUeV5kCAeBMc,9978
-minitap/mcp/tools/screen_analyzer.md,sha256=TTO80JQWusbA9cKAZn-9cqhgVHm6F_qJh5w152hG3YM,734
-minitap_mcp-0.5.0.dist-info/WHEEL,sha256=DpNsHFUm_gffZe1FgzmqwuqiuPC6Y-uBCzibcJcdupM,78
-minitap_mcp-0.5.0.dist-info/entry_points.txt,sha256=rYVoXm7tSQCqQTtHx4Lovgn1YsjwtEEHfddKrfEVHuY,55
-minitap_mcp-0.5.0.dist-info/METADATA,sha256=j4TMgzWoC3WHoDBEavfB-SSzQVdpUV10E0HZW30njDg,8641
-minitap_mcp-0.5.0.dist-info/RECORD,,