@bluefly/openstandardagents 0.4.8 → 0.5.0

package/openapi/core/ossa-registry.openapi.yaml

@@ -24,20 +24,19 @@ info:
     - Performance metrics and health scoring
 
     OSSA Compliance: v0.1.9
-
+  contact:
+    name: Bluefly OSSA Team
+    url: https://gitlab.com/blueflyio/ossa/openstandardagents
 servers:
   - url: https://registry.openstandardagents.org/api/v1
     description: Production registry
-  # Local development server (commented to avoid lint warning)
-  # - url: http://localhost:8080/api/v1
-  #   description: Local development
-
 paths:
   /agents:
     get:
       operationId: listAgents
       summary: List all registered agents
-      tags: [Agents]
+      tags:
+        - Agents
       security:
         - ApiKeyAuth: []
       parameters:
@@ -45,7 +44,15 @@ paths:
           in: query
           schema:
             type: string
-            enum: [compliance, chat, orchestration, audit, workflow, monitoring, data_sync, search]
+            enum:
+              - compliance
+              - chat
+              - orchestration
+              - audit
+              - workflow
+              - monitoring
+              - data_sync
+              - search
         - name: certified
           in: query
           schema:
@@ -54,7 +61,12 @@ paths:
           in: query
           schema:
             type: string
-            enum: [aws, gcp, azure, local, hybrid]
+            enum:
+              - aws
+              - gcp
+              - azure
+              - local
+              - hybrid
         - name: page
           in: query
           schema:
@@ -66,29 +78,33 @@ paths:
             type: integer
             default: 20
       responses:
-        '200':
+        "200":
           description: List of agents
           content:
             application/json:
               schema:
                 type: object
-                required: [agents, pagination]
+                required:
+                  - agents
+                  - pagination
                 properties:
                   agents:
                     type: array
                     items:
-                      $ref: '#/components/schemas/Agent'
+                      $ref: "#/components/schemas/Agent"
                   pagination:
-                    $ref: '#/components/schemas/Pagination'
-        '400':
-          $ref: '#/components/responses/BadRequest'
-        '401':
-          $ref: '#/components/responses/Unauthorized'
-
+                    $ref: "#/components/schemas/Pagination"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+      x-ossa-capability: registry-list-agents
+      description: List all registered agents
     post:
       operationId: registerAgent
       summary: Register a new agent
-      tags: [Agents]
+      tags:
+        - Agents
       security:
         - ApiKeyAuth: []
       requestBody:
@@ -96,87 +112,104 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/AgentRegistration'
+              $ref: "#/components/schemas/AgentRegistration"
       responses:
-        '201':
+        "201":
           description: Agent registered
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/Agent'
-        '400':
-          $ref: '#/components/responses/BadRequest'
-        '401':
-          $ref: '#/components/responses/Unauthorized'
-
+                $ref: "#/components/schemas/Agent"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+      x-ossa-capability: registry-register-agent
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Register a new agent
   /agents/{agentId}:
     get:
       operationId: getAgent
       summary: Get agent details
-      tags: [Agents]
+      tags:
+        - Agents
       security:
         - ApiKeyAuth: []
       parameters:
-        - $ref: '#/components/parameters/AgentId'
+        - $ref: "#/components/parameters/AgentId"
       responses:
-        '200':
+        "200":
           description: Agent details
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/Agent'
-        '404':
-          $ref: '#/components/responses/NotFound'
-
+                $ref: "#/components/schemas/Agent"
+        "404":
+          $ref: "#/components/responses/NotFound"
+      x-ossa-capability: registry-get-agent
+      description: Get agent details
     put:
       operationId: updateAgent
       summary: Update agent metadata
-      tags: [Agents]
+      tags:
+        - Agents
       security:
         - ApiKeyAuth: []
       parameters:
-        - $ref: '#/components/parameters/AgentId'
+        - $ref: "#/components/parameters/AgentId"
       requestBody:
         required: true
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/AgentUpdate'
+              $ref: "#/components/schemas/AgentUpdate"
       responses:
-        '200':
+        "200":
           description: Agent updated
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/Agent'
-        '404':
-          $ref: '#/components/responses/NotFound'
-
+                $ref: "#/components/schemas/Agent"
+        "404":
+          $ref: "#/components/responses/NotFound"
+      x-ossa-capability: registry-update-agent
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Update agent metadata
     delete:
       operationId: deleteAgent
       summary: Deprecate an agent
-      tags: [Agents]
+      tags:
+        - Agents
       security:
         - ApiKeyAuth: []
       parameters:
-        - $ref: '#/components/parameters/AgentId'
+        - $ref: "#/components/parameters/AgentId"
       responses:
-        '204':
+        "204":
           description: Agent deprecated
-        '404':
-          $ref: '#/components/responses/NotFound'
-
+        "404":
+          $ref: "#/components/responses/NotFound"
+      x-ossa-capability: registry-delete-agent
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Deprecate an agent
   /agents/{agentId}/versions:
     get:
       operationId: listAgentVersions
       summary: List agent versions
-      tags: [Versions]
+      tags:
+        - Versions
       security:
         - ApiKeyAuth: []
       parameters:
-        - $ref: '#/components/parameters/AgentId'
+        - $ref: "#/components/parameters/AgentId"
       responses:
-        '200':
+        "200":
           description: Agent versions
           content:
             application/json:
@@ -186,49 +219,56 @@ paths:
                   versions:
                     type: array
                     items:
-                      $ref: '#/components/schemas/AgentVersion'
-        '400':
-          $ref: '#/components/responses/BadRequest'
-        '404':
-          $ref: '#/components/responses/NotFound'
-
+                      $ref: "#/components/schemas/AgentVersion"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "404":
+          $ref: "#/components/responses/NotFound"
+      x-ossa-capability: registry-list-agent-versions
+      description: List agent versions
     post:
       operationId: publishVersion
       summary: Publish new agent version
-      tags: [Versions]
+      tags:
+        - Versions
       security:
         - ApiKeyAuth: []
       parameters:
-        - $ref: '#/components/parameters/AgentId'
+        - $ref: "#/components/parameters/AgentId"
       requestBody:
         required: true
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/VersionPublish'
+              $ref: "#/components/schemas/VersionPublish"
       responses:
-        '201':
+        "201":
           description: Version published
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AgentVersion'
-        '400':
-          $ref: '#/components/responses/BadRequest'
-        '404':
-          $ref: '#/components/responses/NotFound'
-
+                $ref: "#/components/schemas/AgentVersion"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "404":
+          $ref: "#/components/responses/NotFound"
+      x-ossa-capability: registry-publish-version
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Publish new agent version
   /agents/{agentId}/certifications:
     get:
       operationId: listCertifications
       summary: List agent certifications
-      tags: [Certifications]
+      tags:
+        - Certifications
       security:
         - ApiKeyAuth: []
       parameters:
-        - $ref: '#/components/parameters/AgentId'
+        - $ref: "#/components/parameters/AgentId"
       responses:
-        '200':
+        "200":
           description: Certifications
           content:
             application/json:
@@ -238,91 +278,105 @@ paths:
                   certifications:
                     type: array
                     items:
-                      $ref: '#/components/schemas/Certification'
-        '400':
-          $ref: '#/components/responses/BadRequest'
-        '404':
-          $ref: '#/components/responses/NotFound'
-
+                      $ref: "#/components/schemas/Certification"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "404":
+          $ref: "#/components/responses/NotFound"
+      x-ossa-capability: registry-list-certifications
+      description: List agent certifications
     post:
       operationId: addCertification
       summary: Add certification
-      tags: [Certifications]
+      tags:
+        - Certifications
       security:
         - ApiKeyAuth: []
       parameters:
-        - $ref: '#/components/parameters/AgentId'
+        - $ref: "#/components/parameters/AgentId"
       requestBody:
         required: true
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/CertificationRequest'
+              $ref: "#/components/schemas/CertificationRequest"
       responses:
-        '201':
+        "201":
           description: Certification added
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/Certification'
-        '400':
-          $ref: '#/components/responses/BadRequest'
-        '404':
-          $ref: '#/components/responses/NotFound'
-
+                $ref: "#/components/schemas/Certification"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "404":
+          $ref: "#/components/responses/NotFound"
+      x-ossa-capability: registry-add-certification
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Add certification
   /agents/{agentId}/deploy:
     post:
       operationId: deployAgent
       summary: Deploy agent to environment
-      tags: [Deployment]
+      tags:
+        - Deployment
       security:
         - ApiKeyAuth: []
       parameters:
-        - $ref: '#/components/parameters/AgentId'
+        - $ref: "#/components/parameters/AgentId"
       requestBody:
         required: true
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/DeploymentRequest'
+              $ref: "#/components/schemas/DeploymentRequest"
       responses:
-        '202':
+        "202":
           description: Deployment initiated
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/DeploymentStatus'
-        '400':
-          $ref: '#/components/responses/BadRequest'
-        '404':
-          $ref: '#/components/responses/NotFound'
-
+                $ref: "#/components/schemas/DeploymentStatus"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "404":
+          $ref: "#/components/responses/NotFound"
+      x-ossa-capability: registry-deploy-agent
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Deploy agent to environment
   /agents/{agentId}/health:
     get:
       operationId: getAgentHealth
       summary: Get agent health metrics
-      tags: [Health]
+      tags:
+        - Health
       security:
         - ApiKeyAuth: []
       parameters:
-        - $ref: '#/components/parameters/AgentId'
+        - $ref: "#/components/parameters/AgentId"
       responses:
-        '200':
+        "200":
           description: Health metrics
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/HealthMetrics'
-        '400':
-          $ref: '#/components/responses/BadRequest'
-        '404':
-          $ref: '#/components/responses/NotFound'
-
+                $ref: "#/components/schemas/HealthMetrics"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "404":
+          $ref: "#/components/responses/NotFound"
+      x-ossa-capability: registry-get-agent-health
+      description: Get agent health metrics
   /compliance/validate:
     post:
       operationId: validateCompliance
       summary: Validate agent compliance
-      tags: [Compliance]
+      tags:
+        - Compliance
       security:
         - ApiKeyAuth: []
       requestBody:
@@ -330,28 +384,33 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/ComplianceValidation'
+              $ref: "#/components/schemas/ComplianceValidation"
       responses:
-        '200':
+        "200":
           description: Compliance validation result
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/ComplianceResult'
-
+                $ref: "#/components/schemas/ComplianceResult"
+      x-ossa-capability: registry-validate-compliance
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Validate agent compliance
   /search:
     post:
       operationId: searchAgents
       summary: Search agents
-      tags: [Search]
+      tags:
+        - Search
       requestBody:
         required: true
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/SearchQuery'
+              $ref: "#/components/schemas/SearchQuery"
       responses:
-        '200':
+        "200":
           description: Search results
           content:
             application/json:
@@ -361,21 +420,24 @@ paths:
                   results:
                     type: array
                     items:
-                      $ref: '#/components/schemas/SearchResult'
+                      $ref: "#/components/schemas/SearchResult"
                   facets:
                     type: object
                     additionalProperties:
                       type: array
                       items:
                         type: object
-
+      x-ossa-capability: registry-search-agents
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Search agents
 components:
   securitySchemes:
     ApiKeyAuth:
       type: apiKey
       in: header
       name: X-OSSA-API-Key
-
   parameters:
     AgentId:
       name: agentId
@@ -383,8 +445,7 @@ components:
       required: true
       schema:
         type: string
-        pattern: '^[a-z0-9-]+$'
-
+        pattern: ^[a-z0-9-]+$
   schemas:
     Agent:
       type: object
@@ -399,20 +460,33 @@ components:
       properties:
         id:
           type: string
-          pattern: '^[a-z0-9-]+$'
+          pattern: ^[a-z0-9-]+$
         name:
           type: string
         description:
           type: string
         role:
           type: string
-          enum: [compliance, chat, orchestration, audit, workflow, monitoring, data_sync, search, custom]
+          enum:
+            - compliance
+            - chat
+            - orchestration
+            - audit
+            - workflow
+            - monitoring
+            - data_sync
+            - search
+            - custom
         version:
           type: string
-          pattern: '^\d+\.\d+\.\d+$'
+          pattern: ^\d+\.\d+\.\d+$
         status:
           type: string
-          enum: [active, deprecated, beta, experimental]
+          enum:
+            - active
+            - deprecated
+            - beta
+            - experimental
         author:
           type: object
           properties:
@@ -434,7 +508,12 @@ components:
               type: array
               items:
                 type: string
-                enum: [aws, gcp, azure, local, hybrid]
+                enum:
+                  - aws
+                  - gcp
+                  - azure
+                  - local
+                  - hybrid
             regions:
               type: array
               items:
@@ -450,9 +529,14 @@ components:
           type: array
           items:
             type: string
-            enum: [fedramp, iso27001, soc2, hipaa, gdpr]
+            enum:
+              - fedramp
+              - iso27001
+              - soc2
+              - hipaa
+              - gdpr
         metrics:
-          $ref: '#/components/schemas/AgentMetrics'
+          $ref: "#/components/schemas/AgentMetrics"
         certifications:
           type: array
           items:
@@ -465,7 +549,6 @@ components:
         updatedAt:
           type: string
           format: date-time
-
     AgentRegistration:
       type: object
       required:
@@ -480,10 +563,19 @@ components:
           type: string
         role:
           type: string
-          enum: [compliance, chat, orchestration, audit, workflow, monitoring, data_sync, search, custom]
+          enum:
+            - compliance
+            - chat
+            - orchestration
+            - audit
+            - workflow
+            - monitoring
+            - data_sync
+            - search
+            - custom
         version:
           type: string
-          pattern: '^\d+\.\d+\.\d+$'
+          pattern: ^\d+\.\d+\.\d+$
         manifest:
           type: object
           description: OSSA agent manifest
@@ -505,7 +597,6 @@ components:
           type: object
         signature:
           type: string
-
     AgentUpdate:
       type: object
       properties:
@@ -513,12 +604,15 @@ components:
           type: string
         status:
           type: string
-          enum: [active, deprecated, beta, experimental]
+          enum:
+            - active
+            - deprecated
+            - beta
+            - experimental
         capabilities:
           type: array
           items:
             type: string
-
     AgentVersion:
       type: object
       required:
@@ -528,7 +622,7 @@ components:
       properties:
         version:
           type: string
-          pattern: '^\d+\.\d+\.\d+$'
+          pattern: ^\d+\.\d+\.\d+$
         releaseDate:
           type: string
           format: date-time
@@ -540,7 +634,6 @@ components:
           type: boolean
         signature:
           type: string
-
     VersionPublish:
       type: object
       required:
@@ -549,7 +642,7 @@ components:
       properties:
         version:
           type: string
-          pattern: '^\d+\.\d+\.\d+$'
+          pattern: ^\d+\.\d+\.\d+$
         changelog:
           type: string
         manifest:
@@ -558,7 +651,6 @@ components:
           type: boolean
         signature:
           type: string
-
     Certification:
       type: object
       required:
@@ -568,7 +660,13 @@ components:
       properties:
         type:
           type: string
-          enum: [fedramp, iso27001, soc2, hipaa, gdpr, custom]
+          enum:
+            - fedramp
+            - iso27001
+            - soc2
+            - hipaa
+            - gdpr
+            - custom
         issuedAt:
           type: string
           format: date-time
@@ -582,7 +680,6 @@ components:
           format: uri
         verified:
           type: boolean
-
     CertificationRequest:
       type: object
       required:
@@ -591,14 +688,19 @@ components:
       properties:
         type:
           type: string
-          enum: [fedramp, iso27001, soc2, hipaa, gdpr, custom]
+          enum:
+            - fedramp
+            - iso27001
+            - soc2
+            - hipaa
+            - gdpr
+            - custom
         expiresAt:
           type: string
           format: date-time
         certificateUrl:
           type: string
           format: uri
-
     DeploymentRequest:
       type: object
       required:
@@ -607,10 +709,18 @@ components:
       properties:
         environment:
           type: string
-          enum: [development, staging, production]
+          enum:
+            - development
+            - staging
+            - production
         cloud:
           type: string
-          enum: [aws, gcp, azure, local, hybrid]
+          enum:
+            - aws
+            - gcp
+            - azure
+            - local
+            - hybrid
         region:
           type: string
         namespace:
@@ -618,7 +728,6 @@ components:
         config:
           type: object
           additionalProperties: true
-
     DeploymentStatus:
       type: object
       required:
@@ -630,7 +739,12 @@ components:
           type: string
         status:
           type: string
-          enum: [pending, deploying, deployed, failed, rollback]
+          enum:
+            - pending
+            - deploying
+            - deployed
+            - failed
+            - rollback
         startedAt:
           type: string
           format: date-time
@@ -643,7 +757,6 @@ components:
           type: array
           items:
             type: string
-
     HealthMetrics:
       type: object
       required:
@@ -675,7 +788,6 @@ components:
               type: boolean
             soc2:
               type: boolean
-
     AgentMetrics:
       type: object
       properties:
@@ -691,7 +803,6 @@ components:
           type: number
           minimum: 0
           maximum: 1
-
     ComplianceValidation:
       type: object
       required:
@@ -704,8 +815,12 @@ components:
           type: array
           items:
             type: string
-            enum: [fedramp, iso27001, soc2, hipaa, gdpr]
-
+            enum:
+              - fedramp
+              - iso27001
+              - soc2
+              - hipaa
+              - gdpr
     ComplianceResult:
       type: object
       required:
@@ -731,7 +846,6 @@ components:
                 type: array
                 items:
                   type: string
-
     SearchQuery:
       type: object
       properties:
@@ -756,20 +870,22 @@ components:
               type: boolean
         sort:
           type: string
-          enum: [relevance, downloads, health, recent]
+          enum:
+            - relevance
+            - downloads
+            - health
+            - recent
         page:
           type: integer
         limit:
           type: integer
-
     SearchResult:
       type: object
       properties:
         agent:
-          $ref: '#/components/schemas/Agent'
+          $ref: "#/components/schemas/Agent"
         relevance:
           type: number
-
     Pagination:
       type: object
       required:
@@ -785,7 +901,6 @@ components:
           type: integer
         pages:
           type: integer
-
     Error:
       type: object
       required:
@@ -800,25 +915,50 @@ components:
           type: string
         details:
           type: object
-
   responses:
     BadRequest:
       description: Bad request
       content:
         application/json:
           schema:
-            $ref: '#/components/schemas/Error'
-
+            $ref: "#/components/schemas/Error"
     Unauthorized:
       description: Unauthorized
       content:
         application/json:
           schema:
-            $ref: '#/components/schemas/Error'
-
+            $ref: "#/components/schemas/Error"
     NotFound:
       description: Not found
       content:
         application/json:
           schema:
-            $ref: '#/components/schemas/Error'
+            $ref: "#/components/schemas/Error"
+x-ossa-metadata:
+  version: 0.3.3
+  compliance:
+    level: standard
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
+x-ossa:
+  version: 0.5.0
+  agent:
+    id: ossa-registry
+    type: gateway
+tags:
+  - name: Agents
+    description: Agents operations
+  - name: Certifications
+    description: Certifications operations
+  - name: Compliance
+    description: Compliance operations
+  - name: Deployment
+    description: Deployment operations
+  - name: Health
+    description: Health operations
+  - name: Search
+    description: Search operations
+  - name: Versions
+    description: Versions operations