google-stitch-mcp 0.3.2

package/dist/lib/server/AssetGateway.d.ts

@@ -0,0 +1,25 @@
+import { Readable } from 'stream';
+export declare class AssetGateway {
+    private cacheDir;
+    constructor(projectRoot?: string);
+    init(): Promise<void>;
+    private getHash;
+    fetchAsset(url: string): Promise<{
+        stream: Readable;
+        contentType?: string;
+    } | null>;
+    rewriteCssUrls(css: string, baseUrl: string): string;
+    rewriteHtmlForPreview(html: string): Promise<string>;
+    /**
+     * Maps common MIME types to file extensions.
+     */
+    private getExtensionFromContentType;
+    rewriteHtmlForBuild(html: string): Promise<{
+        html: string;
+        assets: {
+            url: string;
+            filename: string;
+        }[];
+    }>;
+    copyAssetTo(url: string, destPath: string): Promise<boolean>;
+}

package/dist/lib/server/vite/StitchViteServer.d.ts

@@ -0,0 +1,11 @@
+import { AssetGateway } from '../AssetGateway.js';
+export declare class StitchViteServer {
+    private server;
+    private htmlMap;
+    assetGateway: AssetGateway;
+    constructor(projectRoot?: string, assetGateway?: AssetGateway);
+    start(port?: number): Promise<string>;
+    stop(): Promise<void>;
+    mount(route: string, html: string): void;
+    navigate(url: string): void;
+}

package/dist/lib/server/vite/plugins/virtualContent.d.ts

@@ -0,0 +1,7 @@
+import { type Plugin } from 'vite';
+import { AssetGateway } from '../../AssetGateway.js';
+export interface VirtualContentOptions {
+    assetGateway: AssetGateway;
+    htmlMap: Map<string, string>;
+}
+export declare function virtualContent({ assetGateway, htmlMap }: VirtualContentOptions): Plugin;

package/dist/lib/services/site/SiteService.d.ts

@@ -0,0 +1,6 @@
+import type { RemoteScreen, SiteConfig, IAssetGateway, UIScreen } from './types.js';
+export declare class SiteService {
+    static toUIScreens(screens: RemoteScreen[]): UIScreen[];
+    static generateSite(config: SiteConfig, htmlContent: Map<string, string>, assetGateway: IAssetGateway, outputDir?: string): Promise<void>;
+    static slugify(text: string): string;
+}

