@bluefly/openstandardagents 0.3.1 → 0.3.2

package/openapi/agent-crud.yaml

@@ -2,7 +2,7 @@ openapi: 3.1.0
 jsonSchemaDialect: https://spec.openapis.org/oas/3.1/dialect/base
 info:
   title: OSSA Agent CRUD API
-  version: 0.3.0
+  version: 0.3.2
   description: |
     # OSSA Agent CRUD Operations API
 
@@ -284,7 +284,7 @@ components:
       properties:
         apiVersion:
           type: string
-          const: ossa/v0.3.0
+          const: ossa/v0.3.2
           description: OSSA specification version
         kind:
           type: string
@@ -339,7 +339,7 @@ components:
           description: Unique identifier for the agent
         apiVersion:
           type: string
-          const: ossa/v0.3.0
+          const: ossa/v0.3.2
         kind:
           type: string
           const: Agent
@@ -887,7 +887,7 @@ components:
     CreateWorkerAgentExample:
       summary: Create a worker agent
       value:
-        apiVersion: ossa/v0.3.0
+        apiVersion: ossa/v0.3.2
         kind: Agent
         metadata:
           name: security-scanner
@@ -935,7 +935,7 @@ components:
     CreateOrchestratorAgentExample:
       summary: Create an orchestrator agent
       value:
-        apiVersion: ossa/v0.3.0
+        apiVersion: ossa/v0.3.2
         kind: Agent
         metadata:
           name: workflow-orchestrator
@@ -989,7 +989,7 @@ components:
       summary: Complete agent response
       value:
         id: 550e8400-e29b-41d4-a716-446655440000
-        apiVersion: ossa/v0.3.0
+        apiVersion: ossa/v0.3.2
         kind: Agent
         metadata:
           name: security-scanner
@@ -1049,7 +1049,7 @@ components:
       value:
         agents:
           - id: 550e8400-e29b-41d4-a716-446655440000
-            apiVersion: ossa/v0.3.0
+            apiVersion: ossa/v0.3.2
             kind: Agent
             metadata:
               name: security-scanner
@@ -1072,7 +1072,7 @@ components:
             createdAt: '2025-12-18T10:30:00Z'
             updatedAt: '2025-12-18T10:30:00Z'
           - id: 660e8400-e29b-41d4-a716-446655440001
-            apiVersion: ossa/v0.3.0
+            apiVersion: ossa/v0.3.2
             kind: Agent
             metadata:
               name: code-reviewer

package/openapi/agent-discovery.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: OSSA Agent Discovery & Registry API
-  version: 1.0.0
+  version: 0.3.2
   description: |
     Agent Discovery and Registry API for OSSA v0.3.0.
 
@@ -70,7 +70,7 @@ paths:
                   name: security-scanner
                   version: 1.0.0
                   manifest:
-                    apiVersion: ossa/v0.3.0
+                    apiVersion: ossa/v0.3.2
                     kind: Agent
                     metadata:
                       name: security-scanner

package/openapi/agent-identity.yaml

@@ -2,7 +2,7 @@ openapi: 3.1.0
 jsonSchemaDialect: https://spec.openapis.org/oas/3.1/dialect/base
 info:
   title: OSSA Agent Identity & Authentication API
-  version: 0.3.0
+  version: 0.3.2
   description: |
     # OSSA Agent Identity & Authentication API
 
@@ -157,7 +157,7 @@ paths:
                   value:
                     agent_id: "data-processor-agent"
                     instance_id: "550e8400-e29b-41d4-a716-446655440000"
-                    version: "ossa/v0.3.0"
+                    version: "ossa/v0.3.2"
                     kind: "Agent"
                     status: "active"
                     tenant_id: "tenant-123"
@@ -468,22 +468,22 @@ components:
 
   schemas:
     AgentIdentity:
-      $ref: 'https://openstandardagents.org/schemas/v0.3.0/identity.json#/definitions/AgentIdentity'
+      $ref: 'https://openstandardagents.org/schemas/v0.3.2/identity.json#/definitions/AgentIdentity'
 
     AuthenticationRequest:
-      $ref: 'https://openstandardagents.org/schemas/v0.3.0/identity.json#/definitions/AuthenticationRequest'
+      $ref: 'https://openstandardagents.org/schemas/v0.3.2/identity.json#/definitions/AuthenticationRequest'
 
     TokenResponse:
-      $ref: 'https://openstandardagents.org/schemas/v0.3.0/identity.json#/definitions/TokenResponse'
+      $ref: 'https://openstandardagents.org/schemas/v0.3.2/identity.json#/definitions/TokenResponse'
 
     SecurityContext:
-      $ref: 'https://openstandardagents.org/schemas/v0.3.0/identity.json#/definitions/SecurityContext'
+      $ref: 'https://openstandardagents.org/schemas/v0.3.2/identity.json#/definitions/SecurityContext'
 
     TokenRevocationRequest:
-      $ref: 'https://openstandardagents.org/schemas/v0.3.0/identity.json#/definitions/TokenRevocationRequest'
+      $ref: 'https://openstandardagents.org/schemas/v0.3.2/identity.json#/definitions/TokenRevocationRequest'
 
     TokenRevocationResponse:
-      $ref: 'https://openstandardagents.org/schemas/v0.3.0/identity.json#/definitions/TokenRevocationResponse'
+      $ref: 'https://openstandardagents.org/schemas/v0.3.2/identity.json#/definitions/TokenRevocationResponse'
 
     Error:
       type: object

package/openapi/cli-commands.openapi.yaml

@@ -0,0 +1,231 @@
+openapi: 3.1.0
+jsonSchemaDialect: https://spec.openapis.org/oas/3.1/dialect/base
+info:
+  title: OSSA CLI Commands API
+  version: 0.3.2
+  description: |
+    # OSSA CLI Commands OpenAPI Specification
+
+    Complete API specification for all OSSA CLI commands, ensuring type safety,
+    validation, and consistency between CLI and REST API operations.
+
+    ## Principles
+    - **DRY**: Single source of truth for command schemas
+    - **SOLID**: Command separation and dependency injection
+    - **Zod Validation**: Runtime validation for all inputs
+    - **OpenAPI First**: Spec drives CLI command definitions
+    - **CRUD Complete**: Full Create, Read, Update, Delete operations
+
+  contact:
+    name: Bluefly.io LLM Platform Team
+    url: https://github.com/blueflyio/openstandardagents
+  license:
+    name: MIT
+    url: https://opensource.org/licenses/MIT
+
+paths:
+  /cli/agent/create:
+    post:
+      summary: Create agent (CLI: ossa agent create)
+      description: Register a new agent via CLI
+      operationId: cliAgentCreate
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AgentCreateCLI'
+      responses:
+        '200':
+          description: Agent created successfully
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AgentResponse'
+        '400':
+          $ref: '#/components/responses/ValidationError'
+
+  /cli/agent/list:
+    get:
+      summary: List agents (CLI: ossa agent list)
+      description: List all agents with filtering
+      operationId: cliAgentList
+      parameters:
+        - name: search
+          in: query
+          schema:
+            type: string
+        - name: limit
+          in: query
+          schema:
+            type: integer
+            minimum: 1
+            maximum: 100
+            default: 20
+        - name: type
+          in: query
+          schema:
+            $ref: '#/components/schemas/AgentType'
+        - name: status
+          in: query
+          schema:
+            $ref: '#/components/schemas/AgentStatus'
+        - name: domain
+          in: query
+          schema:
+            type: string
+      responses:
+        '200':
+          description: List of agents
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AgentsList'
+
+  /cli/agent/get:
+    get:
+      summary: Get agent (CLI: ossa agent get)
+      description: Get detailed information about an agent
+      operationId: cliAgentGet
+      parameters:
+        - name: agent
+          in: query
+          required: true
+          schema:
+            type: string
+            pattern: '^[a-z0-9]([-a-z0-9]*[a-z0-9])?(@\d+\.\d+\.\d+(-[a-zA-Z0-9]+(\.[a-zA-Z0-9]+)*)?(\+[a-zA-Z0-9]+(\.[a-zA-Z0-9]+)*)?)?$'
+      responses:
+        '200':
+          description: Agent details
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AgentResponse'
+        '404':
+          $ref: '#/components/responses/NotFound'
+
+  /cli/agent/update:
+    put:
+      summary: Update agent (CLI: ossa agent update)
+      description: Update an existing agent
+      operationId: cliAgentUpdate
+      parameters:
+        - name: agent
+          in: query
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AgentUpdate'
+      responses:
+        '200':
+          description: Agent updated successfully
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AgentResponse'
+        '400':
+          $ref: '#/components/responses/ValidationError'
+        '404':
+          $ref: '#/components/responses/NotFound'
+
+  /cli/agent/delete:
+    delete:
+      summary: Delete agent (CLI: ossa agent delete)
+      description: Delete an agent
+      operationId: cliAgentDelete
+      parameters:
+        - name: agent
+          in: query
+          required: true
+          schema:
+            type: string
+        - name: force
+          in: query
+          schema:
+            type: boolean
+            default: false
+      responses:
+        '204':
+          description: Agent deleted successfully
+        '404':
+          $ref: '#/components/responses/NotFound'
+        '409':
+          $ref: '#/components/responses/Conflict'
+
+components:
+  schemas:
+    AgentCreateCLI:
+      type: object
+      required:
+        - path
+      properties:
+        path:
+          type: string
+          minLength: 1
+          description: Path to OSSA agent manifest file
+        registry:
+          type: string
+          enum: [gitlab, github]
+          default: gitlab
+        token:
+          type: string
+          description: Authentication token (optional, can use env var)
+        dryRun:
+          type: boolean
+          default: false
+
+    AgentType:
+      type: string
+      enum:
+        - orchestrator
+        - worker
+        - specialist
+        - critic
+        - monitor
+        - gateway
+
+    AgentStatus:
+      type: string
+      enum:
+        - registered
+        - active
+        - inactive
+        - suspended
+        - deprecated
+
+    AgentResponse:
+      $ref: '../agent-crud.yaml#/components/schemas/AgentResponse'
+
+    AgentsList:
+      $ref: '../agent-crud.yaml#/components/schemas/AgentsList'
+
+    AgentUpdate:
+      $ref: '../agent-crud.yaml#/components/schemas/AgentUpdate'
+
+  responses:
+    ValidationError:
+      $ref: '../agent-crud.yaml#/components/responses/ValidationError'
+
+    NotFound:
+      $ref: '../agent-crud.yaml#/components/responses/NotFound'
+
+    Conflict:
+      $ref: '../agent-crud.yaml#/components/responses/Conflict'
+
+x-ossa-metadata:
+  version: 0.3.1
+  compliance:
+    level: enterprise
+    frameworks:
+      - OSSA v0.3.1
+      - OpenAPI 3.1
+      - RFC7807
+  governance:
+    approved: true
+    approvedBy: Platform Team
+    approvalDate: 2025-12-23

