feat(browser): auto-commit con 3 cambios

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

python/functions/browser/whatsapp_send_image.md

@@ -6,9 +6,9 @@ domain: browser
 version: "1.0.0"
 purity: impure
 signature: "def whatsapp_send_image(name: str, image_path: str, *, caption: str = '', port: int = 9222, target_url_substr: str = 'whatsapp', open_first: bool = True) -> dict"
-description: "Envia una imagen (con caption opcional) a un chat de WhatsApp Web en una pestana ya logueada del navegador diario via CDP, sin abrir ventana nueva ni darle foco. Abre el chat por nombre exacto (whatsapp_open_chat) y verifica el destinatario (salvaguarda anti-envio-equivocado), hace click real en 'Adjuntar' para exponer el <input type=file> vivo, asigna la imagen con cdp_set_file_input (DOM.setFileInputFiles), espera el preview de la bandeja inline, teclea el caption opcional con teclado CDP real, y hace click en el boton enviar (icono wds-ic-send-filled) verificando que la bandeja se cerro. Accion con efecto: envia la imagen DE VERDAD, no reversible."
+description: "Envia una imagen (con caption opcional) a un chat de WhatsApp Web en una pestana ya logueada del navegador diario via CDP, sin abrir ventana nueva ni darle foco. Abre el chat por nombre exacto (whatsapp_open_chat) y verifica el destinatario (salvaguarda anti-envio-equivocado), hace click real en 'Adjuntar' para exponer el <input type=file> vivo, asigna la imagen con cdp_set_file_input (DOM.setFileInputFiles), espera la bandeja inline y hace click en el boton enviar (icono wds-ic-send-filled) verificando que la bandeja se cerro. Si hay caption, lo envia como mensaje de texto de seguimiento via whatsapp_send_message (en la WhatsApp Web compacta actual el caption embebido en la imagen no es automatizable de forma fiable, asi que viaja como segunda burbuja [imagen][caption]). Accion con efecto: envia la imagen DE VERDAD, no reversible."
 tags: [whatsapp, cdp, browser, automation, image, upload, python, navegator]
-uses_functions: [whatsapp_open_chat_py_browser, cdp_eval_py_browser, cdp_click_xy_py_browser, cdp_type_chars_py_browser, cdp_set_file_input_py_browser]
+uses_functions: [whatsapp_open_chat_py_browser, cdp_eval_py_browser, cdp_click_xy_py_browser, cdp_set_file_input_py_browser, whatsapp_send_message_py_browser]
 uses_types: []
 returns: []
 returns_optional: false
@@ -21,16 +21,16 @@ params_schema:
     - name: image_path
       desc: "Ruta de la imagen a enviar. Se expande (~) y se convierte a ruta ABSOLUTA; debe existir en disco o aborta con error sin abrir el chat."
     - name: caption
-      desc: "Texto opcional que acompana la imagen. Se teclea en el composer con teclado CDP real caracter a caracter; '' (default) envia la imagen sin caption."
+      desc: "Texto opcional descriptivo. Se envia como un MENSAJE DE TEXTO de seguimiento (segunda burbuja [imagen][caption]) via whatsapp_send_message; '' (default) envia solo la imagen. La WhatsApp Web compacta actual no permite automatizar el caption embebido en la imagen de forma fiable."
     - name: port
       desc: "Puerto de remote debugging de Chrome. Default 9222."
     - name: target_url_substr
       desc: "Substring que debe contener la URL del target (pestana). Default 'whatsapp'."
     - name: open_first
       desc: "Si True (default), abre el chat por su nombre antes de adjuntar. Si False, asume el chat ya abierto pero verifica el aria-label del composer contra name (aborta si no coincide)."
-  output: "dict {ok: bool (alias de sent), sent: bool, recipient: str, image: str (ruta absoluta), caption: str, error: str (motivo del fallo, vacio si sent=True)}. sent=True solo si la imagen se adjunto, el caption (si lo hay) se verifico y se pulso enviar dejando la bandeja vacia. Nunca lanza: los fallos se reportan en 'sent'/'ok' + 'error'."
+  output: "dict {ok: bool (imagen + caption enviados), sent: bool (imagen enviada), caption_sent: bool (caption de seguimiento enviado, False si no habia o fallo), recipient: str, image: str (ruta absoluta), caption: str, error: str (motivo del fallo, vacio si todo ok)}. sent=True solo si la imagen se adjunto y se envio dejando la bandeja vacia. Nunca lanza: los fallos se reportan en 'sent'/'ok' + 'error'."
 tested: true
-tests: ["test_golden_adjunta_caption_y_envia", "test_envia_sin_caption_no_teclea", "test_edge_imagen_no_existe_error_sin_abrir", "test_edge_open_fallido_error_sin_adjuntar", "test_seguridad_open_first_false_label_no_coincide_aborta", "test_error_set_file_input_falla_no_envia"]
+tests: ["test_golden_envia_imagen_y_caption_de_seguimiento", "test_envia_sin_caption_no_manda_texto", "test_edge_imagen_no_existe_error_sin_abrir", "test_edge_open_fallido_error_sin_adjuntar", "test_seguridad_open_first_false_label_no_coincide_aborta", "test_error_set_file_input_falla_no_envia"]
 test_file_path: "python/functions/browser/whatsapp_send_image_test.py"
 file_path: "python/functions/browser/whatsapp_send_image.py"
 ---
@@ -76,8 +76,15 @@ usa `whatsapp_send_message`; para leer/confirmar lo enviado, `whatsapp_read_chat
   vacia aunque la sesion siga logueada.
 - **El input vivo solo existe tras pulsar "Adjuntar".** Por eso la funcion hace el click real en
   el boton "Adjuntar" antes de `setFileInputFiles`; asignar al input persistente decoy no abre el
-  preview. La WhatsApp Web actual usa una **bandeja de medios INLINE** sobre el composer (no un
-  drawer a pantalla completa): el caption se escribe en el MISMO composer del footer.
+  preview. La WhatsApp Web actual usa una **bandeja de medios INLINE compacta** sobre el composer
+  (no un drawer a pantalla completa).
+- **El caption NO se embebe en la imagen: viaja como mensaje de texto de seguimiento.** En esta
+  WhatsApp Web compacta hay dos botones de envio cuando hay media: "Enviar N seleccionados" (envia
+  la bandeja, IGNORA el texto del composer) y "Enviar"/Enter (envia el texto como burbuja aparte,
+  descartando la media en cola). No hay un campo de caption por-imagen automatizable de forma
+  fiable. Por eso la funcion envia primero la imagen (boton de la bandeja) y, si hay `caption`, lo
+  manda despues como mensaje de texto via `whatsapp_send_message` (`open_first=False`): el resultado
+  es [imagen][caption] como dos burbujas. `caption_sent` indica si esa segunda burbuja salio.
 - **Selector de aria-label en espanol.** El preview se detecta por `[aria-label="Quitar archivo
   adjunto"]` y el boton de adjuntar por `[aria-label="Adjuntar"]`: dependen del idioma de la UI
   (espanol). En otro locale habria que ajustar los aria-labels.
@@ -87,8 +94,6 @@ usa `whatsapp_send_message`; para leer/confirmar lo enviado, `whatsapp_read_chat
   `sent=False` con "envio incierto".
 - **Salvaguarda anti-destinatario-equivocado**: con `open_first=True` abre y verifica el chat; con
   `open_first=False` lee el aria-label del composer y aborta si no contiene `name`.
-- **Caption verificado**: tras teclear, re-lee el `innerText` del composer y solo envia si coincide
-  EXACTAMENTE con `caption`; si no, devuelve `sent=False` sin enviar.
 - **Funciona con la ventana minimizada o sin foco**: CDP opera la pestana sin traerla a primer plano.
 - **Viola los ToS de WhatsApp**: automatizar la web tiene riesgo de ban del numero personal. Usar
   con cautela y bajo tu responsabilidad.