@bluefly/openstandardagents 0.4.4 → 0.4.5

package/examples/hierarchical-agent.ossa.yaml

@@ -0,0 +1,126 @@
+# OSSA v0.4.5 Example: Hierarchical Agent — Code Review Pipeline with Subagents
+#
+# Demonstrates the parent-child subagent pattern for a code review pipeline.
+# A coordinator agent spawns isolated subagents to perform specific review
+# tasks (exploration, security scanning, test validation). Subagents report
+# results only to the parent — there is no peer communication.
+#
+# Key characteristics:
+#   - Coordinator with subagents (not team members)
+#   - Parent-child delegation, no peer communication
+#   - Each subagent has a token budget to control costs
+#   - Context isolation enforced for all subagents
+#   - Results flow up: subagent -> parent -> user
+
+apiVersion: ossa/v0.4.5
+kind: Agent
+metadata:
+  name: code-review-pipeline
+  version: "1.0.0"
+  description: >-
+    A code review coordinator that spawns specialized subagents to analyze
+    code changes. A researcher explores the codebase for context, a debugger
+    scans for security vulnerabilities, and a generic subagent validates test
+    coverage. The coordinator synthesizes all findings into a review report.
+
+  agentKind: coordinator
+  agentType: a2a
+
+  agentArchitecture:
+    pattern: hierarchical
+    capabilities:
+      - tools
+      - code
+      - context
+      - function-calling
+    coordination:
+      handoffStrategy: automatic
+      maxDepth: 2
+      teamModel: parent-child
+      communicationPattern: direct
+      taskCoordination: assigned
+
+  labels:
+    domain: development
+    subdomain: code-review
+    pattern: hierarchical
+
+spec:
+  role: >-
+    You are a code review coordinator. When given a merge request or set of
+    file changes, you:
+    1. Spawn the code-explorer subagent to gather codebase context.
+    2. Spawn the security-scanner subagent to identify vulnerabilities.
+    3. Spawn the test-validator subagent to check test coverage.
+    4. Collect all subagent reports and synthesize a comprehensive review
+       with actionable feedback, severity ratings, and suggested fixes.
+
+  llm:
+    provider: anthropic
+    model: claude-sonnet-4-5-20250929
+    temperature: 0.2
+    maxTokens: 4096
+    profile: deep
+
+  subagents:
+    - name: code-explorer
+      kind: researcher
+      role: >-
+        Fast codebase search and structural analysis. Find relevant files,
+        trace dependencies, identify architecture patterns, and summarize
+        the context around changed files. Read-only — never modify anything.
+      model:
+        provider: anthropic
+        name: claude-haiku-4-5-20250514
+      tools:
+        - glob
+        - grep
+        - read_file
+      contextIsolation: true
+      reportTo: parent
+      maxTokenBudget: 50000
+
+    - name: security-scanner
+      kind: debugger
+      role: >-
+        Identify security vulnerabilities, code smells, and potential attack
+        vectors in the changed files. Check for injection risks, auth bypass,
+        secrets in code, unsafe deserialization, and OWASP Top 10 issues.
+        Generate a severity-rated findings list.
+      model:
+        provider: anthropic
+        name: claude-sonnet-4-5-20250929
+      tools:
+        - read_file
+        - grep
+        - static_analysis
+      contextIsolation: true
+      reportTo: parent
+      maxTokenBudget: 80000
+
+    - name: test-validator
+      kind: subagent
+      role: >-
+        Run the test suite and validate coverage for changed files. Check
+        that new code has corresponding tests, coverage thresholds are met,
+        and no existing tests are broken. Report coverage percentages and
+        any failures.
+      model:
+        provider: anthropic
+        name: claude-sonnet-4-5-20250929
+      tools:
+        - bash
+        - read_file
+        - grep
+      contextIsolation: true
+      reportTo: parent
+      maxTokenBudget: 60000
+
+  constraints:
+    cost:
+      maxTokensPerRequest: 200000
+      maxCostPerDay: 50.00
+      currency: USD
+    performance:
+      timeoutSeconds: 120
+      maxConcurrentRequests: 5

package/examples/hierarchical-crewai.ossa.yaml

