@houtini/gemini-mcp 1.4.5 → 2.2.0

package/dist/tools/generate-landing-page.d.ts

@@ -0,0 +1,15 @@
+import { GeminiService } from '../services/gemini/index.js';
+export interface LandingPageRequest {
+    brief: string;
+    companyName?: string;
+    primaryColour?: string;
+    style?: 'minimal' | 'bold' | 'corporate' | 'startup';
+    sections?: string[];
+    model?: string;
+}
+export declare class GenerateLandingPageTool {
+    private geminiService;
+    constructor(geminiService: GeminiService);
+    execute(request: LandingPageRequest): Promise<string>;
+}
+//# sourceMappingURL=generate-landing-page.d.ts.map

package/dist/tools/generate-landing-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-landing-page.d.ts","sourceRoot":"","sources":["../../src/tools/generate-landing-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAI5D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAgBD,qBAAa,uBAAuB;IACtB,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAE1C,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;CAiD5D"}

package/dist/tools/generate-landing-page.js

@@ -0,0 +1,66 @@
+import { GeminiError } from '../utils/error-handler.js';
+import logger from '../utils/logger.js';
+const SYSTEM_PROMPT = `You are an expert front-end developer specialising in high-converting landing pages.
+Generate complete, self-contained HTML with inline CSS and vanilla JavaScript.
+
+Requirements:
+- Single HTML file, no external dependencies
+- Responsive mobile-first design
+- Modern CSS (flexbox/grid, CSS variables for theming)
+- Smooth scroll, subtle animations where appropriate
+- Semantic HTML5 elements
+- Accessible (ARIA labels, contrast ratios)
+- No placeholder images — use CSS gradients or SVG shapes instead
+
+Output ONLY the raw HTML. No markdown fences, no explanations.`;
+export class GenerateLandingPageTool {
+    geminiService;
+    constructor(geminiService) {
+        this.geminiService = geminiService;
+    }
+    async execute(request) {
+        const style = request.style || 'startup';
+        const sections = request.sections?.length
+            ? request.sections.join(', ')
+            : 'hero, features, social proof, call-to-action';
+        const prompt = `
+Create a landing page for the following brief:
+
+${request.brief}
+
+${request.companyName ? `Company/Product name: ${request.companyName}` : ''}
+${request.primaryColour ? `Primary brand colour: ${request.primaryColour}` : ''}
+Design style: ${style}
+Sections to include: ${sections}
+
+Generate a complete, production-ready single-file HTML landing page.
+`.trim();
+        logger.info('Generating landing page', {
+            style,
+            briefLength: request.brief.length,
+            model: request.model,
+        });
+        let response;
+        try {
+            const result = await this.geminiService.chat({
+                message: prompt,
+                systemPrompt: SYSTEM_PROMPT,
+                model: request.model,
+                maxTokens: 16384,
+                grounding: false,
+            });
+            response = result.content;
+        }
+        catch (error) {
+            throw new GeminiError(`Landing page generation failed: ${error.message}`);
+        }
+        // Strip markdown fences if model includes them despite instructions
+        const fenceMatch = response.match(/```(?:html)?\s*([\s\S]+?)```/i);
+        const html = fenceMatch ? fenceMatch[1].trim() : response.trim();
+        if (!html.toLowerCase().includes('<!doctype') && !html.toLowerCase().includes('<html')) {
+            throw new GeminiError('Model did not return valid HTML. Try again or adjust the brief.');
+        }
+        return html;
+    }
+}
+//# sourceMappingURL=generate-landing-page.js.map

package/dist/tools/generate-landing-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-landing-page.js","sourceRoot":"","sources":["../../src/tools/generate-landing-page.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAWxC,MAAM,aAAa,GAAG;;;;;;;;;;;;+DAYyC,CAAC;AAEhE,MAAM,OAAO,uBAAuB;IACd;IAApB,YAAoB,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAEpD,KAAK,CAAC,OAAO,CAAC,OAA2B;QACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,SAAS,CAAC;QACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,MAAM;YACvC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YAC7B,CAAC,CAAC,8CAA8C,CAAC;QAEnD,MAAM,MAAM,GAAG;;;EAGjB,OAAO,CAAC,KAAK;;EAEb,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,yBAAyB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE;EACzE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,yBAAyB,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE;gBAC/D,KAAK;uBACE,QAAQ;;;CAG9B,CAAC,IAAI,EAAE,CAAC;QAEL,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE;YACrC,KAAK;YACL,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM;YACjC,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QAEH,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;gBAC3C,OAAO,EAAE,MAAM;gBACf,YAAY,EAAE,aAAa;gBAC3B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;YACH,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,WAAW,CAAC,mCAAoC,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACvF,CAAC;QAED,oEAAoE;QACpE,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEjE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACvF,MAAM,IAAI,WAAW,CAAC,iEAAiE,CAAC,CAAC;QAC3F,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/tools/generate-svg.d.ts

