@bluefly/openstandardagents 0.2.7 → 0.2.8

package/website/content/docs/examples/catalog.md

@@ -1,300 +0,0 @@
-# Examples Catalog
-
-Auto-generated catalog of all OSSA agent examples.
-
-**Total Examples**: 19
-
-## Bridges
-
-### Crypto Market Analyst
-
-**Role**: `chat`
-
-OSSA agent with AIFlow-Agent bridge for social crypto analysis
-
-**File**: [`bridges/aiflow-bridge-example.yml`](https://github.com/blueflyio/openstandardagents/blob/main/examples/bridges/aiflow-bridge-example.yml)
-
-```bash
-ossa validate examples/bridges/aiflow-bridge-example.yml
-```
-
-### Kubernetes Operations Agent
-
-**Role**: `orchestration`
-
-OSSA agent with kagent.dev bridge for Kubernetes operations
-
-**File**: [`bridges/kagent-bridge-example.yml`](https://github.com/blueflyio/openstandardagents/blob/main/examples/bridges/kagent-bridge-example.yml)
-
-```bash
-ossa validate examples/bridges/kagent-bridge-example.yml
-```
-
-## Common_npm
-
-### Agent Router
-
-**Role**: `integration`
-
-Multi-provider LLM gateway with circuit breaker, intelligent routing, and failover.
-
-Features:
-- Multi-provider support (OpenAI, Anthropic, Google, etc.)
-- Intelligent routing based on model capabilities
-- Circuit breaker pattern for fault tolerance
-- Request/response caching
-- Cost optimization
-- Load balancing
-
-
-**File**: [`common_npm/agent-router.ossa.yaml`](https://github.com/blueflyio/openstandardagents/blob/main/examples/common_npm/agent-router.ossa.yaml)
-
-```bash
-ossa validate examples/common_npm/agent-router.ossa.yaml
-```
-
-## Drupal
-
-### GitLab ML Recommendation Engine
-
-**Role**: `integration`
-
-AI-powered customer success recommendation agent using RAG (Retrieval-Augmented Generation).
-
-**Pipeline Architecture:**
-1. Semantic search in Qdrant for similar successful cases
-2. GPT-4 generation with retrieved context
-3. Priority ranking based on customer health scores
-
-**Integrates with:**
-- GitLabMlRecommendationsService (RAG generation)
-- GitLabMlDashboardService (health metrics)
-- QdrantVectorService (semantic search)
-
-
-**File**: [`drupal/gitlab-ml-recommender.ossa.yaml`](https://github.com/blueflyio/openstandardagents/blob/main/examples/drupal/gitlab-ml-recommender.ossa.yaml)
-
-```bash
-ossa validate examples/drupal/gitlab-ml-recommender.ossa.yaml
-```
-
-## Enterprise
-
-### enterprise-ai-orchestrator
-
-Enterprise-grade AI orchestration platform with multi-model support
-
-**File**: [`enterprise/agent.yml`](https://github.com/blueflyio/openstandardagents/blob/main/examples/enterprise/agent.yml)
-
-```bash
-ossa validate examples/enterprise/agent.yml
-```
-
-## General
-
-### FedRAMP Compliance Scanner
-
-**Role**: `compliance`
-
-Automated FedRAMP compliance scanning agent that validates
-infrastructure against FedRAMP Moderate controls.
-
-
-**File**: [`compliance-agent.yml`](https://github.com/blueflyio/openstandardagents/blob/main/examples/compliance-agent.yml)
-
-```bash
-ossa validate examples/compliance-agent.yml
-```
-
-## Kagent
-
-### Kubernetes Troubleshooter
-
-**Role**: `monitoring`
-
-Autonomous Kubernetes cluster troubleshooting agent with diagnostic capabilities
-
-**File**: [`kagent/k8s-troubleshooter-v1.ossa.yaml`](https://github.com/blueflyio/openstandardagents/blob/main/examples/kagent/k8s-troubleshooter-v1.ossa.yaml)
-
-```bash
-ossa validate examples/kagent/k8s-troubleshooter-v1.ossa.yaml
-```
-
-## Minimal
-
-### hello-world
-
-Minimal OSSA-compliant agent example
-
-**File**: [`minimal/agent.yml`](https://github.com/blueflyio/openstandardagents/blob/main/examples/minimal/agent.yml)
-
-```bash
-ossa validate examples/minimal/agent.yml
-```
-
-## Production
-
-### Document Analyzer
-
-**Role**: `data_processing`
-
-Production document analysis agent with NLP capabilities
-
-**File**: [`production/agent.yml`](https://github.com/blueflyio/openstandardagents/blob/main/examples/production/agent.yml)
-
-```bash
-ossa validate examples/production/agent.yml
-```
-
-## Spec-examples
-
-### API Integration Bridge Agent
-
-**Role**: `integration`
-
-Universal API integration agent that connects external services,
-normalizes APIs, and provides unified access layer.
-
-
-**File**: [`spec-examples/integration-agent.yml`](https://github.com/blueflyio/openstandardagents/blob/main/examples/spec-examples/integration-agent.yml)
-
-```bash
-ossa validate examples/spec-examples/integration-agent.yml
-```
-
-### Code Generation & Testing Assistant
-
-**Role**: `development`
-
-AI-powered code generation agent with support for multiple languages,
-test generation, and code review capabilities.
-
-
-**File**: [`spec-examples/development-agent.yml`](https://github.com/blueflyio/openstandardagents/blob/main/examples/spec-examples/development-agent.yml)
-
-```bash
-ossa validate examples/spec-examples/development-agent.yml
-```
-
-### Customer Support Chat Agent
-
-**Role**: `chat`
-
-AI-powered customer support agent with natural language understanding,
-context retention, and integration with ticketing systems.
-
-
-**File**: [`spec-examples/chat-agent.yml`](https://github.com/blueflyio/openstandardagents/blob/main/examples/spec-examples/chat-agent.yml)
-
-```bash
-ossa validate examples/spec-examples/chat-agent.yml
-```
-
-### Data ETL Processing Agent
-
-**Role**: `data_processing`
-
-High-performance data extraction, transformation, and loading agent
-with support for multiple data sources and destinations.
-
-
-**File**: [`spec-examples/data-processing-agent.yml`](https://github.com/blueflyio/openstandardagents/blob/main/examples/spec-examples/data-processing-agent.yml)
-
-```bash
-ossa validate examples/spec-examples/data-processing-agent.yml
-```
-
-### Edge Processing Agent
-
-**Role**: `monitoring`
-
-Lightweight agent optimized for edge deployment with minimal
-resource requirements and offline capabilities.
-
-
-**File**: [`spec-examples/edge-agent.yml`](https://github.com/blueflyio/openstandardagents/blob/main/examples/spec-examples/edge-agent.yml)
-
-```bash
-ossa validate examples/spec-examples/edge-agent.yml
-```
-
-### FedRAMP Compliance Scanner
-
-**Role**: `compliance`
-
-Automated compliance scanning agent for FedRAMP Moderate environments.
-Scans infrastructure, code, and configurations for security vulnerabilities
-and compliance violations.
-
-
-**File**: [`spec-examples/compliance-agent.yml`](https://github.com/blueflyio/openstandardagents/blob/main/examples/spec-examples/compliance-agent.yml)
-
-```bash
-ossa validate examples/spec-examples/compliance-agent.yml
-```
-
-### Security Audit Agent
-
-**Role**: `audit`
-
-Automated security auditing agent that scans infrastructure,
-detects vulnerabilities, and generates compliance reports.
-
-
-**File**: [`spec-examples/audit-agent.yml`](https://github.com/blueflyio/openstandardagents/blob/main/examples/spec-examples/audit-agent.yml)
-
-```bash
-ossa validate examples/spec-examples/audit-agent.yml
-```
-
-### Serverless Function Agent
-
-**Role**: `custom`
-
-Serverless agent optimized for AWS Lambda, Google Cloud Functions,
-and Azure Functions with auto-scaling and cost optimization.
-
-
-**File**: [`spec-examples/serverless-agent.yml`](https://github.com/blueflyio/openstandardagents/blob/main/examples/spec-examples/serverless-agent.yml)
-
-```bash
-ossa validate examples/spec-examples/serverless-agent.yml
-```
-
-### System Health Monitoring Agent
-
-**Role**: `monitoring`
-
-Continuous system health monitoring with intelligent alerting
-and auto-remediation capabilities.
-
-
-**File**: [`spec-examples/monitoring-agent.yml`](https://github.com/blueflyio/openstandardagents/blob/main/examples/spec-examples/monitoring-agent.yml)
-
-```bash
-ossa validate examples/spec-examples/monitoring-agent.yml
-```
-
-### Workflow Orchestration Agent
-
-**Role**: `orchestration`
-
-Advanced workflow orchestration agent that coordinates multi-step processes,
-manages agent swarms, and provides intelligent task routing.
-
-
-**File**: [`spec-examples/workflow-agent.yml`](https://github.com/blueflyio/openstandardagents/blob/main/examples/spec-examples/workflow-agent.yml)
-
-```bash
-ossa validate examples/spec-examples/workflow-agent.yml
-```
-
-## Usage
-
-```bash
-# Validate any example
-ossa validate examples/<path>
-
-# Run an example
-ossa run examples/<path>
-```

package/website/content/docs/for-audiences/students-researchers.md

@@ -1,122 +0,0 @@
----
-title: "Students Researchers"
----
-
-# For Students & Researchers
-
-OSSA provides a standard format for studying, comparing, and researching AI agent architectures.
-
-## Why OSSA for Research?
-
-### Standard Format Enables Comparison
-
-Before OSSA, comparing agents across frameworks was difficult:
-- Different code structures
-- Framework-specific implementations
-- No standard metrics
-
-With OSSA:
-- ✅ Standard format enables direct comparison
-- ✅ Framework-agnostic research
-- ✅ Reproducible experiments
-- ✅ Academic paper support
-
-## Research Use Cases
-
-### 1. Agent Architecture Comparison
-
-Compare agent designs across frameworks:
-
-```yaml
-# LangChain agent → OSSA
-# Anthropic SDK agent → OSSA
-# Custom framework → OSSA
-# Compare capabilities, performance, cost
-```
-
-### 2. Multi-Agent System Research
-
-Study agent orchestration patterns:
-
-- Agent-to-agent communication
-- Workflow patterns
-- Failure recovery
-- Cost optimization
-
-### 3. Framework Migration Studies
-
-Research migration patterns:
-
-- Framework lock-in analysis
-- Portability metrics
-- Migration complexity
-- Performance impact
-
-## Academic Resources
-
-### Papers & Publications
-
-- OSSA Specification: [spec/v0.2.x/ossa-0.2.x.schema.json](https://github.com/blueflyio/openstandardagents/blob/main/spec/v0.2.6/ossa-0.2.6.schema.json) (latest v0.2.x schema)
-- Examples Library: [examples/](https://github.com/blueflyio/openstandardagents/tree/main/examples)
-
-### Research Questions
-
-1. **How do different LLM providers affect agent performance?**
-   - Compare OpenAI, Anthropic, Google agents in OSSA format
-   - Measure latency, cost, accuracy
-
-2. **What are optimal agent orchestration patterns?**
-   - Study multi-agent workflows
-   - Analyze failure recovery strategies
-
-3. **How does framework choice impact agent portability?**
-   - Measure migration effort
-   - Compare runtime performance
-
-## Getting Started for Research
-
-### Step 1: Understand the Standard
-
-Read the specification:
-- [Specification Deep-Dive](../Technical/Specification-Deep-Dive)
-- [Schema Reference](../Technical/Schema-Reference)
-
-### Step 2: Study Examples
-
-Review annotated examples:
-- [Hello World Complete](https://github.com/blueflyio/openstandardagents/blob/main/examples/getting-started/hello-world-complete.ossa.yaml)
-- [Integration Patterns](../Examples/Integration-Patterns)
-
-### Step 3: Create Research Agents
-
-Generate agents for your research:
-
-```bash
-ossa generate chat --name "research-agent-1"
-ossa generate workflow --name "research-agent-2"
-```
-
-### Step 4: Compare & Analyze
-
-Use OSSA format to:
-- Compare agent designs
-- Measure performance
-- Analyze costs
-- Study patterns
-
-## Contributing Research
-
-We welcome research contributions:
-
-1. **Case Studies**: Document your research findings
-2. **Pattern Analysis**: Share discovered patterns
-3. **Performance Studies**: Contribute benchmarks
-4. **Academic Papers**: Reference OSSA in publications
-
-## Related Resources
-
-- [Getting Started](../Getting-Started/5-Minute-Overview)
-- [Technical Documentation](../Technical/Specification-Deep-Dive)
-- [Examples & Patterns](../Examples/Getting-Started-Examples)
-- [Repository](https://github.com/blueflyio/openstandardagents)
-

package/website/content/docs/getting-started/index.md

@@ -1,92 +0,0 @@
----
-title: "Getting Started with OSSA"
-description: "Quick start guide for building your first OSSA agent"
----
-
-# Getting Started with OSSA
-
-## What is OSSA?
-
-OSSA (Open Standard for Scalable Agents) is a specification standard for AI agents, similar to how OpenAPI standardizes REST APIs.
-
-**OSSA is NOT a framework** - it's a standard that defines the contract.
-
-## Installation
-
-```bash
-npm install -g @bluefly/openstandardagents
-```
-
-## Quick Start
-
-### 1. Initialize a New Agent
-
-```bash
-ossa init my-agent --type worker
-cd .agents/my-agent
-```
-
-### 2. Edit Agent Manifest
-
-Edit `agent.yml`:
-
-```yaml
-apiVersion: ossa/v{{version}}
-
-agent:
-  id: my-agent
-  name: My Agent
-  version: "1.0.0"
-  role: worker
-  
-  runtime:
-    type: docker
-    
-  capabilities:
-    - name: process_data
-      description: Process incoming data
-      input_schema:
-        type: object
-        properties:
-          data:
-            type: string
-      output_schema:
-        type: object
-        properties:
-          result:
-            type: string
-```
-
-### 3. Validate
-
-```bash
-ossa validate agent.yml
-```
-
-### 4. Deploy
-
-OSSA doesn't dictate deployment. Deploy to YOUR infrastructure:
-- Docker / Kubernetes
-- AWS / GCP / Azure
-- On-premise
-- Serverless
-
-## CLI Commands
-
-- `ossa init <name>` - Initialize new agent project
-- `ossa validate <path>` - Validate against OSSA 1.0 schema
-- `ossa generate <type>` - Generate from template
-- `ossa migrate <source>` - Migrate v0.1.9 → 1.0
-
-## Next Steps
-
-- Review [Examples](/docs/examples/migration-guides)
-- Read the [Schema Reference](/docs/schema-reference)
-- Visit the [GitHub Repository](https://github.com/blueflyio/openstandardagents)
-
-## Need More Features?
-
-For production features like GitLab integration, Kubernetes deployment, and monitoring, see:
-
-**[agent-buildkit](https://github.com/blueflyio/openstandardagents)** - Reference implementation with production tooling
-

package/website/content/docs/getting-started/installation.md

@@ -1,155 +0,0 @@
----
-title: "Installation"
----
-
-# Installation Guide
-
-Install OSSA CLI and get ready to create your first agent.
-
-## Prerequisites
-
-- **Node.js** 18+ (for OSSA CLI)
-- **npm** or **yarn** package manager
-- Basic familiarity with YAML/JSON
-
-## Installation Methods
-
-### Method 1: Global Installation (Recommended)
-
-Install OSSA CLI globally for use across all projects:
-
-```bash
-npm install -g @bluefly/open-standards-scalable-agents
-```
-
-Verify installation:
-
-```bash
-ossa --version
-```
-
-### Method 2: Local Installation
-
-Install in a specific project:
-
-```bash
-npm install --save-dev @bluefly/open-standards-scalable-agents
-```
-
-Use via npx:
-
-```bash
-npx ossa --version
-```
-
-### Method 3: Using agent-buildkit (Production)
-
-For production deployments with full features:
-
-```bash
-npm install -g @bluefly/agent-buildkit
-```
-
-This includes OSSA validation plus:
-- GitLab integration
-- Kubernetes deployment
-- Production monitoring
-- Compliance tooling
-
-## Verify Installation
-
-Check that OSSA CLI is working:
-
-```bash
-ossa --help
-```
-
-You should see:
-
-```
-OSSA CLI - Open Standard for Scalable Agents (The OpenAPI for AI Agents)
-
-Usage: ossa [options] [command]
-
-Options:
-  -V, --version   output the version number
-  -h, --help      display help for command
-
-Commands:
-  validate <path>  Validate OSSA agent manifest or OpenAPI spec
-  generate <type>  Generate OSSA agent manifest from template
-  migrate <source> Migrate agent manifest between OSSA versions
-  help [command]   display help for command
-```
-
-## What Gets Installed
-
-### OSSA CLI Commands
-
-- `ossa validate` - Validate agent manifests against JSON Schema
-- `ossa generate` - Generate agent manifests from templates
-- `ossa migrate` - Migrate between OSSA versions
-
-### Package Contents
-
-- **JSON Schema**: `spec/v0.2.x/ossa-0.2.x.schema.json` (see latest in `spec/v0.2.6/`)
-- **TypeScript Types**: Available via package exports
-- **CLI Tool**: `bin/ossa` executable
-
-## Troubleshooting
-
-### Command Not Found
-
-If `ossa` command is not found:
-
-```bash
-# Check npm global bin path
-npm config get prefix
-
-# Add to PATH if needed
-export PATH="$(npm config get prefix)/bin:$PATH"
-```
-
-### Permission Errors
-
-On Linux/macOS, you may need sudo:
-
-```bash
-sudo npm install -g @bluefly/open-standards-scalable-agents
-```
-
-Or configure npm to use a different directory:
-
-```bash
-mkdir ~/.npm-global
-npm config set prefix '~/.npm-global'
-export PATH=~/.npm-global/bin:$PATH
-```
-
-### Version Conflicts
-
-If you have multiple versions:
-
-```bash
-# List global packages
-npm list -g --depth=0
-
-# Uninstall old version
-npm uninstall -g @bluefly/open-standards-scalable-agents
-
-# Install latest
-npm install -g @bluefly/open-standards-scalable-agents@latest
-```
-
-## Next Steps
-
-1. ✅ Installation complete
-2. → [Hello World Tutorial](Hello-World)
-3. → [First Agent Creation](First-Agent)
-
-## Related
-
-- [5-Minute Overview](5-Minute-Overview)
-- [Hello World Tutorial](Hello-World)
-- [CLI Reference](../Technical/CLI-Reference)
-