@houtini/gemini-mcp 1.4.5 → 2.2.0

package/dist/utils/chart-design-system.js

@@ -0,0 +1,235 @@
+/**
+ * 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.
+ */
+/**
+ * Professional color palettes based on industry standards
+ */
+const COLOR_SYSTEMS = {
+    professional: {
+        primary: ['#2563eb', '#7c3aed', '#dc2626', '#ea580c', '#ca8a04'],
+        neutral: ['#0f172a', '#475569', '#94a3b8', '#cbd5e1', '#f1f5f9'],
+        accent: ['#06b6d4', '#10b981', '#f59e0b'],
+        description: 'IBM Carbon, Tailwind-inspired professional palette'
+    },
+    editorial: {
+        primary: ['#e63946', '#f1faee', '#a8dadc', '#457b9d', '#1d3557'],
+        neutral: ['#2b2d42', '#8d99ae', '#edf2f4'],
+        accent: ['#ff6b6b', '#4ecdc4'],
+        description: 'FiveThirtyEight, Economist-inspired editorial colours'
+    },
+    scientific: {
+        primary: ['#003f5c', '#58508d', '#bc5090', '#ff6361', '#ffa600'],
+        neutral: ['#1a1a1a', '#4a4a4a', '#8a8a8a', '#cacaca', '#f0f0f0'],
+        accent: ['#00d9ff', '#7209b7'],
+        description: 'Nature, Science journal-inspired academic palette'
+    },
+    minimal: {
+        primary: ['#000000', '#404040', '#737373', '#a6a6a6', '#d9d9d9'],
+        neutral: ['#fafafa', '#f5f5f5', '#e5e5e5'],
+        accent: ['#2563eb', '#dc2626'],
+        description: 'Edward Tufte-inspired minimal data-ink approach'
+    },
+    dark: {
+        primary: ['#60a5fa', '#a78bfa', '#f472b6', '#fb923c', '#fbbf24'],
+        neutral: ['#0a0a0a', '#1f1f1f', '#404040', '#737373', '#a6a6a6'],
+        accent: ['#22d3ee', '#34d399'],
+        description: 'Observable dark mode, GitHub dark-inspired'
+    }
+};
+/**
+ * Typography systems based on research findings
+ */
+const TYPOGRAPHY_SYSTEMS = {
+    professional: {
+        title: 'Inter or SF Pro (system-ui fallback)',
+        labels: 'Inter or Roboto',
+        data: 'JetBrains Mono or SF Mono (monospace)',
+        sizes: {
+            title: '18-24px',
+            subtitle: '14-16px',
+            labels: '11-13px',
+            annotations: '10-12px'
+        }
+    },
+    editorial: {
+        title: 'Playfair Display or Georgia',
+        labels: 'Inter or Franklin Gothic',
+        data: 'Courier New or monospace',
+        sizes: {
+            title: '24-32px',
+            subtitle: '16-20px',
+            labels: '12-14px',
+            annotations: '11-13px'
+        }
+    },
+    scientific: {
+        title: 'Arial or Helvetica',
+        labels: 'Arial or Helvetica',
+        data: 'Monaco or Consolas',
+        sizes: {
+            title: '16-20px',
+            subtitle: '13-15px',
+            labels: '10-12px',
+            annotations: '9-11px'
+        }
+    }
+};
+/**
+ * Design principles based on best practices
+ */
+const DESIGN_PRINCIPLES = {
+    'data-ink': `
+    • Maximize data-ink ratio (Tufte principle)
+    • Remove chartjunk and unnecessary decoration
+    • Use subtle gridlines (1px, 10-15% opacity)
+    • Direct labeling instead of legends when possible
+    • Minimal borders and backgrounds
+  `,
+    'storytelling': `
+    • Clear visual hierarchy with focal points
+    • Progressive disclosure of complexity
+    • Annotations and callouts for key insights
+    • Contextual reference lines or benchmarks
+    • Narrative flow through chart elements
+  `,
+    'exploration': `
+    • Rich interactive affordances suggested visually
+    • Tooltip regions clearly defined
+    • Hover states indicated subtly
+    • Multiple layers of detail accessibility
+    • Clear filtering and selection states
+  `,
+    'presentation': `
+    • High contrast for projector/screen visibility
+    • Large, readable text (minimum 12px)
+    • Strong visual anchors and structure
+    • Balanced whitespace and breathing room
+    • Professional polish without decoration
+  `
+};
+/**
+ * Chart-specific best practices
+ */
+const CHART_SPECIFICS = {
+    line: `
+    • Line weight: 2-3px for primary, 1-2px for secondary
+    • Point markers only at data points, not everywhere
+    • Differentiate series with both colour AND line style
+    • Y-axis starts at 0 unless justified otherwise
+  `,
+    bar: `
+    • Bar spacing: 10-30% of bar width
+    • Sorted by value unless categorical order matters
+    • Horizontal bars for long labels
+    • Subtle rounded corners (2-4px) for modern feel
+  `,
+    scatter: `
+    • Point size: 4-8px diameter
+    • 30-50% opacity for overlapping points
+    • Trend lines should be subtle (dashed, lighter colour)
+    • Legend shows both shape AND colour
+  `,
+    pie: `
+    • Maximum 5-7 slices (combine small values into "Other")
+    • Start at 12 o'clock, arrange clockwise by size
+    • Consider donut chart (60-70% inner radius)
+    • Direct slice labeling with values
+  `,
+    heatmap: `
+    • Sequential colour scale for continuous data
+    • Diverging scale for data with meaningful midpoint
+    • Include colour legend with numerical scale
+    • Cell annotations for key values
+  `
+};
+/**
+ * Generate professional design prompt enhancement
+ */
+export function enhanceChartPrompt(basePrompt, options = {}) {
+    const { colorScheme = 'professional', chartType = 'bar', emphasis = 'data-ink' } = options;
+    const colors = COLOR_SYSTEMS[colorScheme];
+    const typography = TYPOGRAPHY_SYSTEMS[colorScheme === 'editorial' ? 'editorial' :
+        colorScheme === 'scientific' ? 'scientific' : 'professional'];
+    const principles = DESIGN_PRINCIPLES[emphasis];
+    const specifics = CHART_SPECIFICS[chartType] || '';
+    return `${basePrompt}
+
+PROFESSIONAL DESIGN SYSTEM:
+Style: ${colors.description}
+
+COLOUR PALETTE:
+Primary: ${colors.primary.join(', ')}
+Neutral greys: ${colors.neutral.join(', ')}  
+Accent: ${colors.accent.join(', ')}
+
+TYPOGRAPHY:
+• Titles: ${typography.title} at ${typography.sizes.title}, font-weight 600
+• Axis labels: ${typography.labels} at ${typography.sizes.labels}, font-weight 500
+• Data labels: ${typography.data} at ${typography.sizes.labels}
+• Annotations: ${typography.labels} at ${typography.sizes.annotations}, font-weight 400
+
+DESIGN PRINCIPLES:${principles}
+
+CHART-SPECIFIC GUIDELINES:${specifics}
+
+LAYOUT & SPACING:
+• Margins: 40-60px (top/bottom), 50-80px (left/right) for axis labels
+• Title placement: top-left or centered, 20-30px from chart area
+• Legend: top-right or bottom, with 16px item spacing
+• Grid: subtle (1px, #000 at 8-12% opacity), aligned to data ticks
+
+AVOID:
+❌ 3D effects, shadows, or gradients on data elements
+❌ Decorative borders, backgrounds, or textures
+❌ Bright, saturated neon colours
+❌ Comic Sans, Papyrus, or novelty fonts
+❌ Unnecessary chart elements (chartjunk)
+❌ Default chart library aesthetics (Excel, Google Sheets look)
+
+ACHIEVE:
+✓ Clean, confident, professional presentation
+✓ Accessibility (WCAG AA contrast ratios minimum)
+✓ Print-ready quality (300 DPI equivalent)
+✓ Timeless design that won't look dated
+✓ Focus on data clarity and insight`;
+}
+/**
+ * Get color palette for a specific scheme
+ */
+export function getColorPalette(scheme) {
+    return COLOR_SYSTEMS[scheme];
+}
+/**
+ * Validate chart design prompt for common issues
+ */
+export function validateChartPrompt(prompt) {
+    const warnings = [];
+    const suggestions = [];
+    // Check for anti-patterns
+    if (prompt.toLowerCase().includes('3d') || prompt.toLowerCase().includes('shadow')) {
+        warnings.push('3D effects and shadows reduce data clarity');
+        suggestions.push('Use flat design with subtle depth cues instead');
+    }
+    if (prompt.toLowerCase().includes('gradient') && prompt.includes('data')) {
+        warnings.push('Gradients on data elements can be distracting');
+        suggestions.push('Reserve gradients for backgrounds only, if at all');
+    }
+    if (!prompt.toLowerCase().includes('color') && !prompt.toLowerCase().includes('colour')) {
+        suggestions.push('Consider specifying a professional colour palette');
+    }
+    if (!prompt.toLowerCase().includes('font') && !prompt.toLowerCase().includes('typography')) {
+        suggestions.push('Specify typography for more professional results');
+    }
+    return {
+        valid: warnings.length === 0,
+        warnings,
+        suggestions
+    };
+}
+//# sourceMappingURL=chart-design-system.js.map

