@bluefly/openstandardagents 0.1.9 → 0.2.5-RC

package/examples/advanced/workflows/hybrid-model-strategy.yaml

@@ -0,0 +1,232 @@
+# Hybrid Model Strategy: Fast Local Planning + Premium Development
+# Demonstrates using fast Ollama models for planning agents and Claude for development
+
+apiVersion: ossa.io/v0.1.9
+kind: Workflow
+metadata:
+  name: hybrid-development-workflow
+  description: "Cost-optimized workflow using fast local models for planning and premium models for development"
+
+spec:
+  # Planning Phase - Use Fast Local Models
+  agents:
+    # Fast planning agent using local Ollama
+    - name: project-planner
+      type: orchestrator
+      ossa_type: orchestrator
+      modelConfig:
+        provider: "ollama"
+        model: "mistral:7b"  # Fast 1-2 second responses
+        parameters:
+          temperature: 0.3
+          max_tokens: 2000
+        ollamaConfig:
+          baseUrl: "http://localhost:11434"
+          keepAlive: "5m"
+      capabilities:
+        - project-planning
+        - task-breakdown
+        - resource-estimation
+      instruction: |
+        You are a fast project planning agent. Quickly break down development tasks:
+        - Analyze requirements
+        - Create task breakdown structure
+        - Estimate effort and dependencies
+        - Identify risks and blockers
+        Store plan in {project_plan}
+      output_key: project_plan
+
+    # Fast requirement analyzer using local model
+    - name: requirements-analyzer
+      type: critic
+      ossa_type: critic
+      modelConfig:
+        provider: "ollama"
+        model: "qwen2.5:7b"  # Good for analysis, fast
+        parameters:
+          temperature: 0.2
+          max_tokens: 1500
+        ollamaConfig:
+          baseUrl: "http://localhost:11434"
+      capabilities:
+        - requirements-analysis
+        - user-story-validation
+        - acceptance-criteria
+      instruction: |
+        Quickly analyze requirements for clarity and completeness:
+        - Validate user stories
+        - Identify missing requirements
+        - Check for conflicts or ambiguities
+        Store analysis in {requirements_analysis}
+      output_key: requirements_analysis
+
+  # Development Phase - Use Premium Models
+    # Premium development agent using Claude Code
+    - name: senior-developer
+      type: worker
+      ossa_type: worker
+      modelConfig:
+        provider: "anthropic"
+        model: "claude-3-5-sonnet-20241022"
+        parameters:
+          temperature: 0.1  # Low temperature for precise code
+          max_tokens: 8000
+        anthropicConfig:
+          apiKey: "${ANTHROPIC_API_KEY}"
+          defaultHeaders:
+            "anthropic-beta": "computer-use-2024-10-22"
+      capabilities:
+        - code-generation
+        - architecture-design
+        - best-practices
+        - testing
+        - documentation
+      instruction: |
+        You are an expert senior developer using best practices:
+        - Write clean, maintainable code
+        - Follow SOLID principles
+        - Include comprehensive tests
+        - Add proper documentation
+        - Consider security and performance
+        Use {project_plan} and {requirements_analysis} as context
+      tools:
+        - file-operations
+        - git-operations
+        - test-runner
+        - linter
+      output_key: development_result
+
+    # Code review agent using Claude
+    - name: code-reviewer
+      type: critic
+      ossa_type: critic
+      modelConfig:
+        provider: "anthropic"
+        model: "claude-3-5-sonnet-20241022"
+        parameters:
+          temperature: 0.05  # Very low for consistent reviews
+          max_tokens: 6000
+      capabilities:
+        - code-review
+        - security-analysis
+        - performance-review
+        - maintainability-check
+      instruction: |
+        Perform thorough code review focusing on:
+        - Code quality and best practices
+        - Security vulnerabilities
+        - Performance issues
+        - Maintainability concerns
+        - Test coverage and quality
+        Review {development_result} and provide detailed feedback
+      output_key: code_review
+
+  # Optimization Phase - Use Local Models for Simple Tasks
+    # Documentation generator using local model
+    - name: doc-generator
+      type: worker
+      ossa_type: worker
+      modelConfig:
+        provider: "ollama"
+        model: "codellama:7b"  # Good for documentation
+        parameters:
+          temperature: 0.4
+          max_tokens: 3000
+      capabilities:
+        - documentation-generation
+        - api-docs
+        - readme-creation
+      instruction: |
+        Generate comprehensive documentation based on {development_result}:
+        - API documentation
+        - Usage examples
+        - Installation instructions
+        - Architecture overview
+      output_key: documentation
+
+  # Cost Optimization Configuration
+  costOptimization:
+    strategy: "hybrid"
+    budgetLimits:
+      planning_phase: 0.01    # $0.01 - use free local models
+      development_phase: 1.00  # $1.00 - premium models for quality
+      optimization_phase: 0.05 # $0.05 - local models for docs
+
+    fallbackStrategy:
+      # If premium models unavailable, use these alternatives
+      fallbacks:
+        "claude-3-5-sonnet": "gpt-4o"
+        "gpt-4o": "gemini-2.0-flash"
+        "gemini-2.0-flash": "ollama:qwen2.5:7b"
+
+  # Performance Targets
+  performance:
+    planning_phase:
+      target_latency: "5s"      # Fast local responses
+      cost_per_task: "$0.00"    # Free local inference
+    development_phase:
+      target_latency: "30s"     # Quality over speed
+      cost_per_task: "$0.50"    # Premium model investment
+    optimization_phase:
+      target_latency: "10s"     # Fast local processing
+      cost_per_task: "$0.02"    # Minimal cost
+
+  # Execution Flow
+  execution:
+    phases:
+      - name: planning
+        agents: [project-planner, requirements-analyzer]
+        execution_mode: parallel
+        budget_limit: 0.01
+
+      - name: development
+        agents: [senior-developer]
+        execution_mode: sequential
+        dependencies: [planning]
+        budget_limit: 1.00
+
+      - name: review
+        agents: [code-reviewer]
+        execution_mode: sequential
+        dependencies: [development]
+        budget_limit: 0.30
+
+      - name: documentation
+        agents: [doc-generator]
+        execution_mode: sequential
+        dependencies: [development]
+        budget_limit: 0.05
+
+    # Quality gates
+    quality_gates:
+      - phase: development
+        condition: "code_review.score > 8.0"
+        action: "proceed"
+      - phase: development
+        condition: "code_review.security_issues > 0"
+        action: "retry_with_feedback"
+
+---
+# Example Environment Configuration
+# .env file should contain:
+
+# Fast local models for planning
+OLLAMA_BASE_URL=http://localhost:11434
+PLANNING_MODEL=mistral:7b
+ANALYSIS_MODEL=qwen2.5:7b
+DOC_MODEL=codellama:7b
+
+# Premium models for development
+ANTHROPIC_API_KEY=sk-ant-...
+DEVELOPMENT_MODEL=claude-3-5-sonnet-20241022
+REVIEW_MODEL=claude-3-5-sonnet-20241022
+
+# Cost controls
+MAX_PLANNING_COST=0.01
+MAX_DEVELOPMENT_COST=1.00
+MAX_TOTAL_COST=2.00
+
+# Performance settings
+PLANNING_TIMEOUT=10s
+DEVELOPMENT_TIMEOUT=300s
+REVIEW_TIMEOUT=120s

