@bluefly/openstandardagents 0.2.4 → 0.2.7

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

@@ -0,0 +1,167 @@
+openapi: 3.1.0
+info:
+  title: Kubernetes Troubleshooter Agent API
+  version: 1.0.0
+  description: |
+    Autonomous Kubernetes cluster troubleshooting agent with diagnostic capabilities.
+    Diagnoses pod failures, network issues, resource constraints, and configuration problems.
+
+x-ossa-metadata:
+  version: 0.2.5-RC
+  compliance:
+    level: intermediate
+    frameworks:
+      - OSSA
+      - OpenAPI 3.1
+
+x-ossa:
+  version: 0.2.5-RC
+  agent:
+    id: k8s-troubleshooter
+    type: worker
+    compliance:
+      standards:
+        - openapi-first
+        - type-safe
+      validated: true
+      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
+  - name: pods
+    description: Pod operations
+  - name: cluster
+    description: Cluster operations
+
+paths:
+  /diagnose/pod:
+    post:
+      summary: Diagnose pod issues
+      description: |
+        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]
+      x-ossa-capability: pod-diagnostics
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+        allowed_actions:
+          - read_pods
+          - read_logs
+          - read_events
+          - read_metrics
+        blocked_actions:
+          - delete_pods
+          - scale_deployments
+          - modify_configs
+      x-ossa-tools:
+        - type: mcp
+          server: kubernetes-mcp
+          capabilities:
+            - get_pods
+            - get_logs
+            - get_events
+            - describe_resource
+            - get_metrics
+      x-ossa-llm:
+        provider: openai
+        model: gpt-4
+        temperature: 0.2
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [pod_name, namespace]
+              properties:
+                pod_name:
+                  type: string
+                  description: Name of the pod to diagnose
+                namespace:
+                  type: string
+                  description: Kubernetes namespace
+                  default: default
+                include_logs:
+                  type: boolean
+                  default: true
+                  description: Whether to include pod logs in diagnosis
+      responses:
+        '200':
+          description: Diagnosis completed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status:
+                    type: string
+                    enum: [healthy, degraded, failed]
+                  issues:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        severity:
+                          type: string
+                          enum: [critical, warning, info]
+                        message:
+                          type: string
+                        resource:
+                          type: string
+                  recommendations:
+                    type: array
+                    items:
+                      type: string
+                  metadata:
+                    type: object
+                    properties:
+                      diagnosed_at:
+                        type: string
+                        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]
+      x-ossa-capability: cluster-diagnostics
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      responses:
+        '200':
+          description: Cluster health status
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status:
+                    type: string
+                    enum: [healthy, degraded, unhealthy]
+                  nodes:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        name:
+                          type: string
+                        status:
+                          type: string
+                        issues:
+                          type: array
+                          items:
+                            type: string
+

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

@@ -0,0 +1,171 @@
+openapi: 3.1.0
+info:
+  title: LangChain Agent API
+  version: 1.0.0
+  description: |
+    LangChain agent with tool chain integration.
+    Uses tools to accomplish tasks with memory and chain capabilities.
+
+x-ossa-metadata:
+  version: 0.2.5-RC
+  compliance:
+    level: basic
+    frameworks:
+      - OSSA
+      - OpenAPI 3.1
+      - LangChain
+
+x-ossa:
+  version: 0.2.5-RC
+  agent:
+    id: langchain-agent
+    type: worker
+    compliance:
+      standards:
+        - openapi-first
+      validated: true
+      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]
+      x-ossa-capability: execute_task
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      x-ossa-llm:
+        provider: openai
+        model: gpt-4
+        temperature: 0.5
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [task]
+              properties:
+                task:
+                  type: string
+                  description: Task description
+                tools:
+                  type: array
+                  items:
+                    type: string
+                  description: Tools to use for task
+                context:
+                  type: object
+                  description: Additional context
+      responses:
+        '200':
+          description: Task executed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  result:
+                    type: string
+                  steps:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        tool:
+                          type: string
+                        result:
+                          type: string
+                  memory:
+                    type: object
+
+  /tools/calculator:
+    post:
+      summary: Calculator tool
+      description: Perform mathematical calculations
+      operationId: calculator
+      tags: [tools]
+      x-ossa-capability: calculator
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [operation, a, b]
+              properties:
+                operation:
+                  type: string
+                  enum: [add, subtract, multiply, divide]
+                a:
+                  type: number
+                b:
+                  type: number
+      responses:
+        '200':
+          description: Calculation result
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  result:
+                    type: number
+
+  /tools/search:
+    post:
+      summary: Web search tool
+      description: Search the web for information
+      operationId: webSearch
+      tags: [tools]
+      x-ossa-capability: web_search
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [query]
+              properties:
+                query:
+                  type: string
+                  description: Search query
+      responses:
+        '200':
+          description: Search results
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  results:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        title:
+                          type: string
+                        url:
+                          type: string
+                        snippet:
+                          type: string
+

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

@@ -0,0 +1,171 @@
+openapi: 3.1.0
+info:
+  title: System Performance Monitor Agent API
+  version: 1.3.0
+  description: |
+    Real-time monitoring agent for system health, performance, and resource utilization.
+    Collects metrics, detects anomalies, and generates alerts.
+
+x-ossa-metadata:
+  version: 0.2.5-RC
+  compliance:
+    level: intermediate
+    frameworks:
+      - OSSA
+      - OpenAPI 3.1
+
+x-ossa:
+  version: 0.2.5-RC
+  agent:
+    id: system-performance-monitor
+    type: monitor
+    compliance:
+      standards:
+        - openapi-first
+        - type-safe
+      validated: true
+      validatedAt: "2024-01-15T10:00:00Z"
+
+servers:
+  - url: https://monitor.platform.com/api/v1
+    description: Production
+
+tags:
+  - name: metrics
+    description: Metrics collection operations
+  - name: health
+    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]
+      x-ossa-capability: collect-metrics
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [sources]
+              properties:
+                sources:
+                  type: array
+                  items:
+                    type: string
+                metrics:
+                  type: array
+                  items:
+                    type: string
+      responses:
+        '200':
+          description: Metrics collected
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  metrics:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        name:
+                          type: string
+                        value:
+                          type: number
+                        timestamp:
+                          type: string
+                          format: date-time
+                        labels:
+                          type: object
+
+  /health/check:
+    get:
+      summary: Check system health
+      description: Perform health check on system components
+      operationId: checkHealth
+      tags: [health]
+      x-ossa-capability: check-health
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      parameters:
+        - name: component
+          in: query
+          schema:
+            type: string
+          description: Specific component to check
+      responses:
+        '200':
+          description: Health status
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status:
+                    type: string
+                    enum: [healthy, degraded, unhealthy]
+                  components:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        name:
+                          type: string
+                        status:
+                          type: string
+                        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]
+      x-ossa-capability: generate-alerts
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [severity, message]
+              properties:
+                severity:
+                  type: string
+                  enum: [critical, warning, info]
+                message:
+                  type: string
+                metric:
+                  type: string
+                threshold:
+                  type: object
+      responses:
+        '200':
+          description: Alert generated
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  alert_id:
+                    type: string
+                  status:
+                    type: string
+                    enum: [fired, resolved]
+