@bluefly/openstandardagents 0.3.1 → 0.3.3

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

@@ -0,0 +1,131 @@
+apiVersion: ossa/v0.3.3
+kind: Agent
+metadata:
+  name: example-agent-quick-wins
+  namespace: production
+  labels:
+    app: example
+    version: v1.0.0
+  annotations:
+    ossa.io/migration: v0.3.3-to-v0.3.3
+    ossa.io/migrated-date: 2026-01-07
+spec:
+  role: Example agent demonstrating all quick-win capabilities
+  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
+  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
+  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
+  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
+  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
+  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
+  rollback:
+    triggers:
+      - health_check_failure
+      - error_rate_threshold
+      - cost_exceeded
+    automation:
+      enabled: true
+      approval_required: false
+      notification_channels:
+        - slack
+        - email
+  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/

package/spec/v0.3.2/examples/tasks/data-transform.ossa.yaml

@@ -0,0 +1,137 @@
+apiVersion: ossa/v0.3.3
+kind: Task
+metadata:
+  name: transform-csv-to-json
+  version: 1.0.0
+  labels:
+    domain: data-engineering
+    tier: tier_1_read
+  annotations:
+    ossa.io/description: Transform CSV data to structured JSON
+    ossa.io/category: data-transformation
+    ossa.io/idempotent: "true"
+    ossa.io/migration: v0.3.3-to-v0.3.3
+    ossa.io/migrated-date: 2026-01-07
+spec:
+  execution:
+    type: idempotent
+    runtime: any
+    entrypoint: transform
+    timeout_seconds: 300
+  capabilities:
+    - read_file
+    - parse_csv
+    - write_json
+    - validate_schema
+  input:
+    type: object
+    required:
+      - source_path
+      - target_path
+      - schema
+    properties:
+      source_path:
+        type: string
+        description: Path to source CSV file
+      target_path:
+        type: string
+        description: Path to output JSON file
+      schema:
+        type: object
+        description: JSON Schema for validation
+        properties:
+          columns:
+            type: array
+            items:
+              type: object
+              properties:
+                name:
+                  type: string
+                type:
+                  type: string
+                  enum:
+                    - string
+                    - integer
+                    - number
+                    - boolean
+                    - date
+                required:
+                  type: boolean
+      options:
+        type: object
+        properties:
+          delimiter:
+            type: string
+            default: ","
+          skip_header:
+            type: boolean
+            default: true
+          null_value:
+            type: string
+            default: ""
+          batch_size:
+            type: integer
+            default: 1000
+  output:
+    type: object
+    required:
+      - success
+      - records_processed
+    properties:
+      success:
+        type: boolean
+      records_processed:
+        type: integer
+        minimum: 0
+      records_failed:
+        type: integer
+        minimum: 0
+      output_path:
+        type: string
+      checksum:
+        type: string
+        description: SHA256 of output file
+      processing_time_ms:
+        type: integer
+  batch:
+    enabled: true
+    parallelism: 10
+    retry: 3
+    backoff_seconds: 5
+  error_handling:
+    on_failure: continue
+    retryable_errors:
+      - IO_ERROR
+      - MEMORY_LIMIT
+    fatal_errors:
+      - SCHEMA_MISMATCH
+      - INVALID_FORMAT
+runtime:
+  python:
+    read_file:
+      module: pathlib
+      class: Path
+      method: read_text
+    parse_csv:
+      module: csv
+      function: DictReader
+    write_json:
+      module: json
+      function: dump
+    validate_schema:
+      module: jsonschema
+      function: validate
+  node:
+    read_file:
+      module: fs/promises
+      function: readFile
+    parse_csv:
+      module: csv-parse
+      function: parse
+    write_json:
+      module: fs/promises
+      function: writeFile
+    validate_schema:
+      module: ajv
+      class: Ajv
+      method: validate

package/spec/v0.3.2/examples/tasks/publish-content.ossa.yaml

@@ -0,0 +1,103 @@
+apiVersion: ossa/v0.3.3
+kind: Task
+metadata:
+  name: publish-content
+  version: 1.0.0
+  labels:
+    domain: content-management
+    tier: tier_2_write_limited
+  annotations:
+    ossa.io/description: Publish content to production with validation
+    ossa.io/category: content
+    ossa.io/compliance: SOC2
+    ossa.io/migration: v0.3.3-to-v0.3.3
+    ossa.io/migrated-date: 2026-01-07
+spec:
+  execution:
+    type: transactional
+    runtime: drupal
+    entrypoint: Drupal\ossa_content\Task\PublishContentTask::execute
+    timeout_seconds: 60
+  capabilities:
+    - publish_content
+    - invalidate_cache
+    - send_notification
+  input:
+    type: object
+    required:
+      - content_id
+      - content_type
+    properties:
+      content_id:
+        type: string
+        pattern: ^[a-zA-Z0-9_-]+$
+        description: Unique content identifier
+      content_type:
+        type: string
+        enum:
+          - article
+          - page
+          - product
+          - announcement
+      notify_subscribers:
+        type: boolean
+        default: true
+      schedule_at:
+        type: string
+        format: date-time
+        description: Optional scheduled publish time
+  output:
+    type: object
+    required:
+      - success
+      - published_url
+    properties:
+      success:
+        type: boolean
+      published_url:
+        type: string
+        format: uri
+      published_at:
+        type: string
+        format: date-time
+      cache_invalidated:
+        type: boolean
+      notifications_sent:
+        type: integer
+        minimum: 0
+  batch:
+    enabled: true
+    parallelism: 5
+    retry: 3
+    backoff_seconds: 10
+  error_handling:
+    on_failure: rollback
+    retryable_errors:
+      - NETWORK_TIMEOUT
+      - DATABASE_LOCK
+      - CACHE_UNAVAILABLE
+    fatal_errors:
+      - CONTENT_NOT_FOUND
+      - VALIDATION_ERROR
+      - PERMISSION_DENIED
+runtime:
+  drupal:
+    publish_content:
+      service: "@content_moderation.moderation_information"
+      method: transitionContent
+    invalidate_cache:
+      service: "@cache.render"
+      method: invalidateAll
+    send_notification:
+      service: "@ossa_notifications.subscriber_notifier"
+      method: notifySubscribers
+  symfony:
+    publish_content:
+      service: App\Service\ContentPublisher
+      method: publish
+    invalidate_cache:
+      service: symfony.cache.adapter.redis
+      method: clear
+    send_notification:
+      service: App\Notification\SubscriberNotifier
+      method: send

