@bluefly/openstandardagents 0.3.0 → 0.3.2

package/examples/showcase/compliance-validator.ossa.yaml

@@ -0,0 +1,62 @@
+# ============================================================================
+# OSSA Power Agent: Compliance Validator
+# ============================================================================
+# OSSA specification compliance validation agent. Validates agent manifests,
+# ensures schema compliance, and enforces organizational policies.
+#
+# Showcases: Contract validation, schema enforcement, policy DSL
+# ============================================================================
+
+apiVersion: ossa/v0.3.2
+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: power-agent
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/agents/compliance-validator
+
+spec:
+  capabilities:
+    - type: function
+      name: validate.manifest
+      description: Validate OSSA manifest against schema
+    - type: function
+      name: validate.contract
+      description: Validate agent contracts
+    - type: function
+      name: validate.policy
+      description: Enforce organizational policies
+    - type: function
+      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: anthropic
+    model: claude-sonnet-4
+    temperature: 0.1  # Very low for consistent validation
+    maxTokens: 8192
+
+  tools:
+    - type: function
+      name: schema.validate
+      description: Validate manifest against JSON Schema

package/examples/showcase/content-writer.ossa.yaml

@@ -0,0 +1,67 @@
+# ============================================================================
+# 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.2
+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: power-agent
+    ossa.dev/runtime: drupal
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/agents/content-writer
+
+spec:
+  capabilities:
+    - type: function
+      name: content.create
+      description: Create CMS content entities
+    - type: function
+      name: content.translate
+      description: Translate content to multiple languages
+    - type: function
+      name: content.moderate
+      description: Review and moderate content
+    - type: function
+      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
+    maxTokens: 8192
+
+  tools:
+    - type: function
+      name: drupal.node.create
+      description: Create Drupal content node

package/examples/showcase/data-transformer.ossa.yaml

@@ -0,0 +1,78 @@
+# ============================================================================
+# OSSA Power Agent: Data Transformer
+# ============================================================================
+# Data pipeline and transformation agent for ETL operations, format
+# conversion, validation, and data quality checks.
+#
+# Showcases: Task kind (deterministic), batch processing, data contracts
+# ============================================================================
+
+apiVersion: ossa/v0.3.2
+kind: Task
+metadata:
+  name: data-transformer
+  version: 1.0.0
+  description: Data transformation and ETL pipeline agent
+  labels:
+    ossa.dev/category: data
+    ossa.dev/tier: power-agent
+    ossa.dev/execution: deterministic
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/agents/data-transformer
+
+spec:
+  # Task-specific execution configuration
+  execution:
+    type: deterministic
+    runtime: any  # Can run on any runtime
+    batch:
+      enabled: true
+      parallelism: 10
+      chunk_size: 1000
+    retry:
+      max_attempts: 3
+      backoff: exponential
+
+  capabilities:
+    - type: function
+      name: data.extract
+      description: Extract data from various sources
+    - type: function
+      name: data.transform
+      description: Transform data between formats
+    - type: function
+      name: data.validate
+      description: Validate data against schemas
+    - type: function
+      name: data.load
+      description: Load data to destination
+
+  role: |
+    You are a data transformation specialist responsible for ETL pipelines,
+    format conversion, and data quality validation.
+
+    ETL workflow:
+    1. Extract - Read from sources (API, database, files)
+    2. Transform - Convert, clean, normalize, enrich
+    3. Validate - Check against schemas, business rules
+    4. Load - Write to destination systems
+
+    Data quality checks:
+    - Schema compliance
+    - Null/empty value detection
+    - Type validation
+    - Range/boundary checks
+    - Referential integrity
+    - Duplicate detection
+
+  # Note: Tasks may not need LLM for deterministic operations
+  llm:
+    provider: anthropic
+    model: ${OSSA_LLM_MODEL:-claude-haiku-3-5}  # Faster model for data tasks
+    temperature: 0.0  # Deterministic
+    maxTokens: 4096
+
+  tools:
+    - type: function
+      name: data.read.json
+      description: Read JSON data

package/examples/showcase/doc-generator.ossa.yaml

