stitch-kit 1.5.0

package/docs/mcp-naming-convention.md

@@ -0,0 +1,64 @@
+# Stitch MCP Naming Convention
+
+## Rule
+
+MCP wrapper skills follow the pattern: `stitch-mcp-<tool>` where `<tool>` is the MCP tool name with underscores replaced by hyphens.
+
+```
+MCP tool name (snake_case) → skill name (kebab-case)
+generate_screen_from_text  → stitch-mcp-generate-screen-from-text
+```
+
+## Tool → skill mapping
+
+| MCP tool name | Skill name |
+|---------------|-----------|
+| `create_project` | `stitch-mcp-create-project` |
+| `list_projects` | `stitch-mcp-list-projects` |
+| `get_project` | `stitch-mcp-get-project` |
+| `generate_screen_from_text` | `stitch-mcp-generate-screen-from-text` |
+| `list_screens` | `stitch-mcp-list-screens` |
+| `get_screen` | `stitch-mcp-get-screen` |
+
+## ID formats — the most common source of errors
+
+Different Stitch MCP tools expect different ID formats. **Agents fail this constantly without explicit guidance.**
+
+### projectId formats
+
+| Tool | projectId format | Example |
+|------|-----------------|---------|
+| `get_project` | `projects/NUMERIC_ID` | `projects/3780309359108792857` |
+| `list_screens` | `projects/NUMERIC_ID` | `projects/3780309359108792857` |
+| `generate_screen_from_text` | **numeric only** | `3780309359108792857` |
+| `get_screen` | **numeric only** | `3780309359108792857` |
+
+### screenId formats
+
+| Tool | screenId format | Example |
+|------|----------------|---------|
+| `get_screen` | **numeric/alphanumeric only** | `88805abc123def456` |
+
+**Never pass `projects/ID` to `generate_screen_from_text` or `get_screen`.**
+
+### Correct vs. wrong
+
+```
+✅ generate_screen_from_text projectId: "3780309359108792857"
+❌ generate_screen_from_text projectId: "projects/3780309359108792857"
+
+✅ get_screen projectId: "3780309359108792857", screenId: "88805abc123def456"
+❌ get_screen projectId: "projects/3780309359108792857", screenId: "screens/88805abc123def456"
+
+✅ list_screens projectId: "projects/3780309359108792857"
+❌ list_screens projectId: "3780309359108792857"
+```
+
+## Tool prefix discovery
+
+The MCP tool namespace prefix varies by client configuration (e.g. `stitch:`, `mcp__stitch__`, `mcp_stitch__stitch:`). Always run `list_tools` first to discover the prefix, then use it for all subsequent calls.
+
+## References
+
+- Stitch MCP setup: https://stitch.withgoogle.com/docs/mcp/guide/
+- `skills-index.md` — full skills table

package/docs/mcp-schemas/README.md

