Update from code changes: document private editor pages

editor/agent.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Ask agent"
-description: "Use the editor's built-in AI agent to write content, edit pages, search across your site, upload files, and configure settings from a chat interface."
+title: "Use the editor's AI agent to edit and manage pages"
+description: "Learn how to use the editor's AI agent to edit pages, update navigation, run bash commands, manage private pages, and configure your Mintlify site."
 keywords: ["editor", "AI", "assistant", "agent", "chat", "code mode", "file upload"]
 ---
 
@@ -35,6 +35,7 @@
 Click the paperclip icon in the chat box, or drag and drop files onto the panel. The agent reads attached files as context for your request.
 
 Supported file types:
+
 - **Images**: JPG, PNG, GIF, WebP, SVG
 - **Documents**: PDF
 - **Code and text**: `.js`, `.ts`, `.jsx`, `.tsx`, `.mdx`, `.md`, `.json`, `.yaml`, `.html`, `.css`, Python, Go, Rust, Ruby, Java, Swift, C, C++, SQL, shell scripts, and more
@@ -71,9 +72,70 @@
 
 Example: `find every page that mentions the deprecated /v1/auth endpoint`
 
+### Work with private pages
+
+If you have access to private pages, the agent can read and edit them from the private pages root. Use this feature to review or update content that should not appear in public navigation. Private pages are available in the editor without an additional feature flag. Your role and page grants determine what you can access and change.
+
+You can open the agent from the private page editor. The agent button is hidden for users with the viewer role. Private navigation refreshes when the agent or another editor changes the private page tree.
+
+Private pages are organized into two sidebar sections. **Personal** contains pages and folders you own. **Shared with me** contains pages and folders shared with you. You can collapse each section independently. Use the add menu on the **Personal** header or right-click that header to create a private page or folder. The **Shared with me** header has no add menu.
+
+To promote a private page or folder from the sidebar, open its **More options** menu and select **Promote to workspace**. This action is available for items in your **Personal** section when you have **Manager** access to the item and all of its descendants. After you confirm, Mintlify adds the page or folder to the workspace root. Promoting a folder also promotes all nested folders and pages. Mintlify recreates their structure and copies their content. Mintlify generates page paths from titles and resolves duplicate paths automatically. The confirmation dialog warns that promotion is permanent. You cannot move promoted content back to private pages.
+
+When the agent works with a private page, its tool activity labels show the page title instead of the UUID-based filename.
+
+When you open a private page, the editor toolbar shows an **Edited** label with how long ago the page was last edited. The label updates after you edit the page.
+
+Private pages use UUID-based filenames. Start by listing the private pages, then read or edit the file you need:
+
+```bash
+ls /home/daytona/private
+cat /home/daytona/private/private-page-<uuid>.mdx
+```
+
+Type `@` in the composer to search for private pages by title. Private pages appear in the mention picker with the label `Private page`. After you select one, its chip does not link to the private page. The agent resolves the mention to its UUID path. It includes only pages you can access.
+
+To create a private folder in **Personal**, use a human-readable title as the final path segment. After you list the directory again, the folder appears under a new `private-folder-<uuid>` path:
+
+```bash
+mkdir "/home/daytona/private/Onboarding"
+ls /home/daytona/private
+# private-folder-<uuid>
+```
+
+Within `/home/daytona/private`, use `mv` to reparent a private page or folder from **Personal** into another private folder. The item keeps its UUID-based name. Manager access is required. You cannot rename pages or move a folder into itself:
+
+```bash
+mv /home/daytona/private/private-page-<page-uuid>.mdx \
+  /home/daytona/private/private-folder-<folder-uuid>/
+mv /home/daytona/private/private-folder-<source-uuid> \
+  /home/daytona/private/private-folder-<destination-uuid>/
+```
+
+Moving a workspace page into `/home/daytona/private` is not supported.
+
+To duplicate a private page, use `cp` with a human-readable title as the final path segment. After you list the directory again, the copy appears under a new `private-page-<uuid>.mdx` path:
+
+```bash
+cp /home/daytona/private/private-page-<source-uuid>.mdx \
+  "/home/daytona/private/Copy of this page"
+ls /home/daytona/private
+# private-page-<new-uuid>.mdx
+```
+
+You can copy private pages only. Copying folders and copying between `/home/daytona/private` and `/home/daytona/workspace` are not supported.
+
+You can also delete a private page if your role allows it. Manager access is required for deletion. To make a private page public, move it into the workspace:
+
+```bash
+mv /home/daytona/private/private-page-<uuid>.mdx /home/daytona/workspace/<path>.mdx
+```
+
+The move adds the page to public navigation and revokes its private-page access. You do not need to configure another filesystem or grant additional access. The agent uses your existing private-page permissions.
+
 ### Configure your site (code mode)
 