package/dist/utils/chart-design-system.js.map

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

package/dist/utils/image-compress.d.ts

@@ -0,0 +1,9 @@
+export interface CompressResult {
+    base64: string;
+    mimeType: 'image/jpeg';
+    originalBytes: number;
+    previewBytes: number;
+    wasCompressed: boolean;
+}
+export declare function compressForViewer(base64Data: string, sourceMimeType: string): Promise<CompressResult>;
+//# sourceMappingURL=image-compress.d.ts.map

package/dist/utils/image-compress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-compress.d.ts","sourceRoot":"","sources":["../../src/utils/image-compress.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,cAAc,CAAC,CAyCzB"}

package/dist/utils/image-compress.js

@@ -0,0 +1,43 @@
+import sharp from 'sharp';
+const MAX_VIEWER_DIMENSION = 1024;
+const VIEWER_QUALITY = 100;
+const MAX_VIEWER_BYTES = 400_000;
+export async function compressForViewer(base64Data, sourceMimeType) {
+    const inputBuffer = Buffer.from(base64Data, 'base64');
+    const originalBytes = inputBuffer.length;
+    const outputBuffer = await sharp(inputBuffer)
+        .resize(MAX_VIEWER_DIMENSION, MAX_VIEWER_DIMENSION, {
+        fit: 'inside',
+        withoutEnlargement: true,
+    })
+        .jpeg({ quality: VIEWER_QUALITY, mozjpeg: true })
+        .toBuffer();
+    if (outputBuffer.length > MAX_VIEWER_BYTES) {
+        for (const quality of [95, 90, 85]) {
+            const retryBuffer = await sharp(inputBuffer)
+                .resize(MAX_VIEWER_DIMENSION, MAX_VIEWER_DIMENSION, {
+                fit: 'inside',
+                withoutEnlargement: true,
+            })
+                .jpeg({ quality, mozjpeg: true })
+                .toBuffer();
+            if (retryBuffer.length <= MAX_VIEWER_BYTES) {
+                return {
+                    base64: retryBuffer.toString('base64'),
+                    mimeType: 'image/jpeg',
+                    originalBytes,
+                    previewBytes: retryBuffer.length,
+                    wasCompressed: true,
+                };
+            }
+        }
+    }
+    return {
+        base64: outputBuffer.toString('base64'),
+        mimeType: 'image/jpeg',
+        originalBytes,
+        previewBytes: outputBuffer.length,
+        wasCompressed: true,
+    };
+}
+//# sourceMappingURL=image-compress.js.map

