# Historial de cambios de la CLI de MAX (/es/docs/max/changelog)

Consulta lo que cambió en las versiones: capacidades, correcciones y cambios que afectan a comandos. Empieza por tu versión instalada y abre la guía de la función que quieras probar.

Cambios destacados de `@wirecat/max-cli`, con una sección por versión, recientes primero. Se utiliza [versionado semántico](https://semver.org/lang/ru/); antes de `1.0.0`, la interfaz de comandos todavía puede cambiar.

## 0.111.0 — 12.11.2026 [#01110--12112026]

### Novedades [#novedades]

- **El registro de ejecución guarda el progreso de la sincronización.** Cada línea de progreso de `messages sync` es ahora también un evento `sync.progress` con contadores, en cualquier formato de salida, así que `max <profile> runs show <run>` muestra qué vio WireCat Desktop y cuándo.
- **Parte de un nombre en `from:` y `chat:`.** `from:Ярослав*` y `chat:*Квестор*` encuentran por parte del nombre, del alias o del @username, sin importar mayúsculas ni ё/е. Si nadie encaja con el patrón, la respuesta es `not_found` con los nombres más cercanos. Si encajan más de 50, es `query.too-large`: precisa el patrón. Un número y un nombre exacto funcionan como antes. Si varias personas tienen exactamente ese nombre, el error ahora propone también a quienes lo tienen solo dentro de su nombre: para «Ярослав», también «Ярослав Орлов».
- **Parte de una palabra en el texto de los mensajes.** `*договор*` sin campo encuentra «Договор», «ДОГОВОРЫ» y «переговоры», también en un archivo grande, dentro de `AND`, `OR`, `NOT` y junto con `chat:` y `date:`. Hacen falta tres letras seguidas.
- **El comienzo de una palabra busca donde busca la palabra entera.** `счет*` sin campo ahora encuentra la palabra también en las transcripciones de mensajes de voz, en el texto y en los nombres de archivo, y `matched_in` dice dónde exactamente.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts]

- **Compilado sobre cli-core 0.642.0** (antes 0.638.0). El almacén sigue en la versión 66. Detalles en el [historial de cambios de cli-core](https://github.com/WireCatLabs/cli-core/blob/main/CHANGELOG.md).
- **`*часть*` en el texto de los mensajes se busca tal como está escrito.** Antes `*мои*` también encontraba «мой», y `*cafe*` también «café». Ahora solo se ignoran las mayúsculas y ё/е. Qué tener en cuenta: escribe la letra tal como aparece en el texto, o busca la palabra entera (`мой`), que sigue encontrando todas sus formas.
- **Embeddings remotos por http simple solo en este ordenador.** `--base-url` o `embedding_base_url` con una dirección `http://` en otra máquina ahora se rechaza con `model.address-refused`: los mensajes viajarían por la red sin cifrar. Qué tener en cuenta: usa `https://` o ejecuta el modelo en este ordenador (`localhost`, `127.0.0.1`). Un ajuste guardado se sigue leyendo, y los demás comandos no fallan.
- **`list:` en la búsqueda de mensajes ahora se rechaza.** Es un campo del correo, y antes una consulta con él no encontraba nada sin decir por qué. Ahora la respuesta es `query.unsupported-field` con una explicación.
- **Los datos de prueba se ocultan en las listas de personas.** Una persona cuyas direcciones son todas de prueba (`example.com`, `.test` y similares) o que se creó como ejemplo ya no aparece en ninguna vista, tampoco en `all`.

### Corregido [#corregido]

- **`messages sync --all` muestra el progreso dentro de un chat.** MAX entrega un chat de 30 en 30 mensajes con una pausa de 5–10 segundos, y la línea de progreso solo salía al terminar el chat: en un chat grande, WireCat Desktop mostraba «Чат 1 из 36 · 0» durante minutos. Ahora el contador `fetched` crece después de cada página, como mucho dos veces por segundo.
- **La pista sobre el almacenamiento de contraseñas ya no remite a cron.** Si el perfil ya inició sesión pero el token no se puede leer, el error y `max <profile> doctor` ahora dicen que lo más probable es que el almacenamiento esté bloqueado: justo después de arrancar el equipo se abre al iniciar sesión en el sistema, y una ejecución programada lo espera por sí sola. El consejo sobre `XDG_RUNTIME_DIR` se mantiene para cron y ssh.
- **Las programaciones diarias y únicas esperan cuando MAX pide esperar.** Si una de esas ejecuciones por temporizador recibe `rate_limited`, espera lo que pidió MAX, si no pasa de seis horas, y vuelve a intentarlo en lugar de perderse hasta el día siguiente. Qué tener en cuenta: una programación con `--every` y una ejecución manual siguen terminando con error en el acto.
- **`*слово*` en el texto sugiere una salida.** Si ese patrón recorre demasiadas palabras, el error ahora propone `слово*`, que también encuentra las formas de la palabra.

## 0.110.0 — 11.11.2026 [#01100--11112026]

### Novedades [#novedades-1]

- **`participants_count` en la búsqueda y las estadísticas.** `participants_count<10` encuentra mensajes en chats de menos de diez personas, así que `stats messages show -- 'kind:private OR (kind:group participants_count<10)'` cuenta las conversaciones privadas sin los grupos grandes.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-1]

- **Compilado sobre cli-core 0.638.0** (antes 0.633.0) y cli-base 0.96.0 (antes 0.93.0). Al abrirse por primera vez, el almacén pasa a la versión 66.
  `contacts unlink` ahora exige `--from person:<uid>` o `--from person:me`: la persona de la que se desvincula la cuenta. Sin él, el comando se niega y dice qué añadir. Una cuenta ya registrada para otra persona no se mueve. Detalles en el
  [historial de cambios de cli-core](https://github.com/WireCatLabs/cli-core/blob/main/CHANGELOG.md).

### Corregido [#corregido-1]

- **Atrasar el reloj del sistema ya no detiene la sincronización durante horas.** Si el reloj del ordenador iba adelantado y se corrigió, max creía que MAX le había pedido esperar y rechazaba cada sincronización, aunque ni siquiera se había conectado a MAX. Ahora la espera se recalcula según el tamaño del desfase, y el rechazo ya no dice que MAX pidió esperar.

## 0.109.0 — 10.11.2026 [#01090--10112026]

### Novedades [#novedades-2]

- **`muted:` en la búsqueda y las estadísticas, de `@wirecat/cli-core` 0.633.0.** `muted:false` deja fuera los chats en los que desactivaste las notificaciones, así que `stats messages show -- 'date>=30d muted:false'` cuenta solo lo que la sincronización todavía lee. `stats messages responses` y `stats messages waiting` también lo entienden.
- **`store import`, de `@wirecat/cli-core` 0.633.0.** Carga chats, personas y mensajes inventados desde un archivo marcado como synthetic en un almacén de prueba, por ejemplo el entorno de pruebas de Desktop. No toca el almacén real del propietario.

## 0.108.0 — 10.11.2026 [#01080--10112026]

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-2]

- **Compilado sobre cli-core 0.630.0** (antes 0.624.0). Al abrirse por primera vez, el almacén pasa a la versión 63. La vista de cada persona se guarda con ella, y guardar los miembros de un chat no toca las filas de quienes siguen en él, así que `people list` en memo filtra, cuenta y pagina en SQL. Quien escribió en un chat privado o en un grupo pequeño cuenta ahora como persona del propietario, ninguna regla une a nadie con el propio propietario, y un nombre coincide en cirílico y en latino. Una herramienta con un cli-core antiguo que guarda miembros borra las vistas guardadas, así que max, tg y memo se actualizan juntos. Qué cambió entre versiones, en el
  [historial de cambios de cli-core](https://github.com/WireCatLabs/cli-core/blob/main/CHANGELOG.md).

## 0.107.0 — 09.11.2026 [#01070--09112026]

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-3]

- **Compilado sobre cli-core 0.624.0** (antes 0.618.0). Al abrirse por primera vez, el almacén pasa a la versión 61 (vínculos de las personas con el propietario, solo añadidos). Qué cambió entre versiones, en el
  [historial de cambios de cli-core](https://github.com/WireCatLabs/cli-core/blob/main/CHANGELOG.md).
- **`search messages --timeout 30s` busca hasta 29 segundos.** Antes la búsqueda se detenía a los 2 segundos, sin importar cuánto tiempo se diera a la ejecución, y una consulta correcta sobre un almacén grande fallaba en WireCat Desktop. Sin `--timeout`, el límite sigue siendo de 2 segundos, también para agentes y MCP.
- **`schedule pause <имя>` y `schedule resume <имя>`**: la programación se quita del temporizador y se conserva, y `schedule run` la sigue ejecutando. `--at` se puede dar varias veces: `--at 08:30 --at 18:00`.

## 0.106.0 — 09.11.2026 [#01060--09112026]

### Novedades [#novedades-3]

- **Un pull request escribe sus líneas del historial de cambios en un archivo aparte, `changes/<ветка>.md`.** Los pull requests abiertos ya no entran en conflicto en la sección «Sin publicar». `pnpm docs:check` comprueba cada uno de esos archivos, y `bin/release` los reúne en la sección de la versión. Durante la transición, una entrada en «Sin publicar» también funciona.

### Corregido [#corregido-2]

- **`max serve` termina cuando su versión está desactualizada, y el servicio inicia la nueva.** Una vez por minuto comprueba si el almacén compartido pasó a un formato en el que esta versión ya no puede escribir, y si hay instalada una versión más reciente de max. Si es así, escribe `serve.outdated` en el registro y sale con el código 3, y el servicio de systemd (`Restart=on-failure`) inicia la versión instalada. Por qué: antes `serve` podía seguir funcionando con una versión antigua sin guardar nada.
- **Después de `max store recover run`, la sincronización normal vuelve a cargar lo que pudo perderse con el daño.** La recuperación marca como no cargado todo lo que el chat guardaba desde un día antes de la última comprobación profunda superada. De cli-core 0.618.0 (antes 0.616.0).

## 0.105.0 — 09.11.2026 [#01050--09112026]

### Novedades [#novedades-4]

- **`max <профиль> account remove --keep-data|--delete-data` cierra la sesión del perfil en MAX y lo borra de este ordenador.**
  El comando cierra la sesión en el servidor de MAX y después elimina el token del llavero y los archivos del perfil: el estado, el socket y el registro de `max serve`, y con ellos lo que la capa compartida guarda para el perfil. `--keep-data` conserva los mensajes en el almacén, y la búsqueda los encuentra. `--delete-data` también los elimina. Los demás perfiles no se ven afectados.
  Por qué: hasta ahora `session end` olvidaba solo el token y el resto del perfil quedaba.
  Qué tener en cuenta: mientras `max serve` funciona para el perfil, el comando se niega, igual que `session end`: primero
  `max <профиль> server stop`. El token del bot (`bot:<профиль>`) se conserva: un bot es una cuenta aparte. Una ejecución con carpetas movidas olvida solo su propia copia y no cierra la sesión del propietario en MAX.

## 0.104.0 — 08.11.2026 [#01040--08112026]

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-4]

- **`max` abre un almacén que memo y otras herramientas de WireCat ya actualizaron, y él mismo lo pasa a la versión 57.** Un almacén en la versión 56 o posterior no lo abren `max` 0.103.0 y anteriores ni ninguna herramienta con cli-core anterior a 0.606.0: piden actualizar.
  Qué tener en cuenta: actualiza `max`, `tg` y memo juntos (cli-core 0.606.0, 0.607.0).
- **`--offline` en un comando que necesita MAX responde `permission_error` (`offline.refused`) con el código de salida 5.** Antes `chats inspect`, `chats events`, `chats folders …` y `upgrade` respondían `validation_error` con el código 2.
  Qué tener en cuenta: un script que espera ahí el código 2 debe esperar el 5 (cli-core 0.607.0).
- **`contacts context` y `contacts prepare` leen solo las cuentas del mismo ámbito que el perfil.** Un perfil personal ya no muestra el correo, los mensajes, los eventos y las reuniones de una persona desde cuentas de trabajo, ni uno de trabajo desde cuentas personales. La respuesta tiene un campo nuevo, `accounts`: cada cuenta leída y su ámbito (cli-core 0.605.0).
- **Un nombre escrito con «е» encuentra un chat o una persona con «ё».** Un nombre que antes coincidía con un solo chat o persona ahora puede coincidir con dos (`Алена` y `Алёна`). Entonces `max` se niega y nombra a ambos, como con cualquier nombre ambiguo (cli-core 0.601.0).
- **La búsqueda lee la consulta como palabras normales más a menudo.** `?` al final de una palabra es un signo de interrogación: `счёт?` encuentra «счёт». Un texto con dos puntos, un enlace, un paréntesis o unas comillas sin cerrar (`встреча в 10:30`) se busca como palabras, cuando antes la búsqueda se negaba (cli-core 0.602.0, 0.604.0).

### Corregido [#corregido-3]

- **Un archivo de almacén dañado detiene la escritura y menciona `max store recover`.** Antes, un comando que recibía de SQLite «database disk image is malformed» fallaba con `internal_error`. Ahora la respuesta es `configuration_error` (`store.damaged`), y los comandos siguientes que escriben se niegan hasta que pase una comprobación profunda o una recuperación. La lectura funciona (cli-core 0.605.0).
- **Nada vuelve a unir a las personas que separaste.** Un tercer contacto con la misma dirección de correo podía volver a unir a dos personas después de que las separaras (cli-core 0.605.0).

## 0.103.0 — 07.11.2026 [#01030--07112026]

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-5]

- **`max schedule agent` y `max schedule command` aceptan `--deliver-to <маршрут>` en lugar de `--to <маршрут>`**, y `schedule list` llama al campo `deliver_to` (cli-core 0.600.0). Las programaciones guardadas con `--to` entregan el resultado como antes.

### Corregido [#corregido-4]

- **Abrir el almacén ya no suelta los bloqueos del archivo SQLite.** Antes el archivo se abría truncándolo, y eso liberaba los bloqueos POSIX que tenían otros procesos, así que dos escrituras podían cruzarse (cli-core 0.599.0).
- **`max mcp serve --permission <ключ>=deny` ahora también se aplica a los comandos propios de `max`.** Antes, los niveles dados al servidor MCP no llegaban a las comprobaciones de `max`: un agente podía ejecutar `contacts sync`, `messages transcribe`, `watch` y los comandos de `max bot` (por ejemplo, `bot comments send`) con los niveles guardados del perfil, y la petición llegaba a MAX. Ahora ese comando recibe `permission_error` antes de conectarse. Qué tener en cuenta: un agente con esos niveles ya no pasa por el `max serve` compartido (que solo conoce los niveles guardados), sino que abre su propia conexión, igual que una ejecución con `--permission` en la terminal.

## 0.102.0 — 05.11.2026 [#01020--05112026]

### Corregido [#corregido-5]

- **`max bot list` y `max bot list --check` vuelven a funcionar sin nombre de perfil.** En 0.101.0, en un ordenador sin perfiles respondían con el error `name a profile`, y la lista de bots solo se obtenía poniendo cualquier palabra delante: `max personal bot list`. El comando lee todos los bots de este ordenador, así que no necesita perfil, igual que en `tg` y `wa`. Qué tener en cuenta: los demás comandos `max bot …` siguen necesitando un perfil, y `max` no lo elige por ti.

## 0.101.0 — 05.11.2026 [#01010--05112026]

### Corregido [#corregido-6]

- **Una petición al Bot API y la subida de un archivo ya no retienen en memoria un comando terminado hasta el final de su tiempo límite.** El temporizador del límite seguía hasta el final aunque MAX ya hubiera respondido, y retenía todo lo que el comando había cargado. Un proceso que hace muchas peticiones seguidas, como `max bot mcp` o `max bot updates watch`, crecía con cada petición. Lo mismo se corrige para `--timeout` de los comandos `max bot`.

## 0.100.0 — 05.11.2026 [#01000--05112026]

### Novedades [#novedades-5]

- **`max config migrate` añade al archivo cada configuración que falta, con su valor integrado, y cualquier escritura de `max` en el archivo hace lo mismo.** En `config.json` se ven y se editan todas las configuraciones, también `serve` y `transcribe_model`, sin consultar la documentación. Tus valores, su orden y las claves desconocidas se conservan; `config unset` no vuelve a escribir lo eliminado, y una simple lectura no reescribe el archivo (cli-core 0.563.0).
- **`max config show` muestra para cada configuración su valor integrado y lo que hace**, y también `keep_successful_runs_for_days` y `runs_size_limit_mb`, que faltaban en la lista.
- **De cli-core 0.563.0:** `config repair` repara la sintaxis JSON del archivo de configuración; `stats messages responses` y `stats messages waiting`; `tasks status`, `tasks review` y `tasks acknowledge`.
- **De cli-core 0.564.0–0.566.0:** `store chats status` cuenta los chats que el archivo guarda desde el primer mensaje, en parte o nada; `stats tasks show` acepta una consulta y cuenta las tareas abiertas y cerradas en un periodo (`-- created>=30d`); `has:transcript` encuentra mensajes de voz con transcripción.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-6]

- **Una escritura en una tarea que cambió después de que la leyeras ahora termina con el código `conflict`, salida 15**, y no con `configuration_error`, salida 3. El motivo sigue siendo `task.stale` (cli-core 0.567.0, cli-base 0.77.1).
- **`max account list` ya no muestra un bot como una cuenta sin sesión.** Un nombre que solo tiene un bot no se muestra; un nombre que es a la vez tu cuenta y un bot lleva `bot: true` (cli-core 0.567.0).
- **El nuevo código de error `conflict` (código de salida 15) aparece en `max commands --json` y en el esquema de errores de las herramientas MCP** (cli-base 0.77.1). Significa que una escritura se rechazó porque lo que cambia cambió después de leerlo. Lo devuelve una escritura en una tarea desde una copia desactualizada (ver arriba).
- **`search all` ordena todas las fuentes en una sola lista, busca también el correo por significado y encuentra registros para una pregunta escrita como frase** (cli-core 0.564.0). Antes, los resultados de cada fuente iban uno tras otro, y una pregunta solo encontraba los registros que tenían todas sus palabras.

## 0.99.0 — 03.11.2026 [#0990--03112026]

### Novedades [#novedades-6]

- **`wcat max` ejecuta el programa, y `wcat --help` lo muestra.** El paquete instala el comando `wcat-max` junto a `max`, y `wcat-max --wcat-describe` imprime para `wcat` el nombre, la versión y la descripción del programa.

## 0.98.0 — 02.11.2026 [#0980--02112026]

### Novedades [#novedades-7]

- **`projects evidence` y `projects status` leen los chats vinculados por finalidad**: `--purpose sales,work` o `--purpose all`. Sin la opción se usan las finalidades por defecto (la integrada es `work`). Un chat que queda fuera de la selección no desaparece en silencio: es una fila `missing` con la finalidad, el número de mensajes y el comando que lo lee (cli-core 0.553.0).
- **`projects evidence --include-proposed`** lee también los chats con personas propuestas para el proyecto pero aún no confirmadas; todo lo que aportan va marcado como `proposed` (cli-core 0.553.0).
- **`projects evidence --compact`** imprime una línea por cada hallazgo, chat vinculado, chat omitido y miembro (cli-core 0.553.0).

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-7]

- **El JSON de `projects status` tiene un campo nuevo, `purposes`**, y un chat omitido por finalidad lleva la cuenta, el id del chat y los contadores (cli-core 0.553.0).

## 0.97.0 — 02.11.2026 [#0970--02112026]

### Novedades [#novedades-8]

- **`max serve` recupera lo que llegó mientras no funcionaba.** 30 segundos después de conectarse, lee los chats que tienen mensajes más nuevos que los que había en la copia cuando arrancó: no más de 7 días atrás, hasta 500 mensajes por chat y durante 5 minutos como máximo. Si estuvo parado más de una semana, ejecuta una vez `max <profile> messages sync --all` (cli-core 0.552.0).
- **`server install` habilita el servicio**, y `serve` arranca en cada inicio de sesión y después de reiniciar el equipo. Para habilitar un servicio que instaló una versión anterior de `max`, repite `max <profile> server install`; `server status` muestra `starts_at_login`. Un servicio de una copia de trabajo del código de max se escribe, pero no se habilita (cli-core 0.552.0).
- **`messages sync` respeta los límites del historial**: por defecto no lee un grupo de más de 50 personas (`history_group_members_max`), lee un grupo 365 días atrás y un chat personal 1095 (`history_group_days`, `history_dialog_days`), e indica lo que omitió en `limited`. `--full-history` lee más atrás en una ejecución; para leer siempre los grupos grandes, sube la configuración. Los mensajes nuevos nunca se pierden (cli-core 0.551.0).
- **`max <profile> projects status <проект>`** muestra en qué punto está un proyecto, solo a partir de la copia local (cli-core 0.551.0).
- **`--compact`** imprime una línea por elemento para un agente, a partir de la misma respuesta que `--json` (cli-core 0.550.0).
- **`messages list` lee una ventana por ambos lados**, también sin red: `'date>=2026-10-01 date<2026-10-20'` lee hacia delante desde el inicio y se detiene en el final. Antes, esa consulta se rechazaba (cli-core 0.547.0).
- **Un comando que necesita un chat o un mensaje acepta también la referencia que imprimen otros programas de WireCat** (`msg:…`, `chat:…`) (cli-core 0.546.0).

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-8]

- **Una búsqueda que se quedó sin tiempo termina con `timeout` y el motivo `query.time-limit`** en unos 2 segundos, y no con `validation_error` / `query.too-large` tras mucho rato. La consulta es correcta; añade `chat:` o `date:` para buscar en una parte menor de la copia (cli-core 0.552.0).
- **Un texto de la forma `<вид>:<без пробелов>` en lugar de un chat se lee como referencia**, y una referencia a otra cuenta o mensajero se rechaza con su propio motivo. Una clave después de `--` se lee como clave (cli-core 0.546.0).

### Corregido [#corregido-7]

- **Una sincronización cuya salida se cerró termina su trabajo.** Antes, un canal cerrado (EPIPE) la cortaba (cli-core 0.552.0).
- **`messages delete` sin número de mensaje se rechaza antes de conectarse** (cli-core 0.551.0).
- **`page.next` de `messages list` se ejecuta tal como está escrito, y un inicio «inclusivo» conserva el mensaje enviado justo en ese momento** (cli-core 0.547.0).
- **Si el llavero está bloqueado, `max serve` y una ejecución programada lo vuelven a intentar en lugar de pedir que inicies sesión de nuevo.** Un perfil que ya había iniciado sesión en este ordenador pero no podía leer su token respondía `authentication_error` (código 4). El servicio `serve` con `RestartPreventExitStatus=4` ya no se reiniciaba hasta un `server start` manual, y un temporizador que saltaba al arrancar, antes del inicio de sesión, perdía su ejecución de todo el día. Ahora `max serve` y una ejecución bajo temporizador (`MAX_SCHEDULED`) responden `provider_unavailable` (código 12) con el motivo `credentials.unreachable`: systemd reinicia el servicio, y `schedule exec` (cli-core) repite la ejecución hasta que el inicio de sesión abre el llavero. Un comando escrito a mano responde como antes.

## 0.96.0 — 02.11.2026 [#0960--02112026]

### Novedades [#novedades-9]

- **`max <profile> messages download --offline` copia un archivo que ya está en este ordenador**, sin conectarse; `--attachment <n>` elige un archivo del mensaje, y en lugar del chat y el mensaje se puede pasar una referencia `msg:` (cli-core 0.532.0).
- **La primera ejecución de una versión nueva actualiza las instrucciones para agentes que instaló una versión antigua.** Una copia desactualizada de `SKILL.md` (Claude Code, `~/.agents/skills`, Hermes) se reescribe una vez, con una línea en stderr; el comando no toca una copia que no existe, que no tiene versión o que es un enlace. `MAX_NO_SKILL_REFRESH=1` lo desactiva (cli-core 0.544.0).

### Seguridad [#seguridad]

- **Un agente ya no puede relajar los permisos desde su propio shell.** `max <profile> config set|unset permissions…` ejecutado por un agente (Hermes, OpenClaw, Claude Code y otros que marcan su shell) solo puede endurecer un nivel, no relajarlo, y solo el propietario cambia `mcp.authority` y `bot.api`. Así el modo de solo lectura que pone la aplicación WireCat se mantiene aunque un mensaje en un chat convenza al agente de ejecutar `config set`. Cambia los permisos en una terminal fuera del agente (cli-core 0.544.0).

## 0.95.0 — 01.11.2026 [#0950--01112026]

### Novedades [#novedades-10]

- **`projects evidence --json` da un comando de descarga para cada chat vinculado** en `linked_chats[].sync_command`: la misma línea que en el texto, o null si el chat está cargado por completo (cli-core 0.517.0).

### Corregido [#corregido-8]

- **`projects evidence` ya no escribe «held from <date> only»** sobre un chat que llegó a su primer mensaje: ahora es «held from its first message, behind since <date>» o «with gaps». El progreso de `messages sync` muestra hasta dónde llegó con una fecha («back to <date>»), y no con la clave del mensaje, que en MAX era un número de milisegundos (cli-core 0.517.0).

## 0.94.0 — 01.11.2026 [#0940--01112026]

### Novedades [#novedades-11]

- **`max <profile> projects evidence <project>`** (`projectsCommand` de cli-core). Muestra lo que los mensajes guardados de esta cuenta dicen de un proyecto: nombre, clave, otros nombres, palabras, contactos, miembros confirmados y chats vinculados. **`--sync-first`** (desactivado por defecto, no está en MCP) primero descarga los chats vinculados que el almacén no tiene hasta `--since-time`, de uno en uno, dentro de `--sync-time` (3 minutos para todos). Un chat para el que no alcanzó el tiempo queda parcial, con `missing` y `next`. Si la descarga falla (por ejemplo, hace falta un `serve` en marcha), el chat se marca `failed` con el motivo, y la lectura sigue. El acceso lo cierra el permiso `messages` (cli-core 0.511.0).

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-9]

- **El registro de llamadas MCP nombra al agente que hizo la llamada, no `max-mcp`** (cli-core 0.509.0): el nombre con el que se presentó el cliente (`clientInfo.name`, por ejemplo `claude-code`), si no el agente que arrancó el servidor, si no `max-mcp`. Un filtro por `max-mcp` no encuentra las llamadas nuevas. El nombre lo dice el propio cliente, es solo una etiqueta.

## 0.93.0 — 31.10.2026 [#0930--31102026]

### Novedades [#novedades-12]

- **`messages sync --json` escribe el progreso de la sincronización en stderr** (cli-core 0.507.0): una línea JSON cada vez, solo contadores, sin ids ni nombres de chats. stdout sigue llevando una sola respuesta.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-10]

- **`search messages --discover` busca por significado también cuando la consulta tiene `-`, `NOT`, `OR`, paréntesis, frases o `exact:`** (cli-core 0.506.0). Antes, esa consulta solo hacía una búsqueda estricta. Ahora las palabras se siguen buscando con la consulta entera (`discovery.method: "lexical-strict"`), y se añaden mensajes cercanos en significado a sus palabras. Cada mensaje encontrado por significado, y cada respuesta o continuación añadida, cumple todos los campos de la consulta y no contiene ninguna palabra excluida.

### Corregido [#corregido-9]

- **La descripción de `doctor` es la misma que en los demás CLI: «the state this installation is in, without connecting unless --online»** (cli-core 0.507.0). Antes, max la sustituía por la suya, y el resumen no coincidía con el común.
- **`search messages --discover` con un filtro estrecho (`chat:`, `date:`) ordena por significado los mensajes del propio filtro**, si no son más de 100 000, y no los 100 más cercanos de todo el archivo, así que la página se llena (cli-core 0.506.0).
- **`search messages --discover` funciona con una base de datos abierta solo para lectura** (cli-core 0.506.0).
- **Una reconstrucción larga en un proceso ya no rompe una escritura en otro con el error "database is locked"** (cli-core 0.506.0).
- **El archivo de reserva para el token ahora lo gestiona cli-base 0.68.0, sin código propio en max** (cli-core 0.507.0). Un token del archivo privado se lee de ahí, y la rotación lo deja ahí; `session start` lo devuelve al llavero y borra la copia del archivo, como en 0.92.0. El aviso de llavero no disponible sigue siendo uno por ejecución.

## 0.92.0 — 31.10.2026 [#0920--31102026]

### Novedades [#novedades-13]

- **`search messages` dice cuántos mensajes coinciden en total: `page.total`** (cli-core 0.501.0). En `--json` aparece `page.total: { value, relation }` con la forma de `hits.total` de Elasticsearch: `eq` es un número exacto, `gte` significa «como mínimo» (el conteo se detiene en 10 000). En la terminal, debajo de los resultados: `showing 1–20 of 144`.
- **`session start --credential-storage keyring|file`.** Por defecto el token va al almacén de contraseñas del sistema, y si no está disponible, a un archivo que solo tú puedes leer, sin preguntas y con un aviso. `file` elige el archivo directamente; no lo recomendamos. Un token del archivo se lee primero, así que ya no se toca un almacén bloqueado para él; el siguiente inicio de sesión con el almacén devuelve el token allí. La respuesta dice dónde quedó el token: `credential_storage`. Requiere cli-core 0.503.0.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-11]

- **max requiere cli-base 0.67.0** (cli-core 0.501.0).

## 0.91.0 — 31.10.2026 [#0910--31102026]

### Novedades [#novedades-14]

- **`messages list --offline`, `tasks agenda` y `search all` avisan cuando la copia local tiene un chat solo en parte** (cli-core 0.493.0). Un chat no descargado hasta el principio, o nunca descargado, da `meta.complete: false`, `missing` y `next` con el paso `messages sync <чат>` (primero para la ventana de la respuesta, si la tiene). En `tasks agenda` cada fila tiene `completeness` y `held`, y en el texto ese chat va marcado `[partial]` o `[never fetched]`. El código de salida sigue siendo 0.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-12]

- **`search messages`, `search all`, `tasks agenda` y `messages list --offline` responden `meta.complete: false` si un chat que leyeron está en la copia solo en parte** (cli-core 0.493.0). Antes era `true`, y el hueco solo se veía en `missing` y `next`. Un script que tomaba `meta.complete` como señal de que «ninguna fuente falló» debe leer el motivo en `missing`. El código de salida sigue siendo 0.
- **Las continuaciones en `search messages --discover --json` llegan como fragmento de hasta 240 caracteres, igual que el propio resultado: `items[].follow_ups[].excerpt` en lugar de `text`** (cli-core 0.496.0). En 0.90.0 la continuación llegaba como mensaje entero, y en un archivo real un solo mensaje largo añadía 7 KB a una respuesta de cinco resultados. `messages context <ref>` muestra el mensaje entero. La salida en la terminal no cambió.

### Corregido [#corregido-10]

- **`search messages --discover` con fecha y hora entre comillas ya no falla con `query.invalid-date`** (cli-core 0.496.0). La corrección de «22:00» en 0.90.0 reemplazaba los dos puntos entre cifras también dentro de las comillas, así que `date:["2026-08-21T21:30:00Z" TO "…"]` con `--discover` no funcionaba.
- **`search notes` y las notas de `search all` respetan los campos de la consulta también en lo encontrado por significado** (cli-core 0.496.0). `date:today` o `tag:work` sin `--exact` devolvían unas 20 notas que no cumplían ningún campo. Ahora por significado solo se buscan las palabras de la consulta, y cada campo y cada palabra excluida (`-draft`) se aplican a todos los resultados.
- **En un documento de Drive, `date:` y el `updated_at` mostrado son el mismo momento, el de la edición en Drive** (cli-core 0.496.0). Antes, `date:` leía el momento en que cambió la copia, y de 20 resultados para `date>=30d`, 16 mostraban una fecha más antigua.
- **Una ejecución con carpetas movidas ya no puede borrar del llavero el inicio de sesión del propietario ni cerrar su sesión en MAX** (cli-base 0.65.5, WC-SECR-24). Antes, solo se consideraba movida una ejecución con `MAX_*_DIR`; una ejecución con otro `HOME` o carpeta XDG tocaba la entrada real `max-cli`, y `session end` en ella la borraba. Ahora esa ejecución lee el inicio de sesión del propietario, pero no lo cambia ni lo borra, y un inicio de sesión nuevo se escribe en una entrada temporal. `session end` sobre el inicio de sesión del propietario no cierra nada y responde `kept: "owners-sign-in"`.
- **`bin/max` en una copia de trabajo del código ya no copia tokens**: la copia lee el inicio de sesión del propietario, y `scripts/seed-worktree.ts` solo traslada el estado del perfil.
- **max requiere cli-base 0.65.5 y cli-core 0.496.0.**

## 0.90.0 — 31.10.2026 [#0900--31102026]

### Novedades [#novedades-15]

- **`max <профиль> search messages '<вопрос>' --discover` muestra continuaciones: mensajes posteriores que pueden cancelar o cambiar lo encontrado (cli-core 0.492.0).** A los cinco primeros resultados se añaden hasta dos mensajes posteriores, de cualquier chat que lea la búsqueda, que comparten con él una palabra poco común (su raíz aparece en no más de tres mensajes del archivo): así se ve si una decisión se canceló después y la cancelación no fue una respuesta. En `--json` es `items[].follow_ups`, en la terminal las líneas `later, shares a rare word`. Qué tener en cuenta: las continuaciones aparecen cuando las raíces de las palabras ya están construidas.

### Corregido [#corregido-11]

- **`search messages --discover` ya no falla con una pregunta que lleva una hora o una proporción («antes de las 22:00», «1:1»)** (cli-core 0.492.0). Los dos puntos entre cifras se leían como filtro de campo, y la búsqueda terminaba con el error `query.invalid-syntax`.
- **Corrección a 0.89.0: en esa misma versión, una escritura en el almacén dejó de fallar con «database is locked» mientras otro programa de WireCat escribe en él** (cli-core 0.485.0). La entrada de 0.89.0 no lo dice.
- **max requiere cli-core 0.492.0** (cli-base sigue en 0.65.0).

## 0.89.0 — 31.10.2026 [#0890--31102026]

### Novedades [#novedades-16]

- **`contacts list notes:` encuentra parte de una palabra sin importar mayúsculas o minúsculas, también en cirílico (cli-core 0.490.0).** Antes, `notes:КВАРТ` no encontraba una nota con la palabra «квартира»: la comparación sin distinguir mayúsculas solo funcionaba con letras latinas, y la búsqueda leía todas las notas. Ahora las notas se buscan con un índice de tres caracteres y responden en milisegundos. Qué tener en cuenta: una consulta de menos de tres caracteres se rechaza con el error «search needs at least three characters» (una consulta vacía sigue sin seleccionar nada). El almacén se actualiza a la versión 40 la primera vez que se abre; las notas guardadas antes reciben el índice por partes durante `search notes` o `store migrate`, y mientras tanto se buscan con el método anterior. Una compilación de otro programa de WireCat con un cli-core antiguo no escribe el índice en un almacén ya actualizado, así que actualiza todos los programas de WireCat a la vez.

### Corregido [#corregido-12]

- **Corrección a 0.88.0: los campos de la tarjeta de contacto se llaman `firstName`, `lastName` y `userId`.** La entrada de 0.88.0 sobre el adjunto `CONTACT` los llama `first_name`, `last_name` y `user_id`; #874 los renombró, y la entrada se quedó como estaba.
- **max requiere cli-core 0.491.0** (cli-base sigue en 0.65.0). En 0.491.0 solo se corrige la sincronización del correo, que max no usa.

## 0.88.0 — 31.10.2026 [#0880--31102026]

### Novedades [#novedades-17]

- **Una tarjeta de contacto en un mensaje (`CONTACT`) se lee como contacto: el adjunto tiene `contact` con el nombre, `first_name`, `last_name` y `user_id`.** Antes ese adjunto llegaba solo con el tipo `contact`, sin nombre. Qué tener en cuenta: MAX no envía el teléfono en la tarjeta, así que no hay campo `phone`.

### Corregido [#corregido-13]

- **La búsqueda por título de chat y por nombre de contacto no distingue mayúsculas en ningún alfabeto (cli-core 0.484.0).** Antes, `max <профиль> chats list 'title:СТАС*' --offline` no encontraba el chat «Стас»: el almacén local solo comparaba sin distinguir mayúsculas las letras latinas. Ahora lo encuentra; `name:` en `tags list` funciona igual para títulos de chats y nombres de contactos. Qué tener en cuenta: el almacén se actualiza a la versión 38 la primera vez que se abre, sin que tengas que hacer nada. Si una compilación más antigua de otro programa de WireCat abre el mismo almacén y renombra algo, la búsqueda por el nombre nuevo funcionará cuando una compilación nueva vuelva a abrir el almacén.
- **`max --help` muestra `gcal` en la lista "Works with" (cli-core 0.482.0).** Es Google Calendar junto a los demás datos de WireCat; `max setup` ofrece instalar `@wirecat/gcal-cli`. Si un script comprueba el texto de la primera pantalla, ahora tiene una línea más.
- **max requiere cli-core 0.484.0** (cli-base sigue en 0.65.0).

## 0.87.0 — 30.10.2026 [#0870--30102026]

### Corregido [#corregido-14]

- **Los chats personales del almacén local reciben un título con el nombre de la otra persona, y `max <профиль> chats list 'title:Стас*' --offline` los encuentra.** Antes, un chat personal no tenía título en el almacén, y cada inicio de sesión en MAX borraba lo que `chats list` había llegado a escribir, así que una búsqueda sin red por título no encontraba ningún chat personal, y los agentes tenían que recorrerlos todos. Ahora, tras iniciar sesión, el título se toma del nombre de la otra persona (el mismo que muestra `contacts`), también en los chats personales guardados antes. Qué tener en cuenta: un chat personal cuya otra persona no está en los contactos ni entre los miembros de los chats se queda sin título hasta que se ejecute `chats list` con red.

## 0.86.0 — 29.10.2026 [#0860--29102026]

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-13]

- **`max contacts info` se sustituye por `max contacts show` (cli-core 0.477.0).** Muestra el contacto completo, y el número de teléfono ahora se imprime entero, sin máscara. Qué hacer: en los scripts, cambia `contacts info` por `contacts show`. La forma antigua del comando ya no existe.
- **max requiere cli-core 0.478.0** (cli-base sigue en 0.65.0).

### Corregido [#corregido-15]

- **`sender_is_me` en `inbox`, `review`, `search messages` y `search all` (cli-core 0.478.0).** Estas respuestas no marcaban tus propios mensajes; ahora tienen el campo, como `messages list`.

## 0.85.0 — 29.10.2026 [#0850--29102026]

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-14]

