stitch-forge 0.3.1

package/dist/mcp/client.js

@@ -0,0 +1,302 @@
+/**
+ * MCP Client wrapper for Stitch tools.
+ *
+ * When running inside Claude Code with the Stitch MCP server configured,
+ * tool calls are handled automatically by the MCP protocol.
+ *
+ * This module provides typed wrappers for standalone CLI usage
+ * (outside Claude Code) via direct HTTP calls to the Stitch MCP endpoint.
+ */
+import { getConfig } from '../utils/config.js';
+/**
+ * Direct HTTP client for Stitch MCP endpoint.
+ * Used when running as standalone CLI (not inside Claude Code).
+ */
+export class StitchMcpClient {
+    endpoint;
+    apiKey;
+    constructor(apiKey, endpoint) {
+        const config = getConfig();
+        this.apiKey = apiKey || config.apiKey || process.env.STITCH_API_KEY || '';
+        this.endpoint = endpoint || 'https://stitch.googleapis.com/mcp';
+        if (!this.apiKey) {
+            throw new Error('No Stitch API key found. Set STITCH_API_KEY env var or run `forge init`.');
+        }
+    }
+    async callTool(toolName, params) {
+        const maxRetries = 3;
+        // Generation can take 60-90s; other calls are fast
+        const timeout = toolName === 'generate_screen_from_text' ? 120000 : 30000;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                const response = await fetch(this.endpoint, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'Accept': 'application/json',
+                        'X-Goog-Api-Key': this.apiKey,
+                    },
+                    body: JSON.stringify({
+                        jsonrpc: '2.0',
+                        id: Date.now(),
+                        method: 'tools/call',
+                        params: { name: toolName, arguments: params },
+                    }),
+                    signal: AbortSignal.timeout(timeout),
+                });
+                if (!response.ok) {
+                    if (attempt < maxRetries && this.isRetryable(response.status)) {
+                        const delay = Math.pow(2, attempt) * 1000 + Math.random() * 1000;
+                        await new Promise(r => setTimeout(r, delay));
+                        continue;
+                    }
+                    throw new Error(this.formatError(response.status, await response.text()));
+                }
+                const data = await response.json();
+                // JSON-RPC error
+                if (data.error) {
+                    const err = data.error;
+                    throw new Error(`Stitch API error: ${err.message || 'Unknown error'} (code ${err.code || 'unknown'})`);
+                }
+                // MCP tool responses come in result.content[0].text
+                const result = data.result;
+                if (result && Array.isArray(result.content)) {
+                    const textContent = result.content
+                        .find(c => c.type === 'text');
+                    if (textContent?.text) {
+                        try {
+                            return JSON.parse(textContent.text);
+                        }
+                        catch {
+                            return textContent.text;
+                        }
+                    }
+                }
+                return (data.result ?? data);
+            }
+            catch (error) {
+                if (error instanceof Error && error.name === 'TimeoutError') {
+                    if (attempt < maxRetries) {
+                        const delay = Math.pow(2, attempt) * 1000 + Math.random() * 1000;
+                        await new Promise(r => setTimeout(r, delay));
+                        continue;
+                    }
+                    throw new Error('Stitch API request timed out after 30 seconds. Check your network connection.');
+                }
+                // Re-throw non-retryable errors (our own formatted messages)
+                if (error instanceof Error && error.message.startsWith('Stitch')) {
+                    throw error;
+                }
+                if (attempt < maxRetries) {
+                    const delay = Math.pow(2, attempt) * 1000 + Math.random() * 1000;
+                    await new Promise(r => setTimeout(r, delay));
+                    continue;
+                }
+                throw error;
+            }
+        }
+        throw new Error('Stitch API: max retries exceeded');
+    }
+    isRetryable(status) {
+        return [429, 500, 502, 503, 504].includes(status);
+    }
+    formatError(status, body) {
+        switch (status) {
+            case 400: return `Stitch API: Bad request. Check your parameters. (${body.slice(0, 200)})`;
+            case 401: return 'Stitch API: Invalid API key. Run `forge init` to reconfigure.';
+            case 403: return 'Stitch API: Access denied. Check your API key permissions.';
+            case 404: return 'Stitch API: Resource not found. The project or screen may have been deleted.';
+            default: return `Stitch API error (${status}): ${body.slice(0, 200)}`;
+        }
+    }
+    async listProjects() {
+        const raw = await this.callTool('list_projects', {});
+        // API returns { projects: [...] } with resource-style names
+        const projects = raw.projects || (Array.isArray(raw) ? raw : []);
+        return projects.map(p => ({
+            id: this.extractId(p.name),
+            name: p.title || p.name,
+            createdAt: p.createTime || '',
+            screenCount: Array.isArray(p.screenInstances) ? p.screenInstances.length : 0,
+        }));
+    }
+    async getProject(projectId) {
+        const raw = await this.callTool('get_project', {
+            projectId: this.toResourceName(projectId, 'projects'),
+        });
+        return {
+            id: this.extractId(raw.name || projectId),
+            name: raw.title || projectId,
+            createdAt: raw.createTime || '',
+            screenCount: Array.isArray(raw.screenInstances) ? raw.screenInstances.length : 0,
+        };
+    }
+    async listScreens(projectId) {
+        const raw = await this.callTool('list_screens', {
+            projectId: this.toResourceName(projectId, 'projects'),
+        });
+        const screens = raw.screens || (Array.isArray(raw) ? raw : []);
+        return screens.map(s => ({
+            id: this.extractId(s.name || ''),
+            name: s.title || s.name || '',
+            prompt: s.prompt || '',
+            createdAt: s.createTime || '',
+        }));
+    }
+    async generateScreen(projectId, prompt, modelId) {
+        const projResource = this.toResourceName(projectId, 'projects');
+        const projId = this.extractId(projResource);
+        const apiModel = this.mapModelId(modelId || 'GEMINI_2_5_FLASH');
+        const raw = await this.callTool('generate_screen_from_text', {
+            projectId: projId,
+            prompt,
+            ...(apiModel ? { modelId: apiModel } : {}),
+        });
+        // The API returns { projectId, sessionId, outputComponents }.
+        // The screen data is in outputComponents[0].design.screens[0] with:
+        //   id, name, title, htmlCode.downloadUrl, screenshot.downloadUrl
+        const screen = this.extractScreenFromResponse(raw);
+        if (screen)
+            return { ...screen, projectId: projId };
+        // Fallback: list screens and find the latest (may require delay)
+        for (let attempt = 0; attempt < 3; attempt++) {
+            await new Promise(r => setTimeout(r, (attempt + 1) * 2000));
+            const screens = await this.listScreens(projId);
+            if (screens.length > 0) {
+                const last = screens[screens.length - 1];
+                return { screenId: last.id, projectId: projId, name: last.name };
+            }
+        }
+        throw new Error('Screen was generated but could not be retrieved. Try running `forge sync` to pull screens.');
+    }
+    /** Extract screen data directly from generate_screen_from_text response */
+    extractScreenFromResponse(raw) {
+        // Primary path: outputComponents[N].design.screens[0]
+        try {
+            const components = raw.outputComponents;
+            if (components?.length) {
+                for (const comp of components) {
+                    const design = comp.design;
+                    const screens = design?.screens;
+                    if (screens?.length) {
+                        const screen = screens[0];
+                        const htmlCode = screen.htmlCode;
+                        const screenshot = screen.screenshot;
+                        if (screen.id || screen.name) {
+                            return {
+                                screenId: screen.id || this.extractId(screen.name || ''),
+                                name: screen.title || screen.name || '',
+                                htmlCodeUrl: htmlCode?.downloadUrl || undefined,
+                                screenshotUrl: screenshot?.downloadUrl || undefined,
+                            };
+                        }
+                    }
+                }
+            }
+        }
+        catch { /* fall through to deep search */ }
+        // Deep search: find any object with htmlCode.downloadUrl anywhere in the response
+        try {
+            const json = JSON.stringify(raw);
+            const htmlUrlMatch = json.match(/"downloadUrl"\s*:\s*"(https:\/\/contribution[^"]+)"/);
+            const idMatch = json.match(/"id"\s*:\s*"([a-f0-9]{32})"/);
+            const titleMatch = json.match(/"title"\s*:\s*"([^"]+)"/);
+            if (htmlUrlMatch && idMatch) {
+                return {
+                    screenId: idMatch[1],
+                    name: titleMatch?.[1] || 'generated-screen',
+                    htmlCodeUrl: htmlUrlMatch[1],
+                };
+            }
+        }
+        catch { /* give up */ }
+        return null;
+    }
+    async getScreenCode(projectId, screenId, htmlCodeUrl) {
+        // Fast path: if we have a direct download URL from generation response, use it
+        if (htmlCodeUrl) {
+            const res = await fetch(htmlCodeUrl, { signal: AbortSignal.timeout(30000) });
+            if (res.ok)
+                return res.text();
+        }
+        const projResource = this.toResourceName(projectId, 'projects');
+        const projId = this.extractId(projResource);
+        const screenResource = screenId.includes('/')
+            ? screenId
+            : `${projResource}/screens/${screenId}`;
+        const scrId = this.extractId(screenResource);
+        // Try get_screen_code proxy tool (from @_davideast/stitch-mcp)
+        try {
+            const raw = await this.callTool('get_screen_code', {
+                projectId: projResource,
+                screenId: screenResource,
+            });
+            if (typeof raw === 'string')
+                return raw;
+            const obj = raw;
+            return obj.html || obj.code || JSON.stringify(raw);
+        }
+        catch {
+            // Proxy tool not available, try native API
+        }
+        // Native API: get_screen returns htmlCode.downloadUrl
+        // Retry because the screen may take a few seconds to be queryable
+        for (let attempt = 0; attempt < 3; attempt++) {
+            try {
+                const screen = await this.callTool('get_screen', {
+                    name: screenResource,
+                    projectId: projId,
+                    screenId: scrId,
+                });
+                const htmlCode = screen.htmlCode;
+                if (htmlCode?.downloadUrl) {
+                    const htmlRes = await fetch(htmlCode.downloadUrl, {
+                        signal: AbortSignal.timeout(30000),
+                    });
+                    if (htmlRes.ok)
+                        return htmlRes.text();
+                }
+            }
+            catch { /* retry */ }
+            if (attempt < 2)
+                await new Promise(r => setTimeout(r, (attempt + 1) * 2000));
+        }
+        throw new Error('Could not retrieve screen HTML after 3 attempts. The screen may not be ready yet — try `forge sync` to pull screens.');
+    }
+    async getScreenImage(projectId, screenId) {
+        return this.callTool('get_screen_image', {
+            projectId: this.toResourceName(projectId, 'projects'),
+            screenId: this.toResourceName(screenId, `projects/${projectId}/screens`),
+        });
+    }
+    async buildSite(projectId, routes) {
+        return this.callTool('build_site', {
+            projectId: this.toResourceName(projectId, 'projects'),
+            routes,
+        });
+    }
+    /** Extract numeric ID from resource name like "projects/123" or "screens/456" */
+    extractId(resourceName) {
+        if (!resourceName)
+            return '';
+        const parts = resourceName.split('/');
+        return parts[parts.length - 1];
+    }
+    /** Ensure value is a resource name; if it's just an ID, prepend the prefix */
+    toResourceName(value, prefix) {
+        if (value.includes('/'))
+            return value;
+        return `${prefix}/${value}`;
+    }
+    /** Map internal model names to Stitch API model IDs */
+    mapModelId(model) {
+        const mapping = {
+            'GEMINI_2_5_FLASH': 'GEMINI_3_FLASH',
+            'GEMINI_3_PRO': 'GEMINI_3_1_PRO',
+            'GEMINI_3_FLASH': 'GEMINI_3_FLASH',
+            'GEMINI_3_1_PRO': 'GEMINI_3_1_PRO',
+        };
+        return mapping[model];
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/mcp/client.js.map

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

package/dist/mcp/tools.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Tool call builders for Stitch MCP.
+ *
+ * These are used by the standalone CLI (not Claude Code).
+ * Inside Claude Code, the MCP protocol handles tool calls automatically —
+ * Claude Code just calls the tools directly via the MCP server.
+ *
+ * This module builds the JSON-RPC payloads for direct HTTP usage.
+ */
+export interface McpToolCall {
+    method: 'tools/call';
+    params: {
+        name: string;
+        arguments: Record<string, unknown>;
+    };
+}
+export declare function listProjects(): McpToolCall;
+export declare function getProject(projectId: string): McpToolCall;
+export declare function listScreens(projectId: string): McpToolCall;
+export declare function generateScreen(projectId: string, prompt: string, modelId?: string): McpToolCall;
+export declare function getScreenCode(projectId: string, screenId: string): McpToolCall;
+export declare function getScreenImage(projectId: string, screenId: string): McpToolCall;
+export declare function buildSite(projectId: string, routes: Array<{
+    screenId: string;
+    route: string;
+}>): McpToolCall;

package/dist/mcp/tools.js

@@ -0,0 +1,46 @@
+/**
+ * Tool call builders for Stitch MCP.
+ *
+ * These are used by the standalone CLI (not Claude Code).
+ * Inside Claude Code, the MCP protocol handles tool calls automatically —
+ * Claude Code just calls the tools directly via the MCP server.
+ *
+ * This module builds the JSON-RPC payloads for direct HTTP usage.
+ */
+export function listProjects() {
+    return { method: 'tools/call', params: { name: 'list_projects', arguments: {} } };
+}
+export function getProject(projectId) {
+    return { method: 'tools/call', params: { name: 'get_project', arguments: { projectId } } };
+}
+export function listScreens(projectId) {
+    return { method: 'tools/call', params: { name: 'list_screens', arguments: { projectId } } };
+}
+export function generateScreen(projectId, prompt, modelId = 'GEMINI_2_5_FLASH') {
+    return {
+        method: 'tools/call',
+        params: {
+            name: 'generate_screen_from_text',
+            arguments: { projectId, prompt, modelId },
+        },
+    };
+}
+export function getScreenCode(projectId, screenId) {
+    return {
+        method: 'tools/call',
+        params: { name: 'get_screen_code', arguments: { projectId, screenId } },
+    };
+}
+export function getScreenImage(projectId, screenId) {
+    return {
+        method: 'tools/call',
+        params: { name: 'get_screen_image', arguments: { projectId, screenId } },
+    };
+}
+export function buildSite(projectId, routes) {
+    return {
+        method: 'tools/call',
+        params: { name: 'build_site', arguments: { projectId, routes } },
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,MAAM,UAAU,YAAY;IAC1B,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,SAAiB;IAC1C,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,SAAiB,EACjB,MAAc,EACd,OAAO,GAAG,kBAAkB;IAE5B,OAAO;QACL,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE;YACN,IAAI,EAAE,2BAA2B;YACjC,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE;SAC1C;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,QAAgB;IAC/D,OAAO;QACL,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE;KACxE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,QAAgB;IAChE,OAAO;QACL,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE;KACzE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,SAAiB,EACjB,MAAkD;IAElD,OAAO;QACL,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE;KACjE,CAAC;AACJ,CAAC"}

package/dist/research/business-researcher.d.ts

@@ -0,0 +1,41 @@
+import type { BusinessBrief, BusinessModelContext, SiteAnalysis, ExtractedPalette, ExtractedTypography, AudienceInsight, MarketPosition, BusinessResearchResult } from './types.js';
+/**
+ * Extract color palette from HTML by parsing style blocks and inline styles.
+ */
+export declare function extractPalette(html: string): ExtractedPalette;
+/**
+ * Extract typography information from HTML.
+ */
+export declare function extractTypography(html: string): ExtractedTypography;
+/**
+ * Detect common layout patterns from HTML DOM structure.
+ */
+export declare function detectLayoutPatterns(html: string): string[];
+/**
+ * Infer audience insights from industry and audience descriptions.
+ * Knowledge-base lookup, not web search.
+ */
+export declare function inferAudienceInsights(industry: string, audience: string, locale?: string): AudienceInsight;
+/**
+ * Infer market position from the business brief text.
+ */
+export declare function inferMarketPosition(brief: BusinessBrief, _siteAnalysis?: SiteAnalysis): MarketPosition;
+/**
+ * Infer what kind of business this is and what the website should (and should NOT) do.
+ *
+ * Uses a combination of site navigation signals, CTA text, layout patterns, and
+ * industry keywords from the brief to determine the business model. This prevents
+ * generating e-commerce pages for physical-only retailers, or store locators for SaaS products.
+ */
+export declare function inferBusinessModel(brief: BusinessBrief, siteAnalysis?: SiteAnalysis | null): BusinessModelContext;
+/**
+ * Analyze a website by fetching it and extracting design signals.
+ * Returns null on fetch failure (graceful degradation).
+ */
+export declare function analyzeSite(url: string): Promise<SiteAnalysis | null>;
+/**
+ * Perform complete business research for a brief.
+ * Orchestrates site analysis, competitor analysis, audience insights,
+ * market positioning, and business model inference.
+ */
+export declare function researchBusiness(brief: BusinessBrief): Promise<BusinessResearchResult>;