@bluefly/openstandardagents 0.1.9

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "@bluefly/openstandardagents",
+  "version": "0.1.9",
+  "description": "OSSA v0.1.9 - Open Standards for Scalable Agents Specification",
+  "type": "module",
+  "main": "dist/types/index.js",
+  "types": "dist/types/index.d.ts",
+  "bin": {
+    "ossa": "dist/cli/ossa-cli.js",
+    "ossa-deploy": "dist/cli/agent-deployment.js"
+  },
+  "scripts": {
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "build": "tsc && chmod +x dist/cli/*.js",
+    "build:cli": "tsc && chmod +x dist/cli/*.js && npm link",
+    "build:server": "tsc && npm run generate:client",
+    "build:all": "npm run build:server && npm run build:cli",
+    "start": "node dist/server/simple-app.js",
+    "start:complex": "node dist/server/app.js",
+    "start:dev": "nodemon --exec ts-node src/server/app.ts",
+    "start:prod": "NODE_ENV=production npm start",
+    "generate:client": "openapi-typescript src/api/ossa-complete.openapi.yml -o src/types/api-client.ts",
+    "generate:docs": "swagger-cli validate src/api/ossa-complete.openapi.yml && echo 'OpenAPI 3.1 validation passed'",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write 'src/**/*.ts' 'tests/**/*.ts'",
+    "api:generate": "openapi-typescript src/api/specification.openapi.yml -o src/types/api.ts",
+    "api:validate": "npx @redocly/cli lint src/api/specification.openapi.yml",
+    "api:validate:complete": "npx @redocly/cli lint src/api/ossa-complete.openapi.yml",
+    "api:validate:ecosystem": "cd ../agent_buildkit && npm run ecosystem:validate",
+    "api:bundle": "npx @redocly/cli bundle src/api/ossa-complete.openapi.yml --output dist/ossa-complete.json",
+    "api:docs": "npx @redocly/cli preview src/api/ossa-complete.openapi.yml",
+    "api:docs:build": "npx @redocly/cli build-docs src/api/ossa-complete.openapi.yml --output dist/api-docs/index.html",
+    "api:docs:serve": "npx @redocly/cli preview src/api/ossa-complete.openapi.yml",
+    "validate:specs": "npm run api:validate && npm run api:validate:complete && npm run validate:schemas",
+    "validate:schemas": "node scripts/validate-schemas.cjs",
+    "cli:link": "npm link",
+    "cli:unlink": "npm unlink -g @ossa/specification",
+    "deploy:agents": "ossa-deploy deploy --all",
+    "server:health": "curl -f http://localhost:3000/health || exit 1",
+    "server:docs": "open http://localhost:3000/docs",
+    "precommit": "npm run lint && npm run test",
+    "clean": "rm -rf dist coverage"
+  },
+  "keywords": [
+    "ossa",
+    "specification",
+    "standard",
+    "openapi",
+    "ai-agents",
+    "acdl",
+    "protocol"
+  ],
+  "author": "Bluefly.io",
+  "license": "MIT",
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.0",
+    "compression": "^1.7.4",
+    "cors": "^2.8.5",
+    "express": "^4.18.2",
+    "express-rate-limit": "^7.1.5",
+    "express-validator": "^7.0.1",
+    "helmet": "^7.1.0",
+    "js-yaml": "^4.1.0",
+    "openapi-types": "^12.1.3",
+    "swagger-ui-express": "^5.0.0",
+    "uuid": "^9.0.1",
+    "yaml": "^2.8.1",
+    "zod": "^4.1.5"
+  },
+  "devDependencies": {
+    "@redocly/cli": "^2.1.5",
+    "@types/chalk": "^0.4.31",
+    "@types/commander": "^2.12.0",
+    "@types/compression": "^1.7.5",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^4.17.21",
+    "@types/jest": "^29.5.11",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.10.5",
+    "@types/node-fetch": "^2.6.6",
+    "@types/swagger-ui-express": "^4.1.6",
+    "@types/uuid": "^9.0.7",
+    "@typescript-eslint/eslint-plugin": "^6.15.0",
+    "@typescript-eslint/parser": "^6.15.0",
+    "eslint": "^8.56.0",
+    "jest": "^29.7.0",
+    "nodemon": "^3.0.2",
+    "openapi-typescript": "^6.7.3",
+    "prettier": "^3.1.1",
+    "supertest": "^6.3.3",
+    "swagger-cli": "^4.0.4",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.6.2",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/public/api-docs.html

@@ -0,0 +1,206 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>OSSA API Documentation</title>
+    <meta name="description" content="OSSA - Open Standards for Scalable Agents API Documentation">
+    
+    <!-- Redocly CDN -->
+    <script src="https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js"></script>
+    
+    <style>
+        body {
+            margin: 0;
+            padding: 0;
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif;
+        }
+        .header {
+            background: linear-gradient(135deg, #0066cc 0%, #004499 100%);
+            color: white;
+            padding: 1rem 2rem;
+            box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+            display: flex;
+            align-items: center;
+            gap: 1rem;
+        }
+        .header .logo {
+            font-size: 2rem;
+            line-height: 1;
+        }
+        .header h1 {
+            margin: 0;
+            font-size: 1.5rem;
+            font-weight: 600;
+        }
+        .header p {
+            margin: 0.5rem 0 0 0;
+            opacity: 0.9;
+            font-size: 0.9rem;
+        }
+        .nav-tabs {
+            background: #f5f5f5;
+            border-bottom: 1px solid #ddd;
+            padding: 0 2rem;
+            display: flex;
+            gap: 1rem;
+            overflow-x: auto;
+        }
+        .nav-tab {
+            padding: 1rem 1.5rem;
+            cursor: pointer;
+            border-bottom: 3px solid transparent;
+            transition: all 0.2s;
+            white-space: nowrap;
+            text-decoration: none;
+            color: #333;
+            font-weight: 500;
+        }
+        .nav-tab:hover {
+            background: white;
+            border-bottom-color: #0066cc;
+        }
+        .nav-tab.active {
+            background: white;
+            border-bottom-color: #0066cc;
+            color: #0066cc;
+        }
+        #redoc-container {
+            min-height: calc(100vh - 140px);
+        }
+        .footer {
+            background: #263238;
+            color: white;
+            padding: 2rem;
+            text-align: center;
+            margin-top: 4rem;
+        }
+        .footer a {
+            color: #64b5f6;
+            text-decoration: none;
+        }
+        .footer a:hover {
+            text-decoration: underline;
+        }
+        .api-selector {
+            position: absolute;
+            top: 1rem;
+            right: 2rem;
+            background: rgba(255,255,255,0.1);
+            border: 1px solid rgba(255,255,255,0.3);
+            padding: 0.5rem 1rem;
+            border-radius: 4px;
+            color: white;
+            cursor: pointer;
+        }
+        .api-selector select {
+            background: transparent;
+            border: none;
+            color: white;
+            font-size: 0.9rem;
+            cursor: pointer;
+            outline: none;
+        }
+        .api-selector select option {
+            background: #263238;
+        }
+    </style>
+</head>
+<body>
+    <div class="header">
+        <div class="logo">⚡</div>
+        <div>
+            <h1>OSSA Documentation</h1>
+            <p>Open Standards for Scalable Agents - v0.1.9</p>
+        </div>
+        <div class="api-selector">
+            <select id="apiSelector" onchange="loadAPI(this.value)">
+                <option value="ossa-complete">Complete API</option>
+                <option value="specification">Core Specification</option>
+                <option value="orchestration">Orchestration API</option>
+            </select>
+        </div>
+    </div>
+    
+    <div class="nav-tabs">
+        <a href="/index.html" class="nav-tab">Home</a>
+        <a href="/api-docs.html" class="nav-tab active">API Reference</a>
+        <a href="/docs/specification/agents.html" class="nav-tab">Agent Specification</a>
+        <a href="/docs/development/roadmap.html" class="nav-tab">Roadmap</a>
+        <a href="https://gitlab.bluefly.io/llm/ossa" class="nav-tab" target="_blank">GitLab →</a>
+    </div>
+    
+    <div id="redoc-container"></div>
+    
+    <div class="footer">
+        <p>© 2024 OSSA - Open Standards for Scalable Agents</p>
+        <p>
+            <a href="https://gitlab.bluefly.io/llm/ossa">GitLab</a> • 
+            <a href="https://gitlab.bluefly.io/llm/agent_buildkit">Agent BuildKit</a> • 
+            <a href="/docs">Documentation</a>
+        </p>
+    </div>
+    
+    <script>
+        const apiSpecs = {
+            'ossa-complete': 'src/api/ossa-complete.openapi.yml',
+            'specification': 'src/api/specification.openapi.yml',
+            'orchestration': 'src/api/orchestration.openapi.yml'
+        };
+        
+        function loadAPI(apiKey) {
+            const specUrl = apiSpecs[apiKey] || apiSpecs['ossa-complete'];
+            
+            // Clear existing content
+            document.getElementById('redoc-container').innerHTML = '';
+            
+            // Initialize Redoc with the selected API spec
+            Redoc.init(specUrl, {
+                scrollYOffset: 50,
+                theme: {
+                    colors: {
+                        primary: {
+                            main: '#0066cc'
+                        }
+                    },
+                    logo: {
+                        gutter: '0px'
+                    },
+                    typography: {
+                        fontSize: '14px',
+                        lineHeight: '1.6',
+                        code: {
+                            fontSize: '13px',
+                            backgroundColor: '#f5f5f5'
+                        }
+                    },
+                    rightPanel: {
+                        backgroundColor: '#263238'
+                    },
+                    codeBlock: {
+                        backgroundColor: '#263238'
+                    }
+                },
+                nativeScrollbars: false,
+                disableSearch: false,
+                hideDownloadButton: false,
+                onlyRequiredInSamples: false,
+                generateCodeSamples: {
+                    languages: [
+                        { lang: 'curl' },
+                        { lang: 'javascript', label: 'JavaScript' },
+                        { lang: 'python', label: 'Python' },
+                        { lang: 'go', label: 'Go' },
+                        { lang: 'php', label: 'PHP' }
+                    ]
+                }
+            }, document.getElementById('redoc-container'));
+        }
+        
+        // Load the default API on page load
+        document.addEventListener('DOMContentLoaded', function() {
+            loadAPI('ossa-complete');
+        });
+    </script>
+</body>
+</html>

package/public/assets/favicon.svg

@@ -0,0 +1,8 @@
+<svg width="32" height="32" viewBox="0 0 32 32" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect width="32" height="32" rx="6" fill="#2563eb"/>
+  <path d="M8 16C8 11.5817 11.5817 8 16 8C20.4183 8 24 11.5817 24 16C24 20.4183 20.4183 24 16 24C11.5817 24 8 20.4183 8 16Z" stroke="white" stroke-width="2"/>
+  <circle cx="16" cy="12" r="2" fill="white"/>
+  <circle cx="12" cy="20" r="2" fill="white"/>
+  <circle cx="20" cy="20" r="2" fill="white"/>
+  <path d="M16 14L14 18L18 18Z" stroke="white" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/public/assets/script.js

@@ -0,0 +1,279 @@
+// OSSA Documentation Site JavaScript
+
+document.addEventListener('DOMContentLoaded', function() {
+    // Smooth scrolling for navigation links
+    const navLinks = document.querySelectorAll('a[href^="#"]');
+    
+    navLinks.forEach(link => {
+        link.addEventListener('click', function(e) {
+            e.preventDefault();
+            
+            const targetId = this.getAttribute('href');
+            const targetSection = document.querySelector(targetId);
+            
+            if (targetSection) {
+                const headerHeight = document.querySelector('.header').offsetHeight;
+                const targetPosition = targetSection.offsetTop - headerHeight - 20;
+                
+                window.scrollTo({
+                    top: targetPosition,
+                    behavior: 'smooth'
+                });
+            }
+        });
+    });
+    
+    // Add active state to navigation based on scroll position
+    function updateActiveNav() {
+        const sections = document.querySelectorAll('section[id]');
+        const navLinks = document.querySelectorAll('.nav-link[href^="#"]');
+        
+        let current = '';
+        
+        sections.forEach(section => {
+            const sectionTop = section.offsetTop;
+            const sectionHeight = section.clientHeight;
+            const scrollPosition = window.pageYOffset + 100;
+            
+            if (scrollPosition >= sectionTop && scrollPosition < sectionTop + sectionHeight) {
+                current = section.getAttribute('id');
+            }
+        });
+        
+        navLinks.forEach(link => {
+            link.classList.remove('active');
+            if (link.getAttribute('href') === `#${current}`) {
+                link.classList.add('active');
+            }
+        });
+    }
+    
+    // Throttled scroll listener
+    let scrollTimeout;
+    window.addEventListener('scroll', function() {
+        if (scrollTimeout) {
+            clearTimeout(scrollTimeout);
+        }
+        scrollTimeout = setTimeout(updateActiveNav, 10);
+    });
+    
+    // Copy code blocks functionality
+    function addCopyButtons() {
+        const codeBlocks = document.querySelectorAll('pre code');
+        
+        codeBlocks.forEach((codeBlock, index) => {
+            const pre = codeBlock.parentElement;
+            const copyButton = document.createElement('button');
+            
+            copyButton.innerHTML = `
+                <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                    <rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect>
+                    <path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path>
+                </svg>
+            `;
+            
+            copyButton.className = 'copy-button';
+            copyButton.title = 'Copy code';
+            
+            copyButton.addEventListener('click', async function() {
+                try {
+                    await navigator.clipboard.writeText(codeBlock.textContent);
+                    
+                    // Visual feedback
+                    this.innerHTML = `
+                        <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                            <polyline points="20,6 9,17 4,12"></polyline>
+                        </svg>
+                    `;
+                    this.style.color = '#10b981';
+                    
+                    setTimeout(() => {
+                        this.innerHTML = `
+                            <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                                <rect x="9" y="9" width="13" height="13" rx="2" ry="2"></rect>
+                                <path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"></path>
+                            </svg>
+                        `;
+                        this.style.color = '';
+                    }, 2000);
+                    
+                } catch (err) {
+                    console.error('Failed to copy code:', err);
+                }
+            });
+            
+            pre.style.position = 'relative';
+            pre.appendChild(copyButton);
+        });
+    }
+    
+    // Add copy button styles
+    const copyButtonStyles = `
+        .copy-button {
+            position: absolute;
+            top: 12px;
+            right: 12px;
+            background: rgba(255, 255, 255, 0.1);
+            border: 1px solid rgba(255, 255, 255, 0.2);
+            border-radius: 6px;
+            padding: 8px;
+            color: #e2e8f0;
+            cursor: pointer;
+            transition: all 0.2s ease;
+            backdrop-filter: blur(10px);
+        }
+        
+        .copy-button:hover {
+            background: rgba(255, 255, 255, 0.2);
+            border-color: rgba(255, 255, 255, 0.3);
+        }
+        
+        .copy-button:active {
+            transform: scale(0.95);
+        }
+        
+        .nav-link.active {
+            color: var(--color-primary);
+            background-color: var(--bg-secondary);
+        }
+    `;
+    
+    const styleSheet = document.createElement('style');
+    styleSheet.textContent = copyButtonStyles;
+    document.head.appendChild(styleSheet);
+    
+    // Initialize copy buttons
+    addCopyButtons();
+    
+    // Mobile menu toggle (if needed)
+    function createMobileMenu() {
+        const nav = document.querySelector('.nav');
+        const header = document.querySelector('.header-content');
+        
+        if (window.innerWidth <= 768) {
+            const menuButton = document.createElement('button');
+            menuButton.innerHTML = `
+                <svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                    <line x1="3" y1="6" x2="21" y2="6"></line>
+                    <line x1="3" y1="12" x2="21" y2="12"></line>
+                    <line x1="3" y1="18" x2="21" y2="18"></line>
+                </svg>
+            `;
+            menuButton.className = 'mobile-menu-button';
+            menuButton.style.cssText = `
+                display: block;
+                background: none;
+                border: none;
+                color: var(--text-primary);
+                cursor: pointer;
+                padding: 8px;
+                margin-left: auto;
+            `;
+            
+            nav.style.display = 'none';
+            header.appendChild(menuButton);
+            
+            menuButton.addEventListener('click', function() {
+                const isVisible = nav.style.display !== 'none';
+                nav.style.display = isVisible ? 'none' : 'flex';
+                nav.style.flexDirection = 'column';
+                nav.style.position = 'absolute';
+                nav.style.top = '100%';
+                nav.style.left = '0';
+                nav.style.right = '0';
+                nav.style.background = 'var(--bg-primary)';
+                nav.style.border = '1px solid var(--border-color)';
+                nav.style.borderTop = 'none';
+                nav.style.padding = 'var(--spacing-md)';
+                nav.style.gap = 'var(--spacing-sm)';
+            });
+        }
+    }
+    
+    // Handle window resize
+    window.addEventListener('resize', function() {
+        createMobileMenu();
+    });
+    
+    // Initialize mobile menu
+    createMobileMenu();
+    
+    // Lazy loading for images (if any are added later)
+    function setupLazyLoading() {
+        const images = document.querySelectorAll('img[data-src]');
+        
+        if ('IntersectionObserver' in window) {
+            const imageObserver = new IntersectionObserver((entries, observer) => {
+                entries.forEach(entry => {
+                    if (entry.isIntersecting) {
+                        const img = entry.target;
+                        img.src = img.dataset.src;
+                        img.classList.remove('lazy');
+                        imageObserver.unobserve(img);
+                    }
+                });
+            });
+            
+            images.forEach(img => imageObserver.observe(img));
+        } else {
+            // Fallback for older browsers
+            images.forEach(img => {
+                img.src = img.dataset.src;
+                img.classList.remove('lazy');
+            });
+        }
+    }
+    
+    setupLazyLoading();
+    
+    // Add animation on scroll
+    function setupScrollAnimations() {
+        const observerOptions = {
+            threshold: 0.1,
+            rootMargin: '0px 0px -50px 0px'
+        };
+        
+        const observer = new IntersectionObserver((entries) => {
+            entries.forEach(entry => {
+                if (entry.isIntersecting) {
+                    entry.target.style.opacity = '1';
+                    entry.target.style.transform = 'translateY(0)';
+                }
+            });
+        }, observerOptions);
+        
+        // Observe elements that should animate
+        const animateElements = document.querySelectorAll('.feature-card, .quickstart-step, .docs-category');
+        animateElements.forEach(el => {
+            el.style.opacity = '0';
+            el.style.transform = 'translateY(20px)';
+            el.style.transition = 'opacity 0.6s ease, transform 0.6s ease';
+            observer.observe(el);
+        });
+    }
+    
+    setupScrollAnimations();
+    
+    // Performance monitoring
+    if ('performance' in window) {
+        window.addEventListener('load', function() {
+            setTimeout(() => {
+                const perfData = performance.getEntriesByType('navigation')[0];
+                console.log('Page load time:', perfData.loadEventEnd - perfData.loadEventStart, 'ms');
+            }, 0);
+        });
+    }
+});
+
+// Service worker registration for PWA capabilities (optional)
+if ('serviceWorker' in navigator) {
+    window.addEventListener('load', function() {
+        navigator.serviceWorker.register('/sw.js')
+            .then(registration => {
+                console.log('SW registered: ', registration);
+            })
+            .catch(registrationError => {
+                console.log('SW registration failed: ', registrationError);
+            });
+    });
+}