@getparallel/parx 0.4.3 → 0.4.4

package/CHANGELOG.md

@@ -6,6 +6,13 @@ changes). Entries are generated by `npm run release` from the git history of `ap
 
 <!-- Notes written under «## Unreleased» are used as the next entry instead of the git log. -->
 
+## 0.4.4 (2026-10-11)
+
+- parx always shows what it is doing: «Thinking…» from the first moment, then the real step as it happens («Reading src/app.ts…», «Searching for useAuth…», «Editing 2 files…», «Running tests…», «Writing the answer…»), with the time and the Actions. If the server takes a while, only honest phrases («Planning the steps…», «Looking at the results…», «Waiting for the server…»); the old brand phrases are gone. Same in `--lanes`, at 40 columns, with `NO_COLOR` and `--ascii`.
+- The answer is written out word by word with a soft cursor, in 2 seconds at most, and ends exactly as before (markdown, code blocks, wrapping). Only the rows that change are repainted; scrolling up while it writes does not jump. Any key shows the rest at once; `/animation off` (saved) or `--no-animation` shows answers whole, and so do pipes, CI, `--lanes` and `/report`.
+- `/new` starts truly fresh: the screen and the terminal scrollback are cleared in one go, the queue, the waiting lines and what the agent remembers are gone, and you see the welcome and the tips again, like when parx opens. Mode, model and sign-in stay. If a task is running, it asks «Stop and start new?» with buttons first.
+- `/mouse off` is remembered in the next session too (it was saved but not read back).
+
 ## 0.4.3 (2026-10-11)
 
 - Each permission mode has its own colour, from least to most freedom: Read only teal, Ask violet, Auto orange, Bypass red. It shows in the status row, the `/mode` menu, the `/mode` confirmation, `/help` and the `╱╱` input marker; bash mode keeps its amber.

package/README.md

@@ -93,10 +93,19 @@ when it asks first:
 ## Inside a session
 
 The input sits at the bottom from the start; the status lives in one place, the row under the rail:
-the mode and the model at rest; while it works, what it is doing in plain words («Reading 3 files»,
-«Running tests», or «Tracing the route…» while it plans), the time and the Actions so far, with a
-small rail animation (a dot along the route, a train on the track, a sleeper scanning the rails, the
-track being laid).
+the mode and the model at rest; while it works, it always says what it is doing right now, with a
+small rail animation in violet, the time and the Actions so far. It is never silent: «Thinking…»
+while Parallel thinks, then the real step as it happens («Reading src/app.ts…», «Searching for
+useAuth…», «Editing 2 files…», «Running tests…», «Running git status…», «Writing the answer…»). If
+the server takes a while, only what is really going on («Planning the steps…», «Looking at the
+results…», «Waiting for the server…»). It works the same in `--lanes` (one row per lane), at 40
+columns, with `NO_COLOR` and with `--ascii`.
+
+**The answer is written out**, word by word, with a soft cursor, in 2 seconds at most (long answers
+go faster). It is laid out whole first, so markdown and code blocks end exactly as if they had
+appeared at once, and scrolling up while it writes does not move what you are reading. Any key shows
+the rest at once. `/animation off` (saved) or `--no-animation` shows answers whole; without a
+terminal (a pipe, CI), in `--lanes` and in `/report` they are always whole.
 
 Type `/` for the commands; the menu filters as you type, ↑ ↓ move, Tab or Enter pick, Esc closes.
 
@@ -110,10 +119,12 @@ Type `/` for the commands; the menu filters as you type, ↑ ↓ move, Tab or En
 | `/inbox` | what your missions are waiting for (approvals, proposed changes, your steps), as buttons; what you pick takes effect like on the web |
 | `/report` | a plain-language summary of what was done, copied to the clipboard for an email or WhatsApp |
 | `/teach` | class mode: explains each step as it codes, like a teacher |
-| `/undo`, `/new`, `/balance`, `/log`, `/help`, `/exit` | the usual |
+| `/new` | a clean conversation, as if you had just opened parx: the screen, the terminal scrollback, the queue and what the agent remembers are cleared (mode, model and sign-in stay). If a task is running it asks «Stop and start new?» first |
+| `/undo`, `/balance`, `/log`, `/help`, `/exit` | the usual |
 | `/notify` on, off | desktop notifications |
 | `/tips` on, off | the welcome tips |
 | `/mouse` on, off | clicks and wheel inside parx (saved; `--no-mouse` for one session) |
+| `/animation` on, off | answers written out as they arrive, or whole (saved; `--no-animation` for one session) |
 
 **Bash mode:** start the input with `!` and it turns amber with a small `bash` label; Enter runs the
 command in your shell, in the project folder, and its output streams into the conversation with the

package/dist/actividad.js

@@ -0,0 +1,131 @@
+import { capacidades, c } from "./marca.js";
+import { t } from "./textos.js";
+import { anchoDeCaracter, sinColor } from "./texto.js";
+export function elipsis() {
+    return capacidades().unicode ? '…' : '...';
+}
+export function conElipsis(texto) {
+    const s = texto.trimEnd();
+    if (!s || /(…|\.\.\.|[.!?:])$/.test(s))
+        return s;
+    return `${s}${elipsis()}`;
+}
+const AL_EMPEZAR = [
+    [0, 'trabajo.pensando'],
+    [6_000, 'trabajo.planear'],
+    [15_000, 'trabajo.sigue'],
+    [35_000, 'trabajo.servidor'],
+];
+const TRAS_HERRAMIENTAS = [
+    [0, 'trabajo.pensando'],
+    [5_000, 'trabajo.resultados'],
+    [11_000, 'trabajo.siguiente'],
+    [20_000, 'trabajo.sigue'],
+    [40_000, 'trabajo.servidor'],
+];
+export function fraseDeEspera(ms, trasHerramientas = false) {
+    const tabla = trasHerramientas ? TRAS_HERRAMIENTAS : AL_EMPEZAR;
+    let clave = tabla[0][1];
+    for (const [desde, k] of tabla)
+        if (Math.max(0, ms) >= desde)
+            clave = k;
+    return conElipsis(t(clave));
+}
+export const CARACTERES_POR_SEGUNDO = 110;
+export const MS_MAX_RESPUESTA = 2000;
+export const MS_MAX_INTERMEDIO = 900;
+export const MS_POR_FOTOGRAMA = 33;
+export function duracionDeRevelado(caracteres, maxMs = MS_MAX_RESPUESTA) {
+    if (caracteres <= 0)
+        return 0;
+    return Math.round(Math.min(maxMs, Math.max(160, (caracteres / CARACTERES_POR_SEGUNDO) * 1000)));
+}
+export function caracteresVisibles(total, ms, duracion) {
+    if (duracion <= 0 || ms >= duracion)
+        return total;
+    return Math.max(0, Math.min(total, Math.floor((total * Math.max(0, ms)) / duracion)));
+}
+export function cursorEncendido(ms) {
+    return Math.floor(Math.max(0, ms) / 500) % 2 === 0;
+}
+export function simboloDeCursor() {
+    return c.violeta(capacidades().unicode ? '▍' : '_');
+}
+export function caracteresDe(lineas) {
+    let n = 0;
+    for (const l of lineas)
+        n += anchoVisible(l);
+    return n;
+}
+function anchoVisible(l) {
+    let n = 0;
+    for (const ch of sinColor(l))
+        n += anchoDeCaracter(ch);
+    return n;
+}
+const ESCAPE = /\x1b\[[0-9;?]*[ -/]*[@-~]/y;
+export function cortarVisible(linea, n) {
+    if (n <= 0)
+        return '';
+    let out = '';
+    let w = 0;
+    let color = false;
+    let i = 0;
+    while (i < linea.length) {
+        if (linea[i] === '\x1b') {
+            ESCAPE.lastIndex = i;
+            const m = ESCAPE.exec(linea);
+            if (m) {
+                out += m[0];
+                color = true;
+                i += m[0].length;
+                continue;
+            }
+        }
+        const ch = String.fromCodePoint(linea.codePointAt(i));
+        const cw = anchoDeCaracter(ch);
+        if (w + cw > n)
+            return `${out}${color ? '\x1b[0m' : ''}`;
+        out += ch;
+        w += cw;
+        i += ch.length;
+    }
+    return out;
+}
+export function revelarLineas(lineas, n, cursor, ancho = Infinity) {
+    const total = caracteresDe(lineas);
+    if (n >= total)
+        return cursor ? conCursor([...lineas], cursor, ancho) : [...lineas];
+    const out = [];
+    let quedan = Math.max(0, n);
+    for (const l of lineas) {
+        const w = anchoVisible(l);
+        if (quedan >= w) {
+            out.push(l);
+            quedan -= w;
+            continue;
+        }
+        const plano = Array.from(sinColor(l));
+        let cols = 0;
+        let k = 0;
+        while (k < plano.length && cols < quedan)
+            cols += anchoDeCaracter(plano[k++]);
+        while (k < plano.length && plano[k] !== ' ')
+            cols += anchoDeCaracter(plano[k++]);
+        const parte = cortarVisible(l, cols);
+        out.push(sinColor(parte).trim() ? parte : '');
+        break;
+    }
+    while (out.length > 1 && out[out.length - 1] === '' && lineas[out.length - 1] !== '')
+        out.pop();
+    return cursor ? conCursor(out, cursor, ancho) : out;
+}
+function conCursor(lineas, cursor, ancho) {
+    if (!lineas.length)
+        return [cursor];
+    const i = lineas.length - 1;
+    const l = lineas[i];
+    if (anchoVisible(l) + 1 < ancho)
+        lineas[i] = `${l.replace(/\s+$/, '')}${anchoVisible(l) ? ' ' : ''}${cursor}`;
+    return lineas;
+}

package/dist/agente.js

@@ -153,29 +153,31 @@ export async function hacerTarea(s, pedido, señal, imagenes = []) {
             disponibles = r.acciones.disponibles;
             pantalla.progreso(acciones);
             registro.apuntar('turno', { tarea, vuelta, acciones });
-            const llamadas = [];
+            const llamadas = r.salida.filter((i) => i.type === 'function_call');
             for (const item of r.salida) {
                 s.conversacion.push(item);
                 if (item.type === 'message') {
                     const texto = textoDeMensaje(item).trim();
                     if (texto) {
                         respuesta = texto;
+                        pantalla.espera(t('hace.respuesta'), 'tendido', true);
                         pantalla.escribir();
-                        pantalla.texto(texto);
+                        await pantalla.textoAnimado(texto, { intermedio: llamadas.length > 0 });
                         pantalla.escribir();
+                        pantalla.espera(null);
                     }
                 }
-                else if (item.type === 'function_call')
-                    llamadas.push(item);
             }
             if (!llamadas.length)
                 break;
-            const etiqueta = etiquetaDeTanda(llamadas.map((l) => ({ name: String(l.name ?? ''), arguments: String(l.arguments ?? '{}') })));
-            if (etiqueta)
-                pantalla.espera(etiqueta.texto, etiqueta.anim, false);
-            for (const ll of llamadas) {
+            const todas = llamadas.map((l) => ({ name: String(l.name ?? ''), arguments: String(l.arguments ?? '{}') }));
+            for (let i = 0; i < llamadas.length; i++) {
+                const ll = llamadas[i];
                 if (señal.aborted)
                     throw new ErrorDeParallel('interrumpido');
+                const etiqueta = etiquetaDeTanda(grupoDesde(todas, i));
+                if (etiqueta && empiezaGrupo(todas, i))
+                    pantalla.espera(etiqueta.texto, etiqueta.anim, false);
                 const salida = await ejecutarHerramienta(String(ll.name ?? ''), String(ll.arguments ?? '{}'), s.ctx);
                 s.conversacion.push({ type: 'function_call_output', call_id: ll.call_id, output: salida });
             }
@@ -209,6 +211,31 @@ export async function hacerTarea(s, pedido, señal, imagenes = []) {
     pantalla.cierre(`${t('estado.hecho')}${sep}${c.gris(textoDeAcciones(acciones))}${sep}${c.gris(duracion(ms))}`);
     return true;
 }
+function familia(nombre) {
+    if (nombre === 'write_file' || nombre === 'edit_file')
+        return 'cambio';
+    if (nombre === 'read_file' || nombre === 'search' || nombre === 'list_files')
+        return nombre;
+    return null;
+}
+export function grupoDesde(llamadas, i) {
+    const actual = llamadas[i];
+    if (!actual)
+        return [];
+    const f = familia(actual.name);
+    if (!f)
+        return [actual];
+    let j = i;
+    while (j < llamadas.length && familia(llamadas[j].name) === f)
+        j++;
+    return llamadas.slice(i, j);
+}
+export function empiezaGrupo(llamadas, i) {
+    if (i === 0)
+        return true;
+    const f = familia(llamadas[i].name);
+    return !f || f !== familia(llamadas[i - 1].name);
+}
 function cerrarLlamadasPendientes(items) {
     const respondidas = new Set(items.filter((i) => i.type === 'function_call_output').map((i) => i.call_id));
     for (const i of [...items]) {

package/dist/cli.js

@@ -43,6 +43,8 @@ function opciones() {
             ascii: { type: 'boolean' },
             mouse: { type: 'boolean' },
             'no-mouse': { type: 'boolean' },
+            'no-animation': { type: 'boolean' },
+            animation: { type: 'boolean' },
             version: { type: 'boolean', short: 'v' },
             help: { type: 'boolean', short: 'h' },
             browser: { type: 'boolean' },
@@ -262,10 +264,40 @@ async function principal() {
     const quien = quienEs(cuenta);
     let avisos = ajustes.avisos !== false;
     const conRaton = !v['no-mouse'] && v.mouse !== false && (Boolean(v.mouse) || ajustes.raton !== false);
+    pantalla.animar = !v['no-animation'] && v.animation !== false && (Boolean(v.animation) || ajustes.animacion !== false);
     let esperandoEnBandeja = null;
     let control = new AbortController();
     let ocupado = false;
     let superficie = null;
+    let bienvenida;
+    let consejosDeEntrada = [];
+    const confirmarNuevaEnMarcha = async () => {
+        if (!superficie)
+            return;
+        const i = await superficie.elegir(t('nueva.parar'), [{ etiqueta: t('nueva.si'), peligro: true }, { etiqueta: t('nueva.no') }], { detalle: t('nueva.parar_detalle'), elegida: 1 });
+        if (i !== 0)
+            return;
+        superficie.nuevaTrasParar();
+        if (ocupado)
+            control.abort();
+    };
+    const empezarDeNuevo = () => {
+        sesion.conversacion = [];
+        sesion.diario = [];
+        sesion.id = randomUUID();
+        sesion.ultimaTarea = undefined;
+        sesion.ctx.hechos = { ficheros: [], comandos: [] };
+        sesion.ctx.permitidos.clear();
+        sesion.ctx.deshacer.length = 0;
+        if (sesion.ctx.lecturas)
+            sesion.ctx.lecturas.length = 0;
+        registro.apuntar('nueva', {});
+        pantalla.reiniciar();
+        if (superficie)
+            superficie.reiniciar(bienvenida, consejosDeEntrada);
+        else
+            pantalla.escribir(t('repl.nueva'));
+    };
     let ctrlC = 0;
     const totalDeLaSesion = () => sesion.total.tareas ? c.gris(t('estado.total', { acciones: acciones(sesion.total.acciones), tiempo: duracion(sesion.total.ms) })) : '';
     const despedida = () => [totalDeLaSesion(), c.gris(t('repl.adios'))].filter(Boolean).join('\n  ');
@@ -419,6 +451,7 @@ async function principal() {
                 if (avisos && superficie?.enfocada === false)
                     avisarEnElEscritorio({ titulo: 'parx', texto: t('aviso.te_necesita', { pregunta: texto }) });
             },
+            alNuevaEnMarcha: () => void confirmarNuevaEnMarcha(),
         });
         const s = superficie;
         process.on('exit', () => s.restaurarDeUrgencia());
@@ -437,7 +470,8 @@ async function principal() {
         const elegidos = elegirConsejos(leerAjustes().consejos);
         if (elegidos.ids.length)
             guardarAjustes({ consejos: elegidos.estado });
-        superficie.iniciar(bloqueDeBienvenida({
+        consejosDeEntrada = conCarriles || quiereBypass ? [] : elegidos.ids;
+        bienvenida = bloqueDeBienvenida({
             version: VERSION,
             quien: quien.includes('@') ? quien : (quien.split(/\s+/)[0] ?? ''),
             carpeta: rutaCorta(raiz, 60),
@@ -447,7 +481,8 @@ async function principal() {
                 return nueva ? t('update.disponible', { version: nueva }) : undefined;
             })(),
             peligro: () => sesion.ctx.modo === 'bypass',
-        }), conCarriles || quiereBypass ? [] : elegidos.ids);
+        });
+        superficie.iniciar(bienvenida, consejosDeEntrada);
         if (quiereBypass)
             await confirmarBypass();
         const mirarBandeja = async () => {
@@ -819,9 +854,15 @@ async function principal() {
                     break;
                 }
                 case 'new':
-                    sesion.conversacion = [];
-                    pantalla.escribir(t('repl.nueva'));
+                    empezarDeNuevo();
+                    break;
+                case 'animation': {
+                    const si = ALIAS_SI_NO[arg] ?? (pantalla.animar ? 'no' : 'si');
+                    pantalla.animar = si === 'si';
+                    guardarAjustes({ animacion: pantalla.animar });
+                    pantalla.escribir(pantalla.animar ? t('animacion.on') : t('animacion.off'));
                     break;
+                }
                 case 'undo': {
                     const r2 = deshacerUltimo(sesion.ctx);
                     pantalla.escribir(r2 ? t('repl.deshecho', { ruta: r2 }) : t('repl.nada_que_deshacer'));

package/dist/config.js

@@ -92,6 +92,10 @@ export function leerAjustes(dir = carpetaDeConfiguracion()) {
             out.modo = MODO_VIEJO[a.modo];
         if (typeof a.avisos === 'boolean')
             out.avisos = a.avisos;
+        if (typeof a.raton === 'boolean')
+            out.raton = a.raton;
+        if (typeof a.animacion === 'boolean')
+            out.animacion = a.animacion;
         const k = a.consejos;
         if (k && typeof k === 'object') {
             const n = (x) => (typeof x === 'number' && Number.isFinite(x) && x >= 0 ? Math.floor(x) : 0);

package/dist/herramientas.js

@@ -3,6 +3,7 @@ import { dirname, join, relative } from 'node:path';
 import { contarCambios, diffDeLineas } from "./diff.js";
 import { cuantos, t } from "./textos.js";
 import { c } from "./marca.js";
+import { elipsis } from "./actividad.js";
 import { estaDentro, familiaDeComando, nivelDeComando, resolverRuta, rutaReal } from "./seguridad.js";
 import { ejecutarComando, recortar } from "./shell.js";
 const nulable = (tipo, descripcion) => ({ type: [tipo, 'null'], description: descripcion });
@@ -211,7 +212,15 @@ export function etiquetaDeComando(comando) {
         return t('hace.instalar');
     const primera = c1.split(/\s*(?:&&|\|\||;|\|)\s*/)[0] ?? c1;
     const corto = primera.split(/\s+/).filter((p) => !/^[A-Z_]+=/.test(p)).slice(0, 3).join(' ');
-    return t('hace.ejecutar', { comando: corto.length > 28 ? `${corto.slice(0, 27)}…` : corto });
+    return t('hace.ejecutar', { comando: corto.length > 28 ? `${corto.slice(0, 27)}${elipsis()}` : corto });
+}
+export function rutaParaLaBarra(ruta) {
+    const r = ruta.trim().replace(/^\.\/(?=.)/, '') || '.';
+    if (r.length <= 30)
+        return r;
+    const partes = r.split(/[\\/]/).filter(Boolean);
+    const cola = partes.slice(-2).join('/');
+    return cola.length <= 30 ? `${elipsis()}/${cola}` : `${elipsis()}/${partes[partes.length - 1]}`;
 }
 export function etiquetaDeTanda(llamadas) {
     if (!llamadas.length)
@@ -225,7 +234,7 @@ export function etiquetaDeTanda(llamadas) {
         }
     });
     const nombres = llamadas.map((l) => l.name);
-    const base = (p) => String(p ?? '.').split(/[\\/]/).filter(Boolean).pop() ?? '.';
+    const base = (p) => rutaParaLaBarra(String(p ?? '.'));
     const cmd = nombres.indexOf('run_command');
     if (cmd !== -1)
         return { texto: etiquetaDeComando(String(args[cmd].command ?? '')), anim: 'tren' };
@@ -244,9 +253,14 @@ export function etiquetaDeTanda(llamadas) {
     const b = nombres.indexOf('search');
     if (b !== -1) {
         const patron = String(args[b].pattern ?? '');
-        return { texto: t('hace.buscar', { patron: patron.length > 24 ? `${patron.slice(0, 23)}…` : patron }), anim: 'lectura' };
+        if (!patron.trim())
+            return { texto: t('hace.buscar_ficheros'), anim: 'lectura' };
+        return { texto: t('hace.buscar', { patron: patron.length > 24 ? `${patron.slice(0, 23)}${elipsis()}` : patron }), anim: 'lectura' };
     }
-    return { texto: t('hace.listar', { ruta: base(args[0].path ?? '.') }), anim: 'lectura' };
+    const l = nombres.indexOf('list_files');
+    if (l !== -1)
+        return { texto: t('hace.listar', { ruta: base(args[l].path ?? '.') }), anim: 'lectura' };
+    return { texto: t('hace.generico'), anim: 'ruta' };
 }
 export async function ejecutarHerramienta(nombre, argumentos, ctx) {
     let a;

package/dist/textos.js

@@ -19,7 +19,7 @@ export const TEXTOS = {
     'tui.si_ediciones': 'Yes, allow all edits',
     'tui.si_ediciones_corto': 'All edits',
     'tui.una_vez': 'Yes, this once',
-    'tui.atajos': 'Shift+Tab mode · ↑ ↓ history · ! runs a shell command · Esc stops a task · Ctrl+C twice exits · Ctrl+L redraws',
+    'tui.atajos': 'Shift+Tab mode · ↑ ↓ history · ! runs a shell command · Esc stops a task · any key shows the whole answer · Ctrl+C twice exits · Ctrl+L redraws',
     'tui.atajos_raton': 'Click any option or button · wheel or PgUp/PgDn scrolls · End jumps to the bottom · Shift+drag selects text (Option in iTerm2, Fn in Terminal) · /mouse off gives the mouse back to the terminal',
     'tui.al_fondo': 'Jump to bottom',
     'tui.nuevas': '{n} new',
@@ -76,21 +76,22 @@ export const TEXTOS = {
     'carpeta.lista': 'Allowed folders: {lista}',
     'carpeta.ninguna': 'Only the project folder. Add one with /folder <path>.',
     'carpeta.no_existe': 'That folder does not exist: {ruta}',
-    'trabajo.ruta': 'Tracing the route',
-    'trabajo.carriles': 'On the rails',
-    'trabajo.puntos': 'Connecting the dots',
-    'trabajo.numeros': 'Running the numbers',
-    'trabajo.afinar': 'Fine-tuning',
-    'trabajo.agujas': 'Switching tracks',
-    'trabajo.mapa': 'Reading the map',
-    'trabajo.estacion': 'Nearing the station',
+    'trabajo.pensando': 'Thinking',
+    'trabajo.planear': 'Planning the steps',
+    'trabajo.resultados': 'Looking at the results',
+    'trabajo.siguiente': 'Deciding the next step',
+    'trabajo.sigue': 'Still thinking',
+    'trabajo.servidor': 'Waiting for the server',
+    'hace.respuesta': 'Writing the answer',
+    'hace.generico': 'Working',
+    'hace.buscar_ficheros': 'Searching files',
     'hace.leer': 'Reading {n} files',
     'hace.leer_uno': 'Reading {ruta}',
     'hace.listar': 'Looking around {ruta}',
     'hace.buscar': 'Searching for {patron}',
     'hace.escribir': 'Writing {ruta}',
     'hace.editar': 'Editing {ruta}',
-    'hace.cambios': 'Changing {n} files',
+    'hace.cambios': 'Editing {n} files',
     'hace.tests': 'Running tests',
     'hace.build': 'Building',
     'hace.instalar': 'Installing',
@@ -181,6 +182,12 @@ export const TEXTOS = {
     'repl.adios': 'See you.',
     'repl.registro': 'Log of this session: {ruta}',
     'repl.nueva': 'New conversation.',
+    'nueva.parar': 'Stop and start new?',
+    'nueva.parar_detalle': 'parx is working. This stops it and clears the conversation.',
+    'nueva.si': 'Stop and start new',
+    'nueva.no': 'Keep working',
+    'animacion.on': 'Answers are written out as they arrive. Any key shows the rest at once.',
+    'animacion.off': 'Answers appear whole, at once. /animation on to turn it back on.',
     'repl.desconocido': 'Unknown command. Type /help.',
     'repl.deshecho': 'Undone: {ruta}',
     'repl.nada_que_deshacer': 'Nothing to undo.',
@@ -261,6 +268,7 @@ export const COMANDOS = [
     ['notify', 'Desktop notifications: on or off'],
     ['tips', 'Tips when it opens: on or off'],
     ['mouse', 'Clicks and wheel in parx: on or off'],
+    ['animation', 'Answers written out as they arrive: on or off'],
     ['log', 'Where the log of what it does is kept'],
     ['exit', 'Leave parx'],
 ];
@@ -273,6 +281,7 @@ export const ALIAS_COMANDO = {
     mission: 'mission', mision: 'mission', misión: 'mission',
     inbox: 'inbox', bandeja: 'inbox', approvals: 'inbox', waiting: 'inbox',
     mouse: 'mouse', raton: 'mouse', ratón: 'mouse',
+    animation: 'animation', animations: 'animation', animacion: 'animation', animación: 'animation',
     report: 'report', informe: 'report',
     teach: 'teach', class: 'teach', clase: 'teach',
     undo: 'undo', deshacer: 'undo',
@@ -304,6 +313,7 @@ export const USO = [
     '  --dir <folder>                  the project folder (default: current)',
     '  --ascii                         plain characters only (also NO_COLOR for no color)',
     '  --no-mouse                      leave the mouse to the terminal (no clicks or wheel in parx)',
+    '  --no-animation                  show answers whole, without writing them out',
     '  --version, --help',
     '',
     'Sign in:',

package/dist/tui.js

@@ -4,6 +4,7 @@ import { ALIAS_COMANDO, COMANDOS, t as tt } from "./textos.js";
 import { MODELOS, ORDEN_DE_MODELOS } from "./modelos.js";
 import { consejo, ordenDeConsejos } from "./consejos.js";
 export { anchoDe } from "./texto.js";
+import { conElipsis, fraseDeEspera } from "./actividad.js";
 export const MARGEN = 2;
 export function anchoUtil(ancho) {
     return Math.max(10, ancho - MARGEN * 2);
@@ -287,9 +288,9 @@ function teclaDeRaton(b, x, y, soltar, botonX10) {
 }
 export const RATON_SI = '\x1b[?1000h\x1b[?1002h\x1b[?1003h\x1b[?1006h';
 export const RATON_NO = '\x1b[?1003l\x1b[?1002l\x1b[?1000l\x1b[?1006l';
-const CON_VALOR = new Set(['mode', 'model', 'tips', 'notify', 'teach', 'mouse']);
+const CON_VALOR = new Set(['mode', 'model', 'tips', 'notify', 'teach', 'mouse', 'animation']);
 const CON_TEXTO = new Set(['folder']);
-const SE_MANDAN_SOLOS = new Set(['teach', 'notify', 'tips', 'folder', 'mouse']);
+const SE_MANDAN_SOLOS = new Set(['teach', 'notify', 'tips', 'folder', 'mouse', 'animation']);
 const MODOS_DEL_MENU = ['ask', 'auto', 'read', 'bypass'];
 export function opcionesDelMenu(valor) {
     if (!valor.startsWith('/') || valor.includes('\n'))
@@ -321,8 +322,8 @@ export function opcionesDelMenu(valor) {
         : cmd === 'model'
             ? ORDEN_DE_MODELOS.map((k) => [k, `${MODELOS[k].nombre} ${MODELOS[k].version}: ${MODELOS[k].descripcion}`])
             : [
-                ['on', cmd === 'teach' ? 'Explain each step as it codes' : cmd === 'notify' ? 'Notify me when it finishes or needs me' : cmd === 'mouse' ? 'Click options, scroll with the wheel' : 'Show them when parx opens'],
-                ['off', cmd === 'teach' ? 'Back to normal' : cmd === 'notify' ? 'No desktop notifications' : cmd === 'mouse' ? 'The terminal selects and scrolls as usual' : 'Don’t show them again'],
+                ['on', cmd === 'teach' ? 'Explain each step as it codes' : cmd === 'notify' ? 'Notify me when it finishes or needs me' : cmd === 'mouse' ? 'Click options, scroll with the wheel' : cmd === 'animation' ? 'Write answers out as they arrive' : 'Show them when parx opens'],
+                ['off', cmd === 'teach' ? 'Back to normal' : cmd === 'notify' ? 'No desktop notifications' : cmd === 'mouse' ? 'The terminal selects and scrolls as usual' : cmd === 'animation' ? 'Show answers whole, at once' : 'Don’t show them again'],
             ];
     return valores
         .filter(([v]) => v.startsWith(q))
@@ -380,17 +381,11 @@ export function duracion(ms) {
 export function acciones(n) {
     return n === 1 ? tt('estado.accion') : tt('estado.acciones', { n: n.toLocaleString('en-US') });
 }
-const FRASES = ['trabajo.ruta', 'trabajo.puntos', 'trabajo.carriles', 'trabajo.numeros', 'trabajo.mapa', 'trabajo.afinar', 'trabajo.agujas', 'trabajo.estacion'];
-export const MS_POR_FRASE = 2800;
-export function fraseDeEspera(ms, semilla = 0) {
-    const vuelta = Math.floor(Math.max(0, ms) / MS_POR_FRASE);
-    if (vuelta === 0)
-        return `${tt(FRASES[0])}…`;
-    return `${tt(FRASES[1 + ((semilla + vuelta - 1) % (FRASES.length - 1))])}…`;
-}
+export { fraseDeEspera } from "./actividad.js";
 export function ponerTextoDeTrabajo(w, texto, anim = 'ruta', vivo = false, ahora = Date.now()) {
     if (texto) {
         w.texto = texto;
+        w.trasHerramientas = true;
         w.anim = anim;
         w.vivo = vivo;
         w.literalHasta = ahora + 1800;
@@ -401,12 +396,12 @@ export function ponerTextoDeTrabajo(w, texto, anim = 'ruta', vivo = false, ahora
     }
 }
 export function nuevoTrabajo(ahora = Date.now()) {
-    return { texto: null, literalHasta: 0, vivo: false, anim: 'ruta', desde: ahora, esperaDesde: ahora, paso: 0, acciones: null, semilla: Math.floor(Math.random() * 7) };
+    return { texto: null, literalHasta: 0, vivo: false, anim: 'ruta', desde: ahora, esperaDesde: ahora, paso: 0, acciones: null, trasHerramientas: false };
 }
 export function textoDeTrabajo(w, ahora) {
     if (w.texto && (w.vivo || ahora < w.literalHasta))
-        return { texto: w.texto, anim: w.anim };
-    return { texto: fraseDeEspera(ahora - w.esperaDesde, w.semilla), anim: 'ruta' };
+        return { texto: conElipsis(w.texto), anim: w.anim };
+    return { texto: fraseDeEspera(ahora - w.esperaDesde, w.trasHerramientas), anim: 'ruta' };
 }
 export function filaDeTrabajo(w, ahora, ancho = Infinity) {
     const { texto, anim } = textoDeTrabajo(w, ahora);
@@ -712,6 +707,9 @@ export function opcionesDePregunta(tipo) {
             return { opciones: [tt('tui.si'), tt('tui.siempre'), tt('tui.no')], cortas: [tt('tui.si'), tt('tui.siempre_corto'), tt('tui.no')], valores: ['si', 'siempre', 'no'], elegida: 0 };
     }
 }
+export function esNueva(v) {
+    return ALIAS_COMANDO[/^\/(\S+)$/.exec(v.trim())?.[1]?.toLowerCase() ?? ''] === 'new';
+}
 const MAX_LINEAS = 4000;
 const MAX_BLOQUES = 1500;
 const PEGADO_LARGO = 280;
@@ -1045,6 +1043,98 @@ export class Superficie {
         this.escribir(s);
         this.pintar();
     }
+    refrescarUltimo() {
+        const b = this.ultimoBloque();
+        if (!b)
+            return;
+        const k = this.ultimoAlto;
+        if (this.lineas.length < k)
+            return;
+        const nuevas = sinBlancoDoble(b(this.ancho), this.ultimoTrasBlanco);
+        const base = this.lineas.length - k;
+        const viejas = this.lineas.slice(base);
+        if (nuevas.length === k && nuevas.every((l, i) => l === viejas[i]))
+            return;
+        if (nuevas.length < k) {
+            this.bloques[this.bloques.length - 1] = b;
+            this.recomponer();
+            return;
+        }
+        this.lineas.splice(base, k, ...nuevas);
+        this.ultimoAlto = nuevas.length;
+        if (!this.activa) {
+            this.volcadas = this.lineas.length;
+            this.recortarMemoria();
+            return;
+        }
+        const subido = this.subidas > 0 || this.volcadas < base + k;
+        const n = this.carrilPintadas || componerCarril(this.datos(), this.ancho, this.alto).carril.length;
+        if (subido) {
+            const desde = this.desplazadas(n) - this.subidas;
+            const cambiaVisible = viejas.some((l, i) => base + i < this.volcadas && base + i >= desde && nuevas[i] !== l);
+            if (cambiaVisible)
+                this.vistaSucia = true;
+            this.recortarMemoria();
+            if (cambiaVisible || nuevas.length !== k)
+                this.pintar();
+            return;
+        }
+        const top = this.filaDelCarril(n);
+        const tapadas = top - this.encimaPintadas;
+        let s = '';
+        for (let i = 0; i < k; i++) {
+            if (nuevas[i] === viejas[i])
+                continue;
+            const fila = base + i - this.desplazadas(n) + 1;
+            if (fila >= 1 && fila < tapadas)
+                s += `\x1b[${fila};1H\x1b[2K${nuevas[i]}`;
+        }
+        if (s)
+            this.escribir(`\x1b[?2026h\x1b7${s}\x1b8\x1b[?2026l`);
+        if (nuevas.length > k) {
+            this.escribir(this.destapar());
+            this.volcar();
+            this.pintar();
+        }
+    }
+    reiniciar(bienvenida, consejos = []) {
+        this.bloques = [];
+        this.lineas = [];
+        this.volcadas = 0;
+        this.subidas = 0;
+        this.vistaSucia = false;
+        this.cola = [];
+        this.aviso = null;
+        this.ultimoAlto = 0;
+        this.ultimoTrasBlanco = false;
+        this.encimaPintadas = 0;
+        this.sobre = null;
+        this.pulsado = null;
+        this.ctrlC = 0;
+        this.alRevelar = null;
+        this.ponerBienvenida(bienvenida, consejos);
+        this.recomponer();
+    }
+    ponerBienvenida(bienvenida, consejos = []) {
+        if (bienvenida)
+            this.bloques.push(bienvenida);
+        this.consejos = [];
+        this.consejosVisibles = false;
+        if (consejos.length) {
+            const ocupado = (bienvenida ? bienvenida(this.ancho).length : 0) + componerCarril(this.datos(), this.ancho, this.alto).carril.length;
+            let n = consejos.length;
+            while (n > 0 && ocupado + bloqueDeConsejos(() => consejos.slice(0, n))(this.ancho).length > this.alto)
+                n--;
+            this.consejos = consejos.slice(0, n);
+            this.consejosVisibles = n > 0;
+            if (n > 0)
+                this.bloques.push(bloqueDeConsejos(() => (this.consejosVisibles ? this.consejos : [])));
+        }
+    }
+    alRevelar = null;
+    revelando(fn) {
+        this.alRevelar = fn;
+    }
     recomponer(alEmpezar = false) {
         if (!this.activa)
             return;
@@ -1098,6 +1188,10 @@ export class Superficie {
         this.volcar();
         this.pintar();
     }
+    nuevaTrasParar() {
+        this.cola = ['/new'];
+        this.mostrarAviso(null);
+    }
     get _vista() {
         return { subidas: this.subidas, pendientes: this.lineas.length - this.volcadas };
     }
@@ -1175,18 +1269,7 @@ export class Superficie {
         if (this.activa)
             return;
         this.activa = true;
-        if (bienvenida)
-            this.bloques.push(bienvenida);
-        if (consejos.length) {
-            const ocupado = (bienvenida ? bienvenida(this.ancho).length : 0) + componerCarril(this.datos(), this.ancho, this.alto).carril.length;
-            let n = consejos.length;
-            while (n > 0 && ocupado + bloqueDeConsejos(() => consejos.slice(0, n))(this.ancho).length > this.alto)
-                n--;
-            this.consejos = consejos.slice(0, n);
-            this.consejosVisibles = n > 0;
-            if (n > 0)
-                this.bloques.push(bloqueDeConsejos(() => (this.consejosVisibles ? this.consejos : [])));
-        }
+        this.ponerBienvenida(bienvenida, consejos);
         this.escribir(this.modosSi());
         try {
             this.o.entrada.setRawMode?.(true);
@@ -1321,7 +1404,7 @@ export class Superficie {
             const r = enCola;
             this.ejemplo = null;
             this.mostrarAviso(this.cola.length ? tt('tui.en_cola_n', { n: this.cola.length }) : null);
-            if (r.trim() && r.trim() !== '!')
+            if (r.trim() && r.trim() !== '!' && !esNueva(r.trim()))
                 this.anadir(this.bloqueDeEnvio(r));
             return Promise.resolve(this.expandir(r));
         }
@@ -1479,6 +1562,10 @@ export class Superficie {
         this.posHistorial = this.historial.length;
         this.irAlFondo();
         if (this.trabajo || !this.resolverLectura) {
+            if (this.trabajo && this.o.alNuevaEnMarcha && esNueva(v)) {
+                this.o.alNuevaEnMarcha();
+                return;
+            }
             if (v) {
                 this.cola.push(crudo);
                 this.mostrarAviso(this.cola.length > 1 ? tt('tui.en_cola_n', { n: this.cola.length }) : tt('tui.en_cola'));
@@ -1487,7 +1574,7 @@ export class Superficie {
         }
         const r = this.resolverLectura;
         this.resolverLectura = null;
-        if (v && v !== '!')
+        if (v && v !== '!' && !esNueva(v))
             this.anadir(this.bloqueDeEnvio(crudo));
         else
             this.pintar();
@@ -1507,6 +1594,11 @@ export class Superficie {
         }
         if (k.t === 'raton')
             return this.alRaton(k);
+        if (this.alRevelar && k.t !== 'pagina_arriba' && k.t !== 'pagina_abajo' && k.t !== 'fondo') {
+            const f = this.alRevelar;
+            this.alRevelar = null;
+            f();
+        }
         if (k.t === 'pagina_arriba' || k.t === 'pagina_abajo')
             return this.desplazar((k.t === 'pagina_arriba' ? 1 : -1) * Math.max(1, this.filasDeVista() - 2));
         if (k.t === 'fondo')

package/dist/ui.js

@@ -1,6 +1,7 @@
 import { animacion, c, capacidades, SIMBOLOS } from "./marca.js";
 import { cuantos, t } from "./textos.js";
 import { trozos } from "./diff.js";
+import { caracteresDe, caracteresVisibles, cursorEncendido, duracionDeRevelado, MS_MAX_INTERMEDIO, MS_MAX_RESPUESTA, MS_POR_FOTOGRAMA, revelarLineas, simboloDeCursor } from "./actividad.js";
 import { anchoDe, envolver, recortar, recortarMedio, rellenar, sinColor } from "./texto.js";
 import { anchoUtil, bloqueDeCierre, bloqueDeLinea, bloqueDeTexto, filaDeTrabajo, MARGEN, nuevoTrabajo, opcionesDePregunta, ponerTextoDeTrabajo, } from "./tui.js";
 export function leerRespuesta(texto, tipo = 'normal') {
@@ -89,6 +90,8 @@ export class Pantalla {
         };
     }
     bloque(b, grupo = 'otro') {
+        if (this.revelado)
+            this.terminarRevelado();
         const bc = this.conCarril(this.conAire(b, grupo));
         if (this.superficie) {
             this.superficie.anadir(bc);
@@ -290,42 +293,147 @@ export class Pantalla {
         }
     }
     texto(md) {
-        const lineas = md.replace(/\r/g, '').split('\n');
-        this.bloque((ancho) => {
-            const util = anchoUtil(ancho);
-            const pre = ' '.repeat(MARGEN);
-            const out = [];
-            let enBloque = false;
-            for (const linea of lineas) {
-                if (/^```/.test(linea.trim())) {
-                    enBloque = !enBloque;
-                    continue;
-                }
-                if (enBloque) {
-                    out.push(`${pre}  ${c.marca(recortar(linea.replace(/\t/g, '  '), util - 2))}`);
-                    continue;
-                }
-                const titulo = /^#{1,6}\s+(.*)$/.exec(linea);
-                if (titulo) {
-                    for (const l of envolver(c.negrita(titulo[1]), util))
-                        out.push(`${pre}${l}`);
-                    continue;
-                }
-                let l = linea;
-                let sangria = '';
-                const lista = /^(\s*)([-*]|\d+[.)])\s+/.exec(l);
-                if (lista) {
-                    const marca = /\d/.test(lista[2]) ? lista[2] : SIMBOLOS.punto === '●' ? '·' : '-';
-                    l = `${lista[1]}${c.claro(marca)} ${l.slice(lista[0].length)}`;
-                    sangria = ' '.repeat(anchoDe(lista[1]) + anchoDe(marca) + 1);
-                }
-                l = l.replace(/\*\*([^*]+)\*\*/g, (_m, x) => c.negrita(x));
-                l = l.replace(/`([^`]+)`/g, (_m, x) => c.marca(x));
-                for (const p of envolver(l, util, sangria))
-                    out.push(`${pre}${p}`);
+        this.terminarRevelado();
+        this.bloque(bloqueDeMarkdown(md), 'texto');
+    }
+    animar = true;
+    revelado = null;
+    terminarRevelado() {
+        const f = this.revelado;
+        this.revelado = null;
+        f?.();
+    }
+    textoAnimado(md, o = {}) {
+        this.terminarRevelado();
+        const conSuperficie = this.superficie !== null;
+        if (!this.animar || this.carril || !this.tty || (!conSuperficie && !process.stdout.isTTY)) {
+            this.texto(md);
+            return Promise.resolve();
+        }
+        const completo = bloqueDeMarkdown(md);
+        const maxMs = o.intermedio ? MS_MAX_INTERMEDIO : MS_MAX_RESPUESTA;
+        const estado = { inicio: Date.now(), fin: false, ahora: Date.now() };
+        const total = caracteresDe(completo(this.superficie?.ancho ?? Math.max(20, process.stdout.columns || 80)));
+        const duracion = duracionDeRevelado(total, maxMs);
+        const parcial = (ancho) => {
+            const lineas = completo(ancho);
+            if (estado.fin)
+                return lineas;
+            const ms = estado.ahora - estado.inicio;
+            const n = caracteresVisibles(caracteresDe(lineas), ms, duracion);
+            return revelarLineas(lineas, n, cursorEncendido(ms) ? simboloDeCursor() : ' ', anchoUtil(ancho) + MARGEN * 2);
+        };
+        return new Promise((resolver) => {
+            let reloj = null;
+            const acabar = () => {
+                if (estado.fin)
+                    return;
+                estado.fin = true;
+                if (reloj)
+                    clearInterval(reloj);
+                if (this.revelado === acabar)
+                    this.revelado = null;
+                this.superficie?.revelando(null);
+                if (conSuperficie)
+                    this.superficie.refrescarUltimo();
+                else
+                    this.revelarEnLinea(completo, Infinity);
+                resolver();
+            };
+            if (conSuperficie) {
+                this.bloque(parcial, 'texto');
+                this.superficie.revelando(acabar);
             }
-            return out;
-        }, 'texto');
+            else {
+                this.pausarLinea();
+                this.ultimoGrupo = 'texto';
+                this.lineaEnCurso = { escritas: 0, parcial: '' };
+                this.revelarEnLinea(completo, 0);
+            }
+            this.revelado = acabar;
+            const fotograma = () => {
+                estado.ahora = Date.now();
+                if (estado.ahora - estado.inicio >= duracion)
+                    return acabar();
+                if (conSuperficie)
+                    this.superficie.refrescarUltimo();
+                else
+                    this.revelarEnLinea(completo, caracteresVisibles(total, estado.ahora - estado.inicio, duracion), cursorEncendido(estado.ahora - estado.inicio));
+            };
+            reloj = setInterval(fotograma, MS_POR_FOTOGRAMA);
+            reloj.unref?.();
+        });
     }
+    lineaEnCurso = null;
+    revelarEnLinea(completo, n, cursor = false) {
+        const l = this.lineaEnCurso;
+        if (!l)
+            return;
+        const ancho = Math.max(20, process.stdout.columns || capacidades().ancho || 80);
+        const lineas = completo(ancho);
+        const vistas = revelarLineas(lineas, n, null);
+        let s = '';
+        while (l.escritas < vistas.length - 1 || (n >= caracteresDe(lineas) && l.escritas < lineas.length)) {
+            s += `\r\x1b[2K${lineas[l.escritas]}\n`;
+            l.escritas++;
+            l.parcial = '';
+        }
+        if (n < caracteresDe(lineas)) {
+            const parcial = vistas[l.escritas] ?? '';
+            s += `\r\x1b[2K${parcial}${cursor ? `${anchoDe(parcial) ? ' ' : ''}${simboloDeCursor()}` : ''}`;
+            l.parcial = parcial;
+        }
+        else {
+            this.lineaEnCurso = null;
+            if (lineas.length)
+                this.enBlanco = lineas[lineas.length - 1].trim() === '';
+        }
+        if (s)
+            process.stdout.write(s);
+    }
+    reiniciar() {
+        this.terminarRevelado();
+        this.ultimoGrupo = null;
+        this.enBlanco = true;
+        this.lecturas = null;
+    }
+}
+export function bloqueDeMarkdown(md) {
+    const lineas = md.replace(/\r/g, '').split('\n');
+    return (ancho) => {
+        const util = anchoUtil(ancho);
+        const pre = ' '.repeat(MARGEN);
+        const out = [];
+        let enBloque = false;
+        for (const linea of lineas) {
+            if (/^```/.test(linea.trim())) {
+                enBloque = !enBloque;
+                continue;
+            }
+            if (enBloque) {
+                out.push(`${pre}  ${c.marca(recortar(linea.replace(/\t/g, '  '), util - 2))}`);
+                continue;
+            }
+            const titulo = /^#{1,6}\s+(.*)$/.exec(linea);
+            if (titulo) {
+                for (const l of envolver(c.negrita(titulo[1]), util))
+                    out.push(`${pre}${l}`);
+                continue;
+            }
+            let l = linea;
+            let sangria = '';
+            const lista = /^(\s*)([-*]|\d+[.)])\s+/.exec(l);
+            if (lista) {
+                const marca = /\d/.test(lista[2]) ? lista[2] : SIMBOLOS.punto === '●' ? '·' : '-';
+                l = `${lista[1]}${c.claro(marca)} ${l.slice(lista[0].length)}`;
+                sangria = ' '.repeat(anchoDe(lista[1]) + anchoDe(marca) + 1);
+            }
+            l = l.replace(/\*\*([^*]+)\*\*/g, (_m, x) => c.negrita(x));
+            l = l.replace(/`([^`]+)`/g, (_m, x) => c.marca(x));
+            for (const p of envolver(l, util, sangria))
+                out.push(`${pre}${p}`);
+        }
+        return out;
+    };
 }
 export { bloqueDeLinea };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getparallel/parx",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "parx: the coding agent of Parallel in your terminal. Reads and edits your project, runs commands and tests, and does coding tasks end to end. Mac, Windows and Linux.",
   "keywords": [
     "parx",