@@ -0,0 +1,130 @@
+# Stitch MCP API Schemas
+
+Formal JSON Schema definitions for all 14 Stitch MCP tools.
+
+Each file documents the full `arguments` (input) and `outputSchema` (output) for one tool.
+
+---
+
+## Files
+
+### Project management
+
+| File | Tool | Purpose |
+|------|------|---------|
+| `create_project.json` | `create_project` | Create a new project. Returns `projects/{id}` in `name`. |
+| `get_project.json` | `get_project` | Get full project details. Input: `projects/{id}` format. |
+| `list_projects.json` | `list_projects` | List owned/shared projects. Filter: `view=owned` or `view=shared`. |
+| `delete_project.json` | `delete_project` | Permanently delete a project. Input: `projects/{id}` format. Irreversible. |
+
+### Screen operations
+
+| File | Tool | Purpose |
+|------|------|---------|
+| `generate_screen_from_text.json` | `generate_screen_from_text` | Generate a screen from a prompt. Input: **numeric project ID only**. |
+| `upload_screens_from_images.json` | `upload_screens_from_images` | Upload images as new screens. Input: **numeric project ID**, base64 images. |
+| `edit_screens.json` | `edit_screens` | Edit existing screens with text prompts. Input: **numeric IDs only**. |
+| `generate_variants.json` | `generate_variants` | Generate design variants. Input: **numeric IDs**, variant options. |
+| `list_screens.json` | `list_screens` | List screens in a project. Input: `projects/{id}` format. |
+| `get_screen.json` | `get_screen` | Get screen HTML + screenshot. Input: **numeric IDs only**. |
+
+### Design systems
+
+| File | Tool | Purpose |
+|------|------|---------|
+| `create_design_system.json` | `create_design_system` | Create a reusable design system. Optional numeric `projectId`. |
+| `update_design_system.json` | `update_design_system` | Update an existing design system. Requires asset `name`. |
+| `list_design_systems.json` | `list_design_systems` | List available design systems. Optional numeric `projectId`. |
+| `apply_design_system.json` | `apply_design_system` | Apply a design system to screens. **Numeric IDs** + `assetId`. |
+
+---
+
+## Key insights from the schemas
+
+### DesignTheme — 28 available fonts
+
+All tools that return design data include a `DesignTheme` object. The `font` field accepts these enum values:
+
+**Sans-serif (modern):**
+`INTER`, `GEIST`, `DM_SANS`, `MANROPE`, `PLUS_JAKARTA_SANS`, `WORK_SANS`,
+`PUBLIC_SANS`, `SOURCE_SANS_THREE`, `NUNITO_SANS`, `SPACE_GROTESK`,
+`BE_VIETNAM_PRO`, `LEXEND`, `EPILOGUE`, `HANKEN_GROTESK`, `SPLINE_SANS`,
+`RUBIK`, `ARIMO`, `SORA`, `METROPOLIS`, `MONTSERRAT`, `IBM_PLEX_SANS`
+
+**Serif:**
+`NOTO_SERIF`, `NEWSREADER`, `DOMINE`, `LIBRE_CASLON_TEXT`, `EB_GARAMOND`,
+`LITERATA`, `SOURCE_SERIF_FOUR`
+
+### DesignTheme — roundness values
+
+| Enum | Meaning | Use for |
+|------|---------|---------|
+| `ROUND_FOUR` | `border-radius: 4px` | Sharp / enterprise |
+| `ROUND_EIGHT` | `border-radius: 8px` | Modern / balanced |
+| `ROUND_TWELVE` | `border-radius: 12px` | Friendly / consumer |
+| `ROUND_FULL` | `border-radius: 9999px` | Pill buttons |
+| `ROUND_TWO` | — | **Deprecated / unused** |
+
+### DesignTheme — saturation
+
+Integer 1–4. Higher = more vivid colors. Default (unset) is neutral.
+
+### outputComponents pattern
+
+Multiple tools (`generate_screen_from_text`, `edit_screens`, `generate_variants`) return `outputComponents[]`. Each item has one of:
+- `text` — agent text response, return to user
+- `suggestion` — follow-up prompt suggestion, present to user; if accepted, use as next prompt
+- `design` — the generated design object containing `screens[]` with `theme`, `deviceType`
+
+### generate_variants — variantOptions
+
+| Field | Type | Values |
+|-------|------|--------|
+| `variantCount` | int | 1–5 |
+| `creativeRange` | enum | `REFINE`, `EXPLORE`, `REIMAGINE` |
+| `aspects` | array | `LAYOUT`, `COLOR_SCHEME`, `IMAGES`, `TEXT_FONT`, `TEXT_CONTENT` |
+
+### Model selection
+
+| modelId | Description |
+|---------|-------------|
+| `GEMINI_3_FLASH` | Default. Faster. |
+| `GEMINI_3_PRO` | Thinking model. Higher quality. Slower. |
+
+### ScreenMetadata — agentType
+
+`GEMINI_3_AGENT` = the Gemini 3.0 Thinking model (maps to `GEMINI_3_PRO` model selection).
+
+### componentRegions
+
+`generate_screen_from_text` responses include `componentRegions[]` in `screenMetadata`.
+Each region has:
+- `type` — `COMPONENT_TYPE_IMAGE | TEXT | BUTTON | INPUT | CONTAINER`
+- `boundingBox` — `{x, y, width, height}` in pixels relative to screen dimensions
+- `xpath` — XPath to locate the element in the HTML
+- `description` — human-readable label
+
+Useful for: targeted HTML extraction, component-level conversion, design audits.
+
+---
+
+## ID format reference (the #1 source of bugs)
+
+| Tool | projectId format | screenId format | Other IDs |
+|------|-----------------|----------------|-----------|
+| `create_project` | — (returns `projects/NUMERIC`) | — | — |
+| `get_project` | `projects/NUMERIC` | — | — |
+| `list_projects` | — | — | — |
+| `delete_project` | `projects/NUMERIC` | — | — |
+| `generate_screen_from_text` | **NUMERIC only** | — | — |
+| `upload_screens_from_images` | **NUMERIC only** | — | — |
+| `edit_screens` | **NUMERIC only** | **NUMERIC array** | — |
+| `generate_variants` | **NUMERIC only** | **NUMERIC array** | — |
+| `list_screens` | `projects/NUMERIC` | — | — |
+| `get_screen` | **NUMERIC only** | **NUMERIC only** | — |
+| `create_design_system` | **NUMERIC** (optional) | — | Returns Asset `name` |
+| `update_design_system` | — | — | Asset `name` required |
+| `list_design_systems` | **NUMERIC** (optional) | — | Returns Asset names |
+| `apply_design_system` | **NUMERIC only** | **NUMERIC array** | `assetId` required |
+
+See `../mcp-naming-convention.md` for the full breakdown.

