@bluefly/openstandardagents 0.2.7 → 0.2.8

package/{spec/v0.2.6-dev/ossa-0.2.5.schema.json → dist/spec/v0.2.8/ossa-0.2.8.schema.json}

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://openstandardagents.org/schemas/v0.2.5/agent.json",
-  "title": "OSSA v0.2.5-RC Agent Manifest Schema",
+  "$id": "https://openstandardagents.org/schemas/v0.2.8/agent.json",
+  "title": "OSSA v0.2.8 Agent Manifest Schema",
   "description": "Open Standard for Scalable AI Agents (OSSA) - The OpenAPI for AI Agents. Specification for declarative agent definition with framework-agnostic portability.",
   "type": "object",
   "required": [
@@ -13,10 +13,12 @@
   "properties": {
     "apiVersion": {
       "type": "string",
-      "pattern": "^ossa/v(0\\.2\\.[2-5](-dev)?|1)(\\.[0-9]+)?(-[a-zA-Z0-9]+)?$",
-      "description": "OSSA API version (supports ossa/v0.2.2, ossa/v0.2.3, ossa/v0.2.5, or ossa/v1 for compatibility)",
+      "pattern": "^ossa/v(0\\.2\\.[2-8](-dev)?|1)(\\.[0-9]+)?(-[a-zA-Z0-9]+)?$",
+      "description": "OSSA API version (supports ossa/v0.2.2 through ossa/v0.2.8, or ossa/v1 for compatibility)",
       "examples": [
         "ossa/v1",
+        "ossa/v0.2.8",
+        "ossa/v0.2.6",
         "ossa/v0.2.5",
         "ossa/v0.2.3",
         "ossa/v0.2.2",
@@ -87,6 +89,9 @@
         },
         "google_adk": {
           "$ref": "#/definitions/GoogleADKExtension"
+        },
+        "a2a": {
+          "$ref": "#/definitions/A2AExtension"
         }
       },
       "additionalProperties": true
@@ -169,6 +174,21 @@
         },
         "state": {
           "$ref": "#/definitions/State"
+        },
+        "security": {
+          "$ref": "#/definitions/Security"
+        },
+        "reliability": {
+          "$ref": "#/definitions/Reliability"
+        },
+        "collaboration": {
+          "$ref": "#/definitions/Collaboration"
+        },
+        "safety": {
+          "$ref": "#/definitions/Safety"
+        },
+        "deployment": {
+          "$ref": "#/definitions/Deployment"
         }
       },
       "additionalProperties": true
@@ -266,6 +286,62 @@
           "minimum": -2,
           "maximum": 2,
           "description": "Presence penalty for token generation"
+        },
+        "fallback_models": {
+          "type": "array",
+          "description": "Fallback models to use if primary model fails",
+          "items": {
+            "type": "object",
+            "properties": {
+              "provider": {
+                "type": "string",
+                "enum": ["openai", "anthropic", "google", "azure", "ollama", "custom"]
+              },
+              "model": {
+                "type": "string"
+              }
+            },
+            "required": ["provider", "model"]
+          }
+        },
+        "retry_config": {
+          "type": "object",
+          "description": "Retry configuration for LLM calls",
+          "properties": {
+            "max_attempts": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 5,
+              "default": 3
+            },
+            "backoff_strategy": {
+              "type": "string",
+              "enum": ["fixed", "exponential"],
+              "default": "exponential"
+            }
+          }
+        },
+        "cost_tracking": {
+          "type": "object",
+          "description": "Cost tracking and budgeting",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false
+            },
+            "budget_alert_threshold": {
+              "type": "number",
+              "minimum": 0,
+              "description": "Alert when cost exceeds this threshold"
+            },
+            "cost_allocation_tags": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "string"
+              },
+              "description": "Tags for cost allocation"
+            }
+          }
         }
       },
       "additionalProperties": false
@@ -303,7 +379,6 @@
         },
         "endpoint": {
           "type": "string",
-          "format": "uri",
           "description": "HTTP/gRPC endpoint (for type=http/grpc)"
         },
         "capabilities": {
@@ -353,12 +428,57 @@
             "type": "string"
           },
           "description": "Compliance framework tags (e.g., 'pii', 'hipaa', 'gdpr', 'fedramp')"
