@bluefly/openstandardagents 0.2.4 → 0.2.5-RC

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]
+

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

@@ -0,0 +1,242 @@
+openapi: 3.1.0
+info:
+  title: Multi-Workflow Orchestrator Agent API
+  version: 2.1.0
+  description: |
+    Enterprise orchestrator managing complex multi-agent workflows across distributed systems.
+    Coordinates worker agents, manages dependencies, and handles failure recovery.
+
+x-ossa-metadata:
+  version: 0.2.5-RC
+  compliance:
+    level: enterprise
+    frameworks:
+      - OSSA
+      - OpenAPI 3.1
+  governance:
+    approved: true
+    approvedBy: Platform Team
+    approvalDate: "2024-01-15"
+
+x-ossa:
+  version: 0.2.5-RC
+  agent:
+    id: multi-workflow-orchestrator
+    type: orchestrator
+    compliance:
+      standards:
+        - openapi-first
+        - dry
+        - crud
+        - solid
+        - type-safe
+      validated: true
+      validatedAt: "2024-01-15T10:30:00Z"
+
+servers:
+  - url: https://orchestrator.platform.com/api/v1
+    description: Production
+  - url: http://orchestrator:3000/api/v1
+    description: Kubernetes internal
+
+tags:
+  - name: workflows
+    description: Workflow orchestration operations
+  - name: agents
+    description: Agent coordination operations
+  - name: resources
+    description: Resource allocation operations
+
+paths:
+  /workflows:
+    post:
+      summary: Create and execute workflow
+      description: |
+        Creates a new workflow definition and starts execution.
+        Orchestrates multiple agents to complete complex multi-step processes.
+      operationId: createWorkflow
+      tags: [workflows]
+      x-ossa-capability: orchestrate-workflows
+      x-ossa-autonomy:
+        level: semi-autonomous
+        approval_required: false
+        allowed_actions:
+          - delegate_tasks
+          - aggregate_results
+          - coordinate_agents
+      x-ossa-llm:
+        provider: openai
+        model: gpt-4
+        temperature: 0.1
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [workflow_id, steps]
+              properties:
+                workflow_id:
+                  type: string
+                  description: Unique workflow identifier
+                steps:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      step_id:
+                        type: string
+                      agent_type:
+                        type: string
+                        enum: [worker, specialist, critic]
+                      capability:
+                        type: string
+                      input:
+                        type: object
+                priority:
+                  type: string
+                  enum: [low, normal, high, critical]
+                  default: normal
+      responses:
+        '202':
+          description: Workflow execution started
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  workflow_id:
+                    type: string
+                  status:
+                    type: string
+                    enum: [pending, running, completed, failed]
+                  steps:
+                    type: array
+                    items:
+                      type: object
+
+  /workflows/{workflow_id}:
+    get:
+      summary: Get workflow status
+      description: Retrieve the current status of a workflow execution
+      operationId: getWorkflowStatus
+      tags: [workflows]
+      x-ossa-capability: orchestrate-workflows
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      parameters:
+        - name: workflow_id
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Workflow status
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  workflow_id:
+                    type: string
+                  status:
+                    type: string
+                  steps:
+                    type: array
+                    items:
+                      type: object
+                  aggregated_result:
+                    type: object
+
+  /agents/discover:
+    post:
+      summary: Discover agents by capability
+      description: Find agents that match specific capability requirements
+      operationId: discoverAgents
+      tags: [agents]
+      x-ossa-capability: coordinate-agents
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [capability]
+              properties:
+                capability:
+                  type: string
+                  description: Required capability name
+                agent_type:
+                  type: string
+                  enum: [worker, specialist, critic, orchestrator]
+                filters:
+                  type: object
+      responses:
+        '200':
+          description: List of matching agents
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  agents:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        agent_id:
+                          type: string
+                        capabilities:
+                          type: array
+                          items:
+                            type: string
+                        status:
+                          type: string
+
+  /resources/allocate:
+    post:
+      summary: Allocate resources for workflow
+      description: Allocate compute, memory, and token budgets for workflow execution
+      operationId: allocateResources
+      tags: [resources]
+      x-ossa-capability: resource-allocation
+      x-ossa-autonomy:
+        level: semi-autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [workflow_id, resources]
+              properties:
+                workflow_id:
+                  type: string
+                resources:
+                  type: object
+                  properties:
+                    cpu:
+                      type: string
+                    memory:
+                      type: string
+                    tokens:
+                      type: integer
+      responses:
+        '200':
+          description: Resources allocated
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  allocation_id:
+                    type: string
+                  resources:
+                    type: object
+

