# Changelog

Lo que cambió en lo que se integra: la API, el MCP, los webhooks, el SDK y la CLI. Del más nuevo al más viejo.

## 2026-10-15 · En el modo Libre, editar un agente lo publica, y volver es «Deshacer»

_mcp · portal_

- `editar_agente` en el modo Libre publica la versión nueva en producción y lo dice (`publicado_en_produccion`, `version`); trae `deshacer`, la llamada a `volver_a_version` que vuelve a la anterior. Con `desplegar_hasta` sigue el camino de promover; en Con controles y Regulado, la edición queda en dev como siempre. Quien no publica (un desarrollador) edita en dev y la respuesta dice por qué.
- `volver_a_version` a producción, en el modo Libre, vuelve también la definición del agente (herramientas, control, correa): si no, la próxima edición publicaba de nuevo lo que se había deshecho.
- Un servidor MCP nuevo entra según el modo de control: en Libre sólo queda en cuarentena lo que borra, paga o manda en masa; en Con controles, lo que escribe; en Regulado, todo. `conectar_servidor_mcp` y `conectar_base` dicen cuántas quedaron en cuarentena.
- En el portal, guardar un agente en el modo Libre lo publica y deja «Deshacer» arriba; la ayuda del formulario dice qué va a pasar antes de guardar.

## 2026-10-15 · Las cuentas de la organización, calculadas por el servidor: cuántas, cuánto, por agente o por día

_mcp · portal_

- `consultar_numeros` (lectura nueva) { vista, medida?, por?, periodo?, agente_id? }: una vista de una lista cerrada —`tareas` (tareas pedidas o frenadas), `gasto` (costo de modelo o ejecuciones) o `aprobaciones` (aprobadas o rechazadas, con cuántas decidió una persona y cuántas el sistema)—, agrupada por agente, columna del tablero de Tareas, día o semana. No hay SQL ni tablas: un argumento o un valor que no es de la lista se rechaza diciendo cuáles hay.
- La respuesta trae el período con fechas, cortado en la zona horaria de la organización, el día de hoy, el total ya sumado, cada grupo con su nombre y lo que no entró en la lista. «Frenada» es la columna Frenada de Tareas, la misma cuenta que el Inicio. Corre en una transacción de sólo lectura, con el recorte por agente de quien pregunta.
- En el portal, el chat del Inicio la dibuja debajo de la respuesta (barras o serie por día), y la cuenta de un agente se guarda en el tablero de la persona con ese agente.

## 2026-10-15 · Lo que el agente no terminó ya no es una aprobación

_mcp · portal_

- `aprobaciones_pendientes` ya no trae las tareas que el agente dejó sin terminar (un «no pude» que otra vuelta no arregla, o algo de afuera como una llave vencida): aprobarlas las cerraba como hechas.
- `seguir_tarea` también las hace seguir: vuelven a la cola desde donde quedaron, con lo que ya hicieron.
- `inicio` suma `esperan_otra_cosa`: lo que espera a una persona y no es una aprobación (una pregunta del agente, una herramienta que le falta, una tarea sin terminar). `como_vamos` lo dice en una línea.
- En el portal, Te espera las muestra como «Frenada» con el porqué, y la tarea y el chat traen «Que siga desde donde quedó».

## 2026-10-15 · Cuando el agente pregunta o le falta una herramienta, se resuelve ahí: no es una aprobación

_mcp · portal_

- `contestar_pregunta` (escribe): contesta la pregunta que un agente dejó en una tarea, y la tarea sigue desde donde quedó con todas las respuestas anteriores. Una respuesta que parece una clave se rechaza; una pregunta que pide una llave o trae órdenes no se contesta por acá.
- `seguir_tarea` (escribe): para una tarea a la que le faltó una herramienta, se la prende al agente si la organización ya la tiene y la tarea sigue; si la app no está conectada, dice qué conectar.
- `aprobaciones_pendientes` ya no trae esas tareas: aprobarlas las cerraba como hechas.
- En el portal, Te espera las muestra como «Te pregunta» y «Le falta algo», con la caja para contestar o el botón para seguir, igual que la tarjeta del chat y la tarea.

## 2026-10-15 · El modo de control de la organización: Libre, Con controles o Regulado

_mcp · portal_

- `politica_de_publicacion` dice el modo de la organización (`modo`, `modo_titulo`, `modo_en_una_linea`): con qué diales nacen sus agentes. Libre es el de nacimiento: los controles se prenden.
- `configurar_publicacion` acepta `modo` y `aplicar_a_actuales`: cambia el modo para los agentes nuevos y, si se pide, también para los que ya existen, y la respuesta dice qué le cambió a cada uno. Regulado prende cuatro ojos y la ventana de cambios; los otros dos los apagan. Aflojar el modo lo decide un técnico o un admin; si toca cuatro ojos o la ventana, un admin.
- `editar_agente` acepta `modo`: los diales de un modo de una vez, y rigen desde ya, sin publicar.
- `crear_agente` sin `human_in_the_loop` ni `verificacion` toma los del modo. La verificación del modo se prende sólo si el agente dice cómo se comprueba su trabajo: sin eso no hay qué releer.
- En el portal, Ajustes → Seguridad muestra los tres modos con la lista de lo que cambia antes de elegir, y la ficha de cada agente dice su modo.

## 2026-10-15 · Qué es YoRobot, como lectura: el chat lo explica con lo que puede citar

_mcp · portal_

- `explicar_yorobot` (lectura nueva, sin argumentos): qué hace la plataforma, los precios y la prueba de hoy, la Escuela y la Academia, en las mismas palabras que la página de precios. Es para preguntas sobre YoRobot mismo, no sobre la organización.
- En el portal, el chat del Inicio la lee para contestar qué es YoRobot o cuánto cuesta, y la respuesta sale citada en vez de marcada «sin respaldo».

## 2026-10-11 · El próximo paso hacia «Implementador certificado», por MCP y en el chat

_mcp · portal_

- `proximo_paso` (lectura nueva, sin argumentos): el camino de la organización hacia la certificación, medido sobre lo que hizo —los siete ejercicios de la Academia y los módulos de la Escuela, cada uno con «hecho» o «falta», dónde se hace y cuál es el próximo paso—. Con la organización en la prueba dice que Diagnóstico y Venta están cerrados y no entrega sus ejercicios.
- «Creá un agente» y «Probalo con un caso» ya no se aprueban con el agente de ejemplo que deja el alta: cuentan los agentes propios, igual que en el Inicio.
- Diagnóstico se aprueba con el objetivo de la organización y su número de hoy, sea la línea de base declarada o la primera medición con valor.
- En el portal, «Hacerlo ahora» de Diagnóstico lleva a Chats, donde se fija el objetivo de la organización conversando con el copiloto.

## 2026-10-10 · Lo que pasa ahora, el lote de trámite, el ranking y los últimos días, por MCP

_mcp · portal_

- `inicio` trae `ahora`: lo mismo que el cockpit del Inicio —cuántos agentes trabajan y cada corrida en vivo con su tarea, desde cuándo (`desde`, `hace`) y el silencio como booleanos (`sospechoso`, `critico`)—, y la madre que espera a sus hijas (`espera_hijas`).
- `aprobaciones_pendientes` dice `tramite` por fila (verificada en limpio, sin discrepancia, libre y sin nada que salga al mundo) o `por_que_no_es_tramite`; `tramite` arriba cuenta toda la cola.
- `aprobar` acepta `tarea_ids` (hasta 50): entra sólo lo que es trámite, lo demás vuelve en `rechazadas_del_lote` con su motivo (una sola frase para lo ajeno, lo inexistente o lo ya decidido), y devuelve UN `enlace` a Aprobaciones con el lote preseleccionado, que la persona aprueba con su sesión. Sigue sin aprobar nada la IA. En el portal, `/dashboard/aprobaciones?lote=<ids>` preselecciona el lote; el contador del lote hecho pasó a `?aprobadas=`.
- `ranking_de_agentes` { orden?, dias? }: la pantalla Ranking para el modelo, con cada número y su denominador (`verificadas` {n, de, tasa} sobre las tareas, `sin_discrepancia` sobre las medidas), el costo por tarea y el `crecimiento` contra el período anterior. `orden`: verificadas, discrepancias, costo_por_tarea o crecimiento; `dias` de 1 a 90 (30 por defecto).
- `actividad_por_dia` { dias? }: las tiras de Consumo día por día en UTC (corridas, costo, verificación con su denominador), los días sin trabajo en cero, el total del período y, con 14 días o más, los últimos 7 contra los 7 anteriores.
- Las dos lecturas nuevas no son del puesto de operación: a un token de un operador le contestan `sin_alcance`, como la pantalla lo redirige.

## 2026-10-10 · Las rutinas por MCP vienen en palabras: cuándo corre, cuándo es la próxima y qué pasó la última vez

_mcp · portal_

- `listar_rutinas` trae por rutina y por disparador `cuando` (cuándo corre, en palabras), `proxima` (la próxima corrida, dicha desde ahora y en la zona de quien pregunta, que viaja en `horas_en_zona`; `null` si no va a correr sola) y `ultima` (qué pasó la última vez que disparó y hace cuánto). El `cron` crudo y su huso se quedan.
- En el portal, Rutinas dice la última vez de cada rutina por su registro de disparos (antes lo deducía del reloj y del último rebote de la semana), y una rutina apagada ya no muestra próxima.

## 2026-10-10 · Las tareas por MCP dicen lo mismo que el tablero, y la tarea trae lo que devolvió el agente y su hilo

_mcp_

- `listar_tareas` trae por tarea `columna` y `columna_texto` (la columna del tablero de Tareas: Pendiente, Trabajando, Te espera, Frenada o Hecho), `que_la_mueve` en una frenada, `hijas: { listas, total }` en una madre y `silencio` con una corrida activa. Y filtra por `columna`.
- `estado_de_tarea` trae `resultado` (lo que devolvió el agente: `texto`, `hizo`, `no_pudo`, rotulado como lo que dice él y no la verificación) y `conversacion` (el hilo con sus hijas: quién pidió qué y qué contestó cada una, los últimos 30 turnos con el recorte avisado en el dato, y las horas en la zona de la persona).

## 2026-10-06 · Retener sin repetir: una corrida muerta con un efecto pedido no se vuelve a correr sola

_mcp · portal_

- Una tarea cuya corrida murió con una acción con efecto pedida y sin resultado queda RETENIDA: el worker no la retoma y el barrido la deja esperando a una persona. Repetirla podría mandar lo mismo dos veces.
- `resolver_efecto_incierto` (y el mismo cuadro en la tarea, en el portal): quien opera dice `no_salio`, `salio` o `a_medias` con evidencia. Las dos primeras la vuelven a la cola con una continuación (`salio` marca lo que salió para que no se repita); `a_medias` la deja esperando a una persona. Queda en la auditoría con su nombre.

## 2026-10-05 · El Vigía de mercado: un sub-agente del copiloto que sale a internet y vuelve con recomendaciones citadas

_mcp · portal_

