@bluefly/openstandardagents 0.2.5-RC → 0.2.8

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

@@ -2,7 +2,7 @@
 # Cost Optimizer Agent
 # Domain: infrastructure.cost.optimization
 
-apiVersion: ossa/v1
+apiVersion: ossa/v0.2.8
 kind: Agent
 metadata:
   name: cost-optimizer

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

@@ -2,7 +2,7 @@
 # Documentation Agent
 # Domain: documentation.generation.automated
 
-apiVersion: ossa/v1
+apiVersion: ossa/v0.2.8
 kind: Agent
 metadata:
   name: documentation-agent

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

@@ -2,6 +2,7 @@
 # Kubernetes Troubleshooter Agent with KAgent Bridge
 # Fully compatible with kagent.dev/v1alpha2
 
+apiVersion: ossa/v0.2.8
 ossaVersion: "1.0"
 
 agent:

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

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

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

@@ -17,7 +17,7 @@
 # Domain: infrastructure.kubernetes.troubleshooting
 # ============================================================================
 
-apiVersion: ossa/v1
+apiVersion: ossa/v0.2.8
 kind: Agent
 metadata:
   # Basic agent identification metadata

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

@@ -6,7 +6,7 @@
 # Last Updated: 2025-11-10
 # ============================================================================
 
-apiVersion: ossa/v1
+apiVersion: ossa/v0.2.8
 kind: Agent
 metadata:
   # Core identity metadata for the security scanning agent

package/examples/langchain/chain-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2",
+  "apiVersion": "ossa/v0.2.8",
   "kind": "Agent",
   "metadata": {
     "name": "langchain-agent",
@@ -17,13 +17,30 @@
       {
         "type": "function",
         "name": "calculator",
-        "capabilities": ["add", "subtract", "multiply", "divide"]
+        "capabilities": [
+          {
+            "name": "add"
+          },
+          {
+            "name": "subtract"
+          },
+          {
+            "name": "multiply"
+          },
+          {
+            "name": "divide"
+          }
+        ]
       },
       {
         "type": "http",
         "name": "web_search",
         "endpoint": "https://api.search.example.com",
-        "capabilities": ["search"]
+        "capabilities": [
+          {
+            "name": "search"
+          }
+        ]
       }
     ]
   },
@@ -38,5 +55,4 @@
       }
     }
   }
-}
-
+}

package/examples/langflow/workflow-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2",
+  "apiVersion": "ossa/v0.2.8",
   "kind": "Agent",
   "metadata": {
     "name": "workflow-orchestrator",
@@ -35,5 +35,4 @@
       ]
     }
   }
-}
-
+}

package/examples/langgraph/state-machine-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2",
+  "apiVersion": "ossa/v0.2.8",
   "kind": "Agent",
   "metadata": {
     "name": "state-machine-agent",
@@ -55,5 +55,4 @@
       }
     }
   }
-}
-
+}

package/examples/llamaindex/rag-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2",
+  "apiVersion": "ossa/v0.2.8",
   "kind": "Agent",
   "metadata": {
     "name": "rag-query-agent",
@@ -37,5 +37,4 @@
       }
     }
   }
-}
-
+}

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

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

package/examples/multi-agent/README.md

