@milpa/comal 0.1.0 → 0.1.2

package/src/tui/discovery.mjs

@@ -1,91 +1,94 @@
+import { t } from '../i18n/index.mjs';
 // Presentation-only discovery: supplied snapshots in, suggestions out. Never
 // reads a workspace, contacts a provider, executes tools, or changes authority.
 import { graphemes, safeText } from './text.mjs';
 
 const COMMANDS = [
-  ['help', '', 'Ayuda y teclado'], ['status', '', 'Sesión, proveedor y presupuesto'],
-  ['tools', '', 'Herramientas disponibles en este momento'], ['house', '', 'Recibos y operaciones interrumpidas'],
-  ['operations', '', 'Contratos y efectos de las operaciones'], ['sessions', '', 'Abrir el selector de sesiones'],
-  ['resume', 'UUID', 'Reanudar una sesión guardada'], ['clear', '', 'Crear una conversación nueva'],
-  ['copy', '', 'Copiar la última respuesta completa'], ['select', '', 'Seleccionar texto con el terminal'],
-  ['compact', '', 'Derivar el estado del libro sin LLM'], ['context', '', 'Consultar el presupuesto de contexto'],
-  ['state', '', 'Petición y estado actual del trabajo'], ['audit', '', 'Verificar la integridad del libro'],
-  ['board', '', 'Abrir el tablero de tareas'], ['work', 'resume|recover', 'Continuar trabajo o reconciliar una publicación Chrome'],
-  ['tasks', '', 'Abrir el tablero de tareas'], ['model', 'ID', 'Consultar o cambiar el modelo'],
-  ['models', '', 'Consultar modelos del proveedor; puede hacer una petición'],
-  ['effort', 'NIVEL', 'Consultar o cambiar el esfuerzo anunciado por el modelo'],
-  ['capabilities', '[refresh]', 'Soporte y procedencia de las capacidades'],
-  ['permissions', 'MODO', 'Cambiar el modo de permisos'], ['goal', '[condición|status|pause|resume|clear]', 'Definir o controlar un objetivo persistente'],
-  ['queue', '[pause|resume|clear|edit N]', 'Gestionar los mensajes en cola'],
-  ['rename', 'NOMBRE', 'Cambiar el nombre visible de esta sesión'], ['table', 'ARCHIVO', 'Mostrar una tabla CSV, TSV, JSON o Markdown'],
-  ['mcp', '[acción]', 'Ver o configurar servidores MCP'], ['plugins', '[acción]', 'Ver plugins y controlar su ciclo de vida'],
-  ['agent', '[explore|general|background] TAREA', 'Delegar una tarea a un subagente'], ['agents', '[UUID|status|wait|stop|resume|background|continue] [RUN]', 'Ver y controlar ejecuciones hijas'],
-  ['search', 'CONSULTA', 'Buscar en la web'], ['list-agents', '', 'Descubrir otras sesiones vivas'],
-  ['send', 'ID_O_NOMBRE TEXTO', 'Enviar un mensaje a otra sesión'], ['inbox', '[acción]', 'Controlar el buzón entre sesiones'],
-  ['providers', '', 'Ver perfiles y proveedores de login'], ['provider', 'PERFIL', 'Cambiar al perfil configurado'],
-  ['login', 'PROVEEDOR', 'Autenticar un proveedor sin pegar claves'], ['logout', 'PROVEEDOR', 'Retirar credenciales de Comal'],
-  ['exit', '', 'Guardar y salir'], ['quit', '', 'Guardar y salir'],
+  ['cloud', '[login|status|logout]', 'Connect your Comal account for Artifacts and Remote Control'],
+  ['remote-control', '[start|status|stop]', 'Open this local session on the web'], ['rc', '[start|status|stop]', 'Remote Control shortcut'],
+  ['help', '', "Help and keyboard"], ['status', '', "Session, provider and budget"],
+  ['tools', '', "Tools available at this time"], ['house', '', "Receipts and interrupted operations"],
+  ['operations', '', "Contracts and effects of operations"], ['sessions', '', "Open the session selector"],
+  ['resume', 'UUID', "Resume a saved session"], ['clear', '', "Create a new conversation"],
+  ['copy', '', "Copy the last complete response"], ['select', '', "Select text with the terminal"],
+  ['compact', '', "Derive ledger state without an LLM"], ['context', '', "Check the context budget"],
+  ['state', '', "Request and current job status"], ['audit', '', "Verify ledger integrity"],
+  ['board', '', "Open the task board"], ['work', 'resume|recover|review', "Continue work, recover Chrome or review a native failure locally"],
+  ['tasks', '', "Open the task board"], ['model', 'ID', "Check or change the model"],
+  ['models', '', "Check provider models; can make a request"],
+  ['effort', "LEVEL", "Check or change the effort announced by the model"],
+  ['capabilities', '[refresh]', "Support and provenance of capabilities"],
+  ['permissions', "MODE", "Change the permissions mode"], ['goal', "[condition|status|pause|resume|clear]", "Define or control a persistent goal"],
+  ['queue', '[pause|resume|clear|edit N]', "Manage queued messages"],
+  ['rename', "NAME", "Change the visible name of this session"], ['table', "FILE", "Display a CSV, TSV, JSON, or Markdown table"],
+  ['mcp', "[action]", "View or configure MCP servers"], ['plugins', "[action]", "View plugins and control their lifecycle"],
+  ['agent', "[explore|general|background] TASK", "Delegate a task to a subagent"], ['agents', '[UUID|status|wait|stop|resume|background|continue] [RUN]', "View and control child runs"],
+  ['search', "QUERY", "Search the web"], ['list-agents', '', "Discover other live sessions"],
+  ['send', "ID_OR_NAME TEXT", "Send a message to another session"], ['inbox', "[action]", "Control the mailbox between sessions"],
+  ['providers', '', "View profiles and login providers"], ['provider', "PROFILE", "Switch to the configured profile"],
+  ['login', "PROVIDER", "Authenticate a provider without pasting keys"], ['logout', "PROVIDER", "Remove Comal credentials"],
+  ['exit', '', "Save and exit"], ['quit', '', "Save and exit"],
 ].map(([name, args, description]) => Object.freeze({ name, args, description }));
 export const COMMAND_CATALOG = Object.freeze(COMMANDS);
 
 // Search vocabulary only: exact registered names select these terms. They never
 // add an operation or replace the host's description/capability contract.
 const TOOL_KEYWORDS = Object.freeze({
-  Read: 'leer archivo archivos texto contenido código codigo inspeccionar',
-  Write: 'escribir crear guardar archivo archivos código codigo',
-  Edit: 'editar modificar reemplazar archivo archivos código codigo',
-  Glob: 'buscar encontrar archivos rutas nombres patrón patron',
-  Grep: 'buscar encontrar texto contenido coincidencias expresión regular',
+  Read: "read file files text content code code inspect leer archivo archivos texto contenido código codigo inspeccionar",
+  Write: "write create save file files code code escribir crear guardar archivo archivos código codigo",
+  Edit: "edit modify replace file files code code editar modificar reemplazar archivo archivos código codigo",
+  Glob: "search find files paths names pattern pattern buscar encontrar archivos rutas nombres patrón patron",
+  Grep: "search find text content matches regular expression buscar encontrar texto contenido coincidencias expresión regular",
   Bash: 'terminal shell comandos ejecutar proceso procesos',
-  ListDirectory: 'listar directorio carpeta carpetas archivos explorar sólo lectura solo lectura',
-  FileInfo: 'información informacion archivo tamaño tamano formato firma cabecera sólo lectura solo lectura',
-  ReadTable: 'leer tabla tablas datos CSV TSV JSON Markdown',
-  WebSearch: 'buscar búsqueda busqueda web internet fuentes investigar',
-  WebFetch: 'leer descargar página pagina enlace sitio web internet fuente',
-  AnalyzeMedia: 'imagen imágenes imagenes visión vision fotografía fotografia foto captura multimedia video vídeo analizar',
-  ProviderSearch: 'buscar búsqueda busqueda web internet fuentes proveedor nativo investigar',
-  ProviderCapabilities: 'capacidades soporte proveedor modelo visión vision video vídeo herramientas razonamiento',
-  ListAgents: 'listar descubrir pares vivos otras sesiones instancias agentes comunicación comunicacion',
-  SendMessage: 'enviar mensaje mensajes comunicar comunicación comunicacion sesiones pares delegar informe respuesta',
-  Agent: 'subagente subagentes delegar explorar investigar tarea',
-  AgentBatch: 'subagentes delegar paralelo tareas equipo lote',
+  ListDirectory: "list directory folder folders files explore read-only read-only listar directorio carpeta carpetas archivos explorar sólo lectura solo lectura",
+  FileInfo: "information information file size size format signature header read-only read-only información informacion archivo tamaño tamano formato firma cabecera sólo lectura solo lectura",
+  ReadTable: "read table tables data CSV TSV JSON Markdown leer tabla tablas datos CSV TSV JSON Markdown",
+  WebSearch: "search search web internet sources research buscar búsqueda busqueda web internet fuentes investigar",
+  WebFetch: "read download page page link website internet source leer descargar página pagina enlace sitio web internet fuente",
+  AnalyzeMedia: "image images images vision vision photography photography photo capture multimedia video video analyze imagen imágenes imagenes visión vision fotografía fotografia foto captura multimedia video vídeo analizar",
+  ProviderSearch: "search search search web internet sources provider native investigate buscar búsqueda busqueda web internet fuentes proveedor nativo investigar",
+  ProviderCapabilities: "capabilities support provider model vision vision video video tools reasoning capacidades soporte proveedor modelo visión vision video vídeo herramientas razonamiento",
+  ListAgents: "list discover peers alive other sessions instances agents communication communication listar descubrir pares vivos otras sesiones instancias agentes comunicación comunicacion",
+  SendMessage: "send message messages communicate communication communication sessions peers delegate report response enviar mensaje mensajes comunicar comunicación comunicacion sesiones pares delegar informe respuesta",
+  Agent: "subagent subagents delegate explore investigate task subagente subagentes delegar explorar investigar tarea",
+  AgentBatch: "subagents delegate parallel tasks team batch subagentes delegar paralelo tareas equipo lote",
   AgentStatus:'estado subagentes ejecuciones pendientes resultado verificado',
-  AgentWait:'esperar subagente ejecución resultado',
-  AgentStop:'detener cancelar subagente ejecución',
-  AgentResume:'reanudar subagente interrumpido checkpoint',
-  AgentContinue:'subagente recuperar delegación invocación interrumpida',
+  AgentWait:"wait subagent execution result esperar subagente ejecución resultado",
+  AgentStop:"stop cancel subagent execution detener cancelar subagente ejecución",
+  AgentResume:"resume subagent interrupted checkpoint reanudar subagente interrumpido checkpoint",
+  AgentContinue:"subagent recover delegation invocation interrupted subagente recuperar delegación invocación interrumpida",
   AgentBackground:'subagente segundo plano background',
-  ToolPack: 'cargar descargar herramientas MCP paquetes packs temporales esquemas descubrir adquirir liberar',
-  McpStatus: 'MCP servidores conexiones herramientas estado',
-  McpConfigure: 'MCP configurar servidores añadir agregar quitar conexiones',
-  McpReload: 'MCP recargar reconectar servidores conexiones herramientas',
+  ToolPack: "load unload tools MCP packages packs temporary schemas discover acquire release cargar descargar herramientas MCP paquetes packs temporales esquemas descubrir adquirir liberar",
+  McpStatus: "MCP servers connections tools status MCP servidores conexiones herramientas estado",
+  McpConfigure: "MCP configure servers add add remove connections MCP configurar servidores añadir agregar quitar conexiones",
+  McpReload: "MCP reload reconnect servers connections tools MCP recargar reconectar servidores conexiones herramientas",
   PluginStatus: 'plugins extensiones complementos dependencias operaciones estado',
-  PluginRun: 'plugins extensiones complementos operación operacion ejecutar',
+  PluginRun: "plugins extensions add-ons operation operation execute plugins extensiones complementos operación operacion ejecutar",
   PluginEnable: 'plugins extensiones complementos activar habilitar',
   PluginDisable: 'plugins extensiones complementos desactivar retirar',
   PluginReload: 'plugins extensiones complementos recargar actualizar',
-  WorkBoard: 'tablero kanban tareas trabajo pendientes progreso',
-  WorkSnapshot: 'petición peticion estado trabajo checkpoint memoria',
-  AuditStatus: 'auditoría auditoria verificar evidencia libro integridad',
-  EvidenceRead: 'leer evidencia recibos libro prueba pruebas',
-  HouseSnapshot: 'casa juez recibos operaciones estado ejecución ejecucion',
-  HouseContext: 'casa juez contexto evidencia memoria',
-  OperationCatalog: 'catálogo catalogo operaciones contratos efectos herramientas',
+  WorkBoard: "board kanban tasks work pending progress tablero kanban tareas trabajo pendientes progreso",
+  WorkSnapshot: "request request status work checkpoint memory petición peticion estado trabajo checkpoint memoria",
+  AuditStatus: "audit audit verify evidence ledger integrity auditoría auditoria verificar evidencia libro integridad",
+  EvidenceRead: "read evidence receipts ledger proof proofs leer evidencia recibos libro prueba pruebas",
+  HouseSnapshot: "house judge receipts operations status execution execution casa juez recibos operaciones estado ejecución ejecucion",
+  HouseContext: "house judge context evidence memory casa juez contexto evidencia memoria",
+  OperationCatalog: "catalog catalog operations contracts effects tools catálogo catalogo operaciones contratos efectos herramientas",
 });
 const COMMAND_KEYWORDS = Object.freeze({
-  help: 'ayuda atajos teclado', tools: 'catálogo catalogo descubrir herramientas',
-  operations: 'contratos efectos herramientas catálogo catalogo',
-  sessions: 'sesiones historial retomar recuperar', resume: 'sesiones historial retomar recuperar continuar',
-  compact: 'memoria proyección proyeccion derivar resumen contexto',
-  board: 'kanban pendientes tareas progreso', work: 'kanban checkpoint continuar retomar',
-  effort: 'esfuerzo razonamiento pensar thinking', capabilities: 'capacidades visión vision video imágenes imagenes soporte',
-  permissions: 'modos seguridad permisos autorizar plan automático automatico',
-  goal: 'objetivo autónomo autonomo continuar persistente', queue: 'cola mensajes pendientes pausar reordenar',
-  mcp: 'herramientas servidores conectar recargar stdio HTTP', plugins: 'extensiones complementos módulos modulos',
-  agent: 'subagente delegar tarea explorar', agents: 'subagentes delegados estado',
-  search: 'investigar búsqueda busqueda internet fuentes', 'list-agents': 'pares vivos otras instancias comunicar sesiones',
-  send: 'comunicar mensaje sesiones pares', inbox: 'buzón buzon mensajes recibir sesiones',
-  login: 'iniciar sesión sesion autenticar suscripción suscripcion', logout: 'cerrar sesión sesion credenciales',
+  help: 'ayuda atajos teclado', tools: "catalog catalog discover tools catálogo catalogo descubrir herramientas",
+  operations: "contracts effects tools catalog catalog contratos efectos herramientas catálogo catalogo",
+  sessions: "sessions history resume recover sesiones historial retomar recuperar", resume: "sessions history resume recover continue sesiones historial retomar recuperar continuar",
+  compact: "memory projection projection derive summary context memoria proyección proyeccion derivar resumen contexto",
+  board: "kanban pending tasks progress kanban pendientes tareas progreso", work: "kanban checkpoint continue resume kanban checkpoint continuar retomar",
+  effort: 'esfuerzo razonamiento pensar thinking', capabilities: "capabilities vision vision video images images support capacidades visión vision video imágenes imagenes soporte",
+  permissions: "modes security permissions authorize plan automatic automatic modos seguridad permisos autorizar plan automático automatico",
+  goal: "goal autonomous autonomous continue persistent objetivo autónomo autonomo continuar persistente", queue: "queue messages pending pause reorder cola mensajes pendientes pausar reordenar",
+  mcp: "tools servers connect reload stdio HTTP herramientas servidores conectar recargar stdio HTTP", plugins: "extensions add-ons modules modules extensiones complementos módulos modulos",
+  agent: "subagent delegate task explore subagente delegar tarea explorar", agents: 'subagentes delegados estado',
+  search: "investigate search search internet sources investigar búsqueda busqueda internet fuentes", 'list-agents': "peers alive other instances communicate sessions pares vivos otras instancias comunicar sesiones",
+  send: "communicate message between peer sessions comunicar mensaje sesiones pares", inbox: "mailbox mailbox messages receive sessions buzón buzon mensajes recibir sesiones",
+  login: "log in session authenticate subscription subscription iniciar sesión sesion autenticar suscripción suscripcion", logout: "log out session credentials cerrar sesión sesion credenciales",
 });
 
 const token = value => typeof value === 'string' && value.length <= 256 && value.length > 0 && !/[\s\x00-\x1f\x7f-\x9f]/u.test(value);