- `armar_vigia_de_mercado` arma (o devuelve) el Vigía de la persona: sub-agente de su copiloto que sólo busca y lee páginas públicas por el portal, sin herramientas que escriban y corriendo contenido. Salvo `semanal: false`, el copiloto le reparte una vuelta por internet los lunes a las 8.
- `pedir_al_vigia` le pide una búsqueda ahora. La tarea es del copiloto, que le reparte al Vigía y recibe su informe.
- El informe del Vigía vuelve en `arbol_de_tarea` (`hijas[].informe`): hechos con `url`, `fuente`, `publicado_el` y `consultado_el`, cada uno `comprobado` sólo si su cita está en la página que el portal trajo en esa tarea; señales, inferencias y recomendaciones con `confianza` y `requiere_aprobacion`. Una recomendación sin hechos comprobados sale `respaldada: false`, y su texto libre no cruza a la madre.

## 2026-10-05 · Una tarjeta por agente: gasto, tope del mes, firma pendiente y membresía

_api · mcp · sdk · portal · docs_

- Alcance nuevo `topes`: sólo fija el tope de gasto de un agente. Con sólo `topes` un token no lee nada ni pide tareas. Es el que lleva el token de una aplicación conectada.
- `GET /api/v1/agentes` ve sólo lo que ve la persona del token (antes, el plantel entero) y trae `contexto`, `total` y, por agente, `ultima_actividad` (y `_local`), `gasto_mes_usd`, `tope_mes_usd`, `bloqueado`, `te_esperan` y `portal_url`. La clave `agentes` sigue.
- `GET /api/v1/agentes/{id}`: el gasto contra su tope y el de la organización (`porciento`, `bloqueado`), sus 30 días y `esperan_tu_firma` con `aprobar_en`.
- `PUT /api/v1/agentes/{id}/tope` y `fijar_tope_de_agente` por MCP: el tope de gasto del MES de un agente. Al llegar, sus tareas nuevas frenan igual que con el tope de la organización (cola, API, canales, llamadas). Nunca mayor que el tope mensual de la organización; ponerlo o bajarlo lo hace quien opera el agente, subirlo o sacarlo un técnico o un admin. Un error trae `{ error, mensaje }`. En el portal, «Tope de gasto del mes» en Permisos y límites del agente.
- `GET /api/v1/membresia` y `ver_membresia`: el plan con su nombre y si hay algo que pagar (hoy `sin_facturacion`, sin link de pago).
- `GET /api/v1/aprobaciones?agente=<id>` filtra por agente.
- `/openapi.json` publica el esquema de la respuesta de todas las rutas. Corregido: `POST /agentes/{id}/charla` pide `escritura` y contesta NDJSON, como hacía el código.
- SDK: `agente()`, `fijarTope()`, `membresia()`, `aprobaciones({ agente })` y `ErrorDeYoRobot.codigo`.

## 2026-10-05 · Aplicaciones conectadas: Che Tienda se conecta sin copiar un token

_api · mcp · portal · docs_

- `conectar_aplicacion { aplicacion: "che-tienda", tienda? }`: YoRobot crea un token nuevo a nombre de quien conecta (alcances `lectura` y `topes`, sin vencimiento), se lo entrega a la app de servidor a servidor con una firma Ed25519 y sella la credencial que la app devuelve; las lecturas de su OpenAPI quedan como conexiones activas. Si la app no contesta 200, el token queda revocado. Lo hace un técnico o un admin.
- `listar_aplicaciones_conectadas` y `desconectar_aplicacion { vinculo_id }`: la baja revoca el token, borra la credencial y las conexiones, y le avisa a la app con `vinculo.revocado`.
- `DELETE /api/v1/vinculos/{id}`: la baja pedida por la app, con el token de ese vínculo. La llave pública está en `/.well-known/jwks.json`.
- En el portal: el botón de la app lleva a `/conectar/che-tienda`, y Ajustes → Aplicaciones lista las conectadas con su Desconectar. El contrato completo está en «Aplicaciones conectadas» de `/docs/api.md` y en `AGENTS.md`.

## 2026-10-04 · Lo aprobado sale: el post de LinkedIn y el mail del SDR de Growth

_mcp · portal_

- Al aprobar una tarea, el post de LinkedIn (`redes_publicar`) y el mail del SDR (`gmail_enviar`) que el agente dejó esperando salen una sola vez, por un worker, con los argumentos exactos que se aprobaron. Sólo los de la corrida que se aprueba, y nunca de un agente en «Propone, no toca nada». Las escrituras de Datos que esperaban el OK se guardan al aprobar.
- Quien aprueba ve entero lo que sale (en la tarea, en la app y en el enlace de aprobación) y lo que no sale, con su porqué. El enlace de aprobación por MCP devuelve en cada acción `que` y `sale_al_aprobar` (y `por_que_no` cuando no sale).
- `ver_traza` suma `efectos_aprobados`: qué salió, con `estado_texto`, `salio` (`true`, `false` o `null` si no se sabe) y, en un post, `publicado`.

## 2026-10-04 · Un agente se puede eliminar para siempre

_mcp · portal_

- `eliminar_agente`: borra el agente con sus versiones, despliegues, casos, evaluaciones, memorias, canales, automatizaciones, llamadas y conversaciones. Sólo un admin, sólo un agente en descanso y sin tareas corriendo, y con `confirmar` igual a su nombre. Las tareas que hizo quedan sin agente, y la auditoría guarda `agente.eliminado`.
- En el portal, la configuración del agente termina en una «Zona de peligro»: mandarlo a descanso y, para el admin, «Eliminar agente» cuando está en descanso.

## 2026-10-03 · La autonomía del proyecto se sube desde el portal y el MCP

_mcp · portal_

