@bluefly/openstandardagents 0.2.5-RC → 0.2.7

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-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/index.md

@@ -1,176 +1,45 @@
----
-title: "Schema Reference"
-description: "Complete reference documentation for the OSSA v0.2.x Agent Manifest Schema"
-weight: 50
----
+# Schema Reference
 
-# OSSA Schema Reference
+Complete reference for the OSSA agent manifest schema.
 
-Complete reference documentation for the Open Standard for Scalable Agents (OSSA) v0.2.x schema.
+## Overview
 
-The OSSA schema provides a declarative, framework-agnostic way to define AI agents with full portability across platforms and orchestration frameworks.
+The OSSA schema defines the structure of agent manifests. Every field serves a specific purpose in the agent lifecycle.
 
-## Schema Overview
+## Core Fields
 
-The OSSA manifest is a JSON/YAML document that defines:
+### Agent Identification
+- [agent.id](./agent-id.md) - Unique agent identifier
+- [agent.name](./agent-name.md) - Human-readable name
+- [agent.version](./agent-version.md) - Semantic version
+- [agent.role](./agent-role.md) - Agent role classification
 
-- **Agent metadata** - Name, version, labels, and annotations
-- **Agent specification** - Role, LLM configuration, tools, and capabilities
-- **Autonomy settings** - Decision-making level and approval requirements
-- **Constraints** - Cost, performance, and resource limits
-- **Observability** - Tracing, metrics, and logging configuration
-- **Framework extensions** - Integration with kagent, BuildKit, Drupal, LibreChat, and 14+ other frameworks
+### Agent Capabilities
+- [agent.capabilities](./agent-capabilities.md) - What the agent can do
 
-## Schema Version
+## Schema Versions
 
-```yaml
-apiVersion: ossa/v0.2.x
-```
+- **Current**: v0.2.5-RC
+- **Stable**: v0.2.4
+- **Previous**: v0.2.3, v0.2.2
 
-The current stable version is `ossa/v0.2.x` (v0.2.2, v0.2.3, v0.2.4+). The schema also supports `ossa/v1` for forward compatibility.
-
-## Schema Components
-
-### Core Objects
-
-- [**OSSA Manifest**](./ossa-manifest.md) - Root manifest object with metadata and spec
-- [**Agent Spec**](./agent-spec.md) - Agent specification including role, LLM, and tools
-- [**LLM Configuration**](./llm-config.md) - Language model provider and parameters
-- [**Tools**](./tools.md) - Tool definitions for MCP, Kubernetes, HTTP, and custom integrations
-
-### Configuration Objects
-
-- [**Taxonomy**](./taxonomy.md) - Agent domain, subdomain, and capability classification
-- [**Autonomy**](./autonomy.md) - Decision-making level and action controls
-- [**Constraints**](./constraints.md) - Cost, performance, and resource constraints
-- [**Observability**](./observability.md) - Tracing, metrics, and logging
-
-### Framework Extensions
-
-- [**kagent Extension**](./extensions/kagent.md) - Kubernetes-native agent deployment
-- [**BuildKit Extension**](./extensions/buildkit.md) - Agent BuildKit orchestration
-- [**Drupal Extension**](./extensions/drupal.md) - Drupal LLM Platform integration
-- [**LibreChat Extension**](./extensions/librechat.md) - LibreChat integration
-- [**MCP Extension**](./extensions/mcp.md) - Model Context Protocol servers
-- [**LangChain Extension**](./extensions/langchain.md) - LangChain framework
-- [**CrewAI Extension**](./extensions/crewai.md) - CrewAI multi-agent framework
-- [**OpenAI Agents Extension**](./extensions/openai-agents.md) - OpenAI Agents SDK
-- [**Cursor Extension**](./extensions/cursor.md) - Cursor IDE integration
-- [**Langflow Extension**](./extensions/langflow.md) - Langflow workflow orchestration
-- [**AutoGen Extension**](./extensions/autogen.md) - Microsoft AutoGen
-- [**Vercel AI Extension**](./extensions/vercel-ai.md) - Vercel AI SDK
-- [**LlamaIndex Extension**](./extensions/llamaindex.md) - LlamaIndex RAG framework
-- [**LangGraph Extension**](./extensions/langgraph.md) - LangGraph state machines
-- [**Anthropic Extension**](./extensions/anthropic.md) - Anthropic Claude API
-
-## Quick Example
-
-```yaml
-apiVersion: ossa/v0.2.x
-kind: Agent
-metadata:
-  name: code-reviewer
-  version: 1.0.0
-  description: Automated code review agent
-  labels:
-    domain: development
-    capability: code-review
-spec:
-  taxonomy:
-    domain: development
-    subdomain: quality-assurance
-    capability: code-review
-  role: |
-    You are a code review specialist. Analyze code for:
-    - Security vulnerabilities
-    - Performance issues
-    - Best practices adherence
-    - Code quality and maintainability
-  llm:
-    provider: anthropic
-    model: claude-3-5-sonnet-20241022
-    temperature: 0.3
-    maxTokens: 4096
-  tools:
-    - type: mcp
-      server: filesystem
-      capabilities:
-        - read_file
-        - list_directory
-    - type: mcp
-      server: git
-      capabilities:
-        - git_diff
-        - git_log
-  autonomy:
-    level: supervised
-    approval_required: false
-    allowed_actions:
-      - read_code
-      - analyze_security
-      - generate_report
-  constraints:
-    cost:
-      maxTokensPerDay: 1000000
-      maxCostPerDay: 50.0
-      currency: USD
-    performance:
-      maxLatencySeconds: 30
-      timeoutSeconds: 120
-  observability:
-    tracing:
-      enabled: true
-      exporter: otlp
-    metrics:
-      enabled: true
-      exporter: prometheus
-    logging:
-      level: info
-      format: json
-```
+See [Versioning Guide](../guides/versioning.md) for migration information.
 
 ## Validation
 