package/spec/v0.3.2/examples/workflows/content-publishing.ossa.yaml

@@ -0,0 +1,173 @@
+apiVersion: ossa/v0.3.3
+kind: Workflow
+metadata:
+  name: content-publishing-pipeline
+  version: 1.0.0
+  labels:
+    domain: content-management
+    tier: tier_3_write_elevated
+  annotations:
+    ossa.io/description: End-to-end content publishing with review and approval
+    ossa.io/category: publishing
+    ossa.io/compliance: SOC2,GDPR
+    ossa.io/migration: v0.3.3-to-v0.3.3
+    ossa.io/migrated-date: 2026-01-07
+spec:
+  triggers:
+    - type: webhook
+      endpoint: /api/v1/publish
+      methods:
+        - POST
+      authentication:
+        type: bearer
+        scope: publish:content
+    - type: schedule
+      cron: 0 9 * * 1-5
+      timezone: America/New_York
+    - type: event
+      source: cms
+      event_type: content.ready_for_publish
+  inputs:
+    type: object
+    required:
+      - content_id
+    properties:
+      content_id:
+        type: string
+      priority:
+        type: string
+        enum:
+          - low
+          - normal
+          - high
+          - critical
+        default: normal
+      skip_review:
+        type: boolean
+        default: false
+      notify_channels:
+        type: array
+        items:
+          type: string
+          enum:
+            - email
+            - slack
+            - teams
+            - webhook
+        default:
+          - email
+  outputs:
+    type: object
+    properties:
+      published_url:
+        type: string
+        format: uri
+      review_comments:
+        type: array
+        items:
+          type: string
+      notifications_sent:
+        type: integer
+      total_duration_ms:
+        type: integer
+  steps:
+    - id: validate
+      name: Validate Content
+      ref: tasks/validate-content
+      kind: Task
+      input:
+        content_id: ${{ inputs.content_id }}
+        strict: true
+      on_failure: halt
+    - id: review
+      name: AI Content Review
+      ref: agents/content-reviewer
+      kind: Agent
+      condition: ${{ !inputs.skip_review }}
+      input:
+        content: ${{ steps.validate.output.content }}
+        guidelines: brand-voice,accessibility,seo
+      timeout_seconds: 120
+      on_failure: continue
+      output_mapping:
+        review_score: ${{ output.score }}
+        suggestions: ${{ output.suggestions }}
+    - id: approval
+      name: Human Approval
+      type: approval
+      condition: ${{ steps.review.output.review_score < 0.8 }}
+      approvers:
+        - role: content-manager
+        - role: editor-in-chief
+      require: 1
+      timeout_hours: 24
+      escalation:
+        after_hours: 4
+        to:
+          - senior-editor
+    - id: publish
+      name: Publish Content
+      ref: tasks/publish-content
+      kind: Task
+      depends_on:
+        - validate
+        - review
+      input:
+        content_id: ${{ inputs.content_id }}
+        content_type: ${{ steps.validate.output.content_type }}
+        notify_subscribers: true
+      on_failure: rollback
+    - id: notify
+      name: Send Notifications
+      ref: tasks/send-notifications
+      kind: Task
+      depends_on:
+        - publish
+      input:
+        channels: ${{ inputs.notify_channels }}
+        message:
+          title: New content published
+          url: ${{ steps.publish.output.published_url }}
+          priority: ${{ inputs.priority }}
+      on_failure: continue
+    - id: analytics
+      name: Track Analytics
+      ref: tasks/track-analytics
+      kind: Task
+      depends_on:
+        - publish
+      async: true
+      input:
+        event: content_published
+        properties:
+          content_id: ${{ inputs.content_id }}
+          published_at: ${{ steps.publish.output.published_at }}
+  context:
+    variables:
+      environment: ${{ env.ENVIRONMENT }}
+      trace_id: ${{ uuid() }}
+    secrets:
+      - name: CMS_API_KEY
+        ref: vault://secret/cms/api-key
+      - name: NOTIFICATION_TOKEN
+        ref: vault://secret/notifications/token
+  concurrency:
+    group: publish-${{ inputs.content_id }}
+    cancel_in_progress: false
+  error_handling:
+    on_failure: compensate
+    compensation_steps:
+      - id: rollback-publish
+        name: Rollback Publication
+        ref: tasks/unpublish-content
+        kind: Task
+        input:
+          content_id: ${{ inputs.content_id }}
+      - id: notify-failure
+        name: Notify Team
+        ref: tasks/send-alert
+        kind: Task
+        input:
+          channel: ops-alerts
+          message: Publishing workflow failed for ${{ inputs.content_id }}
+          severity: high