- **`max mcp serve` sin perfil ya no sirve todos los perfiles (cli-core 0.470.0).** Termina con código 2 (`validation_error`) y enumera los perfiles de este ordenador. Nombra un perfil como primera palabra (`max work mcp serve`), una lista (`max mcp serve --profiles work,personal`) o todos (`--profiles all`). `--http`, `mcp server start|stop|status`, `mcp revoke` y `mcp config` funcionan igual. A quién afecta: una entrada de cliente MCP de 0.83.0–0.84.0 con `max mcp serve` sin perfil deja de arrancar; imprímela de nuevo con `max mcp config --profiles all` o añade el perfil. Un servidor en segundo plano de todos los perfiles iniciado por esas versiones se reinicia con `max mcp server start --profiles all`. La entrada del MCP Registry ya ejecuta `mcp serve --profiles all`, la imagen de Docker el perfil `glama` y `doctor --online` el perfil que comprueba.
- **Cada mensaje en las respuestas de `messages list`, `show`, `context`, la búsqueda e `inbox` tiene `sender_is_me` (cli-core 0.473.0).** Es verdadero para tus propios mensajes, también en MAX, donde el propietario no tiene id de remitente. Un script que compara la respuesta con una copia estricta del esquema rechazará el campo nuevo.
- **max requiere cli-core 0.473.0** (cli-base sigue en 0.65.0). `max --help` ahora también nombra `mail` en "Works with".
- **La habilidad para agentes se publica en ClawHub como `wirecat-max`.** Instalación: `openclaw skills install @wirecat/wirecat-max`. La entrada `max-cli` ya no se actualiza. `max skill install` sigue escribiendo `skills/max-cli/`.

## 0.84.0 — 27.10.2026 [#0840--27102026]

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-15]

- **cli-core 0.469.0 y cli-base 0.65.0.** cli-core 0.469 solo acepta cli-base 0.65, por eso ambas versiones cambian
  juntas. cli-base 0.65 incluye los verbos `serve` y `revoke`, así que sus entradas en la línea base del linter se
  eliminaron, y su `cli-dev bundle` encuentra un servidor iniciado con una opción antes de `mcp serve`. Desde cli-core 0.468, el servidor MCP ofrece
  un comando que solo carga datos en el almacén a través de la herramienta de lectura.

## 0.83.0 — 27.10.2026 [#0830--27102026]

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-16]

- **El servidor MCP se inicia con `max mcp serve`, y `max mcp` solo muestra la ayuda (cli-core 0.463.0).**
  Lo mismo para el bot: `max <бот> bot mcp serve`. Los inicios de sesión de las apps del navegador los termina `max mcp revoke` en lugar de
  `max mcp --revoke`. Las entradas que imprimen `mcp config` y `mcp add`, `mcp server start`, `doctor --online`,
  la entrada en el MCP Registry y la imagen de Docker ya ejecutan `mcp serve`. Qué hacer: en tu entrada del cliente MCP o en un
  script, sustituye `max <профиль> mcp` por `max <профиль> mcp serve`, y `mcp --revoke` por `mcp revoke`. La forma antigua
  del comando ya no existe.
- **`skill show`, `skill status` y `skill install` con `--json` imprimen `{ item, meta }` (cli-core 0.462.0).** Los campos
  que estaban en el nivel superior (`name`, `content`, `written`) ahora están dentro de `item`. El instalador de Windows ya
  lee la forma nueva.
- **`max account list` indica si el perfil tiene sesión iniciada en este equipo** (`signed_in`), y los resultados de búsqueda de cualquier
  tipo nombran los campos que el agente lee como datos (`untrusted`). Un script que compara la respuesta con una copia estricta antigua
  del esquema rechazará el campo nuevo (cli-core 0.464.0 y 0.466.0).
- **Cada ejecución se registra de forma predeterminada, también la correcta (cli-core 0.467.0).** Las correctas se guardan 7 días
  (`keep_successful_runs_for_days`), las fallidas 30 (`keep_runs_for_days`); la carpeta de ejecuciones no supera
  `runs_size_limit_mb` (200). Con `record_input` predeterminado, un envío correcto deja el texto escrito en el registro
  local con permisos `0600` durante 7 días. `record: false` ahora conserva las ejecuciones fallidas (antes, nada),
  `record_input: false` oculta lo escrito en todas partes, `--no-record` no conserva nada. `kept_because_failed` ya no se
  pone en `run.json`.
- **max requiere cli-core 0.467.0 y cli-base 0.64.0.**

### Novedades [#novedades-18]

- **Una solicitud en el registro de ejecución se marca como de red y conoce su intento.** Cada trama del protocolo personal y cada
  solicitud de la Bot API en `events.jsonl` recibe `"level": "wire"` y `transport` (`max-ws` o `http`). Una solicitud de la Bot API
  recibe además `attempt`, y un reintento tras `429` o un fallo, `wait_ms`: cuánto esperó el cliente antes. Igual
  se numeran los reintentos de `messages send` mientras el archivo no está listo (`attachment.not.ready`). Requiere un cli-core
  que registre cada ejecución.
- **`max upgrade` reinicia el servidor MCP del navegador que inició `max mcp server start`,** en el mismo puerto, con
  la misma dirección y restricciones (`mcp_servers`, versión antigua → nueva); un servidor iniciado a mano se queda y
  se nombra. Las sesiones de agentes por stdio en la versión antigua se enumeran (`stale_sessions`): reinícialas desde la app
  del agente. Funciona a partir de la próxima actualización (cli-core 0.464.0).

### Corregido [#corregido-16]

- **`max mcp serve` sin perfil marca los perfiles sin sesión iniciada.** Antes la lista tenía todos los perfiles, y
  la app podía elegir un perfil sin sesión y recibir un error. Ahora en el menú de la app y en la descripción ese
  perfil lleva «— not signed in», los perfiles solo de bot no se muestran (el bot tiene su propio `bot mcp serve`), y una llamada
  para un perfil sin sesión responde cómo entrar: `max <профиль> setup` o desde WireCat Desktop.
- **La página de inicio de sesión del servidor MCP del navegador explica que un código sirve para un solo inicio de sesión.** Tras el inicio de sesión de una app,
  el código nuevo aparece en WireCat Desktop y en `max mcp server status` (cli-core 0.466.0).
- **El skill max-cli ya no envía al agente a `search all` ni a `messages sync --all`.** La búsqueda empieza por
  `search messages`; las notas y Drive, solo si el propietario lo pide. Si no se encuentra nada, el agente lo dice y
  propone una descarga limitada de un chat, que inicia tras el consentimiento del propietario. Los mismos cambios en README y
  en docs (search, usage, index, troubleshooting).

## 0.82.0 — 27.10.2026 [#0820--27102026]

### Novedades [#novedades-19]

- **Sin sesión, el error también propone WireCat Desktop.** `no session`, `has not logged in yet` y un token caducado ahora
  dicen: un comando en el terminal o el inicio de sesión en WireCat Desktop (Tools → MAX → Manage). Por MCP se indica al agente que no pida
  códigos ni contraseñas (cli-core 0.452.0; con él también 0.451.0: búsqueda por significado con ONNX Runtime nativo también en Windows).
- **`max mcp` sin perfil atiende todos los perfiles, por stdio y con `--http` (cli-core 0.450.0).** En la app de IA basta
  un conector para MAX, no uno por perfil. Cada herramienta (`max_tools_search`, `max_read`,
  `max_write`) tiene el campo obligatorio `profile` (todos los perfiles de este equipo, sin valor por defecto), y se indica al agente
  que pregunte si no nombraste la cuenta. La llamada va al propio `max <profile> mcp` de ese perfil: se inicia
  con la primera llamada y se cierra tras 10 minutos de inactividad, así que los permisos, la sesión y el registro del perfil funcionan como antes.
  `max mcp --revoke`, `max mcp config` y `max mcp server start|stop|status` funcionan sin perfil, con su propio inicio de sesión.
  `--public-url` acepta una ruta, `https://<name>.ts.net/max`. La entrada en el MCP Registry ejecuta `max mcp`.
  `max <profile> mcp` no cambió.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-17]

- **max requiere cli-base 0.63.0 (cli-core 0.450.0).** Nada de lo que usa max cambió en ella.

### Corregido [#corregido-17]

- **Cada comando tarda menos en prepararse (cli-base 0.62.0, cli-core 0.449.0).** La comprobación de los comandos comunes
  describe cada comando una vez, no de nuevo para cada grupo por encima. En tg, un `run(["--version"])` ya calentado es
  más rápido: 29 ms en lugar de 49. Por qué: la comprobación ocupaba cerca del 60 % de la preparación de cada comando. Qué tener en cuenta: nada, la comprobación
  detecta los mismos cambios.
- **La búsqueda por significado y `--discover` funcionan con ONNX Runtime nativo también en Windows (cli-core 0.451.0).** Después de
  `max <профиль> models download`, los modelos de texto y el reordenador usan la biblioteca nativa en Windows x64 y
  arm64, como ya en Linux y macOS: de 2 a 3 veces más rápido que WebAssembly. La descarga toma `onnxruntime.dll` del paquete npm
  `onnxruntime-node` (113,5 MB, una vez, verificado por sha256). Los modelos de imágenes (CLIP, SigLIP2) también usan la
  biblioteca nativa donde está instalada: aproximadamente el doble de rápido. Los resultados son los mismos.

## 0.81.0 — 26.10.2026 [#0810--26102026]

### Novedades [#novedades-20]

- **La búsqueda por significado y el reordenamiento de `search messages --discover` son de 2 a 3 veces más rápidos en Linux y en Mac con Apple Silicon (cli-core 0.448.0).** Los modelos ahora se calculan con la biblioteca nativa ONNX Runtime en lugar de WebAssembly: en un mismo archivo, `--discover` pasó de 4,6 a 3,2 s, con las mismas respuestas. La biblioteca (10–42 MB, versión oficial de Microsoft, verificada por sha256) la instala `max <профиль> models download`; la búsqueda no descarga nada por sí sola. Qué tener en cuenta: en una máquina ya configurada, la mejora aparece tras el próximo `models download e5-small` o `models download mmarco`. Windows, los Mac con Intel y Alpine siguen funcionando con WebAssembly.

### Corregido [#corregido-18]

- **El reordenamiento de `--discover` ve el propio mensaje encontrado, no solo aquel al que responde (cli-core 0.447.0).** Antes el modelo leía primero el mensaje original completo y cortaba el texto en 512 tokens, así que con un original largo la respuesta quedaba fuera de su ventana. Ahora del original se toman los primeros 300 caracteres.

## 0.80.0 — 26.10.2026 [#0800--26102026]

### Novedades [#novedades-21]

- **`max <профиль> session start qr --json --answer-stdin` inicia sesión sin terminal, para WireCat Desktop (cli-core 0.443.0).** La contraseña en la nube de MAX se pide con una línea `needs` en stderr (`{"event":"needs","field":"password","secret":true,"prompt","hint"}`), y la respuesta se lee como una línea de stdin; `session start token` pide el token del mismo modo. Sin `--answer-stdin`, una ejecución sin terminal sigue rechazándose, para que el shell de un agente nunca espere una pregunta. La respuesta no se imprime ni llega a los registros de ejecución.
- **`max <профиль> mcp server start|stop|status` mantiene el servidor MCP HTTP en segundo plano (cli-core 0.445.0).** `start` acepta `--public-url`, `--port` y `--permission`, como `mcp --http`, y vuelve cuando el servidor escucha; `status` muestra el puerto, la dirección, el código de acceso de un solo uso y las apps conectadas; `stop` detiene solo su propio servidor. WireCat Desktop lo inicia y lo detiene desde el panel Manage.
- **`max <профиль> tasks list claimed_by:<кто>` muestra las tareas que tomó ese ejecutor (cli-core 0.441.0).** `claimed_by:*`: todas las tareas tomadas; `NOT claimed_by:*`: las que nadie tomó; un patrón como `claimed_by:claude-code:*` también funciona. Solo cuentan las tomas vigentes: una toma caducada no retiene nada.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-18]

- **La ayuda de `--record` dice lo que de verdad guarda el registro de ejecución.** Antes: «ids and timings, never message content», aunque desde 0.79.0 el registro guarda la línea de comandos tal como la escribiste. Ahora: «with the command as typed and secrets hidden; record_input false leaves the typed words out». Qué tener en cuenta: cambia el texto de `max --help` y de `docs/commands.md`; una comprobación que compara la ayuda verá la línea nueva.

### Corregido [#corregido-19]

- **El código de acceso para una app del navegador de `mcp --http` se renueva cuando caduca (cli-core 0.445.0)**, no solo tras una entrada errónea o tardía. La página de inicio de sesión dice que el código se muestra en WireCat Desktop o en el terminal. Un segundo `mcp --http` para el mismo perfil ahora se niega a iniciarse.
- **`search messages --discover` con reordenamiento lee solo los primeros 300 caracteres del mensaje al que responde el resultado (cli-core 0.447.0).** Por qué: un mensaje original largo ocupaba toda la ventana del modelo, y este evaluaba el original en lugar de la respuesta. Qué tener en cuenta: el orden de los resultados de `--discover` con un modelo de reordenamiento puede cambiar; el modelo hace cerca de un 40 % menos de trabajo.

### Seguridad [#seguridad-1]

- **El registro de ejecución oculta más secretos por su forma, no solo por el nombre de la opción (cli-core 0.440.0–0.444.0).** Se sustituyen por `[redacted]` los tokens de formatos conocidos (GitHub, OpenAI y Anthropic, Slack, AWS, Google, Stripe, npm, token de bot de Telegram, JWT, clave privada PEM), `Bearer` y `Basic`, el valor tras un nombre «secreto» (`password=…`, `пароль 1234`, `pin 1234`, `код 123456`), las cadenas aleatorias largas y las claves hex; las demás palabras se quedan. Un número de teléfono con «+» o de 11 a 15 cifras seguidas se oculta dondequiera que se escriba, incluso en el texto de un mensaje. Qué tener en cuenta: un hash de commit completo y un id positivo de 11 a 15 cifras también se convierten en `[redacted]`; un número sin «+» escrito por grupos (`8 912 345-67-89`) no se reconoce.
- **Si los ajustes no se cargaron, el registro de ejecución oculta las palabras escritas (cli-core 0.442.0).** Antes, en ese caso `record_input` se consideraba activado aunque los ajustes tuvieran `record_input: false`.

## 0.79.0 — 26.10.2026 [#0790--26102026]

### Novedades [#novedades-22]

- **`max skill install --for hermes` instala el skill para Hermes Agent, y `max skill status` dice qué copia lee Hermes (cli-base 0.59.0).** El comando añade `~/.agents/skills` a `skills.external_dirs` de Hermes con `hermes config set`, sin tocar las carpetas ya escritas, y si eso no funciona, copia el archivo a la carpeta personal de Hermes. Si Hermes no está instalado, el comando falla con `not_found` y no escribe nada. `max skill install` sin más y `--for all` siguen escribiendo solo las copias para Claude Code y `~/.agents/skills`. En `skill status --json` aparece `hermes` junto a `targets`.
- **Una ejecución iniciada por OpenClaw o Hermes Agent nombra a ese agente (cli-core 0.437.0).** En `runs show`, un comando que ejecutó el agente de OpenClaw tiene `agent` igual a `openclaw`, y si lo inició un mensaje de un chat, también `from_chat: true`; una ejecución de Hermes tiene su sesión, así que una tarea tomada por Hermes la retiene una sola sesión.
- **Nuevo ajuste `record_input` (cli-core 0.439.0).** `max personal config set record_input false` oculta en los registros de ejecución lo que escribiste; `config set` y `config show` lo muestran.
- **El skill `max-cli` declara a OpenClaw y ClawHub que necesita el programa `max` y cómo instalarlo** (`metadata.openclaw`: `requires.bins` y el paquete npm `@wirecat/max-cli`). Si `max` no está en el PATH, OpenClaw marca el skill como no listo y propone instalar el paquete. Claude Code y Codex no leen este bloque.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-19]

- **El registro de ejecución guarda la línea de comandos tal como la escribiste (cli-core 0.439.0).** En `argv` de `run.json` y en `runs show` ahora se ven el nombre del chat, la consulta de búsqueda y el texto del mensaje; antes aparecía `[redacted]` en su lugar. Los secretos siempre se ocultan: valores de opciones como `--token` y `--password`, la contraseña en una dirección, una cadena larga que parece una clave, el cuerpo de `bot api … --body`, un número de teléfono escrito después de `contacts lookup`. Por qué: el registro debe mostrar qué se ejecutó exactamente. Qué tener en cuenta: `max personal config set record_input false` devuelve la ocultación anterior para un perfil, `max config set record_input false --defaults`, para todos; un script o una comprobación que espere solo `[redacted]` en `argv` verá las palabras escritas. `doctor reports create` sigue ocultándolas en el informe.

### Seguridad [#seguridad-2]

- **La primera palabra que no puede ser un perfil no llega al registro de ejecución (cli-core 0.438.0).** Antes, esa ejecución la guardaba como `profile`, aunque podía ser el texto de un mensaje o el nombre de una persona.
- **Un error que cita `--token=…` o `password=…` ya no guarda el valor (cli-core 0.439.0).**

### Corregido [#corregido-20]

- **El skill `max-cli` ya no propone al agente `npx @wirecat/max-cli` si no encuentra `max`.** Ejecuta el `max` ya instalado por su ruta completa: `"$(npm prefix -g)/bin/max" personal doctor` o `"$(pnpm bin -g)/max" personal doctor`. Por qué: `npx` descarga código, y los catálogos de plugins pueden prohibir esa ejecución; normalmente `max` está instalado, pero no está en el PATH del agente. Los agentes leen el skill con `max skill show`.

## 0.78.0 — 26.10.2026 [#0780--26102026]

### Corregido [#corregido-21]

- **`max` se presenta como el cliente web actual de MAX: `appVersion` 26.10.7 y Chrome 154** (antes 26.9.8 y Chrome 151,
  leído el 25.09). MAX rechaza las versiones de cliente que ya no admite; `max doctor` muestra la fecha
  2026-10-26.
- **`npx skills add WireCatLabs/max-cli` ofrece solo el skill `max-cli`.** Antes también mostraba cuatro skills para desarrolladores de max (`add-command`, `parity-audit`, `release`, `test-live`): estaban en `.claude/skills`, y skills.sh también busca skills ahí. Ahora están en `docs/dev/skills`.
- **Un vector se elimina en cuanto ningún texto de la base lo usa** (cli-core 0.435.0). Antes, tras cambiar
  la imagen de una foto, cambiar el texto de la transcripción de una reunión o limpiar un chat (`store clear --left`, la fusión de un chat con
  otro), los vectores se quedaban. `conversations embeddings clear --chat` ahora quita también los vectores de los mensajes del chat, no
  solo los de sus conversaciones; `conversations embed --chat` los vuelve a crear.
  Qué tener en cuenta: `store rebuild` elimina los vectores que quedaron de versiones anteriores e informa su número en
  `unused_vectors_dropped`; `store check` los cuenta en `vectors.unused`.
- **La instalación tiene una sola copia de sherpa-onnx, no dos** (cli-core 0.433.0). En 0.77.0, max pasó a sherpa-onnx 2.0
  antes que cli-core, y la instalación creció unos 15 MB; ahora cli-core también usa 2.0. Los comandos y su salida no cambian.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-20]

- **La base común pasa a la versión 34: los CLI con cli-core 0.433.0 o anterior ya no la abrirán** (cli-core 0.434.0).
  La búsqueda por significado toma los candidatos del índice sqlite-vec de la base, en lugar de recorrer todos los vectores; la respuesta es la misma que la del
  recorrido. La primera apertura de la base con esta versión construye el índice con los vectores ya guardados, en porciones cortas.
  Por qué: recorrer todos los vectores es más lento con cada mensaje que tiene vector.
  Qué tener en cuenta: actualiza junto con max todos los CLI que leen la misma base (tg, wa, memo, zm, drive); los antiguos la rechazarán
  y pedirán actualizarse. La extensión forma parte de la instalación (`@wirecat/cli-core-sqlite` 1.1.0); si no
  se cargó, el comando que necesita la base termina con el error `store.vector-extension-missing` o
  `store.vector-extension-failed`: reinstala max. `store check` muestra `vector_indexes` y no pasa
  `checks.vector_indexes` cuando el índice no coincide con los vectores.
- **La ayuda de `max upgrade` muestra solo el ejemplo `max upgrade --check`** (cli-core 0.433.0).
  Por qué: el ejemplo `max upgrade` sin opción, copiado y ejecutado, actualizaba el programa de inmediato.
  Qué tener en cuenta: en la salida de `max upgrade --help` y `max commands --json` solo cambia esa línea.
- **El modelo de Anthropic recibe la clave en la cabecera `Authorization: Bearer`, no en `X-Api-Key`** (cli-core 0.433.0,
  `@anthropic-ai/sdk` 1.3).
  Por qué: así envía la clave la nueva versión de la biblioteca de Anthropic.
  Qué tener en cuenta: afecta solo a `models.<назначение>.base_url` con el proveedor `anthropic`, es decir, a una pasarela propia en lugar de
  la dirección de Anthropic: esa pasarela debe leer la clave de `Authorization`.

### Novedades [#novedades-23]

- **`search messages --discover` reordena los primeros 50 resultados con un modelo reordenador cuando está descargado**
  (`max models download mmarco`, 136 MB; cli-core 0.435.0). El modelo lee la pregunta junto con cada resultado, su chat,
  autor, fecha y el mensaje al que responde; su puntuación se mezcla con la de la búsqueda, y los demás resultados
  mantienen su orden. Cada resultado reordenado tiene `discovery.reranker_score`, y `score` sigue siendo
  la puntuación de la búsqueda. Sin el modelo el orden es el de antes, y la búsqueda lo dice: la nota `not reranked: …` en el terminal,
  `missing`/`next` (`models.download`) en `--json` y MCP. El reordenamiento tiene 15 segundos además de la búsqueda por palabras;
  si no le da tiempo, los resultados quedan sin él. El nuevo ajuste de perfil `search_reranker` elige `bge-reranker-v2-m3`
  (588 MB) o desactiva el reordenamiento (`off`). Nada se descarga solo, y el texto no sale del equipo.
  `models list` muestra los reordenadores con el tipo `reranker`.
- **`search all` también busca mensajes por significado**, cuando el modelo e5-small está descargado y los mensajes tienen vectores (cli-core
  0.435.0). Las coincidencias por palabras y por significado se combinan en una lista de mensajes, y `foundBy` de cada uno dice qué
  búsqueda lo encontró. Una consulta con NOT o con un filtro dentro de OR y grupos, así como `--exact` y `--backend server`, buscan
  solo por palabras. Sin modelo o sin vectores, `search all` busca por palabras como antes y dice por qué: la nota
  `messages: meaning search not used: …`, `missing`/`next` en `--json` y MCP.

## 0.77.0 — 25.10.2026 [#0770--25102026]

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-21]

- **El reconocimiento de mensajes de voz funciona con sherpa-onnx 2.0, y la instalación creció unos 15 MB.**
  Antes max y cli-core usaban una sola copia de sherpa-onnx 1.13.8.
  Por qué: todas las dependencias se actualizaron a sus últimas versiones; en 2.0 solo se quitaron partes de síntesis de voz,
  el reconocimiento funciona como antes.
  Qué tener en cuenta: hasta que cli-core pase a sherpa-onnx 2.0, la instalación tiene dos copias de este paquete.
  Los comandos y su salida no cambian. `string-width` y `wrap-ansi`, que no se usaban, ya no se instalan
  con max; si tu script los cargaba desde la instalación de max, instálalos aparte.
- **Una ejecución de un comando `bot` que falló nombra la llamada de la Bot API en la que ocurrió.** En `runs show` y `runs list`, `error.http` tiene junto al código HTTP `method` y `endpoint_template`, por ejemplo `{ "method": "GET", "endpoint_template": "/chats/:id", "status": 403 }`; antes solo había el código.
  Por qué: con el código solo no se ve cuál de las llamadas del comando falló.
  Qué tener en cuenta: los id de chat, usuario y mensaje en la ruta se escriben como `:id`, el token de vídeo como `:token`, y los parámetros de la consulta no entran en la plantilla, así que los id y el token reales no llegan al registro. Los mismos dos campos están en las solicitudes del bot en `--trace` y en el registro de ejecución, y la línea de `--trace` los muestra tras el nombre de la operación (`← getMyInfo  GET /me  200 …`). Un script que analiza el texto de `--trace` verá una columna más.

### Novedades [#novedades-24]

- **`store reset --dry-run` enumera lo que vaciaría el reinicio y no borra nada** (cli-core 0.429.0): los archivos de la base y su tamaño, cada tabla con datos y su número de filas, si se hará antes una copia y si serve u otro proceso tiene el archivo abierto.
- **`search messages --discover` también encuentra mensajes cercanos por significado**, cuando el modelo e5-small está descargado y `conversations rebuild` dio a los mensajes sus propios vectores (cli-core 0.432.0). En cada resultado, `discovery.found_by` dice qué búsqueda lo encontró. Hasta entonces la búsqueda es por palabras, como antes, y explica por qué. Nada se descarga, y el texto no sale del equipo.

### Corregido [#corregido-22]

- **Un `--version` sin más responde antes de cargar el programa**: el bin se inicia con `@wirecat/cli-core/cli/start` (cli-core 0.429.0).

## 0.76.0 — 25.10.2026 [#0760--25102026]

### Corregido [#corregido-23]

- **Un fallo a mitad de un comando ahora se informa como cualquier otro error.** En lugar de una traza de pila de Node, se imprime un error `internal_error` (`command.crashed`): una línea en el terminal y un objeto JSON de error en los demás casos; el código de salida sigue siendo 1.
  Por qué: la traza no le dice nada a un script y puede mostrar en pantalla texto que no debe estar ahí.
  Qué tener en cuenta: si un script analizaba la traza en stderr, que lea el objeto de error.

### Novedades [#novedades-25]

- **`max doctor --json` enumera todos los errores del archivo de ajustes en `config.issues` (cli-core 0.423.0).** Cada error es `{ kind, file, profile?, key?, line?, column?, what, fix? }`; `kind` es `invalid_json`, `unknown_setting`, `unknown_permission`, `missing_setting` o `invalid_value`. Si el JSON no es válido, `line` y `column` indican dónde se detuvo el análisis; en los demás casos, `fix` es un comando `config unset` que quita la clave y se ejecuta tal como está escrito. El valor del ajuste no aparece en la respuesta. Con errores en el archivo, `doctor` responde y termina con el código `0`, y sin nombre de perfil responde con `profile: null`.
- **`config show` funciona con un archivo que tiene errores y nombra cada uno con el comando que lo quita.** `config unset` también elimina una clave que ningún esquema conoce, incluso en la raíz del archivo (`max config unset <clave>`).
- **`max skill status` y `max skill show --for claude|agents` (cli-core 0.427.0).** `status` dice si el SKILL.md instalado coincide con esta versión; `show --for` imprime la copia instalada.
- **`max store tables list` enumera las tablas del archivo común, y `store info` muestra más datos del archivo (cli-core 0.427.0).**
- **El registro de una ejecución dice quién la inició y qué salió mal (cli-core 0.425.0).** En `run.json`, `runs list`, `runs show` y `search runs` aparecen `cli_command`, `argv` (el contenido y los secretos son `[redacted]`), `agent` y, para una ejecución fallida, `error`.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-22]

- **`npm install -g` elige el agente para el skill solo según `MAX_INSTALL_AGENT`.** `TG_INSTALL_AGENT` ya no se lee.
- **La respuesta de `doctor` tiene la lista `config.issues` en lugar de la cadena `config.error`.** Si los ajustes no se pudieron resolver por un bloqueo del perfil, una opción o una variable de entorno, el mensaje está en `settings.error`.
- **Los nombres antiguos de ajustes ya no se reconocen.** `default_profile`, `analysis_provider`, `analysis_model`, `analysis_base_url` con las variables `MAX_ANALYSIS_*` y los nombres en camelCase (`sendsPerHour` y otros) son ajustes desconocidos como cualquier otro: el comando se niega y nombra el `config unset` que quita la clave. El modelo de análisis se configura en `models.analysis.provider`, `models.analysis.model` y `models.analysis.base_url`.
- **`messages sync` y `bot messages sync` se comprueban con sus propias claves `messages.sync` y `bot.messages.sync` (cli-core 0.421.0).** Un nivel en `messages` o `bot.messages` sigue aplicándose a ellos, y una denegación escrita directamente en `messages.sync` o `bot.messages.sync` ahora detiene el comando. Los comandos del bot comprueban la denegación de lectura antes de conectarse.
- **Una clave de permiso guardada que ningún comando comprueba detiene tanto los comandos del bot como `--dry-run`.** El error nombra la clave y el `config unset` que la quita; `config show`, `set` y `unset` funcionan para que se pueda reparar el archivo.
- **Los nombres antiguos de comandos reciben la respuesta habitual «unknown command», sin pista.** `max personal search mail` ya no nombra memo: el correo lo busca `memo search mail`.
- **Una ejecución sin perfil nombrado se registra sin `profile`, no con `"profile": "default"` (cli-core 0.424.0).**
- **En el registro de una ejecución, la pila de un comando fallido empieza por el nombre del paquete y no tiene líneas de Node (cli-core 0.425.0).** Una línea de la pila es `MaxClient.connect @wirecat/max-cli/client.js:1497`, no `client.js:1497`; ya no hay líneas `node:internal`.
- **`config set` escribe `config.json` con permisos `0600`, no `0644` (cli-base 0.57.0).** El archivo contiene los perfiles, cuentas y rutas del propietario. Un programa que lee los ajustes como otro usuario no podrá leerlos después del siguiente `config set`.

### Seguridad [#seguridad-3]

- **`max doctor` nombra `config.json` y su carpeta si otros usuarios pueden leerlos, y el comando `chmod` que lo corrige.** En `--json` es `files`: `{ checked, ok, problems: [{ path, mode, want }] }`; el archivo debe ser `0600` y la carpeta `0700`. Por cada problema, stderr recibe una línea `to make it private: chmod 600 '<ruta>'`; `doctor` no cambia los permisos. La carpeta se comprueba también cuando la fija `MAX_CONFIG_DIR`. El bloque está presente sin nombre de perfil y cuando los ajustes no se resolvieron; también entra en el informe de `doctor reports create`. En Windows los permisos no se comprueban: `files` es `{ checked: false, reason }`.

## 0.75.0 — 25.10.2026 [#0750--25102026]

### Novedades [#novedades-26]

- `max --help` nombra `max account list`: la lista de perfiles y sus cuentas con sesión iniciada.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-23]

- **Los nombres antiguos de los permisos de estadísticas y búsqueda ya no se reconocen.** Antes, las claves `messages.stats`, `chats.stats`, `tasks.stats`, `messages.search`, `conversations.search` y `topics.search` detenían el comando con una pista para renombrarlas; ahora esa clave simplemente no tiene efecto, y una denegación guardada con el nombre antiguo ya no se aplica. Renómbralas a `stats.messages.show`, `stats.chats.show`, `stats.tasks.show`, `search.messages`, `search.conversations` y `search.topics`.
- **La base de datos común pasa a la versión 33 (cli-core 0.420.0).** Cuando esta versión abra la base, un CLI con un cli-core más antiguo se negará a trabajar con ella y pedirá actualizarse, así que actualiza juntos todos los CLI de WireCat que comparten la base.

## 0.74.0 — 25.10.2026 [#0740--25102026]

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-24]

- **`bot store fetch` ahora es `bot messages sync`; el grupo `bot store` ya no existe.** El comando hace lo mismo que el `messages sync` personal, así que ahora se llama igual; `store` es la base de datos local. El nombre antiguo responde con una pista que indica el nuevo. Si tus ajustes guardan `permissions.bot.store.fetch`, los comandos se niegan a ejecutarse hasta que la clave se renombre a `permissions.bot.messages.sync`.

## 0.73.0 — 25.10.2026 [#0730--25102026]

### Novedades [#novedades-27]

- **`chats requests confirm|reject <chat> --all` responde a todas las solicitudes de un canal a la vez.** Primero se comprueba el número de solicitudes con los permisos del perfil y el límite de acciones por hora; después se envía una sola petición a MAX. Úsalo solo en un canal donde todas las solicitudes pendientes deban recibir la misma respuesta. No se puede filtrar con `--link`: la interfaz actual de MAX no indica por qué enlace llegó la solicitud.

- Las listas de miembros, comentarios y destinatarios permitidos del bot aceptan una consulta por campos. Los identificadores de miembros y comentarios se pasan a la Bot API antes de aplicar el límite de página; la lista de destinatarios se filtra al leerla y no cambia los permisos de envío. Un comentario también muestra su `id` de texto cuando la API lo envió en `body.mid`.

### Correcciones [#correcciones]

- **`watch --jsonl` imprime registros `item` y un `end` final.** Un fallo del origen termina el flujo con un resumen incompleto; `--json` se niega antes de suscribirse. La lista de destinatarios permitidos usa la consulta nativa común.
- **El archivado ya no se detiene ante un evento de llamada junto a un archivo.** El archivo se guarda y se verifica su suma de comprobación; los mensajes que solo contienen una llamada no requieren descarga.
- **El informe de diagnóstico usa el módulo común de WireCat.** Se mantienen el formato de MAX y los campos técnicos de los eventos; el contenido de los mensajes se excluye y los identificadores reciben etiquetas dentro del informe.

- **Una denegación de permisos no oculta el comando.** Los catálogos de la CLI y de MCP conservan los comandos y muestran su disponibilidad actual con el motivo de la denegación; la llamada sigue comprobando los permisos. El MCP del bot también muestra los comandos de configuración dentro del perfil del bot.
- **El cambio de ajustes usa la implementación común de WireCat.** `config set|unset` mantiene el formato de respuesta, los ajustes de MAX y los límites de permisos; el módulo común comprueba y escribe el archivo.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-25]

- **Una segunda dirección de webhook se añade con `--append`.** `--add <chat>` sigue siendo la opción para cambiar carpetas. La composición desconocida de un chat y la lista de tipos de webhook ahora se omiten en lugar de ser `null`.

- **Los contratos comunes de los comandos no pueden cambiar en silencio.** `commands info --json` muestra las definiciones de origen, los esquemas, los motivos de error y las diferencias explícitas de MAX. Los eventos de contacto usan `at:` y `scope:` en lugar de opciones de tiempo y ámbito, y los registros de diagnóstico usan `started_at:`.

### Seguridad [#seguridad-4]

- **La resolución de dependencias excluye las versiones vulnerables de Vite.** Las dependencias de producción se comprueban tanto en la resolución guardada como en una nueva.

## 0.72.0 — 24.10.2026 [#0720--24102026]

### Novedades [#novedades-28]

