@bluefly/openstandardagents 0.3.1 → 0.3.3

package/examples/showcase/code-assistant.ossa.yaml

@@ -0,0 +1,104 @@
+apiVersion: ossa/v0.3.3
+kind: Agent
+metadata:
+  name: code-assistant
+  version: 1.0.0
+  description: Universal AI coding assistant for all major IDEs
+  labels:
+    ossa.dev/category: development
+    ossa.dev/tier: standard-example
+    ossa.dev/ide: universal
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/agents/code-assistant
+spec:
+  capabilities:
+  - type: function
+    name: code.complete
+    description: Intelligent code completion with context awareness
+  - type: function
+    name: code.refactor
+    description: Automated refactoring with safety checks
+  - type: function
+    name: code.explain
+    description: Explain code functionality and architecture
+  - type: function
+    name: code.generate
+    description: Generate code from natural language descriptions
+  - type: function
+    name: code.debug
+    description: Identify and suggest fixes for bugs
+  role: 'You are a universal AI coding assistant integrated across all major IDEs.
+
+    Your capabilities span code completion, refactoring, explanation, generation,
+
+    and debugging across all programming languages.
+
+
+    Key behaviors:
+
+    1. Context-aware completions based on project patterns
+
+    2. Safe refactoring with preview and undo support
+
+    3. Clear explanations with examples
+
+    4. Idiomatic code generation following project conventions
+
+    5. Root cause analysis for debugging
+
+    '
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4
+    temperature: 0.3
+    maxTokens: 8192
+  tools:
+  - type: function
+    name: file.read
+    description: Read file contents with line numbers
+  - type: function
+    name: file.edit
+    description: Edit file with diff preview
+  - type: function
+    name: search.code
+    description: Search codebase with regex
+  - type: function
+    name: search.files
+    description: Find files by glob pattern
+  - type: function
+    name: terminal.run
+    description: Execute terminal commands
+  safety:
+    constraints:
+    - Never execute destructive commands without confirmation
+    - Never expose secrets or credentials in responses
+    - Respect .gitignore and security policies
+    policies:
+    - policy: read-only-by-default
+      description: All file operations require explicit approval
+extensions:
+  claude-code:
+    hooks:
+      before_execute: validate_permissions
+      after_execute: log_action
+    keyboard_shortcuts:
+      toggle: Cmd+Shift+A
+      explain: Cmd+Shift+E
+  cursor:
+    composer_integration: true
+    inline_suggestions: true
+  copilot:
+    suggestions:
+      enabled: true
+      debounce_ms: 300
+  vscode:
+    extension_id: ossa.code-assistant
+    commands:
+    - ossa.explain
+    - ossa.refactor
+    - ossa.generate
+  jetbrains:
+    plugin_id: org.ossa.code-assistant
+    actions:
+    - OSSAExplainAction
+    - OSSARefactorAction

package/examples/showcase/code-reviewer.ossa.yaml

@@ -0,0 +1,58 @@
+apiVersion: ossa/v0.3.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:
+  - type: function
+    name: review.analyze
+    description: Analyze code changes for issues
+  - type: function
+    name: review.comment
+    description: Add review comments on specific lines
+  - type: function
+    name: review.approve
+    description: Approve merge requests (requires elevated access)
+  - type: function
+    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: anthropic
+    model: claude-sonnet-4
+    temperature: 0.3
+    maxTokens: 16384
+  tools:
+  - type: function
+    name: mr.diff
+    description: Get merge request diff

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

@@ -0,0 +1,61 @@
+apiVersion: ossa/v0.3.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:
+  - 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
+    maxTokens: 8192
+  tools:
+  - type: function
+    name: schema.validate
+    description: Validate manifest against JSON Schema

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

@@ -0,0 +1,70 @@
+apiVersion: ossa/v0.3.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:
+  - 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,76 @@
+apiVersion: ossa/v0.3.3
+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: standard-example
+    ossa.dev/execution: deterministic
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/agents/data-transformer
+spec:
+  execution:
+    type: deterministic
+    runtime: any
+    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
+
+    '
+  llm:
+    provider: anthropic
+    model: claude-haiku-3-5
+    temperature: 0.0
+    maxTokens: 4096
+  tools:
+  - type: function
+    name: data.read.json
+    description: Read JSON data

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

@@ -0,0 +1,66 @@
+apiVersion: ossa/v0.3.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:
+  - 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:
+    - 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,66 @@
+apiVersion: ossa/v0.3.3
+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: standard-example
+    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
+    maxTokens: 16384
+  tools:
+  - type: function
+    name: scan.sast
+    description: Run static application security testing

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

@@ -0,0 +1,37 @@
+apiVersion: ossa/v0.3.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:
+  - 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\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:
+  - type: function
+    name: code.parse
+    description: Parse code into AST

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

@@ -0,0 +1,114 @@
+apiVersion: ossa/v0.3.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:
+  - 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
+  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/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.3
 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.3
 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.3
 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.3
 kind: 'ComplianceConfiguration'
 metadata:
   name: '__ARCHIVE_REPORTS-compliance'