@agent-native/core 0.92.12 → 0.94.0

package/docs/content/locales/es-ES/multi-tenancy.mdx

@@ -17,7 +17,7 @@ Ya se envía un andamio `npx @agent-native/core@latest create` nuevo con:
 - **Cambio de organización**: la sesión realiza un seguimiento de la organización activa (`session.orgId`) y al cambiarla se cambian los datos que ven el usuario y el agente.
 - **Aislamiento de datos por organización**: cada consulta se limita automáticamente a la organización activa.
 
-Si está evaluando un agente nativo para un CRM, un rastreador de proyectos, una bandeja de entrada de soporte o cualquier herramienta de equipo, la base multiinquilino ya está ahí. Todas las plantillas propias son multiinquilino; consulte [Cloneable SaaS templates](/docs/cloneable-saas) para ver la lista.
+Si está evaluando un agente nativo para un CRM, un rastreador de proyectos, una bandeja de entrada de soporte o cualquier herramienta de equipo, la base multiinquilino ya está ahí. Todas las plantillas propias son multiinquilino; consulte [Plantillas](/docs/cloneable-saas) para ver la lista.
 
 <Diagram id="doc-block-3yhq1v" title={"Membresía y aislamiento de la organización"} summary={"Los usuarios se unen a organizaciones como owner/admin/member. Cada fila poseíble lleva el org_id del inquilino propietario y ninguna fila cruza el límite."}>
 
