@bluefly/openstandardagents 0.2.4

package/examples/enterprise/agent.yml

@@ -0,0 +1,452 @@
+# Enterprise OSSA Agent Example (400+ lines)
+# Platinum conformance level - Enterprise-grade with all features
+
+ossa: 1.0
+agent:
+  name: enterprise-ai-orchestrator
+  version: 3.5.0
+  description: Enterprise-grade AI orchestration platform with multi-model support
+  author: Enterprise AI Division
+  license: Commercial
+  conformance: platinum
+  tags:
+    - enterprise
+    - orchestration
+    - multi-model
+    - secure
+    - scalable
+
+discover:
+  auto: true
+  protocol: uadp
+  registry: https://registry.ossa.ai
+  endpoints:
+    - https://discovery.ossa.ai/agents
+    - https://enterprise.ossa.ai/discovery
+
+capabilities:
+  # Core AI Capabilities
+  - text_generation
+  - text_analysis
+  - code_generation
+  - code_review
+  - image_generation
+  - image_analysis
+  - speech_to_text
+  - text_to_speech
+  - translation
+  - summarization
+  # Orchestration Capabilities
+  - workflow_orchestration
+  - agent_coordination
+  - task_distribution
+  - load_balancing
+  # Enterprise Features
+  - audit_logging
+  - compliance_checking
+  - data_governance
+  - security_scanning
+
+api:
+  POST /orchestrate:
+    capability: workflow_orchestration
+    description: Orchestrate complex AI workflows
+
+  POST /generate/text:
+    capability: text_generation
+    description: Generate text using multiple models
+
+  POST /generate/code:
+    capability: code_generation
+    description: Generate code with review
+
+  POST /analyze/document:
+    capability: text_analysis
+    description: Deep document analysis
+
+  POST /analyze/image:
+    capability: image_analysis
+    description: Computer vision analysis
+
+  POST /coordinate:
+    capability: agent_coordination
+    description: Coordinate multiple agents
+
+  GET /health:
+    description: Comprehensive health status
+
+  GET /metrics:
+    description: Detailed Prometheus metrics
+
+  GET /ready:
+    description: Readiness probe
+
+  GET /live:
+    description: Liveness probe
+
+monitoring:
+  io_aware: true
+
+  logs:
+    format: jsonl
+    level: info
+    trace: true
+    retention: 90d
+    outputs:
+      - type: elasticsearch
+        config:
+          url: https://logs.enterprise.com
+      - type: file
+        config:
+          path: /var/log/ossa/orchestrator.log
+          rotation: hourly
+          max_files: 168
+    sampling:
+      enabled: true
+      rate: 1.0
+      rules:
+        - level: debug
+          rate: 0.1
+        - level: error
+          rate: 1.0
+
+  metrics:
+    enabled: true
+    endpoint: /metrics
+    format: prometheus
+    interval: 30
+    exporters:
+      - type: prometheus
+        endpoint: http://prometheus:9090
+      - type: datadog
+        endpoint: https://api.datadoghq.com
+      - type: cloudwatch
+        config:
+          region: us-east-1
+    custom_metrics:
+      - name: workflow_executions_total
+        type: counter
+        labels: [workflow_type, status, tenant]
+      - name: model_latency_seconds
+        type: histogram
+        labels: [model, operation]
+        buckets: [0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10]
+      - name: active_agents
+        type: gauge
+        labels: [agent_type]
+      - name: token_usage_total
+        type: counter
+        labels: [model, tenant, operation]
+
+  traces:
+    enabled: true
+    format: otlp
+    endpoint: https://traces.enterprise.com:4317
+    sampling:
+      type: adaptive
+      rate: 0.1
+      max_per_second: 1000
+    propagation: [tracecontext, baggage, b3]
+    io_capture:
+      enabled: true
+      max_input_size: 10MB
+      max_output_size: 10MB
+      truncate: true
+
+  health:
+    enabled: true
+    endpoint: /health
+    interval: 15
+    checks:
+      - name: postgres_primary
+        type: tcp
+        config:
+          port: 5432
+          timeout: 5
+        critical: true
+      - name: redis_cache
+        type: tcp
+        config:
+          port: 6379
+          timeout: 5
+      - name: elasticsearch
+        type: http
+        config:
+          url: http://elasticsearch:9200/_cluster/health
+          timeout: 10
+      - name: model_servers
+        type: grpc
+        config:
+          port: 50051
+          timeout: 5
+        critical: true
+
+  alerts:
+    enabled: true
+    channels:
+      - name: pagerduty
+        type: pagerduty
+        config:
+          integration_key: "${PAGERDUTY_KEY}"
+      - name: slack
+        type: slack
+        config:
+          webhook_url: "${SLACK_WEBHOOK}"
+      - name: email
+        type: email
+        config:
+          smtp_host: smtp.enterprise.com
+          from: alerts@enterprise.com
+    rules:
+      - name: high_error_rate
+        condition: "error_rate > 0.05"
+        severity: critical
+        channels: [pagerduty, slack]
+      - name: high_latency
+        condition: "p95_latency > 5s"
+        severity: high
+        channels: [slack]
+        throttle: 300
+
+  redaction:
+    enabled: true
+    patterns:
+      - pattern: "\\b[A-Z]{2}\\d{2}\\s?\\d{4}\\s?\\d{4}\\s?\\d{4}\\s?\\d{4}\\b"
+        name: credit_card
+        replacement: "[CC-REDACTED]"
+      - pattern: "\\b\\d{3}-\\d{2}-\\d{4}\\b"
+        name: ssn
+        replacement: "[SSN-REDACTED]"
+      - pattern: "\\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Z|a-z]{2,}\\b"
+        name: email
+        replacement: "[EMAIL-REDACTED]"
+      - pattern: "Bearer\\s+[A-Za-z0-9\\-._~\\+/]+={0,2}"
+        name: bearer_token
+        replacement: "[TOKEN-REDACTED]"
+
+  retention:
+    logs:
+      duration: 90d
+      archive:
+        enabled: true
+        location: s3://enterprise-logs-archive
+        after: 30d
+    metrics:
+      duration: 365d
+      archive:
+        enabled: true
+        location: s3://enterprise-metrics-archive
+        after: 90d
+    traces:
+      duration: 30d
+
+performance:
+  token_optimization:
+    enabled: true
+    strategies:
+      - type: flash_attention
+        config:
+          block_size: 512
+      - type: paged_kv
+        config:
+          page_size: 4096
+      - type: grouped_query
+        config:
+          num_groups: 8
+    max_context: 128000
+    compression:
+      enabled: true
+      method: zstd
+      level: 3
+
+  cache:
+    enabled: true
+    layers:
+      - name: l1_memory
+        type: memory
+        size: 1GB
+        ttl: 60
+      - name: l2_redis
+        type: redis
+        ttl: 3600
+        config:
+          host: redis-primary
+          port: 6379
+          password: "${REDIS_PASSWORD}"
+      - name: l3_disk
+        type: disk
+        size: 100GB
+        config:
+          path: /var/cache/ossa
+    key_strategy: hybrid
+    eviction:
+      policy: lru
+      max_entries: 100000
+
+  quantization:
+    enabled: true
+    method: awq
+    target_bits: 4
+    calibration:
+      dataset: enterprise-calibration-v2
+      samples: 512
+      method: percentile
+
+  batching:
+    enabled: true
+    dynamic: true
+    max_batch_size: 128
+    timeout_ms: 50
+    padding: bucket
+    buckets: [128, 256, 512, 1024, 2048, 4096]
+
+  resources:
+    limits:
+      cpu: "16"
+      memory: 64Gi
+      disk: 500Gi
+    requests:
+      cpu: "8"
+      memory: 32Gi
+    gpu:
+      required: true
+      type: nvidia
+      model: A100
+      count: 4
+      memory: 80GB
+      compute_capability: "8.0"
+    network:
+      bandwidth: 10Gbps
+      timeout: 60000
+      retry:
+        enabled: true
+        max_attempts: 5
+        backoff: exponential
+        initial_delay: 1000
+        max_delay: 30000
+
+  scaling:
+    enabled: true
+    type: both
+    horizontal:
+      min_replicas: 3
+      max_replicas: 100
+      target_cpu: 70
+      target_memory: 80
+      metrics:
+        - name: requests_per_second
+          target: 1000
+          type: average
+        - name: pending_workflows
+          target: 100
+          type: average
+    vertical:
+      enabled: true
+      update_mode: auto
+      cpu:
+        min: "4"
+        max: "32"
+      memory:
+        min: 16Gi
+        max: 128Gi
+
+  optimization:
+    compiler:
+      enabled: true
+      backend: tensorrt
+      mode: max_performance
+    runtime:
+      torch_dynamo: true
+      cuda_graphs: true
+      amp:
+        enabled: true
+        dtype: float16
+      fusion: true
+    model:
+      pruning:
+        enabled: true
+        sparsity: 0.5
+      distillation:
+        enabled: false
+
+bridge:
+  mcp:
+    enabled: true
+    server_type: websocket
+    tools:
+      - name: orchestrateWorkflow
+        description: Orchestrate AI workflow
+        capability: workflow_orchestration
+      - name: coordinateAgents
+        description: Coordinate multiple agents
+        capability: agent_coordination
+    resources:
+      - uri: ossa://workflows
+        name: Available Workflows
+        mimeType: application/json
+    config:
+      max_message_size: 10485760
+      timeout_ms: 30000
+      retry_count: 3
+
+  a2a:
+    enabled: true
+    card_url: https://enterprise.ai/agents/orchestrator.json
+    schema_version: "1.0"
+    capabilities_mapping:
+      workflow_orchestration: orchestrate
+      agent_coordination: coordinate
+
+  openapi:
+    enabled: true
+    spec_url: ./openapi.yaml
+    spec_version: "3.1"
+    servers:
+      - url: https://api.enterprise.ai
+        description: Production API
+      - url: https://staging.enterprise.ai
+        description: Staging API
+
+  langchain:
+    enabled: true
+    tool_class: EnterpriseOrchestrator
+    chain_type: agent
+    memory:
+      type: vector
+      max_tokens: 128000
+    callbacks:
+      - EnterpriseLogger
+      - ComplianceAuditor
+    export:
+      as_tool: true
+      as_chain: true
+      as_agent: true
+
+  crewai:
+    enabled: true
+    agent_type: manager
+    role: Enterprise AI Orchestrator
+    goal: Efficiently orchestrate complex AI workflows
+    backstory: Advanced orchestration system managing enterprise AI operations
+    max_iter: 50
+    allow_delegation: true
+
+  autogen:
+    enabled: true
+    agent_type: assistant
+    system_message: Enterprise AI orchestration and coordination
+    human_input_mode: NEVER
+    code_execution:
+      enabled: true
+      work_dir: /tmp/autogen
+      use_docker: true
+    max_consecutive_auto_reply: 25
+
+  custom:
+    drupal:
+      enabled: true
+      modules: [mcp, experience_builder, eca]
+      api_version: "11.x"
+    gitlab:
+      enabled: true
+      ci_component: app-4001.cloud.bluefly.io/llm/golden@v0.1.0

package/examples/extensions/drupal-v1.yml

@@ -0,0 +1,266 @@
+# OSSA Drupal Extension Schema
+# Extension specification for Drupal LLM Platform deployment
+# Compatible with Drupal 10+ and llm-platform modules
+
+apiVersion: ossa/v1
+kind: ExtensionSchema
+metadata:
+  name: drupal-extension
+  version: v1
+  namespace: ossa/extensions
+  
+spec:
+  platform: drupal
+  compatibleWith:
+    - "drupal/11"
+    - "drupal/10"
+  
+  description: "Extension schema for Drupal LLM Platform agent deployment and orchestration"
+
+  additionalFields:
+    module:
+      type: string
+      required: true
+      pattern: "^[a-z][a-z0-9_]*$"
+      description: "Drupal module that owns this agent"
+      examples:
+        - "ai_agents"
+        - "ai_agent_orchestra"
+        - "ai_agent_marketplace"
+
+    service:
+      type: string
+      required: true
+      pattern: "^[a-z][a-z0-9_]*\\.[a-z][a-z0-9_]*$"
+      description: "Drupal service ID for agent execution (module.service format)"
+      examples:
+        - "ai_agents.executor"
+        - "ai_agent_orchestra.gitlab_ml_recommendations"
+        - "ai_agent_marketplace.discovery"
+
+    dependencies:
+      type: array
+      items:
+        type: string
+        pattern: "^[a-z][a-z0-9_]*$"
+      description: "Required Drupal modules (must be installed)"
+      examples:
+        - ["ai_agents", "ai_provider_langchain", "ai_provider_openai"]
+
+    database:
+      type: object
+      properties:
+        tables:
+          type: array
+          items:
+            type: string
+          description: "Required database tables (without prefix)"
+          examples:
+            - ["gitlab_ml_metrics", "gitlab_ml_alerts"]
+        migrations:
+          type: array
+          items:
+            type: string
+          description: "Required migration IDs"
+        schema_version:
+          type: string
+          description: "Database schema version"
+
+    rag_pipeline:
+      type: object
+      description: "RAG (Retrieval-Augmented Generation) pipeline configuration"
+      properties:
+        vector_db:
+          type: string
+          enum: ["qdrant", "weaviate", "pinecone"]
+          default: "qdrant"
+          description: "Vector database for semantic search"
+        collection:
+          type: string
+          description: "Vector collection name"
+        embedding_model:
+          type: string
+          default: "text-embedding-ada-002"
+          description: "Embedding model for vector generation"
+        similarity_limit:
+          type: integer
+          default: 5
+          minimum: 1
+          maximum: 100
+          description: "Number of similar documents to retrieve"
+        similarity_threshold:
+          type: number
+          default: 0.7
+          minimum: 0
+          maximum: 1
+          description: "Minimum similarity score (0-1)"
+        llm_service:
+          type: string
+          format: uri
+          description: "LLM service endpoint for generation"
+          examples:
+            - "http://agent-router:4000"
+            - "http://localhost:3007"
+
+    monitoring:
+      type: object
+      description: "Observability and monitoring configuration"
+      properties:
+        metrics:
+          type: boolean
+          default: true
+          description: "Enable Prometheus metrics"
+        tracing:
+          type: boolean
+          default: true
+          description: "Enable OpenTelemetry tracing"
+        logging:
+          type: boolean
+          default: true
+          description: "Enable structured logging"
+        opentelemetry:
+          type: object
+          properties:
+            endpoint:
+              type: string
+              format: uri
+              description: "OpenTelemetry collector endpoint"
+              examples:
+                - "http://agent-tracer:4318"
+            service_name:
+              type: string
+              description: "Service name for tracing"
+            headers:
+              type: object
+              additionalProperties:
+                type: string
+              description: "Additional headers for OTLP export"
+
+    caching:
+      type: object
+      description: "Drupal caching configuration for agent results"
+      properties:
+        enabled:
+          type: boolean
+          default: true
+        backend:
+          type: string
+          enum: ["redis", "database", "memory"]
+          default: "redis"
+        ttl:
+          type: integer
+          description: "Cache TTL in seconds"
+          default: 3600
+        tags:
+          type: array
+          items:
+            type: string
+          description: "Cache tags for invalidation"
+
+    permissions:
+      type: array
+      items:
+        type: string
+      description: "Required Drupal permissions"
+      examples:
+        - ["administer ai agents", "execute ai agents"]
+
+    a2a_config:
+      type: object
+      description: "Agent-to-Agent communication configuration"
+      properties:
+        enabled:
+          type: boolean
+          default: false
+        protocol:
+          type: string
+          enum: ["json-rpc", "http", "sse"]
+          default: "json-rpc"
+        endpoints:
+          type: array
+          items:
+            type: string
+            format: uri
+        authentication:
+          type: object
+          properties:
+            type:
+              type: string
+              enum: ["bearer", "oauth2", "mtls"]
+            secretRef:
+              type: object
+              properties:
+                name:
+                  type: string
+                key:
+                  type: string
+
+    event_bus:
+      type: object
+      description: "Event bus integration for pub/sub"
+      properties:
+        enabled:
+          type: boolean
+          default: false
+        topics:
+          type: array
+          items:
+            type: string
+          description: "Event topics to subscribe/publish"
+        redis:
+          type: object
+          properties:
+            host:
+              type: string
+              format: uri
+            db:
+              type: integer
+              default: 0
+
+  validation:
+    required:
+      - module
+      - service
+    
+    customRules:
+      - name: "validate-drupal-service-format"
+        rule: "Service ID must follow module.service naming convention"
+        
+      - name: "validate-module-exists"
+        rule: "Module specified must be installed in Drupal"
+        
+      - name: "validate-dependencies"
+        rule: "All dependencies must be installed Drupal modules"
+        
+      - name: "validate-rag-pipeline"
+        rule: "If rag_pipeline specified, vector_db and collection are required"
+        
+      - name: "validate-monitoring-endpoint"
+        rule: "If monitoring.tracing is true, opentelemetry.endpoint must be provided"
+
+  examples:
+    - name: "GitLab ML Recommendation Agent"
+      description: "RAG-powered customer success agent"
+      manifest:
+        drupal:
+          module: "ai_agent_orchestra"
+          service: "ai_agent_orchestra.gitlab_ml_recommendations"
+          dependencies:
+            - "ai_agents"
+            - "ai_provider_langchain"
+          rag_pipeline:
+            vector_db: "qdrant"
+            collection: "gitlab_customer_embeddings"
+            similarity_limit: 5
+            llm_service: "http://agent-router:4000"
+          monitoring:
+            metrics: true
+            tracing: true
+            opentelemetry:
+              endpoint: "http://agent-tracer:4318"
+
+  migration:
+    fromVersion: "none"
+    toVersion: "v1"
+    breakingChanges: []
+    migrationGuide: "https://ossa.dev/docs/drupal/migration"