@@ -0,0 +1,74 @@
+# Multi-Agent Examples
+
+Examples demonstrating different multi-agent patterns using OSSA.
+
+## Patterns
+
+### 1. Sequential Pipeline (`sequential-pipeline.ossa.yaml`)
+
+**Pattern**: Chain of agents processing data sequentially
+
+```
+Input → Researcher → Analyzer → Writer → Output
+```
+
+**Use Cases**:
+- Research and report generation
+- Data processing pipelines
+- Content creation workflows
+
+### 2. Parallel Execution (`parallel-execution.ossa.yaml`)
+
+**Pattern**: Fan-out to multiple agents, then fan-in to aggregate
+
+```
+        ┌─ Agent A ─┐
+Input ──┼─ Agent B ─┼─→ Aggregator → Output
+        └─ Agent C ─┘
+```
+
+**Use Cases**:
+- Parallel data processing
+- Multiple perspective analysis
+- Distributed task execution
+
+### 3. Conditional Router (`conditional-router.ossa.yaml`)
+
+**Pattern**: Router analyzes input and routes to specialist
+
+```
+                ┌─ Code Specialist
+Input → Router ─┼─ Data Specialist
+                └─ General Assistant
+```
+
+**Use Cases**:
+- Question routing
+- Skill-based delegation
+- Dynamic agent selection
+
+## Running Examples
+
+```bash
+# Validate examples
+ossa validate examples/multi-agent/*.yaml
+
+# Run sequential pipeline
+ossa run examples/multi-agent/sequential-pipeline.ossa.yaml
+
+# Run parallel execution
+ossa run examples/multi-agent/parallel-execution.ossa.yaml
+
+# Run conditional router
+ossa run examples/multi-agent/conditional-router.ossa.yaml
+```
+
+## Implementation Notes
+
+These examples show the OSSA manifest structure. Actual multi-agent orchestration requires:
+- Runtime that supports tool calling
+- Agent registry/discovery mechanism
+- Communication protocol between agents
+- State management
+
+See [Agent Buildkit](https://github.com/blueflyio/agent-buildkit) for production multi-agent orchestration.

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

@@ -0,0 +1,42 @@
+apiVersion: ossa/v0.2.8
+kind: Agent
+metadata:
+  name: conditional-router
+  version: "1.0.0"
+  description: Router agent that conditionally routes to specialist agents
+spec:
+  role: Router that analyzes requests and routes to appropriate specialist
+  llm:
+    provider: openai
+    model: gpt-4o-mini
+  
+  tools:
+    - type: function
+      name: route_to_code_specialist
+      description: Route coding questions to code specialist agent
+      parameters:
+        type: object
+        properties:
+          question:
+            type: string
+        required: [question]
+    
+    - type: function
+      name: route_to_data_specialist
+      description: Route data questions to data specialist agent
+      parameters:
+        type: object
+        properties:
+          question:
+            type: string
+        required: [question]
+    
+    - type: function
+      name: route_to_general_assistant
+      description: Route general questions to general assistant
+      parameters:
+        type: object
+        properties:
+          question:
+            type: string
+        required: [question]

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

@@ -0,0 +1,54 @@
+apiVersion: ossa/v0.2.8
+kind: Agent
+metadata:
+  name: parallel-executor
+  version: "1.0.0"
+  description: Parallel execution with fan-out/fan-in pattern
+spec:
+  role: Orchestrator for parallel task execution
+  llm:
+    provider: openai
+    model: gpt-4o-mini
+  
+  tools:
+    - type: function
+      name: call_agent_a
+      description: Execute task on agent A (runs in parallel)
+      parameters:
+        type: object
+        properties:
+          task:
+            type: string
+        required: [task]
+    
+    - type: function
+      name: call_agent_b
+      description: Execute task on agent B (runs in parallel)
+      parameters:
+        type: object
+        properties:
+          task:
+            type: string
+        required: [task]
+    
+    - type: function
+      name: call_agent_c
+      description: Execute task on agent C (runs in parallel)
+      parameters:
+        type: object
+        properties:
+          task:
+            type: string
+        required: [task]
+    
+    - type: function
+      name: aggregate_results
+      description: Combine results from all parallel agents
+      parameters:
+        type: object
+        properties:
+          results:
+            type: array
+            items:
+              type: string
+        required: [results]

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

@@ -0,0 +1,45 @@
+apiVersion: ossa/v0.2.8
+kind: Agent
+metadata:
+  name: sequential-pipeline
+  version: "1.0.0"
+  description: Sequential pipeline with 3 agents processing data in chain
+spec:
+  role: Orchestrator for sequential data processing pipeline
+  llm:
+    provider: openai
+    model: gpt-4o-mini
+  
+  tools:
+    - type: function
+      name: call_researcher
+      description: Call the researcher agent to gather information
+      parameters:
+        type: object
+        properties:
+          query:
+            type: string
+            description: Research query
+        required: [query]
+    
+    - type: function
+      name: call_analyzer
+      description: Call the analyzer agent to process research results
+      parameters:
+        type: object
+        properties:
+          data:
+            type: string
+            description: Data to analyze
+        required: [data]
+    
+    - type: function
+      name: call_writer
+      description: Call the writer agent to create final output
+      parameters:
+        type: object
+        properties:
+          analysis:
+            type: string
+            description: Analysis to write about
+        required: [analysis]

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

@@ -1,4 +1,4 @@
-apiVersion: ossa/v0.2.4
+apiVersion: ossa/v0.2.8
 kind: Agent
 
 metadata:

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

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2.4",
+  "apiVersion": "ossa/v0.2.8",
   "kind": "Agent",
   "metadata": {
     "name": "multi-tool-agent",
@@ -37,7 +37,9 @@
                 "default": 5
               }
             },
-            "required": ["query"]
+            "required": [
+              "query"
+            ]
           }
         },
         {
@@ -52,7 +54,9 @@
                 "description": "Mathematical expression to evaluate (e.g., '2 + 2', 'sqrt(16)', 'sin(pi/2)')"
               }
             },
-            "required": ["expression"]
+            "required": [
+              "expression"
+            ]
           }
         },
         {
@@ -68,7 +72,11 @@
               },
               "units": {
                 "type": "string",
-                "enum": ["celsius", "fahrenheit", "kelvin"],
+                "enum": [
+                  "celsius",
+                  "fahrenheit",
+                  "kelvin"
+                ],
                 "description": "Temperature units",
                 "default": "celsius"
               },
@@ -78,7 +86,9 @@
                 "default": false
               }
             },
