@bluefly/openstandardagents 0.2.4 → 0.2.7

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
 

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

@@ -0,0 +1,208 @@
+openapi: 3.1.0
+info:
+  title: Data Processing Worker Agent API
+  version: 1.2.0
+  description: |
+    High-performance worker agent for distributed data processing tasks.
+    Executes tasks delegated by orchestrator 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: data-processing-worker
+    type: worker
+    compliance:
+      standards:
+        - openapi-first
+        - type-safe
+      validated: true
+      validatedAt: "2024-01-15T10:00:00Z"
+
+servers:
+  - url: https://worker.platform.com/api/v1
+    description: Production
+  - url: http://worker:3000/api/v1
+    description: Kubernetes internal
+
+tags:
+  - name: processing
+    description: Data processing operations
+  - name: tasks
+    description: Task management operations
+
+paths:
+  /process:
+    post:
+      summary: Process data records
+      description: Process a batch of data records with transformation and validation
+      operationId: processRecords
+      tags: [processing]
+      x-ossa-capability: process-records
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [records]
+              properties:
+                records:
+                  type: array
+                  items:
+                    type: object
+                transformation:
+                  type: object
+                  description: Transformation rules to apply
+                validation:
+                  type: object
+                  description: Validation rules
+      responses:
+        '200':
+          description: Processing completed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  processed:
+                    type: integer
+                  failed:
+                    type: integer
+                  results:
+                    type: array
+                    items:
+                      type: object
+                  errors:
+                    type: array
+                    items:
+                      type: object
+
+  /transform:
+    post:
+      summary: Transform data
+      description: Apply transformation rules to input data
+      operationId: transformData
+      tags: [processing]
+      x-ossa-capability: transform-data
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [data, rules]
+              properties:
+                data:
+                  type: object
+                rules:
+                  type: array
+                  items:
+                    type: object
+      responses:
+        '200':
+          description: Transformation completed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  transformed:
+                    type: object
+                  metadata:
+                    type: object
+
+  /validate:
+    post:
+      summary: Validate input data
+      description: Validate input data against schema and business rules
+      operationId: validateInput
+      tags: [processing]
+      x-ossa-capability: validate-input
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [data, schema]
+              properties:
+                data:
+                  type: object
+                schema:
+                  type: object
+                rules:
+                  type: array
+                  items:
+                    type: string
+      responses:
+        '200':
+          description: Validation completed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  valid:
+                    type: boolean
+                  errors:
+                    type: array
+                    items:
+                      type: object
+                  warnings:
+                    type: array
+                    items:
+                      type: string
+
+  /tasks/{task_id}/status:
+    get:
+      summary: Get task status
+      description: Retrieve the status of an asynchronous task
+      operationId: getTaskStatus
+      tags: [tasks]
+      x-ossa-capability: report-progress
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      parameters:
+        - name: task_id
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Task status
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  task_id:
+                    type: string
+                  status:
+                    type: string
+                    enum: [pending, running, completed, failed]
+                  progress:
+                    type: number
+                    minimum: 0
+                    maximum: 100
+                  result:
+                    type: object
+