- `fijar_autonomia_del_proyecto`: fija el nivel de un proyecto (`shadow`, `assisted`, `delegated`, `gated_auto`) por `proyecto_id` o `repo`. Bajar lo hace cualquier operador; subir, un técnico o un admin; `gated_auto` sólo un admin y nunca en un proyecto de cara al cliente. Responde `abre_pr` y `mergea_solo` con el nivel que rige, y el cambio queda en la auditoría.
- En el portal, el proyecto muestra su autonomía y se cambia ahí mismo; instalar el equipo técnico ofrece «que abran PR», que sube los proyectos elegidos a «2 · Delegado» sin bajar los que ya estaban más arriba.

## 2026-10-03 · North Star en porcentaje, y «Seguimiento de CRM» armado

_mcp · portal_

- `definir_objetivo`: una métrica de Datos puede ser una proporción (`"agregado": "proporcion"`: el % de los registros con `campo` lleno, con `"unidad": "%"`) y contar varios `estados` a la vez. Sin registros que contar queda «no pude medir», no un 0 %.
- `crear_agente_desde_trabajo` con `crm` crea el agente directamente (antes devolvía el pedido para el Constructor), con su North Star: el % de las oportunidades abiertas con un próximo paso aceptado por una persona. El agente lo propone; aceptarlo y mover la etapa es tuyo.

## 2026-10-02 · El North Star y las conexiones, dentro del alta

_mcp · portal_

- `crear_agente_desde_trabajo` acepta `meta`: fija tu North Star al crear (el `north_star_sugerido` de `listar_trabajos`, cuando `se_mide_al_nacer`) y lo devuelve medido en `north_star.hoy` («Hoy está en 0. La meta es 3.»). El agente deja además su primer mensaje en tu conversación con él, armado por el servidor con lo que hay en Datos, el North Star y lo que falta conectar.
- `definir_objetivo`: una métrica de Datos puede contar por el `estado` del registro («las oportunidades en demo»), validado contra los estados de la entidad.
- `listar_trabajos`: una llave que su sistema rechazó en la última prueba ya no cuenta como conectada. Growth nombra los sistemas que su equipo usa de verdad (Cal.com y MuAPI); Atención de clientes y Reporte para gerencia se arman con el Constructor.
- En el portal, el paso 2 del alta conecta cada sistema ahí mismo, con la prueba de la llave, y las acciones que la pieza usa vienen prendidas. El paso 3 muestra el valor de hoy del North Star y lo fija con su meta.

## 2026-10-02 · Crear un agente desde lo que delegás

_mcp · portal_

- `listar_trabajos`: lo que una empresa delega —«Growth: conseguir reuniones», «Atención de clientes», «Cobranzas», «Reporte para gerencia», «Seguimiento de CRM»—, con lo que gana, qué hace el agente, los sistemas que usa y si ya los conectaste (`conectado`, `sistemas_sin_conectar`), lo que siempre pregunta antes de hacer y el North Star sugerido. `se_crea_al_llamar` dice si hay una pieza armada en la biblioteca.
- `crear_agente_desde_trabajo`: crea el agente de un trabajo igual que «Crear un agente» del portal, sólo en prueba. De un equipo devuelve el líder, que reparte. Con `preguntar_todo: true` pide aprobación también antes de lo que se puede deshacer. Si el trabajo se arma con el Constructor no crea nada y devuelve el `pedido` para `hablar_con_el_constructor`.
- En el portal, «Crear un agente» arranca por el trabajo, en tres pasos —qué delegás, qué sistemas usa, tu objetivo y lo que te pregunta— con la ficha del agente armándose al costado. El Constructor de Chats ofrece los mismos trabajos. Las piezas de la biblioteca siguen instalables, al pie del alta.

## 2026-10-01 · De día: tu copiloto se despierta por tu North Star, con cuota para interrumpirte

_mcp · portal_

- `configurar_despertadores`: lo que despierta a tu copiloto por tu número —un umbral de tu número, de una entrada o de una contramétrica; algo nuevo en una fuente viva que toca tus temas; un registro de Datos que cambia de estado; una decisión que vence sin respuesta; una hora— y qué hace al despertarse: `investigar` (sólo avisa), `borrador` (te deja la tarea armada) o `piloto` (hace lo que se deshace y no mueve plata sin tu aprobación, y te lo cuenta). Una contramétrica que cruza su umbral lo despierta siempre, y es urgente.
- Cada despertar pasa antes por una evaluación barata: si no importa para tu número, no te escribe. El mismo evento no despierta dos veces.
- `editar_mi_perfil` suma `silencio_desde`, `silencio_hasta` y `avisos_por_dia` (3 por defecto): lo que cae en tu silencio o pasa tu cuota te llega en el briefing de la mañana. Lo urgente puede saltar la cuota una vez por día, y lo dice. `listar_objetivos` y `ver_objetivo` traen los `despertadores` en palabras y el `escalon`.

## 2026-10-01 · El sueño: tu copiloto repasa el día de noche y te deja la mañana preparada

_mcp · portal_

