grok-imagine-image-mcp-server 1.0.0

package/dist/utils/batch-manager.js

@@ -0,0 +1,301 @@
+/**
+ * Batch execution manager with concurrency control
+ */
+import { resolveOutputPath, getDefaultOutputDirectory } from './batch-config.js';
+import { generateImage } from '../tools/generate.js';
+import { editImage } from '../tools/edit.js';
+import { debugLog } from './debug.js';
+/**
+ * Semaphore for concurrency control
+ */
+class Semaphore {
+    permits;
+    queue = [];
+    constructor(permits) {
+        this.permits = permits;
+    }
+    async acquire() {
+        if (this.permits > 0) {
+            this.permits--;
+            return;
+        }
+        return new Promise((resolve) => {
+            this.queue.push(resolve);
+        });
+    }
+    release() {
+        const next = this.queue.shift();
+        if (next) {
+            next();
+        }
+        else {
+            this.permits++;
+        }
+    }
+}
+/**
+ * Cost per image by model
+ */
+const MODEL_COSTS = {
+    'grok-imagine-image': { base: 0.02, edit_input: 0.002 },
+    'grok-2-image': { base: 0.07, edit_input: 0 },
+    'grok-2-image-latest': { base: 0.07, edit_input: 0 },
+    'grok-2-image-1212': { base: 0.07, edit_input: 0 },
+};
+/**
+ * BatchManager handles batch execution with concurrency control
+ */
+export class BatchManager {
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    /**
+     * Estimate cost for batch execution
+     */
+    estimateBatchCost(config) {
+        const breakdown = [];
+        const modelCounts = {};
+        for (const job of config.jobs) {
+            const model = job.model || config.default_model || 'grok-imagine-image';
+            const n = job.n || 1;
+            const isEdit = !!(job.image_path || job.image_base64 || job.image_url);
+            const key = `${model}${isEdit ? '_edit' : ''}`;
+            if (!modelCounts[key]) {
+                modelCounts[key] = { count: 0, images: 0, isEdit };
+            }
+            modelCounts[key].count++;
+            modelCounts[key].images += n;
+        }
+        let totalMin = 0;
+        let totalMax = 0;
+        let totalImages = 0;
+        for (const [key, data] of Object.entries(modelCounts)) {
+            const modelName = key.replace('_edit', '');
+            const costs = MODEL_COSTS[modelName] || MODEL_COSTS['grok-imagine-image'];
+            const baseCost = costs.base * data.images;
+            const editCost = data.isEdit ? costs.edit_input * data.count : 0;
+            const cost = baseCost + editCost;
+            breakdown.push({
+                model: key,
+                count: data.count,
+                images: data.images,
+                costMin: cost,
+                costMax: cost,
+            });
+            totalMin += cost;
+            totalMax += cost;
+            totalImages += data.images;
+        }
+        return {
+            totalJobs: config.jobs.length,
+            totalImages,
+            estimatedCostMin: totalMin,
+            estimatedCostMax: totalMax,
+            breakdown,
+        };
+    }
+    /**
+     * Execute batch jobs with concurrency control
+     */
+    async executeBatch(config, options = {}) {
+        const startTime = Date.now();
+        const startedAt = new Date().toISOString();
+        const maxConcurrent = config.max_concurrent || 2;
+        const timeout = config.timeout || 600000;
+        const outputDir = config.output_dir || getDefaultOutputDirectory();
+        const semaphore = new Semaphore(maxConcurrent);
+        debugLog(`Starting batch execution: ${config.jobs.length} jobs, max concurrent: ${maxConcurrent}`);
+        const results = [];
+        const jobPromises = [];
+        // Create job promises
+        for (let i = 0; i < config.jobs.length; i++) {
+            const job = config.jobs[i];
+            const outputPath = resolveOutputPath(job, i, outputDir, options.allowAnyPath);
+            const jobPromise = (async () => {
+                await semaphore.acquire();
+                try {
+                    const result = await this.executeJob(job, i, outputPath, config);
+                    results.push(result);
+                }
+                finally {
+                    semaphore.release();
+                }
+            })();
+            jobPromises.push(jobPromise);
+        }
+        // Execute with timeout
+        let timedOut = false;
+        try {
+            await Promise.race([
+                Promise.all(jobPromises),
+                new Promise((_, reject) => setTimeout(() => {
+                    timedOut = true;
+                    reject(new Error('Batch execution timed out'));
+                }, timeout)),
+            ]);
+        }
+        catch (error) {
+            if (timedOut) {
+                debugLog('Batch timed out, waiting for in-progress jobs...');
+                // Wait a bit for in-progress jobs to complete
+                await new Promise((resolve) => setTimeout(resolve, 2000));
+            }
+            else {
+                throw error;
+            }
+        }
+        // Mark incomplete jobs as cancelled
+        const completedIndices = new Set(results.map((r) => r.index));
+        for (let i = 0; i < config.jobs.length; i++) {
+            if (!completedIndices.has(i + 1)) {
+                results.push({
+                    index: i + 1,
+                    prompt: config.jobs[i].prompt,
+                    status: 'cancelled',
+                    error: 'Job cancelled due to timeout',
+                });
+            }
+        }
+        // Sort results by index
+        results.sort((a, b) => a.index - b.index);
+        const endTime = Date.now();
+        const finishedAt = new Date().toISOString();
+        // Calculate totals
+        const succeeded = results.filter((r) => r.status === 'completed').length;
+        const failed = results.filter((r) => r.status === 'failed').length;
+        const cancelled = results.filter((r) => r.status === 'cancelled').length;
+        // Estimate cost
+        const estimate = this.estimateBatchCost(config);
+        return {
+            total: config.jobs.length,
+            succeeded,
+            failed,
+            cancelled,
+            results,
+            started_at: startedAt,
+            finished_at: finishedAt,
+            total_duration_ms: endTime - startTime,
+            estimated_cost: estimate.estimatedCostMin,
+        };
+    }
+    /**
+     * Execute a single job with retry logic
+     */
+    async executeJob(job, index, outputPath, config) {
+        const jobIndex = index + 1;
+        const isEditJob = !!(job.image_path || job.image_base64 || job.image_url);
+        const retryPolicy = config.retry_policy || { max_retries: 2, retry_delay_ms: 1000 };
+        const maxRetries = retryPolicy.max_retries ?? 2;
+        const retryDelay = retryPolicy.retry_delay_ms ?? 1000;
+        const retryPatterns = retryPolicy.retry_on_errors ?? ['rate_limit', 'timeout', '429', '503'];
+        let lastError = '';
+        const startTime = Date.now();
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                debugLog(`Job ${jobIndex}: Starting (attempt ${attempt + 1}/${maxRetries + 1})`);
+                let result;
+                let revisedPrompt;
+                let outputPaths = [];
+                if (isEditJob) {
+                    // Edit job
+                    result = await editImage(this.apiKey, {
+                        prompt: job.prompt,
+                        image_path: job.image_path,
+                        image_base64: job.image_base64,
+                        image_url: job.image_url,
+                        output_path: outputPath,
+                        model: job.model || config.default_model,
+                        n: job.n || 1,
+                        resolution: job.resolution || config.default_resolution,
+                    });
+                }
+                else {
+                    // Generate job
+                    result = await generateImage(this.apiKey, {
+                        prompt: job.prompt,
+                        output_path: outputPath,
+                        model: job.model || config.default_model,
+                        n: job.n || 1,
+                        aspect_ratio: job.aspect_ratio || config.default_aspect_ratio,
+                        resolution: job.resolution || config.default_resolution,
+                    });
+                }
+                // Parse result
+                if (typeof result === 'string') {
+                    // Extract output paths from result text
+                    const pathMatches = result.match(/(?:saved|generated|edited)[^:]*:\s*([^\n]+)/gi);
+                    if (pathMatches) {
+                        for (const match of pathMatches) {
+                            const pathMatch = match.match(/:\s*(.+)/);
+                            if (pathMatch) {
+                                outputPaths.push(pathMatch[1].trim());
+                            }
+                        }
+                    }
+                    // Extract revised prompt
+                    const promptMatch = result.match(/Revised prompt:\s*(.+)/i);
+                    if (promptMatch) {
+                        revisedPrompt = promptMatch[1].trim();
+                    }
+                }
+                else if (result && result.content) {
+                    // Result with content array
+                    const textContent = result.content.find((c) => c.type === 'text');
+                    if (textContent && textContent.text) {
+                        const pathMatches = textContent.text.match(/(?:saved|generated|edited)[^:]*:\s*([^\n]+)/gi);
+                        if (pathMatches) {
+                            for (const match of pathMatches) {
+                                const pathMatch = match.match(/:\s*(.+)/);
+                                if (pathMatch) {
+                                    outputPaths.push(pathMatch[1].trim());
+                                }
+                            }
+                        }
+                        const promptMatch = textContent.text.match(/Revised prompt:\s*(.+)/i);
+                        if (promptMatch) {
+                            revisedPrompt = promptMatch[1].trim();
+                        }
+                    }
+                }
+                // If no paths extracted, use the expected output path
+                if (outputPaths.length === 0) {
+                    outputPaths.push(outputPath);
+                }
+                const duration = Date.now() - startTime;
+                debugLog(`Job ${jobIndex}: Completed in ${duration}ms`);
+                return {
+                    index: jobIndex,
+                    prompt: job.prompt,
+                    status: 'completed',
+                    output_paths: outputPaths,
+                    duration_ms: duration,
+                    revised_prompt: revisedPrompt,
+                    is_edit: isEditJob,
+                };
+            }
+            catch (error) {
+                lastError = error.message || String(error);
+                debugLog(`Job ${jobIndex}: Failed (attempt ${attempt + 1}): ${lastError}`);
+                // Check if we should retry
+                const shouldRetry = attempt < maxRetries &&
+                    retryPatterns.some((pattern) => lastError.toLowerCase().includes(pattern.toLowerCase()));
+                if (shouldRetry) {
+                    debugLog(`Job ${jobIndex}: Retrying in ${retryDelay}ms...`);
+                    await new Promise((resolve) => setTimeout(resolve, retryDelay));
+                }
+            }
+        }
+        // All retries exhausted
+        const duration = Date.now() - startTime;
+        return {
+            index: jobIndex,
+            prompt: job.prompt,
+            status: 'failed',
+            error: lastError,
+            duration_ms: duration,
+            is_edit: isEditJob,
+        };
+    }
+}
+//# sourceMappingURL=batch-manager.js.map

