@takeshijuan/ideogram-mcp-server 1.0.0 → 2.0.0

package/dist/config/config.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Configuration Loading and Validation
+ *
+ * This module handles loading configuration from environment variables
+ * and validating them using Zod schemas. It provides a strongly-typed
+ * configuration object for use throughout the application.
+ */
+import { z } from 'zod';
+/**
+ * Supported log levels
+ */
+export declare const LOG_LEVELS: readonly ["debug", "info", "warn", "error"];
+/**
+ * Log level type
+ */
+export type LogLevel = (typeof LOG_LEVELS)[number];
+/**
+ * Zod schema for environment variable validation.
+ * Transforms and validates all configuration values.
+ */
+declare const ConfigSchema: z.ZodObject<{
+    /**
+     * Ideogram API key (required)
+     */
+    ideogramApiKey: z.ZodString;
+    /**
+     * Logging level
+     */
+    logLevel: z.ZodDefault<z.ZodEnum<["debug", "info", "warn", "error"]>>;
+    /**
+     * Directory for local image storage
+     */
+    localSaveDir: z.ZodDefault<z.ZodString>;
+    /**
+     * Enable automatic local saving of images
+     */
+    enableLocalSave: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Maximum concurrent API requests
+     */
+    maxConcurrentRequests: z.ZodDefault<z.ZodNumber>;
+    /**
+     * API request timeout in milliseconds
+     */
+    requestTimeoutMs: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    ideogramApiKey: string;
+    logLevel: "debug" | "info" | "warn" | "error";
+    localSaveDir: string;
+    enableLocalSave: boolean;
+    maxConcurrentRequests: number;
+    requestTimeoutMs: number;
+}, {
+    ideogramApiKey: string;
+    logLevel?: "debug" | "info" | "warn" | "error" | undefined;
+    localSaveDir?: string | undefined;
+    enableLocalSave?: boolean | undefined;
+    maxConcurrentRequests?: number | undefined;
+    requestTimeoutMs?: number | undefined;
+}>;
+/**
+ * Validated configuration type
+ */
+export type Config = z.infer<typeof ConfigSchema>;
+/**
+ * Validated application configuration.
+ *
+ * This is loaded and validated once at module load time.
+ * Any configuration errors will be thrown immediately.
+ *
+ * @example
+ * ```typescript
+ * import { config } from './config/config.js';
+ *
+ * // Access configuration values
+ * const apiKey = config.ideogramApiKey;
+ * const logLevel = config.logLevel;
+ * ```
+ */
+export declare const config: Config;
+/**
+ * Check if the configuration is valid without throwing.
+ * Useful for testing or conditional initialization.
+ *
+ * @returns True if configuration is valid, false otherwise
+ */
+export declare function isConfigValid(): boolean;
+/**
+ * Get configuration validation errors without throwing.
+ * Returns an empty array if configuration is valid.
+ *
+ * @returns Array of validation error messages
+ */
+export declare function getConfigErrors(): string[];
+/**
+ * Create a configuration object for testing or dependency injection.
+ * Validates the provided values against the schema.
+ *
+ * @param overrides - Configuration values to use instead of environment variables
+ * @returns Validated configuration object
+ * @throws Error if validation fails
+ */
+export declare function createConfig(overrides: Partial<Config> & {
+    ideogramApiKey: string;
+}): Config;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB;;GAEG;AACH,eAAO,MAAM,UAAU,6CAA8C,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAMnD;;;GAGG;AACH,QAAA,MAAM,YAAY;IAChB;;OAEG;;IAWH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAUH;;OAEG;;;;;;;;;;;;;;;;EAOH,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAoGlD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,MAAM,EAAE,MAAqB,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAW1C;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAe5F"}

package/dist/config/constants.d.ts

