@rbalchii/anchor-engine 4.7.0

package/engine/dist/services/vision/vision_service.d.ts

@@ -0,0 +1,4 @@
+export function startVisionServer(): Promise<void>;
+export function stopVisionServer(): void;
+export function analyzeImage(base64Image: any, prompt: any): Promise<any>;
+//# sourceMappingURL=vision_service.d.ts.map

package/engine/dist/services/vision/vision_service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision_service.d.ts","sourceRoot":"","sources":["../../../src/services/vision/vision_service.js"],"names":[],"mappings":"AAgEA,mDAqEC;AAED,yCAKC;AAED,0EAgEC"}

package/engine/dist/services/vision/vision_service.js

@@ -0,0 +1,197 @@
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const http = require('http');
+const paths = require('../../config/paths');
+const Config = require('../../config');
+let serverProcess = null;
+let lastVisionError = null;
+const SERVER_PORT = Config.SERVICES.VISION_SERVER_PORT;
+const BIN_PATH = path.join(paths.BASE_PATH, 'engine/bin/llama-server.exe');
+const MODEL_DIR = path.join(paths.BASE_PATH, 'engine/models/vision');
+const VISION_CONFIG = Config.MODELS.VISION;
+// Auto-detect model file
+const getModelPath = () => {
+    try {
+        // Prioritize User's custom model from Config
+        if (VISION_CONFIG.PATH) {
+            // Check if absolute path
+            if (fs.existsSync(VISION_CONFIG.PATH)) {
+                console.log(`[Vision] Using configured path: ${VISION_CONFIG.PATH}`);
+                return VISION_CONFIG.PATH;
+            }
+            // Check if relative to MODEL_DIR
+            const relativePath = path.join(MODEL_DIR, VISION_CONFIG.PATH);
+            if (fs.existsSync(relativePath)) {
+                console.log(`[Vision] Using configured model (relative): ${relativePath}`);
+                return relativePath;
+            }
+        }
+        if (!fs.existsSync(MODEL_DIR)) {
+            console.log(`[Vision] MODEL_DIR not found: ${MODEL_DIR}`);
+            return null;
+        }
+        const files = fs.readdirSync(MODEL_DIR);
+        const gguf = files.find(f => f.endsWith('.gguf') && !f.includes('mmproj'));
+        return gguf ? path.join(MODEL_DIR, gguf) : null;
+    }
+    catch (e) {
+        console.error(`[Vision] Error detecting models: ${e.message}`);
+        return null;
+    }
+};
+// Optional: detect separate projector if exists
+const getMmprojPath = () => {
+    try {
+        // Check Config first
+        if (VISION_CONFIG.PROJECTOR) {
+            const configProjPath = path.isAbsolute(VISION_CONFIG.PROJECTOR)
+                ? VISION_CONFIG.PROJECTOR
+                : path.join(MODEL_DIR, VISION_CONFIG.PROJECTOR);
+            if (fs.existsSync(configProjPath))
+                return configProjPath;
+        }
+        if (!fs.existsSync(MODEL_DIR))
+            return null;
+        const files = fs.readdirSync(MODEL_DIR);
+        const proj = files.find(f => f.includes('mmproj'));
+        return proj ? path.join(MODEL_DIR, proj) : null;
+    }
+    catch (e) {
+        return null;
+    }
+};
+async function startVisionServer() {
+    if (serverProcess) {
+        // Double check if process is really alive, otherwise nullify
+        if (serverProcess.exitCode !== null) {
+            console.warn("[Vision] Process found but it has exited. Restarting...");
+            serverProcess = null;
+        }
+        else {
+            return;
+        }
+    }
+    const modelPath = getModelPath();
+    if (!modelPath) {
+        console.warn("[Vision] No GGUF model found. Vision features disabled.");
+        return;
+    }
+    const args = [
+        '-m', modelPath,
+        '--port', SERVER_PORT.toString(),
+        '-c', VISION_CONFIG.CTX_SIZE.toString(),
+        '--n-gpu-layers', VISION_CONFIG.GPU_LAYERS.toString(),
+    ];
+    // Check if separate mmproj exists
+    const mmproj = getMmprojPath();
+    if (mmproj) {
+        args.push('--mmproj', mmproj);
+    }
+    console.log(`[Vision] Launching Binary Sidecar: llama-server.exe on port ${SERVER_PORT}`);
+    console.log(`[Vision] Model Path: ${modelPath}`);
+    if (mmproj)
+        console.log(`[Vision] Projector Path: ${mmproj}`);
+    try {
+        serverProcess = spawn(BIN_PATH, args, {
+            stdio: ['ignore', 'pipe', 'pipe']
+        });
+        serverProcess.stdout.on('data', (data) => {
+            const msg = data.toString();
+            // console.log(`[Vision Binary] ${msg}`); 
+        });
+        serverProcess.stderr.on('data', (data) => {
+            const msg = data.toString();
+            if (msg.includes('server is listening') || msg.includes('HTTP server listening')) {
+                console.log(`[Vision] Sidecar Ready.`);
+            }
+            // Detect specific architecture errors
+            if (msg.includes('unknown model architecture')) {
+                lastVisionError = "Incompatible Binary: Your llama-server.exe does not support this model type (e.g. Qwen2-VL). Please update engine/bin or use a different model.";
+                console.error(`[Vision Critical] ${lastVisionError}`);
+            }
+            // LOG ALL ERRORS
+            if (msg.includes('error') || msg.includes('Error') || msg.includes('failed')) {
+                console.error(`[Vision Binary Error] ${msg.trim()}`);
+            }
+        });
+        serverProcess.on('close', (code) => {
+            console.log(`[Vision] Sidecar exited with code ${code}`);
+            serverProcess = null;
+        });
+    }
+    catch (e) {
+        console.error(`[Vision] Failed to spawn sidecar: ${e.message}`);
+    }
+}
+function stopVisionServer() {
+    if (serverProcess) {
+        serverProcess.kill();
+        serverProcess = null;
+    }
+}
+async function analyzeImage(base64Image, prompt) {
+    if (!serverProcess) {
+        lastVisionError = null;
+        await startVisionServer();
+        if (!serverProcess)
+            throw new Error("Vision server failed to start (Mock Mode or Missing Binary).");
+        // Wait for boot
+        await new Promise(r => setTimeout(r, 4000)); // Fixed timeout for now, could be configurable later
+        if (!serverProcess) {
+            // Return the specific error if captured, otherwise generic
+            throw new Error(lastVisionError || "Vision server crashed during startup.");
+        }
+    }
+    return new Promise((resolve, reject) => {
+        // Standard ChatML format for Qwen2-VL
+        const payload = JSON.stringify({
+            prompt: `<|im_start|>system\nYou are a helpful visual assistant. You can see the image provided. Describe it in detail.<|im_end|>\n<|im_start|>user\n<image>\n${prompt}<|im_end|>\n<|im_start|>assistant\n`,
+            image_data: [{ data: base64Image, id: 12 }],
+            n_predict: 400,
+            temperature: 0.1,
+            cache_prompt: true
+        });
+        const options = {
+            hostname: 'localhost',
+            port: SERVER_PORT,
+            path: '/completion',
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': payload.length
+            }
+        };
+        const req = http.request(options, (res) => {
+            let data = '';
+            res.on('data', (chunk) => data += chunk);
+            res.on('end', () => {
+                if (!data || data.trim().length === 0) {
+                    return reject(new Error("Vision sidecar returned empty response. It may have crashed."));
+                }
+                try {
+                    const json = JSON.parse(data);
+                    // Standard llama-server completion response
+                    resolve(json.content || json.text || String(data));
+                }
+                catch (e) {
+                    // If not JSON, it might be raw text error output
+                    if (data.includes('error') || data.includes('failed')) {
+                        reject(new Error(`Vision sidecar error: ${data.substring(0, 100)}`));
+                    }
+                    else {
+                        reject(new Error(`Failed to parse vision response: ${e.message}`));
+                    }
+                }
+            });
+        });
+        req.on('error', (e) => {
+            reject(new Error(`Vision Request Error: ${e.message}`));
+        });
+        req.write(payload);
+        req.end();
+    });
+}
+module.exports = { startVisionServer, stopVisionServer, analyzeImage };
+export {};
+//# sourceMappingURL=vision_service.js.map

