@bluefly/openstandardagents 0.3.1 → 0.3.2

package/examples/migration-guides/from-langchain-to-ossa.yaml

@@ -50,7 +50,7 @@
 # OSSA MANIFEST (After):
 # ----------------------------------------------------------------------------
 
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Agent
 
 metadata:
@@ -117,7 +117,7 @@ spec:
 # ----------------------------------------------------------------------------
 
 ---
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Agent
 
 metadata:
@@ -185,7 +185,7 @@ spec:
 # ----------------------------------------------------------------------------
 
 ---
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Agent
 
 metadata:
@@ -215,7 +215,7 @@ spec:
       endpoint: https://api.academic.com/search
 
 ---
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Agent
 
 metadata:

package/examples/multi-agent/conditional-router.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Agent
 metadata:
   name: conditional-router

package/examples/multi-agent/parallel-execution.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Agent
 metadata:
   name: parallel-executor

package/examples/multi-agent/sequential-pipeline.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Agent
 metadata:
   name: sequential-pipeline

package/examples/observability/activity-stream-full.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Agent
 metadata:
   name: activity-tracked-agent

package/examples/openai/basic-agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Agent
 
 metadata:

package/examples/openai/multi-tool-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.3.0",
+  "apiVersion": "ossa/v0.3.2",
   "kind": "Agent",
   "metadata": {
     "name": "multi-tool-agent",
@@ -185,4 +185,4 @@
       }
     }
   }
-}
+}

package/examples/openai/swarm-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.3.0",
+  "apiVersion": "ossa/v0.3.2",
   "kind": "Agent",
   "metadata": {
     "name": "swarm-agent",
@@ -69,4 +69,4 @@
       }
     }
   }
-}
+}

package/examples/production/document-analyzer-openai.yml

@@ -1,7 +1,7 @@
 # OSSA Agent with OpenAI Bridge Configuration Example
 # Document Analyzer Agent - Proof of Concept
 
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Agent
 metadata:
   name: document-analyzer

package/examples/quickstart/support-agent.ossa.yaml

@@ -1,7 +1,7 @@
 # OSSA Quickstart Example - Customer Support Agent
 # Run with: ossa run examples/quickstart/support-agent.ossa.yaml
 
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Agent
 
 metadata:

package/examples/real-world/gitlab-cicd-optimizer.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Agent
 metadata:
   name: gitlab-cicd-optimizer

package/examples/real-world/rag-documentation-assistant.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Agent
 metadata:
   name: rag-documentation-assistant

package/examples/runtime-adapters/bedrock-claude-example.ossa.yaml

@@ -209,7 +209,7 @@
 #                           THE ACTUAL MANIFEST STARTS HERE
 # ═══════════════════════════════════════════════════════════════════════════════════
 
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Agent
 
 metadata:

package/examples/schema/reusable-components.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.3.0
+apiVersion: ossa/v0.3.2
 kind: Agent
 metadata:
   name: component-showcase

package/examples/showcase/ci-pipeline.ossa.yaml

@@ -0,0 +1,59 @@
+# ============================================================================
+# OSSA Power Agent: CI Pipeline
+# ============================================================================
+# CI/CD automation agent for build, test, deploy, and release workflows.
+# Integrates with GitLab CI, GitHub Actions, and other CI systems.
+#
+# Showcases: Runtime integration, messaging, GitLab extension
+# ============================================================================
+
+apiVersion: ossa/v0.3.2
+kind: Agent
+metadata:
+  name: ci-pipeline
+  version: 1.0.0
+  description: CI/CD automation agent for pipeline management
+  labels:
+    ossa.dev/category: devops
+    ossa.dev/tier: power-agent
+    ossa.dev/runtime: gitlab-ci
+  annotations:
+    ossa.dev/documentation: https://openstandardagents.org/agents/ci-pipeline
+
+spec:
+  capabilities:
+    - type: function
+      name: ci.trigger
+      description: Trigger CI/CD pipeline runs
+    - type: function
+      name: ci.monitor
+      description: Monitor pipeline status and jobs
+    - type: function
+      name: ci.fix
+      description: Analyze and fix pipeline failures
+    - type: function
+      name: ci.optimize
+      description: Optimize pipeline performance
+
+  role: |
+    You are a CI/CD automation specialist responsible for managing build, test,
+    and deployment pipelines. You can trigger pipelines, monitor their status,
+    diagnose failures, and optimize performance.
+
+    Pipeline management:
+    1. Trigger appropriate pipelines based on changes
+    2. Monitor job status and detect failures early
+    3. Analyze failure logs and suggest fixes
+    4. Optimize pipeline DAGs for faster execution
+    5. Manage deployment approvals and rollbacks
+
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4
+    temperature: 0.2
+    maxTokens: 8192
+
+  tools:
+    - type: function
+      name: gitlab.pipeline.trigger
+      description: Trigger a GitLab CI pipeline

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

@@ -0,0 +1,118 @@
+# ============================================================================
+# 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
+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: power-agent
+    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,61 @@
+# ============================================================================
+# 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
+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: power-agent
+    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,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