docs: add UID/GID mapping section to Agent Drive overview

[devin-ai-integration]

Summary

Adds a new "Map UID/GID on mount" subsection to the Agent Drive Overview page, documenting the optional UID/GID mapping feature introduced in sandbox#211.

The section covers:

• How to pass uidMap/gidMap when mounting a drive (TypeScript and Python examples)
• How the mapping works (local UID/GID maps to filer UID/GID 0)
• Default mapping via BLFS_UID_MAP and BLFS_GID_MAP environment variables
• Override priority (request > env var > no mapping)

Review & Testing Checklist for Human

• Verify the TypeScript SDK parameter names match the actual SDK (uidMap, gidMap)
• Verify the Python SDK parameter names match the actual SDK (uid_map, gid_map)
• Preview the page locally with npx mint dev to confirm rendering

Notes

This section is placed after "Mount a drive as read-only" and before "List mounted drives", following the existing H3 pattern for mount options.

Link to Devin session: https://app.devin.ai/sessions/1dfaeffa257b47078447110cbb2007fc
Requested by: @Joffref

---

Note

Adds a "Map UID/GID on mount" subsection to the Agent Drive Overview, documenting uidMap/gidMap mount parameters and BLFS_UID_MAP/BLFS_GID_MAP environment variables. The follow-up commit removes internal filer references that shouldn't be in public docs.

^{Written by Mendral for commit affe4e8.}

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR that start with 'DevinAI' or '@devin'.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
blaxel	🟢 Ready	View Preview	May 28, 2026, 1:04 AM

[devin-ai-integration]

Devin is archived and cannot be woken up. Please unarchive Devin if you want to continue using it.

[Joffref]

DevinAI don't mention filer and the UID/GID on its end, it's more confusing than anything

[mendral-app]

LGTM

No previous comments to address (prior review was LGTM). The new commit cleanly removes internal filer references, leaving the public documentation accurate and consistent.

_{Tag @mendral-app with feedback or questions. View session}

[vikram-blaxel]

@Joffref not sure if you want to merge this now or later but lgtm from my side.

[Joffref]

@vikram-blaxel I believe it hasn't been merge correctly in SDKs. We need to fix auto-gen of the SDK.