@desplega.ai/agent-swarm 1.20.0 → 1.49.0

package/templates-ui/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/templates-ui/public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

package/templates-ui/public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

package/templates-ui/public/next.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

package/templates-ui/public/vercel.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

package/templates-ui/public/window.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

package/templates-ui/src/app/[category]/[name]/page.tsx

@@ -0,0 +1,89 @@
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import { Header } from "@/components/header";
+import { Footer } from "@/components/footer";
+import { TemplateDetail } from "@/components/template-detail";
+import {
+  getAllTemplates,
+  getTemplate,
+  getTemplateConfig,
+} from "@/lib/templates";
+
+interface PageProps {
+  params: Promise<{ category: string; name: string }>;
+}
+
+export async function generateStaticParams() {
+  const templates = getAllTemplates();
+  return templates.map((t) => ({
+    category: t.category,
+    name: t.name,
+  }));
+}
+
+export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
+  const { category, name } = await params;
+
+  try {
+    const config = getTemplateConfig(category, name);
+    const title = config.displayName;
+    const description = config.description;
+    const capabilities = config.agentDefaults.capabilities.join(", ");
+
+    return {
+      title,
+      description,
+      openGraph: {
+        title: `${title} — Agent Swarm Template`,
+        description: `${description} Capabilities: ${capabilities}.`,
+        url: `https://templates.agent-swarm.dev/${category}/${name}`,
+      },
+      twitter: {
+        card: "summary",
+        title: `${title} — Agent Swarm Template`,
+        description,
+      },
+    };
+  } catch {
+    return { title: "Template Not Found" };
+  }
+}
+
+export default async function TemplateDetailPage({ params }: PageProps) {
+  const { category, name } = await params;
+
+  let template;
+  try {
+    template = getTemplate(category, name);
+  } catch {
+    notFound();
+  }
+
+  const jsonLd = {
+    "@context": "https://schema.org",
+    "@type": "SoftwareApplication",
+    name: template.config.displayName,
+    description: template.config.description,
+    applicationCategory: "DeveloperApplication",
+    operatingSystem: "Docker",
+    softwareVersion: template.config.version,
+    author: {
+      "@type": "Organization",
+      name: "Desplega AI",
+    },
+  };
+
+  return (
+    <div className="flex min-h-screen flex-col">
+      <Header />
+      <main className="mx-auto w-full max-w-4xl flex-1 px-4 py-12">
+        <script
+          type="application/ld+json"
+          dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
+        />
+        <TemplateDetail template={template} category={category} />
+      </main>
+      <Footer />
+    </div>
+  );
+}

package/templates-ui/src/app/api/templates/[...slug]/route.ts

@@ -0,0 +1,52 @@
+import { NextResponse } from "next/server";
+import { getAllTemplates, getTemplate, parseTemplateId } from "@/lib/templates";
+
+// Intentional: public registry API, consumed by agent-swarm workers and external tools
+const corsHeaders = {
+  "Access-Control-Allow-Origin": "*",
+  "Access-Control-Allow-Methods": "GET, OPTIONS",
+  "Access-Control-Allow-Headers": "Content-Type",
+};
+
+export async function OPTIONS() {
+  return new NextResponse(null, { status: 204, headers: corsHeaders });
+}
+
+export async function GET(
+  _request: Request,
+  { params }: { params: Promise<{ slug: string[] }> }
+) {
+  const { slug } = await params;
+
+  // GET /api/templates -> list all templates
+  if (!slug || slug.length === 0) {
+    const templates = getAllTemplates();
+    return NextResponse.json(templates, { headers: corsHeaders });
+  }
+
+  // Reconstruct the template ID from slug segments
+  // e.g. ["official", "coder"] or ["official", "coder@1.0.0"]
+  const templateId = slug.join("/");
+  const parsed = parseTemplateId(templateId);
+
+  try {
+    const template = getTemplate(parsed.category, parsed.name);
+
+    // Validate version if specified
+    if (parsed.version && template.config.version !== parsed.version) {
+      return NextResponse.json(
+        {
+          error: `Version ${parsed.version} not found. Available: ${template.config.version}`,
+        },
+        { status: 404, headers: corsHeaders }
+      );
+    }
+
+    return NextResponse.json(template, { headers: corsHeaders });
+  } catch {
+    return NextResponse.json(
+      { error: `Template "${templateId}" not found` },
+      { status: 404, headers: corsHeaders }
+    );
+  }
+}

