agentuity · afterrburn · Jul 31, 2025 · Jul 16, 2025 · Jul 16, 2025 · Jul 16, 2025
diff --git a/agent-docs/package.json b/agent-docs/package.json
@@ -34,5 +34,10 @@
     "langchain": "^0.3.28",
     "vitest": "^3.2.3"
   },
+  "overrides": {
+    "gray-matter": {
+      "js-yaml": "^3.14.1"
+    }
+  },
   "module": "index.ts"
-}
+}
diff --git a/app/(docs)/layout.tsx b/app/(docs)/layout.tsx
@@ -3,6 +3,7 @@ import { source } from "@/lib/source";
 import { DocsLayout } from "fumadocs-ui/layouts/notebook";
 import { LargeSearchToggle } from 'fumadocs-ui/components/layout/search-toggle';
 import AISearchToggle from "../../components/AISearchToggle";
+import CopyPageDropdown from "../../components/CopyPageDropdown";
 import type { ReactNode } from "react";
 
 export default function Layout({ children }: { children: ReactNode }) {
@@ -12,12 +13,13 @@ export default function Layout({ children }: { children: ReactNode }) {
 			tree={source.pageTree}
 			searchToggle={{
 				components: {
-					lg: (
-						<div className="flex gap-1.5 max-md:hidden">
-							<LargeSearchToggle className="flex-1" />
-							<AISearchToggle />
-						</div>
-					),
+				lg: (
+					<div className="flex gap-1.5 max-md:hidden">
+						<LargeSearchToggle className="flex-1" />
+						<AISearchToggle />
+						<CopyPageDropdown />
+					</div>
+				),
 				},
 			}}
 		>

diff --git a/app/api/page-content/route.ts b/app/api/page-content/route.ts
@@ -0,0 +1,47 @@
+import { NextRequest } from 'next/server';
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import matter from 'gray-matter';
+
+export async function GET(request: NextRequest) {
+  try {
+    const { searchParams } = new URL(request.url);
+    const path = searchParams.get('path');
+
+    if (!path) {
+      return new Response('Path parameter required', { status: 400 });
+    }
+
+    if (path.includes('..') || path.includes('\\') || path.startsWith('/')) {
+      return new Response('Invalid path parameter', { status: 400 });
+    }
+
+    const basePath = join(process.cwd(), 'content');
+    const indexPath = join(basePath, path, 'index.mdx');
+    const directPath = join(basePath, `${path}.mdx`);
+
+    let fileContent: string;
+
+    try {
+      fileContent = await readFile(indexPath, 'utf-8');
+    } catch {
+      try {
+        fileContent = await readFile(directPath, 'utf-8');
+      } catch {
+        return new Response('Page not found', { status: 404 });
+      }
+    }
+
+    const { content, data } = matter(fileContent);
+
+    return Response.json({
+      content,
+      title: data.title || '',
+      description: data.description || '',
+      path
+    });
+  } catch (error) {
+    console.error('Error reading page content:', error);
+    return new Response('Failed to read page content', { status: 500 });
+  }
+}
diff --git a/app/layout.tsx b/app/layout.tsx
@@ -7,7 +7,10 @@ import "./global.css";
 
 // Validate environment variables at startup (server-side only)
 if (typeof window === 'undefined') {
-	validateEnv();
+	const isValid = validateEnv();
+	if (!isValid) {
+		console.warn('Environment validation failed during build – this is expected at build time');
+	}
 }
 
 export const metadata: Metadata = {
@@ -88,7 +91,7 @@ export default function Layout({ children }: { children: ReactNode }) {
 	return (
 		<html lang="en" className={GeistSans.className} suppressHydrationWarning>
 			<body className="flex flex-col min-h-screen antialiased">
-				<RootProvider 
+				<RootProvider
 					theme={{ enabled: true, enableSystem: true }}
 				>
 					{children}

diff --git a/components/CopyPageDropdown.tsx b/components/CopyPageDropdown.tsx
@@ -0,0 +1,139 @@
+'use client';
+
+import React, { useState } from 'react';
+import { usePathname } from 'next/navigation';
+import { Copy, ExternalLink, FileText, MessageSquare } from 'lucide-react';
+import * as Popover from '@radix-ui/react-popover';
+
+interface PageContent {
+  content: string;
+  title: string;
+  description: string;
+  path: string;
+}
+
+export default function CopyPageDropdown() {
+  const [isOpen, setIsOpen] = useState(false);
+  const [isLoading, setIsLoading] = useState(false);
+  const pathname = usePathname();
+
+  const formatMarkdownForLLM = (content: PageContent): string => {
+    return `# ${content.title}\n\n${content.description ? `${content.description}\n\n` : ''}${content.content}`;
+  };
+
+  const fetchPageContent = async (): Promise<PageContent | null> => {
+    try {
+      setIsLoading(true);
+      const contentPath = pathname.startsWith('/') ? pathname.slice(1) : pathname;
+
+      const response = await fetch(`/api/page-content?path=${encodeURIComponent(contentPath)}`);
+      if (!response.ok) throw new Error('Failed to fetch content');
+
+      return await response.json();
+    } catch (error) {
+      console.error('Error fetching page content:', error);
+      return null;
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  const handleCopyMarkdown = async () => {
+    const content = await fetchPageContent();
+    if (!content) return;
+
+    const markdownForLLM = formatMarkdownForLLM(content);
+
+    try {
+      await navigator.clipboard.writeText(markdownForLLM);
+    } catch (error) {
+      console.error('Failed to copy to clipboard:', error);
+    }
+    setIsOpen(false);
+  };
+
+  const handleViewMarkdown = async () => {
+    const content = await fetchPageContent();
+    if (!content) return;
+
+    const markdownForLLM = formatMarkdownForLLM(content);
+    const blob = new Blob([markdownForLLM], { type: 'text/markdown' });
+    const url = URL.createObjectURL(blob);
+    window.open(url, '_blank');
+    setTimeout(() => URL.revokeObjectURL(url), 100);
+    setIsOpen(false);
+  };
+
+  const handleOpenInChatGPT = async () => {
+    const content = await fetchPageContent();
+    if (!content) return;
+
+    const markdownForLLM = formatMarkdownForLLM(content);
+    const chatGPTUrl = `https://chatgpt.com/?q=${encodeURIComponent(`Please help me understand this documentation:\n\n${markdownForLLM}`)}`;
+    window.open(chatGPTUrl, '_blank');
+    setIsOpen(false);
+  };
+
+  const handleOpenInClaude = async () => {
+    const content = await fetchPageContent();
+    if (!content) return;
+
+    const markdownForLLM = formatMarkdownForLLM(content);
+    const claudeUrl = `https://claude.ai/new?q=${encodeURIComponent(`Please help me understand this documentation:\n\n${markdownForLLM}`)}`;
+    window.open(claudeUrl, '_blank');
+    setIsOpen(false);
+  };
+
+  return (
+    <Popover.Root open={isOpen} onOpenChange={setIsOpen}>
+      <Popover.Trigger asChild>
+        <button 
+          aria-label="Copy page options"
+          className="flex items-center justify-center transition-all duration-200 hover:scale-110 active:scale-95 transform-origin-center border border-gray-200 dark:border-cyan-900 rounded-md size-10 hover:border-cyan-300 dark:hover:border-cyan-600"
+        >
+          <Copy className="size-4 text-cyan-700 dark:text-cyan-500" />
+        </button>
+      </Popover.Trigger>
+      <Popover.Content 
+        className="w-64 p-2 bg-white dark:bg-gray-800 border border-gray-200 dark:border-gray-700 rounded-md shadow-lg z-50"
+        align="end"
+        sideOffset={8}
+      >
+        <div className="flex flex-col gap-1">
+          <button 
+            onClick={handleCopyMarkdown} 
+            disabled={isLoading}
+            className="flex items-center gap-2 w-full p-2 text-sm hover:bg-gray-100 dark:hover:bg-gray-700 rounded text-left disabled:opacity-50"
+          >
+            <Copy className="size-4" />
+            Copy as Markdown for LLMs
+          </button>
+          <button 
+            onClick={handleViewMarkdown} 
+            disabled={isLoading}
+            className="flex items-center gap-2 w-full p-2 text-sm hover:bg-gray-100 dark:hover:bg-gray-700 rounded text-left disabled:opacity-50"
+          >
+            <FileText className="size-4" />
+            View as Markdown
+          </button>
+          <button 
+            onClick={handleOpenInChatGPT} 
+            disabled={isLoading}
+            className="flex items-center gap-2 w-full p-2 text-sm hover:bg-gray-100 dark:hover:bg-gray-700 rounded text-left disabled:opacity-50"
+          >
+            <MessageSquare className="size-4" />
+            Open in ChatGPT
+          </button>
+          <button 
+            onClick={handleOpenInClaude} 
+            disabled={isLoading}
+            className="flex items-center gap-2 w-full p-2 text-sm hover:bg-gray-100 dark:hover:bg-gray-700 rounded text-left disabled:opacity-50"
+          >
+            <ExternalLink className="size-4" />
+            Open in Claude
+          </button>
+        </div>
+      </Popover.Content>
+    </Popover.Root>
+  );
+}