@ferchy/n8n-nodes-aimc-toolkit 0.1.8 → 0.1.10

package/README.md

@@ -4,12 +4,13 @@ AIMC Toolkit is a community node package for n8n with focused nodes:
 
 - **AIMC Code**: run JavaScript with a practical toolbox of libraries.
 - **AIMC Media**: FFmpeg-powered media operations without extra glue nodes.
-- **AIMC TTS**: CPU-friendly text-to-speech using Piper.
 
 ## Why I Built This
 
 n8n is powerful, but real workflows often need basic utilities (validation, parsing, HTTP) and media tasks (convert, compress, merge). I built AIMC Toolkit to remove the busywork and keep workflows short, readable, and fast.
 
+**Inspiration**: The original idea was sparked by Kenkaii’s SuperCode. I’m grateful for that work and built AIMC Toolkit as my own version, tailored to my needs and expanded with improvements over time.
+
 ## Who This Is For
 
 - Automation builders who want fewer nodes and faster iterations.
@@ -22,7 +23,6 @@ n8n is powerful, but real workflows often need basic utilities (validation, pars
 - **Fewer nodes, cleaner flows**: consolidate multiple steps into one code node.
 - **Media ready**: convert, compress, merge, and inspect media in one place.
 - **Practical libraries**: parsing, validation, dates, and web utilities built in.
-- **Local voice**: generate speech on a CPU server without paid APIs.
 
 ## Installation
 
@@ -74,6 +74,7 @@ brew install ffmpeg
 - Run once for all items or once per item.
 - Access libraries as globals (`axios`, `_`, `zod`) or via `libs`.
 - Built-in helpers (`utils.now`, `utils.safeJson`, `utils.toArray`).
+- **AIMC Connect Mode**: optional AI connectors for LLMs, tools, memory, and more.
 
 **Example: normalize data**
 ```javascript
@@ -105,6 +106,20 @@ result = {
 }
 ```
 
+**AIMC Connect Mode (AI)**
+Enable **AIMC Connect Mode** to attach AI connectors. When enabled, your code can use:
+
+- `ai` (object with all connectors)
+- `aiModel`, `aiTools`, `aiMemory`, `aiVectorStore`, `aiChain`, `aiDocument`
+
+Example:
+```javascript
+if (aiModel) {
+  const response = await aiModel.invoke('Summarize this input.');
+  return { summary: response };
+}
+```
+
 ### AIMC Media
 
 **Operations**
@@ -147,31 +162,6 @@ Audio File Path: /path/to/audio.mp3
 **Large Files**
 Use **Input Mode = File Path** to avoid loading big files into memory.
 
-### AIMC TTS (Piper)
-
-**What it does**
-Generate speech locally using Piper (CPU-friendly, no external API). Output is WAV audio.
-
-**Requirements**
-- Python 3 installed
-- Piper installed: `pip install piper-tts`
-- A downloaded voice model
-
-**Download a voice**
-```bash
-python3 -m piper.download_voices en_US-lessac-medium
-```
-
-**Example**
-```
-Text: Hello from AIMC Toolkit
-Voice Name: en_US-lessac-medium
-Output Mode: Binary
-```
-
-**Tips**
-- Use **Output Mode = File Path** for large audio.
-- For custom voice storage, set **Data Dir**.
 
 
 ## Library Reference (AIMC Code)

package/dist/nodes/AimcCode/AimcCode.node.js

@@ -147,6 +147,7 @@ function normalizeResult(result, fallbackItems) {
     ];
 }
 function buildSandbox(params) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
     const cache = {};
     const sandbox = {
         items: params.items,
@@ -161,6 +162,16 @@ function buildSandbox(params) {
                 : params.items.map((entry) => entry.json),
         },
         params: params.nodeParams,
+        ai: params.aiContext || {},
+        aiModel: (_a = params.aiContext) === null || _a === void 0 ? void 0 : _a.languageModel,
+        aiTools: (_b = params.aiContext) === null || _b === void 0 ? void 0 : _b.tools,
+        aiMemory: (_c = params.aiContext) === null || _c === void 0 ? void 0 : _c.memory,
+        aiChain: (_d = params.aiContext) === null || _d === void 0 ? void 0 : _d.chain,
+        aiDocument: (_e = params.aiContext) === null || _e === void 0 ? void 0 : _e.document,
+        aiEmbedding: (_f = params.aiContext) === null || _f === void 0 ? void 0 : _f.embedding,
+        aiOutputParser: (_g = params.aiContext) === null || _g === void 0 ? void 0 : _g.outputParser,
+        aiTextSplitter: (_h = params.aiContext) === null || _h === void 0 ? void 0 : _h.textSplitter,
+        aiVectorStore: (_j = params.aiContext) === null || _j === void 0 ? void 0 : _j.vectorStore,
         utils: {
             now: () => new Date().toISOString(),
             sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
@@ -294,7 +305,32 @@ class AimcCode {
             defaults: {
                 name: 'AIMC Code',
             },
-            inputs: ['main'],
+            inputs: `={{ 
+			((values, aiMode) => {
+				const connectorTypes = {
+					'${"ai_chain"}': 'Chain',
+					'${"ai_document"}': 'Document',
+					'${"ai_embedding"}': 'Embedding',
+					'${"ai_languageModel"}': 'Language Model',
+					'${"ai_memory"}': 'Memory',
+					'${"ai_outputParser"}': 'Output Parser',
+					'${"ai_textSplitter"}': 'Text Splitter',
+					'${"ai_tool"}': 'Tool',
+					'${"ai_vectorStore"}': 'Vector Store',
+					'${"main"}': 'Main'
+				};
+				const baseInputs = [{ displayName: '', type: '${"main"}' }];
+				if (aiMode && values) {
+					return baseInputs.concat(values.map(value => ({
+						type: value.type,
+						required: value.required,
+						maxConnections: value.maxConnections === -1 ? undefined : value.maxConnections,
+						displayName: connectorTypes[value.type] !== 'Main' ? connectorTypes[value.type] : undefined
+					})));
+				}
+				return baseInputs;
+			})($parameter.aiConnections?.input, $parameter.aiConnectMode)
+		}}`,
             outputs: ['main'],
             properties: [
                 {
@@ -333,6 +369,67 @@ class AimcCode {
                         maxValue: 300,
                     },
                 },
+                {
+                    displayName: 'AIMC Connect Mode',
+                    name: 'aiConnectMode',
+                    type: 'boolean',
+                    default: false,
+                    description: 'Enable AI connector inputs for models, tools, memory, and more.',
+                },
+                {
+                    displayName: 'AI Connections',
+                    name: 'aiConnections',
+                    placeholder: 'Add AI Connection',
+                    type: 'fixedCollection',
+                    displayOptions: {
+                        show: {
+                            aiConnectMode: [true],
+                        },
+                    },
+                    typeOptions: {
+                        multipleValues: true,
+                    },
+                    default: {},
+                    options: [
+                        {
+                            name: 'input',
+                            displayName: 'Input',
+                            values: [
+                                {
+                                    displayName: 'Type',
+                                    name: 'type',
+                                    type: 'options',
+                                    options: [
+                                        { name: 'Chain', value: 'ai_chain' },
+                                        { name: 'Document', value: 'ai_document' },
+                                        { name: 'Embedding', value: 'ai_embedding' },
+                                        { name: 'Language Model', value: 'ai_languageModel' },
+                                        { name: 'Memory', value: 'ai_memory' },
+                                        { name: 'Output Parser', value: 'ai_outputParser' },
+                                        { name: 'Text Splitter', value: 'ai_textSplitter' },
+                                        { name: 'Tool', value: 'ai_tool' },
+                                        { name: 'Vector Store', value: 'ai_vectorStore' },
+                                    ],
+                                    default: 'ai_languageModel',
+                                },
+                                {
+                                    displayName: 'Max Connections',
+                                    name: 'maxConnections',
+                                    type: 'number',
+                                    default: 1,
+                                    description: 'Set -1 for unlimited connections',
+                                },
+                                {
+                                    displayName: 'Required',
+                                    name: 'required',
+                                    type: 'boolean',
+                                    default: false,
+                                    description: 'Whether this connection is required',
+                                },
+                            ],
+                        },
+                    ],
+                },
                 {
                     displayName: 'JavaScript Code',
                     name: 'code',
@@ -410,8 +507,38 @@ class AimcCode {
         const language = this.getNodeParameter('language', 0, 'javascript');
         const mode = this.getNodeParameter('mode', 0, 'runOnceForAllItems');
         const timeoutSeconds = this.getNodeParameter('timeoutSeconds', 0, 30);
+        const aiConnectMode = this.getNodeParameter('aiConnectMode', 0, false);
         const timeoutMs = Math.max(1, timeoutSeconds) * 1000;
         const nodeParams = this.getNode().parameters;
+        const aiContext = {};
+        const fetchAi = async (type) => {
+            if (!aiConnectMode) {
+                return undefined;
+            }
+            const getter = this
+                .getInputConnectionData;
+            if (!getter) {
+                return undefined;
+            }
+            try {
+                const value = await getter(type, 0);
+                return Array.isArray(value) ? value[0] : value;
+            }
+            catch {
+                return undefined;
+            }
+        };
+        if (aiConnectMode) {
+            aiContext.chain = await fetchAi('ai_chain');
+            aiContext.document = await fetchAi('ai_document');
+            aiContext.embedding = await fetchAi('ai_embedding');
+            aiContext.languageModel = await fetchAi('ai_languageModel');
+            aiContext.memory = await fetchAi('ai_memory');
+            aiContext.outputParser = await fetchAi('ai_outputParser');
+            aiContext.textSplitter = await fetchAi('ai_textSplitter');
+            aiContext.tools = await fetchAi('ai_tool');
+            aiContext.vectorStore = await fetchAi('ai_vectorStore');
+        }
         if (language === 'python') {
             const pythonCode = this.getNodeParameter('pythonCode', 0, '');
             if (!pythonCode.trim()) {
@@ -477,6 +604,7 @@ class AimcCode {
                         item,
                         mode,
                         nodeParams,
+                        aiContext,
                     });
                     const result = await runCode(sandbox);
                     const normalized = normalizeResult(result, [item]);
@@ -488,6 +616,7 @@ class AimcCode {
                 items,
                 mode,
                 nodeParams,
+                aiContext,
             });
             const result = await runCode(sandbox);
             const normalized = normalizeResult(result, items);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ferchy/n8n-nodes-aimc-toolkit",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "AIMC Toolkit nodes for n8n: code execution and media operations.",
   "license": "MIT",
   "author": "Ferchy",
@@ -28,8 +28,7 @@
     "n8nNodesApiVersion": 1,
     "nodes": [
       "dist/nodes/AimcCode/AimcCode.node.js",
-      "dist/nodes/AimcMedia/AimcMedia.node.js",
-      "dist/nodes/AimcTts/AimcTts.node.js"
+      "dist/nodes/AimcMedia/AimcMedia.node.js"
     ]
   },
   "dependencies": {

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

@@ -1,5 +0,0 @@
-import { INodeExecutionData, INodeType, INodeTypeDescription, IExecuteFunctions } from 'n8n-workflow';
-export declare class AimcTts implements INodeType {
-    description: INodeTypeDescription;
-    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
-}

package/dist/nodes/AimcTts/AimcTts.node.js

@@ -1,276 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AimcTts = void 0;
-const n8n_workflow_1 = require("n8n-workflow");
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const os = __importStar(require("os"));
-const child_process_1 = require("child_process");
-const util_1 = require("util");
-const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
-let piperChecked = null;
-async function ensurePiperAvailable(pythonPath) {
-    if (piperChecked) {
-        if (!piperChecked.ok) {
-            throw new Error(piperChecked.message || 'Piper not available');
-        }
-        return;
-    }
-    try {
-        await execFileAsync(pythonPath, ['-m', 'piper', '--help'], {
-            timeout: 10000,
-            maxBuffer: 1024 * 1024,
-        });
-        piperChecked = { ok: true };
-    }
-    catch (error) {
-        const message = error instanceof Error && error.message
-            ? error.message
-            : 'Piper not available';
-        piperChecked = { ok: false, message };
-        throw new Error(message);
-    }
-}
-async function createTempDir() {
-    return fs.promises.mkdtemp(path.join(os.tmpdir(), 'aimc-tts-'));
-}
-class AimcTts {
-    constructor() {
-        this.description = {
-            displayName: 'AIMC TTS',
-            name: 'aimcTts',
-            icon: 'file:aimc-tts.svg',
-            group: ['transform'],
-            version: 1,
-            description: 'Text-to-speech using Piper (CPU-friendly).',
-            defaults: {
-                name: 'AIMC TTS',
-            },
-            inputs: ['main'],
-            outputs: ['main'],
-            properties: [
-                {
-                    displayName: 'Text',
-                    name: 'text',
-                    type: 'string',
-                    default: '',
-                    typeOptions: {
-                        rows: 4,
-                    },
-                    description: 'Text to synthesize. Supports expressions from input data.',
-                },
-                {
-                    displayName: 'Voice Name',
-                    name: 'voice',
-                    type: 'string',
-                    default: 'en_US-lessac-medium',
-                    description: 'Piper voice name (downloaded via piper).',
-                },
-                {
-                    displayName: 'Data Dir',
-                    name: 'dataDir',
-                    type: 'string',
-                    default: '',
-                    description: 'Optional custom voice data directory.',
-                },
-                {
-                    displayName: 'Python Path',
-                    name: 'pythonPath',
-                    type: 'string',
-                    default: 'python3',
-                    description: 'Path to Python binary with piper-tts installed.',
-                },
-                {
-                    displayName: 'Sentence Silence (seconds)',
-                    name: 'sentenceSilence',
-                    type: 'number',
-                    default: 0,
-                    typeOptions: {
-                        minValue: 0,
-                        maxValue: 10,
-                    },
-                    description: 'Silence added after each sentence except the last.',
-                },
-                {
-                    displayName: 'Volume',
-                    name: 'volume',
-                    type: 'number',
-                    default: 1,
-                    typeOptions: {
-                        minValue: 0.1,
-                        maxValue: 3,
-                    },
-                    description: 'Volume multiplier (1.0 = default).',
-                },
-                {
-                    displayName: 'Disable Normalization',
-                    name: 'noNormalize',
-                    type: 'boolean',
-                    default: false,
-                    description: 'Disable automatic volume normalization.',
-                },
-                {
-                    displayName: 'Timeout (Seconds)',
-                    name: 'timeoutSeconds',
-                    type: 'number',
-                    default: 60,
-                    typeOptions: {
-                        minValue: 10,
-                        maxValue: 600,
-                    },
-                },
-                {
-                    displayName: 'Output Mode',
-                    name: 'outputMode',
-                    type: 'options',
-                    options: [
-                        { name: 'Binary', value: 'binary' },
-                        { name: 'File Path', value: 'filePath' },
-                    ],
-                    default: 'binary',
-                },
-                {
-                    displayName: 'Output Binary Property',
-                    name: 'outputBinaryProperty',
-                    type: 'string',
-                    default: 'data',
-                    displayOptions: {
-                        show: {
-                            outputMode: ['binary'],
-                        },
-                    },
-                },
-                {
-                    displayName: 'Output File Path',
-                    name: 'outputFilePath',
-                    type: 'string',
-                    default: '',
-                    placeholder: '/path/to/output.wav',
-                    displayOptions: {
-                        show: {
-                            outputMode: ['filePath'],
-                        },
-                    },
-                },
-            ],
-        };
-    }
-    async execute() {
-        const items = this.getInputData();
-        const results = [];
-        for (let index = 0; index < items.length; index++) {
-            const item = items[index];
-            const text = this.getNodeParameter('text', index, '');
-            const voice = this.getNodeParameter('voice', index);
-            const dataDir = this.getNodeParameter('dataDir', index, '');
-            const pythonPath = this.getNodeParameter('pythonPath', index, 'python3');
-            const sentenceSilence = this.getNodeParameter('sentenceSilence', index, 0);
-            const volume = this.getNodeParameter('volume', index, 1);
-            const noNormalize = this.getNodeParameter('noNormalize', index, false);
-            const timeoutSeconds = this.getNodeParameter('timeoutSeconds', index, 60);
-            const outputMode = this.getNodeParameter('outputMode', index, 'binary');
-            const outputBinaryProperty = this.getNodeParameter('outputBinaryProperty', index, 'data');
-            const outputFilePath = this.getNodeParameter('outputFilePath', index, '');
-            if (!text || !text.trim()) {
-                throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Text is required.');
-            }
-            try {
-                await ensurePiperAvailable(pythonPath);
-            }
-            catch (error) {
-                const message = error instanceof Error ? error.message : 'Piper not available';
-                throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Piper not found. Install piper-tts and voices. ${message}`);
-            }
-            let tempDir = null;
-            let outputPath = outputFilePath;
-            if (outputMode === 'filePath' && !outputPath) {
-                throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Output File Path is required.');
-            }
-            if (outputMode === 'binary') {
-                tempDir = await createTempDir();
-                outputPath = path.join(tempDir, 'speech.wav');
-            }
-            const args = ['-m', 'piper', '-m', voice, '-f', outputPath];
-            if (dataDir) {
-                args.push('--data-dir', dataDir);
-            }
-            if (sentenceSilence > 0) {
-                args.push('--sentence-silence', sentenceSilence.toString());
-            }
-            if (volume && volume !== 1) {
-                args.push('--volume', volume.toString());
-            }
-            if (noNormalize) {
-                args.push('--no-normalize');
-            }
-            args.push('--', text);
-            try {
-                await execFileAsync(pythonPath, args, {
-                    timeout: Math.max(10, timeoutSeconds) * 1000,
-                    maxBuffer: 1024 * 1024,
-                });
-                const outputItem = {
-                    json: {
-                        ...item.json,
-                        tts: {
-                            voice,
-                            outputPath: outputMode === 'filePath' ? outputPath : undefined,
-                        },
-                    },
-                };
-                if (outputMode === 'binary') {
-                    const data = await fs.promises.readFile(outputPath);
-                    const binaryData = await this.helpers.prepareBinaryData(data, 'speech.wav');
-                    outputItem.binary = {
-                        [outputBinaryProperty]: binaryData,
-                    };
-                }
-                results.push(outputItem);
-            }
-            catch (error) {
-                const message = error instanceof Error ? error.message : 'Unknown error';
-                throw new n8n_workflow_1.NodeOperationError(this.getNode(), `TTS failed: ${message}`);
-            }
-            finally {
-                if (tempDir) {
-                    await fs.promises.rm(tempDir, { recursive: true, force: true });
-                }
-            }
-        }
-        return [results];
-    }
-}
-exports.AimcTts = AimcTts;

package/dist/nodes/AimcTts/aimc-tts.svg

@@ -1,19 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64">
-  <defs>
-    <linearGradient id="aimc-tts-bg" x1="0" y1="0" x2="1" y2="1">
-      <stop offset="0%" stop-color="#0A1021"/>
-      <stop offset="100%" stop-color="#0B1B3A"/>
-    </linearGradient>
-    <linearGradient id="aimc-tts-glow" x1="0" y1="0" x2="1" y2="1">
-      <stop offset="0%" stop-color="#7DD3FC"/>
-      <stop offset="100%" stop-color="#0EA5E9"/>
-    </linearGradient>
-  </defs>
-  <rect x="6" y="6" width="52" height="52" rx="10" fill="url(#aimc-tts-bg)"/>
-  <rect x="26" y="18" width="12" height="22" rx="6" fill="url(#aimc-tts-glow)"/>
-  <path d="M22 30C22 36 26 40 32 40C38 40 42 36 42 30" stroke="#38BDF8" stroke-width="2.5" fill="none" stroke-linecap="round"/>
-  <path d="M24 46H40" stroke="#1E3A8A" stroke-width="2" stroke-linecap="round"/>
-  <path d="M32 40V46" stroke="#1E3A8A" stroke-width="2" stroke-linecap="round"/>
-  <path d="M14 24C18 20 20 20 22 24" stroke="#1E3A8A" stroke-width="1.5" fill="none" stroke-linecap="round"/>
-  <path d="M50 24C46 20 44 20 42 24" stroke="#1E3A8A" stroke-width="1.5" fill="none" stroke-linecap="round"/>
-</svg>