- Cada noche, antes de tu briefing (por defecto a las 02:00 de tu zona), tu copiloto repasa el día —la conversación, tus decisiones, tus tareas con el veredicto del verificador y tu North Star— y deja: lo que aprendió, hasta tres preguntas, hasta tres propuestas hacia tu número (cada una con la tarea en borrador que la haría) y las lecturas que probablemente pidas, ya calculadas. Si no pasó nada desde la última noche, no duerme y no cuesta nada. De noche sólo lee: no manda mensajes ni escribe en ningún sistema.
- `ver_diario_de_sueno`: la noche, con cada oración del diario marcada con evidencia o como inferencia, el plan con su impacto marcado estimado, las lecturas y la autoevaluación de lo de ayer (efecto verificado o coincidencia). `configurar_sueno`: prenderla, apagarla, moverla o cambiarle el tope por noche.
- `listar_aprendizajes`, `aceptar_aprendizaje` y `rechazar_aprendizaje`: tus preferencias las guardás vos (y viajan sólo a lo que trabaja para vos); lo del negocio lo acepta un admin o un técnico en Memoria. Todo pasa por el filtro de memorias, y lo que sólo dijo un tercero no alcanza como evidencia.
- En la app, la tarjeta «Anoche» llega a tu conversación con el copiloto con «Guardar / No / Editar», y las propuestas como decisiones: «Hacerlo» encarga la tarea a tu nombre, con los permisos de tu copiloto.

## 2026-10-01 · El North Star: el número que persigue tu copiloto

_mcp · portal_

- `definir_objetivo`: el número que, si mejora, sabés que te fue bien, contra una fuente que el sistema sabe leer —una entidad de Datos (suma, cuenta, promedio o último valor, con filtro y ventana), una lectura del copiloto (el número sale de una `ruta` en su respuesta) o la carga manual—. Sin `guardar: true` es la vista previa: valida la métrica contra tus fuentes y la mide una vez («Hoy está en US$ 740.000. La meta de US$ 1.200.000 es +62 % en 91 días»). Uno activo por persona; el de la organización lo fija un admin. Cambiar la métrica o la meta es una versión nueva.
- `listar_objetivos`, `ver_objetivo`, `medir_objetivo` y `pausar_objetivo`: el número de hoy ya calculado por el servidor —`valor`, `meta`, `falta`, `avance_pct`, `va_bien` (null mientras no se sabe) con su porqué, la proyección marcada estimada, `medido_at` y la `cita`—, más las métricas de entrada y las contramétricas. «No pude medir» queda escrito, al lado del último valor bueno. Definirlo, medirlo y pausarlo piden tu propio token o tu conexión OAuth.
- En la conversación con tu copiloto: te pregunta cuál es tu número, lo propone contra tus datos y lo confirmás con un botón (`ver_hilo` lo trae como bloque `objetivo_propuesto`). Desde ahí persigue ese número y lo muestra con el bloque `objetivo`. En la app, «Mi North Star» va arriba de Hoy y del panel del copiloto.

## 2026-10-01 · Microsoft Teams como canal

_portal · mcp_

- En Capacidades → Canales, un agente se conecta a Microsoft Teams con el bot de Azure de la organización (App ID, App secret y Tenant ID): le hablan en un chat o mencionándolo en un canal, y contesta en el mismo hilo. Al conectar, el portal da la URL del webhook y el `manifest.json` para subir a Teams. Cada mensaje entra con el token que firma Microsoft para ese bot; sin él, 401.
- `editar_mi_perfil` con `canal: teams`: una vez vinculado con el código, el briefing llega como tarjeta al chat con el bot, con un botón por opción; contestar con el número también elige. Lo irreversible no se elige desde Teams: su botón abre el portal.
- `avisar_a` acepta `tipo: teams` con la URL del webhook de Workflows del canal: el aviso llega como tarjeta con el link a la cola. `conectar_canal` no conecta Teams: contesta con el link a la pantalla, que es la que da el manifest.

## 2026-09-30 · Recordatorios desde la conversación

_mcp_

- Un agente puede proponerte un recordatorio en la conversación —«recordame el jueves a las 9 que llame a Marta», «todos los lunes mandame el pipeline»—: `escribir_en_hilo` y `ver_hilo` lo traen como bloque `recordatorio`, con la fecha ya resuelta en tu zona (`cuando`: «jueves 2/10 09:00 ART») y `se_puede_confirmar`. Es una propuesta: no existe hasta que la confirmás en la app.
- A esa hora te llega por tu canal (la app del teléfono, WhatsApp —también el de YoRobot—, Slack, Telegram o correo, según tu perfil) y queda en la conversación. Uno que pregunta lo contesta el agente leyendo tus datos, sin encargar trabajo. Por la app del teléfono el aviso dice que tenés un recordatorio y de qué agente, no qué dice; por el WhatsApp de YoRobot, pasadas 24 h desde tu último mensaje te llega el aviso, y el recordatorio cuando contestás.
- En la conversación de Chats, la propuesta se confirma con un botón. Si te la propone por el WhatsApp de YoRobot, te llega dicha con el link para confirmarla en la app.
- `listar_recordatorios`, `pausar_recordatorio` y `borrar_recordatorio`: los tuyos, con el próximo aviso, cómo te llegó el último, cuántos te quedan hasta el tope y los que un agente te propuso y todavía no confirmaste (`sin_confirmar` los cuenta todos; `propuestas_sin_confirmar` trae los 10 más nuevos, y `propuestas_recortada` dice si hay más). Piden tu propio token o tu conexión OAuth, como la conversación: uno que un admin emitió a tu nombre contesta `requiere_persona`. También en la app, en Mis recordatorios.
- La automatización de un recordatorio («Recordatorio de …») es de su persona: se dispara sólo a su hora. `disparar_rutina` y `POST /api/v1/automatizaciones/{id}/disparar` la rechazan (`estado_invalido`; 409), y `editar_rutina`, `prender_rutina`, `apagar_rutina` y `agregar_disparador` contestan con la frase. Borrarla con `borrar_rutina` sí se puede. `listar_rutinas` se la muestra sólo a quien opera, y `exportar_equipo` no la lleva.

## 2026-09-30 · La app en el teléfono

_mcp · portal_

