@bluefly/openstandardagents 0.2.4

package/website/content/docs/getting-started/installation.md

@@ -0,0 +1,155 @@
+---
+title: "Installation"
+---
+
+# Installation Guide
+
+Install OSSA CLI and get ready to create your first agent.
+
+## Prerequisites
+
+- **Node.js** 18+ (for OSSA CLI)
+- **npm** or **yarn** package manager
+- Basic familiarity with YAML/JSON
+
+## Installation Methods
+
+### Method 1: Global Installation (Recommended)
+
+Install OSSA CLI globally for use across all projects:
+
+```bash
+npm install -g @bluefly/openstandardagents
+```
+
+Verify installation:
+
+```bash
+ossa --version
+```
+
+### Method 2: Local Installation
+
+Install in a specific project:
+
+```bash
+npm install --save-dev @bluefly/openstandardagents
+```
+
+Use via npx:
+
+```bash
+npx ossa --version
+```
+
+### Method 3: Using agent-buildkit (Production)
+
+For production deployments with full features:
+
+```bash
+npm install -g @bluefly/agent-buildkit
+```
+
+This includes OSSA validation plus:
+- GitLab integration
+- Kubernetes deployment
+- Production monitoring
+- Compliance tooling
+
+## Verify Installation
+
+Check that OSSA CLI is working:
+
+```bash
+ossa --help
+```
+
+You should see:
+
+```
+OSSA CLI - Open Standard for Scalable Agents (The OpenAPI for AI Agents)
+
+Usage: ossa [options] [command]
+
+Options:
+  -V, --version   output the version number
+  -h, --help      display help for command
+
+Commands:
+  validate <path>  Validate OSSA agent manifest or OpenAPI spec
+  generate <type>  Generate OSSA agent manifest from template
+  migrate <source> Migrate agent manifest between OSSA versions
+  help [command]   display help for command
+```
+
+## What Gets Installed
+
+### OSSA CLI Commands
+
+- `ossa validate` - Validate agent manifests against JSON Schema
+- `ossa generate` - Generate agent manifests from templates
+- `ossa migrate` - Migrate between OSSA versions
+
+### Package Contents
+
+- **JSON Schema**: `spec/v0.2.2/ossa-0.2.2.schema.json`
+- **TypeScript Types**: Available via package exports
+- **CLI Tool**: `bin/ossa` executable
+
+## Troubleshooting
+
+### Command Not Found
+
+If `ossa` command is not found:
+
+```bash
+# Check npm global bin path
+npm config get prefix
+
+# Add to PATH if needed
+export PATH="$(npm config get prefix)/bin:$PATH"
+```
+
+### Permission Errors
+
+On Linux/macOS, you may need sudo:
+
+```bash
+sudo npm install -g @bluefly/openstandardagents
+```
+
+Or configure npm to use a different directory:
+
+```bash
+mkdir ~/.npm-global
+npm config set prefix '~/.npm-global'
+export PATH=~/.npm-global/bin:$PATH
+```
+
+### Version Conflicts
+
+If you have multiple versions:
+
+```bash
+# List global packages
+npm list -g --depth=0
+
+# Uninstall old version
+npm uninstall -g @bluefly/openstandardagents
+
+# Install latest
+npm install -g @bluefly/openstandardagents@latest
+```
+
+## Next Steps
+
+1. ✅ Installation complete
+2. → [Hello World Tutorial](Hello-World)
+3. → [First Agent Creation](First-Agent)
+
+## Related
+
+- [5-Minute Overview](5-Minute-Overview)
+- [Hello World Tutorial](Hello-World)
+- [CLI Reference](../quick-reference)
+

package/website/content/docs/getting-started/running-agents.md