package/templates-ui/src/app/api/templates/route.ts

@@ -0,0 +1,18 @@
+import { NextResponse } from "next/server";
+import { getAllTemplates } from "@/lib/templates";
+
+// Intentional: public registry API, consumed by agent-swarm workers and external tools
+const corsHeaders = {
+  "Access-Control-Allow-Origin": "*",
+  "Access-Control-Allow-Methods": "GET, OPTIONS",
+  "Access-Control-Allow-Headers": "Content-Type",
+};
+
+export async function OPTIONS() {
+  return new NextResponse(null, { status: 204, headers: corsHeaders });
+}
+
+export async function GET() {
+  const templates = getAllTemplates();
+  return NextResponse.json(templates, { headers: corsHeaders });
+}

package/templates-ui/src/app/builder/page.tsx

@@ -0,0 +1,37 @@
+import type { Metadata } from "next";
+import { Header } from "@/components/header";
+import { Footer } from "@/components/footer";
+import { ComposeBuilder } from "@/components/compose-builder";
+import { getAllTemplates } from "@/lib/templates";
+
+export const metadata: Metadata = {
+  title: "Docker Compose Builder",
+  description:
+    "Configure your agent swarm and generate docker-compose.yml and .env files. Select templates, set integrations, and deploy.",
+  openGraph: {
+    title: "Docker Compose Builder | Agent Swarm Templates",
+    description:
+      "Configure your agent swarm and generate docker-compose.yml and .env files.",
+  },
+};
+
+export default function BuilderPage() {
+  const templates = getAllTemplates();
+
+  return (
+    <div className="flex min-h-screen flex-col lg:h-screen lg:overflow-hidden">
+      <Header />
+      <div className="mx-auto w-full max-w-6xl px-4 py-4">
+        <h1 className="text-xl sm:text-2xl font-bold tracking-tight">
+          Docker Compose Builder
+        </h1>
+        <p className="mt-1 text-xs sm:text-sm text-muted-foreground">
+          Configure your swarm and generate docker-compose + .env files
+        </p>
+      </div>
+      <main className="mx-auto w-full max-w-6xl flex-1 px-4 pb-6 lg:overflow-hidden">
+        <ComposeBuilder templates={templates} />
+      </main>
+    </div>
+  );
+}

package/templates-ui/src/app/globals.css

