@bluefly/openstandardagents 0.3.2 → 0.3.5

package/examples/ossa-templates/04-code-reviewer.ossa.yaml

@@ -0,0 +1,116 @@
+apiVersion: ossa/v0.3
+kind: Agent
+metadata:
+  name: code-reviewer
+  version: 1.0.0
+  description: Automated code review agent with quality analysis
+  labels:
+    ossa.dev/category: development
+    ossa.dev/tier: standard-example
+    ossa.dev/access-tier: standard
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/agents/code-reviewer
+spec:
+  capabilities:
+  - name: review.analyze
+    description: Analyze code changes for issues
+  - name: review.comment
+    description: Add review comments on specific lines
+  - name: review.approve
+    description: Approve merge requests (requires elevated access)
+  - name: review.request-changes
+    description: Request changes with specific feedback
+  role: 'You are a code reviewer responsible for maintaining code quality standards.
+
+    Review merge requests for:
+
+
+    1. Code correctness and potential bugs
+
+    2. Security vulnerabilities
+
+    3. Performance implications
+
+    4. Code style and conventions
+
+    5. Test coverage
+
+    6. Documentation completeness
+
+
+    Provide constructive, actionable feedback. Be specific about issues and
+
+    suggest concrete improvements. Acknowledge good patterns and practices.
+
+    '
+  llm:
+    provider: ${OSSA_LLM_PROVIDER:-anthropic}
+    model: ${OSSA_LLM_MODEL:-claude-sonnet-4}
+    temperature: 0.3
+    maxTokens: ${OSSA_LLM_MAX_TOKENS:-16384}
+  tools:
+  - name: mr.diff
+    description: Get merge request diff
+    handler:
+      runtime: api
+      endpoint: ${GITLAB_API_URL}/projects/${CI_PROJECT_ID}/merge_requests/${MR_IID}/diffs
+      method: GET
+    type: function
+  - name: mr.comment
+    description: Add comment to merge request
+    handler:
+      runtime: api
+      endpoint: ${GITLAB_API_URL}/projects/${CI_PROJECT_ID}/merge_requests/${MR_IID}/discussions
+      method: POST
+    type: function
+  - name: mr.approve
+    description: Approve merge request
+    handler:
+      runtime: api
+      endpoint: ${GITLAB_API_URL}/projects/${CI_PROJECT_ID}/merge_requests/${MR_IID}/approve
+      method: POST
+    type: function
+  - name: lint.check
+    description: Run linting tools
+    handler:
+      runtime: docker
+      image: node:20-alpine
+      command:
+      - npx
+      - eslint
+      - --format=json
+    type: function
+  contracts:
+    provides:
+    - name: code-review
+      version: '1.0'
+      schema:
+        input:
+          type: object
+          properties:
+            mr_iid:
+              type: integer
+              description: Merge request IID
+            project_id:
+              type: integer
+              description: GitLab project ID
+        output:
+          type: object
+          properties:
+            status:
+              type: string
+              enum:
+              - approved
+              - changes_requested
+              - commented
+            comments:
+              type: array
+              items:
+                type: object
+                properties:
+                  file:
+                    type: string
+                  line:
+                    type: integer
+                  comment:
+                    type: string

package/examples/ossa-templates/05-doc-generator.ossa.yaml