package/openapi/reference-implementations/quickstart-support-agent-api.openapi.yaml

@@ -0,0 +1,187 @@
+openapi: 3.1.0
+info:
+  title: Customer Support Agent API
+  version: 1.0.0
+  description: |
+    A helpful customer support agent that answers questions and helps with orders.
+    Demonstrates OSSA quickstart patterns for production-ready agents.
+
+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: support-agent
+    type: chat
+    compliance:
+      standards:
+        - openapi-first
+      validated: true
+      validatedAt: "2024-01-15T10:00:00Z"
+
+servers:
+  - url: http://localhost:3000
+    description: Local development server
+
+tags:
+  - name: support
+    description: Customer support operations
+  - name: orders
+    description: Order management operations
+
+paths:
+  /chat:
+    post:
+      summary: Chat with support agent
+      description: |
+        Interactive chat endpoint for customer support.
+        The agent can answer questions about orders, shipping, returns, and products.
+      operationId: chat
+      tags: [support]
+      x-ossa-capability: customer_support
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: false
+      x-ossa-llm:
+        provider: openai
+        model: gpt-4o-mini
+        temperature: 0.7
+        maxTokens: 1000
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [message]
+              properties:
+                message:
+                  type: string
+                  description: Customer message
+                session_id:
+                  type: string
+                  description: Session identifier for conversation continuity
+                context:
+                  type: object
+                  description: Additional context for the conversation
+      responses:
+        '200':
+          description: Support response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  response:
+                    type: string
+                    description: Agent response message
+                  session_id:
+                    type: string
+                  needs_escalation:
+                    type: boolean
+                    description: Whether human agent escalation is needed
+                  suggested_actions:
+                    type: array
+                    items:
+                      type: string
+
+  /orders/{order_id}/status:
+    get:
+      summary: Get order status
+      description: Retrieve the status of a customer order
+      operationId: getOrderStatus
+      tags: [orders]
+      x-ossa-capability: order_tracking
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      parameters:
+        - name: order_id
+          in: path
+          required: true
+          schema:
+            type: string
+          description: The order ID to look up (e.g., ORD-12345)
+      responses:
+        '200':
+          description: Order status retrieved
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  order_id:
+                    type: string
+                  status:
+                    type: string
+                    enum: [pending, processing, shipped, delivered, cancelled]
+                  tracking_number:
+                    type: string
+                  estimated_delivery:
+                    type: string
+                    format: date-time
+                  items:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        name:
+                          type: string
+                        quantity:
+                          type: integer
+                        price:
+                          type: number
+        '404':
+          description: Order not found
+
+  /orders/{order_id}/track:
+    get:
+      summary: Track order package
+      description: Get detailed tracking information for an order
+      operationId: trackOrder
+      tags: [orders]
+      x-ossa-capability: order_tracking
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      parameters:
+        - name: order_id
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Tracking information
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  order_id:
+                    type: string
+                  tracking_number:
+                    type: string
+                  carrier:
+                    type: string
+                  events:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        timestamp:
+                          type: string
+                          format: date-time
+                        location:
+                          type: string
+                        status:
+                          type: string
+                        description:
+                          type: string
+

package/openapi/{self-evolving-ecosystem.openapi.yaml → reference-implementations/self-evolving-ecosystem.openapi.yaml}

@@ -21,10 +21,10 @@ info:
     - Type-Safe: Zod + TypeScript auto-generation
 
     OSSA Compliance: v0.1.9
-    Reference: https://gitlab.bluefly.io/llm/OSSA
+    Reference: https://github.com/blueflyio/openstandardagents
   contact:
     name: LLM Platform Innovation Team
-    url: https://gitlab.bluefly.io/llm
+    url: https://github.com/blueflyio/openstandardagents
   license:
     name: MIT