@bluefly/openstandardagents 0.3.1 → 0.3.2

package/spec/v0.3.2/schemas/agent-unified.yaml

@@ -0,0 +1,165 @@
+# OSSA v0.3.1 - Unified Agent Schema
+# Universal agent platform: OSSA + GitLab Duo + Google A2A + MCP
+# Zero hardcoded models, runtime-agnostic, infrastructure-driven
+
+apiVersion: ossa/v0.3.2
+kind: Agent
+
+metadata:
+  name: string
+  version: string  # semver
+  description: string
+  labels:
+    domain: string
+    capability: string
+    runtime: string
+
+spec:
+  # ============================================
+  # UNIFIED LLM CONFIGURATION
+  # No hardcoded models, runtime-configurable
+  # ============================================
+  llm:
+    provider: ${LLM_PROVIDER:-anthropic}
+    model: ${LLM_MODEL:-claude-sonnet}
+    profile: ${LLM_PROFILE:-balanced}  # NEW: A2A compatible
+    temperature: ${LLM_TEMPERATURE:-0.1}
+    maxTokens: ${LLM_MAX_TOKENS:-16000}
+    topP: ${LLM_TOP_P:-0.9}
+
+    fallback_models:
+      - provider: ${LLM_FALLBACK_PROVIDER_1:-openai}
+        model: ${LLM_FALLBACK_MODEL_1:-gpt-4o}
+        condition: on_error
+      - provider: ${LLM_FALLBACK_PROVIDER_2:-google}
+        model: ${LLM_FALLBACK_MODEL_2:-gemini-2.0-flash}
+        condition: on_rate_limit
+
+    retry_config:
+      max_attempts: ${LLM_RETRY_ATTEMPTS:-3}
+      backoff_strategy: ${LLM_BACKOFF_STRATEGY:-exponential}
+
+  # ============================================
+  # EXECUTION PROFILES (Google A2A)
+  # Task-specific optimization
+  # ============================================
+  execution_profile:
+    default: ${LLM_PROFILE:-balanced}
+    profiles:
+      fast:
+        maxTokens: 4000
+        temperature: 0.0
+        description: "Quick responses for triage"
+      balanced:
+        maxTokens: 16000
+        temperature: 0.1
+        description: "General agent operations"
+      deep:
+        maxTokens: 32000
+        temperature: 0.2
+        reasoning_enabled: true
+        description: "Deep analysis and reasoning"
+      safe:
+        temperature: 0.0
+        validation_required: true
+        audit_log: true
+        description: "Compliance and security"
+
+  # ============================================
+  # RUNTIME DECLARATION (Multi-platform)
+  # ============================================
+  runtime:
+    type: ${AGENT_RUNTIME:-unified}
+    supports:
+      - google-a2a
+      - gitlab-duo
+      - ossa-mesh
+      - mcp
+      - local-execution
+    scheduling:
+      strategy: ${AGENT_SCHEDULING:-fair}
+      priority: ${AGENT_PRIORITY:-normal}
+      max_concurrent: ${AGENT_MAX_CONCURRENT:-10}
+      timeout_seconds: ${AGENT_TIMEOUT:-300}
+    resource_limits:
+      memory_mb: ${AGENT_MEMORY_MB:-512}
+      cpu_millicores: ${AGENT_CPU_MILLICORES:-500}
+
+  # ============================================
+  # CAPABILITIES (A2A/Duo compatible)
+  # ============================================
+  capabilities:
+    - name: ${CAPABILITY_SCAN:-security_scan}
+      type: action
+      runtime: llm
+      description: "Run security analysis"
+      input_schema:
+        type: object
+        required: [path]
+        properties:
+          path:
+            type: string
+          severity:
+            type: string
+            enum: [low, medium, high, critical]
+
+  # ============================================
+  # FUNCTIONS (A2A format)
+  # OpenAI-style function calling
+  # ============================================
+  functions:
+    - name: scan_security
+      description: "Run OSSA security analysis"
+      parameters:
+        type: object
+        properties:
+          path:
+            type: string
+            description: "Path to scan"
+          severity:
+            type: string
+            enum: [low, medium, high, critical]
+        required: [path]
+      returns:
+        type: object
+        properties:
+          findings:
+            type: array
+          score:
+            type: number
+
+  # ============================================
+  # EXTENSIONS (A2A compatible)
+  # ============================================
+  extensions:
+    - type: http
+      name: ossa-mesh
+      endpoint: ${OSSA_MESH_URL}
+      credentials_ref: OSSA_MESH_TOKEN
+    - type: mcp
+      name: gitlab-mcp
+      endpoint: ${GITLAB_MCP_URL}
+      credentials_ref: GITLAB_TOKEN
+
+  # ============================================
+  # EXISTING OSSA FEATURES
+  # ============================================
+  role: string
+  taxonomy:
+    domain: string
+    subdomain: string
+    capability: string
+
+  tools:
+    - name: string
+      description: string
+      source:
+        type: mcp
+        uri: string
+
+  knowledge_graph:
+    enabled: boolean
+    provider: string
+    connection:
+      endpoint: string
+      credentials_ref: string

package/spec/v0.3.2/schemas/capabilities.yaml

@@ -0,0 +1,102 @@
+# OSSA v0.3.1 - Capabilities Schema
+# Google A2A and GitLab Duo compatible capability declarations
+
+$schema: http://json-schema.org/draft-07/schema#
+$id: https://openstandardagents.org/schemas/v0.3.1/capabilities.yaml
+
+title: Agent Capabilities
+description: |
+  Structured capability declarations compatible with Google A2A and GitLab Duo.
+  Maps agent actions to callable functions.
+
+type: array
+items:
+  type: object
+  required:
+    - name
+    - type
+  properties:
+    name:
+      type: string
+      description: Capability identifier
+      pattern: ^[a-z][a-z0-9_]*$
+      examples:
+        - security_scan
+        - code_review
+        - deploy_service
+        - analyze_logs
+
+    type:
+      type: string
+      description: Capability type
+      enum:
+        - action
+        - query
+        - transform
+        - validation
+        - orchestration
+
+    runtime:
+      type: string
+      description: Execution runtime
+      enum:
+        - llm
+        - code
+        - hybrid
+        - external
+      default: llm
+
+    description:
+      type: string
+      description: Human-readable capability description
+
+    input_schema:
+      type: object
+      description: JSON Schema for input validation
+
+    output_schema:
+      type: object
+      description: JSON Schema for output validation
+
+    requires:
+      type: array
+      description: Required dependencies
+      items:
+        type: string
+
+    timeout_seconds:
+      type: integer
+      description: Capability-specific timeout
+      default: 60
+
+    retry_policy:
+      type: object
+      properties:
+        max_attempts:
+          type: integer
+          default: 3
+        backoff:
+          type: string
+          enum: [exponential, linear, constant]
+
+examples:
+  - name: security_scan
+    type: action
+    runtime: hybrid
+    description: Run OSSA security analysis on codebase
+    input_schema:
+      type: object
+      required: [path]
+      properties:
+        path:
+          type: string
+        severity:
+          type: string
+          enum: [low, medium, high, critical]
+    output_schema:
+      type: object
+      properties:
+        findings:
+          type: array
+        score:
+          type: number

package/spec/v0.3.2/schemas/functions.yaml

@@ -0,0 +1,75 @@
+# OSSA v0.3.1 - Functions Schema
+# Google A2A compatible function declarations (OpenAI function calling format)
+
+$schema: http://json-schema.org/draft-07/schema#
+$id: https://openstandardagents.org/schemas/v0.3.1/functions.yaml
+
+title: Agent Functions
+description: |
+  Function declarations in Google A2A / OpenAI format.
+  Enables structured function calling across all runtimes.
+
+type: array
+items:
+  type: object
+  required:
+    - name
+    - description
+    - parameters
+  properties:
+    name:
+      type: string
+      description: Function name
+      pattern: ^[a-zA-Z_][a-zA-Z0-9_]*$
+
+    description:
+      type: string
+      description: What the function does
+
+    parameters:
+      type: object
+      description: JSON Schema for function parameters
+      required:
+        - type
+        - properties
+      properties:
+        type:
+          type: string
+          const: object
+        properties:
+          type: object
+        required:
+          type: array
+          items:
+            type: string
+
+    returns:
+      type: object
+      description: Return value schema
+
+    strict:
+      type: boolean
+      description: Enforce strict schema validation
+      default: true
+
+examples:
+  - name: scan_security
+    description: Run OSSA security analysis
+    parameters:
+      type: object
+      properties:
+        path:
+          type: string
+          description: Path to scan
+        severity:
+          type: string
+          enum: [low, medium, high, critical]
+          description: Minimum severity level
+      required: [path]
+    returns:
+      type: object
+      properties:
+        findings:
+          type: array
+        score:
+          type: number

package/spec/v0.3.2/schemas/messaging/channel.schema.json

