@bluefly/openstandardagents 0.1.9 → 0.2.5-RC

package/website/app/sitemap.ts

@@ -0,0 +1,56 @@
+import { MetadataRoute } from 'next';
+import fs from 'fs';
+import path from 'path';
+
+export const dynamic = 'force-static';
+
+function getAllPages(): string[] {
+  const pages: string[] = ['', '/docs', '/playground', '/examples', '/schema', '/blog'];
+
+  // Add blog posts
+  const blogDir = path.join(process.cwd(), '../content/blog');
+  if (fs.existsSync(blogDir)) {
+    const files = fs.readdirSync(blogDir);
+    files
+      .filter((file) => file.endsWith('.md'))
+      .forEach((file) => {
+        pages.push(`/blog/${file.replace(/\.md$/, '')}`);
+      });
+  }
+
+  // Add docs pages
+  const docsDir = path.join(process.cwd(), '../../.gitlab/wiki-content');
+  if (fs.existsSync(docsDir)) {
+    const traverseDir = (dir: string, basePath = ''): void => {
+      const entries = fs.readdirSync(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (entry.isDirectory()) {
+          traverseDir(path.join(dir, entry.name), `${basePath}/${entry.name}`);
+        } else if (entry.isFile() && entry.name.endsWith('.md')) {
+          const slug = entry.name.replace(/\.md$/, '');
+          if (slug !== 'index') {
+            pages.push(`/docs${basePath}/${slug}`);
+          } else if (basePath) {
+            pages.push(`/docs${basePath}`);
+          }
+        }
+      }
+    }
+    traverseDir(docsDir);
+  }
+
+  return pages;
+}
+
+export default function sitemap(): MetadataRoute.Sitemap {
+  const baseUrl = 'https://openstandardagents.org';
+  const pages = getAllPages();
+
+  return pages.map((page) => ({
+    url: `${baseUrl}${page === '' ? '' : page}`,
+    lastModified: new Date(),
+    changeFrequency: page.startsWith('/blog') ? 'weekly' : 'monthly',
+    priority: page === '' ? 1.0 : page.startsWith('/docs') ? 0.9 : 0.8,
+  }));
+}
+

package/website/app/specification/page.tsx

@@ -0,0 +1,287 @@
+import Link from 'next/link';
+import type { Metadata } from 'next';
+import { STABLE_VERSION_TAG, STABLE_VERSION } from '@/lib/version';
+
+export const metadata: Metadata = {
+  title: 'Specification - Open Standard Agents',
+  description: 'The complete Open Standard Agents specification documentation.',
+};
+
+export default function SpecificationPage() {
+  return (
+    <>
+      {/* Hero Section */}
+      <div className="bg-gradient-to-br from-secondary via-primary to-accent text-white py-16 px-4">
+        <div className="container mx-auto max-w-6xl text-center">
+          <div className="inline-flex items-center justify-center w-20 h-20 bg-white/20 backdrop-blur-sm rounded-full mb-6">
+            <svg className="w-10 h-10" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z" />
+            </svg>
+          </div>
+          <h1 className="text-5xl font-bold mb-4">OSSA Specification</h1>
+          <p className="text-xl text-white/90 mb-2">
+            Complete technical specification for defining, validating, and deploying AI agents
+          </p>
+          <p className="text-lg text-white/80">
+            Version {STABLE_VERSION_TAG} • The OpenAPI for AI Agents
+          </p>
+        </div>
+      </div>
+
+      <div className="container mx-auto max-w-7xl px-4 py-12">
+        <div className="max-w-4xl mx-auto">
+          {/* Current Version Highlighted Block */}
+          <section className="mb-12">
+            <div className="bg-gradient-to-br from-blue-50 via-indigo-50 to-purple-50 rounded-2xl p-8 border-2 border-blue-200 shadow-lg">
+              <div className="flex items-center justify-between mb-6">
+                <div>
+                  <h2 className="text-3xl font-bold mb-2 text-primary">Current Version</h2>
+                  <h3 className="text-2xl font-semibold mb-2 text-gray-900">{STABLE_VERSION_TAG}</h3>
+                  <p className="text-gray-700">Latest stable release</p>
+                </div>
+                <Link href="/schema" className="btn-primary whitespace-nowrap">
+                  View Schema
+                </Link>
+              </div>
+              <div className="grid md:grid-cols-2 gap-6 mt-6 pt-6 border-t-2 border-blue-200">
+                <div>
+                  <h4 className="font-bold mb-2 text-gray-900">Release Date</h4>
+                  <p className="text-gray-700 text-lg">November 2024</p>
+                </div>
+                <div>
+                  <h4 className="font-bold mb-2 text-gray-900">Status</h4>
+                  <span className="inline-block px-4 py-2 bg-green-100 text-green-800 rounded-full text-sm font-semibold border-2 border-green-300">
+                    Stable
+                  </span>
+                </div>
+              </div>
+            </div>
+          </section>
+
+          {/* Why This Specification? */}
+          <section className="mb-16">
+            <div className="bg-gradient-to-br from-amber-50 via-orange-50 to-yellow-50 rounded-2xl p-8">
+              <div className="flex items-start mb-6">
+                <div className="w-12 h-12 bg-gradient-to-br from-secondary via-primary to-accent rounded-lg flex items-center justify-center mr-4 flex-shrink-0">
+                  <svg className="w-6 h-6 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M8.228 9c.549-1.165 2.03-2 3.772-2 2.21 0 4 1.343 4 3 0 1.4-1.278 2.575-3.006 2.907-.542.104-.994.54-.994 1.093m0 3h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" />
+                  </svg>
+                </div>
+                <div>
+                  <h2 className="text-3xl font-bold mb-4 text-gray-900">Why This Specification?</h2>
+                  <div className="space-y-4 text-lg text-gray-700">
+                    <p>
+                      <strong className="text-primary">The Problem:</strong> Every AI framework defines agents differently.
+                      LangChain has "chains," CrewAI has "crews," OpenAI has "assistants," Anthropic has different tools.
+                      This creates <span className="text-red-600 font-semibold">vendor lock-in</span> and makes it impossible to share agents between teams or frameworks.
+                    </p>
+                    <p>
+                      <strong className="text-secondary">The Solution:</strong> OSSA provides a single, standard way to describe agents that works everywhere.
+                      Like OpenAPI revolutionized REST APIs, OSSA revolutionizes AI agents with a vendor-neutral specification.
+                    </p>
+                    <p>
+                      <strong className="text-primary">The Result:</strong> Write your agent definition once, deploy it to any framework.
+                      Switch providers without rewriting code. Share agents across organizations. True portability and interoperability.
+                    </p>
+                  </div>
+                </div>
+              </div>
+            </div>
+          </section>
+
+          <section className="mb-12">
+            <div className="flex items-center mb-8">
+              <div className="w-12 h-12 bg-gradient-to-br from-secondary via-primary to-accent rounded-lg flex items-center justify-center mr-4">
+                <svg className="w-6 h-6 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                  <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M19 11H5m14 0a2 2 0 012 2v6a2 2 0 01-2 2H5a2 2 0 01-2-2v-6a2 2 0 012-2m14 0V9a2 2 0 00-2-2M5 11V9a2 2 0 012-2m0 0V5a2 2 0 012-2h6a2 2 0 012 2v2M7 7h10" />
+                </svg>
+              </div>
+              <h2 className="text-3xl font-bold text-primary">Specification Structure</h2>
+            </div>
+            <div className="space-y-4">
+              <div className="bg-white border-2 border-blue-100 rounded-xl p-6 shadow-md hover:shadow-xl hover:border-primary transition-all duration-300">
+                <h3 className="text-xl font-bold mb-3 text-primary">1. Core Specification</h3>
+                <p className="text-gray-700 mb-4">
+                  The fundamental structure of an OSA agent manifest, including metadata, specification,
+                  and extensions.
+                </p>
+                <Link href="/docs/getting-started/first-agent" className="text-primary hover:text-secondary font-semibold inline-flex items-center">
+                  Read Core Specification →
+                </Link>
+              </div>
+
+              <div className="bg-white border-2 border-blue-100 rounded-xl p-6 shadow-md hover:shadow-xl hover:border-primary transition-all duration-300">
+                <h3 className="text-xl font-bold mb-3 text-primary">2. Schema Reference</h3>
+                <p className="text-gray-700 mb-4">
+                  Complete JSON Schema definition with all properties, types, constraints, and validation rules.
+                </p>
+                <Link href="/schema" className="text-primary hover:text-secondary font-semibold inline-flex items-center">
+                  Explore Schema →
+                </Link>
+              </div>
+
+              <div className="bg-white border-2 border-blue-100 rounded-xl p-6 shadow-md hover:shadow-xl hover:border-primary transition-all duration-300">
+                <h3 className="text-xl font-bold mb-3 text-primary">3. Platform Extensions</h3>
+                <p className="text-gray-700 mb-4">
+                  Framework-specific extensions for Cursor, OpenAI, CrewAI, LangChain, Anthropic,
+                  Langflow, AutoGen, and more.
+                </p>
+                <Link href="/docs/examples/migration-guides" className="text-primary hover:text-secondary font-semibold inline-flex items-center">
+                  View Extensions →
+                </Link>
+              </div>
+
+              <div className="bg-white border-2 border-blue-100 rounded-xl p-6 shadow-md hover:shadow-xl hover:border-primary transition-all duration-300">
+                <h3 className="text-xl font-bold mb-3 text-primary">4. Validation Rules</h3>
+                <p className="text-gray-700 mb-4">
+                  Comprehensive validation rules, error messages, and best practices for creating valid agent manifests.
+                </p>
+                <Link href="/playground" className="text-primary hover:text-secondary font-semibold inline-flex items-center">
+                  Try Validation →
+                </Link>
+              </div>
+            </div>
+          </section>
+
+          <section className="mb-12">
+            <div className="flex items-center mb-8">
+              <div className="w-12 h-12 bg-gradient-to-br from-secondary via-primary to-accent rounded-lg flex items-center justify-center mr-4">
+                <svg className="w-6 h-6 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                  <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z" />
+                </svg>
+              </div>
+              <h2 className="text-3xl font-bold text-primary">Key Concepts</h2>
+            </div>
+            <div className="space-y-6">
+              <div className="bg-white border-2 border-gray-200 rounded-xl p-6 shadow-md">
+                <h3 className="text-xl font-bold mb-3 text-primary">Agent Manifest</h3>
+                <p className="text-gray-700 mb-4">
+                  A YAML or JSON file that describes an AI agent, including its role, LLM configuration,
+                  tools, and deployment requirements.
+                </p>
+                <div className="bg-gray-900 rounded-lg p-4 mt-3 border-2 border-gray-700">
+                  <pre className="text-green-400 text-sm overflow-x-auto font-mono">
+                    <code>{`apiVersion: ossa/v${STABLE_VERSION}
+kind: Agent
+metadata:
+  name: my-agent
+spec:
+  role: You are a helpful assistant
+  llm:
+    provider: openai
+    model: gpt-4`}</code>
+                  </pre>
+                </div>
+              </div>
+
+              <div className="bg-white border-2 border-gray-200 rounded-xl p-6 shadow-md">
+                <h3 className="text-xl font-bold mb-3 text-primary">Schema Validation</h3>
+                <p className="text-gray-700">
+                  Every agent manifest must conform to the OSA JSON Schema. Validation ensures correctness,
+                  completeness, and compatibility before deployment.
+                </p>
+              </div>
+
+              <div className="bg-white border-2 border-gray-200 rounded-xl p-6 shadow-md">
+                <h3 className="text-xl font-bold mb-3 text-primary">Platform Extensions</h3>
+                <p className="text-gray-700">
+                  Framework-specific extensions allow agents to leverage platform-specific features while
+                  maintaining core OSA compatibility.
+                </p>
+              </div>
+
+              <div className="bg-white border-2 border-gray-200 rounded-xl p-6 shadow-md">
+                <h3 className="text-xl font-bold mb-3 text-primary">Export/Import</h3>
+                <p className="text-gray-700">
+                  Convert OSA manifests to framework-specific formats (export) or import existing agents
+                  into OSA format for standardization.
+                </p>
+              </div>
+            </div>
+          </section>
+
+          <section className="mb-12">
+            <div className="flex items-center mb-8">
+              <div className="w-12 h-12 bg-gradient-to-br from-secondary via-primary to-accent rounded-lg flex items-center justify-center mr-4">
+                <svg className="w-6 h-6 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                  <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M12 8v4l3 3m6-3a9 9 0 11-18 0 9 9 0 0118 0z" />
+                </svg>
+              </div>
+              <h2 className="text-3xl font-bold text-primary">Version History</h2>
+            </div>
+            <div className="space-y-4">
+              <div className="bg-gradient-to-br from-blue-50 to-indigo-50 border-2 border-primary rounded-xl p-6 shadow-lg">
+                <div className="flex items-center justify-between mb-2">
+                  <h3 className="text-xl font-bold text-gray-900">{STABLE_VERSION_TAG}</h3>
+                  <span className="px-4 py-2 bg-green-100 text-green-800 rounded-full text-sm font-semibold border-2 border-green-300">
+                    Current
+                  </span>
+                </div>
+                <p className="text-gray-700 mb-2 font-medium">November 2024</p>
+                <p className="text-gray-700">
+                  Enhanced platform extensions, improved validation, and expanded tool support.
+                </p>
+              </div>
+
+              <div className="bg-white border-2 border-gray-200 rounded-xl p-6 shadow-md">
+                <div className="flex items-center justify-between mb-2">
+                  <h3 className="text-xl font-semibold text-gray-900">v0.2.2</h3>
+                  <span className="px-3 py-1 bg-gray-200 text-gray-700 rounded-full text-sm font-medium">
+                    Previous
+                  </span>
+                </div>
+                <p className="text-gray-700 mb-2">October 2024</p>
+                <p className="text-gray-700">
+                  Initial platform extensions and improved schema structure.
+                </p>
+              </div>
+
+              <div className="bg-white border-2 border-gray-200 rounded-xl p-6 shadow-md">
+                <div className="flex items-center justify-between mb-2">
+                  <h3 className="text-xl font-semibold text-gray-900">v0.1.9</h3>
+                  <span className="px-3 py-1 bg-gray-200 text-gray-700 rounded-full text-sm font-medium">
+                    Legacy
+                  </span>
+                </div>
+                <p className="text-gray-700 mb-2">September 2024</p>
+                <p className="text-gray-700">
+                  Initial release with basic agent definition structure.
+                </p>
+              </div>
+            </div>
+          </section>
+
+          <section className="mb-12">
+            <div className="flex items-center mb-8">
+              <div className="w-12 h-12 bg-gradient-to-br from-secondary via-primary to-accent rounded-lg flex items-center justify-center mr-4">
+                <svg className="w-6 h-6 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                  <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M12 6.253v13m0-13C10.832 5.477 9.246 5 7.5 5S4.168 5.477 3 6.253v13C4.168 18.477 5.754 18 7.5 18s3.332.477 4.5 1.253m0-13C13.168 5.477 14.754 5 16.5 5c1.747 0 3.332.477 4.5 1.253v13C19.832 18.477 18.247 18 16.5 18c-1.746 0-3.332.477-4.5 1.253" />
+                </svg>
+              </div>
+              <h2 className="text-3xl font-bold text-primary">Resources</h2>
+            </div>
+            <div className="grid md:grid-cols-2 gap-4">
+              <Link href="/schema" className="bg-white border-2 border-blue-100 rounded-xl p-6 shadow-md hover:shadow-xl hover:border-primary transition-all duration-300">
+                <h3 className="text-xl font-bold mb-2 text-primary">Interactive Schema Explorer</h3>
+                <p className="text-gray-700">Explore the complete JSON Schema interactively.</p>
+              </Link>
+              <Link href="/playground" className="bg-white border-2 border-blue-100 rounded-xl p-6 shadow-md hover:shadow-xl hover:border-primary transition-all duration-300">
+                <h3 className="text-xl font-bold mb-2 text-primary">Validation Playground</h3>
+                <p className="text-gray-700">Test and validate your agent manifests in real-time.</p>
+              </Link>
+              <Link href="/examples" className="bg-white border-2 border-blue-100 rounded-xl p-6 shadow-md hover:shadow-xl hover:border-primary transition-all duration-300">
+                <h3 className="text-xl font-bold mb-2 text-primary">Examples Gallery</h3>
+                <p className="text-gray-700">Browse real-world examples and use cases.</p>
+              </Link>
+              <Link href="/docs" className="bg-white border-2 border-blue-100 rounded-xl p-6 shadow-md hover:shadow-xl hover:border-primary transition-all duration-300">
+                <h3 className="text-xl font-bold mb-2 text-primary">Full Documentation</h3>
+                <p className="text-gray-700">Comprehensive guides and tutorials.</p>
+              </Link>
+            </div>
+          </section>
+        </div>
+      </div>
+    </>
+  );
+}
+

