@bluefly/openstandardagents 0.1.9 → 0.2.5-RC

package/examples/agent-manifests/judges/judge-agent.yaml

@@ -0,0 +1,153 @@
+apiVersion: ossa.io/v0.1.9
+kind: Agent
+metadata:
+  name: decision-arbitration-judge
+  version: v1.0.0
+  description: 'Ultimate decision-making agent for conflict resolution and final arbitration'
+  author: 'architecture-council'
+  labels:
+    environment: production
+    classification: internal
+    role: judge
+    complexity: enterprise
+spec:
+  type: judge
+  subtype: decision-arbitrator
+  capabilities:
+    domains:
+      - decision-making
+      - conflict-resolution
+      - arbitration
+      - consensus-building
+      - priority-ranking
+      - resource-allocation
+    operations:
+      - arbitrate-conflicts
+      - make-decisions
+      - resolve-disputes
+      - prioritize-requests
+      - allocate-resources
+      - build-consensus
+    patterns:
+      - decision-tree
+      - weighted-scoring
+      - consensus-algorithm
+      - conflict-resolution
+      - priority-queue
+      - resource-optimization
+  protocols:
+    supported:
+      - name: rest
+        version: '1.1'
+        endpoint: 'https://judge.platform.com/api/v1'
+        authentication:
+          type: oauth2
+          scopes: ['judge.arbitrate', 'decisions.make', 'conflicts.resolve']
+        tls: true
+      - name: grpc
+        version: '1.0'
+        endpoint: 'grpc://judge.platform.com:9443/DecisionJudge'
+        authentication:
+          type: mutual-tls
+      - name: event-stream
+        version: '1.0'
+        endpoint: 'wss://events.platform.com/judge'
+        authentication:
+          type: jwt
+  arbitration:
+    decisionMaking:
+      algorithm: 'weighted-consensus'
+      votingSystem: 'ranked-choice'
+      quorumRequired: true
+      minimumParticipants: 3
+      timeoutPeriod: 300000
+    conflictResolution:
+      escalationLevels:
+        - automated
+        - peer-review
+        - expert-panel
+        - executive-decision
+      resolutionStrategies:
+        - compromise
+        - priority-based
+        - resource-optimal
+        - consensus-driven
+    criteria:
+      businessValue: 30
+      technicalFeasibility: 25
+      riskAssessment: 20
+      resourceRequirement: 15
+      timeToMarket: 10
+  decision:
+    factors:
+      - impact
+      - urgency
+      - complexity
+      - risk
+      - cost
+      - benefit
+      - feasibility
+      - alignment
+    scoringModel:
+      scale: '1-10'
+      weights:
+        strategic: 40
+        operational: 30
+        technical: 20
+        financial: 10
+    evidenceRequired:
+      dataPoints: true
+      stakeholderInput: true
+      expertOpinion: true
+      historicalContext: true
+      riskAssessment: true
+  governance:
+    authority:
+      scope: 'platform-wide'
+      limitations:
+        ['legal-compliance', 'budget-constraints', 'policy-boundaries']
+      escalationPath: 'executive-committee'
+    accountability:
+      decisionAudit: true
+      outcomeTracking: true
+      performanceReview: true
+      learningFeedback: true
+    transparency:
+      decisionLog: true
+      rationale: true
+      stakeholderNotification: true
+      appealProcess: true
+  consensus:
+    buildingMethods:
+      - facilitated-discussion
+      - structured-voting
+      - compromise-negotiation
+      - expert-mediation
+    participantRoles:
+      - stakeholder
+      - expert
+      - facilitator
+      - observer
+    agreements:
+      unanimous: preferred
+      majority: acceptable
+      executive: fallback
+  performance:
+    throughput:
+      decisionsPerDay: 20
+      conflictsPerWeek: 10
+    latency:
+      simpleDecision: 3600000
+      complexArbitration: 86400000
+      conflictResolution: 259200000
+      p95: 172800000
+      p99: 604800000
+  monitoring:
+    decisionQuality: true
+    outcomeTracking: true
+    stakeholderSatisfaction: true
+    processEfficiency: true
+    alerting:
+      escalationThreshold: 3
+      timeoutThreshold: 604800000
+      satisfactionThreshold: 70

package/examples/agent-manifests/monitors/monitor-agent.yaml