@@ -0,0 +1,245 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.3.1/messaging/channel.json",
+  "title": "OSSA Channel Schema",
+  "description": "Schema for message channel configuration in OSSA v0.3.1",
+  "type": "object",
+  "required": [
+    "name",
+    "type"
+  ],
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Channel name (must follow naming conventions)",
+      "pattern": "^agents\\.([a-z0-9-]+\\.)+[a-z0-9-]+$",
+      "minLength": 3,
+      "maxLength": 256,
+      "examples": [
+        "agents.tasks.assigned",
+        "agents.code-reviewer.completed",
+        "agents.broadcast.shutdown"
+      ]
+    },
+    "type": {
+      "type": "string",
+      "enum": ["direct", "topic", "broadcast"],
+      "description": "Channel type determining routing behavior"
+    },
+    "description": {
+      "type": "string",
+      "description": "Human-readable channel description",
+      "maxLength": 512
+    },
+    "schema": {
+      "type": "string",
+      "description": "JSON Schema reference for message validation",
+      "format": "uri-reference",
+      "examples": [
+        "TaskAssigned",
+        "https://ossa.dev/schemas/messaging/TaskCompleted.schema.json"
+      ]
+    },
+    "qos": {
+      "$ref": "#/definitions/ChannelQoS",
+      "description": "Default quality of service for this channel"
+    },
+    "config": {
+      "$ref": "#/definitions/ChannelConfig",
+      "description": "Channel-specific configuration"
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Custom metadata for channel management",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false,
+  "definitions": {
+    "ChannelQoS": {
+      "type": "object",
+      "description": "Default quality of service settings for channel",
+      "properties": {
+        "deliveryMode": {
+          "type": "string",
+          "enum": ["at-most-once", "at-least-once", "exactly-once"],
+          "default": "at-least-once"
+        },
+        "persistent": {
+          "type": "boolean",
+          "default": true,
+          "description": "Messages persist to disk"
+        },
+        "ordered": {
+          "type": "boolean",
+          "default": true,
+          "description": "Maintain message order"
+        },
+        "maxRetries": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100,
+          "default": 3,
+          "description": "Maximum delivery retry attempts"
+        },
+        "retryBackoff": {
+          "type": "string",
+          "enum": ["none", "linear", "exponential"],
+          "default": "exponential",
+          "description": "Retry backoff strategy"
+        }
+      },
+      "additionalProperties": false
+    },
+    "ChannelConfig": {
+      "type": "object",
+      "description": "Channel configuration options",
+      "properties": {
+        "maxMessageSize": {
+          "type": "integer",
+          "minimum": 1024,
+          "maximum": 10485760,
+          "default": 1048576,
+          "description": "Maximum message size in bytes (default: 1MB)"
+        },
+        "maxSubscribers": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10000,
+          "default": 1000,
+          "description": "Maximum concurrent subscribers"
+        },
+        "messageRetention": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 2592000,
+          "default": 86400,
+          "description": "Message retention period in seconds (default: 24 hours, 0 = no retention)"
+        },
+        "deadLetterQueue": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable dead letter queue for failed messages"
+        },
+        "dlqChannel": {
+          "type": "string",
+          "description": "Custom DLQ channel name (default: {channel}.dlq)",
+          "pattern": "^agents\\.([a-z0-9-]+\\.)+[a-z0-9-]+$"
+        },
+        "rateLimiting": {
+          "type": "object",
+          "description": "Rate limiting configuration",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false
+            },
+            "maxMessagesPerSecond": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 100000
+            },
+            "burstSize": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 1000
+            }
+          },
+          "additionalProperties": false
+        },
+        "encryption": {
+          "type": "object",
+          "description": "Channel-level encryption settings",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false
+            },
+            "algorithm": {
+              "type": "string",
+              "enum": ["AES-256-GCM", "ChaCha20-Poly1305"],
+              "default": "AES-256-GCM"
+            },
+            "keyRef": {
+              "type": "string",
+              "description": "Reference to encryption key in secret store"
+            }
+          },
+          "required": ["enabled"],
+          "if": {
+            "properties": {
+              "enabled": { "const": true }
+            }
+          },
+          "then": {
+            "required": ["keyRef"]
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "examples": [
+    {
+      "name": "agents.tasks.assigned",
+      "type": "topic",
+      "description": "Task assignment notifications",
+      "schema": "TaskAssigned",
+      "qos": {
+        "deliveryMode": "at-least-once",
+        "persistent": true,
+        "ordered": true,
+        "maxRetries": 5,
+        "retryBackoff": "exponential"
+      },
+      "config": {
+        "maxMessageSize": 1048576,
+        "maxSubscribers": 100,
+        "messageRetention": 86400,
+        "deadLetterQueue": true,
+        "rateLimiting": {
+          "enabled": true,
+          "maxMessagesPerSecond": 1000,
+          "burstSize": 100
+        }
+      }
+    },
+    {
+      "name": "agents.code-reviewer.tasks",
+      "type": "direct",
+      "description": "Direct task assignments to code-reviewer agent",
+      "schema": "ReviewTask",
+      "qos": {
+        "deliveryMode": "exactly-once",
+        "persistent": true,
+        "ordered": true
+      },
+      "config": {
+        "maxMessageSize": 524288,
+        "messageRetention": 3600,
+        "encryption": {
+          "enabled": true,
+          "algorithm": "AES-256-GCM",
+          "keyRef": "messaging-encryption-key"
+        }
+      }
+    },
+    {
+      "name": "agents.broadcast.shutdown",
+      "type": "broadcast",
+      "description": "System-wide shutdown notification",
+      "schema": "SystemShutdown",
+      "qos": {
+        "deliveryMode": "at-most-once",
+        "persistent": false,
+        "ordered": false
+      },
+      "config": {
+        "maxMessageSize": 4096,
+        "messageRetention": 0,
+        "deadLetterQueue": false
+      }
+    }
+  ]
+}