@houtini/gemini-mcp 1.4.5 → 2.2.0

package/dist/tools/gemini-help.js

@@ -0,0 +1,534 @@
+import * as z from 'zod';
+const HELP_TOPICS = {
+    overview: `# Gemini MCP Server - Overview
+
+**Version:** 2.1.0
+**Tools Available:** 10
+
+## Core Features
+• **Chat & Research:** gemini_chat, gemini_deep_research
+• **Image Generation:** generate_image, edit_image
+• **Image Analysis:** describe_image, analyze_image
+• **Utilities:** gemini_list_models, load_image_from_path, generate_landing_page
+• **Help:** gemini_help (this tool)
+
+## Quick Start
+\`gemini_help topic="image_generation"\` - Image generation guide
+\`gemini_help topic="grounding"\` - Search grounding features
+\`gemini_help topic="media_resolution"\` - Token optimization
+\`gemini_help topic="all"\` - Complete documentation
+
+## Key Capabilities
+✓ Google Search grounding for real-time data
+✓ Multi-modal image generation with conversational editing
+✓ Advanced image analysis with token optimization
+✓ Deep research with iterative multi-step analysis
+✓ Full-resolution image output (saved to disk)
+✓ High-quality inline previews (1024px, quality 100)`,
+    image_generation: `# Image Generation Guide
+
+## Tool: generate_image
+
+### Basic Usage
+\`\`\`
+generate_image(
+  prompt="A photorealistic sunset over mountains",
+  aspectRatio="16:9"
+)
+\`\`\`
+
+### Parameters
+
+**prompt** (required)
+Description of the image to generate. Be specific and detailed.
+
+**model** (optional, default: "gemini-3-pro-image-preview")
+Options:
+• gemini-3-pro-image-preview - Best quality, conversational editing support
+• gemini-2.5-flash-image - Stable, fast generation
+• nano-banana-pro-preview - Alias for gemini-3-pro-image-preview
+
+**aspectRatio** (optional, default: "1:1")
+Options: "1:1", "3:4", "4:3", "9:16", "16:9"
+Use 16:9 for landscapes, 9:16 for portraits, 1:1 for squares
+
+**imageSize** (optional)
+Options: "1K", "2K", "4K"
+Only works with image-specific models. Higher = more detail but slower.
+Note: Preview is capped at 1024px, but full-res saved to disk
+
+**use_search** (optional, default: false)
+Enable Google Search grounding for real-time data.
+Use for: weather forecasts, current events, stock prices, sports scores
+Returns grounding sources as markdown links
+
+**global_media_resolution** (optional, default: "HIGH")
+For reference images only. See \`gemini_help topic="media_resolution"\`
+
+**outputPath** (optional)
+Custom save location. Otherwise saves to configured output directory.
+
+### Output Resolution
+• Generation: Full resolution (up to 4K depending on settings)
+• Disk: Full resolution saved (always)
+• Preview: 1024px max dimension, quality 100 (for inline display)
+
+### Advanced: Conversational Editing
+Generate an image, then edit it by passing the thoughtSignature:
+\`\`\`
+1. generate_image(prompt="A logo") → returns thoughtSignature
+2. edit_image(
+     prompt="Make it blue",
+     images=[{data, mimeType, thoughtSignature}]
+   )
+\`\`\``,
+    image_editing: `# Image Editing Guide
+
+## Tool: edit_image
+
+### Basic Usage
+\`\`\`
+edit_image(
+  prompt="Change the color scheme to blue and green",
+  images=[{data: base64Data, mimeType: "image/png"}]
+)
+\`\`\`
+
+### Parameters
+
+**prompt** (required)
+Natural language instructions for how to edit the image(s).
+Examples:
+• "Make the background darker"
+• "Add a red border"
+• "Change to black and white"
+• "Increase contrast and saturation"
+
+**images** (required, array)
+One or more images to edit. Each image object:
+• data: Base64 encoded image data
+• mimeType: Image MIME type (e.g., "image/png", "image/jpeg")
+• thoughtSignature: (optional) For conversational editing
+• mediaResolution: (optional) Per-image quality override
+
+**model** (optional, default: "gemini-3-pro-image-preview")
+Same options as generate_image
+
+**use_search** (optional, default: false)
+Enable Google Search for data-driven edits
+Example: "Add current weather data for London"
+
+**global_media_resolution** (optional, default: "HIGH")
+Token cost optimization. See \`gemini_help topic="media_resolution"\`
+
+**outputPath** (optional)
+Custom save location for edited image
+
+### Conversational Editing
+For multi-step refinements with gemini-3-pro-image-preview:
+1. First edit returns thoughtSignature
+2. Pass thoughtSignature in subsequent edits
+3. Model maintains visual context across iterations
+
+### Tips
+• Be specific: "Make brighter" vs "Increase brightness by 20%"
+• Reference elements: "The sky in the background" vs "The background"
+• Multiple images: Model can composite or compare them`,
+    image_analysis: `# Image Analysis Guide
+
+## Tools: describe_image, analyze_image
+
+### describe_image - Text Descriptions
+
+**Purpose:** Generate natural language descriptions of images
+
+\`\`\`
+describe_image(
+  images=[{data: base64Data, mimeType: "image/jpeg"}],
+  prompt="Describe this image in detail"
+)
+\`\`\`
+
+Returns plain text description.
+
+### analyze_image - Structured Analysis
+
+**Purpose:** Extract specific information from images as structured data
+
+\`\`\`
+analyze_image(
+  images=[{data: base64Data, mimeType: "image/png"}],
+  prompt="Extract all text from this document and count words"
+)
+\`\`\`
+
+Returns structured analysis based on prompt.
+
+### Media Resolution (Cost Optimization)
+
+**global_media_resolution** parameter:
+• MEDIA_RESOLUTION_LOW (280 tokens, 75% savings)
+  Use for: Simple tasks, bulk operations, thumbnails
+• MEDIA_RESOLUTION_MEDIUM (560 tokens, 50% savings)
+  Use for: PDFs, documents (OCR quality same as HIGH!)
+• MEDIA_RESOLUTION_HIGH (1120 tokens, default)
+  Use for: Detailed analysis, complex images
+
+**Per-image override:**
+\`\`\`
+images=[
+  {data: icon, mimeType: "image/png",
+   mediaResolution: "MEDIA_RESOLUTION_LOW"},
+  {data: detailed, mimeType: "image/png",
+   mediaResolution: "MEDIA_RESOLUTION_ULTRA_HIGH"}
+]
+\`\`\`
+
+ULTRA_HIGH (2000+ tokens) only available as per-image override.
+
+### PDF Analysis Best Practice
+For PDFs, use MEDIUM resolution:
+• Same OCR quality as HIGH
+• 50% token savings
+• Perfect for multi-page documents`,
+    chat: `# Chat & Conversation Guide
+
+## Tool: gemini_chat
+
+### Basic Usage
+\`\`\`
+gemini_chat(
+  message="Explain quantum entanglement",
+  model="gemini-3-pro-preview"
+)
+\`\`\`
+
+### Parameters
+
+**message** (required)
+Your message/question to Gemini
+
+**model** (optional)
+Options: See \`gemini_help topic="models"\`
+
+**grounding** (optional, default: false)
+Enable Google Search grounding for current information
+Returns grounding metadata with sources
+
+**max_tokens** (optional, default: 65536)
+Maximum tokens in response (1-65536)
+
+**temperature** (optional, default: 0.7)
+Randomness (0.0-1.0). Lower = more focused, Higher = more creative
+
+**thinking_level** (optional)
+For Gemini 3 models only:
+• "LOW" - Minimal reasoning, fast responses
+• "MEDIUM" - Balanced (Flash only)
+• "HIGH" - Deep reasoning, slower (default for Gemini 3)
+• "MINIMAL" - Absolute minimum thinking (Flash only)
+
+**system_prompt** (optional)
+System-level instructions for the model
+
+### Grounding Example
+\`\`\`
+gemini_chat(
+  message="What are the latest developments in the MCP specification?",
+  grounding=true
+)
+\`\`\`
+Returns current information with source citations.`,
+    deep_research: `# Deep Research Guide
+
+## Tool: gemini_deep_research
+
+### Purpose
+Conduct comprehensive multi-step research on complex topics using iterative analysis.
+
+### Usage
+\`\`\`
+gemini_deep_research(
+  research_question="What are the implications of quantum computing for cryptography?",
+  max_iterations=5,
+  focus_areas=["RSA encryption", "Post-quantum algorithms"]
+)
+\`\`\`
+
+### Parameters
+
+**research_question** (required)
+Complex research question or topic to investigate deeply
+
+**max_iterations** (optional, default: 5)
+Number of research iterations (3-10)
+More iterations = deeper research but longer wait time
+• 3-4: Quick overview (4-8 minutes)
+• 5-7: Comprehensive analysis (8-15 minutes)
+• 8-10: Exhaustive research (15-25 minutes)
+
+**focus_areas** (optional, array)
+Specific areas to focus the research on
+Example: ["clinical trials", "side effects", "dosage"]
+
+**model** (optional)
+Research model to use (defaults to latest available)
+
+### How It Works
+1. Initial search and information gathering
+2. Iterative deepening with follow-up queries
+3. Cross-referencing and validation
+4. Synthesis into comprehensive report
+
+### Returns
+Comprehensive research report with:
+• Executive summary
+• Key findings organized by theme
+• Source citations
+• Confidence assessments
+• Recommended follow-up questions
+
+### Best For
+• Complex topics requiring multiple sources
+• Academic or technical research
+• Comparative analysis across domains
+• Questions with no single definitive answer`,
+    grounding: `# Google Search Grounding Guide
+
+## What is Grounding?
+Grounding connects Gemini to Google Search for real-time, factual information.
+
+## Available in Tools
+• gemini_chat (grounding parameter)
+• generate_image (use_search parameter)
+• edit_image (use_search parameter)
+
+## Chat Grounding
+\`\`\`
+gemini_chat(
+  message="What happened in tech news today?",
+  grounding=true
+)
+\`\`\`
+
+**Returns:**
+• Current information (not training data)
+• Grounding metadata with sources
+• Web search queries used
+
+**Best for:**
+• Current events and news
+• Recent developments in any field
+• Fact-checking and verification
+• Topics that change frequently
+
+## Image Grounding
+\`\`\`
+generate_image(
+  prompt="Weather forecast for London tomorrow with actual temperatures",
+  use_search=true
+)
+\`\`\`
+
+**Returns:**
+• Image with real-time data
+• Grounding sources as markdown links
+• Search queries used
+
+**Best for:**
+• Weather forecasts
+• Stock prices and financial data
+• Sports scores and statistics
+• Current events infographics
+• Any data-driven visualizations
+
+## Important Notes
+• Grounding adds latency (search takes time)
+• Sources returned as clickable markdown links
+• Not needed for general knowledge or creative tasks
+• Most valuable for factual, current information`,
+    media_resolution: `# Media Resolution & Token Optimization
+
+## What is Media Resolution?
+Controls image quality when analyzing images, trading quality for token cost.
+
+## Resolution Levels
+
+**MEDIA_RESOLUTION_LOW (280 tokens)**
+• 75% token savings vs HIGH
+• Use for: Simple visual tasks, thumbnails, bulk processing
+• Quality: Sufficient for basic recognition and simple questions
+
+**MEDIA_RESOLUTION_MEDIUM (560 tokens)**
+• 50% token savings vs HIGH
+• Use for: PDFs, documents, screenshots
+• Quality: **Same OCR quality as HIGH!** (OCR saturates at medium)
+• **RECOMMENDED for all document analysis**
+
+**MEDIA_RESOLUTION_HIGH (1120 tokens)**
+• Default quality level
+• Use for: Complex images, detailed analysis
+• Quality: Full fidelity for most tasks
+
+**MEDIA_RESOLUTION_ULTRA_HIGH (2000+ tokens)**
+• Maximum detail, per-image only (not global)
+• Use for: Pixel-perfect analysis, fine details, medical imaging
+• Quality: Highest possible fidelity
+
+## Usage
+
+### Global Setting (All Images)
+\`\`\`
+analyze_image(
+  images=[{data1}, {data2}, {data3}],
+  prompt="Analyze these images",
+  global_media_resolution="MEDIA_RESOLUTION_MEDIUM"
+)
+\`\`\`
+
+### Per-Image Override (Mixed Quality)
+\`\`\`
+analyze_image(
+  images=[
+    {data: simple, mimeType: "image/png",
+     mediaResolution: "MEDIA_RESOLUTION_LOW"},
+    {data: detailed, mimeType: "image/png",
+     mediaResolution: "MEDIA_RESOLUTION_ULTRA_HIGH"}
+  ],
+  global_media_resolution="MEDIA_RESOLUTION_MEDIUM"
+)
+\`\`\`
+
+Per-image setting overrides global setting.
+
+## Best Practices
+
+**For PDFs/Documents:**
+Always use MEDIUM - same OCR quality, 50% cost savings
+
+**For Bulk Processing:**
+Use LOW for simple tasks (thumbnails, basic recognition)
+
+**For Mixed Batches:**
+Set global to MEDIUM, override specific images to ULTRA_HIGH
+
+**For Cost Optimization:**
+Start with MEDIUM, only increase if quality insufficient`,
+    models: `# Gemini Models Reference
+
+## Chat Models
+
+**Gemini 3 Series (Latest)**
+• gemini-3-pro-preview - Best reasoning, supports thinking levels
+• gemini-3-flash-preview - Fast, supports thinking levels
+• gemini-3.1-pro-preview - Enhanced reasoning
+• gemini-3.1-pro-preview-customtools - Optimized for tool use
+
+**Gemini 2.5 Series (Stable)**
+• gemini-2.5-pro - Stable flagship model
+• gemini-2.5-flash - Stable fast model
+• gemini-2.5-flash-lite - Lightweight, efficient
+
+**Gemini 2.0 Series**
+• gemini-2.0-flash - Versatile multimodal
+• gemini-2.0-flash-001 - Stable version
+• gemini-2.0-flash-lite - Lightweight variant
+
+**Aliases**
+• gemini-flash-latest - Latest Flash release
+• gemini-pro-latest - Latest Pro release
+
+## Image Generation Models
+
+**gemini-3-pro-image-preview** (Nano Banana Pro)
+• Best quality image generation
+• Supports conversational editing via thoughtSignatures
+• Default for generate_image and edit_image
+
+**gemini-2.5-flash-image**
+• Stable image generation
+• Fast, reliable
+• No conversational editing
+
+**nano-banana-pro-preview**
+• Alias for gemini-3-pro-image-preview
+
+## Image Analysis Models
+
+All chat models support image analysis via:
+• describe_image
+• analyze_image
+
+Recommended:
+• gemini-3-flash-preview (default) - Fast, accurate
+• gemini-3-pro-preview - Best quality analysis
+
+## Specialized Models
+
+**gemini-2.5-computer-use-preview-10-2025**
+• Computer interaction tasks
+
+**deep-research-pro-preview-12-2025**
+• Deep research iterations
+
+**Gemma Models**
+• gemma-3-1b-it through gemma-3-27b-it
+• Open weights models for research
+
+## Model Selection Tips
+
+**For Chat:**
+• Quick questions: gemini-3-flash-preview
+• Complex reasoning: gemini-3-pro-preview
+• Stable production: gemini-2.5-pro
+
+**For Images:**
+• Generation: gemini-3-pro-image-preview (only one with editing)
+• Analysis: gemini-3-flash-preview (fast, accurate)
+
+**For Research:**
+• deep-research-pro-preview-12-2025
+
+Use \`gemini_list_models\` to see all available models with descriptions.`,
+};
+export function registerGeminiHelp(server) {
+    server.registerTool('gemini_help', {
+        title: 'Gemini MCP Help',
+        description: 'Get comprehensive help about Gemini MCP features, settings, and best practices',
+        inputSchema: {
+            topic: z.enum([
+                'overview',
+                'image_generation',
+                'image_editing',
+                'image_analysis',
+                'chat',
+                'deep_research',
+                'grounding',
+                'media_resolution',
+                'models',
+                'all',
+            ])
+                .optional()
+                .default('overview')
+                .describe('Help topic to display'),
+        },
+    }, async ({ topic }) => {
+        if (topic === 'all') {
+            const allTopics = Object.keys(HELP_TOPICS)
+                .map((t) => HELP_TOPICS[t])
+                .join('\n\n---\n\n');
+            return { content: [{ type: 'text', text: allTopics }] };
+        }
+        const content = HELP_TOPICS[topic];
+        if (!content) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Unknown help topic: ${topic}\n\nAvailable topics:\n${Object.keys(HELP_TOPICS).join('\n')}`,
+                    }],
+            };
+        }
+        return { content: [{ type: 'text', text: content }] };
+    });
+}
+//# sourceMappingURL=gemini-help.js.map

package/dist/tools/gemini-help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-help.js","sourceRoot":"","sources":["../../src/tools/gemini-help.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,MAAM,WAAW,GAA2B;IAC1C,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;qDAwByC;IAEnD,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwDb;IAEL,aAAa,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uDAmDsC;IAErD,cAAc,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAwDiB;IAEjC,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mDA+C2C;IAEjD,aAAa,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6CAqD4B;IAE3C,SAAS,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDAqDoC;IAE/C,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yDAkEqC;IAEvD,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0EA2EgE;CACzE,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,gFAAgF;QAC7F,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC;gBACZ,UAAU;gBACV,kBAAkB;gBAClB,eAAe;gBACf,gBAAgB;gBAChB,MAAM;gBACN,eAAe;gBACf,WAAW;gBACX,kBAAkB;gBAClB,QAAQ;gBACR,KAAK;aACN,CAAC;iBACC,QAAQ,EAAE;iBACV,OAAO,CAAC,UAAU,CAAC;iBACnB,QAAQ,CAAC,uBAAuB,CAAC;SACrC;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;YACpB,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;iBACvC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;iBAC1B,IAAI,CAAC,aAAa,CAAC,CAAC;YACvB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QACnE,CAAC;QAED,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,uBAAuB,KAAK,0BAA0B,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBAClG,CAAC;aACH,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACjE,CAAC,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * Prompt Assistant Tool - Modular Handler
+ *
+ * Clean architecture for easy expansion:
+ * 1. Domain modules live in ./prompt-library/
+ * 2. Each domain exports enhance*, get*, validate* functions
+ * 3. Add new domains by importing and adding cases
+ */
+export interface PromptAssistantArgs {
+    request_type: 'chart_design' | 'optimize_chart' | 'validate_chart' | 'get_palette';
+    color_scheme?: 'professional' | 'editorial' | 'scientific' | 'minimal' | 'dark';
+    chart_type?: 'line' | 'bar' | 'scatter' | 'area' | 'pie' | 'network' | 'heatmap' | 'treemap';
+    emphasis?: 'data-ink' | 'storytelling' | 'exploration' | 'presentation';
+    current_prompt?: string;
+}
+/**
+ * Main handler - routes to appropriate domain module
+ */
+export declare function handlePromptAssistant(args: PromptAssistantArgs): Promise<string>;
+//# sourceMappingURL=gemini-prompt-assistant.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-prompt-assistant.d.ts","sourceRoot":"","sources":["../../src/tools/gemini-prompt-assistant.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,cAAc,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,aAAa,CAAC;IAEnF,YAAY,CAAC,EAAE,cAAc,GAAG,WAAW,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;IAChF,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC7F,QAAQ,CAAC,EAAE,UAAU,GAAG,cAAc,GAAG,aAAa,GAAG,cAAc,CAAC;IAExE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqItF"}

package/dist/tools/gemini-prompt-assistant.js

@@ -0,0 +1,129 @@
+/**
+ * Prompt Assistant Tool - Modular Handler
+ *
+ * Clean architecture for easy expansion:
+ * 1. Domain modules live in ./prompt-library/
+ * 2. Each domain exports enhance*, get*, validate* functions
+ * 3. Add new domains by importing and adding cases
+ */
+import { enhanceChartPrompt, getChartColorPalette, validateChartPrompt } from './prompt-library/index.js';
+/**
+ * Main handler - routes to appropriate domain module
+ */
+export async function handlePromptAssistant(args) {
+    const { request_type } = args;
+    // CHART DESIGN ENHANCEMENT
+    if (request_type === 'chart_design') {
+        const basePrompt = args.current_prompt || 'Professional data visualization';
+        const enhanced = enhanceChartPrompt(basePrompt, {
+            colorScheme: args.color_scheme,
+            chartType: args.chart_type,
+            emphasis: args.emphasis
+        });
+        return `# Enhanced Chart Design Prompt
+
+${enhanced}
+
+---
+
+**USAGE:**
+\`\`\`javascript
+Use gemini:generate_image with:
+  prompt: "${enhanced.slice(0, 200)}..."
+  aspectRatio: "16:9"
+\`\`\`
+
+**CUSTOMIZE:**
+• Try different \`color_scheme\`: professional, editorial, scientific, minimal, dark
+• Adjust \`chart_type\` for specifics: line, bar, scatter, pie, heatmap
+• Set \`emphasis\` for audience: data-ink, storytelling, exploration, presentation`;
+    }
+    // OPTIMIZE EXISTING CHART PROMPT
+    if (request_type === 'optimize_chart') {
+        if (!args.current_prompt) {
+            return 'Error: current_prompt required for optimization';
+        }
+        const validation = validateChartPrompt(args.current_prompt);
+        const enhanced = enhanceChartPrompt(args.current_prompt, {
+            colorScheme: args.color_scheme,
+            chartType: args.chart_type,
+            emphasis: args.emphasis
+        });
+        let response = `# Chart Prompt Optimization
+
+**Original Prompt:**
+${args.current_prompt}
+
+`;
+        if (validation.warnings.length > 0) {
+            response += `**⚠️ Warnings:**\n`;
+            validation.warnings.forEach(w => response += `• ${w}\n`);
+            response += `\n`;
+        }
+        if (validation.suggestions.length > 0) {
+            response += `**💡 Suggestions:**\n`;
+            validation.suggestions.forEach(s => response += `• ${s}\n`);
+            response += `\n`;
+        }
+        response += `**✨ Optimized Prompt:**\n${enhanced}`;
+        return response;
+    }
+    // VALIDATE CHART PROMPT
+    if (request_type === 'validate_chart') {
+        if (!args.current_prompt) {
+            return 'Error: current_prompt required for validation';
+        }
+        const validation = validateChartPrompt(args.current_prompt);
+        let response = `# Chart Prompt Validation
+
+**Prompt:** ${args.current_prompt}
+
+**Status:** ${validation.valid ? '✅ Looks good' : '⚠️ Issues found'}
+
+`;
+        if (validation.warnings.length > 0) {
+            response += `\n**Warnings:**\n`;
+            validation.warnings.forEach(w => response += `• ${w}\n`);
+        }
+        if (validation.suggestions.length > 0) {
+            response += `\n**Suggestions:**\n`;
+            validation.suggestions.forEach(s => response += `• ${s}\n`);
+        }
+        return response;
+    }
+    // GET COLOR PALETTE
+    if (request_type === 'get_palette') {
+        const scheme = args.color_scheme || 'professional';
+        const palette = getChartColorPalette(scheme);
+        return `# ${scheme.charAt(0).toUpperCase() + scheme.slice(1)} Color Palette
+
+**Description:** ${palette.description}
+
+**Primary Colors:**
+${palette.primary.map(c => `• ${c}`).join('\n')}
+
+**Neutral Grays:**
+${palette.neutral.map(c => `• ${c}`).join('\n')}
+
+**Accent Colors:**
+${palette.accent.map(c => `• ${c}`).join('\n')}
+
+**Usage in Prompt:**
+"Use professional colour palette: primary ${palette.primary.slice(0, 3).join(', ')}; neutral greys ${palette.neutral[0]} to ${palette.neutral[palette.neutral.length - 1]}"
+
+**All Available Schemes:**
+• professional - IBM Carbon, Tailwind-inspired
+• editorial - FiveThirtyEight, Economist-inspired
+• scientific - Nature, Science journal-inspired
+• minimal - Edward Tufte data-ink approach
+• dark - Observable, GitHub dark mode`;
+    }
+    return `Unknown request_type: ${request_type}
+
+Available request types:
+• chart_design - Get professional chart design system
+• optimize_chart - Improve existing chart prompt
+• validate_chart - Check prompt for anti-patterns
+• get_palette - View color scheme details`;
+}
+//# sourceMappingURL=gemini-prompt-assistant.js.map

package/dist/tools/gemini-prompt-assistant.js.map

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