@agent-native/core 0.93.0 → 0.94.1

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

@@ -145,8 +145,7 @@ pnpm install
 
 Luego defina la operación duradera:
 
-```ts
-// actions/summarize-week.ts
+```ts filename="actions/summarize-week.ts"
 import { defineAction } from "@agent-native/core/action";
 import { z } from "zod";
 
@@ -500,12 +499,11 @@ Mantenga el contrato pequeño: defina operaciones duraderas como actions, devuel
 resultados del widget cuando el chat necesita UI enriquecido y agrega pantallas completas solo cuando los usuarios
 necesita explorar, comparar, configurar o colaborar en objetos persistentes.
 
-## Documentos relacionados {#related-docs}
+## Qué sigue {#related-docs}
 
-- [Actions](/docs/actions): define la operación sin cabeza una vez.
-- [Native Interfaz de chat](/docs/native-chat-ui): muestra los resultados de la acción escrita en el chat.
-- [Drop-in Agent](/docs/drop-in-agent): monta superficies de chat, barra lateral o panel.
-- [Component API](/docs/components): piezas de chat/compositor de React de nivel inferior.
-- [Embedding SDK](/docs/embedding-sdk): agrega Agent-Native a una aplicación existente.
-- [External Agents](/docs/external-agents): conecta hosts compatibles con MCP a una aplicación.
-- [A2A Protocol](/docs/a2a-protocol): llama a agentes de otros agentes.
+- [**Actions**](/docs/actions): define la operación una vez; todas las superficies anteriores llaman a la misma
+- [**Native Interfaz de chat**](/docs/native-chat-ui): representa resultados tipados como tablas, gráficos y tarjetas en el chat
+- [**Generative UI**](/docs/generative-ui): genera UI aislada, temporal o persistente, dentro del chat
+- [**Automation-First Apps**](/docs/pure-agent-apps): el patrón completo sin navegador para trabajos, colas, scripts y agentes externos
+- [**External Agents**](/docs/external-agents): conecta hosts compatibles con MCP a una aplicación
+- [**A2A Protocol**](/docs/a2a-protocol): llama a agentes desde otras aplicaciones Agent-Native

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

@@ -239,6 +239,7 @@ interface AgentTask {
   summary: string; // full summary once completed
   currentStep: string; // latest step label (updated while running)
   createdAt: number;
+  delegationDepth?: number; // 1 for a direct sub-agent, 2 for a sub-agent of that sub-agent, etc.
   // Additional fields: parentThreadId, name, updatedAt, startedAt,
   // completedAt, runId, error
 }

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

@@ -15,7 +15,7 @@ La autenticación se configura automáticamente a través de `autoMountAuth(app)
 - **MCP OAuth remoto:** OAuth 2.1 estándar para hosts MCP como el código Claude y los conectores ChatGPT.
 - **Personalizado:** Traiga su propia autenticación a través de la devolución de llamada `getSession`.
 
-<Diagram id="doc-block-1lj059p" title={"Tres entradas, una sesión"} summary={"Los visitantes del navegador, los clientes programáticos MCP y los proveedores personalizados se resuelven en la misma sesión de autenticación que lee el alcance descendente."}>
+<Diagram id="doc-block-1lj059p" title={"Tres entradas, una sesión"} summary={"Los visitantes del navegador, los hosts MCP y los proveedores personalizados se resuelven en la misma sesión de autenticación que lee el alcance descendente."}>
 
 ```html
 <div class="auth-modes">

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

