@kvasar/google-stitch 0.1.14 → 0.1.16

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "openclaw-google-stitch",
    "name": "Google Stitch MCP",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Integrates Google Stitch MCP services into OpenClaw",
    "skills": ["skills"],
   "configSchema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kvasar/google-stitch",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "OpenClaw plugin for Google Stitch UI generation, screen design, variants, and design systems",
   "type": "module",
   "main": "./src/index.ts",

package/skills/SKILL.md

@@ -85,7 +85,7 @@ Example prompts:
 
 ### Screen generation
 
-For new screens from prompts:
+For creating new screens from prompts:
 
 - `generate_screen_from_text`
 
@@ -96,12 +96,19 @@ Example prompts:
 - build landing page
 - design mobile onboarding
 
+Use this tool when the user wants to create a new UI screen from a text description.
+
 Always extract:
 
 - projectId
 - prompt
-- deviceType (optional)
-- modelId (optional)
+
+Important:
+- Screen generation usually takes a few minutes to complete
+- Do **not retry automatically** if a connection error or timeout occurs
+- A connection error does **not necessarily mean the generation failed**
+- After waiting a few minutes, use `get_screen` or `list_screens` to verify whether the screen was successfully created
+- Avoid duplicate retries to prevent generating the same screen multiple times
 
 ## Supported device types:
 
@@ -135,6 +142,33 @@ Always structure the tool call as:
 
 Never call the tool with only a string prompt.
 
+### List screens
+
+Lists all screens within a given Stitch project.
+
+- `list_screens`
+
+Required parameters:
+- `projectId`: the Stitch project ID (without the `projects/` prefix)
+
+Use this tool when the user wants to:
+- see all generated screens in a project
+- review existing designs
+- inspect project screens before updating or exporting
+
+Example prompts:
+- List all screens in project 12345
+- Show me all screens for project 4044680601076201931
+- What screens are in project 12345?
+- Show me the designs in this project
+- List the generated UI screens for project 12345
+
+Returns:
+- Array of `Screen` objects
+- Includes fields such as `name`, `title`, `prompt`, `deviceType`, `width`, `height`, and grouping metadata
+
+---
+
 ### Screen editing
 
 For modifying existing screens:

package/src/tools/list_screens.ts

@@ -1,7 +1,20 @@
-export const listScreensTool = (client:any) => ({
+import { StitchMCPClient } from "../services/stitch-mcp-client.js";
+
+interface ListScreensParams {
+  projectId: string;
+}
+
+export const listScreensTool = (client: StitchMCPClient) => ({
   name: "list_screens",
-  description: "list screens",
-  async execute(_: string, params: any) {
-    return await client.request?.("list_screens", params);
+  description: "Lists all screens within a given Stitch project",
+
+  async execute(_: string, params: ListScreensParams) {
+    if (!params?.projectId) {
+      throw new Error("projectId is required");
+    }
+
+    return client.request("list_screens", {
+      projectId: params.projectId,
+    });
   },
-});
+});