package/dist/utils/image-compress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-compress.js","sourceRoot":"","sources":["../../src/utils/image-compress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAClC,MAAM,cAAc,GAAG,GAAG,CAAC;AAC3B,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAUjC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAkB,EAClB,cAAsB;IAEtB,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACtD,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,CAAC;IAEzC,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC;SAC1C,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,EAAE;QAClD,GAAG,EAAE,QAAQ;QACb,kBAAkB,EAAE,IAAI;KACzB,CAAC;SACD,IAAI,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SAChD,QAAQ,EAAE,CAAC;IAEd,IAAI,YAAY,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAC3C,KAAK,MAAM,OAAO,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;YACnC,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC;iBACzC,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,EAAE;gBAClD,GAAG,EAAE,QAAQ;gBACb,kBAAkB,EAAE,IAAI;aACzB,CAAC;iBACD,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;iBAChC,QAAQ,EAAE,CAAC;YAEd,IAAI,WAAW,CAAC,MAAM,IAAI,gBAAgB,EAAE,CAAC;gBAC3C,OAAO;oBACL,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC;oBACtC,QAAQ,EAAE,YAAY;oBACtB,aAAa;oBACb,YAAY,EAAE,WAAW,CAAC,MAAM;oBAChC,aAAa,EAAE,IAAI;iBACpB,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACvC,QAAQ,EAAE,YAAY;QACtB,aAAa;QACb,YAAY,EAAE,YAAY,CAAC,MAAM;QACjC,aAAa,EAAE,IAAI;KACpB,CAAC;AACJ,CAAC"}