@@ -476,10 +476,12 @@ acción para que UI y el agente compartan la misma capacidad.
 ```ts
 import { defineAction } from "@agent-native/core/action";
 import { completeText } from "@agent-native/core/server";
+import { z } from "zod";
 
 export default defineAction({
   description: "Classify a short message",
-  run: async ({ body }: { body: string }) => {
+  schema: z.object({ body: z.string() }),
+  run: async ({ body }) => {
     const result = await completeText({
       systemPrompt: "Return exactly one label.",
       input: body,
@@ -494,3 +496,11 @@ export default defineAction({
 Utilice `sendToAgentChat({ background: true, openSidebar: false })` en su lugar cuando
 el trabajo necesita herramientas, estado, auditabilidad, dirección del usuario o varios pasos
 razonamiento.
+
+## Qué sigue {#whats-next}
+
+- [**Drop-in Agent**](/docs/drop-in-agent) — monta `<AgentSidebar>` y `<AgentPanel>` con un recorrido centrado en el tutorial
+- [**Native Chat UI**](/docs/native-chat-ui) — el contrato de resultados de acciones detrás de los widgets de datos y renderizadores personalizados
+- [**Actions**](/docs/actions) — `defineAction()`, esquemas y la superficie de acciones que llaman estos componentes
+- [**Real-Time Collaboration**](/docs/real-time-collaboration) — los hooks de colaboración y componentes de presencia en detalle
+- [**Sharing**](/docs/sharing) — configuración de `<ShareButton>` y `<ShareDialog>` para recursos con propietario

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

@@ -44,7 +44,6 @@ Cada plantilla sigue el mismo diseño general:
 <FileTree
   id="doc-block-1qe28n0"
   title="Estructura del proyecto de plantilla"
-  title="my-template/"
   entries={[
     {
       path: "app/",
@@ -172,8 +171,7 @@ Las cuatro áreas de cada plantilla se conectan a través de una superficie de a
 
 Defina tablas de dominio con los asistentes del marco Drizzle para que los esquemas sigan siendo portátiles en SQLite, Postgres, D1, Turso, Supabase, Neon y otros backends compatibles:
 
-```ts
-// server/db/schema.ts
+```ts filename="server/db/schema.ts"
 import {
   table,
   text,
@@ -204,8 +202,7 @@ Los cambios de esquema deben ser aditivos. Agregue tablas y columnas a través d
 
 Para lecturas y escrituras de aplicaciones, utilice el generador de consultas de Drizzle y los operadores portátiles de `drizzle-orm`. No escriba código de producto con SQL sin formato cuando Drizzle pueda expresar la consulta y no importe desde `drizzle-orm/sqlite-core` o `drizzle-orm/pg-core` en plantillas.
 
-```ts
-// server/plugins/db.ts
+```ts filename="server/plugins/db.ts"
 import { runMigrations } from "@agent-native/core/db";
 
 export default runMigrations(
@@ -349,8 +346,7 @@ Para la navegación de aplicaciones, prefiera un comando `navigate` que incluya
 `path` cuando se conoce el URL. No escribas también `__set_url__` para el mismo movimiento;
 Esa clave está reservada para las herramientas del marco URL y los cambios de filtro exclusivos de URL.
 
-```ts
-// actions/navigate.ts
+```ts filename="actions/navigate.ts"
 import { defineAction } from "@agent-native/core/action";
 import { writeAppState } from "@agent-native/core/application-state";
 import { z } from "zod";

package/corpus/core/docs/content/locales/es-ES/cross-app-sso.mdx

@@ -9,7 +9,11 @@ Cada aplicación alojada en `*.agent-native.com` ejecuta su propia implementaci
 
 Esta es la misma primitiva de confianza que ya usan [A2A](/docs/a2a-protocol) y [External Agents](/docs/external-agents) (una JWT firmada por `A2A_SECRET` verificada en el límite de la solicitud) aplicada a la ruta de inicio de sesión humano en lugar de llamadas de agente a agente.
 
-> **Implementación unificada frente a implementación por dominio.** Si aloja todas las aplicaciones en un origen (`your-agents.com/mail`, `your-agents.com/calendar`), ya obtiene un inicio de sesión compartido a través de un único dominio de cookies, sin necesidad de federación. Cross-App SSO solo es necesario cuando las aplicaciones se ejecutan en dominios separados. Ver [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment).
+<Callout tone="info">
+
+**Implementación unificada frente a implementación por dominio.** Si aloja todas las aplicaciones en un origen (`your-agents.com/mail`, `your-agents.com/calendar`), ya obtiene un inicio de sesión compartido a través de un único dominio de cookies, sin necesidad de federación. Cross-App SSO solo es necesario cuando las aplicaciones se ejecutan en dominios separados. Ver [Multi-App Workspaces — Unified deploy](/docs/multi-app-workspace#deployment).
+
+</Callout>
 
 ## Qué y por qué {#what-why}
 
@@ -86,15 +90,17 @@ El flujo es una autorización estándar → token firmado → redireccionamiento
 
 </Diagram>
 
-1. **Aplicación → Envío (autorizar).** La aplicación envía al usuario a la autoridad de identidad:
+1. **Aplicación → Dispatch (autorización).** La ruta `GET /_agent-native/identity/login` de la aplicación (a la que enlaza el botón «Iniciar sesión con Agent-Native») crea la redirección y envía al usuario a la autoridad de identidad:
 
-   ```
+   ```http
    GET https://dispatch.agent-native.com/_agent-native/identity/authorize
        ?app=<requesting-app>
        &redirect_uri=<app-callback-url>
        &state=<csrf-state>
    ```
 
