@google/stitch-sdk 0.0.1

package/dist/generated/src/tool-definitions.js

@@ -0,0 +1,333 @@
+/** All tools available on the Stitch MCP server, generated from tools-manifest.json. */
+export const toolDefinitions = [
+    {
+        "name": "create_project",
+        "description": "Creates a new Stitch project. A project is a container for UI designs and frontend code.\n",
+        "inputSchema": {
+            "description": "Request message for CreateProject.",
+            "properties": {
+                "title": {
+                    "description": "Optional. The title of the project.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        }
+    },
+    {
+        "name": "get_project",
+        "description": "Retrieves the details of a specific Stitch project using its project name.\n",
+        "inputSchema": {
+            "description": "Request message for GetProject.",
+            "properties": {
+                "name": {
+                    "description": "Required. Identifier. The resource name of the project to retrieve. Format: `projects/{project}` Example: `projects/4044680601076201931`",
+                    "type": "string",
+                    "x-google-identifier": true
+                }
+            },
+            "required": [
+                "name"
+            ],
+            "type": "object"
+        }
+    },
+    {
+        "name": "list_projects",
+        "description": "Lists all Stitch projects accessible to the user. By default, it lists projects owned by the user.\n",
+        "inputSchema": {
+            "description": "Request message for ListProjects.",
+            "properties": {
+                "filter": {
+                    "description": "Optional. A filter to apply to the list of projects, following a subset of AIP-160. This service supports filtering on the `view` field. Supported filters: * `view=owned`: Lists only projects owned by the user. This is the default behavior if no filter is specified. * `view=shared`: Lists only projects shared with the user. Example: `view=owned`",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        }
+    },
+    {
+        "name": "list_screens",
+        "description": "Lists all screens within a given Stitch project.\n",
+        "inputSchema": {
+            "description": "Request message for ListScreens.",
+            "properties": {
+                "projectId": {
+                    "description": "Required. Identifier. The project ID to list screens for, example: '4044680601076201931', without the `projects/` prefix.",
+                    "type": "string",
+                    "x-google-identifier": true
+                }
+            },
+            "required": [
+                "projectId"
+            ],
+            "type": "object"
+        }
+    },
+    {
+        "name": "get_screen",
+        "description": "Retrieves the details of a specific screen within a project.\n",
+        "inputSchema": {
+            "description": "Request message for GetScreen.",
+            "properties": {
+                "name": {
+                    "description": "Required. Identifier. The resource name of the screen to retrieve. Format: `projects/{project}/screens/{screen}` Example: `projects/4044680601076201931/screens/98b50e2ddc9943efb387052637738f61`",
+                    "type": "string",
+                    "x-google-identifier": true
+                },
+                "projectId": {
+                    "deprecated": true,
+                    "description": "Required. The project ID of screen to retrieve. Example: `4044680601076201931`, without the `projects/` prefix.",
+                    "type": "string"
+                },
+                "screenId": {
+                    "deprecated": true,
+                    "description": "Required. The screen ID of screen to retrieve. Example: `98b50e2ddc9943efb387052637738f61`, without the `screens/` prefix.",
+                    "type": "string"
+                }
+            },
+            "required": [
+                "name",
+                "projectId",
+                "screenId"
+            ],
+            "type": "object"
+        }
+    },
+    {
+        "name": "generate_screen_from_text",
+        "description": "Generates a new screen within a project from a text prompt.\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. Please try to get the screen with `get_screen` method later.\n\n**Output:**\n*  **`output_components`**: If `output_components` contains text, return it to the user. If `output_components` contains suggestions (e.g. \"Yes, make them all\"), present these suggestions to the user. If the user accepts one of the suggestions, call `generate_screen_from_text` again with `prompt` set to the accepted suggestion.\n",
+        "inputSchema": {
+            "description": "Request message for GenerateScreenFromText.",
+            "properties": {
+                "deviceType": {
+                    "description": "The type of device that captured the screenshot, e.g., mobile or desktop.",
+                    "enum": [
+                        "DEVICE_TYPE_UNSPECIFIED",
+                        "MOBILE",
+                        "DESKTOP",
+                        "TABLET",
+                        "AGNOSTIC"
+                    ],
+                    "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."
+                    ]
+                },
+                "modelId": {
+                    "description": "Optional. The model to use for generation.",
+                    "enum": [
+                        "MODEL_ID_UNSPECIFIED",
+                        "GEMINI_3_PRO",
+                        "GEMINI_3_FLASH"
+                    ],
+                    "type": "string",
+                    "x-google-enum-descriptions": [
+                        "Unspecified model.",
+                        "Gemini 3 Pro.",
+                        "Gemini 3 Flash."
+                    ]
+                },
+                "projectId": {
+                    "description": "Required. The project ID to generate the screen for, example: '4044680601076201931', without the `projects/` prefix.",
+                    "type": "string"
+                },
+                "prompt": {
+                    "description": "Required. The input text to generate the screen from.",
+                    "type": "string"
+                }
+            },
+            "required": [
+                "projectId",
+                "prompt"
+            ],
+            "type": "object"
+        }
+    },
+    {
+        "name": "edit_screens",
+        "description": "Edits existing screens within a project using a text prompt.\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 process may still succeed.\n",
+        "inputSchema": {
+            "description": "Request message for EditScreens.",
+            "properties": {
+                "deviceType": {
+                    "description": "Optional. The type of device that captured the screenshot, e.g., mobile or desktop.",
+                    "enum": [
+                        "DEVICE_TYPE_UNSPECIFIED",
+                        "MOBILE",
+                        "DESKTOP",
+                        "TABLET",
+                        "AGNOSTIC"
+                    ],
+                    "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."
+                    ]
+                },
+                "modelId": {
+                    "description": "Optional. The model to use for generation.",
+                    "enum": [
+                        "MODEL_ID_UNSPECIFIED",
+                        "GEMINI_3_PRO",
+                        "GEMINI_3_FLASH"
+                    ],
+                    "type": "string",
+                    "x-google-enum-descriptions": [
+                        "Unspecified model.",
+                        "Gemini 3 Pro.",
+                        "Gemini 3 Flash."
+                    ]
+                },
+                "projectId": {
+                    "description": "Required. The project ID of screens to edit, example: '4044680601076201931', without the `projects/` prefix.",
+                    "type": "string"
+                },
+                "prompt": {
+                    "description": "Required. The input text to generate the screen from.",
+                    "type": "string"
+                },
+                "selectedScreenIds": {
+                    "description": "Required. The screen IDs of screens to edit, example: ['98b50e2ddc9943efb387052637738f61', '98b50e2ddc9943efb387052637738f62'], without the `screens/` prefix.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                }
+            },
+            "required": [
+                "projectId",
+                "selectedScreenIds",
+                "prompt"
+            ],
+            "type": "object"
+        }
+    },
+    {
+        "name": "generate_variants",
+        "description": "Generates variants of existing screens within a project using a text prompt.\n",
+        "inputSchema": {
+            "$defs": {
+                "VariantOptions": {
+                    "description": "Configuration options for design variant generation. This message captures all parameters used to generate variants, allowing the configuration to be stored, replayed, or analyzed.",
+                    "properties": {
+                        "aspects": {
+                            "description": "Optional. Specific aspects to focus on. If empty, all aspects may be varied.",
+                            "items": {
+                                "enum": [
+                                    "VARIANT_ASPECT_UNSPECIFIED",
+                                    "LAYOUT",
+                                    "COLOR_SCHEME",
+                                    "IMAGES",
+                                    "TEXT_FONT",
+                                    "TEXT_CONTENT"
+                                ],
+                                "type": "string",
+                                "x-google-enum-descriptions": [
+                                    "Unspecified aspect.",
+                                    "Layout: Arrangement of elements on the screen.",
+                                    "Color scheme: Colors used on the screen.",
+                                    "Images: Images used on the screen.",
+                                    "Text font: Fonts used for text on the screen.",
+                                    "Text content: Text content on the screen."
+                                ]
+                            },
+                            "type": "array"
+                        },
+                        "creativeRange": {
+                            "description": "Optional. Creative range for variations. Default: EXPLORE",
+                            "enum": [
+                                "CREATIVE_RANGE_UNSPECIFIED",
+                                "REFINE",
+                                "EXPLORE",
+                                "REIMAGINE"
+                            ],
+                            "type": "string",
+                            "x-google-enum-descriptions": [
+                                "Unspecified creative range.",
+                                "Subtle refinements, closely adhering to original.",
+                                "Balanced exploration. Default.",
+                                "Radical explorations, fundamentally challenging the original."
+                            ]
+                        },
+                        "variantCount": {
+                            "description": "Optional. Number of variants to generate (1-5). Default: 3",
+                            "format": "int32",
+                            "type": "integer"
+                        }
+                    },
+                    "type": "object"
+                }
+            },
+            "description": "Request message for GenerateVariants.",
+            "properties": {
+                "deviceType": {
+                    "description": "Optional. The type of device that captured the screenshot, e.g., mobile or desktop.",
+                    "enum": [
+                        "DEVICE_TYPE_UNSPECIFIED",
+                        "MOBILE",
+                        "DESKTOP",
+                        "TABLET",
+                        "AGNOSTIC"
+                    ],
+                    "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."
+                    ]
+                },
+                "modelId": {
+                    "description": "Optional. The model to use for generation.",
+                    "enum": [
+                        "MODEL_ID_UNSPECIFIED",
+                        "GEMINI_3_PRO",
+                        "GEMINI_3_FLASH"
+                    ],
+                    "type": "string",
+                    "x-google-enum-descriptions": [
+                        "Unspecified model.",
+                        "Gemini 3 Pro.",
+                        "Gemini 3 Flash."
+                    ]
+                },
+                "projectId": {
+                    "description": "Required. The project ID of screens to generate variants for, example: '4044680601076201931', without the `projects/` prefix.",
+                    "type": "string"
+                },
+                "prompt": {
+                    "description": "Required. The input text used to generate the variants.",
+                    "type": "string"
+                },
+                "selectedScreenIds": {
+                    "description": "Required. The screen ids of screen to generate variants for, example: ['98b50e2ddc9943efb387052637738f61', '98b50e2ddc9943efb387052637738f62'], without the `screens/` prefix.",
+                    "items": {
+                        "type": "string"
+                    },
+                    "type": "array"
+                },
+                "variantOptions": {
+                    "$ref": "#/$defs/VariantOptions",
+                    "description": "Required. The variant options for generation, including the number of variants, creative range, and aspects to focus on."
+                }
+            },
+            "required": [
+                "projectId",
+                "selectedScreenIds",
+                "prompt",
+                "variantOptions"
+            ],
+            "type": "object"
+        }
+    }
+];
+//# sourceMappingURL=tool-definitions.js.map

package/dist/generated/src/tool-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-definitions.js","sourceRoot":"","sources":["../../../generated/src/tool-definitions.ts"],"names":[],"mappings":"AAkBA,wFAAwF;AACxF,MAAM,CAAC,MAAM,eAAe,GAAqB;IAC/C;QACE,MAAM,EAAE,gBAAgB;QACxB,aAAa,EAAE,4FAA4F;QAC3G,aAAa,EAAE;YACb,aAAa,EAAE,oCAAoC;YACnD,YAAY,EAAE;gBACZ,OAAO,EAAE;oBACP,aAAa,EAAE,qCAAqC;oBACpD,MAAM,EAAE,QAAQ;iBACjB;aACF;YACD,MAAM,EAAE,QAAQ;SACjB;KACF;IACD;QACE,MAAM,EAAE,aAAa;QACrB,aAAa,EAAE,8EAA8E;QAC7F,aAAa,EAAE;YACb,aAAa,EAAE,iCAAiC;YAChD,YAAY,EAAE;gBACZ,MAAM,EAAE;oBACN,aAAa,EAAE,0IAA0I;oBACzJ,MAAM,EAAE,QAAQ;oBAChB,qBAAqB,EAAE,IAAI;iBAC5B;aACF;YACD,UAAU,EAAE;gBACV,MAAM;aACP;YACD,MAAM,EAAE,QAAQ;SACjB;KACF;IACD;QACE,MAAM,EAAE,eAAe;QACvB,aAAa,EAAE,sGAAsG;QACrH,aAAa,EAAE;YACb,aAAa,EAAE,mCAAmC;YAClD,YAAY,EAAE;gBACZ,QAAQ,EAAE;oBACR,aAAa,EAAE,6VAA6V;oBAC5W,MAAM,EAAE,QAAQ;iBACjB;aACF;YACD,MAAM,EAAE,QAAQ;SACjB;KACF;IACD;QACE,MAAM,EAAE,cAAc;QACtB,aAAa,EAAE,oDAAoD;QACnE,aAAa,EAAE;YACb,aAAa,EAAE,kCAAkC;YACjD,YAAY,EAAE;gBACZ,WAAW,EAAE;oBACX,aAAa,EAAE,2HAA2H;oBAC1I,MAAM,EAAE,QAAQ;oBAChB,qBAAqB,EAAE,IAAI;iBAC5B;aACF;YACD,UAAU,EAAE;gBACV,WAAW;aACZ;YACD,MAAM,EAAE,QAAQ;SACjB;KACF;IACD;QACE,MAAM,EAAE,YAAY;QACpB,aAAa,EAAE,gEAAgE;QAC/E,aAAa,EAAE;YACb,aAAa,EAAE,gCAAgC;YAC/C,YAAY,EAAE;gBACZ,MAAM,EAAE;oBACN,aAAa,EAAE,mMAAmM;oBAClN,MAAM,EAAE,QAAQ;oBAChB,qBAAqB,EAAE,IAAI;iBAC5B;gBACD,WAAW,EAAE;oBACX,YAAY,EAAE,IAAI;oBAClB,aAAa,EAAE,iHAAiH;oBAChI,MAAM,EAAE,QAAQ;iBACjB;gBACD,UAAU,EAAE;oBACV,YAAY,EAAE,IAAI;oBAClB,aAAa,EAAE,4HAA4H;oBAC3I,MAAM,EAAE,QAAQ;iBACjB;aACF;YACD,UAAU,EAAE;gBACV,MAAM;gBACN,WAAW;gBACX,UAAU;aACX;YACD,MAAM,EAAE,QAAQ;SACjB;KACF;IACD;QACE,MAAM,EAAE,2BAA2B;QACnC,aAAa,EAAE,8qBAA8qB;QAC7rB,aAAa,EAAE;YACb,aAAa,EAAE,6CAA6C;YAC5D,YAAY,EAAE;gBACZ,YAAY,EAAE;oBACZ,aAAa,EAAE,2EAA2E;oBAC1F,MAAM,EAAE;wBACN,yBAAyB;wBACzB,QAAQ;wBACR,SAAS;wBACT,QAAQ;wBACR,UAAU;qBACX;oBACD,MAAM,EAAE,QAAQ;oBAChB,4BAA4B,EAAE;wBAC5B,0BAA0B;wBAC1B,+BAA+B;wBAC/B,gCAAgC;wBAChC,+BAA+B;wBAC/B,iDAAiD;qBAClD;iBACF;gBACD,SAAS,EAAE;oBACT,aAAa,EAAE,4CAA4C;oBAC3D,MAAM,EAAE;wBACN,sBAAsB;wBACtB,cAAc;wBACd,gBAAgB;qBACjB;oBACD,MAAM,EAAE,QAAQ;oBAChB,4BAA4B,EAAE;wBAC5B,oBAAoB;wBACpB,eAAe;wBACf,iBAAiB;qBAClB;iBACF;gBACD,WAAW,EAAE;oBACX,aAAa,EAAE,sHAAsH;oBACrI,MAAM,EAAE,QAAQ;iBACjB;gBACD,QAAQ,EAAE;oBACR,aAAa,EAAE,uDAAuD;oBACtE,MAAM,EAAE,QAAQ;iBACjB;aACF;YACD,UAAU,EAAE;gBACV,WAAW;gBACX,QAAQ;aACT;YACD,MAAM,EAAE,QAAQ;SACjB;KACF;IACD;QACE,MAAM,EAAE,cAAc;QACtB,aAAa,EAAE,2QAA2Q;QAC1R,aAAa,EAAE;YACb,aAAa,EAAE,kCAAkC;YACjD,YAAY,EAAE;gBACZ,YAAY,EAAE;oBACZ,aAAa,EAAE,qFAAqF;oBACpG,MAAM,EAAE;wBACN,yBAAyB;wBACzB,QAAQ;wBACR,SAAS;wBACT,QAAQ;wBACR,UAAU;qBACX;oBACD,MAAM,EAAE,QAAQ;oBAChB,4BAA4B,EAAE;wBAC5B,0BAA0B;wBAC1B,+BAA+B;wBAC/B,gCAAgC;wBAChC,+BAA+B;wBAC/B,iDAAiD;qBAClD;iBACF;gBACD,SAAS,EAAE;oBACT,aAAa,EAAE,4CAA4C;oBAC3D,MAAM,EAAE;wBACN,sBAAsB;wBACtB,cAAc;wBACd,gBAAgB;qBACjB;oBACD,MAAM,EAAE,QAAQ;oBAChB,4BAA4B,EAAE;wBAC5B,oBAAoB;wBACpB,eAAe;wBACf,iBAAiB;qBAClB;iBACF;gBACD,WAAW,EAAE;oBACX,aAAa,EAAE,8GAA8G;oBAC7H,MAAM,EAAE,QAAQ;iBACjB;gBACD,QAAQ,EAAE;oBACR,aAAa,EAAE,uDAAuD;oBACtE,MAAM,EAAE,QAAQ;iBACjB;gBACD,mBAAmB,EAAE;oBACnB,aAAa,EAAE,gKAAgK;oBAC/K,OAAO,EAAE;wBACP,MAAM,EAAE,QAAQ;qBACjB;oBACD,MAAM,EAAE,OAAO;iBAChB;aACF;YACD,UAAU,EAAE;gBACV,WAAW;gBACX,mBAAmB;gBACnB,QAAQ;aACT;YACD,MAAM,EAAE,QAAQ;SACjB;KACF;IACD;QACE,MAAM,EAAE,mBAAmB;QAC3B,aAAa,EAAE,gFAAgF;QAC/F,aAAa,EAAE;YACb,OAAO,EAAE;gBACP,gBAAgB,EAAE;oBAChB,aAAa,EAAE,sLAAsL;oBACrM,YAAY,EAAE;wBACZ,SAAS,EAAE;4BACT,aAAa,EAAE,8EAA8E;4BAC7F,OAAO,EAAE;gCACP,MAAM,EAAE;oCACN,4BAA4B;oCAC5B,QAAQ;oCACR,cAAc;oCACd,QAAQ;oCACR,WAAW;oCACX,cAAc;iCACf;gCACD,MAAM,EAAE,QAAQ;gCAChB,4BAA4B,EAAE;oCAC5B,qBAAqB;oCACrB,gDAAgD;oCAChD,0CAA0C;oCAC1C,oCAAoC;oCACpC,+CAA+C;oCAC/C,2CAA2C;iCAC5C;6BACF;4BACD,MAAM,EAAE,OAAO;yBAChB;wBACD,eAAe,EAAE;4BACf,aAAa,EAAE,2DAA2D;4BAC1E,MAAM,EAAE;gCACN,4BAA4B;gCAC5B,QAAQ;gCACR,SAAS;gCACT,WAAW;6BACZ;4BACD,MAAM,EAAE,QAAQ;4BAChB,4BAA4B,EAAE;gCAC5B,6BAA6B;gCAC7B,mDAAmD;gCACnD,gCAAgC;gCAChC,+DAA+D;6BAChE;yBACF;wBACD,cAAc,EAAE;4BACd,aAAa,EAAE,4DAA4D;4BAC3E,QAAQ,EAAE,OAAO;4BACjB,MAAM,EAAE,SAAS;yBAClB;qBACF;oBACD,MAAM,EAAE,QAAQ;iBACjB;aACF;YACD,aAAa,EAAE,uCAAuC;YACtD,YAAY,EAAE;gBACZ,YAAY,EAAE;oBACZ,aAAa,EAAE,qFAAqF;oBACpG,MAAM,EAAE;wBACN,yBAAyB;wBACzB,QAAQ;wBACR,SAAS;wBACT,QAAQ;wBACR,UAAU;qBACX;oBACD,MAAM,EAAE,QAAQ;oBAChB,4BAA4B,EAAE;wBAC5B,0BAA0B;wBAC1B,+BAA+B;wBAC/B,gCAAgC;wBAChC,+BAA+B;wBAC/B,iDAAiD;qBAClD;iBACF;gBACD,SAAS,EAAE;oBACT,aAAa,EAAE,4CAA4C;oBAC3D,MAAM,EAAE;wBACN,sBAAsB;wBACtB,cAAc;wBACd,gBAAgB;qBACjB;oBACD,MAAM,EAAE,QAAQ;oBAChB,4BAA4B,EAAE;wBAC5B,oBAAoB;wBACpB,eAAe;wBACf,iBAAiB;qBAClB;iBACF;gBACD,WAAW,EAAE;oBACX,aAAa,EAAE,+HAA+H;oBAC9I,MAAM,EAAE,QAAQ;iBACjB;gBACD,QAAQ,EAAE;oBACR,aAAa,EAAE,yDAAyD;oBACxE,MAAM,EAAE,QAAQ;iBACjB;gBACD,mBAAmB,EAAE;oBACnB,aAAa,EAAE,gLAAgL;oBAC/L,OAAO,EAAE;wBACP,MAAM,EAAE,QAAQ;qBACjB;oBACD,MAAM,EAAE,OAAO;iBAChB;gBACD,gBAAgB,EAAE;oBAChB,MAAM,EAAE,wBAAwB;oBAChC,aAAa,EAAE,0HAA0H;iBAC1I;aACF;YACD,UAAU,EAAE;gBACV,WAAW;gBACX,mBAAmB;gBACnB,QAAQ;gBACR,gBAAgB;aACjB;YACD,MAAM,EAAE,QAAQ;SACjB;KACF;CACF,CAAC"}

package/dist/src/ai.d.ts

@@ -0,0 +1,17 @@
+/**
+ * AI SDK adapter entry point.
+ *
+ * Import from `@google/stitch-sdk/ai` to use Stitch tools with the Vercel AI SDK.
+ *
+ * @example
+ * import { stitchTools } from "@google/stitch-sdk/ai";
+ * import { generateText } from "ai";
+ *
+ * const { text } = await generateText({
+ *   model,
+ *   tools: stitchTools(),
+ *   prompt: "Create a login page",
+ * });
+ */
+export { stitchTools } from "./tools-adapter.js";
+//# sourceMappingURL=ai.d.ts.map

package/dist/src/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/ai.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/ai.js

@@ -0,0 +1,30 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+/**
+ * AI SDK adapter entry point.
+ *
+ * Import from `@google/stitch-sdk/ai` to use Stitch tools with the Vercel AI SDK.
+ *
+ * @example
+ * import { stitchTools } from "@google/stitch-sdk/ai";
+ * import { generateText } from "ai";
+ *
+ * const { text } = await generateText({
+ *   model,
+ *   tools: stitchTools(),
+ *   prompt: "Create a login page",
+ * });
+ */
+export { stitchTools } from "./tools-adapter.js";
+//# sourceMappingURL=ai.js.map

package/dist/src/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/ai.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,kDAAkD;AAClD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/client.d.ts

@@ -0,0 +1,77 @@
+import { StitchConfig, StitchToolClientSpec } from './spec/client.js';
+/**
+ * Authenticated tool pipe for the Stitch MCP Server.
+ *
+ * Designed for agents and orchestration scripts that forward JSON payloads
+ * to MCP tools. Handles auth injection via the transport layer (not global fetch).
+ *
+ * Usage:
+ *   const client = new StitchToolClient();          // reads STITCH_API_KEY from env
+ *   const result = await client.callTool("generate_screen_from_text", { ... });
+ */
+export declare class StitchToolClient implements StitchToolClientSpec {
+    name: 'stitch-tool-client';
+    description: 'Authenticated tool pipe for Stitch MCP Server';
+    private client;
+    private transport;
+    private config;
+    private isConnected;
+    constructor(inputConfig?: Partial<StitchConfig>);
+    /**
+     * Build auth headers based on config (API key or OAuth).
+     */
+    private buildAuthHeaders;
+    private parseToolResponse;
+    connect(): Promise<void>;
+    /**
+     * Generic tool caller with type support and error parsing.
+     */
+    callTool<T>(name: string, args: Record<string, any>): Promise<T>;
+    listTools(): Promise<{
+        [x: string]: unknown;
+        tools: {
+            inputSchema: {
+                [x: string]: unknown;
+                type: "object";
+                properties?: Record<string, object> | undefined;
+                required?: string[] | undefined;
+            };
+            name: string;
+            description?: string | undefined;
+            outputSchema?: {
+                [x: string]: unknown;
+                type: "object";
+                properties?: Record<string, object> | undefined;
+                required?: string[] | undefined;
+            } | undefined;
+            annotations?: {
+                title?: string | undefined;
+                readOnlyHint?: boolean | undefined;
+                destructiveHint?: boolean | undefined;
+                idempotentHint?: boolean | undefined;
+                openWorldHint?: boolean | undefined;
+            } | undefined;
+            execution?: {
+                taskSupport?: "optional" | "required" | "forbidden" | undefined;
+            } | undefined;
+            _meta?: Record<string, unknown> | undefined;
+            icons?: {
+                src: string;
+                mimeType?: string | undefined;
+                sizes?: string[] | undefined;
+                theme?: "light" | "dark" | undefined;
+            }[] | undefined;
+            title?: string | undefined;
+        }[];
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+        nextCursor?: string | undefined;
+    }>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/src/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAsB,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAI1F;;;;;;;;;GASG;AACH,qBAAa,gBAAiB,YAAW,oBAAoB;IAC3D,IAAI,EAAE,oBAAoB,CAAwB;IAClD,WAAW,EAAE,+CAA+C,CAAmD;IAE/G,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAkB;gBAEzB,WAAW,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAgB/C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,iBAAiB;IAsCnB,OAAO;IAsBb;;OAEG;IACG,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAYhE,SAAS;;;;;;0BAY0/e,CAAC;wBAA8D,CAAC;;;uBAAwF,CAAC;wBAA8C,CAAC;;;0BAAoG,CAAC;wBAA8D,CAAC;;uBAA0E,CAAC;qBAAyB,CAAC;4BAAkD,CAAC;+BAAsD,CAAC;8BAAqD,CAAC;6BAAoD,CAAC;;qBAAuE,CAAC;2BAA+B,CAAC;;iBAAiG,CAAC;iBAAwD,CAAC;;wBAAyD,CAAC;qBAA2C,CAAC;qBAA6C,CAAC;;iBAA8E,CAAC;;;;yBAAgH,CAAC;kDAAiF,CAAC;;;;;;IAPl1hB,KAAK;CAMZ"}

package/dist/src/client.js

@@ -0,0 +1,135 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { StitchConfigSchema } from './spec/client.js';
+import { StitchError } from './spec/errors.js';
+import { SDK_VERSION } from './version.js';
+/**
+ * Authenticated tool pipe for the Stitch MCP Server.
+ *
+ * Designed for agents and orchestration scripts that forward JSON payloads
+ * to MCP tools. Handles auth injection via the transport layer (not global fetch).
+ *
+ * Usage:
+ *   const client = new StitchToolClient();          // reads STITCH_API_KEY from env
+ *   const result = await client.callTool("generate_screen_from_text", { ... });
+ */
+export class StitchToolClient {
+    name = 'stitch-tool-client';
+    description = 'Authenticated tool pipe for Stitch MCP Server';
+    client;
+    transport = null;
+    config;
+    isConnected = false;
+    constructor(inputConfig) {
+        const rawConfig = {
+            accessToken: inputConfig?.accessToken || process.env.STITCH_ACCESS_TOKEN,
+            apiKey: inputConfig?.apiKey || process.env.STITCH_API_KEY,
+            projectId: inputConfig?.projectId || process.env.GOOGLE_CLOUD_PROJECT,
+            baseUrl: inputConfig?.baseUrl,
+            timeout: inputConfig?.timeout,
+        };
+        this.config = StitchConfigSchema.parse(rawConfig);
+        this.client = new Client({ name: "stitch-core-client", version: SDK_VERSION }, { capabilities: {} });
+    }
+    /**
+     * Build auth headers based on config (API key or OAuth).
+     */
+    buildAuthHeaders() {
+        const headers = {
+            'Accept': 'application/json, text/event-stream',
+        };
+        if (this.config.apiKey) {
+            headers['X-Goog-Api-Key'] = this.config.apiKey;
+        }
+        else {
+            headers['Authorization'] = `Bearer ${this.config.accessToken}`;
+            headers['X-Goog-User-Project'] = this.config.projectId;
+        }
+        return headers;
+    }
+    parseToolResponse(result, name) {
+        if (result.isError) {
+            const errorText = result.content.map((c) => (c.type === 'text' ? c.text : '')).join('');
+            let code = 'UNKNOWN_ERROR';
+            const lowerErrorText = errorText.toLowerCase();
+            if (lowerErrorText.includes('rate limit') || lowerErrorText.includes('429')) {
+                code = 'RATE_LIMITED';
+            }
+            else if (lowerErrorText.includes('not found') || lowerErrorText.includes('404')) {
+                code = 'NOT_FOUND';
+            }
+            else if (lowerErrorText.includes('permission') || lowerErrorText.includes('403')) {
+                code = 'PERMISSION_DENIED';
+            }
+            throw new StitchError({
+                code,
+                message: `Tool Call Failed [${name}]: ${errorText}`,
+                recoverable: code === 'RATE_LIMITED',
+            });
+        }
+        // Stitch specific parsing: Check structuredContent first, then JSON in text
+        const anyResult = result;
+        if (anyResult.structuredContent)
+            return anyResult.structuredContent;
+        const textContent = result.content.find((c) => c.type === 'text');
+        if (textContent && textContent.type === 'text') {
+            try {
+                return JSON.parse(textContent.text);
+            }
+            catch {
+                return textContent.text;
+            }
+        }
+        return anyResult;
+    }
+    async connect() {
+        if (this.isConnected)
+            return;
+        // Create transport with auth headers injected per-instance (no global fetch mutation)
+        this.transport = new StreamableHTTPClientTransport(new URL(this.config.baseUrl), {
+            requestInit: {
+                headers: this.buildAuthHeaders(),
+            },
+        });
+        this.transport.onerror = (err) => {
+            console.error("Stitch Transport Error:", err);
+            this.isConnected = false;
+        };
+        await this.client.connect(this.transport);
+        this.isConnected = true;
+    }
+    /**
+     * Generic tool caller with type support and error parsing.
+     */
+    async callTool(name, args) {
+        if (!this.isConnected)
+            await this.connect();
+        const result = await this.client.callTool({ name, arguments: args }, undefined, { timeout: this.config.timeout });
+        return this.parseToolResponse(result, name);
+    }
+    async listTools() {
+        if (!this.isConnected)
+            await this.connect();
+        return this.client.listTools();
+    }
+    async close() {
+        if (this.transport) {
+            await this.transport.close();
+            this.isConnected = false;
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}

package/dist/src/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const DEFAULT_STITCH_API_URL = "https://stitch.googleapis.com/mcp";
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,sBAAsB,sCAAsC,CAAC"}

package/dist/src/constants.js

@@ -0,0 +1,15 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+export const DEFAULT_STITCH_API_URL = 'https://stitch.googleapis.com/mcp';
+//# sourceMappingURL=constants.js.map

package/dist/src/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,kDAAkD;AAClD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AAEjC,MAAM,CAAC,MAAM,sBAAsB,GAAG,mCAAmC,CAAC"}