stitch-kit 1.5.0

package/docs/mcp-schemas/generate_screen_from_text.json

@@ -0,0 +1,242 @@
+{
+  "name": "generate_screen_from_text",
+  "description": "Generates a new screen within a project from a text prompt.\n\n**Input Requirements (CRITICAL):**\n\n1.  **`project_id` (string - MANDATORY):** Numeric ID only — no `projects/` prefix. Example: `3780309359108792857`.\n2.  **`prompt` (string - MANDATORY):** The prompt describing the desired screen.\n3.  **`device_type` (enum - OPTIONAL):** Defaults to MOBILE if not provided.\n4.  **`model_id` (enum - OPTIONAL):** Defaults to GEMINI_3_FLASH. Use GEMINI_3_PRO for higher quality (Thinking model).\n\n**Instructions for Tool Call:**\n*  This action can take a few minutes to complete. Please be patient. DO NOT RETRY.\n*  If the tool call fails due to connection error, the generation process may still succeed. Try get_screen later.\n\n**Output:**\n*  **`output_components`**: If `output_components` contains text, return it to the user. If it contains suggestions, present them. If accepted, call generate_screen_from_text again with `prompt` set to the accepted suggestion.\n",
+  "arguments": {
+    "type": "object",
+    "properties": {
+      "deviceType": {
+        "description": "The device type for the generated screen.",
+        "enum": [
+          "DEVICE_TYPE_UNSPECIFIED",
+          "MOBILE",
+          "DESKTOP",
+          "TABLET",
+          "AGNOSTIC"
+        ],
+        "type": "string"
+      },
+      "modelId": {
+        "description": "Optional. GEMINI_3_PRO = Thinking model (higher quality, slower). GEMINI_3_FLASH = default (faster).",
+        "enum": [
+          "MODEL_ID_UNSPECIFIED",
+          "GEMINI_3_PRO",
+          "GEMINI_3_FLASH"
+        ],
+        "type": "string"
+      },
+      "projectId": {
+        "description": "Required. Numeric project ID only — do NOT include 'projects/' prefix.",
+        "type": "string"
+      },
+      "prompt": {
+        "description": "Required. The text prompt describing the screen to generate.",
+        "type": "string"
+      }
+    },
+    "required": ["projectId", "prompt"],
+    "description": "Request message for GenerateScreenFromText."
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "outputComponents": {
+        "description": "Array of output components. May contain text responses, design objects, or suggestions to present to the user.",
+        "items": { "$ref": "#/$defs/SessionOutputComponent" },
+        "type": "array"
+      },
+      "projectId": { "description": "Same as the input project ID.", "type": "string" },
+      "sessionId": { "description": "Session ID for this generation.", "type": "string" }
+    },
+    "$defs": {
+      "SessionOutputComponent": {
+        "description": "A partial output of the session. Check all three fields — only one will be populated.",
+        "properties": {
+          "design": {
+            "$ref": "#/$defs/Design",
+            "description": "A generated design to display. Only for TEXT_TO_UI and IMAGE_TO_UI projects."
+          },
+          "suggestion": {
+            "description": "A suggested follow-up prompt. Present to the user; if accepted, use as the next prompt.",
+            "type": "string"
+          },
+          "text": {
+            "description": "A text response from the agent.",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "Design": {
+        "description": "A generated design — collection of screens with theme metadata.",
+        "properties": {
+          "deviceType": {
+            "enum": ["DEVICE_TYPE_UNSPECIFIED", "MOBILE", "DESKTOP", "TABLET", "AGNOSTIC"],
+            "type": "string"
+          },
+          "screens": {
+            "items": { "$ref": "#/$defs/Screen" },
+            "type": "array"
+          },
+          "theme": { "$ref": "#/$defs/DesignTheme" },
+          "title": { "type": "string" }
+        },
+        "type": "object"
+      },
+      "Screen": {
+        "description": "A generated screen.",
+        "properties": {
+          "deviceType": {
+            "enum": ["DEVICE_TYPE_UNSPECIFIED", "MOBILE", "DESKTOP", "TABLET", "AGNOSTIC"],
+            "type": "string"
+          },
+          "figmaExport": { "$ref": "#/$defs/File" },
+          "generatedBy": { "type": "string" },
+          "groupId": { "description": "Groups related screens (e.g. variants of a design).", "type": "string" },
+          "groupName": { "description": "Human-readable group name (e.g. 'Warm Minimalism').", "type": "string" },
+          "height": { "type": "string" },
+          "htmlCode": { "$ref": "#/$defs/File" },
+          "isCreatedByClient": { "type": "boolean" },
+          "name": {
+            "description": "Format: projects/{project}/screens/{screen}",
+            "type": "string",
+            "x-google-identifier": true
+          },
+          "prompt": { "type": "string" },
+          "screenMetadata": { "$ref": "#/$defs/ScreenMetadata" },
+          "screenType": {
+            "enum": ["SCREEN_TYPE_UNSPECIFIED", "DESIGN", "IMAGE", "PROTOTYPE", "DOCUMENT"],
+            "type": "string"
+          },
+          "screenshot": { "$ref": "#/$defs/File" },
+          "theme": { "$ref": "#/$defs/DesignTheme" },
+          "title": { "type": "string" },
+          "width": { "type": "string" }
+        },
+        "type": "object"
+      },
+      "ScreenMetadata": {
+        "description": "Metadata about how a screen was generated.",
+        "properties": {
+          "agentType": {
+            "description": "Which Stitch agent produced this screen.",
+            "enum": [
+              "DESIGN_AGENT_TYPE_UNSPECIFIED",
+              "TURBO_AGENT",
+              "PRO_AGENT",
+              "IMAGE_AGENT",
+              "GENIE_AGENT",
+              "IMAGE_PRO_AGENT",
+              "HATTER_AGENT",
+              "GEMINI_3_AGENT"
+            ],
+            "type": "string",
+            "x-google-enum-descriptions": [
+              "Unspecified.",
+              "Faster agent with Figma export support.",
+              "Uses Gemini 3.0 Flash. Legacy 'PRO' name from when it used Gemini 2.5 Pro.",
+              "Produces image-based screens.",
+              "Genie prototype agent.",
+              "Image pro agent.",
+              "Hatter general assistant agent.",
+              "Powered by Gemini 3.0 Thinking model. The new 'Pro' agent after Gemini 3 launch."
+            ]
+          },
+          "componentRegions": {
+            "description": "Bounding boxes for detected UI components in the screenshot.",
+            "items": { "$ref": "#/$defs/ComponentRegion" },
+            "type": "array"
+          },
+          "displayMode": {
+            "description": "Whether frontend should display HTML or screenshot.",
+            "enum": ["DISPLAY_MODE_UNSPECIFIED", "SCREENSHOT", "HTML"],
+            "type": "string"
+          },
+          "isRemixed": { "type": "boolean" },
+          "status": {
+            "enum": ["SCREEN_STATUS_UNSPECIFIED", "IN_PROGRESS", "COMPLETE", "FAILED"],
+            "type": "string"
+          },
+          "statusMessage": { "description": "Human-readable status from the agent.", "type": "string" }
+        },
+        "type": "object"
+      },
+      "ComponentRegion": {
+        "description": "A detected UI component with its bounding box and XPath reference.",
+        "properties": {
+          "boundingBox": { "$ref": "#/$defs/BoundingBox" },
+          "description": { "type": "string" },
+          "type": {
+            "enum": [
+              "COMPONENT_TYPE_UNSPECIFIED",
+              "COMPONENT_TYPE_IMAGE",
+              "COMPONENT_TYPE_TEXT",
+              "COMPONENT_TYPE_BUTTON",
+              "COMPONENT_TYPE_INPUT",
+              "COMPONENT_TYPE_CONTAINER"
+            ],
+            "type": "string"
+          },
+          "xpath": { "description": "XPath to locate this component in the HTML.", "type": "string" }
+        },
+        "type": "object"
+      },
+      "BoundingBox": {
+        "description": "Pixel coordinates relative to the screen dimensions.",
+        "properties": {
+          "height": { "format": "int32", "type": "integer" },
+          "width": { "format": "int32", "type": "integer" },
+          "x": { "format": "int32", "type": "integer" },
+          "y": { "format": "int32", "type": "integer" }
+        },
+        "type": "object"
+      },
+      "DesignTheme": {
+        "description": "Theme configuration returned with the generated design.",
+        "properties": {
+          "backgroundDark": { "description": "Hex background for dark mode.", "type": "string" },
+          "backgroundLight": { "description": "Hex background for light mode.", "type": "string" },
+          "colorMode": {
+            "enum": ["COLOR_MODE_UNSPECIFIED", "LIGHT", "DARK"],
+            "type": "string"
+          },
+          "customColor": { "description": "Custom primary color (hex).", "type": "string" },
+          "description": { "description": "Brief aesthetic description.", "type": "string" },
+          "font": {
+            "description": "28 fonts available. Use enum values in prompts for precise control.",
+            "enum": [
+              "FONT_UNSPECIFIED",
+              "BE_VIETNAM_PRO", "EPILOGUE", "INTER", "LEXEND", "MANROPE",
+              "NEWSREADER", "NOTO_SERIF", "PLUS_JAKARTA_SANS", "PUBLIC_SANS",
+              "SPACE_GROTESK", "SPLINE_SANS", "WORK_SANS", "DOMINE",
+              "LIBRE_CASLON_TEXT", "EB_GARAMOND", "LITERATA", "SOURCE_SERIF_FOUR",
+              "MONTSERRAT", "METROPOLIS", "SOURCE_SANS_THREE", "NUNITO_SANS",
+              "ARIMO", "HANKEN_GROTESK", "RUBIK", "GEIST", "DM_SANS",
+              "IBM_PLEX_SANS", "SORA"
+            ],
+            "type": "string"
+          },
+          "preset": { "type": "string" },
+          "roundness": {
+            "description": "ROUND_TWO is deprecated/unused. Safe values: ROUND_FOUR, ROUND_EIGHT, ROUND_TWELVE, ROUND_FULL.",
+            "enum": ["ROUNDNESS_UNSPECIFIED", "ROUND_TWO", "ROUND_FOUR", "ROUND_EIGHT", "ROUND_TWELVE", "ROUND_FULL"],
+            "type": "string"
+          },
+          "saturation": {
+            "description": "Color saturation 1–4. Higher = more vivid.",
+            "format": "int32",
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "File": {
+        "properties": {
+          "downloadUrl": { "description": "FIFE base URL for images, direct URL for HTML.", "type": "string" },
+          "name": { "type": "string" }
+        },
+        "type": "object"
+      }
+    },
+    "description": "Response message for GenerateScreenFromText."
+  }
+}

package/docs/mcp-schemas/generate_variants.json

@@ -0,0 +1,77 @@
+{
+  "name": "generate_variants",
+  "description": "Generates design variants of existing screens. Explores alternative layouts, color schemes, fonts, or content with configurable creativity levels.\n\n**Input Requirements (CRITICAL):**\n1. **`projectId` (string - MANDATORY):** Numeric ID only.\n2. **`selectedScreenIds` (array - MANDATORY):** Numeric screen IDs to vary.\n3. **`variantOptions` (object - RECOMMENDED):** Controls variant generation.\n",
+  "arguments": {
+    "type": "object",
+    "properties": {
+      "projectId": {
+        "description": "Required. Numeric project ID only — do NOT include 'projects/' prefix.",
+        "type": "string"
+      },
+      "selectedScreenIds": {
+        "description": "Required. Array of numeric screen IDs to generate variants from.",
+        "type": "array",
+        "items": { "type": "string" }
+      },
+      "prompt": {
+        "description": "Optional. Guidance text for the variant direction.",
+        "type": "string"
+      },
+      "variantOptions": {
+        "$ref": "#/$defs/VariantOptions",
+        "description": "Optional but recommended. Controls what and how much to vary."
+      },
+      "deviceType": {
+        "description": "Optional. Device type context.",
+        "enum": ["DEVICE_TYPE_UNSPECIFIED", "MOBILE", "DESKTOP", "TABLET", "AGNOSTIC"],
+        "type": "string"
+      },
+      "modelId": {
+        "description": "Optional. GEMINI_3_PRO for higher quality, GEMINI_3_FLASH for speed.",
+        "enum": ["MODEL_ID_UNSPECIFIED", "GEMINI_3_PRO", "GEMINI_3_FLASH"],
+        "type": "string"
+      }
+    },
+    "required": ["projectId", "selectedScreenIds"],
+    "description": "Request message for GenerateVariants.",
+    "$defs": {
+      "VariantOptions": {
+        "description": "Configuration for variant generation.",
+        "properties": {
+          "variantCount": {
+            "description": "Number of variants to generate (1-5).",
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 5
+          },
+          "creativeRange": {
+            "description": "How much to deviate from the original design.",
+            "enum": ["CREATIVE_RANGE_UNSPECIFIED", "REFINE", "EXPLORE", "REIMAGINE"],
+            "type": "string"
+          },
+          "aspects": {
+            "description": "Which design aspects to vary.",
+            "type": "array",
+            "items": {
+              "enum": ["ASPECT_UNSPECIFIED", "LAYOUT", "COLOR_SCHEME", "IMAGES", "TEXT_FONT", "TEXT_CONTENT"],
+              "type": "string"
+            }
+          }
+        },
+        "type": "object"
+      }
+    }
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "outputComponents": {
+        "description": "Array of output components with generated variant screens.",
+        "type": "array"
+      },
+      "projectId": { "type": "string" },
+      "sessionId": { "type": "string" }
+    },
+    "description": "Response message for GenerateVariants."
+  }
+}

package/docs/mcp-schemas/get_project.json

@@ -0,0 +1,137 @@
+{
+  "name": "get_project",
+  "description": "Retrieves the details of a specific Stitch project using its project name.\n\n**Input Requirements (CRITICAL):**\n\n1.  **`name` (string - MANDATORY):** The name of the project to retrieve. This must be in the format `projects/{project_id}`.\n",
+  "arguments": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "description": "Required. Identifier. The name of the project to retrieve. Format: projects/{project_id}",
+        "type": "string",
+        "x-google-identifier": true
+      }
+    },
+    "required": ["name"],
+    "description": "Request message for GetProject."
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "backgroundTheme": { "type": "string" },
+      "createTime": { "format": "date-time", "readOnly": true, "type": "string" },
+      "designTheme": {
+        "$ref": "#/$defs/DesignTheme",
+        "description": "Output only. The theme used to generate the first design in the project.",
+        "readOnly": true
+      },
+      "deviceType": {
+        "enum": ["DEVICE_TYPE_UNSPECIFIED", "MOBILE", "DESKTOP", "TABLET", "AGNOSTIC"],
+        "readOnly": true,
+        "type": "string"
+      },
+      "metadata": { "$ref": "#/$defs/ProjectMetadata" },
+      "name": {
+        "description": "Identifier. Format: projects/{project}",
+        "type": "string",
+        "x-google-identifier": true
+      },
+      "origin": {
+        "enum": ["ORIGIN_UNSPECIFIED", "STITCH", "IMPORTED_FROM_GALILEO"],
+        "readOnly": true,
+        "type": "string"
+      },
+      "projectType": {
+        "enum": [
+          "PROJECT_TYPE_UNSPECIFIED",
+          "TEXT_TO_UI",
+          "TEXT_TO_UI_PRO",
+          "TEXT_TO_UI_PRO_IMAGE_SPACE",
+          "IMAGE_TO_UI",
+          "IMAGE_TO_UI_PRO",
+          "PROJECT_DESIGN"
+        ],
+        "type": "string"
+      },
+      "readTime": { "format": "date-time", "readOnly": true, "type": "string" },
+      "screenInstances": {
+        "items": { "$ref": "#/$defs/ScreenInstance" },
+        "readOnly": true,
+        "type": "array"
+      },
+      "thumbnailScreenshot": { "$ref": "#/$defs/File" },
+      "title": { "type": "string" },
+      "updateTime": { "format": "date-time", "readOnly": true, "type": "string" },
+      "visibility": {
+        "enum": ["VISIBILITY_UNSPECIFIED", "PUBLIC", "PRIVATE"],
+        "type": "string"
+      }
+    },
+    "$defs": {
+      "DesignTheme": {
+        "description": "The theme of the design.",
+        "properties": {
+          "backgroundDark": { "type": "string" },
+          "backgroundLight": { "type": "string" },
+          "colorMode": {
+            "enum": ["COLOR_MODE_UNSPECIFIED", "LIGHT", "DARK"],
+            "type": "string"
+          },
+          "customColor": { "description": "Custom primary color (hex).", "type": "string" },
+          "description": { "type": "string" },
+          "font": {
+            "enum": [
+              "FONT_UNSPECIFIED",
+              "BE_VIETNAM_PRO", "EPILOGUE", "INTER", "LEXEND", "MANROPE",
+              "NEWSREADER", "NOTO_SERIF", "PLUS_JAKARTA_SANS", "PUBLIC_SANS",
+              "SPACE_GROTESK", "SPLINE_SANS", "WORK_SANS", "DOMINE",
+              "LIBRE_CASLON_TEXT", "EB_GARAMOND", "LITERATA", "SOURCE_SERIF_FOUR",
+              "MONTSERRAT", "METROPOLIS", "SOURCE_SANS_THREE", "NUNITO_SANS",
+              "ARIMO", "HANKEN_GROTESK", "RUBIK", "GEIST", "DM_SANS",
+              "IBM_PLEX_SANS", "SORA"
+            ],
+            "type": "string"
+          },
+          "preset": { "type": "string" },
+          "roundness": {
+            "description": "ROUND_TWO is deprecated/unused.",
+            "enum": ["ROUNDNESS_UNSPECIFIED", "ROUND_TWO", "ROUND_FOUR", "ROUND_EIGHT", "ROUND_TWELVE", "ROUND_FULL"],
+            "type": "string"
+          },
+          "saturation": { "description": "1–4", "format": "int32", "type": "integer" }
+        },
+        "type": "object"
+      },
+      "File": {
+        "properties": {
+          "downloadUrl": { "type": "string" },
+          "name": { "type": "string" }
+        },
+        "type": "object"
+      },
+      "ProjectMetadata": {
+        "properties": {
+          "isRemixed": { "type": "boolean" },
+          "userRole": { "enum": ["ROLE_UNSPECIFIED", "OWNER", "READER"], "type": "string" }
+        },
+        "type": "object"
+      },
+      "ScreenInstance": {
+        "description": "An instance of a screen on the project canvas.",
+        "properties": {
+          "groupId": { "type": "string" },
+          "groupName": { "type": "string" },
+          "height": { "format": "int32", "type": "integer" },
+          "hidden": { "type": "boolean" },
+          "id": { "type": "string" },
+          "label": { "type": "string" },
+          "sourceScreen": { "description": "Format: projects/{project}/screens/{screen}", "type": "string" },
+          "variantScreenInstance": { "$ref": "#/$defs/ScreenInstance" },
+          "width": { "format": "int32", "type": "integer" },
+          "x": { "format": "int32", "type": "integer" },
+          "y": { "format": "int32", "type": "integer" }
+        },
+        "type": "object"
+      }
+    },
+    "description": "A project is a single app."
+  }
+}

