@bluefly/openstandardagents 0.2.5-RC → 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/examples/{AIFlow-Framework-Integration-with-OSSA.md → 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/v0.2.5-RC/ossa-0.2.5-RC.schema.json](https://github.com/blueflyio/openstandardagents/blob/development/spec/v0.2.5-RC/ossa-0.2.5-RC.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/v0.2.5-RC/ossa-0.2.5-RC.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.x/ossa-0.2.x.schema.json](https://github.com/blueflyio/openstandardagents/blob/main/spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json) (latest v0.2.x schema)
+- 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/{Installation.md → installation.md}

@@ -92,7 +92,7 @@ Commands:
 
 ### Package Contents
 
-- **JSON Schema**: `spec/v0.2.x/ossa-0.2.x.schema.json` (see latest in `spec/v0.2.5-RC/`)
+- **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
 

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

@@ -30,7 +30,7 @@ cd .agents/my-agent
 Edit `agent.yml`:
 
 ```yaml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 
 agent:
   id: my-agent

package/website/content/docs/integrations/aiflow.md

@@ -34,7 +34,7 @@ The OpenAPI 3.1 specification defines the REST API interface for the AIFlow agen
 
 ### OSSA Schema
 
-**Location**: [OSSA/spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json](https://github.com/blueflyio/openstandardagents/blob/development/spec/v0.2.5-RC/ossa-0.2.5-RC.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.
 
@@ -98,7 +98,7 @@ 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/v0.2.5-RC/ossa-0.2.5-RC.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/migration-guides/anthropic-mcp-to-ossa.md

@@ -317,7 +317,7 @@ buildkit agents create simple-agent \
 
 **2. Agent Manifest (`agent.yml`):**
 ```yaml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 agent:
   id: simple-agent
   name: simple-agent
@@ -707,7 +707,7 @@ server.connect(transport);
 
 **Agent Manifest (`agent.yml`):**
 ```yaml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 agent:
   id: filesystem-agent
   name: filesystem-agent
@@ -1124,7 +1124,7 @@ server.connect(transport);
 
 **Agent Manifest (`agent.yml`):**
 ```yaml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 agent:
   id: database-agent
   name: database-agent
@@ -1462,7 +1462,7 @@ bridge:
 
 ```yaml
 # orchestrator-agent.yml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 agent:
   id: orchestrator
   role: orchestration
@@ -1502,7 +1502,7 @@ agent:
 
 ```yaml
 # gateway-agent.yml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 agent:
   id: mcp-gateway
   role: workflow

package/website/content/docs/migration-guides/crewai-to-ossa.md

@@ -115,7 +115,7 @@ result = crew.kickoff()
 **Orchestrator Agent** (`orchestrator.ossa.yaml`):
 
 \`\`\`yaml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 agent:
   id: research-writing-orchestrator
   name: Research & Writing Orchestrator
@@ -170,7 +170,7 @@ agent:
 **Researcher Agent** (`researcher.ossa.yaml`):
 
 \`\`\`yaml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 agent:
   id: ai-researcher
   name: AI Research Agent
@@ -203,7 +203,7 @@ agent:
 **Writer Agent** (`writer.ossa.yaml`):
 
 \`\`\`yaml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 agent:
   id: technical-writer
   name: Technical Writer Agent

package/website/content/docs/migration-guides/drupal-eca-to-ossa.md

@@ -152,7 +152,7 @@ events:
 
 **OSSA Agent (Webhook Integration):**
 ```yaml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 agent:
   id: drupal-content-handler
   name: Drupal Content Handler Agent
@@ -225,7 +225,7 @@ conditions:
 
 **OSSA Agent (Schema + Policy Enforcement):**
 ```yaml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 agent:
   id: content-moderator
   name: Content Moderation Agent
@@ -283,7 +283,7 @@ actions:
 
 **OSSA Agent (Multi-Capability):**
 ```yaml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 agent:
   id: content-processor
   name: Content Processing Agent
@@ -475,7 +475,7 @@ workflow:
 
 **OSSA Orchestrator Agent:**
 ```yaml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 agent:
   id: content-workflow-orchestrator
   name: Content Workflow Orchestrator
@@ -673,7 +673,7 @@ actions:
 
 ```yaml
 # drupal-content-moderator.ossa.yaml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 
 agent:
   id: drupal-content-moderator
@@ -962,7 +962,7 @@ actions:
 
 ```yaml
 # user-onboarding-agent.ossa.yaml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 
 agent:
   id: user-onboarding-orchestrator
@@ -1272,7 +1272,7 @@ actions:
 
 ```yaml
 # commerce-order-processor.ossa.yaml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 
 agent:
   id: commerce-order-processor

package/website/content/docs/migration-guides/langchain-to-ossa.md

@@ -173,7 +173,7 @@ print(result)
 **Step 1: Create agent manifest** - `.agents/assistant-agent/agent.yml`
 
 ```yaml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 metadata:
   name: assistant-agent
   version: "1.0.0"
@@ -471,7 +471,7 @@ agent.run("What's my name?")  # Should remember "Alice"
 **Agent manifest** - `.agents/conversational-agent/agent.yml`
 
 ```yaml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 metadata:
   name: conversational-agent
   version: "1.0.0"
@@ -799,7 +799,7 @@ print(f"Story: {result['story']}")
 **Agent manifest** - `.agents/story-writer-agent/agent.yml`
 
 ```yaml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 metadata:
   name: story-writer-agent
   version: "1.0.0"
@@ -1257,7 +1257,7 @@ final = editor.run(f"Edit this draft: {draft}")
 Use orchestrator agent with A2A (Agent-to-Agent) communication:
 
 ```yaml
-ossaVersion: "0.2.5-RC"
+ossaVersion: "0.2.6"
 agent:
   id: article-orchestrator
   name: Article Orchestrator

package/website/content/docs/openapi-extensions/index.md

@@ -395,7 +395,7 @@ See [Full Documentation](https://github.com/blueflyio/openstandardagents/blob/ma
 - **Full Documentation**: [docs/openapi-extensions.md](https://github.com/blueflyio/openstandardagents/blob/main/docs/openapi-extensions.md)
 - **JSON Schema**: [docs/schemas/openapi-extensions.schema.json](https://github.com/blueflyio/openstandardagents/blob/main/docs/schemas/openapi-extensions.schema.json)
 - **Examples**: [examples/openapi-extensions/](https://github.com/blueflyio/openstandardagents/tree/main/examples/openapi-extensions)
-- **OSSA Specification**: [spec/v0.2.5-RC/OSSA-SPECIFICATION-v0.2.x.md](https://github.com/blueflyio/openstandardagents/blob/main/spec/v0.2.5-RC/OSSA-SPECIFICATION-v0.2.2.md)
+- **OSSA Specification**: [spec/v0.2.6/OSSA-SPECIFICATION-v0.2.x.md](https://github.com/blueflyio/openstandardagents/blob/main/spec/v0.2.6/OSSA-SPECIFICATION-v0.2.2.md)
 - **npm Package**: [@bluefly/openstandardagents](https://www.npmjs.com/package/@bluefly/openstandardagents)
 
 ---

package/website/content/docs/ossa-compliant-badge.md

@@ -234,7 +234,7 @@ extensions:
 
 ## Resources
 
-- **OSSA Specification**: [spec/v0.2.5-RC/](Specification/v0.2.3/)
+- **OSSA Specification**: [spec/v0.2.6/](Specification/v0.2.3/)
 - **Examples**: [examples/](Examples/)
 - **CLI Documentation**: [docs/cli/](./cli/)
 - **Contributing**: [CONTRIBUTING.md](../CONTRIBUTING.md)

package/website/content/docs/pre-release/index.md

@@ -112,8 +112,8 @@ git clone https://github.com/blueflyio/openstandardagents.git
 cd openstandardagents
 
 # View development specs
-ls spec/v0.2.5-RC/
-ls spec/v0.2.5-RC/
+ls spec/v0.2.6/
+ls spec/v0.2.6/
 ```
 
 ### Validation
@@ -130,9 +130,9 @@ ossa validate your-agent.yaml --version 0.2.4-dev
 
 Development examples are in the spec directories:
 
-- `spec/v0.2.5-RC/examples/customer-support-graph.ossa.yaml` - Sequential process
-- `spec/v0.2.5-RC/examples/research-team.ossa.yaml` - Hierarchical process
-- `spec/v0.2.5-RC/examples/parallel-processors.ossa.yaml` - Parallel process
+- `spec/v0.2.6/examples/customer-support-graph.ossa.yaml` - Sequential process
+- `spec/v0.2.6/examples/research-team.ossa.yaml` - Hierarchical process
+- `spec/v0.2.6/examples/parallel-processors.ossa.yaml` - Parallel process
 
 ---