@bluefly/openstandardagents 0.2.4 → 0.2.5-RC

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

@@ -0,0 +1,165 @@
+openapi: 3.1.0
+info:
+  title: Multi-System Integrator Agent API
+  version: 1.4.0
+  description: |
+    Enterprise integration agent for connecting heterogeneous systems and APIs.
+    Transforms protocols, maps schemas, and routes messages between systems.
+
+x-ossa-metadata:
+  version: 0.2.5-RC
+  compliance:
+    level: enterprise
+    frameworks:
+      - OSSA
+      - OpenAPI 3.1
+
+x-ossa:
+  version: 0.2.5-RC
+  agent:
+    id: multi-system-integrator
+    type: integrator
+    compliance:
+      standards:
+        - openapi-first
+        - type-safe
+      validated: true
+      validatedAt: "2024-01-15T10:00:00Z"
+
+servers:
+  - url: https://integrator.platform.com/api/v1
+    description: Production
+
+tags:
+  - name: integration
+    description: System integration operations
+  - name: transformation
+    description: Data transformation operations
+  - name: routing
+    description: Message routing operations
+
+paths:
+  /integrate/connect:
+    post:
+      summary: Connect systems
+      description: Establish connection between two or more systems
+      operationId: connectSystems
+      tags: [integration]
+      x-ossa-capability: connect-systems
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [systems]
+              properties:
+                systems:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      system_id:
+                        type: string
+                      protocol:
+                        type: string
+                      endpoint:
+                        type: string
+                mapping:
+                  type: object
+                  description: Schema mapping configuration
+      responses:
+        '200':
+          description: Systems connected
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  connection_id:
+                    type: string
+                  status:
+                    type: string
+                    enum: [connected, failed]
+
+  /transform:
+    post:
+      summary: Transform data
+      description: Transform data between different formats and schemas
+      operationId: transformData
+      tags: [transformation]
+      x-ossa-capability: map-schemas
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [data, from_format, to_format]
+              properties:
+                data:
+                  type: object
+                from_format:
+                  type: string
+                to_format:
+                  type: string
+                mapping:
+                  type: object
+      responses:
+        '200':
+          description: Data transformed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  transformed:
+                    type: object
+                  metadata:
+                    type: object
+
+  /route:
+    post:
+      summary: Route message
+      description: Route message to appropriate system based on routing rules
+      operationId: routeMessage
+      tags: [routing]
+      x-ossa-capability: route-messages
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [message, destination]
+              properties:
+                message:
+                  type: object
+                destination:
+                  type: string
+                routing_rules:
+                  type: object
+      responses:
+        '200':
+          description: Message routed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  routed:
+                    type: boolean
+                  destination:
+                    type: string
+                  status:
+                    type: string
+

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

@@ -0,0 +1,148 @@
+openapi: 3.1.0
+info:
+  title: Decision Arbitration Judge Agent API
+  version: 1.0.0
+  description: |
+    Ultimate decision-making agent for conflict resolution and final arbitration.
+    Makes decisions, resolves disputes, and prioritizes requests.
+
+x-ossa-metadata:
+  version: 0.2.5-RC
+  compliance:
+    level: enterprise
+    frameworks:
+      - OSSA
+      - OpenAPI 3.1
+  governance:
+    approved: true
+    approvedBy: Architecture Council
+    approvalDate: "2024-01-15"
+
+x-ossa:
+  version: 0.2.5-RC
+  agent:
+    id: decision-arbitration-judge
+    type: judge
+    compliance:
+      standards:
+        - openapi-first
+        - type-safe
+      validated: true
+      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]
+      x-ossa-capability: arbitrate-conflicts
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      x-ossa-llm:
+        provider: openai
+        model: gpt-4
+        temperature: 0.1
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [conflict, participants]
+              properties:
+                conflict:
+                  type: object
+                  description: Conflict description
+                participants:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      agent_id:
+                        type: string
+                      position:
+                        type: object
+                criteria:
+                  type: object
+                  properties:
+                    business_value:
+                      type: number
+                    technical_feasibility:
+                      type: number
+                    risk_assessment:
+                      type: number
+      responses:
+        '200':
+          description: Arbitration completed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  decision:
+                    type: object
+                  resolution:
+                    type: string
+                  consensus_score:
+                    type: number
+                  participants:
+                    type: array
+                    items:
+                      type: object
+
+  /decide:
+    post:
+      summary: Make decision
+      description: Make a decision based on weighted criteria and priorities
+      operationId: makeDecision
+      tags: [decisions]
+      x-ossa-capability: make-decisions
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [options, criteria]
+              properties:
+                options:
+                  type: array
+                  items:
+                    type: object
+                criteria:
+                  type: object
+                weights:
+                  type: object
+      responses:
+        '200':
+          description: Decision made
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  selected_option:
+                    type: object
+                  score:
+                    type: number
+                  reasoning:
+                    type: string
+                  confidence:
+                    type: number
+

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
+