package/docs/mcp-schemas/get_screen.json

@@ -0,0 +1,92 @@
+{
+  "name": "get_screen",
+  "description": "Retrieves the details of a specific screen within a project.\n\n**Input Requirements (CRITICAL):**\n\n1.  **`project_id` (string - MANDATORY):** Numeric ID only — no `projects/` prefix. Example: `3780309359108792857`.\n2.  **`screen_id` (string - MANDATORY):** Numeric/hex screen ID — no path prefix. Example: `88805318abe84d16add098fae3add91e`.\n",
+  "arguments": {
+    "type": "object",
+    "properties": {
+      "projectId": {
+        "description": "Required. Numeric project ID only — do NOT include 'projects/' prefix.",
+        "type": "string"
+      },
+      "screenId": {
+        "description": "Required. Numeric/hex screen ID — do NOT include path prefix.",
+        "type": "string"
+      }
+    },
+    "required": ["projectId", "screenId"],
+    "description": "Request message for GetScreen."
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "deviceType": {
+        "description": "The device type of the screen.",
+        "enum": ["DEVICE_TYPE_UNSPECIFIED", "MOBILE", "DESKTOP", "TABLET", "AGNOSTIC"],
+        "type": "string"
+      },
+      "height": { "description": "Screen height in pixels.", "type": "string" },
+      "htmlCode": {
+        "$ref": "#/$defs/File",
+        "description": "The HTML code of the screen. Use downloadUrl to fetch the full HTML."
+      },
+      "name": {
+        "description": "Identifier. Format: projects/{project}/screens/{screen}",
+        "type": "string",
+        "x-google-identifier": true
+      },
+      "screenshot": {
+        "$ref": "#/$defs/File",
+        "description": "PNG screenshot. Use downloadUrl to download."
+      },
+      "title": { "description": "Output only. Generated screen title.", "readOnly": true, "type": "string" },
+      "width": { "description": "Screen width in pixels.", "type": "string" }
+    },
+    "$defs": {
+      "File": {
+        "description": "A File resource.",
+        "properties": {
+          "downloadUrl": {
+            "description": "URL to download this file. For images, this is a FIFE base URL.",
+            "type": "string"
+          },
+          "name": {
+            "description": "Identifier. Format: projects/{project}/files/{file}",
+            "type": "string",
+            "x-google-identifier": true
+          },
+          "userFeedback": {
+            "$ref": "#/$defs/UserFeedback",
+            "description": "Output only. Latest feedback for this file.",
+            "readOnly": true
+          }
+        },
+        "type": "object"
+      },
+      "UserFeedback": {
+        "description": "User feedback for a given interaction.",
+        "properties": {
+          "comment": { "type": "string" },
+          "designFeedbackReason": {
+            "enum": [
+              "DESIGN_FEEDBACK_REASON_UNSPECIFIED",
+              "DESIGN_DOESNT_MATCH_PROMPT",
+              "EDIT_DOESNT_MATCH_PROMPT",
+              "DESCRIPTION_DOESNT_MATCH",
+              "COMPONENT_ISSUE",
+              "INCORRECT_THEME",
+              "FIGMA_EXPORT_FAILED",
+              "OTHER"
+            ],
+            "type": "string"
+          },
+          "rating": {
+            "enum": ["RATING_UNSPECIFIED", "POSITIVE", "NEGATIVE"],
+            "type": "string"
+          }
+        },
+        "type": "object"
+      }
+    },
+    "description": "A screen generated by the agent."
+  }
+}

package/docs/mcp-schemas/list_design_systems.json

@@ -0,0 +1,32 @@
+{
+  "name": "list_design_systems",
+  "description": "Lists all available Stitch Design Systems, optionally filtered by project.\n",
+  "arguments": {
+    "type": "object",
+    "properties": {
+      "projectId": {
+        "description": "Optional. Numeric project ID to filter by. No 'projects/' prefix.",
+        "type": "string"
+      }
+    },
+    "description": "Request message for ListDesignSystems."
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "assets": {
+        "description": "Array of Asset objects containing design systems.",
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "name": { "description": "Asset identifier.", "type": "string" },
+            "displayName": { "type": "string" },
+            "designSystem": { "type": "object" }
+          }
+        }
+      }
+    },
+    "description": "Response message for ListDesignSystems."
+  }
+}