package/dist/lib/services/site/schemas.d.ts

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+export declare const RemoteScreenSchema: z.ZodObject<{
+    name: z.ZodString;
+    title: z.ZodString;
+    htmlCode: z.ZodOptional<z.ZodObject<{
+        downloadUrl: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        downloadUrl: string;
+    }, {
+        downloadUrl: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    title: string;
+    htmlCode?: {
+        downloadUrl: string;
+    } | undefined;
+}, {
+    name: string;
+    title: string;
+    htmlCode?: {
+        downloadUrl: string;
+    } | undefined;
+}>;
+export declare const SiteRouteSchema: z.ZodObject<{
+    screenId: z.ZodString;
+    route: z.ZodString;
+    status: z.ZodEnum<["included", "ignored"]>;
+    warning: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "included" | "ignored";
+    screenId: string;
+    route: string;
+    warning?: string | undefined;
+}, {
+    status: "included" | "ignored";
+    screenId: string;
+    route: string;
+    warning?: string | undefined;
+}>;
+export declare const SiteConfigSchema: z.ZodEffects<z.ZodObject<{
+    projectId: z.ZodString;
+    routes: z.ZodArray<z.ZodObject<{
+        screenId: z.ZodString;
+        route: z.ZodString;
+        status: z.ZodEnum<["included", "ignored"]>;
+        warning: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "included" | "ignored";
+        screenId: string;
+        route: string;
+        warning?: string | undefined;
+    }, {
+        status: "included" | "ignored";
+        screenId: string;
+        route: string;
+        warning?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    routes: {
+        status: "included" | "ignored";
+        screenId: string;
+        route: string;
+        warning?: string | undefined;
+    }[];
+}, {
+    projectId: string;
+    routes: {
+        status: "included" | "ignored";
+        screenId: string;
+        route: string;
+        warning?: string | undefined;
+    }[];
+}>, {
+    projectId: string;
+    routes: {
+        status: "included" | "ignored";
+        screenId: string;
+        route: string;
+        warning?: string | undefined;
+    }[];
+}, {
+    projectId: string;
+    routes: {
+        status: "included" | "ignored";
+        screenId: string;
+        route: string;
+        warning?: string | undefined;
+    }[];
+}>;

package/dist/lib/services/site/types.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { RemoteScreenSchema, SiteConfigSchema, SiteRouteSchema } from './schemas.js';
+export type RemoteScreen = z.infer<typeof RemoteScreenSchema>;
+export type SiteRoute = z.infer<typeof SiteRouteSchema>;
+export type SiteConfig = z.infer<typeof SiteConfigSchema>;
+export interface UIScreen {
+    id: string;
+    title: string;
+    downloadUrl: string;
+    status: 'included' | 'ignored' | 'discarded';
+    route: string;
+}
+export interface IAssetGateway {
+    rewriteHtmlForBuild(html: string): Promise<{
+        html: string;
+        assets: {
+            url: string;
+            filename: string;
+        }[];
+    }>;
+    copyAssetTo(url: string, destPath: string): Promise<boolean>;
+}

package/dist/platform/detector.d.ts

@@ -0,0 +1,29 @@
+export type OS = 'macos' | 'linux' | 'windows';
+export type Arch = 'arm64' | 'x86_64';
+export interface Platform {
+    os: OS;
+    arch: Arch;
+    gcloudDownloadUrl: string;
+    gcloudBinaryName: string;
+    isWindows: boolean;
+}
+/**
+ * Detect the current platform and architecture
+ */
+export declare function detectPlatform(): Platform;
+/**
+ * Get the user's home directory
+ */
+export declare function getHomeDir(): string;
+/**
+ * Get the Stitch MCP directory path
+ */
+export declare function getStitchDir(): string;
+/**
+ * Get the gcloud SDK installation path
+ */
+export declare function getGcloudSdkPath(): string;
+/**
+ * Get the gcloud config directory path
+ */
+export declare function getGcloudConfigPath(): string;

package/dist/platform/environment.d.ts

@@ -0,0 +1,13 @@
+export interface EnvironmentInfo {
+    isWSL: boolean;
+    isSSH: boolean;
+    isDocker: boolean;
+    isCloudShell: boolean;
+    hasDisplay: boolean;
+    needsNoBrowser: boolean;
+    reason?: string;
+}
+/**
+ * Detect environment characteristics that affect browser auth
+ */
+export declare function detectEnvironment(): EnvironmentInfo;

package/dist/platform/paths.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Get cross-platform path join
+ */
+export declare function joinPath(...parts: string[]): string;
+/**
+ * Get the directory name from a path
+ */
+export declare function dirname(filepath: string): string;
+/**
+ * Get the basename from a path
+ */
+export declare function basename(filepath: string): string;
+/**
+ * Normalize path separators for the current platform
+ */
+export declare function normalizePath(filepath: string): string;
+/**
+ * Convert a path to use forward slashes (for consistency)
+ */
+export declare function toUnixPath(filepath: string): string;

package/dist/platform/shell.d.ts

@@ -0,0 +1,30 @@
+export interface ShellResult {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    error?: string;
+}
+export declare function getSpawnArgs(command: string, args: string[]): {
+    cmd: string;
+    args: string[];
+};
+/**
+ * Execute a shell command and return the result
+ */
+export declare function execCommand(command: string[], options?: {
+    cwd?: string;
+    env?: Record<string, string>;
+    timeout?: number;
+}): Promise<ShellResult>;
+/**
+ * Execute a shell command and stream output
+ */
+export declare function execCommandStreaming(command: string[], onStdout?: (data: string) => void, onStderr?: (data: string) => void, options?: {
+    cwd?: string;
+    env?: Record<string, string>;
+}): Promise<ShellResult>;
+/**
+ * Check if a command exists in PATH
+ */
+export declare function commandExists(command: string): Promise<boolean>;

package/dist/services/gcloud/handler.d.ts

@@ -0,0 +1,57 @@
+import { type GcloudService, type EnsureGcloudInput, type AuthenticateInput, type ListProjectsInput, type SetProjectInput, type GcloudResult, type AuthResult, type ProjectListResult, type ProjectSetResult } from './spec.js';
+export declare class GcloudHandler implements GcloudService {
+    private platform;
+    private gcloudPath;
+    private useSystemGcloud;
+    /**
+     * Ensure gcloud is installed and available
+     */
+    ensureInstalled(input: EnsureGcloudInput): Promise<GcloudResult>;
+    /**
+     * Authenticate user
+     */
+    authenticate(input: AuthenticateInput): Promise<AuthResult>;
+    /**
+     * Authenticate application default credentials
+     */
+    authenticateADC(input: AuthenticateInput): Promise<AuthResult>;
+    /**
+     * List projects
+     */
+    listProjects(input: ListProjectsInput): Promise<ProjectListResult>;
+    /**
+     * Set active project
+     */
+    setProject(input: SetProjectInput): Promise<ProjectSetResult>;
+    /**
+     * Get access token
+     */
+    getAccessToken(): Promise<string | null>;
+    /**
+     * Get the correct login command with config prefix if using bundled gcloud
+     */
+    private getLoginCommand;
+    getProjectId(): Promise<string | null>;
+    /**
+     * Install beta components
+     */
+    installBetaComponents(): Promise<{
+        success: boolean;
+        error?: {
+            message: string;
+        };
+    }>;
+    /**
+     * Run the gcloud authentication flow (URL extraction followed by actual login)
+     */
+    private runAuthFlow;
+    private findGlobalGcloud;
+    private getVersionFromPath;
+    private isVersionValid;
+    private installLocal;
+    private setupEnvironment;
+    private getEnvironment;
+    private getGcloudCommand;
+    getActiveAccount(): Promise<string | null>;
+    hasADC(): Promise<boolean>;
+}