@houtini/gemini-mcp 1.4.5 → 2.2.0

package/dist/tools/register-svg.js

@@ -0,0 +1,84 @@
+import * as z from 'zod';
+import { registerAppTool } from '@modelcontextprotocol/ext-apps/server';
+import { writeFile, mkdir } from 'fs/promises';
+import { dirname, resolve } from 'path';
+import logger from '../utils/logger.js';
+import { McpError, createToolResult } from '../utils/error-handler.js';
+import { savedFileMessage } from '../utils/tool-wrapper.js';
+import { GenerateSVGTool } from './generate-svg.js';
+export function register(ctx) {
+    const svgTool = new GenerateSVGTool(ctx.geminiService);
+    registerAppTool(ctx.server, 'generate_svg', {
+        title: 'Generate SVG Graphic',
+        description: 'Generate scalable vector graphics (SVG) using Gemini. ' +
+            'Creates clean, production-ready SVG code for diagrams, illustrations, icons, and data visualizations. ' +
+            'Returns inline preview with SVG viewer.',
+        inputSchema: {
+            prompt: z.string().describe('Description of the SVG graphic to generate'),
+            width: z.number()
+                .optional()
+                .default(800)
+                .describe('SVG width in pixels (default: 800)'),
+            height: z.number()
+                .optional()
+                .default(600)
+                .describe('SVG height in pixels (default: 600)'),
+            style: z.enum(['technical', 'artistic', 'minimal', 'data-viz'])
+                .optional()
+                .default('technical')
+                .describe('Visual style: technical (diagrams), artistic (illustrations), minimal (simple), data-viz (charts)'),
+            model: z.string()
+                .optional()
+                .describe('Gemini model to use (defaults to configured default)'),
+            outputPath: z.string()
+                .optional()
+                .describe('Optional file path to save the SVG (e.g. C:/output/diagram.svg)'),
+        },
+        _meta: {
+            ui: { resourceUri: 'ui://gemini/svg-viewer.html' }
+        }
+    }, async ({ prompt, width, height, style, model, outputPath }) => {
+        try {
+            logger.info('Executing generate_svg tool', { style, dimensions: `${width}x${height}`, model });
+            const svgContent = await svgTool.execute({
+                prompt,
+                width,
+                height,
+                style,
+                model,
+            });
+            const absolutePath = outputPath
+                ? resolve(outputPath)
+                : resolve(ctx.outputDir, `gemini-${Date.now()}.svg`);
+            await mkdir(dirname(absolutePath), { recursive: true });
+            await writeFile(absolutePath, svgContent, 'utf-8');
+            logger.info('SVG saved successfully', { savedPath: absolutePath });
+            return {
+                structuredContent: {
+                    svgContent,
+                    mimeType: 'image/svg+xml',
+                    savedPath: absolutePath,
+                    description: `${style} style SVG graphic (${width}x${height})`,
+                    prompt
+                },
+                content: [
+                    {
+                        type: 'text',
+                        text: savedFileMessage('SVG saved', absolutePath)
+                    }
+                ]
+            };
+        }
+        catch (error) {
+            logger.error('generate_svg tool failed', { error });
+            const msg = error instanceof McpError
+                ? error.message
+                : `Failed to generate SVG: ${error.message}`;
+            return {
+                content: createToolResult(false, msg, error),
+                structuredContent: { content: msg, success: false },
+            };
+        }
+    });
+}
+//# sourceMappingURL=register-svg.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { ToolContext } from './types.js';
+export declare function register(ctx: ToolContext): void;
+//# sourceMappingURL=register-video.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-video.d.ts","sourceRoot":"","sources":["../../src/tools/register-video.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAgB,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CA+H/C"}

package/dist/tools/register-video.js

@@ -0,0 +1,118 @@
+import * as z from 'zod';
+import { registerAppTool } from '@modelcontextprotocol/ext-apps/server';
+import logger from '../utils/logger.js';
+import { toolError } from '../utils/tool-wrapper.js';
+import { GenerateVideoTool } from './generate-video.js';
+import { imageInputSchema } from './schemas.js';
+import { resolveImageInput } from '../utils/resolve-images.js';
+export function register(ctx) {
+    registerAppTool(ctx.server, 'generate_video', {
+        title: 'Generate Video',
+        description: 'Generate videos using Google Veo 3.1 AI model. Creates realistic 4-8 second videos from text prompts ' +
+            'with optional first-frame image and reference images for character/style consistency. ' +
+            'Supports native audio generation. Processing time: 2-5 minutes for 1080p videos. ' +
+            'Returns video file path with optional thumbnail and HTML preview player. ' +
+            '\u26a0\ufe0f IMPORTANT: Video generation is ASYNC and takes 2-5 minutes. The tool will poll for completion automatically.',
+        inputSchema: {
+            prompt: z.string().describe('Detailed description of the video to generate. Be specific about actions, camera movements, lighting, and style. ' +
+                'Example: "A close-up shot of a futuristic coffee machine brewing a glowing blue espresso, with steam rising dramatically. Cinematic lighting, 4K quality."'),
+            model: z.string().optional().default('veo-3.1-generate-preview')
+                .describe('Video generation model (default: veo-3.1-generate-preview)'),
+            aspectRatio: z.enum(['16:9', '9:16']).optional().default('16:9')
+                .describe('Video aspect ratio: 16:9 (landscape) or 9:16 (portrait/vertical)'),
+            resolution: z.enum(['720p', '1080p', '4k']).optional().default('1080p')
+                .describe('Video resolution. Higher resolutions take longer to generate and result in larger files.'),
+            durationSeconds: z.union([z.literal(4), z.literal(6), z.literal(8)]).optional().default(8)
+                .describe('Video duration in seconds (4, 6, or 8 seconds)'),
+            generateAudio: z.boolean().optional().default(true)
+                .describe('Generate native synchronized audio effects and dialogue based on the prompt'),
+            sampleCount: z.number().min(1).max(4).optional().default(1)
+                .describe('Number of video samples to generate (1-4). Each sample is a separate generation.'),
+            seed: z.number().optional()
+                .describe('Optional seed for deterministic output. Use the same seed with the same prompt for consistent results.'),
+            outputPath: z.string().optional()
+                .describe('Optional custom output path for the video file (e.g., C:/videos/output.mp4). If not provided, saves to default output directory with timestamped filename.'),
+            generateThumbnail: z.boolean().optional().default(true)
+                .describe('Extract thumbnail from video (requires ffmpeg installed). Thumbnail is saved alongside video.'),
+            generateHTMLPlayer: z.boolean().optional().default(true)
+                .describe('Generate interactive HTML video player with preview and download options'),
+            firstFrameImage: imageInputSchema
+                .optional()
+                .describe('Starting frame image for image-to-video generation. Provide via filePath (local file) or data+mimeType (base64). ' +
+                'The video will animate from this image. Supports JPEG, PNG, WebP.'),
+            referenceImages: z.array(z.object({
+                referenceType: z.enum(['asset', 'style']).describe('Type of reference: "asset" for character/object consistency, "style" for visual style transfer'),
+                image: imageInputSchema.describe('The reference image (filePath or base64 data)')
+            }))
+                .max(3)
+                .optional()
+                .describe('Up to 3 reference images for character/style consistency. Each needs a referenceType ("asset" or "style") and an image.')
+        },
+        _meta: {
+            ui: { resourceUri: 'ui://gemini/video-viewer.html' }
+        }
+    }, async ({ prompt, model, aspectRatio, resolution, durationSeconds, generateAudio, sampleCount, seed, outputPath, generateThumbnail, generateHTMLPlayer, firstFrameImage, referenceImages }) => {
+        try {
+            logger.info('Executing generate_video tool', {
+                prompt: prompt.slice(0, 100),
+                duration: durationSeconds || 8,
+                resolution: resolution || '1080p',
+                hasFirstFrame: !!firstFrameImage,
+                referenceImageCount: referenceImages?.length || 0
+            });
+            // Resolve first-frame image from filePath if provided
+            let resolvedFirstFrame;
+            if (firstFrameImage) {
+                const resolved = await resolveImageInput(firstFrameImage);
+                resolvedFirstFrame = { data: resolved.data, mimeType: resolved.mimeType };
+            }
+            // Resolve reference images from filePaths if provided
+            let resolvedReferenceImages;
+            if (referenceImages?.length) {
+                resolvedReferenceImages = await Promise.all(referenceImages.map(async (ref) => {
+                    const resolved = await resolveImageInput(ref.image);
+                    return {
+                        referenceType: ref.referenceType,
+                        image: { data: resolved.data, mimeType: resolved.mimeType }
+                    };
+                }));
+            }
+            const videoTool = new GenerateVideoTool(ctx.geminiService);
+            const { content, metadata } = await videoTool.execute({
+                prompt,
+                model,
+                aspectRatio,
+                resolution,
+                durationSeconds,
+                generateAudio,
+                sampleCount,
+                seed,
+                outputPath,
+                generateThumbnail,
+                generateHTMLPlayer,
+                firstFrameImage: resolvedFirstFrame,
+                referenceImages: resolvedReferenceImages
+            });
+            // Enrich with media server URLs for inline playback in the viewer
+            const enriched = { ...metadata };
+            if (metadata.videoPath) {
+                const videoUrl = ctx.mediaServer.getFileUrl(metadata.videoPath);
+                if (videoUrl)
+                    enriched.videoUrl = videoUrl;
+            }
+            if (metadata.thumbnailPath) {
+                const thumbUrl = ctx.mediaServer.getFileUrl(metadata.thumbnailPath);
+                if (thumbUrl)
+                    enriched.thumbnailUrl = thumbUrl;
+            }
+            return {
+                content,
+                structuredContent: enriched
+            };
+        }
+        catch (error) {
+            return toolError('generate_video', error);
+        }
+    });
+}
+//# sourceMappingURL=register-video.js.map

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

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

package/dist/tools/register-viewers.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Register all MCP App viewer resources from a data-driven spec.
+ * When a mediaServerPort is provided, viewers that need it get CSP whitelisting
+ * to load media from the localhost server.
+ */
+export declare function registerViewers(server: McpServer, distDir: string, mediaServerPort?: number): Promise<void>;
+//# sourceMappingURL=register-viewers.d.ts.map

package/dist/tools/register-viewers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-viewers.d.ts","sourceRoot":"","sources":["../../src/tools/register-viewers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA+CpE;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,EACf,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,CAgEf"}

package/dist/tools/register-viewers.js

@@ -0,0 +1,89 @@
+import { registerAppResource, RESOURCE_MIME_TYPE } from '@modelcontextprotocol/ext-apps/server';
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import logger from '../utils/logger.js';
+const VIEWERS = [
+    {
+        name: 'Image Viewer',
+        resourceId: 'gemini-image-viewer',
+        uri: 'ui://gemini/image-viewer.html',
+        segments: ['image-viewer', 'src', 'ui', 'image-viewer.html'],
+    },
+    {
+        name: 'Video Viewer',
+        resourceId: 'gemini-video-viewer',
+        uri: 'ui://gemini/video-viewer.html',
+        segments: ['video-viewer', 'src', 'ui', 'video-viewer.html'],
+        needsMediaServer: true,
+    },
+    {
+        name: 'SVG Viewer',
+        resourceId: 'gemini-svg-viewer',
+        uri: 'ui://gemini/svg-viewer.html',
+        segments: ['svg-viewer', 'src', 'ui', 'svg-viewer.html'],
+    },
+    {
+        name: 'Landing Page Viewer',
+        resourceId: 'gemini-landing-page-viewer',
+        uri: 'ui://gemini/landing-page-viewer.html',
+        segments: ['landing-page-viewer', 'src', 'ui', 'landing-page-viewer.html'],
+    },
+];
+/**
+ * Register all MCP App viewer resources from a data-driven spec.
+ * When a mediaServerPort is provided, viewers that need it get CSP whitelisting
+ * to load media from the localhost server.
+ */
+export async function registerViewers(server, distDir, mediaServerPort) {
+    const mediaOrigin = mediaServerPort
+        ? `http://127.0.0.1:${mediaServerPort}`
+        : undefined;
+    const results = await Promise.allSettled(VIEWERS.map(async (v) => {
+        const htmlPath = join(distDir, ...v.segments);
+        const html = await readFile(htmlPath, 'utf-8');
+        // Build CSP metadata for viewers that need media server access
+        const needsCsp = v.needsMediaServer && mediaOrigin;
+        const contentMeta = needsCsp
+            ? {
+                _meta: {
+                    ui: {
+                        csp: {
+                            resourceDomains: [mediaOrigin],
+                            connectDomains: [mediaOrigin],
+                        },
+                    },
+                },
+            }
+            : {};
+        registerAppResource(server, v.resourceId, v.uri, {}, async () => ({
+            contents: [{
+                    uri: v.uri,
+                    mimeType: RESOURCE_MIME_TYPE,
+                    text: html,
+                    ...contentMeta,
+                }],
+        }));
+        return v.name;
+    }));
+    const succeeded = results
+        .filter((r) => r.status === 'fulfilled')
+        .map((r) => r.value);
+    const failed = results
+        .map((r, i) => ({ result: r, spec: VIEWERS[i] }))
+        .filter((x) => x.result.status === 'rejected');
+    logger.info('Viewer registration complete', {
+        succeeded: succeeded.length,
+        failed: failed.length,
+        available: succeeded,
+        mediaServerCsp: mediaOrigin || 'none',
+    });
+    if (failed.length > 0) {
+        for (const { spec, result } of failed) {
+            logger.warn(`Failed to load ${spec.name} viewer - inline preview will not be available`, {
+                viewer: spec.name,
+                error: result.reason,
+            });
+        }
+    }
+}
+//# sourceMappingURL=register-viewers.js.map

package/dist/tools/register-viewers.js.map

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

package/dist/tools/schemas.d.ts

@@ -0,0 +1,33 @@
+import * as z from 'zod';
+/**
+ * Shared Zod schema for image input, used by describe_image, analyze_image,
+ * generate_image (reference images), and edit_image.
+ *
+ * Images can be provided in two ways:
+ *  1. Inline base64: set `data` (base64 string) and `mimeType`
+ *  2. File path:     set `filePath` — the tool loads the image server-side,
+ *                    bypassing the MCP transport limit entirely.
+ *
+ * Use `filePath` for large images (>1 MB) to avoid MCP transport failures.
+ * The `load_image_from_path` tool returns a filePath you can pass directly.
+ */
+export declare const imageInputSchema: z.ZodObject<{
+    data: z.ZodOptional<z.ZodString>;
+    filePath: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    thoughtSignature: z.ZodOptional<z.ZodString>;
+    mediaResolution: z.ZodOptional<z.ZodEnum<["MEDIA_RESOLUTION_LOW", "MEDIA_RESOLUTION_MEDIUM", "MEDIA_RESOLUTION_HIGH", "MEDIA_RESOLUTION_ULTRA_HIGH"]>>;
+}, "strip", z.ZodTypeAny, {
+    mimeType?: string;
+    data?: string;
+    thoughtSignature?: string;
+    mediaResolution?: "MEDIA_RESOLUTION_LOW" | "MEDIA_RESOLUTION_MEDIUM" | "MEDIA_RESOLUTION_HIGH" | "MEDIA_RESOLUTION_ULTRA_HIGH";
+    filePath?: string;
+}, {
+    mimeType?: string;
+    data?: string;
+    thoughtSignature?: string;
+    mediaResolution?: "MEDIA_RESOLUTION_LOW" | "MEDIA_RESOLUTION_MEDIUM" | "MEDIA_RESOLUTION_HIGH" | "MEDIA_RESOLUTION_ULTRA_HIGH";
+    filePath?: string;
+}>;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;EA8B3B,CAAC"}

package/dist/tools/schemas.js

@@ -0,0 +1,39 @@
+import * as z from 'zod';
+/**
+ * Shared Zod schema for image input, used by describe_image, analyze_image,
+ * generate_image (reference images), and edit_image.
+ *
+ * Images can be provided in two ways:
+ *  1. Inline base64: set `data` (base64 string) and `mimeType`
+ *  2. File path:     set `filePath` — the tool loads the image server-side,
+ *                    bypassing the MCP transport limit entirely.
+ *
+ * Use `filePath` for large images (>1 MB) to avoid MCP transport failures.
+ * The `load_image_from_path` tool returns a filePath you can pass directly.
+ */
+export const imageInputSchema = z.object({
+    data: z.string()
+        .optional()
+        .describe('Base64 encoded image data'),
+    filePath: z.string()
+        .optional()
+        .describe('Local file path to the image (alternative to base64 data). ' +
+        'The image is loaded server-side, bypassing MCP transport limits. ' +
+        'Use the filePath returned by load_image_from_path.'),
+    mimeType: z.string()
+        .optional()
+        .describe('MIME type of the image (e.g., image/png, image/jpeg). Required when using data, auto-detected from filePath.'),
+    thoughtSignature: z.string()
+        .optional()
+        .describe('Thought signature from a previous generate_image or edit_image call. ' +
+        'Required for conversational editing with Gemini 3 Pro Image. ' +
+        'Pass the thoughtSignature from the previous response to maintain edit context.'),
+    mediaResolution: z.enum([
+        'MEDIA_RESOLUTION_LOW',
+        'MEDIA_RESOLUTION_MEDIUM',
+        'MEDIA_RESOLUTION_HIGH',
+        'MEDIA_RESOLUTION_ULTRA_HIGH'
+    ]).optional().describe('Per-image resolution override. LOW=280 tokens (75% savings), MEDIUM=560 tokens (50% savings), ' +
+        'HIGH=1120 tokens (default), ULTRA_HIGH=2000+ tokens (max detail, per-image only)')
+});
+//# sourceMappingURL=schemas.js.map

package/dist/tools/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;SACb,QAAQ,EAAE;SACV,QAAQ,CAAC,2BAA2B,CAAC;IACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;SACjB,QAAQ,EAAE;SACV,QAAQ,CACP,6DAA6D;QAC7D,mEAAmE;QACnE,oDAAoD,CACrD;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,8GAA8G,CAAC;IAC3H,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;SACzB,QAAQ,EAAE;SACV,QAAQ,CACP,uEAAuE;QACvE,+DAA+D;QAC/D,gFAAgF,CACjF;IACH,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC;QACtB,sBAAsB;QACtB,yBAAyB;QACzB,uBAAuB;QACvB,6BAA6B;KAC9B,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACpB,gGAAgG;QAChG,kFAAkF,CACnF;CACF,CAAC,CAAC"}

package/dist/tools/types.d.ts

@@ -0,0 +1,12 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { GeminiService } from '../services/gemini/index.js';
+import { GeminiImageService } from '../services/gemini/image-service.js';
+import { MediaServer } from '../services/media-server.js';
+export interface ToolContext {
+    server: McpServer;
+    geminiService: GeminiService;
+    imageService: GeminiImageService;
+    outputDir: string;
+    mediaServer: MediaServer;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,kBAAkB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;CAC1B"}

package/dist/tools/types.js

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

package/dist/tools/types.js.map

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

package/dist/ui/image-viewer.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=image-viewer.d.ts.map

package/dist/ui/image-viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-viewer.d.ts","sourceRoot":"","sources":["../../src/ui/image-viewer.ts"],"names":[],"mappings":""}

package/dist/ui/image-viewer.js

@@ -0,0 +1,42 @@
+import { App } from '@modelcontextprotocol/ext-apps';
+const app = new App({ name: 'Gemini Image Viewer', version: '1.0.0' });
+app.ontoolresult = (result) => {
+    const data = result.structuredContent;
+    if (!data || !data.base64Data)
+        return;
+    render(data);
+};
+app.connect();
+function render(data) {
+    const loading = document.getElementById('loading');
+    const content = document.getElementById('content');
+    const img = document.getElementById('img');
+    const pathDisplay = document.getElementById('path-display');
+    const copyBtn = document.getElementById('copy-btn');
+    const descEl = document.getElementById('desc');
+    img.src = `data:${data.mimeType};base64,${data.base64Data}`;
+    if (data.savedPath) {
+        pathDisplay.textContent = data.savedPath;
+        copyBtn.style.display = 'block';
+        copyBtn.addEventListener('click', () => {
+            navigator.clipboard.writeText(data.savedPath).then(() => {
+                copyBtn.textContent = 'Copied!';
+                copyBtn.classList.add('copied');
+                setTimeout(() => {
+                    copyBtn.textContent = 'Copy path';
+                    copyBtn.classList.remove('copied');
+                }, 2000);
+            });
+        });
+    }
+    else {
+        pathDisplay.innerHTML = '<span class="no-path">Not saved to disk</span>';
+    }
+    if (data.description) {
+        descEl.textContent = data.description;
+        descEl.style.display = 'block';
+    }
+    loading.style.display = 'none';
+    content.style.display = 'block';
+}
+//# sourceMappingURL=image-viewer.js.map

package/dist/ui/image-viewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-viewer.js","sourceRoot":"","sources":["../../src/ui/image-viewer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,gCAAgC,CAAC;AASrD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAEvE,GAAG,CAAC,YAAY,GAAG,CAAC,MAA2C,EAAE,EAAE;IACjE,MAAM,IAAI,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACtC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU;QAAE,OAAO;IACtC,MAAM,CAAC,IAAI,CAAC,CAAC;AACf,CAAC,CAAC;AAEF,GAAG,CAAC,OAAO,EAAE,CAAC;AAEd,SAAS,MAAM,CAAC,IAAiB;IAC/B,MAAM,OAAO,GAAG,QAAQ,CAAC,cAAc,CAAC,SAAS,CAAE,CAAC;IACpD,MAAM,OAAO,GAAG,QAAQ,CAAC,cAAc,CAAC,SAAS,CAAE,CAAC;IACpD,MAAM,GAAG,GAAG,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAqB,CAAC;IAC/D,MAAM,WAAW,GAAG,QAAQ,CAAC,cAAc,CAAC,cAAc,CAAE,CAAC;IAC7D,MAAM,OAAO,GAAG,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAsB,CAAC;IACzE,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAE,CAAC;IAEhD,GAAG,CAAC,GAAG,GAAG,QAAQ,IAAI,CAAC,QAAQ,WAAW,IAAI,CAAC,UAAU,EAAE,CAAC;IAE5D,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,WAAW,CAAC,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC;QACzC,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;QAChC,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YACrC,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,SAAU,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;gBACvD,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;gBAChC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAChC,UAAU,CAAC,GAAG,EAAE;oBACd,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;oBAClC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACrC,CAAC,EAAE,IAAI,CAAC,CAAC;YACX,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,WAAW,CAAC,SAAS,GAAG,gDAAgD,CAAC;IAC3E,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;IACjC,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;IAC/B,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;AAClC,CAAC"}

package/dist/utils/chart-design-system.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Professional Chart & Data Visualization Design System
+ *
+ * Based on research from Observable, D3.js, Information is Beautiful,
+ * and modern dashboard design systems.
+ *
+ * Purpose: Enhance prompts with professional design principles to avoid
+ * generic AI-generated aesthetics.
+ */
+export interface ChartStyleOptions {
+    colorScheme?: 'professional' | 'editorial' | 'scientific' | 'minimal' | 'dark';
+    chartType?: 'line' | 'bar' | 'scatter' | 'area' | 'pie' | 'network' | 'heatmap' | 'treemap';
+    emphasis?: 'data-ink' | 'storytelling' | 'exploration' | 'presentation';
+}
+/**
+ * Professional color palettes based on industry standards
+ */
+declare const COLOR_SYSTEMS: {
+    professional: {
+        primary: string[];
+        neutral: string[];
+        accent: string[];
+        description: string;
+    };
+    editorial: {
+        primary: string[];
+        neutral: string[];
+        accent: string[];
+        description: string;
+    };
+    scientific: {
+        primary: string[];
+        neutral: string[];
+        accent: string[];
+        description: string;
+    };
+    minimal: {
+        primary: string[];
+        neutral: string[];
+        accent: string[];
+        description: string;
+    };
+    dark: {
+        primary: string[];
+        neutral: string[];
+        accent: string[];
+        description: string;
+    };
+};
+/**
+ * Generate professional design prompt enhancement
+ */
+export declare function enhanceChartPrompt(basePrompt: string, options?: ChartStyleOptions): string;
+/**
+ * Get color palette for a specific scheme
+ */
+export declare function getColorPalette(scheme: keyof typeof COLOR_SYSTEMS): {
+    primary: string[];
+    neutral: string[];
+    accent: string[];
+    description: string;
+} | {
+    primary: string[];
+    neutral: string[];
+    accent: string[];
+    description: string;
+} | {
+    primary: string[];
+    neutral: string[];
+    accent: string[];
+    description: string;
+} | {
+    primary: string[];
+    neutral: string[];
+    accent: string[];
+    description: string;
+} | {
+    primary: string[];
+    neutral: string[];
+    accent: string[];
+    description: string;
+};
+/**
+ * Validate chart design prompt for common issues
+ */
+export declare function validateChartPrompt(prompt: string): {
+    valid: boolean;
+    warnings: string[];
+    suggestions: string[];
+};
+export {};
+//# sourceMappingURL=chart-design-system.d.ts.map

package/dist/utils/chart-design-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-design-system.d.ts","sourceRoot":"","sources":["../../src/utils/chart-design-system.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,cAAc,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;IAC/E,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5F,QAAQ,CAAC,EAAE,UAAU,GAAG,cAAc,GAAG,aAAa,GAAG,cAAc,CAAC;CACzE;AAED;;GAEG;AACH,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BlB,CAAC;AA+GF;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAuDR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,OAAO,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;EAEjE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG;IACnD,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CA4BA"}