@bluefly/openstandardagents 0.4.8 → 0.5.0

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

@@ -5,7 +5,9 @@ info:
   description: |
     High-performance worker agent for distributed data processing tasks.
     Executes tasks delegated by orchestrator agents.
-
+  contact:
+    name: Bluefly OSSA Team
+    url: https://gitlab.com/blueflyio/ossa/openstandardagents
 x-ossa-metadata:
   version: 0.2.5-RC
   compliance:
@@ -13,38 +15,39 @@ x-ossa-metadata:
     frameworks:
       - OSSA
       - OpenAPI 3.1
-
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
 x-ossa:
   version: 0.2.5-RC
   agent:
-    id: data-processing-worker
+    id: reference-implementations-worker-agent-api
     type: worker
     compliance:
       standards:
         - openapi-first
         - type-safe
       validated: true
-      validatedAt: "2024-01-15T10:00:00Z"
-
+      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]
+      tags:
+        - processing
       x-ossa-capability: process-records
       x-ossa-autonomy:
         level: autonomous
@@ -55,7 +58,8 @@ paths:
           application/json:
             schema:
               type: object
-              required: [records]
+              required:
+                - records
               properties:
                 records:
                   type: array
@@ -68,7 +72,7 @@ paths:
                   type: object
                   description: Validation rules
       responses:
-        '200':
+        "200":
           description: Processing completed
           content:
             application/json:
@@ -87,13 +91,13 @@ paths:
                     type: array
                     items:
                       type: object
-
   /transform:
     post:
       summary: Transform data
       description: Apply transformation rules to input data
       operationId: transformData
-      tags: [processing]
+      tags:
+        - processing
       x-ossa-capability: transform-data
       x-ossa-autonomy:
         level: autonomous
@@ -104,7 +108,9 @@ paths:
           application/json:
             schema:
               type: object
-              required: [data, rules]
+              required:
+                - data
+                - rules
               properties:
                 data:
                   type: object
@@ -113,7 +119,7 @@ paths:
                   items:
                     type: object
       responses:
-        '200':
+        "200":
           description: Transformation completed
           content:
             application/json:
@@ -124,13 +130,13 @@ paths:
                     type: object
                   metadata:
                     type: object
-
   /validate:
     post:
       summary: Validate input data
       description: Validate input data against schema and business rules
       operationId: validateInput
-      tags: [processing]
+      tags:
+        - processing
       x-ossa-capability: validate-input
       x-ossa-autonomy:
         level: autonomous
@@ -141,7 +147,9 @@ paths:
           application/json:
             schema:
               type: object
-              required: [data, schema]
+              required:
+                - data
+                - schema
               properties:
                 data:
                   type: object
@@ -152,7 +160,7 @@ paths:
                   items:
                     type: string
       responses:
-        '200':
+        "200":
           description: Validation completed
           content:
             application/json:
@@ -169,13 +177,13 @@ paths:
                     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]
+      tags:
+        - tasks
       x-ossa-capability: report-progress
       x-ossa-autonomy:
         level: autonomous
@@ -187,7 +195,7 @@ paths:
           schema:
             type: string
       responses:
-        '200':
+        "200":
           description: Task status
           content:
             application/json:
@@ -198,11 +206,14 @@ paths:
                     type: string
                   status:
                     type: string
-                    enum: [pending, running, completed, failed]
+                    enum:
+                      - pending
+                      - running
+                      - completed
+                      - failed
                   progress:
                     type: number
                     minimum: 0
                     maximum: 100
                   result:
                     type: object
-

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

@@ -5,7 +5,9 @@ info:
   description: |
     Advanced workflow orchestration agent that coordinates multi-step processes,
     manages agent swarms, and provides intelligent task routing.
-
+  contact:
+    name: Bluefly OSSA Team
+    url: https://gitlab.com/blueflyio/ossa/openstandardagents
 x-ossa-metadata:
   version: 0.2.5-RC
   compliance:
