@bluefly/openstandardagents 0.2.4 → 0.2.7

package/{docs/OSSA-COMPLIANT-BADGE.md → website/content/docs/ossa-compliant-badge.md}

@@ -1,3 +1,7 @@
+---
+title: "OSSA COMPLIANT BADGE"
+---
+
 # OSSA Compliant Badge
 
 Display the **OSSA Compliant** badge in your project to show that your AI agent follows the Open Standard for AI Agents (OSSA) specification.
@@ -9,16 +13,16 @@ Display the **OSSA Compliant** badge in your project to show that your AI agent
 ### Markdown
 
 ```markdown
-[![OSSA Compliant](https://img.shields.io/badge/OSSA-Compliant-00B8D4.svg)](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard)
+[![OSSA Compliant](https://img.shields.io/badge/OSSA-Compliant-00B8D4.svg)](https://github.com/blueflyio/openstandardagents)
 ```
 
 **Result**:
-[![OSSA Compliant](https://img.shields.io/badge/OSSA-Compliant-00B8D4.svg)](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard)
+[![OSSA Compliant](https://img.shields.io/badge/OSSA-Compliant-00B8D4.svg)](https://github.com/blueflyio/openstandardagents)
 
 ### HTML
 
 ```html
-<a href="https://gitlab.bluefly.io/llm/openapi-ai-agents-standard">
+<a href="https://github.com/blueflyio/openstandardagents">
   <img src="https://img.shields.io/badge/OSSA-Compliant-00B8D4.svg" alt="OSSA Compliant">
 </a>
 ```
@@ -27,7 +31,7 @@ Display the **OSSA Compliant** badge in your project to show that your AI agent
 
 ```rst
 .. image:: https://img.shields.io/badge/OSSA-Compliant-00B8D4.svg
-   :target: https://gitlab.bluefly.io/llm/openapi-ai-agents-standard
+   :target: https://github.com/blueflyio/openstandardagents
    :alt: OSSA Compliant
 ```
 
@@ -59,7 +63,7 @@ To display the OSSA Compliant badge, your project must:
 
 ```bash
 # Install OSSA CLI
-npm install -g @bluefly/open-standards-scalable-agents
+npm install -g @bluefly/openstandardagents
 
 # Validate your manifest
 ossa validate path/to/your-agent.ossa.yaml
@@ -74,7 +78,7 @@ ossa-validation:
   stage: test
   image: node:20-alpine
   script:
-    - npm install -g @bluefly/open-standards-scalable-agents
+    - npm install -g @bluefly/openstandardagents
     - ossa validate agents/*.ossa.yaml
 ```
 
@@ -91,7 +95,7 @@ jobs:
       - uses: actions/setup-node@v3
         with:
           node-version: '20'
-      - run: npm install -g @bluefly/open-standards-scalable-agents
+      - run: npm install -g @bluefly/openstandardagents
       - run: ossa validate agents/*.ossa.yaml
 ```
 
@@ -128,9 +132,9 @@ Projects that have achieved OSSA compliance:
 
 | Project | Level | Version | Link |
 |---------|-------|---------|------|
-| Agent Buildkit | Advanced | v0.2.3 | [GitLab](https://gitlab.bluefly.io/llm/npm/agent-buildkit) |
-| Agent Studio | Advanced | v0.2.3 | [GitLab](https://gitlab.bluefly.io/llm/demos/llm-platform-demo) |
-| KAgent | Advanced | v0.2.3 | [GitLab](https://gitlab.bluefly.io/llm/npm/kagent) |
+| Agent Buildkit | Advanced | v0.2.3 | [GitHub](https://github.com/blueflyio/openstandardagents) |
+| Agent Studio | Advanced | v0.2.3 | [GitHub](https://github.com/blueflyio/openstandardagents) |
+| KAgent | Advanced | v0.2.3 | [GitHub](https://github.com/blueflyio/openstandardagents) |
 
 **Add your project**: Submit a merge request to update this table!
 
@@ -230,16 +234,15 @@ extensions:
 
 ## Resources
 
-- **OSSA Specification**: [spec/v0.2.3/](../spec/v0.2.3/)
-- **Examples**: [examples/](../examples/)
+- **OSSA Specification**: [spec/v0.2.6/](Specification/v0.2.3/)
+- **Examples**: [examples/](Examples/)
 - **CLI Documentation**: [docs/cli/](./cli/)
 - **Contributing**: [CONTRIBUTING.md](../CONTRIBUTING.md)
-- **GitLab Repository**: https://gitlab.bluefly.io/llm/openapi-ai-agents-standard
-- **GitHub Mirror**: https://github.com/BlueflyCollective/OSSA
+- **GitHub Repository**: https://github.com/blueflyio/openstandardagents
 
 ---
 
-**Questions?** Open an issue on [GitLab](https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/-/issues)
+**Questions?** Open an issue on [GitHub](https://github.com/blueflyio/openstandardagents/issues)
 
 **Want to contribute?** See [CONTRIBUTING.md](../CONTRIBUTING.md)
 

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

@@ -46,17 +46,17 @@ OSSA follows semantic versioning. Development specs are marked with `-dev` suffi
 
 ---
 
-### v0.2.5-dev - Multi-Agent Composition
+### v0.2.5-RC-dev - Multi-Agent Composition
 
 **Status**: Development
 **Target Release**: March 2025
-**Milestone**: [v0.2.5 - Multi-Agent Composition](https://github.com/blueflyio/openstandardagents/milestones/13)
+**Milestone**: [v0.2.5-RC - Multi-Agent Composition](https://github.com/blueflyio/openstandardagents/milestones/13)
 
 #### New Features
 
 1. **AgentGraph Resource Type**
    ```yaml
-   apiVersion: ossa/v0.2.5
+   apiVersion: ossa/v0.2.5-RC
    kind: AgentGraph  # New!
    metadata:
      name: customer-support-cluster
@@ -112,8 +112,8 @@ git clone https://github.com/blueflyio/openstandardagents.git
 cd openstandardagents
 
 # View development specs
-ls spec/v0.2.4-dev/
-ls spec/v0.2.5-dev/
+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-dev/examples/customer-support-graph.ossa.yaml` - Sequential process
-- `spec/v0.2.5-dev/examples/research-team.ossa.yaml` - Hierarchical process
-- `spec/v0.2.5-dev/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
 
 ---
 
@@ -152,7 +152,7 @@ We welcome feedback on development specifications:
 - [#224 - Google ADK extension](https://github.com/blueflyio/openstandardagents/issues/224)
 - [#225 - MS AF adapter](https://github.com/blueflyio/openstandardagents/issues/225)
 
-### v0.2.5 Issues
+### v0.2.5-RC Issues
 - [#211-212 - AgentGraph resource](https://github.com/blueflyio/openstandardagents/issues/211)
 - [#213 - Process patterns](https://github.com/blueflyio/openstandardagents/issues/213)
 - [#214 - Edge routing](https://github.com/blueflyio/openstandardagents/issues/214)
@@ -168,7 +168,7 @@ We welcome feedback on development specifications:
 |---------|-------|--------|--------|
 | v0.2.3 | Documentation & Examples | **Stable** | Released |
 | v0.2.4 | Transport & Security | Development | Feb 2025 |
-| v0.2.5 | Multi-Agent Composition | Development | Mar 2025 |
+| v0.2.5-RC | Multi-Agent Composition | Development | Mar 2025 |
 | v0.3.0 | Gamma Release | Planned | Apr 2025 |
 | v1.0.0 | Genesis Release | Planned | TBD |
 

package/website/content/docs/readme.md

@@ -0,0 +1,35 @@
+---
+title: "README"
+---
+
+# OSSA Documentation
+
+## Core Documentation
+
+- **[Getting Started](Getting-Started)** - Quick start guide for OSSA
+- **[OpenAPI Extensions](OpenAPI-Extensions)** - How OSSA extends OpenAPI/Swagger for AI agents
+- **[Migration Guide](migration/)** - Upgrading from v0.1.x to v1.0
+- **[Specification](Specification/)** - OSSA 1.0 JSON Schema
+- **[Examples](Examples/)** - Reference implementations
+
+## Additional Resources
+
+For comprehensive documentation, guides, and architecture details, visit:
+
+**[GitHub Repository](https://github.com/blueflyio/openstandardagents)**
+
+The repository contains:
+- Architecture guides
+- Deployment strategies
+- Integration tutorials
+- Best practices
+- Community guidelines
+- Contributing guidelines
+
+## Quick Links
+
+- **Specification**: [spec/ossa-1.0.schema.json](Specification/ossa-1.0.schema.json)
+- **npm Package**: [@bluefly/openstandardagents](https://www.npmjs.com/package/@bluefly/openstandardagents)
+- **GitHub Repository**: [blueflyio/openstandardagents](https://github.com/blueflyio/openstandardagents)
+- **Issues**: [GitHub Issues](https://github.com/blueflyio/openstandardagents/issues)
+

package/website/content/docs/releases/v0.2.6.md

@@ -0,0 +1,99 @@
+# OSSA v0.2.6 Release Notes
+
+**Release Date:** November 26, 2025  
+**Type:** Bug Fixes & Documentation
+
+## Overview
+
+Version 0.2.6 focuses on critical bug fixes, documentation improvements, and website enhancements to improve the developer experience and project stability.
+
+## What's New
+
+### Website Enhancements
+
+#### Brand Identity & Design System
+- **New Design Token System**: Comprehensive color, typography, and spacing tokens
+- **Component Library**: Button, Card, and Badge components with full accessibility support
+- **Enterprise Messaging**: Updated homepage with vendor-neutral, compliance-ready positioning
+- **Comparison Matrix**: Visual comparison of OSSA vs LangChain, AutoGen, MCP, and Semantic Kernel
+
+#### Improved User Experience
+- Mobile-optimized typography and responsive design
+- Enhanced call-to-action buttons with better visual hierarchy
+- Improved contrast and WCAG 2.1 AA compliance
+- Card-based layouts across all pages
+
+### Bug Fixes
+
+- Fixed website deployment and version display issues
+- Resolved spec directory structure inconsistencies
+- Corrected version references across documentation
+
+### Documentation
+
+- Updated all version references to 0.2.6
+- Improved specification documentation
+- Enhanced integration guides
+
+## Breaking Changes
+
+None. This is a backward-compatible release.
+
+## Migration Guide
+
+No migration required. Update your package:
+
+```bash
+npm install @bluefly/openstandardagents@0.2.6
+```
+
+## Upgrade Instructions
+
+### For Existing Projects
+
+```bash
+# Update package
+npm install @bluefly/openstandardagents@latest
+
+# Verify installation
+ossa --version
+```
+
+### For New Projects
+
+```bash
+# Install globally
+npm install -g @bluefly/openstandardagents
+
+# Create new agent
+ossa init my-agent
+```
+
+## What's Next
+
+### v0.2.7 - Multi-Agent & Adapters
+- Enhanced multi-agent orchestration
+- Additional LLM provider integrations (Mistral Devstral)
+- Improved adapter system
+
+### v0.2.8 - Developer Experience
+- CLI enhancements
+- Better error messages
+- Improved validation feedback
+
+## Contributors
+
+Thank you to all contributors who made this release possible!
+
+## Resources
+
+- [Full Changelog](https://gitlab.com/blueflyio/openstandardagents/-/blob/main/CHANGELOG.md)
+- [Documentation](https://openstandardagents.org/docs)
+- [Examples](https://openstandardagents.org/examples)
+- [Issue Tracker](https://gitlab.com/blueflyio/openstandardagents/-/issues)
+
+## Support
+
+- [GitLab Issues](https://gitlab.com/blueflyio/openstandardagents/-/issues)
+- [Documentation](https://openstandardagents.org/docs)
+- [Community](https://gitlab.com/blueflyio/openstandardagents)

package/website/content/docs/schema-reference/agent-capabilities.md

@@ -0,0 +1,50 @@
+# agent.capabilities
+
+**Type**: `string`
+**Required**: Yes
+
+## Description
+
+The agent.capabilities field
+
+## Why This Field Exists
+
+Define what the agent can do, enabling capability-based routing and discovery
+
+## How to Use
+
+List all capabilities with input/output schemas and descriptions
+
+## Where It's Used
+
+Used by orchestrators to route tasks and by registry for discovery
+
+## Examples
+
+```yaml
+agent.capabilities: process_data
+```
+
+```yaml
+agent.capabilities: validate_compliance
+```
+
+```yaml
+agent.capabilities: generate_report
+```
+
+## Validation
+
+```bash
+ossa validate agent.ossa.yaml
+```
+
+## Related Fields
+
+- [agent.tools](./agent-tools.md)
+- [agent.role](./agent-role.md)
+
+## Related Documentation
+
+- [defining-capabilities](../guides/defining-capabilities.md)
+

package/website/content/docs/schema-reference/agent-id.md

@@ -0,0 +1,52 @@
+# agent.id
+
+**Type**: `string`
+**Required**: Yes
+
+## Description
+
+The agent.id field
+
+## Why This Field Exists
+
+Unique identifier for agent registration, API routing, and inter-agent communication
+
+## How to Use
+
+Use DNS-1123 subdomain format: lowercase alphanumeric with hyphens, max 63 chars
+
+## Where It's Used
+
+Used in API endpoints (/agents/{id}), Kubernetes resources, and registry URLs
+
+## Examples
+
+```yaml
+agent.id: my-agent
+```
+
+```yaml
+agent.id: data-processor-v2
+```
+
+```yaml
+agent.id: compliance-checker-prod
+```
+
+## Validation
+
+```bash
+ossa validate agent.ossa.yaml
+```
+
+## Related Fields
+
+- [agent.name](./agent-name.md)
+- [agent.version](./agent-version.md)
+- [agent.role](./agent-role.md)
+
+## Related Documentation
+
+- [ossa-validate](../cli-reference/ossa-validate.md)
+- [core-api](../api-reference/core-api.md)
+

package/website/content/docs/schema-reference/agent-name.md

@@ -0,0 +1,50 @@
+# agent.name
+
+**Type**: `string`
+**Required**: Yes
+
+## Description
+
+The agent.name field
+
+## Why This Field Exists
+
+Human-readable name for display in UIs and documentation
+
+## How to Use
+
+Use descriptive names that clearly indicate the agent's purpose
+
+## Where It's Used
+
+Displayed in agent lists, dashboards, and documentation
+
+## Examples
+
+```yaml
+agent.name: Data Processing Agent
+```
+
+```yaml
+agent.name: Compliance Checker
+```
+
+```yaml
+agent.name: Customer Support Bot
+```
+
+## Validation
+
+```bash
+ossa validate agent.ossa.yaml
+```
+
+## Related Fields
+
+- [agent.id](./agent-id.md)
+- [agent.description](./agent-description.md)
+
+## Related Documentation
+
+- [creating-agents](../guides/creating-agents.md)
+

package/website/content/docs/schema-reference/agent-role.md

@@ -0,0 +1,54 @@
+# agent.role
+
+**Type**: `string`
+**Required**: Yes
+
+## Description
+
+The agent.role field
+
+## Why This Field Exists
+
+Classify agents by their function in the system for routing and orchestration
+
+## How to Use
+
+Choose from predefined roles or use custom roles
+
+## Where It's Used
+
+Used for agent discovery, filtering, and orchestration patterns
+
+## Examples
+
+```yaml
+agent.role: worker
+```
+
+```yaml
+agent.role: orchestrator
+```
+
+```yaml
+agent.role: compliance
+```
+
+```yaml
+agent.role: monitor
+```
+
+## Validation
+
+```bash
+ossa validate agent.ossa.yaml
+```
+
+## Related Fields
+
+- [agent.capabilities](./agent-capabilities.md)
+- [agent.taxonomy](./agent-taxonomy.md)
+
+## Related Documentation
+
+- [multi-agent-systems](../architecture/multi-agent-systems.md)
+

package/website/content/docs/schema-reference/agent-spec.md

@@ -350,7 +350,7 @@ spec:
 The only required field in `spec` is `role`:
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: simple-agent
@@ -397,7 +397,7 @@ spec:
 
 The `spec` object is validated against the JSON Schema:
 ```
-https://openstandardagents.org/schemas/v0.2.3/agent.json#/definitions/AgentSpec
+https://openstandardagents.org/schemas/v0.2.x/agent.json#/definitions/AgentSpec
 ```
 
 Required fields:

package/website/content/docs/schema-reference/agent-version.md

@@ -0,0 +1,50 @@
+# agent.version
+
+**Type**: `string`
+**Required**: Yes
+
+## Description
+
+The agent.version field
+
+## Why This Field Exists
+
+Track agent versions for compatibility, rollback, and change management
+
+## How to Use
+
+Use semantic versioning (MAJOR.MINOR.PATCH)
+
+## Where It's Used
+
+Used in registry, deployment manifests, and API responses
+
+## Examples
+
+```yaml
+agent.version: 1.0.0
+```
+
+```yaml
+agent.version: 2.1.3
+```
+
+```yaml
+agent.version: 0.1.0-beta
+```
+
+## Validation
+
+```bash
+ossa validate agent.ossa.yaml
+```
+
+## Related Fields
+
+- [agent.id](./agent-id.md)
+- [ossaVersion](./ossaVersion.md)
+
+## Related Documentation
+
+- [versioning](../guides/versioning.md)
+

package/website/content/docs/schema-reference/autonomy.md

@@ -260,7 +260,7 @@ autonomy:
 ### Read-Only Analysis Agent
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: log-analyzer
@@ -296,7 +296,7 @@ spec:
 ### Code Review Agent (Supervised)
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: code-reviewer
@@ -328,7 +328,7 @@ spec:
 ### Infrastructure Automation Agent
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: k8s-autoscaler
@@ -366,7 +366,7 @@ spec:
 ### Customer Support Agent
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: support-assistant
@@ -411,7 +411,7 @@ spec:
 ### DevOps Incident Response
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: incident-responder

package/website/content/docs/schema-reference/constraints.md

@@ -251,7 +251,7 @@ constraints:
 ### Production Chatbot
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: customer-chatbot
@@ -283,7 +283,7 @@ spec:
 ### Background Data Analyzer
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: data-analyzer
@@ -314,7 +314,7 @@ spec:
 ### Development/Testing Agent
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: dev-assistant
@@ -343,7 +343,7 @@ spec:
 ### High-Performance Code Generator
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: code-generator
@@ -375,7 +375,7 @@ spec:
 ### Cost-Optimized Agent
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: budget-agent