-For requests that go beyond editing pages (setting up authentication, managing workflows, or changing deployment settings), the agent switches into code mode. It writes and runs a script against your Mintlify dashboard on your behalf.
+For requests that go beyond editing pages, such as setting up authentication, managing workflows, or changing deployment settings, the agent switches into code mode. It writes and runs a script against your Mintlify dashboard on your behalf.
 
 Code mode respects your dashboard permissions. If you don't have access to a setting in the dashboard, the agent can't change it either.
 
@@ -85,9 +147,9 @@
 
 ### Continue an automation run
 
-When you open the editor from a completed automation run by clicking **View changes**, the agent panel opens automatically with context on what the automation did. A **Changed pages** card at the top of the chat lists every page the automation modified—click any page to open a diff view.
+When you open the editor from a completed automation run by clicking **View changes**, the agent panel opens automatically. It includes context on what the automation did. A **Changed pages** card at the top of the chat lists every page the automation modified. Click any page to open a diff view.
 
-The agent has context on the automation's prompt, a summary of the changes it made, and which pages it modified. You can ask it to refine or extend the automation's work without re-explaining the background.
+The agent has context on the automation's prompt and a summary of the changes it made. It also knows which pages it modified. You can ask it to refine or extend the automation's work without re-explaining the background.
 
 For example: `The new section on rate limits is too long. Trim it to three sentences.`
 
@@ -97,4 +159,4 @@
 
 ## AI instructions
 
