helix-assistant-cli 0.2.7 → 0.2.9

package/dist/client/agent-client.d.ts

@@ -42,6 +42,7 @@ export declare class AgentClient extends EventEmitter {
     getProviders(): Promise<ProviderSummary[]>;
     getModels(requirements?: Record<string, unknown>): Promise<ModelSummary[]>;
     getSettings(): Promise<HelixSettings>;
+    getCapabilities(): Promise<Record<string, unknown>>;
     saveSettings(settings: Partial<HelixSettings>): Promise<HelixSettings>;
     validateKey(provider: string, slot: number, key: string): Promise<string>;
     getSkills(): Promise<SkillSummary[]>;

package/dist/client/agent-client.js

@@ -265,6 +265,9 @@ class AgentClient extends events_1.EventEmitter {
     async getSettings() {
         return this.request('GET_SETTINGS', {});
     }
+    async getCapabilities() {
+        return this.request('GET_CAPABILITIES', {});
+    }
     async saveSettings(settings) {
         return this.request('SAVE_SETTINGS', { settings });
     }

package/dist/commands/diagnostics.d.ts

@@ -0,0 +1,4 @@
+import type { AgentClient } from '../client/agent-client';
+export declare function handleProviders(client: AgentClient): Promise<void>;
+export declare function handleCapabilities(client: AgentClient): Promise<void>;
+export declare function handleSettings(client: AgentClient): Promise<void>;

package/dist/commands/diagnostics.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleProviders = handleProviders;
+exports.handleCapabilities = handleCapabilities;
+exports.handleSettings = handleSettings;
+const colors_1 = require("../ui/colors");
+async function handleProviders(client) {
+    try {
+        const providers = await client.getProviders();
+        console.log(`\n${(0, colors_1.BOLD)('🧠 Proveedores configurados:')}\n`);
+        for (const provider of providers) {
+            const state = provider.configured ? (0, colors_1.GREEN)('configurado') : (0, colors_1.GRAY)('sin clave');
+            console.log(`  ${(0, colors_1.CYAN)(provider.name || provider.id)}  [${state}]  ${(0, colors_1.DIM)(`${provider.models_available} modelos`)}`);
+            for (const key of provider.keys || []) {
+                console.log(`    ${(0, colors_1.DIM)(`slot ${key.slot}:`)} ${key.configured ? (0, colors_1.GREEN)(key.health) : (0, colors_1.GRAY)('vacío')} ${key.masked || ''}`);
+            }
+        }
+        console.log('');
+    }
+    catch (err) {
+        console.log((0, colors_1.RED)(`  Error consultando proveedores: ${err.message}\n`));
+    }
+}
+async function handleCapabilities(client) {
+    try {
+        const caps = await client.getCapabilities();
+        console.log(`\n${(0, colors_1.BOLD)('⚙ Capacidades activas:')}\n`);
+        for (const [key, value] of Object.entries(caps)) {
+            const rendered = typeof value === 'boolean' ? (value ? (0, colors_1.GREEN)('activo') : (0, colors_1.YELLOW)('inactivo')) : (0, colors_1.CYAN)(String(value));
+            console.log(`  ${(0, colors_1.DIM)(key.padEnd(24))} ${rendered}`);
+        }
+        console.log('');
+    }
+    catch (err) {
+        console.log((0, colors_1.RED)(`  Error consultando capacidades: ${err.message}\n`));
+    }
+}
+async function handleSettings(client) {
+    try {
+        const settings = await client.getSettings();
+        const safe = Object.fromEntries(Object.entries(settings).filter(([key]) => !/key|token|secret|password|auth/i.test(key)));
+        console.log(`\n${(0, colors_1.BOLD)('📋 Configuración efectiva (sin secretos):')}\n${JSON.stringify(safe, null, 2)}\n`);
+    }
+    catch (err) {
+        console.log((0, colors_1.RED)(`  Error consultando configuración: ${err.message}\n`));
+    }
+}

package/dist/commands/mcp.d.ts

@@ -1,3 +1,4 @@
 import type { AgentClient } from '../client/agent-client';
+export declare function handleMcpDefaults(): void;
 export declare function handleListMcp(client: AgentClient): Promise<void>;
 export declare function handleCreateMcp(client: AgentClient): Promise<void>;

package/dist/commands/mcp.js

@@ -3,11 +3,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleMcpDefaults = handleMcpDefaults;
 exports.handleListMcp = handleListMcp;
 exports.handleCreateMcp = handleCreateMcp;
 const prompts_1 = __importDefault(require("prompts"));
 const chalk_1 = __importDefault(require("chalk"));
 const colors_1 = require("../ui/colors");
+const mcp_defaults_1 = require("../config/mcp-defaults");
+function handleMcpDefaults() {
+    console.log(`\n${(0, colors_1.BOLD)('📦 MCPs recomendados (catálogo, no activados automáticamente):')}\n`);
+    for (const item of mcp_defaults_1.MCP_DEFAULTS) {
+        console.log(`  ${(0, colors_1.CYAN_BOLD)('◈')} ${(0, colors_1.formatMcp)(item.id)} — ${item.label}`);
+        console.log(`    ${(0, colors_1.DIM)(item.purpose)} | ${item.activation} | ${item.privacy}`);
+    }
+    console.log((0, colors_1.DIM)('\nActiva cada MCP individualmente con consentimiento y alcance explícito.\n'));
+}
 async function handleListMcp(client) {
     console.log(`\n${(0, colors_1.BOLD)('🔌 Servidores y Herramientas MCP:')}\n`);
     try {

package/dist/config/mcp-defaults.d.ts

@@ -0,0 +1,10 @@
+export interface McpDefaultDefinition {
+    id: string;
+    label: string;
+    purpose: string;
+    transport: 'stdio' | 'connector';
+    activation: 'local-opt-in' | 'oauth-opt-in';
+    privacy: string;
+}
+/** Catalog only: entries are never enabled or installed automatically. */
+export declare const MCP_DEFAULTS: McpDefaultDefinition[];

package/dist/config/mcp-defaults.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_DEFAULTS = void 0;
+/** Catalog only: entries are never enabled or installed automatically. */
+exports.MCP_DEFAULTS = [
+    { id: 'filesystem', label: 'Archivos locales', purpose: 'Carpeta elegida por el usuario', transport: 'stdio', activation: 'local-opt-in', privacy: 'Solo rutas autorizadas' },
+    { id: 'obsidian', label: 'Obsidian / Helix Vault', purpose: 'Leer y gestionar una bóveda concreta', transport: 'stdio', activation: 'local-opt-in', privacy: 'Solo la bóveda seleccionada' },
+    { id: 'vscode', label: 'VS Code', purpose: 'Trabajar con el workspace seleccionado', transport: 'stdio', activation: 'local-opt-in', privacy: 'Solo el workspace seleccionado' },
+    { id: 'github', label: 'GitHub', purpose: 'Repositorios, issues y pull requests', transport: 'stdio', activation: 'oauth-opt-in', privacy: 'Requiere token u OAuth del usuario' },
+    { id: 'gmail', label: 'Gmail', purpose: 'Correo y búsqueda de mensajes', transport: 'connector', activation: 'oauth-opt-in', privacy: 'Requiere OAuth explícito del usuario' },
+    { id: 'notion', label: 'Notion', purpose: 'Páginas y bases de datos', transport: 'connector', activation: 'oauth-opt-in', privacy: 'Requiere integración autorizada' },
+];

package/dist/index.js

@@ -70,7 +70,7 @@ const program = new commander_1.Command();
 program
     .name('helix')
     .description('HELIX - Interactive Terminal CLI for Windows AI Desktop Agent')
-    .version('0.2.7')
+    .version('0.2.9')
     .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')

package/dist/ui/autocomplete.js

@@ -10,7 +10,7 @@ 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]' },
-    { command: '/mcp', description: 'Listar servidores MCP y sus herramientas' },
+    { command: '/mcp', description: 'Listar servidores MCP y sus herramientas', usage: '/mcp [defaults]' },
     { 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.)' },
@@ -19,6 +19,9 @@ exports.SLASH_COMMANDS = [
     { 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: '/providers', description: 'Ver proveedores configurados y salud de sus claves' },
+    { command: '/capabilities', description: 'Ver capacidades activas: sandbox, subagentes, voz y browser' },
+    { command: '/settings', description: 'Ver configuración efectiva sin exponer secretos' },
     { 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' },

package/dist/ui/repl.js

@@ -17,6 +17,7 @@ const mcp_1 = require("../commands/mcp");
 const mic_1 = require("../commands/mic");
 const browser_1 = require("../commands/browser");
 const markdown_1 = require("./markdown");
+const diagnostics_1 = require("../commands/diagnostics");
 class HelixRepl {
     options;
     rl = null;
@@ -316,7 +317,10 @@ class HelixRepl {
                     }
                     break;
                 case '/mcp':
-                    await (0, mcp_1.handleListMcp)(this.client);
+                    if (args?.trim().toLowerCase() === 'defaults')
+                        (0, mcp_1.handleMcpDefaults)();
+                    else
+                        await (0, mcp_1.handleListMcp)(this.client);
                     break;
                 case '/create-mcp':
                     this.rl?.pause();
@@ -351,6 +355,15 @@ class HelixRepl {
                 case '/status':
                     await this._handleStatus();
                     break;
+                case '/providers':
+                    await (0, diagnostics_1.handleProviders)(this.client);
+                    break;
+                case '/capabilities':
+                    await (0, diagnostics_1.handleCapabilities)(this.client);
+                    break;
+                case '/settings':
+                    await (0, diagnostics_1.handleSettings)(this.client);
+                    break;
                 case '/stop':
                     console.log((0, colors_1.RED_BOLD)('\n[PARADA DE EMERGENCIA]: Cancelando todas las tareas activas...'));
                     this.client.emergencyStop();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helix-assistant-cli",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "HELIX - Interactive Terminal CLI for Windows AI Desktop Agent",
   "private": false,
   "publishConfig": {

package/src/client/agent-client.ts

@@ -319,6 +319,10 @@ export class AgentClient extends EventEmitter {
     return this.request<HelixSettings>('GET_SETTINGS', {});
   }
 
+  public async getCapabilities(): Promise<Record<string, unknown>> {
+    return this.request<Record<string, unknown>>('GET_CAPABILITIES', {});
+  }
+
   public async saveSettings(settings: Partial<HelixSettings>): Promise<HelixSettings> {
     return this.request<HelixSettings>('SAVE_SETTINGS', { settings });
   }

package/src/commands/diagnostics.ts

@@ -0,0 +1,38 @@
+import chalk from 'chalk';
+import type { AgentClient } from '../client/agent-client';
+import { BOLD, CYAN, DIM, GREEN, GRAY, RED, YELLOW } from '../ui/colors';
+
+export async function handleProviders(client: AgentClient): Promise<void> {
+  try {
+    const providers = await client.getProviders();
+    console.log(`\n${BOLD('🧠 Proveedores configurados:')}\n`);
+    for (const provider of providers) {
+      const state = provider.configured ? GREEN('configurado') : GRAY('sin clave');
+      console.log(`  ${CYAN(provider.name || provider.id)}  [${state}]  ${DIM(`${provider.models_available} modelos`)}`);
+      for (const key of provider.keys || []) {
+        console.log(`    ${DIM(`slot ${key.slot}:`)} ${key.configured ? GREEN(key.health) : GRAY('vacío')} ${key.masked || ''}`);
+      }
+    }
+    console.log('');
+  } catch (err) { console.log(RED(`  Error consultando proveedores: ${(err as Error).message}\n`)); }
+}
+
+export async function handleCapabilities(client: AgentClient): Promise<void> {
+  try {
+    const caps = await client.getCapabilities();
+    console.log(`\n${BOLD('⚙ Capacidades activas:')}\n`);
+    for (const [key, value] of Object.entries(caps)) {
+      const rendered = typeof value === 'boolean' ? (value ? GREEN('activo') : YELLOW('inactivo')) : CYAN(String(value));
+      console.log(`  ${DIM(key.padEnd(24))} ${rendered}`);
+    }
+    console.log('');
+  } catch (err) { console.log(RED(`  Error consultando capacidades: ${(err as Error).message}\n`)); }
+}
+
+export async function handleSettings(client: AgentClient): Promise<void> {
+  try {
+    const settings = await client.getSettings();
+    const safe = Object.fromEntries(Object.entries(settings).filter(([key]) => !/key|token|secret|password|auth/i.test(key)));
+    console.log(`\n${BOLD('📋 Configuración efectiva (sin secretos):')}\n${JSON.stringify(safe, null, 2)}\n`);
+  } catch (err) { console.log(RED(`  Error consultando configuración: ${(err as Error).message}\n`)); }
+}

package/src/commands/mcp.ts

@@ -3,6 +3,16 @@ import chalk from 'chalk';
 import type { AgentClient } from '../client/agent-client';
 import type { McpServerConfig } from '../client/types';
 import { formatMcp, CYAN_BOLD, GREEN, RED, YELLOW, GRAY, BOLD, DIM } from '../ui/colors';
+import { MCP_DEFAULTS } from '../config/mcp-defaults';
+
+export function handleMcpDefaults(): void {
+  console.log(`\n${BOLD('📦 MCPs recomendados (catálogo, no activados automáticamente):')}\n`);
+  for (const item of MCP_DEFAULTS) {
+    console.log(`  ${CYAN_BOLD('◈')} ${formatMcp(item.id)} — ${item.label}`);
+    console.log(`    ${DIM(item.purpose)} | ${item.activation} | ${item.privacy}`);
+  }
+  console.log(DIM('\nActiva cada MCP individualmente con consentimiento y alcance explícito.\n'));
+}
 
 export async function handleListMcp(client: AgentClient): Promise<void> {
   console.log(`\n${BOLD('🔌 Servidores y Herramientas MCP:')}\n`);

package/src/config/mcp-defaults.ts

@@ -0,0 +1,18 @@
+export interface McpDefaultDefinition {
+  id: string;
+  label: string;
+  purpose: string;
+  transport: 'stdio' | 'connector';
+  activation: 'local-opt-in' | 'oauth-opt-in';
+  privacy: string;
+}
+
+/** Catalog only: entries are never enabled or installed automatically. */
+export const MCP_DEFAULTS: McpDefaultDefinition[] = [
+  { id: 'filesystem', label: 'Archivos locales', purpose: 'Carpeta elegida por el usuario', transport: 'stdio', activation: 'local-opt-in', privacy: 'Solo rutas autorizadas' },
+  { id: 'obsidian', label: 'Obsidian / Helix Vault', purpose: 'Leer y gestionar una bóveda concreta', transport: 'stdio', activation: 'local-opt-in', privacy: 'Solo la bóveda seleccionada' },
+  { id: 'vscode', label: 'VS Code', purpose: 'Trabajar con el workspace seleccionado', transport: 'stdio', activation: 'local-opt-in', privacy: 'Solo el workspace seleccionado' },
+  { id: 'github', label: 'GitHub', purpose: 'Repositorios, issues y pull requests', transport: 'stdio', activation: 'oauth-opt-in', privacy: 'Requiere token u OAuth del usuario' },
+  { id: 'gmail', label: 'Gmail', purpose: 'Correo y búsqueda de mensajes', transport: 'connector', activation: 'oauth-opt-in', privacy: 'Requiere OAuth explícito del usuario' },
+  { id: 'notion', label: 'Notion', purpose: 'Páginas y bases de datos', transport: 'connector', activation: 'oauth-opt-in', privacy: 'Requiere integración autorizada' },
+];

package/src/index.ts

@@ -73,7 +73,7 @@ const program = new Command();
 program
   .name('helix')
   .description('HELIX - Interactive Terminal CLI for Windows AI Desktop Agent')
-  .version('0.2.7')
+  .version('0.2.9')
   .option('-u, --ws-url <url>', 'URL del servidor WebSocket del agente', getWsUrl())
   .option('-t, --token <token>', 'Token de autenticación WebSocket de HELIX', getWsToken())
   .option('--plain', 'Desactivar formato enriquecido de Markdown y mostrar texto plano sin asteriscos')

package/src/ui/autocomplete.ts

@@ -12,7 +12,7 @@ export interface CommandDefinition {
 export const SLASH_COMMANDS: CommandDefinition[] = [
   { 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: '/mcp', description: 'Listar servidores MCP y sus herramientas', usage: '/mcp [defaults]' },
   { 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.)' },
@@ -21,6 +21,9 @@ export const SLASH_COMMANDS: CommandDefinition[] = [
   { 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: '/providers', description: 'Ver proveedores configurados y salud de sus claves' },
+  { command: '/capabilities', description: 'Ver capacidades activas: sandbox, subagentes, voz y browser' },
+  { command: '/settings', description: 'Ver configuración efectiva sin exponer secretos' },
   { 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' },

package/src/ui/repl.ts

@@ -21,11 +21,12 @@ import {
 } from './colors';
 import { handleConfigApiKey, handleShowApiKey } from '../commands/apikey';
 import { handleCreateSkill, handleListSkills } from '../commands/skills';
-import { handleCreateMcp, handleListMcp } from '../commands/mcp';
+import { handleCreateMcp, handleListMcp, handleMcpDefaults } from '../commands/mcp';
 import { handleMicrophoneCommand } from '../commands/mic';
 import { handleBrowserCommand } from '../commands/browser';
 import type { ConfirmationRequest } from '../client/types';
 import { formatTerminalMarkdown } from './markdown';
+import { handleCapabilities, handleProviders, handleSettings } from '../commands/diagnostics';
 
 export interface ReplOptions {
   wsUrl: string;
@@ -359,7 +360,8 @@ export class HelixRepl {
           break;
 
         case '/mcp':
-          await handleListMcp(this.client);
+          if (args?.trim().toLowerCase() === 'defaults') handleMcpDefaults();
+          else await handleListMcp(this.client);
           break;
 
         case '/create-mcp':
@@ -397,6 +399,18 @@ export class HelixRepl {
           await this._handleStatus();
           break;
 
+        case '/providers':
+          await handleProviders(this.client);
+          break;
+
+        case '/capabilities':
+          await handleCapabilities(this.client);
+          break;
+
+        case '/settings':
+          await handleSettings(this.client);
+          break;
+
         case '/stop':
           console.log(RED_BOLD('\n[PARADA DE EMERGENCIA]: Cancelando todas las tareas activas...'));
           this.client.emergencyStop();