@bluefly/openstandardagents 0.4.8 → 0.5.0

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

@@ -5,7 +5,9 @@ info:
   description: |
     Governance agent enforcing policies, compliance, and security standards across systems.
     Validates compliance, assesses risks, and generates audit reports.
-
+  contact:
+    name: Bluefly OSSA Team
+    url: https://gitlab.com/blueflyio/ossa/openstandardagents
 x-ossa-metadata:
   version: 0.2.5-RC
   compliance:
@@ -21,24 +23,25 @@ x-ossa-metadata:
   governance:
     approved: true
     approvedBy: Governance Team
-    approvalDate: "2024-01-15"
-
+    approvalDate: 2024-01-15
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
 x-ossa:
   version: 0.2.5-RC
   agent:
-    id: policy-compliance-governor
+    id: reference-implementations-governor-agent-api
     type: governor
     compliance:
       standards:
         - openapi-first
         - type-safe
       validated: true
-      validatedAt: "2024-01-15T10:00:00Z"
-
+      validatedAt: 2024-01-15T10:00:00Z
 servers:
   - url: https://governor.platform.com/api/v1
     description: Production
-
 tags:
   - name: policies
     description: Policy enforcement operations
@@ -46,14 +49,14 @@ tags:
     description: Compliance validation operations
   - name: audit
     description: Audit operations
-
 paths:
   /policies/enforce:
     post:
       summary: Enforce policy
       description: Enforce policy on a resource or action
       operationId: enforcePolicy
-      tags: [policies]
+      tags:
+        - policies
       x-ossa-capability: enforce-policies
       x-ossa-autonomy:
         level: supervised
@@ -64,7 +67,9 @@ paths:
           application/json:
             schema:
               type: object
-              required: [policy, resource]
+              required:
+                - policy
+                - resource
               properties:
                 policy:
                   type: string
@@ -74,10 +79,13 @@ paths:
                   description: Resource to enforce policy on
                 mode:
                   type: string
-                  enum: [advisory, blocking, logging]
+                  enum:
+                    - advisory
+                    - blocking
+                    - logging
                   default: blocking
       responses:
-        '200':
+        "200":
           description: Policy enforced
           content:
             application/json:
@@ -92,13 +100,13 @@ paths:
                     type: array
                     items:
                       type: object
-
   /compliance/validate:
     post:
       summary: Validate compliance
       description: Validate resource or system against compliance framework
       operationId: validateCompliance
-      tags: [compliance]
+      tags:
+        - compliance
       x-ossa-capability: validate-compliance
       x-ossa-autonomy:
         level: autonomous
@@ -109,11 +117,18 @@ paths:
           application/json:
             schema:
               type: object
-              required: [framework, resource]
+              required:
+                - framework
+                - resource
               properties:
                 framework:
                   type: string
-                  enum: [soc2, pci-dss, gdpr, hipaa, iso27001]
+                  enum:
+                    - soc2
+                    - pci-dss
+                    - gdpr
+                    - hipaa
+                    - iso27001
                 resource:
                   type: object
                 controls:
@@ -121,7 +136,7 @@ paths:
                   items:
                     type: string
       responses:
-        '200':
+        "200":
           description: Compliance validation completed
           content:
             application/json:
@@ -143,13 +158,13 @@ paths:
                           type: string
                   score:
                     type: number
-
   /audit/generate:
     post:
       summary: Generate audit report
       description: Generate audit report for compliance tracking
       operationId: generateAuditReport
-      tags: [audit]
+      tags:
+        - audit
       x-ossa-capability: generate-reports
       x-ossa-autonomy:
         level: autonomous
@@ -160,7 +175,8 @@ paths:
           application/json:
             schema:
               type: object
-              required: [period]
+              required:
+                - period
               properties:
                 period:
                   type: object
@@ -173,10 +189,13 @@ paths:
                       format: date-time
                 format:
                   type: string
-                  enum: [json, pdf, html]
+                  enum:
+                    - json
+                    - pdf
+                    - html
                   default: json
       responses:
-        '200':
+        "200":
           description: Audit report generated
           content:
             application/json:
@@ -190,4 +209,3 @@ paths:
                     format: uri
                   summary:
                     type: object
-

package/openapi/reference-implementations/helm-generator.openapi.yaml

@@ -10,11 +10,12 @@ info:
     - Supports multi-cloud deployments
     - Includes compliance and security policies
     - Auto-generates Kubernetes resources
