docs: smoke-test Visibility wrappers for .md export links

docs/src/changelog.mdx

@@ -90,7 +90,7 @@ description: Updates and improvements to Notte
 
   - Restructured navigation and content
   - Comprehensive SDK reference and guides
-  - [AI tools compatibility](/guides/vibe-coding) for vibe coding
+  - <Visibility for="humans">[AI tools compatibility](/guides/vibe-coding)</Visibility><Visibility for="agents">[AI tools compatibility](/guides/vibe-coding.md)</Visibility> for vibe coding
 </Update>
 
 <Update label="January 23, 2026" tags={["Launches"]}>
@@ -104,11 +104,11 @@ description: Updates and improvements to Notte
 
   We wrapped Launch Week I with five major releases:
 
-  - **[Agent Identities](/concepts/personas)** - Manage personas for your agents
-  - **[Automation Studio](/product/studio)** - Visual automation builder
-  - **[Agent Mode](/product/agent-mode)** - AI-powered browser automation
-  - **[Demonstrate Mode](/product/demonstrate-mode)** - Record and replay workflows
-  - **[Deployed Functions](/concepts/functions)** - Serverless function execution
+  - **<Visibility for="humans">[Agent Identities](/concepts/personas)</Visibility><Visibility for="agents">[Agent Identities](/concepts/personas.md)</Visibility>** - Manage personas for your agents
+  - **<Visibility for="humans">[Automation Studio](/product/studio)</Visibility><Visibility for="agents">[Automation Studio](/product/studio.md)</Visibility>** - Visual automation builder
+  - **<Visibility for="humans">[Agent Mode](/product/agent-mode)</Visibility><Visibility for="agents">[Agent Mode](/product/agent-mode.md)</Visibility>** - AI-powered browser automation
+  - **<Visibility for="humans">[Demonstrate Mode](/product/demonstrate-mode)</Visibility><Visibility for="agents">[Demonstrate Mode](/product/demonstrate-mode.md)</Visibility>** - Record and replay workflows
+  - **<Visibility for="humans">[Deployed Functions](/concepts/functions)</Visibility><Visibility for="agents">[Deployed Functions](/concepts/functions.md)</Visibility>** - Serverless function execution
 
   Read the full recap: https://www.notte.cc/launch-week-i
 </Update>

docs/src/concepts/agents.mdx

@@ -29,7 +29,7 @@ Create and run an agent in a few lines:
 <AgentQuickstart />
 
 <Tip>
-  Agents run within [browser sessions](/concepts/sessions). Use context managers to ensure sessions are automatically stopped when done. This prevents orphaned sessions and unexpected costs.
+  Agents run within <Visibility for="humans">[browser sessions](/concepts/sessions)</Visibility><Visibility for="agents">[browser sessions](/concepts/sessions.md)</Visibility>. Use context managers to ensure sessions are automatically stopped when done. This prevents orphaned sessions and unexpected costs.
 </Tip>
 
 ## How Agents Work
@@ -68,7 +68,7 @@ This cycle repeats until:
 
 ## Agents vs Scripted Automation
 
-Both agents and scripted automation run on [browser sessions](/concepts/sessions)—the cloud browser infrastructure. The difference is how you control what happens in that session.
+Both agents and scripted automation run on <Visibility for="humans">[browser sessions](/concepts/sessions)</Visibility><Visibility for="agents">[browser sessions](/concepts/sessions.md)</Visibility>—the cloud browser infrastructure. The difference is how you control what happens in that session.
 
 | Aspect | Scripted Automation | Agent |
 |--------|---------------------|-------|
