fix(shell-docs): resolve 53 sitemap 500s before cutover

The 53 hard-500 URLs in the public sitemap split into three independent
root causes, all surfaced in production-mode rendering only because the
underlying issues throw inside next-mdx-remote:

1. tutorials/ai-powered-textarea/step-2-setup-copilotkit and
   tutorials/ai-todo-app/step-2-setup-copilotkit reference
   <CopilotCloudConfigureCopilotKit>,
   <SelfHostingCopilotRuntimeConfigureCopilotKit>, and
   crewai-flows/quickstart references <CloudCopilotKit> — three
   unsuffixed component names whose only registered counterparts in
   docsComponents end in "Provider". MDX rendering throws "Expected
   component X to be defined" and 500s. Adds the unsuffixed names as
   aliases of the existing Provider stubs in mdx-registry.

   deploy-agentcore (langgraph variants + aws-strands) uses
   <Content framework="..." />, also unregistered. Adds Content as a
   children-passthrough stub for the same reason.

2. Three langgraph tutorial pages (agent-native-app/step-6-shared-state,
   ai-travel-app/step-3-setup-copilotkit,
   ai-travel-app/step-4-integrate-the-agent) place a closing </Step>
   tag immediately under a markdown bullet list with no blank line
   separator. The remark parser treats the closing tag as a list-item
   continuation, errors out with "Expected the closing tag </Step>",
   and ships a 500. Adds the missing blank line before the close tag.

3. Five MDX files (llamaindex + adk shared-state/predictive-state-updates,
   pydantic-ai shared-state/in-app-agent-write, plus crewai-flows and
   pydantic-ai human-in-the-loop/index — last two not in the 53 but
   share the bug) use {/\\* ... \\*/} where the asterisks are escaped.
   Acorn cannot parse the resulting expression and the page 500s.
   Replaces the escapes with proper {/* ... */} JSX comments.

Verified: a clean production build of shell-docs followed by
`npx next start` and a curl probe of all 53 URLs from
validation/test2_results.json returns 200 across the full set with
zero MDX or React errors in the server log.

Author: samjulien

showcase/shell-docs/src/content/docs/integrations/adk/shared-state/predictive-state-updates.mdx

@@ -5,7 +5,7 @@ description: Stream in-progress agent state updates to the frontend.
 ---
 
 {/* TODO: Re-add once the dojo example is updated and works */}