@@ -117,8 +117,8 @@ Los datos del inquilino están aislados mediante una columna `org_id` (agregada
 
 Esta es la misma canalización utilizada para el alcance por usuario. Para conocer las mecánicas de nivel SQL, el contrato `ownableColumns()` y los guardias `accessFilter` / `resolveAccess` / `assertAccess`, consulte [Security → Data Scoping](/docs/security#data-scoping): la única fuente de verdad para el proceso de alcance.
 
-## Documentos relacionados {#related}
+## Qué sigue {#related}
 
-- [Authentication](/docs/authentication#organizations): sesiones, proveedores sociales y la superficie de gestión de la organización
-- [Security → Data Scoping](/docs/security#data-scoping): aislamiento de nivel SQL, contrato `ownableColumns()` y guardias de acceso
-- [Multi-App Workspace](/docs/multi-app-workspace): aloja múltiples aplicaciones nativas del agente en un monorepo con autenticación compartida y RBAC
+- [**Authentication**](/docs/authentication#organizations) — sesiones, proveedores sociales y la superficie de gestión de la organización
+- [**Security — Data Scoping**](/docs/security#data-scoping) — aislamiento de nivel SQL, contrato `ownableColumns()` y protecciones de acceso
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — aloja múltiples aplicaciones Agent-Native en un monorepo con autenticación compartida y RBAC

package/docs/content/locales/es-ES/notifications.mdx

@@ -113,6 +113,7 @@ La gravedad determina el estilo de la insignia en el menú desplegable y se tran
 | `inbox`   | Persiste en la tabla `notifications`; acciona la campana UI | Siempre activo: parte de la primitiva.                         |
 | `webhook` | POST JSON a un URL configurado                              | Var entorno `NOTIFICATIONS_WEBHOOK_URL` configurada al inicio. |
 
+El correo electrónico, Slack y el webhook siempre se registran junto con la bandeja de entrada. La entrega prefiere la URL o los destinatarios de los metadatos de la notificación y, a continuación, recurre a la variable de entorno correspondiente. Si no se configura ninguno, ese canal no hace nada durante la emisión.
 El canal de webhook resuelve las referencias de `${keys.NAME}` tanto en URL como en `NOTIFICATIONS_WEBHOOK_AUTH` contra el [secrets](/docs/security) ad-hoc del propietario, por lo que el valor sin procesar nunca ingresa al contexto del agente. Se aplican listas de permitidos URL por clave: la misma regla que utiliza la herramienta de automatizaciones `web-request`.
 
 <Diagram id="doc-block-cbsg3f" title="Canales y gravedad." summary={"la bandeja de entrada siempre está activada; el webhook necesita una var env; Los canales personalizados se registran al inicio. La gravedad impulsa el estilo de la insignia y se transmite a todos los canales."}>
@@ -203,7 +204,7 @@ Se requiere `meta.owner`: limita la notificación para que solo el usuario la ve
 
 Registra un canal personalizado desde cualquier complemento del servidor.
 
-```ts
+```ts filename="server/plugins/notifications-slack-ops.ts"
 import { registerNotificationChannel } from "@agent-native/core/notifications";
 
 registerNotificationChannel({
@@ -274,15 +275,15 @@ interface NotificationMeta {
 
 Montado en `/_agent-native/notifications/*` por el complemento core-routes. Todas las rutas tienen como alcance el correo electrónico de la sesión autenticada.
 
-| Método   | Ruta                                                |
-| -------- | --------------------------------------------------- |
-| `GET`    | `/_agent-native/notifications?unread=true&limit=50` |
-| `GET`    | `/_agent-native/notifications/count`                |
-| `POST`   | `/_agent-native/notifications/:id/read`             |
-| `POST`   | `/_agent-native/notifications/read-all`             |
-| `DELETE` | `/_agent-native/notifications/:id`                  |
+| Método   | Ruta                                                           |
+| -------- | -------------------------------------------------------------- |
+| `GET`    | `/_agent-native/notifications?unread=true&limit=50&before=ISO` |
+| `GET`    | `/_agent-native/notifications/count`                           |
+| `POST`   | `/_agent-native/notifications/:id/read`                        |
+| `POST`   | `/_agent-native/notifications/read-all`                        |
+| `DELETE` | `/_agent-native/notifications/:id`                             |
 
-<Endpoint id="doc-block-1wnwsyu" title="Lista de notificaciones" summary={"The route behind listNotifications() — scoped to the authenticated session's email."} method="GET" path={"/_agent-native/notifications?unread=true&limit=50"} summary="Listar notificaciones recientes para el usuario actual" auth={"Authenticated session; results are scoped to the session's email."} params={[
+<Endpoint id="doc-block-1wnwsyu" title="Lista de notificaciones" method="GET" path={"/_agent-native/notifications?unread=true&limit=50&before=ISO"} summary="Listar notificaciones recientes para el usuario actual" auth={"Authenticated session; results are scoped to the session's email."} params={[
   {
     "name": "unread",
     "in": "query",
@@ -296,6 +297,13 @@ Montado en `/_agent-native/notifications/*` por el complemento core-routes. Toda
     "type": "number",
     "required": false,
     "description": "Max rows to return."
+  },
+  {
+    "name": "before",
+    "in": "query",
+    "type": "string",
+    "required": false,
+    "description": "Cursor de marca de tiempo ISO: devuelve las notificaciones creadas antes de este momento para la paginación."
   }
 ]} responses={[
   {
@@ -308,7 +316,7 @@ Montado en `/_agent-native/notifications/*` por el complemento core-routes. Toda
 
 ## Componente UI {#ui}
 
-```tsx
+```tsx filename="app/components/HeaderBar.tsx"
 import { NotificationsBell } from "@agent-native/core/client/notifications";
 
 export function HeaderBar() {

package/docs/content/locales/es-ES/processors.mdx

@@ -51,8 +51,11 @@ Un `Processor` es un **observador/guarda** interno de bucle para la ejecución d
 
 </Diagram>
 
-> [!WARNING]
-> Un procesador es **configuración**, no una herramienta, no una acción y no una creación DSL. Los procesadores solo observan, mutan su propio estado de alcance de flujo y `abort()`. Nunca definen el comportamiento de la aplicación, reemplazan a actions ni aparecen en el modelo. Las operaciones de la aplicación pertenecen a [actions](/docs/actions).
+<Callout id="doc-block-proc1cfg" tone="warning">
+
+Un procesador es **configuración**, no una herramienta, no una acción y no una creación DSL. Los procesadores solo observan, mutan su propio estado de alcance de flujo y `abort()`. Nunca definen el comportamiento de la aplicación, reemplazan a actions ni aparecen en el modelo. Las operaciones de la aplicación pertenecen a [actions](/docs/actions).
+
+</Callout>
 
 ## Los ganchos {#hooks}
 
@@ -133,10 +136,13 @@ await runAgentLoop({
 
 **Gasto general cero cuando no se utiliza.** El bucle crea la cadena de procesadores solo cuando se suministra al menos un procesador; cuando `processors` se omite o está vacío, no se ejecuta ningún código de costura y el bucle no se modifica byte por byte. Los enlaces se ejecutan en orden de registro y pueden ser sincronizados o asíncronos.
 
-> [!NOTE]
-> La costura a nivel de bucle es el entregable hoy y los subagentes, A2A, MCP y las pruebas pueden llamarla directamente. Pasar `processors` a través del controlador de chat HTTP (para que un solucionador por solicitud pueda configurarlos sin llamar directamente a `runAgentLoop`) es una práctica práctica que aún no está cableada: configure los procesadores en el sitio de llamadas de `runAgentLoop` por ahora.
+<Callout id="doc-block-proc1note" tone="info">
+
+La costura a nivel de bucle es el entregable hoy y los subagentes, A2A, MCP y las pruebas pueden llamarla directamente. Pasar `processors` a través del controlador de chat HTTP (para que un solucionador por solicitud pueda configurarlos sin llamar directamente a `runAgentLoop`) es una práctica práctica que aún no está cableada: configure los procesadores en el sitio de llamadas de `runAgentLoop` por ahora.
+
+</Callout>
 
-## Relacionado
+## Qué sigue
 
 - [**Durable Resume**](/docs/durable-resume): cómo el bucle sobrevive a las interrupciones sin volver a ejecutar los efectos secundarios completados.
 - [**Custom Agents & Teams**](/docs/agent-teams): los subagentes ejecutan el mismo bucle y pueden llevar sus propios procesadores.

package/docs/content/locales/es-ES/server.mdx

@@ -96,8 +96,7 @@ server/routes/
 
 Cada ruta exporta un `defineEventHandler`:
 
-```ts
-// server/routes/api/health.get.ts
+```ts filename="server/routes/api/health.get.ts"
 import { defineEventHandler } from "h3";
 
 export default defineEventHandler(() => ({
@@ -137,8 +136,7 @@ Use la opción `http` de la action para dar forma al acceso HTTP directo: las ac
 
 Para un endpoint de estado de solo lectura, manténgalo como una action:
 
-```ts
-// actions/get-status.ts
+```ts filename="actions/get-status.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -171,8 +169,7 @@ qué pasó. Para transformaciones estrechas del lado del servidor que intenciona
 herramientas, historial de chat o estado de ejecución, use `completeText()` como escape explícito
 escotilla.
 
-```ts
-// actions/classify-message.ts
+```ts filename="actions/classify-message.ts"
 import { defineAction } from "@agent-native/core/action";
 import { completeText } from "@agent-native/core/server";
 import { z } from "zod";
@@ -237,8 +234,7 @@ Actions montado por el marco se ejecuta automáticamente con el contexto de soli
 
 Los complementos se encuentran en `server/plugins/` y se ejecutan al inicio. Úselos para migraciones, configuración de proveedores, trabajos recurrentes, adaptadores de integración y configuración de complementos de marco.
 
-```ts
-// server/plugins/db.ts
+```ts filename="server/plugins/db.ts"
 import { runMigrations } from "@agent-native/core/db";
 
 export default runMigrations(
@@ -416,8 +412,11 @@ El webhooks entrante debería verificarse, persistir y regresar rápidamente. El
 
 </Diagram>
 
-> [!WARNING]
-> No confíe en promesas no esperadas después de devolver una respuesta: los hosts sin servidor congelan la ejecución. Consulte [Messaging](/docs/messaging) para conocer la cola de integración canónica.
+<Callout tone="warning">
+  No confíe en promesas no esperadas después de devolver una respuesta: los
+  hosts sin servidor congelan la ejecución. Consulte
+  [Messaging](/docs/messaging) para conocer la cola de integración canónica.
+</Callout>
 
 ## Avanzado: trampillas de escape {#advanced-escape-hatches}
 
@@ -459,3 +458,11 @@ const handler = createProductionAgentHandler({
   systemPrompt: "You are the app agent...",
 });
 ```
+
+## Qué sigue
+
+- [**Actions**](/docs/actions) — la superficie de operaciones predeterminada; use una ruta personalizada solo cuando no encaje
+- [**Base de datos**](/docs/database) — el patrón `getDb()`/`schema` que importan tanto las rutas personalizadas como las acciones
+- [**Seguridad**](/docs/security#access-guards) — `accessFilter`/`assertAccess` y el modelo completo de ámbito de datos
+- [**Mensajería**](/docs/messaging) — el patrón canónico de cola de integración para webhooks entrantes
+- [**Protocolo MCP**](/docs/mcp-protocol) — el endpoint `/_agent-native/mcp` que este servidor monta automáticamente

package/docs/content/locales/es-ES/sharing.mdx

@@ -1,13 +1,13 @@
 ---
 title: "Compartir y privacidad"
-description: "Compartir al estilo Google Docs, integrado en el marco. Cada recurso creado por el usuario (documentos, paneles, diseños, presentaciones, clips, grabaciones, formularios) obtiene el mismo modelo privado de forma predeterminada con un recurso compartido constante UI."
+description: "Uso compartido familiar y coherente, integrado en el framework. Cada recurso creado por el usuario —documentos, paneles, diseños, presentaciones, clips, grabaciones y formularios— obtiene el mismo modelo privado de forma predeterminada con una interfaz de uso compartido coherente."
 ---
 
 # Compartir y privacidad
 
 Cada recurso que un usuario crea en una aplicación nativa del agente (un documento, un panel, un diseño, una presentación, una grabación de pantalla, una transcripción de una reunión, un formulario, un enlace de reserva) es **privado para el creador de forma predeterminada**. Otras personas solo lo ven cuando el creador lo comparte explícitamente o cambia su visibilidad a `org` o `public`.
 
-Se ve y funciona como Google Docs. El mismo botón para compartir, el mismo cuadro de diálogo, el mismo modelo de visibilidad de tres niveles, las mismas subvenciones por usuario/por organización, en todas las plantillas, sin reinvención por aplicación.
+Es un modelo de uso compartido familiar en todas partes: el mismo botón, el mismo cuadro de diálogo, el mismo modelo de visibilidad de tres niveles y las mismas concesiones por usuario y organización, en todas las plantillas y sin reinventarlo para cada aplicación.
 
 ## Por qué un modelo {#why}
 
@@ -92,7 +92,7 @@ Cada plantilla que almacena trabajos escritos por usuarios utiliza este modelo.
 - **Contenido** — documentos
 - **Diapositivas**: presentaciones
 - **Diseño**: diseños y recursos
-- **Clips**: grabaciones de pantalla (estilo Loom)
+- **Clips**: grabaciones de pantalla
 - **Plan** — visual plans and PR recaps
 - **Formularios**: definiciones de formulario
 - **Calendario**: enlaces a eventos y reservas
@@ -115,7 +115,7 @@ Cada recurso que se puede compartir tiene un botón para compartir en su encabez
 
 - Selector de visibilidad (`Private` / `Organization` / `Public link`).
 - Autocompletar "Agregar personas o equipos": busque usuarios en la organización o pegue un correo electrónico.
-- Una casilla de verificación `Notificar people` al estilo de Google Docs para concesiones de correo electrónico individuales.
+- Una casilla de verificación `Notificar a las personas` para concesiones individuales por correo electrónico.
 - Una lista de concesiones actuales con selectores de roles y un control de eliminación.
 - Un botón de copiar-enlace que respeta la visibilidad actual.
 
@@ -270,7 +270,7 @@ export const deckShares = createSharesTable("deck_shares");
 
 Una llamada de registro en `server/db/index.ts`:
 
-```ts
+```ts filename="server/db/index.ts"
 import { registerShareableResource } from "@agent-native/core/sharing";
 
 registerShareableResource({
@@ -315,9 +315,9 @@ For resources that execute code or carry elevated trust (like extensions), set `
 
 Compartir se basa en el modelo de alcance de datos más amplio del marco: el acceso de lista/lectura/escritura a tablas propias pasa por `accessFilter()` / `resolveAccess()` / `assertAccess()`, y los recursos etiquetados con `org_id` son invisibles en todas las organizaciones. Consulte [Security → Data Scoping](/docs/security#data-scoping) para conocer el proceso completo, la protección de CI y la superficie de amenazas.
 
-## Ver también {#see-also}
+## Qué sigue {#see-also}
 
-- [Security & Data Scoping](/docs/security): el filtro de acceso y el modelo de propiedad en el que se basa el uso compartido.
-- [Authentication](/docs/authentication): sesiones, organizaciones y cómo la identidad fluye en el contexto de la solicitud.
-- [Extensions](/docs/extensions#sharing): compartir en la superficie de la miniaplicación en espacio aislado.
-- [Creating Templates](/docs/creating-templates): conectar `ownableColumns` al esquema de una nueva plantilla.
+- [**Seguridad — Ámbito de datos**](/docs/security#data-scoping) — el modelo de filtro de acceso y propiedad en el que se basa el uso compartido
+- [**Autenticación**](/docs/authentication) — sesiones, organizaciones y cómo fluye la identidad al contexto de la solicitud
+- [**Extensiones**](/docs/extensions#sharing) — uso compartido en la superficie de miniaplicaciones aisladas
+- [**Creación de plantillas**](/docs/creating-templates) — conexión de `ownableColumns` al esquema de una plantilla nueva

package/docs/content/locales/es-ES/skills-guide.mdx

@@ -5,7 +5,7 @@ description: "Cómo funciona skills en el agente nativo: marco skills, dominio s
 
 # Guía Skills
 
-Skills son archivos Markdown que brindan al agente un conocimiento profundo sobre patrones y flujos de trabajo específicos.
+Skills son archivos Markdown que proporcionan al agente conocimientos profundos sobre patrones y flujos de trabajo específicos. En lugar de concentrar todas las reglas en un único prompt del sistema, el conocimiento se divide en archivos específicos que el agente carga solo cuando una tarea realmente los necesita. Así, el contexto predeterminado se mantiene reducido sin impedir que el agente profundice cuando sea necesario.
 
 ## ¿Qué son skills? {#what-are-skills}
 
@@ -120,9 +120,11 @@ El dominio skills sigue el mismo formato que el marco skills. Codifican patrones
 
 Las skills respaldadas por apps actuales incluyen `visual-plan`, `visual-recap` y `visualize-repo` de Plan, `visual-edit` de Design, `assets` de Assets y `content` para edición docs/blog/MDX respaldada por repositorio.
 
-skills, respaldado por una aplicación, empaqueta una aplicación nativa del agente como un artefacto del mercado de habilidades. El paquete puede incluir instrucciones del agente, skills exportado, metadatos del conector MCP, instrucciones de inicio alojadas/locales y superficies UI como aplicaciones MCP.
+<Callout tone="info">
 
-> **Detalles completos a continuación:** la mecánica de skills respaldado por aplicaciones (formato de manifiesto, comandos CLI, adaptadores de mercado, hash de actualización automática) se tratan en [App-backed skills — full details](#app-backed-skills-full).
+**Detalles completos a continuación:** la mecánica de skills respaldado por aplicaciones (formato de manifiesto, comandos CLI, adaptadores de mercado, hash de actualización automática) se tratan en [App-backed skills — full details](#app-backed-skills-full).
+
+</Callout>
 
 ## Creando skills personalizado {#creating-skills}
 
@@ -177,7 +179,11 @@ El sistema de herramientas del agente utiliza los frontmatter `name` y `descript
 
 Guarde el archivo en `.agents/skills/my-skill/SKILL.md`. El nombre del directorio debe coincidir con `name` en frontmatter.
 
-> **Ver también:** [Writing Agent Instructions](/docs/writing-agent-instructions) para saber cómo redactar descripciones de habilidades, aplicar la divulgación progresiva y mantener `AGENTS.md` eficiente. Ambas páginas utilizan la habilidad `project-imports` como ejemplo de ejecución.
+<Callout tone="info">
+
+**Ver también:** [Writing Agent Instructions](/docs/writing-agent-instructions) para saber cómo redactar descripciones de habilidades, aplicar la divulgación progresiva y mantener `AGENTS.md` eficiente. Ambas páginas utilizan la habilidad `project-imports` como ejemplo de ejecución.
+
+</Callout>
 
 ## Alcance de la habilidad: tiempo de ejecución frente a desarrollo {#skill-scope}
 
@@ -267,33 +273,37 @@ Esto reemplaza el antiguo truco de confiar en el código Claude que solo lee `.c
 
 </Diagram>
 
-> **Consulte también:** [Writing Agent Instructions](/docs/writing-agent-instructions) para saber cómo redactar descripciones de habilidades, aplicar la divulgación progresiva y mantener `AGENTS.md` optimizado.
-
 ## Skills frente a AGENTS.md {#skills-vs-agents-md}
 
-> **AGENTS.md**: descripción general. Enumera todos los scripts, describe el modelo de datos y explica la arquitectura de la aplicación. El agente lee esto primero para entender la aplicación.
->
-> **Skills**: inmersiones profundas. Cada habilidad se centra en un patrón con reglas detalladas, ejemplos de código y listas de lo que se debe/no se debe hacer. El agente los lee cuando necesita seguir un patrón específico.
+<Callout tone="info">
+
+**AGENTS.md**: descripción general. Enumera todos los scripts, describe el modelo de datos y explica la arquitectura de la aplicación. El agente lee esto primero para entender la aplicación.
+
+**Skills**: inmersiones profundas. Cada habilidad se centra en un patrón con reglas detalladas, ejemplos de código y listas de lo que se debe/no se debe hacer. El agente los lee cuando necesita seguir un patrón específico.
+
+</Callout>
 
 `AGENTS.md` le dice al agente _qué_ hace la aplicación. Skills le dice al agente _cómo_ hacer cosas específicas correctamente. Ambos son necesarios: `AGENTS.md` para orientación, skills para ejecución.
 
 ## Skills frente a memoria {#skills-vs-memory}
 
-> **Skills**: guías prácticas reutilizables y escritas. Se aplica a todos los usuarios y se invoca a pedido cuando la tarea coincide.
->
-> **Memoria (`LEARNINGS.md` / `memory/MEMORY.md`)**: aprendizajes compartidos del proyecto y memoria estructurada personal cargada en cada turno.
+<Callout tone="info">
+
+**Skills**: guías prácticas reutilizables y escritas. Se aplica a todos los usuarios y se invoca a pedido cuando la tarea coincide.
+
+**Memoria (`LEARNINGS.md` / `memory/MEMORY.md`)**: aprendizajes compartidos del proyecto y memoria estructurada personal cargada en cada turno.
+
+</Callout>
 
 Si el conocimiento se aplica a _todos_ los que trabajan en la aplicación ("siempre prefiera CTE a las subconsultas"), es una habilidad o `LEARNINGS.md` compartida. Si se trata de _este usuario en particular_ ("A Steve le gustan las respuestas concisas"), pertenece a `memory/MEMORY.md`. Consulte [Workspace Memory](/docs/workspace#memory) para conocer el tratamiento completo.
 
----
+## Skills frente a recursos SQL {#skills-vs-resources}
 
-# Avanzado
+Esta página presenta un skill como un archivo en `.agents/skills/<name>/SKILL.md`. [Workspace](/docs/workspace#skills) presenta el mismo skill como un recurso SQL en la ruta `skills/<slug>/SKILL.md`, con alcance de workspace, compartido o personal. Son el mismo concepto desde dos perspectivas: el modo Code lee y escribe el archivo directamente; el modo App lo almacena como una fila de recurso para que funcione sin un sistema de archivos. En ambos casos, crea el contenido con el formato de esta página.
 
 ## skills respaldado por la aplicación: detalles completos {#app-backed-skills-full}
 
-El paquete skills respaldado por una aplicación es una aplicación nativa del agente como un artefacto del mercado de habilidades.
-El paquete puede incluir instrucciones del agente, conector skills y MCP exportado
-metadatos, instrucciones de inicio alojadas/locales y superficies UI como aplicaciones MCP.
+El formato del manifiesto, los comandos CLI, los adaptadores de marketplace y el hash de actualización automática que sustentan los [skills respaldados por aplicaciones](#app-backed-skills), en detalle:
 
 Cada habilidad respaldada por la aplicación comienza con `agent-native.app-skill.json` en la raíz de la aplicación:
 
@@ -410,3 +420,10 @@ npx @agent-native/core@latest skills update scaffold --project
 `AGENTS.md` y `.agents/skills` siguen siendo canónicos. El comando de actualización también repara
 Enlaces de compatibilidad Claude (`CLAUDE.md` y `.claude/skills`) para que vea el código Claude
 las mismas instrucciones sin mantener una segunda copia.
+
+## Qué sigue {#whats-next}
+
+- [**Escribir instrucciones del agente**](/docs/writing-agent-instructions) — redactar descripciones de skills y distribuir la guía entre AGENTS.md, skills y memoria
+- [**Workspace**](/docs/workspace#skills) — dónde se almacenan los skills como recursos SQL en el modo App
+- [**Menciones de agentes**](/docs/agent-mentions) — el activador de comandos `/` que invoca un skill en el chat
+- [**Plugin y marketplace de Plan**](/docs/plan-plugin) — instalación y actualización automática integral de un skill real respaldado por una aplicación

package/docs/content/locales/es-ES/template-assets.mdx

@@ -92,6 +92,18 @@ Cuando abre la aplicación, la biblioteca seleccionada, el mensaje, las referenc
 - **Otras aplicaciones necesitan un selector o generador de recursos**: Presentaciones, Diseño, Contenido, un editor de blog o un creador de sitios pueden insertar el selector o llamar a Recursos a través de A2A.
 - **Quiere que los medios de marca estén disponibles a través de su agente de codificación**: Codex, Claude Code, Claude o ChatGPT pueden generar y seleccionar recursos sin salir del chat.
 
+## Qué puedes hacer con él
+
+- **Crea bibliotecas de recursos.** Agrupa imágenes de referencia, vídeos, logotipos canónicos, notas de estilo, paletas, carpetas y resultados generados por marca, campaña, producto o categoría.
+- **Generar a través del chat.** El compositor principal y los controles Generar de la biblioteca envían el mensaje al agente con `sendToAgentChat()`, para que los usuarios puedan inspeccionar variantes, dar comentarios e iterar.
+- **Generar imágenes y vídeos.** La generación de imágenes administrada por Builder está disponible cuando está habilitada, y Gemini potencia la generación de vídeos además del respaldo manual de imágenes.
+- **Cargue y describa referencias.** Agregue imágenes o videos de la biblioteca UI o solicite el botón adjunto del compositor, luego busque por título, descripción, texto alternativo, mensaje, modelo, tipo de medio, estado, función, carpeta o colección.
+- **Mantenga un registro de auditoría de generación.** Cada ejecución registra indicaciones, modelo, relación de aspecto, referencias, activo de origen, linaje, activos generados, estado, errores y marcas de tiempo para una revisión posterior del diseño.
+- **Preservar la precisión del logotipo.** El agente puede generar un área de marcador de posición y el servidor compone el logotipo canónico cargado en la imagen final en lugar de depender del modelo de imagen para volver a dibujarlo.
+- **Insertar como selector.** Otras aplicaciones pueden encuadrar `/picker` y escuchar el evento `chooseAsset` desde `@agent-native/embedding`, lo que convierte a Assets en un selector/generador de recursos para editores de blogs, creadores de sitios, presentaciones de diapositivas y aplicaciones personalizadas. El selector también emite el alias heredado `chooseImage` para hosts existentes de solo imágenes.
+- **Instalar como una habilidad respaldada por una aplicación.** El manifiesto `agent-native.app-skill.json` exporta una habilidad de Activos más metadatos del conector MCP para que los mercados puedan instalar la aplicación, sus instrucciones y su selector juntos.
+- **Servir a otros agentes.** Diapositivas, Diseño, Contenido, Correo y Envío pueden llamar a Recursos a través de A2A para enumerar bibliotecas, generar lotes, crear videos, refinar un recurso, recuperar exportaciones y generar vistas previas en línea donde se permite la incrustación.
+
 ## Cómo empezar
 
 Demostración en vivo: [assets.agent-native.com](https://assets.agent-native.com).
@@ -114,18 +126,6 @@ Demostración en vivo: [assets.agent-native.com](https://assets.agent-native.com
 - "Convierta este diagrama subido en una imagen explicativa del producto más limpia."
 - "Crea un guión gráfico de vídeo y guarda el mejor conjunto de fotogramas en esta biblioteca."
 
-## Qué puedes hacer con él
-
-- **Crea bibliotecas de recursos.** Agrupa imágenes de referencia, vídeos, logotipos canónicos, notas de estilo, paletas, carpetas y resultados generados por marca, campaña, producto o categoría.
-- **Generar a través del chat.** El compositor principal y los controles Generar de la biblioteca envían el mensaje al agente con `sendToAgentChat()`, para que los usuarios puedan inspeccionar variantes, dar comentarios e iterar.
-- **Generar imágenes y vídeos.** La generación de imágenes administrada por Builder está disponible cuando está habilitada, y Gemini potencia la generación de vídeos además del respaldo manual de imágenes.
-- **Cargue y describa referencias.** Agregue imágenes o videos de la biblioteca UI o solicite el botón adjunto del compositor, luego busque por título, descripción, texto alternativo, mensaje, modelo, tipo de medio, estado, función, carpeta o colección.
-- **Mantenga un registro de auditoría de generación.** Cada ejecución registra indicaciones, modelo, relación de aspecto, referencias, activo de origen, linaje, activos generados, estado, errores y marcas de tiempo para una revisión posterior del diseño.
-- **Preservar la precisión del logotipo.** El agente puede generar un área de marcador de posición y el servidor compone el logotipo canónico cargado en la imagen final en lugar de depender del modelo de imagen para volver a dibujarlo.
-- **Insertar como selector.** Otras aplicaciones pueden encuadrar `/picker` y escuchar el evento `chooseAsset` desde `@agent-native/embedding`, lo que convierte a Assets en un selector/generador de recursos para editores de blogs, creadores de sitios, presentaciones de diapositivas y aplicaciones personalizadas. El selector también emite el alias heredado `chooseImage` para hosts existentes de solo imágenes.
-- **Instalar como una habilidad respaldada por una aplicación.** El manifiesto `agent-native.app-skill.json` exporta una habilidad de Activos más metadatos del conector MCP para que los mercados puedan instalar la aplicación, sus instrucciones y su selector juntos.
-- **Servir a otros agentes.** Diapositivas, Diseño, Contenido, Correo y Envío pueden llamar a Recursos a través de A2A para enumerar bibliotecas, generar lotes, crear videos, refinar un recurso, recuperar exportaciones y generar vistas previas en línea donde se permite la incrustación.
-
 ## Usándolo desde su agente de codificación
 
 Genere y seleccione medios de marca sin salir de Codex, Claude Code, Claude o ChatGPT.
@@ -168,10 +168,13 @@ Genere y seleccione medios de marca sin salir de Codex, Claude Code, Claude o Ch
 
 El resto de este documento es para cualquiera que bifurque la plantilla de Activos o la amplíe.
 
-### Andamios
+### Inicio rápido
 
 ```bash
 npx @agent-native/core@latest create my-assets --standalone --template assets
+cd my-assets
+pnpm install
+pnpm dev
 ```
 
 ### Modelo de datos

package/docs/content/locales/es-ES/template-brain.mdx

@@ -205,7 +205,7 @@ Postgres, Neon, D1, Turso y hosts similares. El estado de la aplicación refleja
 ruta actual, filtros e ID seleccionados para que el agente siempre conozca la ruta actual
 navegación y selección.
 
-El esquema del cerebro vive en `templates/brain/server/db/schema.ts`. Ocho mesas:
+El esquema del cerebro vive en `templates/brain/server/db/schema.ts`. Nueve tablas:
 
 | Tabla                    | Qué contiene                                                                                                                                                             |
 | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
@@ -553,3 +553,5 @@ Pídale al agente que realice cambios por usted; puede editar su propia fuente.
 - [**Dispatch template**](/docs/template-dispatch): la aplicación de coordinación de andamios
 - [**Workspace**](/docs/workspace): recursos compartidos entre aplicaciones
 - [**A2A Protocol**](/docs/a2a-protocol): delegación entre aplicaciones
+- [**Plantillas**](/docs/cloneable-saas) — el modelo de clonar y poseer, y todas las demás plantillas de dominio desde las que empezar
+- [**Primeros pasos**](/docs/getting-started) — los fundamentos del framework: actions, estado de la aplicación y sincronización en vivo

package/docs/content/locales/es-ES/template-clips.mdx

@@ -17,7 +17,7 @@ Una aplicación que lo captura todo: grabaciones de pantalla, notas de reuniones
   />
 </WireframeBlock>
 
-Piense en la línea de Loom + Granola + Wispr Flow en una sola aplicación, pero el agente es un editor de primera clase en todas las superficies, y las grabaciones, reuniones y dictados son suyos, no de un proveedor de SaaS. Clips también hace que las grabaciones compartidas sean legibles para el agente: pegue un enlace normal para compartir de Clips en un agente y este podrá "escuchar" la transcripción como texto y "ver" marcos de pantalla con marca de tiempo como imágenes; no se necesita video sin formato. La visualización de cuadros funciona en cualquier agente con capacidad de imagen (ChatGPT, Código Claude, Cursor, Codex); Los chats web de solo texto aún obtienen la transcripción completa y pueden tomar un fotograma que usted cargue.
+Grabaciones de pantalla asíncronas, notas de reuniones sincronizadas con el calendario y dictado por pulsación para hablar, todo en una sola aplicación: el agente es un editor de primera clase en cada superficie y las grabaciones, reuniones y dictados son suyos, no de un proveedor de SaaS. Clips también hace que las grabaciones compartidas sean legibles para los agentes: pegue un enlace público de Clips o un enlace temporal **Copiar para el agente** en un agente y podrá «oír» la transcripción como texto y «ver» como imágenes los fotogramas de pantalla con marca de tiempo, sin necesidad del vídeo original. La visualización de fotogramas funciona en cualquier agente con capacidad de imagen (ChatGPT, Claude Code, Cursor, Codex); los chats web de solo texto siguen recibiendo la transcripción completa y pueden usar un fotograma que usted cargue.
 
 <Diagram id="doc-block-cw43i6" title="Capturar, transcribir, reutilizar" summary={"Tres tipos de captura aterrizan en una biblioteca; el agente transcribe, titula y resume, luego cada transcripción se puede buscar y compartir."}>
 
@@ -77,12 +77,13 @@ Piense en la línea de Loom + Granola + Wispr Flow en una sola aplicación, pero
 ## Qué puedes hacer con él
 
 - **Graba tu pantalla** con una grabadora integrada, superposición de cámara web, captura de audio y pausa/recorte.
+- **Importa vídeos públicos de Loom.** En la web, selecciona **Grabar → Importar Loom** y pega una URL para compartir o incrustar de Loom. Clips guarda una copia en tu biblioteca e importa la transcripción pública cuando está disponible.
 - **Capture reuniones de su calendario.** Conecte Google Calendar, vea las próximas reuniones en la barra lateral y presione grabar en cualquiera. Obtienes una transcripción en vivo más un resumen de IA, notas con viñetas y elementos de acción en el momento en que finaliza.
 - **Dictado pulsar para hablar.** Mantenga presionada la tecla Fn en su máquina, hable y el texto limpio aparecerá en cualquier aplicación que esté usando. Cada dictado se mantiene en un historial con capacidad de búsqueda con originales y versiones limpiadas por IA, una al lado de la otra.
 - **Obtenga un título, un resumen y marcadores de capítulo generados automáticamente** para cada grabación: el agente los completa y los mantiene actualizados.
 - **Busca en todas las transcripciones**: grabaciones de pantalla, reuniones y dictados, todo en una sola biblioteca. "Busque el clip donde analizamos el plan de implementación".
 - **Compartir clips** con permisos por clip (público, de equipo, privado). El seguimiento de enlaces y los comentarios encadenados también funcionan.
-- **Vista previa de clips públicos en Slack** con un despliegue reproducible estilo Loom después del
+- **Vista previa de clips públicos en Slack** con un despliegue de vídeo reproducible después de que el
   workspace instala tu aplicación Clips Slack.
 - **Capture registros del navegador con la extensión de Chrome.** Las grabaciones del navegador pueden
   adjunte registros de consola redactados y obtenga metadatos/XHR, lo cual es útil para
@@ -507,7 +508,7 @@ Las rutas en UI se encuentran en `templates/clips/app/routes/`: la aplicación a
 
 ### Clave actions
 
-Cada operación invocable por el agente es un archivo TypeScript en `templates/clips/actions/`, montado automáticamente en `POST /_agent-native/actions/:name` y ejecutable desde CLI como `pnpm action <name>`. Hay ~80 actions; las agrupaciones útiles:
+Cada operación invocable por el agente es un archivo TypeScript en `templates/clips/actions/`, montado automáticamente en `POST /_agent-native/actions/:name` y ejecutable desde CLI como `pnpm action <name>`. Hay unas 100 acciones; las agrupaciones útiles:
 
 - **Ciclo de vida de grabación**: `create-recording`, `finalize-recording`, `update-recording`, `set-thumbnail`, `archive-recording` / `restore-recording` / `trash-recording` / `delete-recording-permanent`, `move-recording`, `tag-recording`.
 - **Transcripción e IA** — `request-transcript`, `cleanup-transcript`, `regenerate-title` / `regenerate-summary` / `regenerate-chapters`, `set-chapters`, `generate-workflow`. (`cleanup-transcript` y `finalize-meeting` son llamadas de canalización de medios del lado del servidor; la mayoría de las otras funciones de IA se delegan en el chat del agente).

package/docs/content/locales/es-ES/template-design.mdx

@@ -11,7 +11,7 @@ Design es un estudio de creación de prototipos HTML nativo del agente. En lugar
   <Screen
     surface="desktop"
     html={
-      "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Página de lanzamiento del producto</h1><span class='wf-pill accent'>Desktop</span><span class='wf-pill'>Tablet</span><span class='wf-pill'>Mobile</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Export code</button></div><div class='wf-card' style='flex:1;display:grid;grid-template-rows:auto 1fr auto;gap:12px'><div style='display:flex;gap:8px'><span class='wf-pill accent'>Hero</span><span class='wf-pill'>Pricing</span><span class='wf-pill'>FAQ</span></div><div class='wf-box' style='display:flex;align-items:center;justify-content:center;min-height:230px'><strong>Prototipo HTML generado</strong></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span class='wf-muted'>Haz el hero más denso y el CTA más claro.</span><div style='flex:1'></div><button class='primary'>Aplicar revisión</button></div></div></div>"
+      "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Página de lanzamiento del producto</h1><span class='wf-pill accent'>Desktop</span><span class='wf-pill'>Tablet</span><span class='wf-pill'>Mobile</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Export code</button></div><div class='wf-card' style='flex:1;display:grid;grid-template-rows:auto 1fr auto;gap:12px'><div style='display:flex;gap:8px'><span class='wf-pill accent'>Hero</span><span class='wf-pill'>Pricing</span><span class='wf-pill'>FAQ</span></div><div class='wf-box' style='display:flex;flex-direction:column;gap:12px;min-height:230px;padding:20px'><div style='display:flex;flex-direction:column;align-items:center;gap:8px;text-align:center'><strong style='font-size:22px'>Lanza más rápido con Agent-Native</strong><span class='wf-muted' style='max-width:70%'>Genera un prototipo funcional a partir de un prompt y después refínalo en el mismo lugar.</span><button class='primary'>Empezar</button></div><div style='display:grid;grid-template-columns:repeat(3,1fr);gap:10px;flex:1'><div class='wf-card' style='min-height:56px'></div><div class='wf-card' style='min-height:56px'></div><div class='wf-card' style='min-height:56px'></div></div></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span class='wf-muted'>Haz el hero más denso y el CTA más claro.</span><div style='flex:1'></div><button class='primary'>Aplicar revisión</button></div></div></div>"
     }
   />
 </WireframeBlock>
@@ -89,6 +89,7 @@ Cuando abre la aplicación, el prototipo generado es el centro del espacio de tr
 ## Qué puedes hacer con él
 
 - **Genere prototipos completos.** Describa la pantalla o página que necesita y el agente creará un documento funcional HTML con estilo Tailwind y Alpine interactions.
+- **Empieza con plantillas reutilizables.** Elige un formato con dimensiones para anuncios, documentos de una página o páginas de destino, o guarda cualquier diseño integrado como plantilla. La indicación ajusta el contenido desbloqueado y conserva logotipos y fondos bloqueados.
 - **Compara variantes.** Comience con varias direcciones, elija la más fuerte y luego continúe perfeccionando.
 - **Ajuste visualmente.** Utilice los controles de ajuste integrados para realizar cambios comunes o solicite al agente actualizaciones de copia, diseño, color, espaciado e interacción.
 - **Aplica sistemas de diseño.** Guarda y reutiliza las preferencias del sistema de diseño para que el trabajo generado esté más cerca de tu marca.
@@ -133,6 +134,8 @@ pnpm dev
 
 Todos los datos residen en SQL a través de Drizzle ORM. Esquema: `templates/design/server/db/schema.ts`. Los diseños y los sistemas de diseño llevan el estándar `ownableColumns` y una tabla de recursos compartidos de marco correspondiente, por lo que encajan en el modelo de uso compartido por usuario/por organización.
 
+La tabla siguiente cubre los recursos propios principales: diseños, archivos, plantillas, versiones y sistemas de diseño. Otras siete tablas del mismo esquema respaldan funciones descritas en otras partes de este documento, en lugar del modelo de recursos principal: `design_localhost_connections` y `design_localhost_write_grants` (modo de origen localhost), `component_index` (indexación de componentes), `motion_timeline` (movimiento), `design_state` (instantáneas del estado del editor), `design_fusion_edits` (modo de fusión de aplicaciones completas) y `design_review_snapshot` (instantáneas de revisión).
+
 | Tabla                                    | Qué contiene                                                                                                                                       |
 | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `designs`                                | Un proyecto de diseño: `title`, `description`, `project_type` (`prototype` / `other`), el blob `data` JSON y un enlace `design_system_id` opcional |

package/docs/content/locales/es-ES/template-dispatch.mdx

@@ -5,7 +5,11 @@ description: "El envío es el plano de control del espacio de trabajo: bandeja d
 
 # Envío
 
-> **Consulte también:** para obtener una descripción general conceptual de lo que hace Dispatch y cuándo lo desea, consulte [Dispatch](/docs/dispatch). Esta página es la referencia específica de la plantilla.
+<Callout tone="info">
+
+**Consulte también:** para obtener una descripción general conceptual de lo que hace Dispatch y cuándo lo desea, consulte [Dispatch](/docs/dispatch). Esta página es la referencia específica de la plantilla.
+
+</Callout>
 
 El envío es el **plano de control del espacio de trabajo**. Mientras que otras plantillas son aplicaciones de dominio (Mail, Calendar, Analytics, Brain), Dispatch es la aplicación que ejecuta _junto_ con ellas para coordinar todo: una bandeja de entrada central, una bóveda de secretos, trabajos programados, integración Slack/Telegram y un agente orquestador que delega el trabajo del dominio a la aplicación especializada adecuada a través de [A2A](/docs/a2a-protocol).
 

package/docs/content/locales/es-ES/template-mail.mdx

@@ -362,3 +362,11 @@ El correo es tuyo para cambiarlo. Todo lo importante se encuentra en unos cuanto
 **Cambio de métodos abreviados de teclado.** Los controladores de combinaciones de teclas se encuentran en `templates/mail/app/components/email/`: busque `useHotkeys` o `addEventListener("keydown"` para encontrar dónde está cableada cada tecla.
 
 Pídale al agente que realice cualquiera de estos cambios por usted. El agente puede editar su propia fuente; consulte [Self-Modifying Code](/docs/key-concepts#agent-modifies-code).
+
+## Qué sigue
+
+- [**Plantillas**](/docs/cloneable-saas) — el modelo de clonar y poseer, y cualquier otra plantilla de dominio desde la que empezar
+- [**Primeros pasos**](/docs/getting-started) — los fundamentos del marco: acciones, estado de la aplicación y sincronización en directo
+- [**Calendario**](/docs/template-calendar) — una plantilla de dominio relacionada que cubre programación y reservas
+- [**Automatizaciones**](/docs/automations) — el motor basado en eventos sobre el que se construyen las reglas de clasificación automática de Mail
+- [**Acciones**](/docs/actions) — el sistema de acciones que invocan el chat, los atajos y las automatizaciones

package/docs/content/locales/es-ES/tracking.mdx

@@ -127,6 +127,8 @@ import { defineAction } from "@agent-native/core/action";
 import { track } from "@agent-native/core/tracking";
 import { z } from "zod";
 
+import { getDb, schema } from "../server/db/index.js";
+
 export default defineAction({
   description: "Create a new project.",
   schema: z.object({
@@ -134,14 +136,15 @@ export default defineAction({
     template: z.string().optional(),
   }),
   run: async ({ name, template }, ctx) => {
-    const project = await db
-      .insert(projects)
+    const db = getDb();
+    const [project] = await db
+      .insert(schema.projects)
       .values({ name, template })
       .returning();
 
-    track("project.created", { name, template }, { userId: ctx.userEmail });
+    track("project.created", { name, template }, { userId: ctx?.userEmail });
 
-    return { ok: true, projectId: project[0].id };
+    return { ok: true, projectId: project.id };
   },
 });
 ```
@@ -349,5 +352,5 @@ El marco también rastrea `builder connect clicked` desde los CTA de Connect Bui
 ## ¿Qué sigue?
 
 - [**Actions**](/docs/actions): donde se originan la mayoría de las llamadas de seguimiento
-- [**Server Plugins**](/docs/server) — `registerBuiltinProviders()` se ejecuta en el complemento core-routes al inicio
-- [**Secrets**](/docs/security): administra claves API para proveedores de seguimiento
+- [**Server Plugins**](/docs/server#server-plugins) — `registerBuiltinProviders()` se ejecuta en el complemento core-routes al inicio
+- [**Seguridad — Gestión de secretos**](/docs/security#secrets): administra claves API para proveedores de seguimiento

package/docs/content/locales/es-ES/using-your-agent.mdx

@@ -92,21 +92,14 @@ La mayoría de las veces diriges al agente escribiendo en el chat. Hay dos cosas
 
 El agente no es una aplicación independiente a la que puedes acceder. Se envía como un puñado de componentes React (una barra lateral, un panel sin formato y una llamada `sendToAgentChat()`) que se pueden colocar en cualquier aplicación. Renderice `<AgentSidebar>` para darle a cada pantalla un agente alternable, o conecte un botón para transferir una tarea específica al chat en lugar de ejecutar una llamada única a LLM.
 
-→ [**Drop-in Agent**](/docs/drop-in-agent): monta `<AgentPanel>`, `<AgentSidebar>` y `sendToAgentChat()` en cualquier aplicación React.
-→ [**Agent Surfaces**](/docs/agent-surfaces): elija si el flujo de trabajo debe ser headless, chat primero, integrado o una aplicación completa.
-
 ## Puedes ir a UI ligera {#ui-light}
 
 No todas las aplicaciones necesitan un panel completo. Cuando el agente _es_ el producto, puede omitir la mayor parte del UI personalizado: abra la aplicación, solicite lo que desee y deje que el agente haga el resto. El agente todavía tiene su superficie de administración (historial, espacio de trabajo, configuración), pero la interacción principal es la conversación en lugar de los clics.
 
-→ [**Automation-First Apps**](/docs/pure-agent-apps): apps sin navegador para jobs, colas, scripts y agents externos.
-
 ## Coeditas con él {#you-co-edit}
 
 Cuando usted y el agente trabajan en el mismo documento, no se turnan. Con la colaboración en tiempo real, las ediciones del agente se transmiten junto con las suyas (cursores en vivo, sin sobrescrituras) de la misma manera que lo haría un compañero de equipo. Puedes seguir escribiendo mientras funciona y ve los cambios a medida que ocurren.
 
-→ [**Real-Time Collaboration**](/docs/real-time-collaboration): edición colaborativa multiusuario con cursores en vivo y ediciones de agentes en el mismo documento.
-
 ## ¿Qué sigue? {#whats-next}
 
 - [**Context Awareness**](/docs/context-awareness): el agente sabe lo que estás mirando

package/docs/content/locales/es-ES/voice-input.mdx

@@ -9,6 +9,12 @@ Cada aplicación nativa del agente tiene un micrófono en el compositor de chat.
 
 El marco maneja todo esto automáticamente. Los usuarios conectados a Builder obtienen Gemini Flash-Lite alojado en Builder de forma predeterminada; de lo contrario, los usuarios pueden traer su propia clave de proveedor o recurrir al reconocimiento de voz del navegador.
 
+## Modo de voz en tiempo real {#realtime-speech-mode}
+
+Al abrir el micrófono, un menú emergente permite elegir entre **Conversación en tiempo real** y **Dictado editable**. El modo en tiempo real requiere una `OPENAI_API_KEY` de ámbito de usuario y conecta el navegador con `gpt-realtime-2.1` mediante WebRTC. El chat se contrae en un orbe de voz situado abajo a la derecha; al pulsarlo puedes mostrar u ocultar el chat sin finalizar la conversación.
+
+El modelo de voz utiliza las mismas herramientas autenticadas de Agent Native que el chat, por lo que puede navegar por la aplicación y ejecutar acciones mientras habla. Las acciones que requieren aprobación permanecen en pausa hasta que las apruebes. El audio nunca se almacena en SQL; Agent Native conserva únicamente un estado compacto de la sesión y la transcripción. Las sesiones en tiempo real duran como máximo 60 minutos.
+
 ## Cómo funciona {#how-it-works}
 
 El botón de voz del compositor graba audio en el navegador y luego elige un proveedor: