@bluefly/openstandardagents 0.2.4 → 0.2.7

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]

package/openapi/github-sync.yaml

@@ -0,0 +1,115 @@
+openapi: 3.1.0
+info:
+  title: GitHub Sync API
+  version: 1.0.0
+  description: API for syncing GitHub PRs to GitLab
+
+servers:
+  - url: http://localhost:3000
+    description: Development
+
+paths:
+  /sync/pr/{number}:
+    post:
+      summary: Sync GitHub PR to GitLab
+      operationId: syncPR
+      tags: [Sync]
+      parameters:
+        - name: number
+          in: path
+          required: true
+          schema:
+            type: integer
+      responses:
+        '200':
+          description: MR created
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GitLabMR'
+
+  /sync/batch:
+    post:
+      summary: Batch sync PRs
+      operationId: batchSync
+      tags: [Sync]
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                author:
+                  type: string
+                  example: app/dependabot
+      responses:
+        '200':
+          description: Batch MR created
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GitLabMR'
+
+  /sync/list:
+    get:
+      summary: List syncable PRs
+      operationId: listPRs
+      tags: [Sync]
+      parameters:
+        - name: author
+          in: query
+          schema:
+            type: string
+      responses:
+        '200':
+          description: List of PRs
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/GitHubPR'
+
+components:
+  schemas:
+    GitHubPR:
+      type: object
+      required: [number, title, author, state]
+      properties:
+        number:
+          type: integer
+        title:
+          type: string
+        body:
+          type: string
+          nullable: true
+        author:
+          type: object
+          properties:
+            login:
+              type: string
+        state:
+          type: string
+          enum: [open, closed]
+
+    GitLabMR:
+      type: object
+      required: [iid, title, source_branch, target_branch, state, web_url]
+      properties:
+        iid:
+          type: integer
+        title:
+          type: string
+        description:
+          type: string
+          nullable: true
+        source_branch:
+          type: string
+        target_branch:
+          type: string
+        state:
+          type: string
+          enum: [opened, closed, merged]
+        web_url:
+          type: string
+          format: uri

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

@@ -0,0 +1,136 @@
+openapi: 3.1.0
+info:
+  title: AIFlow Bridge Agent API
+  version: 1.0.0
+  description: |
+    OSSA agent with AIFlow-Agent bridge for social crypto analysis.
+    Integrates with Twitter, Telegram, and Discord for autonomous social media presence.
+
+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: crypto-analyst-agent
+    type: chat
+    compliance:
+      standards:
+        - openapi-first
+      validated: true
+      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]
+      x-ossa-capability: analyze_market
+      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: [token]
+              properties:
+                token:
+                  type: string
+                  description: Token symbol (e.g., BNB, CAKE)
+                timeframe:
+                  type: string
+                  enum: [1h, 24h, 7d, 30d]
+                  default: 24h
+      responses:
+        '200':
+          description: Market analysis completed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  token:
+                    type: string
+                  sentiment:
+                    type: string
+                    enum: [bullish, bearish, neutral]
+                  analysis:
+                    type: string
+                  metrics:
+                    type: object
+                    properties:
+                      price_change:
+                        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]
+      x-ossa-capability: post_social
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [content, platform]
+              properties:
+                content:
+                  type: string
+                  description: Post content
+                platform:
+                  type: string
+                  enum: [twitter, telegram, discord]
+                character:
+                  type: string
+                  description: Character persona to use
+      responses:
+        '200':
+          description: Post published
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  post_id:
+                    type: string
+                  platform:
+                    type: string
+                  url:
+                    type: string
+                    format: uri
+                  status:
+                    type: string
+                    enum: [published, pending_approval]
+

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

@@ -0,0 +1,192 @@
+openapi: 3.1.0
+info:
+  title: FedRAMP Compliance Scanner Agent API
+  version: 1.0.0
+  description: |
+    Automated FedRAMP compliance scanning agent that validates
+    infrastructure against FedRAMP Moderate controls.
+
+x-ossa-metadata:
+  version: 0.2.5-RC
+  compliance:
+    level: enterprise
+    frameworks:
+      - OSSA
+      - OpenAPI 3.1
+      - FedRAMP
+      - SOC2
+  governance:
+    approved: true
+    approvedBy: Security Team
+    approvalDate: "2024-01-15"
+
+x-ossa:
+  version: 0.2.5-RC
+  agent:
+    id: fedramp-compliance-scanner
+    type: worker
+    compliance:
+      standards:
+        - openapi-first
+        - type-safe
+      validated: true
+      validatedAt: "2024-01-15T10:00:00Z"
+
+servers:
+  - url: https://compliance-scanner.platform.com/api/v1
+    description: Production
+
+tags:
+  - name: scanning
+    description: Compliance scanning operations
+  - name: remediation
+    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]
+      x-ossa-capability: scan_infrastructure
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [namespace]
+              properties:
+                namespace:
+                  type: string
+                  description: Kubernetes namespace to scan
+                controls:
+                  type: array
+                  items:
+                    type: string
+                  description: Specific controls to check (e.g., AC-2, AC-3)
+      responses:
+        '200':
+          description: Scan completed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  compliant:
+                    type: boolean
+                  violations:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        control:
+                          type: string
+                        severity:
+                          type: string
+                          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]
+      x-ossa-capability: remediate
+      x-ossa-autonomy:
+        level: supervised
+        approval_required: true
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [violation_id]
+              properties:
+                violation_id:
+                  type: string
+                  description: Violation identifier from scan
+                auto_apply:
+                  type: boolean
+                  default: false
+                  description: Whether to automatically apply remediation
+      responses:
+        '200':
+          description: Remediation completed
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  remediated:
+                    type: boolean
+                  actions:
+                    type: array
+                    items:
+                      type: string
+                  status:
+                    type: string
+
+  /reports/generate:
+    post:
+      summary: Generate compliance report
+      description: Generate FedRAMP compliance report
+      operationId: generateReport
+      tags: [reporting]
+      x-ossa-capability: generate_report
+      x-ossa-autonomy:
+        level: autonomous
+        approval_required: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              required: [format]
+              properties:
+                format:
+                  type: string
+                  enum: [pdf, html, json]
+                  default: json
+                period:
+                  type: object
+                  properties:
+                    start:
+                      type: string
+                      format: date-time
+                    end:
+                      type: string
+                      format: date-time
+      responses:
+        '200':
+          description: Report generated
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  report_url:
+                    type: string
+                    format: uri
+                  summary:
+                    type: object
+                    properties:
+                      total_controls:
+                        type: integer
+                      compliant:
+                        type: integer
+                      violations:
+                        type: integer
+