@bluefly/openstandardagents 0.4.9 → 0.5.0

package/openapi/reference-implementations/judge-agent-api.openapi.yaml

@@ -5,7 +5,9 @@ info:
   description: |
     Ultimate decision-making agent for conflict resolution and final arbitration.
     Makes decisions, resolves disputes, and prioritizes requests.
-
+  contact:
+    name: Bluefly OSSA Team
+    url: https://gitlab.com/blueflyio/ossa/openstandardagents
 x-ossa-metadata:
   version: 0.2.5-RC
   compliance:
@@ -16,37 +18,38 @@ x-ossa-metadata:
   governance:
     approved: true
     approvedBy: Architecture Council
-    approvalDate: "2024-01-15"
-
+    approvalDate: 2024-01-15
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
 x-ossa:
   version: 0.2.5-RC
   agent:
-    id: decision-arbitration-judge
+    id: reference-implementations-judge-agent-api
     type: judge
     compliance:
       standards:
         - openapi-first
         - type-safe
       validated: true
-      validatedAt: "2024-01-15T10:00:00Z"
-
+      validatedAt: 2024-01-15T10:00:00Z
 servers:
   - url: https://judge.platform.com/api/v1
     description: Production
-
 tags:
   - name: arbitration
     description: Arbitration operations
   - name: decisions
     description: Decision-making operations
-
 paths:
   /arbitrate:
     post:
       summary: Arbitrate conflict
       description: Resolve conflicts between agents or requests using consensus algorithm
       operationId: arbitrateConflict
-      tags: [arbitration]
+      tags:
+        - arbitration
       x-ossa-capability: arbitrate-conflicts
       x-ossa-autonomy:
         level: supervised
@@ -61,7 +64,9 @@ paths:
           application/json:
             schema:
               type: object
-              required: [conflict, participants]
+              required:
+                - conflict
+                - participants
               properties:
                 conflict:
                   type: object
@@ -85,7 +90,7 @@ paths:
                     risk_assessment:
                       type: number
       responses:
-        '200':
+        "200":
           description: Arbitration completed
           content:
             application/json:
@@ -102,13 +107,13 @@ paths:
                     type: array
                     items:
                       type: object
-
   /decide:
     post:
       summary: Make decision
       description: Make a decision based on weighted criteria and priorities
       operationId: makeDecision
-      tags: [decisions]
+      tags:
+        - decisions
       x-ossa-capability: make-decisions
       x-ossa-autonomy:
         level: supervised
@@ -119,7 +124,9 @@ paths:
           application/json:
             schema:
               type: object
-              required: [options, criteria]
+              required:
+                - options
+                - criteria
               properties:
                 options:
                   type: array
@@ -130,7 +137,7 @@ paths:
                 weights:
                   type: object
       responses:
-        '200':
+        "200":
           description: Decision made
           content:
             application/json:
@@ -145,4 +152,3 @@ paths:
                     type: string
                   confidence:
                     type: number
-

package/openapi/reference-implementations/k8s-troubleshooter-api.openapi.yaml

@@ -5,7 +5,9 @@ info:
   description: |
     Autonomous Kubernetes cluster troubleshooting agent with diagnostic capabilities.
     Diagnoses pod failures, network issues, resource constraints, and configuration problems.
-
+  contact:
+    name: Bluefly OSSA Team
+    url: https://gitlab.com/blueflyio/ossa/openstandardagents
 x-ossa-metadata:
   version: 0.2.5-RC
   compliance:
@@ -13,25 +15,26 @@ x-ossa-metadata:
     frameworks:
       - OSSA
       - OpenAPI 3.1
-
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
 x-ossa:
   version: 0.2.5-RC
   agent:
-    id: k8s-troubleshooter
-    type: worker
+    id: reference-implementations-k8s-troubleshooter-api
+    type: specialist
     compliance:
       standards:
         - openapi-first
         - type-safe
       validated: true
-      validatedAt: "2024-01-15T10:00:00Z"
-
+      validatedAt: 2024-01-15T10:00:00Z
 servers:
   - url: https://troubleshooter.platform.com/api/v1
     description: Production
   - url: http://k8s-troubleshooter:3000/api/v1
     description: Kubernetes internal
-
 tags:
   - name: diagnostics
     description: Diagnostic operations
@@ -39,7 +42,6 @@ tags:
     description: Pod operations
   - name: cluster
     description: Cluster operations
-
 paths:
   /diagnose/pod:
     post:
@@ -48,7 +50,9 @@ paths:
         Analyzes a Kubernetes pod to identify failures, configuration issues,
         and resource constraints. Uses MCP tools to gather pod logs, events, and metrics.
       operationId: diagnosePod
