@promptbook/cli 0.104.0-0 → 0.104.0-10

package/apps/agents-server/src/app/docs/page.tsx

@@ -1,20 +1,20 @@
+import { MarkdownContent } from '@promptbook-local/components';
 import Link from 'next/link';
+import { DocsToolbar } from '../../components/DocsToolbar/DocsToolbar';
+import { DocumentationContent } from '../../components/DocumentationContent/DocumentationContent';
 import { Card } from '../../components/Homepage/Card';
 import { Section } from '../../components/Homepage/Section';
 import { OpenMojiIcon } from '../../components/OpenMojiIcon/OpenMojiIcon';
-import { getVisibleCommitmentDefinitions } from '../../utils/getVisibleCommitmentDefinitions';
-import { PrintButton } from '../../components/PrintButton/PrintButton';
 import { PrintHeader } from '../../components/PrintHeader/PrintHeader';
-import { DocumentationContent } from '../../components/DocumentationContent/DocumentationContent';
+import { getVisibleCommitmentDefinitions } from '../../utils/getVisibleCommitmentDefinitions';
 
 export default function DocsPage() {
     const groupedCommitments = getVisibleCommitmentDefinitions();
 
     return (
         <div className="min-h-screen bg-gradient-to-br from-blue-50 via-white to-purple-50">
-            <PrintButton />
-            
             <div className="container mx-auto px-4 py-16">
+                <DocsToolbar />
                 <PrintHeader title="Full Documentation" />
 
                 {/* Screen view: Cards */}
@@ -24,7 +24,7 @@ export default function DocsPage() {
                             <Link key={primary.type} href={`/docs/${primary.type}`} className="block h-full group">
                                 <Card className="h-full group-hover:border-blue-500 transition-colors">
                                     <h3 className="text-xl font-semibold mb-2 group-hover:text-blue-600 transition-colors">
-                                        <OpenMojiIcon icon={primary.icon} className="mr-2" />
+                                        <OpenMojiIcon icon={primary.icon} variant="color" className="mr-2" />
                                         {primary.type}
                                         {aliases.length > 0 && (
                                             <span className="text-gray-400 font-normal text-lg">
@@ -33,7 +33,11 @@ export default function DocsPage() {
                                             </span>
                                         )}
                                     </h3>
-                                    {primary.description && <p className="text-gray-600 line-clamp-3">{primary.description}</p>}
+                                    {primary.description && (
+                                        <p className="text-gray-600 line-clamp-3">
+                                            <MarkdownContent content={primary.description} />
+                                        </p>
+                                    )}
                                 </Card>
                             </Link>
                         ))}
@@ -44,11 +48,7 @@ export default function DocsPage() {
                 <div className="hidden print:block space-y-12">
                     {groupedCommitments.map(({ primary, aliases }) => (
                         <div key={primary.type} className="break-inside-avoid page-break-after-always">
-                            <DocumentationContent 
-                                primary={primary} 
-                                aliases={aliases} 
-                                isPrintOnly={true} 
-                            />
+                            <DocumentationContent primary={primary} aliases={aliases} isPrintOnly={true} />
                             <hr className="my-8 border-gray-200" />
                         </div>
                     ))}

package/apps/agents-server/src/app/embed/layout.tsx

@@ -0,0 +1,31 @@
+import type { Metadata } from 'next';
+
+export const metadata: Metadata = {
+    title: 'Promptbook Agent Embed',
+    description: 'Embedded agent chat widget',
+};
+
+/**
+ * Minimal layout for the embed page - no header, footer, or other UI elements
+ * This layout is completely transparent and only renders the chat widget
+ */
+export default function EmbedLayout({
+    children,
+}: Readonly<{
+    children: React.ReactNode;
+}>) {
+    return (
+        <html lang="en">
+            <body
+                style={{
+                    margin: 0,
+                    padding: 0,
+                    background: 'transparent',
+                    overflow: 'hidden',
+                }}
+            >
+                {children}
+            </body>
+        </html>
+    );
+}

package/apps/agents-server/src/app/embed/page.tsx

@@ -2,23 +2,36 @@
 
 import { PromptbookAgentIntegration } from '@promptbook-local/components';
 import { useSearchParams } from 'next/navigation';
+import { useMemo } from 'react';
 
 export default function EmbedPage() {
     const searchParams = useSearchParams();
     const agentUrl = searchParams.get('agentUrl');
+    const metaParam = searchParams.get('meta');
+
+    const meta = useMemo(() => {
+        if (!metaParam) {
+            return undefined;
+        }
+        try {
+            return JSON.parse(metaParam);
+        } catch (e) {
+            console.error('[🔌] Failed to parse meta parameter:', e);
+            return undefined;
+        }
+    }, [metaParam]);
 
     if (!agentUrl) {
-        return <div className="text-red-500">Missing agentUrl parameter</div>;
+        return <div style={{ color: 'red' }}>Missing agentUrl parameter</div>;
     }
 
     return (
-        <div className="w-full h-full bg-transparent">
-            <PromptbookAgentIntegration
-                agentUrl={agentUrl}
-                onOpenChange={(isOpen) => {
-                    window.parent.postMessage({ type: 'PROMPTBOOK_AGENT_RESIZE', isOpen }, '*');
-                }}
-            />
-        </div>
+        <PromptbookAgentIntegration
+            agentUrl={agentUrl}
+            meta={meta}
+            onOpenChange={(isOpen) => {
+                window.parent.postMessage({ type: 'PROMPTBOOK_AGENT_RESIZE', isOpen }, '*');
+            }}
+        />
     );
 }

package/apps/agents-server/src/app/globals.css

@@ -5,35 +5,67 @@
 /**
  * OpenMoji black and white CSS
  *
- * https://github.com/hfg-gmuend/openmoji/blob/master/font/OpenMoji-black-glyf/openmoji.css
+ * https://github.com/hfg-gmuend/openmoji/blob/master/font/OpenMoji-black-glyf
  */
 @font-face {
     font-family: 'OpenMojiBlack';
     src: url('/fonts/OpenMoji-black-glyf.woff2') format('woff2');
-    unicode-range: U+23, U+2A, U+2D, U+30-39, U+A9, U+AE, U+200D, U+203C, U+2049, U+20E3, U+2117, U+2120, U+2122,
-        U+2139, U+2194-2199, U+21A9, U+21AA, U+229C, U+231A, U+231B, U+2328, U+23CF, U+23E9-23F3, U+23F8-23FE, U+24C2,
-        U+25A1, U+25AA-25AE, U+25B6, U+25C0, U+25C9, U+25D0, U+25D1, U+25E7-25EA, U+25ED, U+25EE, U+25FB-25FE,
-        U+2600-2605, U+260E, U+2611, U+2614, U+2615, U+2618, U+261D, U+2620, U+2622, U+2623, U+2626, U+262A, U+262E,
-        U+262F, U+2638-263A, U+2640, U+2642, U+2648-2653, U+265F, U+2660, U+2663, U+2665, U+2666, U+2668, U+267B,
-        U+267E, U+267F, U+2691-2697, U+2699, U+269B, U+269C, U+26A0, U+26A1, U+26A7, U+26AA, U+26AB, U+26B0, U+26B1,
-        U+26BD, U+26BE, U+26C4, U+26C5, U+26C8, U+26CE, U+26CF, U+26D1, U+26D3, U+26D4, U+26E9, U+26EA, U+26F0-26F5,
-        U+26F7-26FA, U+26FD, U+2702, U+2705, U+2708-270D, U+270F, U+2712, U+2714, U+2716, U+271D, U+2721, U+2728,
-        U+2733, U+2734, U+2744, U+2747, U+274C, U+274E, U+2753-2755, U+2757, U+2763, U+2764, U+2795-2797, U+27A1,
-        U+27B0, U+27BF, U+2934, U+2935, U+2B05-2B07, U+2B0C, U+2B0D, U+2B1B, U+2B1C, U+2B1F-2B24, U+2B2E, U+2B2F,
-        U+2B50, U+2B55, U+2B58, U+2B8F, U+2BBA-2BBC, U+2BC3, U+2BC4, U+2BEA, U+2BEB, U+3030, U+303D, U+3297, U+3299,
-        U+E000-E009, U+E010, U+E011, U+E040-E06D, U+E080-E0B4, U+E0C0-E0CC, U+E0FF-E10D, U+E140-E14A, U+E150-E157,
-        U+E181-E189, U+E1C0-E1C4, U+E1C6-E1D9, U+E200-E216, U+E240-E269, U+E280-E283, U+E2C0-E2C4, U+E2C6-E2DA,
-        U+E300-E303, U+E305-E30F, U+E312-E316, U+E318-E322, U+E324-E329, U+E32B, U+E340-E348, U+E380, U+E381, U+F000,
-        U+F77A, U+F8FF, U+FE0F, U+1F004, U+1F0CF, U+1F10D-1F10F, U+1F12F, U+1F16D-1F171, U+1F17E, U+1F17F, U+1F18E,
-        U+1F191-1F19A, U+1F1E6-1F1FF, U+1F201, U+1F202, U+1F21A, U+1F22F, U+1F232-1F23A, U+1F250, U+1F251,
-        U+1F260-1F265, U+1F300-1F321, U+1F324-1F393, U+1F396, U+1F397, U+1F399-1F39B, U+1F39E-1F3F0, U+1F3F3-1F3F5,
-        U+1F3F7-1F4FD, U+1F4FF-1F53D, U+1F549-1F54E, U+1F550-1F567, U+1F56F, U+1F570, U+1F573-1F57A, U+1F587,
-        U+1F58A-1F58D, U+1F590, U+1F595, U+1F596, U+1F5A4, U+1F5A5, U+1F5A8, U+1F5B1, U+1F5B2, U+1F5BC, U+1F5C2-1F5C4,
-        U+1F5D1-1F5D3, U+1F5DC-1F5DE, U+1F5E1, U+1F5E3, U+1F5E8, U+1F5EF, U+1F5F3, U+1F5FA-1F64F, U+1F680-1F6C5,
-        U+1F6CB-1F6D2, U+1F6D5-1F6D7, U+1F6DC-1F6E5, U+1F6E9, U+1F6EB, U+1F6EC, U+1F6F0, U+1F6F3-1F6FC, U+1F7E0-1F7EB,
-        U+1F7F0, U+1F90C-1F93A, U+1F93C-1F945, U+1F947-1F9FF, U+1FA70-1FA7C, U+1FA80-1FA88, U+1FA90-1FABD,
-        U+1FABF-1FAC5, U+1FACE-1FADB, U+1FAE0-1FAE8, U+1FAF0-1FAF8, U+1FBC5-1FBC9, U+E0061-E0067, U+E0069,
-        U+E006C-E0079, U+E007F;
+    unicode-range: U+23, U+2A, U+2D, U+30-39, U+A9, U+AE, U+200D, U+203C, U+2049, U+20E3, U+2117, U+2120, U+2122, U+2139,
+        U+2194-2199, U+21A9, U+21AA, U+229C, U+231A, U+231B, U+2328, U+23CF, U+23E9-23F3, U+23F8-23FE, U+24C2, U+25A1,
+        U+25AA-25AE, U+25B6, U+25C0, U+25C9, U+25D0, U+25D1, U+25E7-25EA, U+25ED, U+25EE, U+25FB-25FE, U+2600-2605,
+        U+260E, U+2611, U+2614, U+2615, U+2618, U+261D, U+2620, U+2622, U+2623, U+2626, U+262A, U+262E, U+262F,
+        U+2638-263A, U+2640, U+2642, U+2648-2653, U+265F, U+2660, U+2663, U+2665, U+2666, U+2668, U+267B, U+267E, U+267F,
+        U+2691-2697, U+2699, U+269B, U+269C, U+26A0, U+26A1, U+26A7, U+26AA, U+26AB, U+26B0, U+26B1, U+26BD, U+26BE,
+        U+26C4, U+26C5, U+26C8, U+26CE, U+26CF, U+26D1, U+26D3, U+26D4, U+26E9, U+26EA, U+26F0-26F5, U+26F7-26FA, U+26FD,
+        U+2702, U+2705, U+2708-270D, U+270F, U+2712, U+2714, U+2716, U+271D, U+2721, U+2728, U+2733, U+2734, U+2744,
+        U+2747, U+274C, U+274E, U+2753-2755, U+2757, U+2763, U+2764, U+2795-2797, U+27A1, U+27B0, U+27BF, U+2934, U+2935,
+        U+2B05-2B07, U+2B0C, U+2B0D, U+2B1B, U+2B1C, U+2B1F-2B24, U+2B2E, U+2B2F, U+2B50, U+2B55, U+2B58, U+2B8F,
+        U+2BBA-2BBC, U+2BC3, U+2BC4, U+2BEA, U+2BEB, U+3030, U+303D, U+3297, U+3299, U+E000-E009, U+E010, U+E011,
+        U+E040-E06D, U+E080-E0B4, U+E0C0-E0CC, U+E0FF-E10D, U+E140-E14A, U+E150-E157, U+E181-E189, U+E1C0-E1C4,
+        U+E1C6-E1D9, U+E200-E216, U+E240-E269, U+E280-E283, U+E2C0-E2C4, U+E2C6-E2DA, U+E300-E303, U+E305-E30F,
+        U+E312-E316, U+E318-E322, U+E324-E329, U+E32B, U+E340-E348, U+E380, U+E381, U+F000, U+F77A, U+F8FF, U+FE0F,
+        U+1F004, U+1F0CF, U+1F10D-1F10F, U+1F12F, U+1F16D-1F171, U+1F17E, U+1F17F, U+1F18E, U+1F191-1F19A, U+1F1E6-1F1FF,
+        U+1F201, U+1F202, U+1F21A, U+1F22F, U+1F232-1F23A, U+1F250, U+1F251, U+1F260-1F265, U+1F300-1F321, U+1F324-1F393,
+        U+1F396, U+1F397, U+1F399-1F39B, U+1F39E-1F3F0, U+1F3F3-1F3F5, U+1F3F7-1F4FD, U+1F4FF-1F53D, U+1F549-1F54E,
+        U+1F550-1F567, U+1F56F, U+1F570, U+1F573-1F57A, U+1F587, U+1F58A-1F58D, U+1F590, U+1F595, U+1F596, U+1F5A4,
+        U+1F5A5, U+1F5A8, U+1F5B1, U+1F5B2, U+1F5BC, U+1F5C2-1F5C4, U+1F5D1-1F5D3, U+1F5DC-1F5DE, U+1F5E1, U+1F5E3,
+        U+1F5E8, U+1F5EF, U+1F5F3, U+1F5FA-1F64F, U+1F680-1F6C5, U+1F6CB-1F6D2, U+1F6D5-1F6D7, U+1F6DC-1F6E5, U+1F6E9,
+        U+1F6EB, U+1F6EC, U+1F6F0, U+1F6F3-1F6FC, U+1F7E0-1F7EB, U+1F7F0, U+1F90C-1F93A, U+1F93C-1F945, U+1F947-1F9FF,
+        U+1FA70-1FA7C, U+1FA80-1FA88, U+1FA90-1FABD, U+1FABF-1FAC5, U+1FACE-1FADB, U+1FAE0-1FAE8, U+1FAF0-1FAF8,
+        U+1FBC5-1FBC9, U+E0061-E0067, U+E0069, U+E006C-E0079, U+E007F;
+}
+
+/**
+ * OpenMoji color CSS
+ *
+ * https://github.com/hfg-gmuend/openmoji/tree/master/font/OpenMoji-color-cbdt
+ */
+@font-face {
+    font-family: 'OpenMojiColor';
+    src: url('/fonts/OpenMoji-color-cbdt.woff2') format('woff2');
+    unicode-range: U+23, U+2A, U+2D, U+30-39, U+A9, U+AE, U+200D, U+203C, U+2049, U+20E3, U+2117, U+2120, U+2122, U+2139,
+        U+2194-2199, U+21A9, U+21AA, U+229C, U+231A, U+231B, U+2328, U+23CF, U+23E9-23F3, U+23F8-23FE, U+24C2, U+25A1,
+        U+25AA-25AE, U+25B6, U+25C0, U+25C9, U+25D0, U+25D1, U+25E7-25EA, U+25ED, U+25EE, U+25FB-25FE, U+2600-2605,
+        U+260E, U+2611, U+2614, U+2615, U+2618, U+261D, U+2620, U+2622, U+2623, U+2626, U+262A, U+262E, U+262F,
+        U+2638-263A, U+2640, U+2642, U+2648-2653, U+265F, U+2660, U+2663, U+2665, U+2666, U+2668, U+267B, U+267E, U+267F,
+        U+2691-2697, U+2699, U+269B, U+269C, U+26A0, U+26A1, U+26A7, U+26AA, U+26AB, U+26B0, U+26B1, U+26BD, U+26BE,
+        U+26C4, U+26C5, U+26C8, U+26CE, U+26CF, U+26D1, U+26D3, U+26D4, U+26E9, U+26EA, U+26F0-26F5, U+26F7-26FA, U+26FD,
+        U+2702, U+2705, U+2708-270D, U+270F, U+2712, U+2714, U+2716, U+271D, U+2721, U+2728, U+2733, U+2734, U+2744,
+        U+2747, U+274C, U+274E, U+2753-2755, U+2757, U+2763, U+2764, U+2795-2797, U+27A1, U+27B0, U+27BF, U+2934, U+2935,
+        U+2B05-2B07, U+2B0C, U+2B0D, U+2B1B, U+2B1C, U+2B1F-2B24, U+2B2E, U+2B2F, U+2B50, U+2B55, U+2B58, U+2B8F,
+        U+2BBA-2BBC, U+2BC3, U+2BC4, U+2BEA, U+2BEB, U+3030, U+303D, U+3297, U+3299, U+E000-E009, U+E010, U+E011,
+        U+E040-E06D, U+E080-E0B4, U+E0C0-E0CC, U+E0FF-E10D, U+E140-E14A, U+E150-E157, U+E181-E189, U+E1C0-E1C4,
+        U+E1C6-E1D9, U+E200-E216, U+E240-E269, U+E280-E283, U+E2C0-E2C4, U+E2C6-E2DA, U+E300-E303, U+E305-E30F,
+        U+E312-E316, U+E318-E322, U+E324-E329, U+E32B, U+E340-E348, U+E380, U+E381, U+F000, U+F77A, U+F8FF, U+FE0F,
+        U+1F004, U+1F0CF, U+1F10D-1F10F, U+1F12F, U+1F16D-1F171, U+1F17E, U+1F17F, U+1F18E, U+1F191-1F19A, U+1F1E6-1F1FF,
+        U+1F201, U+1F202, U+1F21A, U+1F22F, U+1F232-1F23A, U+1F250, U+1F251, U+1F260-1F265, U+1F300-1F321, U+1F324-1F393,
+        U+1F396, U+1F397, U+1F399-1F39B, U+1F39E-1F3F0, U+1F3F3-1F3F5, U+1F3F7-1F4FD, U+1F4FF-1F53D, U+1F549-1F54E,
+        U+1F550-1F567, U+1F56F, U+1F570, U+1F573-1F57A, U+1F587, U+1F58A-1F58D, U+1F590, U+1F595, U+1F596, U+1F5A4,
+        U+1F5A5, U+1F5A8, U+1F5B1, U+1F5B2, U+1F5BC, U+1F5C2-1F5C4, U+1F5D1-1F5D3, U+1F5DC-1F5DE, U+1F5E1, U+1F5E3,
+        U+1F5E8, U+1F5EF, U+1F5F3, U+1F5FA-1F64F, U+1F680-1F6C5, U+1F6CB-1F6D2, U+1F6D5-1F6D7, U+1F6DC-1F6E5, U+1F6E9,
+        U+1F6EB, U+1F6EC, U+1F6F0, U+1F6F3-1F6FC, U+1F7E0-1F7EB, U+1F7F0, U+1F90C-1F93A, U+1F93C-1F945, U+1F947-1F9FF,
+        U+1FA70-1FA7C, U+1FA80-1FA88, U+1FA90-1FABD, U+1FABF-1FAC5, U+1FACE-1FADB, U+1FAE0-1FAE8, U+1FAF0-1FAF8,
+        U+1FBC5-1FBC9, U+E0061-E0067, U+E0069, U+E006C-E0079, U+E007F;
 }
 
 :root {
@@ -201,7 +233,7 @@ textarea:focus-visible {
 /* Print styles */
 @media print {
     @page {
-        margin: 2cm;
+        margin: 1cm;
     }
 
     /* Hide UI elements */
@@ -211,7 +243,7 @@ textarea:focus-visible {
     aside,
     button:not(.print:block),
     .no-print,
-    [role="complementary"],
+    [role='complementary'],
     #portal-root {
         display: none !important;
     }
@@ -227,6 +259,14 @@ textarea:focus-visible {
         color: black !important;
     }
 
+    /* Remove container padding for full width printing */
+    .container {
+        padding-left: 0 !important;
+        padding-right: 0 !important;
+        max-width: none !important;
+        width: 100% !important;
+    }
+
     /* Remove shadows and backgrounds for clean print */
     * {
         box-shadow: none !important;
@@ -236,10 +276,66 @@ textarea:focus-visible {
     }
 
     /* Ensure text visibility */
-    h1, h2, h3, h4, h5, h6, p, li, span, div {
+    h1,
+    h2,
+    h3,
+    h4,
+    h5,
+    h6,
+    p,
+    li,
+    span,
+    div {
         color: black !important;
     }
 
+    /* Optimize typography for print */
+    .prose {
+        font-size: 11pt !important;
+        line-height: 1.4 !important;
+        max-width: 100% !important;
+    }
+
+    .prose h1 {
+        font-size: 22pt !important;
+        margin-bottom: 0.5rem !important;
+        margin-top: 0 !important;
+        line-height: 1.2 !important;
+    }
+
+    .prose h2 {
+        font-size: 16pt !important;
+        margin-top: 1.5rem !important;
+        margin-bottom: 0.5rem !important;
+        padding-bottom: 0.25rem !important;
+        line-height: 1.3 !important;
+    }
+
+    .prose h3 {
+        font-size: 14pt !important;
+        margin-top: 1rem !important;
+        margin-bottom: 0.5rem !important;
+        line-height: 1.3 !important;
+    }
+
+    .prose p,
+    .prose ul,
+    .prose ol {
+        margin-bottom: 0.5rem !important;
+        margin-top: 0 !important;
+    }
+
+    .prose li {
+        margin-top: 0.2rem !important;
+        margin-bottom: 0.2rem !important;
+    }
+
+    .prose pre {
+        padding: 0.5rem !important;
+        margin-bottom: 0.75rem !important;
+        margin-top: 0.5rem !important;
+    }
+
     /* Links */
     a {
         text-decoration: underline;
@@ -247,30 +343,41 @@ textarea:focus-visible {
     }
 
     /* Preserve borders */
-    .border, .border-b, .border-t, .border-l, .border-r {
+    .border,
+    .border-b,
+    .border-t,
+    .border-l,
+    .border-r {
         border-color: #ddd !important;
     }
 
     /* Page break control */
-    h1, h2 {
+    h1,
+    h2 {
         break-after: avoid;
         page-break-after: avoid;
     }
 
-    p, li, pre, code {
+    p,
+    li,
+    pre,
+    code {
         break-inside: avoid;
         page-break-inside: avoid;
     }
 
     /* Specific component overrides */
-    .card, .bg-white {
+    .card,
+    .bg-white {
         border: none !important;
     }
 
     /* Code blocks */
-    pre, code {
+    pre,
+    code {
         background-color: #f5f5f5 !important;
         border: 1px solid #ddd !important;
         white-space: pre-wrap !important;
+        font-size: 0.9em !important;
     }
 }

package/apps/agents-server/src/app/humans.txt/route.ts

@@ -6,7 +6,7 @@ import { NextResponse } from 'next/server';
 export const dynamic = 'force-dynamic';
 
 export async function GET() {
-    const txt = generateHumansTxt();
+    const txt = await generateHumansTxt();
     return new NextResponse(txt, {
         headers: {
             'Content-Type': 'text/plain',

package/apps/agents-server/src/app/layout.tsx

@@ -83,31 +83,36 @@ export default async function RootLayout({
         console.error('Failed to parse FOOTER_LINKS', error);
     }
 
-    // Fetch federated servers and add to footerLinks
+    // Fetch federated servers and add to footerLinks (only if user is authenticated or SHOW_FEDERATED_SERVERS_PUBLICLY is true)
     let federatedServers: Array<{ url: string; title: string; logoUrl: string | null }> = [];
     try {
-        const federatedServersRaw = await getFederatedServersFromMetadata();
-        federatedServers = await Promise.all(
-            federatedServersRaw.map(async (url: string) => {
-                let logoUrl: string | null = null;
-                try {
-                    // Try to fetch logo from metadata endpoint if available
-                    const res = await fetch(`${url}/api/metadata`);
-                    if (res.ok) {
-                        const meta = await res.json();
-                        logoUrl = meta.SERVER_LOGO_URL || null;
+        const showFederatedServersPublicly = ((await getMetadata('SHOW_FEDERATED_SERVERS_PUBLICLY')) || 'false') === 'true';
+
+        // Only show federated servers in footer if user is authenticated or if SHOW_FEDERATED_SERVERS_PUBLICLY is true
+        if (currentUser || showFederatedServersPublicly) {
+            const federatedServersRaw = await getFederatedServersFromMetadata();
+            federatedServers = await Promise.all(
+                federatedServersRaw.map(async (url: string) => {
+                    let logoUrl: string | null = null;
+                    try {
+                        // Try to fetch logo from metadata endpoint if available
+                        const res = await fetch(`${url}/api/metadata`);
+                        if (res.ok) {
+                            const meta = await res.json();
+                            logoUrl = meta.SERVER_LOGO_URL || null;
+                        }
+                    } catch {
+                        logoUrl = null;
                     }
-                } catch {
-                    logoUrl = null;
-                }
-                return {
-                    title: `Federated: ${new URL(url).hostname}`,
-                    url,
-                    logoUrl,
-                };
-            })
-        );
-        footerLinks = [...footerLinks, ...federatedServers];
+                    return {
+                        title: `Federated: ${new URL(url).hostname}`,
+                        url,
+                        logoUrl,
+                    };
+                })
+            );
+            footerLinks = [...footerLinks, ...federatedServers];
+        }
     } catch (error) {
         console.error('Failed to fetch federated servers for footer', error);
     }

package/apps/agents-server/src/app/page.tsx

@@ -12,10 +12,13 @@ import { Section } from '../components/Homepage/Section';
 import { TechInfoCard } from '../components/Homepage/TechInfoCard';
 import { UsersList } from '../components/UsersList/UsersList';
 import VercelDeploymentCard from '../components/VercelDeploymentCard/VercelDeploymentCard';
+import { $getTableName } from '../database/$getTableName';
+import { $provideSupabaseForServer } from '../database/$provideSupabaseForServer';
 import { getLongRunningTask } from '../deamons/longRunningTask';
 import { $provideAgentCollectionForServer } from '../tools/$provideAgentCollectionForServer';
 import { $provideExecutionToolsForServer } from '../tools/$provideExecutionToolsForServer';
 import { $provideServer } from '../tools/$provideServer';
+import { getCurrentUser } from '../utils/getCurrentUser';
 import { isUserAdmin } from '../utils/isUserAdmin';
 
 // Add calendar formats that include seconds
@@ -31,10 +34,57 @@ const calendarWithSeconds = {
 export default async function HomePage() {
     $sideEffect(/* Note: [🐶] This will ensure dynamic rendering of page and avoid Next.js pre-render */ headers());
 
+    const { publicUrl } = await $provideServer();
+
+    const currentUser = await getCurrentUser();
     const isAdmin = await isUserAdmin(); /* <- TODO: [👹] Here should be user permissions */
 
     const collection = await $provideAgentCollectionForServer();
-    const agents = await collection.listAgents();
+    const allAgents = await collection.listAgents();
+
+    // Filter agents based on visibility and user authentication
+    const supabase = $provideSupabaseForServer();
+    // const { tablePrefix } = await $provideServer();
+
+    // Get visibility for all agents
+    const visibilityResult = await supabase
+        .from(await $getTableName(`Agent`))
+        .select('agentName, visibility')
+        .is('deletedAt', null);
+
+    let agents: typeof allAgents;
+    if (visibilityResult.error) {
+        console.error('Error fetching agent visibility:', visibilityResult.error);
+        // Fallback to showing all agents if visibility fetch fails
+        agents = allAgents;
+    } else {
+        const visibilityMap = new Map(
+            visibilityResult.data.map((item: { agentName: string; visibility: 'PUBLIC' | 'PRIVATE' }) => [
+                item.agentName,
+                item.visibility,
+            ]),
+        );
+
+        // Filter agents based on user authentication and visibility
+        agents = allAgents
+            .filter((agent) => {
+                const visibility = visibilityMap.get(agent.agentName);
+                if (!visibility) return false; // If no visibility info, hide the agent
+
+                // Admins can see all agents
+                if (currentUser?.isAdmin) return true;
+
+                // Authenticated users can see PUBLIC and PRIVATE agents
+                if (currentUser) return true;
+
+                // Unauthenticated users can only see PUBLIC agents
+                return visibility === 'PUBLIC';
+            })
+            .map((agent) => ({
+                ...agent,
+                visibility: visibilityMap.get(agent.agentName) as 'PUBLIC' | 'PRIVATE',
+            }));
+    }
 
     const longRunningTask = getLongRunningTask();
 
@@ -46,15 +96,13 @@ export default async function HomePage() {
     return (
         <div className="min-h-screen bg-gradient-to-br from-blue-50 via-white to-purple-50">
             <div className="container mx-auto px-4 py-16">
-                <AgentsList agents={[...agents]} isAdmin={isAdmin} />
+                <AgentsList agents={[...agents]} isAdmin={isAdmin} publicUrl={publicUrl} />
 
-                <ExternalAgentsSectionClient />
+                <ExternalAgentsSectionClient publicUrl={publicUrl} />
 
                 {isAdmin && <UsersList allowCreate={false} />}
 
-                {isAdmin && (
-                    <ModelsSection models={models} maxVisible={11} showViewAllLink />
-                )}
+                {isAdmin && <ModelsSection models={models} maxVisible={11} showViewAllLink />}
 
                 {isAdmin && (
                     <>

package/apps/agents-server/src/app/recycle-bin/actions.ts

@@ -2,25 +2,31 @@
 
 import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
 import { revalidatePath } from 'next/cache';
+import { isUserAdmin } from '../../utils/isUserAdmin';
 
 export async function restoreDeletedAgent(agentName: string) {
-    const collection = await $provideAgentCollectionForServer();
-    
-    // Find the latest history item for this agent
-    const history = await collection.listAgentHistory(agentName);
-    
-    if (history.length === 0) {
-        throw new Error(`No history found for agent ${agentName}`);
+    if (!(await isUserAdmin())) {
+        throw new Error('You are not authorized to restore agents');
     }
-    
-    const latestVersion = history[0];
-    
-    if (!latestVersion) {
-         throw new Error(`No history found for agent ${agentName}`);
+
+    const collection = await $provideAgentCollectionForServer();
+
+    await collection.restoreAgent(agentName);
+
+    revalidatePath('/recycle-bin');
+    revalidatePath(`/agents/${agentName}`);
+    revalidatePath('/');
+}
+
+export async function deleteAgent(agentName: string) {
+    if (!(await isUserAdmin())) {
+        throw new Error('You are not authorized to delete agents');
     }
 
-    await collection.restoreAgent(latestVersion.id);
-    
+    const collection = await $provideAgentCollectionForServer();
+
+    await collection.deleteAgent(agentName);
+
     revalidatePath('/recycle-bin');
     revalidatePath(`/agents/${agentName}`);
     revalidatePath('/');