package/website/components/InstallCommand.tsx

@@ -0,0 +1,96 @@
+'use client';
+
+import { useState } from 'react';
+
+export function InstallCommand() {
+  const [copiedIndex, setCopiedIndex] = useState<number | null>(null);
+
+  const steps = [
+    {
+      title: '1. Install',
+      command: 'npm install -g @bluefly/openstandardagents',
+    },
+    {
+      title: '2. Create',
+      command: 'osa init my-agent',
+    },
+    {
+      title: '3. Validate',
+      command: 'osa validate my-agent.ossa.yaml',
+    },
+    {
+      title: '4. Export',
+      command: 'osa export --to langchain',
+    },
+  ];
+
+  const copyToClipboard = async (command: string, index: number) => {
+    try {
+      await navigator.clipboard.writeText(command);
+      setCopiedIndex(index);
+      setTimeout(() => setCopiedIndex(null), 2000);
+    } catch (err) {
+      console.error('Failed to copy:', err);
+    }
+  };
+
+  return (
+    <div className="bg-gradient-to-r from-primary to-secondary text-white rounded-lg p-8 shadow-xl">
+      <div className="container mx-auto max-w-6xl">
+        <h3 className="text-2xl font-bold mb-2">Get Started in Minutes</h3>
+        <p className="text-lg mb-6 opacity-90">
+          Install the CLI, create your first agent, and start building with OSSA
+        </p>
+
+        <div className="grid md:grid-cols-2 lg:grid-cols-4 gap-4 mb-6">
+          {steps.map((step, index) => (
+            <div key={index} className="bg-white/10 backdrop-blur-sm rounded-lg p-4">
+              <h4 className="font-semibold mb-2 text-sm">{step.title}</h4>
+              <div className="bg-black/30 rounded p-2 flex items-start justify-between gap-2">
+                <code className="text-xs font-mono text-white flex-1 break-all">
+                  {step.command}
+                </code>
+                <button
+                  onClick={() => copyToClipboard(step.command, index)}
+                  className="flex-shrink-0 p-1 hover:bg-white/20 rounded transition-colors"
+                  aria-label="Copy command"
+                >
+                  {copiedIndex === index ? (
+                    <svg className="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                      <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M5 13l4 4L19 7" />
+                    </svg>
+                  ) : (
+                    <svg className="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                      <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M8 16H6a2 2 0 01-2-2V6a2 2 0 012-2h8a2 2 0 012 2v2m-6 12h8a2 2 0 002-2v-8a2 2 0 00-2-2h-8a2 2 0 00-2 2v8a2 2 0 002 2z" />
+                    </svg>
+                  )}
+                </button>
+              </div>
+            </div>
+          ))}
+        </div>
+
+        <div className="flex flex-wrap gap-4 text-sm">
+          <a href="/docs/getting-started/5-minute-overview" className="text-white hover:underline flex items-center gap-2">
+            <svg className="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z" />
+            </svg>
+            Quick Start Guide
+          </a>
+          <a href="/examples" className="text-white hover:underline flex items-center gap-2">
+            <svg className="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M10 20l4-16m4 4l4 4-4 4M6 16l-4-4 4-4" />
+            </svg>
+            View Examples
+          </a>
+          <a href="/docs" className="text-white hover:underline flex items-center gap-2">
+            <svg className="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M12 6.253v13m0-13C10.832 5.477 9.246 5 7.5 5S4.168 5.477 3 6.253v13C4.168 18.477 5.754 18 7.5 18s3.332.477 4.5 1.253m0-13C13.168 5.477 14.754 5 16.5 5c1.747 0 3.332.477 4.5 1.253v13C19.832 18.477 18.247 18 16.5 18c-1.746 0-3.332.477-4.5 1.253" />
+            </svg>
+            Full Documentation
+          </a>
+        </div>
+      </div>
+    </div>
+  );
+}

package/website/components/Logo.tsx

@@ -0,0 +1,97 @@
+'use client';
+
+interface LogoProps {
+  domain: string;
+  name: string;
+}
+
+// Special handling for domains that don't work with clearbit
+// Use SimpleIcons or direct logo URLs where available
+const LOGO_FALLBACKS: Record<string, string> = {
+  'kagent.dev': 'https://www.google.com/s2/favicons?sz=256&domain=kagent.dev',
+  'langchain.com': 'https://simpleicons.org/icons/langchain.svg',
+  'crewai.com': 'https://www.google.com/s2/favicons?sz=128&domain=crewai.com',
+  'llamaindex.ai': 'https://www.google.com/s2/favicons?sz=128&domain=llamaindex.ai',
+  'modelcontextprotocol.io': 'https://simpleicons.org/icons/anthropic.svg',
+  'librechat.com': 'https://simpleicons.org/icons/react.svg',
+  'langflow.com': 'https://simpleicons.org/icons/python.svg',
+  'openai.com': 'https://simpleicons.org/icons/openai.svg',
+  'anthropic.com': 'https://simpleicons.org/icons/anthropic.svg',
+  'cursor.sh': 'https://simpleicons.org/icons/cursor.svg',
+  'microsoft.com': 'https://www.google.com/s2/favicons?sz=256&domain=microsoft.com',
+  'vercel.com': 'https://simpleicons.org/icons/vercel.svg',
+  'drupal.org': 'https://simpleicons.org/icons/drupal.svg',
+  'huggingface.co': 'https://simpleicons.org/icons/huggingface.svg',
+  'google.com': 'https://simpleicons.org/icons/google.svg',
+  'deepmind.google': 'https://www.google.com/s2/favicons?sz=256&domain=deepmind.google',
+  'aws.amazon.com': 'https://www.google.com/s2/favicons?sz=128&domain=aws.amazon.com',
+  'azure.com': 'https://simpleicons.org/icons/microsoftazure.svg',
+  'github.com': 'https://simpleicons.org/icons/github.svg',
+  'docker.com': 'https://simpleicons.org/icons/docker.svg',
+  'kubernetes.io': 'https://simpleicons.org/icons/kubernetes.svg',
+};
+
+export function Logo({ domain, name }: LogoProps) {
+  const getLogoSrc = () => {
+    // Check for name-based fallbacks first (for cases where domain is shared)
+    if (name === 'LangGraph' && domain === 'langchain.com') {
+      return 'https://simpleicons.org/icons/langchain.svg';
+    }
+    if (name === 'LlamaIndex') {
+      return 'https://www.google.com/s2/favicons?sz=128&domain=llamaindex.ai';
+    }
+    if (name === 'CrewAI') {
+      return 'https://www.google.com/s2/favicons?sz=128&domain=crewai.com';
+    }
+    if (name === 'AutoGen') {
+      return 'https://www.google.com/s2/favicons?sz=256&domain=microsoft.com';
+    }
+    if (name === 'Vercel AI') {
+      return 'https://simpleicons.org/icons/vercel.svg';
+    }
+    if (name === 'MCP') {
+      return 'https://simpleicons.org/icons/anthropic.svg';
+    }
+    if (name === 'Kagent' || name === 'kAgent') {
+      return 'https://www.google.com/s2/favicons?sz=256&domain=kagent.dev';
+    }
+    if (name === 'AWS') {
+      return 'https://www.google.com/s2/favicons?sz=128&domain=aws.amazon.com';
+    }
+    if (name === 'Microsoft') {
+      return 'https://www.google.com/s2/favicons?sz=256&domain=microsoft.com';
+    }
+    if (name === 'Gemini') {
+      return 'https://www.google.com/s2/favicons?sz=256&domain=deepmind.google';
+    }
+    // Check domain-based fallbacks
+    if (LOGO_FALLBACKS[domain]) {
+      return LOGO_FALLBACKS[domain];
+    }
+    return `https://logo.clearbit.com/${domain}`;
+  };
+
+  const handleError = (e: React.SyntheticEvent<HTMLImageElement, Event>) => {
+    // Try Google favicon service as fallback
+    const fallbackSrc = `https://www.google.com/s2/favicons?sz=256&domain=${domain}`;
+    if (e.currentTarget.src !== fallbackSrc) {
+      e.currentTarget.src = fallbackSrc;
+    } else {
+      // If both fail, use a placeholder
+      e.currentTarget.src = 'data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNDgiIGhlaWdodD0iNDgiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHJlY3Qgd2lkdGg9IjI0IiBoZWlnaHQ9IjI0IiByeD0iNCIgZmlsbD0iI0U1RTdFQiIvPgo8cGF0aCBkPSJNMTIgOEMxMy4xIDggMTQgOC45IDE0IDEwQzE0IDExLjEgMTMuMSAxMiAxMiAxMkMxMC45IDEyIDEwIDExLjEgMTAgMTBDMTAgOC45IDEwLjkgOCAxMiA4Wk0xMiAxNEMxMy4xIDE0IDE0IDE0LjkgMTQgMTZDMTQgMTcuMSAxMy4xIDE4IDEyIDE4QzEwLjkgMTggMTAgMTcuMSAxMCAxNkMxMCAxNC45IDEwLjkgMTQgMTIgMTRaIiBmaWxsPSIjOUI5Q0E0Ii8+Cjwvc3ZnPgo=';
+    }
+  };
+
+  return (
+    <div className="flex flex-col items-center gap-3 p-4 hover:bg-white rounded-lg transition-all">
+      <img
+        src={getLogoSrc()}
+        alt={name}
+        className="h-12 w-12 object-contain"
+        style={{ filter: 'grayscale(100%) contrast(1.2)' }}
+        onError={handleError}
+      />
+      <span className="text-sm font-medium text-gray-600">{name}</span>
+    </div>
+  );
+}

