@bluefly/openstandardagents 0.3.0 → 0.3.2

package/spec/v0.3.0/examples/drupal-content-writer.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Agent
 metadata:
   name: drupal-content-writer

package/spec/v0.3.0/examples/drupal-moderation-assistant.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Agent
 metadata:
   name: drupal-moderation-assistant

package/spec/v0.3.0/examples/quick-wins/complete-agent-with-quick-wins.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Agent
 metadata:
   name: example-agent-quick-wins

package/spec/v0.3.0/runtime-bindings/anthropic.yaml

@@ -0,0 +1,209 @@
+# Anthropic Runtime Binding
+# OSSA v0.3.0 Runtime Binding for Anthropic Claude
+
+apiVersion: ossa/v0.3.0
+kind: RuntimeBinding
+metadata:
+  name: anthropic
+  version: "1.0.0"
+  description: Runtime binding for Anthropic Claude models
+  labels:
+    provider: anthropic
+    category: llm
+    tier: enterprise
+
+spec:
+  # Provider identification
+  provider: anthropic
+  apiVersion: "2024-01-01"
+  
+  # Default model configuration
+  defaultModel: claude-3-5-sonnet-20241022
+  
+  # Supported models with pricing and capabilities
+  models:
+    - id: claude-opus-4-5-20251101
+      name: Claude Opus 4.5
+      contextWindow: 200000
+      maxOutput: 8192
+      pricing:
+        input: 15.0    # per 1M tokens
+        output: 75.0   # per 1M tokens
+      capabilities:
+        - tool_use
+        - vision
+        - extended_thinking
+        - streaming
+      tier: enterprise
+      
+    - id: claude-sonnet-4-20250514
+      name: Claude Sonnet 4
+      contextWindow: 200000
+      maxOutput: 8192
+      pricing:
+        input: 3.0
+        output: 15.0
+      capabilities:
+        - tool_use
+        - vision
+        - streaming
+      tier: standard
+      
+    - id: claude-3-5-sonnet-20241022
+      name: Claude 3.5 Sonnet
+      contextWindow: 200000
+      maxOutput: 8192
+      pricing:
+        input: 3.0
+        output: 15.0
+      capabilities:
+        - tool_use
+        - vision
+        - streaming
+      tier: standard
+      recommended: true
+      
+    - id: claude-3-5-haiku-20241022
+      name: Claude 3.5 Haiku
+      contextWindow: 200000
+      maxOutput: 8192
+      pricing:
+        input: 0.8
+        output: 4.0
+      capabilities:
+        - tool_use
+        - streaming
+      tier: economy
+      
+    - id: claude-3-opus-20240229
+      name: Claude 3 Opus
+      contextWindow: 200000
+      maxOutput: 4096
+      pricing:
+        input: 15.0
+        output: 75.0
+      capabilities:
+        - tool_use
+        - vision
+        - streaming
+      tier: enterprise
+      
+    - id: claude-3-sonnet-20240229
+      name: Claude 3 Sonnet
+      contextWindow: 200000
+      maxOutput: 4096
+      pricing:
+        input: 3.0
+        output: 15.0
+      capabilities:
+        - tool_use
+        - vision
+        - streaming
+      tier: standard
+      deprecated: true
+      
+    - id: claude-3-haiku-20240307
+      name: Claude 3 Haiku
+      contextWindow: 200000
+      maxOutput: 4096
+      pricing:
+        input: 0.25
+        output: 1.25
+      capabilities:
+        - tool_use
+        - streaming
+      tier: economy
+
+  # Capability mapping configuration
+  capabilityMapping:
+    # How OSSA tools map to Anthropic format
+    toolFormat: tool_use
+    
+    # Tool input schema mapping
+    toolSchema:
+      wrapper: null  # Anthropic uses inline schema
+      inputKey: input_schema
+      outputKey: null  # Not supported
+      
+    # Message format mapping
+    messageFormat:
+      systemPrompt: separate  # System prompt is a separate parameter
+      userRole: user
+      assistantRole: assistant
+      toolResultRole: user  # Tool results sent as user messages
+      
+    # Content block mapping
+    contentBlocks:
+      text: text
+      image: image
+      toolUse: tool_use
+      toolResult: tool_result
+      
+    # Structured output support
+    structuredOutput: true
+    
+    # Streaming support
+    streaming: true
+    
+    # Vision/multimodal support
+    vision: true
+
+  # Rate limiting defaults
+  rateLimits:
+    requestsPerMinute: 1000
+    tokensPerMinute: 400000
+    tokensPerDay: 10000000
+
+  # Authentication configuration
+  authentication:
+    type: api_key
+    headerName: x-api-key
+    envVariable: ANTHROPIC_API_KEY
+
+  # Endpoint configuration
+  endpoints:
+    messages: https://api.anthropic.com/v1/messages
+    
+  # Request configuration
+  requestConfig:
+    timeout: 120000  # 2 minutes
+    retries: 3
+    retryDelay: 1000
+    retryBackoff: exponential
+
+  # Extension configuration
+  extensions:
+    # Anthropic-specific OSSA extension
+    anthropic:
+      description: Anthropic-specific configuration options
+      schema:
+        type: object
+        properties:
+          model:
+            type: string
+            description: Override model from manifest
+          system:
+            type: string
+            description: Custom system prompt
+          max_tokens:
+            type: integer
+            description: Maximum tokens to generate
+          temperature:
+            type: number
+            minimum: 0
+            maximum: 1
+          stop_sequences:
+            type: array
+            items:
+              type: string
+            description: Custom stop sequences
+          top_p:
+            type: number
+            minimum: 0
+            maximum: 1
+          top_k:
+            type: integer
+            minimum: 1
+          tools:
+            type: array
+            description: Additional Anthropic-native tools

package/spec/v0.3.1/UNIFIED-SCHEMA.md

@@ -0,0 +1,120 @@
+# OSSA v0.3.1 - Unified Agent Schema
+
+## The Rocketship 🚀
+
+This schema unifies OSSA, GitLab Duo, Google A2A, and MCP into a single universal agent platform.
+
+### What Changed
+
+**Before (v0.2.x):**
+```yaml
+llm:
+  provider: anthropic
+  model: claude-sonnet-4-20250514
+```
+
+**After (v0.3.1):**
+```yaml
+llm:
+  provider: ${LLM_PROVIDER:-anthropic}
+  model: ${LLM_MODEL:-claude-sonnet}
+  profile: ${LLM_PROFILE:-balanced}
+  fallback_models:
+    - provider: ${LLM_FALLBACK_PROVIDER_1:-openai}
+      model: ${LLM_FALLBACK_MODEL_1:-gpt-4o}
+```
+
+### Key Features
+
+1. **Zero Hardcoded Models** - All LLM config is runtime-configurable
+2. **Execution Profiles** - Google A2A compatible (fast/balanced/deep/safe)
+3. **Multi-Runtime Support** - Works with Duo, A2A, OSSA, MCP
+4. **Fallback Models** - Multi-provider resilience
+5. **Structured Functions** - A2A/OpenAI function calling format
+6. **Extensions** - Pluggable external behaviors
+
+### Compatibility Matrix
+
+| Feature | OSSA v0.2.x | Duo | A2A | v0.3.1 |
+|---------|-------------|-----|-----|--------|
+| Runtime-configurable models | ❌ | ❌ | ✅ | ✅ |
+| Execution profiles | ❌ | ❌ | ✅ | ✅ |
+| Multi-provider fallback | partial | ❌ | ✅ | ✅ |
+| Structured functions | ❌ | partial | ✅ | ✅ |
+| Extensions | partial | partial | ✅ | ✅ |
+
+### Migration
+
+```bash
+# Auto-migrate all agents
+./scripts/migrate-to-unified-llm.sh
+
+# Generate new agent
+./scripts/generate-agent.sh my-agent worker
+
+# Validate
+ossa validate examples/
+```
+
+### Environment Variables
+
+```bash
+# Primary LLM
+export LLM_PROVIDER=anthropic
+export LLM_MODEL=claude-sonnet-4
+export LLM_PROFILE=balanced
+
+# Fallbacks
+export LLM_FALLBACK_PROVIDER_1=openai
+export LLM_FALLBACK_MODEL_1=gpt-4o
+
+# Runtime
+export AGENT_RUNTIME=unified
+export AGENT_SCHEDULING=fair
+export AGENT_PRIORITY=normal
+```
+
+### Execution Profiles
+
+- **fast** - Quick responses (4K tokens, temp=0.0)
+- **balanced** - General ops (16K tokens, temp=0.1)
+- **deep** - Analysis (32K tokens, temp=0.2, reasoning enabled)
+- **safe** - Compliance (temp=0.0, validation required)
+
+### CI Enforcement
+
+Add to `.gitlab-ci.yml`:
+
+```yaml
+include:
+  - local: .gitlab/ci/validate-no-hardcoded-models.yml
+```
+
+This blocks any MR with hardcoded model names.
+
+### Example Agent
+
+See: `examples/unified/security-scanner.ossa.yaml`
+
+### Schema Files
+
+- `schemas/unified-llm.yaml` - LLM configuration
+- `schemas/runtime.yaml` - Runtime declaration
+- `schemas/capabilities.yaml` - Capability definitions
+- `schemas/functions.yaml` - Function declarations
+- `schemas/agent-unified.yaml` - Complete agent schema
+
+### Why This Matters
+
+1. **No More Breaking Changes** - Model updates don't require code changes
+2. **Multi-Provider** - Switch between Anthropic/OpenAI/Google/Groq instantly
+3. **Future-Proof** - New runtimes (A2A, Duo) work without modification
+4. **Cost Optimization** - Use cheap models for triage, expensive for analysis
+5. **Compliance** - Audit trail of which models were used when
+
+### Next Steps
+
+1. Run migration: `./scripts/migrate-to-unified-llm.sh`
+2. Update CI: Add validation rule
+3. Test: `ossa validate examples/`
+4. Deploy: Agents auto-detect runtime