- `editar_mi_perfil` acepta `canal: app`: el briefing te avisa al teléfono donde activaste los avisos de la app (Web Push). El aviso dice que llegó, no qué dice: se lee en la app, con tu sesión. Sin avisos activos, `mi_perfil` dice en `entrega` que te llega por el portal y por qué.
- La app (`/app`, y `app.yorobot.ai` donde está configurado): Chats, Hoy —tu briefing, los números que cambiaron, tus decisiones y lo que fijaste desde una conversación—, Aprobaciones y Yo. Cada agente tiene su página (`/a/<id>`) para agregarlo a inicio con su cara o guardarlo como contacto.

## 2026-09-30 · Crear un agente conversando con el Constructor, desde tu editor

_mcp · portal_

- `hablar_con_el_constructor`: la misma entrevista que el Constructor de la app, turno a turno. Cada respuesta trae `plan_parcial`, la ficha del agente como va: lo que entendió, lo que falta y, cuando hay plan, los sistemas en palabras, el escalón de autonomía, qué te va a preguntar antes de actuar (`que_te_pregunta` y `todo_con_efecto_espera_aprobacion`, con la misma regla que aplica el agente al ejecutar), el tope con `el_tope_decide_algo` y los actos. Mandá la `sesion` que devuelve el primer turno en los siguientes.
- Cuando alcanza, el plan pasa por la misma validación que la app y queda como borrador: `creado: false` y `confirmar_en`, el link donde la persona lo revisa y lo confirma con su sesión. La misma entrevista da el mismo plan por el MCP y por la app.
- En el portal, «Nuevo agente» abre un chat con YoRobot · Constructor en Chats: la ficha del agente se arma al costado mientras charlás, y al confirmar el agente nace en prueba y se presenta en el mismo hilo.

## 2026-09-30 · Lo que el agente te muestra en la conversación

_mcp_

- `escribir_en_hilo` y `ver_hilo` traen `bloques`: lo que el agente muestra además de contestar —un contador, una tabla, una lista, un gráfico, una línea de tiempo, un mapa—, con los números que calculó el sistema, el período en fechas y, pegado a cada lista, si está recortada. El agente nombra qué mostrar; los datos los resuelve el servidor con tu alcance.
- Una decisión que el agente propone en la conversación trae sus opciones, la recomendada, el porqué y sus citas comprobadas contra lo que leyó. Lo irreversible no se elige desde el chat: se firma en su página del portal (`firmar_en`).
- `generar_pdf`: un PDF con bloques de Datos que queda como archivo en tu conversación con el agente, con el link para bajarlo; con `incluir_contenido: true`, también en base64.

## 2026-09-30 · Tu conversación con cada agente

_mcp_

- `escribir_en_hilo`: le escribís a un agente en tu conversación con él —la misma que vas a ver en la app— y te contesta en segundos con sus lecturas y la versión publicada en producción. Si lo que pedís cambia datos, lo encarga como tarea y la respuesta trae `tarea_id`; con `como_tarea: true` va directo como tarea.
- `ver_hilo`: la conversación en orden, con las tareas que encargó y su estado, y los briefings que te entregó como copiloto con sus decisiones. Es sólo tuya: nadie más la lee, tampoco un admin.
- `listar_hilos`: tu bandeja, con cada agente al que llegás, el último mensaje y cuántos tenés sin leer.

## 2026-09-30 · Los workers se actualizan cuando el portal se lo pide

_mcp · portal_

- `desplegar_workers`: pide a los workers de la organización que corran una versión (un sha de git; sin `version`, la del portal). El pedido viaja en la respuesta del próximo claim: el worker termina la tarea que tenga, deja de reclamar y la máquina se actualiza sola. También desde el botón de Procesos.
- Si la versión nueva no arranca en cinco minutos, la máquina vuelve sola a la anterior y el worker lo cuenta: esa versión no se vuelve a pedir sola, y pedirla de nuevo es el reintento. Una máquina sin el actualizador instalado lo dice en su log y sigue reclamando como antes.

## 2026-09-30 · Conectar WhatsApp e Instagram desde YoRobot

_mcp · portal_

- `conectar_whatsapp`: conecta a un agente el WhatsApp Business que la organización ya usa, que sigue andando en la app del celular. Devuelve un enlace a YoRobot: la persona entra con Facebook, elige su número y lo valida con el QR o el código que le llega, sin pasar ningún código por el chat.
- `conectar_instagram`: conecta los mensajes directos de la cuenta profesional de Instagram de la organización. El enlace lleva a entrar con Instagram y autorizar los mensajes; el agente contesta dentro de las 24 h del último mensaje de cada persona, y una respuesta larga sale en varios mensajes.
- `estado_de_conexion`: cómo va el alta, en una palabra (`esperando_alta`, `conectado`, `fallida`, `vencida` o `reemplazada`), con `conectado` como booleano, la cuenta y el agente. El canal se prende solo cuando Meta confirma la cuenta.
- Si una persona de la organización contesta desde la app en una conversación, el agente se calla en esa conversación y retoma cuando la persona deja de escribir 30 minutos; una respuesta suya que haya quedado en cola no sale.
- `conectar_canal` queda para Slack y Telegram. WhatsApp e Instagram se habilitan cuando YoRobot activa cada red; hasta entonces las herramientas contestan que todavía no está habilitado.

## 2026-09-29 · El copiloto de cada persona: su briefing diario, con cita, y sus decisiones desde el mensaje

_mcp · webhooks · portal_