@@ -13,36 +15,37 @@ x-ossa-metadata:
     frameworks:
       - OSSA
       - OpenAPI 3.1
-
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
 x-ossa:
   version: 0.2.5-RC
   agent:
-    id: workflow-orchestrator
+    id: reference-implementations-workflow-orchestrator-api
     type: orchestrator
     compliance:
       standards:
         - openapi-first
         - type-safe
       validated: true
-      validatedAt: "2024-01-15T10:00:00Z"
-
+      validatedAt: 2024-01-15T10:00:00Z
 servers:
   - url: https://workflow-orchestrator.platform.com/api/v1
     description: Production
-
 tags:
   - name: workflows
     description: Workflow execution operations
   - name: coordination
     description: Agent coordination operations
-
 paths:
   /workflows/execute:
     post:
       summary: Execute workflow
       description: Execute multi-step workflow with agent coordination
       operationId: executeWorkflow
-      tags: [workflows]
+      tags:
+        - workflows
       x-ossa-capability: execute_workflow
       x-ossa-autonomy:
         level: semi-autonomous
@@ -53,11 +56,14 @@ paths:
           application/json:
             schema:
               type: object
-              required: [workflow_definition]
+              required:
+                - workflow_definition
               properties:
                 workflow_definition:
                   type: object
-                  required: [name, steps]
+                  required:
+                    - name
+                    - steps
                   properties:
                     name:
                       type: string
@@ -87,7 +93,7 @@ paths:
                     retry:
                       type: object
       responses:
-        '202':
+        "202":
           description: Workflow execution started
           content:
             application/json:
@@ -98,14 +104,18 @@ paths:
                     type: string
                   status:
                     type: string
-                    enum: [pending, running, completed, failed]
-
+                    enum:
+                      - pending
+                      - running
+                      - completed
+                      - failed
   /workflows/{workflow_id}:
     get:
       summary: Get workflow status
       description: Retrieve workflow execution status and results
       operationId: getWorkflowStatus
-      tags: [workflows]
+      tags:
+        - workflows
       x-ossa-capability: execute_workflow
       x-ossa-autonomy:
         level: autonomous
@@ -117,7 +127,7 @@ paths:
           schema:
             type: string
       responses:
-        '200':
+        "200":
           description: Workflow status
           content:
             application/json:
@@ -141,13 +151,13 @@ paths:
                           type: object
                   result:
                     type: object
-
   /coordinate/swarm:
     post:
       summary: Coordinate agent swarm
       description: Coordinate multiple agents for parallel task execution
       operationId: coordinateSwarm
-      tags: [coordination]
+      tags:
+        - coordination
       x-ossa-capability: coordinate_agents
       x-ossa-autonomy:
         level: semi-autonomous
@@ -158,7 +168,9 @@ paths:
           application/json:
             schema:
               type: object
-              required: [agents, task]
+              required:
+                - agents
+                - task
               properties:
                 agents:
                   type: array
@@ -173,9 +185,12 @@ paths:
                   type: object
                 strategy:
                   type: string
-                  enum: [parallel, sequential, priority]
+                  enum:
+                    - parallel
+                    - sequential
+                    - priority
       responses:
-        '200':
+        "200":
           description: Swarm coordination initiated
           content:
             application/json:
@@ -190,4 +205,3 @@ paths:
                       type: object
                   status:
                     type: string
-

package/openapi/release-automation.openapi.yaml

@@ -5,7 +5,7 @@ info:
   description: |
     OpenAPI specification for agent-based release automation.
     Integrates semantic-release, Keep a Changelog format, and agent orchestration.
-    
+
     FOLLOWS DRY PRINCIPLE: Single source of truth for release automation schemas.
   contact:
     name: OSSA Release Team
@@ -13,13 +13,11 @@ info:
   license:
     name: Apache-2.0
     url: https://www.apache.org/licenses/LICENSE-2.0.html
