minitap-mcp 0.4.3__tar.gz → 0.5.0__tar.gz

{minitap_mcp-0.4.3 → minitap_mcp-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: minitap-mcp
-Version: 0.4.3
+Version: 0.5.0
 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

minitap_mcp-0.5.0/minitap/mcp/core/agents/extract_figma_assets.py

@@ -0,0 +1,69 @@
+"""Agent to extract Figma asset URLs from design context code using regex."""
+
+import re
+
+from pydantic import BaseModel, Field
+
+
+class FigmaAsset(BaseModel):
+    """Represents a single Figma asset."""
+
+    variable_name: str = Field(description="The variable name from the code (e.g., imgSignal)")
+    url: str = Field(description="The full URL to the asset")
+    extension: str = Field(description="The file extension (e.g., svg, png, jpg)")
+
+
+class ExtractedAssets(BaseModel):
+    """Container for all extracted Figma assets."""
+
+    assets: list[FigmaAsset] = Field(
+        default_factory=list,
+        description="List of all extracted assets from the Figma design context",
+    )
+    code_implementation: str = Field(
+        description="The React/TypeScript code with imports instead of const declarations"
+    )
+
+
+def extract_figma_assets(design_context_code: str) -> ExtractedAssets:
+    """Extract asset URLs from Figma design context code using regex.
+
+    Args:
+        design_context_code: The React/TypeScript code from get_design_context
+
+    Returns:
+        ExtractedAssets with list of assets and transformed code
+    """
+    # Regex captures: (1) variable name, (2) full URL, (4) extension
+    # Supports http/https, any domain, query strings, optional semicolon
+    pattern = r'const\s+(\w+)\s*=\s*["\']((https?://[^"\']+?)\.(\w+)(?:\?[^"\']*)?)["\'];?'
+    matches = re.finditer(pattern, design_context_code)
+
+    assets = []
+    asset_lines = []
+
+    for match in matches:
+        var_name = match.group(1)
+        url = match.group(2)
+        extension = match.group(4)
+
+        assets.append(FigmaAsset(variable_name=var_name, url=url, extension=extension))
+        asset_lines.append(match.group(0))
+
+    import_statements = []
+    for asset in assets:
+        import_statements.append(
+            f"import {asset.variable_name} from './{asset.variable_name}.{asset.extension}';"
+        )
+
+    transformed_code = design_context_code
+    for line in asset_lines:
+        transformed_code = transformed_code.replace(line, "")
+
+    lines = transformed_code.split("\n")
+    while lines and not lines[0].strip():
+        lines.pop(0)
+
+    final_code = "\n".join(import_statements) + "\n\n" + "\n".join(lines)
+
+    return ExtractedAssets(assets=assets, code_implementation=final_code)

{minitap_mcp-0.4.3 → minitap_mcp-0.5.0}/minitap/mcp/tools/save_figma_assets.py

@@ -41,9 +41,9 @@ logger = get_logger(__name__)
     
     This tool:
     1. Calls get_design_context from Figma MCP to get the React/TypeScript code
-    2. Extracts all asset URLs and code implementation from the code
+    2. Extracts asset URLs and transforms const declarations to import statements
     3. Downloads each asset to .mobile-use/figma_assets/<node-id>/ folder
-    4. Saves the code implementation to .mobile-use/figma_assets/<node-id>/code_implementation.ts
+    4. Saves the transformed code to .mobile-use/figma_assets/<node-id>/code_implementation.ts
     5. Returns a list of downloaded files
     """,
 )
@@ -75,10 +75,8 @@ async def save_figma_assets(
     # Step 1: Get design context from Figma MCP
     design_context = await get_design_context(node_id, file_key)
 
-    # Step 2: Extract asset URLs using LLM agent
-    extracted_context: ExtractedAssets = await extract_figma_assets(
-        design_context.code_implementation
-    )
+    # Step 2: Extract asset URLs and transform code
+    extracted_context: ExtractedAssets = extract_figma_assets(design_context.code_implementation)
     if not extracted_context.assets:
         raise ToolError("No assets found in the Figma design context.")
 

{minitap_mcp-0.4.3 → minitap_mcp-0.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "minitap-mcp"
-version = "0.4.3"
+version = "0.5.0"
 description = "Model Context Protocol server for controlling Android & iOS devices with natural language"
 readme = "PYPI_README.md"
 

minitap_mcp-0.4.3/minitap/mcp/core/agents/extract_figma_assets.md

@@ -1,64 +0,0 @@
-You are an expert at parsing React/TypeScript code to extract asset URLs and generate clean, documented code implementations.
-
-Your task is to:
-
-1. Extract all asset URLs from the provided code snippet
-2. Generate a clean `code_implementation` output that includes the React code with embedded comments referencing implementation and node guidelines
-
-**Instructions:**
-
-## Part 1: Extract Asset URLs
-
-1. Look for all constant declarations that contain URLs pointing to assets (images, SVGs, etc.)
-2. These constants typically follow patterns like:
-
-   - `const imgVariableName = "http://localhost:3845/assets/[hash].[extension]";`
-   - The variable names usually start with `img` followed by a descriptive name in camelCase
-
-3. For each asset URL found, extract:
-   - The **variable name** (e.g., `imgSignal`, `imgBatteryThreeQuarters`)
-   - The **full URL** (e.g., `http://localhost:3845/assets/685c5ac58caa29556e29737cf8f8c9605d9c8571.svg`)
-   - The **file extension** from the URL (e.g., `svg`, `png`, `jpg`)
-
-## Part 2: Generate Code Implementation
-
-The `code_implementation` field should contain:
-
-1. The React/TypeScript code with **LOCAL asset imports** instead of HTTP URLs:
-
-   - Convert `const imgSignal = "http://localhost:3845/assets/[hash].svg";`
-   - To `import imgSignal from './assets/imgSignal.svg';` (or appropriate relative path)
-   - Use the **exact same variable names** as in the original const declarations
-   - **CRITICAL**: Preserve the variable naming convention
-
-2. Preserve all `data-node-id` attributes and other metadata in the code
-
-## Part 3: Return Format
-
-Return a JSON object with two fields:
-
-- `assets`: Array of extracted asset objects
-- `code_implementation`: String containing the React code with embedded guideline comments
-
-```json
-{
-  "assets": [
-    {
-      "variable_name": "imgSignal",
-      "url": "http://localhost:3845/assets/685c5ac58caa29556e29737cf8f8c9605d9c8571.svg",
-      "extension": "svg"
-    },
-    ...
-  ],
-  "code_implementation": "import ... function ..."
-}
-```
-
-**Important:**
-
-- Only extract asset URLs
-- Preserve the exact variable names as they appear in the code
-- DO NOT MISS any assets
-- If no assets are found, return an empty array for `assets`
-- Return ONLY the JSON object with both `assets` and `code_implementation` fields
-- Do NOT include the const declarations of the assets in the code_implementation output - convert them to imports.

minitap_mcp-0.4.3/minitap/mcp/core/agents/extract_figma_assets.py

@@ -1,96 +0,0 @@
-"""Agent to extract Figma asset URLs from design context code."""
-
-import re
-import uuid
-from pathlib import Path
-
-from jinja2 import Template
-from langchain_core.messages import BaseMessage, HumanMessage, SystemMessage
-from pydantic import BaseModel, Field
-
-from minitap.mcp.core.llm import get_minitap_llm
-
-
-class FigmaAsset(BaseModel):
-    """Represents a single Figma asset."""
-
-    variable_name: str = Field(description="The variable name from the code (e.g., imgSignal)")
-    url: str = Field(description="The full URL to the asset")
-    extension: str = Field(description="The file extension (e.g., svg, png, jpg)")
-
-
-class ExtractedAssets(BaseModel):
-    """Container for all extracted Figma assets."""
-
-    assets: list[FigmaAsset] = Field(
-        default_factory=list,
-        description="List of all extracted assets from the Figma design context",
-    )
-    code_implementation: str = Field(
-        description=(
-            "The React/TypeScript code\n"
-            "with the local url declarations turned into const declarations"
-        )
-    )
-
-
-def sanitize_unicode_for_llm(text: str) -> str:
-    """Remove or replace problematic Unicode characters that increase token consumption.
-
-    Characters outside the Basic Multilingual Plane (BMP) like emoji and special symbols
-    get escaped as \\U sequences when sent to LLMs, dramatically increasing token count
-    and processing time.
-
-    Args:
-        text: The text to sanitize
-
-    Returns:
-        Text with problematic Unicode characters replaced with placeholders
-    """
-
-    # Replace characters outside BMP (U+10000 and above) with a placeholder
-    # These are typically emoji, special symbols, or rare characters
-    def replace_high_unicode(match):
-        char = match.group(0)
-        codepoint = ord(char)
-        # Return a descriptive placeholder
-        return f"[U+{codepoint:X}]"
-
-    # Pattern matches characters with codepoints >= U+10000
-    pattern = re.compile(r"[\U00010000-\U0010FFFF]")
-    sanitized = pattern.sub(replace_high_unicode, text)
-
-    return sanitized
-
-
-async def extract_figma_assets(design_context_code: str) -> ExtractedAssets:
-    """Extract asset URLs from Figma design context code.
-
-    Args:
-        design_context_code: The React/TypeScript code from get_design_context
-
-    Returns:
-        List of dictionaries containing variable_name, url, and extension
-    """
-    system_message = Template(
-        Path(__file__).parent.joinpath("extract_figma_assets.md").read_text(encoding="utf-8")
-    ).render()
-
-    sanitized_code = sanitize_unicode_for_llm(design_context_code)
-
-    messages: list[BaseMessage] = [
-        SystemMessage(content=system_message),
-        HumanMessage(
-            content=f"Here is the code to analyze:\n\n```typescript\n{sanitized_code}\n```"
-        ),
-    ]
-
-    llm = get_minitap_llm(
-        model="openai/gpt-5",
-        temperature=0,
-        trace_id=str(uuid.uuid4()),
-        remote_tracing=True,
-    ).with_structured_output(ExtractedAssets)
-    result: ExtractedAssets = await llm.ainvoke(messages)  # type: ignore
-
-    return result