package/examples/agent-manifests/critics/critic-agent.yaml

@@ -0,0 +1,149 @@
+apiVersion: ossa.io/v0.1.9
+kind: Agent
+metadata:
+  name: code-quality-critic
+  version: v1.0.0
+  description: 'Quality assurance agent for code review, testing, and continuous improvement'
+  author: 'quality-engineering-team'
+  labels:
+    environment: production
+    classification: internal
+    role: critic
+    complexity: standard
+spec:
+  type: critic
+  subtype: code-reviewer
+  capabilities:
+    domains:
+      - code-review
+      - quality-assessment
+      - testing-validation
+      - security-analysis
+      - performance-analysis
+      - documentation-review
+    operations:
+      - analyze-code
+      - review-changes
+      - assess-quality
+      - detect-issues
+      - suggest-improvements
+      - validate-tests
+    patterns:
+      - static-analysis
+      - dynamic-analysis
+      - peer-review
+      - automated-testing
+      - quality-gates
+      - continuous-feedback
+  protocols:
+    supported:
+      - name: rest
+        version: '1.1'
+        endpoint: 'https://critic.platform.com/api/v1'
+        authentication:
+          type: bearer-token
+          scopes: ['critic.review', 'code.analyze', 'quality.assess']
+        tls: true
+      - name: webhook
+        version: '1.0'
+        endpoint: 'https://critic.platform.com/webhooks/review'
+        authentication:
+          type: hmac-sha256
+      - name: grpc
+        version: '1.0'
+        endpoint: 'grpc://critic.platform.com:9443/CodeCritic'
+        authentication:
+          type: mutual-tls
+  analysis:
+    codeQuality:
+      complexity: true
+      maintainability: true
+      reliability: true
+      security: true
+      performance: true
+      testability: true
+    staticAnalysis:
+      syntaxChecking: true
+      typeChecking: true
+      styleChecking: true
+      securityScanning: true
+      dependencyAnalysis: true
+    supportedLanguages:
+      - javascript
+      - typescript
+      - python
+      - java
+      - go
+      - rust
+      - csharp
+    qualityMetrics:
+      cyclomaticComplexity: true
+      codeChurn: true
+      testCoverage: true
+      duplication: true
+      maintainabilityIndex: true
+  review:
+    automatedReview: true
+    humanReview: true
+    reviewCriteria:
+      functionality: true
+      readability: true
+      maintainability: true
+      performance: true
+      security: true
+      testCoverage: true
+    scoring:
+      scale: '0-100'
+      passThreshold: 70
+      categories:
+        - functionality
+        - quality
+        - security
+        - performance
+        - maintainability
+  feedback:
+    suggestions: true
+    improvements: true
+    bestPractices: true
+    patterns: true
+    antiPatterns: true
+    learningResources: true
+    priority:
+      - critical
+      - high
+      - medium
+      - low
+      - info
+  integration:
+    versionControl:
+      - git
+      - mercurial
+      - subversion
+    cicdPlatforms:
+      - gitlab
+      - github
+      - jenkins
+      - azure-devops
+    issueTracking:
+      - jira
+      - github-issues
+      - gitlab-issues
+  performance:
+    throughput:
+      reviewsPerHour: 50
+      linesOfCodePerMinute: 1000
+    latency:
+      analysisTime: 30000
+      reviewTime: 120000
+      feedbackTime: 5000
+      p95: 180000
+      p99: 300000
+  monitoring:
+    reviewMetrics: true
+    qualityTrends: true
+    performanceMetrics: true
+    errorTracking: true
+    alerting:
+      reviewFailureThreshold: 5
+      qualityDegradationThreshold: 10
+      performanceThreshold: 300000