package/engine/dist/services/vision/vision_service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision_service.js","sourceRoot":"","sources":["../../../src/services/vision/vision_service.js"],"names":[],"mappings":"AAAA,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAC7B,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AACzB,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAEvC,IAAI,aAAa,GAAG,IAAI,CAAC;AACzB,IAAI,eAAe,GAAG,IAAI,CAAC;AAC3B,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC;AACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,6BAA6B,CAAC,CAAC;AAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;AACrE,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;AAE3C,yBAAyB;AACzB,MAAM,YAAY,GAAG,GAAG,EAAE;IACtB,IAAI,CAAC;QACD,6CAA6C;QAC7C,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC;YACrB,yBAAyB;YACzB,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,OAAO,CAAC,GAAG,CAAC,mCAAmC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrE,OAAO,aAAa,CAAC,IAAI,CAAC;YAC9B,CAAC;YACD,iCAAiC;YACjC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;YAC9D,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC9B,OAAO,CAAC,GAAG,CAAC,+CAA+C,YAAY,EAAE,CAAC,CAAC;gBAC3E,OAAO,YAAY,CAAC;YACxB,CAAC;QACL,CAAC;QAED,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,iCAAiC,SAAS,EAAE,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3E,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC,CAAC;AAEF,gDAAgD;AAChD,MAAM,aAAa,GAAG,GAAG,EAAE;IACvB,IAAI,CAAC;QACD,qBAAqB;QACrB,IAAI,aAAa,CAAC,SAAS,EAAE,CAAC;YAC1B,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC;gBAC3D,CAAC,CAAC,aAAa,CAAC,SAAS;gBACzB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;YAEpD,IAAI,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC;gBAAE,OAAO,cAAc,CAAC;QAC7D,CAAC;QAED,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3C,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;AAChC,CAAC,CAAC;AAEF,KAAK,UAAU,iBAAiB;IAC5B,IAAI,aAAa,EAAE,CAAC;QAChB,6DAA6D;QAC7D,IAAI,aAAa,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;YACxE,aAAa,GAAG,IAAI,CAAC;QACzB,CAAC;aAAM,CAAC;YACJ,OAAO;QACX,CAAC;IACL,CAAC;IAED,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;QACxE,OAAO;IACX,CAAC;IAED,MAAM,IAAI,GAAG;QACT,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE;QAChC,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC,QAAQ,EAAE;QACvC,gBAAgB,EAAE,aAAa,CAAC,UAAU,CAAC,QAAQ,EAAE;KACxD,CAAC;IAEF,kCAAkC;IAClC,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,IAAI,MAAM,EAAE,CAAC;QACT,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,+DAA+D,WAAW,EAAE,CAAC,CAAC;IAC1F,OAAO,CAAC,GAAG,CAAC,wBAAwB,SAAS,EAAE,CAAC,CAAC;IACjD,IAAI,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,4BAA4B,MAAM,EAAE,CAAC,CAAC;IAE9D,IAAI,CAAC;QACD,aAAa,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE;YAClC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SACpC,CAAC,CAAC;QAEH,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACrC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5B,0CAA0C;QAC9C,CAAC,CAAC,CAAC;QAEH,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACrC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC5B,IAAI,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC;gBAC/E,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;YAC3C,CAAC;YAED,sCAAsC;YACtC,IAAI,GAAG,CAAC,QAAQ,CAAC,4BAA4B,CAAC,EAAE,CAAC;gBAC7C,eAAe,GAAG,iJAAiJ,CAAC;gBACpK,OAAO,CAAC,KAAK,CAAC,qBAAqB,eAAe,EAAE,CAAC,CAAC;YAC1D,CAAC;YAED,iBAAiB;YACjB,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC3E,OAAO,CAAC,KAAK,CAAC,yBAAyB,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACzD,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAC/B,OAAO,CAAC,GAAG,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC;YACzD,aAAa,GAAG,IAAI,CAAC;QACzB,CAAC,CAAC,CAAC;IACP,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB;IACrB,IAAI,aAAa,EAAE,CAAC;QAChB,aAAa,CAAC,IAAI,EAAE,CAAC;QACrB,aAAa,GAAG,IAAI,CAAC;IACzB,CAAC;AACL,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,WAAW,EAAE,MAAM;IAC3C,IAAI,CAAC,aAAa,EAAE,CAAC;QACjB,eAAe,GAAG,IAAI,CAAC;QACvB,MAAM,iBAAiB,EAAE,CAAC;QAC1B,IAAI,CAAC,aAAa;YAAE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QACpG,gBAAgB;QAChB,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,qDAAqD;QAElG,IAAI,CAAC,aAAa,EAAE,CAAC;YACjB,2DAA2D;YAC3D,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,uCAAuC,CAAC,CAAC;QAChF,CAAC;IACL,CAAC;IAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnC,sCAAsC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;YAC3B,MAAM,EAAE,wJAAwJ,MAAM,qCAAqC;YAC3M,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;YAC3C,SAAS,EAAE,GAAG;YACd,WAAW,EAAE,GAAG;YAChB,YAAY,EAAE,IAAI;SACrB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG;YACZ,QAAQ,EAAE,WAAW;YACrB,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACL,cAAc,EAAE,kBAAkB;gBAClC,gBAAgB,EAAE,OAAO,CAAC,MAAM;aACnC;SACJ,CAAC;QAEF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACtC,IAAI,IAAI,GAAG,EAAE,CAAC;YACd,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC;YACzC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACf,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACpC,OAAO,MAAM,CAAC,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC,CAAC;gBAC7F,CAAC;gBACD,IAAI,CAAC;oBACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAC9B,4CAA4C;oBAC5C,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;gBACvD,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACT,iDAAiD;oBACjD,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACpD,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;oBACzE,CAAC;yBAAM,CAAC;wBACJ,MAAM,CAAC,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;oBACvE,CAAC;gBACL,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;YAClB,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnB,GAAG,CAAC,GAAG,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,CAAC,OAAO,GAAG,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAAE,CAAC"}