- **Tras iniciar sesión, `max serve` realiza más peticiones de las que hace web.max.ru:** fichas y estado en línea de contactos de chats personales; tras el primer inicio, también historias para la lista, chats que faltan en carpetas y la siguiente página de chats. Reduce las diferencias respecto al cliente web, aunque MAX aún puede distinguir la herramienta. Son lecturas cuyas respuestas no se muestran. No se suscribe a notificaciones push ([peticiones de red](/llms.mdx/docs/es/max/security/content.md#%D1%87%D1%82%D0%BE-%D1%83%D1%85%D0%BE%D0%B4%D0%B8%D1%82-%D0%B2-%D1%81%D0%B5%D1%82%D1%8C)).

- **El primer inicio normal de `max` en el terminal hace tres preguntas comunes:** idiomas de búsqueda, instalación de otras herramientas WireCat y permiso para hacer cambios. Elegir solo lectura limita todos los perfiles, incluido MCP, incluso con un `allow` más específico. No pregunta a agentes, tuberías, modo JSON ni CI. Cambia las respuestas con `max setup`.

### Cambios que pueden afectar a scripts [#cambios-que-pueden-afectar-a-scripts]

- **Los comandos comunes adoptan nombres canónicos; se eliminan los anteriores** (cli-core 0.406.0): `contacts profile` → `contacts info`, `contacts timeline` → `contacts events`, `contacts alias` → `contacts aliases`, `chats link` → `chats links`, `metadata refresh` → `metadata sync`, `store reindex` → `store rebuild`, `commands schema` → `commands info`, `stats messages counters refresh` → `stats messages counters sync`, `models text key` → `models keys`, `models audio list` → `models list kind:audio`, `doctor report` → `doctor reports show`. El comando antiguo se niega a ejecutarse e indica el nuevo; también se eliminan los alias ocultos de opciones. Actualiza scripts, horarios y llamadas MCP guardadas. Una ruta de permisos antigua como `permissions.metadata.refresh` detiene la ejecución con `configuration_error` e indica la nueva.
- **`max <profile> watch --json` emite registros `{ "type": "item", "data": … }` y uno final `{ "type": "end" }`** (cli-core 0.400.0). Los campos de mensajes y eventos usan snake_case y valores canónicos con referencias. La parada normal y el tiempo agotado producen un `end` completo; un fallo del origen, uno incompleto y un código de error. Actualiza los lectores de las antiguas líneas sin envoltura.
- **La búsqueda de ejecuciones es `max <profile> search runs` (`search runs`), en lugar de `runs search`.** Escribe `status:`, `error_code:`, `operation:` y `profile:` en la consulta: `search runs status:failed error_code:timeout`. No hay alias; migra las peticiones MCP guardadas.
- **Las estadísticas seleccionan filas mediante términos de consulta.** Sustituye `--chat` y `--exact` por `chat:` y `exact:`; los rankings usan `message_kind:` y `min_messages:`, las discusiones `min_views:` y `max_replies:`, las preguntas sin respuesta `older_than:`. Actualiza CLI y MCP; `--source` y `--timezone` siguen siendo opciones.
- **Los comandos que cambian lo que podrán hacer futuras ejecuciones requieren `permissions.mcp.authority: allow` o `ask` en MCP**, con `deny` por defecto: `config set|unset`, `recipients add|remove|clear`, `replies …`, `schedule command|agent|remove`, `skill install`, `flood clear`, claves de modelos y operaciones similares. El agente no puede cambiar esta clave mediante `config set`. Consulta [qué no ofrece MCP](/llms.mdx/docs/es/max/mcp/content.md#%D1%87%D0%B5%D0%B3%D0%BE-%D0%BD%D0%B5%D1%82-%D0%B2-mcp).

- **El mantenimiento del archivo, el control del servidor, la descarga de modelos y la creación de informes están disponibles mediante MCP.** Tienen claves propias como `store.backup`, `server.start`, `models.download`, `doctor.reports.create`, con `ask` por defecto. Revisa los permisos si el agente debe limitarse a leer: MCP permite una escritura solicitada con `ask` sin formulario de confirmación.
- **`bot api` requiere un `permissions.bot.api: allow` o `ask` explícito para el agente.** El valor predeterminado es `deny`; un `bot: allow` general no lo habilita. El agente no puede cambiar `mcp` ni `bot.api` en los ajustes ni sustituir todo `permissions`; puede cambiar otras claves individuales si lo permite `mcp.authority`. En max se mantienen las comprobaciones de permisos, destinatarios y registro de escrituras.
- **Lee pares de tareas similares mediante `tasks duplicates list [query...]`.** El grupo `tasks duplicates` ya no muestra la lista. Migra las llamadas CLI y MCP guardadas al `list` explícito.
- **`events list` devuelve fechas ISO 8601 e identificadores de texto.** `starts_at`, `ends_at`, `deleted_at`, `created_at`, `updated_at` dejan de ser números de milisegundos; `id` y `event_series_id` dejan de ser números. Actualiza los lectores JSON que dependían de esos tipos.

- **`doctor reports create` comprueba los permisos antes de crear un archivo.** Una configuración inválida devuelve el código 3 porque no se puede comprobar el permiso de escritura. Lee el motivo con `doctor` y corrige primero el ajuste. Con una configuración válida, la creación segura de informes también está disponible con `MAX_READ_ONLY`.

### Corregido [#corregido-24]

- **`attachments download` omite eventos de servicio y teclados integrados.** No contienen archivos; antes detenían la copia del chat con el código 13. Comprueba las copias existentes con `attachments check`; repetir la descarga las conserva.

## 0.71.0 — 23.10.2026 [#0710--23102026]

### Novedades [#novedades-29]

- **Las transcripciones de voz coinciden con formas de palabras y distorsiones del reconocimiento** (cli-core 0.396.0). `max <profile> search messages риелтор` encuentra tanto «риелтору» como «реелтора» en transcripciones. Un resultado encontrado solo por distorsión lleva `match: "corrected"` y `corrections`. No se amplían números, frases, `exact:` ni texto escrito. El texto que guarda un agente para un mensaje de voz también es una transcripción. El almacén migra a la versión 29 al iniciarse.
- **MCP ofrece más comandos dentro de los permisos del perfil** (cli-core 0.398.0): `config show`, `doctor report`, `runs list|show|path`, `store status|info|check|export|reindex`, `store jobs cancel|retry|clear`, `attachments move`, `attachments jobs status`, `commands schema`, `guide`, `skill show`, listas de modelos, `replies status|test|consents show`, `schedule list`, `server status|logs`; para bots, `list`, `chats leave`, `chats admins add|remove`, `commands set|clear`, `webhooks list|set|delete`. Consulta [qué no ofrece MCP](/llms.mdx/docs/es/max/mcp/content.md#%D1%87%D0%B5%D0%B3%D0%BE-%D0%BD%D0%B5%D1%82-%D0%B2-mcp) para las exclusiones y sus motivos. Son los nombres de esta versión histórica.
- **`max <profile> review --offline` responde desde el archivo local** en vez de negarse (cli-core 0.398.0). Solo muestra lo sincronizado y advierte de los datos ausentes (`missing` en JSON).
- **Copias de archivos verificadas.** `attachments download <dir>` guarda archivos disponibles de varios chats con tamaño y SHA-256; `attachments check <dir>` comprueba copias sin red. `attachments jobs` controla las copias diarias de Linux habilitadas explícitamente. Las copias completas sobreviven a interrupciones y al borrado del historial. `attachments move <dir> <archive-dir> --before-time <time>` mueve imágenes antiguas a otro archivo verificado y registra la nueva ubicación para comprobarlas y evitar descargas repetidas.

- La búsqueda de transcripciones guardadas encuentra formas de palabras y grafías distorsionadas por el reconocimiento. `text:` busca solo texto escrito; `exact:` desactiva la ampliación para esa palabra.

### Corregido [#corregido-25]

- **Los ejemplos de `--help` se pueden pegar y ejecutar:** `Example:` incluye el perfil `personal` (`max personal review "date>2h"`) en vez de fallar con «name a profile» (cli-core 0.398.0).
- Las búsquedas de reuniones guardadas ya no se muestran ni eliminan mediante comandos de búsqueda de mensajes.
- Las sugerencias de corrección mantienen el perfil elegido; la ayuda muestra descripciones breves y ejemplos.

### Cambios que pueden afectar a scripts [#cambios-que-pueden-afectar-a-scripts-1]

- En argumentos MCP, borrar mensajes acepta `message`, exportar chats acepta `chat` y las operaciones con tareas duplicadas aceptan `task` y, para un par, `other_task`. Actualiza peticiones guardadas con `messages`, `chats` o `dup`. El orden posicional de CLI no cambia.
- Los comandos de referencia `commands` y `commands schema` rechazan `--jsonl`: usa `--json` para un documento.

## 0.70.0 — 23.10.2026 [#0700--23102026]

### Novedades [#novedades-30]

- **`contacts prepare <person>` prepara un resumen antes de conversar** a partir de mensajes, tareas, hechos y notas guardados, con enlaces a fuentes. Es común con tg y wa y no conecta a MAX (cli-core 0.394.0).
- **La ayuda incluye ejemplos de invocación** de cli-core 0.394.0.

### Cambios que pueden afectar a scripts [#cambios-que-pueden-afectar-a-scripts-2]

- **Leer ya no marca chats como leídos.** `messages list` ya no acepta `--mark-read`; `inbox` y `review` ya no aceptan `--mark-read` ni `--no-mark-read`; `catch_up_marks_read` deja de ser válido. Envía una confirmación explícita con `chats mark-read`.
- **Las claves de permisos anidadas desconocidas se rechazan** como errores de configuración antes de conectar. Corrige la clave en vez de depender del antiguo aviso.

## 0.69.0 — 22.10.2026 [#0690--22102026]

### Novedades [#novedades-31]

- **Las respuestas JSON filtradas por fecha identifican la zona usada y el intervalo UTC** (cli-core 0.385.0): `meta.timezone` indica la zona si faltaba en la entrada; `meta.window` da los límites UTC `since` y `until`. Afecta a `stats chats show`, `stats chats retention`, `stats messages unanswered`, `stats messages discussion`, `stats contacts responses`, `stats chats newcomers`, `contacts context`, `search conversations`, `runs search`, `messages sync`, `store export`, `replies test`, y a `inbox`, `review`, `chats events`, `chats members history` con `time:` o `date:` en la consulta. Hace visible el intervalo elegido. Son campos nuevos y opcionales; los anteriores no cambian. `search conversations` interpreta una fecha sin hora en `--timezone` cuando se indica.
- **El JSON del chat incluye `muted_until`** (fin del silencio en UTC) **y `marked_unread`** (chat marcado sin leer), desde cli-core 0.382.0.

### Cambios que pueden afectar a scripts [#cambios-que-pueden-afectar-a-scripts-3]

- **`inbox` y `review` basados en el archivo omiten chats silenciados y archivados** (cli-core 0.382.0). El archivo guarda esas marcas de MAX y sus resultados coinciden con MAX. Usa `chats list` si un script esperaba esos chats en la bandeja.
- **Un almacén sin permiso de escritura devuelve `permission_error`, código 5 y motivo `store.not-writable`** (cli-core 0.381.0), en lugar de `internal_error` con «this is a bug». Actualiza los scripts que gestionaban el antiguo código.

### Corregido [#corregido-26]

- **Los nombres copiados con emojis encuentran el chat o persona** (cli-core 0.381.0). Un emoji copiado puede contener un selector invisible ausente al escribirlo; antes «Семья❤️» no encontraba «Семья❤».

## 0.68.0 — 22.10.2026 [#0680--22102026]

### Cambios que pueden afectar a scripts [#cambios-que-pueden-afectar-a-scripts-4]

- **Las fechas y horas sin zona en `--since-time`, `--until-time`, `--at-time` y `chats mute --until` usan la zona del ordenador; una fecha sola significa medianoche local** (cli-core 0.379.0, cli-base 0.48.0). Antes `2026-09-01` significaba medianoche UTC. Una zona explícita (`…Z`, `+02:00`) sigue prevaleciendo; `--timezone` del comando prevalece sobre la del ordenador. Un límite superior sin hora incluye todo el día local. Así se respeta el día del propietario. Los scripts que esperen UTC deben indicarlo, por ejemplo `2026-09-01T00:00:00Z`; las horas JSON siguen en UTC con `Z`.
- **`stats chats retention` y `chats stats show` interpretan `--since-time` y `--until-time` en `--timezone`**; el límite superior de retención sin hora incluye el día local completo (cli-core 0.380.0). `stats charts`, `contacts timeline` y MCP `stats` identifican la zona en `meta.timezone` y el intervalo UTC en `meta.window`.

### Corregido [#corregido-27]

- **`max watch` muestra las horas de mensajes en la zona del ordenador**, anunciada como `times in <пояс>` antes del primer mensaje. Antes no se indicaba. Las líneas `--jsonl` no cambian en esta versión.
- **`max doctor` y los rechazos de inicio tras demasiados intentos muestran horas como `2026-10-21 16:03 Europe/Madrid`**, en lugar de la forma UTC `2026-10-21T14:03:00.000Z`, fácil de confundir con hora local. `max doctor --json` mantiene UTC.

## 0.67.0 — 21.10.2026 [#0670--21102026]

### Corregido [#corregido-28]

- **Un llavero Linux bloqueado o no disponible avisa y recurre al archivo de credenciales** (cli-base 0.47.5). El llavero se lee solo mediante Secret Service. Antes un fallo podía guardar silenciosamente en memoria del núcleo, que se pierde al cerrar sesión o reiniciar.

## 0.66.0 — 20.10.2026 [#0660--20102026]

### Novedades [#novedades-32]

- **El almacén guarda el historial de un chat (versión 25 del almacén, cli-core 0.366.0).** Un cambio de id, título,
  pertenencia o visibilidad de un chat se escribe en `chat_revisions` con el valor anterior y el nuevo; una lectura por
  el id antiguo de un chat que recibió uno nuevo lo encuentra. El almacén pasa a la versión 25 al abrirse por primera
  vez; no se envía nada.

### Correcciones [#correcciones-1]

- **Un chat que abandonaste se encuentra por cualquiera de sus ids** (cli-core 0.368.0): `store export`,
  `store status`, `messages
  thread`, `--chat` y `chat:` en la búsqueda, etiquetas, tareas y las demás lecturas de su historial guardado. `chats track` y `store gaps plan` rechazan un chat abandonado: «you left chat <id>».
- **`max guide catch-up` y la primera pantalla de `max --help` ponen el filtro entre comillas: `max review 'date>1d' --unanswered 4h`.**
  Sin comillas, la shell leía `>` como una redirección: creaba un archivo llamado `1d` y `review` se ejecutaba sin el
  filtro. Con cli-core 0.370.0, la comprobación de escenarios en las pruebas detecta esos caracteres fuera de comillas.
- **«Works with» escribe el título del escenario de memo igual que memo y las demás herramientas:** «One person across
  every tool», con mayúscula.

## 0.65.0 — 19.10.2026 [#0650--19102026]

### Novedades [#novedades-33]

- **`store clear --left` nombra los chats que elimina** (cli-core 0.353.0–0.362.0). El rechazo sin
  `--allow-dangerous` enumera los primeros 20 por id, título y número de mensajes; el nuevo `--dry-run` los muestra
  todos en `left` y no elimina nada; la respuesta tras eliminar también incluye `left`.

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts]

- **Sin terminal, `session start qr` y `setup` imprimen el código QR como texto, y `--qr-file` desaparece.** El
  propietario iniciaba sesión con un PNG que el agente abría en un visor de imágenes, una ventana aparte fácil de
  perder. Ahora el código va a stderr como texto plano (caracteres `█▀▄`, sin color, legible en un tema oscuro) y el
  agente lo pega en el chat como bloque de código. Con `--json` el código también es una línea
  `{"event":"qr","qr":{"text","expires_at","scan"}}` en stderr. En una terminal el código se dibuja como antes. Un
  script con `--qr-file` recibe ahora un error de opción desconocida. Cómo inicia sesión un agente:
  [sessions.md](/llms.mdx/docs/es/max/sessions/content.md#%D0%B2%D1%85%D0%BE%D0%B4-%D1%87%D0%B5%D1%80%D0%B5%D0%B7-%D0%B0%D0%B3%D0%B5%D0%BD%D1%82%D0%B0).

### Correcciones [#correcciones-2]

- **Un chat al que el propietario volvió ya no queda marcado como «abandonado»** (cli-core 0.352.0). Una lista de
  chats incompleta y el inicio de sesión quitan esa marca de los chats que nombran; «archivado» y otros estados se
  mantienen. Antes, ese chat podía desaparecer de `max chats list`, y `store clear --left` lo eliminaba con sus
  mensajes. Una lista completa sigue marcando como «abandonados» los chats que no contiene.

## 0.64.0 — 19.10.2026 [#0640--19102026]

### Novedades [#novedades-34]

- **`session start qr --qr-file <png>` y `setup --qr-file <png>`**, como en tg y wa: el código QR se escribe en un PNG
  para el agente, sin terminal. El archivo se crea desde el principio con modo `0600` y se elimina tras el acceso. El
  acceso por QR pasa ahora por `loginQr` de cli-core 0.347.0, uno para los tres CLI.
- **El siguiente paso en la salida `--json` y en un error incluye `line`, el comando completo con el perfil**
  (cli-core 0.348.0): `"line": "max personal mcp config"` junto a `"command": "mcp config"`. Un `command` copiado
  solo fallaba con «name a profile». `command` no cambia; las respuestas MCP no tienen `line`.

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-1]

- **Una terminal estrecha ya no abre el código QR en un navegador.** El código no se dibuja y `max` indica ensanchar
  la ventana o pasar `--qr-file`. Por qué: el acceso por QR es ahora común a tg, max y wa, y un navegador que se abre
  solo no se podía llevar a cli-core para los tres. MAX emite un código por ejecución, así que en una ventana
  estrecha no hay nada que esperar: interrumpe el comando y ejecútalo de nuevo más ancho o con `--qr-file`.
- Sin terminal, `session start qr` y `setup` responden igual que tg y wa: «shows a QR code to scan — run it in a
  terminal, or pass --qr-file <png>».

### Correcciones [#correcciones-3]

- **El paso de acceso en `setup` se llama «Link this device»** y ya no pide escanear un código QR antes de
  dibujarlo. La línea bajo el propio código dice dónde escanear; en una terminal estrecha, solo la sugerencia de
  ensancharla.
- **Una terminal estrecha ya no pide escanear un código QR que no está** (cli-core 0.350.0). `session start qr` y
  `setup` escribían «scan this code with the MAX app on your phone» antes del código; si el código no cabía, solo
  seguía la sugerencia de ensanchar la ventana o pasar `--qr-file`. Ahora la línea «scan in the MAX app on your phone»
  va tras el código dibujado o la nota sobre `--qr-file`, y una terminal estrecha muestra solo la sugerencia.
- **Las sugerencias en errores y notas nombran el perfil**: «the store is behind this build — `max personal store
  migrate`» en lugar de `max store migrate`, que al copiarse fallaba con «name a profile». Lo mismo con la
  sugerencia para descargar el modelo de voz: `max personal models audio download gigaam-v3`.

## 0.63.0 — 19.10.2026 [#0630--19102026]

### Novedades [#novedades-35]

- **`max --help` y `max` sin comando muestran una primera pantalla corta** (cli-core 0.345.0): qué sabe hacer max,
  las otras herramientas de WireCat y adónde ir después — `max commands`, `max guide`, `max help options`,
  `max skill show`. Ya no imprime la lista completa de comandos ni todas las opciones generales.
- **`max guide` — escenarios: qué comandos ejecutar, en orden, para una tarea frecuente.** Cuatro escenarios:
  `catch-up` (ponerse al día con lo acumulado), `find-what-was-said` (encontrar lo que alguien escribió),
  `agent-on-a-timer` (un agente programado que no puede enviar) y `post-as-a-bot` (escribir en nombre de un bot).
  `max guide <имя>` imprime los pasos, `--json` lo mismo como datos. El escenario `memo guide person-brief`
  aparece en la sección «Works with».
- **`max help options`** imprime las opciones de todos los comandos, **`max --help-all`** la ayuda completa de antes.
- **`max commands` sin `--json` imprime la lista de comandos por secciones** (Read, Write, Organise, Automate,
  Set up), una línea por comando; `max commands <путь>` la acota.
- **La ayuda de cada comando termina con las líneas Returns, Next usually y Example**, y las mismas líneas están en
  la [referencia de comandos](/llms.mdx/docs/es/max/commands/content.md).

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-2]

- **`npm install -g` ya no instala por sí solo la habilidad del agente.** Escribía sin avisar en `~/.claude/skills` y
  `~/.agents/skills`, y npm oculta la salida del script de instalación. Ahora la habilidad la instala
  `max <профиль> setup` o `max skill install --for all`; `MAX_INSTALL_AGENT=all` (o el nombre de un agente) durante
  la instalación la instala en el acto, como antes. El instalador de Windows pasa `all` él mismo y se comporta como
  antes.
- **`max --help` ya no enumera los comandos ni las opciones generales.** Un script que los buscaba ahí necesita
  `max --help-all` o `max help options`.
- **`max commands` sin `--json` imprime texto, incluso hacia una tubería.** Antes imprimía el documento JSON completo
  (cientos de kilobytes); un script que lo analizaba tiene que añadir `--json`.
- **Una errata en una opción de una lista con consulta es un error de opción desconocida** (`unknown option '--limt' (Did you mean
  --limit?)`), no una palabra de la consulta. Una negación como `-kind:channel` sigue siendo parte de
  la consulta.

### Correcciones [#correcciones-4]

- **`inbox` y `review` declaran su salida** (cli-core 0.345.0): `max commands schema inbox` da los campos del
  resumen del mensaje, y `--json=<поля>` con un nombre que no tiene se rechaza con la lista de campos en lugar de
  devolver registros vacíos.
- **`--brief` y `--full` ya no mencionan el correo** en la ayuda de max.
- **Una errata en el nombre del perfil ya no crea un perfil.** `max typoprofile chats list` se negaba, pero dejaba
  el archivo `profiles/typoprofile.json`, y después el error «name a profile» y `max complete` ofrecían
  `typoprofile` como perfil de este equipo. Ahora el archivo solo aparece al iniciar sesión; `session end` con un
  nombre así tampoco lo crea. Los archivos que quedaron de erratas anteriores se pueden borrar de
  `~/.local/share/max-cli/profiles/`.
- **`max <профиль> doctor` sin token aconseja `max <профиль> setup`**, como el README y el error «no session», y no
  `session start`.

### Seguridad [#seguridad-5]

- **La prohibición de escribir actúa antes de conectarse a MAX** (cli-core). Con `MAX_READ_ONLY=1` o con el nivel
  `readonly` o `deny`, `messages send`, `messages edit`, `messages delete --for-everyone`, `reactions add` y otras
  escrituras primero se conectaban a MAX y solo después recibían la negativa; con el inicio de sesión roto salían con
  el código `10`. Ahora es el código `5`, sin conexión, como promete la [página de seguridad](/llms.mdx/docs/es/max/security/content.md). La
  negativa queda en `sends list` como una línea corta: la clave del comando y el tipo, y el chat solo si se indicó
  su id.
- **`--dry-run` con `MAX_READ_ONLY` ya no responde «se puede»** a una escritura que la ejecución real prohibiría.
- **`max mcp` con `MAX_READ_ONLY` no ofrece escrituras en MAX**, y la llamada a un comando así mediante `max_write`
  recibe la negativa de la prohibición, no «no existe ese comando».

## 0.62.0 — 18.10.2026 [#0620--18102026]

### Novedades [#novedades-36]

- **Por `max mcp` el agente recibe todos los comandos que permiten los niveles del perfil** (cli-core 0.341.0). Antes
  el servidor ofrecía 141 herramientas escritas a mano; ahora las herramientas se construyen a partir de los propios
  comandos, y el agente dispone de 181 comandos, entre ellos `messages sync`, `contacts sync`, `chats members fetch`,
  `chats tracking add/remove`, `contacts link/unlink`, `mentions confirm/reject/rebuild`, `conversations embed`,
  `images embed`, `tasks reject`, `contacts import`, `account privacy set` y `chats app`. Lo que el agente no puede
  hacer lo deciden los niveles del perfil: pon `readonly` o `deny` en el área que quieras. La lista completa está
  fijada en `contracts/mcp-catalogue.json`.
- **`conversations rebuild`** vuelve a construir las conversaciones de los chats que cambiaron y calcula sus vectores
  con el modelo de este equipo; no consulta a MAX, no descarga ningún modelo y no envía texto a ninguna parte.
  Sustituye a la herramienta de agente `conversations_refresh`.

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-3]

- **Los argumentos de las herramientas de `max mcp` se llaman como las opciones de los comandos**, en snake_case:
  `chat`, `limit`, `query`, `sync_first`, etc. Un agente que recordaba los nombres antiguos tiene que volver a
  consultar `max_tools_search`.
- **`search messages` de un agente ya no acepta la consulta estructurada `ast`**: solo el texto de la consulta, como
  en la línea de comandos.
- **Un agente no puede marcar como leído ni actuar en nombre del propietario**: no se le ofrecen `--mark-read` en
  `messages list`, `inbox` y `review`, `--as-owner` ni `messages send --allow-any-file`, y el ajuste `catch_up_marks_read` no se
  aplica a sus ejecuciones. Sus puntos de control `--new` son distintos de los tuyos.

### Correcciones [#correcciones-5]

- **`max mcp` responde a todas las llamadas recibidas antes de que se cierre stdin**, en lugar de salir y abandonar
  la que seguía en curso. `max bot mcp` aún no lo hace.
- **`max tasks --help` ya no promete que `serve` abra tareas.** La ayuda decía "review and serve add
  them". Ahora dice que las tareas las abren `review`, `inbox` y `messages sync`, y `serve` solo las peticiones de
  las reglas de respuesta automática.
  Por qué: `serve` en MAX no revisa preguntas ni menciones al recibirlas. Quien mantenía `serve` en marcha y esperaba
  tareas veía la lista vacía hasta el siguiente `review` o `messages sync`.
  Qué tener en cuenta: el comportamiento no ha cambiado. Un `tasks list` vacío ahora dice lo mismo (cli-core 0.341.0).
- **`max mcp --help` sugiere `claude mcp add max -- max <profile> mcp`** (cli-core 0.341.0). La sugerencia anterior,
  sin perfil, siempre fallaba con "name a profile", y el agente recibía un servidor que no funcionaba.
- **En Node 22, los comandos que abren el archivo ya no imprimen `ExperimentalWarning: SQLite is an
  experimental feature`** (cli-core 0.341.0). Los agentes tomaban esas dos líneas de stderr por un error. Los demás
  avisos se imprimen como antes.
- **`tags remove` con un alias de etiqueta la quita igual que `tags add` la pone** (cli-core 0.341.0).
- **El arranque es un poco más rápido** (cli-base 0.45.0): las tablas de vocabulario y de reglas ya no se analizan en
  cada arranque, solo cuando se inicia el servidor para el agente.

### Seguridad [#seguridad-6]

- **`attachments extract --output-dir` rechaza las carpetas de claves, las carpetas del propio `max` y la carpeta del
  archivo** (cli-core 0.341.0), como ya hacía la herramienta del agente.

## 0.61.0 — 18.10.2026 [#0610--18102026]

### Novedades [#novedades-37]

- **`tasks agenda` muestra lo que otros te deben** (cli-core 0.328.0): las tareas abiertas que hace otra persona, en
  una sección aparte y como `assigned` en `--json`, las más antiguas arriba.
- **Un agente puede silenciar y reactivar el sonido de un chat** (cli-core 0.338.0): `chats mute` y `chats unmute`
  están ahora entre las herramientas de `max mcp`. Cada una se comprueba con su propia clave (`chats.mute`,
  `chats.unmute`); nadie en el chat se entera.
- **Ejemplos en la ayuda** de `account privacy show`, `account privacy set`, `chats mute`, `chats unmute`,
  `messages pin`, `messages unpin`, `metadata get` y `metadata refresh` (cli-core 0.336.0, 0.339.0).

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-4]

- **`bot messages send --reply-to` solo acepta un id de mensaje de MAX, `mid.…`**, y lo mismo un agente con
  `reply_to`. Cualquier otro valor se rechaza antes de enviar (código 2). Antes se enviaba a MAX tal cual.
- **`bot messages show`, `edit`, `delete`, `pin` y `unpin` también aceptan solo `mid.…`**, y lo mismo un agente.
  Cualquier otro valor se rechaza antes de la primera petición (código 2). Antes, `delete` con varios id borraba los
  mensajes hasta el primero incorrecto y solo fallaba en él (`not_found`).
- **Un comando sin terminal que espera a una persona tiene 5 minutos, no 30 segundos** (cli-core 0.328.0), por
  ejemplo el `session start` de un agente. `--timeout` y `MAX_TIMEOUT` siguen decidiendo si se indican.
- **Una ruta de comando dada como un solo argumento es un error** (cli-core 0.328.0): `max 'chats list' --help`
  imprimía la ayuda general con código 0; ahora responde `validation_error` y muestra cómo escribirlo bien.
- **Un agente ya no ve `offline` en `bot me`, `bot comments list`, `bot comments get` y `bot chats members list`.**
  Estos comandos siempre consultan a MAX y rechazaban `offline`; ahora el argumento no está en la descripción de la
  herramienta (cli-core 0.335.0).
- **`conversations build` y `conversations embed` se marcan como comandos que cambian algo fuera de este equipo**
  (cli-core 0.334.0, 0.336.0): con `--analyze` y `--provider` envían el texto de las conversaciones a un servicio
  externo, y `search
  conversations` con un modelo remoto envía allí la consulta. Con `MAX_READ_ONLY` los tres se
  niegan antes de enviar; un modelo en este equipo o en un servidor local funciona como antes. No se ejecutan a
  través de `max serve`. En `docs/commands.md` esa marca dice ahora "fuera de este equipo: en MAX o en un servicio
  externo", no "en MAX".
- **Con `MAX_READ_ONLY`, `session start`, `session end` y `setup` se niegan antes de empezar** (código 5, "it cannot
  log in or out"), no desde dentro del comando.
- **Con `MAX_READ_ONLY` se rechazan las escrituras locales que borran o sobrescriben lo que guardaste**
  (cli-core 0.336.0, 0.337.0): `searches create`, `searches delete`, `searches clear`, `contacts alias set`,
  `contacts alias rm`, `contacts notes add`, `contacts notes edit`, `contacts notes remove`, `contacts link`,
  `contacts unlink`, `tags add`, `tags auto`, `tags remove`, `mentions confirm`, `mentions reject`,
  `attachments text set`, `chats tracking add`, `chats tracking remove`, `conversations links add`,
  `conversations links clear`, `conversations consents revoke`, `tasks reject` y sus herramientas de agente salen con
  código 5, `permission_error`. Sigue funcionando lo que el archivo reconstruye por sí mismo (`images embed`,
  `mentions rebuild`, `conversations embed clear`, `store jobs …`), la sincronización, `serve` y el registro de
  tareas (`tasks add`, `scan`, `close` y otros). Con el bloqueo, `tasks close` solo propone cerrar la tarea, y
  `--as-owner` se rechaza.
- **Mientras MAX restringe la cuenta, no sale ninguna escritura** (cli-core 0.334.0): también se rechazan una
  reacción, marcar un chat como leído, un fijado silencioso y los cambios de título y de perfil (`permission_error`);
  la lectura funciona. Un bloqueo sin plazo retiene las escrituras hasta que ejecutes `flood clear` o
  `doctor --online` vea que la cuenta está bien; en `--json` ese bloqueo tiene `until: null`.
- **Un envío que no consiguió el cerrojo de archivo de otro proceso sale con código 9 (`timeout`), no con 1**
  (cli-core 0.338.0): no se envió nada, así que es seguro reintentarlo. Lo mismo con `flood clear`.
- **`upgrade --offline` sale con código 2** (cli-core 0.338.0): `upgrade` consulta npm, así que con `--offline`
  (y con `--check`) ahora se niega en lugar de ir a la red contra lo que pide la opción.
- **La herramienta de agente `messages list` ya no ofrece `topic:`** (cli-core 0.340.0): MAX no tiene temas, y esa
  condición se rechaza, como ya ocurría en la línea de comandos.

### Correcciones [#correcciones-6]

- **Un archivo que no se pudo abrir se cierra** (cli-core 0.332.0): en Windows se puede borrar la carpeta con ese
  archivo.
- **`doctor report create` vuelve a funcionar con `MAX_READ_ONLY`.** cli-core 0.337.0 prohíbe con ese bloqueo
  cualquier escritura local no marcada como segura; el informe solo añade un archivo nuevo, y ahora está marcado.
- **El cerrojo de archivo de otro proceso ya no detiene `max serve`** (cli-core 0.340.0): antes serve lo esperaba
  hasta 5 segundos, y durante ese tiempo se paraban todos los comandos que pasaban por él y el mantenimiento de la
  conexión con MAX.
- **Dos cambios a la vez en la lista de destinatarios ya no se anulan entre sí** (cli-core 0.338.0):
  `recipients add`, `remove` y `clear` leen y escriben la lista bajo un mismo cerrojo.
- **`store gaps repair --background` ejecuta su tarea** en lugar de fallar al instante (cli-core 0.339.0).
- **Las pistas de `server status`, `server …` y del mantenimiento del archivo nombran el perfil**: `max <profile> session
  start`, no `max session start` (cli-core 0.339.0).
- **`upgrade --check` funciona con `MAX_READ_ONLY`** (cli-core 0.338.0): solo pregunta a npm por una versión nueva.
- **Las descargas de modelos no pasan por `max serve`** (cli-core 0.336.0): `models … download` e
  `images models download` descargan del servidor de modelos, no de MAX.
- **Con serve en marcha, `images embed` lee las imágenes a través de su conexión**, como las demás lecturas (cli-core
  0.337.0).
- **Se recuerda una restricción o un bloqueo que detuvo `watch` o `serve`** (cli-core 0.334.0): el siguiente comando
  espera, como tras el mismo error en un comando normal.

### Seguridad [#seguridad-7]

- **`session end` ya no cierra la sesión de la cuenta que usa `max serve`.** Si serve se inició a mano o con un
  servicio, `session end` cerraba la misma sesión de MAX en la que trabaja serve y borraba su token. Ahora el comando
  se niega (código 2) y pide ejecutar antes `max <profile> server stop`. Un serve iniciado por otro comando lo sigue
  deteniendo él mismo. `session start`, `session end` y `setup` nunca se ejecutan a través de serve
  (cli-core 0.333.0, `logsInOrOut`).
- **`chats.unmute: readonly` ahora detiene `chats unmute`** (cli-core 0.336.0). Antes, reactivar el sonido se
  comprobaba con la clave `chats.mute`, y su propia clave no tenía efecto. Una configuración que solo tiene
  `chats.mute` funciona como antes mientras no se defina `chats.unmute`.

## 0.60.0 — 17.10.2026 [#0600--17102026]

### Novedades [#novedades-38]

- **`stats messages top --measure reactions` muestra las reacciones por emoji** (cli-core 0.324.0): junto al total,
  `👍 4 · 😂 3` (hasta cinco emoji, después `+N`), y en `--json` cada fila tiene `reactions: [{reaction, count}]`.
- **`max <profile> contacts link <person> me`** (cli-core 0.323.0): marca que un contacto eres tú, para una cuenta tuya
  que el archivo no reconoce por sí solo, como `zoom:<id>`.

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-5]

- **Las herramientas de `max bot mcp` se construyen ahora a partir de los propios comandos `max bot`** (cli-core 0.325.0)
  y se ejecutan a través de ellos. Los argumentos se llaman como en el comando: `messages send` y `messages edit`
  aceptan `md` / `html` en lugar de `format`, `messages delete` una lista `messages`, `search messages` `query`,
  `chats members remove` `person`. Se añaden `chats rules show`, `offline` en los comandos que leen MAX y los
  argumentos `page`, `newest`, `notify`, `no_block`, `sync_first`. Una escritura con nivel `ask` está permitida al
  agente: no hay nadie que responda a la pregunta.
- **No se ofrecen al agente**: `session`, `setup`, `config`, `doctor report`, `bot uploads`, ni `--allow-dangerous`
  en `bot comments delete` y en `bot api`. Solo el propietario sigue ejecutándolos.

### Correcciones [#correcciones-7]

- **Las menciones encuentran menos nombres falsos** (cli-core 0.323.0). Una palabra del nombre de un contacto cuenta
  por sí sola solo como nombre o apellido; un contacto con nombre de empresa («Smart Agents») se encuentra solo por el
  nombre completo, y los corteses «Ваш», «Вам», «Вас» nunca cuentan. El nombre de un santo en el nombre de un lugar
  («Saint Michael's Bridge») y una ciudad después de «в»/«во» («во Владимире») tampoco son nombres.
- **Tus cuentas eres tú** (cli-core 0.323.0): la identidad propia de una cuenta se vincula contigo en la siguiente
  sincronización, y tu nombre en tus mensajes ya no pertenece a otra persona.
- **Una dirección conserva su ciudad** (cli-core 0.323.0): una misma calle en dos ciudades son dos lugares; una
  dirección sin ciudad sigue encontrando su lugar en esa calle.
- **En un grupo con la etiqueta `watch-tasks`, la respuesta de cualquier miembro cierra una pregunta** (cli-core
  0.325.0). Una respuesta directa a la pregunta (una respuesta con cita) de alguien que no sea quien preguntó cierra
  la tarea con la marca «answered in the group». Antes solo la cerraba tu respuesta, y las preguntas que otros ya
  habían respondido seguían abiertas. Un mensaje que no responde a la pregunta no cierra nada. En los chats
  individuales y en los grupos sin la etiqueta sigue contando solo tu respuesta.

Después de actualizar, vuelve a leer una vez los mensajes antiguos: `max <profile> mentions rebuild person-name place`.

### Seguridad [#seguridad-8]

- **`MAX_READ_ONLY` ahora impide iniciar y cerrar sesión, escribir como bot y modificar el archivo**: `session start`,
  `session end` y `setup` se niegan con `permission_error` antes de conectarse. También se niegan `bot api` (cada
  operación que cambia algo, y `get-updates`), `bot comments send|edit|delete`, `bot chats members add`,
  `bot uploads put`, así como `store reset`, `restore`, `clear`, `migrate`, `repair`, `copies delete` y `decrypt`.
  Antes, `session end` bajo esta restricción cerraba la sesión en MAX y la olvidaba, y estos comandos del bot enviaban
  una solicitud a MAX. `store repair --dry-run` bajo la restricción sigue mostrando lo que se repararía.
- **Una escritura en la Bot API que max no sabe registrar en el diario se rechaza** con `configuration_error`, en lugar
  de llegar a MAX sin pasar por la lista de destinatarios ni el diario de envíos. Así, una operación que añada una
  futura actualización del esquema de la Bot API no se salta las comprobaciones. Sin diario solo pasa `get-updates`:
  no envía nada a nadie.

## 0.59.0 — 17.10.2026 [#0590--17102026]

### Novedades [#novedades-39]

- **Una tarea tiene responsable** (cli-core 0.320.0): `tasks add --assignee`, `tasks plan --assignee` y el filtro
  `assignee:` en `tasks list`; una tarea también puede ser algo que alguien te debe. Un grupo con la etiqueta
  `watch-tasks` recibe una tarea por cada pregunta sin respuesta, se le haya hecho a quien se le haya hecho.

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-6]

- **Ya no se elige un perfil por defecto** (cli-core 0.319.0). El ajuste `default_profile` no se lee: si sigue en el
  archivo de configuración, un comando sin nombre de perfil se detiene e indica qué escribir. Nombra el perfil como
  primera palabra (`max <perfil> …`) o define `MAX_PROFILE`, y elimina el ajuste antiguo:
  `max config unset default_profile`. `max config set default_profile` ahora se niega.
- **Un perfil llamado `default` es un nombre normal.** `max default mcp config` llama al servidor MCP `max-default`,
  no `max`; una entrada escrita antes funciona hasta que `mcp setup` la reescriba con el nuevo nombre.
- **`tasks apply` ahora es `tasks scan`** (cli-core 0.320.0). La herramienta MCP es `tasks_scan` y la clave de permiso,
  `tasks.scan`. Funciona igual: muestra qué tareas abriría el historial de un chat y las crea solo con `--yes`.
- **Un agente ya no puede borrar un mensaje para todos** (cli-core 0.321.0). La herramienta MCP `messages delete` no
  acepta `for_everyone`: ese argumento se rechaza como desconocido. El propietario sigue borrando para todos con
  `max <perfil> messages delete --for-everyone`.
- **`mcp --permission` solo endurece los permisos** (cli-core 0.321.0). Una anulación que aflojaría el nivel del
  perfil, como `messages.send=allow` para un perfil con `readonly`, se rechaza al iniciar el servidor indicando la
  clave. Para permitir más, cambia los permisos del perfil; `--permission messages.send=deny` y otras restricciones
  funcionan como antes.

### Correcciones [#correcciones-8]

- **Prohibir al agente `chats members list` ahora surte efecto** (cli-core 0.321.0). Por MCP, el comando tomaba su
  nivel de la clave `chats.members`, y una prohibición en `chats.members.list` no le llegaba.
- **`tasks show HRB-12` muestra una tarea de proyecto** (cli-core 0.320.0). Antes, una tarea de un proyecto, y no de
  una cuenta, se daba por no encontrada.
- **Las tareas se abren solo donde se te ha preguntado algo** (cli-core 0.317.0). En un chat individual, como antes,
  cada pregunta sin respuesta; en un grupo, solo una respuesta a tu mensaje y una mención tuya; en un canal y en
  Mensajes guardados, nada. Antes, cualquier pregunta sin respuesta en cualquier chat se convertía en tu tarea.
- **Editar un mensaje no borra lo que la edición no incluye** (cli-core 0.317.0): la hora de envío, las reacciones y
  los campos de servicio del mensaje guardado se mantienen.
- **Las herramientas de `max bot mcp` respetan el entorno del servidor.** Antes, una llamada ignoraba las variables
  con las que se inició el servidor: por ejemplo, con `MAX_READ_ONLY=1` el bot enviaba el mensaje igualmente. Ahora
  una llamada por MCP se comporta igual que el mismo comando en el terminal.

## 0.58.0 — 17.10.2026 [#0580--17102026]

### Seguridad [#seguridad-9]

- **Los datos internos de los adjuntos quedan fuera de la salida**, incluido el flujo de eventos del bot (cli-core 0.315.0). Las claves multimedia y el token permanecen dentro del cliente.

- **Los archivos de estado de WhatsApp no se pueden enviar como adjuntos** (cli-core 0.314.0). La protección comprueba los directorios predeterminados, las variables de entorno y los enlaces simbólicos; los archivos normales contiguos siguen permitidos.

### Novedades [#novedades-40]

