@bluefly/openstandardagents 0.4.8 → 0.5.0

package/openapi/protocols/websocket-events.yaml

@@ -5,15 +5,12 @@ info:
   description: |
     OpenAPI extension for WebSocket event definitions in OSSA.
     Defines event schemas for bidirectional agent-to-agent messaging over WebSocket.
-
   contact:
     name: OSSA Standards Team
     url: https://openstandardagents.org
-
 servers:
   - url: wss://agent.example.com
     description: WebSocket server endpoint
-
 x-websocket-config:
   protocol: ossa.v0.3.0
   keepalive:
@@ -23,9 +20,8 @@ x-websocket-config:
   compression:
     enabled: true
     method: permessage-deflate
-  max_message_size_bytes: 1048576  # 1MB
+  max_message_size_bytes: 1048576
   max_connections_per_agent: 10
-
 paths:
   /ws:
     get:
@@ -33,7 +29,6 @@ paths:
       description: |
         Establish WebSocket connection for agent-to-agent messaging.
         Client must send registration event after connection.
-
       parameters:
         - name: Authorization
           in: header
@@ -41,54 +36,54 @@ paths:
           schema:
             type: string
           description: Bearer token for authentication (preferred)
-
         - name: token
           in: query
           required: false
           schema:
             type: string
           description: JWT token for authentication (fallback for restricted environments)
-
       responses:
-        '101':
+        "101":
           description: Switching Protocols - WebSocket connection established
           headers:
             Upgrade:
               schema:
                 type: string
-                enum: [websocket]
+                enum:
+                  - websocket
             Connection:
               schema:
                 type: string
-                enum: [Upgrade]
+                enum:
+                  - Upgrade
             Sec-WebSocket-Accept:
               schema:
                 type: string
-
-        '401':
+        "401":
           description: Unauthorized - Invalid or missing authentication
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/Error'
-
-        '429':
+                $ref: "#/components/schemas/Error"
+        "429":
           description: Too Many Requests - Connection limit exceeded
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/Error'
-
+                $ref: "#/components/schemas/Error"
       x-websocket-events:
-        - $ref: '#/components/x-websocket-events/Register'
-        - $ref: '#/components/x-websocket-events/Message'
-        - $ref: '#/components/x-websocket-events/CapabilityCall'
-        - $ref: '#/components/x-websocket-events/StatusUpdate'
-        - $ref: '#/components/x-websocket-events/Error'
-        - $ref: '#/components/x-websocket-events/Acknowledgment'
-        - $ref: '#/components/x-websocket-events/Ping'
-        - $ref: '#/components/x-websocket-events/Pong'
-
+        - $ref: "#/components/x-websocket-events/Register"
+        - $ref: "#/components/x-websocket-events/Message"
+        - $ref: "#/components/x-websocket-events/CapabilityCall"
+        - $ref: "#/components/x-websocket-events/StatusUpdate"
+        - $ref: "#/components/x-websocket-events/Error"
+        - $ref: "#/components/x-websocket-events/Acknowledgment"
+        - $ref: "#/components/x-websocket-events/Ping"
+        - $ref: "#/components/x-websocket-events/Pong"
+      x-ossa-capability: protocol-get-/ws
+      tags:
+        - WebSocket
+      operationId: getWs
 components:
   x-websocket-events:
     Register:
@@ -111,19 +106,20 @@ components:
             agentId:
               type: string
               format: uri
