@bluefly/openstandardagents 0.2.4 → 0.2.5-RC

package/website/content/docs/architecture/overview.md

@@ -103,10 +103,10 @@ Deploy OSSA agents anywhere:
 
 ## Related Documentation
 
-- [Specification Deep-Dive](../Technical/Specification-Deep-Dive) - Technical details of the OSSA spec
-- [Runtime Deployment](../Technical/Runtime-Deployment) - Deployment patterns and guides
-- [Tool Integration](../Technical/Tool-Integration) - Connecting external tools to agents
-- [Integration Patterns](../Examples/Integration-Patterns) - Real-world integration examples
+- [Specification](/docs/specification) - Technical details of the OSSA spec
+- [Schema Reference](/docs/schema-reference) - Complete schema documentation
+- [Ecosystem Overview](/docs/ecosystem/overview) - Framework integrations
+- [Migration Guides](/docs/migration-guides/langchain-to-ossa) - Real-world migration examples
 
 ---
 

package/website/content/docs/architecture/stack-integration.md

@@ -29,7 +29,7 @@ graph TB
 
     subgraph "OSSA Specification Layer"
         Manifest[OSSA Manifests<br/>agent.ossa.yaml]
-        Schema[JSON Schema<br/>v0.2.2]
+        Schema[JSON Schema<br/>v0.2.x]
         CLI_Tool[OSSA CLI<br/>Validation]
         Registry[Agent Registry]
     end
@@ -144,7 +144,7 @@ response = agent.run(user_message="Hello")
 
 **Components:**
 - **OSSA Manifests**: YAML/JSON files defining agents
-- **JSON Schema**: Validation schema (v0.2.2)
+- **JSON Schema**: Validation schema (v0.2.x)
 - **OSSA CLI**: Validation and generation tools
 - **Agent Registry**: Discovery and versioning
 
@@ -452,8 +452,8 @@ Change any layer without affecting others:
 ## Related Documentation
 
 - [Execution Flow](execution-flow) - How requests flow through OSSA agents
-- [Runtime Deployment](../Technical/Runtime-Deployment) - Deployment guides
-- [Integration Patterns](../Examples/Integration-Patterns) - Real-world examples
+- [Specification](/docs/specification) - Deployment guides
+- [Ecosystem Overview](/docs/ecosystem/overview) - Real-world examples
 - [Multi-Agent Systems](multi-agent-systems) - Agent-to-agent communication
 
 ---

package/website/content/docs/changelog.md

@@ -24,7 +24,7 @@ This release represents a complete transformation of OSSA into an enterprise-gra
 - **Getting Started Guide** - Clear, technical quick-start documentation
 
 ### Changed
-- **Package Name Standardized** - Now `@bluefly/openstandardagents` (consistent with npm)
+- **Package Name Standardized** - Now `@bluefly/open-standards-scalable-agents` (consistent with npm)
 - **Version Unified to 1.0.0** - Aligned package.json, schema, and documentation versions
 - **Dependencies Minimized** - Reduced from 8 to 4 deps, removed runtime services (qdrant, redis, pg, zod)
   - **Before**: 12MB+ with runtime dependencies
@@ -81,10 +81,10 @@ This release represents a complete transformation of OSSA into an enterprise-gra
 **For npm users**:
 ```bash
 # Old (not published)
-npm install -g @bluefly/openstandardagents
+npm install -g @ossa/standard
 
 # New (v1.0.0+)
-npm install -g @bluefly/openstandardagents
+npm install -g @bluefly/open-standards-scalable-agents
 ```
 
 **For developers**:
@@ -93,7 +93,7 @@ npm install -g @bluefly/openstandardagents
 - Examples unchanged (`examples/`)
 
 **For documentation**:
-- Comprehensive guides → GitLab Wiki (https://github.com/blueflyio/openstandardagents/wiki)
+- Comprehensive guides → GitLab Wiki (https://github.com/blueflyio/openstandardagents/wiki/home)
 - Core specification docs → `docs/` directory
 - API documentation → GitLab Pages (automated)
 

package/website/content/docs/contributing.md

@@ -188,8 +188,8 @@ Contributing to OAAS directly advances:
 ### 3. Getting Started
 
 1. **Read the Documentation** - Start with [README.md](README.md) and [ROADMAP.md](ROADMAP.md)
-2. **Check Issues** - Find something you can help with in our [GitHub Issues](https://github.com/blueflyio/openstandardagents/issues)
-3. **Join Discussions** - Participate in [GitHub Discussions](https://github.com/blueflyio/openstandardagents/discussions)
+2. **Check Issues** - Find something you can help with in our [GitHub Issues](https://github.com/openapi-ai-agents/standard/issues)
+3. **Join Discussions** - Participate in [GitHub Discussions](https://github.com/openapi-ai-agents/standard/discussions)
 4. **Submit PRs** - Start with small, focused changes
 5. **Test Everything** - Ensure all implementations work correctly
 

package/website/content/docs/ecosystem/framework-support.md

@@ -18,8 +18,6 @@ This guide provides detailed information about OSSA compatibility with popular A
 | Langflow | ✅ Supported | 1.0.0+ | Low | [Docs](#langflow) |
 | Drupal ECA | ✅ Supported | 1.0.0+ | Medium | [Docs](#drupal-eca) |
 | OpenAI Assistants | ✅ Supported | 1.0.0+ | Medium | [Docs](#openai-assistants) |
-| AutoGPT | 🔄 Planned | TBD | TBD | Coming Soon |
-| BabyAGI | 🔄 Planned | TBD | TBD | Coming Soon |
 
 **Legend:**
 - ✅ **Native**: Built on OSSA from the ground up

package/website/content/docs/examples/AIFlow-Framework-Integration-with-OSSA.md

@@ -0,0 +1,107 @@
+---
+title: "AIFlow Framework Integration with OSSA"
+---
+
+# AIFlow Framework Integration with OSSA
+
+## Overview
+
+AIFlow is a Python-based social agent framework that enables personality-driven, emotionally intelligent AI agents for autonomous social media content generation. This integration demonstrates how AIFlow agents are wrapped in OSSA 1.0 manifests for Kubernetes orchestration and deployment through agent-buildkit.
+
+For complete integration analysis, see: [agent-buildkit AIFlow Integration Guide](https://github.com/blueflyio/openstandardagents/wiki/AIFlow-Integration-with-OSSA-BuildKit-and-K-Agent)
+
+## Core Components
+
+### OSSA Manifest
+
+**Location**: [agent-buildkit/examples/aiflow-integration/social-agent-aiflow.ossa.yaml](https://github.com/blueflyio/openstandardagents/blob/development/examples/aiflow-integration/social-agent-aiflow.ossa.yaml)
+
+The manifest defines the agent's identity, runtime configuration, capabilities, and deployment requirements. It conforms to OSSA 1.0 specification.
+
+**Key Manifest Sections**:
+
+- **Agent Identity**: `social-agent-aiflow`, version 1.0.0, role: chat
+- **Runtime**: Docker image `aiflow/agent:1.0.0`, Python 3.12+, resource requirements
+- **Capabilities**: `generate_post`, `generate_response` with defined schemas
+- **Dependencies**: Required integration with `agent-brain` for cognitive functions
+- **Environment**: Required secrets for Anthropic API, Twitter API, Telegram Bot, PostgreSQL
+
+### OpenAPI Specification
+
+**Location**: [agent-buildkit/openapi/aiflow-agent.openapi.yml](https://github.com/blueflyio/openstandardagents/blob/development/openapi/aiflow-agent.openapi.yml)
+
+The OpenAPI 3.1 specification defines the REST API interface for the AIFlow agent, including:
+- FastAPI bridge endpoints for AIFlow Sia runtime
+- Request/response schemas for all capabilities
+- Kubernetes metadata extensions (x-k-agent) for orchestration
+- Health check endpoints and observability metrics
+
+### 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)
+
+JSON Schema definition for OSSA 1.0 manifest validation. All agent manifests must conform to this schema.
+
+## Validation
+
+### OSSA Manifest Validation
+
+Validate the manifest against OSSA 1.0 schema:
+
+```yaml
+ossa validate examples/aiflow-integration/social-agent-aiflow.ossa.yaml
+```
+
+This checks:
+- Schema compliance against OSSA 1.0 specification
+- Required fields and type correctness
+- Capability schema definitions
+- Dependency declarations
+- Environment variable definitions
+
+### OpenAPI Specification Validation
+
+Validate OpenAPI spec with strict mode and K-Agent metadata checks:
+
+```yaml
+buildkit openapi validate --spec openapi/aiflow-agent.openapi.yml --strict
+```
+
+This validates:
+- OpenAPI 3.1 syntax and semantics
+- x-k-agent extension metadata for Kubernetes
+- Endpoint schemas match OSSA capability definitions
+- Health check endpoint compliance
+
+## Deployment
+
+Deploy via agent-buildkit orchestration:
+
+```yaml
+buildkit orchestrate deploy --manifest examples/aiflow-integration/social-agent-aiflow.ossa.yaml
+```
+
+This generates Kubernetes manifests and deploys the agent with:
+- Rolling deployment strategy
+- Horizontal Pod Autoscaling (HPA)
+- Health checks and readiness probes
+- Service account and RBAC configuration
+- ConfigMap for character definitions
+- Persistent volume for memory database
+
+## Integration Architecture
+
+1. **OSSA Manifest** → Defines agent structure and requirements
+2. **OpenAPI Spec** → REST API contract with K8s metadata
+3. **FastAPI Bridge** → Wraps AIFlow Sia runtime in REST API
+4. **BuildKit Deployment** → Generates and applies K8s manifests
+5. **Runtime Orchestration** → Kubernetes manages agent lifecycle
+
+## Resources
+
+- **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)
+- **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/Migration-Guides.md

@@ -125,7 +125,7 @@ agent = create_agent(llm, tools)
 
 **After** (OSSA):
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.2
 kind: Agent
 spec:
   role: Agent description
@@ -202,7 +202,7 @@ ossa validate migrated-agent.ossa.yaml --verbose
 
 ### Getting Help
 
-- [GitHub Issues](https://github.com/blueflyio/openstandardagents/issues)
+- [GitLab Issues](https://github.com/blueflyio/openstandardagents/issues)
 - [Documentation](../Technical/Specification-Deep-Dive)
 - [Examples](../Getting-Started-Examples)
 

package/website/content/docs/for-audiences/{architects.md → Architects.md}

@@ -23,7 +23,7 @@ OSSA provides:
 Simple, standalone agent:
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 metadata:
   name: standalone-agent

package/website/content/docs/for-audiences/{developers.md → Developers.md}

@@ -11,7 +11,7 @@ Build OSSA-compliant agents using your preferred framework and deploy anywhere.
 ### 1. Install OSSA CLI
 
 ```bash
-npm install -g @bluefly/openstandardagents
+npm install -g @bluefly/open-standards-scalable-agents
 ```
 
 ### 2. Generate Your First Agent
@@ -94,8 +94,8 @@ ossa migrate <source> [--target-version <version>]
 ### Programmatic API
 
 ```typescript
-import { ValidationService } from '@bluefly/openstandardagents/validation';
-import { GenerationService } from '@bluefly/openstandardagents/generation';
+import { ValidationService } from '@bluefly/open-standards-scalable-agents/validation';
+import { GenerationService } from '@bluefly/open-standards-scalable-agents/generation';
 
 // Validate
 const validationService = new ValidationService();

package/website/content/docs/for-audiences/Enterprises.md

@@ -91,7 +91,7 @@ OSSA enables:
 ### Example: Compliance Agent
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 
 metadata:
@@ -238,7 +238,7 @@ spec:
 
 ### Enterprise Support
 
-- [GitHub Issues](https://github.com/blueflyio/openstandardagents/issues)
+- [GitLab Issues](https://github.com/blueflyio/openstandardagents/issues)
 - [Documentation](../Technical/Specification-Deep-Dive)
 - [Examples](../Examples/Enterprise-Examples)
 

package/website/content/docs/for-audiences/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.5-RC/ossa-0.2.5-RC.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/{5-minute-overview.md → 5-Minute-Overview.md}

@@ -32,7 +32,7 @@ Get up to speed on OSSA in 5 minutes.
 OSSA defines agents using a **declarative YAML/JSON format**:
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 
 metadata:
@@ -68,7 +68,7 @@ spec:
 
 ## Next Steps
 
-1. **Install OSSA CLI**: `npm install -g @bluefly/openstandardagents`
+1. **Install OSSA CLI**: `npm install -g @bluefly/open-standards-scalable-agents`
 2. **Try the Hello World example**: See [Hello World Tutorial](Hello-World)
 3. **Create your first agent**: See [First Agent Creation](First-Agent)
 4. **Explore examples**: Check out [Examples & Patterns](../Examples/Getting-Started-Examples)

package/website/content/docs/getting-started/{first-agent.md → First-Agent.md}

@@ -121,7 +121,7 @@ ossa validate research-assistant.ossa.yaml --verbose
 Your final agent should look like:
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 
 metadata:

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

@@ -29,7 +29,7 @@ This creates a minimal, valid OSSA agent manifest.
 Open `hello-world.ossa.yaml`:
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 
 metadata:
@@ -55,7 +55,7 @@ spec:
 ### apiVersion & kind
 
 ```yaml
-apiVersion: ossa/v0.2.3
+apiVersion: ossa/v0.2.x
 kind: Agent
 ```
 
@@ -106,7 +106,7 @@ ossa validate hello-world.ossa.yaml
 You should see:
 
 ```
-✓ Agent manifest is valid OSSA 0.2.2
+✓ Agent manifest is valid OSSA v0.2.x
 ```
 
 ## Step 5: Add a Tool (Optional)

package/website/content/docs/getting-started/{installation.md → 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.5-RC/`)
 - **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)
 

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
+