- **Los nombres y las direcciones se pueden revisar como menciones** (cli-core 0.311.0). `mentions rebuild person-name` y `mentions rebuild place` los encuentran en el texto guardado; `mentions places` muestra las direcciones confirmadas.
- **`tasks apply <chat...>` muestra las tareas del historial guardado seleccionado.** `--yes` las crea con comprobación de duplicados.

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-7]

- **La primera sincronización no abre tareas de mensajes antiguos por defecto** (cli-core 0.311.0). `task_first_pass_per_chat` activa su creación; `tasks apply` permite revisar los chats elegidos por separado. Las siguientes sincronizaciones siguen procesando mensajes nuevos.

### Correcciones [#correcciones-9]

- **`max doctor report create` escribe un informe incluso con ajustes incorrectos.** Antes se detenía con `configuration_error` y no dejaba ningún informe que compartir. Ahora el informe muestra el error de ajustes en lugar de la comprobación del perfil, nombra el ajuste incorrecto sin su valor e incluye la última ejecución fallida.

## 0.57.0 — 17.10.2026 [#0570--17102026]

### Novedades [#novedades-41]

- **Los documentos de Drive aparecen en la búsqueda local compartida** (cli-core 0.301.0), con su enlace de Google y fecha de modificación. `--source drive:<профиль>` elige el perfil importado. `chats documents list <чат>` muestra los documentos compartidos en mensajes guardados sin consultar MAX.

- **El servidor MCP solo se carga cuando max se ejecuta como MCP** (cli-core 0.300.0): las demás órdenes cargan aproximadamente una décima parte menos de archivos al arrancar.
- **La ficha de una tarea muestra las tareas que apuntan a ella** (cli-core 0.304.0): `tasks show` imprime `task:<id> follow-up-of this task`, mientras que `--json` y MCP devuelven `linked_from`. Antes solo la tarea nueva mostraba el vínculo, no la cerrada.
- **max arranca aproximadamente un cuarto más rápido después de la primera ejecución.** El código compilado de Node se guarda en la carpeta temporal del sistema, configurable con `NODE_COMPILE_CACHE`: `max --help` tarda unos 0,42 segundos en lugar de 0,56.

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-8]

- **Los errores de ajustes ocupan una línea sin repetir el valor** (cli-core 0.304.0): el primer campo incorrecto, el motivo y el número de errores adicionales, como `config.json: profiles.default.limitt is an unknown setting (and 2 more
  problems)`. Un campo antiguo (`clientId`) indica su nuevo nombre (`rename it to client_id`, cli-core 0.307.0). Antes se enumeraban todos los errores y campos admitidos y se citaba el valor, que podía contener un token por accidente.
- **`search notes` selecciona notas mediante `source:internal` o `source:file` en la consulta** (cli-core 0.303.0). Se eliminan la opción `--type` y el campo `type` de MCP `search_notes`. El nombre coincide con el campo `source` de la nota. `--source notes:<папка>` sigue eligiendo qué cuentas leer.
- **El aviso diario de actualizaciones también queda en silencio con `--timeout=5`, `--help=…` y otros argumentos separados por `=`**, como ya ocurría con `--timeout 5`. La comprobación ahora procede de cli-core compartido.
- **Se ocultan las órdenes que MAX no admite** (cli-core 0.299.0). `messages send`, `chats mark-read` y `polls create` no tienen `--topic`, porque MAX no tiene temas de foro. `messages list` no acepta `topic:`; `chats requests
  accept` y `decline` no tienen `--all` ni `--link`, por lo que siempre requieren una persona. Antes se mostraban esas opciones, pero se rechazaban.
- **`max doctor` responde incluso con ajustes incorrectos.** Antes devolvía `configuration_error` y código 3; ahora devuelve `config: {error: …}`, nombra el ajuste incorrecto y sale con código 0. `doctor` se usa precisamente cuando los ajustes fallan. Los scripts que detectaban ajustes incorrectos por su código de salida deben consultar `config.error`.

## 0.56.0 — 16.10.2026 [#0560--16102026]

### Añadido [#añadido]

- **`tasks reject` rechaza el cierre sugerido por un agente, y `tasks list close:suggested` encuentra esas tareas** (cli-core 0.295.0). `tasks agenda` indica el motivo `close-suggested`; el propietario confirma con `tasks close <задача>`, sin necesitar `--as`. Los ajustes compartidos `task_agent_close` (`on` por defecto) y `task_agent_close_min` (0.8) controlan los cierres del agente; `config show` los muestra.
- **Una tarea nueva sobre otra cerrada en los últimos 14 días es su seguimiento** (cli-core 0.295.0): `review` y `tasks add` la vinculan a la cerrada mediante `follow-up-of`. La cerrada permanece cerrada y no entra en `tasks duplicates`; `tasks show` muestra el vínculo.
- **59 categorías predeterminadas en lugar de 7, con hasta 80 en la lista** (cli-core 0.295.0 y 0.296.0): `bills`, `health`, `travel`, `fitness`, `subscriptions` y otras. `tasks categories` muestra el significado y las palabras de la regla en inglés, ruso y español. Un almacén cuya lista se guardó con `config set task_categories.*` conserva la suya; `config unset task_categories` adopta los nuevos valores.
- **Las categorías quitadas de la lista siguen visibles** (cli-core 0.296.0): `tasks categories` las nombra y cuenta sus tareas abiertas/totales (`unlisted` en JSON); `tasks agenda` indica las categorías que aún tienen tareas abiertas (`unlisted_categories`).
- **Español en las tareas** (cli-core 0.296.0): un activador `es:` reconoce otras formas de la palabra (`pagues` — `pagar`) en mensajes en español; la comprobación de duplicados entiende fechas como `mañana`, `el viernes`, `15 de noviembre`.
- **Los duplicados se comprueban de nuevo tras vincular un mensaje** (cli-core 0.295.0): después de `tasks link <задача> msg:…`, `tasks add --into` y `tasks merge`, las tareas similares aparecen en `tasks duplicates`; el campo `review` de la respuesta las cuenta. El vínculo se conserva y nada se une automáticamente.
- **`commands --json` indica cuánto vive cada comando** (cli-base 0.38.0): `serve` y `watch` tienen `lifetime` — `persistent`; `setup` y `session start` son `interactive`. Antes se deducía por sus nombres.

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-9]

- **Un agente solo cierra una tarea con `--certainty <0..1>`; un cierre incierto espera al propietario** (cli-core 0.295.0). `AI_AGENT` o `CLAUDECODE` identifica al agente; `--as-owner` cierra como propietario. Un agente puede equivocarse y una tarea cerrada desaparece de tu agenda. `tasks close` del agente sin `--certainty` se rechaza con `task.certainty-required`; MCP `tasks_close` requiere el nuevo argumento `certainty`. Por debajo de `task_agent_close_min` (0.8 por defecto), o con `task_agent_close off`, la respuesta contiene `state: open` y `close_suggestion`, y la tarea queda abierta.
- **`tasks add` ya no se niega si solo coinciden tareas cerradas** (cli-core 0.295.0): abre una nueva con `follow-up-of` (`follow_up_of` en la respuesta). El código 2 se mantiene si coincide una abierta. Un script que esperaba código 2 para una tarea cerrada ahora recibe una nueva.
- **La regla elige categorías más precisas: la luz va a `bills`, no a `money`, y el médico a `health`, no a `personal`** (cli-core 0.295.0 y 0.296.0). Las siete categorías originales conservan nombre y significado; las tareas guardadas no cambian. Un filtro como `tasks agenda category:personal` encuentra menos tareas nuevas. Algunas palabras pasan a categorías más precisas: `gym` a `fitness`, `restaurant` a `food`, `переезд` a `moving`.
- **La comprobación de duplicados lee los mensajes de la tarea** (cli-core 0.295.0): el original y los cinco últimos vinculados. Una tarea de regla sin texto propio se compara por las palabras del mensaje, así que `tasks add` puede rechazar con código 2 donde antes abría una tarea.
- **`max mcp` y `max <бот> bot mcp` usan ahora el servidor MCP compartido, como `tg`.** Las herramientas siguen siendo `max_read`, `max_tools_search` y `max_write`. `chats check` en `max_write` se sustituye por `chats moderate`; desaparece el alias `chats rules` y queda `chats rules show`. `max bot mcp` ya no acepta `--allow-send`, `--allow-delete`, `--allow-moderate`, `--confirm-send` ni `--allow-dangerous`. MAX y TG comparten comportamiento y código probado. Esas opciones de `bot mcp` antes no habilitaban nada; ahora impiden iniciar el servidor con código 2 y “unknown option”. Quítalas de la configuración; `max <бот> bot mcp config` muestra la entrada nueva. Los agentes que usaban `chats check` o `chats rules` necesitan los nombres nuevos. `max mcp config` ya no incluye `--yes`: las escrituras MCP con `ask` ya se ejecutan sin preguntar. El audio por MCP se descarga y después se transcribe en este ordenador, como en `tg`. `chats moderate` solo lee la posición guardada del archivo de reglas; ya no migra posiciones de sesiones muy antiguas.
- **`setup --json` coloca los siguientes comandos en `next` del sobre, no en `item.next`.** El objeto `item.next` con `instructions`, `chats`, `history` y `skill` se sustituye por dos pasos de lectura de nivel superior: `skill show` y `chats list --limit 5`. Todos los comandos ofrecen los siguientes pasos en el mismo lugar. Los scripts deben leer `next` en vez de `item.next`. La descarga de historial y la instalación de la habilidad solo aparecen en la salida para personas.
- **`chats media` devuelve mensajes con la misma forma que el historial.** El audio de voz es ahora `voice`, no `audio`, como en `messages list`. Los identificadores de archivo y vídeo MAX están dentro de `provider_ref` del adjunto (`provider_ref.file_id`, `provider_ref.video_id`), no en su nivel superior. Antes `chats media` devolvía adjuntos con una forma propia de MAX. Los scripts que esperaban `audio` deben buscar `voice` y leer `file_id`/`video_id` dentro de `provider_ref`; `--type audio` sigue eligiendo mensajes de voz.
- **`max watch` representa mensajes con el mismo código que `messages list`.** Las encuestas muestran pregunta, respuestas y número de votos. JSON y `--jsonl` no cambian. La salida para personas puede variar un poco respecto a 0.55.0; los scripts deben usar `--jsonl`.

### Corregido [#corregido-29]

- **`doctor report create` también sustituye por etiquetas los identificadores del mensaje respondido y de los intentos de escritura.** Las etiquetas relacionan registros dentro de un informe y cambian al crear otro.

### Seguridad [#seguridad-10]

- **Cada escritura pasa por una sola protección compartida, desde la terminal, `max serve` y MCP.** Envíos, ediciones, eliminaciones, reacciones, marcar como leído, reenvíos, moderación y cambios de chats/contactos/cuenta comparten niveles de permisos, `MAX_READ_ONLY`, lista de destinatarios y registro de envíos. Las escrituras visibles para otras personas (mensajes, reenvíos, ediciones, eliminaciones, grupos nuevos y añadir personas) también comparten el límite por hora. `deny` y `readonly` impiden escribir. Con `ask`, la terminal pregunta o espera `--yes` (`--allow-dangerous` para eliminar); `--json` sin indicador se rechaza. Por MCP, `ask` funciona como antes: deciden los permisos del perfil, incluidos los del servidor mediante `--permission`. `MAX_READ_ONLY=1` prohíbe toda escritura, también por MCP. Antes MCP seguía otra ruta dentro de MAX; ahora la comparte con `tg`. Los comandos de terminal mantienen su comportamiento. Para impedir que el agente elimine o envíe sin ti, usa `deny` o `readonly` en vez de `ask`: esas herramientas no se ofrecen al agente.

## 0.55.0 — 15.10.2026 [#0550--15102026]

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-10]

- **Las opciones de los comandos comunes siguen el vocabulario común; los nombres antiguos ya no se aceptan** (cli-core 0.288.0):
  `--budget` → `--max-pages`; `messages sync --estimate` → `--dry-run` (max lo sigue rechazando: los id de mensaje de
  MAX no dicen cuántos faltan); `contacts context --refresh`, `bot contacts show --refresh` y
  `tags auto --refresh-metadata` → `--sync-first`; `search conversations --refresh` → `--catch-up`;
  `attachments show --if-sha256` → `--expected-fingerprint`; en `replies edit`, `--chats`, `--not-chats`, `--people`,
  `--not-people` → `--allow-chats`, `--deny-chats`, `--allow-people`, `--deny-people` (el archivo de reglas no cambia);
  `schedule --once` → `--at-time`; `bot chats moderate --no-ban` → `--no-block`; `chats mark-read --until` →
  `--until-id`; `tasks add|plan --check` → `--remind-time`; `tasks add --attach` → `--into`; `tasks claim --for` →
  `--lease`; `tasks agenda --due` → `--due-within`; `server logs --lines` → `--limit` (`-n` se mantiene); en `chats start`,
  `--payload` → `--start`, como en `chats app`; `store export --to/--kind` → `--output-dir/--include`.
  Por qué: en max, tg y las demás CLI de WireCat una palabra significa una sola cosa, y un agente no tiene que recordar
  el nombre de la opción en cada programa.
  Qué tener en cuenta: un nombre antiguo termina el comando con código 2 («unknown option») antes de conectar con MAX;
  revisa los scripts y las programaciones (`schedule list`). En MCP el argumento es el nombre nuevo en snake_case, por
  ejemplo `max_pages`, `until_id`, `expected_fingerprint`, `output_dir`, `allow_chats`, `at_time`. En
  `search conversations` no cambies `--refresh` por `--sync-first`: esa opción ya existía y primero lee los mensajes
  nuevos de MAX; la antigua preparación de la búsqueda es ahora `--catch-up`.
- **`tasks similar` es ahora `tasks related`, y `tasks duplicates unsure` es `tasks duplicates defer`**, sin los nombres antiguos.
  Por qué: el mismo vocabulario común.
  Qué tener en cuenta: en MCP busca los comandos `tasks related` y `tasks duplicates defer` con `max_tools_search`. La
  clave de permisos es `tasks.duplicates.defer`. La clave antigua `tasks.duplicates.unsure` en el archivo de ajustes
  ahora solo avisa en stderr y no tiene efecto, así que el comando recibe el nivel de `tasks`: quítala con
  `config unset` y da el mismo nivel a la clave `tasks.duplicates.defer`. En la base de datos la decisión sigue
  llamándose `unsure`.
- **`tasks agenda` y `tasks duplicates` filtran con campos de consulta, no con opciones**: `tasks agenda --tag <имя>` →
  `tag:<имя>`, `--category <имя>` → `category:<имя>`, `--claimed` → `claimed:any` (también `none`, `mine`, `others`; por
  defecto, como antes, las sin reservar y las tuyas); `tasks duplicates --unsure` → `decision:unsure` (por defecto
  `decision:review`).
  Por qué: la lista la filtra la base de datos, como las demás listas, y no el programa después de leer.
  Qué tener en cuenta: un OR o NOT que mezcla campos de tarea con `chat_kind:` se rechaza (`query.unsupported-placement`).
  En MCP estos comandos aceptan `query` en lugar de `tag`, `category`, `claimed` y `unsure`.
- **Toda respuesta `--json` es un sobre: `item` para una cosa, o `items` + `page` para una lista, y `meta`.** Ahora
  responden así también los que devolvían un objeto suelto: la vista previa `--dry-run --json` (bajo `item`, claves en
  snake_case: `business_rules`, `action_invoked`, `write_reserved`, `messenger_contacted`, `configuration_read`),
  `mentions confirm|reject` e `images embed --json`, `max_tools_search` en MCP (`{items, more}` →
  `{items, page, meta}`) y el recurso MCP `max://chat/<id>` (el chat y los mensajes bajo `item`), además de `bot me`, `bot api …` (la respuesta de la Bot API va dentro de `item` sin cambios; una respuesta vacía es
  `null`), `contacts sync`, `contacts lookup` (`displayName` → `display_name`, `lastMessagedAt` → `last_messaged_at`),
  `doctor report`, `doctor report create` (`sendTo` → `send_to`) y `setup` (`chats.hasMore` → `chats.has_more`).
  Por qué: un agente lee cualquier respuesta de la misma forma.
  Qué tener en cuenta: lee los campos de `.item`; en lugar de `more`, usa `page.has_more`.
- **Una copia local de los mensajes dañada es un error, no una copia vacía** (cli-core 0.286.0). Antes, un comando que
  conecta con MAX seguía sin ella en silencio. La copia solo se omite si no existe, si la cuenta aún no está registrada
  o si otro proceso (`serve`) la retiene más de 5 segundos.
  Por qué: una respuesta sin la copia parecía completa, aunque le faltaba lo guardado.
  Qué tener en cuenta: ese error es motivo para `max <профиль> store repair --dry-run`.

### Correcciones [#correcciones-10]

- **La sugerencia del siguiente paso incluye el perfil** (cli-core 0.286.0): después de `max personal …` la línea
  `→ …` también empieza por `max personal`, y pegada tal cual funciona en lugar de pedir que elijas un perfil.

### Eliminaciones [#eliminaciones]

- **Abrir la base de datos ya no borra el archivo antiguo `messages.db`** ni lo anuncia en stderr (cli-core 0.286.0).
  Si el archivo quedó de versiones antiguas, bórralo tú.

## 0.54.0 — 15.10.2026 [#0540--15102026]

### Novedades [#novedades-42]

- **Las tareas se pueden reservar, etiquetar y repartir en categorías**: `tasks claim <задача> [--for 30m]`,
  `tasks release`, `tasks categories`, `tags add|remove --task`, `tasks agenda --claimed` (cli-core 0.282.0).
- **Tareas que pueden ser el mismo trabajo** (cli-core 0.285.0): `tasks similar <задача>` valora las tareas
  parecidas; `tasks duplicates [--unsure]` muestra los pares que encontraron las reglas, `tasks merge <задача> --into <другая>`
  los fusiona, `tasks unmerge` deshace la fusión, `tasks duplicates reject|unsure` resuelve un par. `tasks agenda`
  acepta `--category` y `--tag`, y `config set task_categories.<имя>` cambia la lista de categorías de toda la base.
- **Menciones** (cli-core 0.285.0): `mentions domains` muestra los sitios a los que llevan los enlaces;
  `mentions list --new`, lo encontrado desde la última consulta; `mentions confirm|reject <id> --all-in-chat` resuelve un nombre en
  todo el chat. `config set phone_countries es,ru` lee los números escritos sin `+`.
- **Versión de la base 16**: las reglas de menciones leen el texto de las notas y de los documentos guardados, y un único
  `mentions rebuild` lee los guardados antes; `mentions list` sigue mostrando solo las menciones en mensajes. La
  actualización añade solo disparadores, así que una versión anterior de max sigue abriendo la base.

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-11]

- **Los ajustes se nombran solo en snake_case** (cli-core 0.283.0): `config set` y `config unset` ya no entienden
  camelCase, y una clave en camelCase en el archivo de ajustes se considera desconocida. Los ajustes comunes del almacén
  ahora son `search_stemmers.cyrillic`, `search_stemmers.latin` y `account_groups.<имя>`.
- **`tasks add` exige `--category <имя>`** de la lista de `tasks categories` (`money`, `documents`, `meeting` y otras);
  si ninguna encaja, usa `--category other`.
- **`MAX_READ_ONLY` ahora prohíbe también escribir en max**: antes esta variable no llegaba a la comprobación de escritura.
- **`tasks add` se niega si la tarea puede ser el mismo trabajo** que una abierta o cerrada en los últimos 14 días
  (cli-core 0.285.0): salida 2, motivo `task.duplicate-candidates`, candidatas en `details.candidates`. Repite con
  `--attach <задача>` para vincularle el mensaje, o con `--new` para abrir una nueva; por MCP, `tasks add`
  se comporta igual.
- **`phone:` y `value:` también encuentran un número guardado que termina en las cifras nacionales del escrito** (desde 8;
  cli-core 0.285.0), así que un número guardado antes de `phone_countries` se encuentra en cualquier forma. Un número
  urbano ruso escrito en grupos, `(812) 000-00-01`, ahora se guarda como `+78120000001`, no como cifras sueltas.
- **`max search mail` ya no existe: el correo lo busca memo** (decisión del propietario del 14.10.2026, cli-core 0.285.0,
  cli-core#1121). MCP no tiene `search_mail`. `max search all` busca mensajes y notas (y reuniones, si `--source`
  las nombra), pero nunca correo; `--only mail` se rechaza. En lugar de «unknown command», `max search mail …` responde con
  una pista: ``mail is memo's: install @wirecat/cli-memo, then `memo search mail …` ``. Las tareas, las notas de contactos,
  las etiquetas, `search notes` y `search all` se quedan en `max`.

### Correcciones [#correcciones-11]

- Un título con letras cirílicas mayúsculas se encuentra con una consulta en minúsculas (cli-core 0.285.0).
- **El HTML dañino en un adjunto ya no cuelga la lectura** (cli-core 0.285.0): una página de etiquetas o comentarios sin
  cerrar se lee en un tiempo lineal respecto a su tamaño.

### Seguridad [#seguridad-11]

- **`messages send --file`, el envío desde MCP y las fotos de perfil o de grupo no toman archivos de lugares con credenciales**
  (cli-core 0.283.0): la misma lista que `bot uploads put` desde 0.53.0: claves SSH y de la nube, `.netrc`,
  `.git-credentials`, ajustes de gh, docker y kube, credenciales de Claude y Codex, llaveros, perfiles de navegador,
  almacenes de contraseñas y carpetas de las aplicaciones de WireCat; en macOS y Windows sin distinguir mayúsculas. Antes se negaban
  solo con `.ssh`, `.gnupg`, `.aws`, `.env` y similares, y con las carpetas de max. Si necesitas justo ese archivo, usa `--allow-any-file`.
- **La lista de lugares de los que no se envía un archivo ahora es una para todas las aplicaciones de WireCat**: max la toma de
  cli-core y ya no guarda su propia copia. Si el archivo aún no existe, también se resuelven los enlaces en las carpetas que lo contienen.
- **Con `MAX_READ_ONLY` no se puede cambiar lo que permitiría escribir más tarde** (cli-core 0.281.0): `schedule
  command|agent|remove`, `config set|unset`, `recipients add|remove|clear`, `flood clear`, `server
  install|uninstall`, `mcp setup`, `skill install`, `upgrade`, las claves de modelos y `bot auth` responden
  `permission_error`. Un agente programado se ejecuta con esta variable y antes podía programarse un envío para después;
  ahora no puede, y una programación guardada bajo ella también se ejecuta solo en lectura. La lectura, la sincronización,
  las tareas y las notas funcionan como antes.

### Eliminaciones [#eliminaciones-1]

- **Código de compatibilidad.** `max mcp` y `mcp config|setup|doctor` ya no aceptan `--allow-send`, `--confirm-send`,
  `--allow-mark-read`, `--allow-delete`, `--allow-moderate`, `--allow-dangerous` y `--http-confirmation`; el acceso se
  define con `permissions`. Se quita `messages download --output`; queda `--output-dir`. El comando `config migrate` ya no
  existe. Los ajustes `read_only`, `allow` y `mcp_tools` se eliminan: un archivo que los contenga no se lee; en su lugar define
  `permissions.<ресурс> readonly`. `doctor` no busca el antiguo archivo de caché (`legacy_cache`), e `inbox` ya no traslada
  la antigua marca `lastCheckAt`.
- **Traslado de carpetas al arrancar** (desde `~/Library` y a la carpeta de WireCat): ya está hecho.
- **El antiguo lenguaje de búsqueda**: `search messages` y `searches create` ya no tienen `--language` ni `--regex`. Guarda
  de nuevo una búsqueda guardada en el lenguaje antiguo.
- **`conversations embed --workers`.**

## 0.53.0 — 15.10.2026 [#0530--15102026]

### Novedades [#novedades-43]

- **`config set` y `config unset` aceptan nombres de ajustes en camelCase** (cli-core 0.279.0): `max <профиль> config set
  senderColors false` escribe `sender_colors`, y `max <профиль> config set readOtherBots true --bot` escribe
  `read_other_bots`. Las rutas después de `permissions.` conservan su escritura.

### Correcciones [#correcciones-12]

- **`max bot uploads put` y las subidas desde código rechazan archivos de carpetas de credenciales, llaveros y perfiles
  de navegador**, como las demás subidas; en macOS y Windows los nombres se comparan sin distinguir mayúsculas.
- **Un envío rechazado por MAX por su límite se puede repetir**: si `messages send`, `messages forward` o
  `polls create` recibe ese rechazo, `retry.safe` es `true`: el mensaje no se envió. Si el límite llega durante
  un reintento tras perder la respuesta, sigue siendo `outcome_unknown` y `retry.safe: false`.

## 0.52.0 — 14.10.2026 [#0520--14102026]

### Novedades [#novedades-44]

- **La sincronización continúa donde se detuvo**: `store jobs show` muestra `progress`, y `messages sync --all`
  ya no tropieza con un chat que ya está ocupado (cli-core 0.276.0).
- **`max watch` ya no se cae con una traza si un manejador de eventos lanza un error**: la suscripción termina con ese error
  y la conexión con el servidor se mantiene.
- **Los archivos y vídeos se leen del disco a medida que se suben** (cli-core 0.272.0). `max messages send --file`,
  `--photo`, las fotos de perfil y de grupo y `max bot` ya no cargan el archivo entero en memoria antes de enviarlo, y
  desaparece el rechazo de archivos de 2 GiB o más. Un mensaje de voz se sigue leyendo entero (de él se calculan la duración y la forma de onda), hasta 256 MiB.
- **Búsqueda de imágenes: `max <профиль> images embed` y `max <профиль> images models download|list`.** Se activa con
  `max <профиль> config set picture_search true` (desactivada por defecto); el modelo `clip-b32` se descarga una vez
  (unos 155 MB) e `images embed` calcula un vector para cada imagen del almacén local. La búsqueda de mensajes por palabras
  devuelve entonces `pictures` junto a los resultados. Por qué: encontrar una imagen por lo que muestra.
  Qué tener en cuenta: la consulta de imágenes solo admite inglés; el agente la traduce por su cuenta. Más en
  [búsqueda](/llms.mdx/docs/es/max/search/content.md#%D0%BA%D0%B0%D1%80%D1%82%D0%B8%D0%BD%D0%BA%D0%B8-%D0%BF%D0%BE%D0%B8%D1%81%D0%BA-%D0%BF%D0%BE-%D1%82%D0%BE%D0%BC%D1%83-%D1%87%D1%82%D0%BE-%D0%BD%D0%B0-%D0%BD%D0%B8%D1%85-%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%BE).

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-12]

- **`max store export --format jsonl` escribe en archivos y carpetas los mismos registros que en pantalla**: snake_case, `chat_id`;
  la línea de borrado es `{ "id", "chat_id", "deleted": true }` (cli-core 0.276.0). Qué tener en cuenta: la nueva versión no
  añade datos a una carpeta exportada antes; exporta a una carpeta nueva.
- **`max watch --jsonl` escribe los mensajes con la misma forma que `messages list`**: snake_case, con `ref` (`chat_id`,
  `chat_title`, `sender_name`). Las líneas de `--events` también van en snake_case: `chat_id`, `message_id`, `user_id`,
  `up_to_time`, `unread_count`. Una persona ve lo mismo que antes. Qué tener en cuenta: los scripts que leían `chatId` usan `chat_id`.
- **Un mensaje de voz sin texto aparece en `missing`** en `review`, `inbox`, `messages list` y en MCP, para que el agente vea
  que todavía hay que transcribirlo (cli-core 0.275.0).
- **El siguiente paso hacia un comando que solo cambia este ordenador no se ejecuta solo** (cli-core 0.273.0):
  los pasos `server restart` y `store reindex` llevan `safe_to_auto_execute: false`.
- **`mentions rebuild` recibe el tipo como argumento**: `max <профиль> mentions rebuild person-name`, no `--kind`
  (cli-core 0.272.0).
- **`max doctor --json`, `session start` y `session end` responden con un sobre en snake_case**: `{item, meta}`, claves
  `legacy_cache`, `keyring.moved_by_environment`, `session.state_file`, `revoked_on_server`. Una persona sigue viendo
  líneas de texto. Qué tener en cuenta: los scripts que leían estas respuestas toman los campos de `item`, en snake_case.
- **`max bot chats members list --cursor` en lugar de `--marker`**, sin alias; la herramienta MCP del bot también recibe `cursor`.
  La respuesta indica el siguiente paso en `page.next`. Los comandos propios de max (`recipients`, `config`, `mcp`,
  `messages transcribe`, `bot comments`, `bot uploads`) responden igual que los comunes: una línea final en `--jsonl` y
  sugerencias en stderr.

## 0.51.0 — 14.10.2026 [#0510--14102026]

### Novedades [#novedades-45]

- **Cada `max watch` tiene su propia cola.** Un observador lento ya no retrasa a los demás; el búfer es de 64 MiB por
  observador y 256 MiB en total, `max serve --max-subscriber-buffer-bytes` y `--max-subscriber-total-buffer-bytes`
  los cambian, `0` quita el límite.
- **`max mentions`: teléfonos, correo, enlaces y documentos de Google de los mensajes guardados** (cli-core 0.264.0,
  versión de la base 7). `mentions list kind:phone`, `mentions list domain:google.com`; una palabra sin campo es un valor
  en cualquier registro, `89001234567` encuentra `+79001234567`. `mentions show <id>` muestra el texto que la rodea. Los
  mensajes guardados antes los lee un único `max <профиль> mentions rebuild`; los nuevos se leen al guardarse.
- **`max mentions confirm|reject`, menciones en archivos y mensajes de voz, búsqueda por `phone:`, `email:`, `url:`, `domain:`**
  (cli-core 0.269.0, versión de la base 11). `mentions confirm <id> [person:<uid>|organization:<id>]` registra de quién
  es el teléfono o la dirección (también de organizaciones), `mentions reject <id>` descarta el valor para siempre; el
  autor del registro es el agente o el dueño (`--as-owner`). El texto de los archivos y las transcripciones de voz
  también dan menciones (campo `file_text` o `transcript`); las guardadas antes las lee un único `mentions rebuild`.
  La búsqueda de mensajes las encuentra por `phone:"8 900
  000-00-01"`, `domain:docs.google.com`, `email:"ana@example.com"`. Las versiones anteriores leen la base como antes.

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-13]

- **Compilado sobre `@wirecat/cli-core` 0.269.0: `contacts timeline` se pagina como las demás listas.** Una lista
  recortada por `--limit` responde `page.has_more: true`, `page.cursor` y el paso `page.next` (`--cursor` continúa con
  los mismos `--scope`, `--since-time` y `--until-time`); antes era `has_more: false` y `meta.truncated`.
  `meta.truncated` se mantiene para los cambios que aún esperan en la cola. La nota «cut at --limit» en stderr
  desaparece. Qué tener en cuenta: los scripts que leían `meta.truncated` de `contacts timeline` leen `page.has_more`.
- **Las claves de error están en snake_case también en `max bot` y en el envío sin respuesta.** El código de rechazo de
  MAX en el bot ahora es `error.details.max_code` (era `maxCode`); `outcome_unknown` al enviar un mensaje devuelve
  `send_id` (era `sendId`).
- **Sobre `@wirecat/cli-core` 0.270.0 y `@wirecat/cli-base` 0.27.2.**
- **`--json=<поля>` sustituye a `--fields` y `--agent-json`, que ya no existen.** `--json=id,text` conserva esos campos
  de cada elemento. El JSON de la CLI conserva el texto tal cual; las respuestas MCP siguen mostrando los caracteres
  invisibles.
- **`tags list`, `tasks list` y `conversations list` aceptan una consulta en lugar de flags de filtro.**
  `tags list tag:work type:chat`, `tags list sources:auto`; `tasks list state:open kind:promise chat:<id>`;
  `conversations list <чат> started_at>=7d`. Estas listas ya no tienen `--tag`, `--type`, `--source`, `--state`,
  `--chat`, `--before-time` ni `--since-time`. Los elementos son entidades comunes: una etiqueta nombra sobre qué está
  como `target`, una conversación devuelve `messages_count`, `started_at`, `first_message`.

### Correcciones [#correcciones-13]

- **`max serve` ya no pierde el inicio de sesión si se cerró justo cuando respondía MAX.** El estado del perfil y el
  token renovado se guardan antes de comprobar el cierre: MAX ya contó ese inicio de sesión y la siguiente ejecución no
  vuelve a iniciar sesión.
- **Un búfer común de `max watch` lleno desconecta a quien más retiene**, no a quien le toca recibir a continuación.
  El rechazo llega a `watch` con el código `invalid_response` y el motivo `output.too-large`, no `provider_error`.
- **El registro de una ejecución fallida vuelve a guardar el código de rechazo de MAX** (`providerError`, por ejemplo
  `proto.payload`). Desde cli-core 0.263.0 se lee de `error.details.provider_error`, pero max escribía `providerError`
  y el código se perdía; también la comprobación de encuesta «ya votada» y el reintento tras `not.found` miran la
  clave nueva.
- **`MaxClient` llama por su nombre a un archivo de 2 GiB o más, en vez de «it cannot be read».** Un archivo por ruta
  en `send({ files })` y la foto de un grupo o perfil se comprueban primero por tamaño: Node no lee archivos de 2 GiB
  o más, y el error ahora lo dice.
- **`max <бот> bot chats members add` acepta como máximo 100 personas a la vez.** La Bot API de MAX acepta hasta 100
  ids por solicitud; una lista más larga ahora se rechaza antes de la solicitud, pidiendo dividirla en varias
  ejecuciones.

## 0.50.0 — 14.10.2026 [#0500--14102026]

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-14]

- **Compilado sobre `@wirecat/cli-core` 0.262.0 (nuevo nombre de `@wirecat/cli-messaging`, sigue a su 0.261.0; el
  comando de comparación es `cli-core-parity`) y `@wirecat/cli-base` 0.26.0.** Las claves de la salida para máquinas
  están en snake_case: en `error.details`, `operation_id`, `send_id`, `retry_after_ms`; en `commands --json`,
  `global_options`, `inherited_options`, `exit_codes`, `takes_value` y `contract: 1`. El árbol de consulta del argumento
  MCP `ast` escribe `lower_inclusive`, `upper_inclusive` y `must_not`.
- **Los archivos HTML se leen como texto principal** (cli-core 0.262.0): se descartan menús, pies de página y banners;
  se conservan títulos, listas, tablas y enlaces. El texto ya guardado de los adjuntos HTML se vuelve a leer en el
  siguiente `attachments extract` y cambia. `title:`, `site:`, `lang:`, `author:` y `keyword:` buscan en notas y
  archivos.

### Correcciones [#correcciones-14]

- **`max config set defaultProfile <имя>` y `config unset defaultProfile` funcionan sin indicar un perfil.** Antes, el
  comando exigía primero un perfil y fallaba si había varios (cli-core 0.262.0).

## 0.49.0 — 13.10.2026 [#0490--13102026]

### Novedades [#novedades-46]

- **Compilado sobre `@wirecat/cli-messaging` 0.259.0 y `@wirecat/cli-base` 0.24.0.** El comando `store fetch` ahora
  se llama `messages sync` (mismos argumentos, opciones y JSON); el nombre antiguo queda oculto y obsoleto.
- **`--debug`:** ante un fallo, el registro completo —causa y pila— sigue al error: en la terminal, tras la línea `✗`;
  en otro caso, como segunda línea JSON.
- **`runs list` y `runs search` leen un índice por días** y responden en milisegundos incluso con miles de ejecuciones.

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-15]

- **La copia compartida de mensajes y los modelos de voz se mudan una vez a la carpeta WireCat**, `~/.local/share/WireCat/`
  (Windows: `%LOCALAPPDATA%\WireCat\Data\`), en la primera ejecución, desde `~/.local/share/cli-messaging/` y
  `~/.cache/cli-common/models/`. La mudanza no sobrescribe nada: si en ambos sitios hay copias distintas, `max`
  se detiene con el código `3` y nombra los dos archivos. `WIRECAT_STATE_DIR` sustituye a `CLI_COMMON_CACHE_DIR` y
  traslada toda la carpeta. Actualiza `tg` y `memo` junto con `max`: un CLI antiguo creará una copia nueva en el sitio anterior.
  [Dónde están los archivos](/llms.mdx/docs/es/max/installation/content.md).
- **Un único objeto de error:** `{"error":{"code","reason","message","details"}}`. Lo que estaba directamente en `error`
  —`candidates`, `sendId`, `operationId`, `permission`— ahora está en `error.details`. `reason` es un identificador con
  puntos (`output_limit` → `output.too-large`, `input_limit` → `input.too-large`); `retryable` aparece solo si lo
  fijó el propio fallo, y `actions` solo en los elementos fallidos de un resultado parcial. El código `1` se llama
  `internal_error` (antes `generic_failure`), y su mensaje ya no incluye el texto del fallo: lo muestra
  `--debug`. Las claves que no están en la lista común de cli-messaging desaparecen de `details`: `providerError` queda
  solo en el texto del mensaje, y los ID de los mensajes que `messages delete` no eliminó también se enumeran en el mensaje.
- **`runs show` muestra solo lo que salió mal** (respuestas fallidas, advertencias, un cierre inesperado) y añade
  `eventCount`; todos los eventos, con `-v`, como antes.
- **`max` ya no elige el perfil por su cuenta.** Si ni la primera palabra, ni `MAX_PROFILE`, ni el ajuste
  `defaultProfile` nombran un perfil, un comando que necesita una cuenta termina con el código `2` y enumera los
  perfiles de este ordenador, aunque solo haya uno. Antes trabajaba en silencio con el perfil `default`.
  El primer inicio de sesión también lleva nombre: `max personal setup` (cualquier nombre en lugar de `personal`); en un
  ordenador sin perfiles, el error sugiere justo este comando. Sin perfil siguen funcionando `--help`,
  `--version`, `commands`, `skill show`, `account list` y `config show`. Las sugerencias de los errores ahora
  siempre nombran el perfil (`max default setup`, no `max setup`), y `max mcp config` siempre se lo pasa al servidor.
  Por qué: qué cuenta escribe y lee lo decide el propietario, y lo decide de forma explícita; si no, un agente o un
  script podía actuar desde la cuenta equivocada.
  Qué tener en cuenta: para quien usaba el perfil `default` sin nombrarlo, `max chats list` y los scripts sin perfil
  dejarán de funcionar. El error nombra los perfiles; elige una de tres opciones: `max default chats list`,
  `export MAX_PROFILE=default` en el perfil de tu shell o `max config set defaultProfile default`. Las entradas MCP
  creadas con `max mcp config`, vuelve a crearlas con ese mismo comando. [Perfiles](/llms.mdx/docs/es/max/profiles/content.md).

## 0.48.0 — 12.10.2026 [#0480--12102026]

### Novedades [#novedades-47]

- **`--brief` y `--full` en cualquier comando.** `--brief` deja de cada mensaje encontrado la referencia, el chat, la hora,
  el autor, un fragmento y la puntuación; `--full` lo devuelve todo.
- **`max search all` nombra al autor de cada resultado** y cómo se encontró (por palabras o por significado).

- **`max schedule`: un comando o un agente programados**, mediante systemd (Linux), launchd (macOS) o el
  Programador de tareas (Windows). `max schedule command <имя> --every 2h -- messages list <чат>` ejecuta un
  comando de max; la lectura guarda lo leído en el almacén. `max schedule agent <имя> claude "<задание>" --at 08:30`
  inicia un agente (claude o codex), como mucho una vez por hora. El agente trabaja con `MAX_READ_ONLY=1` y no puede
  enviar nada; su respuesta queda en `latest.md` junto a la programación, y una notificación de escritorio avisa cuando
  está lista. `--once 2h` es una sola ejecución; después, la programación se elimina sola. `max schedule list`, `run`, `remove`.
- **`max server install` indica cómo activar la revisión diaria de compromisos**, y no activa nada por su cuenta.
- **`MAX_READ_ONLY=1` prohíbe al proceso cualquier envío**, por encima del archivo de configuración y de `--permission`.

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-16]

- **`max search messages` devuelve un fragmento, no el texto completo.** Cada resultado tiene `excerpt` en lugar de `text`:
  unos 240 caracteres alrededor de la primera palabra de la consulta; el texto completo, con `--full` o `max messages show <ссылка>`.
  Los campos vacíos `editedAt`, `replyTo`, `forwardedFrom` y `reactions` ya no se imprimen en la salida para máquinas.
  Un script que leía `text` de los resultados de búsqueda debe leer `excerpt` o añadir `--full`.

## 0.47.0 — 11.10.2026 [#0470--11102026]

### Novedades [#novedades-48]

- **Las tareas tienen plan, enlaces y agenda** (almacén compartido 0.247.0, versión 4). `max tasks add` acepta
  `--title`, `--description`, `--due` y `--check`; `max tasks plan <задача>` los cambia después, y `none` borra
  una fecha. La fecha de revisión indica cuándo el agente debe volver a mirar la tarea; no es un recordatorio: el
  propietario no recibe nada. `max tasks link` vincula a la tarea mensajes, chats, personas, documentos y enlaces;
  `max tasks show` muestra el plan con sus enlaces. `max tasks agenda`, sin el texto de los mensajes, enumera
  las tareas vencidas y próximas, los chats donde el propietario debe una respuesta (`owed`), donde espera una respuesta
  (`waiting`) y los chats cuyo último mensaje aún no está guardado (`unsynced`). `max skill show follow-ups` es
  una revisión diaria para el agente: solo borradores, no envía nada.
- **La búsqueda entiende comparaciones con dos puntos.** `date:>=2026-01-01` (y `:>`, `:<`, `:<=`) equivale a
  `date>=2026-01-01`; antes esa forma daba `invalid_syntax`. Un `after:` o `before:` rechazado ahora
  sugiere el reemplazo: ante `after:2026-09-01`, la respuesta es usar `date>=2026-09-01`.

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-17]

- Almacén compartido 0.247.0: el contexto de una reunión registra hechos con la acción `fact.add`; `memory.add` ya no
  acepta el tipo `fact`.
- El almacén compartido 0.246.0 comprueba las etiquetas nuevas antes de crearlas. Un nombre parecido requiere la
  revisión del propietario; puedes usar la etiqueta existente o su alias explícito. Los registros
  existentes se conservan; las coincidencias automáticas de nombre y alias se unen en una sola etiqueta.

## 0.46.0 — 11.10.2026 [#0460--11102026]

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-18]

- **En macOS, max guarda sus archivos en los mismos sitios que en Linux**: `~/.config/max-cli`, `~/.local/share/max-cli` y
  `~/.cache/max-cli` en lugar de `~/Library/…`. La primera ejecución traslada allí las carpetas antiguas junto con el almacén
  compartido y los modelos de voz, y cambia el registro del agente instalado de `max server` a la nueva carpeta. Mientras
  `max serve` o el servidor MCP estén en marcha, max muestra una advertencia, esa vez trabaja con las carpetas antiguas
  y lo vuelve a intentar en la siguiente ejecución. En Linux y Windows no cambia nada.
- **max funciona sobre `@wirecat/cli-messaging` 0.242.0**: se conservan las claves existentes de proyectos y tareas; los
  proyectos nuevos reciben claves cortas, y el almacén compartido admite dependencias verificables entre tareas.
- **max funciona sobre `@wirecat/cli-messaging` 0.238.0; el archivo pasa a la versión 2.** Al abrirse por primera vez, el
  archivo se actualiza: los recuerdos del tipo `fact` se convierten en hechos (lo que ocurrió, separado de las conclusiones),
  y los vínculos «asignado» se copian a las asignaciones de tareas. Las compilaciones anteriores de max abren el archivo
  actualizado como antes.
- **El correo para la búsqueda por significado se divide en fragmentos por conversación, no por mensaje.** Las citas,
  saludos y firmas no entran en los fragmentos. En la primera indexación se eliminan los fragmentos antiguos y todo el
  correo se vectoriza de nuevo: una sola vez, y llevará tiempo. El texto de los correos y la búsqueda por palabras no cambian.

### Novedades [#novedades-49]

- `--source` en `search messages`, `search mail` y `search conversations` acepta una lista de cuentas y grupos:
  `--source group:work,max:default,email:me@work.example`. Un grupo se guarda con
  `max config set accountGroups.<имя> <список>` y lo ven todas las aplicaciones que trabajan con el archivo.
- `max search conversations` encuentra correos de los buzones también por palabras, no solo por significado.

## 0.45.5 — 11.10.2026 [#0455--11102026]

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-19]

- **Unirse a un chat e importar contactos cuentan para `sendsPerHour`.** Unirse cuenta como una acción; importar,
  una por número; `max contacts import` envía los números de 10 en 10 por solicitud. Si el límite detuvo una importación
  a medias, el error dice cuántos números se enviaron, y volver a importar es seguro.

### Novedades [#novedades-50]

- `max search all --backend archive|server|both` y `--server-time`, como en `search messages`; solo afecta a los
  mensajes: el correo y las notas se buscan localmente. Por defecto, `both`.
- `max search mail --account <адрес>` busca en el correo de un solo buzón; sin él, en todos.
- El correo se busca por destinatarios, carpeta y asunto (`to:`, `cc:`, `bcc:`, `mailbox:`, `subject:`), y los adjuntos de los correos, por significado.

### Seguridad [#seguridad-12]

- **La búsqueda ya no devuelve mensajes de otra cuenta.** `search messages --backend server` con `--source all` o
  `in:all` podía mostrar un mensaje ajeno con los mismos ID de chat y de mensaje; ahora se rechaza buscar en un chat sin cuenta.
  De `@wirecat/cli-messaging` 0.233.0.

## 0.45.4 — 11.10.2026 [#0454--11102026]

### Novedades [#novedades-51]

- **`max search messages` sin chat también consulta al servidor de MAX**, como la barra de búsqueda de web.max.ru: una
  solicitud para todos los chats y la mejor coincidencia de cada chat. Lo encontrado se guarda en el archivo y se
  comprueba con tu consulta. Con `--chat`, el servidor busca en un chat, como antes. `--backend archive` deja solo
  el archivo; con `--json`, estas búsquedas tienen ahora un bloque `server`.

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-20]

- **`max search messages` con palabras y sin chat ahora se conecta a MAX** (antes respondía solo el archivo) y
  puede esperar al servidor hasta 5 segundos. Lo mismo se aplica a la búsqueda por MCP. Para buscar solo en el
  archivo, como antes, añade `--backend archive` (en MCP, `backend: "archive"`).

### Correcciones [#correcciones-15]

- Funciona con `@wirecat/cli-messaging` 0.231.0, que incluye cli-meetings 0.3.0 y los paquetes SQLite y ONNX 1.0.1 con
  archivo de licencia; para `max` no cambia nada.

## 0.45.3 — 11.10.2026 [#0453--11102026]

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-21]

- La búsqueda en el archivo con `--discover` admite preguntas como «¿Pueden los contratistas conectarse al proyecto?»:
  el signo de interrogación ya no se convierte en un patrón de búsqueda. La búsqueda estricta y los filtros funcionan como antes.
- La búsqueda de correo y las conversaciones de una persona vinculada también leen el almacenamiento de correo
  separado, junto con la importación anterior. El correo admite filtros de remitente y de cadena. En los resultados,
  un correo con la misma referencia aparece una sola vez.

## 0.45.2 — 11.10.2026 [#0452--11102026]

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-22]

- **Una descarga de historial cuya primera página falla sin posibilidad de reintento vuelve a terminar con error**
  (código de salida `2`), como antes de 0.45.1. Una espera que pide MAX y un fallo después de varias páginas siguen
  dando un resultado parcial con `complete: false` y código `0`.

### Correcciones [#correcciones-16]

- **`max store fetch --background` ya no se detiene a los 30 segundos.** La tarea en segundo plano recibía el
  límite de 30 segundos común a los comandos y se detenía tras unos cien mensajes. Ahora llega hasta el final; un
  `--timeout` explícito sigue limitándola.
- **`max store fetch --all` espera una pausa breve** que pide la lista de chats (hasta 5 minutos, como ya hacían
  las páginas de mensajes), en lugar de terminar enseguida con `rate_limited`.

### Seguridad [#seguridad-13]

- **Se elimina el antiguo `messages.db`** al abrir el almacén en su ruta predeterminada (así desde 0.45.1): el archivo
  sin cifrar anterior a `wirecat.db`, junto con sus `-wal` y `-shm`. Una línea en stderr lo indica. El archivo se
  conserva si está definido `MESSAGING_STORE` y mientras otro proceso lo tenga abierto.

## 0.45.1 — 11.10.2026 [#0451--11102026]

### Correcciones [#correcciones-17]

- Las referencias a paquetes, la documentación y los ejemplos usan el espacio de nombres WireCat.
- La descarga HTTP distingue un rechazo 429 de un fallo de red normal: detiene los archivos nuevos e indica la pausa `Retry-After` cuando existe. Un rechazo 413 sugiere reducir los datos de entrada en vez de aumentar el límite local.

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-23]

- El fallo de un archivo o una página de historial conserva el trabajo completado y devuelve `complete: false`, `batch` o `issue` con código de salida `0`. Los scripts deben comprobar la integridad; el JSONL de descarga parcial añade `batch_summary`. Los errores incluyen `actions` para recuperarse. Reanudar las descargas reintenta los ID fallidos del checkpoint.
- Después de diez intentos, el lote detiene las solicitudes nuevas si la tasa de errores supera el 50%; `MESSAGING_BATCH_MAX_ERROR_PERCENT` cambia el porcentaje y 100 desactiva esa parada porcentual. Los límites de frecuencia y los fallos de autenticación detienen antes; nunca se repiten automáticamente escrituras de resultado desconocido.

### Novedades [#novedades-52]

- Configura el tamaño para extracción y transferencia de archivos guardados mediante `MESSAGING_ATTACHMENT_MAX_MIB` (por defecto 50). Las vistas previas PDF permiten ahora 4000 píxeles por lado y 8 MiB por página; `MESSAGING_PDF_PREVIEW_MAX_PIXELS` y `MESSAGING_PDF_PREVIEW_MAX_MIB` ajustan esos valores. Aumentarlos requiere más memoria; el OCR externo y la descompresión mantienen límites independientes.
- `max runs search`, también el comando `runs search` en MCP `max_read`, busca registros seguros por texto, estado, código de error y tiempo sin conectar con MAX.

## 0.45.0 — 11.10.2026 [#0450--11102026]

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-24]

- **El almacén limpia sus registros crecientes al abrirse**, como máximo una vez al día: elimina llamadas de herramientas del agente de más de 90 días y conserva las filas de actualizaciones de bot procesadas de más de 30 días, eliminando su contenido. Actualiza tg-cli y cli-memo a la vez: comparten el almacén.

### Novedades [#novedades-53]

- `max store reset` sirve para un almacén que esta compilación no puede migrar: crea una copia junto a él, lo elimina y empieza uno vacío. Pregunta primero; `--yes` omite la pregunta y `--no-backup` omite la copia.
- `max search all --meetings [provider:account]` también busca transcripciones, chat y resúmenes de una cuenta de reuniones; `--max-meetings <n|all>` establece cuántas consultar (100 por defecto).

### Seguridad [#seguridad-14]

- **Se elimina el antiguo `messages.db`** al abrir el almacén predeterminado: el archivo sin cifrar anterior a `wirecat.db`, junto con sus `-wal` y `-shm`. Una línea en stderr indica el archivo. Se conserva si está definido `MESSAGING_STORE` o mientras otro proceso lo tenga abierto. De `@wirecat/cli-messaging` 0.222.0.

## 0.44.0 — 10.10.2026 [#0440--10102026]

### Cambios — pueden romper scripts [#cambios--pueden-romper-scripts-25]

- **El almacén local es un archivo nuevo, `wirecat.db`, y empieza vacío.** Está junto al antiguo `messages.db`, que `max` deja intacto: no lo lee, convierte ni elimina. Ejecuta `max store fetch --all` para recuperar mensajes de MAX. Los datos que solo existen en este ordenador, como notas, alias, etiquetas, tareas y transcripciones, permanecen en `messages.db`. El inicio de sesión se conserva. Actualiza tg-cli al mismo tiempo o verán archivos diferentes.

### Novedades [#novedades-54]

- `max contacts timeline <человек>`, también el comando `contacts timeline` en MCP `max_read`, muestra la actividad de una persona en todos los mensajeros vinculados, de más reciente a más antigua, desde el almacén local. `--scope personal|work`, `--since-time`, `--until-time` y `--limit` acotan los resultados.

## 0.43.1 — 10.10.2026 [#0431--10102026]

### Corregido [#corregido-30]

- Las descargas de adjuntos usan HTTP(S) normal y el transporte configurado, sin validación DNS independiente ni restricciones de direcciones locales. Esto mantiene la compatibilidad con VPN, proxies y redes privadas; la compatibilidad con un proxy concreto depende del transporte.
- La extracción local de texto PDF y la vista de páginas ya no requieren dividir documentos después de 20 páginas; se elimina el plazo independiente de 30 segundos para la extracción. Se mantienen la cancelación del comando y los límites de tamaño.
- La transcripción local de grabaciones Ogg Opus completas, mono o estéreo, ya no rechaza audio después de 10 minutos. Las grabaciones largas requieren más memoria y tiempo.
- Vuelven a estar disponibles los adjuntos de carpetas de trabajo ocultas normales. Siguen protegidos los archivos conocidos de credenciales, las carpetas de la CLI y el almacén de mensajes.
- La exportación Markdown conserva el formato de los mensajes; MCP conserva el Unicode original al escribir y muestra los controles de forma visible en las respuestas. Los servicios de modelos configurados permiten redirecciones normales.
- La actualización y la configuración de MCP en Windows aceptan entradas relativas normales de PATH y entornos no estándar del procesador de comandos. El almacén de mensajes conserva su esquema anterior.
- La guía aclara que la búsqueda con `--discover` solo lee el archivo local. La búsqueda normal en un chat también puede consultar el servidor MAX; discovery no lo consulta.

## 0.43.0 — 10.10.2026 [#0430--10102026]

### Novedades [#novedades-55]

- La búsqueda de mensajes con `--discover` o MCP `discover: true` encuentra coincidencias parciales y respuestas directas válidas en el archivo local sin descargar modelos. La búsqueda estricta sigue siendo predeterminada; los términos ausentes ayudan al agente a comprobar la evidencia.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-26]

- El proyecto usa Apache 2.0. Consulta las condiciones en `LICENSE`.

## 0.42.0 — 10.10.2026 [#0420--10102026]

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-27]

- **El paquete se llama `@wirecat/max-cli` y el repositorio pertenece a WireCatLabs.** Usa este paquete para instalar y actualizar.
- **La eliminación verifica el resultado leyendo del servidor.** Si MAX sigue devolviendo el mensaje o falla la comprobación, informa `outcome_unknown` en lugar de `deleted`. Lee el mensaje antes de repetir; la confirmación de la petición no demuestra su eliminación.
- **La transcripción local admite Ogg Opus completo, mono o estéreo, de hasta 10 minutos.** Divide las grabaciones más largas. La extracción de texto PDF admite hasta 20 páginas y 30 segundos; divide los PDF mayores.
- **MCP hace visibles los controles Unicode ocultos** en resultados de texto y argumentos de escritura, incluida la conversión de formato. Conserva las banderas regionales; el JSON normal de la CLI mantiene las cadenas originales.

### Corregido [#corregido-31]

- **Las descargas de adjuntos por MCP terminan sin quedarse bloqueadas.** La extracción local de texto ya no bloquea la conexión necesaria para descargar.
- **`messages delete` acepta ID separados por comas** y argumentos separados.
- **Las guías MCP explican permisos del perfil y aprobación en la aplicación del agente.** El servidor no muestra formularios de aprobación; se eliminó código obsoleto no utilizado.

### Seguridad [#seguridad-15]

- **La extracción desde carpetas y transferencia de archivos guardados comprueban su ubicación.** Rechazan archivos y carpetas ocultos, carpetas de la CLI y el almacén de mensajes, incluidos destinos de enlaces simbólicos. Las descargas MCP tampoco escriben allí; usa una carpeta de descargas normal.
- **DOCX aplica los límites de archivos de Office.** Comprueba número de partes, tamaño descomprimido y tamaño de las partes de texto antes de leerlas.

## 0.41.0 — 09.10.2026 [#0410--09102026]

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-28]

- **Las reglas responden a todos los destinatarios que coinciden hasta que limitas la audiencia; desaparece la lista separada `testers`.** `max replies audience --reply listed --allow-people <id>` limita la audiencia a esas personas; `--deny-people` y `--deny-chats` excluyen destinatarios. No se envía nada mientras `permissions.replies.send` no sea `allow`; las reglas nuevas permanecen desactivadas hasta que las activas. Antes, el destinatario debía estar tanto en `testers` como en la audiencia, y ambas listas causaban confusión. Un archivo que todavía incluye `testers` sigue respondiendo exactamente a las mismas personas: pasan a la lista permitida (si la audiencia ya era `listed`, solo a las también permitidas por ella). Se eliminan los chats permitidos de ese archivo para evitar responder a todos sus miembros; las prohibiciones se mantienen. La siguiente edición con `max replies` reescribe el archivo sin `testers`.
- **`max replies status --json` ya no incluye `testers`**; los contadores `audience` muestran a quién se puede responder. En `max replies test` y `serve`, los remitentes fuera de la audiencia se omiten con el motivo «not on the allow list» en vez de «not a test account».

### Correcciones [#correcciones-18]

- **`max mcp config` incluye `MESSAGING_STORE` y `XDG_RUNTIME_DIR` en la configuración del cliente**, igual que `tg`. Un cliente que iniciaba el servidor con un entorno reducido no podía acceder al llavero en Linux y respondía «sin sesión»; con un `MESSAGING_STORE` propio buscaba en otro archivo. Ejecuta de nuevo `max mcp config` y sustituye la entrada del cliente.

## 0.40.0 — 09.10.2026 [#0400--09102026]

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-29]

- **El almacén de mensajes elimina las copias conservadas para versiones antiguas** (versión del almacén 28, cli-messaging 0.212.0). Las notas, notas sobre contactos, relaciones y entidades anteriores al nuevo sistema se trasladan una vez a las nuevas tablas durante la actualización. Después, las versiones antiguas de max, tg y memo rechazan abrirlo con «upgrade this tool»: actualiza las tres herramientas juntas.

## 0.39.0 — 09.10.2026 [#0390--09102026]

### Novedades [#novedades-56]

- **`max attachments show --page 1` devuelve una página de un PDF guardado como PNG.** Un agente remoto puede leer todas las páginas con su propia visión y guardar el texto para la búsqueda. Hacen falta los opcionales `unpdf` y `@napi-rs/canvas`; ni la API de OCR ni la escritura en el índice se ejecutan por sí solas. Si el cliente MCP solo muestra los metadatos del recurso, pide `format: base64` y muestra el PNG con las herramientas del agente.

- **`max search all "<palabras>"` busca a la vez en todo lo que se guarda en este equipo**: mensajes de MAX y Telegram, correo importado por memo y notas. Cada resultado indica su tipo: mensaje, correo o nota. `--only notes` (o `messages`, `mail`) acota la búsqueda.
- **`max search mail` y `max search notes`** buscan en un solo tipo. Las notas se encuentran por palabras y, si se ha descargado un modelo de texto local, por significado; `--type internal` (escritas en memo) o `file` (de la carpeta de notas).
- **`max search messages --type voice`** (o `text`, `file`) encuentra solo ese tipo de mensajes.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-30]

- **El `--answerer` de estadísticas acepta nombres guardados, nombres propios y @username.** La búsqueda es local, en las cuentas del historial seleccionado; si hay ambigüedad, se devuelven candidatos. Un nombre desconocido ahora da error en lugar de un informe sobre un ID inventado con cero respuestas. Para un ID de texto desconocido elegido explícitamente, usa `person:provider/account/id`. En responses aparece `identityKnown`; un ID sin observaciones recibe `false` y `status: unknown`. Cero respuestas observadas no prueba que no haya actividad ([estadísticas](/llms.mdx/docs/es/max/rankings/content.md)).

- **Toda la búsqueda se ha trasladado a `max search`.** Las órdenes antiguas ya no existen:

  | Antes | Ahora |
  |---|---|
  | `max messages search` | `max search messages` |
  | `max messages search --source email` | `max search mail` |
  | `max conversations search` | `max search conversations` |
  | `max bot messages search` | `max bot search messages` |

  Para los agentes, las herramientas se han trasladado igual: `search messages`, `search conversations` y el nuevo `search all`, por el que conviene empezar.
- **`max search messages` ya no devuelve correo.** Una búsqueda guardada con `in:email` ahora pide `max search mail`.
- **Los permisos con rutas antiguas** (`messages.search`, `conversations.search`) detienen `max search` hasta que `max config migrate` los renombre con los mismos niveles.

### Correcciones [#correcciones-19]

- **La ayuda sobre solicitudes nombra explícitamente las limitaciones de MAX.** Ya no ofrece `--all` ni `--link` como operaciones disponibles ni promete un orden por fecha; las comprobaciones de rechazo se mantienen.

## 0.38.1 — 08.10.2026 [#0381--08102026]

### Novedades [#novedades-57]

- **`max chats requests list|accept|decline` muestra y procesa solicitudes de canales.** `--search` filtra nombres. MAX no da hora: `requestedAt` es `null`. `--link` y `--all` no se admiten y se rechazan antes de consultar.

### Correcciones [#correcciones-20]

- La biblioteca compartida se actualiza a 0.205.0 para que MAX, Telegram y Memo compartan versión del archivo. No cambian el esquema de notas ni los enlaces.

## 0.38.0 — 08.10.2026 [#0380--08102026]

### Novedades [#novedades-58]

- **`max store jobs list --state <estado>`** muestra solo las tareas en segundo plano en ese estado: `running`, `done`, `failed`, `cancelled` o `died`.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-31]

- **Se buscan raíces inglesas y españolas juntas.** Antes solo españolas, con peores coincidencias inglesas. Las raíces se reconstruyen automáticamente: archivos pequeños al abrir, grandes por partes; `max serve` completa en segundo plano y `max store migrate` inmediatamente. Hasta completar se buscan formas exactas, se indica en stderr y `query.stemming.applied` es `false`. El índice latino ocupa aproximadamente el doble. Se conserva `searchStemmers.latin` propio, aplicado por `max store reindex`. Actualiza tg también: una versión antigua no usa el índice reconstruido ([archivo](/llms.mdx/docs/es/max/archive/content.md#%D0%BE%D0%B1%D1%81%D0%BB%D1%83%D0%B6%D0%B8%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D0%B0%D1%80%D1%85%D0%B8%D0%B2%D0%B0)).

- **Las notas personales (`max contacts notes`) aparecen en cada perfil que ve a esa persona.** Antes solo en el perfil original. Se guardan aparte de mensajes junto con las notas `memo`. Notas de varios perfiles aparecen juntas; los alias (`contacts alias`) siguen siendo propios de cada cuenta.

### Correcciones [#correcciones-21]

- **`max chats join` ya no presenta una solicitud como una entrada.** Si el canal aprueba a quién entra, la orden solo envía la solicitud y ahora responde `requested: true` en lugar de la ficha del canal; con `max serve` en marcha, ese canal no aparece en la lista de chats hasta que se acepte la solicitud ([grupos](/llms.mdx/docs/es/max/groups/content.md)).

## 0.37.0 — 08.10.2026 [#0370--08102026]

### Novedades [#novedades-59]

- **Botones de bots:** `messages list` y `messages show` muestran botones numerados: `[1 Да] [2 Нет]`. `max messages press <чат> <сообщение> <кнопка>` selecciona por número o texto exacto; el bot ve quién pulsó. Solo pulsa callbacks normales. Nunca comparte teléfono o ubicación; otros tipos explican el siguiente paso. Los botones aparecen al leer de MAX y no están en la copia local ([uso](/llms.mdx/docs/es/max/usage/content.md)).
- **Iniciar un bot:** `max chats start <бот> [--payload]` actúa como su botón Inicio. Acepta `https://max.ru/<бот>?start=…`, incluso si nunca le escribiste; aparece su chat. Rechaza enlaces a personas. Iniciar es un mensaje tuyo y pasa los controles de envío.
- **Miniaplicaciones:** `max chats app <бот> [--start]` imprime una dirección con tu sesión. Mantenla privada; `max` no la guarda.
- **`max account list`** muestra perfiles locales y cuentas sin consultar MAX.
- **`max bot messages list`** también muestra teclados en mensajes del propio bot.
- **`max watch --events`** muestra lecturas y cambios de chats (incluidos en 0.36.0 sin mencionarse): `read` puede ser tu otro dispositivo; `chat` refleja nombre, miembros o salida. Marcar no leído no es un evento de lectura.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-32]

- **`contacts profile`: `flags` contiene `bot`**, true para bots, false para personas; antes estaba vacío.
- **`watch --events`: `chat` aparece solo si el chat cambia** — nombre, descripción, miembros, estado, foto o propietario. Antes podía aparecer con cada envío mediante `max serve`.

### Correcciones [#correcciones-22]

- Una respuesta perdida tras iniciar un bot o pulsar un botón da resultado desconocido (`outcome_unknown`, salida 14), no un fallo seguro para reintentar. No se repite automáticamente; comprueba la respuesta del bot antes de repetir. El registro conserva el resultado desconocido.
- Consultar un grupo por enlace mediante `max serve` no añade a tu lista un grupo al que no perteneces (corregido en 0.36.0 sin mencionarse).
- `max` y grupos como `max chats` sin subcomando muestran ayuda en un terminal en lugar de `✗ (outputHelp)`. Scripts y `--json` reciben un error con `max --help`.

## 0.36.0 — 08.10.2026 [#0360--08102026]

### Novedades [#novedades-60]

- **Archivos para agentes remotos:** `attachments show` transfiere bytes guardados por porciones limitadas con SHA256. MCP devuelve imágenes completas o recursos binarios, con alternativa JSON/base64. No llama a un modelo ni cambia el índice; el agente lee y guarda el texto ([adjuntos](/llms.mdx/docs/es/max/attachments/content.md)).
- **La biblioteca compartida** añade lectura de carpetas con nombres de chats, `metadata refresh --only-missing`, reintento/limpieza de trabajos, cohortes de retención observadas y contadores con frescura explícita; los valores desconocidos no se sustituyen por cero.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-33]

- **`max contacts profile` rellena `seen`** con la última hora de presencia o `online` si MAX informa de presencia. Un campo antes vacío puede contener un valor ([personas](/llms.mdx/docs/es/max/people/content.md)).
- JSON de rankings y pruebas incluye observaciones de contadores y frescura; las pruebas admiten selecciones de cohortes de retención. Comprueba campos y tipo de selección antes de interpretar; un valor desconocido o un archivo incompleto no significa cero.

## 0.35.0 — 08.10.2026 [#0350--08102026]

### Novedades [#novedades-61]

- **`max chats delete` y `max chats clear` borran el chat o sus mensajes solo para esta cuenta.**
  Los demás los conservan. Sin `--allow-dangerous`, pregunta; sin terminal, rechaza.
- **Texto local de adjuntos:** ODT, ODS, XLSX, PPTX, EPUB, UTF-16 con BOM y codificaciones antiguas
  detectadas con confianza. Sin modelo; no calcula fórmulas y las imágenes quedan para el agente.
  Estos formatos no necesitan paquetes adicionales; PDF/DOCX conservan motores opcionales ([adjuntos](/llms.mdx/docs/es/max/attachments/content.md)).
- **Informes de administración del archivo:** preguntas sin respuesta observada, tiempo de respuesta de
  personas elegidas, ayuda tras una entrada conocida y publicaciones vistas con poca conversación.
  Las selecciones/pruebas muestran los mensajes; lo desconocido no demuestra ausencia de respuesta ([clasificaciones](/llms.mdx/docs/es/max/rankings/content.md)).
- **Stickers: `max stickers list` y `max messages send --sticker <id>`.** Lista paquetes añadidos;
  `--set <id>` muestra sus stickers e ids. Envía un sticker sin texto ni archivos.
- **`max chats mute` y `max chats unmute`** cambian solo tus notificaciones, para siempre o con `--until 8h`.
- **`max account privacy set`** cambia `--find-by-phone`, `--phone-number`, `--calls`,
  `--chat-invites` (everyone, contacts, nobody) y `--hide-online on|off`; mantiene los demás ajustes.
  MAX solo admite everyone/contacts para encontrar por teléfono; rechaza `nobody`.
- **`max chats media`** lee fotos, vídeos, archivos, audio y enlaces del servidor con `--type` y
  `--before-id` ([uso](/llms.mdx/docs/es/max/usage/content.md#%D0%BC%D0%B5%D0%B4%D0%B8%D0%B0-%D1%87%D0%B0%D1%82%D0%B0)).
- **`max calls list`** muestra llamadas entrantes, salientes, perdidas y duración, las nuevas primero.
- **`max account privacy show`** muestra quién encuentra, ve el número, llama o añade la cuenta y
  si se oculta el estado; usa la respuesta de acceso sin otra petición.

## 0.34.0 — 08.10.2026 [#0340--08102026]

### Novedades [#novedades-62]

- **`max chats update --photo` establece la foto de un grupo o canal** ([grupos](/llms.mdx/docs/es/max/groups/content.md)).
- **`max chats folders order` cambia el orden de las carpetas.** Primero va la carpeta obligatoria «Todos los chats», después las carpetas indicadas y luego las restantes en su orden anterior ([uso](/llms.mdx/docs/es/max/usage/content.md)).
- **Tus propios nombres y notas sobre personas: `max contacts alias` y `max contacts notes`.** Se guardan solo en este ordenador y no se envían a MAX; `contacts show --with-notes` los muestra y `contacts list --search-notes` los busca ([uso](/llms.mdx/docs/es/max/usage/content.md#%D1%81%D0%B2%D0%BE%D0%B8-%D0%B8%D0%BC%D0%B5%D0%BD%D0%B0-%D0%B8-%D0%B7%D0%B0%D0%BC%D0%B5%D1%82%D0%BA%D0%B8-%D0%BE-%D0%BB%D1%8E%D0%B4%D1%8F%D1%85)).
- **Etiquetas automáticas de grupos y canales: `max metadata refresh` y `max tags auto`** — a partir del nombre y la descripción, sin leer mensajes; tus etiquetas no se modifican ([búsqueda](/llms.mdx/docs/es/max/search/content.md#%D0%BC%D0%B5%D1%82%D0%BA%D0%B8)).
- **`max store fetch --all` descarga todos los chats** — los últimos 90 días de cada uno; `--background` lo ejecuta en segundo plano. La búsqueda indica cuántos mensajes y chats ha revisado y cuántos chats no se han descargado o están desactualizados; `coverage.next` en JSON indica al agente qué comando ejecutar antes de concluir que un mensaje no existe.
- **Las métricas de respuestas y debates utilizan los vínculos de respuesta de MAX guardados.** Si los datos son incompletos, el vínculo queda como desconocido en lugar de suponerse.
- La [guía de clasificaciones](/llms.mdx/docs/es/max/rankings/content.md) explica las métricas, puntuaciones, cobertura, selecciones guardadas y pruebas.
- Las nuevas guías explican los [adjuntos](/llms.mdx/docs/es/max/attachments/content.md), el [reconocimiento de voz](/llms.mdx/docs/es/max/audio-recognition/content.md) y la [configuración de modelos externos](/llms.mdx/docs/es/max/external-models/content.md).

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-34]

- **`max session end` cierra la sesión en MAX, en lugar de limitarse a olvidar el token aquí** — como `tg session end`. `revokedOnServer` ahora es `true`. Si el token se copió de una pestaña de web.max.ru, esa pestaña también cerrará la sesión ([sesiones](/llms.mdx/docs/es/max/sessions/content.md)).

- **`max messages search` en un solo chat también consulta el servidor de MAX.** Con `--chat` o `chat:` y palabras, busca por defecto en el archivo y el servidor (`--backend both`), y encuentra mensajes aún no descargados. Los resultados del servidor se comprueban con la misma consulta; cada mensaje tiene un campo `source`. `--backend archive` busca solo en el archivo; `--server-time` indica cuánto esperar al servidor (5 segundos). Sin un chat, se busca solo en el archivo ([búsqueda](/llms.mdx/docs/es/max/search/content.md)).
  Ten en cuenta: buscar en un chat ahora puede conectarse a MAX; `--backend archive` mantiene la búsqueda local.

### Correcciones [#correcciones-23]

- **Las solicitudes MCP preparadas utilizan los disponibles `max_read` y `max_write`**, en lugar de los antiguos nombres de herramientas individuales. Sus búsquedas comprueban `coverage.next` antes de concluir que un mensaje no existe.

- **Las selecciones guardadas conservan los límites de fecha exclusivos al ejecutarse de nuevo**, por lo que los mensajes justo en el límite quedan excluidos. MCP ya no ofrece al agente operaciones de carpetas no disponibles.

- **`max serve --timeout` cierra el servidor.** Al agotarse el tiempo, se cierran la conexión, el inicio de sesión pendiente y las tareas en segundo plano; el proceso termina con el código de tiempo de espera agotado.

## 0.33.0 — 07.10.2026 [#0330--07102026]

### Novedades [#novedades-63]

- **`max stats messages top` y `max stats contacts top` clasifican los mensajes guardados y sus autores**, y el campo `evidence` de cada entrada muestra qué mensajes explican su posición. Todo se calcula con la copia local; no se envía nada a MAX. `searches create --selection` guarda esa clasificación como una búsqueda.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-35]

- **Cada perfil comparte ahora un único ritmo de solicitudes a MAX entre todos los procesos `max`.** Antes, los comandos simultáneos, `store fetch` en segundo plano, `mcp` y `serve` hacían sus pausas por separado y, juntos, contactaban con MAX más a menudo. Ahora comparten un cupo: 10 solicitudes seguidas y después 20 por minuto.
  Por qué: MAX bloquea las cuentas por un exceso de solicitudes, y las tareas en paralelo las multiplicaban.
  Ten en cuenta: las descargas masivas en paralelo tardan más; un comando que tendría que esperar más de 5 minutos termina de inmediato con el código `8`. Cambia el ritmo con `requestsPerMinute` o `MAX_REQUESTS_PER_MINUTE`; `0` lo desactiva. Consulta los límites en [limits.md](/llms.mdx/docs/es/max/limits/content.md).
- **`max messages send` ya no tiene la opción `--comment-to`.** Apareció en 0.32.0 con el código compartido de Telegram, pero en MAX solo rechazaba la operación con el código 2.
  Ten en cuenta: un script que pase `--comment-to` sigue recibiendo el código 2, ahora con un mensaje de opción desconocida.

## 0.32.0 — 07.10.2026 [#0320--07102026]

### Novedades [#novedades-64]

- **Las fotos y los escaneos de adjuntos se pueden reconocer por lotes con el modelo elegido.** Por defecto, el agente sigue leyéndolos por sí mismo y guarda el texto con `attachments text set`. Para procesarlos por lotes, usa `attachments extract --ocr` con el modelo de `models.ocr` y `--concurrency`; el texto reconocido entra en la búsqueda existente con `content:`.
  Ten en cuenta: `--ocr` envía archivos al proveedor del modelo elegido, por lo que debe activarse de forma explícita. La caché tiene en cuental archivo y el modelo; un fallo de la API no sobrescribe el texto del agente ni el índice anterior.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-36]

- **`max contacts profile` muestra los nombres anteriores de una persona en el nuevo campo `aliases`.** Antes, la copia local recordaba solo el nombre actual: un nombre nuevo de un mensaje o de la sincronización de contactos sobrescribía el anterior.
  Por qué: es más fácil reconocer por un nombre anterior a alguien que ha cambiado de nombre.
  Ten en cuenta: la respuesta `--json` incluye ahora `aliases`, una lista de `{ name, firstSeenAt, lastSeenAt, source }` de más antiguo a más reciente. `source: messages` indica un nombre de los mensajes guardados y es aproximado. La lista queda vacía hasta que la copia haya observado un cambio de nombre. `from:` busca solo por el nombre actual. [Personas](/llms.mdx/docs/es/max/people/content.md).
- **`max messages send` añadió `--comment-to`, pero no funciona en MAX: el comando rechaza la operación con el código 2 y no envía nada.** La opción se comparte con Telegram, donde publica un comentario bajo una publicación de canal.
  Ten en cuenta: MAX no admite comentarios bajo publicaciones de canales; no uses esta opción en scripts.

## 0.31.0 — 07.10.2026 [#0310--07102026]

### Novedades [#novedades-65]

- **Preparación de la búsqueda y reparación del archivo.** Extracción de texto mediante MCP, `attachments extract --from-dir` y `messages download --extract`; comprobación de archivos modificados por hash. `store fetch --catch-up` prepara el grafo y los vectores locales instalados dentro de los límites indicados; está desactivado por defecto. `store gaps plan/repair` y MCP muestran los huecos internos registrados y los descargan de forma explícita con límites y tareas. Los extremos desconocidos y las páginas ambiguas no se consideran un archivo completo.

- **Las listas de miembros de los grupos en seguimiento se actualizan a diario mientras funciona MAX server.** Está disponible `chats members fetch --track`; el seguimiento no amplía el tiempo de espera por inactividad del servidor.

- **`max setup` es más fácil de leer.** Cada paso tiene un encabezado como `[1/4] This computer`, con lo ocurrido debajo y con sangría; las preguntas y el código QR aparecen bajo su paso, con líneas en blanco alrededor del código. El resultado es una tabla alineada cuya primera fila indica el comando con el que empezar. La salida `--json` y sus claves no cambian; `--quiet` sigue ocultando los pasos.

- **Las plantillas de respuestas automáticas utilizan Liquid y bloques `ai` separados.** `models.replies` elige el proveedor; `replies consents` concede consentimiento para un perfil y un endpoint, con exclusiones para chats concretos. `replies test` normal no llama al modelo; `--ai` pasa explícitamente los datos guardados. Las plantillas antiguas conservan un texto alternativo con una advertencia. El envío sigue limitado por `testers` y `replies.send`; consulta la [guía](/llms.mdx/docs/es/max/replies/content.md).
- **`max serve` abre tareas a partir de las reglas de respuesta automática.** Consúltalas con `max tasks list` o el prompt MCP `open-tasks`; crear una tarea no envía nada.
- **La conexión desde el navegador está documentada para Windows, macOS y Linux.** La guía distingue Tailscale del servidor, proporciona comandos de PowerShell y explica los permisos temporales de envío, la conexión de Codex web, cómo ejecutar dos mensajeros y cómo detener túneles individuales. [Conexión](/llms.mdx/docs/es/max/remote/content.md).

- **Los ajustes, permisos y perfiles se explican por separado.** Las guías empiezan con tareas habituales, la ubicación del archivo y ejemplos; la referencia completa sigue disponible.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-37]

- Contrato del SDK 0.161.0: modo sin interacción, límites de entrada, salida y tiempo, esquemas de comandos, selección de campos, vistas previas y reglas para reintentar escrituras. Las estadísticas utilizan `stats <ресурс> <вид>` sin los antiguos alias.
- MCP utiliza tres herramientas de búsqueda, lectura y escritura en lugar de una herramienta por comando; no hay formularios de confirmación del servidor. Se mantienen los permisos del perfil y las reglas de moderación independientes.
- Los ajustes se dividen en una guía breve y una referencia completa; se añaden una página para usuarios sobre el contrato de la CLI y una comprobación de la habilidad del agente en CI.

- **Las estadísticas se consultan con `stats messages show`, `stats chats show` y `stats tasks show`.** Se eliminan las antiguas rutas `messages stats`, `chats stats`, `tasks stats`; actualiza los comandos y los permisos exactos a `stats.messages.show`, `stats.chats.show`, `stats.tasks.show`. Las herramientas MCP se llaman ahora `max_stats_messages_show`, `max_stats_chats_show`, `max_stats_tasks_show`.
- **Los errores de sintaxis devuelven el código 2 y un error JSON estructurado.** Los scripts que esperaban el antiguo código 1 o texto normal deben actualizar su tratamiento de errores.

- **La primera carga de ajustes crea config.json.** No se sobrescribe un archivo existente; las variables de entorno y las opciones del comando no se guardan en él. config show ahora puede crear el archivo, y los valores habituales muestran el archivo defaults como origen.
- **La búsqueda de palabras y frases encuentra formas de las palabras.** Las consultas de los scripts pueden devolver más mensajes. Para la coincidencia exacta anterior, usa exact: o --exact; text: explícito sigue buscando formas de las palabras. Los ajustes de idioma del archivo determinan las coincidencias.

### Correcciones [#correcciones-24]

- **La preparación de la búsqueda respeta la prohibición de escribir vínculos.** `conversations.links: readonly` o `deny` detiene la preparación tras la descarga y durante la reparación de huecos, antes de conectarse o iniciar una tarea. `--no-catch-up` explícito sigue permitiendo leer el historial normalmente según las reglas del perfil.

- El contexto de una persona encuentra conversaciones privadas sin una lista de miembros registrada cuando el ID del diálogo coincide con el ID de la persona; vuelven a estar disponibles los mensajes recientes en ambas direcciones.
- La documentación de MCP utiliza las rutas de comandos y los permisos actuales, sin los formularios de confirmación eliminados.

- Al interrumpirse una escritura, se conservan los valores originales `outcome_unknown`, `operationId` y los datos de reintento devueltos por el comando: la biblioteca compartida se actualiza a 0.161.0.

- **Un tiempo de espera agotado durante una escritura de Bot API conserva un resultado desconocido.** La operación puede haberse completado; comprueba el estado antes de reintentar.

- **MCP de MAX no ofrece herramientas de foros no compatibles.** La búsqueda de comandos ya no ofrece modificar ni ordenar topics de Telegram.

## 0.30.0 — 06.10.2026 [#0300--06102026]

### Novedades [#novedades-66]

- **`max stats charts --output activity.png` guarda un gráfico PNG con tema oscuro.** SVG sigue disponible; las imágenes solo se escriben en archivos nuevos. MCP `max_stats_charts` con `format: "png"` devuelve una imagen junto con JSON, sin conectarse a MAX ni escribir archivos. Sin `format`, MCP sigue devolviendo JSON.
- **Las reglas de respuesta automática se pueden editar con `max replies add|edit|on|off` y `audience`.** Una regla nueva está desactivada hasta que se activa explícitamente; los cambios se guardan solo localmente, sin enviar mensajes. Las respuestas automáticas siguen limitadas a cuentas de prueba; la lista `testers` se sigue definiendo en el archivo. [Respuestas automáticas](/llms.mdx/docs/es/max/replies/content.md).
- **`max tasks` muestra qué espera tu respuesta.** `max review` mantiene en la copia local una tarea para una pregunta sin responder o un mensaje que te menciona, y la cierra cuando respondes; ahora estas tareas son visibles. `max tasks list` las muestra con un enlace al mensaje; `max tasks add <сообщение> --type promise` añade lo que las reglas no detectan; `max tasks close <задача> --as done|dismissed` cierra una tarea para siempre; `max tasks stats` las cuenta por chat. MCP `max_tasks_list`, `max_tasks_add`, `max_tasks_close`, `max_tasks_stats` ofrece lo mismo al agente. Todo queda en este ordenador; no se envía nada a MAX. Las escrituras requieren los permisos `tasks.add` y `tasks.close`.
  Ten en cuenta: MCP incorpora cuatro herramientas más; `max serve` aún no abre tareas en MAX. [Qué espera tu respuesta](/llms.mdx/docs/es/max/groups/content.md#%D1%87%D1%82%D0%BE-%D0%B6%D0%B4%D1%91%D1%82-%D0%B2%D0%B0%D1%88%D0%B5%D0%B3%D0%BE-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0).
- **La búsqueda semántica abarca los mensajes largos completos.** Antes de crear el embedding, los mensajes de más de unos 1200 caracteres se dividen en fragmentos superpuestos, de modo que se lee todo el mensaje y no solo el principio. Los chats preparados antes se consideran desactualizados: se reconstruyen con `conversations build` o `search --refresh` (cli-messaging 0.153.0; el almacén pasa a la versión 21, en la que las compilaciones antiguas pueden seguir escribiendo).
- **MCP realiza escrituras permitidas desde clientes web sin formularios del servidor.** `--http-confirmation permissions` respeta los niveles de permiso: `allow` no exige formulario del servidor y `ask` sí. Por defecto, cada escritura sigue exigiendo un formulario. La opción repetible `--permission ключ=уровень` modifica los permisos solo mientras funciona el servidor, sin cambiar los ajustes. La confirmación de la aplicación es independiente y el servidor no la comprueba.
  Ten en cuenta: en este modo, el agente del navegador realiza sin formulario todo lo que el perfil permita con `allow`, incluido el envío de mensajes; revisa los permisos antes de activarlo. [Conexión](/llms.mdx/docs/es/max/remote/content.md).

### Correcciones [#correcciones-25]

- **Las descripciones de las herramientas MCP de seguimiento de miembros tienen en cuenta la recogida manual en MAX.** Ya no prometen lecturas diarias mediante `serve` ni ofrecen el no disponible `fetch --track`. La lista de grupos y las instantáneas guardadas se siguen leyendo del almacén local.

## 0.29.0 — 06.10.2026 [#0290--06102026]

### Novedades [#novedades-67]

- **`max chats tracking list|show|add|remove` gestiona los grupos cuyo número de miembros se sigue.** Consulta las instantáneas guardadas del número de miembros, añade un grupo sin leerlo inmediatamente o quítalo conservando su historial. Para registrar los miembros, utiliza `max chats members fetch`. En MAX, `serve` todavía no lee los miembros diariamente: repite la recogida manualmente o con tu propia programación.
- **Perfil de una persona.** `max contacts profile <человек>` muestra lo que MAX informa sobre una persona: nombre, enlace, descripción, fecha de creación de la cuenta (`registered`, según MAX) y si tiene foto propia. Para cada chat compartido muestra cuántos mensajes tiene guardados, el primero y el último. Si MAX proporciona un teléfono, aparecen sus cuatro últimos dígitos; `--show-phone` lo muestra completo. Una petición adicional a MAX respecto a `contacts show`. MCP: `max_contacts_profile`.
- **Respuestas por reglas, solo a cuentas de prueba.** `max serve` responde a mensajes entrantes con las reglas de `<профиль>.replies.json`, solo a personas incluidas en `testers` y únicamente con `permissions.replies.send allow`. Comandos: `max replies test`, `pause`, `resume`, `status`. Véase [docs/replies.md](/llms.mdx/docs/es/max/replies/content.md).
- `max contacts context <человек> --chat <чат>` (repetible) devuelve los mensajes recientes de esa persona en cada chat, con fecha y texto para que el agente los resuma. `-v` añade identificadores y enlaces; `--limit` se aplica por chat; `--refresh` consulta primero la última página del chat en MAX.
- Utiliza cli-messaging 0.152.0.
- **`max contacts check <человек>` comprueba si una persona parece un bot.** Valora el perfil y los mensajes guardados (ningún mensaje, un enlace como primer mensaje, el mismo texto en varios chats), con una fuente para cada motivo. Las listas públicas de remitentes de spam cubren solo Telegram, así que no se consultan para MAX. `max chats members audit
  --deep <n>` comprueba los primeros n miembros de la misma forma, uno por segundo.

- **`max chats members fetch` guarda instantáneas de miembros; `history` muestra los cambios.** El historial se consulta sin conexión, con `--since-time`. `--budget` limita la instantánea; las salidas solo se registran tras una lectura completa. El seguimiento diario espera soporte del servicio en segundo plano de MAX. [Trabajo con miembros](/llms.mdx/docs/es/max/groups/content.md#%D1%81%D0%BD%D0%B8%D0%BC%D0%BA%D0%B8-%D1%83%D1%87%D0%B0%D1%81%D1%82%D0%BD%D0%B8%D0%BA%D0%BE%D0%B2).

- **`max stats charts` dibuja estadísticas del chat.** Devuelve una descripción neutra en JSON; `--output` guarda un SVG oscuro de mensajes, autores activos, entradas y salidas por día o semana. Las fechas ausentes quedan como huecos y los datos incompletos se indican. No sobrescribe archivos existentes. MCP `max_stats_charts` devuelve la descripción del archivo local; PNG llegará por separado. La biblioteca nueva añade unos 61,6 MiB descomprimidos antes de la deduplicación y se carga en el proceso solo al pedir una imagen. [Uso](/llms.mdx/docs/es/max/usage/content.md#%D0%B3%D1%80%D0%B0%D1%84%D0%B8%D0%BA%D0%B8-%D1%81%D1%82%D0%B0%D1%82%D0%B8%D1%81%D1%82%D0%B8%D0%BA%D0%B8).

- **`max store fetch` también conserva las reacciones a publicaciones de canales.** MAX incluye el número de reacciones en el historial del canal; `max` ahora lo conserva, por lo que `max chats stats` puede ordenar publicaciones por reacciones sin otra petición.

- **`max chats stats <чат>` muestra cifras de un grupo o canal durante un periodo.** Mensajes, autores activos, respuestas, reacciones, publicaciones destacadas, preguntas y tiempos de respuesta, entradas y salidas. Calcula con el archivo local y consulta las entradas y salidas a MAX. Con historial incompleto, las cifras son mínimos y el comando sugiere un `store fetch` para completarlo.

- **La búsqueda lee el texto de archivos.** `attachments extract` guarda texto TXT, DOCX y de PDF con capa de texto; `content:` lo busca. DOCX/PDF requieren los paquetes opcionales `mammoth`/`unpdf`; el agente lee fotos y documentos escaneados y guarda el resultado con `attachments text set`. Por defecto solo lee archivos descargados; `--download --output-dir` los descarga primero de forma explícita.
- **Actualizar antes de buscar y seguir las respuestas.** `--sync-first` limita la descarga a cinco chats, 500 mensajes y 30 segundos; una actualización incompleta no oculta los resultados locales. `--thread` añade un grafo acotado de respuestas con la procedencia de los enlaces; sin grafo utiliza el contexto cronológico.
- **La búsqueda de conversaciones acepta filtros estrictos y un alcance explícito de cuentas.** `--filter` limita las conversaciones antes de ordenarlas; al menos un mensaje debe cumplir todo el filtro. `--source` amplía el alcance explícitamente. Un agente puede enlazar mensajes íntegramente mediante MCP: instrucciones `link-conversations`, lotes, almacenamiento de enlaces y reconstrucción del grafo.
- **Los modelos de vectores y análisis se configuran por separado para cada perfil.** Los vectores locales y tu agente siguen siendo los valores predeterminados. Un servicio externo recibe texto solo al seleccionarlo explícitamente; `build --analyze --chat` pide consentimiento y lo recuerda para la cuenta, el chat y el servicio hasta revocarlo.

- **Etiquetas propias: `max tags add`, `remove` y `list`.** Etiqueta un chat (`--chat`), persona (`--contact`) o mensaje (`--message`); `tag:<метка>` encuentra lo etiquetado. Las etiquetas se guardan en el archivo local y nunca se envían a MAX. Una etiqueta contiene de 1 a 32 letras latinas, cifras o guiones. El agente dispone de las mismas acciones mediante MCP. Véase [Búsqueda de mensajes](/llms.mdx/docs/es/max/search/content.md).
- **Consultas guardadas: `max searches` y `--saved`.** `max searches create <имя> [запрос]` guarda una consulta con sus opciones; `max messages search --saved <имя>` y `max messages stats --saved <имя>` la ejecutan. Las palabras añadidas a `--saved` restringen la consulta; las opciones de la línea de comandos sustituyen las guardadas. `searches list`, `show`, `history`, `delete` y `clear` muestran y limpian las consultas y el historial. La consulta de `messages search` ahora es opcional si se indica `--saved`.
- **`max contacts context <человек>` muestra lo que el archivo sabe sobre una persona.** Chats compartidos, últimos mensajes en ambas direcciones, mensajes recientes y menciones. Lee el archivo sin marcar mensajes como leídos. `max contacts link` registra que una cuenta de MAX y otra de Telegram pertenecen a la misma persona, para que `context` incluya ambas; `max contacts unlink` deshace el enlace. Como `context` devuelve texto de mensajes, `permissions.messages: deny` también lo bloquea.
- **`max store repair` repara la estructura del archivo sin borrar datos.** Conserva una tabla con estructura distinta como copia junto a la nueva y la nombra en el resultado. `--dry-run` muestra los cambios sin aplicarlos. `max store copies delete <имя>` borra una copia conservada. Véase [Archivo](/llms.mdx/docs/es/max/archive/content.md).
- **La búsqueda puede usar raíces de palabras al activarlas.** `max config set searchStemmers.cyrillic russian` y `searchStemmers.latin spanish` (o `english`) configuran todo el archivo, todos los perfiles y ambos mensajeros. Después hay que ejecutar `max store reindex`.
- **`max flood clear` olvida las esperas recordadas y levanta las retenciones de envío.** Aparecen en `max server status`, en el nuevo campo `flood`. MAX todavía no informa de cuánto hay que esperar, así que estará vacío para una cuenta personal de MAX. La pausa de inicio de sesión que muestra `max doctor` sigue evitando accesos demasiado frecuentes. No hay herramienta MCP deliberadamente: el agente no debe levantar una restricción.
- **Tres guías de búsqueda.** [Búsqueda de mensajes](/llms.mdx/docs/es/max/search/content.md) cubre búsquedas cotidianas por palabras, personas, fechas, archivos, enlaces y etiquetas; [búsqueda por temas](/llms.mdx/docs/es/max/topic-search/content.md), conversaciones, vectores y texto enviado a modelos externos; [lenguaje de consultas](/llms.mdx/docs/es/max/query-language/content.md) es la referencia.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-38]

- **La búsqueda semántica con e5-small local descarta coincidencias débiles antes de combinarlas con las de palabras.** La similitud coseno debe superar 0,80; las coincidencias de palabras se mantienen. Puede haber menos resultados, y un resultado encontrado por ambos métodos puede quedar solo como coincidencia de palabras.
- **El archivo incorpora tablas de texto de adjuntos y de consentimiento de análisis.** Es una migración local al abrirlo por primera vez; se conservan los mensajes anteriores. Haz una copia de seguridad de un archivo grande antes de actualizar.

- **El archivo ahora conserva todas las consultas correctas de `messages search` y `messages stats`, tanto de CLI como de MCP.** Guarda la consulta y sus opciones, nunca los mensajes encontrados, y conserva las últimas 1000 ejecuciones. Sirve para `searches history` y `--saved`. Si no deben quedar consultas en disco, utiliza `--no-record` o `max config set record false`; `max searches clear` vacía el historial sin borrar consultas guardadas.
- **El archivo migra al nuevo esquema al primer uso.** Incorpora tablas de etiquetas, consultas guardadas y raíces de palabras; `max store migrate` completa el índice de raíces para mensajes existentes. En archivos grandes, `store migrate` y `store reindex` tardan más. El archivo es compartido con `tg`; las versiones anteriores de `max` y `tg` todavía pueden abrirlo.
- **`max inbox`, `inbox --new`, `review` y `chats list --unread` (también con `--search` y `--kind`) revisan todos los chats que MAX devuelve al iniciar sesión, en vez de los 200 más recientes.** Antes se omitían silenciosamente chats con mensajes no leídos situados más abajo. Cada ejecución sigue procesando como máximo 20 chats y nombra los demás en `skipped N chats`. Ahora `partial: true` solo significa que MAX no devolvió todos los chats al iniciar sesión.
- **`max chats list` indica `hasMore: true` en la última página no vacía si MAX devolvió una lista incompleta.** Antes parecía completa. Los scripts que paginan hasta `hasMore: false` se detienen en la página vacía.
- **`max messages list` y `max store fetch` ya no consideran una página corta como el inicio del chat.** MAX no indica si hay mensajes anteriores, y una página puede tener menos mensajes que `--limit` incluso en medio de una conversación. Tras una página corta, `max` pide ahora un mensaje más antiguo: si existe, `hasMore: true`; si no, es el inicio del chat. Ten en cuenta: esto añade una solicitud a MAX por cada página corta, y `hasMore` será `true` más a menudo.
- **`max config set` y `config unset` aceptan `searchStemmers.cyrillic` y `searchStemmers.latin`; `config show --json` los muestra en el nuevo campo `storeSettings`.** Se guardan en el archivo, no en el fichero de configuración, por lo que rechazan `--defaults`, `--personal` y `--bot`; no se pueden modificar bajo `MAX_PROFILE_LOCK`.

### Correcciones [#correcciones-26]

- Los errores del fichero de reglas de respuestas ya no imprimen fragmentos de ese fichero en el registro del servicio.

- **`max mcp --http`: Claude y ChatGPT ya pueden completar el inicio de sesión.** La página de acceso hacía que el navegador enviara el formulario sin origen y `max` respondía «Origin not allowed». Ahora funciona (cli-messaging 0.152.0).

- **Un localizador de mensaje de otra cuenta ya no abre un mensaje con el mismo número en la cuenta actual.** `messages show/context` lo rechaza; MCP acepta `offline: true` para el contexto local ordinario.

- **La búsqueda estricta `text:/…/` encuentra palabras igual que la búsqueda por palabras.** Antes `text:/Квартир.*/` y `text:/счёт/` no encontraban palabras guardadas por las mayúsculas y la letra ё. `body:` sigue distinguiendo mayúsculas.
- **Los errores de búsqueda estricta indican qué hacer.** `~` sugiere `--language legacy` y `слово*`; un prefijo corto como `к*` indica el límite de 10 000 palabras y pide uno más largo; `index_not_ready` muestra el progreso del índice y el comando exacto `max store migrate`.
- **MCP no guarda el historial de consultas cuando se desactiva el registro.** Antes `record: false` solo desactivaba el historial en la línea de comandos.
## 0.28.0 — 04.10.2026 [#0280--04102026]

### Novedades [#novedades-68]

- MCP `max_chats_stats` calcula la actividad de un grupo o canal a partir del archivo local; no consulta las entradas ni las salidas. `max chats members audit` muestra señales de miembros sospechosos, sin eliminar a nadie.
- MCP `max_inbox` y `max_review` aceptan `kinds` y `new`, con marcas por chat separadas de las de la CLI.

- **`max messages stats` cuenta mensajes del archivo local por chat, remitente, día u hora.** La consulta usa Lucene estricto; sin ella, se cuentan todos los mensajes guardados de la cuenta actual. No usa la red; `--source max` incluye explícitamente los demás perfiles. En un archivo incompleto, el resultado es un límite inferior; revisa `coverage` y `completeness`.
- **`max mcp --http --public-url https://<имя>.ts.net` abre `max` a ChatGPT y Claude en el navegador.** Las herramientas MCP se ofrecen en `127.0.0.1` detrás de tu propio túnel, con acceso propio: la aplicación necesita un código de un solo uso que `max` muestra en el terminal. Cada cambio pregunta antes mediante un formulario en la aplicación. El acceso dura 30 días; `max mcp --revoke` los cierra todos. [docs/remote.md](/llms.mdx/docs/es/max/remote/content.md) sustituye el montaje con un proxy de terceros.

- El MCP personal usa el mismo conjunto de esquemas que Telegram: dispositivos, búsqueda de contactos por teléfono, carpetas, miembros, invitaciones, configuración del grupo, encuestas, pruebas locales y conversaciones. Los temas de Telegram no existen en MAX. Se conservan los nombres antiguos de comprobación y reglas del grupo.
- Un envío programado confirmado usa la hora del formulario, aunque la respuesta llegue más tarde.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-39]

- `coverage.inventoryComplete` indica ahora que se ha recibido la lista completa de chats, y `lastSyncedAt`, la carga más antigua dentro de la cobertura; las entradas de `completeness` incluyen `fetchedAt`. Un archivo existente obtiene estos datos tras la siguiente lista completa y la descarga del historial. `/catch-up` acepta `kind` y `mode` en lugar de `since`.
- `config set permissions` rechaza órdenes desconocidas, incluidas erratas dentro de un objeto completo, con el código 2. `config unset` permite eliminarlas; al leer un archivo existente se avisa y se continúa.

- Los argumentos de MCP usan los nombres comunes: `at_time`, `md`, `since_time`, `before_n`, `after_n`, `unanswered`; `send_id` es ahora una cadena. Los argumentos desconocidos se rechazan antes de ejecutar. Actualiza las llamadas según el esquema de `tools/list`. En `max_inbox` y `max_review`, el parámetro `all: true` incluye los chats silenciados y archivados; sin él, solo quedan las menciones al propietario.

### Correcciones [#correcciones-27]

- La búsqueda y las estadísticas muestran la cobertura real del archivo local y la hora de la última carga. `wordsReady` ya no promete un índice de palabras listo para búsquedas solo con filtros o regex. `store fetch` ignora la marca de inicio del historial si aparecen mensajes más antiguos en el archivo.
- `server status` informa del código de cierre normal del servicio y del motivo de la parada sin volver a iniciarlo.

## 0.27.0 — 04.10.2026 [#0270--04102026]

### Novedades [#novedades-69]

- **La instalación global con npm configura el PATH de Windows y el skill del agente.** Conserva las entradas existentes y permite ejecutar `max` en terminales nuevas. Un agente que ya está abierto debe actualizar su entorno. El skill se instala antes de iniciar sesión; `MAX_INSTALL_AGENT=none` lo desactiva. La instalación local y npx no cambian el entorno del usuario.

- **`max commands messages search --json` describe un comando; `max commands messages --json`, un grupo.** El agente ya no necesita leer el árbol completo antes de cada tarea. Se conservan las opciones globales y los códigos de salida. Las palabras tras `commands` indican una ruta; consulta otros grupos en llamadas separadas. Sin ruta, sigue devolviendo el árbol completo.

- **`max messages link` y MCP `max_messages_link` devuelven un locator del mensaje del archivo local.** El destino se valida con la cuenta actual; se rechazan locators de otra cuenta. MAX personal aún no tiene un formato de permalink verificado: `url` es `null` y la respuesta indica el motivo. `--offline` no conecta con MAX. Consulta [mensajes](/llms.mdx/docs/es/max/usage/content.md).

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-40]

- **CLI y MCP usan `permissions` con los niveles `deny`, `readonly`, `ask` y `allow`.** Comandos y agentes comparten permisos. La mayoría de escrituras por MCP están ahora disponibles por defecto; eliminar mensajes y cerrar otras sesiones requiere confirmación salvo que exista un `allow` explícito. Por ejemplo, `messages: readonly` junto con `messages.delete: allow` permite leer y eliminar sin preguntar, pero prohíbe las demás escrituras en mensajes; no limita otros recursos. Antes de actualizar, revisa los permisos del agente y asigna `readonly` o `deny` a los recursos que quieras restringir. `--confirm-send` exige un formulario antes de cada escritura; en JSON, `ask` necesita una opción explícita.

- **`config migrate` convierte los ajustes antiguos de acceso y los niveles de moderación.** `--dry-run` muestra cambios sin escribir. Conserva los permisos efectivos, los ajustes MAX y las posiciones guardadas de comprobación de grupos. Cuando existe `permissions`, no se pueden cambiar `readOnly`, `allow` ni `mcpTools`. Los antiguos `--allow-send`, `--allow-mark-read`, `--allow-delete` y `--allow-moderate` se aceptan con aviso, pero no otorgan permisos. Siguen vigentes la lista de destinatarios y el límite por hora. Consulta [configuración](/llms.mdx/docs/es/max/configuration/content.md) y [MCP](/llms.mdx/docs/es/max/mcp/content.md).

### Correcciones [#correcciones-28]

- **La apertura simultánea del archivo local espera un bloqueo breve de SQLite al arrancar.** Antes, la configuración del journal podía encontrar una base ocupada antes de activar la espera y fallar de inmediato. Un bloqueo prolongado sigue causando un error. Este cambio no inicia la descarga del historial.

## 0.26.0 — 03.10.2026 [#0260--03102026]

### Novedades [#novedades-70]

- **`max skill show link-conversations` imprime el skill compartido para relacionar conversaciones.** Funciona sin sesión; sin nombre, sigue mostrando el skill principal de MAX.

- **`max messages evidence` devuelve un paquete limitado del archivo local**, con locator, información de integridad y continuación mediante `--before-id`. No conecta con MAX.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-41]

- **Las fotos descargadas reciben su extensión según el MIME HTTP**, por ejemplo `.webp` para WebP, en lugar de JPEG según el tipo de adjunto. Se conservan los nombres originales; no hay consultas preliminares adicionales.

- **`max account show` usa el formato de cuenta compartido con Telegram.** JSON añade `username: null`; mantiene los campos MAX, el teléfono oculto y `--show-phone`.

- **`max sends list` respeta el `limit` configurado, como Telegram.** Antes seleccionaba siempre 20 intentos sin opción explícita. El campo JSON `limit` muestra el límite elegido; mantiene `items`, `page` y `hasMore`. `--limit` tiene prioridad sobre el ajuste.

- **`max messages download` admite `--all`, `--output-dir` y `--pause`, como Telegram.** Crea el directorio y, al repetir la descarga del chat completo, continúa desde el progreso guardado. `--output` sigue siendo un nombre compatible para el directorio. El JSON de un mensaje contiene ahora `{items}`, sin `page`, `limit` ni `hasMore` artificiales; los scripts deben leer `items`. Los audios tienen ahora `kind` = `voice`, como Telegram, en vez de `audio`. Los archivos se descargan en streaming con las mismas comprobaciones de dirección y tamaño; los audios conservan el límite de 32 MiB.

### Seguridad [#seguridad-16]

- **`max contacts lookup` no repite un teléfono pasado por error como argumento.** Rechaza el uso antes de pedir el número o conectar; introduce el teléfono cuando se solicite o mediante stdin.

### Correcciones [#correcciones-29]

- **`messages list`, `inbox` y `review` con `--transcribe` descargan la grabación por la conexión de lectura.** Antes se abría un segundo acceso a MAX. La grabación se descarga antes de cerrar la conexión, y el reconocimiento local empieza después del cierre. Sin un `--mark-read` explícito, no se marca nada como leído.
- **`review --unanswered` tiene en cuenta las transcripciones guardadas y nuevas de preguntas de voz.** Antes, una pregunta con texto vacío se descartaba antes de transcribirla. La misma corrección se aplica en MCP; el texto original del mensaje no cambia, y las grabaciones sin reconocer dejan la revisión incompleta.

- **`max chats show` explica correctamente las diferencias en el número de miembros.** La lista puede excluir tu cuenta o estar incompleta. El comando muestra ambas cifras sin afirmar que falló la descarga. Se conservan JSON y la lista original.

- **El rechazo `poll.already.voted` explica cómo cambiar el voto.** Si la encuesta lo permite, ejecuta primero `polls vote <chat> <message> --retract` en el mismo perfil y elige después otra respuesta.

- **`max messages download --timeout` también cierra el flujo HTTP del adjunto.** Antes podía seguir descargando tras vencer el tiempo del comando, hasta otro límite de inactividad. Ahora el cierre del adaptador cancela sus flujos y eliminal archivo incompleto.

## 0.25.0 — 03.10.2026 [#0250--03102026]

### Novedades [#novedades-71]

- `bot api` usa el mismo constructor de comandos y validación de entrada que Telegram. Los generadores permanecen en cli-core; se conservan los parámetros, respuestas nativas y permisos efectivos de MAX. La opción compartida `--store-token <profile>` sirve para operaciones que devuelven credenciales; las demás la rechazan.

### Correcciones [#correcciones-30]

- **`messages list`, `inbox` y `review` con `--transcribe` descargan la grabación por la conexión de lectura.** Antes se abría un segundo acceso a MAX. La grabación se descarga antes de cerrar la conexión, y el reconocimiento local empieza después del cierre. Sin un `--mark-read` explícito, no se marca nada como leído.
- **`review --unanswered` tiene en cuenta las transcripciones guardadas y nuevas de preguntas de voz.** Antes, una pregunta con texto vacío se descartaba antes de transcribirla. La misma corrección se aplica en MCP; el texto original del mensaje no cambia, y las grabaciones sin reconocer dejan la revisión incompleta.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-42]

- **`max models audio list --json` añade `directory`:** el directorio de modelos compartido por MAX y Telegram. Los comandos, la selección del directorio y la verificación de descargas son ahora comunes; se conservan los archivos, el orden y `transcribeModel`. No hace falta descargar de nuevo. JSONL sigue devolviendo un modelo por línea.

- **`--md` usa el formateador propio de MAX** para send/edit y pies de archivo: estilos anidados, `__жирный__`, `++подчёркнутый++`, enlaces y código. Los bots admiten énfasis, títulos y citas mediante HTML seguro; el protocolo personal rechaza tipos no verificados. Telegram tiene otra sintaxis. Ya no se envían silenciosamente tipos wire desconocidos.

## 0.24.0 — 03.10.2026 [#0240--03102026]

### Novedades [#novedades-72]

- **`max setup` guía el primer inicio de una cuenta personal:** comprueba directorios, ofrece acceso por QR, comprueba la cuenta y hasta cinco chats e instala el skill del agente elegido. Reutiliza la sesión existente al repetirse. El historial se descarga aparte; setup no inicia el servicio en segundo plano. La ayuda, instalación e instrucciones del agente explican los siguientes pasos y cómo ejecutar en Windows sin PATH. `max skill show` funciona antes de iniciar sesión.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-43]

- **`max chats check` pasa a ser `max chats moderate`:** reglas y moderación compartidas con Telegram. `--since-time` acepta fecha o `30m`/`2h`/`1d`, en lugar de `--since` con un ID de mensaje; JSON devuelve `{ chatId, rows }`. Lee hasta 1000 mensajes por ejecución. Los niveles son `deny|readonly|ask|allow`; los antiguos `forbid` y `flag|confirm` se interpretan como `deny` y `ask`. El punto guardado se migra de la sesión al archivo de reglas, por lo que la primera ejecución continúa desde él. CLI y MCP personal comparten ese punto; nombres y opciones MCP se conservan. La incorporación por enlace en `chats events` se llama `join`.

- **`max upgrade --json` siempre incluye `restarted`.** En MAX es un array vacío: la política de inicio de servidores no cambia. Comprobar versiones y no encontrar actualizaciones devuelve el mismo formato que instalar, conservando los campos anteriores. Los scripts que comprueban las claves exactas deben admitir este campo.

- **La búsqueda local usa un perfil Lucene estricto:** paréntesis, campos, rangos de fechas, `--timezone`, patrones y regex limitados. Los prefijos deben indicarse como `слово*`; la búsqueda anterior con correcciones está en `--language legacy`. JSON informa de la cobertura incluso sin resultados. La guía y el skill explican la migración; JS `--regex` se ejecuta en un worker separado con límites de tamaño y tiempo.

- **`max commands --json` incluye la versión del contrato JSON en `contract`.** El valor `0` coincide con Telegram CLI; conserva los campos anteriores. Los scripts que comparan todo el JSON con una cadena guardada deben admitirlo; leer campos concretos no necesita cambios.

