@milpa/comal 0.1.0 → 0.1.2

package/src/tui/screen.mjs

@@ -1,3 +1,4 @@
+import { t, formatNumber } from '../i18n/index.mjs';
 import { workProjection } from '../work-plan.mjs';
 import { Composer } from './composer.mjs';
 import { MarkdownRenderer, DataTableParser } from './markdown.mjs';
@@ -10,51 +11,20 @@ import { commandCatalog, commandSuggestions, applySuggestion, contextualTip } fr
 const SPINNER = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
 const MOUSE_ON = '\x1b[?1000h\x1b[?1006h';
 const MOUSE_OFF = '\x1b[?1000l\x1b[?1006l';
-const HELP = `# Comal · teclado
-
-| Acción | Tecla |
-| --- | --- |
-| Descubrir comandos y herramientas | F6 |
-| Completar comando o argumento | / y Tab; ↑/↓ elige; Esc cierra |
-| Enviar / encolar | Enter (las sugerencias sólo completan) |
-| Nueva línea | Alt+Enter o Ctrl+J |
-| Cambiar modo | Shift+Tab |
-| Editar con $VISUAL/$EDITOR | Ctrl+G |
-| Tablero de trabajo | F3 o /board |
-| Continuar desde checkpoint | /work resume |
-| Sesiones / reanudar | F2 o Ctrl+S |
-| Cola de mensajes | F4 o Ctrl+Q |
-| Desplegar resultados de herramientas | Ctrl+O |
-| Scroll del historial | Rueda del mouse / PgUp / PgDn |
-| Seleccionar texto con el mouse | F5 o /select; F5 o Esc vuelve |
-| Copiar última respuesta completa | Alt+C o /copy |
-| Ir al final | Ctrl+End |
-| Historial del composer | ↑/↓ en primera/última línea |
-| Inicio / final de línea | Home / End o Ctrl+A / Ctrl+E |
-| Borrar palabra / inicio / final | Ctrl+W / Ctrl+U / Ctrl+K |
-| Cancelar turno / pausar goal | Ctrl+C o Esc mientras trabaja |
-| Salir | Ctrl+D con composer vacío o /exit |
-
-Puedes seguir escribiendo durante el streaming. Los mensajes enviados se ejecutan en orden al terminar el turno actual. F4 permite pausar, editar, quitar y reordenar la cola.
-
-/context muestra el presupuesto de contexto. /compact deriva el estado sin LLM y espera su turno si hay trabajo activo. /state muestra petición y estado; /audit verifica el libro. El historial original se conserva.
-/house muestra recibos de ejecución y operaciones interrumpidas; /operations muestra contratos y efectos declarados. El éxito de ejecución no certifica el objetivo humano.
-/plugins muestra plugins, dependencias y operaciones; enable/disable/reload esperan su turno y sólo el usuario puede cambiar su ciclo de vida.
-/model ID y /effort NIVEL cambian la siguiente llamada; durante trabajo quedan en cola. /models lista modelos y /capabilities muestra soporte, procedencia y niveles. E indica esfuerzo; Ctx muestra la ventana efectiva (k/M tokens); ~ indica un límite configurado, ? capacidad desconocida/fallback. /context muestra valores exactos, reserva y fuente. /login PROVEEDOR autentica; /logout PROVEEDOR retira credenciales de Comal.
-
-**La ayuda mantiene activo el composer.** Puedes escribir mientras la consultas; PgUp/PgDn la desplaza y Esc/F1 la cierra. Al enviar vuelve la conversación. La rueda desplaza la conversación; las flechas editan el borrador. F5 libera el mouse y congela la vista: arrastra para seleccionar y usa la acción de copiar de tu terminal (normalmente Ctrl+Shift+C). El trabajo continúa y la vista se actualiza al volver. /copy conserva Markdown y bloques de código, sin el ajuste de líneas de la pantalla. El pegado multilínea no se envía automáticamente.`;
+const HELP = "# Comal · keyboard\n\n| Action | Key |\n| --- | --- |\n| Discover commands and tools | F6 |\n| Complete command or argument | / and Tab; ↑/↓ chooses; Esc closes |\n| Send / enqueue | Enter (suggestions only complete) |\n| New line | Alt+Enter or Ctrl+J |\n| Switch mode | Shift+Tab |\n| Edit with $VISUAL/$EDITOR | Ctrl+G |\n| Work board | F3 or /board |\n| Continue from checkpoint | /work resume |\n| Sessions / resume | F2 or Ctrl+S |\n| Message queue | F4 or Ctrl+Q |\n| Expand tool results | Ctrl+O |\n| Scroll history | Mouse wheel / PgUp / PgDn |\n| Select text with mouse | F5 or /select; F5 or Esc returns |\n| Copy last full response | Alt+C or /copy |\n| Go to end | Ctrl+End |\n| Composer history | ↑/↓ on first/last line |\n| Start / end of line | Home / End or Ctrl+A / Ctrl+E |\n| Delete word / start / end | Ctrl+W / Ctrl+U / Ctrl+K |\n| Cancel turn / pause goal | Ctrl+C or Esc while working |\n| Exit | Ctrl+D with empty composer or /exit |\n\nYou can keep typing during streaming. Sent messages run in order when the current turn ends. F4 lets you pause, edit, remove, and reorder the queue.\n\n/context shows the context budget. /compact derives state without LLM and waits its turn if there is active work. /state shows request and state; /audit verifies the ledger. The original history is preserved.\n/house shows execution receipts and interrupted operations; /operations shows contracts and declared effects. Execution success does not certify the human goal.\n/plugins shows plugins, dependencies, and operations; enable/disable/reload wait their turn and only the user can change their lifecycle.\n/model ID and /effort LEVEL change the next call; during work they stay queued. /models lists models and /capabilities shows support, provenance, and levels. E indicates effort; Ctx shows the effective window (k/M tokens); ~ indicates a configured limit, ? unknown/fallback capability. /context shows exact values, reserve, and source. /login PROVIDER authenticates; /logout PROVIDER removes credentials from Comal.\n\n**Help keeps the composer active.** You can type while viewing it; PgUp/PgDn scrolls it and Esc/F1 closes it. Sending returns to the conversation. The wheel scrolls the conversation; the arrows edit the draft. F5 releases the mouse and freezes the view: drag to select and use your terminal's copy action (usually Ctrl+Shift+C). Work continues and the view updates when you return. /copy preserves Markdown and code blocks, without the screen line wrapping. Multi-line paste is not sent automatically.";
 
 export class TerminalScreen {
   constructor({ input = process.stdin, output = process.stdout, metadata = {}, clipboard = copyText, env = process.env } = {}) {
     Object.assign(this, { input, output, metadata, env }); this.composer = new Composer(); this.markdown = new MarkdownRenderer(); this.tables = new DataTableParser();
     this.clipboard = clipboard; this.selecting = false;
     this.blocks = []; this.toolBlocks = new Map(); this.subagentBlocks = new Map(); this.countedChildResults=new Set(); this.queue = { items: [], paused: false, interrupted: [] }; this.busy = false; this.ready = false;
-    this.mode = metadata.mode || 'default'; this.phase = 'Conectando con el modelo'; this.frame = 0; this.scroll = 0; this.lastContentLength = 0; this.expandedTools = false;
+    this.mode = metadata.mode || 'default'; this.phase = t("Connecting to the model"); this.frame = 0; this.scroll = 0; this.lastContentLength = 0; this.expandedTools = false;
     this.discovery = {}; this.completionIndex = 0; this.brandStarted = Date.now();
     this.callbacks = {}; this.closed = false; this.suspended = false; this.previous = []; this.goal = null; this.usage = 0; this.turn = 0; this.maxTurns = 12;
     this.finished = new Promise(resolve => this.resolveFinished = resolve);
   }
   start() {
+    if (this.started || this.closed) return this;
     this.started = true;
     this.originalRaw = this.input.isRaw || false;
     this.input.setRawMode?.(true); this.input.resume();
@@ -65,11 +35,113 @@ export class TerminalScreen {
     this.output.write('\x1b[?1049h\x1b[?2004h\x1b[?25l' + MOUSE_ON);
     this.timer = setInterval(() => {
       const welcome = !this.blocks.length && this.motionEnabled() && this.brandFrame() < BRAND_WELCOME_FRAMES;
-      if ((this.busy || !this.ready || welcome) && !this.suspended && !this.selecting) { this.frame++; this.render(); }
+      if ((this.busy || !this.ready || welcome || this.setup?.kind === 'status' || this.setup?.validating) && !this.suspended && !this.selecting) { this.frame++; this.render(); }
     }, 120);
     this.render(); return this;
   }
-  configure(callbacks) { this.callbacks = callbacks; this.ready = true; this.phase = 'Listo'; this.schedule(); }
+  configure(callbacks) { this.clearSetup(); this.callbacks = callbacks; this.ready = true; this.phase = t("Ready"); this.schedule(); }
+  // Setup owns the existing terminal surface before a provider/session exists.
+  // Its editor is isolated from conversation drafts, history and callbacks.
+  beginSetup(state, signal, resolve = () => {}) {
+    this.clearSetup();
+    if (this.closed || signal?.aborted) { resolve(null); return null; }
+    let settled = false;
+    state.finish = value => {
+      if (settled) return; settled = true;
+      signal?.removeEventListener('abort', abort);
+      state.editor?.clear(); state.editor = null;
+      if (this.setup === state) this.setup = null;
+      resolve(value); this.schedule();
+    };
+    const abort = () => state.finish(null);
+    signal?.addEventListener('abort', abort, { once: true });
+    this.setup = state; this.schedule(); return state;
+  }
+  clearSetup() { this.setup?.finish(null); }
+  setupChoice({ title, description = '', items, signal } = {}) {
+    if (!Array.isArray(items) || !items.length || items.length > 100 || items.some(item => typeof item?.id !== 'string' || !item.id || typeof item.label !== 'string') || new Set(items.map(item => item.id)).size !== items.length) throw new Error(t('Setup requires between 1 and 100 distinct choices.'));
+    return new Promise(resolve => this.beginSetup({ kind: 'choice', title: safeText(title || t('Choose a connection')), description: safeText(description), items: items.map(item => ({ id: item.id, label: safeText(item.label), description: safeText(item.description || '') })), index: 0 }, signal, resolve));
+  }
+  setupInput({ title, description = '', value = '', secret = false, signal, validate } = {}) {
+    const clean = safeText(value).replace(/[\r\n\t]+/g, ' ');
+    if (Buffer.byteLength(clean) > 4096) throw new Error(t('Setup values support up to 4096 bytes.'));
+    return new Promise(resolve => this.beginSetup({ kind: 'input', title: safeText(title || t('Connection settings')), description: safeText(description), editor: new Composer(clean), secret: Boolean(secret), validate }, signal, resolve));
+  }
+  setupStatus({ title, description = '', signal } = {}) {
+    this.beginSetup({ kind: 'status', title: safeText(title || t('Connecting')), description: safeText(description) }, signal);
+  }
+  insertSetupText(text) {
+    const state = this.setup; if (state?.kind !== 'input' || state.validating) return;
+    const clean = safeText(text, { preserveTabs: true }).replace(/[\r\n\t]+/g, ' ');
+    if (Buffer.byteLength(state.editor.text + clean) > 4096) state.error = t('Use at most 4096 bytes.');
+    else { state.editor.insert(clean); state.error = null; }
+    this.schedule();
+  }
+  async handleSetupKey(text, key) {
+    const state = this.setup, name = key.name;
+    if (name === 'escape' || key.ctrl && name === 'c') {
+      state.finish(null);
+      if (state.kind === 'status') await this.callbacks.onSetupCancel?.();
+      if (key.ctrl && name === 'c') { if (this.callbacks.onInterrupt) await this.callbacks.onInterrupt(); else await this.callbacks.onAction?.('interrupt'); }
+      return;
+    }
+    if (state.kind === 'status' || state.validating) return;
+    if (state.kind === 'choice') {
+      if (name === 'up') state.index = Math.max(0, state.index - 1);
+      else if (name === 'down') state.index = Math.min(state.items.length - 1, state.index + 1);
+      else if (name === 'home') state.index = 0;
+      else if (name === 'end') state.index = state.items.length - 1;
+      else if (name === 'return' && !key.meta && !key.shift) state.finish(state.items[state.index].id);
+      this.schedule(); return;
+    }
+    if (name === 'return' && !key.meta && !key.shift) {
+      const value = state.editor.text; state.validating = true; state.error = null; this.schedule();
+      try {
+        const result = await state.validate?.(value);
+        if (this.setup !== state) return;
+        if (result === false || typeof result === 'string' && result.length) state.error = state.secret ? t('Check the value and try again.') : safeText(typeof result === 'string' ? result : t('Check the value and try again.'));
+        else state.finish(value);
+      } catch (error) { if (this.setup === state) state.error = state.secret ? t('Check the value and try again.') : safeText(error?.message || t('Check the value and try again.')); }
+      finally { state.validating = false; this.schedule(); }
+      return;
+    }
+    if (name === 'return' || name === 'linefeed' || key.ctrl && name === 'j') return;
+    if (!key.ctrl && !key.meta && text && !text.startsWith('\x1b')) this.insertSetupText(text);
+    else { state.editor.key('', key); state.error = null; this.schedule(); }
+  }
+  renderSetup(columns, rows) {
+    const state = this.setup, inner = Math.max(1, columns - 4);
+    const header = [tone.bold(' COMAL') + tone.accent(t(' · setup')), tone.muted('─'.repeat(columns))];
+    const title = wrap(state.title, inner).map(line => '  ' + tone.accent(line));
+    const description = wrap(state.description, inner).map(line => '  ' + tone.muted(line));
+    const prefix = [...header, '', ...title, '', ...description, ''];
+    const cancellation = this.ready ? t('Ctrl+C cancels') : t('Ctrl+C exits');
+    const hint = (state.kind === 'choice' ? t('↑/↓ choose · Enter continues · Esc back') : state.kind === 'input' ? t('Enter continues · Esc back') : t('Esc back')) + ' · ' + cancellation;
+    let body = [], cursor = null;
+    const budget = Math.max(1, rows - Math.min(prefix.length, rows - 4) - 2);
+    if (state.kind === 'choice') {
+      const start = Math.max(0, state.index - Math.max(1, Math.floor(budget / 2)) + 1);
+      for (let index = start; index < state.items.length && body.length < budget; index++) {
+        const item = state.items[index], selected = index === state.index;
+        body.push((selected ? tone.accent : tone.muted)(`  ${selected ? '❯' : ' '} ${clip(item.label, Math.max(1, columns - 5))}`));
+        if (item.description && body.length < budget) body.push('    ' + tone.muted(clip(item.description, Math.max(1, columns - 5))));
+      }
+    } else if (state.kind === 'input') {
+      const editor = state.editor, display = state.secret ? new Composer('•'.repeat(editor.buffer.length)) : editor;
+      if (state.secret) display.cursor = editor.cursor;
+      const layout = display.layout(Math.max(2, columns - 6)), height = Math.max(1, budget - (state.error ? 1 : 0)), offset = Math.max(0, layout.cursorRow - height + 1);
+      body = layout.lines.slice(offset, offset + height).map((line, index) => tone.muted(index === 0 ? '  ❯ ' : '  │ ') + line);
+      cursor = { row: layout.cursorRow - offset + 1, col: layout.cursorColumn + 5 };
+      if (state.error) body.push('  ' + tone.warning(clip(state.error, inner)));
+    } else body.push('  ' + tone.accent(this.spinner() + ' ' + t('Working…')));
+    if (state.validating) body.push('  ' + tone.muted(this.spinner() + ' ' + t('Checking…')));
+    const visiblePrefix = prefix.slice(0, Math.max(0, rows - Math.min(body.length, budget) - 2));
+    const lines = [...visiblePrefix, ...body.slice(0, budget)];
+    if (cursor) cursor.row += visiblePrefix.length;
+    while (lines.length < rows - 1) lines.push(''); lines.push(' ' + tone.muted(clip(hint, columns - 1)));
+    if (state.validating) cursor = null;
+    this.draw(lines, cursor, columns, rows);
+  }
   schedule() {
     if (this.closed || this.suspended || this.selecting || this.renderTimer) return;
     this.renderTimer = setTimeout(() => { this.renderTimer = null; this.render(); }, 24);
@@ -80,7 +152,7 @@ export class TerminalScreen {
   setDiscovery(context = {}) { this.discovery = structuredClone(context); this.schedule(); }
   discoveryContext() { return { ...this.discovery, effortLevels: this.metadata.modelCapabilities?.effort?.levels || this.discovery.effortLevels, busy: this.busy, queue: this.queue, mode: this.mode, selecting: this.selecting, editingQueue: this.editingQueue }; }
   refreshDiscovery() { this.callbacks.onDiscover?.(); }
-  hasModalOverlay() { return Boolean(this.overlay && this.overlay.kind !== 'help'); }
+  hasModalOverlay() { return Boolean(this.setup || this.overlay && this.overlay.kind !== 'help'); }
   completion() {
     const signature = JSON.stringify([this.composer.text, this.composer.cursor]);
     if (signature !== this.completionSignature) { this.completionSignature = signature; this.completionIndex = 0; }
@@ -98,7 +170,7 @@ export class TerminalScreen {
     if (!item) return false;
     if (result.exact === item) result.items = [item];
     const next = applySuggestion(this.composer.text, result, item);
-    this.composer.setText(next.text, next.cursor); this.draftChanged(); return true;
+    this.composer.setText(next.text, next.cursor, this.composer.attachments.map(({start,end,...item})=>item)); this.draftChanged(); return true;
   }
   showPalette() { this.refreshDiscovery(); this.overlay = { kind: 'palette', filter: '', index: 0, tab: 'command', detail: null, scroll: 0 }; this.schedule(); }
   paletteItems() {
@@ -109,17 +181,18 @@ export class TerminalScreen {
   paletteTool() { return this.discovery.tools?.find(tool => tool.name === this.overlay?.detail); }
   preparePaletteItem(item) {
     if (item.inspectOnly) { this.overlay.detail = item.label; this.overlay.scroll = 0; this.schedule(); return; }
-    if (!this.preparedDraft) this.preparedDraft = { text: this.composer.text, cursor: this.composer.cursor, sessionId: this.metadata.sessionId };
+    if (!this.preparedDraft) this.preparedDraft = { ...this.composer.snapshot(), sessionId: this.metadata.sessionId };
     this.composer.setText(item.value);
     this.closeOverlay(); this.draftChanged();
   }
-  updateMetadata(metadata) { if(['model','provider','profile','effort'].some(key=>metadata[key]!==undefined && metadata[key]!==this.metadata[key]))this.cacheReadTokens=null; Object.assign(this.metadata, metadata); if (metadata.mode) this.mode = metadata.mode; this.schedule(); }
+  updateMetadata(metadata) { const changed=['model','provider','profile','effort'].some(key=>metadata[key]!==undefined && metadata[key]!==this.metadata[key]); if(changed)this.cacheReadTokens=null; Object.assign(this.metadata, metadata); if (metadata.mode) this.mode = metadata.mode; if(changed)this.callbacks.onCapabilitiesChanged?.(); this.schedule(); }
   setMode(mode) { this.mode = mode; this.schedule(); }
   setQueue(snapshot) { this.queue = snapshot; this.schedule(); }
-  setBusy(value) { this.busy = value; if (value) { this.startedAt = Date.now(); this.turn = 0; this.phase = 'Preparando turno'; } else this.phase = 'Listo'; this.schedule(); }
+  setBusy(value) { this.busy = value; if (value) { this.startedAt = Date.now(); this.turn = 0; this.phase = t("Preparing turn"); } else this.phase = t("Ready"); this.schedule(); }
   notice(text, error = false) { this.blocks.push({ role: 'notice', text: safeText(text), error }); if (error && this.overlay) this.overlay.error = safeText(text); this.schedule(); }
-  setDraft(text) { this.composer.setText(text); this.schedule(); }
-  draftChanged() { this.callbacks.onDraft?.(this.composer.text); this.schedule(); }
+  setDraft(text, attachments = []) { this.composer.setText(text, undefined, attachments); this.schedule(); }
+  setAttachmentStatus(status) { this.attachmentStatus = status; this.schedule(); }
+  draftChanged() { if (!this.composer.attachments.length) this.attachmentStatus = null; this.callbacks.onDraft?.(this.composer.text, this.composer.attachments); this.schedule(); }
   addTable(text, format, title) { const data = this.tables.parse(text, format); this.blocks.push({ role: 'table', data, text: title }); this.schedule(); }
   loadSession(session) {
     this.cacheReadTokens=null;
@@ -128,16 +201,19 @@ export class TerminalScreen {
     for (const [responseId, row] of rows.entries()) {
       const message = row.message;
       if (message.role === 'user' && typeof message.content === 'string' && row.source !== 'goal') this.blocks.push({ role: 'user', text: message.content });
+      if (message.role === 'user' && row.source === 'human_composer' && Array.isArray(message.content)) this.blocks.push({role:'user',text:message.content.filter(block=>block.type==='text').map(block=>block.text).join('\n')});
       for (const block of Array.isArray(message.content) ? message.content : []) {
         if (message.role === 'assistant' && block.type === 'text') this.blocks.push({ role: 'assistant', text: block.text, responseId });
         if (message.role === 'assistant' && block.type === 'tool_use') { const item = { role: 'tool', id: block.id, name: block.name, input: block.input, state: 'interrupted' }; this.blocks.push(item); this.toolBlocks.set(block.id, item); }
         if (message.role === 'user' && block.type === 'tool_result') { const item = this.toolBlocks.get(block.tool_use_id); if (item) { item.state = block.is_error ? 'error' : 'done'; item.output = block.content; } }
       }
     }
-    this.composer.history = rows.filter(row => row.message.role === 'user' && typeof row.message.content === 'string' && row.source !== 'goal').map(row => row.message.content).slice(-100);
-    this.composer.setText(session.draft || ''); this.metadata.sessionId = session.id; this.metadata.model = session.model; this.metadata.name = session.name;
+    const history = rows.filter(row => row.message.role === 'user' && row.source !== 'goal' && (typeof row.message.content === 'string' || row.source === 'human_composer')).slice(-100);
+    this.composer.history = history.map(row => typeof row.message.content === 'string' ? row.message.content : row.message.content.filter(block=>block.type==='text').map(block=>block.text).join('\n'));
+    this.composer.historyAttachments = history.map(row=>row.attachments || []);
+    this.composer.setText(session.draft || '', undefined, session.draftAttachments || []); this.attachmentStatus = null; this.metadata.sessionId = session.id; this.metadata.model = session.model; this.metadata.name = session.name;
     this.context = null; this.work = workProjection(session);
-    if (session.compaction) this.notice(`Contexto reanudado desde el libro: ~${session.compaction.after_tokens} tokens. Historial original conservado.`);
+    if (session.compaction) this.notice(t("Context resumed from the ledger: ~{v0} tokens. Original history preserved.", {v0: session.compaction.after_tokens}));
     this.countedChildResults.clear();let childUsage=0;
     for (const row of session.rows.filter(row => row.type === 'subagent')) {
       if(this.countChildResult(row))childUsage+=(row.usage?.input_tokens || 0)+(row.usage?.output_tokens || 0);
@@ -157,28 +233,28 @@ export class TerminalScreen {
   handleEvent(event) {
     if(event.type==='usage_accounting')this.cacheReadTokens=Number.isSafeInteger(event.accounting?.cache_read_tokens)?event.accounting.cache_read_tokens:null;
     if (event.type === 'model_stream_progress') {
-      if (event.tool_argument_chars) this.phase = `Preparando herramientas · ${event.tool_argument_chars.toLocaleString()} caracteres`;
-      else if (event.reasoning_chars && !event.text_chars) this.phase = `Modelo razonando · ${event.reasoning_chars.toLocaleString()} caracteres`;
+      if (event.tool_argument_chars) this.phase = t("Preparing tools · {v0} characters", {v0: formatNumber(event.tool_argument_chars)});
+      else if (event.reasoning_chars && !event.text_chars) this.phase = t("Model reasoning · {v0} characters", {v0: formatNumber(event.reasoning_chars)});
     }
     if (event.type === 'context_usage') this.context = event;
     if (event.type === 'vision_status') {
       const stamp = JSON.stringify([event.supported, event.source, event.images, event.references?.map(ref => ref.sha256)]);
-      if (stamp !== this.lastVisionStamp) { this.lastVisionStamp = stamp; this.notice(event.images ? `Visión · ${event.images} imágenes en la petición · reserva ~${event.token_reserve} tokens.` : `Captura guardada como referencia · ${event.supported ? 'sin espacio para píxeles en el contexto' : 'el proveedor no anuncia visión'}.`); }
+      if (stamp !== this.lastVisionStamp) { this.lastVisionStamp = stamp; this.notice(event.images ? t("Vision · {v0} images in the request · reserve ~{v1} tokens.", {v0: event.images, v1: event.token_reserve}) : t("Screenshot saved as a reference · {v0}.", {v0: event.supported ? t("no space for pixels in the context") : t("the provider does not advertise vision")})); }
     }
-    if (event.type === 'context_projection_start') this.phase = 'Derivando estado del libro';
-    if (event.type === 'context_projection') this.notice(`Estado derivado · ~${event.after_tokens} tokens · 0 llamadas de resumen al LLM · evidencia guardada.`);
+    if (event.type === 'context_projection_start') this.phase = t("Deriving state from the ledger");
+    if (event.type === 'context_projection') this.notice(t("State derived \u00b7 ~{v0} tokens \u00b7 0 LLM summary calls \u00b7 evidence saved.", {v0: event.after_tokens}));
     if (['model_retry', 'response_discarded'].includes(event.type)) {
-      if (this.streaming) { this.streaming.text += '\n\n[Respuesta incompleta descartada; no se ejecutaron sus herramientas.]'; this.streaming = null; }
-      if (event.type === 'model_retry') this.notice(`Respuesta descartada (${event.reason}) · reintento acotado · salida máxima ${event.max_tokens} tokens.`);
+      if (this.streaming) { this.streaming.text += t("\n\n[Incomplete response discarded; its tools were not executed.]"); this.streaming = null; }
+      if (event.type === 'model_retry') this.notice(t("Response discarded ({v0}) · bounded retry · maximum output {v1} tokens.", {v0: event.reason, v1: event.max_tokens}));
     }
     if (['mcp_reload', 'plugin_status'].includes(event.type)) this.refreshDiscovery();
-    if (event.type === 'mcp_reload') this.notice(`MCP actualizado · ${event.servers.filter(server => server.status === 'connected').length} servidores conectados · ${event.tools.length} herramientas disponibles en packs.`);
+    if (event.type === 'mcp_reload') this.notice(t("MCP updated · {v0} servers connected · {v1} tools available in packs.", {v0: event.servers.filter(server => server.status === 'connected').length, v1: event.tools.length}));
     if (event.type === 'plugin_status') {
-      if (event.state === 'loading') this.phase = `Activando plugin ${event.id}`;
-      if (['active', 'disabled'].includes(event.state)) this.notice(`Plugin ${event.id} · ${event.state}${event.operations ? ` · ${event.operations.length} operaciones` : ''}`);
+      if (event.state === 'loading') this.phase = t("Enabling plugin {v0}", {v0: event.id});
+      if (['active', 'disabled'].includes(event.state)) this.notice(t("Plugin {v0} · {v1}{v2}", {v0: event.id, v1: event.state, v2: event.operations ? t(" · {v0} operations", {v0: event.operations.length}) : ''}));
       if (['failed', 'cleanup_failed', 'observer_failed'].includes(event.state)) this.notice(`Plugin ${event.id}: ${event.error}`, true);
     }
-    if (event.type === 'mcp_reload_error') this.notice(`No se aplicó la recarga MCP: ${event.error}`, true);
+    if (event.type === 'mcp_reload_error') this.notice(t("MCP reload not applied: {v0}", {v0: event.error}), true);
     if (event.type === 'mcp_progress') {
       const tool = [...this.toolBlocks.values()].findLast(block => block.name === event.name && block.state === 'running');
       if (tool) { tool.progress = event; tool.cacheKey = null; }
@@ -203,19 +279,19 @@ export class TerminalScreen {
     if (event.type === 'user' && event.source !== 'goal') this.blocks.push({ role: 'user', text: event.userIntent || event.text });
     if (event.type === 'text_delta') {
       if (!this.streaming) { this.streaming = { role: 'assistant', text: '' }; this.blocks.push(this.streaming); }
-      this.streaming.text += event.text; this.phase = 'Recibiendo respuesta';
+      this.streaming.text += event.text; this.phase = t("Receiving response");
     }
     if (event.type === 'assistant') {
       if (!this.streaming) { const text = event.message.content.filter(b => b.type === 'text').map(b => b.text).join(''); if (text) this.blocks.push({ role: 'assistant', text }); }
       this.streaming = null;
     }
-    if (event.type === 'tool_use') { const item = { role: 'tool', id: event.id, name: event.name, input: event.input, state: 'running' }; this.blocks.push(item); this.toolBlocks.set(event.id, item); this.phase = `Ejecutando ${event.name}`; }
+    if (event.type === 'tool_use') { const item = { role: 'tool', id: event.id, name: event.name, input: event.input, state: 'running' }; this.blocks.push(item); this.toolBlocks.set(event.id, item); this.phase = t("Executing {v0}", {v0: event.name}); }
     if (event.type === 'tool_result') { const item = this.toolBlocks.get(event.tool_use_id); if (item) { item.state = event.is_error ? 'error' : 'done'; item.output = event.content; } }
     if (event.type === 'auto_decision') this.blocks.push({ role: 'notice', text: `Auto · ${event.decision}: ${event.reason}`, error: event.decision === 'deny' });
     if (event.type === 'model_progress') { this.turn = event.turn; this.maxTurns = event.maxTurns; }
     if (event.type === 'phase') {
-      if (event.state === 'start') this.phase = { worker: 'Esperando al modelo', classifier: 'Revisando permiso auto', 'goal-evaluation': 'Verificando /goal' }[event.phase] || event.phase;
-      else if (this.busy) this.phase = 'Procesando turno';
+      if (event.state === 'start') this.phase = { worker: t("Waiting for the model"), classifier: t("Checking auto permission"), 'goal-evaluation': t("Checking /goal") }[event.phase] || event.phase;
+      else if (this.busy) this.phase = t("Processing turn");
     }
     if (event.type === 'goal_status') {
       const key = `${event.goal.id}:${event.goal.status}:${event.goal.lastReason}`;
@@ -223,10 +299,10 @@ export class TerminalScreen {
       this.goal = event.goal;
     }
     if (event.type === 'result' && !event.usage_includes_subagents) this.usage += (event.usage?.input_tokens || 0) + (event.usage?.output_tokens || 0);
-    if (event.type === 'work_continuation') this.notice(`Continúa ${event.task_id} · ${event.calls}/${event.limit} llamadas · checkpoint conservado.`);
-    if(event.type==='peer_reply')this.notice(event.status==='failed'?`La casa no pudo enviar el informe: ${event.error}`:`La casa devolvió el informe al buzón ${event.to.slice(0,8)} · ${event.status}.`,event.status==='failed');
-    if (event.type === 'result' && event.work_stop_reason) this.notice(`Trabajo: ${event.work_stop_reason}.`);
-    if (event.type === 'work_open') this.notice(`Quedan ${event.remaining.length} tareas abiertas · /work resume continúa desde el checkpoint.`);
+    if (event.type === 'work_continuation') this.notice(t("Continues {v0} · {v1}/{v2} calls · checkpoint preserved.", {v0: event.task_id, v1: event.calls, v2: event.limit}));
+    if(event.type==='peer_reply')this.notice(event.status==='failed'?t("The house could not send the report: {v0}", {v0: event.error}):t("The house returned the report to mailbox {v0} · {v1}.", {v0: event.to.slice(0,8), v1: event.status}),event.status==='failed');
+    if (event.type === 'result' && event.work_stop_reason) this.notice(t("Work: {v0}.", {v0: event.work_stop_reason}));
+    if (event.type === 'work_open') this.notice(t("{v0} open tasks remain · /work resume continues from the checkpoint.", {v0: event.remaining.length}));
     if (event.type === 'work_board' && (!event.session_id || event.session_id === this.metadata.sessionId)) this.work = event.board;
     if (event.type === 'result' && event.work) this.work = event.work;
     if (event.type === 'init') this.metadata.model = event.model;
@@ -237,9 +313,11 @@ export class TerminalScreen {
     if (signal?.aborted || this.closed) return false;
     if (this.selecting) this.setSelection(false);
     return new Promise(resolve => {
-      const finish = allowed => { signal?.removeEventListener('abort', abort); this.permission = null; this.schedule(); resolve(allowed); };
+      let settled=false;
+      const finish = allowed => { if(settled)return;settled=true;signal?.removeEventListener('abort', abort);if(this.permission===question)this.permission = null;this.schedule();resolve(allowed); };
       const abort = () => finish(false);
-      this.permission = { name, input, allowed: false, scroll: 0, finish }; signal?.addEventListener('abort', abort, { once: true }); this.schedule();
+      const question = { name, input, allowed: false, scroll: 0, finish };
+      this.permission = question;signal?.addEventListener('abort', abort, { once: true });if(signal?.aborted)abort();else this.schedule();
     });
   }
   showSessions(items) { this.overlay = { kind: 'sessions', items, filter: '', index: Math.max(0, items.findIndex(item => item.id !== this.metadata.sessionId)) }; this.schedule(); }
@@ -248,6 +326,7 @@ export class TerminalScreen {
   closeOverlay() { this.overlay = null; this.callbacks.onAction?.('queueKick'); this.schedule(); }
   filteredSessions() { const query = this.overlay?.filter?.toLowerCase() || ''; return (this.overlay?.items || []).filter(item => `${item.name || ''} ${item.prompt} ${item.id} ${item.model}`.toLowerCase().includes(query)); }
   paste(text) {
+    if (this.setup) { this.insertSetupText(text); return; }
     if (this.selecting) return;
     if (this.permission) return;
     if (this.overlay?.kind === 'palette' && !this.overlay.detail) { this.overlay.filter += safeText(text).replace(/\n/g, ' ').slice(0, 150); this.overlay.index = 0; this.schedule(); return; }
@@ -264,14 +343,15 @@ export class TerminalScreen {
   }
   async copyResponse() {
     const block = this.blocks.findLast(block => block.role === 'assistant' && block.text?.trim());
-    if (!block) throw new Error('Todavía no hay una respuesta para copiar.');
+    if (!block) throw new Error(t("There is no response to copy yet."));
     const partial = block === this.streaming;
     const text = block.responseId === undefined ? block.text : this.blocks.filter(item => item.role === 'assistant' && item.responseId === block.responseId).map(item => item.text).join('');
     await this.clipboard(text);
-    this.notice(partial ? 'Texto recibido hasta ahora copiado al portapapeles; la respuesta sigue llegando.' : 'Respuesta completa copiada al portapapeles (Markdown original).');
+    this.notice(partial ? t("Text received so far copied to clipboard; the response is still arriving.") : t("Full response copied to clipboard (original Markdown)."));
   }
   handleMouse(event) {
     if (this.closed || this.suspended || this.selecting || event.type !== 'wheel') return;
+    if (this.setup) { if (this.setup.kind === 'choice') this.setup.index = Math.max(0, Math.min(this.setup.items.length - 1, this.setup.index + event.delta)); this.schedule(); return; }
     const lines = event.delta * 3;
     if (this.permission) this.permission.scroll = Math.max(0, this.permission.scroll + lines);
     else if (['help', 'board'].includes(this.overlay?.kind)) this.overlay.scroll = Math.max(0, this.overlay.scroll + lines);
@@ -286,6 +366,7 @@ export class TerminalScreen {
   }
   async handleKey(text, key = {}) {
     if (this.closed || this.suspended) return;
+    if (this.setup) { await this.handleSetupKey(text, key); return; }
     const name = key.name;
     if (this.selecting) {
       if (name === 'f5' || name === 'escape' || (key.ctrl && name === 'c')) this.setSelection(false);
@@ -312,10 +393,10 @@ export class TerminalScreen {
         else if (name === 'pagedown' || name === 'down') this.overlay.scroll += 3;
         else if (name === 'tab' && !key.shift) {
           const tool = this.paletteTool();
-          if (!tool) { this.notice('Esa operación ya no está publicada. Vuelve al catálogo.', true); return; }
-          if (tool.audience === 'human') { this.notice('Control humano: usa el comando correspondiente o /plugins run; no se pide al modelo.', true); return; }
-          if (!this.preparedDraft) this.preparedDraft = { text: this.composer.text, cursor: this.composer.cursor, sessionId: this.metadata.sessionId };
-          this.composer.setText(`Usa la herramienta ${safeText(tool.name)} para ${this.composer.text}`);
+          if (!tool) { this.notice(t("That operation is no longer published. Return to the catalog."), true); return; }
+          if (tool.audience === 'human') { this.notice(t("Human control: use the corresponding command or /plugins run; the model is not asked."), true); return; }
+          if (!this.preparedDraft) this.preparedDraft = { ...this.composer.snapshot(), sessionId: this.metadata.sessionId };
+          this.composer.setText(t("Use the tool {v0} to {v1}", {v0: safeText(tool.name), v1: this.composer.text}), undefined, this.composer.attachments.map(({start,end,...item})=>item));
           this.closeOverlay(); this.draftChanged(); return;
         }
       } else if (name === 'tab') { this.overlay.tab = this.overlay.tab === 'tool' ? 'command' : 'tool'; this.overlay.index = 0; }
@@ -363,7 +444,7 @@ export class TerminalScreen {
     if (key.ctrl && name === 'g') { await this.callbacks.onAction?.('editor'); return; }
     if (key.ctrl && name === 'd' && !this.composer.text) { await this.callbacks.onAction?.('exit'); return; }
     if (name === 'escape' && this.completion().items.length) { this.dismissedCompletion = this.completionSignature; this.schedule(); return; }
-    if (name === 'escape' && this.preparedDraft) { const draft = this.preparedDraft; this.preparedDraft = null; this.composer.setText(draft.text, draft.cursor); this.draftChanged(); return; }
+    if (name === 'escape' && this.preparedDraft) { const draft = this.preparedDraft; this.preparedDraft = null; this.composer.setText(draft.text, draft.cursor, draft.attachments); this.draftChanged(); return; }
     if (name === 'escape') { if (this.editingQueue) await this.callbacks.onAction?.('queueEditCancel'); else if (this.busy) await this.callbacks.onAction?.('interrupt'); return; }
     if (name === 'pageup') { this.scroll += Math.max(5, (this.output.rows || 24) - 10); this.schedule(); return; }
     if (name === 'pagedown') { this.scroll = Math.max(0, this.scroll - Math.max(5, (this.output.rows || 24) - 10)); this.schedule(); return; }
@@ -379,15 +460,23 @@ export class TerminalScreen {
     }
     if (name === 'return' && !key.shift && !key.meta && completion.items.length) { this.acceptCompletion(); return; }
     if (name === 'return' && !key.shift && !key.meta) {
+      if (this.submitting) return;
       const value = this.composer.text; if (!value.trim()) return;
-      if (!this.ready) { this.notice('Todavía conectando; el borrador se conserva.'); return; }
+      if (!this.ready) { this.notice(t("Still connecting; the draft is preserved.")); return; }
       if (this.overlay?.kind === 'help') this.closeOverlay();
       const draft = this.preparedDraft;
-      this.composer.remember(value); this.composer.clear(); this.draftChanged();
+      let prepared = this.composer.snapshot(), submitted = false;
+      this.submitting = true;
       try {
-        await this.callbacks.onSubmit?.(value);
-        if (draft && draft.sessionId === this.metadata.sessionId && !this.composer.text) { this.preparedDraft = null; this.composer.setText(draft.text, draft.cursor); this.draftChanged(); }
-      } catch (e) { if (!this.composer.text) this.composer.setText(value); this.preparedDraft = draft; this.notice(e.message, true); this.draftChanged(); }
+        const original = JSON.stringify(prepared), sessionId = this.metadata.sessionId;
+        if (this.callbacks.onPrepareSubmit) prepared = await this.callbacks.onPrepareSubmit(prepared) || prepared;
+        const current = JSON.stringify(this.composer.snapshot());
+        if (sessionId !== this.metadata.sessionId || (current !== original && current !== JSON.stringify(prepared))) throw new Error(t('The draft changed while preparing the image. Press Enter again to send the current draft.'));
+        this.composer.remember(prepared.text, prepared.attachments); this.composer.clear(); this.draftChanged(); submitted = true;
+        await this.callbacks.onSubmit?.(prepared.text, prepared.attachments);
+        if (draft && draft.sessionId === this.metadata.sessionId && !this.composer.text) { this.preparedDraft = null; this.composer.setText(draft.text, draft.cursor, draft.attachments); this.draftChanged(); }
+      } catch (e) { if (submitted && !this.composer.text) this.composer.setText(prepared.text, prepared.cursor, prepared.attachments); this.preparedDraft = draft; this.notice(e.message, true); this.draftChanged(); }
+      finally { this.submitting = false; }
       return;
     }
     this.composer.key(text, key, Math.max(2, (this.output.columns || 80) - 7)); this.draftChanged();
@@ -396,22 +485,22 @@ export class TerminalScreen {
     const output = [];
     if (!this.blocks.length) {
       const mark = brandingWelcome({ columns: Math.max(0, columns - 4), frame: this.brandFrame(), active: this.busy, env: this.env, stream: this.output });
-      const intro = [tone.bold('  ¿Qué construimos hoy?'), '', ...wrap('  Escribe una tarea; / o F6 te muestran qué puedes hacer.', columns), '', tone.muted('  F6 descubrir · F2 sesiones · Shift+Tab modo')];
+      const intro = [tone.bold(t("  What are we building today?")), '', ...wrap(t("  Type a task; / or F6 show you what you can do."), columns), '', tone.muted(t("  F6 discover · F2 sessions · Shift+Tab mode"))];
       const branded = ['', ...mark.map(line => '  ' + line), '', ...intro];
       if (branded.length <= this.bodyHeight) output.push(...branded);
-      else output.push('', tone.accent('  COMAL · sobre el comal se cocina'), '', ...intro);
+      else output.push('', tone.accent(t("  COMAL · on the comal one cooks")), '', ...intro);
     }
     for (const block of this.blocks) {
       const cacheKey = `${columns}:${this.expandedTools}:${block.text || ''}:${block.state || ''}:${block.output || ''}`;
       if (block.cacheKey === cacheKey) { output.push(...block.cached); continue; }
       let lines;
-      if (block.role === 'user') lines = [tone.accent('  Tú'), ...wrap(safeText(block.text), columns - 4).map(line => '  ' + line), ''];
+      if (block.role === 'user') lines = [tone.accent(t("  You")), ...wrap(safeText(block.text), columns - 4).map(line => '  ' + line), ''];
       else if (block.role === 'assistant') lines = [tone.bold('  Comal'), ...this.markdown.render(block.text, columns - 4).map(line => '  ' + line), ''];
       else if (block.role === 'notice') lines = wrap((block.error ? tone.bad : tone.muted)(safeText(`  ${block.error ? '✗' : '·'} ${block.text}`)), columns);
       else if (block.role === 'table') lines = [tone.accent('  ' + block.text), ...this.tables.render(block.data, columns - 4).map(line => '  ' + line), ''];
       else if (block.role === 'subagent') {
         const icon = ['running','queued','waiting'].includes(block.runner_state || block.state) ? this.spinner() : block.work_state==='checks_verified' ? '✓' : block.state==='paused' ? '◇' : block.state==='completed' ? '·' : '✗';
-        lines = ['  ' + tone.accent(clip(safeText(`${icon} Subagente ${block.id.slice(0, 8)} · ${block.subagent_type} · ${block.description}`), columns - 4)), '    ' + tone.muted(clip(safeText(`${block.runner_state || block.state} · ${block.turn_state || block.status || block.state} · ${block.work_state || 'unjudged'} · calls ${block.turns || 0}/${block.max_turns || 6}${block.lastTool ? ' · ' + block.lastTool : ''}`), columns - 6))];
+        lines = ['  ' + tone.accent(clip(safeText(t("{v0} Subagent {v1} · {v2} · {v3}", {v0: icon, v1: block.id.slice(0, 8), v2: block.subagent_type, v3: block.description})), columns - 4)), '    ' + tone.muted(clip(safeText(`${block.runner_state || block.state} · ${block.turn_state || block.status || block.state} · ${block.work_state || 'unjudged'} · calls ${block.turns || 0}/${block.max_turns || 6}${block.lastTool ? ' · ' + block.lastTool : ''}`), columns - 6))];
         if (this.expandedTools || ['failed', 'cancelled', 'interrupted','paused'].includes(block.state)) lines.push(...wrap(safeText(block.error || block.result || block.text || ''), columns - 6).slice(0, 15).map(line => '    ' + line));
       }
       else {
@@ -432,62 +521,63 @@ export class TerminalScreen {
     if (this.overlay?.kind === 'palette' && !this.permission) {
       if (this.overlay.detail) {
         const tool = this.paletteTool();
-        if (!tool) return [tone.warning('  Operación retirada del catálogo'), tone.muted('  Esc vuelve; no se ejecutó nada.')];
-        const lines = [tone.accent('  ' + safeText(tool.name)), ...wrap(safeText(tool.description), columns - 4).map(line => '  ' + line), '', tone.muted(`  Audiencia: ${safeText(tool.audience || 'any')} · origen: ${safeText(tool.origin?.plugin || tool.origin?.kind || 'núcleo/MCP')}`), tone.muted('  Consultar no autoriza. La ejecución conserva el juicio de la casa.'), ...wrap(safeText('Efectos declarados: ' + Object.entries(tool.effects || {}).map(([key,value]) => `${key}=${value}`).join(' · ')), columns - 4).map(line => '  ' + tone.muted(line)), '', tone.bold('  Argumentos · * obligatorio')];
-        for (const [name, schema] of Object.entries(tool.input_schema?.properties || {})) lines.push(...wrap(safeText(`${tool.input_schema?.required?.includes(name) ? '* ' : '  '}${name} · ${schema.type || 'valor'}${schema.enum ? ' · ' + schema.enum.join(' | ') : ''}${schema.description ? ' · ' + schema.description : ''}`), columns - 6).map(line => '    ' + line));
-        if (!Object.keys(tool.input_schema?.properties || {}).length) lines.push(tone.muted('    Sin campos declarados.'));
-        lines.push('', tone.muted(tool.audience === 'human' ? '  Control humano · Esc vuelve al catálogo' : '  Tab prepara una petición · no envía · Esc vuelve'));
+        if (!tool) return [tone.warning(t("  Operation removed from the catalog")), tone.muted(t("  Esc returns; nothing was executed."))];
+        const lines = [tone.accent('  ' + safeText(tool.name)), ...wrap(safeText(tool.description), columns - 4).map(line => '  ' + line), '', tone.muted(t("  Audience: {v0} · source: {v1}", {v0: safeText(tool.audience || 'any'), v1: safeText(tool.origin?.plugin || tool.origin?.kind || t("core/MCP"))})), tone.muted(t("  Consulting does not authorize. Execution preserves the house's judgment.")), ...wrap(safeText(t("Declared effects: ") + Object.entries(tool.effects || {}).map(([key,value]) => `${key}=${value}`).join(' · ')), columns - 4).map(line => '  ' + tone.muted(line)), '', tone.bold(t("  Arguments · * required"))];
+        for (const [name, schema] of Object.entries(tool.input_schema?.properties || {})) lines.push(...wrap(safeText(`${tool.input_schema?.required?.includes(name) ? '* ' : '  '}${name} · ${schema.type || t("value")}${schema.enum ? ' · ' + schema.enum.join(' | ') : ''}${schema.description ? ' · ' + schema.description : ''}`), columns - 6).map(line => '    ' + line));
+        if (!Object.keys(tool.input_schema?.properties || {}).length) lines.push(tone.muted(t("    No fields declared.")));
+        lines.push('', tone.muted(tool.audience === 'human' ? t("  Human control · Esc returns to catalog") : t("  Tab prepares a request · does not send · Esc returns")));
         this.overlay.scroll = Math.min(this.overlay.scroll, Math.max(0, lines.length - height)); return lines.slice(this.overlay.scroll, this.overlay.scroll + height);
       }
       const items = this.paletteItems(); this.overlay.index = Math.max(0, Math.min(this.overlay.index, items.length - 1));
       const visible = Math.max(1, height - 5), start = Math.max(0, this.overlay.index - visible + 1);
-      return [tone.accent(`  Descubrir · ${this.overlay.tab === 'tool' ? 'HERRAMIENTAS' : 'COMANDOS'} · ${items.length}`), tone.muted('  Tab cambia sección · ↑/↓ elige · Enter prepara/inspecciona · Esc vuelve'), `  Buscar: ${safeText(this.overlay.filter) || tone.muted('escribe para filtrar')}`, '', ...items.slice(start, start + visible).map((item, i) => {
+      return [tone.accent(t("  Discover · {v0} · {v1}", {v0: this.overlay.tab === 'tool' ? t("TOOLS") : t("COMMANDS"), v1: items.length})), tone.muted(t("  Tab changes section · ↑/↓ chooses · Enter prepares/inspects · Esc returns")), t("  Search: {v0}", {v0: safeText(this.overlay.filter) || tone.muted(t("type to filter"))}), '', ...items.slice(start, start + visible).map((item, i) => {
         const selected = start + i === this.overlay.index, labelWidth = Math.max(10, Math.floor(columns * .36));
         const label = `  ${selected ? '❯' : ' '} ${safeText(item.label)}`;
         const line = columns >= 55 ? pad(clip(label, labelWidth), labelWidth) + ' ' + safeText(item.description) : label;
         return (selected ? tone.accent : String)(clip(line, columns));
-      }), ...(!items.length ? [tone.muted('  Sin coincidencias. Cambia de sección con Tab.')] : [])];
+      }), ...(!items.length ? [tone.muted(t("  No matches. Change section with Tab."))] : [])];
     }
     if (this.overlay?.kind === 'board' && !this.permission) {
-      const board = this.work, lines = [tone.accent(`  Trabajo · plan v${board?.plan?.version || 0}`), ...wrap(safeText(board?.plan?.objective || 'Sin plan. Pide una tarea con pasos y comprobaciones.'), columns - 4).map(line => '  ' + line), tone.muted('  /work resume continúa · rueda/PgUp/PgDn desplaza · Esc vuelve'), ''];
-      const labels = { pending: 'PENDIENTE', in_progress: 'EN CURSO', blocked: 'BLOQUEADO', done: 'HECHO · checks registrados', needs_verification: 'POR VERIFICAR' };
-      for (const [status, label] of Object.entries(labels)) { const cards = board?.cards.filter(card => card.status === status) || []; if (!cards.length) continue; lines.push(tone.accent(`  ${label} (${cards.length})`)); for (const card of cards) { lines.push(...wrap(safeText(`${card.id} · ${card.title}`), columns - 6).map(line => '    ' + line)); if (card.held_by?.length || card.reason) lines.push(...wrap(safeText(card.reason || `Espera: ${card.held_by.join(', ')}`), columns - 8).map(line => '      ' + tone.muted(line))); } lines.push(''); }
-      if (board?.next_action) lines.push(...wrap(safeText('Siguiente: ' + board.next_action), columns - 4).map(line => '  ' + line));
+      const board = this.work, lines = [tone.accent(t("  Work · plan v{v0}", {v0: board?.plan?.version || 0})), ...wrap(safeText(board?.plan?.objective || t("No plan. Ask for a task with steps and checks.")), columns - 4).map(line => '  ' + line), tone.muted(t("  /work resume continues · wheel/PgUp/PgDn scrolls · Esc returns")), ''];
+      const labels = { pending: t("PENDING"), in_progress: t("IN PROGRESS"), blocked: t("BLOCKED"), done: t("DONE · checks recorded"), needs_verification: t("TO VERIFY") };
+      for (const [status, label] of Object.entries(labels)) { const cards = board?.cards.filter(card => card.status === status) || []; if (!cards.length) continue; lines.push(tone.accent(`  ${label} (${cards.length})`)); for (const card of cards) { lines.push(...wrap(safeText(`${card.id} · ${card.title}`), columns - 6).map(line => '    ' + line)); if (card.held_by?.length || card.reason) lines.push(...wrap(safeText(card.reason || t("Waiting: {v0}", {v0: card.held_by.join(', ')})), columns - 8).map(line => '      ' + tone.muted(line))); } lines.push(''); }
+      if (board?.next_action) lines.push(...wrap(safeText(t("Next: ") + board.next_action), columns - 4).map(line => '  ' + line));
       this.overlay.scroll = Math.min(this.overlay.scroll, Math.max(0, lines.length - height)); return lines.slice(this.overlay.scroll, this.overlay.scroll + height);
     }
     if (this.permission) {
       const permission = this.permission, details = wrap(safeText(JSON.stringify(permission.input, null, 2)), columns - 6);
       permission.scroll = Math.min(permission.scroll, Math.max(0, details.length - height + 5));
-      return [tone.warning(`  Autorizar ${permission.name}`), tone.muted(`  Detalle ${permission.scroll + 1}/${details.length} · PgUp/PgDn para revisar`), '', ...details.slice(permission.scroll, permission.scroll + height - 5).map(line => '  ' + line), '', `  ${permission.allowed ? tone.good('❯ Sí') : '  Sí'}        ${!permission.allowed ? tone.warning('❯ No') : '  No'}   · Enter confirma · y/n · Esc deniega`];
+      return [tone.warning(t("  Allow {v0}", {v0: permission.name})), tone.muted(t("  Detail {v0}/{v1} · PgUp/PgDn to review", {v0: permission.scroll + 1, v1: details.length})), '', ...details.slice(permission.scroll, permission.scroll + height - 5).map(line => '  ' + line), '', t("  {v0}        {v1}   · Enter confirms · y/n · Esc denies", {v0: permission.allowed ? tone.good(t("❯ Yes")) : t("  Yes"), v1: !permission.allowed ? tone.warning('❯ No') : '  No'})];
     }
     if (this.overlay.kind === 'help') {
-      const lines = [tone.muted('  Ayuda · composer activo · escribe abajo · PgUp/PgDn desplaza · Esc/F1 cierra'), '', ...this.markdown.render(HELP, columns - 4).map(line => '  ' + line)];
+      const lines = [tone.muted(t("  Help · composer active · type below · PgUp/PgDn scrolls · Esc/F1 closes")), '', ...this.markdown.render(t(HELP), columns - 4).map(line => '  ' + line)];
       this.overlay.scroll = Math.min(this.overlay.scroll, Math.max(0, lines.length - height));
       return lines.slice(this.overlay.scroll, this.overlay.scroll + height);
     }
     if (this.overlay.kind === 'sessions') {
       const items = this.filteredSessions(); const visible = Math.max(1, height - 5), start = Math.max(0, this.overlay.index - visible + 1);
-      return [tone.accent('  Sesiones · ' + this.overlay.items.length), `  Buscar: ${this.overlay.filter || tone.muted('escribe para filtrar')}`, this.overlay.error ? tone.bad('  ' + this.overlay.error) : tone.muted('  ↑/↓ elegir · Enter reanuda con historial · Esc vuelve'), '', ...items.slice(start, start + visible).map((item, i) => {
-        const selected = start + i === this.overlay.index, title = `${item.invalid ? '✗ ' : ''}${item.name || item.prompt || '(vacía)'}`;
+      return [tone.accent(t("  Sessions · ") + this.overlay.items.length), t("  Search: {v0}", {v0: this.overlay.filter || tone.muted(t("type to filter"))}), this.overlay.error ? tone.bad('  ' + this.overlay.error) : tone.muted(t("  ↑/↓ choose · Enter resumes with history · Esc returns")), '', ...items.slice(start, start + visible).map((item, i) => {
+        const selected = start + i === this.overlay.index, title = `${item.invalid ? '✗ ' : ''}${item.name || item.prompt || t("(empty)")}`;
         const left = pad(safeText(`${selected ? '❯' : ' '} ${title}`), Math.max(8, columns - 40));
         const right = safeText(`${item.id.slice(0, 8)}  ${item.messages} msgs  ${item.model}`);
         return '  ' + (selected ? tone.accent : String)(clip(left + right, columns - 4));
-      }), ...(!items.length ? [tone.muted('  No hay coincidencias.')] : [])];
+      }), ...(!items.length ? [tone.muted(t("  No matches."))] : [])];
     }
-    const status = this.queue.paused ? 'pausada' : 'activa';
-    const lines = [tone.accent(`  Cola de mensajes · ${status}`), tone.muted('  e editar · d quitar · Ctrl+↑/↓ ordenar · Espacio pausar/reanudar · Esc volver'), ''];
-    if (this.queue.running) lines.push(tone.muted('  En ejecución: ' + clip(safeText(this.queue.running.text), columns - 20)), '');
+    const status = this.queue.paused ? t("paused") : t("active");
+    const lines = [tone.accent(t("  Message queue · {v0}", {v0: status})), tone.muted(t("  e edit · d remove · Ctrl+↑/↓ reorder · Space pause/resume · Esc return")), ''];
+    if (this.queue.running) lines.push(tone.muted(t("  Running: ") + clip(safeText(this.queue.running.text), columns - 20)), '');
     this.queue.items.forEach((item, index) => { lines.push((index === this.overlay.index ? tone.accent : String)(`  ${index === this.overlay.index ? '❯' : ' '} ${index + 1}. ${clip(safeText(item.text).replace(/\n/g, ' ↵ '), columns - 9)}`)); });
-    if (!this.queue.items.length) lines.push(tone.muted('  Cola vacía. Envía un mensaje mientras el agente trabaja.'));
-    if (this.queue.interrupted?.length) lines.push('', tone.warning(`  ${this.queue.interrupted.length} mensaje(s) interrumpidos; no se reenviaron. R reencola el primero.`));
+    if (!this.queue.items.length) lines.push(tone.muted(t("  Empty queue. Send a message while the agent works.")));
+    if (this.queue.interrupted?.length) lines.push('', tone.warning(t("  {v0} interrupted message(s); not resent. R requeues the first.", {v0: this.queue.interrupted.length})));
     return lines.slice(0, height);
   }
   render(selectionEntry = false) {
     if (this.closed || this.suspended || (this.selecting && !selectionEntry)) return;
     const columns = Math.max(1, (this.output.columns || 80) - 1), rows = this.output.rows || 24;
-    if (columns < 23 || rows < 10) { this.draw([clip('Amplía el terminal a 24×10', columns)], null, columns, rows); return; }
+    if (columns < 23 || rows < 10) { this.draw([clip(t("Enlarge the terminal to 24×10"), columns)], null, columns, rows); return; }
+    if (this.setup) { this.renderSetup(columns, rows); return; }
     const composer = this.composer.layout(columns - 6), composerHeight = Math.min(6, rows - 8, Math.max(2, composer.lines.length));
-    const location = ` ${clip(safeText(this.metadata.cwd || ''), Math.max(4, columns - 27))}  ·  ${safeText(this.metadata.sessionId?.slice(0, 8) || 'conectando')}`;
+    const location = ` ${clip(safeText(this.metadata.cwd || ''), Math.max(4, columns - 27))}  ·  ${safeText(this.metadata.sessionId?.slice(0, 8) || t("connecting"))}`;
     const report = this.metadata.modelCapabilities;
     const budget = this.metadata.contextBudget;
     const capacity = budget?.contextWindow;
@@ -495,13 +585,13 @@ export class TerminalScreen {
     const capacityLabel = `Ctx:${amount}${amount === '?' ? '' : budget.kind === 'fallback' ? '?' : budget.kind === 'configured' || budget.source === 'comal_limit' ? '~' : ''}`;
     const indicators = [`E:${safeText(this.metadata.effort || 'auto')}`, capacityLabel];
     if (this.metadata.workflow) indicators.push(safeText(this.metadata.workflow));
-    for (const [key, label] of [['thinking', 'think'], ['vision', 'visión'], ['video', 'video'], ['web_search', 'web']]) {
+    for (const [key, label] of [['thinking', 'think'], ['vision', t("vision")], ['video', 'video'], ['web_search', 'web']]) {
       if (report?.capabilities?.[key] === true) indicators.push(label + (report.provenance?.[key]?.kind === 'configured' ? '~' : ''));
     }
     if (report && Object.values(report.capabilities).some(value => value === null)) indicators.push('caps?');
     const modelLabel = clip(' ' + indicators.join(' · '), Math.max(8, Math.floor(columns / 2)));
     const locationLine = columns >= 50 ? pad(clip(location, columns - width(modelLabel) - 1), columns - width(modelLabel)) + modelLabel : location;
-    const header = [tone.bold(' COMAL') + (this.metadata.name ? tone.accent(safeText(` @${this.metadata.name}`)) : '') + tone.muted(safeText(`  ${this.metadata.model || 'modelo local'}  ·  ${this.metadata.authProvider || this.metadata.provider || 'openai'}  ·  `)) + tone.accent(this.mode), tone.muted(locationLine), tone.muted('─'.repeat(columns))];
+    const header = [tone.bold(' COMAL') + (this.metadata.name ? tone.accent(safeText(` @${this.metadata.name}`)) : '') + tone.muted(safeText(`  ${this.metadata.model || t("local model")}  ·  ${this.metadata.authProvider || this.metadata.provider || 'openai'}  ·  `)) + tone.accent(this.mode), tone.muted(locationLine), tone.muted('─'.repeat(columns))];
     const completions = this.completion();
     const availableBody = Math.max(1, rows - header.length - composerHeight - 4);
     const completionHeight = completions.items.length ? Math.min(5, Math.max(0, availableBody - 1)) : 0;
@@ -518,19 +608,19 @@ export class TerminalScreen {
     }
     while (body.length < bodyHeight) body.push(''); body = body.slice(0, bodyHeight);
     if (sideWidth) {
-      const side = [tone.accent(` Cola · ${this.queue.items.length}${this.queue.paused ? ' pausada' : ''}`), tone.muted(' F4 gestionar'), ''];
-      if (this.queue.running) side.push(tone.muted(' En ejecución'), ...wrap(safeText(this.queue.running.text), sideWidth - 2).slice(0, 2).map(line => ' ' + line), '');
+      const side = [tone.accent(t(" Queue · {v0}{v1}", {v0: this.queue.items.length, v1: this.queue.paused ? t(" paused") : ''})), tone.muted(t(" F4 manage")), ''];
+      if (this.queue.running) side.push(tone.muted(t(" Running")), ...wrap(safeText(this.queue.running.text), sideWidth - 2).slice(0, 2).map(line => ' ' + line), '');
       this.queue.items.slice(0, 6).forEach((item, i) => side.push(tone.accent(` ${i + 1}. `) + clip(safeText(item.text).replace(/\n/g, ' ↵ '), sideWidth - 5), ''));
       body = body.map((line, i) => pad(line, bodyWidth) + tone.muted(' │') + clip(side[i] || '', sideWidth));
     }
     const elapsed = this.startedAt ? ((Date.now() - this.startedAt) / 1000).toFixed(1) : '0.0';
     const active = this.busy || !this.ready;
-    const contextLabel = this.context ? ` · ctx ${this.context.estimated===false?'':'~'}${this.context.percent}%${this.context.accounting_method==='measured_prefix_estimated_tail'?' · base medida':''}${Number.isSafeInteger(this.cacheReadTokens)?' · caché '+this.cacheReadTokens.toLocaleString():''}` : '';
-    const status = (active ? `${brandingStatus({frame:this.brandFrame(),active:true,env:this.env,stream:this.output})} ${this.spinner()} ${this.phase} · ${elapsed}s` : `● Listo · ${this.usage.toLocaleString()} tokens`) + contextLabel;
-    const measure = this.goal?.status === 'active' ? `goal calls ${this.goal.calls}/${this.goal.limits.maxCalls} ${progressBar(this.goal.calls, this.goal.limits.maxCalls, 12)}` : this.busy ? `calls ${this.turn}/${this.maxTurns} ${progressBar(this.turn, this.maxTurns, 12)}` : `${this.queue.items.length} en cola${this.queue.paused ? ' · pausada' : ''}`;
-    const workLabel = this.work?.plan ? ` · trabajo ${this.work.counts.done}/${this.work.cards.length}${this.work.current ? ' · ' + this.work.current.id : ''}` : '';
-    const bar = tone.accent(' ' + status + workLabel) + '  ' + tone.muted(measure) + (this.scroll ? tone.warning(' · historial ↑') : '');
-    let composerHeading = this.editingQueue ? tone.warning(' Editando mensaje en cola · Enter guarda · Esc cancela') : tone.muted(` Composer · ${this.busy ? 'Enter encola' : 'Enter envía'} · Alt+Enter multilínea · Ctrl+G editor`);
+    const contextLabel = this.context ? ` · ctx ${this.context.estimated===false?'':'~'}${this.context.percent}%${this.context.accounting_method==='measured_prefix_estimated_tail'?t(" · measured baseline"):''}${Number.isSafeInteger(this.cacheReadTokens)?t(" · cache ")+formatNumber(this.cacheReadTokens):''}` : '';
+    const status = (active ? `${brandingStatus({frame:this.brandFrame(),active:true,env:this.env,stream:this.output})} ${this.spinner()} ${this.phase} · ${elapsed}s` : t("● Ready · {v0} tokens", {v0: formatNumber(this.usage)})) + contextLabel;
+    const measure = this.goal?.status === 'active' ? `goal calls ${this.goal.calls}/${this.goal.limits.maxCalls} ${progressBar(this.goal.calls, this.goal.limits.maxCalls, 12)}` : this.busy ? `calls ${this.turn}/${this.maxTurns} ${progressBar(this.turn, this.maxTurns, 12)}` : t("{v0} in queue{v1}", {v0: this.queue.items.length, v1: this.queue.paused ? t(" · paused") : ''});
+    const workLabel = this.work?.plan ? t(" · work {v0}/{v1}{v2}", {v0: this.work.counts.done, v1: this.work.cards.length, v2: this.work.current ? ' · ' + this.work.current.id : ''}) : '';
+    const bar = tone.accent(' ' + status + workLabel) + '  ' + tone.muted(measure) + (this.scroll ? tone.warning(t(" · history ↑")) : '');
+    let composerHeading = this.editingQueue ? tone.warning(t(" Editing queued message · Enter saves · Esc cancels")) : tone.muted(t(" Composer · {v0} · Alt+Enter multiline · Ctrl+G editor", {v0: this.busy ? t("Enter queues") : t("Enter sends")}));
     const sessionName = safeText(this.metadata.name || '').replace(/[\r\n]+/g, ' ').trim();
     if (sessionName) {
       const labelWidth = Math.min(Math.floor(columns / 2), columns - 12);
@@ -541,10 +631,10 @@ export class TerminalScreen {
     const footer = [clip(bar, columns), tone.muted('─'.repeat(columns)), composerHeading];
     const offset = Math.max(0, composer.cursorRow - composerHeight + 1);
     const inputLines = Array.from({ length: composerHeight }, (_, i) => tone.muted(i === 0 ? ' ❯ ' : ' │ ') + (composer.lines[offset + i] || ''));
-    const hints = this.selecting ? tone.warning(' SELECCIÓN · Arrastra y copia desde tu terminal · F5/Esc vuelve') : tone.muted(' ' + (completions.items.length ? 'Tab o Enter completa · ↑/↓ elige · Esc cierra · no envía' : (this.overlay?.kind === 'help' ? 'Ayuda abierta · composer activo · PgUp/PgDn desplaza · Esc/F1 cierra' : this.preparedDraft ? 'Acción preparada · Esc recupera tu borrador · Enter envía y lo restaura' : contextualTip(this.composer.text, this.discoveryContext()))));
+    const hints = this.selecting ? tone.warning(t(" SELECTION · Drag and copy from your terminal · F5/Esc returns")) : this.attachmentStatus ? (['unsupported','invalid'].includes(this.attachmentStatus.state) ? tone.warning : tone.muted)(' ' + safeText(this.attachmentStatus.message)) : tone.muted(' ' + (completions.items.length ? t("Tab or Enter completes · ↑/↓ chooses · Esc closes · does not send") : (this.overlay?.kind === 'help' ? t("Help open · composer active · PgUp/PgDn scrolls · Esc/F1 closes") : this.preparedDraft ? t("Action prepared · Esc recovers your draft · Enter sends and restores it") : contextualTip(this.composer.text, this.discoveryContext()))));
     const suggestionLines = [];
     if (completionHeight) {
-      suggestionLines.push(tone.muted(`  Sugerencias · ${completions.items.length} · Tab completa`));
+      suggestionLines.push(tone.muted(t("  Suggestions · {v0} · Tab completes", {v0: completions.items.length})));
       const visible = completionHeight - 1, start = Math.max(0, this.completionIndex - visible + 1);
       for (const [i,item] of completions.items.slice(start, start + visible).entries()) {
         const selected = start + i === this.completionIndex;
@@ -578,6 +668,7 @@ export class TerminalScreen {
   resume() { this.input.setRawMode?.(true); this.input.resume(); this.suspended = false; this.previous = []; this.output.write('\x1b[?1049h\x1b[?2004h' + MOUSE_ON); this.render(); }
   close() {
     if (this.closed) return; this.closed = true;
+    this.clearSetup();
     this.permission?.finish(false); clearInterval(this.timer); clearTimeout(this.renderTimer); this.decoder?.close();
     if (this.onData) this.input.off('data', this.onData); if (this.onResize) this.output.off('resize', this.onResize);
     if (this.started) { this.input.setRawMode?.(this.originalRaw); this.input.pause(); if (!this.suspended) this.output.write('\x1b[0m' + MOUSE_OFF + '\x1b[?2004l\x1b[?25h\x1b[?1049l'); }