@@ -0,0 +1,102 @@
+apiVersion: ossa/v0.3
+kind: Agent
+metadata:
+  name: doc-generator
+  version: 1.0.0
+  description: Automated documentation generation agent
+  labels:
+    ossa.dev/category: documentation
+    ossa.dev/tier: standard-example
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/agents/doc-generator
+spec:
+  capabilities:
+  - name: docs.api
+    description: Generate API documentation from code
+  - name: docs.readme
+    description: Generate or update README files
+  - name: docs.changelog
+    description: Generate changelog from commits
+  - name: docs.technical
+    description: Generate technical documentation
+  role: 'You are a technical documentation specialist responsible for generating
+
+    and maintaining project documentation.
+
+
+    Documentation types:
+
+    1. API Documentation - Generate from code, OpenAPI specs, or schemas
+
+    2. README - Project overview, installation, usage, examples
+
+    3. Changelog - Semantic versioning, conventional commits
+
+    4. Technical Docs - Architecture, design decisions, guides
+
+
+    Always:
+
+    - Use clear, concise language
+
+    - Include code examples where appropriate
+
+    - Follow project documentation conventions
+
+    - Keep documentation in sync with code
+
+    '
+  llm:
+    provider: ${OSSA_LLM_PROVIDER:-anthropic}
+    model: ${OSSA_LLM_MODEL:-claude-sonnet-4}
+    temperature: 0.5
+    maxTokens: ${OSSA_LLM_MAX_TOKENS:-16384}
+    fallback:
+    - provider: openai
+      model: gpt-4o
+    - provider: google
+      model: gemini-2.0-flash
+  tools:
+  - name: code.analyze
+    description: Analyze code structure for documentation
+    handler:
+      runtime: local
+      capability: ast.parse
+    type: function
+  - name: openapi.parse
+    description: Parse OpenAPI specification
+    handler:
+      runtime: local
+      capability: openapi.parse
+    type: function
+  - name: git.log
+    description: Get git commit history
+    handler:
+      runtime: local
+      capability: git.log
+    type: function
+  - name: markdown.write
+    description: Write markdown documentation
+    handler:
+      runtime: local
+      capability: fs.write
+    type: function
+  - name: wiki.publish
+    description: Publish to GitLab wiki
+    handler:
+      runtime: api
+      endpoint: ${GITLAB_API_URL}/projects/${CI_PROJECT_ID}/wikis
+      method: POST
+    type: function
+  templates:
+    readme:
+      path: .ossa/templates/readme.md.template
+      variables:
+      - project_name
+      - description
+      - installation
+      - usage
+      - contributing
+    changelog:
+      path: .ossa/templates/changelog.md.template
+      format: conventional-commits

package/examples/ossa-templates/06-compliance-validator.ossa.yaml

