@bluefly/openstandardagents 0.3.2 → 0.3.5

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

@@ -1,13 +1,4 @@
-# ============================================================================
-# OSSA Power Agent: Code Assistant
-# ============================================================================
-# Universal IDE integration agent supporting Claude Code, Cursor, Copilot,
-# VSCode, JetBrains, Windsurf, Kiro, and Cody.
-#
-# Showcases: Tool definitions, LLM configuration, IDE extensions
-# ============================================================================
-
-apiVersion: ossa/v0.3.2
+apiVersion: ossa/v0.3.5
 kind: Agent
 metadata:
   name: code-assistant
@@ -15,77 +6,76 @@ metadata:
   description: Universal AI coding assistant for all major IDEs
   labels:
     ossa.dev/category: development
-    ossa.dev/tier: power-agent
+    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
+  - 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.
 
-  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
-
+  - 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
+    - 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
-
+    - policy: read-only-by-default
+      description: All file operations require explicit approval
 extensions:
   claude-code:
     hooks:
@@ -94,25 +84,21 @@ extensions:
     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
-
+    - ossa.explain
+    - ossa.refactor
+    - ossa.generate
   jetbrains:
     plugin_id: org.ossa.code-assistant
     actions:
-      - OSSAExplainAction
-      - OSSARefactorAction
+    - OSSAExplainAction
+    - OSSARefactorAction

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

@@ -1,13 +1,4 @@
-# ============================================================================
-# OSSA Power Agent: Code Reviewer
-# ============================================================================
-# Automated code review agent for pull/merge requests with quality checks,
-# style enforcement, and constructive feedback.
-#
-# Showcases: Identity, access tiers, contracts
-# ============================================================================
-
-apiVersion: ossa/v0.3.2
+apiVersion: ossa/v0.3.5
 kind: Agent
 metadata:
   name: code-reviewer
@@ -15,47 +6,53 @@ metadata:
   description: Automated code review agent with quality analysis
   labels:
     ossa.dev/category: development
-    ossa.dev/tier: power-agent
+    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.
+  - 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
+  - type: function
+    name: mr.diff
+    description: Get merge request diff

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

@@ -1,13 +1,4 @@
-# ============================================================================
-# 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
+apiVersion: ossa/v0.3.5
 kind: Agent
 metadata:
   name: compliance-validator
@@ -15,48 +6,56 @@ metadata:
   description: OSSA compliance validation and policy enforcement agent
   labels:
     ossa.dev/category: compliance
-    ossa.dev/tier: power-agent
+    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
+  - 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
+    temperature: 0.1
     maxTokens: 8192
-
   tools:
-    - type: function
-      name: schema.validate
-      description: Validate manifest against JSON Schema
+  - type: function
+    name: schema.validate
+    description: Validate manifest against JSON Schema

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

@@ -1,13 +1,4 @@
-# ============================================================================
-# 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
+apiVersion: ossa/v0.3.5
 kind: Agent
 metadata:
   name: content-writer
@@ -15,53 +6,65 @@ metadata:
   description: CMS content generation agent with Drupal integration
   labels:
     ossa.dev/category: content
-    ossa.dev/tier: power-agent
+    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.
+  - 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
+
+    - 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
+  - type: function
+    name: drupal.node.create
+    description: Create Drupal content node

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

@@ -1,13 +1,4 @@
-# ============================================================================
-# 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
+apiVersion: ossa/v0.3.5
 kind: Task
 metadata:
   name: data-transformer
@@ -15,16 +6,14 @@ metadata:
   description: Data transformation and ETL pipeline agent
   labels:
     ossa.dev/category: data
-    ossa.dev/tier: power-agent
+    ossa.dev/tier: standard-example
     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
+    runtime: any
     batch:
       enabled: true
       parallelism: 10
@@ -32,47 +21,56 @@ spec:
     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,
+  - 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
+    model: claude-haiku-3-5
+    temperature: 0.0
     maxTokens: 4096
-
   tools:
-    - type: function
-      name: data.read.json
-      description: Read JSON data
+  - type: function
+    name: data.read.json
+    description: Read JSON data

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

@@ -1,13 +1,4 @@
-# ============================================================================
-# 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
+apiVersion: ossa/v0.3.5
 kind: Agent
 metadata:
   name: doc-generator
@@ -15,54 +6,61 @@ metadata:
   description: Automated documentation generation agent
   labels:
     ossa.dev/category: documentation
-    ossa.dev/tier: power-agent
+    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
+  - 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
 
-  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
-
+    - provider: openai
+      model: gpt-4o
+    - provider: google
+      model: gemini-2.0-flash
   tools:
-    - type: function
-      name: code.analyze
-      description: Analyze code structure for documentation
+  - type: function
+    name: code.analyze
+    description: Analyze code structure for documentation