@bluefly/openstandardagents 0.2.4 → 0.2.7

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

@@ -0,0 +1,151 @@
+openapi: 3.1.0
+info:
+  title: GitLab ML Recommendation Engine API
+  version: 1.0.0
+  description: |
+    AI-powered customer success recommendation agent using RAG (Retrieval-Augmented Generation).
+    Provides data-driven recommendations for proactive customer engagement.
+
+x-ossa-metadata:
+  version: 0.2.5-RC
+  compliance:
+    level: intermediate
+    frameworks:
+      - OSSA
+      - OpenAPI 3.1
+
+x-ossa:
+  version: 0.2.5-RC
+  agent:
+    id: gitlab-ml-recommender
+    type: integration
+    compliance:
+      standards:
+        - openapi-first
+        - type-safe
+      validated: true
+      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:
+      summary: Generate recommendations
+      description: |
+        Generate AI-powered recommendations using RAG pipeline.
+        Performs semantic search in Qdrant and generates recommendations with GPT-4.
+      operationId: generateRecommendations
+      tags: [recommendations]
+      x-ossa-capability: generate-recommendations
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      x-ossa-llm:
+        provider: openai
+        model: gpt-4
+        temperature: 0.7
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [customer_id]
+              properties:
+                customer_id:
+                  type: string
+                  description: Customer identifier
+                context:
+                  type: object
+                  description: Additional context for recommendations
+                limit:
+                  type: integer
+                  default: 10
+                  description: Maximum number of recommendations
+      responses:
+        '200':
+          description: Recommendations generated
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  recommendations:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        title:
+                          type: string
+                        description:
+                          type: string
+                        priority:
+                          type: string
+                        confidence:
+                          type: number
+                        source:
+                          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]
+      x-ossa-capability: semantic-search
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [query]
+              properties:
+                query:
+                  type: string
+                  description: Search query text
+                top_k:
+                  type: integer
+                  default: 5
+                  description: Number of results to return
+                filters:
+                  type: object
+                  description: Additional filters for search
+      responses:
+        '200':
+          description: Search results
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  results:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        text:
+                          type: string
+                        score:
+                          type: number
+                        metadata:
+                          type: object
+

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

@@ -0,0 +1,193 @@
+openapi: 3.1.0
+info:
+  title: Policy Compliance Governor Agent API
+  version: 1.1.0
+  description: |
+    Governance agent enforcing policies, compliance, and security standards across systems.
+    Validates compliance, assesses risks, and generates audit reports.
+
+x-ossa-metadata:
+  version: 0.2.5-RC
+  compliance:
+    level: enterprise
+    frameworks:
+      - OSSA
+      - OpenAPI 3.1
+      - SOC2
+      - PCI-DSS
+      - GDPR
+      - HIPAA
+      - ISO27001
+  governance:
+    approved: true
+    approvedBy: Governance Team
+    approvalDate: "2024-01-15"
+
+x-ossa:
+  version: 0.2.5-RC
+  agent:
+    id: policy-compliance-governor
+    type: governor
+    compliance:
+      standards:
+        - openapi-first
+        - type-safe
+      validated: true
+      validatedAt: "2024-01-15T10:00:00Z"
+
+servers:
+  - url: https://governor.platform.com/api/v1
+    description: Production
+
+tags:
+  - name: policies
+    description: Policy enforcement operations
+  - name: compliance
+    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]
+      x-ossa-capability: enforce-policies
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [policy, resource]
+              properties:
+                policy:
+                  type: string
+                  description: Policy identifier
+                resource:
+                  type: object
+                  description: Resource to enforce policy on
+                mode:
+                  type: string
+                  enum: [advisory, blocking, logging]
+                  default: blocking
+      responses:
+        '200':
+          description: Policy enforced
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  allowed:
+                    type: boolean
+                  reason:
+                    type: string
+                  violations:
+                    type: array
+                    items:
+                      type: object
+
+  /compliance/validate:
+    post:
+      summary: Validate compliance
+      description: Validate resource or system against compliance framework
+      operationId: validateCompliance
+      tags: [compliance]
+      x-ossa-capability: validate-compliance
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [framework, resource]
+              properties:
+                framework:
+                  type: string
+                  enum: [soc2, pci-dss, gdpr, hipaa, iso27001]
+                resource:
+                  type: object
+                controls:
+                  type: array
+                  items:
+                    type: string
+      responses:
+        '200':
+          description: Compliance validation completed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  compliant:
+                    type: boolean
+                  violations:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        control:
+                          type: string
+                        severity:
+                          type: string
+                        description:
+                          type: string
+                  score:
+                    type: number
+
+  /audit/generate:
+    post:
+      summary: Generate audit report
+      description: Generate audit report for compliance tracking
+      operationId: generateAuditReport
+      tags: [audit]
+      x-ossa-capability: generate-reports
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [period]
+              properties:
+                period:
+                  type: object
+                  properties:
+                    start:
+                      type: string
+                      format: date-time
+                    end:
+                      type: string
+                      format: date-time
+                format:
+                  type: string
+                  enum: [json, pdf, html]
+                  default: json
+      responses:
+        '200':
+          description: Audit report generated
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  report_id:
+                    type: string
+                  report_url:
+                    type: string
+                    format: uri
+                  summary:
+                    type: object
+

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

