deepdebug-local-agent 0.3.1 → 0.3.2

package/bin/install.js

@@ -0,0 +1,419 @@
+#!/usr/bin/env node
+/**
+ * Insptech AI Local Agent — Installer
+ *
+ * Usage:
+ *   npx @insptech/agent install
+ *
+ * What it does:
+ *   1. Asks for API Key (ia_live_...)
+ *   2. Validates the key against the platform
+ *   3. Installs the agent as a background service
+ *   4. Registers the machine on the platform
+ */
+
+import { createInterface } from 'readline';
+import { execSync, spawn } from 'child_process';
+import { writeFileSync, mkdirSync, existsSync } from 'fs';
+import { homedir, platform, hostname } from 'os';
+import { join } from 'path';
+
+const PLATFORM_URL = process.env.INSPTECH_URL || 'https://gateway.insptech.pt';
+const AGENT_PORT   = process.env.AGENT_PORT   || '5055';
+const VERSION      = '1.0.0';
+
+// ============================================
+// COLOURS
+// ============================================
+const c = {
+    reset:  '\x1b[0m',
+    bold:   '\x1b[1m',
+    green:  '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue:   '\x1b[34m',
+    red:    '\x1b[31m',
+    cyan:   '\x1b[36m',
+    grey:   '\x1b[90m',
+};
+
+function log(msg)    { console.log(msg); }
+function ok(msg)     { console.log(`${c.green}✅ ${msg}${c.reset}`); }
+function warn(msg)   { console.log(`${c.yellow}⚠️  ${msg}${c.reset}`); }
+function error(msg)  { console.log(`${c.red}❌ ${msg}${c.reset}`); }
+function info(msg)   { console.log(`${c.cyan}ℹ️  ${msg}${c.reset}`); }
+function step(n, msg){ console.log(`\n${c.bold}${c.blue}[${n}]${c.reset} ${c.bold}${msg}${c.reset}`); }
+
+// ============================================
+// PROMPT HELPER
+// ============================================
+function prompt(question, hidden = false) {
+    return new Promise(resolve => {
+        const rl = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            terminal: true
+        });
+
+        if (hidden) {
+            process.stdout.write(question);
+            process.stdin.setRawMode?.(true);
+            let input = '';
+            process.stdin.once('data', function handler(chunk) {
+                const char = chunk.toString();
+                if (char === '\r' || char === '\n') {
+                    process.stdin.setRawMode?.(false);
+                    process.stdout.write('\n');
+                    rl.close();
+                    resolve(input);
+                } else if (char === '\u0003') {
+                    process.exit();
+                } else if (char === '\u007f') {
+                    if (input.length > 0) {
+                        input = input.slice(0, -1);
+                        process.stdout.write('\b \b');
+                    }
+                } else {
+                    input += char;
+                    process.stdout.write('*');
+                }
+                if (char !== '\r' && char !== '\n') {
+                    process.stdin.once('data', handler);
+                }
+            });
+        } else {
+            rl.question(question, answer => {
+                rl.close();
+                resolve(answer.trim());
+            });
+        }
+    });
+}
+
+// ============================================
+// VALIDATE API KEY FORMAT
+// ============================================
+function isValidKeyFormat(key) {
+    return /^ia_live_[a-zA-Z0-9]{24,}$/.test(key);
+}
+
+// ============================================
+// VALIDATE API KEY AGAINST PLATFORM
+// ============================================
+async function validateApiKey(apiKey) {
+    try {
+        const response = await fetch(`${PLATFORM_URL}/api/v1/agent/validate-key`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'X-Agent-Key': apiKey
+            },
+            body: JSON.stringify({
+                hostname: hostname(),
+                platform: platform(),
+                version: VERSION
+            }),
+            signal: AbortSignal.timeout(10000)
+        });
+
+        if (response.ok) {
+            const data = await response.json();
+            return { valid: true, tenantName: data.tenantName, workspaceName: data.workspaceName };
+        } else if (response.status === 401) {
+            return { valid: false, reason: 'Invalid API key' };
+        } else {
+            return { valid: false, reason: `Server returned ${response.status}` };
+        }
+    } catch (err) {
+        // Network error — allow offline install with warning
+        warn(`Could not reach platform (${err.message}). Continuing with offline install.`);
+        return { valid: true, offline: true };
+    }
+}
+
+// ============================================
+// SAVE CONFIG
+// ============================================
+function saveConfig(apiKey, port) {
+    const configDir  = join(homedir(), '.insptech');
+    const configFile = join(configDir, 'agent.json');
+
+    if (!existsSync(configDir)) mkdirSync(configDir, { recursive: true });
+
+    const config = {
+        apiKey,
+        port,
+        platformUrl: PLATFORM_URL,
+        hostname: hostname(),
+        installedAt: new Date().toISOString(),
+        version: VERSION
+    };
+
+    writeFileSync(configFile, JSON.stringify(config, null, 2), { mode: 0o600 });
+    return configFile;
+}
+
+// ============================================
+// INSTALL AS SERVICE
+// ============================================
+async function installService(apiKey, port) {
+    const os = platform();
+
+    if (os === 'darwin') {
+        return installLaunchd(apiKey, port);
+    } else if (os === 'linux') {
+        return installSystemd(apiKey, port);
+    } else if (os === 'win32') {
+        return installWindowsService(apiKey, port);
+    } else {
+        warn(`Unsupported OS (${os}). Agent will not be installed as a service.`);
+        info(`To start manually: npx @insptech/agent start --api-key ${apiKey}`);
+        return false;
+    }
+}
+
+function installLaunchd(apiKey, port) {
+    try {
+        const plistPath = join(homedir(), 'Library/LaunchAgents/pt.insptech.agent.plist');
+        const nodePath  = execSync('which node').toString().trim();
+        const agentPath = new URL('../src/server.js', import.meta.url).pathname;
+
+        const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>pt.insptech.agent</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>${nodePath}</string>
+        <string>${agentPath}</string>
+    </array>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>INSPTECH_API_KEY</key>
+        <string>${apiKey}</string>
+        <key>AGENT_PORT</key>
+        <string>${port}</string>
+        <key>GATEWAY_URL</key>
+        <string>${PLATFORM_URL}</string>
+    </dict>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <true/>
+    <key>StandardOutPath</key>
+    <string>${homedir()}/.insptech/agent.log</string>
+    <key>StandardErrorPath</key>
+    <string>${homedir()}/.insptech/agent-error.log</string>
+</dict>
+</plist>`;
+
+        writeFileSync(plistPath, plist);
+        execSync(`launchctl load ${plistPath}`);
+        ok(`macOS LaunchAgent installed: ${plistPath}`);
+        return true;
+    } catch (err) {
+        warn(`Could not install as service: ${err.message}`);
+        return false;
+    }
+}
+
+function installSystemd(apiKey, port) {
+    try {
+        const nodePath  = execSync('which node').toString().trim();
+        const agentPath = new URL('../src/server.js', import.meta.url).pathname;
+        const serviceFile = `/etc/systemd/system/insptech-agent.service`;
+
+        const service = `[Unit]
+Description=Insptech AI Local Agent
+After=network.target
+
+[Service]
+Type=simple
+ExecStart=${nodePath} ${agentPath}
+Environment=INSPTECH_API_KEY=${apiKey}
+Environment=AGENT_PORT=${port}
+Environment=GATEWAY_URL=${PLATFORM_URL}
+Restart=on-failure
+RestartSec=10
+StandardOutput=journal
+StandardError=journal
+
+[Install]
+WantedBy=multi-user.target
+`;
+        writeFileSync(serviceFile, service);
+        execSync('systemctl daemon-reload');
+        execSync('systemctl enable insptech-agent');
+        execSync('systemctl start insptech-agent');
+        ok('systemd service installed and started: insptech-agent');
+        return true;
+    } catch (err) {
+        warn(`Could not install systemd service: ${err.message}`);
+        info('Try running with sudo for system-wide service installation.');
+        return false;
+    }
+}
+
+function installWindowsService(apiKey, port) {
+    try {
+        const nodePath  = execSync('where node').toString().trim().split('\n')[0];
+        const agentPath = new URL('../src/server.js', import.meta.url).pathname.replace(/^\//, '');
+
+        // Use sc.exe to create Windows Service
+        const cmd = `sc create "Insptech AI Agent" binPath= "${nodePath} ${agentPath}" start= auto DisplayName= "Insptech AI Agent"`;
+        execSync(cmd, { shell: 'cmd.exe' });
+        execSync('sc start "Insptech AI Agent"', { shell: 'cmd.exe' });
+        ok('Windows Service installed: "Insptech AI Agent" (visible in services.msc)');
+        return true;
+    } catch (err) {
+        warn(`Could not install Windows Service: ${err.message}`);
+        info('Try running PowerShell as Administrator.');
+        return false;
+    }
+}
+
+// ============================================
+// MAIN
+// ============================================
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0] || 'install';
+
+    if (command === 'start') {
+        // Direct start (used by service managers)
+        const { default: startServer } = await import('../src/server.js');
+        return;
+    }
+
+    if (command !== 'install') {
+        log(`\nUsage: npx @insptech/agent install\n`);
+        process.exit(1);
+    }
+
+    // ============================================
+    // BANNER
+    // ============================================
+    log('');
+    log(`${c.bold}${c.blue}╔════════════════════════════════════════╗${c.reset}`);
+    log(`${c.bold}${c.blue}║      Insptech AI — Local Agent         ║${c.reset}`);
+    log(`${c.bold}${c.blue}║         Installation Wizard            ║${c.reset}`);
+    log(`${c.bold}${c.blue}╚════════════════════════════════════════╝${c.reset}`);
+    log(`${c.grey}  version ${VERSION} · insptech.pt${c.reset}`);
+    log('');
+
+    // ============================================
+    // STEP 1 — CHECK NODE VERSION
+    // ============================================
+    step(1, 'Checking requirements');
+    const nodeVersion = process.versions.node;
+    const major = parseInt(nodeVersion.split('.')[0]);
+    if (major < 18) {
+        error(`Node.js 18+ required. Current: ${nodeVersion}`);
+        info('Download from: https://nodejs.org');
+        process.exit(1);
+    }
+    ok(`Node.js ${nodeVersion}`);
+
+    // ============================================
+    // STEP 2 — API KEY
+    // ============================================
+    step(2, 'API Key');
+    log(`${c.grey}  Get your key: app.insptech.pt → Settings → Agent → Generate API Key${c.reset}`);
+    log('');
+
+    let apiKey = '';
+    let attempts = 0;
+
+    while (attempts < 3) {
+        apiKey = await prompt('  Enter your API Key: ', true);
+
+        if (!apiKey) {
+            error('API Key cannot be empty.');
+            attempts++;
+            continue;
+        }
+
+        if (!isValidKeyFormat(apiKey)) {
+            error(`Invalid format. Key must start with "ia_live_" followed by 24+ characters.`);
+            attempts++;
+            continue;
+        }
+
+        break;
+    }
+
+    if (!apiKey || !isValidKeyFormat(apiKey)) {
+        error('Installation cancelled: invalid API Key.');
+        process.exit(1);
+    }
+
+    // ============================================
+    // STEP 3 — VALIDATE KEY
+    // ============================================
+    step(3, 'Validating API Key');
+    process.stdout.write('  Connecting to Insptech AI platform...');
+
+    const validation = await validateApiKey(apiKey);
+
+    if (!validation.valid) {
+        log('');
+        error(`API Key validation failed: ${validation.reason}`);
+        info('Generate a new key at: app.insptech.pt → Settings → Agent');
+        process.exit(1);
+    }
+
+    log(` ${c.green}OK${c.reset}`);
+
+    if (!validation.offline) {
+        if (validation.tenantName) ok(`Authenticated as: ${validation.tenantName}`);
+        if (validation.workspaceName) info(`Workspace: ${validation.workspaceName}`);
+    }
+
+    // ============================================
+    // STEP 4 — PORT
+    // ============================================
+    step(4, 'Configuration');
+    const portAnswer = await prompt(`  Agent port [${AGENT_PORT}]: `);
+    const port = portAnswer || AGENT_PORT;
+    ok(`Port: ${port}`);
+
+    // ============================================
+    // STEP 5 — SAVE CONFIG
+    // ============================================
+    step(5, 'Saving configuration');
+    const configFile = saveConfig(apiKey, port);
+    ok(`Config saved: ${configFile}`);
+
+    // ============================================
+    // STEP 6 — INSTALL SERVICE
+    // ============================================
+    step(6, 'Installing service');
+    const serviceInstalled = await installService(apiKey, port);
+
+    // ============================================
+    // DONE
+    // ============================================
+    log('');
+    log(`${c.bold}${c.green}╔════════════════════════════════════════╗${c.reset}`);
+    log(`${c.bold}${c.green}║     Installation Complete! 🎉          ║${c.reset}`);
+    log(`${c.bold}${c.green}╚════════════════════════════════════════╝${c.reset}`);
+    log('');
+
+    if (serviceInstalled) {
+        ok(`Agent is running on port ${port}`);
+        info(`Logs: ${homedir()}/.insptech/agent.log`);
+    } else {
+        info(`To start manually: node src/server.js`);
+    }
+
+    log('');
+    log(`${c.grey}  Platform: ${PLATFORM_URL}${c.reset}`);
+    log(`${c.grey}  Docs:     https://docs.insptech.pt/agent${c.reset}`);
+    log('');
+}
+
+main().catch(err => {
+    error(`Unexpected error: ${err.message}`);
+    process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepdebug-local-agent",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "type": "module",
   "main": "src/server.js",
   "scripts": {