package/examples/agent-manifests/governors/governor-agent.yaml

@@ -0,0 +1,128 @@
+apiVersion: ossa.io/v0.1.9
+kind: Agent
+metadata:
+  name: policy-compliance-governor
+  version: v1.1.0
+  description: 'Governance agent enforcing policies, compliance, and security standards across systems'
+  author: 'governance-team'
+  labels:
+    environment: production
+    classification: internal
+    role: governor
+    complexity: enterprise
+spec:
+  type: governor
+  subtype: policy-enforcer
+  capabilities:
+    domains:
+      - policy-enforcement
+      - compliance-checking
+      - security-governance
+      - resource-management
+      - audit-tracking
+      - risk-assessment
+    operations:
+      - enforce-policies
+      - validate-compliance
+      - assess-risks
+      - audit-activities
+      - manage-permissions
+      - generate-reports
+    patterns:
+      - policy-as-code
+      - audit-trail
+      - role-based-access
+      - compliance-framework
+      - risk-matrix
+      - governance-workflow
+  protocols:
+    supported:
+      - name: rest
+        version: '1.1'
+        endpoint: 'https://governor.platform.com/api/v1'
+        authentication:
+          type: oauth2
+          scopes: ['governor.enforce', 'policies.validate', 'compliance.audit']
+        tls: true
+      - name: grpc
+        version: '1.0'
+        endpoint: 'grpc://governor.platform.com:9443/PolicyGovernor'
+        authentication:
+          type: mutual-tls
+      - name: webhook
+        version: '1.0'
+        endpoint: 'https://governor.platform.com/webhooks'
+        authentication:
+          type: hmac-sha256
+  governance:
+    policyEngine: 'open-policy-agent'
+    complianceFrameworks:
+      - soc2
+      - pci-dss
+      - gdpr
+      - hipaa
+      - iso27001
+    enforcementModes:
+      - advisory
+      - blocking
+      - logging
+    auditRetention: '7y'
+    riskAssessment:
+      frequency: 'weekly'
+      severity: ['low', 'medium', 'high', 'critical']
+      impact: ['minimal', 'moderate', 'significant', 'severe']
+  policies:
+    categories:
+      - security
+      - privacy
+      - operational
+      - financial
+      - regulatory
+    evaluation:
+      realtime: true
+      batch: true
+      scheduled: true
+    versioning:
+      enabled: true
+      approvalRequired: true
+      rollbackCapable: true
+  compliance:
+    continuousMonitoring: true
+    reportingFrequency: 'monthly'
+    evidenceCollection: true
+    controlMapping: true
+    attestation:
+      required: true
+      frequency: 'quarterly'
+      approvers: ['compliance-officer', 'security-lead']
+  security:
+    accessControl:
+      rbac: true
+      abac: true
+      mfa: required
+    encryption:
+      atRest: true
+      inTransit: true
+      keyRotation: '90d'
+    logging:
+      auditLogs: true
+      securityEvents: true
+      dataAccess: true
+  performance:
+    throughput:
+      policiesPerSecond: 100
+      validationsPerSecond: 500
+    latency:
+      policyEvaluation: 50
+      complianceCheck: 100
+      p95: 200
+      p99: 500
+  monitoring:
+    policyViolations: true
+    complianceStatus: true
+    riskMetrics: true
+    auditTrail: true
+    alerting:
+      policyViolationThreshold: 1
+      complianceFailureThreshold: 1
+      riskEscalationThreshold: 'high'