@@ -0,0 +1,122 @@
+apiVersion: ossa.io/v0.1.9
+kind: Agent
+metadata:
+  name: system-performance-monitor
+  version: v1.3.0
+  description: "Real-time monitoring agent for system health, performance, and resource utilization"
+  author: "monitoring-team"
+  labels:
+    environment: production
+    classification: internal
+    role: monitor
+    complexity: standard
+spec:
+  type: monitor
+  subtype: performance-monitor
+  capabilities:
+    domains:
+      - system-monitoring
+      - performance-tracking
+      - resource-monitoring
+      - health-checking
+      - alerting
+      - metrics-collection
+    operations:
+      - collect-metrics
+      - check-health
+      - detect-anomalies
+      - generate-alerts
+      - track-performance
+      - analyze-trends
+    patterns:
+      - observer-pattern
+      - event-driven
+      - time-series
+      - threshold-based
+      - anomaly-detection
+      - aggregation
+  protocols:
+    supported:
+      - name: rest
+        version: "1.1"
+        endpoint: "https://monitor.platform.com/api/v1"
+        authentication:
+          type: bearer-token
+          scopes: ["monitor.read", "metrics.collect", "alerts.send"]
+        tls: true
+      - name: prometheus
+        version: "1.0"
+        endpoint: "http://monitor.platform.com:9090/metrics"
+        authentication:
+          type: none
+      - name: websocket
+        version: "1.0"
+        endpoint: "wss://events.platform.com/monitor"
+        authentication:
+          type: jwt
+      - name: snmp
+        version: "2c"
+        endpoint: "udp://devices.platform.com:161"
+        authentication:
+          type: community-string
+  monitoring:
+    collectionInterval: 30000
+    retentionPeriod: "30d"
+    maxMetricsPerSecond: 10000
+    aggregationWindow: 300000
+    alertingEnabled: true
+    thresholds:
+      cpu:
+        warning: 70
+        critical: 90
+      memory:
+        warning: 80
+        critical: 95
+      disk:
+        warning: 85
+        critical: 95
+      network:
+        warning: 80
+        critical: 95
+  detection:
+    anomalyDetection: true
+    baselineWindow: "7d"
+    sensitivityLevel: medium
+    machinelearning: true
+    algorithms:
+      - statistical-analysis
+      - trend-detection
+      - seasonal-decomposition
+      - isolation-forest
+  alerting:
+    channels:
+      - email
+      - slack
+      - webhook
+      - sms
+    escalationPolicy:
+      - level: warning
+        delay: 300
+      - level: critical
+        delay: 60
+    suppressionRules:
+      - duplicateWindow: 3600
+      - maintenanceMode: true
+  performance:
+    throughput:
+      metricsPerSecond: 1000
+      maxConcurrentChecks: 100
+    latency:
+      collectionLatency: 10
+      alertingLatency: 5
+      p95: 50
+      p99: 100
+  monitoring:
+    selfMonitoring: true
+    healthChecks: true
+    performanceMetrics: true
+    errorTracking: true
+    alerting:
+      collectionFailureThreshold: 5
+      alertingFailureThreshold: 3
+      latencyThreshold: 1000

package/examples/agent-manifests/orchestrators/orchestrator-agent.yaml

