helix-assistant-cli 0.2.8 → 0.2.9

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.)' },

package/dist/ui/repl.js

@@ -317,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();

package/package.json

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

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.)' },

package/src/ui/repl.ts

@@ -21,7 +21,7 @@ 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';
@@ -360,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':