-            "required": ["location"]
+            "required": [
+              "location"
+            ]
           }
         },
         {
@@ -102,7 +112,10 @@
                 "description": "Target language code (e.g., 'en', 'es', 'fr')"
               }
             },
-            "required": ["text", "target_language"]
+            "required": [
+              "text",
+              "target_language"
+            ]
           }
         },
         {
@@ -125,7 +138,11 @@
                 "description": "Target unit (e.g., 'meters', 'feet', 'celsius', 'pounds')"
               }
             },
-            "required": ["value", "from_unit", "to_unit"]
+            "required": [
+              "value",
+              "from_unit",
+              "to_unit"
+            ]
           }
         },
         {
@@ -141,12 +158,18 @@
               },
               "format": {
                 "type": "string",
-                "enum": ["12h", "24h", "iso"],
+                "enum": [
+                  "12h",
+                  "24h",
+                  "iso"
+                ],
                 "description": "Time format",
                 "default": "12h"
               }
             },
-            "required": ["timezone"]
+            "required": [
+              "timezone"
+            ]
           }
         }
       ],
@@ -162,4 +185,4 @@
       }
     }
   }
-}
+}

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

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2",
+  "apiVersion": "ossa/v0.2.8",
   "kind": "Agent",
   "metadata": {
     "name": "swarm-agent",
@@ -17,12 +17,26 @@
       {
         "type": "function",
         "name": "search_web",
-        "capabilities": ["search", "retrieve"]
+        "capabilities": [
+          {
+            "name": "search"
+          },
+          {
+            "name": "retrieve"
+          }
+        ]
       },
       {
         "type": "function",
         "name": "execute_code",
-        "capabilities": ["run", "evaluate"]
+        "capabilities": [
+          {
+            "name": "run"
+          },
+          {
+            "name": "evaluate"
+          }
+        ]
       }
     ]
   },
@@ -55,5 +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/v1
+apiVersion: ossa/v0.2.8
 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.2
+apiVersion: ossa/v0.2.8
 kind: Agent
 
 metadata:

package/examples/spec-examples/audit-agent.yml

@@ -139,7 +139,7 @@ agent:
   # Metadata
   metadata:
     author: OSSA Security Team
-    maintainer: security@ossa.io
+    maintainer: ops@openstandardagents.org
     license: Apache-2.0
     keywords:
       - security

package/examples/spec-examples/chat-agent.yml

@@ -177,7 +177,7 @@ agent:
   # Metadata
   metadata:
     author: OSSA Chat Team
-    maintainer: chat@ossa.io
+    maintainer: ops@openstandardagents.org
     homepage: https://ossa.io/agents/customer-support-chat
     repository: https://github.com/ossa-agents/chat-agent
     documentation: https://docs.ossa.io/agents/chat

package/examples/spec-examples/compliance-agent.yml

@@ -191,7 +191,7 @@ agent:
   # Metadata
   metadata:
     author: OSSA Standards Team
-    maintainer: compliance@ossa.io
+    maintainer: ops@openstandardagents.org
     homepage: https://ossa.io/agents/compliance-scanner
     repository: https://github.com/ossa-agents/compliance-scanner
     documentation: https://docs.ossa.io/agents/compliance-scanner

package/examples/spec-examples/monitoring-agent.yml

@@ -122,7 +122,7 @@ agent:
   # Metadata
   metadata:
     author: OSSA Monitoring Team
-    maintainer: monitoring@ossa.io
+    maintainer: ops@openstandardagents.org
     license: MIT
     keywords:
       - monitoring

package/examples/spec-examples/workflow-agent.yml

@@ -209,7 +209,7 @@ agent:
   # Metadata
   metadata:
     author: OSSA Workflow Team
-    maintainer: workflows@ossa.io
+    maintainer: ops@openstandardagents.org
     homepage: https://ossa.io/agents/workflow-orchestrator
     repository: https://github.com/ossa-agents/workflow-orchestrator
     documentation: https://docs.ossa.io/agents/workflow-orchestrator

package/examples/templates/ossa-compliance.yaml

@@ -1,6 +1,6 @@
 # OSSA v0.1.9 Compliance Configuration for __ARCHIVE_REPORTS
 
-apiVersion: 'open-standards-scalable-agents/v0.1.9'
+apiVersion: ossa/v0.2.8
 kind: 'ComplianceConfiguration'
 metadata:
   name: '__ARCHIVE_REPORTS-compliance'

package/examples/vercel/edge-agent.ossa.json

@@ -1,5 +1,5 @@
 {
-  "apiVersion": "ossa/v0.2",
+  "apiVersion": "ossa/v0.2.8",
   "kind": "Agent",
   "metadata": {
     "name": "edge-chat-agent",
@@ -33,11 +33,12 @@
                 "description": "City name"
               }
             },
-            "required": ["location"]
+            "required": [
+              "location"
+            ]
           }
         }
       ]
     }
   }
-}
-
+}