@@ -0,0 +1,14 @@
+import { GeminiService } from '../services/gemini/index.js';
+export interface GenerateSVGRequest {
+    prompt: string;
+    width?: number;
+    height?: number;
+    style?: 'technical' | 'artistic' | 'minimal' | 'data-viz';
+    model?: string;
+}
+export declare class GenerateSVGTool {
+    private geminiService;
+    constructor(geminiService: GeminiService);
+    execute(request: GenerateSVGRequest): Promise<string>;
+}
+//# sourceMappingURL=generate-svg.d.ts.map

package/dist/tools/generate-svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-svg.d.ts","sourceRoot":"","sources":["../../src/tools/generate-svg.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAI5D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAmCD,qBAAa,eAAe;IACd,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAE1C,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;CA0E5D"}

package/dist/tools/generate-svg.js

@@ -0,0 +1,106 @@
+import { GeminiError } from '../utils/error-handler.js';
+import logger from '../utils/logger.js';
+const SYSTEM_PROMPT = `You are an expert SVG developer specializing in creating clean, SIMPLE, scalable vector graphics.
+Generate complete, valid SVG code that is self-contained and production-ready.
+
+CRITICAL CONSTRAINTS - MUST FOLLOW:
+- Maximum 150 lines of SVG code total
+- Prefer simple shapes (rect, circle, ellipse, line, polygon) over complex paths
+- Use <text> elements for labels - NEVER attempt to draw text with paths
+- Maximum 20 distinct elements (shapes, paths, groups combined)
+- Each <path> should have maximum 10 commands (M, L, C, Q, etc.)
+- For icons/logos: Use 3-5 simple shapes maximum
+- For diagrams: Use rectangles and lines with <text> labels
+- For illustrations: Combine 10-15 basic shapes creatively
+
+Technical Requirements:
+- Valid SVG with proper viewBox and namespace declaration
+- Clean, readable code with proper formatting and indentation
+- Use semantic groups (<g>) for logical organization
+- Include <title> and <desc> for accessibility
+- Use inline CSS within <style> tags when needed
+- No external dependencies - all fonts, gradients, patterns inline
+- Prefer solid fills over complex gradients
+- Use appropriate SVG elements (rect, circle, path, polygon, text, etc.)
+
+EFFICIENCY RULES:
+- ONE rectangle is better than a path with 4 lines
+- ONE circle is better than a path with arc commands
+- ONE <text> element is better than trying to draw letters
+- Simple gradients (2-3 stops) are acceptable, complex ones are not
+- Reuse elements with <use> and <defs> when possible
+
+CRITICAL OUTPUT FORMAT:
+Return ONLY the raw, valid SVG code. Do not wrap it in markdown backticks. Do not include any explanations or conversational text before or after the SVG.`;
+export class GenerateSVGTool {
+    geminiService;
+    constructor(geminiService) {
+        this.geminiService = geminiService;
+    }
+    async execute(request) {
+        const width = request.width || 800;
+        const height = request.height || 600;
+        const style = request.style || 'technical';
+        const styleGuides = {
+            technical: 'Clean technical diagram style with clear labels, grid-aligned elements, and professional color scheme (blues, greys). Suitable for architecture diagrams, flowcharts, system designs.',
+            artistic: 'Creative, visually striking design with gradients, interesting compositions, and artistic flair. Suitable for logos, illustrations, decorative graphics.',
+            minimal: 'Minimalist design with simple shapes, limited color palette (2-3 colors max), and plenty of whitespace. Clean, modern aesthetic.',
+            'data-viz': 'Data visualization style with clear axes, legends, labels, and appropriate chart types. Professional presentation quality.'
+        };
+        const prompt = `
+Create a SIMPLE, ELEGANT SVG graphic for the following request:
+
+${request.prompt}
+
+Dimensions: ${width}x${height}
+Style: ${style} - ${styleGuides[style]}
+
+STRICT CONSTRAINTS:
+- Maximum 150 lines of code total
+- Maximum 20 elements (shapes + paths + groups)
+- Use basic shapes (rect, circle, line) - avoid complex paths
+- Use <text> elements for any text - NEVER draw letters with paths
+- Each path maximum 10 commands
+
+Generate a complete, production-ready SVG with viewBox="0 0 ${width} ${height}".
+
+Remember: Elegant simplicity beats complex over-engineering. Fewer elements, clearer result.
+`.trim();
+        logger.info('Generating SVG', {
+            style,
+            dimensions: `${width}x${height}`,
+            model: request.model,
+        });
+        let response;
+        try {
+            const result = await this.geminiService.chat({
+                message: prompt,
+                systemPrompt: SYSTEM_PROMPT,
+                model: request.model || 'gemini-3-flash-preview',
+                maxTokens: 8192,
+                grounding: false,
+            });
+            response = result.content;
+        }
+        catch (error) {
+            throw new GeminiError(`SVG generation failed: ${error.message}`);
+        }
+        // Strip markdown fences and any extra whitespace/text
+        let svg = response.trim();
+        // Remove markdown code blocks
+        svg = svg.replace(/^```(?:xml|svg|html)?\n/i, '').replace(/\n```$/i, '');
+        // If there's still a markdown fence, try more aggressive matching
+        const fenceMatch = svg.match(/```(?:svg|xml|html)?\s*([\s\S]+?)```/i);
+        if (fenceMatch) {
+            svg = fenceMatch[1].trim();
+        }
+        // Remove any leading/trailing whitespace
+        svg = svg.trim();
+        // Validate SVG
+        if (!svg.toLowerCase().includes('<svg') || !svg.toLowerCase().includes('</svg>')) {
+            throw new GeminiError('Model did not return valid SVG. Try again or adjust the prompt.');
+        }
+        return svg;
+    }
+}
+//# sourceMappingURL=generate-svg.js.map

package/dist/tools/generate-svg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-svg.js","sourceRoot":"","sources":["../../src/tools/generate-svg.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAUxC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2JA+BqI,CAAC;AAE5J,MAAM,OAAO,eAAe;IACN;IAApB,YAAoB,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAEpD,KAAK,CAAC,OAAO,CAAC,OAA2B;QACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC;QACnC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC;QACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC;QAE3C,MAAM,WAAW,GAA2B;YAC1C,SAAS,EAAE,uLAAuL;YAClM,QAAQ,EAAE,0JAA0J;YACpK,OAAO,EAAE,kIAAkI;YAC3I,UAAU,EAAE,4HAA4H;SACzI,CAAC;QAEF,MAAM,MAAM,GAAG;;;EAGjB,OAAO,CAAC,MAAM;;cAEF,KAAK,IAAI,MAAM;SACpB,KAAK,MAAM,WAAW,CAAC,KAAK,CAAC;;;;;;;;;8DASwB,KAAK,IAAI,MAAM;;;CAG5E,CAAC,IAAI,EAAE,CAAC;QAEL,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE;YAC5B,KAAK;YACL,UAAU,EAAE,GAAG,KAAK,IAAI,MAAM,EAAE;YAChC,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QAEH,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;gBAC3C,OAAO,EAAE,MAAM;gBACf,YAAY,EAAE,aAAa;gBAC3B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,wBAAwB;gBAChD,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,KAAK;aACjB,CAAC,CAAC;YACH,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,WAAW,CAAC,0BAA2B,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,sDAAsD;QACtD,IAAI,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAE1B,8BAA8B;QAC9B,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAEzE,kEAAkE;QAClE,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QACtE,IAAI,UAAU,EAAE,CAAC;YACf,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;QAED,yCAAyC;QACzC,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAEjB,eAAe;QACf,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjF,MAAM,IAAI,WAAW,CAAC,iEAAiE,CAAC,CAAC;QAC3F,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/tools/generate-video.d.ts

@@ -0,0 +1,24 @@
+import { TextContent, ImageContent } from '@modelcontextprotocol/sdk/types.js';
+import { GeminiService } from '../services/gemini/index.js';
+interface VideoResult {
+    videoPath: string;
+    mimeType: string;
+    duration: number;
+    resolution: string;
+    aspectRatio: string;
+    prompt: string;
+    thumbnailPath?: string;
+    htmlPlayerPath?: string;
+    [key: string]: unknown;
+}
+interface GenerateVideoResult {
+    content: (TextContent | ImageContent)[];
+    metadata: VideoResult;
+}
+export declare class GenerateVideoTool {
+    private geminiService;
+    constructor(geminiService: GeminiService);
+    execute(args: any): Promise<GenerateVideoResult>;
+}
+export {};
+//# sourceMappingURL=generate-video.d.ts.map

package/dist/tools/generate-video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-video.d.ts","sourceRoot":"","sources":["../../src/tools/generate-video.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAO5D,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,mBAAmB;IAC3B,OAAO,EAAE,CAAC,WAAW,GAAG,YAAY,CAAC,EAAE,CAAC;IACxC,QAAQ,EAAE,WAAW,CAAC;CACvB;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAE1C,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAiLvD"}

package/dist/tools/generate-video.js

@@ -0,0 +1,163 @@
+import { McpError } from '../utils/error-handler.js';
+import { extractThumbnail, generateVideoPlayerHTML, saveVideoPlayerHTML } from '../utils/video-utils.js';
+import logger from '../utils/logger.js';
+import fs from 'fs/promises';
+export class GenerateVideoTool {
+    geminiService;
+    constructor(geminiService) {
+        this.geminiService = geminiService;
+    }
+    async execute(args) {
+        try {
+            logger.info('Starting video generation', {
+                prompt: args.prompt.slice(0, 100),
+                duration: args.durationSeconds || 8,
+                resolution: args.resolution || '1080p'
+            });
+            const result = await this.geminiService.generateVideo({
+                prompt: args.prompt,
+                model: args.model,
+                aspectRatio: args.aspectRatio,
+                resolution: args.resolution,
+                durationSeconds: args.durationSeconds,
+                generateAudio: args.generateAudio,
+                sampleCount: args.sampleCount,
+                seed: args.seed,
+                outputPath: args.outputPath,
+                firstFrameImage: args.firstFrameImage,
+                referenceImages: args.referenceImages
+            });
+            const responseContent = [];
+            // Generate summary report
+            let report = '# Video Generation Complete\n\n';
+            report += `**Prompt:** ${args.prompt}\n\n`;
+            report += `**Video Details:**\n`;
+            report += `- Duration: ${result.duration} seconds\n`;
+            report += `- Resolution: ${result.resolution}\n`;
+            report += `- Aspect Ratio: ${result.aspectRatio}\n`;
+            report += `- Format: ${result.mimeType}\n`;
+            report += `- Audio: ${args.generateAudio !== false ? 'Enabled' : 'Disabled'}\n`;
+            if (args.firstFrameImage) {
+                report += `- First Frame: Provided (image-to-video mode)\n`;
+            }
+            if (args.referenceImages?.length) {
+                report += `- Reference Images: ${args.referenceImages.length} (${args.referenceImages.map((r) => r.referenceType).join(', ')})\n`;
+            }
+            report += `\n`;
+            // Video file info
+            const stats = await fs.stat(result.videoPath);
+            const sizeInMB = (stats.size / (1024 * 1024)).toFixed(2);
+            report += `**Output:**\n`;
+            report += `- Video: \`${result.videoPath}\` (${sizeInMB} MB)\n`;
+            // Generate thumbnail if requested
+            let thumbnailPath;
+            if (args.generateThumbnail !== false) {
+                try {
+                    thumbnailPath = await extractThumbnail({
+                        videoPath: result.videoPath,
+                        timeSeconds: 1
+                    });
+                    if (thumbnailPath) {
+                        report += `- Thumbnail: \`${thumbnailPath}\`\n`;
+                        result.thumbnailPath = thumbnailPath;
+                        // Include thumbnail as image content for Claude Desktop preview
+                        try {
+                            const thumbnailData = await fs.readFile(thumbnailPath);
+                            const base64Thumbnail = thumbnailData.toString('base64');
+                            responseContent.push({
+                                type: 'image',
+                                data: base64Thumbnail,
+                                mimeType: 'image/jpeg'
+                            });
+                            logger.info('Thumbnail included in response', { path: thumbnailPath });
+                        }
+                        catch (error) {
+                            logger.warn('Failed to include thumbnail in response', { error });
+                        }
+                    }
+                    else {
+                        report += `- Thumbnail: ⚠️ Not generated (ffmpeg not available)\n`;
+                        logger.warn('Thumbnail extraction skipped - ffmpeg not found');
+                    }
+                }
+                catch (error) {
+                    logger.warn('Thumbnail extraction failed', { error: error.message });
+                    report += `- Thumbnail: ⚠️ Generation failed\n`;
+                }
+            }
+            // Generate HTML player if requested
+            let htmlPlayerPath;
+            let htmlPlayerContent;
+            if (args.generateHTMLPlayer !== false) {
+                try {
+                    const htmlContent = generateVideoPlayerHTML(result.videoPath, thumbnailPath, {
+                        prompt: args.prompt,
+                        duration: result.duration,
+                        resolution: result.resolution,
+                        aspectRatio: result.aspectRatio
+                    });
+                    htmlPlayerPath = result.videoPath.replace(/\.(mp4|webm)$/, '.html');
+                    await saveVideoPlayerHTML(htmlContent, htmlPlayerPath);
+                    htmlPlayerContent = htmlContent; // Store for inline preview
+                    report += `- HTML Player: \`${htmlPlayerPath}\`\n`;
+                    report += `\n💡 **Tip:** Video player available in inline preview below.\n`;
+                    logger.info('HTML player generated', { path: htmlPlayerPath });
+                }
+                catch (error) {
+                    logger.warn('HTML player generation failed', { error: error.message });
+                    report += `- HTML Player: ⚠️ Generation failed\n`;
+                }
+            }
+            report += `\n---\n\n`;
+            report += `⏱️ **Processing Time:** Video generation took approximately 2-5 minutes\n`;
+            report += `🎬 **Model:** Veo 3.1 (Google's latest video generation model)\n`;
+            // Add text content first
+            responseContent.unshift({
+                type: 'text',
+                text: report
+            });
+            logger.info('Video generation completed successfully', {
+                videoPath: result.videoPath,
+                size: sizeInMB + ' MB',
+                hasThumbnail: !!thumbnailPath
+            });
+            const metadata = {
+                videoPath: result.videoPath,
+                mimeType: result.mimeType || 'video/mp4',
+                duration: args.durationSeconds || 8,
+                resolution: args.resolution || '1080p',
+                aspectRatio: args.aspectRatio || '16:9',
+                prompt: args.prompt,
+                thumbnailPath,
+                htmlPlayerPath,
+                videoHtml: htmlPlayerContent // Include HTML for inline preview
+            };
+            return {
+                content: responseContent,
+                metadata
+            };
+        }
+        catch (error) {
+            logger.error('Video generation failed', {
+                error: error.message,
+                stack: error.stack
+            });
+            if (error instanceof McpError) {
+                throw error;
+            }
+            const errorMessage = error.message || 'Unknown error';
+            throw new McpError(`Video generation failed: ${errorMessage}\n\n` +
+                `This could be due to:\n` +
+                `1. API quota or rate limits exceeded\n` +
+                `2. Invalid prompt or parameters\n` +
+                `3. Network connectivity issues\n` +
+                `4. Model unavailable or overloaded\n\n` +
+                `Please try:\n` +
+                `- Simplifying your prompt\n` +
+                `- Reducing resolution or duration\n` +
+                `- Waiting a few moments before retrying\n` +
+                `- Checking your API quota at https://aistudio.google.com/`, 'VIDEO_GENERATION_FAILED');
+        }
+    }
+}
+//# sourceMappingURL=generate-video.js.map

package/dist/tools/generate-video.js.map

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

package/dist/tools/image-prompt-assistant.d.ts

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

package/dist/tools/image-prompt-assistant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-prompt-assistant.d.ts","sourceRoot":"","sources":["../../src/tools/image-prompt-assistant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2tBpE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqG/D"}