mcp-hydrocoder-image 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Shinsuke Kagawa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,454 @@
+# MCP HydroCoder Image 🍌
+
+> AI image generation and editing MCP server for Cursor, Claude Code, Codex, and any MCP-compatible tool — powered by Nano Banana 2 and Nano Banana Pro (Google Gemini).
+
+[![npm version](https://badge.fury.io/js/mcp-hydrocoder-image.svg)](https://www.npmjs.com/package/mcp-hydrocoder-image)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+An MCP server that turns simple text prompts into high-quality images. Unlike a simple API wrapper, this server automatically enhances your prompt and configures sensible defaults for generation — you don't need to learn prompt engineering or tune settings. Just describe what you want.
+
+## How It Works
+
+```
+You: "cat on a roof"
+        ↓
+  Your AI assistant infers context
+  (purpose, style, mood, resolution...)
+        ↓
+  MCP optimizes your prompt
+  (adds lighting, composition, atmosphere, artistic details)
+        ↓
+  Image generation with smart defaults
+  (grounding, consistency, resolution — all configured automatically)
+        ↓
+  High-quality image, zero effort
+```
+
+Your AI assistant interprets your intent — the style, purpose, and context behind your request. The MCP focuses on output quality by refining the prompt to meet a structured visual clarity standard and selecting appropriate generation settings. You just describe what you want.
+
+The prompt optimizer uses a **Subject–Context–Style** framework (powered by Gemini 2.5 Flash) to fill in missing visual details — subject characteristics, environment, lighting, camera work — while preserving your original intent. It doesn't blindly add details: prompts that already meet the quality standard are left largely intact.
+
+**Example — what the optimizer does to a short prompt:**
+
+> **Input:** "cat on a roof"
+>
+> **After optimization:** "A sleek, midnight black cat, perched with poised elegance on the apex of a weathered, terracotta tile roof. Its emerald eyes, narrowed slightly, reflect the warm glow of a setting sun. Each individual tile is distinct, showing subtle variations in color and texture, with patches of moss clinging to the crevices. The cat's fur is sharply defined, catching the golden hour light, highlighting its sleek contours. In the background, the silhouettes of distant, old-world city buildings with ornate spires are softly blurred, bathed in a gradient of fiery orange, soft pink, and deep violet twilight. A gentle, ethereal mist begins to rise from the alleyways below, adding a touch of mystery. The composition is a medium shot, taken from a slightly low angle, emphasizing the cat's commanding presence against the vast sky. Photorealistic style, captured with a prime lens, wide aperture to create a beautiful bokeh, enhancing the depth of field."
+
+## Features
+
+- **Built-in Prompt Optimization**: Your simple prompt is automatically enriched with photographic and artistic details — lighting, composition, atmosphere — using Gemini 2.5 Flash. No prompt engineering skills required.
+- **Three Quality Tiers**: Choose between fast iteration, balanced quality, or maximum fidelity with Nano Banana 2 (Gemini 3.1 Flash Image) and Nano Banana Pro (Gemini 3 Pro Image). [See Quality Presets](#quality-presets).
+- **Image Editing**: Transform existing images with natural language instructions (image-to-image) while preserving original style and visual consistency.
+- **High-Resolution Output**: Up to 4K image generation for professional-grade output with superior text rendering and fine details.
+- **Flexible Aspect Ratios**: From square (1:1) to ultra-wide (21:9) and ultra-tall (1:8) formats.
+- **Character Consistency**: Maintain consistent character appearance across multiple generations — ideal for storyboards, product shots, and visual series.
+- **Advanced Capabilities**:
+  - Google Search grounding for real-time factual accuracy
+  - World knowledge for photorealistic depictions of historical figures, landmarks, and factual scenarios
+  - Multi-image blending for composite scenes
+  - Purpose-aware generation (e.g., "cookbook cover" produces different results than "social media post")
+- **Multiple Output Formats**: PNG, JPEG, WebP support.
+
+## Agent Skill: Image Generation Prompt Guide
+
+This project also provides a standalone **[Agent Skill](https://agentskills.io)** (`SKILL.md`) that teaches AI assistants to write better image generation prompts — no MCP server or API key required.
+
+> **Note:** This skill does not generate images itself. It teaches your AI assistant to write better prompts for tools that already have built-in image generation (e.g., Cursor's native image generation).
+
+Based on the **Subject-Context-Style** framework, covering prompt structure, visual details (lighting, textures, camera angles), advanced techniques (character consistency, composition), and image editing. Works with any image model (Gemini, GPT Image, Flux, Stable Diffusion, Midjourney, etc.).
+
+### Install
+
+```bash
+npx mcp-hydrocoder-image skills install --path <target-directory>
+```
+
+The skill will be placed at `<path>/image-generation/SKILL.md`. Specify the skills directory for your AI tool:
+
+```bash
+# Cursor
+npx mcp-hydrocoder-image skills install --path ~/.cursor/skills
+
+# Codex
+npx mcp-hydrocoder-image skills install --path ~/.codex/skills
+
+# Claude Code
+npx mcp-hydrocoder-image skills install --path ~/.claude/skills
+```
+
+### When to Use the Skill vs the MCP Server
+
+| | MCP Server | Agent Skill |
+|---|---|---|
+| **Use when** | Your AI tool does not have built-in image generation | Your AI tool already generates images natively |
+| **Requires** | Gemini API key | Nothing |
+| **What it does** | Generates images via Gemini API with automatic prompt optimization | Teaches the AI to write better prompts |
+| **Works with** | MCP-compatible tools (Cursor, Claude Code, Codex, etc.) | Any tool supporting the [Agent Skills](https://agentskills.io) open standard |
+
+---
+
+## Prerequisites
+
+- **Node.js** 20 or higher
+- **Gemini API Key** - Get yours at [Google AI Studio](https://aistudio.google.com/apikey)
+- An MCP-compatible AI tool: **Cursor**, **Claude Code**, **Codex**, or others
+- Basic terminal/command line knowledge
+
+## Quick Start
+
+### 1. Get Your Gemini API Key
+
+Get your API key from [Google AI Studio](https://aistudio.google.com/apikey)
+
+### 2. MCP Configuration
+
+#### For Codex
+
+Add to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.mcp-hydrocoder-image]
+command = "npx"
+args = ["-y", "mcp-hydrocoder-image"]
+
+[mcp_servers.mcp-hydrocoder-image.env]
+GEMINI_API_KEY = "your_gemini_api_key_here"
+IMAGE_OUTPUT_DIR = "/absolute/path/to/images"
+```
+
+#### For Cursor
+
+Add to your Cursor settings:
+- **Global** (all projects): `~/.cursor/mcp.json`
+- **Project-specific**: `.cursor/mcp.json` in your project root
+
+**macOS / Linux:**
+```json
+{
+  "mcpServers": {
+    "mcp-hydrocoder-image": {
+      "command": "npx",
+      "args": ["-y", "mcp-hydrocoder-image"],
+      "env": {
+        "GEMINI_API_KEY": "your_gemini_api_key_here",
+        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
+      }
+    }
+  }
+}
+```
+
+**Windows:**
+```json
+{
+  "mcpServers": {
+    "mcp-hydrocoder-image": {
+      "command": "npx",
+      "args": ["-y", "mcp-hydrocoder-image"],
+      "env": {
+        "GEMINI_API_KEY": "your_gemini_api_key_here",
+        "IMAGE_OUTPUT_DIR": "C:\\absolute\\path\\to\\images"
+      }
+    }
+  }
+}
+```
+
+#### For Claude Code
+
+Run in your project directory to enable for that project:
+
+```bash
+cd /path/to/your/project
+claude mcp add mcp-hydrocoder-image --env GEMINI_API_KEY=your-api-key --env IMAGE_OUTPUT_DIR=/absolute/path/to/images -- npx -y mcp-hydrocoder-image
+```
+
+Or add globally for all projects:
+
+```bash
+claude mcp add mcp-hydrocoder-image --scope user --env GEMINI_API_KEY=your-api-key --env IMAGE_OUTPUT_DIR=/absolute/path/to/images -- npx -y mcp-hydrocoder-image
+```
+
+Or add via JSON config (`~/.claude/settings.json` for global, `.mcp.json` for project):
+
+**macOS / Linux:**
+```json
+{
+  "mcpServers": {
+    "mcp-hydrocoder-image": {
+      "command": "npx",
+      "args": ["-y", "mcp-hydrocoder-image"],
+      "env": {
+        "GEMINI_API_KEY": "your_gemini_api_key_here",
+        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
+      }
+    }
+  }
+}
+```
+
+**Windows:**
+```json
+{
+  "mcpServers": {
+    "mcp-hydrocoder-image": {
+      "command": "npx",
+      "args": ["-y", "mcp-hydrocoder-image"],
+      "env": {
+        "GEMINI_API_KEY": "your_gemini_api_key_here",
+        "IMAGE_OUTPUT_DIR": "C:\\absolute\\path\\to\\images"
+      }
+    }
+  }
+}
+```
+
+⚠️ **Security Note**: Never commit your API key to version control. Keep it secure and use environment-specific configuration.
+
+📁 **Path Requirements**:
+- `IMAGE_OUTPUT_DIR` must be an absolute path (e.g., `/Users/username/images`, not `./images`)
+- Defaults to `./output` in the current working directory if not specified
+- Directory will be created automatically if it doesn't exist
+
+## Quality Presets
+
+Choose the right balance of speed, quality, and cost:
+
+| Preset | Model | Best for | Speed |
+|--------|-------|----------|-------|
+| `fast` (default) | Nano Banana 2 (Gemini 3.1 Flash Image) | Quick iterations, drafts, high-volume generation | ~30–40s |
+| `balanced` | Nano Banana 2 + Thinking | Production images, good quality with reasonable speed | Medium |
+| `quality` | Nano Banana Pro (Gemini 3 Pro Image) | Final deliverables, maximum fidelity, critical visuals | Slow |
+
+Set the default via `IMAGE_QUALITY` environment variable:
+
+```
+IMAGE_QUALITY=fast       # (default) Fastest generation
+IMAGE_QUALITY=balanced   # Enhanced thinking for better quality
+IMAGE_QUALITY=quality    # Maximum quality output
+```
+
+To override per-request, just tell your AI assistant (e.g., "generate in high quality" or "use balanced quality"). The assistant will pass the appropriate `quality` parameter automatically.
+
+**Codex:**
+```toml
+[mcp_servers.mcp-hydrocoder-image.env]
+GEMINI_API_KEY = "your_gemini_api_key_here"
+IMAGE_QUALITY = "balanced"
+```
+
+**Cursor:**
+Add `"IMAGE_QUALITY": "balanced"` to the env section in your config.
+
+**Claude Code:**
+```bash
+claude mcp add mcp-hydrocoder-image --env GEMINI_API_KEY=your-api-key --env IMAGE_QUALITY=balanced --env IMAGE_OUTPUT_DIR=/absolute/path/to/images -- npx -y mcp-hydrocoder-image
+```
+
+### Skip Prompt Enhancement
+
+Control prompt enhancement via the `skipPromptEnhancement` tool parameter or the `SKIP_PROMPT_ENHANCEMENT` environment variable. **Parameter takes priority over environment variable.**
+
+| Parameter | Env Variable | Result |
+|-----------|-------------|--------|
+| Not set | Not set | Enhancement enabled (default) |
+| Not set | `true` | Enhancement skipped |
+| `true` | Any | Enhancement skipped |
+| `false` | `true` | Enhancement enabled (parameter overrides) |
+
+Skipping enhancement is recommended for multi-image blending, where the prompt enhancer may rewrite your blending intent into unrelated content.
+
+## Usage Examples
+
+Once configured, just describe what you want in natural language:
+
+### Basic Image Generation
+
+```
+"Generate a serene mountain landscape at sunset with a lake reflection"
+```
+
+Your prompt is automatically enhanced with rich details about lighting, materials, composition, and atmosphere.
+
+### Image Editing
+
+```
+"Edit this image to make the person face right"
+(with inputImagePath: "/path/to/image.jpg")
+```
+
+### Advanced Features
+
+**Character Consistency:**
+```
+"Generate a portrait of a medieval knight, maintaining character consistency for future variations"
+(with maintainCharacterConsistency: true)
+```
+
+**High-Resolution 4K with Text Rendering:**
+```
+"Generate a professional product photo of a smartphone with clear text on the screen"
+(with imageSize: "4K")
+```
+
+**Custom Aspect Ratio:**
+```
+"Generate a cinematic landscape of a desert at golden hour"
+(with aspectRatio: "21:9")
+```
+
+## API Reference
+
+### `generate_image` Tool
+
+The server uses a two-stage process with separate models for each stage:
+1. **Prompt Optimization** (Gemini 2.5 Flash): Refines your prompt using the Subject–Context–Style framework. Skippable via `SKIP_PROMPT_ENHANCEMENT`.
+2. **Image Generation** (Nano Banana 2 or Pro): Creates the final image. Model varies by quality preset.
+
+#### Parameters
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `prompt` | string | Yes | Text description or editing instruction |
+| `quality` | string | - | Quality preset: `fast` (default), `balanced`, `quality`. Overrides `IMAGE_QUALITY` env var for this request |
+| `inputImagePath` | string | - | Absolute path to input image for image-to-image editing |
+| `inputImage` | string | - | Base64 encoded image data for image-to-image editing. Alternative to `inputImagePath` |
+| `inputImageMimeType` | string | - | MIME type of the input image (`image/jpeg`, `image/png`, `image/webp`, `image/gif`, `image/bmp`). Used with `inputImage` |
+| `inputImages` | array | - | Multiple input images for multi-image composition. Each item: `{ data: string, mimeType: string }`. Cannot be used with `inputImage`/`inputImagePath` |
+| `returnBase64` | boolean | - | Return the generated image as base64 data in the response. Image is always saved to disk regardless |
+| `fileName` | string | - | Custom filename for output (auto-generated if not specified) |
+| `aspectRatio` | string | - | `1:1` (default), `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`, `1:4`, `1:8`, `4:1`, `8:1` |
+| `imageSize` | string | - | `1K`, `2K`, `4K`. Leave unspecified for standard quality |
+| `blendImages` | boolean | - | Enable multi-image blending for combining multiple visual elements naturally |
+| `maintainCharacterConsistency` | boolean | - | Maintain character appearance consistency across different poses and scenes |
+| `useWorldKnowledge` | boolean | - | Use real-world knowledge for accurate context (historical figures, landmarks, factual scenarios) |
+| `useGoogleSearch` | boolean | - | Enable Google Search grounding for real-time factual accuracy |
+| `purpose` | string | - | Intended use (e.g., "cookbook cover", "social media post"). Helps tailor visual style and details |
+
+#### Response
+
+```json
+{
+  "type": "resource",
+  "resource": {
+    "uri": "file:///path/to/generated/image.png",
+    "name": "image-filename.png",
+    "mimeType": "image/png"
+  },
+  "metadata": {
+    "model": "gemini-3.1-flash-image-preview",
+    "processingTime": 5000,
+    "timestamp": "2026-01-01T12:00:00.000Z"
+  }
+}
+```
+
+## Troubleshooting
+
+### Common Issues
+
+**"API key not found"**
+- Ensure `GEMINI_API_KEY` is set in your environment
+- Verify the API key is valid and has image generation permissions
+
+**"Input image file not found"**
+- Use absolute file paths, not relative paths
+- Ensure the file exists and is accessible
+- Supported formats: PNG, JPEG, WebP (max 10MB)
+
+**"No image data found in Gemini API response"**
+- Try rephrasing your prompt with more specific details
+- Ensure your prompt is appropriate for image generation
+- Check if your API key has sufficient quota
+
+### Performance Tips
+
+- `fast` preset: ~30–40 seconds typical (includes prompt optimization)
+- `balanced` preset: Slightly longer due to enhanced thinking
+- `quality` preset: Slower but highest fidelity output
+- High-resolution (2K/4K): Additional processing time for superior detail
+- Simple prompts work great — the optimizer automatically adds professional details
+- Complex prompts are preserved and further enhanced
+- Consider `useWorldKnowledge` for historical or factual subjects
+- Use `imageSize: "4K"` when text clarity and fine details are critical
+
+## Usage Notes
+
+- This MCP server uses the paid Gemini API:
+  - **Prompt optimization**: Gemini 2.5 Flash (minimal token usage)
+  - **Image generation**: Model depends on quality preset
+    - `fast` / `balanced`: Nano Banana 2 — Gemini 3.1 Flash Image (lower cost)
+    - `quality`: Nano Banana Pro — Gemini 3 Pro Image (higher cost)
+  - `balanced` uses additional thinking tokens (slightly higher cost than `fast`)
+- Check current pricing and rate limits at [Google AI Studio](https://aistudio.google.com/)
+- Monitor your API usage to avoid unexpected charges
+- The prompt optimization step adds minimal cost while significantly improving output quality
+
+## Local Development
+
+If you want to test a local build (e.g., after cloning the repo or making changes), follow these steps instead of using `npx`.
+
+### 1. Build the Project
+
+```bash
+cd /path/to/mcp-hydrocoder-image
+npm install
+npm run build
+```
+
+### 2. Configure the MCP Server
+
+Add the following to your MCP configuration file, pointing directly to the local `dist/index.js`:
+
+- **Claude Code**: `~/.claude.json`
+- **Cursor**: `~/.cursor/mcp.json` or `.cursor/mcp.json`
+- **Codex**: `~/.codex/config.toml`
+
+**Claude Code / Cursor (JSON):**
+
+```json
+{
+  "mcp-hydrocoder-image": {
+    "command": "node",
+    "args": ["/absolute/path/to/mcp-hydrocoder-image/dist/index.js"],
+    "env": {
+      "GEMINI_API_KEY": "your_gemini_api_key_here",
+      "IMAGE_OUTPUT_DIR": "/absolute/path/to/output"
+    }
+  }
+}
+```
+
+> **Proxy users**: If you need a proxy, add `HTTPS_PROXY` and `HTTP_PROXY` to the `env` section.
+
+### 3. Allow Tool Permissions (Claude Code)
+
+To skip the permission prompt on every call, add the tool to your allow list in `~/.claude/settings.json`:
+
+```json
+{
+  "permissions": {
+    "allow": [
+      "mcp__mcp-hydrocoder-image__generate_image"
+    ]
+  }
+}
+```
+
+### 4. Restart and Test
+
+Restart your AI tool to load the new MCP server, then try:
+
+```
+"Generate a serene mountain landscape at sunset"
+```
+
+If the image is saved to your `IMAGE_OUTPUT_DIR`, the local setup is working correctly.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+**Need help?** [Open an issue](https://github.com/ynzys/mcp-hydrocoder-image/issues) or check the [troubleshooting section](#troubleshooting) above.

package/bin/install-skills.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+
+import { cpSync, existsSync, mkdirSync } from 'node:fs'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+const SKILLS_SOURCE = resolve(__dirname, '..', 'skills', 'image-generation')
+const SKILL_DIR_NAME = 'image-generation'
+
+function printHelp() {
+  console.log(`
+Image Generation Skills Installer
+
+Usage:
+  npx mcp-image skills install --path <path>
+
+Options:
+  --path <path>    Install skills to the specified directory.
+                   The skill will be placed at <path>/${SKILL_DIR_NAME}/
+
+  --help, -h       Show this help message
+
+Examples:
+  npx mcp-image skills install --path ~/.claude/skills
+  npx mcp-image skills install --path ./.claude/skills
+  npx mcp-image skills install --path /custom/path
+`)
+}
+
+function parseArgs(args) {
+  const options = { path: undefined, help: false }
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i]
+
+    switch (arg) {
+      case '--help':
+      case '-h':
+        options.help = true
+        break
+
+      case '--path': {
+        const pathArg = args[i + 1]
+        if (!pathArg) {
+          console.error('Error: --path requires a path argument')
+          process.exit(1)
+        }
+        options.path = pathArg
+        i++
+        break
+      }
+
+      default:
+        if (arg && arg.startsWith('-')) {
+          console.error(`Unknown option: ${arg}`)
+          process.exit(1)
+        }
+    }
+  }
+
+  return options
+}
+
+function install(targetPath) {
+  if (!existsSync(SKILLS_SOURCE)) {
+    console.error(`Error: Skills source not found at ${SKILLS_SOURCE}`)
+    process.exit(1)
+  }
+
+  const targetDir = dirname(targetPath)
+  if (!existsSync(targetDir)) {
+    mkdirSync(targetDir, { recursive: true })
+    console.log(`Created directory: ${targetDir}`)
+  }
+
+  cpSync(SKILLS_SOURCE, targetPath, { recursive: true })
+  console.log(`Installed skills to: ${targetPath}`)
+}
+
+export function run(args) {
+  if (args.length === 0) {
+    printHelp()
+    process.exit(0)
+  }
+
+  const options = parseArgs(args)
+
+  if (options.help) {
+    printHelp()
+    process.exit(0)
+  }
+
+  if (!options.path) {
+    console.error('Error: --path is required')
+    console.error('Run "npx mcp-image skills install --help" for usage information.')
+    process.exit(1)
+  }
+
+  const targetPath = resolve(options.path, SKILL_DIR_NAME)
+
+  console.log('Installing image-generation skills...')
+  console.log(`Path: ${targetPath}`)
+  console.log()
+
+  install(targetPath)
+
+  console.log()
+  console.log('Installation complete!')
+  console.log()
+  console.log('Installed files:')
+  console.log('  - image-generation/SKILL.md')
+}

package/dist/api/geminiClient.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Gemini API client for image generation
+ * Integrates with Google's Gemini AI API using the official SDK
+ * Supports automatic URL Context processing and feature parameters
+ */
+import type { ImageQuality } from '../types/mcp.js';
+import type { Result } from '../types/result.js';
+import type { Config } from '../utils/config.js';
+import { GeminiAPIError, NetworkError } from '../utils/errors.js';
+/**
+ * Metadata for generated images
+ */
+export interface GeminiGenerationMetadata {
+    model: string;
+    prompt: string;
+    mimeType: string;
+    timestamp: Date;
+    inputImageProvided: boolean;
+    modelVersion?: string;
+    responseId?: string;
+}
+/**
+ * Parameters for Gemini API image generation
+ */
+export interface GeminiApiParams {
+    prompt: string;
+    inputImage?: string;
+    inputImageMimeType?: string;
+    inputImages?: Array<{
+        data: string;
+        mimeType: string;
+    }>;
+    aspectRatio?: string;
+    imageSize?: string;
+    useGoogleSearch?: boolean;
+    quality?: ImageQuality;
+}
+/**
+ * Result of image generation
+ */
+export interface GeneratedImageResult {
+    imageData: Buffer;
+    metadata: GeminiGenerationMetadata;
+}
+/**
+ * Gemini API client interface
+ */
+export interface GeminiClient {
+    generateImage(params: GeminiApiParams): Promise<Result<GeneratedImageResult, GeminiAPIError | NetworkError>>;
+}
+/**
+ * Creates a new Gemini API client
+ * @param config Configuration containing API key and other settings
+ * @returns Result containing the client or an error
+ */
+export declare function createGeminiClient(config: Config): Result<GeminiClient, GeminiAPIError>;
+//# sourceMappingURL=geminiClient.d.ts.map

package/dist/api/geminiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geminiClient.d.ts","sourceRoot":"","sources":["../../src/api/geminiClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAsHjE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,IAAI,CAAA;IACf,kBAAkB,EAAE,OAAO,CAAA;IAE3B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACvD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,OAAO,CAAC,EAAE,YAAY,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,wBAAwB,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa,CACX,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,cAAc,GAAG,YAAY,CAAC,CAAC,CAAA;CACxE;AA6VD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC,CAevF"}