- `mi_perfil` y `editar_mi_perfil`: por dónde le llega el briefing a cada persona (portal, correo, WhatsApp, Slack, Telegram, Teams), a qué hora, en qué zona e idioma, y qué temas quiere ver y evitar. `entrega` dice por dónde le llega HOY y, si no es su canal, por qué.
- El canal se vincula con prueba: con `vincular: true` la persona recibe un código de un solo uso y lo manda desde su WhatsApp, Slack o Telegram. Hasta entonces esa dirección no recibe nada ni firma nada, y una dirección que carga otra persona queda sin vincular.
- `asignar_copiloto` le da a una persona su agente —varias pueden compartir el mismo— y el briefing diario queda programado a su hora, en su zona. `programar_briefings` pone al día los de todos.
- El briefing sale de la corrida del copiloto con cada renglón comprobado: citado (un fragmento del cerebro que la corrida leyó, o una herramienta que ejecutó) o inferencia, mostrada aparte. Arriba va lo que espera a la persona, y abajo hasta tres decisiones con su recomendación, su porqué y su vencimiento.
- Contestar «1» (o «A2», o el texto de la opción) desde el canal vinculado elige y queda firmado a nombre de la persona. Lo irreversible, o con un monto arriba del tope del copiloto, se firma en el portal: por canal se contesta con el link.
- Webhooks `briefing.listo` y `briefing.borrador`: ids y el link, nunca el contenido. Un briefing sin verificar queda en borrador y no se le entrega a nadie.

## 2026-09-28 · Cruzar y comparar documentos: una tabla con la cita de cada campo

_mcp · portal_

- `configurar_extraccion`: una colección se convierte en una tabla de Datos. Un agente por documento —el Extractor de la biblioteca— lee ese documento y llena una fila, cada campo con la cita del fragmento de donde salió; lo que el documento no dice queda sin valor y con el porqué, nunca inventado. Plantillas `contratos` y `facturas`, o un esquema propio con la pregunta que contesta cada campo.
- Cada documento o versión nueva de la colección se extrae sola; cambiar las preguntas re-extrae todo y repetir con las mismas, nada. La respuesta dice cuántas tareas se crearon, en qué ambiente corren y el techo de plata. `extraer_pendientes` sigue con lo que quedó sin tarea (la cuota, el tope) y, si se pide, reintenta lo que falló.
- `consultar_registros` acepta `filtros` que comparan —`<`, `<=`, `>`, `>=` para números, montos y fechas, `=`, `!=`, `vacio` y `con_valor`—, así «¿cuáles vencen antes de marzo y no se renuevan solos?» es una consulta y no una relectura. Los registros que salieron de un documento traen `citas` y `no_pude`, también en `ver_registro`.
- `guardar_registro` de un agente acepta `citas` y `no_pude`: cada cita se comprueba contra lo que la corrida leyó, y la que no es de un fragmento que le llegó se rechaza con el porqué.
- `comparar_documentos`: dos documentos, o dos versiones del mismo, sección por sección —alineadas por número aunque uno escriba «SEGUNDA» y el otro «2»—, con lo que se sacó y lo que se puso y la cita a los dos lados. En el portal, desde la ficha del documento.
- Purgar un documento deja la fila de Datos con su valor y le saca la cita: queda anotado que el respaldo se purgó.

## 2026-09-28 · Buscar en el Cerebro entero

_mcp · portal_

- `buscar_en_cerebro`: busca en el texto de todos los documentos publicados —no sólo en el título— y devuelve los pasajes con su cita `[cerebro/…#n]`, la versión y la sección («Cláusula 7.2 · p. 3»), cuántos coincidieron en total y si la lista está recortada. Está en el MCP, en el Asistente del portal y arriba de la pantalla del Cerebro.
- En una corrida con documentos que no viajaron al directorio, el agente recibe `buscar_en_cerebro` y `leer_fragmentos`, y el índice le dice cuántos quedaron afuera. La cita a un pasaje que devolvió la búsqueda se verifica como la de un documento del directorio; la cita a otro pasaje del mismo documento, no.
- Con más documentos que lugares en el índice, los que viajan se eligen también por lo que dicen adentro, y la medición del Cerebro mide con esa misma selección: el veredicto `cuerpo` dice cuando alcanza gracias a buscar adentro, sin vectores.

## 2026-09-28 · Colecciones y carga por lote en el Cerebro

_api · mcp · portal · cli_

- Colecciones: un conjunto de documentos que se carga por lote y se trata como uno («Contratos de proveedores»). `crear_coleccion` y `listar_colecciones` por MCP, `GET` y `POST /api/v1/cerebro/colecciones` por la API, y en la pantalla del Cerebro.
- Plantillas de corte: `clausulas` parte un contrato donde empieza cada cláusula numerada —la cita dice «Cláusula 7.2 · p. 3»—, `filas` una planilla por grupos de filas con el encabezado adelante, `parrafos` lo de siempre.
- `cargar_documentos` y `POST /api/v1/cerebro/lote` (formulario multipart): hasta 20 archivos por pedido, cada uno con su resultado —`ingerida`, `duplicada` o `rechazada` con el motivo—; un rechazo no deja nada cargado. `yorobot cerebro subir <carpeta>` manda una carpeta entera de a llamadas que entran.
- Entra HTML. Los PDF se guardan con su hash y su original: antes quedaban con el del archivo vacío, y una versión nueva de un PDF «ya estaba».
- Techo de documentos por plan: Prueba 50, Piloto 1.000, los dedicados sin techo.

## 2026-09-27 · El MCP conectado a los proyectos

_mcp · api · webhooks_