+        },
+        "health_check": {
+          "type": "object",
+          "description": "Health check configuration for this tool",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false
+            },
+            "endpoint": {
+              "type": "string",
+              "description": "Health check endpoint"
+            },
+            "interval_seconds": {
+              "type": "integer",
+              "minimum": 1,
+              "default": 30
+            },
+            "timeout_seconds": {
+              "type": "integer",
+              "minimum": 1,
+              "default": 5
+            }
+          }
+        },
+        "circuit_breaker": {
+          "type": "object",
+          "description": "Circuit breaker configuration for this tool",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false
+            },
+            "failure_threshold": {
+              "type": "integer",
+              "minimum": 1,
+              "default": 5
+            },
+            "timeout_seconds": {
+              "type": "number",
+              "minimum": 0,
+              "default": 60
+            }
+          }
         }
       },
       "additionalProperties": false
     },
     "Capability": {
       "type": "object",
+      "required": ["name"],
       "properties": {
         "name": {
           "type": "string",
@@ -390,6 +510,31 @@
           "type": "object",
           "description": "JSON Schema for capability output"
         },
+        "examples": {
+          "type": "array",
+          "description": "Example invocations of this capability",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Example name"
+              },
+              "description": {
+                "type": "string",
+                "description": "Example description"
+              },
+              "input": {
+                "type": "object",
+                "description": "Example input"
+              },
+              "output": {
+                "type": "object",
+                "description": "Expected output"
+              }
+            }
+          }
+        },
         "transport": {
           "$ref": "#/definitions/Transport"
         },
@@ -406,6 +551,134 @@
             "type": "string"
           },
           "description": "Compliance framework tags for this capability"
+        },
+        "timeout": {
+          "type": "object",
+          "description": "Timeout configuration for capability execution",
+          "properties": {
+            "execution_seconds": {
+              "type": "number",
+              "minimum": 0,
+              "description": "Maximum execution time in seconds"
+            },
+            "connection_seconds": {
+              "type": "number",
+              "minimum": 0,
+              "description": "Connection timeout in seconds"
+            }
+          }
+        },
+        "retry_policy": {
+          "type": "object",
+          "description": "Retry policy for failed capability invocations",
+          "properties": {
+            "max_attempts": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 10,
+              "default": 3,
+              "description": "Maximum retry attempts"
+            },
+            "backoff_strategy": {
+              "type": "string",
+              "enum": ["fixed", "exponential", "linear"],
+              "default": "exponential",
+              "description": "Backoff strategy between retries"
+            },
+            "initial_delay_ms": {
+              "type": "integer",
+              "minimum": 0,
+              "default": 1000,
+              "description": "Initial delay in milliseconds"
+            },
+            "max_delay_ms": {
+              "type": "integer",
+              "minimum": 0,
+              "default": 30000,
+              "description": "Maximum delay in milliseconds"
+            },
+            "retryable_errors": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Error codes/types that should trigger retry"
+            }
+          }
+        },
+        "error_handling": {
+          "type": "object",
+          "description": "Error handling configuration",
+          "properties": {
+            "fallback_capability": {
+              "type": "string",
+              "description": "Fallback capability to use on failure"
+            },
+            "error_mapping": {
+              "type": "object",
+              "description": "Map internal errors to standard error codes",
+              "additionalProperties": {
+                "type": "string"
+              }
+            },
+            "on_error": {
+              "type": "string",
+              "enum": ["fail", "fallback", "ignore", "retry"],
+              "default": "fail",
+              "description": "Action to take on error"
+            }
+          }
+        },
+        "caching": {
+          "type": "object",
+          "description": "Caching configuration for capability results",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false,
+              "description": "Enable result caching"
+            },
+            "ttl_seconds": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Cache TTL in seconds"
+            },
+            "cache_key_fields": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Input fields to use for cache key generation"
+            },
+            "invalidation_strategy": {
+              "type": "string",
+              "enum": ["ttl", "manual", "event_driven"],
+              "default": "ttl"
+            }
+          }
+        },
+        "idempotency": {
+          "type": "object",
+          "description": "Idempotency configuration",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false,
+              "description": "Whether this capability is idempotent"
+            },
+            "key_fields": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Fields used to determine idempotency"
+            },
+            "ttl_seconds": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "How long to track idempotency keys"
+            }
+          }
         }
       },
       "additionalProperties": false
@@ -449,6 +722,39 @@
             "application/x-ndjson",
             "text/event-stream"
           ]
+        },
+        "rateLimit": {
+          "type": "object",
+          "description": "Rate limiting configuration for this transport",
+          "properties": {
+            "requestsPerMinute": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Maximum requests per minute"
+            },
+            "requestsPerHour": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Maximum requests per hour"
+            },
+            "burstLimit": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Maximum burst of concurrent requests"
+            },
+            "strategy": {
+              "type": "string",
+              "enum": ["fixed_window", "sliding_window", "token_bucket", "leaky_bucket"],
+              "default": "sliding_window",
+              "description": "Rate limiting algorithm"
+            },
+            "onExceeded": {
+              "type": "string",
+              "enum": ["reject", "queue", "throttle"],
+              "default": "reject",
+              "description": "Behavior when rate limit is exceeded"
+            }
+          }
         }
       },
       "additionalProperties": false
