@bluefly/openstandardagents 0.4.9 → 0.5.0

package/examples/hierarchical-agent.ossa.yaml

@@ -1,31 +1,11 @@
-# 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.7
+apiVersion: ossa/v0.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.
-
+  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
-
+  agentType: custom
   agentArchitecture:
     pattern: hierarchical
     capabilities:
@@ -39,36 +19,24 @@ metadata:
       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
+  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.
+      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
@@ -79,14 +47,9 @@ spec:
       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.
+      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
@@ -97,14 +60,9 @@ spec:
       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.
+      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
@@ -115,11 +73,10 @@ spec:
       contextIsolation: true
       reportTo: parent
       maxTokenBudget: 60000
-
   constraints:
     cost:
       maxTokensPerRequest: 200000
-      maxCostPerDay: 50.00
+      maxCostPerDay: 50
       currency: USD
     performance:
       timeoutSeconds: 120

package/examples/kagent/ossa-kagent-anthropic.ossa.yaml

@@ -1,8 +1,4 @@
-# OSSA kagent export: Anthropic provider with RemoteMCPServer
-# Run: ossa export examples/kagent/ossa-kagent-anthropic.ossa.yaml --platform kagent -o ./anthropic-out
-# Deploy: kubectl apply -f anthropic-out/
-# Or: ossa export examples/kagent/ossa-kagent-anthropic.ossa.yaml --platform kagent --apply
-apiVersion: ossa/v0.4
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: ossa-kagent-anthropic
@@ -36,24 +32,5 @@ extensions:
       resourceLimits:
         cpu: 500m
         memory: 512Mi
-    mcpServers:
-      gitlab-mcp:
-        url: https://your-mcp-server.example.com/api/mcp/sse
-        transport: sse
-        headers:
-          - name: Authorization
-            valueFrom:
-              type: Secret
-              name: gitlab-mcp-token
-              key: token
-      code-analysis:
-        url: http://code-analysis.kagent.svc.cluster.local/sse
-        transport: sse
     a2aConfig:
-      skills:
-        - id: code-review
-          name: Code Review
-          description: Review merge requests for bugs, security issues, and best practices
-          inputModes: [text]
-          outputModes: [text]
-          tags: [code-review, security, gitlab]
+      enabled: true

package/examples/kagent/ossa-kagent-mcp-tools.ossa.yaml

@@ -1,8 +1,4 @@
-# OSSA v1alpha2 export example: Agent with RemoteMCPServer tools and Anthropic provider
-# Run: ossa export examples/kagent/ossa-kagent-mcp-tools.ossa.yaml --platform kagent -o ./mcp-tools-out
-# Deploy: ossa export examples/kagent/ossa-kagent-mcp-tools.ossa.yaml --platform kagent --apply
-# Result: ModelConfig + 2x RemoteMCPServer + Agent applied in APPLY_ORDER
-apiVersion: ossa/v0.4
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: fleet-ops-agent
@@ -40,29 +36,5 @@ extensions:
       resourceLimits:
         cpu: 1000m
         memory: 1Gi
-    mcpServers:
-      kagent-tool-server:
-        url: http://kagent-tool-server.kagent.svc.cluster.local/sse
-        transport: sse
-      # GitLab tools live in agent-protocol (no separate gitlab-mcp-server)
-      agent-protocol-gitlab:
-        url: http://agent-protocol.agent-platform.svc.cluster.local:4005/api/mcp/sse
-        transport: sse
-        headers:
-          - name: Authorization
-            valueFrom:
-              type: Secret
-              name: gitlab-token
-              key: token
     a2aConfig:
-      skills:
-        - id: fleet-management
-          name: Fleet Management
-          description: Manage Kubernetes resources and GitLab repositories across the fleet
-          inputModes: [text]
-          outputModes: [text]
-          tags: [k8s, gitlab, fleet, ossa]
-          examples:
-            - "List all deployments in the kagent namespace"
-            - "Show recent merge requests for agent-buildkit"
-            - "Get logs from the failing pod"
+      enabled: true

package/examples/kagent/ossa-kagent-multi-tool.ossa.yaml

