@bluefly/openstandardagents 0.4.9 → 0.5.1

package/openapi/schemas/common/economics.yaml

@@ -0,0 +1,98 @@
+openapi: 3.1.0
+components:
+  schemas:
+    ExecutionProfile:
+      type: object
+      description: Portable contract for token/model behavior and execution economics.
+      required:
+        - intent_class
+      properties:
+        id:
+          type: string
+          description: Unique identifier for the execution profile.
+        intent_class:
+          type: string
+          enum: [micro-audit, fast-route, balanced-work, deep-reason, long-context, strict-structured, human-gated]
+          description: Standardized token class mapping to model capability.
+        latency_sla_ms:
+          type: integer
+          description: Target latency in milliseconds.
+        max_cost_usd:
+          type: number
+          description: Maximum acceptable cost in USD for this execution.
+        max_input_tokens:
+          type: integer
+        max_output_tokens:
+          type: integer
+        max_reasoning_tokens:
+          type: integer
+        preferred_modes:
+          type: array
+          items:
+            type: string
+            enum: [structured-output, tool-use, reasoning, vision]
+        fallback_chain:
+          type: array
+          items:
+            type: string
+        compression_policy:
+          type: string
+          enum: [none, extractive, semantic-brief, schema-projection, evidence-only, risk-first, diff-only]
+        cache_policy:
+          type: string
+          enum: [none, content-addressed, ttl]
+        provenance_mode:
+          type: string
+          enum: [relaxed, strict]
+    ContextPack:
+      type: object
+      description: Portable, versioned, scoped context bundle.
+      required:
+        - id
+        - version
+      properties:
+        id:
+          type: string
+        version:
+          type: string
+        description:
+          type: string
+        token_size:
+          type: integer
+        content_hash:
+          type: string
+        trust_score:
+          type: number
+        permission_scope:
+          type: array
+          items:
+            type: string
+        compression_variants:
+          type: array
+          items:
+            type: object
+            properties:
+              mode:
+                type: string
+              token_size:
+                type: integer
+              ref:
+                type: string
+    ReplayPacket:
+      type: object
+      description: Portable execution replay packet for audit and reproducibility.
+      properties:
+        compute_tokens:
+          type: integer
+        context_tokens:
+          type: integer
+        execution_profile_id:
+          type: string
+        context_pack_hashes:
+          type: array
+          items:
+            type: string
+        policy_decisions:
+          type: object
+        failure_class:
+          type: string

package/openapi/schemas/common/errors.yaml

@@ -39,7 +39,6 @@ components:
             items:
               type: string
           description: Validation errors by field
-
     ValidationError:
       type: object
       properties:
@@ -49,7 +48,6 @@ components:
           type: string
         rule:
           type: string
-
     ValidationWarning:
       type: object
       properties:
@@ -59,7 +57,6 @@ components:
           type: string
         suggestion:
           type: string
-
     ExecutionError:
       type: object
       properties:
@@ -73,3 +70,16 @@ components:
         timestamp:
           type: string
           format: date-time
+x-ossa-metadata:
+  version: 0.5.0
+  compliance:
+    level: standard
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
+x-ossa:
+  version: 0.5.0
+  agent:
+    id: schemas-common-errors
+    type: specialist

package/openapi/schemas/common/metadata.yaml

@@ -16,7 +16,6 @@ components:
           type: string
           format: date-time
           description: Timestamp when the resource was deleted (soft delete)
-
     Labels:
       type: object
       additionalProperties:
@@ -26,7 +25,6 @@ components:
         domain: security
         capability: scanning
         runtime: kubernetes
-
     Annotations:
       type: object
       additionalProperties:
@@ -43,15 +41,17 @@ components:
         deployed_by: buildkit-cli
         git_commit: abc123
         environment: production
-        author: "John Doe"
-        license: "Apache-2.0"
-
+        author: John Doe
+        license: Apache-2.0
     HealthStatus:
       type: object
       properties:
         status:
           type: string
-          enum: [healthy, degraded, unhealthy]
+          enum:
+            - healthy
+            - degraded
+            - unhealthy
         version:
           type: string
         uptime:
@@ -66,6 +66,21 @@ components:
             properties:
               status:
                 type: string
-                enum: [pass, fail]
+                enum:
+                  - pass
+                  - fail
               message:
                 type: string
+x-ossa-metadata:
+  version: 0.5.0
+  compliance:
+    level: standard
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
+x-ossa:
+  version: 0.5.0
+  agent:
+    id: schemas-common-metadata
+    type: specialist

package/openapi/schemas/common/pagination.yaml

@@ -25,7 +25,6 @@ components:
           type: boolean
         has_prev:
           type: boolean
-
   parameters:
     PageParam:
       name: page
