helix-assistant-cli 0.0.0-stage → 0.2.1

package/dist/ui/banner.d.ts

@@ -0,0 +1,24 @@
+export interface BannerStatusOptions {
+    connected: boolean;
+    wsUrl: string;
+    voiceEnabled: boolean;
+    isCapturingVoice?: boolean;
+    currentModel?: string | null;
+    activeTasksCount?: number;
+}
+export declare function getAsciiLogo(terminalWidth?: number): string;
+/**
+ * Compact, badge-style status bar.
+ */
+export declare function getStatusBar(options: BannerStatusOptions): string;
+/**
+ * Renders the persistent header. Clears screen only if clearScreen is explicitly true.
+ */
+export declare function renderHeader(options: BannerStatusOptions, clearScreen?: boolean): void;
+/**
+ * Voice-capture indicator badge (for inline use in prompts).
+ */
+export declare function getVoiceIndicator(isCapturing: boolean, voiceEnabled: boolean): string;
+export declare const HELIX_LOGO_ASCII: number[][][];
+export declare const HELIX_BIG_ART: number[][][];
+export declare const HELIX_HARD_BLOCKS: number[][][];

package/dist/ui/banner.js

@@ -0,0 +1,207 @@
+"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"));
+// ═══════════════════════════════════════════════════════════════
+//  HELIX — Pixel-art dot-matrix logo.
+//  Each letter is drawn on an 8-row × 5-col grid.
+//  "On" pixels → "██" block, "off" pixels → "  " (space).
+//  Gradient runs top → bottom:
+//    rows 0-1 : bright white/cream
+//    rows 2-3 : bright yellow
+//    rows 4-5 : orange
+//    rows 6-7 : deep red
+//  Matches the pixel-art HELIX image with yellow→orange→red gradient.
+// ═══════════════════════════════════════════════════════════════
+// ── Letter bitmaps — 1=on, 0=off, 8 rows × 5 cols each ────────
+const H = [
+    [1, 0, 0, 0, 1],
+    [1, 0, 0, 0, 1],
+    [1, 1, 1, 1, 1],
+    [1, 1, 1, 1, 1],
+    [1, 1, 1, 1, 1],
+    [1, 0, 0, 0, 1],
+    [1, 0, 0, 0, 1],
+    [1, 0, 0, 0, 1],
+];
+const E = [
+    [1, 1, 1, 1, 1],
+    [1, 0, 0, 0, 0],
+    [1, 1, 1, 1, 0],
+    [1, 1, 1, 1, 0],
+    [1, 1, 1, 1, 0],
+    [1, 0, 0, 0, 0],
+    [1, 0, 0, 0, 0],
+    [1, 1, 1, 1, 1],
+];
+const L = [
+    [1, 0, 0, 0, 0],
+    [1, 0, 0, 0, 0],
+    [1, 0, 0, 0, 0],
+    [1, 0, 0, 0, 0],
+    [1, 0, 0, 0, 0],
+    [1, 0, 0, 0, 0],
+    [1, 0, 0, 0, 0],
+    [1, 1, 1, 1, 1],
+];
+const I = [
+    [1, 1, 1, 1, 1],
+    [0, 0, 1, 0, 0],
+    [0, 0, 1, 0, 0],
+    [0, 0, 1, 0, 0],
+    [0, 0, 1, 0, 0],
+    [0, 0, 1, 0, 0],
+    [0, 0, 1, 0, 0],
+    [1, 1, 1, 1, 1],
+];
+const X = [
+    [1, 0, 0, 0, 1],
+    [1, 1, 0, 1, 1],
+    [0, 1, 1, 1, 0],
+    [0, 0, 1, 0, 0],
+    [0, 0, 1, 0, 0],
+    [0, 1, 1, 1, 0],
+    [1, 1, 0, 1, 1],
+    [1, 0, 0, 0, 1],
+];
+const LETTERS = [H, E, L, I, X];
+const LETTER_GAP = 1; // 1 empty col between letters
+const ROWS = 8;
+const COLS_PER_LETTER = 5;
+// ── Top-to-bottom gradient — cream/white → yellow → orange → red ──
+// Row 0 = top, row 7 = bottom
+const ROW_COLORS = [
+    '#FFF9E0', // 0 — near-white cream
+    '#FFE84D', // 1 — bright yellow
+    '#FFD200', // 2 — gold yellow
+    '#FFB300', // 3 — amber
+    '#FF8C00', // 4 — orange
+    '#FF6600', // 5 — deep orange
+    '#E63000', // 6 — red-orange
+    '#CC1A00', // 7 — deep red
+];
+const BLOCK_ON = '██'; // filled square block
+const BLOCK_OFF = '  '; // empty (black background)
+// ───────────────────────────────────────────────────────────────
+//  Public API
+// ───────────────────────────────────────────────────────────────
+function getAsciiLogo(terminalWidth = 80) {
+    // total character width: each cell = 2 chars
+    const totalCols = LETTERS.length * COLS_PER_LETTER + (LETTERS.length - 1) * LETTER_GAP;
+    const totalChars = totalCols * 2;
+    const leftPad = Math.max(0, Math.floor((terminalWidth - totalChars) / 2));
+    const pad = ' '.repeat(leftPad);
+    const lines = [];
+    for (let row = 0; row < ROWS; row++) {
+        let line = pad;
+        for (let li = 0; li < LETTERS.length; li++) {
+            const letter = LETTERS[li];
+            for (let col = 0; col < COLS_PER_LETTER; col++) {
+                if (letter[row][col]) {
+                    line += chalk_1.default.hex(ROW_COLORS[row]).bold(BLOCK_ON);
+                }
+                else {
+                    line += BLOCK_OFF;
+                }
+            }
+            // gap between letters
+            if (li < LETTERS.length - 1) {
+                line += BLOCK_OFF.repeat(LETTER_GAP);
+            }
+        }
+        lines.push(line);
+    }
+    return lines.join('\n');
+}
+/**
+ * Compact, badge-style status bar.
+ */
+function getStatusBar(options) {
+    // ── Connection ──
+    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)}`;
+    // ── Microphone ──
+    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')}`;
+    }
+    // ── Model ──
+    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')}`;
+    // ── Active tasks ──
+    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}`;
+}
+/**
+ * Renders the persistent header. Clears screen only if clearScreen is explicitly true.
+ */
+function renderHeader(options, clearScreen = false) {
+    if (clearScreen) {
+        // Clear screen + move cursor to top-left
+        process.stdout.write('\x1bc');
+    }
+    const width = process.stdout.columns || 80;
+    // ── Logo ──
+    const logo = getAsciiLogo(width);
+    // ── Tagline ──
+    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('───╴');
+    // ── Status bar ──
+    const statusBar = getStatusBar(options);
+    // ── Visual lines ──
+    const thinLine = chalk_1.default.gray('─'.repeat(width));
+    // ── Render ──
+    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('');
+}
+/**
+ * Voice-capture indicator badge (for inline use in prompts).
+ */
+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]');
+}
+// Legacy named exports kept for compatibility with other modules
+exports.HELIX_LOGO_ASCII = LETTERS;
+exports.HELIX_BIG_ART = LETTERS;
+exports.HELIX_HARD_BLOCKS = LETTERS;

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;
+}