meigen 0.1.0

package/dist/tools/search-gallery.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * search_gallery Tool — free, no auth required
+ * Searches the local curated prompt library (1300+ high-quality prompts)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchGallerySchema = void 0;
+exports.registerSearchGallery = registerSearchGallery;
+const zod_1 = require("zod");
+const prompt_library_js_1 = require("../lib/prompt-library.js");
+exports.searchGallerySchema = {
+    query: zod_1.z.string().optional()
+        .describe('Search keywords (e.g., "cyberpunk", "product photo", "portrait"). Leave empty to browse by category or get random picks.'),
+    category: zod_1.z.enum(['3D', 'App', 'Food', 'Girl', 'JSON', 'Other', 'Photograph', 'Product']).optional()
+        .describe('Filter by category. Available: 3D, App, Food, Girl, JSON, Other, Photograph, Product'),
+    limit: zod_1.z.number().min(1).max(20).optional().default(5)
+        .describe('Number of results (1-20, default 5)'),
+    offset: zod_1.z.number().min(0).optional().default(0)
+        .describe('Pagination offset'),
+    sortBy: zod_1.z.enum(['rank', 'likes', 'views', 'date']).optional().default('rank')
+        .describe('Sort order when browsing without search query (default: rank)'),
+};
+function registerSearchGallery(server) {
+    server.tool('search_gallery', 'Search 1300+ curated AI image prompts with preview images. Results include image URLs — render them as markdown images (![](url)) so users can visually browse and pick styles. Use when users need inspiration, want to explore styles, or say "generate an image" without a specific idea.', exports.searchGallerySchema, { readOnlyHint: true }, async ({ query, category, limit, offset, sortBy }) => {
+        // No search criteria — return random picks
+        if (!query && !category && offset === 0) {
+            const random = (0, prompt_library_js_1.getRandomPrompts)(limit);
+            const stats = (0, prompt_library_js_1.getLibraryStats)();
+            const header = `Curated Prompt Library: ${stats.total} trending prompts\nCategories: ${Object.entries(stats.categories).map(([k, v]) => `${k} (${v})`).join(', ')}\n\nHere are ${limit} random picks — show the preview images to the user:\n`;
+            return {
+                content: [{
+                        type: 'text',
+                        text: header + formatResults(random),
+                    }],
+            };
+        }
+        const results = (0, prompt_library_js_1.searchPrompts)({ query, category, limit, offset, sortBy });
+        if (results.length === 0) {
+            const suggestion = category
+                ? `No results for "${query || ''}" in category "${category}". Try a different keyword or remove the category filter.`
+                : `No results for "${query}". Try broader keywords like "portrait", "landscape", "product", "anime".`;
+            return {
+                content: [{
+                        type: 'text',
+                        text: suggestion,
+                    }],
+            };
+        }
+        const searchDesc = [
+            query ? `"${query}"` : null,
+            category ? `category: ${category}` : null,
+        ].filter(Boolean).join(', ');
+        const text = `Found ${results.length} results${searchDesc ? ` for ${searchDesc}` : ''}:\n\n${formatResults(results)}\n\nShow the preview images above to the user so they can visually browse. Use get_inspiration(imageId) to get the full prompt and all images for any entry the user likes.`;
+        return {
+            content: [{
+                    type: 'text',
+                    text,
+                }],
+        };
+    });
+}
+function formatResults(results) {
+    return results.map((item, i) => {
+        // Truncate prompt to first 150 chars for preview
+        const promptPreview = item.prompt.length > 150
+            ? item.prompt.slice(0, 150).replace(/\n/g, ' ') + '...'
+            : item.prompt.replace(/\n/g, ' ');
+        const parts = [
+            `${i + 1}. **#${item.rank}** by ${item.author_name} — ${item.categories.join(', ')}`,
+            `   ![Preview #${item.rank}](${item.image})`,
+            `   Prompt: ${promptPreview}`,
+            `   Stats: ${item.likes} likes, ${item.views.toLocaleString()} views`,
+            `   ID: ${item.id}`,
+        ];
+        return parts.join('\n');
+    }).join('\n\n');
+}
+//# sourceMappingURL=search-gallery.js.map