- `tools/list` ofrece un núcleo chico: el resto del catálogo se encuentra con `buscar_herramientas` y se llama con `usar_herramienta`, o con `usar_herramienta_lectura` para lo que sólo lee.
- `conectar_base` conecta la base o la API del proyecto (Supabase, OpenAPI o un servidor MCP) en dos pasos, previsualizar y confirmar, y las llaves se pegan en el portal con un enlace. `probar_conexion` corre una lectura contra el sistema real.
- `aprobar` no aprueba: devuelve un enlace de un solo uso para que la persona decida en el portal con su sesión. `rechazar` rechaza con motivo.
- `preguntar_a_agente`: una pregunta a un agente y su respuesta en segundos, sin crear una tarea.
- Herramientas `local://<puerto>/<ruta>`: los agentes de prueba llegan al proyecto que corre en tu máquina por el puente local.
- Para un dashboard propio, con un token de lectura: `GET /api/v1/tickets`, `/agentes/{id}/metricas`, `/agentes/{id}/actividad`, `/conversaciones`, `/conversaciones/{id}` y `/aprobaciones`, y los webhooks `aprobacion.pendiente` y `conversacion.mensaje`.

## 2026-09-25 · Se retira la API de partners

_api_

- Se quitó el panel embebido, y con él las rutas `/api/v1/partner/*` (clientes, plantillas y sesiones): ya no existen.

## 2026-09-24 · Funciones propias

_mcp · portal_

- `crear_funcion` y `ver_funcion`: una herramienta cuyo cuerpo es JavaScript tuyo —recibe `entrada`, devuelve JSON— para la cuenta que el modelo no tiene que hacer a ojo. Corre en el worker, en un contenedor sin red ni credenciales, con 128 MB y 5 segundos: no llama a ningún sistema, así que es de lectura y no pide aprobación. El portal no la corre nunca.
- Un worker que no sabe correr funciones las recibe frenadas, con el motivo, hasta que se actualiza.

## 2026-09-24 · La tienda de ejemplo: un sandbox sin llaves

_portal · mcp · docs_

- Las organizaciones nuevas nacen con la tienda de ejemplo: dos conexiones contra un sistema de pedidos de mentira que sirve YoRobot (`/api/ejemplo/…`), un agente de plantilla que las usa y cuatro casos. Una consulta pedidos; la otra le «avisa» al cliente y espera aprobación. Nada le llega a nadie, y no se siembran tareas ni resultados.
- `instalar_ejemplo` (y «Ver uno de ejemplo» en Agentes) la instala en las organizaciones de antes.

## 2026-09-24 · Ensayar y publicar, en un botón

_portal · mcp_

- «Ensayar y publicar» en la evaluación del agente, y `ensayar_y_publicar` por MCP: corre la evaluación y, cuando se mide el último caso, si pasaron todos sube la versión hasta producción (o deja el pedido de firma donde hay cuatro ojos). Si falla, no sube nada y queda escrito qué caso y por qué; llega un correo cuando termina.
- `camino_a_produccion` trae `publicacion` en la evaluación que publica al terminar.

## 2026-09-24 · Links para que el cliente cargue su credencial

_portal · mcp_

- Conexiones → Credenciales → «Pedir por link» y `crear_link_de_credencial`: un link de un solo uso para que quien tiene la llave la pegue en `/conectar/…` en vez de mandarla por chat. Vence, se revoca, no pisa una credencial ya cargada salvo que se pida, y quien lo generó recibe un correo con los últimos cuatro.
- Registros (al lado de Hallazgos): la API, el MCP, los webhooks, las tareas y las herramientas en una sola lista, con rango de fechas, «sólo errores» y búsqueda por `X-Request-Id`.

## 2026-09-24 · Hallazgos: lo que se repite fallando, con su causa

_portal · mcp_

- `/dashboard/hallazgos` agrupa las fallas que vuelven —pedidos a la API y al MCP, herramientas que el sistema rechaza, casos que no pasan, discrepancias, webhooks que no entregan y llaves rechazadas— con cuántas veces pasó, la causa probable y dónde se arregla.
- La lectura `hallazgos` contesta «¿qué está fallando?» en el chat del portal y por MCP, con la misma fuente.
- El Inicio propone el paso siguiente con lo que ve: la falla grave que se repite y el agente que nunca corrió.

## 2026-09-24 · El plan, desde el MCP

_mcp · portal_

- `ver_plan`: el plan de la organización y lo que frena — agentes propios contra el techo, si llega a producción, quién ejecuta las tareas, el tope de modelo y los techos por ventana que trae.

## 2026-09-24 · Estado de la plataforma y este changelog

_docs · api_

- `/status` y `/api/status`: si la API contesta, si las tareas se ejecutan y si los avisos salen, con los incidentes de siete días.
- `/docs/changelog` (esta página) y `/docs/limites`, generada del catálogo de planes.

## 2026-09-24 · Registro de pedidos, cabeceras del freno y tokens reconocibles

_api · mcp · webhooks_

- Toda respuesta de `/api/v1` y `/api/mcp` trae `X-Request-Id`; los pedidos se guardan 30 días y se buscan en Accesos → Pedidos o con `listar_pedidos`.
- `X-RateLimit-Limit`, `X-RateLimit-Remaining` y `X-RateLimit-Reset` en cada respuesta de un token que autenticó; el `429` trae `Retry-After`.
- Los tokens nuevos empiezan con su clase: `yrb_api_`, `yrb_mcp_`, `yrb_wk_`. Los `est_` siguen andando. Si uno aparece en un repositorio público de GitHub, se revoca solo.
- Webhooks: `consumo.tope_100` (el tope del mes se llenó y la cola frenó) y `plan.cambiado`.

## 2026-09-24 · El plan es un techo

_api · mcp · portal_

- `fijar_cuota_mensual` y `fijar_cuota_por_ventana` bajan los límites del plan pero no los suben ni los sacan: eso lo hace un cambio de plan.