package/docs/mcp-schemas/apply_design_system.json

@@ -0,0 +1,36 @@
+{
+  "name": "apply_design_system",
+  "description": "Applies a Stitch Design System to one or more existing screens, updating their visual theme.\n\n**Input Requirements (CRITICAL):**\n1. **`projectId` (string - MANDATORY):** Numeric ID only.\n2. **`selectedScreenIds` (array - MANDATORY):** Numeric screen IDs.\n3. **`assetId` (string - MANDATORY):** Design system asset identifier.\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 apply the design system to.",
+        "type": "array",
+        "items": { "type": "string" }
+      },
+      "assetId": {
+        "description": "Required. The design system asset identifier from list or create operations.",
+        "type": "string"
+      }
+    },
+    "required": ["projectId", "selectedScreenIds", "assetId"],
+    "description": "Request message for ApplyDesignSystem."
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "outputComponents": {
+        "description": "Array of output components with updated screen data.",
+        "type": "array"
+      },
+      "projectId": { "type": "string" },
+      "sessionId": { "type": "string" }
+    },
+    "description": "Response message for ApplyDesignSystem."
+  }
+}

package/docs/mcp-schemas/create_design_system.json

@@ -0,0 +1,78 @@
+{
+  "name": "create_design_system",
+  "description": "Creates a new Stitch Design System — a reusable theme configuration (colors, fonts, roundness, saturation) that can be applied to screens.\n",
+  "arguments": {
+    "type": "object",
+    "properties": {
+      "designSystem": {
+        "$ref": "#/$defs/DesignSystemInput",
+        "description": "Required. The design system to create."
+      },
+      "projectId": {
+        "description": "Optional. Numeric project ID to associate with. No 'projects/' prefix.",
+        "type": "string"
+      }
+    },
+    "required": ["designSystem"],
+    "description": "Request message for CreateDesignSystem.",
+    "$defs": {
+      "DesignSystemInput": {
+        "description": "A design system definition.",
+        "properties": {
+          "displayName": {
+            "description": "Required. Human-readable name.",
+            "type": "string"
+          },
+          "theme": {
+            "$ref": "#/$defs/DesignTheme",
+            "description": "Required. Visual theme configuration."
+          },
+          "designTokens": {
+            "description": "Optional. CSS custom properties or token definitions.",
+            "type": "string"
+          },
+          "styleGuidelines": {
+            "description": "Optional. Natural-language design rules.",
+            "type": "string"
+          }
+        },
+        "required": ["displayName", "theme"],
+        "type": "object"
+      },
+      "DesignTheme": {
+        "description": "Visual theme configuration.",
+        "properties": {
+          "colorMode": { "enum": ["COLOR_MODE_UNSPECIFIED", "LIGHT", "DARK"], "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"
+          },
+          "roundness": { "enum": ["ROUNDNESS_UNSPECIFIED", "ROUND_FOUR", "ROUND_EIGHT", "ROUND_TWELVE", "ROUND_FULL"], "type": "string" },
+          "saturation": { "type": "integer", "minimum": 1, "maximum": 4 },
+          "customColor": { "description": "Primary color (hex).", "type": "string" },
+          "backgroundLight": { "description": "Light mode background (hex).", "type": "string" },
+          "backgroundDark": { "description": "Dark mode background (hex).", "type": "string" },
+          "preset": { "type": "string" },
+          "description": { "type": "string" }
+        },
+        "type": "object"
+      }
+    }
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "name": { "description": "Asset identifier. Format: assets/{asset_id}", "type": "string" },
+      "displayName": { "type": "string" },
+      "designSystem": { "description": "The created design system object.", "type": "object" }
+    },
+    "description": "Asset response for CreateDesignSystem."
+  }
+}

package/docs/mcp-schemas/create_project.json