@@ -497,6 +803,40 @@
               "type": "object",
               "description": "Storage-specific configuration",
               "additionalProperties": true
+            },
+            "encryption": {
+              "type": "object",
+              "description": "Encryption configuration for stored state data",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": false,
+                  "description": "Enable encryption for state storage"
+                },
+                "algorithm": {
+                  "type": "string",
+                  "enum": ["aes-256-gcm", "aes-256-cbc", "chacha20-poly1305"],
+                  "default": "aes-256-gcm",
+                  "description": "Encryption algorithm"
+                },
+                "keyRef": {
+                  "type": "string",
+                  "description": "Secret reference for encryption key (e.g., 'vault:secret/data/agent-keys')"
+                },
+                "keyRotation": {
+                  "type": "object",
+                  "properties": {
+                    "enabled": {
+                      "type": "boolean",
+                      "default": false
+                    },
+                    "interval": {
+                      "type": "string",
+                      "description": "Key rotation interval (e.g., '30d', '90d')"
+                    }
+                  }
+                }
+              }
             }
           },
           "additionalProperties": false
@@ -649,8 +989,7 @@
               ]
             },
             "endpoint": {
-              "type": "string",
-              "format": "uri"
+              "type": "string"
             }
           }
         },
@@ -670,8 +1009,7 @@
               ]
             },
             "endpoint": {
-              "type": "string",
-              "format": "uri"
+              "type": "string"
             }
           }
         },
@@ -697,6 +1035,66 @@
               "default": "json"
             }
           }
+        },
+        "alerting": {
+          "type": "object",
+          "description": "Alerting configuration",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false
+            },
+            "channels": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": ["email", "slack", "pagerduty", "webhook", "sns"]
+              },
+              "description": "Alert notification channels"
+            },
+            "rules": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string"
+                  },
+                  "condition": {
+                    "type": "string",
+                    "description": "Alert condition (e.g., 'error_rate > 5%')"
+                  },
+                  "severity": {
+                    "type": "string",
+                    "enum": ["critical", "warning", "info"]
+                  }
+                }
+              }
+            }
+          }
+        },
+        "slo": {
+          "type": "object",
+          "description": "Service Level Objectives",
+          "properties": {
+            "availability": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100,
+              "description": "Target availability percentage"
+            },
+            "latency_p95_ms": {
+              "type": "number",
+              "minimum": 0,
+              "description": "P95 latency target in milliseconds"
+            },
+            "error_budget": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100,
+              "description": "Allowed error budget percentage"
+            }
+          }
         }
       },
       "additionalProperties": false
@@ -739,7 +1137,10 @@
             },
             "strategy": {
               "type": "string",
-              "enum": ["rolling-update", "recreate"],
+              "enum": [
+                "rolling-update",
+                "recreate"
+              ],
               "default": "rolling-update"
             }
           }
