@bluefly/openstandardagents 0.2.7 → 0.2.8

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

@@ -1,175 +0,0 @@
-# Pre-Release Specifications
-
-> **Warning**: These specifications are in development and may change before stable release. Do not use in production.
-
-## Development Versions
-
-OSSA follows semantic versioning. Development specs are marked with `-dev` suffix to indicate they are not yet stable.
-
-### v0.2.4-dev - Transport & Security
-
-**Status**: Development
-**Target Release**: February 2025
-**Milestone**: [v0.2.4 - Transport & Security](https://github.com/blueflyio/openstandardagents/milestones/12)
-
-#### New Features
-
-1. **Transport Metadata for Capabilities**
-   - Protocol support: `http`, `grpc`, `a2a`, `mcp`, `websocket`, `custom`
-   - Streaming modes: `none`, `request`, `response`, `bidirectional`
-   - Binding paths for endpoints
-
-2. **State/Memory Specification**
-   - Mode: `stateless`, `session`, `long_running`
-   - Storage types: `memory`, `vector-db`, `kv`, `rdbms`, `custom`
-   - Retention configuration
-
-3. **Security Scopes and Compliance Tags**
-   - OAuth2-style scopes per capability
-   - Compliance tags: `pii`, `hipaa`, `gdpr`, `fedramp`, `soc2`
-
-4. **Capability Versioning**
-   - Version field (major.minor)
-   - Deprecation flags and messages
-
-5. **Google ADK Extension**
-   - A2A protocol support
-   - Agent hierarchies
-   - MCP integration
-   - Streaming modalities
-
-#### Framework Alignment
-
-- Google Agent Development Kit (ADK)
-- OpenAI Agents SDK
-- Microsoft Agent Framework
-
----
-
-### v0.2.5-RC-dev - Multi-Agent Composition
-
-**Status**: Development
-**Target Release**: March 2025
-**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-RC
-   kind: AgentGraph  # New!
-   metadata:
-     name: customer-support-cluster
-   spec:
-     agents:
-       - ref: triage-agent
-         role: entry
-       - ref: resolver-agent
-         role: worker
-     edges:
-       - from: triage-agent
-         to: resolver-agent
-         condition: standard-issue
-     process: sequential
-   ```
-
-2. **Process Patterns**
-   - `sequential`: Agents execute one after another
-   - `parallel`: Agents execute simultaneously
-   - `hierarchical`: Manager delegates to workers
-   - `conditional`: Branching based on conditions
-   - `loop`: Iterative execution
-
-3. **Edge Routing**
-   - From/to agent references
-   - Condition expressions
-   - Priority ordering
-
-4. **Shared State**
-   - Schema definition
-   - Persistence options
-   - Checkpointing and recovery
-
-#### Framework Alignment
-
-- CrewAI (crews, manager agents)
-- MetaGPT (SOPs, role pipelines)
-- Microsoft AF (workflows)
-- Google ADK (agent graphs)
-- LangGraph (state machines)
-
----
-
-## Using Development Specs
-
-### Installation
-
-Development specs are available in the repository:
-
-```bash
-# Clone the repository
-git clone https://github.com/blueflyio/openstandardagents.git
-cd openstandardagents
-
-# View development specs
-ls spec/v0.2.6/
-ls spec/v0.2.6/
-```
-
-### Validation
-
-```bash
-# Install CLI (if not already installed)
-npm install -g @bluefly/openstandardagents
-
-# Validate against development schema
-ossa validate your-agent.yaml --version 0.2.4-dev
-```
-
-### Examples
-
-Development examples are in the spec directories:
-
-- `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
-
----
-
-## Providing Feedback
-
-We welcome feedback on development specifications:
-
-1. **GitHub Issues**: [Create an issue](https://github.com/blueflyio/openstandardagents/issues/new)
-2. **Discussions**: Comment on milestone issues
-3. **Pull Requests**: Submit improvements
-
-### v0.2.4 Issues
-- [#220 - Transport metadata](https://github.com/blueflyio/openstandardagents/issues/220)
-- [#221 - State/memory block](https://github.com/blueflyio/openstandardagents/issues/221)
-- [#222 - Security scopes](https://github.com/blueflyio/openstandardagents/issues/222)
-- [#223 - Capability versioning](https://github.com/blueflyio/openstandardagents/issues/223)
-- [#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-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)
-- [#215 - Shared state](https://github.com/blueflyio/openstandardagents/issues/215)
-- [#216-218 - Adapter examples](https://github.com/blueflyio/openstandardagents/issues/216)
-- [#219 - Validation rules](https://github.com/blueflyio/openstandardagents/issues/219)
-
----
-
-## Roadmap
-
-| Version | Focus | Status | Target |
-|---------|-------|--------|--------|
-| v0.2.3 | Documentation & Examples | **Stable** | Released |
-| v0.2.4 | Transport & Security | Development | Feb 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 |
-
-See [milestones](https://github.com/blueflyio/openstandardagents/milestones) for full details.

package/website/content/docs/quick-reference.md

@@ -1,17 +0,0 @@
----
-title: "Quick Reference"
----
-
-# Quick Reference
-
-- Root: `x-ossa-metadata`, `x-ossa`, `x-agent`
-- Operation: `x-ossa-capability`, `x-ossa-autonomy`, `x-ossa-constraints`, `x-ossa-tools`, `x-ossa-llm`
-- Parameters: `x-ossa-agent-id`, `x-ossa-version`
-- Schemas: `x-ossa-capability-schema`
-
-**Validation**:
-```bash
-ossa validate examples/openapi-extensions/worker-agent-api.openapi.yml --openapi --verbose
-```
-
-**Links**: [OpenAPI-Extensions](./OpenAPI-Extensions) · [Examples](./Examples)

package/website/content/docs/readme.md

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

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

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

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

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

@@ -1,54 +0,0 @@
-# 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)
-