package/engine/dist/test-framework/core.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Centralized Test Framework for Anchor Engine
+ *
+ * Implements a comprehensive testing framework with support for:
+ * - Unit tests
+ * - Integration tests
+ * - Performance tests
+ * - Dataset-specific tests
+ * - Diagnostic tests
+ */
+export interface TestResult {
+    name: string;
+    status: 'PASS' | 'FAIL' | 'SKIP';
+    duration: number;
+    error?: Error;
+    details?: any;
+}
+export interface TestConfig {
+    name: string;
+    description: string;
+    testFn: () => Promise<void> | void;
+    timeout?: number;
+    tags?: string[];
+    dependencies?: string[];
+    skip?: boolean;
+    only?: boolean;
+}
+export interface TestSuiteConfig {
+    name: string;
+    description: string;
+    tests: TestConfig[];
+    timeout?: number;
+    environment?: 'node' | 'browser' | 'integration' | string;
+    tags?: string[];
+}
+export interface TestReport {
+    suiteName: string;
+    startTime: Date;
+    endTime: Date;
+    duration: number;
+    results: TestResult[];
+    passed: number;
+    failed: number;
+    skipped: number;
+    coverage?: TestCoverage;
+}
+export interface TestCoverage {
+    files: number;
+    statements: number;
+    branches: number;
+    functions: number;
+    lines: number;
+}
+export declare class TestFramework {
+    private testSuites;
+    private reporters;
+    private globalTimeout;
+    private bailMode;
+    private verbose;
+    constructor(options?: {
+        timeout?: number;
+        bailMode?: boolean;
+        verbose?: boolean;
+    });
+    /**
+     * Register a test suite
+     */
+    addTestSuite(suite: TestSuiteConfig): void;
+    /**
+     * Add a reporter for test results
+     */
+    addReporter(reporter: Reporter): void;
+    /**
+     * Run all registered test suites
+     */
+    runAll(): Promise<TestReport[]>;
+    /**
+     * Run a specific test suite
+     */
+    runTestSuite(suite: TestSuiteConfig): Promise<TestReport>;
+    /**
+     * Run a single test case
+     */
+    runTestCase(testCase: TestConfig, timeout: number): Promise<TestResult>;
+    /**
+     * Run tests matching specific tags
+     */
+    runTestsByTag(tag: string): Promise<TestReport[]>;
+    /**
+     * Run tests matching a specific pattern
+     */
+    runTestsByName(pattern: string): Promise<TestReport[]>;
+    /**
+     * Get test statistics
+     */
+    getStats(): {
+        suites: number;
+        tests: number;
+        passed: number;
+        failed: number;
+        skipped: number;
+    };
+}
+/**
+ * Base reporter interface
+ */
+export interface Reporter {
+    generate(reports: TestReport[]): Promise<void>;
+}
+/**
+ * Console reporter
+ */
+export declare class ConsoleReporter implements Reporter {
+    generate(reports: TestReport[]): Promise<void>;
+}
+/**
+ * JSON reporter
+ */
+export declare class JSONReporter implements Reporter {
+    private outputFile;
+    constructor(outputFile?: string);
+    generate(reports: TestReport[]): Promise<void>;
+}
+/**
+ * JUnit XML reporter
+ */
+export declare class JUnitReporter implements Reporter {
+    private outputFile;
+    constructor(outputFile?: string);
+    generate(reports: TestReport[]): Promise<void>;
+}
+export declare const testFramework: TestFramework;
+//# sourceMappingURL=core.d.ts.map

