@bluefly/openstandardagents 0.2.4 → 0.2.7

package/website/content/docs/errors/index.md

@@ -0,0 +1,10 @@
+# Error Reference
+
+Common errors and solutions.
+
+**Total Error Types**: 0
+
+## Getting Help
+
+- Check [Troubleshooting Guide](../troubleshooting/)
+- Open an issue on [GitLab](https://gitlab.com/blueflyio/openstandardagents/-/issues)

package/website/content/docs/{AIFlow-Framework-Integration-with-OSSA.md → examples/aiflow-framework-integration-with-ossa.md}

@@ -38,7 +38,7 @@ The OpenAPI 3.1 specification defines the REST API interface for the AIFlow agen
 
 ### OSSA Schema
 
-**Location**: [OSSA/spec/v1.0/ossa-1.0.schema.json](https://github.com/blueflyio/openstandardagents/blob/development/spec/v1.0/ossa-1.0.schema.json)
+**Location**: [OSSA/spec/v0.2.6/ossa-0.2.6.schema.json](https://github.com/blueflyio/openstandardagents/blob/development/spec/v0.2.6/ossa-0.2.6.schema.json)
 
 JSON Schema definition for OSSA 1.0 manifest validation. All agent manifests must conform to this schema.
 
@@ -102,6 +102,6 @@ This generates Kubernetes manifests and deploys the agent with:
 - **AIFlow Repository**: https://github.com/AIFlow-agent/AIFlow-Agent
 - **OSSA Project**: [openapi-ai-agents-standard](https://github.com/blueflyio/openstandardagents)
 - **Integration Guide**: [agent-buildkit Wiki](https://github.com/blueflyio/openstandardagents/wiki/AIFlow-Integration-with-OSSA-BuildKit-and-K-Agent)
-- **OSSA Specification Schema**: [OSSA 1.0 Schema](https://github.com/blueflyio/openstandardagents/blob/development/spec/v1.0/ossa-1.0.schema.json)
+- **OSSA Specification Schema**: [OSSA 1.0 Schema](https://github.com/blueflyio/openstandardagents/blob/development/spec/v0.2.6/ossa-0.2.6.schema.json)
 - **Example Manifest**: [social-agent-aiflow.ossa.yaml](https://github.com/blueflyio/openstandardagents/blob/development/examples/aiflow-integration/social-agent-aiflow.ossa.yaml)
 - **OpenAPI Spec**: [aiflow-agent.openapi.yml](https://github.com/blueflyio/openstandardagents/blob/development/openapi/aiflow-agent.openapi.yml)

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

@@ -0,0 +1,300 @@
+# 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 → students-researchers.md}

@@ -56,7 +56,7 @@ Research migration patterns:
 
 ### Papers & Publications
 
-- OSSA Specification: [spec/v0.2.2/ossa-0.2.2.schema.json](https://github.com/blueflyio/openstandardagents/blob/main/spec/v0.2.2/ossa-0.2.2.schema.json)
+- 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

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

@@ -0,0 +1,92 @@
+---
+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

@@ -19,7 +19,7 @@ Install OSSA CLI and get ready to create your first agent.
 Install OSSA CLI globally for use across all projects:
 
 ```bash
-npm install -g @bluefly/openstandardagents
+npm install -g @bluefly/open-standards-scalable-agents
 ```
 
 Verify installation:
@@ -33,7 +33,7 @@ ossa --version
 Install in a specific project:
 
 ```bash
-npm install --save-dev @bluefly/openstandardagents
+npm install --save-dev @bluefly/open-standards-scalable-agents
 ```
 
 Use via npx:
@@ -92,7 +92,7 @@ Commands:
 
 ### Package Contents
 
-- **JSON Schema**: `spec/v0.2.2/ossa-0.2.2.schema.json`
+- **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
 
@@ -115,7 +115,7 @@ export PATH="$(npm config get prefix)/bin:$PATH"
 On Linux/macOS, you may need sudo:
 
 ```bash
-sudo npm install -g @bluefly/openstandardagents
+sudo npm install -g @bluefly/open-standards-scalable-agents
 ```
 
 Or configure npm to use a different directory:
@@ -135,10 +135,10 @@ If you have multiple versions:
 npm list -g --depth=0
 
 # Uninstall old version
-npm uninstall -g @bluefly/openstandardagents
+npm uninstall -g @bluefly/open-standards-scalable-agents
 
 # Install latest
-npm install -g @bluefly/openstandardagents@latest
+npm install -g @bluefly/open-standards-scalable-agents@latest
 ```
 
 ## Next Steps
@@ -151,5 +151,5 @@ npm install -g @bluefly/openstandardagents@latest
 
 - [5-Minute Overview](5-Minute-Overview)
 - [Hello World Tutorial](Hello-World)
-- [CLI Reference](../quick-reference)
+- [CLI Reference](../Technical/CLI-Reference)