mcp-stitch 0.1.0

package/README.md

@@ -0,0 +1,122 @@
+# mcp-stitch
+
+MCP server for Google Stitch. It exposes Stitch project, screen, design-system, generation, edit, variant, and artifact export tools over stdio for VS Code and other MCP-compatible agents.
+
+## Requirements
+
+- Node.js 20 or newer
+- A Google API key with access to Stitch
+
+## Environment
+
+Required:
+
+- `GOOGLE_API_KEY`
+
+Recommended:
+
+- `PROJECT_ROOT`: workspace/project directory where exported Stitch artifacts should be written
+
+Optional:
+
+- `STITCH_API_BASE_URL`: defaults to `https://stitch.googleapis.com/mcp`
+- `STITCH_OUTPUT_DIR`: fallback output root when `PROJECT_ROOT` is not set
+- `STITCH_TIMEOUT_MS`: defaults to `30000`
+- `STITCH_MAX_RETRIES`: defaults to `2`
+
+## VS Code Setup
+
+VS Code can load MCP servers from a workspace `.vscode/mcp.json` file or from your user MCP configuration.
+
+For a published npm package, use:
+
+```json
+{
+  "servers": {
+    "stitch": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "mcp-stitch"],
+      "env": {
+        "GOOGLE_API_KEY": "${input:stitchApiKey}",
+        "PROJECT_ROOT": "${workspaceFolder}"
+      }
+    }
+  },
+  "inputs": [
+    {
+      "id": "stitchApiKey",
+      "type": "promptString",
+      "description": "Google API key for Stitch",
+      "password": true
+    }
+  ]
+}
+```
+
+For local development before publishing, build this repo and point VS Code at the compiled entrypoint:
+
+```json
+{
+  "servers": {
+    "stitch": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["/absolute/path/to/mcp-stitch/dist/index.js"],
+      "env": {
+        "GOOGLE_API_KEY": "${input:stitchApiKey}",
+        "PROJECT_ROOT": "${workspaceFolder}"
+      }
+    }
+  },
+  "inputs": [
+    {
+      "id": "stitchApiKey",
+      "type": "promptString",
+      "description": "Google API key for Stitch",
+      "password": true
+    }
+  ]
+}
+```
+
+After VS Code starts the server, ask your agent to call `stitch_status` to confirm the setup.
+
+## Tools
+
+- `stitch_status`
+- `stitch_list_projects`
+- `stitch_get_project`
+- `stitch_create_project`
+- `stitch_list_screens`
+- `stitch_get_screen`
+- `stitch_generate_screen_from_text`
+- `stitch_edit_screens`
+- `stitch_generate_variants`
+- `stitch_upload_design_md`
+- `stitch_create_design_system`
+- `stitch_create_design_system_from_design_md`
+- `stitch_update_design_system`
+- `stitch_list_design_systems`
+- `stitch_apply_design_system`
+- `stitch_export_screen_artifact`
+
+Mutating tools require `confirm: true`.
+
+## Development
+
+```bash
+npm install
+npm run build
+npm run dev
+```
+
+## Publishing Checklist
+
+```bash
+npm run build
+npm pack --dry-run
+npm publish
+```
+
+See [docs/stitch-tools.md](docs/stitch-tools.md) for detailed tool inputs and Stitch contract notes.

package/dist/config/stitch.d.ts

@@ -0,0 +1,11 @@
+export declare const DEFAULT_STITCH_API_BASE_URL = "https://stitch.googleapis.com/mcp";
+export type StitchConfig = {
+    apiKey: string;
+    baseUrl: string;
+    timeoutMs: number;
+    maxRetries: number;
+    outputDir: string;
+};
+export declare function getStitchConfig(): StitchConfig;
+export declare function validateStitchApiConfig(config: StitchConfig): string[];
+//# sourceMappingURL=stitch.d.ts.map

package/dist/config/stitch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitch.d.ts","sourceRoot":"","sources":["../../src/config/stitch.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,2BAA2B,sCAAsC,CAAC;AAE/E,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAeF,wBAAgB,eAAe,IAAI,YAAY,CAmB9C;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAQtE"}

package/dist/config/stitch.js

