@bluefly/openstandardagents 0.4.9 → 0.5.0

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

@@ -4,27 +4,29 @@ info:
   version: 0.3.3
   description: |
     **Drupal llm-platform API for Agent Integration**
-    
+
     Single source of truth for all agent data:
     - Content management (nodes, taxonomy, media)
     - User management (users, roles, permissions)
     - Site building (modules, config, deployments)
     - Data aggregation (reports, analytics, tracking)
     - Workflow orchestration (agent tasks, CI/CD jobs)
-    
+
     All agents write/read data through this API.
     Drupal becomes the central data store and management platform.
-
+  contact:
+    name: Bluefly OSSA Team
+    url: https://gitlab.com/blueflyio/ossa/openstandardagents
 servers:
   - url: https://platform.orb.local/api/v1
     description: Production
   - url: http://drupal-platform.default.svc.cluster.local/api/v1
     description: Kubernetes internal
-
 security:
-  - OAuth2: [read, write]
+  - OAuth2:
+      - read
+      - write
   - ApiKeyAuth: []
-
 tags:
   - name: content
     description: Content node operations
@@ -36,12 +38,11 @@ tags:
     description: Agent session/task tracking
   - name: workflows
     description: Workflow orchestration
-
 paths:
-  # Content CRUD
   /content:
     post:
-      tags: [content]
+      tags:
+        - content
       summary: Create content node
       operationId: createContent
       requestBody:
@@ -49,17 +50,22 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/ContentCreateRequest'
+              $ref: "#/components/schemas/ContentCreateRequest"
       responses:
-        '201':
+        "201":
           description: Content created
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/ContentResponse'
-    
+                $ref: "#/components/schemas/ContentResponse"
+      x-ossa-capability: reference-create-content
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Create content node
     get:
-      tags: [content]
+      tags:
+        - content
       summary: Query content
       operationId: queryContent
       parameters:
@@ -77,18 +83,20 @@ paths:
             type: integer
             default: 50
       responses:
-        '200':
+        "200":
           description: Content list
           content:
             application/json:
               schema:
                 type: array
                 items:
-                  $ref: '#/components/schemas/ContentResponse'
-
+                  $ref: "#/components/schemas/ContentResponse"
+      x-ossa-capability: reference-query-content
+      description: Query content
   /content/{nid}:
     get:
-      tags: [content]
+      tags:
+        - content
       summary: Get content by ID
       operationId: getContent
       parameters:
@@ -98,15 +106,17 @@ paths:
           schema:
             type: integer
       responses:
-        '200':
+        "200":
           description: Content node
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/ContentResponse'
-    
+                $ref: "#/components/schemas/ContentResponse"
+      x-ossa-capability: reference-get-content
+      description: Get content by ID
     put:
-      tags: [content]
+      tags:
+        - content
       summary: Update content
       operationId: updateContent
       parameters:
@@ -120,13 +130,18 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/ContentUpdateRequest'
+              $ref: "#/components/schemas/ContentUpdateRequest"
       responses:
-        '200':
+        "200":
           description: Content updated
-    
+      x-ossa-capability: reference-update-content
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Update content
     delete:
-      tags: [content]
+      tags:
+        - content
       summary: Delete content
       operationId: deleteContent
       parameters:
@@ -136,13 +151,17 @@ paths:
           schema:
             type: integer
       responses:
-        '204':
+        "204":
           description: Content deleted
-
-  # Agent Tracking
+      x-ossa-capability: reference-delete-content
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      description: Delete content
   /agents/sessions:
     post:
-      tags: [agents]
+      tags:
+        - agents
       summary: Create agent session
       description: Track agent activity in Drupal
       operationId: createAgentSession
@@ -160,11 +179,15 @@ paths:
                   type: string
                 session_type:
                   type: string
-                  enum: [coding, chat, workflow, deployment]
+                  enum:
+                    - coding
+                    - chat
+                    - workflow
+                    - deployment
                 metadata:
                   type: object
       responses:
-        '201':
+        "201":
           description: Session created
           content:
             application/json:
@@ -175,10 +198,14 @@ paths:
                     type: string
                   drupal_nid:
                     type: integer
-
+      x-ossa-capability: reference-create-agent-session
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
   /agents/tasks:
     post:
-      tags: [agents]
+      tags:
+        - agents
       summary: Log agent task
       description: Store agent task execution in Drupal for tracking/reporting
       operationId: logAgentTask
