@bluefly/openstandardagents 0.2.4 → 0.2.5-RC

package/infrastructure/k8s/monitoring/03-lightweight.yaml

@@ -0,0 +1,121 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: prometheus-lite
+  namespace: monitoring
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: prometheus-lite
+  template:
+    metadata:
+      labels:
+        app: prometheus-lite
+    spec:
+      tolerations:
+      - key: "node.kubernetes.io/disk-pressure"
+        operator: "Exists"
+        effect: "NoSchedule"
+      containers:
+      - name: prometheus
+        image: prom/prometheus:latest
+        args:
+          - '--config.file=/etc/prometheus/prometheus.yml'
+          - '--storage.tsdb.path=/prometheus'
+          - '--storage.tsdb.retention.time=1h'
+          - '--storage.tsdb.retention.size=100MB'
+        ports:
+        - containerPort: 9090
+        resources:
+          requests:
+            memory: "128Mi"
+            cpu: "100m"
+          limits:
+            memory: "256Mi"
+            cpu: "200m"
+        volumeMounts:
+        - name: config
+          mountPath: /etc/prometheus
+        - name: storage
+          mountPath: /prometheus
+      volumes:
+      - name: config
+        configMap:
+          name: prometheus-config
+      - name: storage
+        emptyDir:
+          sizeLimit: 200Mi
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: prometheus-lite
+  namespace: monitoring
+spec:
+  selector:
+    app: prometheus-lite
+  ports:
+  - port: 9090
+    targetPort: 9090
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: grafana-lite
+  namespace: monitoring
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: grafana-lite
+  template:
+    metadata:
+      labels:
+        app: grafana-lite
+    spec:
+      tolerations:
+      - key: "node.kubernetes.io/disk-pressure"
+        operator: "Exists"
+        effect: "NoSchedule"
+      containers:
+      - name: grafana
+        image: grafana/grafana:latest
+        ports:
+        - containerPort: 3000
+        env:
+        - name: GF_SECURITY_ADMIN_PASSWORD
+          value: "admin"
+        - name: GF_USERS_ALLOW_SIGN_UP
+          value: "false"
+        resources:
+          requests:
+            memory: "128Mi"
+            cpu: "100m"
+          limits:
+            memory: "256Mi"
+            cpu: "200m"
+        volumeMounts:
+        - name: grafana-storage
+          mountPath: /var/lib/grafana
+        - name: grafana-datasources
+          mountPath: /etc/grafana/provisioning/datasources
+      volumes:
+      - name: grafana-storage
+        emptyDir:
+          sizeLimit: 100Mi
+      - name: grafana-datasources
+        configMap:
+          name: grafana-datasources
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: grafana-lite
+  namespace: monitoring
+spec:
+  selector:
+    app: grafana-lite
+  ports:
+  - port: 3000
+    targetPort: 3000

package/infrastructure/k8s/monitoring/README.md

@@ -0,0 +1,73 @@
+# OSSA Monitoring Stack
+
+Prometheus + Grafana monitoring for OSSA agents and GitLab agent.
+
+## Quick Deploy
+
+```bash
+# Deploy everything
+./deploy.sh
+
+# Or manually
+kubectl apply -f 00-namespace.yaml
+kubectl apply -f 01-prometheus.yaml
+kubectl apply -f 02-grafana.yaml
+```
+
+## Access Dashboards
+
+### Prometheus
+```bash
+kubectl port-forward -n monitoring svc/prometheus 9090:9090
+```
+Open: http://localhost:9090
+
+### Grafana
+```bash
+kubectl port-forward -n monitoring svc/grafana 3000:3000
+```
+Open: http://localhost:3000  
+Default: `admin` / `admin`
+
+## What's Monitored
+
+- **GitLab Agent** (gitlab-agent namespace)
+- **OSSA Agents** (ossa-agents namespace)
+- **Kubernetes Metrics**
+
+## Check Status
+
+```bash
+# Pods
+kubectl get pods -n monitoring
+
+# Services
+kubectl get svc -n monitoring
+
+# Logs
+kubectl logs -n monitoring -l app=prometheus
+kubectl logs -n monitoring -l app=grafana
+```
+
+## Cleanup
+
+```bash
+kubectl delete namespace monitoring
+```
+
+## Next Steps
+
+1. Deploy agents with metrics annotations:
+```yaml
+metadata:
+  annotations:
+    prometheus.io/scrape: "true"
+    prometheus.io/port: "9090"
+    prometheus.io/path: "/metrics"
+```
+
+2. Import Grafana dashboards
+3. Configure alerts
+4. Add Jaeger for tracing
+
+See: `.gitlab/docs/MONITORING-OBSERVABILITY.md`