@@ -0,0 +1,132 @@
+apiVersion: ossa/v0.3
+kind: Agent
+metadata:
+  name: compliance-validator
+  version: 1.0.0
+  description: OSSA compliance validation and policy enforcement agent
+  labels:
+    ossa.dev/category: compliance
+    ossa.dev/tier: standard-example
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/agents/compliance-validator
+spec:
+  capabilities:
+  - name: validate.manifest
+    description: Validate OSSA manifest against schema
+  - name: validate.contract
+    description: Validate agent contracts
+  - name: validate.policy
+    description: Enforce organizational policies
+  - name: validate.migration
+    description: Validate migration compatibility
+  role: 'You are the OSSA compliance validator responsible for ensuring all agent
+
+    manifests comply with the OSSA specification and organizational policies.
+
+
+    Validation scope:
+
+    1. Schema Compliance - Validate against OSSA JSON Schema
+
+    2. Contract Validation - Verify input/output contracts
+
+    3. Policy Enforcement - Apply organizational policies
+
+    4. Migration Checks - Ensure backward compatibility
+
+
+    Report all violations with:
+
+    - Severity level (error, warning, info)
+
+    - Location in manifest
+
+    - Specific violation description
+
+    - Remediation guidance
+
+    '
+  llm:
+    provider: ${OSSA_LLM_PROVIDER:-anthropic}
+    model: ${OSSA_LLM_MODEL:-claude-sonnet-4}
+    temperature: 0.1
+    maxTokens: ${OSSA_LLM_MAX_TOKENS:-8192}
+  tools:
+  - name: schema.validate
+    description: Validate manifest against JSON Schema
+    handler:
+      runtime: local
+      capability: jsonschema.validate
+    type: function
+  - name: manifest.parse
+    description: Parse OSSA manifest (YAML/JSON)
+    handler:
+      runtime: local
+      capability: manifest.parse
+    type: function
+  - name: policy.evaluate
+    description: Evaluate against policy rules
+    handler:
+      runtime: local
+      capability: policy.evaluate
+    type: function
+  - name: report.generate
+    description: Generate validation report
+    handler:
+      runtime: local
+      capability: report.generate
+    type: function
+  policies:
+    rules:
+    - id: require-metadata-version
+      description: All manifests must specify metadata.version
+      severity: error
+      check: metadata.version != null
+    - id: require-role-definition
+      description: Agents must have role definition
+      severity: error
+      check: spec.role != null && spec.role.length > 50
+    - id: require-capabilities
+      description: Agents should declare capabilities
+      severity: warning
+      check: spec.capabilities != null && spec.capabilities.length > 0
+    - id: require-llm-config
+      description: Agents should specify LLM configuration
+      severity: warning
+      check: spec.llm != null
+    - id: no-hardcoded-secrets
+      description: No hardcoded secrets in manifest
+      severity: error
+      check: '!contains(toString(.), ''sk-'') && !contains(toString(.), ''glpat-'')'
+  contracts:
+    provides:
+    - name: ossa-validation
+      version: '1.0'
+      schema:
+        input:
+          type: object
+          properties:
+            manifest_path:
+              type: string
+              description: Path to manifest file
+            policy_set:
+              type: string
+              description: Policy set to apply (default, strict, permissive)
+        output:
+          type: object
+          properties:
+            valid:
+              type: boolean
+            errors:
+              type: array
+              items:
+                type: object
+                properties:
+                  severity:
+                    type: string
+                  path:
+                    type: string
+                  message:
+                    type: string
+            warnings:
+              type: array

package/examples/ossa-templates/07-workflow-orchestrator.ossa.yaml

@@ -0,0 +1,110 @@
+apiVersion: ossa/v0.3
+kind: Workflow
+metadata:
+  name: workflow-orchestrator
+  version: 1.0.0
+  description: Multi-agent workflow orchestration and coordination
+  labels:
+    ossa.dev/category: orchestration
+    ossa.dev/tier: standard-example
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/agents/workflow-orchestrator
+spec:
+  execution:
+    type: orchestrated
+    parallelism: 5
+    timeout: 3600s
+  capabilities:
+  - name: workflow.create
+    description: Create and configure workflows
+  - name: workflow.execute
+    description: Execute multi-agent workflows
+  - name: workflow.monitor
+    description: Monitor workflow execution status
+  - name: workflow.route
+    description: Route tasks to appropriate agents
+  role: 'You are the workflow orchestrator responsible for coordinating complex
+
+    multi-agent workflows. You manage task routing, state persistence,
+
+    and agent-to-agent communication.
+
+
+    Orchestration patterns:
+
+    1. Sequential - Execute agents in order
+
+    2. Parallel - Execute multiple agents concurrently
+
+    3. Conditional - Route based on conditions
+
+    4. Fan-out/Fan-in - Distribute and aggregate
+
+    5. Human-in-the-loop - Pause for human approval
+
+    '
+  llm:
+    provider: ${OSSA_LLM_PROVIDER:-anthropic}
+    model: ${OSSA_LLM_MODEL:-claude-sonnet-4}
+    temperature: 0.2
+    maxTokens: ${OSSA_LLM_MAX_TOKENS:-8192}
+  agents:
+  - ref: code-reviewer
+    alias: reviewer
+    on_complete: security-scanner
+  - ref: security-scanner
+    alias: security
+    on_complete: ci-pipeline
+  - ref: ci-pipeline
+    alias: pipeline
+    condition: security.result.passed == true
+  steps:
+  - id: review
+    agent: reviewer
+    input:
+      mr_iid: ${input.mr_iid}
+      project_id: ${input.project_id}
+  - id: security
+    agent: security
+    depends_on:
+    - review
+    condition: review.status == "approved"
+    input:
+      paths: ${input.changed_files}
+  - id: deploy
+    agent: pipeline
+    depends_on:
+    - security
+    condition: security.passed == true
+    input:
+      action: deploy
+      environment: ${input.environment}
+  state:
+    persistence: redis
+    ttl: 86400
+    schema:
+      type: object
+      properties:
+        current_step:
+          type: string
+        completed_steps:
+          type: array
+        results:
+          type: object
+  messaging:
+    transport: redis
+    queues:
+    - name: workflow-events
+      description: Workflow lifecycle events
+    - name: agent-results
+      description: Agent execution results
+    events:
+      publish:
+      - workflow.started
+      - workflow.completed
+      - workflow.failed
+      - step.completed
+      subscribe:
+      - agent.completed
+      - agent.failed
+      - human.approved