package/openapi/core/ossa-core-api.openapi.yaml

@@ -2,7 +2,7 @@ openapi: 3.1.0
 jsonSchemaDialect: https://spec.openapis.org/oas/3.1/dialect/base
 info:
   title: OSSA Master API
-  version: 0.1.9
+  version: 0.3.2
   description: |
     # OSSA - Open Standards for Scalable Agents
 

package/openapi/core/ossa-registry-api.openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: OSSA Agent Registry API
-  version: 1.0.0
+  version: 0.3.2
   description: |
     Central registry for OSSA-compliant AI agents.
 

package/openapi/core/ossa-registry.openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: OSSA Agent Registry API
-  version: 0.1.9
+  version: 0.3.2
   license:
     name: MIT
     url: https://opensource.org/licenses/MIT

package/openapi/core/unified-agent-gateway.openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: Unified Agent Gateway
-  version: 1.0.0
+  version: 0.3.2
   description: |
     **Single Entry Point for All LLM Platform Agents**
     

package/openapi/github-sync.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: GitHub Sync API
-  version: 1.0.0
+  version: 0.3.2
   description: API for syncing GitHub PRs to GitLab
 
 servers:

package/openapi/protocols/sse-streams.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: OSSA Server-Sent Events (SSE) API
-  version: 0.3.0
+  version: 0.3.2
   description: |
     OpenAPI extension for Server-Sent Events streams in OSSA.
     Defines SSE endpoints for unidirectional server-to-client event streaming.

package/openapi/protocols/websocket-events.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: OSSA WebSocket Events API
-  version: 0.3.0
+  version: 0.3.2
   description: |
     OpenAPI extension for WebSocket event definitions in OSSA.
     Defines event schemas for bidirectional agent-to-agent messaging over WebSocket.
@@ -122,7 +122,7 @@ components:
             version:
               type: string
               description: OSSA protocol version
-              example: ossa/v0.3.0
+              example: ossa/v0.3.2
 
     Message:
       summary: General message event

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

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: AIFlow Bridge Agent API
-  version: 1.0.0
+  version: 0.3.2
   description: |
     OSSA agent with AIFlow-Agent bridge for social crypto analysis.
     Integrates with Twitter, Telegram, and Discord for autonomous social media presence.
@@ -9,7 +9,7 @@ info:
 x-ossa-metadata:
   version: 0.2.5-RC
   compliance:
-    level: intermediate
+    level: standard
     frameworks:
       - OSSA
       - OpenAPI 3.1

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

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: FedRAMP Compliance Scanner Agent API
-  version: 1.0.0
+  version: 0.3.2
   description: |
     Automated FedRAMP compliance scanning agent that validates
     infrastructure against FedRAMP Moderate controls.

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

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: CrewAI Research Agent API
-  version: 1.0.0
+  version: 0.3.2
   description: |
     CrewAI research agent for multi-agent collaboration.
     Specializes in gathering comprehensive information on assigned topics.

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

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: Code Quality Critic Agent API
-  version: 1.0.0
+  version: 0.3.2
   description: |
     Quality assurance agent for code review, testing, and continuous improvement.
     Analyzes code quality, detects issues, and suggests improvements.