package/engine/dist/test-framework/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/test-framework/core.ts"],"names":[],"mappings":"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"}

package/engine/dist/test-framework/core.js

@@ -0,0 +1,313 @@
+/**
+ * Centralized Test Framework for Anchor Engine
+ *
+ * Implements a comprehensive testing framework with support for:
+ * - Unit tests
+ * - Integration tests
+ * - Performance tests
+ * - Dataset-specific tests
+ * - Diagnostic tests
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export class TestFramework {
+    testSuites = [];
+    reporters = [];
+    globalTimeout = 30000; // 30 seconds default
+    bailMode = false; // Stop on first failure
+    verbose = false;
+    constructor(options = {}) {
+        this.globalTimeout = options.timeout || this.globalTimeout;
+        this.bailMode = options.bailMode || this.bailMode;
+        this.verbose = options.verbose || this.verbose;
+    }
+    /**
+     * Register a test suite
+     */
+    addTestSuite(suite) {
+        this.testSuites.push(suite);
+    }
+    /**
+     * Add a reporter for test results
+     */
+    addReporter(reporter) {
+        this.reporters.push(reporter);
+    }
+    /**
+     * Run all registered test suites
+     */
+    async runAll() {
+        const reports = [];
+        for (const suite of this.testSuites) {
+            const report = await this.runTestSuite(suite);
+            reports.push(report);
+            // Bail if bail mode is enabled and there was a failure
+            if (this.bailMode && report.failed > 0) {
+                break;
+            }
+        }
+        // Generate reports
+        for (const reporter of this.reporters) {
+            await reporter.generate(reports);
+        }
+        return reports;
+    }
+    /**
+     * Run a specific test suite
+     */
+    async runTestSuite(suite) {
+        const startTime = new Date();
+        const results = [];
+        let passed = 0;
+        let failed = 0;
+        let skipped = 0;
+        console.log(`\n🧪 Running Test Suite: ${suite.name}`);
+        console.log(`📝 ${suite.description}`);
+        console.log(`📊 Tests: ${suite.tests.length}`);
+        // Filter tests based on 'only' flag
+        const testsToRun = suite.tests.filter(test => !test.only) || suite.tests.filter(test => test.only);
+        for (const testCase of testsToRun) {
+            if (testCase.skip) {
+                skipped++;
+                results.push({
+                    name: testCase.name,
+                    status: 'SKIP',
+                    duration: 0,
+                    details: { description: testCase.description }
+                });
+                continue;
+            }
+            const result = await this.runTestCase(testCase, suite.timeout || this.globalTimeout);
+            results.push(result);
+            if (result.status === 'PASS') {
+                passed++;
+            }
+            else if (result.status === 'FAIL') {
+                failed++;
+                if (this.bailMode) {
+                    break;
+                }
+            }
+            // Log result
+            const statusSymbol = result.status === 'PASS' ? '✅' : result.status === 'SKIP' ? '⏭️' : '❌';
+            console.log(`  ${statusSymbol} ${testCase.name} (${result.duration}ms)`);
+            if (result.error && this.verbose) {
+                console.log(`     Error: ${result.error.message}`);
+            }
+        }
+        const endTime = new Date();
+        const duration = endTime.getTime() - startTime.getTime();
+        const report = {
+            suiteName: suite.name,
+            startTime,
+            endTime,
+            duration,
+            results,
+            passed,
+            failed,
+            skipped
+        };
+        return report;
+    }
+    /**
+     * Run a single test case
+     */
+    async runTestCase(testCase, timeout) {
+        const startTime = Date.now();
+        let timeoutId = null;
+        try {
+            // Set up timeout promise
+            const timeoutPromise = new Promise((_, reject) => {
+                timeoutId = setTimeout(() => {
+                    reject(new Error(`Test timeout after ${timeout}ms`));
+                }, timeout);
+            });
+            // Run the test with timeout protection
+            const testPromise = Promise.resolve(testCase.testFn());
+            const result = await Promise.race([testPromise, timeoutPromise]);
+            // Clear timeout if test completed successfully
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+            return {
+                name: testCase.name,
+                status: 'PASS',
+                duration: Date.now() - startTime,
+                details: { description: testCase.description }
+            };
+        }
+        catch (error) {
+            // Clear timeout if test failed
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+            return {
+                name: testCase.name,
+                status: 'FAIL',
+                duration: Date.now() - startTime,
+                error: error,
+                details: { description: testCase.description }
+            };
+        }
+    }
+    /**
+     * Run tests matching specific tags
+     */
+    async runTestsByTag(tag) {
+        const filteredSuites = this.testSuites.map(suite => ({
+            ...suite,
+            tests: suite.tests.filter(test => test.tags?.includes(tag))
+        })).filter(suite => suite.tests.length > 0);
+        const originalSuites = this.testSuites;
+        this.testSuites = filteredSuites;
+        try {
+            return await this.runAll();
+        }
+        finally {
+            // Restore original suites
+            this.testSuites = originalSuites;
+        }
+    }
+    /**
+     * Run tests matching a specific pattern
+     */
+    async runTestsByName(pattern) {
+        const filteredSuites = this.testSuites.map(suite => ({
+            ...suite,
+            tests: suite.tests.filter(test => test.name.includes(pattern))
+        })).filter(suite => suite.tests.length > 0);
+        const originalSuites = this.testSuites;
+        this.testSuites = filteredSuites;
+        try {
+            return await this.runAll();
+        }
+        finally {
+            // Restore original suites
+            this.testSuites = originalSuites;
+        }
+    }
+    /**
+     * Get test statistics
+     */
+    getStats() {
+        let totalTests = 0;
+        let totalPassed = 0;
+        let totalFailed = 0;
+        let totalSkipped = 0;
+        for (const suite of this.testSuites) {
+            totalTests += suite.tests.length;
+            totalSkipped += suite.tests.filter(t => t.skip).length;
+        }
+        return {
+            suites: this.testSuites.length,
+            tests: totalTests,
+            passed: totalPassed,
+            failed: totalFailed,
+            skipped: totalSkipped
+        };
+    }
+}
+/**
+ * Console reporter
+ */
+export class ConsoleReporter {
+    async generate(reports) {
+        console.log('\n' + '='.repeat(60));
+        console.log('TEST REPORT');
+        console.log('='.repeat(60));
+        for (const report of reports) {
+            console.log(`\nSuite: ${report.suiteName}`);
+            console.log(`Duration: ${report.duration}ms`);
+            console.log(`Passed: ${report.passed}, Failed: ${report.failed}, Skipped: ${report.skipped}`);
+            // Show failed tests
+            const failedTests = report.results.filter(r => r.status === 'FAIL');
+            if (failedTests.length > 0) {
+                console.log('\nFailed Tests:');
+                for (const test of failedTests) {
+                    console.log(`  ❌ ${test.name}`);
+                    if (test.error) {
+                        console.log(`     ${test.error.message}`);
+                    }
+                }
+            }
+        }
+        // Overall summary
+        const totalPassed = reports.reduce((sum, r) => sum + r.passed, 0);
+        const totalFailed = reports.reduce((sum, r) => sum + r.failed, 0);
+        const totalSkipped = reports.reduce((sum, r) => sum + r.skipped, 0);
+        const totalTests = totalPassed + totalFailed + totalSkipped;
+        console.log('\n' + '='.repeat(60));
+        console.log(`TOTAL: ${totalTests} tests (${totalPassed} passed, ${totalFailed} failed, ${totalSkipped} skipped)`);
+        console.log('='.repeat(60));
+        if (totalFailed > 0) {
+            console.log('❌ Some tests failed');
+            process.exit(1);
+        }
+        else {
+            console.log('✅ All tests passed');
+            process.exit(0);
+        }
+    }
+}
+/**
+ * JSON reporter
+ */
+export class JSONReporter {
+    outputFile;
+    constructor(outputFile = 'test-report.json') {
+        this.outputFile = outputFile;
+    }
+    async generate(reports) {
+        const reportData = {
+            timestamp: new Date().toISOString(),
+            reports,
+            summary: {
+                totalSuites: reports.length,
+                totalTests: reports.reduce((sum, r) => r.results.length, 0),
+                totalPassed: reports.reduce((sum, r) => sum + r.passed, 0),
+                totalFailed: reports.reduce((sum, r) => sum + r.failed, 0),
+                totalSkipped: reports.reduce((sum, r) => sum + r.skipped, 0)
+            }
+        };
+        await fs.promises.writeFile(this.outputFile, JSON.stringify(reportData, null, 2));
+        console.log(`\n📊 JSON report saved to: ${this.outputFile}`);
+    }
+}
+/**
+ * JUnit XML reporter
+ */
+export class JUnitReporter {
+    outputFile;
+    constructor(outputFile = 'test-report.xml') {
+        this.outputFile = outputFile;
+    }
+    async generate(reports) {
+        let xml = '<?xml version="1.0" encoding="UTF-8"?>\n<testsuites>\n';
+        for (const report of reports) {
+            xml += `  <testsuite name="${report.suiteName}" tests="${report.results.length}" failures="${report.failed}" errors="0" skipped="${report.skipped}" time="${report.duration / 1000}">\n`;
+            for (const result of report.results) {
+                xml += `    <testcase name="${result.name}" time="${result.duration / 1000}"`;
+                if (result.status === 'FAIL') {
+                    xml += `>\n      <failure message="${result.error?.message || 'Unknown error'}"><![CDATA[${result.error?.stack || ''}]]></failure>\n    </testcase>\n`;
+                }
+                else if (result.status === 'SKIP') {
+                    xml += `>\n      <skipped/>\n    </testcase>\n`;
+                }
+                else {
+                    xml += '/>\n';
+                }
+            }
+            xml += '  </testsuite>\n';
+        }
+        xml += '</testsuites>';
+        await fs.promises.writeFile(this.outputFile, xml);
+        console.log(`\n📊 JUnit XML report saved to: ${this.outputFile}`);
+    }
+}
+// Export a default instance for convenience
+export const testFramework = new TestFramework();
+// Export the core classes and types
+//# sourceMappingURL=core.js.map