-{/\* <IframeSwitcher
+{/* <IframeSwitcher
   id="predictive-state-updates-example"
   exampleUrl="https://feature-viewer.copilotkit.ai/adk-middleware/feature/predictive_state_updates?sidebar=false&chatDefaultOpen=false"
   codeUrl="https://feature-viewer.copilotkit.ai/adk-middleware/feature/predictive_state_updates?view=code&sidebar=false&codeLayout=tabs"

showcase/shell-docs/src/content/docs/integrations/crewai-flows/human-in-the-loop/index.mdx

@@ -15,7 +15,7 @@ description: Allow your agent and users to collaborate on complex tasks.
 />
 
 {/* TODO-DOCS-CREWAI-FLOWS: Add Travel App Example */}
-{/\* <Callout>
+{/* <Callout>
 This video shows an example of our [AI Travel App](/langgraph/tutorials/ai-travel-app) using HITL to get user feedback.
 
 </Callout> */}

showcase/shell-docs/src/content/docs/integrations/langgraph/tutorials/agent-native-app/step-6-shared-state.mdx

@@ -118,7 +118,8 @@ In this example, we use the `useCoAgent` hook to wire up the application's state
 - For the generic type, we pass the `AgentState` type that was already defined for the application in `@/lib/types.ts`.
 - For the `name` parameter, we pass the name of the graph as defined in `agent/langgraph.json`.
 - For the `initialState` parameter, we pass the initial state of the LangGraph agent which is already defined in `@/lib/trips.ts`.
-    </Step>
+
+</Step>
 </Steps>
 
 ## Recap

showcase/shell-docs/src/content/docs/integrations/langgraph/tutorials/ai-travel-app/step-3-setup-copilotkit.mdx

@@ -137,7 +137,8 @@ And we're done! Here's what we did:
 - We setup our Copilot cloud account and got an API key.
 - We configured the CopilotKit provider in our application to use our API key.
 - We added the CopilotSidebar to our application.
-  </Step>
+
+</Step>
 
 </Step>
 </Steps>
@@ -215,7 +216,8 @@ Here's what we did:
 - We imported the `<CopilotSidebar />` component from `@copilotkit/react-ui`.
 - We wrapped the page with the `<CopilotKit>` provider.
 - We imported the built-in styles from `@copilotkit/react-ui`.
-    </TailoredContentOption>
+
+</TailoredContentOption>
 </TailoredContent>
 
 Now, head back to the app and you'll find a chat sidebar on the left side of the page. At this point, you can start interacting with your copilot! 🎉

showcase/shell-docs/src/content/docs/integrations/langgraph/tutorials/ai-travel-app/step-4-integrate-the-agent.mdx

@@ -168,7 +168,8 @@ In this example, we use the `useCoAgent` hook to wire up the application's state
 - For the generic type, we pass the `AgentState` type that was already defined for the application in `@/lib/types.ts`.
 - For the `name` parameter, we pass the name of the graph as defined in `agent/langgraph.json`.
 - For the `initialState` parameter, we pass the initial state of the LangGraph agent which is already defined in `@/lib/trips.ts`.
-    </Step>
+
+</Step>
 </Steps>
 
 ## Try it out!

showcase/shell-docs/src/content/docs/integrations/llamaindex/shared-state/predictive-state-updates.mdx

@@ -5,7 +5,7 @@ description: Stream in-progress agent state updates to the frontend.
 ---
 
 {/* TODO: Re-add once the dojo example is updated and works */}
-{/\* <IframeSwitcher
+{/* <IframeSwitcher
   id="predictive-state-updates-example"
   exampleUrl="https://feature-viewer.copilotkit.ai/llama-index/feature/predictive_state_updates?sidebar=false&chatDefaultOpen=false"
   codeUrl="https://feature-viewer.copilotkit.ai/llama-index/feature/predictive_state_updates?view=code&sidebar=false&codeLayout=tabs"

showcase/shell-docs/src/content/docs/integrations/pydantic-ai/human-in-the-loop/index.mdx

@@ -15,7 +15,7 @@ description: Allow your agent and users to collaborate on complex tasks.
 />
 
 {/* TODO: Add Example */}
-{/\* <Callout>
+{/* <Callout>
 This video shows an example of our [AI Travel App](/langgraph/tutorials/ai-travel-app) using HITL to get user feedback.
 
 </Callout> */}

showcase/shell-docs/src/content/docs/integrations/pydantic-ai/shared-state/in-app-agent-write.mdx

@@ -179,6 +179,6 @@ function YourMainContent() {
 By default, the Pydantic AI Agent state will only update _between_ Pydantic AI Agent node transitions --
 which means state updates will be discontinuous and delayed.
 
-{/\* You likely want to render the agent state as it updates **continuously.**
+{/* You likely want to render the agent state as it updates **continuously.**
 
-See **[emit intermediate state](/pydantic-ai/shared-state/predictive-state-updates).** \*/}
+See **[emit intermediate state](/pydantic-ai/shared-state/predictive-state-updates).** */}

showcase/shell-docs/src/lib/mdx-registry.tsx

@@ -350,6 +350,13 @@ export const docsComponents = {
   SharedContent: ({ children }: { children: React.ReactNode }) => (
     <div>{children}</div>
   ),
+  // <Content framework="..." /> is used by orphaned `deploy-agentcore`
+  // pages (langgraph/* + aws-strands) as a placeholder for content
+  // that was never authored. Without a registered shim, MDX rendering
+  // throws and ships a 500 in the public sitemap.
+  Content: ({ children }: { children?: React.ReactNode }) => (
+    <div>{children}</div>
+  ),
   IframeSwitcher: RealIframeSwitcher,
   IframeSwitcherGroup: ({ children }: { children: React.ReactNode }) => (
     <div>{children}</div>
@@ -691,6 +698,15 @@ export const docsComponents = {
   }: {
     children?: React.ReactNode;
   }) => <div>{children}</div>,
+  // Alias of CopilotCloudConfigureCopilotKitProvider — historical
+  // spelling without the `Provider` suffix appears in tutorials
+  // (`ai-powered-textarea/step-2`, `ai-todo-app/step-2`). Keeping both
+  // keys so existing MDX renders without throwing.
+  CopilotCloudConfigureCopilotKit: ({
+    children,
+  }: {
+    children?: React.ReactNode;
+  }) => <div>{children}</div>,
   GenerativeUISpecsOverview: ({ children }: { children?: React.ReactNode }) => (
     <div>{children}</div>
   ),
@@ -876,6 +892,13 @@ export const docsComponents = {
   CloudCopilotKitProvider: ({ children }: { children?: React.ReactNode }) => (
     <div>{children}</div>
   ),
+  // Alias of CloudCopilotKitProvider — `crewai-flows/quickstart` and
+  // other historical MDX use the unsuffixed spelling. Without this,
+  // MDX rendering throws "Expected component CloudCopilotKit to be
+  // defined" at runtime → 500 in production.
+  CloudCopilotKit: ({ children }: { children?: React.ReactNode }) => (
+    <div>{children}</div>
+  ),
   SelfHostingCopilotRuntimeCreateEndpoint: ({
     children,
   }: {
@@ -886,6 +909,13 @@ export const docsComponents = {
   }: {
     children?: React.ReactNode;
   }) => <div>{children}</div>,
+  // Alias of SelfHostingCopilotRuntimeConfigureCopilotKitProvider —
+  // `ai-todo-app/step-2-setup-copilotkit` uses the unsuffixed name.
+  SelfHostingCopilotRuntimeConfigureCopilotKit: ({
+    children,
+  }: {
+    children?: React.ReactNode;
+  }) => <div>{children}</div>,
   AgentState: ({ children }: { children?: React.ReactNode }) => (
     <div>{children}</div>
   ),