@@ -90,29 +90,64 @@ Both agents and scripted automation run on [browser sessions](/concepts/sessions
 - You need intelligent decision-making
 
 <Note>
-  You can combine both approaches: use an agent to figure out a workflow, then [convert it to a function](/features/agents/workflows) for faster, cheaper repeated execution.
+  You can combine both approaches: use an agent to figure out a workflow, then <Visibility for="humans">[convert it to a function](/features/agents/workflows)</Visibility><Visibility for="agents">[convert it to a function](/features/agents/workflows.md)</Visibility> for faster, cheaper repeated execution.
 </Note>
 
 ## Agent Capabilities
 
 Agents come with powerful built-in capabilities:
 
 <CardGroup cols={2}>
-  <Card title="Structured Output" icon="brackets-curly" href="/features/agents/structured-output">
-    Get type-safe responses using Pydantic models
-  </Card>
-  <Card title="Vaults & Personas" icon="lock" href="/concepts/vaults">
-    Use credentials and identities in automations
-  </Card>
-  <Card title="Visual Understanding" icon="eye" href="/features/agents/configuration#use_vision">
-    Analyze images and visual page elements
-  </Card>
-  <Card title="Replay & Debugging" icon="circle-play" href="/features/agents/replay">
-    Debug with MP4 replays of agent execution
-  </Card>
-  <Card title="Agent Fallback" icon="shield" href="/features/agents/fallback">
-    Automatic recovery from script failures
-  </Card>
+  <Visibility for="humans">
+    <Card title="Structured Output" icon="brackets-curly" href="/features/agents/structured-output">
+      Get type-safe responses using Pydantic models
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Structured Output" icon="brackets-curly" href="/features/agents/structured-output.md">
+      Get type-safe responses using Pydantic models
+    </Card>
+  </Visibility>
+  <Visibility for="humans">
+    <Card title="Vaults & Personas" icon="lock" href="/concepts/vaults">
+      Use credentials and identities in automations
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Vaults & Personas" icon="lock" href="/concepts/vaults.md">
+      Use credentials and identities in automations
+    </Card>
+  </Visibility>
+  <Visibility for="humans">
+    <Card title="Visual Understanding" icon="eye" href="/features/agents/configuration#use_vision">
+      Analyze images and visual page elements
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Visual Understanding" icon="eye" href="/features/agents/configuration.md#use_vision">
+      Analyze images and visual page elements
+    </Card>
+  </Visibility>
+  <Visibility for="humans">
+    <Card title="Replay & Debugging" icon="circle-play" href="/features/agents/replay">
+      Debug with MP4 replays of agent execution
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Replay & Debugging" icon="circle-play" href="/features/agents/replay.md">
+      Debug with MP4 replays of agent execution
+    </Card>
+  </Visibility>
+  <Visibility for="humans">
+    <Card title="Agent Fallback" icon="shield" href="/features/agents/fallback">
+      Automatic recovery from script failures
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Agent Fallback" icon="shield" href="/features/agents/fallback.md">
+      Automatic recovery from script failures
+    </Card>
+  </Visibility>
 </CardGroup>
 
 ## Key Concepts
@@ -150,16 +185,44 @@ Agents can fail for various reasons. Always check the result:
 ## Next Steps
 
 <CardGroup cols={2}>
-  <Card title="Agent Lifecycle" icon="rotate" href="/features/agents/lifecycle">
-    Create, manage, and stop agents
-  </Card>
-  <Card title="Agent Configuration" icon="gear" href="/features/agents/configuration">
-    All configuration options
-  </Card>
-  <Card title="Structured Output" icon="brackets-curly" href="/features/agents/structured-output">
-    Get typed responses from agents
-  </Card>
-  <Card title="Convert to Functions" icon="flower" href="/features/agents/workflows">
-    Turn agent runs into reusable code
-  </Card>
+  <Visibility for="humans">
+    <Card title="Agent Lifecycle" icon="rotate" href="/features/agents/lifecycle">
+      Create, manage, and stop agents
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Agent Lifecycle" icon="rotate" href="/features/agents/lifecycle.md">
+      Create, manage, and stop agents
+    </Card>
+  </Visibility>
+  <Visibility for="humans">
+    <Card title="Agent Configuration" icon="gear" href="/features/agents/configuration">
+      All configuration options
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Agent Configuration" icon="gear" href="/features/agents/configuration.md">
+      All configuration options
+    </Card>
+  </Visibility>
+  <Visibility for="humans">
+    <Card title="Structured Output" icon="brackets-curly" href="/features/agents/structured-output">
+      Get typed responses from agents
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Structured Output" icon="brackets-curly" href="/features/agents/structured-output.md">
+      Get typed responses from agents
+    </Card>
+  </Visibility>
+  <Visibility for="humans">
+    <Card title="Convert to Functions" icon="flower" href="/features/agents/workflows">
+      Turn agent runs into reusable code
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Convert to Functions" icon="flower" href="/features/agents/workflows.md">
+      Turn agent runs into reusable code
+    </Card>
+  </Visibility>
 </CardGroup>

docs/src/concepts/file-storage.mdx

@@ -128,19 +128,47 @@ Always check for downloaded files after the session ends:
 ## Next Steps
 
 <CardGroup cols={2}>
-  <Card title="Agents" icon="robot" href="/concepts/agents">
-    Use agents with file operations
-  </Card>
-
-  <Card title="Sessions" icon="browser" href="/concepts/sessions">
-    Learn about browser sessions
-  </Card>
-
-  <Card title="Vaults" icon="lock" href="/concepts/vaults">
-    Store credentials securely
-  </Card>
-
-  <Card title="Personas" icon="user" href="/concepts/personas">
-    Create browser identities
-  </Card>
+  <Visibility for="humans">
+    <Card title="Agents" icon="robot" href="/concepts/agents">
+      Use agents with file operations
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Agents" icon="robot" href="/concepts/agents.md">
+      Use agents with file operations
+    </Card>
+  </Visibility>
+
+  <Visibility for="humans">
+    <Card title="Sessions" icon="browser" href="/concepts/sessions">
+      Learn about browser sessions
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Sessions" icon="browser" href="/concepts/sessions.md">
+      Learn about browser sessions
+    </Card>
+  </Visibility>
+
+  <Visibility for="humans">
+    <Card title="Vaults" icon="lock" href="/concepts/vaults">
+      Store credentials securely
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Vaults" icon="lock" href="/concepts/vaults.md">
+      Store credentials securely
+    </Card>
+  </Visibility>
+
+  <Visibility for="humans">
+    <Card title="Personas" icon="user" href="/concepts/personas">
+      Create browser identities
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Personas" icon="user" href="/concepts/personas.md">
+      Create browser identities
+    </Card>
+  </Visibility>
 </CardGroup>

docs/src/concepts/functions.mdx

@@ -230,19 +230,47 @@ Log important steps for debugging:
 ## Next Steps
 
 <CardGroup cols={2}>
-  <Card title="Creating Functions" icon="file-code" href="/features/functions/creating">
-    Learn how to write and deploy Functions
-  </Card>
-
-  <Card title="Invocations" icon="play" href="/features/functions/invocations">
-    Call Functions via API, SDK, or cURL
-  </Card>
-
-  <Card title="Schedules" icon="clock" href="/features/functions/schedules">
-    Schedule Functions with cron
-  </Card>
-
-  <Card title="Management" icon="sliders" href="/features/functions/management">
-    Update, version, and monitor Functions
-  </Card>
+  <Visibility for="humans">
+    <Card title="Creating Functions" icon="file-code" href="/features/functions/creating">
+      Learn how to write and deploy Functions
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Creating Functions" icon="file-code" href="/features/functions/creating.md">
+      Learn how to write and deploy Functions
+    </Card>
+  </Visibility>
+
+  <Visibility for="humans">
+    <Card title="Invocations" icon="play" href="/features/functions/invocations">
+      Call Functions via API, SDK, or cURL
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Invocations" icon="play" href="/features/functions/invocations.md">
+      Call Functions via API, SDK, or cURL
+    </Card>
+  </Visibility>
+
+  <Visibility for="humans">
+    <Card title="Schedules" icon="clock" href="/features/functions/schedules">
+      Schedule Functions with cron
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Schedules" icon="clock" href="/features/functions/schedules.md">
+      Schedule Functions with cron
+    </Card>
+  </Visibility>
+
+  <Visibility for="humans">
+    <Card title="Management" icon="sliders" href="/features/functions/management">
+      Update, version, and monitor Functions
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Management" icon="sliders" href="/features/functions/management.md">
+      Update, version, and monitor Functions
+    </Card>
+  </Visibility>
 </CardGroup>

docs/src/concepts/scraping.mdx

@@ -179,19 +179,47 @@ Use selectors to focus on relevant content:
 ## Next Steps
 
 <CardGroup cols={2}>
-  <Card title="Browser Sessions" icon="browser" href="/concepts/sessions">
-    Learn about session management
-  </Card>
-
-  <Card title="Browser Agents" icon="robot" href="/concepts/agents">
-    Use AI agents for complex scraping
-  </Card>
-
-  <Card title="Vaults" icon="lock" href="/concepts/vaults">
-    Store credentials for authenticated scraping
-  </Card>
-
-  <Card title="Functions" icon="function" href="/concepts/functions">
-    Deploy scraping as serverless functions
-  </Card>
+  <Visibility for="humans">
+    <Card title="Browser Sessions" icon="browser" href="/concepts/sessions">
+      Learn about session management
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Browser Sessions" icon="browser" href="/concepts/sessions.md">
+      Learn about session management
+    </Card>
+  </Visibility>
+
+  <Visibility for="humans">
+    <Card title="Browser Agents" icon="robot" href="/concepts/agents">
+      Use AI agents for complex scraping
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Browser Agents" icon="robot" href="/concepts/agents.md">
+      Use AI agents for complex scraping
+    </Card>
+  </Visibility>
+
+  <Visibility for="humans">
+    <Card title="Vaults" icon="lock" href="/concepts/vaults">
+      Store credentials for authenticated scraping
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Vaults" icon="lock" href="/concepts/vaults.md">
+      Store credentials for authenticated scraping
+    </Card>
+  </Visibility>
+
+  <Visibility for="humans">
+    <Card title="Functions" icon="function" href="/concepts/functions">
+      Deploy scraping as serverless functions
+    </Card>
+  </Visibility>
+  <Visibility for="agents">
+    <Card title="Functions" icon="function" href="/concepts/functions.md">
+      Deploy scraping as serverless functions
+    </Card>
+  </Visibility>
 </CardGroup>