- **Las lecturas de grupos comparten opciones y formatos.** `chats events` usa `--since-time` en lugar de `--since` y `--type` en lugar de `--event`; el límite es temporal, no un ID. La creación se llama `create`, antes `new`. `chats members list` muestra páginas con `--limit`, `--page` y `--all`; añade `--all` para obtener la cantidad anterior. JSON ya no incluye `chatId` ni `rolesKnown`; roles, creación y última conexión permanecen en las filas. `chats inspect` devuelve `id`, `kind`, `title`, `username`, `participantsCount`, `description` y `member`, en lugar de acceso, enlace y ajustes. `member` y `username` son `null` si MAX no los informa. Actualiza scripts y filtros. Se conservan los avisos sobre listas incompletas y roles desconocidos; leer no marca mensajes como leídos. Consulta [grupos](/llms.mdx/docs/es/max/usage/content.md#%D0%B3%D1%80%D1%83%D0%BF%D0%BF%D1%8B-%D0%B8-%D0%BA%D0%B0%D0%BD%D0%B0%D0%BB%D1%8B).

- **La gestión de grupos devuelve JSON común con `operationId`.** `chats create`, `join`, `update` y `link reset` guardan la ficha en `chat`; `leave` devuelve `chatId`. `members add` incluye `added` y `notAdded`; `members remove`, `removed`; `admins`, `personId` y, al añadir, `rights`. Es el formato compartido con Telegram; actualiza el análisis de resultados. `link show` no cambia. Título y ajustes siguen usando dos solicitudes: si cambia título o descripción pero falla la segunda solicitud, informa de `outcome_unknown` y registra el resultado parcial. Consulta `chats show` antes de repetir. Más en [gestión de grupos](/llms.mdx/docs/es/max/usage/content.md#%D0%B3%D1%80%D1%83%D0%BF%D0%BF%D1%8B-%D0%B8-%D0%BA%D0%B0%D0%BD%D0%B0%D0%BB%D1%8B).

- **`max account update` y `max account sessions end` devuelven el formato común con `operationId`.** Cambiar perfil devuelve `{operationId, account}` con `id`, `name`, `username`, `phone`; cerrar sesiones, `{operationId, sessions}` en lugar de un array. Lee los datos desde `account` o `sessions`. Tras cambiar el perfil, consulta su descripción con `account show`. El teléfono sigue oculto parcialmente; `sessions end` aún requiere `--others --yes`. La foto admite JPG, JPEG, PNG y WebP; convierte los GIF a uno de esos formatos. Consulta [perfil y sesiones](/llms.mdx/docs/es/max/usage/content.md#%D0%BA%D0%BE%D0%BD%D1%82%D0%B0%D0%BA%D1%82%D1%8B-%D0%BF%D1%80%D0%BE%D1%84%D0%B8%D0%BB%D1%8C-%D0%BF%D0%B0%D0%BF%D0%BA%D0%B8).

- **`max chats folders create|update|delete` incluye `operationId`.** Crear o modificar devuelve `{operationId, folder}`; eliminar, `{operationId, folderId}`, en lugar de la ficha directamente. Los scripts deben leer desde `folder` y usar `folderId` al eliminar. `update` sin `--title`, `--add` ni `--remove` ahora rechaza la operación en lugar de reescribir lo mismo. Listar no cambia. Consulta [carpetas](/llms.mdx/docs/es/max/usage/content.md#%D0%BA%D0%BE%D0%BD%D1%82%D0%B0%D0%BA%D1%82%D1%8B-%D0%BF%D1%80%D0%BE%D1%84%D0%B8%D0%BB%D1%8C-%D0%BF%D0%B0%D0%BF%D0%BA%D0%B8).

- **`max contacts add|remove|block|unblock|rename|import` devuelve el formato común con `operationId`.** Añadir y renombrar devuelve `{operationId, person}`; eliminar y bloquear, `{operationId, personId}`; importar, `{operationId, sent, recognised}`. `recognised` contiene fichas (`id`, `name`, `username`) devueltas por MAX en lugar de teléfonos; sin fichas queda vacío. `sent` cuenta filas del archivo, incluidos números repetidos. Actualiza el análisis de respuestas. Un teléfono rechazado por MAX ya no indica la fila; los errores de estructura todavía la indican. Consulta [contactos](/llms.mdx/docs/es/max/usage/content.md#%D0%BA%D0%BE%D0%BD%D1%82%D0%B0%D0%BA%D1%82%D1%8B-%D0%BF%D1%80%D0%BE%D1%84%D0%B8%D0%BB%D1%8C-%D0%BF%D0%B0%D0%BF%D0%BA%D0%B8).

- **Se elimina `max cache clear`.** Lecturas y nombres usan la copia compartida; `max store clear --left --allow-dangerous` elimina datos de chats abandonados. No ofrece borrar toda la copia. El archivo antiguo no se migra ni se abre; `max doctor` muestra su ruta y puedes descargar otra vez el historial con `max store fetch`.

### Correcciones [#correcciones-31]

- **`max conversations embed status` calcula mejor el tiempo para e5-small.** Usa una medición de 31 fragmentos/s, antes 15; en el portátil medido, la estimación anterior era el doble. El tiempo real depende del ordenador y la longitud del texto. Tres workers dieron 1,04–1,1× con más uso de memoria; la distribución de workers no cambió.

- **`max_messages_search` por MCP conserva la cobertura del archivo y usa los parámetros de CLI.** Admite `language`, `timezone`, `ast` versionado, nombre de chat y filtros `source`, `newest`, `context`. El perfil estándar admite consultas de un carácter. Antes faltaban parámetros y se perdían `query`, `coverage` y `completeness`; una respuesta vacía no explicaba el alcance de la copia. Los campos anteriores y el nombre de herramienta se conservan.

- **`max runs list --limit` sugiere ampliar el límite si faltan registros.** Ya no sugiere la opción inexistente `--page`. Leer la lista o un registro no crea otra ejecución; JSON conserva `hasMore`.

- **`chats show` muestra un grupo guardado aunque no llegue en la última actualización de acceso.** Antes podía fallar con «sin chat». Los ajustes y enlaces desconocidos quedan vacíos; leer no modifica el grupo.

- **`max messages transcribe` encuentra una transcripción guardada por nombre de chat, aunque no esté descargado el modelo.** Antes buscaba por nombre en lugar de ID y proponía descargar otra vez el modelo. Un nombre completo o fragmento único devuelve ahora el texto guardado sin descargar el audio ni reconocerlo de nuevo. Consulta [mensajes de voz](/llms.mdx/docs/es/max/usage/content.md).

- En Windows, el generador usa Node en lugar de ejecutar `.cmd` directamente; las comprobaciones de documentación reconocen rutas Windows. Los tests de permisos Unix no los exigen en Windows, donde se usa ACL.

- **Los errores de `max bot` antes de iniciar una acción respetan los ajustes de registro del perfil bot, incluso con `--timeout` delante.** Antes, una opción global anterior a `bot` podía aplicar ajustes de la cuenta personal. Si el bot tiene desactivado el registro, un error al interpretar la orden ya no crea un registro contra esa preferencia.

## 0.23.0 — 03.10.2026 [#0230--03102026]

### Novedades [#novedades-73]

- **`max serve` y los comandos de gestión de chats guardan nombres y chats en la base compartida.** Ya no abren la caché antigua. Una lista completa marca chats abandonados; una respuesta vacía conserva la lista anterior.

- **Los comandos de contactos y lectura guardan datos en la base compartida.** Buscar personas por nombre y `contacts sync` ya no requieren la caché antigua. La sincronización sigue devolviendo solo cantidades. Eliminar el archivo anterior no reinicia su progreso; para obtener todos los contactos, ejecuta `max contacts sync`.

- **`max mcp` libera el modelo tras 10 minutos sin búsquedas.** `conversations_search` ya no mantiene aproximadamente 1 GB durante toda la sesión del agente. La siguiente búsqueda vuelve a cargarlo en alrededor de un segundo (cli-messaging 0.110.0).
- **El autocompletado consulta la base compartida de la cuenta elegida.** No necesita la caché anterior. Tab sigue sin conectarse a MAX; los bots ofrecen chats de su lista local.
- **`max mcp setup codex|claude-code` y `max mcp doctor`** añaden MCP local al cliente y comprueban inicio y herramientas. Si el perfil ofrece escritura, requiere `--allow-writes`; esa aprobación no cambia permisos ni verifica el acceso a MAX.
- **`max <бот> bot store fetch <чат>`** descarga historial en la copia del bot, recientes primero, y puede reanudarse. `--last`, `--since-time`, `--limit`, `--page-size` y `--pause` funcionan como `max store fetch`.
- **`--yes` para cualquier comando** aprueba la pregunta del nivel `ask` antes de escribir; `max account sessions end --others --yes` funciona igual.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-44]

- **`messages send --topic` y `polls create --topic` rechazan claramente destinos MAX.** La opción compartida corresponde a temas de foros de Telegram, que MAX no admite. No envía mensaje ni encuesta; sin `--topic`, nada cambia.

- **`max doctor --json` describe la base compartida en `store` y el archivo anterior en `legacyCache`.** Ya no abre ni comprueba el esquema de la caché antigua. Cambia `cache` por `store` en scripts. Puedes borrar el archivo anterior y recuperar historial mediante `max store fetch`.
- **MCP consulta la base compartida.** Búsquedas, contactos, recursos y transcripciones usan `messages.db` bajo la cuenta del perfil, sin abrir la caché anterior. Leer historial guarda mensajes para búsqueda. La voz lleva `kind: "voice"`. Los nombres y parámetros de herramientas no cambian.
- **`inbox` y `review` usan formatos compartidos.** Sustituye `--since` por `--since-time`. `review --unanswered` acepta `4h`, `1d`, no horas sin unidad. Los adjuntos de voz usan `kind: "voice"` en lugar de `"audio"`. `--all` incluye silenciados y archivados. La primera ejecución migra el punto anterior de `inbox --new`. La revisión retrocede por páginas hasta 300 mensajes por chat e indica si está incompleta. Actualiza comandos y comprobaciones JSON.
- **Las transcripciones personales se guardan en la base compartida.** `messages transcribe`, `inbox`, `review` y MCP usan el mismo texto que `messages list` bajo la misma cuenta. No se migran transcripciones antiguas; se regeneran al solicitarlas con `--transcribe`, con modelo descargado.
- **`max <бот> bot people show` pasa a `max <бот> bot contacts show`**, herramienta MCP `max_bot_contacts_show`. Junto con `bot messages search|between`, son comandos compartidos con `tg`; opciones y resultados no cambian.
- **`max <бот> bot chats check` ahora es `max <бот> bot chats moderate`** — comparte el nombre y el comando con `tg`. `--since` pasa a ser `--since-time` (sigue aceptando `2h`, `1d`); la respuesta `--json` es `{ chatId, rows }` en lugar de una lista; la herramienta MCP es `max_bot_chats_moderate`. Las reglas y la posición de la última comprobación quedan en los mismos archivos. El nivel de consentimiento `flag` significa ahora lo mismo que `confirm`: preguntarte o actuar con `--allow-dangerous`.
- **`max <бот> bot mcp` utiliza permisos del perfil, no opciones.** Sin opciones puede escribir salvo restricciones por `readOnly: true` o `allow`. Eliminar muestra formulario; `--allow-dangerous` lo omite. `--allow-send`, `--allow-delete` y `--allow-moderate` se aceptan con avisos, sin habilitar nada. Usa `readOnly: true` para solo lectura. El servidor se comparte con `tg`.
- **`max bot messages search` busca palabras, mejores coincidencias primero**, en lugar de fragmentos por fecha. `--newest` restaura el orden anterior. Requiere todas las palabras; admite `"фраза"`, `-слово`, `а OR б` y `from:`, `chat:`, `after:`, `before:`, `has:`. Corrige erratas y lo avisa por stderr. Puedes escribir palabras sin comillas; `--from` sigue siendo repetible. No admite `in:`: solo busca en su copia y las autorizadas por `readOtherBots`.

### Correcciones [#correcciones-32]

- **Los rechazos del bot indican un comando válido con `--bot`.** Para solo lectura propone desactivar `readOnly`; si falta un permiso en `allow`, propone añadirlo conservando los existentes. Antes indicaba el inexistente `bot config`.

## 0.22.0 — 02.10.2026 [#0220--02102026]

La mayoría de comandos personales se comparten con tg: opciones, resultados `--json` y base local comunes. Hay muchos cambios de nombres, indicados abajo. No se migra la caché anterior; tras actualizar, ejecuta sin `--offline` y descarga historiales con `max store fetch`.

### Novedades [#novedades-74]

- **`max conversations search "<запрос>"`** encuentra conversaciones por significado en uno o todos los chats. Descarga una vez `max models text download e5-small` (135 MB, compartido con `tg`) y calcula vectores con `max conversations embed --chat <чат>`. `embed status` indica pendientes; `embed clear` elimina vectores. Con `--provider openai` y tu clave (`max models text key set
  openai`) usa un servicio externo; `embed` indica tokens y precio y solicita aprobación.
- **`chats list --json` incluye `providerMetadata.partnerId` en chats individuales**, identificando a la otra persona. Permite resolverla porque MAX diferencia identificadores de chat y persona.
- **`max messages search` incluye otras cuentas de la base:** `in:max`, `in:personal`, `in:bots`, `in:all` o `--source`. Sin esas opciones sigue buscando en la cuenta activa.
- **`max conversations build|list|show` y `max messages links`** identifican conversaciones por respuestas, menciones y turnos, localmente sin consultar MAX. **`conversations
  batches status|next` y `conversations links add|clear`** proporcionan lotes al agente y reciben sus respuestas.
- **`max server logs`, `max server install`, `max server uninstall`**, como tg. `install` escribe un servicio systemd en Linux o launchd en macOS, sin iniciarlo; `max server start` y `stop` lo usan después. Si MAX rechaza el acceso, no lo reinicia, evitando nuevos accesos repetidos. Se conservan `max server start --idle` y `restart --idle`.
- **`max store status`** indica cantidades y tramos completos por chat. **`store fetch --background`** y **`store jobs list|show|cancel`** gestionan descargas en segundo plano. **`store info|check|migrate|backup|restore|reindex`** mantienen la base. **`store clear --left
  --allow-dangerous`** elimina chats abandonados y mensajes.
- **`max bot auth`, `max bot list`, `max bot chats list`, `max bot recipients` y `max bot sends list` se comparten con tg**, con iguales respuestas y ayuda. Token, destinatarios y registro conservan ubicación.
- **`max cache clear --left`** elimina solo chats abandonados y mensajes de la caché del perfil, sin tocar el resto.
- **`max messages search --regex`** — una expresión regular sobre todo el texto guardado. **`messages show|context msg:…`** — un mensaje mediante el enlace de `search`, sin un ID aparte.
- **`max polls show <чат> <сообщение>`** consulta encuesta, identificadores y votos sin cambiar nada.
- **`max polls create --send-id`** reintenta crear una encuesta sin duplicarla tras una respuesta perdida.
- **`max messages send --photo <путь>`** — envía `.jpg .png .webp` como foto, igual que en tg. `--no-preview` también está en `send`, pero MAX no lo admite y el comando rechaza la operación.
- **`max skill install`** instala la habilidad para agentes con un comando: en `~/.claude/skills/max-cli/` para Claude Code y en `~/.agents/skills/max-cli/` para Codex y Gemini CLI, con el número de versión de `max`. `--for claude` o `--for agents` instala solo en una carpeta. `max skill show` imprime lo mismo que antes.
- **El agente descubre la habilidad automáticamente.** Si está definida `AI_AGENT` o `CLAUDECODE` y la habilidad falta o es más antigua que `max`, aparece en stderr una línea sobre `max skill install` una vez al día. No se añade nada a stdout. Desactívalo con `max config set skillHint false --defaults`.
- **`max mcp` y `max bot mcp` ofrecen `max://skill`** y lo mencionan en instrucciones al agente.
- **`max messages delete` devuelve `operationId`**, también en `max sends list`. Igual con `max_messages_delete`; opciones sin cambios.
- **Cada registro tiene `operationId`**, común a filas de un envío, edición, eliminación o cambio de chat, para ver su resultado. En envíos equivale a `sendId`.
- **La instalación ocupa unos 16 MB menos**: la capa de base de datos ahora está incluida en el paquete, en lugar de instalarse por separado. Los comandos de `max` no cambian.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-45]

- **`max messages search` busca palabras, mejores resultados primero.** `--newest` recupera orden reciente. Admite `"фраза"`, `-слово`, `OR`, `from:`, `chat:`, `after:`/`before:` y `has:`. Corrige erratas y lo avisa. `--context <n>` muestra contexto. JSON añade `match` y `score`.
- **`max bot updates watch` ahora es `max bot watch`**, como en tg y el `max watch` personal. Sin `--events`, solo se imprimen mensajes nuevos; con `--events`, se imprime todo y cada línea identifica su evento (`{ "event": "message" | "edit" | "delete" | "callback" | "joined" | … }`) en lugar del evento sin procesar de MAX. `--timeout` lo termina normalmente con el código `0`. Los perfiles de bot de solo lectura ahora pueden usar `watch`: recibir eventos es leer. Se mantiene el marcador desde el que continuar.
- **`bot webhooks list` devuelve `{ url, types }`**, no campos propios de MAX. `bot callbacks answer --text` deja de leer stdin mediante `-`. `bot commands`, `bot callbacks` y `bot webhooks` se comparten con tg; `webhooks set --secret-stdin` solo pregunta tras comprobar permisos.
- **Node 22.16 o posterior**, o Bun. Si Node en Linux usa SQLite del sistema antiguo, `max` reinicia con `@wirecat/cli-messaging-sqlite` antes de leer o enviar. Node oficial y Bun no requieren cambios.
- **`max store` se comparte con tg.** `store fetch` guarda en la base común y pagina MAX como antes: 30 mensajes, pausas de 5–10 segundos y hasta 40 páginas por ejecución. Así `messages`, `conversations` y `store` leen lo mismo. No se migra la caché; vuelve a descargar. Además:
  - Rechaza `store fetch --estimate`: los identificadores de MAX no permiten contar lo pendiente.
  - `store fetch|export --since` pasa a `--since-time`, solo fechas, no identificadores.
  - `store fetch --max-pages <n>` pasa a `--limit <сообщений>`, predeterminado 1200, cuarenta páginas de 30. Tamaño mediante `--page-size`.
  - `store export --format md` pasa a `--format markdown`; `jsonl` no cambia. Los huecos se consultan en `store status`, no en stderr de exportación. No sobrescribe archivos.
  - `store fetch` deja de imprimir el comando de exportación.
  - si dos mensajes se enviaron en el mismo milisegundo y el límite de página quedó entre ellos, `store fetch` puede omitir el más antiguo. Es poco frecuente.
- **`max messages list|show|context|search` son comandos compartidos por tg y max.** `--offline` y `search` leen la copia local compartida, la misma que usa tg.
  Por qué: las mismas opciones y respuestas que tg, y una copia para leer.
  Ten en cuenta: las herramientas de lectura de mensajes y chats de `max mcp` aún leen la antigua copia de max, de modo que un agente mediante MCP y un comando del terminal con `--offline` pueden responder de forma distinta. La copia empieza a llenarse con la primera ejecución sin `--offline` tras actualizar; la antigua copia de max no se migra, ni tampoco las transcripciones de mensajes de voz escuchados antes de actualizar. Además:
  - Voz como `"kind": "voice"`, no `"audio"`; `inbox` y `review` aún usan `"audio"` en esta versión.
  - `messages list --before` y `--after` se dividen en `--before-id`, `--before-time`, `--after-id`, `--after-time`; `messages context`, `--before-n`, `--after-n`. Nombres antiguos producen errores.
  - `messages list --before-id` excluye ese mismo mensaje; con `--offline`, solo sirve `--before-id`, y únicamente con el ID de un mensaje de la copia local;
  - `messages list --transcribe --json` ya no devuelve el campo `transcribeProblem`: el motivo aparece en stderr; con `--offline`, `unheard` está vacío. El mensaje de voz se descarga en una conexión independiente; con `--no-serve`, supone un segundo inicio de sesión en MAX;
  - `max` busca los modelos de voz en `~/.cache/cli-common/models/audio`, la misma carpeta que tg; los descargados en `~/.cache/max-cli/models/audio` deben descargarse de nuevo o trasladarse;
  - `messages search` busca palabras y prefijos (`квартир` encuentra «квартира»), no tres letras cualesquiera. `--chat` acepta títulos guardados.
- **`max chats list|show` y `max contacts list|show` son comandos compartidos por tg y max.** Su `--offline` lee la copia local compartida, la misma que usa tg.
  Por qué: las mismas opciones y respuestas que tg.
  Ten en cuenta: la copia empieza a llenarse con la primera ejecución sin `--offline` tras actualizar; la antigua copia de max no se migra y, hasta entonces, `--offline` devuelve `not_found`. Además:
  - `chats list --search|--kind|--unread` sin `--offline` busca en los 200 chats más recientes y avisa en stderr si había chats anteriores; con `--offline`, busca en todos los guardados;
  - `chats show --offline` no incluye `description`, `access` ni `settings`, conocidos solo por MAX.
  - `--kind` incorrecto devuelve `--kind is one of dialog, group, channel, saved`.
  - `cache clear` también elimina esta cuenta de la base compartida; `contacts sync` recupera todo allí.
- **`max messages send|edit|forward` son comandos compartidos por tg y max.** Respuestas `--json`: `send` devuelve `{sendId, operationId, message}` (con `scheduledFor` si se usa `--at-time`); `forward` también devuelve `{sendId, operationId, message}`; `edit` devuelve `{operationId, message}`, en lugar del mensaje sin envoltorio. Las herramientas MCP `max_messages_send`, `max_messages_edit` y `max_messages_forward` responden igual; `max_messages_edit` ya no tiene `markdown`, y `max_messages_forward` ya no tiene `send_id`.
  Por qué: las mismas opciones y respuestas que tg, con un ID de acción como en el registro de envíos.
  Ten en cuenta: un script que leía el mensaje de la raíz de la respuesta ahora debe leer `message`. `send` ya no permite varios `--file` en un mensaje: un adjunto de `--file` y uno de `--photo`. Si un envío con `--at-time` no recibe respuesta, el error recomienda `messages scheduled` sin nombrar el chat.
- **`max polls` se comparte con tg.** `polls vote|close --json` devuelve `{operationId, poll}`, donde `poll` contiene `{chatId, messageId, question, answers: [{id, text, voters, chosen}], closed, multiple,
  anonymous, voters}`; `polls create`, `{sendId, operationId, message}`. Igual con `max_polls_vote`, `max_polls_close`, `max_polls_create`. `max_polls_create` cambia `revote` por `silent`.
- **Las respuestas `--json` de reacciones, fijación y marcado como leído se comparten con tg**, y cada una incluye `operationId`, el ID de esa acción como en el registro de envíos:
  - `reactions add|remove`: `{operationId, chatId, messageId, reaction}`, reacción propia o `null`, sin cantidades (están en `messages list`).
  - `messages pin|unpin`: `{operationId, chatId, messageId, pinned}`, con `pinned` como `true` o `false`.
  - `chats mark-read`: `{operationId, chatId, until}`, con `null` para el más reciente.

  Igual en `max_reactions_add`, `max_reactions_remove`, `max_messages_pin`, `max_messages_unpin`, `max_chats_mark_read`.
- **`max messages unpin <чат> <сообщение>`** ahora exige un número de mensaje, como `pin` y tg. MAX tiene un mensaje fijado por chat, y se desfija ese mensaje sea cual sea el número indicado. La herramienta MCP `max_messages_unpin` también exige `message`.
  Ten en cuenta: `messages unpin <чат>` sin número da error; añade cualquier número de mensaje de ese chat.
- **Desaparecen `max serve --detach` y `max serve --stop`:** utiliza `max server start` y `max server stop`. `serve` trabaja en primer plano; `max server` gestiona el segundo. Actualiza scripts y servicios manuales.
- **`max server status --json` usa el formato tg:** `byHand` pasa a `by`: `hand`, manual; `command`, iniciado por comando; `server`, por `max server start`; `unit`, servicio. Añade `log`, `unit` y `stale` si quedó una marca de un servidor caído. `max server start`, `stop` y `restart` devuelven `{ started, by, pid, startedAt, log }` y `{ stopped, by, pid }`, sin `socket`.
- **`max messages send --at` pasa a `--at-time`**; el nombre anterior `--at` produce error; reemplázalo por `--at-time`. `at` de `max_messages_send` en MCP no cambia.
- **Se elimina `--markdown`; usa `--md`** en `messages send`, `messages edit` y donde se lea formato. Ese es el nombre en todos los comandos tg y max; un script con `--markdown` da un error de «opción desconocida»: sustitúyelo por `--md`.
- **`max sends list --json` cambia `cid` por `sendId`, cadena en lugar de número**, como `outcome_unknown` y `--send-id`. También muestra así registros antiguos.
- **Los registros de ejecuciones (`--trace`, `--record`, `max runs show`) usan un formato compartido por tg y max.** El ID de envío de un evento se llama `send`, en lugar de `cid`; el campo de error de MAX es `providerError`, en lugar de `maxError`, en los eventos, `run.json` y `details` de los errores `--json`.
- **`max bot` devuelve `outcome_unknown`, código `14`, en escrituras con respuestas 502, 503 o 504**, antes `provider_unavailable`, código `12`. El intermediario no demuestra si MAX ejecutó la petición. Reintentar `12` podía duplicar; con `14`, comprueba primero. Las lecturas siguen reintentándose y devuelven `provider_unavailable`.
- **Los comandos de bot adoptan nombres tg sin alias.** `max bot messages get <сообщение>` pasa a `messages show <чат> <сообщение>`; `messages edit|delete` también reciben chat primero. `bot chats get` pasa a `chats show`; `bot chats pin|unpin`, a `messages pin|unpin <чат> <сообщение>`. `--format markdown|html` pasa a `--md` o `--html`; desaparece `--type`: usa `--photo`, `--voice` o `--as-file` para vídeos como archivo. `chats action` acepta `typing`, `photo`, `video`, `voice`, `file`. Enviar y editar devuelve `{ operationId, message }`. Eliminar pregunta; `--allow-dangerous` aprueba. MCP: `max_bot_chats_show`, `max_bot_messages_show`, `max_bot_messages_pin`, `max_bot_messages_unpin`.
- **`max bot members` y `max bot admins` ahora son `max bot chats members` y `max bot chats admins`**, como en tg. `admins add` acepta `--can` con los valores de `max chats admins add` (`read`, `members`, `admins`, `info`, `pin`, `link`, `edit`, `delete`) en lugar de `--permissions`, y `--title` en lugar de `--alias`. `--can` no incluye permisos de «llamadas» ni «estadísticas». `admins list` devuelve `{ id, name, username, role,
  rights, title }`. Herramientas MCP: `max_bot_chats_members_list|add|remove`, `max_bot_chats_admins_list`.
- **Los cambios locales se clasifican como escrituras.** `config set` y `unset`, `chats rules set` y `unset`, `recipients add`, `remove`, `clear`, y `auth set`, `remove`, `chats rules set`, `unset`, `recipients add`, `remove`, `clear` del bot modifican configuración, reglas, destinatarios o almacén, no MAX. La [referencia](/llms.mdx/docs/es/max/commands/content.md) indica que solo cambia el equipo; `max commands` lo muestra en `writes`. Los filtros de solo lectura mediante `max commands --json` ahora los excluyen.

### Correcciones [#correcciones-33]

- **`max store fetch` por fecha ya no omite mensajes en límites de página** y se detiene si MAX repite páginas.
- **`max messages list --before-time` excluye mensajes del mismo milisegundo:** «antes» es estrictamente anterior.
- **`max messages list --after-id` (0.21.0: `--after <id>`) indica si hay página siguiente**, en lugar de negar siempre al avanzar.
- **`max messages send --voice` funciona mediante `max serve`.** Antes perdía la forma de onda y MAX rechazaba con `proto.payload`, código `11`. Con `--no-serve` ya funcionaba.
- **`max chats list` y `max chats show` eliminan chats abandonados** al recibir una lista completa en el siguiente acceso. Antes permanecían con cantidades obsoletas. Sus mensajes quedan hasta `max cache clear --left`; `max serve` detecta la salida en el siguiente acceso completo.
- **`max serve` no confunde respuestas tras uso prolongado.** Los números de dos bytes reinician tras 65 536 peticiones; ahora se omiten los que aún esperan respuesta.

## 0.21.0 — 30.09.2026 [#0210--30092026]

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-46]

Los comandos siguen una misma regla: primero el objeto y después la acción. Los nombres antiguos ya no funcionan: `max` devuelve «unknown command» o «unknown option» con el código `1` y no hace nada.

- **`max backup messages` pasa a `max store fetch`.** Descarga inmediatamente; `--estimate` solo calcula (antes requería `--run`). Conserva máximo `--max-pages` de 40 páginas y pausas. `--pause` exige duración (`5s`, `500ms`), no número sin unidad. `--since` y `--last` son opcionales; sucesivas ejecuciones llegan al inicio, reanudando.
- **`max export messages` → `max store export`.**
- **`--cid` pasa a `--send-id`** en `messages send` y `messages forward`. `outcome_unknown` usa `sendId`; `max_messages_send` y `max_messages_forward` cambian `cid` por `send_id`.
- **`max chats read` pasa a `max chats mark-read`**; `max_chats_read`, a `max_chats_mark_read`.
- **Se elimina `max chats settings`.** `max chats show` muestra los ajustes del grupo (campos `settings`, `description`, `access`; el enlace de invitación sigue en `max chats link show`), y `max chats update <чат> --all-can-pin on|off` y las demás opciones de ajustes los modifican.
- **`max update` → `max upgrade`**, y el aviso de nueva versión indica `max upgrade`.
- **`max recipients off` pasa a `max recipients clear`**, respuesta `off` a `cleared`; **`max bot recipients off`, a `max bot recipients clear`**.
- **`max account sessions end-others` pasa a `max account sessions end --others`**; sin `--others` rechaza.

### Novedades [#novedades-75]

- **`max complete` aparece en `max --help`**, para encontrar cómo activar Tab.
- **[Acceso desde navegador](/llms.mdx/docs/es/max/remote/content.md): ChatGPT o Claude**, con proxy de contraseña y dirección pública Tailscale sin dominio propio. Basado en documentación, sin prueba completa.

## 0.20.0 — 30.09.2026 [#0200--30092026]

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-47]

- **El almacén compartido de mensajes pasa a la versión 6** (cli-messaging 0.49.0). La primera ejecución de `max` actualiza `messages.db`; después, las versiones de `tg` anteriores a la publicada ese día rechazan abrir el archivo y piden actualizar: `npm install -g @wirecat/tg-cli@latest`. Los comandos de `max` no cambian.
- **`--all-bots` necesita autorización para leer otros bots.** Define `readOtherBots` en `bot`: `max <имя> config set --bot readOtherBots true` o lista de perfiles. Sin ella, código `5` y comando para permitirlo.
- **Cuando un nombre coincide con varias personas, los candidatos se ordenan por nombre**, con las personas sin nombre primero; antes seguían el orden de la caché. El texto del error no cambia.

### Novedades [#novedades-76]

- **`--bots news,support`** en `bot messages search`, `bot people show`, `bot messages between` consulta solo esos perfiles autorizados por `readOtherBots`. `bot messages search` también admite `--all-bots`.
- **`bot mcp` ofrece `all_bots` y `bots`** en esas tres herramientas solo si se autorizan lecturas entre bots.
- **Cada bot conserva sus personas.** Las vistas por uno no aparecen en otro sin `--all-bots` o `--bots`.
- **La búsqueda del bot encuentra fragmentos de tres letras** (`вартир` encuentra «квартиру»), igual que la búsqueda personal en esta versión.

## 0.19.0 — 28.09.2026 [#0190--28092026]

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-48]

- **Un agente mediante `max mcp` cierra una encuesta solo si el perfil permite `edit`.** Antes bastaba con `reaction`.
  Por qué: cerrar modifica el mensaje de la encuesta, y `max polls close` siempre exigía `edit`; el agente y una persona tenían permisos distintos para la misma acción.
  Ten en cuenta: si `allow` del perfil incluye `reaction` pero no `edit`, el agente ya no ve `max_polls_close`; añade `edit` para que pueda cerrar encuestas. Si no se define `allow`, no cambia nada. Consulta [docs/mcp.md](/llms.mdx/docs/es/max/mcp/content.md).

### Correcciones [#correcciones-34]

- **`max mcp --confirm-send` arranca cuando los cambios de cuenta se habilitan solo con `mcpTools`.** Antes, la opción exigía también una de las opciones `--allow-*`; de lo contrario, el servidor no arrancaba.
  Por qué importa: por este motivo, un servidor con solo `mcpTools` funcionaba sin formulario de confirmación; el agente podía añadir y eliminar contactos, crear grupos y cambiar el perfil sin preguntarte.
  Ten en cuenta: sin `--confirm-send`, todo sigue igual. Añade la opción al comando de inicio del servidor para ver un formulario antes de cada cambio.
- **`max <бот> bot messages search --limit N` indica más resultados.** Antes siempre devolvía `hasMore: false` y `limit` de configuración en lugar de `N`, deteniendo scripts y agentes que comprueban `hasMore` antes de tiempo. Ahora devuelve `hasMore: true` si supera `N`.

## 0.18.1 — 28.09.2026 [#0181--28092026]

### Correcciones [#correcciones-35]

- **`max contacts rename` se refleja inmediatamente** en `contacts show` y título del chat. Antes esperaba hasta que `max serve` iniciara sesión porque no aplicaba el contacto devuelto. Si sigue obsoleto, el primer comando 0.18.1 sustituye el servidor anterior.

## 0.18.0 — 28.09.2026 [#0180--28092026]

### Novedades [#novedades-77]

- **Herramientas de cuenta en `max mcp`:** añadir, eliminar, renombrar y bloquear contactos; cerrar tu encuesta; entrar, salir y crear grupos; gestionar administradores; cambiar nombre y descripción. Antes solo leía y enviaba mensajes. Solo tú las habilitas mediante `mcpTools`, por ejemplo `max config set mcpTools contacts,polls`; no mediante opciones del agente. Todas pasan por `readOnly`, `allow` y registro. Consulta [MCP](/llms.mdx/docs/es/max/mcp/content.md).
- **Las subidas del bot aparecen en `--trace` y registros.** `bot messages send --file` y `bot uploads put` muestran tipo, tamaño, estado HTTP y duración en dos líneas. Nunca muestran ni guardan dirección o nombre del archivo.

### Correcciones [#correcciones-36]

- **`max contacts rename` ahora cambia el nombre.** Antes, MAX indicaba éxito, pero el nombre seguía igual.
  Por qué: sin el campo `lastName`, MAX no modifica nada y no avisa. Ahora siempre se envía `lastName` (`null` si no hay apellido), igual que en el cliente web.
  Ten en cuenta: los nombres «cambiados» con 0.17.x en realidad no cambiaron; vuelve a renombrarlos.

## 0.17.1 — 28.09.2026 [#0171--28092026]

### Correcciones [#correcciones-37]

- **Los errores de `--limit`, `--last` y `--max-pages` repiten el valor introducido.** Afecta a `messages list`, `inbox`, `backup`, `sends list` y comandos del bot. Antes, `--limit abc` aparecía como `NaN`; en 0.17.0 solo se corrigieron las listas paginadas.
- **`runs list` y `sends list` truncadas por `--limit` indican `hasMore: true`.** Antes devolvían `hasMore: false` y un `limit` distinto al solicitado. Los scripts que seguían `hasMore` podían detenerse en la primera página.
- **Los contactos renombrados usan el nombre que les has dado**, como MAX. Antes `max` mostraba el nombre propio aunque lo cambiaras mediante `contacts
  rename` o en la aplicación.

## 0.17.0 — 28.09.2026 [#0170--28092026]

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-49]

- **Todas las listas con `--json` son objetos `{items, page, limit, hasMore}`, no arrays.** Incluye `account sessions list`, `chats members list`, `chats folders list`, `messages scheduled`, `messages download`, `messages context`, `models audio list`, `recipients list`, `sends list`, `runs list`, `chats check`, `chats events` y listas del bot. Antes algunas eran arrays y `chats events` devolvía `{events, more}`.
  Motivo: había tres formatos distintos que los scripts y agentes debían recordar.
  Ten en cuenta: lee `.items` en vez del array. Sin paginación, `page` es 1 y `limit` el número de filas. `bot members list` y `bot admins list` añaden `marker`; `user_id` es una cadena. `bot messages get` devuelve el mensaje, no un array de uno. `--jsonl` y las tablas no cambian. MCP usa el mismo formato.

### Novedades [#novedades-78]

- **`max doctor` y `max config show` reconocen los bots.** La lista incluye todos los perfiles de este ordenador, marcados como cuenta personal, bot o ambos. Antes no aparecían los perfiles de bot. `doctor` muestra el origen del token del bot (sin el token), cuántos chats ha visto el bot y dónde están los archivos del perfil; `doctor --online` pregunta a Bot API a quién pertenece el token.
  Ten en cuenta: para perfiles de bot, `doctor` y los comandos personales ya no recomiendan `session start`; indican el comando adecuado `max <имя> bot …`.
- **Herramientas MCP `max_status` y `max_bot_status`.** Indican el perfil, la existencia de token y herramientas de escritura activas. No envían nada; `max_status` ni inicia sesión.
- **El autocompletado con Tab reconoce los bots.** Para los comandos de bot, sugiere los chats que ha visto el bot en lugar de los de la cuenta personal; para la primera palabra, sugiere todos los perfiles, incluidos los de bot.
- **Los comandos del bot tienen registros como los personales.** `max <имя> bot … --trace` muestra peticiones Bot API en stderr: operación, chat/mensaje, estado HTTP y duración. `--record` guarda ejecuciones; los fallos se guardan solos con sus peticiones. Consulta `max runs list`, `max runs show`. Las cargas `--file` aún no se registraban; se añadieron en 0.18.0.
- **Ajustes separados para cuentas y bots.** Secciones `personal` y `bot`, con `defaults` y `profiles` propias. `max config set --personal|--bot` escribe la sección; `max config show --bot` indica la clave de origen, como `config file: bot.profiles.test`. Motivo: necesitan reglas diferentes. Prioridad: perfil de sección, perfil general, sección, `defaults` generales. Los archivos antiguos siguen funcionando. Consulta [Configuración](/llms.mdx/docs/es/max/configuration/content.md).
- **Límite por hora para bots.** `max <имя> config set --bot sendsPerHour 200` lo define. Por defecto sigue sin límite.
- **`max config set defaultProfile <имя>`** selecciona el perfil cuando la primera palabra no lo indica; antes siempre `default`.
- **Foto, nombres propios y bloqueo.** `max account update --photo <файл>` cambia la foto. `max contacts rename <кто> <имя> [фамилия]` cambia el nombre solo para ti. `max contacts block <кто>` y `unblock` bloquean incluso a quien no está en contactos. Aplican los controles de `account update` y `contacts add`. `contacts rename` aún no cambiaba realmente el nombre; corregido en 0.18.0.
- **Canales.** `max chats create <название> --channel` crea un canal privado. Invita mediante `max chats link show`: MAX puede rechazar añadir personas directamente.
- **Permisos de lectura y enlace.** `max chats admins add <чат> <кто> --can read,link` permite leer la historia y cambiar la invitación. Un bot administrador sin `read` no ve mensajes del grupo.
- **Tiempos relativos.** `--since`, `--before`, `--after` admiten `30m`, `2h`, `1d`: `max review --since 1d`. Antes exigían tiempos exactos.

### Correcciones [#correcciones-38]

- **Los cambios propios de chats se ven inmediatamente.** Tras `max chats update`, `chats settings`, `chats link
  reset`, `chats show` y `chats list` mostraban el nombre antiguo durante minutos. MAX no devuelve el cambio como evento; ahora `max serve` aplica el chat de la respuesta, como los mensajes enviados.
- **`max export messages` ya no avisa de un hueco hasta 1970-01-01 tras un `backup` completo.** Antes seguía indicando que faltaba el inicio.
- **Los errores de `--limit` y `--page` repiten lo que escribiste.** Antes, un error para `--limit abc` identificaba el valor introducido como `NaN`.
- **Una invitación revocada en `chats inspect` o `chats join` da `not_found`, código 6**, en vez de un rechazo MAX con número de operación. Los scripts deben esperar 6.
- **`max config show` y `max doctor` no inventan `<имя>.moderation` como perfil.** Antes confundían el archivo de reglas con uno.
- **Errores de subcomando nombran la palabra desconocida, no el perfil.** `max work bot auth status` culpaba a `work` en lugar de `status`.
- **`max config show` incluye `transcribeModel`**, antes ausente.

### Eliminaciones [#eliminaciones-2]

- **Solicitudes de ingreso: `max chats requests list|accept|decline`, regla `requests`, niveles `consent.accept` y `consent.decline`.** MAX permite grupos abiertos o mediante invitación, sin aprobación de solicitudes; los comandos prometían algo inexistente. Los archivos antiguos siguen leyéndose y pierden esas claves al escribirse. Los scripts con `chats requests` reciben «comando inexistente».

## 0.16.0 — 27.09.2026 [#0160--27092026]

### Novedades [#novedades-79]

- **Personas e historial del bot.** `max <имя> bot people show <кто>` muestra dónde escribió y su chat privado. `bot messages search --from <кто>` encuentra uno o varios autores; `bot messages between <кто> <кто>` muestra sus mensajes en chats comunes. Solo usa lo visto en el equipo; `--all-bots` incluye todas las copias.
- **Moderación del bot por reglas.** `max <имя> bot chats check <чат>` comprueba lo nuevo según `bot chats rules show|set|unset`, borrando mensajes o expulsando personas. Ingresos mediante `bot updates watch`. Sin `--no-ban`, quien es expulsado no vuelve por enlace; Bot API no puede deshacerlo. Tampoco conoce la antigüedad de cuentas.
- **Encuestas.** `max messages list` muestra la encuesta en texto: pregunta, opciones con ID en `[скобках]`, votos y ✓ junto a tu opción. `max polls vote <чат> <сообщение> <вариант>…` vota, `--retract` retira el voto, `max polls close` cierra tu propia encuesta y `max polls create` crea una. MCP ofrece `max_polls_vote` y `max_polls_create`, solo con `--allow-send`.
  Ten en cuenta: `max` rechaza lo que rechazaría el cliente web — encuestas cerradas, opciones de más o un segundo voto sin derecho a cambiarlo — sin enviar nada. web.max.ru no muestra encuestas y `polls create` lo recuerda.
- **`max <имя> bot mcp` para agentes.** Solo lectura por defecto; escritura con `--allow-send`, `--allow-delete`, `--allow-moderate`, `--confirm-send`. Ejecuta los mismos comandos con destinatarios y registro. Acciones que requieren consentimiento se muestran en un formulario. Consulta [MCP del bot](/llms.mdx/docs/es/max/bot/content.md#%D0%B1%D0%BE%D1%82-%D0%B4%D0%BB%D1%8F-%D0%B0%D0%B3%D0%B5%D0%BD%D1%82%D0%B0-mcp).

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-50]

- **El parámetro `timeout` de `max bot api get-updates` ahora se indica con `--poll-timeout`.** Antes, `--timeout` de esta operación no llegaba a MAX: `--timeout` es el plazo total del comando.
  Ten en cuenta: los scripts que pasaban `--timeout` para consultas de larga espera deben usar `--poll-timeout`.

### Correcciones [#correcciones-39]

- **La primera orden de una versión nueva sustituye al `max serve` antiguo.** Antes seguía rechazando operaciones nuevas, como votos, hasta `max server stop`.
- **También se sustituye una compilación distinta con igual versión.** Un servidor iniciado a mano rechaza operaciones desconocidas sugiriendo `max server stop`.
- **`max bot api get-updates --limit …` funciona.** Antes, `--limit` de la operación se confundía con un ajuste de `max` y el comando rechazaba la operación.