package/dist/utils/image-utils.d.ts

@@ -0,0 +1,9 @@
+export declare function saveImageToFile(base64Data: string, outputPath: string): Promise<string>;
+export declare function createImagePreviewHtml(imagePath: string, prompt: string, description?: string): Promise<string>;
+export interface ProcessedImage {
+    savedPath: string;
+    previewPath: string;
+    previewImageData: string;
+}
+export declare function processGeneratedImage(base64Data: string, mimeType: string, savePath: string, prompt: string, description?: string): Promise<ProcessedImage>;
+//# sourceMappingURL=image-utils.d.ts.map

package/dist/utils/image-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-utils.d.ts","sourceRoot":"","sources":["../../src/utils/image-utils.ts"],"names":[],"mappings":"AAKA,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK7F;AAED,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAsOjB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,cAAc,CAAC,CAkBzB"}

package/dist/utils/image-utils.js

@@ -0,0 +1,257 @@
+import { writeFile, mkdir } from 'fs/promises';
+import { dirname, resolve } from 'path';
+import logger from './logger.js';
+import { compressForViewer } from './image-compress.js';
+export async function saveImageToFile(base64Data, outputPath) {
+    const absolutePath = resolve(outputPath);
+    await mkdir(dirname(absolutePath), { recursive: true });
+    await writeFile(absolutePath, Buffer.from(base64Data, 'base64'));
+    return absolutePath;
+}
+export async function createImagePreviewHtml(imagePath, prompt, description) {
+    const htmlPath = imagePath.replace(/\.(png|jpg|jpeg|webp)$/i, '.html');
+    const imageFilename = imagePath.split(/[/\\]/).pop() || 'image';
+    const html = `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Gemini Image: ${imageFilename}</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+      min-height: 100vh;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      padding: 20px;
+    }
+    .container {
+      background: white;
+      border-radius: 12px;
+      box-shadow: 0 20px 60px rgba(0,0,0,0.3);
+      max-width: 1200px;
+      width: 100%;
+      overflow: hidden;
+    }
+    .header {
+      background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+      color: white;
+      padding: 30px;
+      text-align: center;
+    }
+    .header h1 {
+      font-size: 24px;
+      margin-bottom: 10px;
+    }
+    .header p {
+      opacity: 0.9;
+      font-size: 14px;
+    }
+    .content {
+      padding: 40px;
+    }
+    .image-container {
+      text-align: center;
+      margin-bottom: 30px;
+      background: #f8f9fa;
+      border-radius: 8px;
+      padding: 20px;
+    }
+    .image-container img {
+      max-width: 100%;
+      height: auto;
+      border-radius: 8px;
+      box-shadow: 0 4px 12px rgba(0,0,0,0.1);
+    }
+    .metadata {
+      background: #f8f9fa;
+      border-radius: 8px;
+      padding: 20px;
+      margin-top: 20px;
+    }
+    .metadata h2 {
+      font-size: 18px;
+      margin-bottom: 15px;
+      color: #333;
+    }
+    .metadata-item {
+      margin-bottom: 15px;
+      padding-bottom: 15px;
+      border-bottom: 1px solid #e0e0e0;
+    }
+    .metadata-item:last-child {
+      border-bottom: none;
+      margin-bottom: 0;
+      padding-bottom: 0;
+    }
+    .metadata-label {
+      font-weight: 600;
+      color: #667eea;
+      display: block;
+      margin-bottom: 5px;
+      font-size: 14px;
+      text-transform: uppercase;
+      letter-spacing: 0.5px;
+    }
+    .metadata-value {
+      color: #555;
+      line-height: 1.6;
+    }
+    .prompt-box {
+      background: #fff;
+      border: 2px solid #667eea;
+      border-radius: 6px;
+      padding: 15px;
+      margin-top: 10px;
+      position: relative;
+      font-family: 'Consolas', 'Monaco', monospace;
+      font-size: 14px;
+      line-height: 1.6;
+      word-wrap: break-word;
+    }
+    .copy-btn {
+      position: absolute;
+      top: 10px;
+      right: 10px;
+      background: #667eea;
+      color: white;
+      border: none;
+      padding: 6px 12px;
+      border-radius: 4px;
+      cursor: pointer;
+      font-size: 12px;
+      font-weight: 600;
+      transition: background 0.3s;
+    }
+    .copy-btn:hover {
+      background: #5568d3;
+    }
+    .copy-btn:active {
+      background: #4a5bc4;
+    }
+    .copy-btn.copied {
+      background: #10b981;
+    }
+    .footer {
+      text-align: center;
+      padding: 20px;
+      color: #999;
+      font-size: 12px;
+      border-top: 1px solid #e0e0e0;
+    }
+    .actions {
+      display: flex;
+      gap: 10px;
+      justify-content: center;
+      margin-top: 20px;
+    }
+    .btn {
+      background: #667eea;
+      color: white;
+      border: none;
+      padding: 12px 24px;
+      border-radius: 6px;
+      cursor: pointer;
+      font-size: 14px;
+      font-weight: 600;
+      text-decoration: none;
+      display: inline-block;
+      transition: background 0.3s;
+    }
+    .btn:hover {
+      background: #5568d3;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="header">
+      <h1>Gemini Generated Image</h1>
+      <p>Created with Google Gemini AI (Nano Banana Pro)</p>
+    </div>
+
+    <div class="content">
+      <div class="image-container">
+        <img src="${imageFilename}" alt="Generated image">
+      </div>
+
+      <div class="metadata">
+        <h2>Generation Details</h2>
+
+        <div class="metadata-item">
+          <span class="metadata-label">Prompt</span>
+          <div class="prompt-box" id="promptBox">
+            <button class="copy-btn" onclick="copyPrompt()">Copy</button>
+            ${prompt.replace(/</g, '&lt;').replace(/>/g, '&gt;')}
+          </div>
+        </div>
+
+        ${description ? `
+        <div class="metadata-item">
+          <span class="metadata-label">AI Description</span>
+          <div class="metadata-value">${description.replace(/</g, '&lt;').replace(/>/g, '&gt;')}</div>
+        </div>
+        ` : ''}
+
+        <div class="metadata-item">
+          <span class="metadata-label">Generated</span>
+          <div class="metadata-value">${new Date().toLocaleString()}</div>
+        </div>
+
+        <div class="metadata-item">
+          <span class="metadata-label">File</span>
+          <div class="metadata-value">${imageFilename}</div>
+        </div>
+      </div>
+
+      <div class="actions">
+        <a href="${imageFilename}" download class="btn">Download Image</a>
+      </div>
+    </div>
+
+    <div class="footer">
+      Generated by Gemini MCP Server &middot; @houtini/gemini-mcp
+    </div>
+  </div>
+
+  <script>
+    function copyPrompt() {
+      const promptText = document.getElementById('promptBox').innerText.replace('Copy', '').trim();
+      navigator.clipboard.writeText(promptText).then(() => {
+        const btn = document.querySelector('.copy-btn');
+        const originalText = btn.textContent;
+        btn.textContent = 'Copied!';
+        btn.classList.add('copied');
+        setTimeout(() => {
+          btn.textContent = originalText;
+          btn.classList.remove('copied');
+        }, 2000);
+      });
+    }
+  </script>
+</body>
+</html>`;
+    await writeFile(htmlPath, html, 'utf-8');
+    return htmlPath;
+}
+export async function processGeneratedImage(base64Data, mimeType, savePath, prompt, description) {
+    const savedPath = await saveImageToFile(base64Data, savePath);
+    const previewPath = await createImagePreviewHtml(savedPath, prompt, description);
+    const compressed = await compressForViewer(base64Data, mimeType);
+    logger.info('Image saved successfully', {
+        savedPath,
+        previewPath,
+        originalKB: Math.round(compressed.originalBytes / 1024),
+        previewKB: Math.round(compressed.previewBytes / 1024),
+        compressionRatio: (compressed.originalBytes / compressed.previewBytes).toFixed(1) + 'x',
+    });
+    return {
+        savedPath,
+        previewPath,
+        previewImageData: compressed.base64,
+    };
+}
+//# sourceMappingURL=image-utils.js.map

