@noleemits/vision-builder-control-mcp 4.34.0 → 4.35.1

package/index.js

@@ -3,6 +3,7 @@
  * Noleemits Vision Builder Control MCP Server
  *
  * Provides 67 tools for building and managing WordPress/Elementor sites.
+ * v4.35.0: PixelVault image integration — pixelvault_status, find_images, generate_image, get_batch_status, insert_image tools; proxy REST endpoints at /nvbc/v1/pixelvault/*.
  * v4.34.0: Design tokens auto-inject as CSS custom properties (--nvbc-color-*, --nvbc-fs-*, --nvbc-space-*) site-wide via wp_head; kit global CSS tools (get_kit_global_css, set_kit_global_css); get_kit_settings formatter handles gap-style objects.
  * v4.33.0: Elementor kit layout settings (get_kit_settings, set_kit_settings) — read/write container_width, viewports, gutter.
  * v4.15.0: Injection engine v2 — icon-list injection, unfilled slot clearing.
@@ -106,7 +107,7 @@ process.on('SIGINT', () => {
 // CONFIG
 // ================================================================
 
-const VERSION = '4.34.0';
+const VERSION = '4.35.1';
 const MIN_PLUGIN_VERSION = '4.13.0'; // Minimum WP plugin version required by this MCP server
 
 // ================================================================
@@ -3087,6 +3088,67 @@ function getToolDefinitions() {
                 required: ['css']
             }
         },
+        // ── PixelVault image generation (v4.35.0) ──
+        {
+            name: 'pixelvault_status',
+            description: 'Check whether the PixelVault plugin is installed, connected (API key configured), and the backend is reachable. Call this before any other PixelVault tool to confirm readiness.',
+            inputSchema: { type: 'object', properties: {} }
+        },
+        {
+            name: 'find_images',
+            description: 'Search the PixelVault AI image library for images matching a query. Returns image results with IDs, URLs, descriptions, and thumbnails. Use the `id` field from results to call insert_image. **Workflow:** 1) Call find_images. 2) Read the `description` of each result to judge relevance. 3) If a clearly relevant match exists, call insert_image with its id. 4) If no relevant match, call generate_image instead.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query:    { type: 'string', description: 'Text search query describing what the image should show.' },
+                    industry: { type: 'string', description: 'Industry filter (e.g. "legal", "healthcare", "construction").' },
+                    style:    { type: 'string', description: 'Style filter (e.g. "photo", "illustration").' },
+                    tags:     { type: 'string', description: 'Comma-separated tag names to filter by.' },
+                    tag_mode: { type: 'string', enum: ['and', 'or'], description: 'Match all tags ("and") or any tag ("or", default).' },
+                    batch_id: { type: 'number', description: 'Filter to images from a specific generation batch (returned by generate_image).' },
+                    per_page: { type: 'number', description: 'Results per page (default 10, max 50).' },
+                    page:     { type: 'number', description: 'Page number for pagination (default 1).' }
+                }
+            }
+        },
+        {
+            name: 'generate_image',
+            description: 'Generate a new AI image from a text prompt using PixelVault. Generation is asynchronous — returns a batch_id immediately. Poll with get_batch_status until status is "ready", then call insert_image with the returned image id.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    prompt:  { type: 'string', description: 'Detailed description of the image to generate. Be specific about subject, setting, mood, and style.' },
+                    post_id: { type: 'number', description: 'Optional WP post ID to associate with this generation.' },
+                    ratio:   { type: 'string', enum: ['16:9', '1:1', '4:3', '9:16'], description: 'Aspect ratio (default: "16:9").' },
+                    quality: { type: 'string', enum: ['sd', 'hq'], description: 'Quality level: "sd" standard (default), "hq" high quality (uses more credits).' }
+                },
+                required: ['prompt']
+            }
+        },
+        {
+            name: 'get_batch_status',
+            description: 'Poll the status of an image generation batch started by generate_image. When status is "ready" the response includes image ids and URLs — pass an id to insert_image to add it to the WP media library.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    batch_id: { type: 'number', description: 'The batch_id returned by generate_image.' }
+                },
+                required: ['batch_id']
+            }
+        },
+        {
+            name: 'insert_image',
+            description: 'Sideload a PixelVault library image into the WordPress media library and return its attachment URL for use in Elementor widgets. Use image IDs from find_images or get_batch_status results.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    image_id:    { type: 'string', description: 'PixelVault image ID (UUID from find_images or get_batch_status).' },
+                    post_id:     { type: 'number', description: 'Optional WP post ID to attach the image to.' },
+                    as_featured: { type: 'boolean', description: 'Set as the post\'s featured image (default: false).' }
+                },
+                required: ['image_id']
+            }
+        },
         {
             name: 'audit_broken_images',
             description: 'Scan all published posts and Elementor pages for broken images (non-200 HTTP responses). Checks <img> tags in post_content and image/image-box widgets + background images in Elementor data. Returns broken URLs with HTTP status, error details, and which posts are affected.',
@@ -5282,6 +5344,96 @@ async function handleToolCall(name, args) {
         return ok(out);
     }
 
+    // ── PixelVault image generation ──
+
+    case 'pixelvault_status': {
+        const r = await apiCall('/pixelvault/status');
+        let out = `=== PIXELVAULT STATUS ===\n`;
+        out += `Available:   ${r.available  ? '✓ yes' : '✗ no'}\n`;
+        out += `Connected:   ${r.connected  ? '✓ yes' : '✗ no'}\n`;
+        out += `Backend OK:  ${r.backend_ok ? '✓ yes' : '✗ no'}\n`;
+        out += `\n${r.message}`;
+        return ok(out);
+    }
+
+    case 'find_images': {
+        const params = new URLSearchParams();
+        if (args.query)    params.set('search',   args.query);
+        if (args.industry) params.set('industry', args.industry);
+        if (args.style)    params.set('style',    args.style);
+        if (args.tags)     params.set('tags',     args.tags);
+        if (args.tag_mode) params.set('tag_mode', args.tag_mode);
+        if (args.batch_id) params.set('batch_id', args.batch_id);
+        if (args.per_page) params.set('per_page', args.per_page);
+        if (args.page)     params.set('page',     args.page);
+        const r = await apiCall(`/pixelvault/images?${params}`);
+        if (r.error || r.code) return ok(`PixelVault error: ${r.message || r.error}`);
+        let out = `=== PIXELVAULT IMAGES (${r.query_matched || 0} matched, ${r.library_size || 0} total) ===\n`;
+        if (!r.results || r.results.length === 0) {
+            out += `\nNo results. ${r.hint || ''}\n`;
+        } else {
+            r.results.forEach((img, i) => {
+                out += `\n[${i + 1}] ${img.id || img.image_id}\n`;
+                out += `  URL: ${img.url || img.thumbnail_url || img.cdn_url || '(no url)'}\n`;
+                if (img.description) out += `  Description: ${img.description}\n`;
+                if (img.industry)    out += `  Industry: ${img.industry}\n`;
+                if (img.style)       out += `  Style: ${img.style}\n`;
+                if (img.ratio)       out += `  Ratio: ${img.ratio}\n`;
+            });
+        }
+        return ok(out);
+    }
+
+    case 'generate_image': {
+        if (!args.prompt) return ok('Error: prompt is required.');
+        const body = { prompt: args.prompt };
+        if (args.post_id) body.post_id = args.post_id;
+        if (args.ratio)   body.ratio   = args.ratio;
+        if (args.quality) body.quality = args.quality;
+        const r = await apiCall('/pixelvault/generate', 'POST', body);
+        if (r.error || r.code) return ok(`Generation failed: ${r.detail || r.message || r.error} [${r.category || ''}]`);
+        let out = `=== IMAGE GENERATION STARTED ===\n`;
+        out += `Batch ID: ${r.batch_id}\n`;
+        out += `Status:   ${r.status || 'generating'}\n`;
+        out += `\n${r.message || 'Poll with get_batch_status(batch_id) until status is "ready", then insert_image.'}\n`;
+        return ok(out);
+    }
+
+    case 'get_batch_status': {
+        if (!args.batch_id) return ok('Error: batch_id is required.');
+        const r = await apiCall(`/pixelvault/batch/${args.batch_id}`);
+        if (r.error || r.code) return ok(`Batch error: ${r.message || r.error}`);
+        let out = `=== BATCH ${args.batch_id} — ${(r.status || 'unknown').toUpperCase()} ===\n`;
+        if (r.status === 'ready' && r.images && r.images.length) {
+            out += `\nImages ready (${r.images.length}):\n`;
+            r.images.forEach((img, i) => {
+                out += `  [${i + 1}] id: ${img.id || img.image_id}  url: ${img.url || img.cdn_url || ''}\n`;
+                if (img.description) out += `       ${img.description}\n`;
+            });
+            out += `\nCall insert_image with one of the ids above to add it to the media library.\n`;
+        } else if (r.status === 'generating') {
+            out += `\nStill generating. Poll again in a few seconds.\n`;
+        } else if (r.status === 'failed') {
+            out += `\nGeneration failed: ${r.error || r.message || '(no detail)'}\n`;
+        }
+        return ok(out);
+    }
+
+    case 'insert_image': {
+        if (!args.image_id) return ok('Error: image_id is required.');
+        const body = { image_id: args.image_id };
+        if (args.post_id)     body.post_id     = args.post_id;
+        if (args.as_featured) body.as_featured = args.as_featured;
+        const r = await apiCall('/pixelvault/insert', 'POST', body);
+        if (r.error || r.code) return ok(`Insert failed: ${r.message || r.error}`);
+        let out = `${r.was_existing ? 'Existing' : 'Inserted'} attachment #${r.attachment_id}\n`;
+        out += `  URL: ${r.url}\n`;
+        if (r.filename)    out += `  File: ${r.filename}\n`;
+        if (r.description) out += `  Description: ${r.description}\n`;
+        if (r.industry)    out += `  Industry: ${r.industry}\n`;
+        return ok(out);
+    }
+
     case 'audit_broken_images': {
         const params = new URLSearchParams();
         if (args.page_id) params.set('page_id', args.page_id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noleemits/vision-builder-control-mcp",
-  "version": "4.34.0",
+  "version": "4.35.1",
   "description": "Vision Builder Control MCP server - design token-driven page builder tools for WordPress/Elementor websites",
   "type": "module",
   "main": "index.js",