@@ -0,0 +1,107 @@
+---
+title: "Running Agents"
+---
+
+# Running Agents
+
+Learn how to run OSSA agents using the CLI.
+
+## Prerequisites
+
+- Node.js 18+
+- npm or yarn
+- API key for your LLM provider
+
+## Installation
+
+```bash
+npm install -g @bluefly/openstandardagents
+```
+
+## Quick Start
+
+### 1. Set your API key
+
+```bash
+export OPENAI_API_KEY=sk-...
+```
+
+### 2. Create an agent manifest
+
+```yaml
+# support-agent.ossa.yaml
+apiVersion: ossa/v0.2.3
+kind: Agent
+
+metadata:
+  name: support-agent
+  version: 1.0.0
+  description: Customer support agent
+
+spec:
+  role: |
+    You are a helpful customer support agent.
+    Answer questions about orders and shipping.
+
+  llm:
+    provider: openai
+    model: gpt-4o-mini
+    temperature: 0.7
+```
+
+### 3. Run the agent
+
+```bash
+# Interactive mode
+ossa run support-agent.ossa.yaml
+
+# Single message
+ossa run support-agent.ossa.yaml -m "Help me track my order"
+
+# Verbose (show tool calls)
+ossa run support-agent.ossa.yaml -v
+```
+
+## Command Options
+
+| Option | Description |
+|--------|-------------|
+| `-r, --runtime` | Runtime adapter (default: openai) |
+| `-v, --verbose` | Show tool calls |
+| `-m, --message` | Single message mode |
+| `--no-validate` | Skip validation |
+| `--max-turns` | Max tool call iterations |
+
+## Supported Runtimes
+
+| Runtime | Status | Provider |
+|---------|--------|----------|
+| openai | Available | OpenAI API |
+| anthropic | Coming Soon | Anthropic Claude |
+| ollama | Coming Soon | Local LLMs |
+| gemini | Coming Soon | Google AI |
+
+## Adding Tools
+
+Define tools in your manifest:
+
+```yaml
+extensions:
+  openai_agents:
+    tools_mapping:
+      - ossa_capability: order_tracking
+        openai_tool_name: get_order_status
+        description: Get order status by ID
+        parameters:
+          type: object
+          properties:
+            order_id:
+              type: string
+          required: [order_id]
+```
+
+## Next Steps
+
+- [Manifest Reference](/docs/schema-reference)
+- [Framework Extensions](/docs/openapi-extensions)
+- [Drupal Integration](/docs/integrations/drupal)

package/website/content/docs/integrations/aiflow.md

@@ -0,0 +1,104 @@
+# 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/v1.0/ossa-1.0.schema.json](https://github.com/blueflyio/openstandardagents/blob/development/spec/v1.0/ossa-1.0.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/v1.0/ossa-1.0.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/integrations/drupal.md

