@agent-native/core 0.92.12 → 0.94.0

package/corpus/core/docs/content/locales/es-ES/external-agents.mdx

@@ -136,13 +136,9 @@ instantánea hasta que la actualices/revises nuevamente, así que vuelve a escan
 o de la aplicación MCP. Si todavía tienes conectores antiguos por aplicación
 habilitado junto con Dispatch, actualiza o vuelve a conectar cada conector obsoleto; actualizando
 Dispatch no reescribe el calendario/correo/etc. almacenados en caché de ChatGPT o Claude.
-instantáneas. Los alcances son:
-
-| Alcance     | Qué permite                                                            |
-| ----------- | ---------------------------------------------------------------------- |
-| `mcp:read`  | Herramientas de solo lectura y descubrimiento de herramientas/recursos |
-| `mcp:write` | Redacción, actualización y otras mutaciones actions                    |
-| `mcp:apps`  | Aplicaciones, gráficos, paneles, borradores y UI MCP en línea          |
+instantáneas. Los ámbitos `mcp:read` / `mcp:write` / `mcp:apps` son los mismos
+que se explican más abajo en
+[OAuth remoto estándar de MCP](#standard-oauth).
 
 Cursor, Goose, Postman, MCPJam y VS Code GitHub Copilot usan el mismo control remoto
 MCP URL a través de su propio servidor MCP UI cuando su compilación admite OAuth remoto

package/corpus/core/docs/content/locales/es-ES/key-concepts.mdx

@@ -11,11 +11,9 @@ Cómo funcionan internamente las aplicaciones nativas del agente: los principios
 
 Cada aplicación nativa del agente consta de tres cosas que funcionan juntas:
 
-> **Agente**: IA autónoma que lee y escribe datos, ejecuta actions y modifica código. Personalizable con skills e instrucciones.
->
-> **Aplicación**: la superficie del producto alrededor del agente. Esto puede ser solo acción al principio, chat enriquecido, un pequeño plano de control o un UI React completo con paneles, flujos y visualizaciones.
->
-> **Computadora**: base de datos, navegador, ejecución de código. Los agentes trabajan directamente con SQL y herramientas integradas; Los servidores MCP son complementos opcionales, no la base.
+- **Agente**: IA autónoma que lee y escribe datos, ejecuta actions y modifica código. Personalizable con skills e instrucciones.
+- **Aplicación**: la superficie del producto alrededor del agente. Esto puede ser solo acción al principio, chat enriquecido, un pequeño plano de control o un UI React completo con paneles, flujos y visualizaciones.
+- **Computadora**: base de datos, navegador, ejecución de código. Los agentes trabajan directamente con SQL y herramientas integradas; Los servidores MCP son complementos opcionales, no la base.
 
 <Diagram id="doc-block-b13lfv" title={"Agente, aplicación y computadora."} summary={"Tres capas trabajando juntas en una tienda SQL compartida. Tanto el agente como la aplicación leen y escriben los mismos datos."}>
 
@@ -278,8 +276,7 @@ sendToAgentChat({
 
 Cuando el agente necesita hacer algo complejo (llamar a un API, procesar datos, consultar la base de datos), ejecuta una **acción**. Actions son archivos TypeScript en `actions/` que exportan un `defineAction()` predeterminado:
 
-```ts
-// actions/fetch-data.ts
+```ts filename="actions/fetch-data.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -381,9 +378,8 @@ Un _frame_ es el entorno que aloja el agente junto a su aplicación; localmente,
 
 Las aplicaciones nativas del agente incluyen un panel de agente integrado que proporciona el agente de IA junto con la aplicación UI. Esto es lo que hace que la arquitectura funcione: el agente necesita una computadora (base de datos, navegador, ejecución de código) y la aplicación necesita al agente para que funcione la IA.
 
-> **Panel de agente integrado**: chat y terminal CLI opcional integrados en cada aplicación. Admite código Claude, Codex, Gemini, OpenCode y Builder.io. Se ejecuta localmente. Gratis y de código abierto.
->
-> **Nube**: implemente en cualquier nube con colaboración, edición visual, roles y permisos en tiempo real. Lo mejor para equipos.
+- **Panel de agente integrado**: chat y terminal CLI opcional integrados en cada aplicación. Admite código Claude, Codex, Gemini, OpenCode y Builder.io. Se ejecuta localmente. Gratis y de código abierto.
+- **Nube**: implemente en cualquier nube con colaboración, edición visual, roles y permisos en tiempo real. Lo mejor para equipos.
 
 ## Conciencia del contexto {#context-awareness}
 
@@ -455,14 +451,11 @@ Adoptar el marco es valioso principalmente por lo que deja de tener que construi
 
 Ese es el "y todo lo demás" que de otro modo estarías pegando tú mismo.
 
-## Inmersiones profundas {#deep-dives}
-
-Para obtener orientación detallada sobre patrones específicos:
+## Qué sigue {#deep-dives}
 
-- [What Is Agent-Native?](/docs/what-is-agent-native): la visión y la filosofía
-- [Context Awareness](/docs/context-awareness): estado de navegación, visualización de pantalla, comandos de navegación
-- [Skills Guide](/docs/skills-guide): marco skills, dominio skills, creación de skills personalizado
-- [Native Interfaz de chat](/docs/native-chat-ui): tablas de acciones declaradas, gráficos y postura en tiempo de ejecución de BYO
-- [Agent Surfaces](/docs/agent-surfaces): chat enriquecido y sin cabeza, sidecar integrado y rutas de aplicación completa
-- [A2A Protocol](/docs/a2a-protocol): comunicación de agente a agente
-- [Multi-App Workspace](/docs/multi-app-workspace): aloja muchas aplicaciones en un monorepo con autenticación compartida, skills, componentes y credenciales
+- [**What Is Agent-Native?**](/docs/what-is-agent-native) — la visión y la filosofía que sustentan estas reglas
+- [**Context Awareness**](/docs/context-awareness) — estado de navegación y comandos view-screen y navigate en detalle
+- [**Skills Guide**](/docs/skills-guide) — skills del framework, skills de dominio y creación de skills personalizadas
+- [**Native Chat UI**](/docs/native-chat-ui) — tablas y gráficos declarados por actions y compatibilidad con tiempos de ejecución propios
+- [**Agent Surfaces**](/docs/agent-surfaces) — chat, UI nativa integrada, páginas completas de aplicación, sidecar integrado, automatización y rutas de agentes externos
+- [**A2A Protocol**](/docs/a2a-protocol) — comunicación entre agentes

package/corpus/core/docs/content/locales/es-ES/messaging.mdx

@@ -1,11 +1,15 @@
 ---
 title: "Mensajería"
-description: "Hable con su agente desde Slack, correo electrónico, Telegram o WhatsApp: el mismo agente, la misma memoria, las mismas herramientas."
+description: "Hable con su agente desde Slack, Microsoft Teams, interacciones de Discord, correo electrónico, Telegram o WhatsApp."
 ---
 
 # Mensajería
 
-Conecta tu agente a Slack, correo electrónico, Telegram o WhatsApp para que puedas chatear con él desde las aplicaciones que ya usas. Es el mismo agente (la misma memoria, las mismas herramientas, los mismos subprocesos), pero al que se puede acceder desde más lugares.
+Conecta tu agente a Slack, Microsoft Teams, interacciones de Discord, correo electrónico, Telegram o WhatsApp. Es el mismo agente, con la misma memoria, herramientas e historial.
+
+> **Compatibilidad exacta:** Teams valida los JWT oficiales de Bot Framework y responde en la conversación de origen. Discord admite comandos de barra mediante interacciones HTTP con verificación Ed25519 y respuesta diferida; no recibe mensajes normales del servidor ni mensajes directos sin un runtime Gateway. Telegram conserva `message_thread_id` y WhatsApp usa el `wamid` entrante para respuestas contextuales.
+>
+> Teams requiere `MICROSOFT_TEAMS_APP_ID`, `MICROSOFT_TEAMS_APP_PASSWORD` y `MICROSOFT_TEAMS_ALLOWED_TENANT_IDS`. Discord requiere `DISCORD_APPLICATION_ID` y `DISCORD_PUBLIC_KEY`. Telegram requiere `TELEGRAM_WEBHOOK_SECRET`, y WhatsApp requiere `WHATSAPP_APP_SECRET`, además de sus credenciales existentes.
 
 > **¿Estás usando la plantilla de Despacho?** Todo esto está conectado para ti en **Configuración → Mensajería**. Haga clic para conectar cada plataforma; no necesita leer el resto de esta página a menos que esté personalizando o creando su propia plantilla. Ver [Dispatch](/docs/dispatch) o [Dispatch template reference](/docs/template-dispatch).
 
@@ -78,7 +82,6 @@ Conecta tu agente a Slack, correo electrónico, Telegram o WhatsApp para que pue
    - `chat:write`: permite al agente enviar mensajes
    - `app_mentions:read`: permite al agente ver cuándo se menciona @ (opcional)
    - `im:history`: permite al agente leer los mensajes directos que se le envían
-   - `assistant:write` — opcional; permite que Slack muestre el estado nativo "está pensando..." en los hilos del asistente
    - `users:read.email` — opcional; ayuda a plantillas como Mail a verificar el correo electrónico del remitente Slack para verificar la identidad de la cola de borradores
 3. Haga clic en **Instalar en el espacio de trabajo** en la parte superior de esa página. Slack le dará un **Token de usuario de bot OAuth** que comienza con `xoxb-`. Cópialo.
 4. Vaya a **Información básica** en la barra lateral y copie el **Secreto de firma**.
@@ -123,12 +126,83 @@ y `link_shared` al controlador de despliegue de clips.
 
 ### Consejos
 
-- **Menciones de canales**: el bot solo responde en los canales cuando se @-menciona, para evitar ruido.
-- **DM**: cada DM se trata como una conversación privada con el agente.
-- **Misma identidad, todos los canales**: si un usuario de Slack tiene el mismo correo electrónico que un usuario registrado en su aplicación, el agente lo trata como a la misma persona.
+- **Menciones de canales**: use una @mención para iniciar el trabajo. Las respuestas sin mención solo continúan mientras ese hilo exacto tenga trabajo activo.
+- **Mensajes directos**: los mensajes directos personales aceptados son conversaciones privadas y requieren un miembro verificado de la organización o una identidad de Slack vinculada.
+- **Identidad**: los mensajes directos pueden vincular un correo de Slack verificado al mismo usuario de la aplicación; los canales administrados usan su identidad de servicio y política.
 - **Listas permitidas de producción**: configure `SLACK_ALLOWED_TEAM_IDS` y, para aplicaciones Slack compartidas, `SLACK_ALLOWED_API_APP_IDS` para que un espacio de trabajo inesperado no pueda reutilizar un secreto de firma válido.
 - **La aplicación Clips se despliega**: los clips Agent-Native instalables para Slack utilizan `SLACK_CLIENT_ID`, `SLACK_CLIENT_SECRET`, `SLACK_SIGNING_SECRET` y `/api/slack/oauth/callback`. Cada espacio de trabajo Slack conectado obtiene su propio token de bot cifrado en `app_secrets`; `SLACK_BOT_TOKEN` es solo un respaldo heredado de un único espacio de trabajo.
 
+### Add to Slack administrado
+
+OAuth administrado es la configuración recomendada. En **Configuración →
+Mensajería**, seleccione **Agent manifest** para descargar el archivo específico
+del host `agent-native-slack-manifest.json` e impórtelo en **App Manifest** de
+Slack. El manifiesto activa la experiencia actual `agent_view` y una pestaña
+**Messages** editable para mensajes directos. Verifique estos alcances de bot:
+
+El icono de la aplicación no forma parte del manifiesto. En **Basic Information
+→ Display Information**, cargue el icono de Agent Native para que el selector de
+Agents coincida con la marca del producto. Puede usar el `icon-512.svg` público
+de la aplicación como origen y convertirlo a un formato de carga admitido por
+Slack si es necesario.
+
+```text
+assistant:write
+app_mentions:read
+   channels:history
+   channels:read
+   chat:write
+files:read
+   groups:history
+   groups:read
+   im:history
+im:read
+   mpim:history
+   mpim:read
+   pins:read
+   reactions:read
+users:read
+users:read.email
+```
+
+Configure OAuth Redirect URL como
+`https://your-app.example.com/_agent-native/integrations/slack/oauth/callback`,
+Event Subscriptions Request URL como
+`https://your-app.example.com/_agent-native/integrations/slack/webhook` e
+Interactivity Request URL como
+`https://your-app.example.com/_agent-native/integrations/slack/interactions`.
+Suscríbase a `app_home_opened`, `app_context_changed`, `app_mention`,
+`message.channels`, `message.groups`, `message.im` y `message.mpim`.
+Configure `SLACK_CLIENT_ID`, `SLACK_CLIENT_SECRET` y
+`SLACK_SIGNING_SECRET`; después, en **Configuración → Mensajería**, pulse
+**Add to Slack**. Cada instalación guarda su token cifrado y usa claves de
+conversación separadas por espacio, aplicación, canal e hilo.
+
+Reinstale la aplicación de Slack después de cambiar el manifiesto, los alcances,
+los eventos, Agent view o la pestaña Messages. `app_home_opened` detecta cuándo se
+abre el DM, `app_context_changed` aporta el contexto visible en Slack y
+`message.im` entrega los mensajes directos. Los administradores de Slack pueden
+ocultar los agentes instalados para toda la organización y cada usuario puede
+ocultarlos de su propia barra superior. Si la instalación funciona pero el agente
+no aparece, revise esos controles o ábralo desde **Tools → Apps**.
+
+Los mensajes directos personales de Slack solo se aceptan de un miembro
+verificado de la organización de Agent Native o de una identidad de Slack ya
+vinculada. Las políticas y los presupuestos del principal de servicio del canal
+son independientes.
+
+Las respuestas sin mención solo dirigen un hilo con una tarea activa; el resto
+de la conversación del canal no invoca al agente. Se carga un contexto acotado
+con reacciones y referencias de archivo, y una tarjeta nativa muestra el plan,
+el progreso, cancelar y aprobar/rechazar. Los mensajes directos usan la identidad
+personal; los canales administrados usan una identidad de servicio explícita y
+políticas para invitados, Slack Connect y modelo. La memoria del canal es explícita,
+aislada y nunca automática. Las rutinas creadas allí vuelven al mismo Slack. Los
+presupuestos diarios o mensuales por organización, solicitante y canal se aplican
+con linaje de auditoría. `assistant:write` habilita los eventos de contexto de
+Agent View; `chat:write` permite las respuestas y las actualizaciones de estado
+en directo.
+
 ## Configurar Telegrama {#telegram}
 
 ### Qué necesitarás
@@ -435,7 +509,9 @@ POST /_agent-native/integrations/telegram/setup
 | Correo electrónico | `EMAIL_AGENT_ADDRESS`, más uno de `RESEND_API_KEY` o `SENDGRID_API_KEY`      | `EMAIL_INBOUND_WEBHOOK_SECRET`                        |
 | WhatsApp           | `WHATSAPP_ACCESS_TOKEN`, `WHATSAPP_VERIFY_TOKEN`, `WHATSAPP_PHONE_NUMBER_ID` | —                                                     |
 
-Todas las credenciales residen en env vars: nunca la base de datos, nunca el código fuente. Utilice la configuración de la barra lateral UI o el panel ambiental de su proveedor de hosting.
+Las credenciales de integración se resuelven primero desde secretos con ámbito del propietario de la integración (usuario, organización y después espacio de trabajo); las variables de entorno de despliegue son una alternativa para instalaciones locales o deliberadamente de un solo tenant. La UI de configuración guarda secretos con ámbito; los valores nunca se devuelven al navegador ni se guardan en el código fuente.
+
+Los adaptadores de runtime integrados son **Slack**, **Telegram**, **WhatsApp Cloud API** y correo electrónico basado en webhooks de proveedor (Resend o SendGrid). Discord y Microsoft Teams no son conectables hasta implementar y registrar un adaptador verificado.
 
 ### Subprocesos e identidad {#threading-and-identity}
 
@@ -481,13 +557,13 @@ import type {
 import type { EnvKeyConfig } from "@agent-native/core/server";
 
 const myAdapter: PlatformAdapter = {
-  platform: "discord",
-  label: "Discord",
+  platform: "my-chat",
+  label: "My Chat",
 
   // Env keys this adapter needs (rendered in the settings UI)
   getRequiredEnvKeys(): EnvKeyConfig[] {
     return [
-      { key: "DISCORD_BOT_TOKEN", label: "Discord Bot Token", required: true },
+      { key: "MY_CHAT_BOT_TOKEN", label: "My Chat Bot Token", required: true },
     ];
   },
 
@@ -507,10 +583,10 @@ const myAdapter: PlatformAdapter = {
   // Return null to silently ignore the event (bot messages, edits, etc.).
   async parseIncomingMessage(event: H3Event): Promise<IncomingMessage | null> {
     return {
-      platform: "discord",
+      platform: "my-chat",
       externalThreadId: "channel-or-thread-id",
       text: "the user's message",
-      senderId: "discord-user-id",
+      senderId: "my-chat-user-id",
       platformContext: { channelId: "channel-id" },
       timestamp: Date.now(),
     };
@@ -538,10 +614,10 @@ const myAdapter: PlatformAdapter = {
   // baseUrl is the app's public URL, used for status checks that need it.
   async getStatus(baseUrl?: string) {
     return {
-      platform: "discord",
-      label: "Discord",
+      platform: "my-chat",
+      label: "My Chat",
       enabled: true,
-      configured: !!process.env.DISCORD_BOT_TOKEN,
+      configured: !!process.env.MY_CHAT_BOT_TOKEN,
     };
   },
 };

package/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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/corpus/core/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