@@ -0,0 +1,38 @@
+import path from "node:path";
+export const DEFAULT_STITCH_API_BASE_URL = "https://stitch.googleapis.com/mcp";
+function parsePositiveInt(value, fallback) {
+    if (!value)
+        return fallback;
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0)
+        return fallback;
+    return parsed;
+}
+function getProjectRoot() {
+    return process.env.PROJECT_ROOT?.trim() || process.cwd();
+}
+export function getStitchConfig() {
+    const apiKey = process.env.GOOGLE_API_KEY?.trim() ?? "";
+    const baseUrl = process.env.STITCH_API_BASE_URL?.trim() || DEFAULT_STITCH_API_BASE_URL;
+    const timeoutMs = parsePositiveInt(process.env.STITCH_TIMEOUT_MS, 30000);
+    const maxRetries = parsePositiveInt(process.env.STITCH_MAX_RETRIES, 2);
+    const rawOutputDir = process.env.STITCH_OUTPUT_DIR?.trim();
+    const outputDir = rawOutputDir
+        ? path.resolve(rawOutputDir)
+        : path.resolve(getProjectRoot(), "stitch-output");
+    return {
+        apiKey,
+        baseUrl,
+        timeoutMs,
+        maxRetries,
+        outputDir,
+    };
+}
+export function validateStitchApiConfig(config) {
+    const errors = [];
+    if (!config.apiKey) {
+        errors.push("Missing GOOGLE_API_KEY environment variable.");
+    }
+    return errors;
+}
+//# sourceMappingURL=stitch.js.map

package/dist/config/stitch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitch.js","sourceRoot":"","sources":["../../src/config/stitch.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,2BAA2B,GAAG,mCAAmC,CAAC;AAU/E,SAAS,gBAAgB,CAAC,KAAyB,EAAE,QAAgB;IACnE,IAAI,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAC;IAE5B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IAE7D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,cAAc;IACrB,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,IAAI,2BAA2B,CAAC;IAEvF,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;IACzE,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;IAEvE,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC;IAC3D,MAAM,SAAS,GAAG,YAAY;QAC5B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;QAC5B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,eAAe,CAAC,CAAC;IAEpD,OAAO;QACL,MAAM;QACN,OAAO;QACP,SAAS;QACT,UAAU;QACV,SAAS;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAoB;IAC1D,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "dotenv/config";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAIA,OAAO,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import "dotenv/config";
+import { registerStitchStatusTool } from "./tools/status.js";
+import { registerStitchProjectTools } from "./tools/stitchProjects.js";
+import { registerStitchScreenTools } from "./tools/stitchScreens.js";
+import { registerStitchDesignSystemTools } from "./tools/stitchDesignSystems.js";
+import { registerStitchExportTool } from "./tools/stitchExport.js";
+const server = new McpServer({
+    name: "mcp-stitch",
+    version: "0.5.0",
+});
+registerStitchStatusTool(server);
+registerStitchProjectTools(server);
+registerStitchScreenTools(server);
+registerStitchDesignSystemTools(server);
+registerStitchExportTool(server);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,eAAe,CAAC;AAEvB,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,wBAAwB,CAAC,MAAM,CAAC,CAAC;AACjC,0BAA0B,CAAC,MAAM,CAAC,CAAC;AACnC,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAClC,+BAA+B,CAAC,MAAM,CAAC,CAAC;AACxC,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAIjC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/models/stitch.d.ts

@@ -0,0 +1,20 @@
+export type JsonObject = Record<string, unknown>;
+export type StitchCallResult = {
+    ok: true;
+    data: unknown;
+    requestId: number;
+    status?: number;
+};
+export type StitchCallFailure = {
+    ok: false;
+    error: string;
+    requestId: number;
+    status?: number;
+    details?: unknown;
+};
+export type StitchCallResponse = StitchCallResult | StitchCallFailure;
+export type StitchToolCall = {
+    toolName: string;
+    input: JsonObject;
+};
+//# sourceMappingURL=stitch.d.ts.map

package/dist/models/stitch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitch.d.ts","sourceRoot":"","sources":["../../src/models/stitch.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAEtE,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;CACnB,CAAC"}

package/dist/models/stitch.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stitch.js.map

package/dist/models/stitch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitch.js","sourceRoot":"","sources":["../../src/models/stitch.ts"],"names":[],"mappings":""}

package/dist/services/stitchClient.d.ts

@@ -0,0 +1,8 @@
+import type { StitchConfig } from "../config/stitch.js";
+import type { StitchCallResponse, StitchToolCall } from "../models/stitch.js";
+export declare class StitchClient {
+    private readonly config;
+    constructor(config: StitchConfig);
+    callTool(call: StitchToolCall): Promise<StitchCallResponse>;
+}
+//# sourceMappingURL=stitchClient.d.ts.map

package/dist/services/stitchClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitchClient.d.ts","sourceRoot":"","sources":["../../src/services/stitchClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAsD9E,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,YAAY;IAI1B,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA2JlE"}

package/dist/services/stitchClient.js

@@ -0,0 +1,189 @@
+import { validateStitchApiConfig } from "../config/stitch.js";
+import { toSafeErrorMessage } from "../utils/redact.js";
+// Stitch transport contract:
+// - HTTP POST to STITCH_API_BASE_URL, defaulting to https://stitch.googleapis.com/mcp
+// - JSON-RPC envelope with method "tools/call"
+// - params.name and params.arguments
+// - API key sent via header "x-goog-api-key"
+function shouldRetry(status) {
+    if (!status)
+        return true;
+    return status === 408 || status === 429 || status >= 500;
+}
+function toStitchErrorText(payload) {
+    if (!payload || typeof payload !== "object")
+        return null;
+    const obj = payload;
+    const errorObj = obj.error;
+    if (errorObj && typeof errorObj === "object") {
+        const e = errorObj;
+        const message = e.message;
+        if (typeof message === "string")
+            return message;
+    }
+    return null;
+}
+function toToolContentError(payload) {
+    if (!payload || typeof payload !== "object")
+        return null;
+    const obj = payload;
+    const result = obj.result;
+    if (!result || typeof result !== "object")
+        return null;
+    const resultObj = result;
+    if (resultObj.isError !== true)
+        return null;
+    const content = resultObj.content;
+    if (!Array.isArray(content) || content.length === 0) {
+        return "Stitch tool returned isError=true.";
+    }
+    const first = content[0];
+    if (first && typeof first === "object") {
+        const text = first.text;
+        if (typeof text === "string" && text.trim().length > 0) {
+            return text.trim();
+        }
+    }
+    return "Stitch tool returned isError=true.";
+}
+export class StitchClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async callTool(call) {
+        const configErrors = validateStitchApiConfig(this.config);
+        const requestId = Date.now();
+        if (configErrors.length > 0) {
+            return {
+                ok: false,
+                error: configErrors.join(" "),
+                requestId,
+            };
+        }
+        const body = {
+            jsonrpc: "2.0",
+            id: requestId,
+            method: "tools/call",
+            params: {
+                name: call.toolName,
+                arguments: call.input,
+            },
+        };
+        let attempt = 0;
+        let lastError = "Unknown Stitch API error.";
+        let lastStatus;
+        while (attempt <= this.config.maxRetries) {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), this.config.timeoutMs);
+            try {
+                const response = await fetch(this.config.baseUrl, {
+                    method: "POST",
+                    headers: {
+                        "content-type": "application/json",
+                        "x-goog-api-key": this.config.apiKey,
+                    },
+                    body: JSON.stringify(body),
+                    signal: controller.signal,
+                });
+                clearTimeout(timeout);
+                lastStatus = response.status;
+                const text = await response.text();
+                let payload = null;
+                try {
+                    payload = text ? JSON.parse(text) : null;
+                }
+                catch {
+                    payload = { raw: text };
+                }
+                if (!response.ok) {
+                    const apiMessage = toStitchErrorText(payload);
+                    lastError = apiMessage ?? `Stitch API request failed with status ${response.status}.`;
+                    if (shouldRetry(response.status) && attempt < this.config.maxRetries) {
+                        attempt += 1;
+                        continue;
+                    }
+                    return {
+                        ok: false,
+                        error: lastError,
+                        requestId,
+                        status: response.status,
+                        details: payload,
+                    };
+                }
+                if (payload && typeof payload === "object") {
+                    const obj = payload;
+                    const apiMessage = toStitchErrorText(payload);
+                    const toolMessage = toToolContentError(payload);
+                    if (apiMessage) {
+                        return {
+                            ok: false,
+                            error: apiMessage,
+                            requestId,
+                            status: response.status,
+                            details: payload,
+                        };
+                    }
+                    if (toolMessage) {
+                        return {
+                            ok: false,
+                            error: toolMessage,
+                            requestId,
+                            status: response.status,
+                            details: payload,
+                        };
+                    }
+                    if ("result" in obj) {
+                        return {
+                            ok: true,
+                            data: obj.result,
+                            requestId,
+                            status: response.status,
+                        };
+                    }
+                }
+                return {
+                    ok: true,
+                    data: payload,
+                    requestId,
+                    status: response.status,
+                };
+            }
+            catch (error) {
+                clearTimeout(timeout);
+                lastError = toSafeErrorMessage(error, [this.config.apiKey]);
+                if (attempt < this.config.maxRetries) {
+                    attempt += 1;
+                    continue;
+                }
+                if (lastStatus === undefined) {
+                    return {
+                        ok: false,
+                        error: `Failed to call Stitch API: ${lastError}`,
+                        requestId,
+                    };
+                }
+                return {
+                    ok: false,
+                    error: `Failed to call Stitch API: ${lastError}`,
+                    requestId,
+                    status: lastStatus,
+                };
+            }
+        }
+        if (lastStatus === undefined) {
+            return {
+                ok: false,
+                error: `Failed to call Stitch API: ${lastError}`,
+                requestId,
+            };
+        }
+        return {
+            ok: false,
+            error: `Failed to call Stitch API: ${lastError}`,
+            requestId,
+            status: lastStatus,
+        };
+    }
+}
+//# sourceMappingURL=stitchClient.js.map