@@ -783,7 +1184,11 @@
             },
             "runtime": {
               "type": "string",
-              "enum": ["docker", "podman", "containerd"],
+              "enum": [
+                "docker",
+                "podman",
+                "containerd"
+              ],
               "default": "docker"
             },
             "resources": {
@@ -851,7 +1256,6 @@
         },
         "endpoint": {
           "type": "string",
-          "format": "uri",
           "description": "LibreChat API endpoint"
         },
         "authentication": {
@@ -871,7 +1275,11 @@
         },
         "server_type": {
           "type": "string",
-          "enum": ["stdio", "sse", "websocket"],
+          "enum": [
+            "stdio",
+            "sse",
+            "websocket"
+          ],
           "default": "stdio"
         },
         "server_name": {
@@ -881,32 +1289,129 @@
         "config": {
           "type": "object",
           "description": "MCP server configuration"
-        }
-      },
-      "additionalProperties": true
-    },
-    "LangChainExtension": {
-      "type": "object",
-      "description": "LangChain framework integration extension",
-      "properties": {
-        "enabled": {
-          "type": "boolean",
-          "default": false
-        },
-        "tool_class": {
-          "type": "string",
-          "description": "LangChain tool class name"
         },
-        "chain_type": {
+        "resources": {
+          "type": "array",
+          "description": "MCP resources exposed by this agent",
+          "items": {
+            "type": "object",
+            "required": ["uri", "name"],
+            "properties": {
+              "uri": {
+                "type": "string",
+                "description": "Resource URI (e.g., file://, http://, custom://)"
+              },
+              "name": {
+                "type": "string",
+                "description": "Resource display name"
+              },
+              "description": {
+                "type": "string",
+                "description": "Resource description"
+              },
+              "mimeType": {
+                "type": "string",
+                "description": "Resource MIME type"
+              }
+            }
+          }
+        },
+        "prompts": {
+          "type": "array",
+          "description": "MCP prompts exposed by this agent",
+          "items": {
+            "type": "object",
+            "required": ["name"],
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Prompt identifier"
+              },
+              "description": {
+                "type": "string",
+                "description": "Prompt description"
+              },
+              "arguments": {
+                "type": "array",
+                "description": "Prompt arguments",
+                "items": {
+                  "type": "object",
+                  "required": ["name"],
+                  "properties": {
+                    "name": {
+                      "type": "string"
+                    },
+                    "description": {
+                      "type": "string"
+                    },
+                    "required": {
+                      "type": "boolean",
+                      "default": false
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "tools": {
+          "type": "array",
+          "description": "MCP tools configuration",
+          "items": {
+            "type": "object",
+            "required": ["name"],
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Tool name"
+              },
+              "description": {
+                "type": "string",
+                "description": "Tool description"
+              },
+              "inputSchema": {
+                "type": "object",
+                "description": "JSON Schema for tool input"
+              }
+            }
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "LangChainExtension": {
+      "type": "object",
+      "description": "LangChain framework integration extension",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": false
+        },
+        "tool_class": {
+          "type": "string",
+          "description": "LangChain tool class name"
+        },
+        "chain_type": {
           "type": "string",
-          "enum": ["llm", "retrieval", "agent", "sequential", "custom"]
+          "enum": [
+            "llm",
+            "retrieval",
+            "agent",
+            "sequential",
+            "custom"
+          ]
         },
         "memory": {
           "type": "object",
           "properties": {
             "type": {
               "type": "string",
-              "enum": ["buffer", "summary", "conversation", "vector"]
+              "enum": [
+                "buffer",
+                "summary",
+                "conversation",
+                "vector"
+              ]
             },
             "max_tokens": {
               "type": "integer"
@@ -926,7 +1431,13 @@
         },
         "agent_type": {
           "type": "string",
-          "enum": ["worker", "manager", "researcher", "analyst", "custom"]
+          "enum": [
+            "worker",
+            "manager",
+            "researcher",
+            "analyst",
+            "custom"
+          ]
         },
         "role": {
           "type": "string",
@@ -1113,7 +1624,6 @@
             },
             "endpoint": {
               "type": "string",
-              "format": "uri",
               "description": "Custom tracing endpoint (for provider=custom)"
             }
           },
@@ -1133,7 +1643,12 @@
         },
         "agent_type": {
           "type": "string",
-          "enum": ["composer", "chat", "background", "cloud"],
+          "enum": [
+            "composer",
+            "chat",
+            "background",
+            "cloud"
+          ],
           "default": "composer",
           "description": "Cursor agent type (composer, chat, background, or cloud)"
         },
@@ -1186,7 +1701,11 @@
           "properties": {
             "provider": {
               "type": "string",
-              "enum": ["openai", "anthropic", "custom"],
+              "enum": [
+                "openai",
+                "anthropic",
+                "custom"
+              ],
               "default": "openai"
             },
             "name": {
@@ -1217,7 +1736,6 @@
         },
         "endpoint": {
           "type": "string",
-          "format": "uri",
           "description": "Langflow API endpoint"
         },
         "api_key": {
@@ -1260,7 +1778,12 @@
         },
         "agent_type": {
           "type": "string",
-          "enum": ["assistant", "user_proxy", "groupchat", "custom"],
+          "enum": [
+            "assistant",
+            "user_proxy",
+            "groupchat",
+            "custom"
+          ],
           "description": "AutoGen agent type"
         },
         "system_message": {
@@ -1269,7 +1792,11 @@
         },
         "human_input_mode": {
           "type": "string",
-          "enum": ["ALWAYS", "NEVER", "TERMINATE"],
+          "enum": [
+            "ALWAYS",
+            "NEVER",
+            "TERMINATE"
+          ],
           "default": "NEVER",
           "description": "When to request human input"
         },
@@ -1329,7 +1856,10 @@
         },
         "runtime": {
           "type": "string",
-          "enum": ["edge", "nodejs"],
+          "enum": [
+            "edge",
+            "nodejs"
+          ],
           "default": "edge",
           "description": "Runtime environment (edge or nodejs)"
         },
@@ -1380,7 +1910,12 @@
         },
         "agent_type": {
           "type": "string",
-          "enum": ["query_engine", "chat_engine", "retriever", "custom"],
+          "enum": [
+            "query_engine",
+            "chat_engine",
+            "retriever",
+            "custom"
+          ],
           "description": "LlamaIndex agent/engine type"
         },
         "llm": {
@@ -1388,7 +1923,12 @@
           "properties": {
             "provider": {
               "type": "string",
-              "enum": ["openai", "anthropic", "local", "custom"]
+              "enum": [
+                "openai",
+                "anthropic",
+                "local",
+                "custom"
+              ]
             },
             "model": {
               "type": "string"
@@ -1406,7 +1946,14 @@
           "properties": {
             "type": {
               "type": "string",
-              "enum": ["pinecone", "weaviate", "chroma", "qdrant", "milvus", "custom"]
+              "enum": [
+                "pinecone",
+                "weaviate",
+                "chroma",
+                "qdrant",
+                "milvus",
+                "custom"
+              ]
             },
             "config": {
               "type": "object",
@@ -1510,7 +2057,12 @@
             },
             "type": {
               "type": "string",
-              "enum": ["memory", "sqlite", "postgres", "custom"]
+              "enum": [
+                "memory",
+                "sqlite",
+                "postgres",
+                "custom"
+              ]
             }
           }
         }
@@ -1529,13 +2081,16 @@
         "model": {
           "type": "string",
           "enum": [
+            "claude-opus-4-5-20251101",
+            "claude-sonnet-4-5-20250929",
+            "claude-haiku-4-5-20251001",
             "claude-3-5-sonnet-20241022",
             "claude-3-5-haiku-20241022",
             "claude-3-opus-20240229",
             "claude-3-sonnet-20240229",
             "claude-3-haiku-20240307"
           ],
-          "default": "claude-3-5-sonnet-20241022",
+          "default": "claude-sonnet-4-5-20250929",
           "description": "Claude model version"
         },
         "system": {
@@ -1545,9 +2100,9 @@
         "max_tokens": {
           "type": "integer",
           "minimum": 1,
-          "maximum": 4096,
+          "maximum": 32000,
           "default": 4096,
-          "description": "Maximum tokens in response"
+          "description": "Maximum tokens in response (Claude 4.5 supports up to 32K output tokens)"
         },
         "temperature": {
           "type": "number",
@@ -1573,7 +2128,11 @@
                 "description": "Tool input schema (JSON Schema)"
               }
             },
-            "required": ["name", "description", "input_schema"]
+            "required": [
+              "name",
+              "description",
+              "input_schema"
+            ]
           }
         },
         "streaming": {
@@ -1602,14 +2161,24 @@
         },
         "agent_type": {
           "type": "string",
-          "enum": ["llm_agent", "sequential_agent", "parallel_agent", "loop_agent", "custom"],
+          "enum": [
+            "llm_agent",
+            "sequential_agent",
+            "parallel_agent",
+            "loop_agent",
+            "conditional_agent",
+            "custom"
+          ],
           "default": "llm_agent",
           "description": "ADK agent type"
         },
         "model": {
           "type": "string",
           "description": "Gemini model to use",
-          "examples": ["gemini-2.0-flash-exp", "gemini-1.5-pro"]
+          "examples": [
+            "gemini-2.0-flash-exp",
+            "gemini-1.5-pro"
+          ]
         },
         "instruction": {
           "type": "string",
@@ -1626,7 +2195,11 @@
               },
               "type": {
                 "type": "string",
-                "enum": ["function", "agent", "mcp_server"]
+                "enum": [
+                  "function",
+                  "agent",
+                  "mcp_server"
+                ]
               },
               "config": {
                 "type": "object",
@@ -1648,7 +2221,11 @@
           "properties": {
             "service": {
               "type": "string",
-              "enum": ["in_memory", "database", "vertex_ai"],
+              "enum": [
+                "in_memory",
+                "database",
+                "vertex_ai"
+              ],
               "default": "in_memory"
             },
             "state_schema": {
@@ -1667,7 +2244,10 @@
             },
             "service": {
               "type": "string",
-              "enum": ["in_memory", "vertex_ai_rag"]
+              "enum": [
+                "in_memory",
+                "vertex_ai_rag"
+              ]
             }
           }
         },
@@ -1691,6 +2271,883 @@
         }
       },
       "additionalProperties": true
+    },
+    "A2AExtension": {
+      "type": "object",
+      "description": "Agent-to-Agent (A2A) protocol extension for inter-agent communication",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": false,
+          "description": "Enable A2A protocol support"
+        },
+        "agent_card": {
+          "type": "object",
+          "description": "A2A Agent Card configuration for discovery",
+          "properties": {
+            "name": {
+              "type": "string",
+              "description": "Agent display name"
+            },
+            "description": {
+              "type": "string",
+              "description": "Agent description for discovery"
+            },
+            "url": {
+              "type": "string",
+              "format": "uri",
+              "description": "Agent endpoint URL"
+            },
+            "version": {
+              "type": "string",
+              "description": "Agent version"
+            },
+            "capabilities": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "List of capabilities the agent exposes"
+            },
+            "authentication": {
+              "type": "object",
+              "properties": {
+                "schemes": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": ["bearer", "oauth2", "mtls", "apikey", "none"]
+                  },
+                  "description": "Supported authentication schemes"
+                }
+              }
+            },
+            "provider": {
+              "type": "object",
+              "properties": {
+                "organization": {
+                  "type": "string"
+                },
+                "url": {
+                  "type": "string",
+                  "format": "uri"
+                }
+              }
+            }
+          }
+        },
+        "supported_content_types": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "default": ["application/json"],
+          "description": "Content types the agent can process",
+          "examples": [
+            ["application/json", "text/plain", "application/x-ndjson"]
+          ]
+        },
+        "skills": {
+          "type": "array",
+          "description": "Skills exposed via A2A protocol",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Skill identifier"
+              },
+              "name": {
+                "type": "string",
+                "description": "Skill display name"
+              },
+              "description": {
+                "type": "string",
+                "description": "Skill description"
+              },
+              "input_modes": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": ["text", "file", "data"]
+                }
+              },
+              "output_modes": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": ["text", "file", "data"]
+                }
+              }
+            }
+          }
+        },
+        "streaming": {
+          "type": "string",
+          "enum": ["none", "response"],
+          "default": "none",
+          "description": "A2A streaming mode"
+        },
+        "push_notifications": {
+          "type": "object",
+          "description": "Push notification configuration",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false
+            },
+            "webhook_url": {
+              "type": "string",
+              "format": "uri",
+              "description": "Webhook URL for push notifications"
+            }
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "Security": {
+      "type": "object",
+      "description": "Security configuration for agent operations",
+      "properties": {
+        "authentication": {
+          "type": "object",
+          "properties": {
+            "required": {
+              "type": "boolean",
+              "default": true,
+              "description": "Whether authentication is required"
+            },
+            "methods": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": ["bearer", "oauth2", "mtls", "apikey", "jwt", "saml"]
+              },
+              "description": "Supported authentication methods"
+            },
+            "mfa_required": {
+              "type": "boolean",
+              "default": false,
+              "description": "Require multi-factor authentication"
+            }
+          }
+        },
+        "authorization": {
+          "type": "object",
+          "properties": {
+            "model": {
+              "type": "string",
+              "enum": ["rbac", "abac", "acl", "custom"],
+              "default": "rbac",
+              "description": "Authorization model"
+            },
+            "roles": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Required roles for agent access"
+            },
+            "permissions": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Required permissions"
+            }
+          }
+        },
+        "encryption": {
+          "type": "object",
+          "properties": {
+            "in_transit": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": true
+                },
+                "tls_version": {
+                  "type": "string",
+                  "enum": ["1.2", "1.3"],
+                  "default": "1.3"
+                },
+                "cipher_suites": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              }
+            },
+            "at_rest": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": false
+                },
+                "algorithm": {
+                  "type": "string",
+                  "enum": ["aes-256-gcm", "aes-256-cbc", "chacha20-poly1305"],
+                  "default": "aes-256-gcm"
+                },
+                "key_management": {
+                  "type": "string",
+                  "enum": ["kms", "vault", "hsm", "manual"],
+                  "description": "Key management system"
+                }
+              }
+            }
+          }
+        },
+        "secrets": {
+          "type": "object",
+          "properties": {
+            "provider": {
+              "type": "string",
+              "enum": ["vault", "aws_secrets_manager", "azure_key_vault", "gcp_secret_manager", "kubernetes"],
+              "description": "Secret management provider"
+            },
+            "rotation": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": false
+                },
+                "interval_days": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "description": "Secret rotation interval in days"
+                }
+              }
+            }
+          }
+        },
+        "audit": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true
+            },
+            "log_level": {
+              "type": "string",
+              "enum": ["minimal", "standard", "detailed"],
+              "default": "standard"
+            },
+            "retention_days": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Audit log retention period"
+            },
+            "pii_redaction": {
+              "type": "boolean",
+              "default": true,
+              "description": "Redact PII from audit logs"
+            }
+          }
+        },
+        "compliance": {
+          "type": "object",
+          "properties": {
+            "frameworks": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": ["soc2", "hipaa", "gdpr", "fedramp", "pci-dss", "iso27001"]
+              },
+              "description": "Compliance frameworks this agent adheres to"
+            },
+            "data_residency": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Allowed data residency regions (ISO 3166-1 alpha-2)"
+            }
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "Reliability": {
+      "type": "object",
+      "description": "Reliability and resilience configuration",
+      "properties": {
+        "sla": {
+          "type": "object",
+          "properties": {
+            "availability_percent": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100,
+              "description": "Target availability percentage (e.g., 99.9)"
+            },
+            "latency_p50_ms": {
+              "type": "number",
+              "minimum": 0,
+              "description": "P50 latency target in milliseconds"
+            },
+            "latency_p95_ms": {
+              "type": "number",
+              "minimum": 0,
+              "description": "P95 latency target in milliseconds"
+            },
+            "latency_p99_ms": {
+              "type": "number",
+              "minimum": 0,
+              "description": "P99 latency target in milliseconds"
+            },
+            "error_rate_percent": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100,
+              "description": "Maximum acceptable error rate percentage"
+            }
+          }
+        },
+        "circuit_breaker": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true
+            },
+            "failure_threshold": {
+              "type": "integer",
+              "minimum": 1,
+              "default": 5,
+              "description": "Number of failures before opening circuit"
+            },
+            "timeout_seconds": {
+              "type": "number",
+              "minimum": 0,
+              "default": 60,
+              "description": "Time to wait before attempting to close circuit"
+            },
+            "half_open_requests": {
+              "type": "integer",
+              "minimum": 1,
+              "default": 3,
+              "description": "Number of test requests in half-open state"
+            }
+          }
+        },
+        "health_check": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true
+            },
+            "endpoint": {
+              "type": "string",
+              "description": "Health check endpoint path"
+            },
+            "interval_seconds": {
+              "type": "integer",
+              "minimum": 1,
+              "default": 30,
+              "description": "Health check interval"
+            },
+            "timeout_seconds": {
+              "type": "integer",
+              "minimum": 1,
+              "default": 5
+            },
+            "unhealthy_threshold": {
+              "type": "integer",
+              "minimum": 1,
+              "default": 3,
+              "description": "Consecutive failures before marking unhealthy"
+            },
+            "healthy_threshold": {
+              "type": "integer",
+              "minimum": 1,
+              "default": 2,
+              "description": "Consecutive successes before marking healthy"
+            }
+          }
+        },
+        "failover": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false
+            },
+            "strategy": {
+              "type": "string",
+              "enum": ["active-passive", "active-active", "round-robin"],
+              "default": "active-passive"
+            },
+            "fallback_agents": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "List of fallback agent IDs"
+            }
+          }
+        },
+        "disaster_recovery": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false
+            },
+            "rpo_minutes": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Recovery Point Objective in minutes"
+            },
+            "rto_minutes": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Recovery Time Objective in minutes"
+            },
+            "backup_regions": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Backup deployment regions"
+            }
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "Collaboration": {
+      "type": "object",
+      "description": "Multi-agent collaboration and orchestration",
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": ["standalone", "collaborative", "orchestrated"],
+          "default": "standalone",
+          "description": "Agent collaboration mode"
+        },
+        "handoffs": {
+          "type": "array",
+          "description": "Agent handoff configuration",
+          "items": {
+            "type": "object",
+            "properties": {
+              "target_agent": {
+                "type": "string",
+                "description": "Target agent ID for handoff"
+              },
+              "conditions": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "description": "Conditions that trigger handoff"
+              },
+              "context_transfer": {
+                "type": "string",
+                "enum": ["full", "partial", "minimal"],
+                "default": "partial",
+                "description": "How much context to transfer"
+              }
+            }
+          }
+        },
+        "delegation": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false
+            },
+            "allowed_agents": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Agents this agent can delegate to"
+            },
+            "max_depth": {
+              "type": "integer",
+              "minimum": 1,
+              "default": 3,
+              "description": "Maximum delegation depth"
+            }
+          }
+        },
+        "communication": {
+          "type": "object",
+          "properties": {
+            "protocols": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": ["a2a", "mcp", "http", "grpc", "websocket"]
+              },
+              "description": "Supported inter-agent communication protocols"
+            },
+            "message_format": {
+              "type": "string",
+              "enum": ["json", "protobuf", "msgpack"],
+              "default": "json"
+            }
+          }
+        },
+        "orchestration": {
+          "type": "object",
+          "properties": {
+            "role": {
+              "type": "string",
+              "enum": ["orchestrator", "worker", "both"],
+              "description": "Agent's role in orchestration"
+            },
+            "workflow_engine": {
+              "type": "string",
+              "enum": ["langgraph", "autogen", "crewai", "custom"],
+              "description": "Workflow orchestration engine"
+            }
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "Safety": {
+      "type": "object",
+      "description": "Safety and content moderation configuration",
+      "properties": {
+        "content_filtering": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true
+            },
+            "categories": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": ["hate", "violence", "sexual", "self-harm", "profanity", "pii"]
+              },
+              "description": "Content categories to filter"
+            },
+            "threshold": {
+              "type": "string",
+              "enum": ["low", "medium", "high"],
+              "default": "medium",
+              "description": "Filtering sensitivity threshold"
+            },
+            "action": {
+              "type": "string",
+              "enum": ["block", "warn", "log"],
+              "default": "block",
+              "description": "Action when harmful content detected"
+            }
+          }
+        },
+        "pii_detection": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true
+            },
+            "types": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": ["email", "phone", "ssn", "credit_card", "ip_address", "name", "address"]
+              },
+              "description": "PII types to detect"
+            },
+            "action": {
+              "type": "string",
+              "enum": ["redact", "block", "warn", "log"],
+              "default": "redact",
+              "description": "Action when PII detected"
+            }
+          }
+        },
+        "rate_limiting": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true
+            },
+            "requests_per_minute": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Maximum requests per minute per user"
+            },
+            "requests_per_hour": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Maximum requests per hour per user"
+            },
+            "burst_limit": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Maximum burst requests"
+            }
+          }
+        },
+        "guardrails": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true
+            },
+            "policies": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string"
+                  },
+                  "type": {
+                    "type": "string",
+                    "enum": ["input", "output", "both"]
+                  },
+                  "rules": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  }
+                }
+              },
+              "description": "Safety guardrail policies"
+            },
+            "max_tool_calls": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Maximum tool calls per execution"
+            },
+            "max_execution_time_seconds": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Maximum execution time"
+            }
+          }
+        },
+        "human_in_loop": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false
+            },
+            "triggers": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": ["high_risk_action", "low_confidence", "policy_violation", "user_request"]
+              },
+              "description": "Conditions that trigger human review"
+            },
+            "timeout_seconds": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "Timeout waiting for human response"
+            }
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "Deployment": {
+      "type": "object",
+      "description": "Deployment and lifecycle management configuration",
+      "properties": {
+        "strategy": {
+          "type": "string",
+          "enum": ["rolling", "blue-green", "canary", "recreate"],
+          "default": "rolling",
+          "description": "Deployment strategy"
+        },
+        "canary": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false
+            },
+            "initial_traffic_percent": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100,
+              "default": 10,
+              "description": "Initial traffic percentage for canary"
+            },
+            "increment_percent": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100,
+              "default": 10,
+              "description": "Traffic increment per step"
+            },
+            "interval_minutes": {
+              "type": "integer",
+              "minimum": 1,
+              "default": 5,
+              "description": "Time between traffic increments"
+            },
+            "success_criteria": {
+              "type": "object",
+              "properties": {
+                "error_rate_threshold": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 100
+                },
+                "latency_p95_threshold_ms": {
+                  "type": "number",
+                  "minimum": 0
+                }
+              }
+            }
+          }
+        },
+        "rollback": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true
+            },
+            "automatic": {
+              "type": "boolean",
+              "default": false,
+              "description": "Automatically rollback on failure"
+            },
+            "triggers": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": ["error_rate", "latency", "health_check", "manual"]
+              },
+              "description": "Conditions that trigger rollback"
+            }
+          }
+        },
+        "versioning": {
+          "type": "object",
+          "properties": {
+            "scheme": {
+              "type": "string",
+              "enum": ["semver", "timestamp", "git_sha"],
+              "default": "semver"
+            },
+            "compatibility": {
+              "type": "string",
+              "enum": ["backward", "forward", "both", "none"],
+              "default": "backward",
+              "description": "Version compatibility mode"
+            }
+          }
+        },
+        "testing": {
+          "type": "object",
+          "properties": {
+            "dry_run": {
+              "type": "boolean",
+              "default": false,
+              "description": "Enable dry-run mode for testing"
+            },
+            "shadow_mode": {
+              "type": "boolean",
+              "default": false,
+              "description": "Run in shadow mode (process but don't act)"
+            },
+            "test_traffic_percent": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100,
+              "description": "Percentage of traffic to use for testing"
+            }
+          }
+        },
+        "lifecycle": {
+          "type": "object",
+          "properties": {
+            "startup_probe": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": true
+                },
+                "initial_delay_seconds": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "default": 0
+                },
+                "period_seconds": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "default": 10
+                },
+                "failure_threshold": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "default": 3
+                }
+              }
+            },
+            "readiness_probe": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": true
+                },
+                "period_seconds": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "default": 10
+                }
+              }
+            },
+            "liveness_probe": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": true
+                },
+                "period_seconds": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "default": 30
+                }
+              }
+            },
+            "graceful_shutdown": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": true
+                },
+                "timeout_seconds": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "default": 30,
+                  "description": "Time to wait for graceful shutdown"
+                }
+              }
+            }
+          }
+        }
+      },
+      "additionalProperties": false
     }
   }
 }