@@ -0,0 +1,290 @@
+{
+  "name": "create_project",
+  "description": "Creates a new Stitch project. A project is a container for UI designs and frontend code.\n",
+  "arguments": {
+    "type": "object",
+    "properties": {
+      "title": {
+        "description": "Optional. The title of the project.",
+        "type": "string"
+      }
+    },
+    "description": "Request message for CreateProject."
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "backgroundTheme": {
+        "description": "Optional. The background theme of the project.",
+        "type": "string"
+      },
+      "createTime": {
+        "description": "Output only. The time when the project was created.",
+        "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": {
+        "description": "Output only. The device type of the project.",
+        "enum": [
+          "DEVICE_TYPE_UNSPECIFIED",
+          "MOBILE",
+          "DESKTOP",
+          "TABLET",
+          "AGNOSTIC"
+        ],
+        "readOnly": true,
+        "type": "string",
+        "x-google-enum-descriptions": [
+          "Unspecified device type.",
+          "A design for a mobile device.",
+          "A design for a desktop device.",
+          "A design for a tablet device.",
+          "A design that is not tied to a specific device."
+        ]
+      },
+      "metadata": {
+        "$ref": "#/$defs/ProjectMetadata",
+        "description": "Metadata of the project."
+      },
+      "name": {
+        "description": "Identifier. The resource name of the project. Format: projects/{project}",
+        "type": "string",
+        "x-google-identifier": true
+      },
+      "origin": {
+        "description": "Output only. The origin of the project.",
+        "enum": [
+          "ORIGIN_UNSPECIFIED",
+          "STITCH",
+          "IMPORTED_FROM_GALILEO"
+        ],
+        "readOnly": true,
+        "type": "string",
+        "x-google-enum-descriptions": [
+          "Unspecified origin. By default, the project is created from Stitch.",
+          "The project is created from Stitch.",
+          "The project is imported from Galileo."
+        ]
+      },
+      "projectType": {
+        "description": "Optional. The type of the project. If not specified, the project is a text to UI project.",
+        "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",
+        "x-google-enum-descriptions": [
+          "Unspecified project type. By default, the project is a text to UI project.",
+          "A text to UI project.",
+          "Pro version of text to UI project.",
+          "Deprecated. Pro version of text to UI project using image space for edits.",
+          "An image to UI project.",
+          "Deprecated.",
+          "A new design project."
+        ]
+      },
+      "readTime": {
+        "description": "Output only. The time the project was last read. Populated only when listing recently viewed projects.",
+        "format": "date-time",
+        "readOnly": true,
+        "type": "string"
+      },
+      "screenInstances": {
+        "description": "Output only. The screen instances on this project.",
+        "items": {
+          "$ref": "#/$defs/ScreenInstance"
+        },
+        "readOnly": true,
+        "type": "array"
+      },
+      "thumbnailScreenshot": {
+        "$ref": "#/$defs/File",
+        "description": "Optional. The screenshot to be used as the thumbnail for the project."
+      },
+      "title": {
+        "description": "Optional. The title of the project.",
+        "type": "string"
+      },
+      "updateTime": {
+        "description": "Output only. The time when the project was last updated.",
+        "format": "date-time",
+        "readOnly": true,
+        "type": "string"
+      },
+      "visibility": {
+        "description": "Optional. The visibility setting of the project.",
+        "enum": [
+          "VISIBILITY_UNSPECIFIED",
+          "PUBLIC",
+          "PRIVATE"
+        ],
+        "type": "string",
+        "x-google-enum-descriptions": [
+          "Unspecified visibility. By default, the project is private.",
+          "The project is visible to all users, and may be featured in the feed.",
+          "The project is visible to only the creator."
+        ]
+      }
+    },
+    "$defs": {
+      "DesignTheme": {
+        "description": "The theme of the design.",
+        "properties": {
+          "backgroundDark": {
+            "description": "Optional. The background color for dark mode (hex format, e.g., \"#1a1a1a\").",
+            "type": "string"
+          },
+          "backgroundLight": {
+            "description": "Optional. The background color for light mode (hex format, e.g., \"#f8f8f8\").",
+            "type": "string"
+          },
+          "colorMode": {
+            "description": "Optional. The mode of appearance of the design.",
+            "enum": [
+              "COLOR_MODE_UNSPECIFIED",
+              "LIGHT",
+              "DARK"
+            ],
+            "type": "string"
+          },
+          "customColor": {
+            "description": "Optional. A custom theme primary color (hex).",
+            "type": "string"
+          },
+          "description": {
+            "description": "Optional. A brief description of the theme aesthetic.",
+            "type": "string"
+          },
+          "font": {
+            "description": "Optional. The font of the design.",
+            "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": {
+            "description": "Optional. The preset color of the design.",
+            "type": "string"
+          },
+          "roundness": {
+            "description": "Optional. The roundness of the design. ROUND_TWO is deprecated/unused.",
+            "enum": [
+              "ROUNDNESS_UNSPECIFIED",
+              "ROUND_TWO",
+              "ROUND_FOUR",
+              "ROUND_EIGHT",
+              "ROUND_TWELVE",
+              "ROUND_FULL"
+            ],
+            "type": "string"
+          },
+          "saturation": {
+            "description": "Optional. The saturation of the design between 1 and 4.",
+            "format": "int32",
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "File": {
+        "description": "A File resource.",
+        "properties": {
+          "downloadUrl": {
+            "description": "Optional. The URL of the file for download. For image files, this would be FIFE base URLs.",
+            "type": "string"
+          },
+          "name": {
+            "description": "Identifier. The resource name of the file. Format: projects/{project}/files/{file}",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "ProjectMetadata": {
+        "description": "Metadata relating to the project.",
+        "properties": {
+          "isRemixed": {
+            "description": "Whether this project was remixed or not.",
+            "type": "boolean"
+          },
+          "userRole": {
+            "description": "The Role of the user accessing the project.",
+            "enum": [
+              "ROLE_UNSPECIFIED",
+              "OWNER",
+              "READER"
+            ],
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "ScreenInstance": {
+        "description": "An instance of a screen on the project canvas.",
+        "properties": {
+          "groupId": {
+            "description": "Optional. Group identifier for Genie Agent output grouping.",
+            "type": "string"
+          },
+          "groupName": {
+            "description": "Optional. Human-readable name for the group (e.g., \"Warm Minimalism\").",
+            "type": "string"
+          },
+          "height": { "format": "int32", "type": "integer" },
+          "hidden": { "description": "User hid this screen from canvas.", "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/delete_project.json

@@ -0,0 +1,20 @@
+{
+  "name": "delete_project",
+  "description": "Permanently deletes a Stitch project and all its screens, designs, and history. This action is irreversible.\n",
+  "arguments": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "description": "Required. The resource name of the project to delete. Format: projects/{project}",
+        "type": "string"
+      }
+    },
+    "required": ["name"],
+    "description": "Request message for DeleteProject."
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {},
+    "description": "Empty response on success."
+  }
+}

package/docs/mcp-schemas/edit_screens.json

@@ -0,0 +1,46 @@
+{
+  "name": "edit_screens",
+  "description": "Edits existing screens within a project using a text prompt. The primary iteration tool — modify colors, layout, content, or style without regenerating from scratch.\n\n**Input Requirements (CRITICAL):**\n1. **`projectId` (string - MANDATORY):** Numeric ID only.\n2. **`selectedScreenIds` (array - MANDATORY):** Numeric screen IDs, no prefix.\n3. **`prompt` (string - MANDATORY):** The edit instruction.\n\n**Instructions:**\n* This action can take a few minutes. DO NOT RETRY.\n* If `output_components` contains suggestions, present them to the user.\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 edit. No 'projects/' or 'screens/' prefix.",
+        "type": "array",
+        "items": { "type": "string" }
+      },
+      "prompt": {
+        "description": "Required. The text prompt describing the desired edits.",
+        "type": "string"
+      },
+      "deviceType": {
+        "description": "Optional. The device type context for the edit.",
+        "enum": ["DEVICE_TYPE_UNSPECIFIED", "MOBILE", "DESKTOP", "TABLET", "AGNOSTIC"],
+        "type": "string"
+      },
+      "modelId": {
+        "description": "Optional. GEMINI_3_PRO for complex edits, GEMINI_3_FLASH for simple changes.",
+        "enum": ["MODEL_ID_UNSPECIFIED", "GEMINI_3_PRO", "GEMINI_3_FLASH"],
+        "type": "string"
+      }
+    },
+    "required": ["projectId", "selectedScreenIds", "prompt"],
+    "description": "Request message for EditScreens."
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "outputComponents": {
+        "description": "Array of output components. May contain text responses, design objects, or suggestions.",
+        "type": "array"
+      },
+      "projectId": { "type": "string" },
+      "sessionId": { "type": "string" }
+    },
+    "description": "Response message for EditScreens."
+  }
+}