-
 servers:
   - url: http://localhost:4000/api/v1
     description: Local development server
   - url: https://your-registry.example.com/api/v1
     description: Production API server (set OSSA_REGISTRY_URL)
-
 tags:
   - name: release
     description: Release orchestration and automation
@@ -27,7 +25,6 @@ tags:
     description: Changelog generation and management
   - name: version
     description: Version management and validation
-
 paths:
   /release/analyze:
     post:
@@ -57,7 +54,7 @@ paths:
                   type: boolean
                   default: false
       responses:
-        '200':
+        "200":
           description: Release analysis complete
           content:
             application/json:
@@ -68,12 +65,20 @@ paths:
                     type: boolean
                   releaseType:
                     type: string
-                    enum: [major, minor, patch, prerelease]
+                    enum:
+                      - major
+                      - minor
+                      - patch
+                      - prerelease
                   currentVersion:
                     type: string
                   nextVersion:
                     type: string
-
+      x-ossa-capability: analyze-release
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Analyze commits and determine release type
   /release/execute:
     post:
       operationId: executeRelease
@@ -95,9 +100,13 @@ paths:
                   type: boolean
                   default: false
       responses:
-        '200':
+        "200":
           description: Release executed successfully
-
+      x-ossa-capability: execute-release
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Execute full release workflow via agent orchestration
   /changelog/generate:
     post:
       operationId: generateChangelog
@@ -117,12 +126,19 @@ paths:
                   type: string
                 format:
                   type: string
-                  enum: [keepachangelog, markdown, json]
+                  enum:
+                    - keepachangelog
+                    - markdown
+                    - json
                   default: keepachangelog
       responses:
-        '200':
+        "200":
           description: Changelog generated successfully
-
+      x-ossa-capability: generate-changelog
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Generate changelog following Keep a Changelog format
   /changelog/validate:
     post:
       operationId: validateChangelog
@@ -140,5 +156,23 @@ paths:
                   type: string
                   default: CHANGELOG.md
       responses:
-        '200':
+        "200":
           description: Changelog validation result
+      x-ossa-capability: validate-changelog
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Validate changelog follows Keep a Changelog format
+x-ossa-metadata:
+  version: 0.5.0
+  compliance:
+    level: standard
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
+x-ossa:
+  version: 0.5.0
+  agent:
+    id: release-automation
+    type: orchestrator

package/openapi/schemas/common/agent.yaml

@@ -16,10 +16,9 @@ components:
           type: string
           const: AgentManifest
         metadata:
-          $ref: '#/components/schemas/Metadata'
+          $ref: "#/components/schemas/Metadata"
         spec:
-          $ref: '#/components/schemas/AgentSpec'
-
+          $ref: "#/components/schemas/AgentSpec"
     Metadata:
       type: object
       required:
@@ -28,10 +27,10 @@ components:
       properties:
         name:
           type: string
-          pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?$'
+          pattern: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
         version:
           type: string
-          pattern: '^\d+\.\d+\.\d+(-[a-zA-Z0-9]+)?$'
+          pattern: ^\d+\.\d+\.\d+(-[a-zA-Z0-9]+)?$
         namespace:
           type: string
         labels:
@@ -42,7 +41,6 @@ components:
           type: object
           additionalProperties:
             type: string
-
     AgentSpec:
       type: object
       required:
@@ -50,7 +48,7 @@ components:
         - capabilities
       properties:
         type:
-          $ref: '#/components/schemas/AgentType'
+          $ref: "#/components/schemas/AgentType"
         description:
           type: string
         role:
@@ -70,17 +68,16 @@ components:
         capabilities:
           type: array
           items:
-            $ref: '#/components/schemas/Capability'
+            $ref: "#/components/schemas/Capability"
         interfaces:
           type: array
           items:
-            $ref: '#/components/schemas/Interface'
+            $ref: "#/components/schemas/Interface"
         requirements:
-          $ref: '#/components/schemas/Requirements'
+          $ref: "#/components/schemas/Requirements"
         configuration:
           type: object
           additionalProperties: true
-
     AgentType:
       type: string
       enum:
@@ -91,7 +88,6 @@ components:
         - monitor
         - gateway
       description: Agent type classification
-
     AgentStatus:
       type: string
       enum:
@@ -101,7 +97,6 @@ components:
         - suspended
         - deprecated
       description: Current operational status of the agent
-
     Capability:
       type: object
       required:
@@ -128,7 +123,6 @@ components:
         parameters:
           type: object
           additionalProperties: true
-
     Interface:
       type: object
       required:
@@ -156,14 +150,13 @@ components:
             config:
               type: object
               additionalProperties: true
-
     Requirements:
       type: object
       properties:
         runtime:
           type: string
         resources:
-          $ref: '#/components/schemas/ResourceRequirements'
+          $ref: "#/components/schemas/ResourceRequirements"
         dependencies:
           type: array
           items:
@@ -172,22 +165,20 @@ components:
           type: object
           additionalProperties:
             type: string
-
     ResourceRequirements:
       type: object
       properties:
         cpu:
           type: string
-          pattern: '^[0-9]+m?$'
+          pattern: ^[0-9]+m?$
         memory:
           type: string
-          pattern: '^[0-9]+(Mi|Gi)$'
+          pattern: ^[0-9]+(Mi|Gi)$
         storage:
           type: string
-          pattern: '^[0-9]+(Mi|Gi)$'
+          pattern: ^[0-9]+(Mi|Gi)$
         gpu:
           type: string
-
     Agent:
       type: object
       properties:
@@ -195,16 +186,15 @@ components:
           type: string
           format: uuid
         manifest:
-          $ref: '#/components/schemas/AgentManifest'
+          $ref: "#/components/schemas/AgentManifest"
         status:
-          $ref: '#/components/schemas/AgentStatus'
+          $ref: "#/components/schemas/AgentStatus"
         registration:
-          $ref: '#/components/schemas/AgentRegistration'
+          $ref: "#/components/schemas/AgentRegistration"
         certification:
-          $ref: '#/components/schemas/Certification'
+          $ref: "#/components/schemas/Certification"
         metrics:
-          $ref: '#/components/schemas/AgentMetrics'
-
+          $ref: "#/components/schemas/AgentMetrics"
     AgentRegistration:
       type: object
       properties:
@@ -224,7 +214,6 @@ components:
           type: string
         federationNode:
           type: string
-
     Certification:
       type: object
       description: Certification or compliance attestation for the agent
@@ -241,7 +230,6 @@ components:
         expiresAt:
           type: string
           format: date-time
-
     AgentMetrics:
       type: object
       properties:
@@ -261,3 +249,16 @@ components:
           type: string
           format: date-time
           description: Timestamp of last activity
+x-ossa-metadata:
+  version: 0.5.0
+  compliance:
+    level: standard
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
+x-ossa:
+  version: 0.5.0
+  agent:
+    id: schemas-common-agent
+    type: specialist

package/openapi/schemas/common/errors.yaml

@@ -39,7 +39,6 @@ components:
             items:
               type: string
           description: Validation errors by field
-
     ValidationError:
       type: object
       properties:
@@ -49,7 +48,6 @@ components:
           type: string
         rule:
           type: string
-
     ValidationWarning:
       type: object
       properties:
@@ -59,7 +57,6 @@ components:
           type: string
         suggestion:
           type: string
-
     ExecutionError:
       type: object
       properties:
@@ -73,3 +70,16 @@ components:
         timestamp:
           type: string
           format: date-time
+x-ossa-metadata:
+  version: 0.5.0
+  compliance:
+    level: standard
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
+x-ossa:
+  version: 0.5.0
+  agent:
+    id: schemas-common-errors
+    type: specialist