@@ -0,0 +1,211 @@
+/**
+ * API Constants and Configuration
+ *
+ * This file contains all constant values for the Ideogram MCP Server including:
+ * - API endpoint URLs
+ * - Enum value arrays for validation
+ * - Default values for optional parameters
+ * - Validation constraints
+ * - Cost estimation data
+ */
+import type { AspectRatio, RenderingSpeed, MagicPrompt, StyleType, Model, PredictionStatus } from '../types/api.types.js';
+/**
+ * Ideogram API base URL
+ */
+export declare const API_BASE_URL: "https://api.ideogram.ai";
+/**
+ * API endpoints for different operations
+ */
+export declare const API_ENDPOINTS: {
+    /** V3 Generate endpoint */
+    readonly GENERATE_V3: "/v1/ideogram-v3/generate";
+    /** Legacy Edit endpoint (inpainting only) */
+    readonly EDIT_LEGACY: "/edit";
+    /** Legacy V2 Generate endpoint */
+    readonly GENERATE_LEGACY: "/generate";
+};
+/**
+ * API header name for authentication
+ */
+export declare const API_KEY_HEADER: "Api-Key";
+/**
+ * All 15 supported aspect ratios.
+ * Note: Uses "x" separator, not ":" (e.g., "16x9" not "16:9")
+ */
+export declare const ASPECT_RATIOS: readonly AspectRatio[];
+/**
+ * Rendering speed options for Ideogram V3.
+ * Ordered from fastest (lowest quality) to slowest (highest quality).
+ */
+export declare const RENDERING_SPEEDS: readonly RenderingSpeed[];
+/**
+ * Magic prompt enhancement options.
+ */
+export declare const MAGIC_PROMPT_OPTIONS: readonly MagicPrompt[];
+/**
+ * Style type options for image generation.
+ */
+export declare const STYLE_TYPES: readonly StyleType[];
+/**
+ * Ideogram model versions (for legacy V2 endpoints).
+ */
+export declare const MODELS: readonly Model[];
+/**
+ * Prediction status values for async operations (local implementation).
+ */
+export declare const PREDICTION_STATUSES: readonly PredictionStatus[];
+/**
+ * Default values for optional generation parameters
+ */
+export declare const DEFAULTS: {
+    /** Default aspect ratio */
+    readonly ASPECT_RATIO: AspectRatio;
+    /** Default number of images to generate */
+    readonly NUM_IMAGES: 1;
+    /** Default rendering speed */
+    readonly RENDERING_SPEED: RenderingSpeed;
+    /** Default magic prompt setting */
+    readonly MAGIC_PROMPT: MagicPrompt;
+    /** Default style type */
+    readonly STYLE_TYPE: StyleType;
+    /** Default save locally option */
+    readonly SAVE_LOCALLY: true;
+};
+/**
+ * Validation constraints for API parameters
+ */
+export declare const VALIDATION: {
+    /** Prompt constraints */
+    readonly PROMPT: {
+        readonly MIN_LENGTH: 1;
+        readonly MAX_LENGTH: 10000;
+    };
+    /** Number of images constraints */
+    readonly NUM_IMAGES: {
+        readonly MIN: 1;
+        readonly MAX: 8;
+    };
+    /** Seed constraints */
+    readonly SEED: {
+        readonly MIN: 0;
+        readonly MAX: 2147483647;
+    };
+    /** Expand pixels constraints for outpainting */
+    readonly EXPAND_PIXELS: {
+        readonly MIN: 1;
+        readonly MAX: 1024;
+    };
+    /** Image file constraints */
+    readonly IMAGE: {
+        /** Maximum file size in bytes (10MB) */
+        readonly MAX_SIZE_BYTES: number;
+        /** Supported image formats */
+        readonly SUPPORTED_FORMATS: readonly ["image/png", "image/jpeg", "image/webp"];
+    };
+};
+/**
+ * Credit costs per image by rendering speed.
+ * Note: These are estimates based on known Ideogram pricing.
+ * Actual costs may vary - Ideogram API does not return cost info.
+ */
+export declare const CREDITS_PER_IMAGE: Record<RenderingSpeed, number>;
+/**
+ * Credits cost for edit operations per image.
+ */
+export declare const EDIT_CREDITS_PER_IMAGE: Record<RenderingSpeed, number>;
+/**
+ * Estimated USD per credit.
+ * Based on Ideogram's pricing tiers.
+ */
+export declare const USD_PER_CREDIT: 0.05;
+/**
+ * HTTP status codes for error handling
+ */
+export declare const HTTP_STATUS: {
+    readonly OK: 200;
+    readonly CREATED: 201;
+    readonly BAD_REQUEST: 400;
+    readonly UNAUTHORIZED: 401;
+    readonly FORBIDDEN: 403;
+    readonly NOT_FOUND: 404;
+    readonly TOO_MANY_REQUESTS: 429;
+    readonly INTERNAL_SERVER_ERROR: 500;
+    readonly SERVICE_UNAVAILABLE: 503;
+};
+/**
+ * Retryable HTTP status codes
+ */
+export declare const RETRYABLE_STATUS_CODES: readonly number[];
+/**
+ * Retry configuration for transient errors
+ */
+export declare const RETRY_CONFIG: {
+    /** Maximum number of retry attempts */
+    readonly MAX_ATTEMPTS: 3;
+    /** Initial delay in milliseconds */
+    readonly INITIAL_DELAY_MS: 1000;
+    /** Maximum delay in milliseconds */
+    readonly MAX_DELAY_MS: 10000;
+    /** Backoff multiplier for exponential backoff */
+    readonly BACKOFF_MULTIPLIER: 2;
+};
+/**
+ * Timeout configuration in milliseconds
+ */
+export declare const TIMEOUTS: {
+    /** Default API request timeout */
+    readonly DEFAULT_REQUEST_MS: 30000;
+    /** Long-running request timeout (for quality rendering) */
+    readonly LONG_REQUEST_MS: 120000;
+    /** Image download timeout */
+    readonly IMAGE_DOWNLOAD_MS: 60000;
+};
+/**
+ * MCP Server identification
+ */
+export declare const SERVER_INFO: {
+    readonly NAME: "ideogram-mcp-server";
+    readonly VERSION: "1.0.0";
+    readonly DESCRIPTION: "Production-grade Ideogram AI image generation MCP server";
+};
+/**
+ * Configuration for the local prediction queue
+ */
+export declare const PREDICTION_QUEUE: {
+    /** Maximum number of queued predictions */
+    readonly MAX_QUEUE_SIZE: 100;
+    /** Prediction timeout in milliseconds */
+    readonly PREDICTION_TIMEOUT_MS: 300000;
+    /** Time before prediction records are cleaned up (24 hours) */
+    readonly CLEANUP_AGE_MS: number;
+};
+/**
+ * Custom error codes for the MCP server
+ */
+export declare const ERROR_CODES: {
+    readonly INVALID_API_KEY: "INVALID_API_KEY";
+    readonly MISSING_API_KEY: "MISSING_API_KEY";
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    readonly INVALID_PROMPT: "INVALID_PROMPT";
+    readonly INVALID_ASPECT_RATIO: "INVALID_ASPECT_RATIO";
+    readonly INVALID_IMAGE: "INVALID_IMAGE";
+    readonly INVALID_MASK: "INVALID_MASK";
+    readonly IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE";
+    readonly API_ERROR: "API_ERROR";
+    readonly RATE_LIMITED: "RATE_LIMITED";
+    readonly INSUFFICIENT_CREDITS: "INSUFFICIENT_CREDITS";
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    readonly TIMEOUT: "TIMEOUT";
+    readonly PREDICTION_NOT_FOUND: "PREDICTION_NOT_FOUND";
+    readonly PREDICTION_ALREADY_COMPLETED: "PREDICTION_ALREADY_COMPLETED";
+    readonly PREDICTION_FAILED: "PREDICTION_FAILED";
+    readonly STORAGE_ERROR: "STORAGE_ERROR";
+    readonly DOWNLOAD_FAILED: "DOWNLOAD_FAILED";
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+};
+/**
+ * Type for error codes
+ */
+export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+//# sourceMappingURL=constants.d.ts.map