@@ -199,7 +226,11 @@ paths:
                   type: string
                 status:
                   type: string
-                  enum: [queued, running, completed, failed]
+                  enum:
+                    - queued
+                    - running
+                    - completed
+                    - failed
                 input:
                   type: object
                 output:
@@ -209,13 +240,16 @@ paths:
                 error:
                   type: string
       responses:
-        '201':
+        "201":
           description: Task logged
-
-  # Site Building
+      x-ossa-capability: reference-log-agent-task
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
   /sites/create:
     post:
-      tags: [sites]
+      tags:
+        - sites
       summary: Build new Drupal site
       description: Agent orchestrates complete site build via GitLab CI
       operationId: createSite
@@ -235,17 +269,20 @@ paths:
                   type: array
                   items:
                     type: string
-                  example: ["ai_agents", "ai_provider_langchain", "mcp_registry"]
+                  example:
+                    - ai_agents
+                    - ai_provider_langchain
+                    - mcp_registry
                 theme:
                   type: string
-                  default: "llm_platform_enterprise"
+                  default: llm_platform_enterprise
                 config:
                   type: object
                 agent_id:
                   type: string
                   description: Agent responsible for build
       responses:
-        '202':
+        "202":
           description: Site build started
           content:
             application/json:
@@ -260,7 +297,10 @@ paths:
                   status_url:
                     type: string
                     format: uri
-
+      x-ossa-capability: reference-create-site
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
 components:
   securitySchemes:
     OAuth2:
@@ -273,12 +313,10 @@ components:
             read: Read access
             write: Write access
             admin: Admin access
-    
     ApiKeyAuth:
       type: apiKey
       in: header
       name: X-API-Key
-
   schemas:
     ContentCreateRequest:
       type: object
@@ -298,7 +336,7 @@ components:
               type: string
             format:
               type: string
-              default: "markdown"
+              default: markdown
         fields:
           type: object
           additionalProperties: true
@@ -309,7 +347,6 @@ components:
               type: string
             session_id:
               type: string
-
     ContentResponse:
       type: object
       properties:
@@ -332,7 +369,6 @@ components:
         changed:
           type: string
           format: date-time
-
     ContentUpdateRequest:
       type: object
       properties:
@@ -344,5 +380,20 @@ components:
           type: object
         status:
           type: string
-          enum: [published, draft, archived]
-
+          enum:
+            - published
+            - draft
+            - archived
+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-drupal-agent-api
+    type: specialist

package/openapi/reference-implementations/getting-started-hello-world-api.openapi.yaml

@@ -6,7 +6,9 @@ info:
     Minimal OSSA-compliant agent API demonstrating basic capabilities.
     This agent can greet users, echo messages, and report its status.
     Perfect for learning OSSA fundamentals and testing deployments.
-
+  contact:
+    name: Bluefly OSSA Team
+    url: https://gitlab.com/blueflyio/ossa/openstandardagents
 x-ossa-metadata:
   version: 0.2.5-RC
   compliance:
@@ -14,22 +16,23 @@ x-ossa-metadata:
     frameworks:
       - OSSA
       - OpenAPI 3.1
-
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
 x-ossa:
   version: 0.2.5-RC
   agent:
-    id: hello-world-agent
-    type: worker
+    id: reference-implementations-getting-started-hello-world-api
+    type: specialist
     compliance:
       standards:
         - openapi-first
       validated: true
-      validatedAt: "2024-01-15T10:00:00Z"
-
+      validatedAt: 2024-01-15T10:00:00Z
 servers:
   - url: http://localhost:3000
     description: Local development server
-
 tags:
   - name: greeting
     description: Greeting operations
@@ -37,14 +40,14 @@ tags:
     description: Echo operations
   - name: status
     description: Status operations
-
 paths:
   /greet:
     post:
       summary: Generate greeting
       description: Generates a personalized greeting message for a user
       operationId: greet
-      tags: [greeting]
+      tags:
+        - greeting
       x-ossa-capability: greeting
       x-ossa-autonomy:
         level: autonomous
@@ -59,19 +62,24 @@ paths:
           application/json:
             schema:
               type: object
-              required: [name]
+              required:
+                - name
               properties:
                 name:
                   type: string
                   description: Name to greet
-                  example: "Alice"
+                  example: Alice
                 language:
                   type: string
-                  enum: [en, es, fr, de]
+                  enum:
+                    - en
+                    - es
+                    - fr
+                    - de
                   default: en
                   description: Language for greeting
       responses:
-        '200':
+        "200":
           description: Greeting generated successfully
           content:
             application/json:
@@ -84,13 +92,13 @@ paths:
                   timestamp:
                     type: string
                     format: date-time
-
   /echo:
     post:
       summary: Echo input
       description: Echo back a message sent to the agent
       operationId: echo
-      tags: [echo]
+      tags:
+        - echo
       x-ossa-capability: echo_message
       x-ossa-autonomy:
         level: autonomous
@@ -101,13 +109,14 @@ paths:
           application/json:
             schema:
               type: object
-              required: [message]
+              required:
+                - message
               properties:
                 message:
                   type: string
                   description: Message to echo
       responses:
-        '200':
+        "200":
           description: Message echoed
           content:
             application/json:
@@ -119,19 +128,19 @@ paths:
                   received_at:
                     type: string
                     format: date-time
-
   /status:
     get:
       summary: Get agent status
       description: Returns the current status of the agent
       operationId: getStatus
-      tags: [status]
+      tags:
+        - status
       x-ossa-capability: get_status
       x-ossa-autonomy:
         level: autonomous
         approval_required: false
       responses:
-        '200':
+        "200":
           description: Agent status
           content:
             application/json:
@@ -140,10 +149,12 @@ paths:
                 properties:
                   status:
                     type: string
-                    enum: [online, offline, maintenance]
+                    enum:
+                      - online
+                      - offline
+                      - maintenance
                   version:
                     type: string
                   uptime:
                     type: integer
                     description: Uptime in seconds
-

package/openapi/reference-implementations/gitlab-ml-recommender-api.openapi.yaml

@@ -5,7 +5,9 @@ info:
   description: |
     AI-powered customer success recommendation agent using RAG (Retrieval-Augmented Generation).
     Provides data-driven recommendations for proactive customer engagement.
-
+  contact:
+    name: Bluefly OSSA Team
+    url: https://gitlab.com/blueflyio/ossa/openstandardagents
 x-ossa-metadata:
   version: 0.2.5-RC
   compliance:
@@ -13,29 +15,29 @@ x-ossa-metadata:
     frameworks:
       - OSSA
       - OpenAPI 3.1
-
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
 x-ossa:
   version: 0.3.3
   agent:
-    id: gitlab-ml-recommender
-    type: integrator
+    id: reference-implementations-gitlab-ml-recommender-api
+    type: specialist
     compliance:
       standards:
         - openapi-first
         - type-safe
       validated: true
-      validatedAt: "2024-01-15T10:00:00Z"
-
+      validatedAt: 2024-01-15T10:00:00Z
 servers:
   - url: https://ml-recommender.platform.com/api/v1
     description: Production
-
 tags:
   - name: recommendations
     description: Recommendation operations
   - name: search
     description: Semantic search operations
-
 paths:
   /recommendations/generate:
     post:
@@ -44,7 +46,8 @@ paths:
         Generate AI-powered recommendations using RAG pipeline.
         Performs semantic search in Qdrant and generates recommendations with GPT-4.
       operationId: generateRecommendations
-      tags: [recommendations]
+      tags:
+        - recommendations
       x-ossa-capability: generate-recommendations
       x-ossa-autonomy:
         level: autonomous
@@ -59,7 +62,8 @@ paths:
           application/json:
             schema:
               type: object
-              required: [customer_id]
+              required:
+                - customer_id
               properties:
                 customer_id:
                   type: string
@@ -72,7 +76,7 @@ paths:
                   default: 10
                   description: Maximum number of recommendations
       responses:
-        '200':
+        "200":
           description: Recommendations generated
           content:
             application/json:
@@ -98,13 +102,13 @@ paths:
                           type: string
                   customer_health_score:
                     type: number
-
   /search/semantic:
     post:
       summary: Semantic search
       description: Perform semantic search in Qdrant vector database
       operationId: semanticSearch
-      tags: [search]
+      tags:
+        - search
       x-ossa-capability: semantic-search
       x-ossa-autonomy:
         level: autonomous
@@ -115,7 +119,8 @@ paths:
           application/json:
             schema:
               type: object
-              required: [query]
+              required:
+                - query
               properties:
                 query:
                   type: string
@@ -128,7 +133,7 @@ paths:
                   type: object
                   description: Additional filters for search
       responses:
-        '200':
+        "200":
           description: Search results
           content:
             application/json:
@@ -148,4 +153,3 @@ paths:
                           type: number
                         metadata:
                           type: object
-