@bluefly/openstandardagents 0.3.2 → 0.3.5

package/README.md

@@ -1,466 +1,383 @@
-<div align="center">
+# Open Standard for Software Agents (OSSA)
 
-```
-   ___  ____ ____    _
-  / _ \/ ___/ ___|  / \
- | | | \___ \___ \ / _ \
- | |_| |___) |__) / ___ \
-  \___/|____/____/_/   \_\
-```
+> **The OpenAPI for Software Agents** - An open specification for production-ready AI agent systems
 
-# Open Standard for Scalable AI Agents
+> **Built for Enterprise Adoption**: OSSA enables companies to build, deploy, and manage AI agents with vendor neutrality, production-grade reliability, and enterprise compliance built-in.
 
-### **The OpenAPI of AI Agents**
+> **v0.3.5 Released**: 10 major features including Completion Signals, Checkpointing, MoE, Flow Orchestration, and more. [See what's new →](spec/v0.3/README.md)
 
-*Define once, deploy anywhere. A vendor-neutral specification for portable, composable, and compliant AI agents.*
+> **For Developers**: See [AGENTS.md](AGENTS.md) for setup and development guidelines. See [llms.txt](llms.txt) for LLM-friendly project overview.
 
-[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 [![npm version](https://img.shields.io/npm/v/@bluefly/openstandardagents)](https://www.npmjs.com/package/@bluefly/openstandardagents)
-[![CI Status](https://img.shields.io/badge/CI-passing-brightgreen.svg)](https://gitlab.com/blueflyio/openstandardagents/-/pipelines)
-[![npm downloads](https://img.shields.io/npm/dm/@bluefly/openstandardagents)](https://www.npmjs.com/package/@bluefly/openstandardagents)
-
-[**Quick Start**](#quick-start-under-60-seconds) • [**Documentation**](https://openstandardagents.org/docs/) • [**Examples**](https://openstandardagents.org/examples/) • [**Community**](#community)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+[![GitHub Actions](https://github.com/blueflyio/openstandardagents/workflows/CI/badge.svg)](https://github.com/blueflyio/openstandardagents/actions)
 
-</div>
+## Why Companies Choose OSSA
 
----
-
-## Why OSSA?
+**OSSA is an emerging open standard for production AI agent systems** - designed for companies building enterprise-grade agent infrastructure.
 
-### 🔄 Portability
-**One manifest, any provider**
+### Business Value
 
-Switch between OpenAI, Anthropic, Azure, or Ollama without changing a single line of code. Runtime bindings abstract implementation from definition.
+- **Vendor Lock-In Elimination** - Switch AI providers (OpenAI, Anthropic, Google) without code changes
+- **Cost Optimization** - Designed to reduce LLM costs via intelligent expert selection (MoE)
+- **Production Reliability** - Improved session recovery with checkpointing and fault tolerance
+- **Enterprise Compliance** - Built-in support for SOC2, HIPAA, GDPR, FedRAMP requirements
+- **Future-Proof Architecture** - Write once, deploy anywhere as AI landscape evolves
+- **Risk Mitigation** - Standardized contracts reduce vendor dependency and technical debt  
 
-### 🧩 Composability
-**Build workflows from agents**
+### Enterprise Features
 
-Compose agents into workflows with parallel execution, conditional branching, and loop control. Orchestrate complex multi-agent systems declaratively.
+- **Vendor-Neutral Contracts** - Works with OpenAI, Anthropic, Google, Azure, AWS, and more
+- **Production-Grade Reliability** - Checkpointing, completion signals, fault tolerance
+- **Enterprise Security** - Built-in access control, audit logging, compliance badges
+- **Observability & Monitoring** - OpenTelemetry, LangSmith, Phoenix, Langfuse integration
+- **Kubernetes-Native** - GitOps-ready, cloud-agnostic deployment
+- **Framework Agnostic** - Works with LangChain, LangFlow, CrewAI, AutoGen, Temporal, n8n
+- **Type-Safe TypeScript SDK** - Full validation and IntelliSense support (Python SDK planned)
 
-### 🛡️ Safety
-**Built-in guardrails**
+### What is OSSA?
 
-Enterprise-grade compliance out of the box. SOC2, FedRAMP, HIPAA, and GDPR controls are first-class schema properties, not afterthoughts.
+OSSA is a **specification standard** (like OpenAPI for REST APIs) that defines contracts and metadata for production agent systems. It's not a framework - it's the standard that frameworks and platforms adopt.
 
-### 📊 Observability
-**Full visibility**
+**Key Differentiators:**
+- **The OpenAPI for Agents** - Open specification standard for agent systems
+- **100% Backward Compatible** - Upgrade without breaking changes
+- **Production-Ready** - Built for enterprise scale and reliability
+- **Open Source** - Apache 2.0 licensed, community-driven
 
-Native OpenTelemetry tracing, structured logging, cost tracking, and performance metrics. Know exactly what your agents are doing and what they cost.
+## Quick Start
 
-
----
-
-## Quick Start (Under 60 Seconds)
-
-### One-Command Quickstart
+### Install
 
 ```bash
-# macOS/Linux
-curl -fsSL https://ossa.dev/quickstart.sh | bash
-
-# Or with npx (works everywhere)
-npx @bluefly/openstandardagents quickstart
-
-# Windows PowerShell
-iwr -useb https://ossa.dev/quickstart.ps1 | iex
+npm install @bluefly/openstandardagents
+# or
+pnpm add @bluefly/openstandardagents
+# or
+yarn add @bluefly/openstandardagents
 ```
 
-### Manual Setup
+### Create Your First Agent
 
-```bash
-# Install the CLI
-npm install -g @bluefly/openstandardagents
-
-# Create your first agent
-ossa init my-agent --type agent
-cd my-agent
-
-# Validate the manifest
-ossa validate agent.ossa.yaml
-
-# Run it
-export ANTHROPIC_API_KEY=sk-ant-...
-ossa run agent.ossa.yaml --interactive
+```yaml
+# my-agent.ossa.yaml
+apiVersion: ossa/v0.3.5
+kind: Agent
+metadata:
+  name: my-first-agent
+  version: 1.0.0
+spec:
+  role: "A helpful assistant that answers questions"
+  runtime:
+    type: node
+    image: node:20-alpine
+  capabilities:
+    - type: text-generation
+      provider: openai
+      model: gpt-4
+  triggers:
+    - type: webhook
+      endpoint: /chat
+  completion:
+    default_signal: complete
+  checkpointing:
+    enabled: true
 ```
 
-That's it. You now have a working AI agent defined in a portable, standard format.
-
-[**→ Full Getting Started Guide**](https://openstandardagents.org/docs/getting-started/)
-
----
-
-## What is OSSA?
+### v0.3.5: The OpenAPI for Software Agents
 
-**OSSA** (Open Standard for Scalable AI Agents) is a **specification standard** for defining AI agents in a vendor-neutral, portable format—like OpenAPI for REST APIs or Kubernetes manifests for containers.
+OSSA v0.3.5 introduces **10 major features** transforming it into the definitive OpenAPI for Software Agents:
 
-OSSA is **NOT** a framework. It's a standard that frameworks implement.
+- **Completion Signals** - Standardized agent termination conditions
+- **Session Checkpointing** - Resilient, resumable agent state
+- **Mixture of Experts (MoE)** - Agent-controlled expert selection
+- **BAT Framework** - Best Available Technology selection
+- **MOE Metrics** - Measure of Effectiveness evaluation
+- **Flow-Based Orchestration** - Native Flow kind support
+- **Dynamic Capability Discovery** - Runtime-adaptive capabilities
+- **Feedback & Learning Loops** - Continuous improvement
+- **Infrastructure Substrate** - Infrastructure as agent-addressable resources
+- **Enhanced A2A Protocol** - Production-ready agent-to-agent communication
 
-### The Three Kinds
+**100% Backward Compatible** - All v0.3.4 agents work with v0.3.5 runtime.
 
-OSSA defines three resource types:
+### AG2 Multi-Agent Swarm (v0.3.4+)
 
-#### Agent
-**LLM-powered agentic loops**
-
-Agents use LLMs to reason, plan, and execute tools. They handle inference, state management, and autonomous decision-making.
+OSSA v0.3.4+ adds first-class support for AG2 (AutoGen) swarm topologies:
 
 ```yaml
+# ag2-swarm.ossa.yaml
+apiVersion: ossa/v0.3.5
 kind: Agent
-spec:
-  llm:
-    provider: openai
-    model: gpt-4
-  role: |
-    You are a helpful assistant
+metadata:
+  name: software-dev-swarm
+  labels:
+    framework: ag2
+    pattern: hierarchical
+
+orchestration:
+  swarm_topology:
+    topology_type: hierarchical
+    hierarchical:
+      root: agent://supervisor
+      levels:
+        - agents:
+            - uri: agent://tech-lead
+              children:
+                - agent://coder
+                - agent://reviewer
+    speaker_selection_strategy:
+      method: capability_match
+
+  group_chat:
+    participants:
+      - agent://supervisor
+      - agent://tech-lead
+      - agent://coder
+      - agent://reviewer
+    manager: agent://supervisor
+    max_round: 20
+
+hitl:
+  enabled: true
+  human_input_mode: TERMINATE
+  intervention_points:
+    - id: code_review
+      trigger:
+        type: on_decision
+      mode: ALWAYS
+
+a2a:
+  service_discovery:
+    enabled: true
+  handoff_protocol:
+    strategy: capability_match
+
+state_management:
+  teachability:
+    enabled: true
+    learning_modes:
+      - feedback
+      - observation
 ```
 
-#### Task
-**Deterministic operations**
-
-Tasks are pure functions—no LLM required. Use them for data transformation, API calls, batch processing, or system integration.
+See [examples/ag2/](spec/v0.3.4/examples/ag2/) for AG2 examples, and [v0.3.5 examples](spec/v0.3/examples/) for new v0.3.5 features.
 
-```yaml
-kind: Task
-spec:
-  type: function
-  runtime:
-    language: typescript
-    entry: transform.ts
-```
-
-#### Workflow
-**Orchestrated compositions**
+### Validate Your Agent
 
-Workflows compose Agents and Tasks into multi-step pipelines with parallel execution, conditionals, and loops.
+```bash
+# Using the CLI
+npx @bluefly/openstandardagents validate my-agent.ossa.yaml
 
-```yaml
-kind: Workflow
-spec:
-  steps:
-    - agent: analyzer
-    - parallel:
-        - task: transform
-        - task: validate
+# Or install globally
+npm install -g @bluefly/openstandardagents
+ossa validate my-agent.ossa.yaml
 ```
 
----
+### Use in Code
 
-## Example: A Complete Enterprise Agent (v0.3.0)
+```typescript
+import { OSSASDKClient } from '@bluefly/openstandardagents/typescript';
 
-This agent demonstrates OSSA's full power—**portable across providers, compliant out of the box, and production-ready**:
+const client = new OSSASDKClient();
+const manifest = client.loadManifest('my-agent.ossa.yaml');
+const validation = client.validateManifest(manifest);
 
-```yaml
-apiVersion: ossa/v0.3.0
-kind: Agent
+if (validation.valid) {
+  console.log('Agent manifest is valid!');
+} else {
+  console.error('Validation errors:', validation.errors);
+}
+```
 
-metadata:
-  name: compliance-auditor
-  version: "1.0.0"
-  description: Enterprise compliance auditor with multi-provider support
-  labels:
-    category: compliance
-    domain: enterprise/governance
-  annotations:
-    ossa.io/maintainer: security-team@company.com
-    ossa.io/cost-center: CC-1234
-
-# NEW v0.3.0: Identity for OpenTelemetry + service mesh
-identity:
-  service_name: compliance-auditor
-  service_namespace: agents.compliance
-  service_version: "1.0.0"
+## Documentation
 
-spec:
-  role: |
-    You are a compliance auditor. Analyze documents for regulatory violations,
-    generate audit reports, and notify stakeholders of findings.
-
-  # Provider-agnostic LLM config - switch providers without code changes
-  llm:
-    provider: anthropic          # Change to: openai, azure, bedrock, ollama
-    model: claude-3-5-sonnet-20241022
-    temperature: 0.3
-    fallback:
-      provider: openai
-      model: gpt-4-turbo-preview
-
-  tools:
-    - type: mcp
-      server: filesystem
-      capabilities: [read_file, list_directory]
-    - type: function
-      name: generate_report
-      capabilities:
-        - name: create_audit_report
-          description: Generate compliance audit report
-          input_schema:
-            type: object
-            properties:
-              findings: { type: array, items: { type: object } }
-              severity: { type: string, enum: [low, medium, high, critical] }
-            required: [findings, severity]
-
-  # NEW v0.3.0: Agent-to-Agent messaging
-  messaging:
-    publishes:
-      - channel: audit.findings
-        schema: { type: object, properties: { severity: { type: string } } }
-    subscribes:
-      - channel: documents.uploaded
-        handler: on_document_received
-    reliability:
-      deliveryGuarantee: at-least-once
-      ordering: strict
-
-  # NEW v0.3.0: Persistent state with encryption
-  state:
-    storage:
-      type: redis
-      connection: ${REDIS_URL}
-    encryption:
-      enabled: true
-      algorithm: AES-256-GCM
-    ttl: 86400
-
-  # Enterprise-grade safety controls
-  safety:
-    content_filtering:
-      block_pii: true
-      block_credentials: true
-      allowed_domains: ["company.com", "*.internal.company.com"]
-    rate_limiting:
-      requests_per_minute: 100
-      tokens_per_hour: 500000
-    input_validation:
-      max_length: 50000
-    output_validation:
-      max_length: 100000
-      require_structured: true
-
-  # NEW v0.3.0: Compliance profiles
-  compliance:
-    frameworks: [SOC2, HIPAA, GDPR]
-    data_residency: us-east-1
-    audit_logging: required
-    pii_handling: encrypt_at_rest
-
-  # Full observability stack
-  observability:
-    tracing:
-      enabled: true
-      provider: opentelemetry
-      sampling_rate: 1.0
-      export_endpoint: ${OTEL_EXPORTER_OTLP_ENDPOINT}
-    logging:
-      level: info
-      structured: true
-      redact_pii: true
-    metrics:
-      track_costs: true
-      track_latency: true
-      track_tokens: true
-      export_endpoint: ${PROMETHEUS_PUSHGATEWAY}
-    activity_stream:
-      enabled: true
-      destination: kafka://events.internal
-
-  # NEW v0.3.0: Lifecycle management
-  lifecycle:
-    environments:
-      development:
-        llm: { provider: ollama, model: llama3.2 }
-      staging:
-        llm: { provider: openai, model: gpt-4o-mini }
-      production:
-        llm: { provider: anthropic, model: claude-3-5-sonnet-20241022 }
-    dependencies:
-      - name: document-processor
-        version: ">=2.0.0"
-```
+- **[Official Website](https://openstandardagents.org)** - Complete specification and guides
+- **[Quick Start Guide](docs/QUICKSTART.md)** - Get started in 5 minutes
+- **[API Reference](docs/api-reference/)** - Complete API documentation
+- **[Examples](examples/)** - 100+ reference examples
+- **[Migration Guides](migrations/guides/)** - Upgrade between versions
 
-**What this demonstrates:**
-- **Portability**: Same agent runs on Anthropic, OpenAI, Azure, or local Ollama
-- **A2A Messaging**: Pub/sub communication with other agents
-- **Enterprise Compliance**: SOC2/HIPAA/GDPR built into the manifest
-- **Environment Configs**: Dev/staging/prod with different providers
-- **Full Observability**: OpenTelemetry traces, Prometheus metrics, audit logs
+## Project Structure
 
-```bash
-ossa validate compliance-auditor.ossa.yaml
-ossa run compliance-auditor.ossa.yaml --env production
+```
+openstandardagents/
+├── spec/              # OSSA specification schemas
+│   ├── v0.3.5/       # Latest version (v0.3.5) - The OpenAPI for Software Agents
+│   └── v0.3.4/       # Previous stable version
+├── src/              # TypeScript source code
+│   ├── cli/          # CLI commands (validate, generate, migrate, etc.)
+│   ├── dev-cli/      # Developer CLI (version, spec, workflow commands)
+│   ├── services/     # Core services (validation, generation, migration)
+│   ├── adapters/     # Observability adapters (Phoenix, Langfuse, LangSmith, OpenTelemetry)
+│   ├── tools/        # Development tools
+│   └── sdks/         # SDK implementations
+├── examples/         # 100+ reference examples
+├── openapi/          # OpenAPI specifications
+├── tests/            # Test suite
+└── docs/             # Documentation
 ```
 
-[**→ See More Examples**](https://openstandardagents.org/examples/)
+## Development
 
----
+### Prerequisites
 
-## Features
+- Node.js >= 20.0.0
+- npm, pnpm, or yarn
 
-### 🌐 20+ LLM Providers
+### Setup
 
-Switch providers without changing your agent definition:
+```bash
+# Clone the repository
+git clone https://github.com/blueflyio/openstandardagents.git
+cd openstandardagents
 
-- **OpenAI** (GPT-4, GPT-3.5)
-- **Anthropic** (Claude 3.5, Claude 3)
-- **Google** (Gemini Pro, Gemini Ultra)
-- **Azure OpenAI**
-- **AWS Bedrock**
-- **Ollama** (local models)
-- **Mistral AI**
-- **Cohere**
-- And more...
+# Install dependencies
+npm install
 
-### 🛠️ MCP Tool Support
+# Run tests
+npm test
 
-Native integration with [Model Context Protocol](https://modelcontextprotocol.io/) for standardized tool definitions:
+# Build
+npm run build
 
-```yaml
-tools:
-  - type: mcp
-    server: filesystem
-    capabilities:
-      - read_file
-      - write_file
-      - list_directory
+# Validate all examples
+npm run validate:all
 ```
 
-### 💬 Agent-to-Agent Messaging
+### Available Commands
 
-Built-in pub/sub messaging for multi-agent coordination:
-
-```yaml
-spec:
-  messaging:
-    publishes:
-      - channel: task.completed
-    subscribes:
-      - channel: task.started
-        handler: on_task_started
-    reliability:
-      deliveryGuarantee: at-least-once
+```bash
+# Validation
+npm run validate:all              # Validate all manifests
+ossa validate <file>              # Validate specific file
+
+# Code Generation
+npm run generate:types           # Generate TypeScript types
+npm run generate:zod             # Generate Zod schemas
+npm run generate:all             # Generate everything
+
+# Migration
+npm run migrate                  # Migrate manifests to latest version
+npm run migrate:check            # Check which files need migration
+
+# Framework Integration
+ossa langflow <file>             # Import/export LangFlow workflows
+ossa langchain <file>            # Import/export LangChain chains
+ossa framework <file>            # Import from any supported framework
+
+# Developer CLI (for contributors)
+ossa-dev version sync            # Sync version across all files
+ossa-dev version release         # Release new version
+ossa-dev spec generate           # Generate spec from source
+ossa-dev spec validate           # Validate generated spec
+
+# Documentation
+npm run docs:generate            # Generate documentation
 ```
 
-### 🔒 Safety Controls
+## Enterprise Adoption
 
-Enterprise-grade security and compliance:
+### Who Uses OSSA?
 
-- Input/output validation
-- Content filtering
-- Rate limiting
-- Audit logging
-- Data boundary controls
-- PII detection and redaction
+Companies use OSSA to:
+- **Build vendor-neutral AI agent infrastructure** - Avoid lock-in to specific AI providers
+- **Standardize agent development** - Consistent patterns across teams and projects
+- **Enable multi-cloud deployment** - Deploy agents on AWS, GCP, Azure, or on-premises
+- **Ensure compliance** - Meet SOC2, HIPAA, GDPR requirements with built-in controls
+- **Reduce costs** - Optimize LLM spending with intelligent expert selection
+- **Future-proof investments** - Adapt to new AI models and frameworks without rewrites
 
-### 💰 Cost Tracking
+### Adoption Path
 
-Track costs across providers with unified metrics:
+1. **Start Small** - Migrate one agent to OSSA format
+2. **Validate** - Use OSSA CLI to validate and test
+3. **Scale** - Standardize all agents on OSSA
+4. **Integrate** - Connect to existing CI/CD and observability tools
+5. **Optimize** - Leverage v0.3.5 features (MoE, checkpointing) for cost and reliability gains
 
-```yaml
-observability:
-  metrics:
-    track_costs: true
-    cost_alerts:
-      - threshold: 10.00
-        action: notify
-```
+### Migration Support
 
----
+- **From Custom Agents** - Use OSSA CLI to convert existing agent definitions
+- **From LangChain/CrewAI** - Import workflows with `ossa langchain:import` or `ossa crewai:import`
+- **From Other Standards** - Migration guides available for common formats
+- **Zero Downtime** - Migrate incrementally, agents continue working during transition
 
-## Installation
+### Enterprise Support
 
-### npm
+- **Documentation** - Comprehensive guides, examples, and API reference
+- **Community** - Active Discord community and GitHub discussions
+- **Migration Tools** - Automated migration CLI for seamless upgrades
+- **Compliance** - Built-in security and compliance features
 
-```bash
-npm install -g @bluefly/openstandardagents
-```
+## Contributing
 
-### yarn
+We welcome contributions from companies and individuals! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
-```bash
-yarn global add @bluefly/openstandardagents
-```
+### Quick Contribution Guide
 
-### pnpm
+1. **Fork the repository**: https://github.com/blueflyio/openstandardagents
+2. **Create a feature branch**: `git checkout -b feature/amazing-feature`
+3. **Make your changes** and add tests
+4. **Run validations**: `npm run validate:all && npm test`
+5. **Commit**: Follow [Conventional Commits](https://www.conventionalcommits.org/)
+6. **Push and create a Pull Request**
 
-```bash
-pnpm add -g @bluefly/openstandardagents
-```
+### Code of Conduct
 
-### Homebrew (Coming Soon)
+Please read [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) before contributing.
 
-```bash
-brew install ossa
-```
+## What's Included
 
-### Docker
+### Specification
 
-```bash
-docker pull bluefly/ossa:latest
-docker run -v $(pwd):/workspace bluefly/ossa validate agent.ossa.yaml
-```
+- **JSON Schema** - Complete validation schemas for all OSSA versions
+- **OpenAPI Specs** - API definitions for agent communication
+- **Migration Guides** - Step-by-step upgrade instructions
 
----
+### Tools
 
-## Documentation
+- **CLI** - Command-line tool for validation, generation, and migration
+- **Developer CLI** - Version management and spec generation tools
+- **TypeScript SDK** - Type-safe client library
+- **Python SDK** - Planned for future release (TypeScript available now)
+- **Framework Integrations** - Import/export from LangChain, LangFlow, CrewAI, AutoGen
+- **Observability Adapters** - Phoenix/Arize, Langfuse, LangSmith, OpenTelemetry support
 
-### Getting Started
-- [Installation Guide](https://openstandardagents.org/docs/installation/)
-- [Your First Agent](https://openstandardagents.org/docs/getting-started/first-agent/)
-- [Core Concepts](https://openstandardagents.org/docs/concepts/)
-- [CLI Reference](https://openstandardagents.org/docs/cli/)
-
-### Examples & Guides
-- [Example Gallery](https://openstandardagents.org/examples/)
-- [Framework Integration](https://openstandardagents.org/docs/integrations/)
-- [Production Deployment](https://openstandardagents.org/docs/deployment/)
-- [Best Practices](https://openstandardagents.org/docs/best-practices/)
-
-### Reference
-- **Getting Started**: [openstandardagents.org/docs/getting-started/](https://openstandardagents.org/docs/getting-started/)
-- **Full Documentation**: [openstandardagents.org/docs/](https://openstandardagents.org/docs/)
-- **Schema Reference**: [openstandardagents.org/schema/](https://openstandardagents.org/schema/)
-- **Specification**: [spec/v0.3.2/ossa-0.3.2.schema.json](https://github.com/blueflyio/openstandardagents/blob/main/spec/v0.3.2/ossa-0.3.2.schema.json)
-- **Messaging Extension**: [spec/v0.3.2/messaging.md](spec/v0.3.2/messaging.md) - Agent-to-agent messaging (v0.3.0+)
-- **Examples**: [openstandardagents.org/examples/](https://openstandardagents.org/examples/)
-- **Blog**: [openstandardagents.org/blog/](https://openstandardagents.org/blog/)
-
-**OSSA** is a vendor-neutral **specification standard** (like OpenAPI)
-**LangChain/AutoGen/Semantic Kernel** are framework-specific **implementations**
-**MCP** is a formal standard for **context protocol**, not full agent lifecycle
+### Examples
 
----
+- **100+ Examples** - Reference implementations for common patterns
+- **Platform Adapters** - Integrations with LangChain, CrewAI, etc.
+- **Multi-Agent Workflows** - Complex orchestration examples
 
-## License
+## Resources
 
-**Apache License 2.0**
+- **Website**: https://openstandardagents.org - Complete specification and enterprise guides
+- **npm Package**: https://www.npmjs.com/package/@bluefly/openstandardagents
+- **Community**: [Discord](https://discord.gg/ZZqad3v4) - Join 1000+ developers and companies
+- **Documentation**: [Full Docs](https://openstandardagents.org/docs) - API reference, guides, examples
+- **Issues**: [GitHub Issues](https://github.com/blueflyio/openstandardagents/issues)
+- **Star Us**: [GitHub](https://github.com/blueflyio/openstandardagents) - Help us grow the ecosystem
 
-OSSA is open source and free to use for commercial and non-commercial purposes.
+## License
 
-See [**LICENSE**](LICENSE) for full terms.
+Apache-2.0 - See [LICENSE](LICENSE) for details.
 
----
+## Design Goals
 
-## Links
+OSSA is designed to provide:
+- **Cost Reduction** - Optimize LLM costs via MoE and intelligent routing
+- **Improved Reliability** - Enhanced session recovery with checkpointing
+- **Zero Vendor Lock-in** - Seamless provider switching through standardization
+- **Faster Development** - Accelerated agent development with standardized patterns
+- **Compliance Support** - Built-in features for SOC2, HIPAA, GDPR requirements
 
-### Development
-- **GitLab** (Primary): [gitlab.com/blueflyio/openstandardagents](https://gitlab.com/blueflyio/openstandardagents)
-- **GitHub** (Mirror): [github.com/blueflyio/openstandardagents](https://github.com/blueflyio/openstandardagents)
-- **npm Package**: [@bluefly/openstandardagents](https://www.npmjs.com/package/@bluefly/openstandardagents)
+## Acknowledgments
 
-### Community
-- **Website**: [openstandardagents.org](https://openstandardagents.org)
-- **Documentation**: [openstandardagents.org/docs](https://openstandardagents.org/docs)
-- **Discord**: [discord.gg/ossa](https://discord.gg/ossa)
-- **Twitter/X**: [@openstandardagi](https://twitter.com/openstandardagi)
+OSSA is maintained by the open-source community and adopted by companies worldwide. Special thanks to all contributors and adopters!
 
 ---
 
-<div align="center">
-
-**Built with ❤️ by the open source community**
-
-[Report Bug](https://github.com/blueflyio/openstandardagents/issues) • [Request Feature](https://github.com/blueflyio/openstandardagents/issues) • [Ask Question](https://github.com/blueflyio/openstandardagents/discussions)
-
-*Note: All development happens on GitLab. GitHub is a read-only mirror.*
+**Built for Enterprise. Open for Everyone.**
 
-</div>
+**Join the companies standardizing on OSSA** - [Get Started](https://openstandardagents.org/docs/getting-started)