@@ -1,7 +1,4 @@
-# OSSA kagent export: Multi-tool agent with multiple RemoteMCPServers
-# Run: ossa export examples/kagent/ossa-kagent-multi-tool.ossa.yaml --platform kagent -o ./multi-out
-# Deploy: kubectl apply -f multi-out/ (files are in APPLY_ORDER)
-apiVersion: ossa/v0.4
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: ossa-kagent-devops
@@ -40,18 +37,5 @@ extensions:
   kagent:
     kubernetes:
       namespace: kagent
-    mcpServers:
-      gitlab-mcp:
-        url: https://your-mcp-server.example.com/api/mcp/sse
-        transport: sse
-      grafana-mcp:
-        url: http://grafana-mcp.kagent.svc.cluster.local/sse
-        transport: sse
     a2aConfig:
-      skills:
-        - id: devops-automation
-          name: DevOps Automation
-          description: CI/CD management, deployment monitoring, and incident response
-          inputModes: [text]
-          outputModes: [text]
-          tags: [devops, cicd, k8s, monitoring]
+      enabled: true

package/examples/kagent/ossa-kagent-poc.ossa.yaml

@@ -1,8 +1,4 @@
-# OSSA-first POC: one manifest, export to kagent.dev (v1alpha2 Declarative)
-# Run: ossa export examples/kagent/ossa-kagent-poc.ossa.yaml --platform kagent --crd-version v1alpha2 -o ./poc-out
-# Deploy: kubectl apply -f poc-out/model-config.yaml; kubectl apply -f poc-out/agent.yaml
-# Invoke: kagent invoke --agent ossa-kagent-poc --task "List pods in kagent namespace"
-apiVersion: ossa/v0.4
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: ossa-kagent-poc
@@ -33,14 +29,4 @@ extensions:
         cpu: 500m
         memory: 512Mi
     a2aConfig:
-      skills:
-        - id: cluster-inspection
-          name: Cluster Inspection
-          description: List and inspect Kubernetes resources (pods, deployments, services)
-          inputModes: [text]
-          outputModes: [text]
-          tags: [k8s, ossa, poc]
-          examples:
-            - "List all pods in the kagent namespace"
-            - "What API resources are available in the cluster?"
-            - "Describe the kagent-controller deployment"
+      enabled: true

package/examples/pipeline-agent.ossa.yaml

@@ -1,4 +1,4 @@
-# OSSA v0.4.5 Example: Pipeline Agent — Data Processing Pipeline
+# OSSA v0.5.0 Example: Pipeline Agent — Data Processing Pipeline
 #
 # Demonstrates the pipeline pattern for sequential data processing. A
 # coordinator manages four team members arranged as sequential stages:
@@ -13,7 +13,7 @@
 #   - Assigned task coordination (coordinator assigns stage work)
 #   - Database-backed persistence for auditability
 
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5.0
 kind: Agent
 metadata:
   name: data-processing-pipeline
@@ -26,7 +26,7 @@ metadata:
     tools and model.
 
   agentKind: coordinator
-  agentType: workflow
+  agentType: claude
 
   agentArchitecture:
     pattern: pipeline

package/examples/platform-specific/claude-code-subagent.yaml

@@ -4,7 +4,7 @@ metadata:
   name: claude-code-explorer
   version: 1.0.0
   description: Specialized sub-agent for deep code exploration and codebase analysis
-  author: Bluefly Platform
+  author: Agent Platform
   tags:
     - claude-code
     - subagent

package/examples/platform-specific/cursor-coding-agent.yaml

@@ -4,7 +4,7 @@ metadata:
   name: cursor-coding-assistant
   version: 1.0.0
   description: AI coding assistant for Cursor IDE with advanced code generation and refactoring
-  author: Bluefly Platform
+  author: Agent Platform
   tags:
     - cursor
     - coding-assistant

package/examples/platform-specific/warp-terminal-agent.yaml

@@ -4,7 +4,7 @@ metadata:
   name: warp-dev-agent
   version: 1.0.0
   description: Development workflow agent for Warp Terminal
-  author: Bluefly Platform
+  author: Agent Platform
   tags:
     - warp
     - terminal