-      tags: [diagnostics, pods]
+      tags:
+        - diagnostics
+        - pods
       x-ossa-capability: pod-diagnostics
       x-ossa-autonomy:
         level: supervised
@@ -81,7 +85,9 @@ paths:
           application/json:
             schema:
               type: object
-              required: [pod_name, namespace]
+              required:
+                - pod_name
+                - namespace
               properties:
                 pod_name:
                   type: string
@@ -95,7 +101,7 @@ paths:
                   default: true
                   description: Whether to include pod logs in diagnosis
       responses:
-        '200':
+        "200":
           description: Diagnosis completed
           content:
             application/json:
@@ -104,7 +110,10 @@ paths:
                 properties:
                   status:
                     type: string
-                    enum: [healthy, degraded, failed]
+                    enum:
+                      - healthy
+                      - degraded
+                      - failed
                   issues:
                     type: array
                     items:
@@ -112,7 +121,10 @@ paths:
                       properties:
                         severity:
                           type: string
-                          enum: [critical, warning, info]
+                          enum:
+                            - critical
+                            - warning
+                            - info
                         message:
                           type: string
                         resource:
@@ -129,19 +141,19 @@ paths:
                         format: date-time
                       execution_time_ms:
                         type: integer
-
   /cluster/health:
     get:
       summary: Check cluster health
       description: Perform comprehensive cluster health check
       operationId: checkClusterHealth
-      tags: [cluster]
+      tags:
+        - cluster
       x-ossa-capability: cluster-diagnostics
       x-ossa-autonomy:
         level: autonomous
         approval_required: false
       responses:
-        '200':
+        "200":
           description: Cluster health status
           content:
             application/json:
@@ -150,7 +162,10 @@ paths:
                 properties:
                   status:
                     type: string
-                    enum: [healthy, degraded, unhealthy]
+                    enum:
+                      - healthy
+                      - degraded
+                      - unhealthy
                   nodes:
                     type: array
                     items:
@@ -164,4 +179,3 @@ paths:
                           type: array
                           items:
                             type: string
-

package/openapi/reference-implementations/langchain-agent-api.openapi.yaml

@@ -5,7 +5,9 @@ info:
   description: |
     LangChain agent with tool chain integration.
     Uses tools to accomplish tasks with memory and chain capabilities.
-
+  contact:
+    name: Bluefly OSSA Team
+    url: https://gitlab.com/blueflyio/ossa/openstandardagents
 x-ossa-metadata:
   version: 0.2.5-RC
   compliance:
@@ -14,35 +16,36 @@ x-ossa-metadata:
       - OSSA
       - OpenAPI 3.1
       - LangChain
-
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
 x-ossa:
   version: 0.2.5-RC
   agent:
-    id: langchain-agent
-    type: worker
+    id: reference-implementations-langchain-agent-api
+    type: specialist
     compliance:
       standards:
         - openapi-first
       validated: true
-      validatedAt: "2024-01-15T10:00:00Z"
-
+      validatedAt: 2024-01-15T10:00:00Z
 servers:
   - url: http://localhost:3000
     description: Local development
-
 tags:
   - name: tasks
     description: Task execution operations
   - name: tools
     description: Tool operations
-
 paths:
   /execute:
     post:
       summary: Execute task with tools
       description: Execute a task using LangChain agent with available tools
       operationId: executeTask
-      tags: [tasks]
+      tags:
+        - tasks
       x-ossa-capability: execute_task
       x-ossa-autonomy:
         level: autonomous
@@ -57,7 +60,8 @@ paths:
           application/json:
             schema:
               type: object
-              required: [task]
+              required:
+                - task
               properties:
                 task:
                   type: string
@@ -71,7 +75,7 @@ paths:
                   type: object
                   description: Additional context
       responses:
-        '200':
+        "200":
           description: Task executed
           content:
             application/json:
@@ -91,13 +95,13 @@ paths:
                           type: string
                   memory:
                     type: object
-
   /tools/calculator:
     post:
       summary: Calculator tool
       description: Perform mathematical calculations
       operationId: calculator
-      tags: [tools]
+      tags:
+        - tools
       x-ossa-capability: calculator
       x-ossa-autonomy:
         level: autonomous
@@ -108,17 +112,24 @@ paths:
           application/json:
             schema:
               type: object
-              required: [operation, a, b]
+              required:
+                - operation
+                - a
+                - b
               properties:
                 operation:
                   type: string
-                  enum: [add, subtract, multiply, divide]
+                  enum:
+                    - add
+                    - subtract
+                    - multiply
+                    - divide
                 a:
                   type: number
                 b:
                   type: number
       responses:
-        '200':
+        "200":
           description: Calculation result
           content:
             application/json:
@@ -127,13 +138,13 @@ paths:
                 properties:
                   result:
                     type: number
-
   /tools/search:
     post:
       summary: Web search tool
       description: Search the web for information
       operationId: webSearch
-      tags: [tools]
+      tags:
+        - tools
       x-ossa-capability: web_search
       x-ossa-autonomy:
         level: autonomous
@@ -144,13 +155,14 @@ paths:
           application/json:
             schema:
               type: object
-              required: [query]
+              required:
+                - query
               properties:
                 query:
                   type: string
                   description: Search query
       responses:
-        '200':
+        "200":
           description: Search results
           content:
             application/json:
@@ -168,4 +180,3 @@ paths:
                           type: string
                         snippet:
                           type: string
-

package/openapi/reference-implementations/monitor-agent-api.openapi.yaml

@@ -5,7 +5,9 @@ info:
   description: |
     Real-time monitoring agent for system health, performance, and resource utilization.
     Collects metrics, detects anomalies, and generates alerts.
-
+  contact:
+    name: Bluefly OSSA Team
+    url: https://gitlab.com/blueflyio/ossa/openstandardagents
 x-ossa-metadata:
   version: 0.2.5-RC
   compliance:
@@ -13,23 +15,24 @@ x-ossa-metadata:
     frameworks:
       - OSSA
       - OpenAPI 3.1
-
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
 x-ossa:
   version: 0.2.5-RC
   agent:
-    id: system-performance-monitor
+    id: reference-implementations-monitor-agent-api
     type: monitor
     compliance:
       standards:
         - openapi-first
         - type-safe
       validated: true
-      validatedAt: "2024-01-15T10:00:00Z"
-
+      validatedAt: 2024-01-15T10:00:00Z
 servers:
   - url: https://monitor.platform.com/api/v1
     description: Production
-
 tags:
   - name: metrics
     description: Metrics collection operations
@@ -37,14 +40,14 @@ tags:
     description: Health check operations
   - name: alerts
     description: Alerting operations
-
 paths:
   /metrics/collect:
     post:
       summary: Collect metrics
       description: Collect system metrics from specified sources
       operationId: collectMetrics
-      tags: [metrics]
+      tags:
+        - metrics
       x-ossa-capability: collect-metrics
       x-ossa-autonomy:
         level: autonomous
@@ -55,7 +58,8 @@ paths:
           application/json:
             schema:
               type: object
-              required: [sources]
+              required:
+                - sources
               properties:
                 sources:
                   type: array
@@ -66,7 +70,7 @@ paths:
                   items:
                     type: string
       responses:
-        '200':
+        "200":
           description: Metrics collected
           content:
             application/json:
@@ -87,13 +91,13 @@ paths:
                           format: date-time
                         labels:
                           type: object
-
   /health/check:
     get:
       summary: Check system health
       description: Perform health check on system components
       operationId: checkHealth
-      tags: [health]
+      tags:
+        - health
       x-ossa-capability: check-health
       x-ossa-autonomy:
         level: autonomous
@@ -105,7 +109,7 @@ paths:
             type: string
           description: Specific component to check
       responses:
-        '200':
+        "200":
           description: Health status
           content:
             application/json:
@@ -114,7 +118,10 @@ paths:
                 properties:
                   status:
                     type: string
-                    enum: [healthy, degraded, unhealthy]
+                    enum:
+                      - healthy
+                      - degraded
+                      - unhealthy
                   components:
                     type: array
                     items:
@@ -127,13 +134,13 @@ paths:
                         last_check:
                           type: string
                           format: date-time
-
   /alerts/generate:
     post:
       summary: Generate alert
       description: Generate alert based on threshold violations or anomalies
       operationId: generateAlert
-      tags: [alerts]
+      tags:
+        - alerts
       x-ossa-capability: generate-alerts
       x-ossa-autonomy:
         level: autonomous
@@ -144,11 +151,16 @@ paths:
           application/json:
             schema:
               type: object
-              required: [severity, message]
+              required:
+                - severity
+                - message
               properties:
                 severity:
                   type: string
-                  enum: [critical, warning, info]
+                  enum:
+                    - critical
+                    - warning
+                    - info
                 message:
                   type: string
                 metric:
@@ -156,7 +168,7 @@ paths:
                 threshold:
                   type: object
       responses:
-        '200':
+        "200":
           description: Alert generated
           content:
             application/json:
@@ -167,5 +179,6 @@ paths:
                     type: string
                   status:
                     type: string
-                    enum: [fired, resolved]
-
+                    enum:
+                      - fired
+                      - resolved