@@ -0,0 +1,68 @@
+# ============================================================================
+# OSSA Power Agent: Doc Generator
+# ============================================================================
+# Documentation generation agent for API docs, READMEs, changelogs,
+# and technical documentation.
+#
+# Showcases: Multi-provider LLM, template system
+# ============================================================================
+
+apiVersion: ossa/v0.3.2
+kind: Agent
+metadata:
+  name: doc-generator
+  version: 1.0.0
+  description: Automated documentation generation agent
+  labels:
+    ossa.dev/category: documentation
+    ossa.dev/tier: power-agent
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/agents/doc-generator
+
+spec:
+  capabilities:
+    - type: function
+      name: docs.api
+      description: Generate API documentation from code
+    - type: function
+      name: docs.readme
+      description: Generate or update README files
+    - type: function
+      name: docs.changelog
+      description: Generate changelog from commits
+    - type: function
+      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: anthropic
+    model: claude-sonnet-4
+    temperature: 0.5
+    maxTokens: 16384
+    # Fallback providers for high availability
+    fallback:
+      - provider: openai
+        model: gpt-4o
+      - provider: google
+        model: gemini-2.0-flash
+
+  tools:
+    - type: function
+      name: code.analyze
+      description: Analyze code structure for documentation

package/examples/showcase/security-scanner.ossa.yaml

@@ -0,0 +1,65 @@
+# ============================================================================
+# OSSA Power Agent: Security Scanner
+# ============================================================================
+# Comprehensive security analysis agent with vulnerability scanning,
+# dependency audit, secret detection, and compliance checking.
+#
+# Showcases: Safety policies, constraints, access tiers
+# ============================================================================
+
+apiVersion: ossa/v0.3.2
+kind: Agent
+metadata:
+  name: security-scanner
+  version: 1.0.0
+  description: Security analysis agent with vulnerability and compliance scanning
+  labels:
+    ossa.dev/category: security
+    ossa.dev/tier: power-agent
+    ossa.dev/access-tier: elevated
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/agents/security-scanner
+
+spec:
+  capabilities:
+    - type: function
+      name: security.scan
+      description: Scan codebase for security vulnerabilities
+    - type: function
+      name: security.audit
+      description: Audit dependencies for known CVEs
+    - type: function
+      name: security.secrets
+      description: Detect exposed secrets and credentials
+    - type: function
+      name: security.compliance
+      description: Check compliance against security policies
+
+  role: |
+    You are a security specialist agent responsible for identifying vulnerabilities,
+    auditing dependencies, detecting secrets, and ensuring compliance with security
+    policies.
+
+    Security scanning process:
+    1. Static analysis for common vulnerability patterns (OWASP Top 10)
+    2. Dependency vulnerability scanning (CVE database)
+    3. Secret detection (API keys, tokens, credentials)
+    4. Configuration security review
+    5. Compliance policy validation
+
+    Always provide:
+    - Severity classification (Critical, High, Medium, Low)
+    - Affected file and line number
+    - Remediation guidance
+    - References to CVEs or security advisories
+
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4
+    temperature: 0.1  # Low temperature for consistent security analysis
+    maxTokens: 16384
+
+  tools:
+    - type: function
+      name: scan.sast
+      description: Run static application security testing

package/examples/showcase/test-generator.ossa.yaml

@@ -0,0 +1,63 @@
+# ============================================================================
+# OSSA Power Agent: Test Generator
+# ============================================================================
+# Automated test generation agent for unit tests, integration tests,
+# and test fixtures based on code analysis.
+#
+# Showcases: Code analysis tools, multi-language support
+# ============================================================================
+
+apiVersion: ossa/v0.3.2
+kind: Agent
+metadata:
+  name: test-generator
+  version: 1.0.0
+  description: Automated test generation agent
+  labels:
+    ossa.dev/category: testing
+    ossa.dev/tier: power-agent
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/agents/test-generator
+
+spec:
+  capabilities:
+    - type: function
+      name: test.unit
+      description: Generate unit tests
+    - type: function
+      name: test.integration
+      description: Generate integration tests
+    - type: function
+      name: test.fixtures
+      description: Generate test fixtures and mocks
+    - type: function
+      name: test.coverage
+      description: Analyze and improve test coverage
+
+  role: |
+    You are a test generation specialist responsible for creating comprehensive
+    test suites for codebases.
+
+    Test generation process:
+    1. Analyze code structure and dependencies
+    2. Identify testable units (functions, classes, modules)
+    3. Generate test cases covering:
+       - Happy path scenarios
+       - Edge cases
+       - Error handling
+       - Boundary conditions
+    4. Create test fixtures and mocks
+    5. Ensure proper test isolation
+
+    Test quality standards:
+    - Descriptive test names (should_X_when_Y)
+    - Arrange-Act-Assert pattern
+    - One assertion per test (where practical)
+    - Independent tests (no shared state)
+    - Fast execution
+
+
+  tools:
+    - type: function
+      name: code.parse
+      description: Parse code into AST

package/examples/showcase/workflow-orchestrator.ossa.yaml

@@ -0,0 +1,129 @@
+# ============================================================================
+# OSSA Power Agent: Workflow Orchestrator
+# ============================================================================
+# Multi-agent workflow orchestration agent. Coordinates complex workflows
+# involving multiple agents with routing, state management, and composition.
+#
+# Showcases: Workflow kind, agent-to-agent communication, composition
+# ============================================================================
+
+apiVersion: ossa/v0.3.2
+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: power-agent
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/agents/workflow-orchestrator
+
+spec:
+  # Workflow-specific configuration
+  execution:
+    type: orchestrated
+    parallelism: 5
+    timeout: 3600s
+
+  capabilities:
+    - type: function
+      name: workflow.create
+      description: Create and configure workflows
+    - type: function
+      name: workflow.execute
+      description: Execute multi-agent workflows
+    - type: function
+      name: workflow.monitor
+      description: Monitor workflow execution status
+    - type: function
+      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: anthropic
+    model: claude-sonnet-4
+    temperature: 0.2
+    maxTokens: 8192
+
+  # Agent composition
+  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
+
+  # Workflow steps
+  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 management
+  state:
+    persistence: redis
+    ttl: 86400
+    schema:
+      type: object
+      properties:
+        current_step:
+          type: string
+        completed_steps:
+          type: array
+        results:
+          type: object
+
+  # Messaging for agent coordination
+  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/tasks/batch-email-sender.yaml

@@ -1,6 +1,6 @@
 # Example: Batch Email Sender Task
 # A deterministic batch task that sends emails to multiple recipients
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Task
 metadata:
   name: batch-email-sender

package/examples/tasks/data-transform.yaml

@@ -1,6 +1,6 @@
 # Example: Data Transform Task
 # A pure function task that transforms data between formats
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Task
 metadata:
   name: data-transform

package/examples/tasks/publish-content.yaml

@@ -1,6 +1,6 @@
 # Example: Publish Content Task
 # A deterministic task that publishes content - no AI required
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Task
 metadata:
   name: publish-content

package/examples/templates/ossa-compliance.yaml

@@ -1,6 +1,6 @@
 # OSSA v0.1.9 Compliance Configuration for __ARCHIVE_REPORTS
 
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: 'ComplianceConfiguration'
 metadata:
   name: '__ARCHIVE_REPORTS-compliance'

package/examples/unified/security-scanner.ossa.yaml

@@ -2,7 +2,7 @@
 # Compatible with: OSSA, GitLab Duo, Google A2A, MCP
 # Zero hardcoded models, runtime-agnostic
 
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Agent
 
 metadata:

package/examples/vercel/edge-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.3.0",
+  "apiVersion": "ossa/v0.3.2",
   "kind": "Agent",
   "metadata": {
     "name": "edge-chat-agent",
@@ -41,4 +41,4 @@
       ]
     }
   }
-}
+}

package/examples/workflows/batch-email-campaign.yaml

@@ -1,6 +1,6 @@
 # Example: Batch Email Campaign Workflow
 # Demonstrates loops, parallel execution, and batch processing
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Workflow
 metadata:
   name: batch-email-campaign

package/examples/workflows/content-review-publish.yaml

@@ -1,6 +1,6 @@
 # Example: Content Review and Publish Workflow
 # Demonstrates mixed Task + Agent composition
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Workflow
 metadata:
   name: content-review-publish

package/examples/workflows/simple-etl.yaml

@@ -1,6 +1,6 @@
 # Example: Simple ETL Workflow
 # Demonstrates sequential Tasks with data transformation
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Workflow
 metadata:
   name: simple-etl