@@ -0,0 +1,96 @@
+apiVersion: ossa/v0.4
+kind: Agent
+metadata:
+  name: devops-crew
+  version: 1.0.0
+  description: CrewAI manager/worker pattern for DevOps automation
+  agentType: crewai
+  agentKind: orchestrator
+  agentArchitecture:
+    pattern: hierarchical
+    capabilities:
+      - tools
+      - code
+      - context
+      - function-calling
+    coordination:
+      handoffStrategy: supervised
+      leaderAgent: devops-manager
+      teamModel: hierarchical
+      taskCoordination: dependency-wave
+      conflictResolution: leader-decides
+spec:
+  role: >
+    You manage a DevOps automation crew. Coordinate infrastructure,
+    deployment, and monitoring tasks across specialized workers.
+  llm:
+    provider: openai
+    model: gpt-4o
+  team:
+    model: hierarchical
+    lead: devops-manager
+    delegateMode: capability-match
+    members:
+      - name: devops-manager
+        kind: team-lead
+        role: >
+          DevOps team manager. Plan infrastructure changes, coordinate
+          deployments, and ensure system reliability.
+        model: gpt-4o
+        tools:
+          - project-planner
+          - status-dashboard
+      - name: infra-engineer
+        kind: specialist
+        role: >
+          Infrastructure engineer. Manage cloud resources, networking,
+          and compute provisioning using IaC.
+        tools:
+          - terraform-apply
+          - cloud-api
+          - dns-manager
+        maxTokenBudget: 25000
+      - name: deploy-engineer
+        kind: worker
+        role: >
+          Deployment engineer. Handle CI/CD pipelines, container builds,
+          and rollout strategies.
+        tools:
+          - docker-build
+          - kubectl-apply
+          - helm-upgrade
+          - ci-trigger
+      - name: monitor-agent
+        kind: teammate
+        role: >
+          Monitoring specialist. Track system health, alert on anomalies,
+          and provide performance insights.
+        tools:
+          - prometheus-query
+          - grafana-dashboard
+          - alert-manager
+          - log-search
+      - name: security-auditor
+        kind: reviewer
+        role: >
+          Security auditor. Review infrastructure changes for compliance,
+          scan for vulnerabilities, and enforce policies.
+        tools:
+          - vulnerability-scan
+          - compliance-check
+          - secret-scanner
+    taskList:
+      persistence: file-backed
+      format: yaml
+      dependencyTracking: true
+    communication:
+      channel: task-list
+      consensus: leader-decides
+    deployment:
+      backend: distributed
+      maxConcurrency: 5
+  constraints:
+    cost:
+      maxTokensPerDay: 2000000
+    performance:
+      timeoutSeconds: 600

package/examples/infrastructure/token-rotation/manifest.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.4
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: token-rotation-manager

package/examples/integration-patterns/agent-to-agent-orchestration.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: workflow-orchestrator

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

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: compliance-validator

package/examples/kagent/cost-optimizer.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: cost-optimizer

package/examples/kagent/documentation-agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: documentation-agent

package/examples/kagent/k8s-troubleshooter-v1.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: k8s-troubleshooter

package/examples/kagent/k8s-troubleshooter.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: k8s-troubleshooter

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

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: security-scanner

package/examples/knowledge-graph/drupal-agent-with-kg.ossa.yaml

@@ -1,7 +1,7 @@
 # OSSA v0.4.1 Agent with Knowledge Graph Extension
 # Portable, configurable - works with ANY git platform, vector DB, wiki format
 
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 
 metadata:

package/examples/mcp/browser-puppeteer.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: browser-automation-agent
@@ -6,13 +6,11 @@ metadata:
   description: "Web scraping and browser automation agent with Puppeteer MCP server"
   labels:
     framework: mcp
-    capability: browser
-    capability: web-scraping
-    capability: automation
+    capability: browser,web-scraping,automation
     environment: production
   annotations:
-    ai.bluefly.io/use-case: "Web scraping, testing, screenshots, PDF generation"
-    ai.bluefly.io/power-level: "HIGH - Browser automation makes agents significantly more powerful"
+    ossa.dev/use-case: "Web scraping, testing, screenshots, PDF generation"
+    ossa.dev/power-level: "HIGH - Browser automation makes agents significantly more powerful"
 
 spec:
   model:
@@ -168,7 +166,7 @@ spec:
             defaultViewport:
               width: 1920
               height: 1080
-            userAgent: "Mozilla/5.0 (compatible; OSSABot/1.0; +https://openstandardagents.com)"
+            userAgent: "Mozilla/5.0 (compatible; OSSABot/1.0; +https://openstandardagents.org)"
 
       capabilities:
         tools:

package/examples/mcp/database-mcp.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: database-assistant

package/examples/mcp/filesystem-mcp.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: filesystem-assistant

package/examples/messaging/dependency-healer.ossa.yaml

@@ -3,7 +3,7 @@
 # This agent monitors dependencies, detects outdated packages, and coordinates
 # updates while communicating with security scanners via OSSA messaging.
 
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: dependency-healer

package/examples/messaging/incident-responder.ossa.yaml

@@ -3,7 +3,7 @@
 # This agent receives security incidents from multiple sources and coordinates
 # response activities across teams via OSSA messaging.
 
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: incident-responder