package/examples/ossa-templates/08-content-writer.ossa.yaml

@@ -0,0 +1,136 @@
+# ============================================================================
+# OSSA Power Agent: Content Writer
+# ============================================================================
+# CMS content generation agent for Drupal and other content management systems.
+# Handles content creation, translation, moderation, and SEO optimization.
+#
+# Showcases: Drupal extension, async processing (Messenger), ECA integration
+# ============================================================================
+
+apiVersion: ossa/v0.3
+kind: Agent
+metadata:
+  name: content-writer
+  version: 1.0.0
+  description: CMS content generation agent with Drupal integration
+  labels:
+    ossa.dev/category: content
+    ossa.dev/tier: standard-example
+    ossa.dev/runtime: drupal
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/agents/content-writer
+
+spec:
+  capabilities:
+    - name: content.create
+      description: Create CMS content entities
+    - name: content.translate
+      description: Translate content to multiple languages
+    - name: content.moderate
+      description: Review and moderate content
+    - name: content.optimize
+      description: Optimize content for SEO
+
+  role: |
+    You are a content writer agent specialized in CMS content generation.
+    You create high-quality articles, translate content, handle moderation
+    workflows, and optimize for SEO.
+
+    Content workflow:
+    1. Analyze content brief and target audience
+    2. Research topic and gather information
+    3. Generate structured content (headings, paragraphs, lists)
+    4. Optimize for SEO (meta, keywords, readability)
+    5. Select media assets
+    6. Submit for moderation or publish
+
+    Content guidelines:
+    - Write for the target audience's expertise level
+    - Use clear, scannable formatting
+    - Include relevant internal/external links
+    - Optimize images with alt text
+    - Follow brand voice guidelines
+
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4
+    temperature: 0.7
+
+  tools:
+    - type: function
+      name: drupal.node.create
+      description: Create content node in Drupal
+      handler:
+        runtime: drupal
+        capability: node.create
+
+    - type: function
+      name: drupal.node.update
+      description: Update existing content node
+      handler:
+        runtime: drupal
+        capability: node.update
+
+    - type: function
+      name: drupal.media.search
+      description: Search media library
+      handler:
+        runtime: drupal
+        capability: media.search
+
+    - type: function
+      name: drupal.taxonomy.suggest
+      description: Suggest taxonomy terms
+      handler:
+        runtime: drupal
+        capability: taxonomy.suggest
+
+    - type: function
+      name: seo.analyze
+      description: Analyze content for SEO
+      handler:
+        runtime: local
+        capability: seo.analyze
+
+extensions:
+  drupal:
+    module: ai_agents_ossa
+    config_entity: true
+
+    permissions:
+      entity_permissions:
+        - "create article content"
+        - "edit any article content"
+        - "view media"
+        - "use ai content generation"
+      custom_permissions:
+        - "execute content writer agent"
+      execution_user: "1"
+      permission_mode: agent_only
+
+    # Async processing via Symfony Messenger
+    messenger:
+      transport: redis
+      queue: content_generation
+      retry_strategy:
+        max_retries: 3
+        delay: 2000
+        multiplier: 2
+        max_delay: 30000
+
+    # ECA workflow integration
+    workflow_engine: eca
+    eca_events:
+      - content_brief_submitted
+      - content_review_requested
+      - content_approved
+
+    # Discovery paths
+    discovery_paths:
+      - "config/agents/*.ossa.yaml"
+      - "modules/custom/*/agents/*.ossa.yaml"
+
+    hooks:
+      before_execute: ai_agents_ossa_before_execute
+      after_execute: ai_agents_ossa_after_execute
+      on_error: ai_agents_ossa_on_error