package/dist/utils/image-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-utils.js","sourceRoot":"","sources":["../../src/utils/image-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAkB,EAAE,UAAkB;IAC1E,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjE,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,SAAiB,EACjB,MAAc,EACd,WAAoB;IAEpB,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,yBAAyB,EAAE,OAAO,CAAC,CAAC;IACvE,MAAM,aAAa,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC;IAEhE,MAAM,IAAI,GAAG;;;;;yBAKU,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA+JlB,aAAa;;;;;;;;;;cAUnB,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;;;;UAItD,WAAW,CAAC,CAAC,CAAC;;;wCAGgB,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;;SAEtF,CAAC,CAAC,CAAC,EAAE;;;;wCAI0B,IAAI,IAAI,EAAE,CAAC,cAAc,EAAE;;;;;wCAK3B,aAAa;;;;;mBAKlC,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;QAyBxB,CAAC;IAEP,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,UAAkB,EAClB,QAAgB,EAChB,QAAgB,EAChB,MAAc,EACd,WAAoB;IAEpB,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAG,MAAM,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACjF,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAEjE,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE;QACtC,SAAS;QACT,WAAW;QACX,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,aAAa,GAAG,IAAI,CAAC;QACvD,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC;QACrD,gBAAgB,EAAE,CAAC,UAAU,CAAC,aAAa,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG;KACxF,CAAC,CAAC;IAEH,OAAO;QACL,SAAS;QACT,WAAW;QACX,gBAAgB,EAAE,UAAU,CAAC,MAAM;KACpC,CAAC;AACJ,CAAC"}

