> ## Documentation Index
> Fetch the complete documentation index at: https://omniloy.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Historial de versiones y notas de lanzamiento del SDK de SofIA

Todos los cambios notables del SDK de SofIA se documentan en esta página. El formato sigue [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) y el proyecto adhiere a [Versionado Semántico](https://semver.org/). Los refactors internos que no afectan tu integración se resumen como "mejoras de estabilidad y rendimiento".

## v1.0.9 - 2026-07-16

### Añadido

* **Acciones clínicas (Extras)** — extrae las acciones que surgen de la consulta (peticiones, citas, pruebas, derivaciones) y entrégalas a tu HIS por categoría. Defines las categorías en la nueva prop `templateExtras` y recibes sus items en el callback `handleExtras`, tal como los produjo tu esquema (sin renombrar campos). Un botón por categoría, las dos primeras inline y el resto en un menú de tres puntos. Ver [Acciones clínicas (Extras)](/sofia/es/sdk/extras).
* Prop **`templateExtras`** (`object`, JSON Schema) — sus propiedades de primer nivel son las categorías.
* Callback **`handleExtras`** — recibe los items de la categoría pulsada, extraídos bajo demanda. Reutiliza el [modal de vista previa de inserción](/sofia/es/sdk/insertion-preview) para la curación (mismo flag `showInsertionPreview`, activado por `templateExtras`).

### Cambiado

* Rediseño de la barra de acciones del transcriptor: botón de grabación/parada dedicado, medidor de nivel de audio, y los botones de Generar y Extras separados en píldoras propias.

## v1.0.8 - 2026-07-09

### Añadido

* **Modal de vista previa de inserción** — revisa y cura un informe generado antes de que llegue a tu app. Opt-in por API key (desactivado por defecto). Ver vista previa de [inserción](/sofia/es/sdk/insertion-preview).
* Prop **`onReportApply`** — recibe el informe curado desde el modal de vista previa de inserción.
* Callback **`updateTemplate`** — alimenta los valores existentes de los campos de tu EMR a la generación para que la regeneración produzca una nota revisada en lugar de una copia idéntica. [Ver pre-rellenar desde tu EMR](/sofia/es/sdk/update-template).
* **Resolución automática de `baseurl`** — las claves más nuevas seleccionan el endpoint automáticamente, por lo que `baseurl` ahora es opcional para ellas.

## v1.0.7 - 2026-06-23

### Añadido

* Selector de entorno de audio en los ajustes de micrófono: una opción de cobertura mínima de VAD por usuario obtenida del backend y enviada como `vad_min_coverage` en el comando de grabación por WS

### Deprecado

* **`wssurl`** — deprecada e ignorada. La URL del WebSocket de transcripción ahora la proporciona la settings API; solo elimina la prop.

## v1.0.6 - 2026-06-11

### Añadido

* **Anonimización de datos del paciente** — la PII en `patientdata` se enmascara del lado del cliente antes de cada petición saliente y se restaura en la respuesta.

### Cambiado

* Límite de descripción personalizada por campo elevado de 1.000 a 3.000 caracteres.
* Mejoras de estabilidad y rendimiento.

## v1.0.5 - 2026-05-13

### Añadido

* **Borrador automático del informe** — se borronea un informe en segundo plano en cuanto termina la grabación.
* **Detección de cortes de audio** — los cortes se marcan inline en la transcripción, con una advertencia antes de generar o regenerar.

### Cambiado

* Mejoras de estabilidad y rendimiento en la grabación y la generación de notas.

## v1.0.4 - 2026-04-17

### Cambiado

* Mejoras de fiabilidad en la grabación de audio — recuperación del micrófono, monitoreo de conectividad y manejo más claro de "no hay micrófono disponible".

## v1.0.3 - 2026-04-14

### Añadido

* Soporte de idiomas extendido.

### Eliminado

* Propiedad **`showconsentindicator`**.

### Corregido

* Parches de seguridad para dependencias de terceros.

## v1.0.2 - 2026-03-19

### Añadido

* Soporte de idiomas extendido (checo, francés, sueco; separación de `en` en `en_GB` / `en_US`).
* Rediseño de la UI de configuración de templates — un campo de prompt general y toggles de activación/desactivación por campo.
* Arrastrar y soltar archivos y pegado desde el portapapeles en el chat.

### Cambios importantes

* Se agregó la propiedad `showconsentindicator`; el indicador de consentimiento está oculto por defecto (establécela en `true` para mostrarlo). *(Eliminada más tarde en 1.0.3.)*

***

## v1.0.0 — 2025

**Tipo de release:** Mayor

### Añadido

* Prop `template` reemplaza `toolsargs` para la configuración de esquemas de datos clínicos
* Prop `templateid` requerida junto con `template` para la generación de reportes
* Campo `isConfigurable` en las propiedades del template para controlar la personalización del usuario
* Modo `debug="true"` con logging estructurado en consola con prefijo `[Sofia SDK]`
* Modo solo-chat automático cuando se omiten `template`/`templateid`

### Cambiado

* El botón de generar ahora requiere **ambos** `template` y `templateid` para aparecer

### Deprecado

* `toolsargs` → usar `template` (será eliminado en v2.0)

### Eliminado

* `isonlychat` — el modo solo-chat ahora es automático
* `disablegenerate` — omitir `template`/`templateid` en su lugar
* `disableactions` — no montar el componente en su lugar
* `sofiatitle` — el título siempre es "SofIA"
* `isscreenloading` — no disponible en UI basada en Chat
* `transcriptorselectvalues` — sin efecto
* `renderReportContent` — renderizado personalizado no disponible en Chat UI
* `handleFill` — no disponible en Chat UI
* `toast` — sin efecto

### Migración

Consulta la [Guía de Migración](/sofia/es/sdk/migration) para instrucciones paso a paso.

***

## v0.0.x — 2024

Versiones pre-release iniciales. Destacados:

* **v0.0.10** — soporte de procesamiento de archivos; warnings de deprecación para props legacy; soporte de `isConfigurable` en campos del template.
* **v0.0.9** — autosummary configurable de la conversación.
* **v0.0.3** — primera versión pública: web component `<sofia-sdk>` con Shadow DOM, transcripción de audio en tiempo real, generación de informes, soporte de frameworks (Vanilla JS, React, Angular), inglés/español, callbacks `handleReport`/`setIsOpen`/`setGetLastReport`, `patientdata` y templates JSON Schema Draft-07.

Las versiones v0.0.4–v0.0.8 fueron mejoras internas de estabilidad y de ajustes sin cambios en la API visibles para el usuario.