package/dist/utils/batch-manager.js.map

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

package/dist/utils/debug.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Debug logging utility
+ */
+export declare function debugLog(message: string, data?: any): void;
+//# sourceMappingURL=debug.d.ts.map

package/dist/utils/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/utils/debug.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI,CAS1D"}

package/dist/utils/debug.js

@@ -0,0 +1,16 @@
+/**
+ * Debug logging utility
+ */
+const DEBUG = process.env.DEBUG === 'true';
+export function debugLog(message, data) {
+    if (DEBUG) {
+        const timestamp = new Date().toISOString();
+        if (data !== undefined) {
+            console.error(`[${timestamp}] ${message}`, JSON.stringify(data, null, 2));
+        }
+        else {
+            console.error(`[${timestamp}] ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=debug.js.map

package/dist/utils/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/utils/debug.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,CAAC;AAE3C,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,IAAU;IAClD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,KAAK,OAAO,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5E,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/utils/image.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Image utilities for saving and processing images
+ */
+/**
+ * Save base64 image data to file
+ */
+export declare function saveBase64Image(base64Data: string, outputPath: string): Promise<void>;
+/**
+ * Download image from URL and save to file
+ */
+export declare function downloadAndSaveImage(url: string, outputPath: string): Promise<void>;
+/**
+ * Validate aspect ratio format
+ */
+export declare function validateAspectRatio(aspectRatio: string): boolean;
+/**
+ * Get file extension from output format or path
+ */
+export declare function getImageExtension(outputPath: string): string;
+/**
+ * Generate thumbnail data from image file
+ */
+export declare function generateThumbnailData(imagePath: string, maxWidth?: number, maxHeight?: number): Promise<string>;
+/**
+ * Check if thumbnail generation is enabled via environment variable
+ */
+export declare function isThumbnailEnabled(): boolean;
+/**
+ * Create MCP content object with thumbnail
+ */
+export declare function createThumbnailContent(base64Data: string): {
+    type: string;
+    data: string;
+    mimeType: string;
+};
+//# sourceMappingURL=image.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/utils/image.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAIhE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAM5D;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAY,EACtB,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,CAMA"}

package/dist/utils/image.js

@@ -0,0 +1,85 @@
+/**
+ * Image utilities for saving and processing images
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { debugLog } from './debug.js';
+/**
+ * Save base64 image data to file
+ */
+export async function saveBase64Image(base64Data, outputPath) {
+    const buffer = Buffer.from(base64Data, 'base64');
+    await fs.writeFile(outputPath, buffer);
+    debugLog(`Saved image to: ${outputPath}`);
+}
+/**
+ * Download image from URL and save to file
+ */
+export async function downloadAndSaveImage(url, outputPath) {
+    debugLog(`Downloading image from: ${url}`);
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to download image: ${response.status} ${response.statusText}`);
+    }
+    const arrayBuffer = await response.arrayBuffer();
+    const buffer = Buffer.from(arrayBuffer);
+    await fs.writeFile(outputPath, buffer);
+    debugLog(`Saved image to: ${outputPath}`);
+}
+/**
+ * Validate aspect ratio format
+ */
+export function validateAspectRatio(aspectRatio) {
+    // Format: "width:height" e.g., "4:3", "16:9", "1:1"
+    const pattern = /^\d+:\d+$/;
+    return pattern.test(aspectRatio);
+}
+/**
+ * Get file extension from output format or path
+ */
+export function getImageExtension(outputPath) {
+    const ext = path.extname(outputPath).toLowerCase();
+    if (['.png', '.jpg', '.jpeg', '.webp'].includes(ext)) {
+        return ext.substring(1);
+    }
+    return 'png'; // default
+}
+/**
+ * Generate thumbnail data from image file
+ */
+export async function generateThumbnailData(imagePath, maxWidth = 256, maxHeight = 256) {
+    try {
+        // Dynamic import for sharp (optional dependency)
+        const sharp = (await import('sharp')).default;
+        const imageBuffer = await fs.readFile(imagePath);
+        const thumbnailBuffer = await sharp(imageBuffer)
+            .resize(maxWidth, maxHeight, {
+            fit: 'inside',
+            withoutEnlargement: true,
+        })
+            .jpeg({ quality: 80 })
+            .toBuffer();
+        return thumbnailBuffer.toString('base64');
+    }
+    catch (error) {
+        debugLog(`Failed to generate thumbnail: ${error.message}`);
+        throw error;
+    }
+}
+/**
+ * Check if thumbnail generation is enabled via environment variable
+ */
+export function isThumbnailEnabled() {
+    return process.env.XAI_IMAGE_THUMBNAIL === 'true';
+}
+/**
+ * Create MCP content object with thumbnail
+ */
+export function createThumbnailContent(base64Data) {
+    return {
+        type: 'image',
+        data: base64Data,
+        mimeType: 'image/jpeg',
+    };
+}
+//# sourceMappingURL=image.js.map

package/dist/utils/image.js.map

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

package/dist/utils/path.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Path utilities for cross-platform file handling
+ */
+/**
+ * Normalize and validate output path
+ */
+export declare function normalizeAndValidatePath(outputPath: string): Promise<string>;
+/**
+ * Generate unique file path to avoid overwriting
+ */
+export declare function generateUniqueFilePath(filePath: string): Promise<string>;
+/**
+ * Get display-friendly path (relative to cwd if possible)
+ */
+export declare function getDisplayPath(filePath: string): string;
+//# sourceMappingURL=path.d.ts.map

package/dist/utils/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBlF;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB9E;AAcD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMvD"}

package/dist/utils/path.js

@@ -0,0 +1,70 @@
+/**
+ * Path utilities for cross-platform file handling
+ */
+import * as path from 'path';
+import * as fs from 'fs/promises';
+import { debugLog } from './debug.js';
+/**
+ * Normalize and validate output path
+ */
+export async function normalizeAndValidatePath(outputPath) {
+    // Handle relative paths
+    let normalizedPath = outputPath;
+    if (!path.isAbsolute(outputPath)) {
+        // Use OUTPUT_DIR env var or current working directory
+        const baseDir = process.env.OUTPUT_DIR || process.cwd();
+        normalizedPath = path.join(baseDir, outputPath);
+    }
+    // Ensure directory exists
+    const dir = path.dirname(normalizedPath);
+    try {
+        await fs.mkdir(dir, { recursive: true });
+        debugLog(`Directory ensured: ${dir}`);
+    }
+    catch (error) {
+        debugLog(`Failed to create directory: ${dir}`, error.message);
+        throw new Error(`Cannot create output directory: ${dir}`);
+    }
+    return normalizedPath;
+}
+/**
+ * Generate unique file path to avoid overwriting
+ */
+export async function generateUniqueFilePath(filePath) {
+    const ext = path.extname(filePath);
+    const baseName = path.basename(filePath, ext);
+    const dir = path.dirname(filePath);
+    let counter = 0;
+    let uniquePath = filePath;
+    while (await fileExists(uniquePath)) {
+        counter++;
+        uniquePath = path.join(dir, `${baseName}_${counter}${ext}`);
+    }
+    if (counter > 0) {
+        debugLog(`Generated unique path: ${uniquePath}`);
+    }
+    return uniquePath;
+}
+/**
+ * Check if file exists
+ */
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get display-friendly path (relative to cwd if possible)
+ */
+export function getDisplayPath(filePath) {
+    const cwd = process.cwd();
+    if (filePath.startsWith(cwd)) {
+        return path.relative(cwd, filePath) || filePath;
+    }
+    return filePath;
+}
+//# sourceMappingURL=path.js.map

package/dist/utils/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,UAAkB;IAC/D,wBAAwB;IACxB,IAAI,cAAc,GAAG,UAAU,CAAC;IAEhC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,sDAAsD;QACtD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACxD,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAClD,CAAC;IAED,0BAA0B;IAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,QAAQ,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,QAAQ,CAAC,+BAA+B,GAAG,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,QAAgB;IAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEnC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,UAAU,GAAG,QAAQ,CAAC;IAE1B,OAAO,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,CAAC;QACV,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,IAAI,OAAO,GAAG,GAAG,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,QAAQ,CAAC,0BAA0B,UAAU,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC;IAClD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/examples/batch-detailed.json

@@ -0,0 +1,41 @@
+{
+  "jobs": [
+    {
+      "prompt": "A majestic mountain landscape at sunrise",
+      "output_path": "mountain_sunrise.jpg",
+      "aspect_ratio": "16:9",
+      "resolution": "1k"
+    },
+    {
+      "prompt": "Portrait of a wise old wizard with a long beard",
+      "output_path": "wizard_portrait.jpg",
+      "aspect_ratio": "3:4",
+      "resolution": "1k"
+    },
+    {
+      "prompt": "A tropical beach with crystal clear water",
+      "output_path": "beach.jpg",
+      "aspect_ratio": "16:9",
+      "resolution": "1k"
+    },
+    {
+      "prompt": "A cozy coffee shop interior with warm lighting",
+      "output_path": "coffee_shop.jpg",
+      "aspect_ratio": "4:3"
+    },
+    {
+      "prompt": "An astronaut floating in space with Earth in the background",
+      "output_path": "astronaut.jpg",
+      "aspect_ratio": "1:1",
+      "resolution": "1k"
+    }
+  ],
+  "output_dir": "./output",
+  "max_concurrent": 3,
+  "default_model": "grok-imagine-image",
+  "default_resolution": "1k",
+  "retry_policy": {
+    "max_retries": 2,
+    "retry_delay_ms": 2000
+  }
+}

package/examples/batch-simple.json

@@ -0,0 +1,14 @@
+{
+  "jobs": [
+    {
+      "prompt": "A beautiful sunset over mountains with orange and purple sky"
+    },
+    {
+      "prompt": "A cute cat playing with a ball of yarn"
+    },
+    {
+      "prompt": "A futuristic city at night with neon lights"
+    }
+  ],
+  "output_dir": "./output"
+}

package/examples/batch-variants.json

@@ -0,0 +1,23 @@
+{
+  "jobs": [
+    {
+      "prompt": "A cute robot mascot character for a tech company",
+      "output_path": "robot_mascot.jpg",
+      "n": 3
+    },
+    {
+      "prompt": "Logo design for a coffee brand, minimalist style",
+      "output_path": "coffee_logo.jpg",
+      "n": 5
+    },
+    {
+      "prompt": "Abstract art with geometric shapes and vibrant colors",
+      "output_path": "abstract_art.jpg",
+      "n": 4,
+      "aspect_ratio": "1:1",
+      "resolution": "1k"
+    }
+  ],
+  "output_dir": "./output/variants",
+  "max_concurrent": 2
+}