+   `redirect_uri` es la ruta `GET /_agent-native/identity/callback` de esta aplicación, la ruta que recibe el token firmado en el paso 3.
+
 <Endpoint id="cross-app-sso-identity-authorize-es-es" title={"Punto final de autorización de identidad"} method="GET" path="/_agent-native/identity/authorize" summary={"El envío (autoridad de identidad) autentica al ser humano y lo redirecciona con un token de identidad firmado"} auth={"Sesión de envío (inicio de sesión interactivo si no hay ninguno)"} params={[
   {
     "name": "app",
@@ -143,7 +149,7 @@ El flujo es una autorización estándar → token firmado → redireccionamiento
    | `scope`      | Siempre `"identity"`: este token solo autoriza el inicio de sesión           |
    | `exp`        | **≤ 2 minutos** desde el problema                                            |
 
-4. **La aplicación verifica los enlaces JIT por correo electrónico.** La aplicación verifica la firma del token con su propio `A2A_SECRET`, verifica `scope: "identity"` y `exp` y luego realiza **enlace justo a tiempo estrictamente mediante correo electrónico verificado**:
+4. **La aplicación verifica y enlaza JIT por correo electrónico.** La ruta `GET /_agent-native/identity/callback` verifica la firma del token con `A2A_SECRET`, comprueba `scope: "identity"` y `exp`, y realiza el **enlace justo a tiempo estrictamente por correo electrónico verificado**:
    - Si existe un usuario local con ese correo electrónico → reutilícelo sin cambios.
    - Si no → crea un usuario local para ese correo electrónico.
 
@@ -290,9 +296,13 @@ Una vez verificada una aplicación, repita los pasos 2 y 3 para la siguiente apl
 **5. Rollback = desarmar la var de entorno en la implementación de esa aplicación.**
 Para revertir cualquier aplicación, **elimine `AGENT_NATIVE_IDENTITY_HUB_URL` del entorno de esa aplicación y vuelva a implementarla/reiníciela.** La aplicación vuelve inmediatamente a su comportamiento de autenticación anterior. No hay **ningún cambio de datos para deshacer**: las filas de identidad solo se agregaron y desarmar la variable simplemente hace que la ruta de federación vuelva a estar inactiva. La transición y la reversión de cada aplicación son independientes y reversibles.
 
-> Rollout cierra la sesión de los usuarios cuando se habilita cada aplicación (se vuelven a autenticar a través de Dispatch), pero siempre vuelven a iniciar sesión en la **misma cuenta de correo electrónico coincidente con los datos intactos**, porque las filas de identidad nunca se destruyen ni se les cambia el nombre, solo se agregan.
+<Callout tone="info">
+
+Rollout cierra la sesión de los usuarios cuando se habilita cada aplicación (se vuelven a autenticar a través de Dispatch), pero siempre vuelven a iniciar sesión en la **misma cuenta de correo electrónico coincidente con los datos intactos**, porque las filas de identidad nunca se destruyen ni se les cambia el nombre, solo se agregan.
+
+</Callout>
 
-## Relacionado {#related}
+## Qué sigue {#whats-next}
 
 - [Authentication](/docs/authentication): modos de autenticación locales, sesiones, organizaciones, la var. de entorno `A2A_SECRET`.
 - [A2A Protocol](/docs/a2a-protocol): modelo de confianza firmado JWT con verificación en el límite que se reutiliza.

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

@@ -452,3 +452,11 @@ Consulte [Frames](/docs/frames) para obtener más información sobre el panel de
 ## Implementaciones de instancias múltiples {#multi-instance}
 
 Las aplicaciones nativas del agente almacenan todo el estado en SQL a través de Drizzle y sincronizan el UI a través de [polling](/docs/key-concepts#polling-sync) con la base de datos: sin estado del sistema de archivos, sin sesiones fijas, sin cachés en memoria. Eso significa que las implementaciones de múltiples instancias y sin servidor funcionan de inmediato: apunte cada instancia al mismo `DATABASE_URL` y convergerán automáticamente. Ver [Key Concepts — Data in SQL](/docs/key-concepts#data-in-sql) y [Portability](/docs/key-concepts#hosting-agnostic).
+
+## Qué sigue
+
+- [**Database**](/docs/database#production) — elige un backend SQL persistente antes de tu primera implementación en producción
+- [**Security**](/docs/security) — la lista de comprobación de producción y los indicadores opcionales mencionados en esta página
+- [**Authentication**](/docs/authentication) — credenciales OAuth y variables de entorno para el modo de autenticación que elijas
+- [**Multi-App Workspace**](/docs/multi-app-workspace) — el modelo de espacio de trabajo detrás de la compilación de origen único de `deploy`
+- [**Frames**](/docs/frames) — el panel de agente integrado frente al marco en la nube de Builder.io para editar la UI de producción

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/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