package/examples/messaging/routing-rules.ossa.yaml

@@ -4,7 +4,7 @@
 # in a multi-agent security system. It implements the routing rules
 # for the security-scanner, dependency-healer, and incident-responder agents.
 
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Workflow
 metadata:
   name: security-workflow-routing

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

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: security-scanner

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

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

package/examples/migrations/langchain/01-python-react-agent-after.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: python-react-agent

package/examples/migrations/langchain/02-typescript-conversational-after.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: typescript-conversational

package/examples/migrations/langchain/03-sequential-chain-after.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Workflow
 metadata:
   name: sequential-chain

package/examples/migrations/langchain/04-config-based-after.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: customer-support-agent

package/examples/migrations/langchain/USAGE.txt

@@ -31,7 +31,7 @@ EXAMPLES
    ossa migrate langchain 01-python-react-agent-before.py
 
 2. Migrate with custom output:
-   ossa migrate langchain agent.py -o my-agent.ossa.yaml
+   ossa migrate langchain agent.py -o creative-agent-naming.ossa.yaml
 
 3. Generate migration report:
    ossa migrate langchain agent.ts --report migration-report.json

package/examples/migrations/swarm-to-ossa/QUICKSTART.md

@@ -213,7 +213,7 @@ spec:
 apiVersion: ossa/v0.3.6
 kind: AgentTest
 metadata:
-  name: test-my-agent
+  name: test-creative-agent-naming
 spec:
   agent: customer-service-agent
   test_cases:
@@ -230,7 +230,7 @@ spec:
 ossa test customer-service-agent.ossa.yaml
 
 # Output:
-# ✓ test-my-agent: Greet user (120ms)
+# ✓ test-creative-agent-naming: Greet user (120ms)
 #
 # Tests: 1 passed, 1 total
 # Time: 0.5s
@@ -357,7 +357,7 @@ Migrate one agent at a time. Don't try to migrate everything at once.
 
 ```bash
 # Generate agent template
-ossa init agent my-agent --from-swarm swarm_agent.py
+ossa init agent creative-agent-naming --from-swarm swarm_agent.py
 ```
 
 ### Tip 3: Validate Early

package/examples/migrations/swarm-to-ossa/after-handoffs.ossa.yaml

@@ -15,7 +15,7 @@
 # ============================================================================
 # Sales Agent - Entry Point
 # ============================================================================
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: sales-agent
@@ -81,7 +81,7 @@ spec:
 # ============================================================================
 # Order Verification Agent
 # ============================================================================
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: order-verification-agent
@@ -160,7 +160,7 @@ spec:
 # ============================================================================
 # Payment Processing Agent
 # ============================================================================
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: payment-processing-agent
@@ -270,7 +270,7 @@ spec:
 # ============================================================================
 # Fulfillment Agent
 # ============================================================================
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: fulfillment-agent
@@ -339,7 +339,7 @@ spec:
 # ============================================================================
 # Supervisor Agent
 # ============================================================================
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: supervisor-agent
@@ -421,7 +421,7 @@ spec:
 # ============================================================================
 # Workflow Orchestration (Bonus: NOT POSSIBLE in Swarm!)
 # ============================================================================
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Workflow
 metadata:
   name: order-processing-workflow

package/examples/migrations/swarm-to-ossa/after-triage-agent.ossa.yaml

@@ -10,7 +10,7 @@
 # - 50% less code
 # - Enterprise features built-in
 
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: customer-service-triage
@@ -139,7 +139,7 @@ spec:
 
 ---
 # Sales Agent (equivalent to sales_agent in Swarm)
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: sales-agent
@@ -223,7 +223,7 @@ spec:
 
 ---
 # Refunds Agent (equivalent to refunds_agent in Swarm)
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: refunds-agent

package/examples/minimal/agent.yml

@@ -132,7 +132,7 @@ api:
 #
 # To create a new agent from this template:
 #
-#   ossa init my-agent --template minimal
+#   ossa init supercali-fragilisticagent --template minimal
 #   # Then customize agent.yml with your values
 #
 # To run this agent locally:

package/examples/mr-reviewer-with-governance.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: mr-reviewer

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

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

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

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

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

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

package/examples/multi-agent-research-workflow.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: research-workflow

package/examples/multi-platform/single-manifest/agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: multi-platform-demo

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

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

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

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: basic-openai-agent

package/examples/ossa-templates/01-code-assistant.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: code-assistant

package/examples/ossa-templates/02-security-scanner.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: security-scanner

package/examples/ossa-templates/03-ci-pipeline.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: ci-pipeline

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

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: code-reviewer

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

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: doc-generator

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

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.1
+apiVersion: ossa/v0.4.5
 kind: Agent
 metadata:
   name: compliance-validator