-
+  contact:
+    name: Bluefly OSSA Team
+    url: https://gitlab.com/blueflyio/ossa/openstandardagents
 servers:
   - url: http://localhost:3101/api/v1
     description: Local development
-
 tags:
   - name: generate
     description: Helm chart generation
@@ -22,53 +23,63 @@ tags:
     description: Chart validation
   - name: templates
     description: Template management
-
 paths:
   /generate:
     post:
       summary: Generate Helm chart from OSSA manifest
       operationId: generateHelmChart
-      tags: [generate]
+      tags:
+        - generate
       requestBody:
         required: true
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/GenerateRequest'
+              $ref: "#/components/schemas/GenerateRequest"
       responses:
-        '200':
+        "200":
           description: Helm chart generated
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/GenerateResponse'
-        '400':
-          $ref: '#/components/responses/BadRequest'
-
+                $ref: "#/components/schemas/GenerateResponse"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+      x-ossa-capability: reference-generate-helm-chart
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Generate Helm chart from OSSA manifest
   /generate/batch:
     post:
       summary: Generate Helm charts for multiple agents
       operationId: generateBatch
-      tags: [generate]
+      tags:
+        - generate
       requestBody:
         required: true
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/BatchGenerateRequest'
+              $ref: "#/components/schemas/BatchGenerateRequest"
       responses:
-        '200':
+        "200":
           description: Batch generation complete
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/BatchGenerateResponse'
-
+                $ref: "#/components/schemas/BatchGenerateResponse"
+      x-ossa-capability: reference-generate-batch
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Generate Helm charts for multiple agents
   /validate:
     post:
       summary: Validate Helm chart
       operationId: validateChart
-      tags: [validate]
+      tags:
+        - validate
       requestBody:
         required: true
         content:
@@ -82,44 +93,55 @@ paths:
                   type: string
                   format: binary
       responses:
-        '200':
+        "200":
           description: Validation result
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/ValidationResponse'
-
+                $ref: "#/components/schemas/ValidationResponse"
+      x-ossa-capability: reference-validate-chart
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Validate Helm chart
   /templates:
     get:
       summary: List available templates
       operationId: listTemplates
-      tags: [templates]
+      tags:
+        - templates
       responses:
-        '200':
+        "200":
           description: Template list
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/TemplateListResponse'
-
+                $ref: "#/components/schemas/TemplateListResponse"
+      x-ossa-capability: reference-list-templates
+      description: List available templates
     post:
       summary: Create custom template
       operationId: createTemplate
-      tags: [templates]
+      tags:
+        - templates
       requestBody:
         required: true
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/TemplateCreateRequest'
+              $ref: "#/components/schemas/TemplateCreateRequest"
       responses:
-        '201':
+        "201":
           description: Template created
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/Template'
-
+                $ref: "#/components/schemas/Template"
+      x-ossa-capability: reference-create-template
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Create custom template
 components:
   schemas:
     GenerateRequest:
@@ -131,8 +153,7 @@ components:
           type: object
           description: OSSA agent manifest
         options:
-          $ref: '#/components/schemas/GenerationOptions'
-
+          $ref: "#/components/schemas/GenerationOptions"
     GenerationOptions:
       type: object
       properties:
@@ -155,7 +176,10 @@ components:
               type: string
             pullPolicy:
               type: string
-              enum: [Always, IfNotPresent, Never]
+              enum:
+                - Always
+                - IfNotPresent
+                - Never
               default: IfNotPresent
         resources:
           type: object
@@ -215,7 +239,11 @@ components:
               type: array
               items:
                 type: string
-                enum: [fedramp, iso27001, soc2, hipaa]
+                enum:
+                  - fedramp
+                  - iso27001
+                  - soc2
+                  - hipaa
             policies:
               type: array
               items:
@@ -232,7 +260,6 @@ components:
             jaeger:
               type: boolean
               default: false
-
     GenerateResponse:
       type: object
       required:
@@ -265,7 +292,6 @@ components:
               type: string
             size:
               type: integer
-
     BatchGenerateRequest:
       type: object
       required:
@@ -281,8 +307,7 @@ components:
               manifest:
                 type: object
               options:
-                $ref: '#/components/schemas/GenerationOptions'
-
+                $ref: "#/components/schemas/GenerationOptions"
     BatchGenerateResponse:
       type: object
       required:
@@ -301,7 +326,6 @@ components:
                 type: string
               error:
                 type: string
-
     ValidationResponse:
       type: object
       required:
@@ -319,7 +343,6 @@ components:
             type: string
         metadata:
           type: object
