aillom-vox-client 1.0.0

package/integrations/n8n-nodes-aillomvox/package.json

@@ -0,0 +1,56 @@
+{
+    "name": "n8n-nodes-aillomvox",
+    "version": "0.1.0",
+    "description": "Official AillomVox node for n8n. Easy integration with Voice Gateway, Recordings Management, and AI Providers.",
+    "keywords": [
+        "n8n-community-node-package",
+        "aillomvox",
+        "voice",
+        "ai",
+        "gateway"
+    ],
+    "license": "MIT",
+    "homepage": "https://vox.aillom.com",
+    "author": {
+        "name": "Aillom AI",
+        "email": "dev@aillom.com"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/aillom/aillom-vox-client.git"
+    },
+    "main": "index.js",
+    "scripts": {
+        "build": "tsc && gulp build:icons",
+        "dev": "tsc --watch",
+        "format": "prettier nodes/**/*.ts --write",
+        "lint": "eslint nodes package.json",
+        "lintfix": "eslint nodes package.json --fix",
+        "prepublishOnly": "npm run build"
+    },
+    "files": [
+        "dist"
+    ],
+    "n8n": {
+        "nodes": [
+            "dist/nodes/AillomVox/AillomVox.node.js"
+        ],
+        "credentials": [
+            "dist/credentials/AillomVoxApi.credentials.js"
+        ]
+    },
+    "devDependencies": {
+        "@types/express": "^4.17.6",
+        "@types/request-promise-native": "~1.0.15",
+        "@typescript-eslint/parser": "~5.45",
+        "eslint-plugin-n8n-nodes-base": "^1.11.0",
+        "gulp": "^4.0.2",
+        "n8n-core": "^1.122.14",
+        "n8n-workflow": "*",
+        "prettier": "^2.7.1",
+        "typescript": "^5.0.0"
+    },
+    "peerDependencies": {
+        "n8n-workflow": "*"
+    }
+}

package/integrations/n8n-nodes-aillomvox/tsconfig.json

@@ -0,0 +1,32 @@
+{
+    "compilerOptions": {
+        "rootDirs": [
+            "nodes",
+            "credentials"
+        ],
+        "outDir": "dist",
+        "target": "es2019",
+        "lib": [
+            "es2019",
+            "dom"
+        ],
+        "module": "commonjs",
+        "moduleResolution": "node",
+        "allowJs": true,
+        "checkJs": false,
+        "strict": false,
+        "noImplicitAny": false, // Relaxed for easier build in mixed envs
+        "esModuleInterop": true,
+        "resolveJsonModule": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "include": [
+        "nodes/**/*",
+        "credentials/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist"
+    ]
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+    "name": "aillom-vox-client",
+    "version": "1.0.0",
+    "description": "Enterprise-Grade Voice AI SDK for Speech-to-Speech, Audio-to-Audio, and Realtime Multimodal applications.",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc --watch",
+        "test": "echo \"Error: no test specified\" && exit 1"
+    },
+    "dependencies": {
+        "isomorphic-ws": "^5.0.0",
+        "ws": "^8.16.0"
+    },
+    "devDependencies": {
+        "@types/ws": "^8.5.10",
+        "typescript": "^5.3.3",
+        "ts-node": "^10.9.2",
+        "@types/node": "^20.11.19"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/aillom/aillom-vox-client.git"
+    },
+    "keywords": [
+        "voice-ai",
+        "speech-to-speech",
+        "audio-to-audio",
+        "realtime-api",
+        "websocket-client",
+        "openai-realtime",
+        "gemini-multimodal",
+        "low-latency",
+        "voice-gateway",
+        "sip-trunking",
+        "asterisk",
+        "inworld-ai",
+        "gpt-4o-realtime",
+        "telephony",
+        "ultravox",
+        "nova-sonic"
+    ],
+    "author": "Aillom Technologies <contato@aillom.com.br>",
+    "license": "ISC",
+    "bugs": {
+        "url": "https://github.com/aillom/aillom-vox-client/issues"
+    },
+    "homepage": "https://vox.aillom.com",
+    "devDependencies": {
+        "@types/node": "^25.2.2",
+        "ts-node": "^10.9.2",
+        "typescript": "^5.9.3"
+    }
+}

package/src/AillomVox.ts