package/examples/production-ready/01-customer-support-bot/agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: customer-support-bot
@@ -26,19 +26,16 @@ spec:
     - Clear and concise explanations
     - Proactive in offering solutions
     - Transparent about limitations
-
   llm:
     provider: openai
     model: gpt-4o
     temperature: 0.7
     maxTokens: 1500
-
   capabilities:
     - search_documentation
     - create_ticket
     - send_email
     - conversation_memory
-
   tools:
     - type: function
       name: search_docs
@@ -55,7 +52,6 @@ spec:
             default: 5
         required:
           - query
-
     - type: function
       name: create_ticket
       description: Create a support ticket for issues requiring human attention
@@ -70,7 +66,11 @@ spec:
             description: Detailed description of the issue
           priority:
             type: string
-            enum: [low, medium, high, urgent]
+            enum:
+              - low
+              - medium
+              - high
+              - urgent
             description: Priority level of the ticket
           category:
             type: string
@@ -79,7 +79,6 @@ spec:
           - title
           - description
           - priority
-
     - type: function
       name: send_email
       description: Send follow-up email to customer
@@ -98,12 +97,14 @@ spec:
           template:
             type: string
             description: Email template to use
-            enum: [follow_up, resolution, escalation]
+            enum:
+              - follow_up
+              - resolution
+              - escalation
         required:
           - to
           - subject
           - body
-
   autonomy:
     level: supervised
     approval_required: false
@@ -112,7 +113,6 @@ spec:
         action: notify_human
       - condition: ticket_count > 3
         action: escalate
-
   memory:
     enabled: true
     type: conversation_buffer
@@ -121,7 +121,6 @@ spec:
       enabled: true
       backend: redis
       ttl: 86400
-
   safety:
     input_filters:
       - type: pii_detection
@@ -132,8 +131,9 @@ spec:
       - type: hallucination_check
         threshold: 0.8
       - type: tone_analysis
-        required_sentiment: [positive, neutral]
-
+        required_sentiment:
+          - positive
+          - neutral
   observability:
     logging:
       level: info
@@ -150,23 +150,16 @@ spec:
     tracing:
       enabled: true
       provider: opentelemetry
-
 extensions:
   langchain:
-    agent_type: react
-    memory_type: conversation_buffer
-    chain_type: conversation
-    tools_mapping:
-      - ossa_capability: search_documentation
-        langchain_tool: search_docs
-        tool_class: CustomSearchTool
-      - ossa_capability: create_ticket
-        langchain_tool: create_ticket
-        tool_class: TicketingTool
-      - ossa_capability: send_email
-        langchain_tool: send_email
-        tool_class: EmailTool
-    export_config:
-      format: python
-      include_dependencies: true
-      output_file: customer_support_agent.py
+    enabled: true
+    chain_type: agent
+    memory:
+      type: buffer
+    tools:
+      - name: search_docs
+        description: Search the knowledge base for relevant documentation
+      - name: create_ticket
+        description: Create a support ticket for issues requiring human attention
+      - name: send_email
+        description: Send follow-up email to customer

package/examples/production-ready/05-sales-assistant/agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: sales-assistant
@@ -19,20 +19,17 @@ spec:
     - Automated follow-up communication
     - Meeting scheduling and coordination
     - Sales pipeline management
-
   llm:
     provider: openai
     model: gpt-4o
     temperature: 0.7
     maxTokens: 1500
-
   capabilities:
     - search_crm
     - create_lead
     - send_followup
     - schedule_meeting
     - update_pipeline
-
   tools:
     - type: function
       name: search_crm
@@ -51,7 +48,6 @@ spec:
                 type: string
               revenue_range:
                 type: string
-
     - type: function
       name: create_lead
       description: Create new lead in CRM
@@ -73,7 +69,6 @@ spec:
         required:
           - name
           - email
-
     - type: function
       name: send_followup
       description: Send automated follow-up email
@@ -84,13 +79,16 @@ spec:
             type: string
           template:
             type: string
-            enum: [intro, demo_followup, pricing, closing]
+            enum:
+              - intro
+              - demo_followup
+              - pricing
+              - closing
           personalization:
             type: object
         required:
           - leadId
           - template
-
     - type: function
       name: schedule_meeting
       description: Schedule meeting with lead