## 0.15.0 — 27.09.2026 [#0150--27092026]

### Novedades [#novedades-80]

- **`max chats check <чат>` modera por reglas.** Lee mensajes y participantes nuevos desde la última revisión, aplica `max chats rules` y avisa, borra o expulsa. Por defecto solo informa; `--dry-run` planifica; máximo 10 acciones. Los cambios pasan los controles habituales. Las solicitudes solo estaban previstas aquí y se eliminaron en 0.17.0 porque MAX no las tiene. Consulta [Grupos](/llms.mdx/docs/es/max/groups/content.md).
- **Moderación mediante agente.** `max mcp --allow-moderate` ofrece `max_chats_check`; siempre se ofrecen los lectores `max_chats_events`, `max_chats_members`, `max_chats_rules`. Sin el indicador no hay herramienta de actuación. Los cambios pendientes de consentimiento se muestran juntos en un formulario.
- **Roles e invitaciones.** `max chats members list` indica `owner`, `admin`, `member`. `max chats link show <чат>` muestra la invitación.
- **Vídeos y voz personales.** `max messages send <чат> --file ролик.mp4` reproduce vídeo en el chat (`.mp4 .mov .webm .mkv`); `max messages send <чат> --voice
  заметка.ogg` envía voz con onda y duración. Antes el vídeo era archivo; `--as-file` conserva ese comportamiento. Voz solo Ogg Opus; otro audio sugiere `ffmpeg`. Consulta [Uso](/llms.mdx/docs/es/max/usage/content.md).
- **Los mensajes de voz aparecen como texto en la lista.** `max messages list <чат> --transcribe` y `max inbox
  --transcribe` transcriben los mensajes de voz mostrados en este ordenador; el texto aparece bajo el mensaje con el icono 🎤 y, en `--json`, en `transcript`. MCP utiliza `transcribe: true` en `max_messages_list` y `max_inbox`.
  Ten en cuenta: los mensajes ya transcritos muestran el texto incluso sin la opción. La transcripción requiere un modelo descargado.
- **Más comandos de bot.** `max <имя> bot messages send --file <путь>` adjunta imagen/vídeo/audio/archivo; `bot uploads put` solo carga. `bot members list|add|remove`, `bot admins list|add|remove`, `bot comments list|get|send|edit|delete`, `bot callbacks answer`, `bot commands
  list|set|clear`, `bot webhooks list|set|delete`. Consulta [Bots](/llms.mdx/docs/es/max/bot/content.md). `webhooks set` rechaza otro destino porque MAX mantendría ambos, en lugar de sustituirlo.
- **Copia local del bot.** Lo leído/enviado/recibido se conserva. `max <имя> bot messages list <чат> --offline`, `messages get --offline` leen sin red; `bot messages search <текст>` busca. El borrado propio u observado por `updates watch` retira el mensaje; la copia contiene texto.
- **`max <имя> bot updates watch`** muestra eventos hasta Ctrl-C, guarda mensajes y reanuda desde la posición anterior. No funciona con webhook; consume los eventos de otros lectores: ejecútalo solo si nadie más necesita el bot.
- **Personas en la copia.** `max <имя> bot people show <кто>` muestra chats y últimos mensajes privados; `--refresh` relee desde MAX. `bot messages
  search --from <кто>` filtra autor; `bot messages between <кто> <кто> …` compara autores en chats comunes. `--all-bots` incluye todas las copias. Persona: número, `@username` o parte del nombre.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-51]

- **`max bot messages list` ordena de antiguos a nuevos**, como `max messages list`. Los envíos del bot se marcan propios. Los scripts que tomaban la primera fila como la más reciente deben adaptarse.

### Correcciones [#correcciones-40]

- **`max review --transcribe` cierra MAX antes de reconocer.** Primero descarga grabaciones, cierra y ejecuta el modelo.
- **`max bot api edit-my-commands`, `subscribe`, `unsubscribe`, `get-upload-url` funcionan.** Antes fallaban con «an account change without a known action» sin enviar nada.
- **Un destinatario positivo sin `user:` se identifica como probable persona** y sugiere `user:<номер>`.
- **Los ejemplos de [Bots](/llms.mdx/docs/es/max/bot/content.md) usan identificadores reales**, explicando cómo obtenerlos.

## 0.14.0 — 27.09.2026 [#0140--27092026]

### Novedades [#novedades-81]

- **`max bot` usa el Bot API oficial.** `max bot auth set` valida y guarda el token separado de la cuenta personal. Perfil primero: `max рабочий bot me`. `max bot me` muestra el bot; `max bot api <operación>` ejecuta las 33 operaciones con parámetros y cuerpo JSON, generadas desde la [especificación oficial](https://github.com/WireCatLabs/max-cli/blob/v0.111.0/docs/dev/bot-api-coverage.md). IDs mayores que 2^53 son cadenas para conservar dígitos; los scripts deben tratarlos así.
- **Comandos prácticos para bots.** `max <имя> bot messages send <чат> <текст>` envía a un chat por número, a una persona como `user:<номер>` o por el título de un chat que el bot ya ha visto; también hay `edit`, `delete`, `list` y `get`. `max <имя> bot chats list` muestra los chats que ha visto el bot; también están `chats get|pin|unpin|leave|action`. `max bot list` muestra todos los nombres con un token de bot.
  Por qué «que ha visto»: MAX no ofrece una lista de chats del bot, por lo que `max` los recuerda por su cuenta.
- **Destinatarios y registro del bot.** `max <имя> bot recipients add|list|remove|off`, `max <имя> bot sends list`. Se comprueban todas las escrituras, incluidas `bot api`. Aún no hay límite por hora; llega en 0.17.0. Consulta [Bots](/llms.mdx/docs/es/max/bot/content.md).
- **Actividad de grupos.** `max review --unanswered [часы]` encuentra preguntas sin respuesta tuya ni de administradores; `max review --chat <чат>` revisa un chat. `max chats events <чат>` muestra ingresos, salidas, altas y expulsiones. `max chats members list
  <чат>` lista miembros con registro y última actividad. `max chats
  rules show|set|unset <чат>` guarda reglas juntas, como `config set`.

### Correcciones [#correcciones-41]

- **Cuando MAX cierra la conexión, el error indica código y motivo.**

## 0.13.0 — 26.09.2026 [#0130--26092026]

### Novedades [#novedades-82]

- **`max review` revisa obligaciones.** Todos los mensajes, también tuyos, desde la última revisión (tres días sin `--since`). `--transcribe` reconoce voz. Termina indicando dónde iniciar la siguiente revisión. Si falta lectura, señala resultado incompleto: no lo consideres completo ([Uso](/llms.mdx/docs/es/max/usage/content.md#%D0%BE%D0%B1%D0%B7%D0%BE%D1%80-%D0%BA%D1%82%D0%BE-%D0%BA%D0%BE%D0%BC%D1%83-%D1%87%D1%82%D0%BE-%D0%B4%D0%BE%D0%BB%D0%B6%D0%B5%D0%BD)).
- **`max_review` y `/review` en MCP.** El agente separa mis obligaciones, esperas y dudas; revisa grupos antes de declarar retrasos y prepara recordatorios. Solo envía con tu aprobación ([MCP](/llms.mdx/docs/es/max/mcp/content.md#%D0%BA%D0%BE%D0%BC%D0%B0%D0%BD%D0%B4%D1%8B-%D0%B8-%D1%87%D0%B0%D1%82%D1%8B-%D0%BF%D0%BE-)).
- **`max mcp config` imprime configuración para Claude Desktop, Cursor y otros.** Rutas absolutas para Windows y clientes sin `PATH` del terminal ([Conexión](/llms.mdx/docs/es/max/mcp/content.md#%D0%BF%D0%BE%D0%B4%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B5)).
- **`max doctor` comprueba la instalación:** qué ejecuta `max`, dónde está instalado, si un terminal nuevo lo encontrará, si se cargan el llavero y SQLite y si hay un modelo de voz descargado.
  Ten en cuenta: si la carpeta del comando no está en `PATH`, `doctor` imprime un comando para corregirlo: para PowerShell en Windows y `export` en Linux y macOS. Si no se encuentra el propio `max`, ejecuta `npx @wirecat/max-cli doctor` ([troubleshooting.md](/llms.mdx/docs/es/max/troubleshooting/content.md#max-%D0%BD%D0%B5-%D0%BD%D0%B0%D1%85%D0%BE%D0%B4%D0%B8%D1%82%D1%81%D1%8F-%D0%BF%D0%BE%D1%81%D0%BB%D0%B5-%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B8)).
- **`max doctor --online`** realiza un inicio, lee un chat y arranca MCP sin enviar.
- **`max models audio download` prueba el modelo descargado.** Si falta, indica idioma y alternativas con tamaños.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-52]

- **`max_messages_attachment` pasa a `max_messages_photo`.** Renueva permisos guardados del cliente MCP.
- **No se admite el perfil `review`**, ahora una orden; renombra perfiles existentes.

### Seguridad [#seguridad-17]

- **Los informes Windows ocultan el directorio personal con cualquier escritura.** Antes el nombre del usuario seguía visible en ciertas rutas.

## 0.12.0 — 26.09.2026 [#0120--26092026]

### Novedades [#novedades-83]

- **Más MCP:** `max_inbox` reúne lo nuevo; respuestas y formato, reacciones, fotos como imagen visible al agente ([Herramientas](/llms.mdx/docs/es/max/mcp/content.md#%D0%B8%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D1%8B)).
- **`/catch-up`, `/reply`, `/find` y chats mediante `@` en Claude Code** ([Comandos](/llms.mdx/docs/es/max/mcp/content.md#%D0%BA%D0%BE%D0%BC%D0%B0%D0%BD%D0%B4%D1%8B-%D0%B8-%D1%87%D0%B0%D1%82%D1%8B-%D0%BF%D0%BE-)).

### Correcciones [#correcciones-42]

- **`max serve` funciona en Windows** mediante canal con nombre, no archivo.
- **Sockets demasiado largos en macOS/Linux dan un error claro**, no `EINVAL`; pueden alargarse por perfil o `MAX_STATE_DIR`.

## 0.11.0 — 26.09.2026 [#0110--26092026]

### Novedades [#novedades-84]

- **`max watch --events` muestra ediciones, borrados y reacciones** con campo `event`; sin indicador conserva formato ([Eventos](/llms.mdx/docs/es/max/archive/content.md#%D0%BD%D0%BE%D0%B2%D1%8B%D0%B5-%D1%81%D0%BE%D0%BE%D0%B1%D1%89%D0%B5%D0%BD%D0%B8%D1%8F-%D1%81%D1%80%D0%B0%D0%B7%D1%83-max-serve-%D0%B8-max-watch)).
- **Informes mediante incidencias GitHub, no correo.** `max doctor report create` imprime enlace con título y plantilla; se adjunta el informe. Incidencia y archivo son públicos ([Problemas](/llms.mdx/docs/es/max/troubleshooting/content.md#%D0%BA%D0%B0%D0%BA-%D1%81%D0%BE%D0%BE%D0%B1%D1%89%D0%B8%D1%82%D1%8C-%D0%BE-%D0%BF%D1%80%D0%BE%D0%B1%D0%BB%D0%B5%D0%BC%D0%B5)).
- **Todos los errores guardan una ejecución**, incluso indicadores inválidos, comprobaciones previas y órdenes sin MAX (`models`, `server`, `watch`). Antes solo los que alcanzaban MAX. Solo se guardan palabras de comando, no argumentos ni mensajes ([Diagnóstico](/llms.mdx/docs/es/max/diagnostics/content.md)).
- **`max backup messages --run` indica ubicación y siguiente paso.** Conserva en copia local; `max export messages` crea archivo. La orden aparece al final y en `export`.
- **`max serve` comprueba permisos y registra envíos:** lectura, acciones, destinatarios y límite. `config set` se aplica sin reiniciar. No se inicia con `MAX_TOKEN`.
- **Tras iniciar sesión, `max serve` solicita lo mismo que una pestaña de web.max.ru:** carpetas, banners, historial de llamadas, conjuntos de stickers y reacciones. **También vuelve a iniciar sesión del mismo modo:** pasa a MAX la hora del inicio anterior y pide solo los chats modificados, en lugar de toda la lista.
  Por qué: cuanto menos difiere `max` del cliente web, menos motivos tiene MAX para detectarlo.
  Ten en cuenta: todo esto es solo lectura; las respuestas no se muestran ni se guardan. Los comandos puntuales no lo hacen ([security.md](/llms.mdx/docs/es/max/security/content.md#%D1%87%D1%82%D0%BE-%D1%83%D1%85%D0%BE%D0%B4%D0%B8%D1%82-%D0%B2-%D1%81%D0%B5%D1%82%D1%8C)).
- **El servidor en segundo plano tolera un mensaje entrante de MAX malformado:** lo omite, escribe una línea sobre ello y sigue funcionando. Antes, ese mensaje podía detener el servidor.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-53]

- **Más protección para agentes.**
  - `max mcp --confirm-send` confirma cualquier escritura —edición, reenvío, fijado, lectura y borrado—; aprobación única durante cinco minutos.
  - `sendsPerHour` incluye ediciones, fijados con aviso y cada persona añadida. Los programados cuentan a la hora de salida. Dos envíos simultáneos ya no superan juntos el límite.
  - Con destinatarios activos, crear grupo o añadir personas exige que el chat privado de cada una esté autorizado.
  - `chats members add` no muestra historia sin `--history`; se elimina `--hide-history`.
  - `MAX_PROFILE_LOCK` fija el proceso en un perfil.
  - `--file` rechaza archivos ocultos y propios de `max` sin `--allow-any-file`.

  Ten en cuenta: el límite se consume antes. Retira `--hide-history` de scripts; añade `--allow-any-file` si debes enviar archivos ocultos.

### Correcciones [#correcciones-43]

- **`max watch` no confunde ediciones/borrados con mensajes nuevos**, aunque MAX los envíe con el mismo formato marcado.
- **Un nombre exacto no gana en silencio.** Si también forma parte de otro chat, enumera ambos y exige ID: un envío al destinatario equivocado no puede deshacerse.

### Seguridad [#seguridad-18]

- **El token de `MAX_TOKEN` se queda solo ahí.** Si MAX emite un token de sesión nuevo, `max` no lo escribe ni en el llavero ni en un archivo, y avisa en stderr. `max doctor` indical archivo `credentials.json` si el token se guarda allí en lugar de en el llavero.
- **`max session start` oculta el teléfono**, como `max account show`. Ctrl-C al pedir token termina con `130`.
- **El servidor en segundo plano no entrega el token** a los comandos que le consultan sobre el inicio de sesión: no lo necesitan y consultan el llavero.
- **Límites de red.** Tramas MAX descomprimidas hasta 32 MiB; conexión y descargas no esperan indefinidamente. `max messages download` solo HTTPS, sin equipo local ni red privada, incluso tras redirecciones; máximo 4 GiB, voz para transcripción 32 MiB. Los enlaces provienen de terceros y pueden apuntar a cualquier lugar.
- **Permisos locales.** Base y `-wal`, `-shm` con `0600`, directorio `0700`; se corrigen los existentes al abrir. Los informes sustituyen IDs por etiquetas.
- **Texto ajeno en una línea y controles visibles** en conversaciones, tablas, candidatos, Markdown y rutas de `messages download`. Se limpian caracteres de control/dirección en nombres. Solo `http`, `https` se convierten en enlaces Markdown.
- **Autocompletado inserta solo números** de chat/persona, mostrando nombre aparte: títulos y `@имя` pertenecen a terceros y no deben ejecutarse en la shell.
- **`max cache clear` sin perfil limpia el predeterminado y respeta `MAX_PROFILE`.**
- **Los lanzamientos son más estrictos.** Las versiones de dependencias se fijan exactamente; el paquete se compila desde cero antes de cada empaquetado, sin utilidades de prueba; publica un paso independiente que no instala ni ejecuta dependencias.

## 0.10.0 — 25.09.2026 [#0100--25092026]

### Novedades [#novedades-85]

- **`max doctor report`, `max doctor report create` preparan informes.** La primera explica contenido; la segunda crea archivo sin texto y pasos de envío. Aquí por correo; desde 0.11.0 por GitHub ([Problemas](/llms.mdx/docs/es/max/troubleshooting/content.md#%D0%BA%D0%B0%D0%BA-%D1%81%D0%BE%D0%BE%D0%B1%D1%89%D0%B8%D1%82%D1%8C-%D0%BE-%D0%BF%D1%80%D0%BE%D0%B1%D0%BB%D0%B5%D0%BC%D0%B5)).
- **`max backup messages <чат> --since <дата> | --last <n>` descarga más historial del chat a la copia local.**
  Ten en cuenta: sin `--run`, el comando solo muestra una estimación y no envía nada. Con `--run`, recorre el historial hacia atrás en páginas de 30 mensajes con pausas, hasta 40 páginas por ejecución, y continúa desde donde quedó al repetirlo ([usage.md](/llms.mdx/docs/es/max/archive/content.md#%D1%81%D0%BA%D0%B0%D1%87%D0%B0%D1%82%D1%8C-%D0%B8%D1%81%D1%82%D0%BE%D1%80%D0%B8%D1%8E)).
- **`max doctor` indica la versión web que representa `max`**, avisando si tiene más de 60 días: MAX puede rechazar clientes antiguos ([Problemas](/llms.mdx/docs/es/max/troubleshooting/content.md)).
- **`max server start|stop|status|restart` gestiona el servidor en segundo plano como un componente independiente**, como `max session`. `status` muestra si funciona, desde cuándo, su versión y si está conectado a MAX; sugiere `restart` si la versión del servidor es anterior a la de `max`. `max serve --detach` y `--stop` siguen funcionando ([usage.md](/llms.mdx/docs/es/max/archive/content.md#%D0%BD%D0%BE%D0%B2%D1%8B%D0%B5-%D1%81%D0%BE%D0%BE%D0%B1%D1%89%D0%B5%D0%BD%D0%B8%D1%8F-%D1%81%D1%80%D0%B0%D0%B7%D1%83-max-serve-%D0%B8-max-watch)).
- **La lectura del historial envía los mismos cinco campos que el cliente web**, y el inicio de sesión pide a MAX 15 chats, como una pestaña de web.max.ru, y después obtiene el resto en una solicitud. Antes, `max` añadía un campo que el cliente web no envía y pedía 40 chats de una vez.
  Por qué: cuanto menos difiere `max` del cliente web, menos motivos tiene MAX para detectarlo.
  Ten en cuenta: la lista de chats es la misma. Se comprobó en un canal con mensajes sin leer: la lectura sigue sin marcar nada como leído.
- **La descripción del dispositivo se obtiene de tu ordenador:** la zona horaria, el idioma del sistema y el sistema operativo son propios de cada instalación, como en el navegador. Antes, todas las instalaciones de `max` se identificaban como el mismo Chrome en Linux con la zona horaria de Madrid.
- **`max serve` envía un evento de servicio como una pestaña oculta:** lista de chats mostrada, 20 segundos después de entrar. Solo número de cuenta y hora, sin títulos/textos. Las órdenes puntuales no lo envían ([Seguridad](/llms.mdx/docs/es/max/security/content.md#%D1%87%D1%82%D0%BE-%D1%83%D1%85%D0%BE%D0%B4%D0%B8%D1%82-%D0%B2-%D1%81%D0%B5%D1%82%D1%8C)).
- **`max` rechaza por sí mismo los títulos de carpeta demasiado largos**: como máximo 20 caracteres, el límite que acepta MAX. Antes, la solicitud llegaba a MAX y este la rechazaba.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-54]

- **Un rechazo por demasiados inicios no provoca nuevos intentos.** Código `8` y pausas de 1 minuto, 5, 30, una hora, 6 horas, un día. El servidor se detiene ante cualquier rechazo; antes repetía cada minuto indefinidamente. Scripts reciben `8` hasta acabar la pausa: respeta el plazo del error ([Problemas](/llms.mdx/docs/es/max/troubleshooting/content.md)).

### Correcciones [#correcciones-44]

- **Un almacén inaccesible no se confunde con falta de sesión.** Si ya hubo entrada pero falta token, por ejemplo en cron, `max` y `max doctor` señalan las claves, no recomiendan otra sesión que añadiría otro dispositivo ([Recetas](/llms.mdx/docs/es/max/recipes/content.md)).
- **Fallos guardados sin `--record`.** Incluyen clave MAX (p. ej. `login.token`), códigos de aviso, punto del fallo, entorno y SO; sin textos. Servidor: JSON con hora ([Diagnóstico](/llms.mdx/docs/es/max/diagnostics/content.md)).
- **`max chats read --until` solo marca hasta el mensaje indicado**, no hasta ahora ni mensajes más nuevos. Igual para `messages list --mark-read`. Antes podían aparecer leídos mensajes no vistos.

## 0.9.0 — 25.09.2026 [#090--25092026]

### Novedades [#novedades-86]

- **`max` se comunica con MAX como el cliente web:** la misma dirección, tramas binarias y compresión que web.max.ru, y la misma descripción de dispositivo con versiones actualizadas de la aplicación y del navegador. Antes, `max` enviaba tramas de texto en un formato antiguo.
  Por qué: el formato antiguo era la forma más fácil de distinguir `max` del cliente web. Además, los mensajes de voz y los vídeos circulares necesitan un campo de bytes que el formato anterior no podía transmitir.
  Ten en cuenta: los comandos y su salida no cambian. El envío de mensajes de voz queda para versiones posteriores. Por ahora, MAX envía toda la lista de chats en cada inicio de sesión, en lugar de solo los cambios: funciona, pero añade tráfico.
- **Un `max serve` en segundo plano iniciado por un comando se reinicia automáticamente tras actualizar `max`.**
  Ten en cuenta: un servidor iniciado manualmente sigue funcionando como antes hasta que lo detengas con `max serve --stop` y lo vuelvas a iniciar.

## 0.8.0 — 25.09.2026 [#080--25092026]

### Novedades [#novedades-87]

- **`max messages transcribe <чат> <id>` reconoce voz localmente.** La grabación no sale. `max models audio list` muestra idiomas; `max models audio download <id>` descarga y verifica. MCP: `max_messages_transcribe` ([Voz](/llms.mdx/docs/es/max/usage/content.md#%D0%B3%D0%BE%D0%BB%D0%BE%D1%81%D0%BE%D0%B2%D1%8B%D0%B5-%D0%B2-%D1%82%D0%B5%D0%BA%D1%81%D1%82)). Descarga única a petición; texto en la copia, sin necesidad de repetir red o modelo.
- **Una conexión por perfil.** Comandos, `max mcp`, `max watch` comparten `max serve`, reduciendo inicios con un token y cierres por MAX. `max session start` detiene, entra y reinicia ([Servidor](/llms.mdx/docs/es/max/archive/content.md#%D0%BD%D0%BE%D0%B2%D1%8B%D0%B5-%D1%81%D0%BE%D0%BE%D0%B1%D1%89%D0%B5%D0%BD%D0%B8%D1%8F-%D1%81%D1%80%D0%B0%D0%B7%D1%83-max-serve-%D0%B8-max-watch)).
- **`max serve --detach` inicia en segundo plano** y responde tras conectar; **`max serve
  --stop` detiene**. Uno iniciado a mano solo se detiene con Ctrl-C/`--stop`; `max
  session end` no lo toca.
- **`allow` limita acciones.** `max work config set allow send,reaction` permite enviar y reaccionar. Doce nombres de `send` a `sessions`. Sin lista todo permitido. Lo prohibido falla con `5` antes de conectar, indicando cómo permitirlo. `max mcp` oculta herramientas prohibidas ([Permisos](/llms.mdx/docs/es/max/usage/content.md#%D1%87%D1%82%D0%BE-%D0%BF%D1%80%D0%BE%D1%84%D0%B8%D0%BB%D1%8E-%D0%BC%D0%BE%D0%B6%D0%BD%D0%BE)).
- **`max messages send … --at <время>` programa.** MAX envía aunque el equipo esté apagado; `2026-09-25T09:00` local, `30m`, `2h`, `1d`. `max messages scheduled <чат>` lista espera; MCP `at` de `max_messages_send`, `max_messages_scheduled`. Cancelación solo en MAX ([Programar](/llms.mdx/docs/es/max/usage/content.md#%D0%BE%D1%82%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D1%82%D1%8C-%D0%BF%D0%BE%D0%B7%D0%B6%D0%B5)).
- **`max chats read <чат>`, `max messages list … --mark-read` marcan explícitamente.** MCP: `max mcp --allow-mark-read`. El otro ve la marca; lectura ordinaria no la cambia ([Lectura](/llms.mdx/docs/es/max/usage/content.md#%D1%87%D1%82%D0%B5%D0%BD%D0%B8%D0%B5)).
- **`max export messages <чат> --format jsonl|md` exporta localmente**, con `--since`, `--output`, sin MAX. Lo ausente se avisa en stderr; `--output` crea archivo privado ([Exportación](/llms.mdx/docs/es/max/archive/content.md#%D0%B2%D1%8B%D0%B3%D1%80%D1%83%D0%B7%D0%B8%D1%82%D1%8C-%D0%B2-%D1%84%D0%B0%D0%B9%D0%BB)).
- **`max messages delete <чат> <id…> --allow-dangerous` borra hasta 10**, solo para ti salvo `--for-everyone`; MCP `max mcp --allow-delete`, solo personal. Sin `--allow-dangerous` falla; cada mensaje consume `sendsPerHour` ([Borrar](/llms.mdx/docs/es/max/usage/content.md#%D1%83%D0%B4%D0%B0%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5)).

### Correcciones [#correcciones-45]

- **Actualizar `max` conserva la historia.** Antes un cambio de estructura borraba todo; ahora migra mensajes. Este lanzamiento también cambia la estructura y conserva historia; chats/personas se renuevan al entrar.
- **Tras rechazo del servidor, los comandos esperan 10 minutos sin crear otro.** Antes cada orden reiniciaba intentos rechazados. `max session
  start` elimina la espera.
- **`max watch` ve los envíos propios de `max`.** MAX no los devuelve a la conexión emisora; antes se perdían.
- **Los comandos `max` simultáneos ya no pierden los datos de inicio de sesión en la copia local.** Antes, dos de cada tres comandos simultáneos indicaban «the local record did not take this login» y no guardaban chats, miembros ni el marcador de sincronización. Ahora el segundo espera a que el primero termine de escribir.

### Seguridad [#seguridad-19]

- **Los errores no controlan el terminal.** Tras mensajes, nombres y tablas en 0.7.0, los errores muestran `\x1b` visible. Pueden repetir entrada del usuario o respuestas MAX.

## 0.7.0 — 24.09.2026 [#070--24092026]

### Novedades [#novedades-88]

- **`max reactions remove <чат> <id>` retira tu reacción.**
- **Grupos y canales bajo `max chats`:** inspeccionar invitación, entrar, salir, crear, añadir/expulsar, administrar, renombrar, ajustes y renovar enlace. Las solicitudes se retiraron en 0.17.0 porque MAX no las tiene. Los cambios son visibles y pasan los controles de envío ([Grupos](/llms.mdx/docs/es/max/usage/content.md#%D0%B3%D1%80%D1%83%D0%BF%D0%BF%D1%8B-%D0%B8-%D0%BA%D0%B0%D0%BD%D0%B0%D0%BB%D1%8B)).
- **`max update` actualiza `max` con el gestor de paquetes con el que se instaló;** `--check` solo indica si existe una versión más reciente.
  Ten en cuenta: una persona en el terminal ve el aviso de nueva versión una vez al día; los agentes y scripts nunca lo ven. Desactívalo con `updateCheck: false` en `defaults` ([installation.md](/llms.mdx/docs/es/max/installation/content.md#%D0%BE%D0%B1%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5)).
- **Tab en zsh/bash/fish/PowerShell:** `source <(max complete zsh)`, órdenes, indicadores, valores, chats/personas locales sin MAX ([Autocompletar](/llms.mdx/docs/es/max/commands/content.md#max-complete)).
- **`max mcp` conecta el perfil por MCP** para clientes sin terminal, como Claude Desktop, o mediante MCP en Cursor ([MCP](/llms.mdx/docs/es/max/mcp/content.md)). Solo lectura sin `--allow-send`; envío con controles de `max messages send`.
- **`max mcp --allow-send --confirm-send` muestra un formulario antes de cada envío:** a qué chat (título e ID) y qué se enviará.
  Ten en cuenta: sin tu «sí», no se envía nada; un cliente que no pueda mostrar formularios recibe un error ([docs/mcp.md](/llms.mdx/docs/es/max/mcp/content.md#%D1%87%D1%82%D0%BE-%D0%BC%D0%BE%D0%B6%D0%B5%D1%82-%D0%B0%D0%B3%D0%B5%D0%BD%D1%82)).
- **`max messages send … --file <путь>` envía fotos/archivos**, varias fotos en un mensaje.

### Seguridad [#seguridad-20]

- **El texto ajeno no controla el terminal.** Mensajes, nombres, títulos, archivos o reacciones podían borrar líneas y sobrescribir salida de `max`. Ahora controles como `\x1b` se muestran visibles en conversaciones, tablas, errores y Tab. JSON no cambia: ya los escapaba.

## 0.6.0 — 24.09.2026 [#060--24092026]

### Novedades [#novedades-89]

- **`max commands --json` describe órdenes, argumentos, indicadores y códigos en una respuesta**, cambios MAX con `mutates: true`. Evita pedir `--help` por comando. Funciona sin sesión incluso con ajustes rotos.
- **`max messages send … --reply-to <id>` responde.**
- **`max messages send … --markdown` o `--md` da formato:** `**жирный**`, `_курсив_`, `~~зачёркнутый~~`, `` `код` ``. Sin indicador, literal.
- **`max reactions add <чат> <id> <эмодзи>` sustituye tu reacción.**
- **Reacciones en lectura:** `messages list`, `show`, `context` muestran `👍 3  🔥 1  (you: 🔥)`, JSON `reactions`. Una petición adicional por página, solo lectura. `--offline` no tiene reacciones (`null`) porque no se guardan.
- **Registro y destinatarios.** Cada intento sin texto en `max sends list`. Lista opcional `max recipients add|remove|list|off`; destinatario no autorizado código `7`, perfil `readOnly` código `5`. Alcance: [Seguridad](/llms.mdx/docs/es/max/security/content.md).
- **`max session start qr | qr-chrome | sms | token` permite entrar sin copiar token.** `qr` dibuja en terminal o abre navegador si es estrecho. `qr-chrome`, `sms` abren web.max.ru en ventana aparte de Chrome/Chromium/Edge/Brave. Sin método sigue token manual o stdin.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-55]

- **El envío tiene un límite por hora: 30 mensajes por defecto (`sendsPerHour`).** Por encima del límite, `max messages send` rechaza la operación con el código `8`. Antes no había límite.
  Ten en cuenta: un script que envíe más debe aumentar `sendsPerHour` en los ajustes.

## 0.5.0 — 24.09.2026 [#050--24092026]

### Novedades [#novedades-90]

- **`max messages download <чат> <id> [--output <каталог>]` guarda foto, archivos, vídeo/audio** sin sobrescribir.
- **`max config set <настройка> <значение>`, `max config unset <настройка>` editan ajustes**, `--defaults` para todos; nueva sección `defaults` para perfiles sin valor propio.
- **`max chats list --unread` filtra no leídos.**
- **`max messages list <чат> --after <id|время>` lee hacia delante**, después de mensaje/tiempo; próxima página con `--after <id самого нового>`.
- **`max chats show <чат>` y `max contacts show <человек>`** muestran chat con miembros o persona por ID/@username/nombre y chats comunes. Nombres ambiguos enumeran candidatos, no se adivinan.
- Todo lo nuevo aquí solo lee, sin enviar ni marcar.

### Correcciones [#correcciones-46]

- **`--offline` funciona.** Antes, la opción no llegaba a ningún comando: la lectura seguía contactando con MAX, y `max --offline messages send` **enviaba un mensaje**. Ahora la lectura utiliza los datos guardados, mientras que el envío y la descarga se rechazan con `--offline`.
  Ten en cuenta: si ejecutaste `--offline messages send` en 0.4.0 o antes, el mensaje se envió.
- **Los errores del archivo de ajustes se explican con claridad:** qué ajuste es desconocido, cuáles existen y qué valores se aceptan. Antes eran mensajes de la biblioteca de validación.
- **Un fallo de `--record` no derriba la orden.** Aviso stderr, respuesta/código sin cambios; visible incluso con `--quiet`.

### Seguridad [#seguridad-21]

- **Publicación desde GitHub Actions con procedencia npm**, para verificar el repositorio de compilación.

## 0.4.0 — 23.09.2026 [#040--23092026]

### Novedades [#novedades-91]

- **`max messages show <чат> <id>` muestra uno; `max messages context <чат> <id>` con `--before`, `--after` muestra contexto.** Marcado `◀` y `"anchor": true`. Si falta, «no encontrado», no el vecino.
- **`max skill show` imprime instrucciones incluidas:** `max skill show > ~/.claude/skills/max-cli/SKILL.md`.
- **`max config show` explica perfil/origen**, archivo/existencia, todos los perfiles incluso solo de estado, ajustes y fuente (indicador, variable, archivo, integrado). `MAX_CONFIG_DIR` y similares avisan de entrada de claves distinta.
- **Texto mediante pipe:** `echo "текст" | max messages send <чат>`, sin argumento lee stdin. Evita `ps`/historial y permite saltos de línea.
- **`--timeout <срок>` limita toda la ejecución**, conexión, entrada y solicitud, no una respuesta.
- **`max doctor` revisa dependencias sin MAX:** fuente del token sin revelarlo, número/último inicio, perfiles, estructura de base y entrada de claves. Funciona con todo roto; falta de sesión es dato, no error.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-56]

- **La opción `--query` de las listas pasa a llamarse `--search`.** El cambio ya se incluyó en 0.3.0, pero faltaba en sus notas.
  Ten en cuenta: un script con `--query` da error; sustitúyelo por `--search`.

### Correcciones [#correcciones-47]

- **`messages list --before <id>` no requiere lectura previa**, obtiene tiempo del ID.
- **Miembros con nombres, no números.** Antes solo contactos tenían nombre; ahora una petición obtiene y guarda todos, incluidos autores de respuestas/reenvíos.
- **La publicación no se detiene antes de crear el tag.** Ocurrió dos veces; ahora verifica npm sin caché y espera hasta tres minutos.

## 0.3.0 — 22.09.2026 [#030--22092026]

### Novedades [#novedades-92]

- **Conversaciones como transcripción:** divisores diarios, `время  автор`, texto alineado y ajustado al terminal. `вы` eres tú; sin nombre aparece ID. `↳` responde, `↪` reenvía; MAX entrega originales completos y se guardan.
- **`-v`, `-vv` añaden detalle:** IDs de mensaje/autor/chat y URLs; después todo lo conocido.
- **`--jsonl` da objeto JSON por línea**, para streaming y `jq`.
- **Adjuntos como enlaces:** `📎 photo`, `📎 photo ×3 1 2 3`, `📎 файл.pdf · 24 MB`; JSON `url`, `width`, `height`, `title`. El enlace de foto no requiere sesión: quien lo recibe puede verla.
- **`senderColors: true` da color por autor**, desactivado por defecto.

### Cambios que pueden romper scripts [#cambios-que-pueden-romper-scripts-57]

- **`-v` ahora indica el detalle de la salida; la versión se consulta con `max -V`.** **`--trace`** activa las líneas de solicitudes en stderr; antes se llamaba `--verbose`.
  Ten en cuenta: los scripts que usaban `max -v` para la versión o `--verbose` para las trazas deben pasar a `-V` y `--trace`.
- **`--query` pasa a `--search`**, inicialmente no anotado.
- **La copia local pasa al esquema 4 y se reconstruye en la primera ejecución.**
  Ten en cuenta: en esta versión no se conserva el historial leído; tendrás que leerlo de nuevo.

### Correcciones [#correcciones-48]

- **Nombres ambiguos enumeran candidatos con ID**, JSON `candidates`.
- **El aviso local indica estructura y solución**, antes solo `Error`.
- **Continuación de `messages list` sugiere `--before <id>`**, no el inexistente `--page`.

## 0.2.0 — 22.09.2026 [#020--22092026]

### Novedades [#novedades-93]

- **`max messages send --silent` envía sin aviso.** Aún no se comprobó el comportamiento real porque exigiría escribir a una persona.
- **Intercambio del token al primer inicio.** MAX devuelve su token; `max` lo guarda en claves en lugar del pegado. Solo una vez.

### Correcciones [#correcciones-49]

- **`max session start` no destruye el token válido.** Antes guardaba antes de validar y una errata lo sustituía; ahora valida y luego guarda.
- **Perfil vinculado al mismo usuario.** Token de otra cuenta se rechaza explicando por qué: evita actuar como otra persona.
- **La sugerencia tras envío incierto usa una orden real**, no `max send`.
- **No se descartan mensajes de la respuesta de entrada** por estructura mal descrita.

## 0.1.0 — 21.09.2026 [#010--21092026]

Primera versión que se puede compartir.

### Novedades [#novedades-94]

- **Siete órdenes sobre MAX real:** `session start|end`, `account show`, `chats list`, `contacts list`, `messages list`, `messages send`.
- **Perfil primero:** `max personal chats list`. Cuentas independientes con token, estado y copia propios; también `MAX_PROFILE`.
- **Token en el almacén del sistema**, no archivo ni argumento. Aún sin entrada por teléfono: `max session start` obtiene el del cliente oficial.
- **Modo máquina:** `--json` da un valor en stdout, también automáticamente sin terminal. Error stderr, stdout vacío. Decide por código de salida: [Referencia docs/commands.md](/llms.mdx/docs/es/max/commands/content.md).
- **Diagnóstico sin contenido:** `--verbose` petición por línea; `--record` conserva 30 días; `max runs list|show|path` lee. Por defecto nada registrado.
- **Copia local:** lecturas guardadas; `--offline` sin conexión; `max cache clear` elimina.
- **`~/.config/max-cli/config.json`**, prioridad indicador → variable → archivo → integrado. Erratas son errores explícitos.
- **Node 22+ y Bun 1.3+**, ambos comprobados en CI.
- **Leer no marca leído.** Obtener historia y marcar son operaciones distintas; la segunda nunca se envía, verificado con prueba.
- **Resultado de envío honesto:** sin respuesta `outcome_unknown` (`14`), sin afirmar fallo/éxito. Repite solo con el mismo `--cid` para evitar doble envío.
- **Protocolo MAX no oficial por ingeniería inversa**, separado de Bot API. Puede cambiar sin aviso; se informa con una línea stderr, no falla en silencio.
- **Aún sin** teléfono, adjuntos, reacciones, ediciones, grupos, historias ni llamadas: solo texto. No habrá envíos masivos con la cuenta personal.