package/dist/tools/search-gallery.js.map

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

package/dist/tools/upload-reference-image.d.ts

@@ -0,0 +1,13 @@
+/**
+ * upload_reference_image Tool
+ * Compresses a local image and uploads it to R2, returning a public URL
+ * for use as referenceImages in generate_image.
+ */
+import { z } from 'zod';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { MeiGenConfig } from '../config.js';
+export declare const uploadReferenceImageSchema: {
+    filePath: z.ZodString;
+};
+export declare function registerUploadReferenceImage(server: McpServer, config: MeiGenConfig): void;
+//# sourceMappingURL=upload-reference-image.d.ts.map

package/dist/tools/upload-reference-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-reference-image.d.ts","sourceRoot":"","sources":["../../src/tools/upload-reference-image.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAGhD,eAAO,MAAM,0BAA0B;;CAGtC,CAAA;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,QAoDnF"}

package/dist/tools/upload-reference-image.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * upload_reference_image Tool
+ * Compresses a local image and uploads it to R2, returning a public URL
+ * for use as referenceImages in generate_image.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadReferenceImageSchema = void 0;
+exports.registerUploadReferenceImage = registerUploadReferenceImage;
+const zod_1 = require("zod");
+const fs_1 = require("fs");
+const upload_js_1 = require("../lib/upload.js");
+exports.uploadReferenceImageSchema = {
+    filePath: zod_1.z.string()
+        .describe('Absolute path to a local image file (JPEG, PNG, WebP, or GIF). The image will be automatically compressed if needed and uploaded for use as a reference image in generate_image.'),
+};
+function registerUploadReferenceImage(server, config) {
+    server.tool('upload_reference_image', 'Upload a local image for use as a reference in generate_image. Compresses large images (max 2MB, max 2048px) and returns a public URL. Call this when the user wants to use a local file as a reference image.', exports.uploadReferenceImageSchema, { readOnlyHint: false }, async ({ filePath }) => {
+        // Validate file exists
+        if (!(0, fs_1.existsSync)(filePath)) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `File not found: ${filePath}`,
+                    }],
+                isError: true,
+            };
+        }
+        try {
+            const result = await (0, upload_js_1.processAndUploadImage)(filePath, config);
+            const compressed = result.originalSize !== result.compressedSize;
+            const sizeInfo = compressed
+                ? `Compressed: ${formatSize(result.originalSize)} → ${formatSize(result.compressedSize)}`
+                : `Size: ${formatSize(result.originalSize)} (no compression needed)`;
+            return {
+                content: [{
+                        type: 'text',
+                        text: [
+                            `Reference image uploaded successfully.`,
+                            ``,
+                            `URL: ${result.publicUrl}`,
+                            sizeInfo,
+                            ``,
+                            `Use this URL in generate_image's referenceImages parameter:`,
+                            `generate_image(prompt="...", referenceImages=["${result.publicUrl}"])`,
+                        ].join('\n'),
+                    }],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Failed to upload reference image: ${message}`,
+                    }],
+                isError: true,
+            };
+        }
+    });
+}
+function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+//# sourceMappingURL=upload-reference-image.js.map

package/dist/tools/upload-reference-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-reference-image.js","sourceRoot":"","sources":["../../src/tools/upload-reference-image.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAaH,oEAoDC;AA/DD,6BAAuB;AACvB,2BAA+B;AAG/B,gDAAwD;AAE3C,QAAA,0BAA0B,GAAG;IACxC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;SACjB,QAAQ,CAAC,kLAAkL,CAAC;CAChM,CAAA;AAED,SAAgB,4BAA4B,CAAC,MAAiB,EAAE,MAAoB;IAClF,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,gNAAgN,EAChN,kCAA0B,EAC1B,EAAE,YAAY,EAAE,KAAK,EAAE,EACvB,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,uBAAuB;QACvB,IAAI,CAAC,IAAA,eAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,mBAAmB,QAAQ,EAAE;qBACpC,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAA;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAA,iCAAqB,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;YAE5D,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,KAAK,MAAM,CAAC,cAAc,CAAA;YAChE,MAAM,QAAQ,GAAG,UAAU;gBACzB,CAAC,CAAC,eAAe,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,UAAU,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE;gBACzF,CAAC,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,0BAA0B,CAAA;YAEtE,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE;4BACJ,wCAAwC;4BACxC,EAAE;4BACF,QAAQ,MAAM,CAAC,SAAS,EAAE;4BAC1B,QAAQ;4BACR,EAAE;4BACF,6DAA6D;4BAC7D,kDAAkD,MAAM,CAAC,SAAS,KAAK;yBACxE,CAAC,IAAI,CAAC,IAAI,CAAC;qBACb,CAAC;aACH,CAAA;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACtE,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,qCAAqC,OAAO,EAAE;qBACrD,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAA;QACH,CAAC;IACH,CAAC,CACF,CAAA;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,GAAG,CAAA;IACpC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;IAChE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;AAClD,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "meigen",
+  "version": "0.1.0",
+  "description": "Visual creative expert plugin — search inspiration, enhance prompts, and generate AI images with intelligent workflow orchestration",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "meigen": "bin/meigen-mcp.js",
+    "meigen-mcp": "bin/meigen-mcp.js"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "data/",
+    "skills/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "mcp",
+    "ai",
+    "image-generation",
+    "claude",
+    "meigen",
+    "prompt-engineering"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "sharp": "^0.34.5",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/sharp": "^0.31.1",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/skills/setup/SKILL.md

@@ -0,0 +1,324 @@
+---
+name: setup
+description: >-
+  Configure MeiGen plugin provider and API keys. Use this when the user runs
+  /meigen:setup, asks to "configure meigen", "set up image generation",
+  "add API key", or needs help configuring the plugin.
+disable-model-invocation: true
+---
+
+# MeiGen Plugin Setup
+
+You are guiding the user through configuring the MeiGen plugin for image generation. Follow this flow step by step.
+
+## Step 1: Welcome
+
+First, check if a config file already exists:
+
+```bash
+cat ~/.config/meigen/config.json 2>/dev/null
+```
+
+Also check for existing ComfyUI workflows:
+
+```bash
+ls ~/.config/meigen/workflows/*.json 2>/dev/null
+```
+
+If config exists, show the current configuration (mask API keys: show first 10 chars + "...") and any saved workflows. Ask if they want to reconfigure.
+
+If no config exists, present this introduction:
+
+> **MeiGen Plugin Configuration**
+>
+> This is optional. Without configuration, you can still use free features:
+> - Search gallery for inspiration and prompts
+> - Enhance simple ideas into professional prompts
+> - Browse available AI models
+>
+> Configuring a provider unlocks **image generation**.
+
+Then proceed to Step 2.
+
+## Step 2: Choose Provider
+
+Present these options to the user:
+
+### Option A: MeiGen Platform (Recommended)
+
+- Supports **Nanobanana Pro**, **Seedream 4.5**, **Midjourney Niji7** and more
+- Free daily credits included
+- Reference image support for style transfer
+- No additional accounts needed — just get a token from meigen.ai
+
+### Option B: ComfyUI (Local)
+
+- Use your **local ComfyUI** installation for image generation
+- Full control over models, samplers, and workflow settings
+- No cloud API needed — runs entirely on your machine
+- Import your own workflow from ComfyUI
+
+### Option C: Custom OpenAI-Compatible API
+
+- Use your own **OpenAI**, **Together AI**, **Fireworks AI**, or any OpenAI-compatible service
+- Bring your own API key and billing
+- Supports any model that uses the OpenAI `/v1/images/generations` endpoint
+
+### Option D: Import from curl Example
+
+- Already have a working curl command from your API provider's docs? Paste it directly!
+- We'll automatically extract the API key, base URL, and model name
+
+### Option E: Skip image generation for now
+
+- Free features still available (inspiration search, prompt enhancement, model listing)
+- You can run `/meigen:setup` anytime later to enable image generation
+
+If user chooses **Skip**, say goodbye and exit. Otherwise continue to the appropriate Step 3.
+
+## Step 3A: MeiGen Platform Setup
+
+Ask the user:
+
+> Do you already have a MeiGen API token, or do you need to create one?
+
+### If they need to create one:
+
+Provide these instructions:
+
+1. Go to **https://www.meigen.ai**
+2. Sign in or create an account
+3. Navigate to **Settings** (click your avatar) → **API Keys**
+4. Click **Create API Key**, give it a name
+5. Copy the token (starts with `meigen_sk_`)
+
+Then ask them to paste the token.
+
+### If they already have one:
+
+Ask them to paste their `meigen_sk_...` token.
+
+### Validate the token:
+
+- Must start with `meigen_sk_`
+- Must be at least 30 characters long
+
+If valid, proceed to **Step 4** with this config:
+
+```json
+{
+  "meigenApiToken": "<the token>"
+}
+```
+
+## Step 3B: ComfyUI (Local) Setup
+
+### 3B-1: Check Connection
+
+Ask the user for their ComfyUI server URL:
+
+> What is your ComfyUI server URL? (default: `http://localhost:8188`)
+
+Test the connection:
+
+```bash
+curl -s <URL>/system_stats | head -c 200
+```
+
+- **Success**: Show confirmation and continue to 3B-2
+- **Failure**: Tell the user:
+  > Cannot connect to ComfyUI at `<URL>`. Please make sure:
+  > 1. ComfyUI is running (start it with `python main.py` or your launcher)
+  > 2. The URL and port are correct
+  > 3. No firewall is blocking the connection
+
+### 3B-2: Import Workflow
+
+Explain the workflow export process to the user:
+
+> To use ComfyUI with this plugin, you need to export a workflow in **API format**:
+>
+> 1. Open ComfyUI in your browser (usually `http://localhost:8188`)
+> 2. Load or create your preferred workflow
+> 3. Click **⚙️ Settings** → enable **"Enable Dev mode options"**
+> 4. Click the **"Save (API Format)"** button that appears
+> 5. Save the downloaded `.json` file somewhere convenient
+
+Then ask them to provide the file path:
+
+> Please provide the path to your exported workflow JSON file:
+> Example: `~/Downloads/workflow_api.json`
+
+Use the `comfyui_workflow` tool with action `import` to import the workflow:
+
+- Ask for a short name for the workflow (e.g., "txt2img", "anime", "realistic")
+- Call: `comfyui_workflow import` with `filePath` and `name`
+- Show the detected nodes and parameters to the user for confirmation
+
+If the import succeeds, ask if they want to import additional workflows. If yes, repeat this step.
+
+### 3B-3: Save Configuration
+
+Build the config JSON:
+
+```json
+{
+  "comfyuiUrl": "<the URL, omit if http://localhost:8188>",
+  "comfyuiDefaultWorkflow": "<the first imported workflow name>"
+}
+```
+
+Proceed to **Step 4** to save. The workflow files are already saved by the import step.
+
+## Step 3C: Custom OpenAI-Compatible API Setup
+
+Collect the following information. Present common presets first for convenience:
+
+### Quick Presets
+
+| Service | Base URL | Default Model |
+|---------|----------|---------------|
+| **OpenAI** | `https://api.openai.com` (default) | `gpt-image-1` |
+| **Together AI** | `https://api.together.xyz/v1` | (check their docs) |
+| **Fireworks AI** | `https://api.fireworks.ai/inference/v1` | (check their docs) |
+
+Ask the user to either pick a preset or provide custom values.
+
+### Required Fields
+
+1. **API Key** (required): Their API key for the service
+   - Example: `sk-...` for OpenAI
+
+2. **Base URL** (optional): API endpoint URL
+   - Default: `https://api.openai.com`
+   - Only needed if using a non-OpenAI service
+
+3. **Model Name** (optional): Which model to use
+   - Default: `gpt-image-1`
+   - Different services use different model names
+
+### Optional: Test the connection
+
+After collecting the info, suggest testing with curl:
+
+```bash
+curl -s <BASE_URL>/v1/models \
+  -H "Authorization: Bearer <API_KEY>" | head -c 500
+```
+
+This helps catch invalid keys or wrong URLs before saving.
+
+Proceed to **Step 4** with config from the collected fields (see bottom of this section for format).
+
+Only include fields that differ from defaults. Omit `openaiBaseUrl` if it's `https://api.openai.com`, omit `openaiModel` if it's `gpt-image-1`.
+
+## Step 3D: Import from curl Example
+
+Ask the user to paste their curl command. Common formats they might paste:
+
+**Format 1: Image generation endpoint**
+```bash
+curl https://api.openai.com/v1/images/generations \
+  -H "Authorization: Bearer sk-xxx" \
+  -H "Content-Type: application/json" \
+  -d '{"model": "gpt-image-1", "prompt": "a cat", "n": 1, "size": "1024x1024"}'
+```
+
+**Format 2: Simple model list test**
+```bash
+curl https://api.together.xyz/v1/models \
+  -H "Authorization: Bearer xxx"
+```
+
+**Format 3: With -u flag or other auth styles**
+```bash
+curl -u :sk-xxx https://api.fireworks.ai/inference/v1/images/generations \
+  -d '{"model": "accounts/fireworks/models/flux", "prompt": "a cat"}'
+```
+
+### Parse the curl command and extract:
+
+1. **Base URL**: The URL hostname + base path (strip `/v1/images/generations`, `/v1/models`, etc.)
+   - `https://api.openai.com/v1/images/generations` → `https://api.openai.com`
+   - `https://api.together.xyz/v1/models` → `https://api.together.xyz/v1`
+   - If URL ends with `/v1/...`, keep the `/v1` part only if it's NOT `api.openai.com`
+
+2. **API Key**: From `Authorization: Bearer <key>` header, or `-u :<key>` flag, or `--header` variants
+
+3. **Model**: From the JSON request body `"model": "<value>"` if present
+
+### Show parsed results for confirmation:
+
+> I extracted the following from your curl command:
+> - **API Key**: `sk-xxx...` (first 10 chars)
+> - **Base URL**: `https://api.together.xyz/v1`
+> - **Model**: `black-forest-labs/FLUX.1-schnell`
+>
+> Does this look correct?
+
+If user confirms, proceed to **Step 4**. If not, let them correct individual fields.
+
+## Step 4: Save Configuration
+
+Build the config JSON based on the chosen provider:
+
+**For MeiGen:**
+```json
+{
+  "meigenApiToken": "<the token>"
+}
+```
+
+**For ComfyUI:**
+```json
+{
+  "comfyuiUrl": "<url, omit if default>",
+  "comfyuiDefaultWorkflow": "<workflow name>"
+}
+```
+
+**For OpenAI-compatible (manual or curl import):**
+```json
+{
+  "openaiApiKey": "<the key>",
+  "openaiBaseUrl": "<base url, omit if default>",
+  "openaiModel": "<model, omit if default>"
+}
+```
+
+Create the config directory and write the file:
+
+```bash
+mkdir -p ~/.config/meigen
+```
+
+Then use the Write tool to write the JSON config to `~/.config/meigen/config.json`.
+
+**Important**: If the user already has a config file with other providers configured, **merge** the new config into the existing one rather than overwriting. For example, a user might have both MeiGen and ComfyUI configured.
+
+After writing, set permissions:
+
+```bash
+chmod 600 ~/.config/meigen/config.json
+```
+
+## Step 5: Completion
+
+Tell the user:
+
+> Configuration saved! To activate the new settings, please **start a new Claude Code session** (close and reopen, or open a new terminal tab).
+>
+> After restarting, you can:
+> - Use `generate_image` to create AI images
+> - Run `list_models` to see available models and workflows
+> - Try: "Generate a beautiful sunset over mountains"
+>
+> You can run `/meigen:setup` again anytime to change your configuration.
+
+**For ComfyUI users**, additionally mention:
+
+> ComfyUI tips:
+> - Use `comfyui_workflow list` to see your saved workflows
+> - Use `comfyui_workflow view` to see adjustable parameters (steps, CFG, sampler, etc.)
+> - Ask me to change any workflow parameter — e.g., "increase steps to 30" or "switch sampler to dpmpp_2m"
+> - You can import more workflows anytime with `comfyui_workflow import`