-To give the agent persistent guidance like voice rules, terminology, or formatting conventions, configure AI instructions in [Editor settings](/editor/settings#ai-instructions). The agent follows these instructions on every request without you needing to repeat them.
+To give the agent persistent guidance, configure AI instructions in [Editor settings](/editor/settings#ai-instructions). Use these instructions to define voice rules, terminology, or formatting conventions. The agent follows them on every request without you needing to repeat them.

es/editor/agent.mdx

@@ -1,6 +1,6 @@
 ---
-title: "Preguntar al agente"
-description: "Use el agente de IA integrado del editor para escribir contenido, editar páginas, buscar en el sitio, subir archivos y ajustar la configuración."
+title: "Usar el agente de IA del editor para editar páginas"
+description: "Aprenda a usar el agente de IA del editor para editar páginas, actualizar la navegación, ejecutar bash y gestionar páginas privadas en Mintlify."
 keywords: ["editor", "AI", "assistant", "agent", "chat", "code mode", "file upload"]
 ---
 
@@ -14,7 +14,7 @@ El agente del editor realiza los cambios directamente en la branch actual.
 
 </div>
 
-Haga clic en **Ask agent** en la barra de herramientas del editor, o presione <kbd>Cmd</kbd> + <kbd>I</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>I</kbd> (Windows).
+Haga clic en **Ask agent** en la barra de herramientas del editor o presione <kbd>Cmd</kbd> + <kbd>I</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>I</kbd> (Windows).
 
 Para cerrar el panel, haga clic en el botón **X** del encabezado del panel o vuelva a presionar <kbd>Cmd</kbd> + <kbd>I</kbd>.
 
@@ -24,7 +24,7 @@ Para cerrar el panel, haga clic en el botón **X** del encabezado del panel o vu
 
 </div>
 
-Escriba su solicitud en el cuadro de chat en la parte inferior del panel y presione <kbd>Enter</kbd> o haga clic en el botón de envío <Icon icon="arrow-up" />.
+Escriba su solicitud en el cuadro de chat en la parte inferior del panel. Presione <kbd>Enter</kbd> o haga clic en el botón de envío <Icon icon="arrow-up" />.
 
 Escriba <kbd>@</kbd> para mencionar una página específica. El agente se centra en esa página al procesar su solicitud. Si no menciona ninguna página, el agente utiliza la página que tiene abierta en ese momento.
 
@@ -42,9 +42,10 @@ Ejemplos de prompts:
 
 </div>
 
-Haga clic en el icono del clip en el cuadro de chat, o arrastre y suelte archivos en el panel. El agente lee los archivos adjuntos como contexto para su solicitud.
+Haga clic en el icono del clip en el cuadro de chat o arrastre y suelte archivos en el panel. El agente lee los archivos adjuntos como contexto para su solicitud.
 
 Tipos de archivo admitidos:
+
 - **Imágenes**: JPG, PNG, GIF, WebP, SVG
 - **Documentos**: PDF
 - **Código y texto**: `.js`, `.ts`, `.jsx`, `.tsx`, `.mdx`, `.md`, `.json`, `.yaml`, `.html`, `.css`, Python, Go, Rust, Ruby, Java, Swift, C, C++, SQL, scripts de shell y más
@@ -95,7 +96,7 @@ El agente puede buscar en todo su repositorio, no solo en la página que tiene a
 
 </div>
 
-El agente puede añadir, renombrar, reordenar y eliminar elementos de navegación, los mismos cambios que haría manualmente en el panel de navegación. También puede actualizar la configuración de `docs.json` directamente, incluyendo añadir nuevos grupos, ajustar opciones y configurar redirecciones.
+El agente puede añadir, renombrar, reordenar y eliminar elementos de navegación, igual que usted haría manualmente en el panel de navegación. También puede actualizar directamente la configuración de `docs.json`, lo que incluye añadir nuevos grupos, ajustar opciones y configurar redirecciones.
 
 Ejemplo: `add a "Quickstart" group under the Getting Started tab and move the quickstart page into it`
 
@@ -109,13 +110,78 @@ El agente puede ejecutar `grep`, `rg` y otros comandos bash sobre su repositorio
 
 Ejemplo: `find every page that mentions the deprecated /v1/auth endpoint`
 
+<div id="work-with-private-pages">
+
+### Trabajar con páginas privadas
+
+</div>
+
+Si tiene acceso a páginas privadas, el agente puede leerlas y editarlas desde la raíz de páginas privadas. Use esta función para revisar o actualizar contenido que no debería aparecer en la navegación pública. Las páginas privadas están disponibles en el editor sin necesidad de activar un indicador de funcionalidad adicional. Su rol y los permisos de cada página determinan a qué páginas puede acceder y qué cambios puede realizar.
+
+Puede abrir el agente desde el editor de páginas privadas. El botón del agente está oculto para los usuarios con el rol de viewer. La navegación privada se actualiza cuando el agente u otro editor cambia el árbol de páginas privadas.
+
+Las páginas privadas están organizadas en dos secciones de la barra lateral. **Personal** contiene las páginas y carpetas de su propiedad. **Shared with me** contiene las páginas y carpetas que han compartido con usted. Puede contraer cada sección de forma independiente. Use el menú de adición del encabezado **Personal** o haga clic derecho en ese encabezado para crear una página o carpeta privada. El encabezado **Shared with me** no incluye un menú de adición.
+
+Para promocionar una página o carpeta privada desde la barra lateral, abra su menú **More options** y seleccione **Promote to workspace**. Esta acción está disponible para los elementos de su sección **Personal** cuando tiene acceso de **Manager** al elemento y a todos sus descendientes. Después de confirmar, Mintlify añade la página o carpeta a la raíz del espacio de trabajo. Al promocionar una carpeta, también se promocionan todas las carpetas y páginas anidadas. Mintlify recrea su estructura y copia su contenido. Mintlify genera las rutas de las páginas a partir de sus títulos y resuelve las rutas duplicadas automáticamente. El diálogo de confirmación advierte que la promoción es permanente. No puede mover el contenido promocionado de vuelta a las páginas privadas.
+
+Cuando el agente trabaja con una página privada, las etiquetas de sus herramientas muestran el título de la página en lugar del nombre de archivo basado en UUID.
+
+Al abrir una página privada, la barra de herramientas del editor muestra la etiqueta **Edited** con el tiempo transcurrido desde la última edición. La etiqueta se actualiza después de editar la página.
+
+Las páginas privadas utilizan nombres de archivo basados en UUID. Empiece por enumerar las páginas privadas y, después, lea o edite el archivo que necesite:
+
+```bash
+ls /home/daytona/private
+cat /home/daytona/private/private-page-<uuid>.mdx
+```
+
+Escriba `@` en el compositor para buscar páginas privadas por título. Las páginas privadas aparecen en el selector de menciones con la etiqueta `Private page`. Después de seleccionar una, su chip no enlaza a la página privada. El agente resuelve la mención a su ruta basada en UUID. Solo incluye las páginas a las que tiene acceso.
+
+Para crear una carpeta privada en **Personal**, use un título legible como segmento final de la ruta. Después de volver a enumerar el directorio, la carpeta aparece con una nueva ruta `private-folder-<uuid>`:
+
+```bash
+mkdir "/home/daytona/private/Onboarding"
+ls /home/daytona/private
+# private-folder-<uuid>
+```
+
+Dentro de `/home/daytona/private`, use `mv` para cambiar el padre de una página o carpeta privada desde **Personal** a otra carpeta privada. El elemento conserva su nombre basado en UUID. Se requiere acceso de **Manager**. No puede renombrar páginas ni mover una carpeta dentro de sí misma:
+
+```bash
+mv /home/daytona/private/private-page-<page-uuid>.mdx \
+  /home/daytona/private/private-folder-<folder-uuid>/
+mv /home/daytona/private/private-folder-<source-uuid> \
+  /home/daytona/private/private-folder-<destination-uuid>/
+```
+
+No se admite mover una página del espacio de trabajo a `/home/daytona/private`.
+
+Para duplicar una página privada, use `cp` con un título legible como segmento final de la ruta. Después de volver a enumerar el directorio, la copia aparece con una nueva ruta `private-page-<uuid>.mdx`:
+
+```bash
+cp /home/daytona/private/private-page-<source-uuid>.mdx \
+  "/home/daytona/private/Copy of this page"
+ls /home/daytona/private
+# private-page-<new-uuid>.mdx
+```
+
+Solo se pueden copiar páginas privadas. `cp` no admite carpetas ni copias entre `/home/daytona/private` y `/home/daytona/workspace`.
+
+También puede eliminar una página privada si su rol lo permite. Para eliminarla, se requiere acceso de **Manager**. Para hacer pública una página privada, muévala al espacio de trabajo:
+
+```bash
+mv /home/daytona/private/private-page-<uuid>.mdx /home/daytona/workspace/<path>.mdx
+```
+
+El traslado añade la página a la navegación pública y revoca su acceso de página privada. No necesita configurar otro sistema de archivos ni conceder permisos adicionales. El agente utiliza sus permisos existentes para páginas privadas.
+
 <div id="configure-your-site-code-mode">
 
 ### Configurar su sitio (code mode)
 
 </div>
 
-Para solicitudes que van más allá de editar páginas (configurar autenticación, gestionar workflows o cambiar ajustes de despliegue), el agente cambia a code mode. Escribe y ejecuta un script contra su panel de Mintlify en su nombre.
+Para solicitudes que van más allá de editar páginas, como configurar autenticación, gestionar workflows o cambiar ajustes de despliegue, el agente cambia a code mode. Escribe y ejecuta un script contra su panel de Mintlify en su nombre.
 
 Code mode respeta sus permisos del panel. Si no tiene acceso a un ajuste en el panel, el agente tampoco puede cambiarlo.
 
@@ -131,9 +197,9 @@ Ejemplos de prompts que usan code mode:
 
 </div>
 
-Cuando abres el editor desde una ejecución de automatización completada haciendo clic en **Ver cambios**, el panel del agente se abre automáticamente con contexto sobre lo que hizo la automatización. Una tarjeta de **Páginas modificadas** en la parte superior del chat lista cada página que la automatización modificó: haz clic en cualquier página para abrir una vista de diff.
+Al hacer clic en **Ver cambios** en una ejecución de automatización completada, el editor se abre. Muestra el panel del agente. El panel incluye el contexto sobre lo que hizo la automatización. Una tarjeta de **Páginas modificadas** en la parte superior del chat lista cada página que la automatización modificó. Haga clic en cualquier página para abrir una vista de diff.
 
-El agente tiene contexto sobre el prompt de la automatización, un resumen de los cambios que realizó y qué páginas modificó. Puedes pedirle que refine o amplíe el trabajo de la automatización sin tener que volver a explicar el contexto.
+El agente tiene contexto sobre el prompt de la automatización y un resumen de los cambios que realizó. También sabe qué páginas modificó. Puede pedirle que refine o amplíe el trabajo de la automatización sin tener que volver a explicar el contexto.
 
 Por ejemplo: `The new section on rate limits is too long. Trim it to three sentences.`
 
@@ -151,4 +217,4 @@ Haga clic en el icono del reloj en el encabezado del panel para ver sus sesiones
 
 </div>
 
-Para dar al agente pautas persistentes como reglas de voz, terminología o convenciones de formato, configure las instrucciones de IA en la [configuración del editor](/es/editor/settings#ai-instructions). El agente sigue estas instrucciones en cada solicitud sin que tenga que repetirlas.
+Para dar al agente pautas persistentes, configure las instrucciones de IA en la [configuración del editor](/es/editor/settings#ai-instructions). Use estas instrucciones para definir reglas de voz, terminología o convenciones de formato. El agente sigue estas instrucciones en cada solicitud sin que tenga que repetirlas.