@@ -0,0 +1,94 @@
+@import "tailwindcss";
+
+@custom-variant dark (&:is(.dark *));
+
+@theme {
+  /* shadcn/ui Zinc theme — light base with amber primary */
+  --color-background: oklch(1 0 0);
+  --color-foreground: oklch(0.141 0.005 285.823);
+  --color-card: oklch(1 0 0);
+  --color-card-foreground: oklch(0.141 0.005 285.823);
+  --color-popover: oklch(1 0 0);
+  --color-popover-foreground: oklch(0.141 0.005 285.823);
+  --color-primary: oklch(0.555 0.163 48.998);
+  --color-primary-foreground: oklch(0.985 0 0);
+  --color-secondary: oklch(0.967 0.001 286.375);
+  --color-secondary-foreground: oklch(0.21 0.006 285.885);
+  --color-muted: oklch(0.967 0.001 286.375);
+  --color-muted-foreground: oklch(0.552 0.016 285.938);
+  --color-accent: oklch(0.967 0.001 286.375);
+  --color-accent-foreground: oklch(0.21 0.006 285.885);
+  --color-destructive: oklch(0.577 0.245 27.325);
+  --color-destructive-foreground: oklch(0.985 0 0);
+  --color-border: oklch(0.92 0.004 286.32);
+  --color-input: oklch(0.92 0.004 286.32);
+  --color-ring: oklch(0.555 0.163 48.998);
+
+  /* Fonts */
+  --font-sans: var(--font-space-grotesk), sans-serif;
+  --font-mono: var(--font-space-mono), monospace;
+
+  /* Border radius */
+  --radius-sm: 0.375rem;
+  --radius-md: 0.5rem;
+  --radius-lg: 0.625rem;
+  --radius-xl: 0.75rem;
+}
+
+/* Dark mode overrides */
+.dark,
+.dark * {
+  --color-background: oklch(0.141 0.005 285.823);
+  --color-foreground: oklch(0.985 0 0);
+  --color-card: oklch(0.21 0.006 285.885);
+  --color-card-foreground: oklch(0.985 0 0);
+  --color-popover: oklch(0.21 0.006 285.885);
+  --color-popover-foreground: oklch(0.985 0 0);
+  --color-primary: oklch(0.769 0.188 70.08);
+  --color-primary-foreground: oklch(0.21 0.006 285.885);
+  --color-secondary: oklch(0.274 0.006 286.033);
+  --color-secondary-foreground: oklch(0.985 0 0);
+  --color-muted: oklch(0.274 0.006 286.033);
+  --color-muted-foreground: oklch(0.705 0.015 286.067);
+  --color-accent: oklch(0.274 0.006 286.033);
+  --color-accent-foreground: oklch(0.985 0 0);
+  --color-destructive: oklch(0.704 0.191 22.216);
+  --color-destructive-foreground: oklch(0.985 0 0);
+  --color-border: oklch(1 0 0 / 10%);
+  --color-input: oklch(1 0 0 / 15%);
+  --color-ring: oklch(0.769 0.188 70.08);
+}
+
+:root {
+  font-synthesis: none;
+  text-rendering: optimizeLegibility;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+body {
+  margin: 0;
+  background: var(--color-background);
+  color: var(--color-foreground);
+  font-family: var(--font-sans);
+  min-height: 100vh;
+}
+
+/* Scrollbar */
+::-webkit-scrollbar {
+  width: 8px;
+  height: 8px;
+}
+
+::-webkit-scrollbar-track {
+  background: var(--color-background);
+}
+
+::-webkit-scrollbar-thumb {
+  background: var(--color-border);
+  border-radius: 4px;
+}
+
+::-webkit-scrollbar-thumb:hover {
+  background: var(--color-muted-foreground);
+}

package/templates-ui/src/app/layout.tsx

@@ -0,0 +1,79 @@
+import type { Metadata } from "next";
+import Script from "next/script";
+import { Space_Grotesk, Space_Mono } from "next/font/google";
+import "./globals.css";
+
+const spaceGrotesk = Space_Grotesk({
+  variable: "--font-space-grotesk",
+  subsets: ["latin"],
+  weight: ["300", "400", "500", "600", "700"],
+  display: "swap",
+});
+
+const spaceMono = Space_Mono({
+  variable: "--font-space-mono",
+  subsets: ["latin"],
+  weight: ["400", "700"],
+  display: "swap",
+});
+
+const siteUrl = "https://templates.agent-swarm.dev";
+
+export const metadata: Metadata = {
+  metadataBase: new URL(siteUrl),
+  title: {
+    default: "Agent Swarm Templates",
+    template: "%s | Agent Swarm Templates",
+  },
+  description:
+    "Pre-configured worker templates for your agent swarm. Browse, customize, and deploy.",
+  icons: {
+    icon: "/logo.png",
+  },
+  openGraph: {
+    type: "website",
+    locale: "en_US",
+    url: siteUrl,
+    siteName: "Agent Swarm Templates",
+    title: "Agent Swarm Templates",
+    description:
+      "Pre-configured worker templates for your agent swarm. Browse, customize, and deploy.",
+    images: [{ url: "/logo.png", width: 512, height: 512, alt: "Agent Swarm" }],
+  },
+  twitter: {
+    card: "summary",
+    title: "Agent Swarm Templates",
+    description:
+      "Pre-configured worker templates for your agent swarm. Browse, customize, and deploy.",
+    images: ["/logo.png"],
+  },
+  alternates: {
+    canonical: siteUrl,
+  },
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <head>
+        <meta name="theme-color" content="#ffffff" />
+        <Script
+          src="https://plausible.io/js/pa-M1-eco9iixf2o8UzZs6o5.js"
+          strategy="afterInteractive"
+        />
+        <Script id="plausible-init" strategy="afterInteractive">
+          {`window.plausible=window.plausible||function(){(plausible.q=plausible.q||[]).push(arguments)},plausible.init=plausible.init||function(i){plausible.o=i||{}};plausible.init()`}
+        </Script>
+      </head>
+      <body
+        className={`${spaceGrotesk.variable} ${spaceMono.variable} antialiased`}
+      >
+        {children}
+      </body>
+    </html>
+  );
+}