-              description: Agent URI (agent://domain/agent-id)
-              example: agent://example.com/supercali-fragilisticagent
+              description: Agent URI (uadp://domain/agent-id)
+              example: uadp://example.com/supercali-fragilisticagent
             capabilities:
               type: array
               items:
                 type: string
               description: List of capabilities this agent provides
-              example: [process_data, analyze_content]
+              example:
+                - process_data
+                - analyze_content
             version:
               type: string
               description: OSSA protocol version
               example: ossa/v0.3.3
-
     Message:
       summary: General message event
       description: Pub/sub style message broadcast
@@ -131,8 +127,7 @@ components:
       event:
         type: message
         schema:
-          $ref: '#/components/schemas/WebSocketEvent'
-
+          $ref: "#/components/schemas/WebSocketEvent"
     CapabilityCall:
       summary: Capability invocation event
       description: RPC-style capability call with request/response pattern
@@ -141,7 +136,7 @@ components:
         type: capability_call
         schema:
           allOf:
-            - $ref: '#/components/schemas/WebSocketEvent'
+            - $ref: "#/components/schemas/WebSocketEvent"
             - type: object
               required:
                 - payload
@@ -160,7 +155,7 @@ components:
                       description: Capability input parameters
                 metadata:
                   allOf:
-                    - $ref: '#/components/schemas/EventMetadata'
+                    - $ref: "#/components/schemas/EventMetadata"
                     - type: object
                       required:
                         - correlationId
@@ -172,7 +167,6 @@ components:
                         replyTo:
                           type: string
                           description: WebSocket connection ID for response
-
     StatusUpdate:
       summary: Agent status update event
       description: Periodic health and status broadcasts
@@ -181,7 +175,7 @@ components:
         type: status_update
         schema:
           allOf:
-            - $ref: '#/components/schemas/WebSocketEvent'
+            - $ref: "#/components/schemas/WebSocketEvent"
             - type: object
               required:
                 - payload
@@ -193,7 +187,11 @@ components:
                   properties:
                     status:
                       type: string
-                      enum: [healthy, degraded, unhealthy, offline]
+                      enum:
+                        - healthy
+                        - degraded
+                        - unhealthy
+                        - offline
                     load:
                       type: number
                       minimum: 0
@@ -209,7 +207,6 @@ components:
                     metrics:
                       type: object
                       additionalProperties: true
-
     Error:
       summary: Error event
       description: Error notification for failed operations
@@ -218,7 +215,7 @@ components:
         type: error
         schema:
           allOf:
-            - $ref: '#/components/schemas/WebSocketEvent'
+            - $ref: "#/components/schemas/WebSocketEvent"
             - type: object
               required:
                 - payload
@@ -246,7 +243,6 @@ components:
                     retryable:
                       type: boolean
                       default: false
-
     Acknowledgment:
       summary: Message acknowledgment
       description: Confirms message receipt for at-least-once delivery
@@ -255,7 +251,7 @@ components:
         type: ack
         schema:
           allOf:
-            - $ref: '#/components/schemas/WebSocketEvent'
+            - $ref: "#/components/schemas/WebSocketEvent"
             - type: object
               required:
                 - payload
@@ -271,8 +267,10 @@ components:
                       format: uuid
                     status:
                       type: string
-                      enum: [received, processed, failed]
-
+                      enum:
+                        - received
+                        - processed
+                        - failed
     Ping:
       summary: Keepalive ping
       description: Server-initiated heartbeat to maintain connection
@@ -291,7 +289,6 @@ components:
             timestamp:
               type: string
               format: date-time
-
     Pong:
       summary: Keepalive pong
       description: Client response to ping
@@ -310,7 +307,6 @@ components:
             timestamp:
               type: string
               format: date-time
-
   schemas:
     WebSocketEvent:
       type: object
@@ -342,8 +338,7 @@ components:
           type: object
           description: Event-specific payload
         metadata:
-          $ref: '#/components/schemas/EventMetadata'
-
+          $ref: "#/components/schemas/EventMetadata"
     EventMetadata:
       type: object
       required:
@@ -353,7 +348,7 @@ components:
           type: string
           format: uri
           description: Agent URI of sender
-          example: agent://example.com/supercali-fragilisticagent
+          example: uadp://example.com/supercali-fragilisticagent
         correlationId:
           type: string
           format: uuid
@@ -363,7 +358,11 @@ components:
           description: Connection ID or endpoint for responses
         priority:
           type: string
-          enum: [low, normal, high, critical]
+          enum:
+            - low
+            - normal
+            - high
+            - critical
           default: normal
         ttl:
           type: integer
@@ -373,7 +372,6 @@ components:
           type: integer
           minimum: 0
           description: Number of retry attempts
-
     Error:
       type: object
       required:
@@ -387,27 +385,22 @@ components:
         details:
           type: object
           additionalProperties: true
-
   securitySchemes:
     bearerAuth:
       type: http
       scheme: bearer
       bearerFormat: JWT
-
     queryToken:
       type: apiKey
       in: query
       name: token
-
 security:
   - bearerAuth: []
   - queryToken: []
-
 x-rate-limits:
   messages_per_second: 100
   max_payload_size_bytes: 1048576
   burst_size: 200
-
 x-reliability:
   delivery_guarantee: at-least-once
   retry_policy:
@@ -415,7 +408,6 @@ x-reliability:
     backoff: exponential
     initial_delay_ms: 1000
     max_delay_ms: 30000
-
 tags:
   - name: Connection
     description: WebSocket connection management
@@ -425,3 +417,18 @@ tags:
     description: Capability invocation
   - name: Health
     description: Agent health and status
+  - name: WebSocket
+    description: WebSocket operations
+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: protocols-websocket-events
+    type: integrator

package/openapi/reference-implementations/aiflow-bridge-api.openapi.yaml

@@ -5,7 +5,9 @@ info:
   description: |
     OSSA agent with AIFlow-Agent bridge for social crypto analysis.
     Integrates with Twitter, Telegram, and Discord for autonomous social media presence.
-
+  contact:
+    name: Bluefly OSSA Team
+    url: https://gitlab.com/blueflyio/ossa/openstandardagents
 x-ossa-metadata:
   version: 0.2.5-RC
   compliance:
@@ -13,35 +15,36 @@ x-ossa-metadata:
     frameworks:
       - OSSA
       - OpenAPI 3.1
-
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
 x-ossa:
   version: 0.3.3
   agent:
-    id: crypto-analyst-agent
-    type: specialist
+    id: reference-implementations-aiflow-bridge-api
+    type: integrator
     compliance:
       standards:
         - openapi-first
       validated: true
-      validatedAt: "2024-01-15T10:00:00Z"
-
+      validatedAt: 2024-01-15T10:00:00Z
 servers:
   - url: https://crypto-analyst.platform.com/api/v1
     description: Production
-
 tags:
   - name: market
     description: Market analysis operations
   - name: social
     description: Social media operations
-
 paths:
   /market/analyze:
     post:
       summary: Analyze cryptocurrency market
       description: Analyze cryptocurrency market trends using on-chain data and LLM reasoning
       operationId: analyzeMarket
-      tags: [market]
+      tags:
+        - market
       x-ossa-capability: analyze_market
       x-ossa-autonomy:
         level: autonomous
@@ -56,17 +59,22 @@ paths:
           application/json:
             schema:
               type: object
-              required: [token]
+              required:
+                - token
               properties:
                 token:
                   type: string
                   description: Token symbol (e.g., BNB, CAKE)
                 timeframe:
                   type: string
-                  enum: [1h, 24h, 7d, 30d]
+                  enum:
+                    - 1h
+                    - 24h
+                    - 7d
+                    - 30d
                   default: 24h
       responses:
-        '200':
+        "200":
           description: Market analysis completed
           content:
             application/json:
@@ -77,7 +85,10 @@ paths:
                     type: string
                   sentiment:
                     type: string
-                    enum: [bullish, bearish, neutral]
+                    enum:
+                      - bullish
+                      - bearish
+                      - neutral
                   analysis:
                     type: string
                   metrics:
@@ -87,13 +98,13 @@ paths:
                         type: number
                       volume:
                         type: number
-
   /social/post:
     post:
       summary: Post to social media
       description: Post content to Twitter, Telegram, or Discord
       operationId: postToSocial
-      tags: [social]
+      tags:
+        - social
       x-ossa-capability: post_social
       x-ossa-autonomy:
         level: supervised
@@ -104,19 +115,24 @@ paths:
           application/json:
             schema:
               type: object
-              required: [content, platform]
+              required:
+                - content
+                - platform
               properties:
                 content:
                   type: string
                   description: Post content
                 platform:
                   type: string
-                  enum: [twitter, telegram, discord]
+                  enum:
+                    - twitter
+                    - telegram
+                    - discord
                 character:
                   type: string
                   description: Character persona to use
       responses:
-        '200':
+        "200":
           description: Post published
           content:
             application/json:
@@ -132,5 +148,6 @@ paths:
                     format: uri
                   status:
                     type: string
-                    enum: [published, pending_approval]
-
+                    enum:
+                      - published
+                      - pending_approval

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

@@ -5,7 +5,9 @@ info:
   description: |
     Automated FedRAMP compliance scanning agent that validates
     infrastructure against FedRAMP Moderate controls.
-
+  contact:
+    name: Bluefly OSSA Team
+    url: https://gitlab.com/blueflyio/ossa/openstandardagents
 x-ossa-metadata:
   version: 0.2.5-RC
   compliance:
@@ -18,24 +20,25 @@ x-ossa-metadata:
   governance:
     approved: true
     approvedBy: Security 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: fedramp-compliance-scanner
-    type: worker
+    id: reference-implementations-compliance-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://compliance-scanner.platform.com/api/v1
     description: Production
-
 tags:
   - name: scanning
     description: Compliance scanning operations
@@ -43,14 +46,14 @@ tags:
     description: Remediation operations
   - name: reporting
     description: Reporting operations
-
 paths:
   /scan:
     post:
       summary: Scan infrastructure for compliance
       description: Scan Kubernetes infrastructure for FedRAMP compliance violations
       operationId: scanInfrastructure
-      tags: [scanning]
+      tags:
+        - scanning
       x-ossa-capability: scan_infrastructure
       x-ossa-autonomy:
         level: autonomous
@@ -61,7 +64,8 @@ paths:
           application/json:
             schema:
               type: object
-              required: [namespace]
+              required:
+                - namespace
               properties:
                 namespace:
                   type: string
@@ -72,7 +76,7 @@ paths:
                     type: string
                   description: Specific controls to check (e.g., AC-2, AC-3)
       responses:
-        '200':
+        "200":
           description: Scan completed
           content:
             application/json:
@@ -90,18 +94,22 @@ paths:
                           type: string
                         severity:
                           type: string
-                          enum: [low, medium, high, critical]
+                          enum:
+                            - low
+                            - medium
+                            - high
+                            - critical
                         description:
                           type: string
                         resource:
                           type: string
-
   /remediate:
     post:
       summary: Remediate compliance violations
       description: Automatically remediate compliance violations
       operationId: remediate
-      tags: [remediation]
+      tags:
+        - remediation
       x-ossa-capability: remediate
       x-ossa-autonomy:
         level: supervised
@@ -112,7 +120,8 @@ paths:
           application/json:
             schema:
               type: object
-              required: [violation_id]
+              required:
+                - violation_id
               properties:
                 violation_id:
                   type: string
@@ -122,7 +131,7 @@ paths:
                   default: false
                   description: Whether to automatically apply remediation
       responses:
-        '200':
+        "200":
           description: Remediation completed
           content:
             application/json:
@@ -137,13 +146,13 @@ paths:
                       type: string
                   status:
                     type: string
-
   /reports/generate:
     post:
       summary: Generate compliance report
       description: Generate FedRAMP compliance report
       operationId: generateReport
-      tags: [reporting]
+      tags:
+        - reporting
       x-ossa-capability: generate_report
       x-ossa-autonomy:
         level: autonomous
@@ -154,11 +163,15 @@ paths:
           application/json:
             schema:
               type: object
-              required: [format]
+              required:
+                - format
               properties:
                 format:
                   type: string
-                  enum: [pdf, html, json]
+                  enum:
+                    - pdf
+                    - html
+                    - json
                   default: json
                 period:
                   type: object
@@ -170,7 +183,7 @@ paths:
                       type: string
                       format: date-time
       responses:
-        '200':
+        "200":
           description: Report generated
           content:
             application/json:
@@ -189,4 +202,3 @@ paths:
                         type: integer
                       violations:
                         type: integer
-