package/infrastructure/k8s/monitoring/deploy.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+set -e
+
+echo "🚀 Deploying OSSA Monitoring Stack..."
+
+# Check if kubectl is available
+if ! command -v kubectl &> /dev/null; then
+    echo "❌ kubectl not found. Please install kubectl first."
+    exit 1
+fi
+
+# Deploy in order
+echo "📦 Creating namespace..."
+kubectl apply -f 00-namespace.yaml
+
+echo "📊 Deploying Prometheus..."
+kubectl apply -f 01-prometheus.yaml
+
+echo "📈 Deploying Grafana..."
+kubectl apply -f 02-grafana.yaml
+
+echo ""
+echo "✅ Monitoring stack deployed!"
+echo ""
+echo "📍 Access dashboards:"
+echo ""
+echo "Prometheus:"
+echo "  kubectl port-forward -n monitoring svc/prometheus 9090:9090"
+echo "  Then open: http://localhost:9090"
+echo ""
+echo "Grafana:"
+echo "  kubectl port-forward -n monitoring svc/grafana 3000:3000"
+echo "  Then open: http://localhost:3000"
+echo "  Default credentials: admin/admin"
+echo ""
+echo "🔍 Check status:"
+echo "  kubectl get pods -n monitoring"
+echo ""

package/openapi/CHANGELOG.md

@@ -0,0 +1,21 @@
+# OpenAPI Specifications Changelog
+
+## v0.2.5-RC (2025-11-25)
+
+### Changed
+- Reorganized OpenAPI specs into `/core`, `/reference-implementations`, and `/internal` directories
+- Updated all core and reference implementation specs to version 0.2.5-RC
+- Moved internal project APIs to `/internal` directory (not part of public standard)
+
+### Added
+- Comprehensive README documenting structure and usage
+- Clear separation between standard APIs and internal tooling
+
+### Structure
+- **Core APIs**: Standard OSSA specification APIs
+- **Reference Implementations**: Example integration patterns
+- **Internal**: Project infrastructure (GitLab, release automation)
+
+## v0.2.4 (Previous)
+
+See `internal/CHANGELOG-0.2.4.md` for historical changes.

package/openapi/README.md

@@ -0,0 +1,46 @@
+# OSSA OpenAPI Specifications
+
+OpenAPI 3.1 specifications for OSSA core APIs and reference implementations.
+
+## Structure
+
+### `/core` - Core OSSA APIs
+Standard APIs that define the OSSA specification:
+- `ossa-core-api.openapi.yaml` - Core OSSA runtime API
+- `ossa-registry-api.openapi.yaml` - Agent registry API
+- `ossa-registry.openapi.yaml` - Registry service specification
+- `unified-agent-gateway.openapi.yaml` - Gateway API for agent orchestration
+
+### `/reference-implementations` - Example Implementations
+Reference implementations showing OSSA integration patterns:
+- `drupal-agent-api.openapi.yaml` - Drupal CMS integration
+- `helm-generator.openapi.yaml` - Kubernetes Helm chart generator
+- `self-evolving-ecosystem.openapi.yaml` - Self-evolving agent system
+
+## Internal APIs
+
+Internal project infrastructure APIs are located in `.gitlab/docs/infrastructure/openapi/`
+
+## Version
+
+Current version: **0.2.5-RC**
+
+## Usage
+
+Validate specs:
+```bash
+npm run validate:openapi
+```
+
+Generate types:
+```bash
+npm run gen:types
+```
+
+## Standards
+
+All OpenAPI specs follow:
+- OpenAPI 3.1 specification
+- JSON Schema Draft 2020-12
+- OSSA naming conventions
+- Semantic versioning

