@bluefly/openstandardagents 0.2.4 → 0.2.5-RC

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.5-RC/](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.5-RC/
+ls spec/v0.2.5-RC/
 ```
 
 ### 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.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
 
 ---
 
@@ -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/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/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

package/website/content/docs/schema-reference/llm-config.md

@@ -356,7 +356,7 @@ llm:
 ## Complete Example
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: technical-writer

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

@@ -352,7 +352,7 @@ observability:
 ### Production Observability Stack
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: production-agent
@@ -379,7 +379,7 @@ spec:
 ### Development Environment
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: dev-agent
@@ -405,7 +405,7 @@ spec:
 ### Cloud-Native (Grafana Stack)
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: cloud-agent
@@ -432,7 +432,7 @@ spec:
 ### Minimal Observability
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: minimal-agent
@@ -456,7 +456,7 @@ spec:
 ### High-Volume Agent
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: high-volume-agent

package/website/content/docs/schema-reference/ossa-manifest.md

@@ -12,7 +12,7 @@ The root object of an OSSA agent manifest. This is the top-level container for a
 
 | Field Name | Type | Required | Description |
 |------------|------|----------|-------------|
-| `apiVersion` | string | **Yes** | OSSA API version. Must match pattern `ossa/v(0.2.[2-3]\|1)`. Examples: `ossa/v1`, `ossa/v0.2.3` |
+| `apiVersion` | string | **Yes** | OSSA API version. Must match pattern `ossa/v(0.2.[2-3]\|1)`. Examples: `ossa/v1`, `ossa/v0.2.x` |
 | `kind` | string | **Yes** | Resource type. Currently only `Agent` is supported |
 | `metadata` | [Metadata](#metadata-object) | **Yes** | Agent metadata including name, version, labels, and annotations |
 | `spec` | [AgentSpec](./agent-spec.md) | **Yes** | Agent specification defining behavior, capabilities, and configuration |
@@ -82,7 +82,7 @@ Framework-specific extensions enable integration with various agent platforms an
 ### Extensions Example
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: multi-platform-agent
@@ -120,7 +120,7 @@ extensions:
 ## Complete Example
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 
 metadata:
@@ -251,7 +251,7 @@ extensions:
 
 ### apiVersion Validation
 - Must match regex: `^ossa/v(0\.2\.[2-3]|1)(\.0)?(-[a-zA-Z0-9]+)?$`
-- Valid examples: `ossa/v1`, `ossa/v0.2.3`, `ossa/v0.2.3`, `ossa/v1.0`
+- Valid examples: `ossa/v1`, `ossa/v0.2.x`, `ossa/v0.2.4`, `ossa/v1.0`
 - Invalid examples: `v1`, `ossa/v2`, `ossa/0.2.3`
 
 ### kind Validation
@@ -300,8 +300,8 @@ https://openstandardagents.org/schemas/v0.2.3/agent.json
 Use it for validation and editor autocomplete:
 ```json
 {
-  "$schema": "https://openstandardagents.org/schemas/v0.2.3/agent.json",
-  "apiVersion": "ossa/v0.2.3",
+  "$schema": "https://openstandardagents.org/schemas/v0.2.x/agent.json",
+  "apiVersion": "ossa/v0.2.x",
   "kind": "Agent",
   "metadata": { ... },
   "spec": { ... }

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

@@ -323,7 +323,7 @@ taxonomy:
 ### Infrastructure Kubernetes Troubleshooting Agent
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: k8s-troubleshooter
@@ -362,7 +362,7 @@ spec:
 ### Security Vulnerability Scanner
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: vulnerability-scanner
@@ -400,7 +400,7 @@ spec:
 ### Documentation Generator
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: api-doc-generator

package/website/content/docs/use-cases/00-index.md

@@ -391,5 +391,5 @@ All use cases are provided under Apache 2.0 license. Implementation code may be
 ---
 
 **Last Updated**: November 2024
-**OSSA Version**: v0.2.3
+**OSSA Version**: v0.2.x
 **Status**: Production Ready

package/{docs/VERSIONING.md → website/content/docs/versioning.md}

@@ -1,3 +1,7 @@
+---
+title: "VERSIONING"
+---
+
 # OSSA Versioning Strategy
 
 ## Semantic Versioning with Semantic-Release
@@ -144,9 +148,9 @@ OSSA schema versions follow specification versions:
 ```
 Package Version  → Schema Directory
 -----------------------------------------
-v0.2.2          → spec/v0.2.2/
-v0.3.0          → spec/v0.3.0/
-v1.0.0          → spec/v1.0.0/
+v0.2.2          → spec/v0.2.5-RC/
+v0.3.0          → spec/v0.2.5-RC/
+v1.0.0          → spec/v0.2.5-RC/
 ```
 
 ### Schema Compatibility
@@ -275,8 +279,8 @@ git commit -m "chore: update docs [skip ci]"
 ## Support
 
 - **Documentation**: [docs/](../docs/)
-- **Issues**: https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/-/issues
-- **Releases**: https://gitlab.bluefly.io/llm/openapi-ai-agents-standard/-/releases
+- **Issues**: https://github.com/blueflyio/openstandardagents/issues
+- **Releases**: https://github.com/blueflyio/openstandardagents/releases
 
 ---
 

package/website/lib/version.ts

@@ -2,11 +2,28 @@
 // AUTO-GENERATED - DO NOT EDIT DIRECTLY
 // Update package.json version instead, then run: npm run sync-version
 
-export const OSSA_VERSION = "0.2.3";
+import versionsData from './versions.json';
+
+export const OSSA_VERSION = "0.2.5-RC";
 export const OSSA_VERSION_TAG = `v${OSSA_VERSION}`;
 export const OSSA_API_VERSION = `ossa/v${OSSA_VERSION}`;
 export const OSSA_SCHEMA_VERSION = OSSA_VERSION;
 
+// Aliases for backward compatibility
+export const STABLE_VERSION = OSSA_VERSION;
+export const STABLE_VERSION_TAG = OSSA_VERSION_TAG;
+
+// Version data from versions.json
+export const STABLE_VERSIONS = versionsData.all.filter((v: any) => v.type === 'stable');
+export const DEV_VERSIONS = versionsData.all.filter((v: any) => v.type === 'dev' || v.type === 'prerelease');
+export const ALL_VERSIONS = versionsData.all;
+export const DEV_VERSION_TAG = versionsData.dev ? `v${versionsData.dev}` : undefined;
+
+// Utility to get version info
+export function getVersionInfo(version: string): any {
+  return versionsData.all.find((v: any) => v.version === version);
+}
+
 // Utility to get schema path
 export function getSchemaPath(ver = OSSA_VERSION): string {
   return `/schemas/ossa-${ver}.schema.json`;

package/website/lib/versions.json

@@ -0,0 +1,78 @@
+{
+  "stable": "0.2.4",
+  "latest": "0.2.4",
+  "dev": "0.2.5-dev",
+  "all": [
+    {
+      "version": "0.2.5",
+      "tag": "v0.2.5",
+      "apiVersion": "ossa/v0.2.5",
+      "type": "stable",
+      "published": false,
+      "available": true,
+      "schemaPath": "/Users/flux423/Sites/LLM/openstandardagents/spec/v0.2.5/ossa-0.2.5.schema.json"
+    },
+    {
+      "version": "0.2.4",
+      "tag": "v0.2.4",
+      "apiVersion": "ossa/v0.2.4",
+      "type": "stable",
+      "published": true,
+      "available": true
+    },
+    {
+      "version": "0.2.3",
+      "tag": "v0.2.3",
+      "apiVersion": "ossa/v0.2.3",
+      "type": "stable",
+      "published": false,
+      "available": true,
+      "schemaPath": "/Users/flux423/Sites/LLM/openstandardagents/spec/v0.2.3/ossa-0.2.3.schema.json"
+    },
+    {
+      "version": "0.2.2",
+      "tag": "v0.2.2",
+      "apiVersion": "ossa/v0.2.2",
+      "type": "stable",
+      "published": false,
+      "available": true,
+      "schemaPath": "/Users/flux423/Sites/LLM/openstandardagents/spec/v0.2.2/ossa-0.2.2.schema.json"
+    },
+    {
+      "version": "0.2.1",
+      "tag": "v0.2.1",
+      "apiVersion": "ossa/v0.2.1",
+      "type": "stable",
+      "published": false,
+      "available": true,
+      "schemaPath": "/Users/flux423/Sites/LLM/openstandardagents/spec/v0.2.1/ossa-0.2.1.schema.json"
+    },
+    {
+      "version": "0.2.0",
+      "tag": "v0.2.0",
+      "apiVersion": "ossa/v0.2.0",
+      "type": "stable",
+      "published": false,
+      "available": true,
+      "schemaPath": "/Users/flux423/Sites/LLM/openstandardagents/spec/v0.2.0/ossa-0.2.0.schema.json"
+    },
+    {
+      "version": "0.2.5-RC",
+      "tag": "v0.2.5-RC",
+      "apiVersion": "ossa/v0.2.5-RC",
+      "type": "stable",
+      "published": false,
+      "available": true,
+      "schemaPath": "/Users/flux423/Sites/LLM/openstandardagents/spec/v0.2.5-RC/ossa-0.2.5-RC.schema.json"
+    },
+    {
+      "version": "0.1.9",
+      "tag": "v0.1.9",
+      "apiVersion": "ossa/v0.1.9",
+      "type": "stable",
+      "published": true,
+      "available": true
+    }
+  ],
+  "fallbackVersion": "0.2.3"
+}

package/website/next.config.ts

@@ -1,7 +1,9 @@
 import type { NextConfig } from 'next';
 
 const nextConfig: NextConfig = {
-  // Remove 'export' to use dynamic server
+  output: 'export',
+  distDir: 'out',
+  trailingSlash: true,
   images: {
     unoptimized: true
   },