package/dist/utils/resolve-images.d.ts

@@ -0,0 +1,29 @@
+export interface ImageInput {
+    data?: string;
+    filePath?: string;
+    mimeType?: string;
+    /** Thought signature from a previous Gemini image generation/edit call.
+     *  Must be round-tripped verbatim for conversational editing. */
+    thoughtSignature?: string;
+    mediaResolution?: string;
+}
+export interface ResolvedImage {
+    data: string;
+    mimeType: string;
+    /** Preserved thought signature for conversational editing. */
+    thoughtSignature?: string;
+    mediaResolution?: string;
+}
+/**
+ * Resolve an image input to base64 data, loading from disk if a filePath
+ * is provided. This runs server-side so the image data never transits MCP.
+ *
+ * Priority: if `data` is provided it is used directly; otherwise `filePath`
+ * is read from disk.
+ */
+export declare function resolveImageInput(image: ImageInput): Promise<ResolvedImage>;
+/**
+ * Resolve an array of image inputs, loading any filePath references from disk.
+ */
+export declare function resolveImageInputs(images: ImageInput[]): Promise<ResolvedImage[]>;
+//# sourceMappingURL=resolve-images.d.ts.map

package/dist/utils/resolve-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-images.d.ts","sourceRoot":"","sources":["../../src/utils/resolve-images.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;qEACiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAsCjF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAEvF"}

package/dist/utils/resolve-images.js

@@ -0,0 +1,56 @@
+import { readFile } from 'fs/promises';
+import { extname, resolve } from 'path';
+import logger from './logger.js';
+const MIME_TYPES = {
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.png': 'image/png',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.bmp': 'image/bmp',
+};
+/**
+ * Resolve an image input to base64 data, loading from disk if a filePath
+ * is provided. This runs server-side so the image data never transits MCP.
+ *
+ * Priority: if `data` is provided it is used directly; otherwise `filePath`
+ * is read from disk.
+ */
+export async function resolveImageInput(image) {
+    if (image.data && image.mimeType) {
+        return {
+            data: image.data,
+            mimeType: image.mimeType,
+            thoughtSignature: image.thoughtSignature,
+            mediaResolution: image.mediaResolution,
+        };
+    }
+    if (image.filePath) {
+        const abs = resolve(image.filePath);
+        const ext = extname(abs).toLowerCase();
+        const mimeType = MIME_TYPES[ext];
+        if (!mimeType) {
+            throw new Error(`Unsupported image format: ${ext}. Supported: ${Object.keys(MIME_TYPES).join(', ')}`);
+        }
+        const buffer = await readFile(abs);
+        logger.info('Resolved image from file path (server-side)', {
+            filePath: abs,
+            sizeKB: Math.round(buffer.length / 1024),
+        });
+        return {
+            data: buffer.toString('base64'),
+            mimeType,
+            thoughtSignature: image.thoughtSignature,
+            mediaResolution: image.mediaResolution,
+        };
+    }
+    throw new Error('Image must provide either data+mimeType (base64) or filePath. ' +
+        'Use filePath to bypass MCP transport limits for large images.');
+}
+/**
+ * Resolve an array of image inputs, loading any filePath references from disk.
+ */
+export async function resolveImageInputs(images) {
+    return Promise.all(images.map(resolveImageInput));
+}
+//# sourceMappingURL=resolve-images.js.map