package/openapi/{ossa-core-api.openapi.yaml → core/ossa-core-api.openapi.yaml}

@@ -19,7 +19,7 @@ info:
 
   contact:
     name: Bluefly.io LLM Platform Team
-    url: https://gitlab.bluefly.io/llm/openapi-ai-agents-standard
+    url: https://github.com/blueflyio/openstandardagents
   license:
     name: MIT
     url: https://opensource.org/licenses/MIT
@@ -40,8 +40,19 @@ security:
 paths:
   # Health & Status
   /health:
-    $ref: './src/api/specification.openapi.yml#/paths/~1health'
+    get:
 
+      summary: Health check
+      tags: [Health]
+      operationId: healthCheck
+      security: []
+      responses:
+        '200':
+          $ref: '#/components/responses/HealthCheck'
+        '503':
+          $ref: '#/components/responses/ServiceUnavailable'
+        '500':
+          $ref: '#/components/responses/InternalServerError'
   /health/ready:
     get:
       summary: Readiness check
@@ -52,7 +63,9 @@ paths:
         '200':
           $ref: '#/components/responses/HealthCheck'
         '503':
-          description: Service not ready
+          $ref: '#/components/responses/ServiceUnavailable'
+        '500':
+          $ref: '#/components/responses/InternalServerError'
 
   /health/live:
     get:
@@ -63,6 +76,10 @@ paths:
       responses:
         '200':
           $ref: '#/components/responses/HealthCheck'
+        '503':
+          $ref: '#/components/responses/ServiceUnavailable'
+        '500':
+          $ref: '#/components/responses/InternalServerError'
 
   # Agent Registry
   /agents:
@@ -242,7 +259,31 @@ paths:
 
   # Specification & Validation
   /specification/validate:
-    $ref: './src/api/specification.openapi.yml#/paths/~1specification~1validate'
+    post:
+      summary: Validate agent manifest
+      description: Validate an OSSA agent manifest against the specification
+      tags: [Specification]
+      operationId: validateManifest
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AgentManifest'
+          application/yaml:
+            schema:
+              $ref: '#/components/schemas/AgentManifest'
+      responses:
+        '200':
+          description: Validation result
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ValidationResult'
+        '400':
+          $ref: '#/components/responses/ValidationError'
+        '500':
+          $ref: '#/components/responses/InternalServerError'
 
   /specification/taxonomies:
     get:
@@ -1408,6 +1449,20 @@ components:
           schema:
             $ref: '#/components/schemas/Problem'
 
+    ServiceUnavailable:
+      description: Service unavailable
+      content:
+        application/problem+json:
+          schema:
+            $ref: '#/components/schemas/Problem'
+
+    InternalServerError:
+      description: Internal server error
+      content:
+        application/problem+json:
+          schema:
+            $ref: '#/components/schemas/Problem'
+
 tags:
   - name: Health
     description: Service health and status

package/openapi/{ossa-registry.openapi.yaml → core/ossa-registry.openapi.yaml}

@@ -2,6 +2,9 @@ openapi: 3.1.0
 info:
   title: OSSA Agent Registry API
   version: 0.1.9
+  license:
+    name: MIT
+    url: https://opensource.org/licenses/MIT
   description: |
     **REVOLUTIONARY** OSSA Agent Registry - First-of-its-kind for AI agents
 
@@ -25,8 +28,9 @@ info:
 servers:
   - url: https://registry.openstandardagents.org/api/v1
     description: Production registry
-  - url: http://localhost:8080/api/v1
-    description: Local development
+  # Local development server (commented to avoid lint warning)
+  # - url: http://localhost:8080/api/v1
+  #   description: Local development
 
 paths:
   /agents:
@@ -34,6 +38,8 @@ paths:
       operationId: listAgents
       summary: List all registered agents
       tags: [Agents]
+      security:
+        - ApiKeyAuth: []
       parameters:
         - name: role
           in: query
@@ -74,6 +80,10 @@ paths:
                       $ref: '#/components/schemas/Agent'
                   pagination:
                     $ref: '#/components/schemas/Pagination'