package/examples/agent-manifests/integrators/integrator-agent.yaml

@@ -0,0 +1,103 @@
+apiVersion: ossa.io/v0.1.9
+kind: Agent
+metadata:
+  name: multi-system-integrator
+  version: v1.4.0
+  description: 'Enterprise integration agent for connecting heterogeneous systems and APIs'
+  author: 'integration-team'
+  labels:
+    environment: production
+    classification: internal
+    role: integrator
+    complexity: enterprise
+spec:
+  type: integrator
+  subtype: api-connector
+  capabilities:
+    domains:
+      - api-integration
+      - data-synchronization
+      - protocol-translation
+      - message-routing
+      - schema-mapping
+      - event-streaming
+    operations:
+      - connect-systems
+      - transform-protocols
+      - map-schemas
+      - route-messages
+      - synchronize-data
+      - handle-failures
+    patterns:
+      - adapter-pattern
+      - message-broker
+      - event-sourcing
+      - saga-pattern
+      - circuit-breaker
+      - retry-with-backoff
+  protocols:
+    supported:
+      - name: rest
+        version: '1.1'
+        endpoint: 'https://integrator.platform.com/api/v1'
+        authentication:
+          type: oauth2
+          scopes: ['integrator.execute', 'systems.connect', 'data.transform']
+        tls: true
+      - name: graphql
+        version: '1.0'
+        endpoint: 'https://integrator.platform.com/graphql'
+        authentication:
+          type: bearer-token
+      - name: websocket
+        version: '1.0'
+        endpoint: 'wss://events.platform.com/integrator'
+        authentication:
+          type: jwt
+      - name: grpc
+        version: '1.0'
+        endpoint: 'grpc://integrator.platform.com:9443/SystemIntegrator'
+        authentication:
+          type: mutual-tls
+  integration:
+    maxConcurrentConnections: 50
+    maxSystemsPerIntegration: 20
+    connectionTimeout: 30000
+    syncInterval: 60000
+    retryPolicy:
+      maxAttempts: 5
+      backoffStrategy: exponential
+      baseDelay: 2000
+    errorHandling:
+      strategy: circuit-breaker
+      failureThreshold: 10
+      recoveryTimeout: 300000
+  transformation:
+    schemaValidation: true
+    dataMapping: true
+    protocolConversion: true
+    formatTranslation: true
+    supportedFormats:
+      - json
+      - xml
+      - avro
+      - protobuf
+      - csv
+  performance:
+    throughput:
+      messagesPerSecond: 500
+      maxBatchSize: 50
+    latency:
+      integrationOverhead: 25
+      transformationTime: 15
+      p95: 100
+      p99: 250
+  monitoring:
+    connectionHealth: true
+    transformationMetrics: true
+    errorTracking: true
+    performanceMetrics: true
+    alerting:
+      connectionFailureThreshold: 3
+      transformationErrorThreshold: 10
+      latencyThreshold: 500