@@ -0,0 +1,105 @@
+---
+title: "Drupal Integration"
+---
+
+# Drupal Integration
+
+Integrate OSSA agents with Drupal's LLM Platform.
+
+## Overview
+
+The OSSA Drupal modules provide:
+- Agent management UI
+- Workflow orchestration
+- CrewAI integration
+- Marketplace for agents
+
+## Available Modules
+
+| Module | Description |
+|--------|-------------|
+| ai_agents_ossa | Core OSSA integration |
+| ai_agents_orchestra | Workflow orchestration |
+| ai_agents_crewai | CrewAI framework bridge |
+| ai_agents_marketplace | Agent marketplace |
+| ai_agents_huggingface | HuggingFace models |
+
+## Installation
+
+### Via Composer
+
+```bash
+composer require drupal/ai_agents_ossa
+drush en ai_agents_ossa
+```
+
+### Configuration
+
+1. Go to `/admin/config/ai/agents`
+2. Configure LLM provider credentials
+3. Import OSSA manifests
+
+## Creating Agents in Drupal
+
+### Using the UI
+
+1. Navigate to `/admin/content/agents`
+2. Click "Add Agent"
+3. Upload OSSA manifest or configure inline
+
+### Using Drush
+
+```bash
+# Import agent from manifest
+drush ai:agent:import path/to/agent.ossa.yaml
+
+# List agents
+drush ai:agent:list
+
+# Run agent
+drush ai:agent:run my-agent "Hello"
+```
+
+## Workflow Orchestration
+
+The `ai_agents_orchestra` module enables multi-agent workflows:
+
+```yaml
+# workflow.ossa.yaml
+apiVersion: ossa/v0.2.5
+kind: AgentGraph
+
+metadata:
+  name: support-workflow
+
+spec:
+  agents:
+    - ref: triage-agent
+    - ref: resolver-agent
+  edges:
+    - from: triage-agent
+      to: resolver-agent
+  process: sequential
+```
+
+## ECA Integration
+
+OSSA agents work with Drupal's ECA (Event-Condition-Action):
+
+- Trigger agents on content events
+- Use agent responses in conditions
+- Chain multiple agents
+
+## API Endpoints
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `/api/agents` | GET | List agents |
+| `/api/agents/{id}/run` | POST | Run agent |
+| `/api/agents/{id}/status` | GET | Agent status |
+
+## Next Steps
+
+- [OSSA Manifest Reference](/docs/schema-reference)
+- [Orchestra Module Docs](https://github.com/blueflyio/openstandardagents)
+- [CrewAI Integration](/docs/migration-guides/crewai-to-ossa)

package/website/content/docs/migration-guides/00-index.md

@@ -0,0 +1,76 @@
+---
+title: Migration Guides
+description: Migrate from existing AI frameworks to OSSA
+weight: 1
+---
+
+# Migration Guides
+
+Comprehensive guides for migrating from popular AI agent frameworks to OSSA (Open Standard for Scalable Agents).
+
+## Available Guides
+
+### 🤖 Framework Migrations
+
+- **[Anthropic MCP to OSSA](./anthropic-mcp-to-ossa.md)** - Extend MCP servers with OSSA for production features
+- **[CrewAI to OSSA](./crewai-to-ossa.md)** - Migrate CrewAI crews to OSSA orchestration
+- **[LangChain to OSSA](./langchain-to-ossa.md)** - Convert LangChain agents to OSSA agents
+- **[Langflow to OSSA](./langflow-to-ossa.md)** - Transform visual flows into OSSA manifests
+- **[OpenAI to OSSA](./openai-to-ossa.md)** - Migrate OpenAI Assistants API to OSSA
+
+### 🔧 Platform Migrations
+
+- **[Drupal ECA to OSSA](./drupal-eca-to-ossa.md)** - Convert Drupal automation rules to OSSA agents
+
+## Migration Overview
+
+All OSSA migrations share common patterns:
+
+### 1. Assessment Phase
+- Inventory existing agents/workflows
+- Map components to OSSA equivalents
+- Identify production requirements
+
+### 2. Design Phase
+- Create OSSA agent manifests
+- Define capability schemas
+- Plan workflow execution
+
+### 3. Implementation Phase
+- Implement agent logic
+- Add monitoring and policies
+- Configure deployment
+
+### 4. Testing Phase
+- Unit test capabilities
+- Integration test workflows
+- Validate performance
+
+### 5. Deployment Phase
+- Deploy to target environment
+- Configure monitoring
+- Run smoke tests
+
+## Why Migrate to OSSA?
+
+### Production Features
+- ✅ **Multi-Protocol Support** - HTTP, gRPC, WebSocket, MCP, A2A
+- ✅ **Enterprise Monitoring** - Traces, metrics, logs, health checks
+- ✅ **Kubernetes Native** - Deploy and scale on K8s
+- ✅ **OpenAPI Integration** - REST APIs for all agents
+- ✅ **Compliance Ready** - ISO42001, SOC2, GDPR support
+
+### Framework Advantages
+- 🔓 **No Vendor Lock-in** - Use any LLM provider
+- 🌐 **Multi-Runtime** - Local, Docker, K8s, serverless
+- 🔌 **Interoperable** - Works with existing frameworks
+- 📊 **Observable** - Built-in monitoring and tracing
+- 🔒 **Secure** - Enterprise security and policies
+
+## Getting Help
+
+- **Documentation**: [OSSA Wiki](https://github.com/blueflyio/openstandardagents/wiki/home)
+- **Issues**: [GitHub Issues](https://github.com/blueflyio/openstandardagents/issues)
+- **Discord**: [OSSA Community](https://github.com/blueflyio/openstandardagents/discussions)
+
+Ready to migrate? Choose your framework above and get started!

package/website/content/docs/migration-guides/README.md

@@ -0,0 +1,133 @@
+---
+title: "README"
+---
+
+# Migration Guides
+
+Comprehensive guides for migrating to or extending with OSSA (Open Standards for Scalable Agents).
+
+## Available Guides
+
+### 1. [Anthropic MCP to OSSA](./Anthropic-MCP-to-OSSA.md)
+**Extend Anthropic Model Context Protocol servers with OSSA**
+
+- **Target Audience:** MCP server developers, Claude Desktop users
+- **Complexity:** Intermediate
+- **Time to Complete:** 2-4 hours
+- **Key Benefits:**
+  - Keep MCP compatibility
+  - Add HTTP/REST API support
+  - Enable production monitoring
+  - Deploy to Kubernetes
+  - Multi-protocol access (MCP + OpenAPI + A2A)
+
+**Topics Covered:**
+- MCP servers → OSSA agents
+- MCP tools → OSSA capabilities
+- MCP resources → OSSA data sources
+- Dual-mode implementation (stdio + HTTP)
+- Integration patterns
+- 3 complete before/after examples
+
+---
+
+### 2. [LangChain to OSSA](./LangChain-to-OSSA.md)
+**Migrate Python LangChain agents to OSSA specification**
+
+- **Target Audience:** LangChain developers, Python AI engineers
+- **Complexity:** Intermediate to Advanced
+- **Time to Complete:** 4-8 hours
+- **Key Benefits:**
+  - Language-agnostic deployment
+  - Better orchestration
+  - Production-ready infrastructure
+  - Multi-framework support
+
+---
+
+## Quick Decision Guide
+
+**Choose the right guide based on your current stack:**
+
+```
+Have MCP servers? → Use "Anthropic MCP to OSSA"
+├─ Already working in Claude Desktop?
+│  └─ Keep MCP, add OSSA for production features
+│
+Have LangChain agents? → Use "LangChain to OSSA"
+├─ Python-based AI workflows?
+│  └─ Migrate to OSSA for better orchestration
+│
+Starting fresh? → Check Getting Started guide
+└─ Use OSSA from day one
+```
+
+## Common Scenarios
+
+### Scenario 1: "I have MCP servers for Claude Desktop"
+→ **Use:** [Anthropic MCP to OSSA](./Anthropic-MCP-to-OSSA.md)
+- Extend with HTTP API
+- Add monitoring/metrics
+- Deploy to production
+
+### Scenario 2: "I have LangChain Python agents"
+→ **Use:** [LangChain to OSSA](./LangChain-to-OSSA.md)
+- Migrate to TypeScript/Node.js
+- Add multi-protocol support
+- Enable agent orchestration
+
+### Scenario 3: "I want to expose my agent via multiple protocols"
+→ **Use:** [Anthropic MCP to OSSA](./Anthropic-MCP-to-OSSA.md)
+- MCP for Claude Desktop
+- OpenAPI for REST clients
+- A2A for agent-to-agent communication
+
+## Migration Roadmap
+
+```
+1. Assessment (1-2 hours)
+   ├─ Inventory existing agents/servers
+   ├─ Identify required features
+   └─ Choose migration guide
+
+2. Planning (2-4 hours)
+   ├─ Map existing functionality to OSSA
+   ├─ Design agent manifest
+   └─ Plan deployment strategy
+
+3. Implementation (4-8 hours)
+   ├─ Create OSSA agent structure
+   ├─ Migrate business logic
+   ├─ Configure bridges (MCP, OpenAPI, etc.)
+   └─ Add monitoring
+
+4. Testing (2-4 hours)
+   ├─ Test all protocols
+   ├─ Verify backward compatibility
+   └─ Load testing
+
+5. Deployment (2-4 hours)
+   ├─ Deploy to target environment
+   ├─ Configure monitoring
+   └─ Update client configurations
+```
+
+## Support
+
+- **Documentation:** `/Users/flux423/Sites/LLM/agent-buildkit/docs/`
+- **Examples:** `/Users/flux423/Sites/LLM/agent-buildkit/.agents/`
+- **OSSA Spec:** [OSSA Complete Reference](../OSSA-COMPLETE-AGENT-REFERENCE.md)
+- **BuildKit CLI:** `buildkit agents --help`
+
+## Contributing
+
+Found an issue or want to add a migration guide?
+
+1. Create an issue: [GitHub Issues](https://github.com/blueflyio/openstandardagents/issues)
+2. Submit a merge request with your guide
+3. Follow the existing structure and format
+
+---
+
+**Last Updated:** 2025-11-10
+**Maintained By:** Agent BuildKit Team