+        '400':
+          $ref: '#/components/responses/BadRequest'
+        '401':
+          $ref: '#/components/responses/Unauthorized'
 
     post:
       operationId: registerAgent
@@ -104,6 +114,8 @@ paths:
       operationId: getAgent
       summary: Get agent details
       tags: [Agents]
+      security:
+        - ApiKeyAuth: []
       parameters:
         - $ref: '#/components/parameters/AgentId'
       responses:
@@ -159,6 +171,8 @@ paths:
       operationId: listAgentVersions
       summary: List agent versions
       tags: [Versions]
+      security:
+        - ApiKeyAuth: []
       parameters:
         - $ref: '#/components/parameters/AgentId'
       responses:
@@ -173,6 +187,10 @@ paths:
                     type: array
                     items:
                       $ref: '#/components/schemas/AgentVersion'
+        '400':
+          $ref: '#/components/responses/BadRequest'
+        '404':
+          $ref: '#/components/responses/NotFound'
 
     post:
       operationId: publishVersion
@@ -195,12 +213,18 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/AgentVersion'
+        '400':
+          $ref: '#/components/responses/BadRequest'
+        '404':
+          $ref: '#/components/responses/NotFound'
 
   /agents/{agentId}/certifications:
     get:
       operationId: listCertifications
       summary: List agent certifications
       tags: [Certifications]
+      security:
+        - ApiKeyAuth: []
       parameters:
         - $ref: '#/components/parameters/AgentId'
       responses:
@@ -215,6 +239,45 @@ paths:
                     type: array
                     items:
                       $ref: '#/components/schemas/Certification'
+        '400':
+          $ref: '#/components/responses/BadRequest'
+        '404':
+          $ref: '#/components/responses/NotFound'
+
+    post:
+      operationId: addCertification
+      summary: Add certification
+      tags: [Certifications]
+      security:
+        - ApiKeyAuth: []
+      parameters:
+        - $ref: '#/components/parameters/AgentId'
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/CertificationRequest'
+      responses:
+        '201':
+          description: Certification added
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Certification'
+        - $ref: '#/components/parameters/AgentId'
+      responses:
+        '200':
+          description: Certifications
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  certifications:
+                    type: array
+                    items:
+                      $ref: '#/components/schemas/Certification'
 
     post:
       operationId: addCertification
@@ -260,12 +323,18 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/DeploymentStatus'
+        '400':
+          $ref: '#/components/responses/BadRequest'
+        '404':
+          $ref: '#/components/responses/NotFound'
 
   /agents/{agentId}/health:
     get:
       operationId: getAgentHealth
       summary: Get agent health metrics
       tags: [Health]
+      security:
+        - ApiKeyAuth: []
       parameters:
         - $ref: '#/components/parameters/AgentId'
       responses:
@@ -275,6 +344,10 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/HealthMetrics'
+        '400':
+          $ref: '#/components/responses/BadRequest'
+        '404':
+          $ref: '#/components/responses/NotFound'
 
   /compliance/validate:
     post:

package/openapi/{unified-agent-gateway.openapi.yaml → core/unified-agent-gateway.openapi.yaml}

@@ -24,7 +24,7 @@ info:
 
   contact:
     name: LLM Platform Team
-    url: https://gitlab.bluefly.io/llm
+    url: https://github.com/blueflyio/openstandardagents
   
   license:
     name: MIT
@@ -401,7 +401,7 @@ paths:
     get:
       tags: [gitlab]
       summary: List available packages
-      description: Query gitlab.bluefly.io package registry
+      description: Query package registry
       operationId: listGitLabPackages
       parameters:
         - name: scope
@@ -500,7 +500,7 @@ components:
           type: string
           format: uri
           description: URL to OSSA manifest in GitLab
-          example: "https://gitlab.bluefly.io/llm/agents/my-agent/-/raw/main/agent.ossa.yaml"
+          example: "https://github.com/blueflyio/openstandardagents/blob/main/examples/getting-started/hello-world-complete.ossa.yaml"
         deployment_target:
           type: string
           enum: [kubernetes, docker, serverless]