package/dist/services/stitchClient.js.map

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

package/dist/tools/status.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerStitchStatusTool(server: McpServer): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/tools/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgBpE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,QA2CzD"}

package/dist/tools/status.js

@@ -0,0 +1,50 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { DEFAULT_STITCH_API_BASE_URL, getStitchConfig } from "../config/stitch.js";
+function isConfigured(name) {
+    return Boolean(process.env[name]?.trim());
+}
+function configuredText(name) {
+    return isConfigured(name) ? "configured" : "missing";
+}
+function optionalText(name, fallback) {
+    return isConfigured(name) ? "configured" : fallback;
+}
+export function registerStitchStatusTool(server) {
+    server.registerTool("stitch_status", {
+        description: "Checks Stitch MCP setup and reports missing required, recommended, and optional environment variables without exposing secret values.",
+        inputSchema: z.object({}),
+    }, async () => {
+        const config = getStitchConfig();
+        const hasProjectRoot = isConfigured("PROJECT_ROOT");
+        const lines = [
+            "Stitch setup status",
+            "",
+            "Required configuration:",
+            `- GOOGLE_API_KEY: ${configuredText("GOOGLE_API_KEY")}`,
+            "",
+            "Recommended configuration:",
+            `- PROJECT_ROOT: ${hasProjectRoot ? "configured" : "missing"}`,
+            ...(hasProjectRoot
+                ? []
+                : [
+                    "  Set PROJECT_ROOT to the workspace/project directory where Stitch artifacts should be exported.",
+                ]),
+            "",
+            "Optional configuration:",
+            `- STITCH_API_BASE_URL: ${isConfigured("STITCH_API_BASE_URL") ? "configured" : `using default ${DEFAULT_STITCH_API_BASE_URL}`}`,
+            `- STITCH_OUTPUT_DIR: ${optionalText("STITCH_OUTPUT_DIR", `not set; defaulting to ${config.outputDir}`)}`,
+            `- STITCH_TIMEOUT_MS: ${optionalText("STITCH_TIMEOUT_MS", `using default ${config.timeoutMs}`)}`,
+            `- STITCH_MAX_RETRIES: ${optionalText("STITCH_MAX_RETRIES", `using default ${config.maxRetries}`)}`,
+        ];
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: lines.join("\n"),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/tools/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,2BAA2B,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEnF,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,QAAgB;IAClD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,WAAW,EACT,uIAAuI;QACzI,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;KAC1B,EACD,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QACjC,MAAM,cAAc,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;QAEpD,MAAM,KAAK,GAAG;YACZ,qBAAqB;YACrB,EAAE;YACF,yBAAyB;YACzB,qBAAqB,cAAc,CAAC,gBAAgB,CAAC,EAAE;YACvD,EAAE;YACF,4BAA4B;YAC5B,mBAAmB,cAAc,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,EAAE;YAC9D,GAAG,CAAC,cAAc;gBAChB,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC;oBACE,kGAAkG;iBACnG,CAAC;YACN,EAAE;YACF,yBAAyB;YACzB,0BAA0B,YAAY,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,iBAAiB,2BAA2B,EAAE,EAAE;YAC/H,wBAAwB,YAAY,CAAC,mBAAmB,EAAE,0BAA0B,MAAM,CAAC,SAAS,EAAE,CAAC,EAAE;YACzG,wBAAwB,YAAY,CAAC,mBAAmB,EAAE,iBAAiB,MAAM,CAAC,SAAS,EAAE,CAAC,EAAE;YAChG,yBAAyB,YAAY,CAAC,oBAAoB,EAAE,iBAAiB,MAAM,CAAC,UAAU,EAAE,CAAC,EAAE;SACpG,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;iBACvB;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/stitchDesignSystems.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerStitchDesignSystemTools(server: McpServer): void;
+//# sourceMappingURL=stitchDesignSystems.d.ts.map

package/dist/tools/stitchDesignSystems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitchDesignSystems.d.ts","sourceRoot":"","sources":["../../src/tools/stitchDesignSystems.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAyKpE,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,QAgPhE"}