@@ -0,0 +1,165 @@
+openapi: 3.1.0
+info:
+  title: Multi-System Integrator Agent API
+  version: 1.4.0
+  description: |
+    Enterprise integration agent for connecting heterogeneous systems and APIs.
+    Transforms protocols, maps schemas, and routes messages between systems.
+
+x-ossa-metadata:
+  version: 0.2.5-RC
+  compliance:
+    level: enterprise
+    frameworks:
+      - OSSA
+      - OpenAPI 3.1
+
+x-ossa:
+  version: 0.2.5-RC
+  agent:
+    id: multi-system-integrator
+    type: integrator
+    compliance:
+      standards:
+        - openapi-first
+        - type-safe
+      validated: true
+      validatedAt: "2024-01-15T10:00:00Z"
+
+servers:
+  - url: https://integrator.platform.com/api/v1
+    description: Production
+
+tags:
+  - name: integration
+    description: System integration operations
+  - name: transformation
+    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]
+      x-ossa-capability: connect-systems
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [systems]
+              properties:
+                systems:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      system_id:
+                        type: string
+                      protocol:
+                        type: string
+                      endpoint:
+                        type: string
+                mapping:
+                  type: object
+                  description: Schema mapping configuration
+      responses:
+        '200':
+          description: Systems connected
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  connection_id:
+                    type: string
+                  status:
+                    type: string
+                    enum: [connected, failed]
+
+  /transform:
+    post:
+      summary: Transform data
+      description: Transform data between different formats and schemas
+      operationId: transformData
+      tags: [transformation]
+      x-ossa-capability: map-schemas
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [data, from_format, to_format]
+              properties:
+                data:
+                  type: object
+                from_format:
+                  type: string
+                to_format:
+                  type: string
+                mapping:
+                  type: object
+      responses:
+        '200':
+          description: Data transformed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  transformed:
+                    type: object
+                  metadata:
+                    type: object
+
+  /route:
+    post:
+      summary: Route message
+      description: Route message to appropriate system based on routing rules
+      operationId: routeMessage
+      tags: [routing]
+      x-ossa-capability: route-messages
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [message, destination]
+              properties:
+                message:
+                  type: object
+                destination:
+                  type: string
+                routing_rules:
+                  type: object
+      responses:
+        '200':
+          description: Message routed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  routed:
+                    type: boolean
+                  destination:
+                    type: string
+                  status:
+                    type: string
+

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

@@ -0,0 +1,148 @@
+openapi: 3.1.0
+info:
+  title: Decision Arbitration Judge Agent API
+  version: 1.0.0
+  description: |
+    Ultimate decision-making agent for conflict resolution and final arbitration.
+    Makes decisions, resolves disputes, and prioritizes requests.
+
+x-ossa-metadata:
+  version: 0.2.5-RC
+  compliance:
+    level: enterprise
+    frameworks:
+      - OSSA
+      - OpenAPI 3.1
+  governance:
+    approved: true
+    approvedBy: Architecture Council
+    approvalDate: "2024-01-15"
+
+x-ossa:
+  version: 0.2.5-RC
+  agent:
+    id: decision-arbitration-judge
+    type: judge
+    compliance:
+      standards:
+        - openapi-first
+        - type-safe
+      validated: true
+      validatedAt: "2024-01-15T10:00:00Z"
+
+servers:
+  - url: https://judge.platform.com/api/v1
+    description: Production
+
+tags:
+  - name: arbitration
+    description: Arbitration operations
+  - name: decisions
+    description: Decision-making operations
+
+paths:
+  /arbitrate:
+    post:
+      summary: Arbitrate conflict
+      description: Resolve conflicts between agents or requests using consensus algorithm
+      operationId: arbitrateConflict
+      tags: [arbitration]
+      x-ossa-capability: arbitrate-conflicts
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      x-ossa-llm:
+        provider: openai
+        model: gpt-4
+        temperature: 0.1
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [conflict, participants]
+              properties:
+                conflict:
+                  type: object
+                  description: Conflict description
+                participants:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      agent_id:
+                        type: string
+                      position:
+                        type: object
+                criteria:
+                  type: object
+                  properties:
+                    business_value:
+                      type: number
+                    technical_feasibility:
+                      type: number
+                    risk_assessment:
+                      type: number
+      responses:
+        '200':
+          description: Arbitration completed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  decision:
+                    type: object
+                  resolution:
+                    type: string
+                  consensus_score:
+                    type: number
+                  participants:
+                    type: array
+                    items:
+                      type: object
+
+  /decide:
+    post:
+      summary: Make decision
+      description: Make a decision based on weighted criteria and priorities
+      operationId: makeDecision
+      tags: [decisions]
+      x-ossa-capability: make-decisions
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [options, criteria]
+              properties:
+                options:
+                  type: array
+                  items:
+                    type: object
+                criteria:
+                  type: object
+                weights:
+                  type: object
+      responses:
+        '200':
+          description: Decision made
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  selected_option:
+                    type: object
+                  score:
+                    type: number
+                  reasoning:
+                    type: string
+                  confidence:
+                    type: number
+