-All OSSA manifests must conform to the JSON Schema:
-
-```
-https://openstandardagents.org/schemas/v0.2.x/agent.json
-```
-
-Use the schema for validation in your tools and editors:
-
-**VSCode/Cursor:**
-```json
-{
-  "$schema": "https://openstandardagents.org/schemas/v0.2.x/agent.json"
-}
-```
+Validate your agent manifests:
 
-**Command-line validation:**
 ```bash
-ossa validate manifest.json
+ossa validate agent.ossa.yaml
 ```
 
-## Framework Compatibility
-
-The OSSA schema is designed for framework-agnostic portability. The same manifest can be deployed to:
-
-- **kagent.dev** - Kubernetes-native agent platform
-- **Agent BuildKit** - Multi-runtime orchestration
-- **Drupal LLM Platform** - Drupal-based agent management
-- **LibreChat** - Open-source chat interface
-- **LangChain, CrewAI, AutoGen** - Python agent frameworks
-- **OpenAI Agents SDK** - Official OpenAI agent runtime
-- **Cursor, Continue** - IDE-integrated coding agents
-- **Vercel AI SDK** - Edge/Node.js deployment
-- **LlamaIndex, LangGraph** - RAG and state machine frameworks
+## Complete Schema
 
-See the [Extensions](./extensions/) section for framework-specific configuration.
+View the complete JSON Schema:
+- [v0.2.5-RC Schema](https://github.com/blueflyio/openstandardagents/blob/main/spec/v0.2.6/ossa-0.2.6.schema.json)
 
-## Additional Resources
+## Related Documentation
 
-- [OSSA Specification](/docs/)
-- [Getting Started Guide](/docs/getting-started/)
-- [Examples](/docs/examples/)
-- [GitHub Repository](https://github.com/blueflyio/openstandardagents)
-- [Schema Download](https://openstandardagents.org/schemas/v0.2.x/agent.json)
+- [CLI Reference](../cli-reference/index.md)
+- [API Reference](../api-reference/index.md)
+- [Creating Agents Guide](../guides/creating-agents.md)

package/website/content/docs/types-reference/index.md

@@ -0,0 +1,105 @@
+# TypeScript Types Reference
+
+Auto-generated from `src/types/index.ts`
+
+## Interfaces
+
+### Capability
+
+```typescript
+export interface Capability {
+  name: string;
+  description: string;
+  input_schema: Record<string, unknown> | string;
+  output_schema: Record<string, unknown> | string;
+  examples?: Array<{
+    name?: string;
+    input?: Record<string, unknown>;
+    output?: Record<string, unknown>;
+  }
+```
+
+### OssaAgent
+
+```typescript
+export interface OssaAgent {
+  // v0.2.3 format
+  apiVersion?: string;
+  kind?: string;
+  metadata?: {
+    name: string;
+    version?: string;
+    description?: string;
+    labels?: Record<string, string>;
+    annotations?: Record<string, string>;
+  }
+```
+
+### ValidationResult
+
+```typescript
+export interface ValidationResult {
+  valid: boolean;
+  errors: ErrorObject[];
+  warnings: string[];
+  manifest?: OssaAgent;
+}
+```
+
+### AgentTemplate
+
+```typescript
+export interface AgentTemplate {
+  id: string;
+  name: string;
+  role: string;
+  description?: string;
+  runtimeType?: string;
+  capabilities?: Capability[];
+}
+```
+
+### IValidationService
+
+```typescript
+export interface IValidationService {
+  validate(
+    manifest: unknown,
+    version: SchemaVersion
+  ): Promise<ValidationResult>;
+}
+```
+
+### ISchemaRepository
+
+```typescript
+export interface ISchemaRepository {
+  getSchema(version: SchemaVersion): Promise<Record<string, unknown>>;
+  clearCache(): void;
+  getAvailableVersions(): string[];
+  getCurrentVersion(): string;
+}
+```
+
+### IManifestRepository
+
+```typescript
+export interface IManifestRepository {
+  load(path: string): Promise<unknown>;
+  save(path: string, manifest: OssaAgent): Promise<void>;
+}
+```
+
+## Type Aliases
+
+### SchemaVersion
+
+```typescript
+export type SchemaVersion = string;
+```
+
+## Usage
+
+```typescript
+import { OSSAManifest, AgentSpec } from '@bluefly/openstandardagents';
+```

package/website/content/docs/versioning.md

@@ -148,9 +148,9 @@ OSSA schema versions follow specification versions:
 ```
 Package Version  → Schema Directory
 -----------------------------------------
-v0.2.2          → spec/v0.2.5-RC/
-v0.3.0          → spec/v0.2.5-RC/
-v1.0.0          → spec/v0.2.5-RC/
+v0.2.2          → spec/v0.2.6/
+v0.3.0          → spec/v0.2.6/
+v1.0.0          → spec/v0.2.6/
 ```
 
 ### Schema Compatibility