helix-assistant-cli 0.2.1 → 0.2.7

package/dist/index.js

@@ -1,5 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+// ═══════════════════════════════════════════════════════════════
+// Cross-Platform Terminal & Stream Encoding Setup
+// Compatible with: Windows CMD (CP850/437/1252/65001), PowerShell,
+// Linux terminal (xterm/kitty/gnome), and Bash (MSYS2/Git Bash/WSL).
+// ═══════════════════════════════════════════════════════════════
+if (process.stdin.setEncoding) {
+    process.stdin.setEncoding('utf-8');
+}
+if (process.stdout.setDefaultEncoding) {
+    process.stdout.setDefaultEncoding('utf-8');
+}
+if (process.stderr.setDefaultEncoding) {
+    process.stderr.setDefaultEncoding('utf-8');
+}
+// On Windows, force console code page to 65001 (UTF-8)
+if (process.platform === 'win32') {
+    try {
+        const { execSync } = require('child_process');
+        execSync('chcp 65001 >nul 2>&1', { stdio: 'ignore' });
+    }
+    catch {
+        // Silently continue if chcp is unavailable
+    }
+}
 const commander_1 = require("commander");
 const repl_1 = require("./ui/repl");
 const env_1 = require("./config/env");
@@ -7,18 +31,55 @@ const agent_client_1 = require("./client/agent-client");
 const apikey_1 = require("./commands/apikey");
 const colors_1 = require("./ui/colors");
 const banner_1 = require("./ui/banner");
+async function readStdin() {
+    if (process.stdin.isTTY) {
+        return '';
+    }
+    return new Promise((resolve) => {
+        let input = '';
+        const onData = (chunk) => {
+            input += chunk.toString();
+        };
+        process.stdin.on('data', onData);
+        process.stdin.once('end', () => {
+            cleanup();
+            if (input.charCodeAt(0) === 0xfeff)
+                input = input.slice(1);
+            resolve(input.trim());
+        });
+        process.stdin.once('error', () => {
+            cleanup();
+            resolve('');
+        });
+        // If no data arrives and stream is not ended within 300ms, abort to prevent hanging
+        const timer = setTimeout(() => {
+            cleanup();
+            if (input.charCodeAt(0) === 0xfeff)
+                input = input.slice(1);
+            resolve(input.trim());
+        }, 300);
+        function cleanup() {
+            clearTimeout(timer);
+            process.stdin.removeListener('data', onData);
+            process.stdin.pause();
+        }
+        process.stdin.resume();
+    });
+}
 const program = new commander_1.Command();
 program
     .name('helix')
     .description('HELIX - Interactive Terminal CLI for Windows AI Desktop Agent')
-    .version('0.1.0')
+    .version('0.2.7')
     .option('-u, --ws-url <url>', 'URL del servidor WebSocket del agente', (0, env_1.getWsUrl)())
     .option('-t, --token <token>', 'Token de autenticación WebSocket de HELIX', (0, env_1.getWsToken)())
+    .option('--plain', 'Desactivar formato enriquecido de Markdown y mostrar texto plano sin asteriscos')
     .action(async (options) => {
     // Default action: start interactive chat REPL
     const repl = new repl_1.HelixRepl({
         wsUrl: options.wsUrl || (0, env_1.getWsUrl)(),
         wsToken: options.token || (0, env_1.getWsToken)(),
+        plain: Boolean(options.plain),
     });
     await repl.start();
 });
@@ -30,19 +91,29 @@ program
     const repl = new repl_1.HelixRepl({
         wsUrl: opts.wsUrl || (0, env_1.getWsUrl)(),
         wsToken: opts.token || (0, env_1.getWsToken)(),
+        plain: Boolean(opts.plain),
     });
     await repl.start();
 });
 program
-    .command('run <prompt>')
-    .description('Ejecutar un prompt directamente y esperar la respuesta')
-    .action(async (promptText) => {
+    .command('run [prompt...]')
+    .description('Ejecutar un prompt directamente y esperar la respuesta (soporta pipes: cat file | helix run)')
+    .action(async (promptParts) => {
+    let promptText = (promptParts || []).join(' ').trim();
+    if (!promptText || promptText === '-') {
+        promptText = await readStdin();
+    }
+    if (!promptText) {
+        console.error((0, colors_1.RED)('Error: Debes proporcionar un prompt como argumento o a través de stdin (ej: echo "hola" | helix run).'));
+        process.exit(1);
+    }
     const opts = program.opts();
     const client = new agent_client_1.AgentClient({
         wsUrl: opts.wsUrl || (0, env_1.getWsUrl)(),
         wsToken: opts.token || (0, env_1.getWsToken)(),
         autoReconnect: false,
     });
+    console.log((0, colors_1.DIM)(`Prompt: ${promptText}\n`));
     console.log((0, colors_1.CYAN)(`Conectando con HELIX en ${client.url}...`));
     try {
         await client.connect();
@@ -51,7 +122,6 @@ program
         console.error((0, colors_1.RED)(`No se pudo conectar al agente HELIX: ${err.message}`));
         process.exit(1);
     }
-    console.log((0, colors_1.DIM)(`Prompt: ${promptText}\n`));
     const convId = `cli_run_${Date.now()}`;
     client.on('react_step', (step) => {
         process.stdout.write(`\r${(0, colors_1.DIM)(`[ReAct Step ${step?.iteration || 1}...]`)}`);

package/dist/skills/user-skill-discovery.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resolves the only user-controlled directory used by the CLI skill catalog.
+ * HELIX_SKILLS_DIR is explicit; otherwise it follows the agent's settings path.
+ */
+export declare function getUserSkillsDirectory(): string;
+/**
+ * Returns names only. The file contents are deliberately never read: skill
+ * instructions can contain secrets and are not needed for autocomplete.
+ * Discovery is shallow and rejects symlinked entries to avoid following paths
+ * outside the user's skills directory.
+ */
+export declare function discoverUserSkillNames(skillsDirectory?: string): string[];

package/dist/skills/user-skill-discovery.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserSkillsDirectory = getUserSkillsDirectory;
+exports.discoverUserSkillNames = discoverUserSkillNames;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const env_1 = require("../config/env");
+const SKILL_NAME = /^[a-z0-9][a-z0-9_-]{0,63}$/;
+/**
+ * Resolves the only user-controlled directory used by the CLI skill catalog.
+ * HELIX_SKILLS_DIR is explicit; otherwise it follows the agent's settings path.
+ */
+function getUserSkillsDirectory() {
+    const configured = process.env.HELIX_SKILLS_DIR?.trim();
+    if (configured)
+        return path_1.default.resolve(configured);
+    return path_1.default.join(path_1.default.dirname((0, env_1.getSettingsFilePath)()), 'skills');
+}
+/**
+ * Returns names only. The file contents are deliberately never read: skill
+ * instructions can contain secrets and are not needed for autocomplete.
+ * Discovery is shallow and rejects symlinked entries to avoid following paths
+ * outside the user's skills directory.
+ */
+function discoverUserSkillNames(skillsDirectory = getUserSkillsDirectory()) {
+    const root = path_1.default.resolve(skillsDirectory);
+    let entries;
+    try {
+        entries = fs_1.default.readdirSync(root, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const names = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory() || entry.isSymbolicLink() || !SKILL_NAME.test(entry.name))
+            continue;
+        const skillFile = path_1.default.join(root, entry.name, 'SKILL.md');
+        try {
+            const file = fs_1.default.lstatSync(skillFile);
+            if (file.isFile() && !file.isSymbolicLink())
+                names.push(entry.name);
+        }
+        catch {
+            // Ignore incomplete, inaccessible, or malformed user entries.
+        }
+    }
+    return names.sort((a, b) => a.localeCompare(b, undefined, { sensitivity: 'base' }));
+}

package/dist/ui/autocomplete.d.ts

@@ -8,8 +8,12 @@ export declare const SLASH_COMMANDS: CommandDefinition[];
 export declare class Autocompleter {
     private client?;
     private skills;
+    private remoteSkills;
+    private localSkills;
     private mcpTools;
-    constructor(client?: AgentClient | undefined);
+    private readonly userSkillsDirectory;
+    constructor(client?: AgentClient | undefined, userSkillsDirectory?: string);
+    private refreshLocalSkills;
     refreshSuggestions(): Promise<void>;
     getSkills(): string[];
     getMcpTools(): string[];

package/dist/ui/autocomplete.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Autocompleter = exports.SLASH_COMMANDS = void 0;
 const chalk_1 = __importDefault(require("chalk"));
 const colors_1 = require("./colors");
+const user_skill_discovery_1 = require("../skills/user-skill-discovery");
 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]' },
@@ -26,9 +27,20 @@ exports.SLASH_COMMANDS = [
 class Autocompleter {
     client;
     skills = [];
+    remoteSkills = [];
+    localSkills = [];
     mcpTools = [];
-    constructor(client) {
+    userSkillsDirectory;
+    constructor(client, userSkillsDirectory = (0, user_skill_discovery_1.getUserSkillsDirectory)()) {
         this.client = client;
+        this.userSkillsDirectory = userSkillsDirectory;
+        this.refreshLocalSkills();
+    }
+    refreshLocalSkills() {
+        this.localSkills = (0, user_skill_discovery_1.discoverUserSkillNames)(this.userSkillsDirectory);
+        const baseSkills = this.client ? this.remoteSkills : this.skills;
+        this.skills = [...new Set([...baseSkills, ...this.localSkills])]
+            .sort((a, b) => a.localeCompare(b, undefined, { sensitivity: 'base' }));
     }
     async refreshSuggestions() {
         if (!this.client || !this.client.connected)
@@ -36,7 +48,7 @@ class Autocompleter {
         try {
             const skills = await this.client.getSkills();
             if (skills) {
-                this.skills = skills.map((s) => s.name);
+                this.remoteSkills = skills.map((s) => s.name);
             }
         }
         catch {
@@ -60,6 +72,7 @@ class Autocompleter {
         catch {
             // Ignored
         }
+        this.refreshLocalSkills();
     }
     getSkills() {
         return this.skills;
@@ -72,6 +85,9 @@ class Autocompleter {
      * (line: string) => [string[], string]
      */
     completer(line) {
+        // A skill may be created by another HELIX surface while the REPL is open.
+        // Keep Tab completion current without exposing the skill file contents.
+        this.refreshLocalSkills();
         const trimmed = line.trimStart();
         // 1. Skill sub-arguments for /skill <name>
         if (trimmed.startsWith('/skill ')) {

package/dist/ui/banner.d.ts

@@ -7,18 +7,9 @@ export interface BannerStatusOptions {
     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[][][];
+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

@@ -9,126 +9,27 @@ 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
-// ───────────────────────────────────────────────────────────────
+// Exact bash logo with ANSI RGB codes - DO NOT MODIFY
 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');
+    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');
 }
-/**
- * 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 ');
@@ -139,42 +40,26 @@ function getStatusBar(options) {
     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 subtitle = ' '.repeat(tagPad) + chalk_1.default.gray('╶───') + ' ' + chalk_1.default.hex('#FF9F1C')(tagline) + ' ' + chalk_1.default.gray('───╴');
     const statusBar = getStatusBar(options);
-    // ── Visual lines ──
     const thinLine = chalk_1.default.gray('─'.repeat(width));
-    // ── Render ──
     console.log('');
     console.log(logo);
     console.log('');
@@ -183,25 +68,17 @@ function renderHeader(options, clearScreen = false) {
     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(`  ${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) {
+    if (isCapturing)
         return chalk_1.default.bgRed.white.bold(' 🎙️  VOZ DETECTADA [HEY HELIX] 🔊 ');
-    }
-    if (voiceEnabled) {
+    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;
+exports.HELIX_LOGO_ASCII = getAsciiLogo;
+exports.HELIX_BIG_ART = getAsciiLogo;
+exports.HELIX_HARD_BLOCKS = getAsciiLogo;

package/dist/ui/markdown.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Formats Markdown text for optimal display in terminal emulators,
+ * resolving visual noise from unparsed asterisks (*, **) and headers.
+ */
+export declare function formatTerminalMarkdown(content: string, plain?: boolean): string;

package/dist/ui/markdown.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTerminalMarkdown = formatTerminalMarkdown;
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Formats Markdown text for optimal display in terminal emulators,
+ * resolving visual noise from unparsed asterisks (*, **) and headers.
+ */
+function formatTerminalMarkdown(content, plain = false) {
+    if (!content)
+        return '';
+    const lines = content.split('\n');
+    const formattedLines = lines.map((line) => {
+        let formatted = line;
+        // Headers (#, ##, ###)
+        const headerMatch = formatted.match(/^(#{1,6})\s+(.*)$/);
+        if (headerMatch) {
+            const title = headerMatch[2].trim();
+            if (plain) {
+                return title.toUpperCase();
+            }
+            return chalk_1.default.hex('#FF9F1C').bold(title);
+        }
+        // Bullet lists (* item, - item)
+        if (/^\s*[*+-]\s+/.test(formatted)) {
+            formatted = formatted.replace(/^(\s*)[*+-]\s+/, (_m, indent) => {
+                return plain ? `${indent}- ` : `${indent}${chalk_1.default.hex('#FF8C00')('•')} `;
+            });
+        }
+        // Inline bold (**text** or __text__)
+        formatted = formatted.replace(/(\*\*|__)(.*?)\1/g, (_m, _delim, text) => {
+            return plain ? text : chalk_1.default.bold(text);
+        });
+        // Inline italics (*text* or _text_)
+        formatted = formatted.replace(/(?<!\*)\*([^*]+)\*(?!\*)|(?<!_)_([^_]+)_(?!_)/g, (_m, t1, t2) => {
+            const text = t1 || t2;
+            return plain ? text : chalk_1.default.whiteBright(text);
+        });
+        // Inline code (`code`)
+        formatted = formatted.replace(/`([^`]+)`/g, (_m, code) => {
+            return plain ? code : chalk_1.default.cyan(code);
+        });
+        return formatted;
+    });
+    return formattedLines.join('\n');
+}

package/dist/ui/repl.d.ts

@@ -1,6 +1,7 @@
 export interface ReplOptions {
     wsUrl: string;
     wsToken?: string;
+    plain?: boolean;
 }
 export declare class HelixRepl {
     private options;
@@ -15,6 +16,7 @@ export declare class HelixRepl {
     private activeTaskId;
     private activeTasksCount;
     private isProcessingPrompt;
+    private plain;
     constructor(options: ReplOptions);
     start(): Promise<void>;
     private _syncSettings;