-
     Template:
       type: object
       required:
@@ -335,13 +358,17 @@ components:
           type: string
         type:
           type: string
-          enum: [deployment, statefulset, daemonset, job, cronjob]
+          enum:
+            - deployment
+            - statefulset
+            - daemonset
+            - job
+            - cronjob
         template:
           type: string
         created_at:
           type: string
           format: date-time
-
     TemplateListResponse:
       type: object
       required:
@@ -350,8 +377,7 @@ components:
         data:
           type: array
           items:
-            $ref: '#/components/schemas/Template'
-
+            $ref: "#/components/schemas/Template"
     TemplateCreateRequest:
       type: object
       required:
@@ -365,10 +391,14 @@ components:
           type: string
         type:
           type: string
-          enum: [deployment, statefulset, daemonset, job, cronjob]
+          enum:
+            - deployment
+            - statefulset
+            - daemonset
+            - job
+            - cronjob
         template:
           type: string
-
     Error:
       type: object
       required:
@@ -379,11 +409,23 @@ components:
           type: string
         message:
           type: string
-
   responses:
     BadRequest:
       description: Bad request
       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: reference-implementations-helm-generator
+    type: specialist

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

@@ -5,7 +5,9 @@ info:
   description: |
     Enterprise integration agent for connecting heterogeneous systems and APIs.
     Transforms protocols, maps schemas, and routes messages between systems.
-
+  contact:
+    name: Bluefly OSSA Team
+    url: https://gitlab.com/blueflyio/ossa/openstandardagents
 x-ossa-metadata:
   version: 0.2.5-RC
   compliance:
@@ -13,23 +15,24 @@ x-ossa-metadata:
     frameworks:
       - OSSA
       - OpenAPI 3.1
-
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
 x-ossa:
   version: 0.2.5-RC
   agent:
-    id: multi-system-integrator
+    id: reference-implementations-integrator-agent-api
     type: integrator
     compliance:
       standards:
         - openapi-first
         - type-safe
       validated: true
-      validatedAt: "2024-01-15T10:00:00Z"
-
+      validatedAt: 2024-01-15T10:00:00Z
 servers:
   - url: https://integrator.platform.com/api/v1
     description: Production
-
 tags:
   - name: integration
     description: System integration operations
@@ -37,14 +40,14 @@ tags:
     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]
+      tags:
+        - integration
       x-ossa-capability: connect-systems
       x-ossa-autonomy:
         level: supervised
@@ -55,7 +58,8 @@ paths:
           application/json:
             schema:
               type: object
-              required: [systems]
+              required:
+                - systems
               properties:
                 systems:
                   type: array
@@ -72,7 +76,7 @@ paths:
                   type: object
                   description: Schema mapping configuration
       responses:
-        '200':
+        "200":
           description: Systems connected
           content:
             application/json:
@@ -83,14 +87,16 @@ paths:
                     type: string
                   status:
                     type: string
-                    enum: [connected, failed]
-
+                    enum:
+                      - connected
+                      - failed
   /transform:
     post:
       summary: Transform data
       description: Transform data between different formats and schemas
       operationId: transformData
-      tags: [transformation]
+      tags:
+        - transformation
       x-ossa-capability: map-schemas
       x-ossa-autonomy:
         level: autonomous
@@ -101,7 +107,10 @@ paths:
           application/json:
             schema:
               type: object
-              required: [data, from_format, to_format]
+              required:
+                - data
+                - from_format
+                - to_format
               properties:
                 data:
                   type: object
@@ -112,7 +121,7 @@ paths:
                 mapping:
                   type: object
       responses:
-        '200':
+        "200":
           description: Data transformed
           content:
             application/json:
@@ -123,13 +132,13 @@ paths:
                     type: object
                   metadata:
                     type: object
-
   /route:
     post:
       summary: Route message
       description: Route message to appropriate system based on routing rules
       operationId: routeMessage
-      tags: [routing]
+      tags:
+        - routing
       x-ossa-capability: route-messages
       x-ossa-autonomy:
         level: autonomous
@@ -140,7 +149,9 @@ paths:
           application/json:
             schema:
               type: object
-              required: [message, destination]
+              required:
+                - message
+                - destination
               properties:
                 message:
                   type: object
@@ -149,7 +160,7 @@ paths:
                 routing_rules:
                   type: object
       responses:
-        '200':
+        "200":
           description: Message routed
           content:
             application/json:
@@ -162,4 +173,3 @@ paths:
                     type: string
                   status:
                     type: string
-