package/examples/ossa-templates/09-test-generator.ossa.yaml

@@ -0,0 +1,113 @@
+apiVersion: ossa/v0.3
+kind: Agent
+metadata:
+  name: test-generator
+  version: 1.0.0
+  description: Automated test generation agent
+  labels:
+    ossa.dev/category: testing
+    ossa.dev/tier: standard-example
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/agents/test-generator
+spec:
+  capabilities:
+  - name: test.unit
+    description: Generate unit tests
+  - name: test.integration
+    description: Generate integration tests
+  - name: test.fixtures
+    description: Generate test fixtures and mocks
+  - name: test.coverage
+    description: Analyze and improve test coverage
+  role: "You are a test generation specialist responsible for creating comprehensive\n\
+    test suites for codebases.\n\nTest generation process:\n1. Analyze code structure\
+    \ and dependencies\n2. Identify testable units (functions, classes, modules)\n\
+    3. Generate test cases covering:\n   - Happy path scenarios\n   - Edge cases\n\
+    \   - Error handling\n   - Boundary conditions\n4. Create test fixtures and mocks\n\
+    5. Ensure proper test isolation\n\nTest quality standards:\n- Descriptive test\
+    \ names (should_X_when_Y)\n- Arrange-Act-Assert pattern\n- One assertion per test\
+    \ (where practical)\n- Independent tests (no shared state)\n- Fast execution\n"
+  tools:
+  - name: code.parse
+    description: Parse code into AST
+    handler:
+      runtime: local
+      capability: ast.parse
+    type: function
+  - name: coverage.analyze
+    description: Analyze test coverage
+    handler:
+      runtime: docker
+      image: node:20-alpine
+      command:
+      - npx
+      - c8
+      - --reporter=json
+    type: function
+  - name: test.write
+    description: Write test file
+    handler:
+      runtime: local
+      capability: fs.write
+    type: function
+  - name: test.run
+    description: Run test suite
+    handler:
+      runtime: local
+      capability: test.execute
+    type: function
+  languages:
+    typescript:
+      framework: vitest
+      patterns:
+      - '*.test.ts'
+      - '*.spec.ts'
+      fixtures_dir: __fixtures__
+    python:
+      framework: pytest
+      patterns:
+      - test_*.py
+      - '*_test.py'
+      fixtures_dir: fixtures
+    php:
+      framework: phpunit
+      patterns:
+      - '*Test.php'
+      fixtures_dir: tests/fixtures
+    go:
+      framework: testing
+      patterns:
+      - '*_test.go'
+  contracts:
+    provides:
+    - name: test-generation
+      version: '1.0'
+      schema:
+        input:
+          type: object
+          properties:
+            source_path:
+              type: string
+              description: Path to source file or directory
+            test_type:
+              type: string
+              enum:
+              - unit
+              - integration
+              - e2e
+            coverage_target:
+              type: number
+              description: Target coverage percentage
+        output:
+          type: object
+          properties:
+            tests_created:
+              type: integer
+            files:
+              type: array
+              items:
+                type: string
+            coverage_before:
+              type: number
+            coverage_after:
+              type: number