package/dist/config/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/config/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,WAAW,EACX,SAAS,EACT,KAAK,EACL,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAM/B;;GAEG;AACH,eAAO,MAAM,YAAY,EAAG,yBAAkC,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,2BAA2B;;IAE3B,6CAA6C;;IAE7C,kCAAkC;;CAE1B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc,EAAG,SAAkB,CAAC;AAMjD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAgBtC,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAK5C,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,WAAW,EAAmC,CAAC;AAE3F;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAMlC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,SAAS,KAAK,EAAkC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAMjD,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB,2BAA2B;2BACJ,WAAW;IAClC,2CAA2C;;IAE3C,8BAA8B;8BACA,cAAc;IAC5C,mCAAmC;2BACX,WAAW;IACnC,yBAAyB;yBACH,SAAS;IAC/B,kCAAkC;;CAE1B,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB,yBAAyB;;;;;IAKzB,mCAAmC;;;;;IAKnC,uBAAuB;;;;;IAKvB,gDAAgD;;;;;IAKhD,6BAA6B;;QAE3B,wCAAwC;;QAExC,8BAA8B;;;CAGxB,CAAC;AAMX;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAKnD,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAKxD,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAG,IAAa,CAAC;AAM5C;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;CAUd,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAI1C,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB,uCAAuC;;IAEvC,oCAAoC;;IAEpC,oCAAoC;;IAEpC,iDAAiD;;CAEzC,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB,kCAAkC;;IAElC,2DAA2D;;IAE3D,6BAA6B;;CAErB,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B,2CAA2C;;IAE3C,yCAAyC;;IAEzC,+DAA+D;;CAEvD,CAAC;AAMX;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;CAkCd,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+/**
+ * Ideogram MCP Server Entry Point
+ *
+ * This is the main entry point for the Ideogram MCP (Model Context Protocol) server.
+ * It initializes the server with a StdioServerTransport for communication with
+ * MCP clients like Claude Desktop, Cursor, and other LLM applications.
+ *
+ * The server provides tools for:
+ * - ideogram_generate: Generate images from text prompts
+ * - ideogram_generate_async: Queue image generation for background processing
+ * - ideogram_edit: Edit images using inpainting or outpainting
+ * - ideogram_get_prediction: Poll for async job status and results
+ * - ideogram_cancel_prediction: Cancel queued async jobs
+ *
+ * @example
+ * ```bash
+ * # Run directly
+ * node dist/index.js
+ *
+ * # Run with inspector for debugging
+ * npx @modelcontextprotocol/inspector node dist/index.js
+ *
+ * # Configure in Claude Desktop (claude_desktop_config.json)
+ * {
+ *   "mcpServers": {
+ *     "ideogram": {
+ *       "command": "node",
+ *       "args": ["/path/to/ideogram-mcp-server/dist/index.js"],
+ *       "env": {
+ *         "IDEOGRAM_API_KEY": "your_api_key"
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG"}

package/dist/index.js

@@ -370,14 +370,11 @@ function getApiErrorUserMessage(statusCode, apiMessage) {
   }
 }
 function extractRetryAfter(headers) {
-  if (!headers)
-    return void 0;
+  if (!headers) return void 0;
   const retryAfter = headers["retry-after"] || headers["Retry-After"];
-  if (!retryAfter)
-    return void 0;
+  if (!retryAfter) return void 0;
   const seconds = parseInt(retryAfter, 10);
-  if (!isNaN(seconds))
-    return seconds;
+  if (!isNaN(seconds)) return seconds;
   const date = new Date(retryAfter);
   if (!isNaN(date.getTime())) {
     const nowMs = Date.now();
@@ -553,10 +550,7 @@ var init_config = __esm({
       localSaveDir: process.env["LOCAL_SAVE_DIR"],
       enableLocalSave: parseBoolean(process.env["ENABLE_LOCAL_SAVE"], DEFAULTS.SAVE_LOCALLY),
       maxConcurrentRequests: parseInteger(process.env["MAX_CONCURRENT_REQUESTS"], 3),
-      requestTimeoutMs: parseInteger(
-        process.env["REQUEST_TIMEOUT_MS"],
-        TIMEOUTS.DEFAULT_REQUEST_MS
-      )
+      requestTimeoutMs: parseInteger(process.env["REQUEST_TIMEOUT_MS"], TIMEOUTS.DEFAULT_REQUEST_MS)
     };
     config = loadConfig();
   }
@@ -628,12 +622,9 @@ function serializeRequest(req) {
     return {};
   }
   const serialized = {};
-  if ("method" in req)
-    serialized["method"] = req["method"];
-  if ("url" in req)
-    serialized["url"] = req["url"];
-  if ("endpoint" in req)
-    serialized["endpoint"] = req["endpoint"];
+  if ("method" in req) serialized["method"] = req["method"];
+  if ("url" in req) serialized["url"] = req["url"];
+  if ("endpoint" in req) serialized["endpoint"] = req["endpoint"];
   if ("headers" in req && typeof req["headers"] === "object" && req["headers"] !== null) {
     const headers = req["headers"];
     const sanitizedHeaders = {};
@@ -654,12 +645,9 @@ function serializeResponse(res) {
     return {};
   }
   const serialized = {};
-  if ("status" in res)
-    serialized["status"] = res["status"];
-  if ("statusCode" in res)
-    serialized["statusCode"] = res["statusCode"];
-  if ("duration" in res)
-    serialized["duration"] = res["duration"];
+  if ("status" in res) serialized["status"] = res["status"];
+  if ("statusCode" in res) serialized["statusCode"] = res["statusCode"];
+  if ("duration" in res) serialized["duration"] = res["duration"];
   return serialized;
 }
 function createChildLogger(component) {
@@ -694,10 +682,7 @@ function logApiResponse(log, context) {
 }
 function logToolInvocation(log, context) {
   const sanitizedParams = sanitizeToolParams(context.params);
-  log.info(
-    { tool: context.tool, params: sanitizedParams },
-    "Tool invoked"
-  );
+  log.info({ tool: context.tool, params: sanitizedParams }, "Tool invoked");
 }
 function logToolResult(log, context) {
   const level = context.success ? "info" : "warn";
@@ -861,10 +846,7 @@ var init_prediction_store = __esm({
           eta_seconds: this.estimateEta(options.request)
         };
         this.predictions.set(id, prediction);
-        this.log.info(
-          { predictionId: id, type: options.type },
-          "Prediction created and queued"
-        );
+        this.log.info({ predictionId: id, type: options.type }, "Prediction created and queued");
         this.processNextIfIdle();
         return prediction;
       }
@@ -1313,10 +1295,7 @@ var init_prediction_store = __esm({
         if (this.cleanupTimer.unref) {
           this.cleanupTimer.unref();
         }
-        this.log.debug(
-          { intervalMs: this.cleanupIntervalMs },
-          "Auto cleanup started"
-        );
+        this.log.debug({ intervalMs: this.cleanupIntervalMs }, "Auto cleanup started");
       }
     };
   }
@@ -1345,12 +1324,7 @@ var init_tool_types = __esm({
       "10x16",
       "16x10"
     ]);
-    RenderingSpeedSchema = z2.enum([
-      "FLASH",
-      "TURBO",
-      "DEFAULT",
-      "QUALITY"
-    ]);
+    RenderingSpeedSchema = z2.enum(["FLASH", "TURBO", "DEFAULT", "QUALITY"]);
     MagicPromptSchema = z2.enum(["AUTO", "ON", "OFF"]);
     StyleTypeSchema = z2.enum([
       "AUTO",
@@ -1766,12 +1740,7 @@ var init_ideogram_client = __esm({
         };
         logApiRequest(this.log, requestContext);
         const timeout = TIMEOUTS.LONG_REQUEST_MS;
-        const response = await this.executeWithRetry(
-          endpoint,
-          formData,
-          timeout,
-          "edit"
-        );
+        const response = await this.executeWithRetry(endpoint, formData, timeout, "edit");
         const responseContext = {
           endpoint,
           statusCode: 200,
@@ -1930,7 +1899,7 @@ var init_ideogram_client = __esm({
           const buffer = Buffer.from(response.data);
           this.validateImageSize(buffer.length);
           let contentType = response.headers["content-type"]?.toString().split(";")[0];
-          if (!contentType || !contentType.startsWith("image/")) {
+          if (!contentType?.startsWith("image/")) {
             contentType = this.detectImageType(buffer);
           }
           const extension = this.getExtensionForContentType(contentType);
@@ -1941,10 +1910,7 @@ var init_ideogram_client = __esm({
           };
         } catch (error) {
           if (axios.isAxiosError(error)) {
-            throw createNetworkError(
-              `Failed to download image from URL: ${error.message}`,
-              error
-            );
+            throw createNetworkError(`Failed to download image from URL: ${error.message}`, error);
           }
           throw wrapError(error);
         }
@@ -2143,10 +2109,7 @@ var init_storage_service = __esm({
           const filePath = path.resolve(targetDir, filename);
           await this.saveFile(filePath, buffer);
           const durationMs = Date.now() - startTime;
-          this.log.info(
-            { filename, sizeBytes: buffer.length, durationMs },
-            "Image saved successfully"
-          );
+          this.log.info({ filename, sizeBytes: buffer.length, durationMs }, "Image saved successfully");
           return {
             filePath,
             filename,
@@ -2402,10 +2365,7 @@ var init_storage_service = __esm({
         try {
           await fs.promises.writeFile(filePath, data);
         } catch (error) {
-          throw createStorageError(
-            "write",
-            `Failed to write file: ${error.message}`
-          );
+          throw createStorageError("write", `Failed to write file: ${error.message}`);
         }
       }
       /**
@@ -2517,11 +2477,8 @@ function createGenerateHandler(options = {}) {
         });
         for (let i = 0; i < response.data.length; i++) {
           const apiImage = response.data[i];
-          if (!apiImage)
-            continue;
-          const savedImage = saveResult.saved.find(
-            (s) => s.originalUrl === apiImage.url
-          );
+          if (!apiImage) continue;
+          const savedImage = saveResult.saved.find((s) => s.originalUrl === apiImage.url);
           const outputImage = {
             url: apiImage.url,
             seed: apiImage.seed,
@@ -2539,10 +2496,7 @@ function createGenerateHandler(options = {}) {
           images.push(outputImage);
         }
         if (saveResult.failureCount > 0) {
-          log.warn(
-            { failedCount: saveResult.failureCount },
-            "Some images failed to save locally"
-          );
+          log.warn({ failedCount: saveResult.failureCount }, "Some images failed to save locally");
         }
       } else {
         for (const apiImage of response.data) {
@@ -2699,11 +2653,8 @@ function createEditHandler(options = {}) {
         });
         for (let i = 0; i < response.data.length; i++) {
           const apiImage = response.data[i];
-          if (!apiImage)
-            continue;
-          const savedImage = saveResult.saved.find(
-            (s) => s.originalUrl === apiImage.url
-          );
+          if (!apiImage) continue;
+          const savedImage = saveResult.saved.find((s) => s.originalUrl === apiImage.url);
           const outputImage = {
             url: apiImage.url,
             seed: apiImage.seed,
@@ -2721,10 +2672,7 @@ function createEditHandler(options = {}) {
           images.push(outputImage);
         }
         if (saveResult.failureCount > 0) {
-          log.warn(
-            { failedCount: saveResult.failureCount },
-            "Some images failed to save locally"
-          );
+          log.warn({ failedCount: saveResult.failureCount }, "Some images failed to save locally");
         }
       } else {
         for (const apiImage of response.data) {
@@ -3051,7 +2999,7 @@ function createGetPredictionHandler(options = {}) {
             }
           }
           const renderingSpeed = prediction.request.rendering_speed ?? "DEFAULT";
-          const numImages = images.length || prediction.request.num_images || 1;
+          const numImages = images.length > 0 ? images.length : prediction.request.num_images ?? 1;
           const cost = prediction.type === "edit" ? calculateEditCost({ numImages, renderingSpeed }) : calculateCost({ numImages, renderingSpeed });
           const completedResult = {
             success: true,
@@ -3435,11 +3383,7 @@ init_logger();
 init_constants();
 var serverLogger = createChildLogger("server");
 function createServer(options = {}) {
-  const {
-    name = SERVER_INFO.NAME,
-    version = SERVER_INFO.VERSION,
-    toolOptions = {}
-  } = options;
+  const { name = SERVER_INFO.NAME, version = SERVER_INFO.VERSION, toolOptions = {} } = options;
   serverLogger.info({ name, version }, "Creating MCP server");
   const server = new McpServer({
     name,

package/dist/placeholder.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Placeholder file for project setup phase.
+ * This file will be replaced by actual implementation in subsequent phases.
+ */
+export {};
+//# sourceMappingURL=placeholder.d.ts.map

package/dist/placeholder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder.d.ts","sourceRoot":"","sources":["../src/placeholder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC"}