@@ -106,7 +109,7 @@ const skills = context => entries(context.skills).filter(skill => /^[\p{L}\p{N}_
  */
 export function commandCatalog(context = {}) {
   return [
-    ...COMMANDS.map(command => ({ label: `/${command.name}`, value: `/${command.name}${command.args ? ' ' : ''}`, description: command.description, keywords: COMMAND_KEYWORDS[command.name] || '', kind: 'command', syntax: `/${command.name}${command.args ? ` ${command.args}` : ''}` })),
+    ...COMMANDS.map(command => ({ label: `/${command.name}`, value: `/${command.name}${command.args ? ' ' : ''}`, description: t(command.description), keywords: COMMAND_KEYWORDS[command.name] || '', kind: 'command', syntax: `/${command.name}${command.args ? ` ${t(command.args)}` : ''}` })),
     ...skills(context).map(skill => ({ ...skill, label: `/${skill.value}`, value: `/${skill.value} `, kind: 'skill' })),
     ...unique(entries(context.tools)).map(tool => ({ ...tool, keywords: TOOL_KEYWORDS[tool.value] || '', kind: 'tool', inspectOnly: true })),
   ];
@@ -115,51 +118,53 @@ export function commandCatalog(context = {}) {
 function argumentItems(command, args, context) {
   const first = args[0] || '', position = args.length - 1;
   if (position === 0) {
-    if (command === 'permissions') return named(['default', 'plan', 'acceptEdits', 'auto'], 'Modo de permisos; no cambia el modelo');
-    if (command === 'effort') return named(context.effortLevels || context.capabilities?.effort?.levels || ['auto'], 'Nivel anunciado por el modelo actual');
+    if (command === 'rc' || command === 'remote-control')return named(['start','status','stop'],'Remote session projection; local tools and permissions');
+    if (command === 'cloud') return named(['login','status','logout'],'Comal account; separate from the model provider');
+    if (command === 'permissions') return named(['default', 'plan', 'acceptEdits', 'auto'], t("Permissions mode; does not change the model"));
+    if (command === 'effort') return named(context.effortLevels || context.capabilities?.effort?.levels || ['auto'], t("Level announced by the current model"));
     if (command === 'provider') return [...entries(context.profiles), ...entries(context.authProviders || ['codex', 'kimi', 'minimax', 'grok'], 'id')];
     if (command === 'model') return entries(context.models, 'id');
     if (command === 'resume') return entries(context.sessions, 'id');
-    if (command === 'agents') return [...named(['status','wait','stop','resume','background','continue'],'Control de ejecuciones hijas'),...entries(context.agents,'id')];
-    if (command === 'send') return entries(context.peers, 'id').map(peer => ({ ...peer, description: 'Sesión viva conocida; enviar no equivale a ejecutar' }));
+    if (command === 'agents') return [...named(['status','wait','stop','resume','background','continue'],t("Child run controls")),...entries(context.agents,'id')];
+    if (command === 'send') return entries(context.peers, 'id').map(peer => ({ ...peer, description: t("Known live session; sending does not equal executing") }));
     if (command === 'capabilities') return named(['refresh'], 'Volver a consultar capacidades; puede hacer peticiones');
-    if (command === 'work') return named(['resume', 'recover'], 'Continuar trabajo o reconciliar una publicación Chrome');
-    if (command === 'goal') return named(['status', 'pause', 'resume', 'clear'], 'Control del objetivo; también puedes escribir una condición');
-    if (command === 'queue') return named(['pause', 'resume', 'clear', 'edit'], 'Acción sobre la cola');
-    if (command === 'mcp') return named(['status', 'list', 'config', 'reload', 'reconnect', 'add', 'remove'], 'Acción sobre servidores MCP');
-    if (command === 'plugins') return named(['status', 'list', 'enable', 'disable', 'reload', 'run'], 'Acción sobre plugins');
-    if (command === 'agent') return named(['explore', 'general','background'], 'Tipo de subagente; completa después la tarea');
-    if (command === 'inbox') return named(['status', 'accept', 'hold', 'refuse', 'release'], 'Control del buzón entre sesiones');
-    if (command === 'login' || command === 'logout') return [...(command === 'login' ? named(['status'], 'Consultar el estado del login') : []), ...entries(context.authProviders || ['codex', 'kimi', 'minimax', 'grok'], 'id')];
+    if (command === 'work') return named(['resume', 'recover', 'review'], t("Continue work, recover Chrome or review a native failure locally"));
+    if (command === 'goal') return named(['status', 'pause', 'resume', 'clear'], t("Target control; you can also write a condition"));
+    if (command === 'queue') return named(['pause', 'resume', 'clear', 'edit'], t("Action on the queue"));
+    if (command === 'mcp') return named(['status', 'list', 'config', 'reload', 'reconnect', 'add', 'remove'], t("Action on MCP servers"));
+    if (command === 'plugins') return named(['status', 'list', 'enable', 'disable', 'reload', 'run'], t("Action on plugins"));
+    if (command === 'agent') return named(['explore', 'general','background'], t("Subagent type; complete the task afterwards"));
+    if (command === 'inbox') return named(['status', 'accept', 'hold', 'refuse', 'release'], t("Mailbox control between sessions"));
+    if (command === 'login' || command === 'logout') return [...(command === 'login' ? named(['status'], t("Check login status")) : []), ...entries(context.authProviders || ['codex', 'kimi', 'minimax', 'grok'], 'id')];
   }
   if (position === 1) {
     if(command==='agents' && ['status','wait','stop','resume','background'].includes(first))return entries(context.agents,'id');
     if (command === 'mcp' && ['reconnect', 'remove'].includes(first)) return entries(context.mcpServers);
     if (command === 'plugins' && ['enable', 'disable', 'reload', 'run'].includes(first)) return entries(context.plugins, 'id');
-    if (command === 'inbox' && first === 'release') return named(['all'], 'Liberar mensajes retenidos; no cambia el modo hold');
-    if (command === 'queue' && first === 'edit') return named((context.queue?.items || []).map((_, index) => String(index + 1)), 'Editar este mensaje pendiente');
+    if (command === 'inbox' && first === 'release') return named(['all'], t("Release held messages; does not change hold mode"));
+    if (command === 'queue' && first === 'edit') return named((context.queue?.items || []).map((_, index) => String(index + 1)), t("Edit this pending message"));
     if (command === 'login' && first === 'status') return entries(context.authProviders || ['codex', 'kimi', 'minimax', 'grok'], 'id');
-    if (command === 'login' && first !== 'status') return named(['--api-key-env'], 'Nombre de variable de entorno, nunca la clave');
+    if (command === 'login' && first !== 'status') return named(['--api-key-env'], t("Environment variable name, never the key"));
   }
   if (position === 2 && command === 'plugins' && first === 'run') {
     const plugin = (context.plugins || []).find(plugin => plugin.id === args[1]);
     const prefix = `plugin__${args[1]}__`;
     return entries(plugin?.operations).map(operation => {
       const value = !plugin.builtin && operation.value.startsWith(prefix) ? operation.value.slice(prefix.length) : operation.value;
-      return { ...operation, label: value, value, kind: 'operation', description: operation.description || 'Operación registrada por este plugin' };
+      return { ...operation, label: value, value, kind: 'operation', description: operation.description || t("Operation registered by this plugin") };
     });
   }
   return [];
 }
 
 function syntaxHint(command, context) {
-  if (command === 'model' && !(context.models || []).length) return 'Usa /models para consultar el catálogo; no se hacen peticiones al escribir.';
-  if (command === 'effort' && !context.effortLevels && !context.capabilities?.effort?.levels) return 'Sólo auto está confirmado. /capabilities muestra los niveles disponibles.';
-  if (command === 'plugins') return '/plugins run ID OPERACIÓN {JSON} · las mutaciones esperan su turno.';
-  if (command === 'login') return 'Nunca pegues una clave aquí; usa --api-key-env VARIABLE.';
-  if (skills(context).some(skill => skill.value === command)) return 'Skill local: escribe la tarea después del nombre.';
+  if (command === 'model' && !(context.models || []).length) return t("Use /models to check the catalog; no requests are made when typing.");
+  if (command === 'effort' && !context.effortLevels && !context.capabilities?.effort?.levels) return t("Only auto is confirmed. /capabilities shows the available levels.");
+  if (command === 'plugins') return t("/plugins run ID OPERATION {JSON} · mutations wait their turn.");
+  if (command === 'login') return t("Never paste a key here; use --api-key-env VARIABLE.");
+  if (skills(context).some(skill => skill.value === command)) return t("Local skill: write the task after the name.");
   const entry = COMMANDS.find(entry => entry.name === command);
-  return entry ? `/${entry.name}${entry.args ? ` ${entry.args}` : ''} · ${entry.description}` : 'F6 abre comandos y herramientas disponibles.';
+  return entry ? `/${entry.name}${entry.args ? ` ${t(entry.args)}` : ''} · ${t(entry.description)}` : t("F6 opens available commands and tools.");
 }
 
 /** Cursor and replacement ranges use grapheme indices, exactly like Composer.
@@ -198,20 +203,20 @@ export function commandSuggestions(text, cursor = graphemes(text).length, contex
  */
 export function applySuggestion(text, result, item) {
   text = String(text); const buffer = graphemes(text);
-  if (!result || result.source !== text || !Number.isInteger(result.start) || !Number.isInteger(result.end) || result.start < 0 || result.end < result.start || result.end > buffer.length || !result.items?.some(candidate => candidate.value === item?.value) || typeof item?.value !== 'string' || /[\x00-\x1f\x7f-\x9f]/u.test(item.value)) throw new Error('La sugerencia cambió; vuelve a seleccionarla.');
+  if (!result || result.source !== text || !Number.isInteger(result.start) || !Number.isInteger(result.end) || result.start < 0 || result.end < result.start || result.end > buffer.length || !result.items?.some(candidate => candidate.value === item?.value) || typeof item?.value !== 'string' || /[\x00-\x1f\x7f-\x9f]/u.test(item.value)) throw new Error(t("The suggestion changed; select it again."));
   const inserted = graphemes(item.value);
   return { text: [...buffer.slice(0, result.start), ...inserted, ...buffer.slice(result.end)].join(''), cursor: result.start + inserted.length };
 }
 
 /** One stable, contextual hint; no timed rotation, extra output, or tool calls. */
 export function contextualTip(text = '', context = {}) {
-  if (context.selecting) return 'Selecciona y copia con tu terminal · F5 o Esc vuelve.';
-  if (context.editingQueue) return 'Editando un mensaje en cola · Enter guarda · Esc conserva el original.';
-  if (context.queue?.paused) return 'Cola pausada · F4 para revisarla y reanudarla.';
-  if (context.queue?.interrupted?.length) return 'Hay mensajes interrumpidos · F4 permite revisarlos antes de reintentar.';
+  if (context.selecting) return t("Select and copy with your terminal · F5 or Esc returns.");
+  if (context.editingQueue) return t("Editing a queued message · Enter saves · Esc keeps the original.");
+  if (context.queue?.paused) return t("Queue paused · F4 to review and resume it.");
+  if (context.queue?.interrupted?.length) return t("Interrupted messages · F4 lets you review them before retrying.");
   if (String(text).trimStart().startsWith('/')) return commandSuggestions(String(text), graphemes(String(text)).length, context).hint;
-  if (context.busy) return 'Puedes seguir escribiendo · Enter encola · Esc interrumpe el turno.';
-  if (String(text).includes('\n')) return 'Mensaje multilínea · Enter envía · Ctrl+G abre tu editor.';
-  if (context.mode === 'plan') return 'Modo plan: inspección sin cambios · Shift+Tab cambia de modo.';
-  return 'F6 descubre comandos y herramientas · / autocompleta · Ctrl+G abre tu editor.';
+  if (context.busy) return t("You can keep typing · Enter queues · Esc interrupts the turn.");
+  if (String(text).includes('\n')) return t("Multiline message · Enter sends · Ctrl+G opens your editor.");
+  if (context.mode === 'plan') return t("Plan mode: inspection without changes · Shift+Tab switches mode.");
+  return t("F6 discovers commands and tools · / autocompletes · Ctrl+G opens your editor.");
 }

package/src/tui/markdown.mjs

@@ -1,3 +1,4 @@
+import { t } from '../i18n/index.mjs';
 import { Marked } from 'marked';
 import { safeText, tone, wrap, width, pad, clip } from './text.mjs';
 
@@ -15,7 +16,7 @@ function inline(tokens = []) {
     if (token.type === 'codespan') return tone.accent(text);
     if (token.type === 'br') return '\n';
     if (token.type === 'link') return tone.accent(text) + (token.href && token.href !== token.text ? tone.muted(` (${safeText(token.href)})`) : '');
-    if (token.type === 'image') return `[imagen: ${text}]`;
+    if (token.type === 'image') return t("[image: {v0}]", {v0: text});
     return text;
   }).join('');
 }
@@ -25,7 +26,7 @@ export class DataTableParser {
     text = safeText(text, { preserveTabs: true });
     if (format === 'json') {
       const parsed = JSON.parse(text), data = Array.isArray(parsed) ? parsed : parsed.data;
-      if (!Array.isArray(data) || !data.every(row => row && typeof row === 'object' && !Array.isArray(row))) throw new Error('La tabla JSON requiere una lista de objetos, o {data: [...]}.');
+      if (!Array.isArray(data) || !data.every(row => row && typeof row === 'object' && !Array.isArray(row))) throw new Error(t("The JSON table requires a list of objects, or {data: [...]}."));
       const headers = [...new Set(data.flatMap(row => Object.keys(row)))];
       return { headers, rows: data.map(row => headers.map(key => typeof row[key] === 'object' && row[key] !== null ? JSON.stringify(row[key]) : String(row[key] ?? ''))) };
     }
@@ -34,19 +35,19 @@ export class DataTableParser {
       return { headers: rows[0] || [], rows: rows.slice(1) };
     }
     const table = lexer.lexer(text).find(token => token.type === 'table');
-    if (!table) throw new Error('No se encontró una tabla Markdown.');
+    if (!table) throw new Error(t("No Markdown table found."));
     return { headers: table.header.map(cell => inline(cell.tokens)), rows: table.rows.map(row => row.map(cell => inline(cell.tokens))), align: table.align };
   }
   render({ headers, rows, align = [] }, columns) {
-    if (!headers.length) return [tone.muted('(tabla vacía)')];
-    if (headers.length > 24 || rows.length > 10000) throw new Error('Tabla demasiado grande: máximo 24 columnas y 10000 filas.');
+    if (!headers.length) return [tone.muted(t("(empty table)"))];
+    if (headers.length > 24 || rows.length > 10000) throw new Error(t("Table too large: maximum 24 columns and 10000 rows."));
     const shown = rows.slice(0, 200).map(row => headers.map((_, i) => safeText(row[i] ?? '')));
     headers = headers.map(safeText);
     const available = columns - (headers.length + 1) - headers.length * 2;
     if (available < headers.length * 3) {
       const output = [];
-      shown.forEach((row, index) => { output.push(tone.muted(`── Fila ${index + 1} ──`)); row.forEach((value, i) => output.push(...wrap(`${tone.bold(headers[i])}: ${value}`, columns))); });
-      if (rows.length > 200) output.push(tone.muted(`… ${rows.length - 200} filas adicionales`));
+      shown.forEach((row, index) => { output.push(tone.muted(t("── Row {v0} ──", {v0: index + 1}))); row.forEach((value, i) => output.push(...wrap(`${tone.bold(headers[i])}: ${value}`, columns))); });
+      if (rows.length > 200) output.push(tone.muted(t("… {v0} additional rows", {v0: rows.length - 200})));
       return output.map(line => clip(line, columns));
     }
     const sizes = headers.map((header, i) => Math.max(3, Math.min(32, width(header), available)));
@@ -68,7 +69,7 @@ export class DataTableParser {
     renderRow(headers, true); output.push(border('├', '┼', '┤'));
     for (const row of shown) renderRow(row);
     output.push(border('└', '┴', '┘'));
-    if (rows.length > shown.length) output.push(tone.muted(`… ${rows.length - shown.length} filas adicionales`));
+    if (rows.length > shown.length) output.push(tone.muted(t("… {v0} additional rows", {v0: rows.length - shown.length})));
     return output.map(line => clip(line, columns));
   }
 }
@@ -86,7 +87,7 @@ function delimited(text, separator) {
     else if (c === '\n') { row.push(cell); rows.push(row); row = []; cell = ''; }
     else cell += c;
   }
-  if (quoted) throw new Error('CSV/TSV tiene una celda entre comillas incompleta.');
+  if (quoted) throw new Error(t("CSV/TSV has an incomplete quoted cell."));
   if (cell || row.length) { row.push(cell); rows.push(row); }
   return rows;
 }

package/src/tui/message-queue.mjs

@@ -1,25 +1,43 @@
-import { randomUUID } from 'node:crypto';
+import { t } from '../i18n/index.mjs';
+import { randomUUID, createHash } from 'node:crypto';
+import { isRemoteCommand } from '../remote-commands.mjs';
 
 export class MessageQueue {
   constructor(snapshot, persist = async () => {}) {
     this.persist = persist; this.items = snapshot?.items || []; this.running = null;
     this.interrupted = [...(snapshot?.interrupted || []), ...(snapshot?.running ? [snapshot.running] : [])];
     this.paused = Boolean(snapshot?.paused || this.items.length || this.interrupted.length);
+    this.remoteAdmissions = snapshot?.remoteAdmissions || {};
+    this.remoteWriter = Promise.resolve();
   }
-  snapshot() { return structuredClone({ items: this.items, running: this.running, interrupted: this.interrupted, paused: this.paused }); }
+  snapshot() { return structuredClone({ items: this.items, running: this.running, interrupted: this.interrupted, paused: this.paused, remoteAdmissions: this.remoteAdmissions }); }
   async save() { await this.persist(this.snapshot()); }
   validate(text, excludeId) {
-    if (!text.trim()) throw new Error('El mensaje está vacío.');
-    if (this.items.length >= 32 && !excludeId) throw new Error('La cola admite hasta 32 mensajes.');
+    if (!text.trim()) throw new Error(t("The message is empty."));
+    if (this.items.length >= 32 && !excludeId) throw new Error(t("The queue supports up to 32 messages."));
     const bytes = Buffer.byteLength(text) + this.items.filter(i => i.id !== excludeId).reduce((sum, i) => sum + Buffer.byteLength(i.text), 0);
-    if (bytes > 1024 * 1024) throw new Error('La cola admite hasta 1 MiB de texto.');
+    if (bytes > 1024 * 1024) throw new Error(t("The queue supports up to 1 MiB of text."));
   }
-  async enqueue(text) {
-    this.validate(text); const item = { id: randomUUID(), text, createdAt: new Date().toISOString() };
+  async enqueue(text, attachments = []) {
+    this.validate(text); if (!Array.isArray(attachments) || attachments.length > 2 || Buffer.byteLength(JSON.stringify(attachments)) > 32768) throw new Error('Invalid image attachment metadata.');
+    const item = { id: randomUUID(), text, ...(attachments.length ? {attachments: structuredClone(attachments)} : {}), createdAt: new Date().toISOString() };
     this.items.push(item);
     try { await this.save(); } catch (e) { this.items = this.items.filter(i => i.id !== item.id); throw e; }
     return item;
   }
+  enqueueRemote(text, remote) {
+    const action = this.remoteWriter.catch(() => {}).then(async () => {
+      if (!remote || !/^[a-f0-9]{32}$/.test(remote.session) || !/^[A-Za-z0-9_-]{8,128}$/.test(remote.request) || Buffer.byteLength(text)>16384 || text.trimStart().startsWith('/') && !isRemoteCommand(text)) throw new Error('Remote input must be plain text or an admitted remote command.');
+      const key=remote.session+':'+remote.request, digest=createHash('sha256').update(JSON.stringify([remote.session,remote.request,text])).digest('hex'), previous=this.remoteAdmissions[key];
+      if(previous){if(previous.digest!==digest)throw new Error('Remote request ID already names another message.');return {id:previous.id,duplicate:true};}
+      if(Object.keys(this.remoteAdmissions).length>=2048)throw new Error('Remote admission history is full. Start a new local session.');
+      this.validate(text);const item={id:randomUUID(),text,remote:{...remote},createdAt:new Date().toISOString()};
+      this.items.push(item);this.remoteAdmissions[key]={id:item.id,digest};
+      try{await this.save();}catch(error){this.items=this.items.filter(i=>i.id!==item.id);delete this.remoteAdmissions[key];throw error;}
+      return item;
+    });
+    this.remoteWriter=action;return action;
+  }
   async take() {
     if (this.paused || !this.items.length || this.running) return null;
     const item = this.items.shift(); this.running = item;
@@ -28,12 +46,12 @@ export class MessageQueue {
   }
   async finish(error = false) { this.running = null; if (error) this.paused = true; await this.save(); }
   async defer() { if (this.running) { this.items.unshift(this.running); this.running = null; await this.save(); } }
-  async update(id, text) { this.validate(text, id); const item = this.items.find(i => i.id === id); if (!item) throw new Error('Ese mensaje ya no está en cola.'); const old = item.text; item.text = text; try { await this.save(); } catch (e) { item.text = old; throw e; } }
+  async update(id, text, attachments) { this.validate(text, id); if (attachments !== undefined && (!Array.isArray(attachments) || attachments.length > 2 || Buffer.byteLength(JSON.stringify(attachments)) > 32768)) throw new Error('Invalid image attachment metadata.'); const item = this.items.find(i => i.id === id); if (!item) throw new Error(t("That message is no longer in queue.")); const old = item.text, oldAttachments = item.attachments; item.text = text; if (attachments !== undefined) item.attachments = structuredClone(attachments); try { await this.save(); } catch (e) { item.text = old; item.attachments = oldAttachments; throw e; } }
   async remove(id) { this.items = this.items.filter(i => i.id !== id); await this.save(); }
   async move(id, delta) { const index = this.items.findIndex(i => i.id === id), next = index + delta; if (index < 0 || next < 0 || next >= this.items.length) return; const [item] = this.items.splice(index, 1); this.items.splice(next, 0, item); await this.save(); }
   async setPaused(paused) { this.paused = paused; await this.save(); }
   async clear() { this.items = []; this.interrupted = []; await this.save(); }
-  async retryInterrupted(id) { const item = this.interrupted.find(i => i.id === id); if (!item) return; await this.enqueue(item.text); this.interrupted = this.interrupted.filter(i => i.id !== id); await this.save(); }
+  async retryInterrupted(id) { const item = this.interrupted.find(i => i.id === id); if (!item) return; await this.enqueue(item.text, item.attachments); this.interrupted = this.interrupted.filter(i => i.id !== id); await this.save(); }
 }
 
 export class QueueRunner {