@@ -0,0 +1,247 @@
+# ============================================================================
+# OSSA Multi-Workflow Orchestrator Agent Manifest
+# ============================================================================
+# Purpose: Enterprise-grade orchestrator for managing complex multi-agent
+#          workflows across distributed systems
+#
+# Key Concepts:
+# - Orchestration: Central coordinator managing workflow execution and state
+# - Agent Coordination: Discovering, routing, and managing worker agents
+# - Dependency Management: Handling execution order and data flow between agents
+# - Failure Recovery: Implementing compensation, retry, and fallback strategies
+#
+# Related Examples:
+# - examples/openapi-extensions/orchestrator-agent-api.openapi.yml (API definition)
+# - examples/production/agent.yml (Worker agent pattern)
+# - examples/kagent/k8s-troubleshooter.ossa.yaml (Complex orchestration)
+#
+# OSSA Version: 0.1.9 (Orchestrator profile)
+# Conformance: Enterprise-level orchestration with high availability
+# ============================================================================
+
+# OSSA manifest version - defines the schema and features available
+apiVersion: ossa.io/v0.1.9
+
+# Kind declares this as an Agent manifest (vs. Bridge, Tool, etc.)
+kind: Agent
+
+# ============================================================================
+# METADATA: Identity and classification for agent discovery
+# ============================================================================
+metadata:
+  # Unique identifier within the agent ecosystem
+  name: multi-workflow-orchestrator
+
+  # Semantic version for compatibility tracking
+  version: v2.1.0
+
+  # Human-readable description for documentation and discovery
+  description: 'Enterprise orchestrator managing complex multi-agent workflows across distributed systems'
+
+  # Team or individual responsible for maintenance
+  author: 'platform-engineering-team'
+
+  # Labels enable filtering, routing, and policy enforcement
+  labels:
+    environment: production      # Deployment environment (dev/staging/production)
+    classification: internal     # Data classification level (public/internal/confidential/secret)
+    role: orchestrator          # Agent role in the ecosystem (orchestrator/worker/specialist/critic)
+    complexity: enterprise      # Complexity level (simple/moderate/enterprise)
+
+# ============================================================================
+# SPEC: Core agent configuration and capabilities
+# ============================================================================
+spec:
+  # Type defines the agent's primary role in multi-agent systems
+  # - orchestrator: Coordinates other agents and manages workflows
+  # - worker: Performs specific tasks delegated by orchestrators
+  # - specialist: Domain-specific expertise (e.g., code review, security)
+  # - critic: Evaluates and validates outputs from other agents
+  type: orchestrator
+
+  # Subtype provides fine-grained specialization
+  # - workflow-coordinator: Manages sequential and parallel workflows
+  # - agent-router: Routes requests to appropriate agents
+  # - resource-manager: Allocates compute/memory/token budgets
+  subtype: workflow-coordinator
+
+  # ============================================================================
+  # CAPABILITIES: What this orchestrator can do
+  # ============================================================================
+  capabilities:
+    # Domains: High-level problem spaces this agent operates in
+    domains:
+      - workflow-orchestration    # Design and execute multi-step workflows
+      - agent-coordination        # Discover, route, and manage agents
+      - resource-allocation       # Distribute compute/memory/tokens across agents
+      - dependency-management     # Handle execution order and data dependencies
+      - failure-recovery         # Implement retry, compensation, and fallback logic
+
+    # Operations: Specific actions this agent can perform
+    operations:
+      - orchestrate-workflows    # Create and execute workflow definitions
+      - coordinate-agents        # Manage agent lifecycle and communication
+      - manage-dependencies      # Resolve execution order based on data flow
+      - handle-failures         # Execute compensation transactions on failure
+      - scale-resources         # Dynamically allocate resources based on load
+      - monitor-execution       # Track progress, metrics, and health
+
+    # Patterns: Architectural patterns this orchestrator implements
+    patterns:
+      - saga-pattern           # Distributed transactions with compensation logic
+      - event-sourcing         # Track workflow state as event stream
+      - choreography           # Decentralized agent coordination via events
+      - orchestration          # Centralized workflow control and state
+      - circuit-breaker        # Prevent cascading failures via fault isolation
+
+  # ============================================================================
+  # PROTOCOLS: Communication methods for agent interaction
+  # ============================================================================
+  protocols:
+    supported:
+      # REST API: Synchronous request-response for workflow submission
+      - name: rest
+        version: '1.1'
+        endpoint: 'https://orchestrator.platform.com/api/v2'
+        authentication:
+          # OAuth2 for delegated authorization with scoped permissions
+          type: oauth2
+          scopes:
+            # orchestrator.execute: Submit and control workflows
+            # agents.coordinate: Discover and communicate with agents
+            # resources.manage: Allocate compute/memory/token budgets
+            ['orchestrator.execute', 'agents.coordinate', 'resources.manage']
+        # TLS 1.3 for encrypted transport
+        tls: true
+
+      # gRPC: High-performance RPC for agent-to-agent communication
+      - name: grpc
+        version: '1.0'
+        endpoint: 'grpc://orchestrator.platform.com:9443/WorkflowOrchestrator'
+        authentication:
+          # Mutual TLS for bidirectional authentication and encryption
+          type: mutual-tls
+
+      # Event Stream: Asynchronous updates for workflow state changes
+      - name: event-stream
+        version: '1.0'
+        endpoint: 'wss://events.platform.com/orchestrator'
+        authentication:
+          # JWT tokens for stateless WebSocket authentication
+          type: jwt
+
+  # ============================================================================
+  # COORDINATION: Multi-agent workflow management configuration
+  # ============================================================================
+  coordination:
+    # Maximum concurrent workflows this orchestrator can manage
+    # - Higher values increase throughput but require more memory
+    # - Should align with available resources and agent pool size
+    maxConcurrentWorkflows: 1000
+
+    # Maximum agents that can participate in a single workflow
+    # - Limits complexity and prevents resource exhaustion
+    # - Should consider coordination overhead (O(n²) for full mesh)
+    maxAgentsPerWorkflow: 50
+
+    # Maximum time (ms) a workflow can run before forced termination
+    # - Prevents runaway workflows from consuming resources
+    # - 3600000ms = 1 hour (should include all retries and compensation)
+    workflowTimeout: 3600000
+
+    # Retry policy for failed workflow steps
+    retryPolicy:
+      # Maximum retry attempts before marking step as failed
+      maxAttempts: 3
+
+      # Exponential backoff: delay = baseDelay * 2^(attempt - 1)
+      # - Attempt 1: 1000ms, Attempt 2: 2000ms, Attempt 3: 4000ms
+      # - Prevents thundering herd on transient failures
+      backoffStrategy: exponential
+      baseDelay: 1000
+
+    # Failure handling strategy for workflow execution
+    failureHandling:
+      # graceful-degradation: Continue workflow with partial results
+      # fail-fast: Immediately abort workflow on any failure
+      # best-effort: Try all steps even if some fail
+      strategy: graceful-degradation
+
+      # Enable fallback workflows when primary workflow fails
+      # - Provides alternative execution paths for critical workflows
+      # - Example: Use cached data if real-time API fails
+      fallbackWorkflows: true
+
+      # Enable compensation actions for saga pattern
+      # - Rollback completed steps when later steps fail
+      # - Example: Cancel payment if shipping address validation fails
+      compensationActions: true
+
+  # ============================================================================
+  # PERFORMANCE: Throughput, latency, and resource optimization
+  # ============================================================================
+  performance:
+    # Throughput targets for capacity planning
+    throughput:
+      # Target workflows processed per second (sustained load)
+      workflowsPerSecond: 50
+
+      # Maximum workflows executing simultaneously (burst capacity)
+      maxConcurrentExecutions: 500
+
+    # Latency targets for SLA monitoring
+    latency:
+      # Overhead added by orchestration layer (ms)
+      # - Includes workflow parsing, agent routing, result aggregation
+      orchestrationOverhead: 50
+
+      # Average latency for agent-to-agent coordination (ms)
+      # - Includes service discovery, health checks, message routing
+      coordinationLatency: 100
+
+      # 99th percentile end-to-end latency (ms)
+      # - Used for SLA enforcement and performance regression detection
+      p99: 2000
+
+  # ============================================================================
+  # MONITORING: Observability configuration for production operations
+  # ============================================================================
+  monitoring:
+    # Track workflow state transitions and execution history
+    # - Enables workflow replay and debugging
+    workflowTracking: true
+
+    # Periodic health checks for all managed agents
+    # - Automatically remove unhealthy agents from routing pool
+    agentHealthChecks: true
+
+    # Collect and expose performance metrics (Prometheus format)
+    # - Request rate, latency, error rate, resource utilization
+    performanceMetrics: true
+
+    # Alerting thresholds for operational issues
+    alerting:
+      # Trigger alert after N consecutive workflow failures
+      failureThreshold: 5
+
+      # Trigger alert when p99 latency exceeds threshold (ms)
+      latencyThreshold: 5000
+
+      # Trigger alert when resource utilization exceeds percentage
+      # - Applies to CPU, memory, token budget, agent pool
+      resourceThreshold: 90
+
+# ============================================================================
+# END OF MANIFEST
+# ============================================================================
+# Next Steps:
+# 1. Deploy using: kubectl apply -f orchestrator-agent.yaml
+# 2. Monitor via: /metrics endpoint (Prometheus format)
+# 3. Submit workflows via: POST /api/v2/workflows/execute
+# 4. View workflow status: GET /api/v2/workflows/{workflowId}
+#
+# Related Documentation:
+# - OSSA Spec: https://ossa.ai/spec
+# - Orchestration Patterns: https://microservices.io/patterns/data/saga.html
+# - Agent Coordination: https://ossa.ai/docs/orchestration
+# ============================================================================

package/examples/agent-manifests/sample-compliant-agent.yaml

@@ -0,0 +1,147 @@
+apiVersion: ossa.io/v0.1.9-alpha.1
+kind: Agent
+metadata:
+  name: financial-data-processor
+  version: v1.2.3
+  description: 'Enterprise-grade financial data processing agent with full OSSA Gold compliance'
+  author: 'enterprise-financial-corp'
+  labels:
+    environment: production
+    classification: confidential
+    industry: financial-services
+    compliance: gold-level
+spec:
+  type: worker
+  subtype: data-processor
+  capabilities:
+    domains:
+      - data-processing
+      - financial-analysis
+      - compliance-validation
+      - audit-trail-generation
+    operations:
+      - process-transactions
+      - validate-compliance
+      - generate-reports
+      - audit-logging
+    inputFormats:
+      - application/json
+      - text/csv
+      - application/xml
+    outputFormats:
+      - application/json
+      - application/pdf
+      - text/csv
+  protocols:
+    supported:
+      - name: rest
+        version: '1.1'
+        endpoint: 'https://api.enterprise.com/agents/financial-processor'
+        authentication:
+          type: oauth2
+          scopes: ['agent.execute', 'data.read', 'audit.write']
+        tls: true
+        timeout: 30000
+      - name: grpc
+        version: '1.0'
+        endpoint: 'grpc://secure.enterprise.com:9443/FinancialProcessor'
+        authentication:
+          type: mutual-tls
+        tls: true
+        timeout: 30000
+      - name: mcp
+        version: '0.1.0'
+        endpoint: 'mcp://internal.enterprise.com:8080/financial-processor'
+        authentication:
+          type: api-key
+        tls: true
+        timeout: 15000
+    preferred: rest
+  conformance:
+    level: gold
+    auditLogging: true
+    feedbackLoop: true
+    propsTokens: true
+    learningSignals: true
+    features:
+      - continuous-monitoring
+      - automated-compliance
+      - real-time-audit
+      - human-oversight-integration
+  performance:
+    throughput:
+      requestsPerSecond: 100
+      concurrentRequests: 50
+      batchSize: 1000
+    latency:
+      p50: 150
+      p95: 500
+      p99: 1000
+      timeout: 30000
+    reliability:
+      availability: 99.95
+      errorRate: 0.01
+      mttr: 300
+  budgets:
+    tokens:
+      default: 5000
+      maximum: 50000
+      emergency: 100000
+    cost:
+      hourly: 10.50
+      daily: 252.00
+      monthly: 7560.00
+    resources:
+      cpu: '2000m'
+      memory: '4Gi'
+      storage: '10Gi'
+  security:
+    encryption:
+      atRest: true
+      inTransit: true
+      algorithms: ['AES-256-GCM', 'RSA-4096']
+    access:
+      authentication: required
+      authorization: rbac
+      auditLevel: comprehensive
+    compliance:
+      frameworks:
+        - iso-42001
+        - nist-ai-rmf
+        - eu-ai-act
+        - pci-dss
+        - sox
+      certifications:
+        - iso-27001
+        - soc2-type2
+      dataProtection:
+        - gdpr
+        - ccpa
+        - pii-handling
+  monitoring:
+    healthCheck:
+      endpoint: '/health'
+      interval: 30
+      timeout: 5
+    metrics:
+      endpoint: '/metrics'
+      format: prometheus
+      retention: '7d'
+    logging:
+      level: info
+      format: structured
+      destination: enterprise-audit-log
+      retention: '2y'
+  governance:
+    approvals:
+      deployment: ['security-officer', 'compliance-manager']
+      updates: ['technical-lead', 'compliance-manager']
+      retirement: ['security-officer', 'data-officer', 'compliance-manager']
+    policies:
+      - financial-data-policy-v2.1
+      - enterprise-security-policy-v3.0
+      - ai-governance-policy-v1.5
+    documentation:
+      - https://docs.enterprise.com/agents/financial-processor
+      - https://compliance.enterprise.com/agent-certifications/fp-v1.2.3
+      - https://security.enterprise.com/risk-assessments/fp-2024-q1