package/website/components/StructuredData.tsx

@@ -0,0 +1,65 @@
+interface StructuredDataProps {
+  type: 'Organization' | 'WebSite' | 'Article';
+  data: Record<string, any>;
+}
+
+export function StructuredData({ type, data }: StructuredDataProps) {
+  const baseUrl = 'https://openstandardagents.org';
+
+  const getStructuredData = (): object => {
+    switch (type) {
+      case 'Organization':
+        return {
+          '@context': 'https://schema.org',
+          '@type': 'Organization',
+          name: 'OSSA Standards Team',
+          url: baseUrl,
+          logo: `${baseUrl}/assets/brand/ossa-logo.svg`,
+          sameAs: [
+            'https://github.com/blueflyio/openstandardagents',
+            'https://www.npmjs.com/package/@bluefly/openstandardagents',
+          ],
+          ...data,
+        };
+      case 'WebSite':
+        return {
+          '@context': 'https://schema.org',
+          '@type': 'WebSite',
+          name: 'OSSA',
+          url: baseUrl,
+          description: 'Open Standard for Scalable AI Agents - The OpenAPI for AI Agents',
+          ...data,
+        };
+      case 'Article':
+        return {
+          '@context': 'https://schema.org',
+          '@type': 'Article',
+          headline: data.title,
+          datePublished: data.date,
+          author: {
+            '@type': 'Person',
+            name: data.author || 'OSSA Team',
+          },
+          publisher: {
+            '@type': 'Organization',
+            name: 'OSSA Standards Team',
+            logo: {
+              '@type': 'ImageObject',
+              url: `${baseUrl}/logo.png`,
+            },
+          },
+          ...data,
+        };
+      default:
+        return {};
+    }
+  };
+
+  return (
+    <script
+      type="application/ld+json"
+      dangerouslySetInnerHTML={{ __html: JSON.stringify(getStructuredData()) }}
+    />
+  );
+}
+