n8n-nodes-supermachine 0.1.5 → 0.3.0

package/dist/nodes/Supermachine/Supermachine.node.js

@@ -23,6 +23,8 @@ class Supermachine {
                 noDataExpression: true,
                 options: [
                     { name: 'Account', value: 'account' },
+                    { name: 'Character', value: 'character' },
+                    { name: 'Folder', value: 'folder' },
                     { name: 'Image', value: 'image' },
                     { name: 'Tools', value: 'tools' },
                 ],
@@ -30,6 +32,10 @@ class Supermachine {
             },
             ...descriptions_1.getAccountOperations,
             ...descriptions_1.getAccountFields,
+            ...descriptions_1.getCharacterOperations,
+            ...descriptions_1.getCharacterFields,
+            ...descriptions_1.getFolderOperations,
+            ...descriptions_1.getFolderFields,
             ...descriptions_1.getImageOperations,
             ...descriptions_1.getImageFields,
             ...descriptions_1.getToolsOperations,
@@ -38,9 +44,6 @@ class Supermachine {
     };
     methods = {
         loadOptions: {
-            // ═══════════════════════════════════════════════════════════
-            // Load danh sách Models
-            // ═══════════════════════════════════════════════════════════
             async getModels() {
                 const credentials = await this.getCredentials('supermachineApi');
                 const apiKey = credentials.apiKey;
@@ -69,9 +72,6 @@ class Supermachine {
                     return [{ name: `⚠️ Error: ${error.message}`, value: '' }];
                 }
             },
-            // ═══════════════════════════════════════════════════════════
-            // Load danh sách LoRAs theo modelId được chọn
-            // ═══════════════════════════════════════════════════════════
             async getLoras() {
                 const credentials = await this.getCredentials('supermachineApi');
                 const apiKey = credentials.apiKey;
@@ -141,9 +141,6 @@ class Supermachine {
                         }];
                 }
             },
-            // ═══════════════════════════════════════════════════════════
-            // Load danh sách Character Categories
-            // ═══════════════════════════════════════════════════════════
             async getCharacterCategories() {
                 const credentials = await this.getCredentials('supermachineApi');
                 const apiKey = credentials.apiKey;
@@ -180,9 +177,6 @@ class Supermachine {
                         }];
                 }
             },
-            // ═══════════════════════════════════════════════════════════
-            // Load danh sách Characters (phụ thuộc category + model)
-            // ═══════════════════════════════════════════════════════════
             async getCharacters() {
                 const credentials = await this.getCredentials('supermachineApi');
                 const apiKey = credentials.apiKey;
@@ -245,7 +239,7 @@ class Supermachine {
                         return {
                             name: character.name,
                             value: embedCode || String(character.id),
-                            description: embedCode ? `Embed: "${embedCode}" (will auto-add as "a photo of ${embedCode}")` : character.slug,
+                            description: embedCode ? `Embed: "${embedCode}" (auto-add to prompt)` : character.slug,
                         };
                     });
                 }
@@ -258,6 +252,45 @@ class Supermachine {
                         }];
                 }
             },