@@ -101,7 +99,11 @@ spec:
             type: string
           meetingType:
             type: string
-            enum: [discovery, demo, negotiation, closing]
+            enum:
+              - discovery
+              - demo
+              - negotiation
+              - closing
           duration:
             type: integer
           suggestedTimes:
@@ -112,16 +114,23 @@ spec:
         required:
           - leadId
           - meetingType
-
   memory:
     enabled: true
     type: entity_memory
     entities:
       - type: lead
-        fields: [name, company, status, last_contact, notes]
+        fields:
+          - name
+          - company
+          - status
+          - last_contact
+          - notes
       - type: interaction
-        fields: [date, type, summary, outcome]
-
+        fields:
+          - date
+          - type
+          - summary
+          - outcome
   observability:
     logging:
       level: info
@@ -132,15 +141,18 @@ spec:
         - emails_sent
         - meetings_scheduled
         - conversion_rate
-
 extensions:
   langchain:
-    agent_type: react
-    memory_type: entity
-    tools_mapping:
-      - ossa_capability: search_crm
-        langchain_tool: crm_search
-      - ossa_capability: create_lead
-        langchain_tool: create_lead
-      - ossa_capability: send_followup
-        langchain_tool: send_email
+    enabled: true
+    chain_type: agent
+    memory:
+      type: vector
+    tools:
+      - name: search_crm
+        description: Search CRM for contacts and accounts
+      - name: create_lead
+        description: Create new lead in CRM
+      - name: send_followup
+        description: Send automated follow-up email
+      - name: schedule_meeting
+        description: Schedule meeting with lead

package/examples/production-ready/07-research-assistant/agent.ossa.yaml

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.4.7
+apiVersion: ossa/v0.5
 kind: Agent
 metadata:
   name: research-assistant
@@ -19,19 +19,16 @@ spec:
     - Citation management
     - Research question formulation
     - Methodology analysis
-
   llm:
     provider: anthropic
     model: claude-sonnet-4-20250514
     temperature: 0.5
     maxTokens: 4000
-
   capabilities:
     - search_papers
     - summarize_paper
     - generate_citations
     - compare_studies
-
   tools:
     - type: function
       name: search_papers
@@ -45,7 +42,11 @@ spec:
             type: array
             items:
               type: string
-              enum: [pubmed, arxiv, semantic_scholar, google_scholar]
+              enum:
+                - pubmed
+                - arxiv
+                - semantic_scholar
+                - google_scholar
           filters:
             type: object
             properties:
@@ -57,7 +58,6 @@ spec:
                 type: number
         required:
           - query
-
     - type: function
       name: summarize_paper
       description: Generate structured summary of research paper
@@ -68,10 +68,13 @@ spec:
             type: string
           summaryType:
             type: string
-            enum: [abstract, full, methodology, findings]
+            enum:
+              - abstract
+              - full
+              - methodology
+              - findings
         required:
           - paperId
-
     - type: function
       name: generate_citations
       description: Generate citations in various formats
@@ -84,11 +87,14 @@ spec:
               type: string
           format:
             type: string
-            enum: [apa, mla, chicago, bibtex]
+            enum:
+              - apa
+              - mla
+              - chicago
+              - bibtex
         required:
           - papers
           - format
-
   memory:
     enabled: true
     type: summary_memory
@@ -97,7 +103,6 @@ spec:
       summary_prompt: |
         Summarize the key research topics, papers discussed,
         and important findings from this session.
-
   observability:
     logging:
       level: info
@@ -107,13 +112,16 @@ spec:
         - papers_searched
         - summaries_generated
         - citations_created
-
 extensions:
   langchain:
-    agent_type: react
-    memory_type: summary
-    tools_mapping:
-      - ossa_capability: search_papers
-        langchain_tool: academic_search
-      - ossa_capability: summarize_paper
-        langchain_tool: paper_summarizer
+    enabled: true
+    chain_type: agent
+    memory:
+      type: summary
+    tools:
+      - name: search_papers
+        description: Search academic papers and publications
+      - name: summarize_paper
+        description: Generate structured summary of research paper
+      - name: generate_citations
+        description: Generate citations in various formats