@bluefly/openstandardagents 0.3.0 → 0.3.1

package/spec/v0.3.1/agent-test.schema.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.3.1/agent-test.json",
+  "title": "OSSA AgentTest Resource",
+  "description": "Test definition for OSSA agents - declarative testing framework for agent behavior, performance, and compliance validation",
+  "type": "object",
+  "required": [
+    "apiVersion",
+    "kind",
+    "metadata",
+    "spec"
+  ],
+  "properties": {
+    "apiVersion": {
+      "type": "string",
+      "const": "ossa/v0.3.1",
+      "description": "OSSA API version for AgentTest resources"
+    },
+    "kind": {
+      "type": "string",
+      "const": "AgentTest",
+      "description": "Resource type identifier"
+    },
+    "metadata": {
+      "$ref": "#/definitions/Metadata",
+      "description": "Test resource metadata including name, version, and labels"
+    },
+    "spec": {
+      "$ref": "#/definitions/TestSpec",
+      "description": "Test specification including target, scenarios, and configuration"
+    }
+  },
+  "definitions": {
+    "Metadata": {
+      "type": "object",
+      "required": [
+        "name"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z0-9]([-a-z0-9]*[a-z0-9])?$",
+          "maxLength": 253,
+          "description": "Test suite identifier (DNS-1123 subdomain format)"
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^(0|[1-9]\\\\d*)\\\\.(0|[1-9]\\\\d*)\\\\.(0|[1-9]\\\\d*)(?:-((?:0|[1-9]\\\\d*|\\\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\\\.(?:0|[1-9]\\\\d*|\\\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\\\+([0-9a-zA-Z-]+(?:\\\\.[0-9a-zA-Z-]+)*))?$",
+          "description": "Test suite version (semver 2.0.0)"
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 2000,
+          "description": "Human-readable test suite description"
+        },
+        "labels": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string",
+            "maxLength": 63
+          },
+          "description": "Labels for test categorization (e.g., team, compliance-level, test-type)"
+        },
+        "annotations": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Arbitrary metadata for tooling integration"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

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

@@ -0,0 +1,110 @@
+apiVersion: ossa/v0.3.1
+kind: Agent
+metadata:
+  name: drupal-content-writer
+  version: 1.0.0
+  description: Autonomous content generation agent for Drupal with background processing
+
+spec:
+  capabilities:
+    - name: content.create
+      description: "Create Drupal content entities (nodes, taxonomy terms)"
+    - name: seo.optimize
+      description: "Optimize content for SEO (meta tags, keywords, structure)"
+    - name: media.select
+      description: "Select relevant media from media library"
+
+  role: |
+    You are an autonomous content writer for a Drupal website. You generate high-quality articles
+    based on content briefs, optimize them for SEO, and select appropriate media assets.
+
+    Process:
+    1. Analyze content brief and target audience
+    2. Research topic using available tools
+    3. Generate article with proper structure (H1, H2, paragraphs)
+    4. Optimize for SEO (meta description, keywords, readability)
+    5. Select relevant images from media library
+    6. Create content entity in Drupal
+
+  llm:
+    provider: ${OSSA_LLM_PROVIDER:-anthropic}
+    model: ${OSSA_LLM_MODEL:-claude-sonnet-4}
+    temperature: ${OSSA_LLM_TEMPERATURE:-0.7}
+    maxTokens: ${OSSA_LLM_MAX_TOKENS:-8192}
+
+  tools:
+    - name: drupal.node.create
+      description: "Create a new Drupal node (article, page, etc.)"
+      handler:
+        runtime: drupal
+        capability: node.create
+
+    - name: drupal.taxonomy.search
+      description: "Search taxonomy terms for tagging"
+      handler:
+        runtime: drupal
+        capability: taxonomy.search
+
+    - name: drupal.media.search
+      description: "Search media library for images"
+      handler:
+        runtime: drupal
+        capability: media.search
+
+extensions:
+  drupal:
+    # Module providing this agent
+    module: ai_agents_ossa
+
+    # Store as exportable config entity
+    config_entity: true
+
+    # Permissions for autonomous execution
+    permissions:
+      # Core Drupal entity permissions
+      entity_permissions:
+        - "create article content"
+        - "create page content"
+        - "edit own article content"
+        - "view media"
+        - "view taxonomy term"
+
+      # Custom permissions for agent execution
+      custom_permissions:
+        - "execute content writer agent"
+        - "generate ai content"
+
+      # Run as admin service account for autonomous operation
+      execution_user: "1"
+
+      # Agent runs with its own permissions (no user context)
+      permission_mode: agent_only
+
+    # Async processing via Symfony Messenger
+    messenger:
+      # Use Redis for high-performance message queue
+      transport: redis
+
+      # Dedicated queue for content generation
+      queue: content_generation
+
+      # Retry strategy for failed executions
+      retry_strategy:
+        max_retries: 3
+        delay: 2000
+        multiplier: 2
+        max_delay: 30000
+
+    # ECA workflow integration
+    workflow_engine: eca
+
+    # Discovery paths for manifest loading
+    discovery_paths:
+      - "config/agents/*.ossa.yaml"
+      - "modules/custom/ai_agents_ossa/agents/*.ossa.yaml"
+
+    # Drupal hooks for integration
+    hooks:
+      before_execute: ai_agents_ossa_content_writer_before
+      after_execute: ai_agents_ossa_content_writer_after
+      on_error: ai_agents_ossa_content_writer_error

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

@@ -0,0 +1,96 @@
+apiVersion: ossa/v0.3.1
+kind: Agent
+metadata:
+  name: drupal-moderation-assistant
+  version: 1.0.0
+  description: Content moderation assistant that helps users review and publish content
+
+spec:
+  capabilities:
+    - name: content.review
+      description: "Review content for quality, SEO, and compliance"
+    - name: moderation.suggest
+      description: "Suggest moderation workflow transitions"
+    - name: quality.score
+      description: "Score content quality based on criteria"
+
+  role: |
+    You are a content moderation assistant helping editors review and publish content.
+    You work within the user's permission context and respect Drupal's editorial workflow.
+
+    Responsibilities:
+    1. Review content for quality, readability, and SEO
+    2. Check content against style guide and compliance rules
+    3. Suggest appropriate moderation state transitions
+    4. Provide actionable feedback for improvement
+
+    You can only suggest transitions the user is authorized to perform.
+
+  llm:
+    provider: ${OSSA_LLM_PROVIDER:-anthropic}
+    model: ${OSSA_LLM_MODEL:-claude-sonnet-4}
+    temperature: ${OSSA_LLM_TEMPERATURE:-0.3}
+    maxTokens: ${OSSA_LLM_MAX_TOKENS:-4096}
+
+  tools:
+    - name: drupal.node.load
+      description: "Load a Drupal node for review"
+      handler:
+        runtime: drupal
+        capability: node.load
+
+    - name: drupal.moderation.transitions
+      description: "Get available moderation transitions for user"
+      handler:
+        runtime: drupal
+        capability: moderation.get_transitions
+
+    - name: drupal.moderation.apply
+      description: "Apply moderation state transition"
+      handler:
+        runtime: drupal
+        capability: moderation.apply_transition
+
+extensions:
+  drupal:
+    # Module providing this agent
+    module: ai_agents_ossa
+
+    # Store as config entity for export
+    config_entity: true
+
+    # Permissions for user-context execution
+    permissions:
+      # Required entity permissions
+      entity_permissions:
+        - "view any article content"
+        - "edit any article content"
+        - "use editorial transition review"
+        - "use editorial transition publish"
+
+      # Custom agent permission
+      custom_permissions:
+        - "use moderation assistant"
+
+      # Run in user context (no service account)
+      # execution_user not specified - uses current user
+
+      # User must have ALL required permissions (intersection)
+      permission_mode: least_permissive
+
+    # Synchronous execution (no queue)
+    messenger:
+      transport: sync
+
+    # Integrated with ECA workflow builder
+    workflow_engine: eca
+
+    # Discovery from module
+    discovery_paths:
+      - "modules/custom/ai_agents_ossa/agents/*.ossa.yaml"
+
+    # Hooks for tracking and logging
+    hooks:
+      before_execute: ai_agents_ossa_log_execution
+      after_execute: ai_agents_ossa_track_moderation
+      on_error: ai_agents_ossa_alert_admin

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

@@ -0,0 +1,144 @@
+apiVersion: ossa/v0.3.1
+kind: Agent
+metadata:
+  name: example-agent-quick-wins
+  namespace: production
+  labels:
+    app: example
+    version: v1.0.0
+spec:
+  role: "Example agent demonstrating all quick-win capabilities"
+  
+  # 1. Health Monitoring Configuration
+  health:
+    enabled: true
+    endpoints:
+      health: /health
+      ready: /ready
+      live: /live
+    interval_seconds: 30
+    timeout_seconds: 5
+    restart_policy:
+      enabled: true
+      max_restarts: 3
+      restart_delay_seconds: 10
+  
+  # 2. Secrets Management
+  secrets:
+    provider: gitlab_vault
+    injection:
+      method: env_vars
+      prefix: AGENT_SECRET_
+    rotation:
+      enabled: true
+      interval_days: 90
+      auto_rotate: false
+    encryption:
+      enabled: true
+      algorithm: aes-256-gcm
+    audit:
+      enabled: true
+      log_access: true
+  
+  # 3. LLM Configuration with Circuit Breaker (via retry)
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4
+    profile: balanced
+    retry:
+      max_attempts: 3
+      backoff:
+        strategy: exponential
+        initial_delay_ms: 1000
+        max_delay_ms: 30000
+      circuit_breaker:
+        enabled: true
+        failure_threshold: 5
+        timeout_ms: 60000
+        half_open_max_calls: 3
+        success_threshold: 2
+  
+  # 4. Error Handling with Aggregation
+  error_handling:
+    strategy: fail_fast
+    aggregation:
+      enabled: true
+      window_seconds: 300
+      threshold: 10
+      alert_channels:
+        - slack
+        - pagerduty
+      categorization:
+        enabled: true
+        categories:
+          - timeout
+          - rate_limit
+          - validation
+  
+  # 5. State Management with Versioning & Conflict Resolution
+  state:
+    mode: long_running
+    storage:
+      type: kv
+      config:
+        provider: redis
+        endpoint: redis://localhost:6379
+    versioning:
+      enabled: true
+      strategy: optimistic_locking
+    conflict_resolution:
+      strategy: merge_on_conflict
+      merge_on_conflict: true
+    persistence:
+      enabled: true
+      backup_interval_seconds: 300
+      restore_on_startup: true
+  
+  # 6. Security Boundaries
+  safety:
+    content_filtering:
+      enabled: true
+    security_boundaries:
+      network_policies:
+        enabled: true
+        allowed_agents:
+          - agent-a
+          - agent-b
+      rbac:
+        enabled: true
+        roles:
+          - reader
+          - writer
+      mtls:
+        enabled: true
+        ca_cert: env:CA_CERT
+      audit_logging:
+        enabled: true
+        retention_days: 90
+  
+  # 7. Rollback Configuration
+  rollback:
+    triggers:
+      - health_check_failure
+      - error_rate_threshold
+      - cost_exceeded
+    automation:
+      enabled: true
+      approval_required: false
+      notification_channels:
+        - slack
+        - email
+  
+  # 8. Testing Configuration (Optional)
+  testing:
+    framework: jest
+    mock_llm:
+      enabled: true
+      provider: local_mock
+      responses_file: tests/fixtures/mock-llm-responses.json
+    coverage:
+      threshold: 80
+      enforce: true
+    test_data:
+      management: fixtures
+      fixtures_path: tests/fixtures/