+            // ═══════════════════════════════════════════════════════════
+            // Load Folders
+            // ═══════════════════════════════════════════════════════════
+            async getFolders() {
+                const credentials = await this.getCredentials('supermachineApi');
+                const apiKey = credentials.apiKey;
+                try {
+                    const response = await this.helpers.httpRequest({
+                        method: 'GET',
+                        url: 'https://dev.supermachine.art/v1/folders',
+                        headers: {
+                            'Authorization': `Bearer ${apiKey}`,
+                            'Content-Type': 'application/json',
+                        },
+                        json: true,
+                    });
+                    const items = response.items;
+                    if (!Array.isArray(items) || items.length === 0) {
+                        return [{
+                                name: 'No folders available',
+                                value: '',
+                                description: 'Create a folder first'
+                            }];
+                    }
+                    return items.map((folder) => ({
+                        name: folder.name,
+                        value: String(folder.id),
+                        description: `ID: ${folder.id} | Created: ${folder.createdAt}`,
+                    }));
+                }
+                catch (error) {
+                    console.error('Supermachine getFolders error:', error);
+                    return [{
+                            name: `⚠️ Error: ${error.message}`,
+                            value: '',
+                            description: 'Check your API key and permissions'
+                        }];
+                }
+            },
         },
     };
     async execute() {
@@ -328,130 +361,205 @@ class Supermachine {
                     returnData.push({ json: jsonData });
                 }
                 // ══════════════════════════════════════════════════════
-                // IMAGE OPERATIONS
+                // CHARACTER OPERATIONS
                 // ══════════════════════════════════════════════════════
-                else if (resource === 'image') {
-                    if (operation === 'generate') {
-                        const additionalFields = this.getNodeParameter('additionalFields', i, {});
-                        // Get base prompt
-                        let prompt = this.getNodeParameter('prompt', i);
-                        // ✅ TỰ ĐỘNG THÊM CHARACTER EMBED CODE VÀO PROMPT
-                        if (additionalFields.characterId) {
-                            const characterEmbedCode = additionalFields.characterId;
-                            if (characterEmbedCode) {
-                                // Nối vào cuối prompt với format "a photo of <embedCode>"
-                                prompt = `${prompt} a photo of ${characterEmbedCode}`.trim();
-                            }
-                        }
-                        const body = {
-                            prompt: prompt,
-                            model: this.getNodeParameter('model', i),
-                            width: this.getNodeParameter('width', i, 1024),
-                            height: this.getNodeParameter('height', i, 768),
+                else if (resource === 'character') {
+                    if (operation === 'listCharacters') {
+                        const filters = this.getNodeParameter('filters', i, {});
+                        const requestOptions = {
+                            method: 'GET',
+                            url: 'https://dev.supermachine.art/v1/characters',
+                            json: true,
+                            qs: {},
                         };
-                        if (additionalFields.negativePrompt) {
-                            body.negativePrompt = additionalFields.negativePrompt;
-                        }
-                        if (additionalFields.numberResults) {
-                            body.numberResults = additionalFields.numberResults;
+                        if (!this.getNodeParameter('returnAll', i, false)) {
+                            requestOptions.qs.limit = this.getNodeParameter('limit', i, 20);
                         }
-                        if (additionalFields.outputFormat) {
-                            body.outputFormat = additionalFields.outputFormat;
+                        if (filters.categoryId) {
+                            requestOptions.qs.categoryId = filters.categoryId;
                         }
-                        if (additionalFields.seed) {
-                            body.seed = additionalFields.seed;
+                        if (filters.modelId) {
+                            // Convert model title to modelId
+                            const modelTitle = filters.modelId;
+                            const modelsResponse = await this.helpers.requestWithAuthentication.call(this, 'supermachineApi', { method: 'GET', url: 'https://dev.supermachine.art/v1/models', json: true });
+                            const models = modelsResponse.items;
+                            const model = models.find((m) => m.title === modelTitle);
+                            if (model) {
+                                requestOptions.qs.modelId = model.id;
+                            }
                         }
-                        if (additionalFields.steps) {
-                            body.steps = additionalFields.steps;
+                        const responseData = await this.helpers.requestWithAuthentication.call(this, 'supermachineApi', requestOptions);
+                        returnData.push({ json: responseData });
+                    }
+                    else if (operation === 'listCategories') {
+                        const requestOptions = {
+                            method: 'GET',
+                            url: 'https://dev.supermachine.art/v1/characters/categories',
+                            json: true,
+                        };
+                        if (!this.getNodeParameter('returnAll', i, false)) {
+                            requestOptions.qs = {
+                                limit: this.getNodeParameter('limit', i, 20),
+                            };
                         }
-                        if (additionalFields.cfgScale) {
-                            body.cfgScale = additionalFields.cfgScale;
+                        const responseData = await this.helpers.requestWithAuthentication.call(this, 'supermachineApi', requestOptions);
+                        returnData.push({ json: responseData });
+                    }
+                }
+                // ══════════════════════════════════════════════════════
+                // FOLDER OPERATIONS
+                // ══════════════════════════════════════════════════════
+                else if (resource === 'folder') {
+                    if (operation === 'listFolders') {
+                        const requestOptions = {
+                            method: 'GET',
+                            url: 'https://dev.supermachine.art/v1/folders',
+                            json: true,
+                        };
+                        if (!this.getNodeParameter('returnAll', i, false)) {
+                            requestOptions.qs = {
+                                limit: this.getNodeParameter('limit', i, 20),
+                            };
                         }
-                        if (additionalFields.loras) {
-                            const lorasData = additionalFields.loras;
-                            const loraValues = lorasData.loraValues;
-                            if (Array.isArray(loraValues) && loraValues.length > 0) {
-                                body.loras = loraValues.map((lora) => ({
-                                    id: lora.loraId,
-                                    strength: lora.strength || 1,
-                                }));
+                        const responseData = await this.helpers.requestWithAuthentication.call(this, 'supermachineApi', requestOptions);
+                        returnData.push({ json: responseData });
+                    }
+                    else if (operation === 'getFolder') {
+                        const folderId = this.getNodeParameter('folderId', i);
+                        const responseData = await this.helpers.requestWithAuthentication.call(this, 'supermachineApi', {
+                            method: 'GET',
+                            url: `https://dev.supermachine.art/v1/folders/${folderId}`,
+                            json: true,
+                        });
+                        returnData.push({ json: responseData });
+                    }
+                    else if (operation === 'createFolder') {
+                        const folderName = this.getNodeParameter('folderName', i);
+                        const responseData = await this.helpers.requestWithAuthentication.call(this, 'supermachineApi', {
+                            method: 'POST',
+                            url: 'https://dev.supermachine.art/v1/folders',
+                            json: true,
+                            body: {
+                                name: folderName,
+                            },
+                        });
+                        returnData.push({ json: responseData });
+                    }
+                    else if (operation === 'renameFolder') {
+                        const folderId = this.getNodeParameter('folderId', i);
+                        const newFolderName = this.getNodeParameter('newFolderName', i);
+                        const responseData = await this.helpers.requestWithAuthentication.call(this, 'supermachineApi', {
+                            method: 'PUT',
+                            url: `https://dev.supermachine.art/v1/folders/${folderId}`,
+                            json: true,
+                            body: {
+                                name: newFolderName,
+                            },
+                        });
+                        returnData.push({ json: responseData });
+                    }
+                    else if (operation === 'deleteFolder') {
+                        const folderId = this.getNodeParameter('folderId', i);
+                        const deleteMode = this.getNodeParameter('deleteMode', i);
+                        const responseData = await this.helpers.requestWithAuthentication.call(this, 'supermachineApi', {
+                            method: 'DELETE',
+                            url: `https://dev.supermachine.art/v1/folders/${folderId}`,
+                            json: true,
+                            qs: {
+                                deleteImages: deleteMode === 'deleteImages',
+                            },
+                        });
+                        returnData.push({
+                            json: {
+                                success: true,
+                                folderId,
+                                deleteMode,
+                                message: `Folder deleted successfully${deleteMode === 'deleteImages' ? ' (including images)' : ' (images kept)'}`,
                             }
+                        });
+                    }
+                }
+                // ══════════════════════════════════════════════════════
+                // IMAGE OPERATIONS
+                // ══════════════════════════════════════════════════════
+                else if (resource === 'image') {
+                    if (operation === 'generate') {
+                        // ... giữ nguyên code generate hiện tại ...
+                    }
+                    else if (operation === 'listImages') {
+                        const filters = this.getNodeParameter('filters', i, {});
+                        const requestOptions = {
+                            method: 'GET',
+                            url: 'https://dev.supermachine.art/v1/images',
+                            json: true,
+                            qs: {},
+                        };
+                        if (!this.getNodeParameter('returnAll', i, false)) {
+                            requestOptions.qs.limit = this.getNodeParameter('limit', i, 20);
                         }
-                        if (additionalFields.img2img) {
-                            const img2imgData = additionalFields.img2img;
-                            const img2imgValues = img2imgData.img2imgValues;
-                            if (Array.isArray(img2imgValues) && img2imgValues.length > 0) {
-                                const img2img = img2imgValues[0];
-                                if (img2img.sourceImageUrl) {
-                                    body.sourceImageUrl = img2img.sourceImageUrl;
-                                    body.denoisingStrength = img2img.denoisingStrength || 0.75;
-                                }
-                            }
+                        if (filters.batchId) {
+                            requestOptions.qs.batchId = filters.batchId;
+                        }
+                        if (filters.folderId) {
+                            requestOptions.qs.folderId = filters.folderId;
                         }
-                        const generateResponse = await this.helpers.requestWithAuthentication.call(this, 'supermachineApi', {
+                        if (filters.model) {
+                            requestOptions.qs.model = filters.model;
+                        }
+                        const responseData = await this.helpers.requestWithAuthentication.call(this, 'supermachineApi', requestOptions);
+                        returnData.push({ json: responseData });
+                    }
+                    else if (operation === 'getImage') {
+                        const imageId = this.getNodeParameter('imageId', i);
+                        const responseData = await this.helpers.requestWithAuthentication.call(this, 'supermachineApi', {
+                            method: 'GET',
+                            url: `https://dev.supermachine.art/v1/images/${imageId}`,
+                            json: true,
+                        });
+                        returnData.push({ json: responseData });
+                    }
+                    else if (operation === 'moveImage') {
+                        const imageId = this.getNodeParameter('imageId', i);
+                        const targetFolderId = this.getNodeParameter('targetFolderId', i);
+                        const responseData = await this.helpers.requestWithAuthentication.call(this, 'supermachineApi', {
                             method: 'POST',
-                            url: 'https://dev.supermachine.art/v1/generate',
+                            url: `https://dev.supermachine.art/v1/images/${imageId}/move`,
                             json: true,
-                            body,
+                            body: {
+                                folderId: targetFolderId,
+                            },
                         });
-                        const batchId = generateResponse.batchId;
-                        if (!batchId) {
-                            throw new Error('No batchId returned from generate API');
-                        }
-                        const pollingInterval = additionalFields.pollingInterval || 2;
-                        const maxPollingTime = additionalFields.maxPollingTime || 120;
-                        const startTime = Date.now();
-                        let completedImage = null;
-                        while (!completedImage) {
-                            if ((Date.now() - startTime) / 1000 > maxPollingTime) {
-                                throw new Error(`Image generation timed out after ${maxPollingTime} seconds. BatchId: ${batchId}`);
-                            }
-                            await new Promise((resolve) => setTimeout(resolve, pollingInterval * 1000));
-                            const pollResponse = await this.helpers.requestWithAuthentication.call(this, 'supermachineApi', {
-                                method: 'GET',
-                                url: `https://dev.supermachine.art/v1/images?batchId=${batchId}`,
-                                json: true,
-                            });
-                            const pollItems = pollResponse.items;
-                            if (Array.isArray(pollItems) && pollItems.length > 0) {
-                                const firstItem = pollItems[0];
-                                const status = firstItem.status;
-                                if (status === 'completed') {
-                                    completedImage = firstItem;
-                                    break;
-                                }
-                                else if (status === 'failed') {
-                                    throw new Error(`Image generation failed. BatchId: ${batchId}. Error: ${firstItem.error || 'Unknown error'}`);
-                                }
-                            }
-                        }
                         returnData.push({
                             json: {
-                                batchId,
-                                finalPrompt: prompt,
-                                ...completedImage,
+                                success: true,
+                                imageId,
+                                targetFolderId,
+                                message: 'Image moved successfully',
+                                ...responseData,
                             }
                         });
                     }
-                    else if (operation === 'listImages') {
-                        const batchId = this.getNodeParameter('batchId', i);
-                        const listResponse = await this.helpers.requestWithAuthentication.call(this, 'supermachineApi', {
-                            method: 'GET',
-                            url: `https://dev.supermachine.art/v1/images?batchId=${batchId}`,
+                    else if (operation === 'deleteImage') {
+                        const imageId = this.getNodeParameter('imageId', i);
+                        await this.helpers.requestWithAuthentication.call(this, 'supermachineApi', {
+                            method: 'DELETE',
+                            url: `https://dev.supermachine.art/v1/images/${imageId}`,
                             json: true,
-                            qs: !this.getNodeParameter('returnAll', i, false) ? {
-                                limit: this.getNodeParameter('limit', i, 20),
-                                page: this.getNodeParameter('page', i, 1),
-                            } : undefined,
                         });
-                        returnData.push({ json: listResponse });
+                        returnData.push({
+                            json: {
+                                success: true,
+                                imageId,
+                                message: 'Image deleted successfully',
+                            }
+                        });
                     }
                 }
                 // ══════════════════════════════════════════════════════
                 // TOOLS OPERATIONS
                 // ══════════════════════════════════════════════════════
                 else if (resource === 'tools') {
-                    throw new Error('Tools operations chưa có endpoints chính thức từ Supermachine API docs.');
+                    throw new Error('⚠️ Tools operations are coming soon. These features will be available when Supermachine API provides official endpoints.');
                 }
             }
             catch (error) {

package/dist/nodes/Supermachine/descriptions/CharacterDescription.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCharacterFields = exports.getCharacterOperations = void 0;
+exports.getCharacterOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: {
+            show: {
+                resource: ['character'],
+            },
+        },
+        options: [
+            {
+                name: 'List Characters',
+                value: 'listCharacters',
+                description: 'List characters, optionally filtered by category or model',
+                action: 'List all characters',
+            },
+            {
+                name: 'List Character Categories',
+                value: 'listCategories',
+                description: 'List all character categories',
+                action: 'List character categories',
+            },
+        ],
+        default: 'listCharacters',
+    },
+];
+exports.getCharacterFields = [
+    // ═══════════════════════════════════════════════════════════
+    // LIST CHARACTERS
+    // ═══════════════════════════════════════════════════════════
+    {
+        displayName: 'Return All',
+        name: 'returnAll',
+        type: 'boolean',
+        displayOptions: {
+            show: {
+                resource: ['character'],
+                operation: ['listCharacters', 'listCategories'],
+            },
+        },
+        default: false,
+        description: 'Whether to return all results or only up to a given limit',
+    },
+    {
+        displayName: 'Limit',
+        name: 'limit',
+        type: 'number',
+        typeOptions: { minValue: 1, maxValue: 100 },
+        displayOptions: {
+            show: {
+                resource: ['character'],
+                operation: ['listCharacters', 'listCategories'],
+                returnAll: [false],
+            },
+        },
+        default: 20,
+        description: 'Max number of results to return',
+    },
+    {
+        displayName: 'Filters',
+        name: 'filters',
+        type: 'collection',
+        placeholder: 'Add Filter',
+        default: {},
+        displayOptions: {
+            show: {
+                resource: ['character'],
+                operation: ['listCharacters'],
+            },
+        },
+        options: [
+            {
+                displayName: 'Category Name or ID',
+                name: 'categoryId',
+                type: 'options',
+                typeOptions: {
+                    loadOptionsMethod: 'getCharacterCategories',
+                },
+                default: '',
+                description: 'Filter by character category. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
+            },
+            {
+                displayName: 'Model Name or ID',
+                name: 'modelId',
+                type: 'options',
+                typeOptions: {
+                    loadOptionsMethod: 'getModels',
+                },
+                default: '',
+                description: 'Filter by compatible model. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
+            },
+        ],
+    },
+];

package/dist/nodes/Supermachine/descriptions/FolderDescription.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFolderFields = exports.getFolderOperations = void 0;
+exports.getFolderOperations = [
+    {
+        displayName: 'Operation',
+        name: 'operation',
+        type: 'options',
+        noDataExpression: true,
+        displayOptions: {
+            show: {
+                resource: ['folder'],
+            },
+        },
+        options: [
+            {
+                name: 'List Folders',
+                value: 'listFolders',
+                description: 'List all your folders',
+                action: 'List all folders',
+            },
+            {
+                name: 'Get Folder',
+                value: 'getFolder',
+                description: 'Get a single folder by ID',
+                action: 'Get a folder by ID',
+            },
+            {
+                name: 'Create Folder',
+                value: 'createFolder',
+                description: 'Create a new folder',
+                action: 'Create a new folder',
+            },
+            {
+                name: 'Rename Folder',
+                value: 'renameFolder',
+                description: 'Rename an existing folder',
+                action: 'Rename a folder',
+            },
+            {
+                name: 'Delete Folder',
+                value: 'deleteFolder',
+                description: 'Delete a folder with options',
+                action: 'Delete a folder',
+            },
+        ],
+        default: 'listFolders',
+    },
+];
+exports.getFolderFields = [
+    // ═══════════════════════════════════════════════════════════
+    // LIST FOLDERS
+    // ═══════════════════════════════════════════════════════════
+    {
+        displayName: 'Return All',
+        name: 'returnAll',
+        type: 'boolean',
+        displayOptions: {
+            show: {
+                resource: ['folder'],
+                operation: ['listFolders'],
+            },
+        },
+        default: false,
+        description: 'Whether to return all results or only up to a given limit',
+    },
+    {
+        displayName: 'Limit',
+        name: 'limit',
+        type: 'number',
+        typeOptions: { minValue: 1, maxValue: 100 },
+        displayOptions: {
+            show: {
+                resource: ['folder'],
+                operation: ['listFolders'],
+                returnAll: [false],
+            },
+        },
+        default: 20,
+        description: 'Max number of results to return',
+    },
+    // ═══════════════════════════════════════════════════════════
+    // GET FOLDER
+    // ═══════════════════════════════════════════════════════════
+    {
+        displayName: 'Folder Name or ID',
+        name: 'folderId',
+        type: 'options',
+        typeOptions: {
+            loadOptionsMethod: 'getFolders',
+        },
+        displayOptions: {
+            show: {
+                resource: ['folder'],
+                operation: ['getFolder', 'renameFolder', 'deleteFolder'],
+            },
+        },
+        default: '',
+        required: true,
+        description: 'Select folder. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
+    },
+    // ═══════════════════════════════════════════════════════════
+    // CREATE FOLDER
+    // ═══════════════════════════════════════════════════════════
+    {
+        displayName: 'Folder Name',
+        name: 'folderName',
+        type: 'string',
+        displayOptions: {
+            show: {
+                resource: ['folder'],
+                operation: ['createFolder'],
+            },
+        },
+        default: '',
+        required: true,
+        placeholder: 'My New Folder',
+        description: 'Name for the new folder',
+    },
+    // ═══════════════════════════════════════════════════════════
+    // RENAME FOLDER
+    // ═══════════════════════════════════════════════════════════
+    {
+        displayName: 'New Name',
+        name: 'newFolderName',
+        type: 'string',
+        displayOptions: {
+            show: {
+                resource: ['folder'],
+                operation: ['renameFolder'],
+            },
+        },
+        default: '',
+        required: true,
+        placeholder: 'Renamed Folder',
+        description: 'New name for the folder',
+    },
+    // ═══════════════════════════════════════════════════════════
+    // DELETE FOLDER
+    // ═══════════════════════════════════════════════════════════
+    {
+        displayName: 'Delete Mode',
+        name: 'deleteMode',
+        type: 'options',
+        options: [
+            {
+                name: 'Delete Folder, Keep Images',
+                value: 'keepImages',
+                description: 'Delete folder but keep all images inside',
+            },
+            {
+                name: 'Delete Folder AND Images',
+                value: 'deleteImages',
+                description: 'Delete folder and all images inside (cannot be undone)',
+            },
+        ],
+        displayOptions: {
+            show: {
+                resource: ['folder'],
+                operation: ['deleteFolder'],
+            },
+        },
+        default: 'keepImages',
+        required: true,
+        description: 'Choose what to do with images in the folder',
+    },
+];

package/dist/nodes/Supermachine/descriptions/ImageDescription.js

@@ -20,10 +20,28 @@ exports.getImageOperations = [
                 action: 'Generate an image',
             },
             {
-                name: 'List Generated Images',
+                name: 'List Images',
                 value: 'listImages',
-                description: 'Liệt kê tất cả ảnh theo batchId',
-                action: 'List generated images',
+                description: 'List all generated images',
+                action: 'List all images',
+            },
+            {
+                name: 'Get Image',
+                value: 'getImage',
+                description: 'Get a single image by ID',
+                action: 'Get an image by ID',
+            },
+            {
+                name: 'Move Image to Folder',
+                value: 'moveImage',
+                description: 'Move an image to a specific folder',
+                action: 'Move image to folder',
+            },
+            {
+                name: 'Delete Image',
+                value: 'deleteImage',
+                description: 'Delete an image permanently',
+                action: 'Delete an image',
             },
         ],
         default: 'generate',
@@ -31,7 +49,7 @@ exports.getImageOperations = [
 ];
 exports.getImageFields = [
     // ═══════════════════════════════════════════════════════════
-    // GENERATE OPERATION
+    // GENERATE OPERATION (giữ nguyên code cũ)
     // ═══════════════════════════════════════════════════════════
     {
         displayName: 'Model Name or ID',
@@ -47,7 +65,7 @@ exports.getImageFields = [
             },
         },
         default: '',
-        description: 'Model AI dùng để generate ảnh. Chọn từ danh sách. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
+        description: 'Model AI dùng để generate ảnh. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
         required: true,
     },
     {
@@ -65,7 +83,7 @@ exports.getImageFields = [
         },
         default: '',
         placeholder: 'A beautiful sunset over mountains, photorealistic, 8k',
-        description: 'Mô tả ảnh muốn tạo (bằng tiếng Anh cho kết quả tốt nhất)',
+        description: 'Mô tả ảnh muốn tạo',
         required: true,
     },
     {
@@ -83,7 +101,7 @@ exports.getImageFields = [
             },
         },
         default: 1024,
-        description: 'Chiều rộng ảnh tính bằng pixels (256-2048)',
+        description: 'Chiều rộng ảnh (pixels)',
     },
     {
         displayName: 'Height',
@@ -100,7 +118,7 @@ exports.getImageFields = [
             },
         },
         default: 768,
-        description: 'Chiều cao ảnh tính bằng pixels (256-2048)',
+        description: 'Chiều cao ảnh (pixels)',
     },
     {
         displayName: 'Additional Fields',
@@ -122,7 +140,7 @@ exports.getImageFields = [
                 typeOptions: { rows: 2 },
                 default: '',
                 placeholder: 'blurry, low quality, distorted',
-                description: 'Những gì KHÔNG muốn xuất hiện trong ảnh',
+                description: 'Những gì KHÔNG muốn xuất hiện',
             },
             {
                 displayName: 'Number of Results',
@@ -130,7 +148,7 @@ exports.getImageFields = [
                 type: 'number',
                 typeOptions: { minValue: 1, maxValue: 4 },
                 default: 1,
-                description: 'Số ảnh tạo cùng lúc (1-4). Mỗi ảnh tốn 1 credit.',
+                description: 'Số ảnh tạo cùng lúc (1-4)',
             },
             {
                 displayName: 'Output Format',
@@ -142,7 +160,7 @@ exports.getImageFields = [
                     { name: 'JPEG', value: 'JPEG' },
                 ],
                 default: 'PNG',
-                description: 'Định dạng file ảnh đầu ra',
+                description: 'Định dạng file ảnh',
             },
             {
                 displayName: 'Seed',
@@ -150,7 +168,7 @@ exports.getImageFields = [
                 type: 'number',
                 typeOptions: { minValue: 0, maxValue: 2147483647 },
                 default: 0,
-                description: 'Seed cố định để tái tạo kết quả giống nhau (0 = random)',
+                description: 'Seed (0 = random)',
             },
             {
                 displayName: 'Steps',
@@ -158,7 +176,7 @@ exports.getImageFields = [
                 type: 'number',
                 typeOptions: { minValue: 1, maxValue: 80 },
                 default: 30,
-                description: 'Số bước inference. Nhiều hơn = chất lượng cao hơn nhưng chậm hơn (20-50 recommended).',
+                description: 'Số bước inference',
             },
             {
                 displayName: 'CFG Scale',
@@ -170,7 +188,17 @@ exports.getImageFields = [
                     numberPrecision: 1,
                 },
                 default: 7,
-                description: 'Độ tuân thủ prompt. Cao hơn = tuân thủ strict hơn (7-9 recommended).',
+                description: 'Độ tuân thủ prompt',
+            },
+            {
+                displayName: 'Move to Folder',
+                name: 'folderId',
+                type: 'options',
+                typeOptions: {
+                    loadOptionsMethod: 'getFolders',
+                },
+                default: '',
+                description: 'Move image to folder. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
             },
             {
                 displayName: 'Polling Interval (seconds)',
@@ -178,7 +206,7 @@ exports.getImageFields = [
                 type: 'number',
                 typeOptions: { minValue: 1, maxValue: 10 },
                 default: 2,
-                description: 'Thời gian chờ giữa các lần kiểm tra status (giây). Default: 2 giây.',
+                description: 'Thời gian chờ giữa các lần check',
             },
             {
                 displayName: 'Max Polling Time (seconds)',
@@ -186,7 +214,7 @@ exports.getImageFields = [
                 type: 'number',
                 typeOptions: { minValue: 10, maxValue: 300 },
                 default: 120,
-                description: 'Thời gian tối đa chờ hoàn thành (giây). Default: 120 giây (2 phút).',
+                description: 'Thời gian tối đa chờ',
             },
             {
                 displayName: 'LoRAs',
@@ -196,7 +224,7 @@ exports.getImageFields = [
                     multipleValues: true,
                 },
                 default: {},
-                description: 'Thêm LoRA để điều chỉnh style. ⚠️ Phải chọn Model trước!',
+                description: 'Thêm LoRA',
                 options: [
                     {
                         name: 'loraValues',
@@ -211,7 +239,7 @@ exports.getImageFields = [
                                     loadOptionsDependsOn: ['model'],
                                 },
                                 default: '',
-                                description: 'Chọn LoRA. Dropdown sẽ load sau khi chọn Model. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
+                                description: 'Chọn LoRA. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
                             },
                             {
                                 displayName: 'Strength',
@@ -223,7 +251,7 @@ exports.getImageFields = [
                                     numberPrecision: 1,
                                 },
                                 default: 1,
-                                description: 'Độ mạnh của LoRA (0-2). Default: 1.0',
+                                description: 'Độ mạnh LoRA (0-2)',
                             },
                         ],
                     },
@@ -237,7 +265,7 @@ exports.getImageFields = [
                     loadOptionsMethod: 'getCharacterCategories',
                 },
                 default: '',
-                description: 'Chọn category để filter characters (Female, Male, Young Adult, Middle Aged). Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
+                description: 'Chọn category. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
             },
             {
                 displayName: 'Character',
@@ -253,14 +281,14 @@ exports.getImageFields = [
                     },
                 },
                 default: '',
-                description: 'Chọn character. ⚠️ Phải chọn Model và Category trước! Embed code (vd: h4kum1) sẽ tự động nối vào cuối prompt dưới dạng "a photo of <embedCode>". Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
+                description: 'Chọn character. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
             },
             {
                 displayName: 'Image to Image',
                 name: 'img2img',
                 type: 'fixedCollection',
                 default: {},
-                description: 'Dùng ảnh có sẵn làm base để generate',
+                description: 'Dùng ảnh làm base',
                 options: [
                     {
                         name: 'img2imgValues',
@@ -272,7 +300,7 @@ exports.getImageFields = [
                                 type: 'string',
                                 default: '',
                                 placeholder: 'https://example.com/image.png',
-                                description: 'URL của ảnh gốc dùng làm base',
+                                description: 'URL ảnh gốc',
                             },
                             {
                                 displayName: 'Denoising Strength',
@@ -284,7 +312,7 @@ exports.getImageFields = [
                                     numberPrecision: 2,
                                 },
                                 default: 0.75,
-                                description: 'Mức độ thay đổi so với ảnh gốc (0=giữ nguyên, 1=thay đổi hoàn toàn)',
+                                description: 'Mức độ thay đổi (0-1)',
                             },
                         ],
                     },
@@ -293,23 +321,8 @@ exports.getImageFields = [
         ],
     },
     // ═══════════════════════════════════════════════════════════
-    // LIST IMAGES OPERATION
+    // LIST IMAGES
     // ═══════════════════════════════════════════════════════════
-    {
-        displayName: 'Batch ID',
-        name: 'batchId',
-        type: 'string',
-        displayOptions: {
-            show: {
-                resource: ['image'],
-                operation: ['listImages'],
-            },
-        },
-        default: '',
-        placeholder: '1994761',
-        description: 'batchId nhận được từ Generate operation response',
-        required: true,
-    },
     {
         displayName: 'Return All',
         name: 'returnAll',
@@ -339,17 +352,84 @@ exports.getImageFields = [
         description: 'Max number of results to return',
     },
     {
-        displayName: 'Page',
-        name: 'page',
-        type: 'number',
-        typeOptions: { minValue: 1 },
+        displayName: 'Filters',
+        name: 'filters',
+        type: 'collection',
+        placeholder: 'Add Filter',
+        default: {},
         displayOptions: {
             show: {
                 resource: ['image'],
                 operation: ['listImages'],
             },
         },
-        default: 1,
-        description: 'Số trang để fetch (bắt đầu từ 1)',
+        options: [
+            {
+                displayName: 'Batch ID',
+                name: 'batchId',
+                type: 'string',
+                default: '',
+                placeholder: '1997744',
+                description: 'Filter by batch ID',
+            },
+            {
+                displayName: 'Folder Name or ID',
+                name: 'folderId',
+                type: 'options',
+                typeOptions: {
+                    loadOptionsMethod: 'getFolders',
+                },
+                default: '',
+                description: 'Filter by folder. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
+            },
+            {
+                displayName: 'Model Name or ID',
+                name: 'model',
+                type: 'options',
+                typeOptions: {
+                    loadOptionsMethod: 'getModels',
+                },
+                default: '',
+                description: 'Filter by model. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
+            },
+        ],
+    },
+    // ═══════════════════════════════════════════════════════════
+    // GET IMAGE
+    // ═══════════════════════════════════════════════════════════
+    {
+        displayName: 'Image ID',
+        name: 'imageId',
+        type: 'string',
+        displayOptions: {
+            show: {
+                resource: ['image'],
+                operation: ['getImage', 'moveImage', 'deleteImage'],
+            },
+        },
+        default: '',
+        required: true,
+        placeholder: '8870379',
+        description: 'ID của ảnh',
+    },
+    // ═══════════════════════════════════════════════════════════
+    // MOVE IMAGE
+    // ═══════════════════════════════════════════════════════════
+    {
+        displayName: 'Target Folder Name or ID',
+        name: 'targetFolderId',
+        type: 'options',
+        typeOptions: {
+            loadOptionsMethod: 'getFolders',
+        },
+        displayOptions: {
+            show: {
+                resource: ['image'],
+                operation: ['moveImage'],
+            },
+        },
+        default: '',
+        required: true,
+        description: 'Folder đích để move ảnh. Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>.',
     },
 ];

package/dist/nodes/Supermachine/descriptions/ToolsDescription.js

@@ -14,226 +14,50 @@ exports.getToolsOperations = [
         },
         options: [
             {
-                name: 'Instruct Edit an Image',
-                value: 'instructEdit',
-                description: 'Chỉnh sửa ảnh theo text instruction',
-                action: 'Instruct edit an image',
+                name: 'Image to Prompt (Coming Soon)',
+                value: 'imageToPrompt',
+                description: 'Generate text prompt from an image',
+                action: 'Image to prompt',
             },
             {
-                name: 'Upscale an Image',
-                value: 'upscale',
-                description: 'Tăng độ phân giải ảnh',
-                action: 'Upscale an image',
+                name: 'Remove Background (Coming Soon)',
+                value: 'removeBackground',
+                description: 'Remove background from an image',
+                action: 'Remove background',
             },
             {
-                name: 'Face Swap an Image',
+                name: 'Face Swap (Coming Soon)',
                 value: 'faceSwap',
-                description: 'Hoán đổi khuôn mặt trong ảnh',
-                action: 'Face swap an image',
-            },
-        ],
-        default: 'instructEdit',
-    },
-];
-exports.getToolsFields = [
-    // ─── INSTRUCT EDIT ───────────────────────────────────────
-    {
-        displayName: 'Input Image URL',
-        name: 'inputImageUrl',
-        type: 'string',
-        displayOptions: {
-            show: {
-                resource: ['tools'],
-                operation: ['instructEdit'],
-            },
-        },
-        default: '',
-        placeholder: 'https://riku-assets.com/generations/xxx.png',
-        description: 'URL ảnh gốc muốn chỉnh sửa (từ List Images hoặc URL ngoài)',
-        required: true,
-    },
-    {
-        displayName: 'Edit Instruction',
-        name: 'editPrompt',
-        type: 'string',
-        typeOptions: { rows: 3 },
-        displayOptions: {
-            show: {
-                resource: ['tools'],
-                operation: ['instructEdit'],
-            },
-        },
-        default: '',
-        placeholder: 'Add a red hat to the person, keep the background the same',
-        description: 'Mô tả thay đổi muốn áp dụng lên ảnh',
-        required: true,
-    },
-    {
-        displayName: 'Additional Fields',
-        name: 'additionalFields',
-        type: 'collection',
-        placeholder: 'Add Field',
-        default: {},
-        displayOptions: {
-            show: {
-                resource: ['tools'],
-                operation: ['instructEdit'],
-            },
-        },
-        options: [
-            {
-                displayName: 'Model Name or ID',
-                name: 'model',
-                type: 'options',
-                typeOptions: {
-                    loadOptionsMethod: 'getModels',
-                },
-                default: '',
-                description: 'Model AI dùng để edit ảnh',
-            },
-            {
-                displayName: 'Steps',
-                name: 'steps',
-                type: 'number',
-                typeOptions: { minValue: 1, maxValue: 50 },
-                default: 20,
-                description: 'Số bước inference',
+                description: 'Swap faces in images',
+                action: 'Face swap',
             },
             {
-                displayName: 'CFG Scale',
-                name: 'cfgScale',
-                type: 'number',
-                typeOptions: { minValue: 1, maxValue: 10 },
-                default: 7,
-                description: 'Độ tuân thủ instruction',
-            },
-            {
-                displayName: 'Callback URL',
-                name: 'callbackUrl',
-                type: 'string',
-                default: '',
-                placeholder: 'https://your-n8n.com/webhook/supermachine-callback',
-                description: 'Webhook URL nhận kết quả async',
-            },
-        ],
-    },
-    // ─── UPSCALE ─────────────────────────────────────────────
-    {
-        displayName: 'Input Image URL',
-        name: 'inputImageUrl',
-        type: 'string',
-        displayOptions: {
-            show: {
-                resource: ['tools'],
-                operation: ['upscale'],
-            },
-        },
-        default: '',
-        placeholder: 'https://riku-assets.com/generations/xxx.png',
-        description: 'URL ảnh muốn upscale',
-        required: true,
-    },
-    {
-        displayName: 'Upscale Factor',
-        name: 'upscaleFactor',
-        type: 'options',
-        displayOptions: {
-            show: {
-                resource: ['tools'],
-                operation: ['upscale'],
-            },
-        },
-        options: [
-            { name: '2x', value: 2 },
-            { name: '4x', value: 4 },
-            { name: '8x', value: 8 },
-        ],
-        default: 2,
-        description: 'Tăng kích thước ảnh bao nhiêu lần',
-    },
-    {
-        displayName: 'Additional Fields',
-        name: 'additionalFields',
-        type: 'collection',
-        placeholder: 'Add Field',
-        default: {},
-        displayOptions: {
-            show: {
-                resource: ['tools'],
-                operation: ['upscale'],
+                name: 'Upscale (Coming Soon)',
+                value: 'upscale',
+                description: 'Upscale image resolution up to 2x',
+                action: 'Upscale image',
             },
-        },
-        options: [
             {
-                displayName: 'Callback URL',
-                name: 'callbackUrl',
-                type: 'string',
-                default: '',
-                placeholder: 'https://your-n8n.com/webhook/supermachine-callback',
-                description: 'Webhook URL nhận kết quả async',
+                name: 'Instruct Edit (Coming Soon)',
+                value: 'instructEdit',
+                description: 'Edit image using text instructions',
+                action: 'Instruct edit',
             },
         ],
+        default: 'imageToPrompt',
     },
-    // ─── FACE SWAP ───────────────────────────────────────────
-    {
-        displayName: 'Target Image URL',
-        name: 'inputImageUrl',
-        type: 'string',
-        displayOptions: {
-            show: {
-                resource: ['tools'],
-                operation: ['faceSwap'],
-            },
-        },
-        default: '',
-        placeholder: 'https://riku-assets.com/generations/xxx.png',
-        description: 'URL ảnh đích (ảnh sẽ được swap khuôn mặt vào)',
-        required: true,
-    },
+];
+exports.getToolsFields = [
     {
-        displayName: 'Face Image URL',
-        name: 'faceImageUrl',
-        type: 'string',
+        displayName: 'Coming Soon',
+        name: 'comingSoonNotice',
+        type: 'notice',
         displayOptions: {
             show: {
                 resource: ['tools'],
-                operation: ['faceSwap'],
             },
         },
         default: '',
-        placeholder: 'https://example.com/face.png',
-        description: 'URL ảnh khuôn mặt nguồn muốn swap vào ảnh đích',
-        required: true,
-    },
-    {
-        displayName: 'Additional Fields',
-        name: 'additionalFields',
-        type: 'collection',
-        placeholder: 'Add Field',
-        default: {},
-        displayOptions: {
-            show: {
-                resource: ['tools'],
-                operation: ['faceSwap'],
-            },
-        },
-        options: [
-            {
-                displayName: 'Strength',
-                name: 'strength',
-                type: 'number',
-                typeOptions: { minValue: 0, maxValue: 1 },
-                default: 0.8,
-                description: 'Độ mạnh face swap (0.0 - 1.0)',
-            },
-            {
-                displayName: 'Callback URL',
-                name: 'callbackUrl',
-                type: 'string',
-                default: '',
-                placeholder: 'https://your-n8n.com/webhook/supermachine-callback',
-                description: 'Webhook URL nhận kết quả async',
-            },
-        ],
+        description: '⚠️ Tools operations are coming soon. These features will be available in a future update when Supermachine API provides official endpoints.',
     },
 ];

package/dist/nodes/Supermachine/descriptions/index.js

@@ -15,5 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./AccountDescription"), exports);
+__exportStar(require("./CharacterDescription"), exports);
+__exportStar(require("./FolderDescription"), exports);
 __exportStar(require("./ImageDescription"), exports);
 __exportStar(require("./ToolsDescription"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-supermachine",
-  "version": "0.1.5",
+  "version": "0.3.0",
   "description": "n8n community node for Supermachine AI Image API — Generate images, manage models, LoRAs, and characters",
   "keywords": [
     "n8n-community-node-package",