package/templates-ui/src/app/page.tsx

@@ -0,0 +1,38 @@
+import type { Metadata } from "next";
+import { Header } from "@/components/header";
+import { Footer } from "@/components/footer";
+import { TemplateGallery } from "@/components/template-gallery";
+import { getAllTemplates } from "@/lib/templates";
+
+export const metadata: Metadata = {
+  title: "Browse Templates",
+  description:
+    "Browse pre-configured agent templates for your swarm. Lead agents, coders, researchers, reviewers, and testers — ready to deploy.",
+  openGraph: {
+    title: "Browse Agent Swarm Templates",
+    description:
+      "Browse pre-configured agent templates for your swarm. Lead agents, coders, researchers, reviewers, and testers — ready to deploy.",
+  },
+};
+
+export default function Home() {
+  const templates = getAllTemplates();
+
+  return (
+    <div className="flex min-h-screen flex-col">
+      <Header />
+      <main className="mx-auto w-full max-w-6xl flex-1 px-4 py-12">
+        <div className="mb-10 text-center">
+          <h1 className="text-4xl font-bold tracking-tight">
+            Agent Swarm Templates
+          </h1>
+          <p className="mt-4 text-lg text-muted-foreground">
+            Pre-configured worker templates for your swarm
+          </p>
+        </div>
+        <TemplateGallery templates={templates} />
+      </main>
+      <Footer />
+    </div>
+  );
+}

package/templates-ui/src/app/robots.ts

@@ -0,0 +1,11 @@
+import type { MetadataRoute } from "next";
+
+export default function robots(): MetadataRoute.Robots {
+  return {
+    rules: {
+      userAgent: "*",
+      allow: "/",
+    },
+    sitemap: "https://templates.agent-swarm.dev/sitemap.xml",
+  };
+}

package/templates-ui/src/app/sitemap.ts

@@ -0,0 +1,31 @@
+import type { MetadataRoute } from "next";
+import { getAllTemplates } from "@/lib/templates";
+
+const siteUrl = "https://templates.agent-swarm.dev";
+
+export default function sitemap(): MetadataRoute.Sitemap {
+  const templates = getAllTemplates();
+
+  const templatePages: MetadataRoute.Sitemap = templates.map((t) => ({
+    url: `${siteUrl}/${t.category}/${t.name}`,
+    lastModified: t.lastUpdatedAt ? new Date(t.lastUpdatedAt) : new Date(),
+    changeFrequency: "weekly",
+    priority: 0.8,
+  }));
+
+  return [
+    {
+      url: siteUrl,
+      lastModified: new Date(),
+      changeFrequency: "weekly",
+      priority: 1,
+    },
+    {
+      url: `${siteUrl}/builder`,
+      lastModified: new Date(),
+      changeFrequency: "monthly",
+      priority: 0.7,
+    },
+    ...templatePages,
+  ];
+}