n8n-nodes-comfyui-all 2.2.23 → 2.3.1

package/dist/nodes/ComfyUiTool.node.d.ts

@@ -0,0 +1,125 @@
+/**
+ * ComfyUI Tool - AI Agent-friendly image generation node
+ *
+ * This node is designed to be used as an AI Agent tool with minimal configuration.
+ * It accepts a simple text query and automatically generates images using ComfyUI.
+ */
+import { IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
+export declare class ComfyUiTool {
+    /**
+     * Node description for n8n
+     */
+    description: {
+        displayName: string;
+        name: string;
+        icon: string;
+        iconColor: string;
+        group: string[];
+        version: number[];
+        defaultVersion: number;
+        description: string;
+        defaults: {
+            name: string;
+        };
+        usableAsTool: boolean;
+        inputs: string[];
+        outputs: string[];
+        subtitle: string;
+        notes: string[];
+        inputSample: {
+            query: string;
+        };
+        outputSample: {
+            json: {
+                success: boolean;
+                imageCount: number;
+                imageUrls: string[];
+                prompt: string;
+                parameters: {
+                    width: number;
+                    height: number;
+                    steps: number;
+                    cfg: number;
+                    seed: number;
+                };
+            };
+            binary: {
+                data: {
+                    data: string;
+                    mimeType: string;
+                    fileName: string;
+                };
+            };
+        };
+        properties: ({
+            displayName: string;
+            name: string;
+            type: string;
+            required: boolean;
+            default: string;
+            description: string;
+            minValue?: undefined;
+            maxValue?: undefined;
+            placeholder?: undefined;
+            options?: undefined;
+        } | {
+            displayName: string;
+            name: string;
+            type: string;
+            default: number;
+            description: string;
+            minValue: number;
+            maxValue: number;
+            required?: undefined;
+            placeholder?: undefined;
+            options?: undefined;
+        } | {
+            displayName: string;
+            name: string;
+            type: string;
+            default: string;
+            description: string;
+            placeholder: string;
+            required?: undefined;
+            minValue?: undefined;
+            maxValue?: undefined;
+            options?: undefined;
+        } | {
+            displayName: string;
+            name: string;
+            type: string;
+            placeholder: string;
+            default: {};
+            options: ({
+                displayName: string;
+                name: string;
+                type: string;
+                typeOptions: {
+                    rows: number;
+                };
+                default: string;
+                description: string;
+                minValue?: undefined;
+                maxValue?: undefined;
+            } | {
+                displayName: string;
+                name: string;
+                type: string;
+                default: number;
+                description: string;
+                minValue: number;
+                maxValue: number;
+                typeOptions?: undefined;
+            })[];
+            required?: undefined;
+            description?: undefined;
+            minValue?: undefined;
+            maxValue?: undefined;
+        })[];
+    };
+    /**
+     * Execute function - called when the node runs
+     */
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}
+//# sourceMappingURL=ComfyUiTool.node.d.ts.map

package/dist/nodes/ComfyUiTool.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComfyUiTool.node.d.ts","sourceRoot":"","sources":["../../nodes/ComfyUiTool.node.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAEnB,MAAM,cAAc,CAAC;AAStB,qBAAa,WAAW;IACtB;;OAEG;IACH,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAyIT;IAEF;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;CAyIxE"}

package/dist/nodes/ComfyUiTool.node.js

@@ -0,0 +1,265 @@
+"use strict";
+/**
+ * ComfyUI Tool - AI Agent-friendly image generation node
+ *
+ * This node is designed to be used as an AI Agent tool with minimal configuration.
+ * It accepts a simple text query and automatically generates images using ComfyUI.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComfyUiTool = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const ComfyUiClient_1 = require("./ComfyUiClient");
+const validation_1 = require("./validation");
+const logger_1 = require("./logger");
+const agentToolHelpers_1 = require("./agentToolHelpers");
+const workflowConfig_1 = require("./workflowConfig");
+class ComfyUiTool {
+    constructor() {
+        /**
+         * Node description for n8n
+         */
+        this.description = {
+            displayName: 'ComfyUI Tool',
+            name: 'comfyUiTool',
+            icon: 'file:comfyui.svg',
+            iconColor: '#77C157',
+            group: ['transform'],
+            version: [1],
+            defaultVersion: 1,
+            description: 'AI-friendly image generation tool. Simply describe what you want to create.',
+            defaults: {
+                name: 'ComfyUI Tool',
+            },
+            usableAsTool: true,
+            inputs: ['main'],
+            outputs: ['main'],
+            subtitle: 'AI Image Generator',
+            notes: [
+                'Optimized for AI Agent usage',
+                'Automatically parses natural language queries',
+                'Supports size, steps, cfg, seed, and negative prompt parameters',
+                'Example: "A beautiful sunset, size:1024x768, steps:30"',
+            ],
+            inputSample: {
+                query: 'A beautiful landscape painting',
+            },
+            outputSample: {
+                json: {
+                    success: true,
+                    imageCount: 1,
+                    imageUrls: ['http://127.0.0.1:8188/view?filename=ComfyUI_00001.png'],
+                    prompt: 'A beautiful landscape painting',
+                    parameters: {
+                        width: 512,
+                        height: 512,
+                        steps: 20,
+                        cfg: 8,
+                        seed: 123456789,
+                    },
+                },
+                binary: {
+                    data: {
+                        data: 'base64_encoded_image_data',
+                        mimeType: 'image/png',
+                        fileName: 'ComfyUI_00001.png',
+                    },
+                },
+            },
+            properties: [
+                {
+                    displayName: 'ComfyUI URL',
+                    name: 'comfyUiUrl',
+                    type: 'string',
+                    required: true,
+                    default: 'http://127.0.0.1:8188',
+                    description: 'URL of ComfyUI server',
+                },
+                {
+                    displayName: 'Timeout (Seconds)',
+                    name: 'timeout',
+                    type: 'number',
+                    default: 120,
+                    description: 'Maximum time to wait for image generation (in seconds). Default: 120 (2 minutes).',
+                    minValue: 10,
+                    maxValue: 600,
+                },
+                {
+                    displayName: 'Output Binary Key',
+                    name: 'outputBinaryKey',
+                    type: 'string',
+                    default: 'data',
+                    description: 'Property name for the output binary data (e.g., "data", "image", "output")',
+                    placeholder: 'data',
+                },
+                {
+                    displayName: 'Default Negative Prompt',
+                    name: 'defaultNegativePrompt',
+                    type: 'string',
+                    default: 'ugly, blurry, low quality, distorted',
+                    description: 'Default negative prompt to use when not specified in query',
+                    placeholder: 'ugly, blurry, low quality',
+                },
+                {
+                    displayName: 'Advanced Options',
+                    name: 'advancedOptions',
+                    type: 'collection',
+                    placeholder: 'Add Option',
+                    default: {},
+                    options: [
+                        {
+                            displayName: 'Custom Workflow JSON',
+                            name: 'customWorkflow',
+                            type: 'string',
+                            typeOptions: {
+                                rows: 20,
+                            },
+                            default: '',
+                            description: 'Optional: Custom ComfyUI workflow JSON (API Format). If empty, uses default workflow. Only use this if you want to override the default template.',
+                        },
+                        {
+                            displayName: 'Default Width',
+                            name: 'defaultWidth',
+                            type: 'number',
+                            default: 512,
+                            description: 'Default image width when not specified in query',
+                            minValue: 64,
+                            maxValue: 4096,
+                        },
+                        {
+                            displayName: 'Default Height',
+                            name: 'defaultHeight',
+                            type: 'number',
+                            default: 512,
+                            description: 'Default image height when not specified in query',
+                            minValue: 64,
+                            maxValue: 4096,
+                        },
+                        {
+                            displayName: 'Default Steps',
+                            name: 'defaultSteps',
+                            type: 'number',
+                            default: 20,
+                            description: 'Default sampling steps when not specified in query',
+                            minValue: 1,
+                            maxValue: 150,
+                        },
+                        {
+                            displayName: 'Default CFG',
+                            name: 'defaultCfg',
+                            type: 'number',
+                            default: 8,
+                            description: 'Default CFG scale when not specified in query',
+                            minValue: 1,
+                            maxValue: 30,
+                        },
+                    ],
+                },
+            ],
+        };
+    }
+    /**
+     * Execute function - called when the node runs
+     */
+    async execute() {
+        const logger = (0, logger_1.createLogger)(this.logger);
+        // Get node parameters
+        const comfyUiUrl = this.getNodeParameter('comfyUiUrl', 0);
+        const timeout = this.getNodeParameter('timeout', 0);
+        const outputBinaryKey = this.getNodeParameter('outputBinaryKey', 0);
+        const defaultNegativePrompt = this.getNodeParameter('defaultNegativePrompt', 0);
+        const advancedOptions = this.getNodeParameter('advancedOptions', 0);
+        const { customWorkflow = '', defaultWidth = 512, defaultHeight = 512, defaultSteps = 20, defaultCfg = 8, } = advancedOptions || {};
+        // Validate URL
+        if (!(0, validation_1.validateUrl)(comfyUiUrl)) {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Invalid ComfyUI URL. Must be a valid HTTP/HTTPS URL.');
+        }
+        // Validate output binary key
+        (0, validation_1.validateOutputBinaryKey)(outputBinaryKey);
+        // Get input data
+        const inputData = this.getInputData();
+        if (!inputData || inputData.length === 0) {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'No input data provided. Please provide a query text.');
+        }
+        // Get query from input
+        const firstItem = inputData[0];
+        const query = firstItem.json.query ||
+            firstItem.json.text ||
+            firstItem.json.prompt ||
+            '';
+        if (!query || query.trim().length === 0) {
+            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'No query found in input. Please provide a "query", "text", or "prompt" field with a description of the image you want to generate.');
+        }
+        logger.info('Processing image generation request', { query, comfyUiUrl, timeout });
+        // Parse the query to extract parameters
+        const params = (0, agentToolHelpers_1.parseInput)(query, {
+            negativePrompt: defaultNegativePrompt,
+            width: defaultWidth,
+            height: defaultHeight,
+            steps: defaultSteps,
+            cfg: defaultCfg,
+        });
+        logger.debug('Parsed parameters', {
+            prompt: params.prompt,
+            width: params.width,
+            height: params.height,
+            steps: params.steps,
+            cfg: params.cfg,
+            seed: params.seed,
+        });
+        // Get workflow template
+        let workflowTemplate;
+        if (customWorkflow && customWorkflow.trim().length > 0) {
+            workflowTemplate = (0, validation_1.safeJsonParse)(customWorkflow, 'Custom workflow JSON');
+        }
+        else {
+            workflowTemplate = (0, workflowConfig_1.getWorkflowTemplate)();
+        }
+        // Update workflow with parsed parameters
+        const workflow = (0, agentToolHelpers_1.updateWorkflow)(workflowTemplate, params);
+        // Create ComfyUI client
+        const client = new ComfyUiClient_1.ComfyUIClient({
+            baseUrl: comfyUiUrl,
+            timeout: timeout * 1000,
+            helpers: this.helpers,
+            logger,
+        });
+        try {
+            logger.info('Starting ComfyUI workflow execution');
+            // Execute workflow
+            const result = await client.executeWorkflow(workflow);
+            if (!result.success) {
+                logger.error('Workflow execution failed', result.error);
+                throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Failed to generate image: ${result.error}`);
+            }
+            // Process results
+            const { json, binary } = await client.processResults(result, outputBinaryKey);
+            // Add metadata to JSON output
+            const enhancedJson = {
+                ...json,
+                prompt: params.prompt,
+                parameters: {
+                    width: params.width,
+                    height: params.height,
+                    steps: params.steps,
+                    cfg: params.cfg,
+                    seed: params.seed,
+                    negative_prompt: params.negative_prompt,
+                },
+            };
+            logger.info('Image generation completed successfully', {
+                imageCount: json.imageCount,
+            });
+            return [this.helpers.constructExecutionMetaData([{ json: enhancedJson, binary }], { itemData: { item: 0 } })];
+        }
+        catch (error) {
+            logger.error('Error during workflow execution', error);
+            throw error;
+        }
+        finally {
+            client.destroy();
+            logger.debug('Client destroyed');
+        }
+    }
+}
+exports.ComfyUiTool = ComfyUiTool;
+//# sourceMappingURL=ComfyUiTool.node.js.map

package/dist/nodes/ComfyUiTool.node.js.map

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

package/dist/nodes/agentToolHelpers.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Agent Tool Helpers - Utility functions for AI Agent-friendly ComfyUI nodes
+ *
+ * This file contains helper functions for parsing natural language queries
+ * and updating ComfyUI workflows, designed to be used by agent-friendly nodes.
+ */
+import type { INodeExecutionData } from 'n8n-workflow';
+import { Workflow, ParsedParameters, ParameterPattern, ParameterExtractionResult, BinaryData } from './types';
+export declare const DEFAULT_NEGATIVE_PROMPT = "ugly, blurry, low quality, distorted";
+export declare const DEFAULT_WIDTH = 512;
+export declare const DEFAULT_HEIGHT = 512;
+export declare const DEFAULT_STEPS = 20;
+export declare const DEFAULT_CFG = 8;
+export declare const MAX_SEED_VALUE = 2147483647;
+export declare const PARAM_PATTERNS: Record<string, ParameterPattern>;
+/**
+ * Extract parameter from query
+ * @param query - User query text
+ * @param pattern - Parameter pattern configuration
+ * @returns Extracted parameter and cleaned query
+ */
+export declare function extractParameter(query: string, pattern: ParameterPattern): ParameterExtractionResult;
+/**
+ * Parse user input to extract image generation parameters
+ * @param query - User query text
+ * @param defaults - Default parameter values
+ * @returns Parsed parameters object
+ */
+export declare function parseInput(query: string, defaults?: {
+    negativePrompt?: string;
+    width?: number;
+    height?: number;
+    steps?: number;
+    cfg?: number;
+}): ParsedParameters;
+/**
+ * Find node ID by node type
+ * @param workflow - Workflow object
+ * @param classType - Node type
+ * @returns Node ID or null
+ */
+export declare function findNodeByClassType(workflow: Workflow, classType: string): string | null;
+/**
+ * Update workflow parameters
+ * @param workflow - ComfyUI workflow object
+ * @param params - Parameters object
+ * @returns Updated workflow
+ */
+export declare function updateWorkflow(workflow: Workflow, params: ParsedParameters): Workflow;
+/**
+ * Update workflow with uploaded image filename
+ * @param workflow - ComfyUI workflow object
+ * @param imageFilename - Uploaded image filename
+ * @returns Updated workflow
+ */
+export declare function updateWorkflowWithImage(workflow: Workflow, imageFilename: string): Workflow;
+/**
+ * Extract binary data from input data
+ * @param inputData - Input data from n8n
+ * @param binaryKey - Binary property key (default: 'data')
+ * @returns Binary data or null
+ */
+export declare function extractBinaryData(inputData: INodeExecutionData[], binaryKey?: string): BinaryData | null;
+/**
+ * Check if input contains binary image data
+ * @param inputData - Input data from n8n
+ * @returns True if binary data is present
+ */
+export declare function hasBinaryData(inputData: INodeExecutionData[]): boolean;
+/**
+ * Get first binary key from input data
+ * @param inputData - Input data from n8n
+ * @returns First binary key or null
+ */
+export declare function getFirstBinaryKey(inputData: INodeExecutionData[]): string | null;
+/**
+ * Apply structured parameters to workflow
+ * Intelligently maps parameters to the correct nodes in the workflow
+ * @param workflow - ComfyUI workflow object
+ * @param params - Parameters object with parameter names and values
+ * @returns Updated workflow
+ */
+export declare function applyStructuredParameters(workflow: Workflow, params: Record<string, unknown>): Workflow;
+/**
+ * Apply parameters to a specific node in the workflow
+ * Used by ComfyUiTool when user has configured which node/parameters AI can modify
+ * @param workflow - ComfyUI workflow object
+ * @param nodeId - Target node ID
+ * @param params - Parameters to apply
+ * @returns Updated workflow
+ */
+export declare function applyParametersToNode(workflow: Workflow, nodeId: string, params: Record<string, unknown>): Workflow;
+//# sourceMappingURL=agentToolHelpers.d.ts.map

package/dist/nodes/agentToolHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentToolHelpers.d.ts","sourceRoot":"","sources":["../../nodes/agentToolHelpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,UAAU,EACX,MAAM,SAAS,CAAC;AAGjB,eAAO,MAAM,uBAAuB,yCAAyC,CAAC;AAC9E,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,WAAW,IAAI,CAAC;AAG7B,eAAO,MAAM,cAAc,aAAa,CAAC;AAGzC,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CA6B3D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,yBAAyB,CAUpG;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACT,GAAG,gBAAgB,CAmDxB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOxF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,GAAG,QAAQ,CAyCrF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAG,QAAQ,CAW3F;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,EAAE,EAAE,SAAS,GAAE,MAAe,GAAG,UAAU,GAAG,IAAI,CAWhH;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAatE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,MAAM,GAAG,IAAI,CAYhF;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CAmEvG;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CAiBnH"}