@@ -9,7 +9,7 @@ info:
 x-ossa-metadata:
   version: 0.2.5-RC
   compliance:
-    level: intermediate
+    level: standard
     frameworks:
       - OSSA
       - OpenAPI 3.1

package/openapi/reference-implementations/document-analyzer-api.openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: Document Analyzer Agent API
-  version: 2.1.0
+  version: 0.3.2
   description: |
     Production document analysis agent with NLP capabilities.
     Analyzes documents for sentiment, extracts entities, generates summaries, and classifies content.
@@ -9,7 +9,7 @@ info:
 x-ossa-metadata:
   version: 0.2.5-RC
   compliance:
-    level: intermediate
+    level: standard
     frameworks:
       - OSSA
       - OpenAPI 3.1

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

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: Drupal LLM Platform Agent API
-  version: 1.0.0
+  version: 0.3.2
   description: |
     **Drupal llm-platform API for Agent Integration**
     

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

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: Hello World Agent API
-  version: 1.0.0
+  version: 0.3.2
   description: |
     Minimal OSSA-compliant agent API demonstrating basic capabilities.
     This agent can greet users, echo messages, and report its status.

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

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: GitLab ML Recommendation Engine API
-  version: 1.0.0
+  version: 0.3.2
   description: |
     AI-powered customer success recommendation agent using RAG (Retrieval-Augmented Generation).
     Provides data-driven recommendations for proactive customer engagement.
@@ -9,7 +9,7 @@ info:
 x-ossa-metadata:
   version: 0.2.5-RC
   compliance:
-    level: intermediate
+    level: standard
     frameworks:
       - OSSA
       - OpenAPI 3.1

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

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: Policy Compliance Governor Agent API
-  version: 1.1.0
+  version: 0.3.2
   description: |
     Governance agent enforcing policies, compliance, and security standards across systems.
     Validates compliance, assesses risks, and generates audit reports.

package/openapi/reference-implementations/helm-generator.openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: OSSA Helm Chart Generator API
-  version: 1.0.0
+  version: 0.3.2
   description: |
     Generates Helm charts from OSSA agent manifests.
 

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

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: Multi-System Integrator Agent API
-  version: 1.4.0
+  version: 0.3.2
   description: |
     Enterprise integration agent for connecting heterogeneous systems and APIs.
     Transforms protocols, maps schemas, and routes messages between systems.

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

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: Decision Arbitration Judge Agent API
-  version: 1.0.0
+  version: 0.3.2
   description: |
     Ultimate decision-making agent for conflict resolution and final arbitration.
     Makes decisions, resolves disputes, and prioritizes requests.

package/openapi/reference-implementations/k8s-troubleshooter-api.openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: Kubernetes Troubleshooter Agent API
-  version: 1.0.0
+  version: 0.3.2
   description: |
     Autonomous Kubernetes cluster troubleshooting agent with diagnostic capabilities.
     Diagnoses pod failures, network issues, resource constraints, and configuration problems.
@@ -9,7 +9,7 @@ info:
 x-ossa-metadata:
   version: 0.2.5-RC
   compliance:
-    level: intermediate
+    level: standard
     frameworks:
       - OSSA
       - OpenAPI 3.1

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

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: LangChain Agent API
-  version: 1.0.0
+  version: 0.3.2
   description: |
     LangChain agent with tool chain integration.
     Uses tools to accomplish tasks with memory and chain capabilities.

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

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: System Performance Monitor Agent API
-  version: 1.3.0
+  version: 0.3.2
   description: |
     Real-time monitoring agent for system health, performance, and resource utilization.
     Collects metrics, detects anomalies, and generates alerts.
@@ -9,7 +9,7 @@ info:
 x-ossa-metadata:
   version: 0.2.5-RC
   compliance:
-    level: intermediate
+    level: standard
     frameworks:
       - OSSA
       - OpenAPI 3.1

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

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: Multi-Workflow Orchestrator Agent API
-  version: 2.1.0
+  version: 0.3.2
   description: |
     Enterprise orchestrator managing complex multi-agent workflows across distributed systems.
     Coordinates worker agents, manages dependencies, and handles failure recovery.

package/openapi/reference-implementations/quickstart-support-agent-api.openapi.yaml

@@ -1,7 +1,7 @@
 openapi: 3.1.0
 info:
   title: Customer Support Agent API
-  version: 1.0.0
+  version: 0.3.2
   description: |
     A helpful customer support agent that answers questions and helps with orders.
     Demonstrates OSSA quickstart patterns for production-ready agents.
@@ -9,7 +9,7 @@ info:
 x-ossa-metadata:
   version: 0.2.5-RC
   compliance:
-    level: intermediate
+    level: standard
     frameworks:
       - OSSA
       - OpenAPI 3.1