@@ -0,0 +1,169 @@
+import { AillomVoxConfig, TranscriptEvent, ToolCallEvent, EventHandler } from './types';
+import WebSocket from 'isomorphic-ws';
+
+export class AillomVox {
+    private ws: WebSocket | null = null;
+    private config: AillomVoxConfig;
+    private eventListeners: Map<string, EventHandler[]> = new Map();
+    private isConnected: boolean = false;
+    private url: string = 'wss://vox.aillom.com/ws';
+
+    constructor(config: AillomVoxConfig) {
+        this.config = config;
+        if (!this.config.apiKey) {
+            throw new Error('AillomVox: apiKey is required');
+        }
+    }
+
+    /**
+     * Connects to the AillomVox Gateway
+     */
+    public connect(): Promise<void> {
+        return new Promise((resolve, reject) => {
+            try {
+                this.ws = new WebSocket(this.url);
+                this.ws.binaryType = 'arraybuffer';
+
+                this.ws.onopen = () => {
+                    this.isConnected = true;
+                    this.sendConfig();
+                    this.emit('connected', {});
+                    resolve();
+                };
+
+                this.ws.onmessage = (event: WebSocket.MessageEvent) => {
+                    this.handleMessage(event);
+                };
+
+                this.ws.onerror = (error: WebSocket.ErrorEvent) => {
+                    this.emit('error', error);
+                    if (!this.isConnected) reject(error);
+                };
+
+                this.ws.onclose = (event: WebSocket.CloseEvent) => {
+                    this.isConnected = false;
+                    this.emit('disconnected', { code: event.code, reason: event.reason });
+                };
+
+            } catch (err) {
+                reject(err);
+            }
+        });
+    }
+
+    /**
+     * Sends audio chunk (PCM 16-bit) to the AI
+     */
+    public sendAudio(chunk: ArrayBuffer | Int16Array | Buffer): void {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
+        this.ws.send(chunk);
+    }
+
+    /**
+     * Sends a tool result back to the AI
+     */
+    public sendToolResult(callId: string, result: any): void {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
+        this.ws.send(JSON.stringify({
+            type: 'tool_result',
+            call_id: callId,
+            result: result
+        }));
+    }
+
+    /**
+     * Disconnects the session
+     */
+    public disconnect(): void {
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+            this.isConnected = false;
+        }
+    }
+
+    /**
+     * Subscribes to an event
+     */
+    public on(event: 'audio', handler: (data: ArrayBuffer) => void): void;
+    public on(event: 'transcript', handler: (data: TranscriptEvent) => void): void;
+    public on(event: 'tool_call', handler: (data: ToolCallEvent) => void): void;
+    public on(event: 'error', handler: (error: any) => void): void;
+    public on(event: 'connected' | 'disconnected' | 'interruption', handler: (data: any) => void): void;
+    public on(event: string, handler: EventHandler): void {
+        if (!this.eventListeners.has(event)) {
+            this.eventListeners.set(event, []);
+        }
+        this.eventListeners.get(event)?.push(handler);
+    }
+
+    private sendConfig() {
+        if (!this.ws) return;
+
+        const payload = {
+            type: 'config',
+            apikey: this.config.apiKey,
+            provider: this.config.provider || 'aillomvox',
+            voice: this.config.voice || 'Edward',
+            language: this.config.language || 'en-US',
+            sample_rate: this.config.sampleRate || 16000,
+            system_prompt: this.config.systemPrompt,
+            tools: this.config.tools,
+            webhook_url: this.config.webhookUrl,
+            max_duration: this.config.maxDuration
+        };
+
+        if (this.config.debug) {
+            console.log('[AillomVox] Sending config:', JSON.stringify(payload, null, 2));
+        }
+
+        this.ws.send(JSON.stringify(payload));
+    }
+
+    private handleMessage(event: WebSocket.MessageEvent) {
+        const data = event.data;
+
+        // Handle Binary Audio
+        if (data instanceof ArrayBuffer || (typeof Buffer !== 'undefined' && Buffer.isBuffer(data))) {
+            this.emit('audio', data);
+            return;
+        }
+
+        // Handle JSON Control Messages
+        if (typeof data === 'string') {
+            try {
+                const msg = JSON.parse(data);
+
+                switch (msg.type) {
+                    case 'transcript':
+                        this.emit('transcript', msg);
+                        break;
+                    case 'tool_call':
+                        this.emit('tool_call', msg);
+                        break;
+                    case 'error':
+                        this.emit('error', msg);
+                        break;
+                    case 'interruption':
+                        this.emit('interruption', {});
+                        break;
+                    case 'hangup':
+                        this.disconnect();
+                        this.emit('disconnected', { reason: 'agent_hangup' });
+                        break;
+                    default:
+                        if (this.config.debug) console.log('[AillomVox] Data:', msg);
+                }
+            } catch (e) {
+                console.error('[AillomVox] Failed to parse message:', e);
+            }
+        }
+    }
+
+    private emit(event: string, data: any) {
+        const listeners = this.eventListeners.get(event);
+        if (listeners) {
+            listeners.forEach(handler => handler(data));
+        }
+    }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './AillomVox';

package/src/types.ts

@@ -0,0 +1,50 @@
+export type ProviderType =
+    | 'aillomvox'
+    | 'gemini'
+    | 'openai'
+    | 'aws'
+    | 'qwen'
+    | 'grok'
+    | 'ultravox';
+
+export interface MicrophoneConfig {
+    sampleRate?: 8000 | 16000 | 24000;
+    inputSampleRate?: number;
+}
+
+export interface ClientTool {
+    name: string;
+    description: string;
+    parameters: Record<string, any>;
+}
+
+export interface AillomVoxConfig {
+    apiKey: string;
+    provider?: ProviderType;
+    voice?: string;
+    language?: string;
+    systemPrompt?: string;
+    sampleRate?: 8000 | 16000 | 24000;
+    debug?: boolean;
+    tools?: ClientTool[];
+    webhookUrl?: string;
+    maxDuration?: number;
+}
+
+export interface TranscriptEvent {
+    role: 'user' | 'assistant';
+    text: string;
+    final: boolean;
+}
+
+export interface ToolCallEvent {
+    call_id: string;
+    name: string;
+    args: any;
+}
+
+export interface AudioEvent {
+    buffer: ArrayBuffer;
+}
+
+export type EventHandler<T = any> = (data: T) => void;

package/tsconfig.json

@@ -0,0 +1,23 @@
+{
+    "compilerOptions": {
+        "target": "es2020",
+        "module": "commonjs",
+        "lib": [
+            "es2020",
+            "dom"
+        ],
+        "declaration": true,
+        "outDir": "dist",
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist"
+    ]
+}