helix-assistant-cli 0.0.0-stage → 0.2.4

package/dist/ui/autocomplete.js

@@ -0,0 +1,142 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Autocompleter = exports.SLASH_COMMANDS = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const colors_1 = require("./colors");
+exports.SLASH_COMMANDS = [
+    { command: '/create-skill', description: 'Crear una nueva skill interactiva para HELIX' },
+    { command: '/skill', description: 'Listar o inspeccionar skills registradas', usage: '/skill [nombre]' },
+    { command: '/mcp', description: 'Listar servidores MCP y sus herramientas' },
+    { command: '/create-mcp', description: 'Registrar y configurar un nuevo servidor MCP' },
+    { command: '/browser', description: 'Ver estado del navegador web o abrir URLs', usage: '/browser [open <url>]' },
+    { command: '/config-apikey', description: 'Configurador interactivo de API Keys (OpenAI, Anthropic, Gemini, etc.)' },
+    { command: '/show-apikey', description: 'Ver estado y validez de las API Keys configuradas' },
+    { command: '/microphone', description: 'Ver o alternar estado del micrófono', usage: '/microphone [enable|disable]' },
+    { command: '/tasks', description: 'Ver tareas activas y recientes del agente' },
+    { command: '/models', description: 'Listar modelos disponibles de proveedores configurados' },
+    { command: '/status', description: 'Mostrar resumen del estado del sistema' },
+    { command: '/clear', description: 'Limpiar pantalla y restaurar el banner de HELIX' },
+    { command: '/stop', description: 'Parada de emergencia de todas las tareas activas' },
+    { command: '/help', description: 'Mostrar ayuda de comandos y atajos' },
+    { command: '/exit', description: 'Salir del CLI' },
+];
+class Autocompleter {
+    client;
+    skills = [];
+    mcpTools = [];
+    constructor(client) {
+        this.client = client;
+    }
+    async refreshSuggestions() {
+        if (!this.client || !this.client.connected)
+            return;
+        try {
+            const skills = await this.client.getSkills();
+            if (skills) {
+                this.skills = skills.map((s) => s.name);
+            }
+        }
+        catch {
+            // Ignored if client is offline
+        }
+        try {
+            const servers = await this.client.getMcpServers();
+            if (servers) {
+                const tools = [];
+                for (const s of servers) {
+                    tools.push(s.name);
+                    if (s.tools) {
+                        for (const t of s.tools) {
+                            tools.push(`${s.name}_${t.name}`);
+                        }
+                    }
+                }
+                this.mcpTools = tools;
+            }
+        }
+        catch {
+            // Ignored
+        }
+    }
+    getSkills() {
+        return this.skills;
+    }
+    getMcpTools() {
+        return this.mcpTools;
+    }
+    /**
+     * Completer function matching readline specification:
+     * (line: string) => [string[], string]
+     */
+    completer(line) {
+        const trimmed = line.trimStart();
+        // 1. Skill sub-arguments for /skill <name>
+        if (trimmed.startsWith('/skill ')) {
+            const arg = trimmed.slice('/skill '.length).toLowerCase();
+            const hits = this.skills
+                .filter((s) => s.toLowerCase().startsWith(arg))
+                .map((s) => `/skill ${s}`);
+            return [hits.length ? hits : this.skills.map((s) => `/skill ${s}`), line];
+        }
+        // 2. Microphone sub-arguments
+        if (trimmed.startsWith('/microphone ')) {
+            const arg = trimmed.slice('/microphone '.length).toLowerCase();
+            const options = ['/microphone enable', '/microphone disable'];
+            const hits = options.filter((o) => o.toLowerCase().startsWith(trimmed.toLowerCase()));
+            return [hits.length ? hits : options, line];
+        }
+        // 3. Browser sub-arguments
+        if (trimmed.startsWith('/browser ')) {
+            const options = ['/browser open https://'];
+            return [options, line];
+        }
+        // 4. Slash command autocompletion
+        if (trimmed.startsWith('/')) {
+            const hits = exports.SLASH_COMMANDS
+                .map((c) => c.command)
+                .filter((c) => c.toLowerCase().startsWith(trimmed.toLowerCase()));
+            return [hits.length ? hits : exports.SLASH_COMMANDS.map((c) => c.command), line];
+        }
+        // 5. In-line @skill mention autocompletion
+        const lastAtMatch = /(?:^|\s)(@)([a-zA-Z0-9_-]*)$/.exec(line);
+        if (lastAtMatch) {
+            const prefix = line.slice(0, line.length - lastAtMatch[2].length);
+            const query = lastAtMatch[2].toLowerCase();
+            const matches = this.skills.filter((s) => s.toLowerCase().startsWith(query));
+            const hits = (matches.length ? matches : this.skills).map((s) => `${prefix}${s} `);
+            return [hits, line];
+        }
+        // 6. In-line #mcp mention autocompletion
+        const lastHashMatch = /(?:^|\s)(#)([a-zA-Z0-9_-]*)$/.exec(line);
+        if (lastHashMatch) {
+            const prefix = line.slice(0, line.length - lastHashMatch[2].length);
+            const query = lastHashMatch[2].toLowerCase();
+            const matches = this.mcpTools.filter((t) => t.toLowerCase().startsWith(query));
+            const hits = (matches.length ? matches : this.mcpTools).map((t) => `${prefix}${t} `);
+            return [hits, line];
+        }
+        return [[], line];
+    }
+    /**
+     * Formats the list of commands for display.
+     */
+    renderHelp() {
+        console.log('');
+        console.log(`  ${chalk_1.default.hex('#FF8C00').bold('⬡ Comandos Disponibles')}  ${chalk_1.default.gray('(/ + [Tab] para autocompletar)')}`);
+        console.log(`  ${chalk_1.default.gray('─'.repeat(50))}`);
+        for (const cmd of exports.SLASH_COMMANDS) {
+            const usage = cmd.usage ? `  ${chalk_1.default.gray(cmd.usage)}` : '';
+            console.log(`  ${chalk_1.default.magenta(cmd.command.padEnd(16))} ${chalk_1.default.gray(cmd.description)}${usage}`);
+        }
+        console.log('');
+        console.log(`  ${chalk_1.default.hex('#FF8C00').bold('⬡ Prefijos Especiales')}`);
+        console.log(`  ${chalk_1.default.gray('─'.repeat(50))}`);
+        console.log(`  ${(0, colors_1.formatSkill)('nombre')}            ${chalk_1.default.gray('Invoca una skill registrada')}`);
+        console.log(`  ${(0, colors_1.formatMcp)('herramienta')}       ${chalk_1.default.gray('Invoca herramientas MCP')}`);
+        console.log('');
+    }
+}
+exports.Autocompleter = Autocompleter;

package/dist/ui/banner.d.ts

@@ -0,0 +1,15 @@
+export interface BannerStatusOptions {
+    connected: boolean;
+    wsUrl: string;
+    voiceEnabled: boolean;
+    isCapturingVoice?: boolean;
+    currentModel?: string | null;
+    activeTasksCount?: number;
+}
+export declare function getAsciiLogo(terminalWidth?: number): string;
+export declare function getStatusBar(options: BannerStatusOptions): string;
+export declare function renderHeader(options: BannerStatusOptions, clearScreen?: boolean): void;
+export declare function getVoiceIndicator(isCapturing: boolean, voiceEnabled: boolean): string;
+export declare const HELIX_LOGO_ASCII: typeof getAsciiLogo;
+export declare const HELIX_BIG_ART: typeof getAsciiLogo;
+export declare const HELIX_HARD_BLOCKS: typeof getAsciiLogo;

package/dist/ui/banner.js

@@ -0,0 +1,84 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELIX_HARD_BLOCKS = exports.HELIX_BIG_ART = exports.HELIX_LOGO_ASCII = void 0;
+exports.getAsciiLogo = getAsciiLogo;
+exports.getStatusBar = getStatusBar;
+exports.renderHeader = renderHeader;
+exports.getVoiceIndicator = getVoiceIndicator;
+const chalk_1 = __importDefault(require("chalk"));
+// Exact bash logo with ANSI RGB codes - DO NOT MODIFY
+function getAsciiLogo(terminalWidth = 80) {
+    const lines = [
+        '   \x1b[48;2;255;227;143m\x1b[38;2;255;255;255m▀\x1b[49m\x1b[38;2;255;227;143m█   \x1b[48;2;255;227;143m\x1b[38;2;255;255;255m▀\x1b[49m\x1b[38;2;255;227;143m█\x1b[0m',
+        '   \x1b[38;2;255;210;77m██   ██       \x1b[38;2;255;255;255m██████  ██      ██  ██    ██\x1b[0m',
+        '\x1b[38;2;255;215;119m██ \x1b[38;2;255;191;31m██   ██ \x1b[38;2;255;215;119m██    \x1b[38;2;246;246;246m██      ██      ██   ██  ██\x1b[0m',
+        '\x1b[38;2;255;191;36m██ \x1b[38;2;255;171;10m███\x1b[48;2;255;171;10m\x1b[38;2;255;255;255m▀\x1b[49m\x1b[38;2;255;171;10m███ \x1b[38;2;255;191;36m██    \x1b[38;2;236;236;236m████    ██      ██     ██\x1b[0m',
+        '\x1b[38;2;255;160;18m██ \x1b[38;2;255;145;20m███████ \x1b[38;2;255;160;18m██    \x1b[38;2;226;226;226m██      ██      ██   ██  ██\x1b[0m',
+        '\x1b[38;2;255;127;26m██ \x1b[38;2;255;122;26m██   ██ \x1b[38;2;255;127;26m██    \x1b[38;2;216;216;216m██████  ██████  ██  ██    ██\x1b[0m',
+        '\x1b[38;2;240;98;15m██ \x1b[38;2;255;95;18m██   ██ \x1b[38;2;240;98;15m██\x1b[0m',
+        '   \x1b[38;2;220;74;12m██   ██\x1b[0m'
+    ];
+    const visibleWidth = 62;
+    const leftPad = Math.max(0, Math.floor((terminalWidth - visibleWidth) / 2));
+    const padding = ' '.repeat(leftPad);
+    return lines.map(line => padding + line).join('\n');
+}
+function getStatusBar(options) {
+    const conn = options.connected
+        ? `${chalk_1.default.green('●')} ${chalk_1.default.greenBright.bold('CONECTADO')} ${chalk_1.default.gray(options.wsUrl)}`
+        : `${chalk_1.default.red('●')} ${chalk_1.default.redBright.bold('DESCONECTADO')} ${chalk_1.default.gray(options.wsUrl)}`;
+    let mic;
+    if (options.isCapturingVoice) {
+        mic = chalk_1.default.bgRed.white.bold(' 🎙️ CAPTURANDO ');
+    }
+    else if (options.voiceEnabled) {
+        mic = `${chalk_1.default.green('●')} ${chalk_1.default.white('Mic')} ${chalk_1.default.gray('"hey helix"')}`;
+    }
+    else {
+        mic = `${chalk_1.default.red('●')} ${chalk_1.default.gray('Mic Off')}`;
+    }
+    const model = options.currentModel
+        ? `${chalk_1.default.hex('#FF9F1C')('⚡')} ${chalk_1.default.white(options.currentModel)}`
+        : `${chalk_1.default.hex('#FF9F1C')('⚡')} ${chalk_1.default.white('Local ReAct')}`;
+    const tasks = (options.activeTasksCount ?? 0) > 0
+        ? `  ${chalk_1.default.yellow('⏳')} ${chalk_1.default.yellowBright(String(options.activeTasksCount))}`
+        : '';
+    const sep = chalk_1.default.gray(' │ ');
+    return `  ${conn}${sep}${mic}${sep}${model}${tasks}`;
+}
+function renderHeader(options, clearScreen = false) {
+    if (clearScreen) {
+        process.stdout.write('\x1bc');
+    }
+    const width = process.stdout.columns || 80;
+    const logo = getAsciiLogo(width);
+    const tagline = 'Persistent AI Desktop Agent';
+    const tagPad = Math.max(0, Math.floor((width - tagline.length - 8) / 2));
+    const subtitle = ' '.repeat(tagPad) + chalk_1.default.gray('╶───') + ' ' + chalk_1.default.hex('#FF9F1C')(tagline) + ' ' + chalk_1.default.gray('───╴');
+    const statusBar = getStatusBar(options);
+    const thinLine = chalk_1.default.gray('─'.repeat(width));
+    console.log('');
+    console.log(logo);
+    console.log('');
+    console.log(subtitle);
+    console.log('');
+    console.log(thinLine);
+    console.log(statusBar);
+    console.log(thinLine);
+    console.log(`  ${chalk_1.default.hex('#FF8C00')('@skill')} ${chalk_1.default.gray('Skills')}  ${chalk_1.default.gray('│')}  ${chalk_1.default.cyan('#mcp')} ${chalk_1.default.gray('Herramientas')}  ${chalk_1.default.gray('│')}  ${chalk_1.default.magenta('/help')} ${chalk_1.default.gray('Comandos')}`);
+    console.log(thinLine);
+    console.log('');
+}
+function getVoiceIndicator(isCapturing, voiceEnabled) {
+    if (isCapturing)
+        return chalk_1.default.bgRed.white.bold(' 🎙️  VOZ DETECTADA [HEY HELIX] 🔊 ');
+    if (voiceEnabled)
+        return chalk_1.default.green('🟢 [Mic Activo]');
+    return chalk_1.default.red('🔴 [Mic Inactivo]');
+}
+exports.HELIX_LOGO_ASCII = getAsciiLogo;
+exports.HELIX_BIG_ART = getAsciiLogo;
+exports.HELIX_HARD_BLOCKS = getAsciiLogo;

package/dist/ui/chat.d.ts

@@ -0,0 +1 @@
+export { HelixRepl, type ReplOptions } from './repl';

package/dist/ui/chat.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HelixRepl = void 0;
+var repl_1 = require("./repl");
+Object.defineProperty(exports, "HelixRepl", { enumerable: true, get: function () { return repl_1.HelixRepl; } });

package/dist/ui/colors.d.ts

@@ -0,0 +1,34 @@
+import chalk from 'chalk';
+export declare const customChalk: chalk.Chalk;
+export declare const ORANGE: chalk.Chalk;
+export declare const ORANGE_BOLD: chalk.Chalk;
+export declare const ORANGE_BG: chalk.Chalk;
+export declare const CYAN: chalk.Chalk;
+export declare const CYAN_BOLD: chalk.Chalk;
+export declare const MAGENTA: chalk.Chalk;
+export declare const MAGENTA_BOLD: chalk.Chalk;
+export declare const GREEN: chalk.Chalk;
+export declare const GREEN_BOLD: chalk.Chalk;
+export declare const RED: chalk.Chalk;
+export declare const RED_BOLD: chalk.Chalk;
+export declare const YELLOW: chalk.Chalk;
+export declare const YELLOW_BOLD: chalk.Chalk;
+export declare const GRAY: chalk.Chalk;
+export declare const BOLD: chalk.Chalk;
+export declare const DIM: chalk.Chalk;
+/**
+ * Highlights skill names with strong orange (#FF8C00).
+ */
+export declare function formatSkill(name: string): string;
+/**
+ * Highlights MCP tool/server names.
+ */
+export declare function formatMcp(name: string): string;
+/**
+ * Highlights slash commands.
+ */
+export declare function formatCommand(cmd: string): string;
+/**
+ * Formats user input text highlighting @skills in orange and #mcps in cyan.
+ */
+export declare function highlightMentions(text: string, knownSkills?: string[]): string;

package/dist/ui/colors.js

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DIM = exports.BOLD = exports.GRAY = exports.YELLOW_BOLD = exports.YELLOW = exports.RED_BOLD = exports.RED = exports.GREEN_BOLD = exports.GREEN = exports.MAGENTA_BOLD = exports.MAGENTA = exports.CYAN_BOLD = exports.CYAN = exports.ORANGE_BG = exports.ORANGE_BOLD = exports.ORANGE = exports.customChalk = void 0;
+exports.formatSkill = formatSkill;
+exports.formatMcp = formatMcp;
+exports.formatCommand = formatCommand;
+exports.highlightMentions = highlightMentions;
+const chalk_1 = __importDefault(require("chalk"));
+exports.customChalk = new chalk_1.default.Instance({ level: 3 });
+// Brand colors
+exports.ORANGE = exports.customChalk.hex('#FF8C00');
+exports.ORANGE_BOLD = exports.customChalk.hex('#FF8C00').bold;
+exports.ORANGE_BG = exports.customChalk.bgHex('#FF8C00').black.bold;
+exports.CYAN = exports.customChalk.cyan;
+exports.CYAN_BOLD = exports.customChalk.cyan.bold;
+exports.MAGENTA = exports.customChalk.magenta;
+exports.MAGENTA_BOLD = exports.customChalk.magenta.bold;
+exports.GREEN = exports.customChalk.green;
+exports.GREEN_BOLD = exports.customChalk.green.bold;
+exports.RED = exports.customChalk.red;
+exports.RED_BOLD = exports.customChalk.red.bold;
+exports.YELLOW = exports.customChalk.yellow;
+exports.YELLOW_BOLD = exports.customChalk.yellow.bold;
+exports.GRAY = exports.customChalk.gray;
+exports.BOLD = exports.customChalk.bold;
+exports.DIM = exports.customChalk.dim;
+/**
+ * Highlights skill names with strong orange (#FF8C00).
+ */
+function formatSkill(name) {
+    const clean = name.startsWith('@') ? name : `@${name}`;
+    return (0, exports.ORANGE_BOLD)(clean);
+}
+/**
+ * Highlights MCP tool/server names.
+ */
+function formatMcp(name) {
+    const clean = name.startsWith('#') ? name : `#${name}`;
+    return (0, exports.CYAN_BOLD)(clean);
+}
+/**
+ * Highlights slash commands.
+ */
+function formatCommand(cmd) {
+    const clean = cmd.startsWith('/') ? cmd : `/${cmd}`;
+    return (0, exports.MAGENTA_BOLD)(clean);
+}
+/**
+ * Formats user input text highlighting @skills in orange and #mcps in cyan.
+ */
+function highlightMentions(text, knownSkills = []) {
+    let result = text;
+    // Highlight @skill in orange
+    result = result.replace(/(^|\s)(@[a-zA-Z0-9_-]+)/g, (_match, prefix, mention) => {
+        return `${prefix}${(0, exports.ORANGE_BOLD)(mention)}`;
+    });
+    // Highlight #mcp in cyan
+    result = result.replace(/(^|\s)(#[a-zA-Z0-9_-]+)/g, (_match, prefix, mention) => {
+        return `${prefix}${(0, exports.CYAN_BOLD)(mention)}`;
+    });
+    // Highlight /commands in magenta
+    result = result.replace(/(^|\s)(\/[a-zA-Z0-9_-]+)/g, (_match, prefix, mention) => {
+        return `${prefix}${(0, exports.MAGENTA_BOLD)(mention)}`;
+    });
+    return result;
+}

package/dist/ui/repl.d.ts

@@ -0,0 +1,31 @@
+export interface ReplOptions {
+    wsUrl: string;
+    wsToken?: string;
+}
+export declare class HelixRepl {
+    private options;
+    private rl;
+    private client;
+    private autocompleter;
+    private conversationId;
+    private conversationHistory;
+    private voiceEnabled;
+    private isCapturingVoice;
+    private currentModel;
+    private activeTaskId;
+    private activeTasksCount;
+    private isProcessingPrompt;
+    constructor(options: ReplOptions);
+    start(): Promise<void>;
+    private _syncSettings;
+    refreshBanner(clearScreen?: boolean): void;
+    private waitingLogged;
+    private _setupClientEvents;
+    private _handleConfirmationDialog;
+    private _startReadline;
+    private _promptUser;
+    private _handleInputLine;
+    private _handleListTasks;
+    private _handleListModels;
+    private _handleStatus;
+}