@@ -35,7 +34,6 @@ components:
         minimum: 1
         default: 1
       description: Page number
-
     LimitParam:
       name: limit
       in: query
@@ -45,7 +43,6 @@ components:
         maximum: 100
         default: 20
       description: Items per page
-
     OffsetParam:
       name: offset
       in: query
@@ -54,19 +51,34 @@ components:
         minimum: 0
         default: 0
       description: Number of items to skip for pagination
-
     SearchParam:
       name: search
       in: query
       schema:
         type: string
       description: Search query
-
     SortParam:
       name: sort
       in: query
       schema:
         type: string
-        enum: [name, downloads, updated, created]
+        enum:
+          - name
+          - downloads
+          - updated
+          - created
         default: downloads
       description: Sort field
+x-ossa-metadata:
+  version: 0.5.0
+  compliance:
+    level: standard
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
+x-ossa:
+  version: 0.5.0
+  agent:
+    id: schemas-common-pagination
+    type: specialist

package/openapi/schemas/common/security.yaml

@@ -6,13 +6,11 @@ components:
       in: header
       name: X-API-Key
       description: API key for server-to-server authentication
-
     BearerAuth:
       type: http
       scheme: bearer
       bearerFormat: JWT
       description: JWT token obtained from authentication endpoint
-
     OAuth2:
       type: oauth2
       description: OAuth2 authorization code flow
@@ -26,11 +24,9 @@ components:
             execute: Execute agent tasks and workflows
             admin: Administrative access
             messaging: Agent-to-agent messaging
-
     AgentMTLS:
       type: mutualTLS
       description: Mutual TLS for agent-to-agent communication
-
   schemas:
     TokenResponse:
       type: object
@@ -55,7 +51,6 @@ components:
         token_id:
           type: string
           format: uuid
-
     SecurityContext:
       type: object
       properties:
@@ -86,3 +81,16 @@ components:
                 type: object
             policy_version:
               type: string
+x-ossa-metadata:
+  version: 0.5.0
+  compliance:
+    level: standard
+  observability:
+    tracing: true
+    metrics: true
+    logging: true
+x-ossa:
+  version: 0.5.0
+  agent:
+    id: schemas-common-security
+    type: specialist

package/openapi/schemas/index.yaml

@@ -10,79 +10,86 @@ info:
       $ref: '../schemas/common/agent.yaml#/components/schemas/AgentManifest'
       $ref: '../schemas/common/errors.yaml#/components/schemas/Problem'
       $ref: '../schemas/common/pagination.yaml#/components/schemas/Pagination'
-
+  contact:
+    name: Bluefly OSSA Team
+    url: https://gitlab.com/blueflyio/ossa/openstandardagents
 components:
   schemas:
-    # Agent Schemas
     AgentManifest:
-      $ref: './common/agent.yaml#/components/schemas/AgentManifest'
+      $ref: ./common/agent.yaml#/components/schemas/AgentManifest
     AgentSpec:
-      $ref: './common/agent.yaml#/components/schemas/AgentSpec'
+      $ref: ./common/agent.yaml#/components/schemas/AgentSpec
     AgentMetadata:
-      $ref: './common/agent.yaml#/components/schemas/Metadata'
+      $ref: ./common/agent.yaml#/components/schemas/Metadata
     AgentType:
-      $ref: './common/agent.yaml#/components/schemas/AgentType'
+      $ref: ./common/agent.yaml#/components/schemas/AgentType
     AgentStatus:
-      $ref: './common/agent.yaml#/components/schemas/AgentStatus'
+      $ref: ./common/agent.yaml#/components/schemas/AgentStatus
     Agent:
-      $ref: './common/agent.yaml#/components/schemas/Agent'
+      $ref: ./common/agent.yaml#/components/schemas/Agent
     Capability:
-      $ref: './common/agent.yaml#/components/schemas/Capability'
+      $ref: ./common/agent.yaml#/components/schemas/Capability
     Interface:
-      $ref: './common/agent.yaml#/components/schemas/Interface'
+      $ref: ./common/agent.yaml#/components/schemas/Interface
     Requirements:
-      $ref: './common/agent.yaml#/components/schemas/Requirements'
+      $ref: ./common/agent.yaml#/components/schemas/Requirements
     ResourceRequirements:
-      $ref: './common/agent.yaml#/components/schemas/ResourceRequirements'
-
-    # Error Schemas
+      $ref: ./common/agent.yaml#/components/schemas/ResourceRequirements
     Problem:
-      $ref: './common/errors.yaml#/components/schemas/Problem'
+      $ref: ./common/errors.yaml#/components/schemas/Problem
     ValidationError:
-      $ref: './common/errors.yaml#/components/schemas/ValidationError'
+      $ref: ./common/errors.yaml#/components/schemas/ValidationError
     ValidationWarning:
-      $ref: './common/errors.yaml#/components/schemas/ValidationWarning'
+      $ref: ./common/errors.yaml#/components/schemas/ValidationWarning
     ExecutionError:
-      $ref: './common/errors.yaml#/components/schemas/ExecutionError'
-
-    # Pagination Schemas
+      $ref: ./common/errors.yaml#/components/schemas/ExecutionError
     Pagination:
-      $ref: './common/pagination.yaml#/components/schemas/Pagination'
-
-    # Security Schemas
+      $ref: ./common/pagination.yaml#/components/schemas/Pagination
     TokenResponse:
-      $ref: './common/security.yaml#/components/schemas/TokenResponse'
+      $ref: ./common/security.yaml#/components/schemas/TokenResponse
     SecurityContext:
-      $ref: './common/security.yaml#/components/schemas/SecurityContext'
-
-    # Metadata Schemas
+      $ref: ./common/security.yaml#/components/schemas/SecurityContext
     Timestamps:
-      $ref: './common/metadata.yaml#/components/schemas/Timestamps'
+      $ref: ./common/metadata.yaml#/components/schemas/Timestamps
     Labels:
-      $ref: './common/metadata.yaml#/components/schemas/Labels'
+      $ref: ./common/metadata.yaml#/components/schemas/Labels
     Annotations:
-      $ref: './common/metadata.yaml#/components/schemas/Annotations'
+      $ref: ./common/metadata.yaml#/components/schemas/Annotations
     HealthStatus:
-      $ref: './common/metadata.yaml#/components/schemas/HealthStatus'
-
+      $ref: ./common/metadata.yaml#/components/schemas/HealthStatus
   parameters:
     PageParam:
-      $ref: './common/pagination.yaml#/components/parameters/PageParam'
+      $ref: ./common/pagination.yaml#/components/parameters/PageParam
     LimitParam:
-      $ref: './common/pagination.yaml#/components/parameters/LimitParam'
+      $ref: ./common/pagination.yaml#/components/parameters/LimitParam
     OffsetParam:
-      $ref: './common/pagination.yaml#/components/parameters/OffsetParam'
+      $ref: ./common/pagination.yaml#/components/parameters/OffsetParam
     SearchParam:
-      $ref: './common/pagination.yaml#/components/parameters/SearchParam'
+      $ref: ./common/pagination.yaml#/components/parameters/SearchParam
     SortParam:
-      $ref: './common/pagination.yaml#/components/parameters/SortParam'
-
+      $ref: ./common/pagination.yaml#/components/parameters/SortParam
   securitySchemes:
     ApiKeyAuth:
-      $ref: './common/security.yaml#/components/securitySchemes/ApiKeyAuth'
+      $ref: ./common/security.yaml#/components/securitySchemes/ApiKeyAuth
     BearerAuth:
-      $ref: './common/security.yaml#/components/securitySchemes/BearerAuth'
+      $ref: ./common/security.yaml#/components/securitySchemes/BearerAuth
     OAuth2:
-      $ref: './common/security.yaml#/components/securitySchemes/OAuth2'
+      $ref: ./common/security.yaml#/components/securitySchemes/OAuth2
     AgentMTLS:
-      $ref: './common/security.yaml#/components/securitySchemes/AgentMTLS'
+      $ref: ./common/security.yaml#/components/securitySchemes/AgentMTLS
+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: schemas-index
+    type: specialist
+servers:
+  - url: https://schemas.openstandardagents.org
+    description: Shared schema index

package/openapi/uadp-asyncapi.yaml

@@ -189,7 +189,7 @@ components:
       description: OAuth2 with client credentials for agent-to-registry auth
       flows:
         clientCredentials:
-          authorizationUrl: https://auth.openstandardagents.org/oauth/token
+          tokenUrl: https://auth.openstandardagents.org/oauth/token
           availableScopes:
             uadp:publish: Publish agent lifecycle events
             uadp:subscribe: Subscribe to registry events
@@ -198,7 +198,9 @@ components:
   parameters:
     AgentIdParam:
       description: Unique agent identifier (DNS-1123 subdomain format)
-      location: $message.payload#/agentId
+      schema:
+        type: string
+        description: Unique agent identifier (DNS-1123 subdomain format)
 
   messages:
     AgentRegisteredMessage:
@@ -225,7 +227,7 @@ components:
               type: Ed25519
               value: "base64encodedValue=="
               publicKey: "base64encodedPublicKey=="
-              issuer: "did:web:agents.bluefly.io:compliance-scanner"
+              issuer: "did:web:example.com:compliance-scanner"
               timestamp: '2026-03-02T23:00:00Z'
 
     AgentUpdatedMessage: