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"]
 ---
 
@@ -71,6 +71,65 @@
 
 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 when you need to review or update content that should not appear in your public navigation. Private pages are available in the editor without an additional feature flag. Your role and page grants still 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.
+
+You can also right-click the **Private** section header in the sidebar to create a private page or folder if you have permission to create them.
+
+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 and includes only pages you can access.
+
+To create a private folder, use a human-readable title as the final path segment. The folder appears under a new `private-folder-<uuid>` path after you list the directory again:
+
+```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 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. The copy appears under a new `private-page-<uuid>.mdx` path after you list the directory again:
+
+```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 automatically.
+
 ### 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.
@@ -85,7 +144,7 @@
 
 ### 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 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.
 
 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.
 

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"]
 ---
 
@@ -109,6 +109,69 @@ 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 opción cuando necesite revisar o actualizar contenido que no debería aparecer en su 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 siguen determinando 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.
+
+También puede hacer clic derecho en el encabezado de la sección **Private** en la barra lateral para crear una página o carpeta privada si tiene permiso para crearlas.
+
+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 e incluye solo páginas a las que tiene acceso.
+
+Para crear una carpeta privada, use `mkdir` con un título legible como segmento final de la ruta. La carpeta aparece con una ruta `private-folder-<uuid>` después de volver a enumerar el directorio:
+
+```bash
+mkdir "/home/daytona/private/Onboarding"
+ls /home/daytona/private
+# private-folder-<uuid>
+```
+
+Dentro de `/home/daytona/private`, `mv` cambia el padre de una página o carpeta a otra carpeta privada y conserva su nombre basado en UUID. Se requiere acceso de **Manager**. No admite 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. Al 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 automáticamente sus permisos existentes para páginas privadas.
+
 <div id="configure-your-site-code-mode">
 
 ### Configurar su sitio (code mode)
@@ -131,9 +194,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 y 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, un resumen de los cambios que realizó y 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.`
 

fr/editor/agent.mdx

@@ -1,10 +1,10 @@
 ---
-title: "Demander à l'agent"
-description: "Utilisez l'agent IA intégré pour rédiger du contenu, modifier des pages, rechercher dans le site, téléverser des fichiers et configurer les paramètres."
+title: "Utiliser l'agent IA de l'éditeur pour modifier des pages"
+description: "Découvrez comment utiliser l'agent IA de l'éditeur pour modifier des pages, actualiser la navigation, exécuter bash et gérer les pages privées."
 keywords: ["editor", "AI", "assistant", "agent", "chat", "code mode", "file upload"]
 ---
 
-L'éditeur inclut un agent intégré qui peut modifier des pages, réorganiser la navigation, mettre à jour `docs.json`, effectuer des recherches dans l'ensemble de votre référentiel et gérer les paramètres du tableau de bord.
+L'éditeur inclut un agent intégré. Il peut modifier des pages, réorganiser la navigation, mettre à jour `docs.json`, effectuer des recherches dans l'ensemble de votre référentiel et gérer les paramètres du tableau de bord.
 
 L'agent de l'éditeur effectue les modifications directement sur votre branche actuelle.
 
@@ -109,6 +109,71 @@ L'agent peut exécuter `grep`, `rg` et d'autres commandes bash sur votre référ
 
 Exemple : `find every page that mentions the deprecated /v1/auth endpoint`
 
+<div id="work-with-private-pages">
+
+### Travailler avec des pages privées
+
+</div>
+
+Si vous avez accès aux pages privées, l'agent peut les lire et les modifier depuis la racine des pages privées. Utilisez cette fonctionnalité lorsque vous devez examiner ou mettre à jour du contenu qui ne doit pas apparaître dans votre navigation publique. Les pages privées sont disponibles dans l'éditeur sans activation d'un indicateur de fonctionnalité supplémentaire. Votre rôle et les autorisations de chaque page déterminent toujours les pages auxquelles vous pouvez accéder et les modifications que vous pouvez effectuer.
+
+Vous pouvez ouvrir l'agent depuis l'éditeur de pages privées. Le bouton de l'agent est masqué pour les utilisateurs ayant le rôle de viewer. La navigation privée s'actualise lorsque l'agent ou un autre éditeur modifie l'arborescence des pages privées.
+
+Si vous disposez des autorisations nécessaires, cliquez avec le bouton droit sur l'en-tête de la section **Private** dans la barre latérale. Vous pouvez ainsi créer une page ou un dossier privé.
+
+Lorsque l'agent utilise une page privée, les libellés de ses outils affichent le titre de la page au lieu du nom de fichier basé sur l'UUID.
+
+Lorsque vous ouvrez une page privée, la barre d'outils de l'éditeur affiche le libellé **Edited** et indique depuis combien de temps la page a été modifiée. Le libellé se met à jour après la modification de la page.
+
+Les pages privées utilisent des noms de fichiers basés sur des UUID. Commencez par lister les pages privées, puis lisez ou modifiez le fichier dont vous avez besoin :
+
+```bash
+ls /home/daytona/private
+cat /home/daytona/private/private-page-<uuid>.mdx
+```
+
+Dans le composeur, saisissez <kbd>@</kbd> pour rechercher une page privée par son titre. Les pages privées apparaissent dans le sélecteur de mentions avec le libellé `Private page`. Après sélection, sa puce ne contient pas de lien vers la page privée. L'agent résout la mention vers son chemin UUID et ne prend en compte que les pages auxquelles vous avez accès.
+
+Pour créer un dossier privé, donnez-lui un titre humain comme dernier segment du chemin. Après une nouvelle liste, le dossier apparaît sous un chemin `private-folder-<uuid>` :
+
+```bash
+mkdir "/home/daytona/private/Onboarding"
+ls /home/daytona/private
+# private-folder-<uuid>
+```
+
+Pour réorganiser une page ou un dossier, `mv` peut le reparenter dans un autre dossier sous `/home/daytona/private` :
+
+```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>/
+```
+
+Le déplacement d'une page de l'espace de travail vers `/home/daytona/private` n'est pas pris en charge.
+
+Cette opération exige l'accès **Manager**. Elle conserve le nom UUID de l'élément ; `mv` ne renomme pas les pages et ne peut pas déplacer un dossier dans lui-même.
+
+Pour copier une page privée, utilisez `cp` avec un nouveau titre humain comme dernier segment du chemin de destination :
+
+```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
+```
+
+La copie est une nouvelle page privée et apparaît sous un chemin `private-page-<uuid>.mdx` après la prochaine liste. La copie de dossiers n'est pas prise en charge, pas plus que les copies entre les racines `/home/daytona/private` et `/home/daytona/workspace`.
+
+Vous pouvez également supprimer une page privée si votre rôle vous y autorise. Un accès Manager est requis pour la suppression. Pour rendre une page privée publique, déplacez-la dans l'espace de travail :
+
+```bash
+mv /home/daytona/private/private-page-<uuid>.mdx /home/daytona/workspace/<path>.mdx
+```
+
+Le déplacement ajoute la page à la navigation publique et révoque son accès en tant que page privée. Vous n'avez pas besoin de configurer un autre système de fichiers ni d'accorder un accès supplémentaire. L'agent utilise automatiquement vos autorisations existantes pour les pages privées.
+
 <div id="configure-your-site-code-mode">
 
 ### Configurer votre site (mode code)
@@ -131,7 +196,7 @@ Exemples de prompts qui utilisent le mode code :
 
 </div>
 
-Lorsque vous ouvrez l'éditeur depuis une exécution d'automatisation terminée en cliquant sur **View changes**, le panneau de l'agent s'ouvre automatiquement avec le contexte de ce que l'automatisation a fait. Une carte **Pages modifiées** en haut du chat liste chaque page modifiée par l'automatisation — cliquez sur une page pour ouvrir une vue de diff.
+Lorsque vous ouvrez l'éditeur depuis une exécution d'automatisation terminée en cliquant sur **View changes**, le panneau de l'agent s'ouvre automatiquement avec le contexte de ce que l'automatisation a fait. Une carte **Pages modifiées** en haut du chat liste chaque page modifiée par l'automatisation. Cliquez sur une page pour ouvrir une vue de diff.
 
 L'agent dispose du contexte du prompt de l'automatisation, d'un résumé des modifications qu'elle a effectuées et des pages qu'elle a modifiées. Vous pouvez lui demander d'affiner ou d'étendre le travail de l'automatisation sans avoir à réexpliquer le contexte.