@bluefly/openstandardagents 0.4.8 → 0.5.0

package/spec/v0.5/agent-card.schema.json

@@ -0,0 +1,477 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.4/agent-card.schema.json",
+  "title": "OSSA Agent Card",
+  "description": "Universal agent contract for discovery, Agent Social profile, marketplace, and global/GitLab registry. Every attribute is defined in and projected from the OSSA agent spec (metadata, spec, or extensions). Single source of truth: OSSA manifest. Serve at .well-known/agent-card.json or .well-known/agent.json (A2A).",
+  "type": "object",
+  "required": ["uri", "name", "version", "ossaVersion", "capabilities", "endpoints", "transport", "authentication", "encryption"],
+  "properties": {
+    "uri": {
+      "type": "string",
+      "pattern": "^uadp://",
+      "description": "Agent URI in the format uadp://{namespace}/{name}"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Human-readable agent name"
+    },
+    "version": {
+      "type": "string",
+      "description": "Agent version (semver)"
+    },
+    "ossaVersion": {
+      "type": "string",
+      "description": "OSSA specification version (e.g., ossa/v0.4.7)"
+    },
+    "taxonomy": {
+      "type": "object",
+      "description": "Agent classification — runtime platform, functional role, architecture pattern",
+      "properties": {
+        "agentType": {
+          "type": "string",
+          "description": "Runtime platform: claude, kagent, openai, langchain, crewai, etc."
+        },
+        "agentKind": {
+          "type": "string",
+          "description": "Functional role: orchestrator, worker, reviewer, analyzer, etc."
+        },
+        "architecture": {
+          "type": "object",
+          "properties": {
+            "pattern": {
+              "type": "string",
+              "description": "Architecture pattern: swarm, pipeline, tree, graph, etc."
+            },
+            "capabilities": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Architecture capabilities: handoff, streaming, context, tools, vision"
+            },
+            "coordination": {
+              "type": "object",
+              "properties": {
+                "handoffStrategy": { "type": "string" },
+                "maxDepth": { "type": "integer" }
+              }
+            },
+            "runtime": {
+              "type": "object",
+              "properties": {
+                "scalability": { "type": "string" },
+                "executionModel": { "type": "string" },
+                "preferredRegion": { "type": "string" }
+              }
+            }
+          }
+        }
+      }
+    },
+    "capabilities": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "List of agent capabilities"
+    },
+    "tools": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "description", "inputSchema"],
+        "properties": {
+          "name": { "type": "string" },
+          "description": { "type": "string" },
+          "inputSchema": { "type": "object" },
+          "outputSchema": { "type": "object" }
+        }
+      },
+      "description": "Tools the agent can call"
+    },
+    "role": {
+      "type": "string",
+      "description": "Agent's role/system prompt summary"
+    },
+    "model": {
+      "type": "object",
+      "description": "LLM configuration powering this agent",
+      "properties": {
+        "provider": { "type": "string", "description": "LLM provider: anthropic, openai, google, etc." },
+        "model": { "type": "string", "description": "Model identifier" },
+        "temperature": { "type": "number", "minimum": 0, "maximum": 2 },
+        "maxTokens": { "type": "integer" },
+        "topP": { "type": "number", "minimum": 0, "maximum": 1 }
+      }
+    },
+    "mcpServers": {
+      "type": "array",
+      "description": "MCP (Model Context Protocol) servers this agent connects to",
+      "items": {
+        "type": "object",
+        "required": ["name"],
+        "properties": {
+          "name": { "type": "string" },
+          "description": { "type": "string" },
+          "transport": {
+            "type": "object",
+            "properties": {
+              "type": { "type": "string", "enum": ["stdio", "sse", "streamable-http"] },
+              "command": { "type": "string" },
+              "args": { "type": "array", "items": { "type": "string" } },
+              "url": { "type": "string" }
+            }
+          },
+          "version": { "type": "string" },
+          "capabilities": {
+            "type": "object",
+            "properties": {
+              "resources": { "type": "object" },
+              "tools": { "type": "object" },
+              "logging": { "type": "object" }
+            }
+          },
+          "resources": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["uri", "name"],
+              "properties": {
+                "uri": { "type": "string" },
+                "name": { "type": "string" },
+                "description": { "type": "string" },
+                "mimeType": { "type": "string" }
+              }
+            }
+          }
+        }
+      }
+    },
+    "a2aProtocol": {
+      "type": "object",
+      "description": "A2A (Agent-to-Agent) protocol configuration",
+      "properties": {
+        "protocol": {
+          "type": "object",
+          "properties": {
+            "type": { "type": "string" },
+            "version": { "type": "string" },
+            "messageFormat": { "type": "string" }
+          }
+        },
+        "agentEndpoints": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["agentId", "url"],
+            "properties": {
+              "agentId": { "type": "string" },
+              "url": { "type": "string" },
+              "capabilities": { "type": "array", "items": { "type": "string" } },
+              "priority": { "type": "integer" }
+            }
+          }
+        },
+        "routing": {
+          "type": "object",
+          "properties": {
+            "strategy": { "type": "string" },
+            "rules": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["name", "condition", "target"],
+                "properties": {
+                  "name": { "type": "string" },
+                  "condition": { "type": "string" },
+                  "target": { "type": "string" },
+                  "priority": { "type": "integer" }
+                }
+              }
+            }
+          }
+        },
+        "delegation": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "maxDepth": { "type": "integer" },
+            "timeout": { "type": "integer" },
+            "handoffRules": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["name", "condition", "target"],
+                "properties": {
+                  "name": { "type": "string" },
+                  "condition": { "type": "string" },
+                  "target": { "type": "string" },
+                  "message": { "type": "string" }
+                }
+              }
+            }
+          }
+        },
+        "completionSignals": {
+          "type": "object",
+          "properties": {
+            "signals": { "type": "array", "items": { "type": "string" } },
+            "handlers": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["signal", "action"],
+                "properties": {
+                  "signal": { "type": "string" },
+                  "action": { "type": "string" },
+                  "target": { "type": "string" }
+                }
+              }
+            }
+          }
+        },
+        "retryPolicy": {
+          "type": "object",
+          "properties": {
+            "maxRetries": { "type": "integer" },
+            "backoff": { "type": "string" },
+            "retryableErrors": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "circuitBreaker": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "failureThreshold": { "type": "integer" },
+            "timeout": { "type": "integer" }
+          }
+        }
+      }
+    },
+    "handoffs": {
+      "type": "array",
+      "description": "Direct delegation targets",
+      "items": {
+        "type": "object",
+        "required": ["to"],
+        "properties": {
+          "to": { "type": "string" },
+          "condition": { "type": "string" }
+        }
+      }
+    },
+    "autonomy": {
+      "type": "object",
+      "description": "Agent independence level and operational boundaries",
+      "properties": {
+        "level": { "type": "string", "description": "Autonomy level: supervised, autonomous, semi-autonomous" },
+        "approvalRequired": { "type": "boolean" },
+        "allowedActions": { "type": "array", "items": { "type": "string" } },
+        "blockedActions": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "constraints": {
+      "type": "object",
+      "description": "Operational limits — cost, performance, resources",
+      "properties": {
+        "cost": {
+          "type": "object",
+          "properties": {
+            "maxTokensPerDay": { "type": "integer" },
+            "maxTokensPerRequest": { "type": "integer" },
+            "maxCostPerDay": { "type": "number" },
+            "currency": { "type": "string" }
+          }
+        },
+        "performance": {
+          "type": "object",
+          "properties": {
+            "maxLatencySeconds": { "type": "number" },
+            "maxConcurrentRequests": { "type": "integer" },
+            "timeoutSeconds": { "type": "number" }
+          }
+        },
+        "resources": {
+          "type": "object",
+          "properties": {
+            "cpu": { "type": "string" },
+            "memory": { "type": "string" }
+          }
+        }
+      }
+    },
+    "observability": {
+      "type": "object",
+      "description": "Tracing, metrics, and logging configuration",
+      "properties": {
+        "tracing": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "exporter": { "type": "string" },
+            "endpoint": { "type": "string" },
+            "samplingRate": { "type": "number" }
+          }
+        },
+        "metrics": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "exporter": { "type": "string" },
+            "endpoint": { "type": "string" }
+          }
+        },
+        "logging": {
+          "type": "object",
+          "properties": {
+            "level": { "type": "string" },
+            "format": { "type": "string" }
+          }
+        }
+      }
+    },
+    "endpoints": {
+      "type": "object",
+      "properties": {
+        "http": { "type": "string", "format": "uri" },
+        "grpc": { "type": "string" },
+        "websocket": { "type": "string", "format": "uri" }
+      },
+      "description": "Network endpoints for reaching the agent"
+    },
+    "transport": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["http", "grpc", "websocket", "mqtt"]
+      },
+      "minItems": 1,
+      "description": "Supported transport protocols"
+    },
+    "authentication": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["mtls", "bearer", "oidc", "api_key", "none"]
+      },
+      "minItems": 1,
+      "description": "Supported authentication methods"
+    },
+    "encryption": {
+      "type": "object",
+      "required": ["tlsRequired", "minTlsVersion"],
+      "properties": {
+        "tlsRequired": { "type": "boolean" },
+        "minTlsVersion": { "type": "string", "enum": ["1.2", "1.3"] },
+        "cipherSuites": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "properties": {
+        "team": { "type": "string" },
+        "environment": { "type": "string" },
+        "region": { "type": "string" },
+        "description": { "type": "string" },
+        "author": { "type": "string" }
+      },
+      "additionalProperties": true,
+      "description": "Additional metadata"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["healthy", "degraded", "unavailable"],
+      "description": "Current agent health status"
+    },
+    "lastHeartbeat": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Last heartbeat timestamp (ISO 8601)"
+    },
+    "state": {
+      "type": "object",
+      "description": "State persistence for discovery and session resume (SoD: defined in OSSA manifest, projected here)",
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": ["stateless", "session", "long_running"],
+          "description": "State persistence mode"
+        },
+        "storageHint": {
+          "type": "string",
+          "description": "Storage backend: redis, postgres, vector-db, kv, custom"
+        },
+        "sessionEndpoint": {
+          "type": "string",
+          "format": "uri",
+          "description": "URL to create or resume session"
+        },
+        "checkpointIntervalSeconds": {
+          "type": "integer",
+          "description": "Checkpoint interval in seconds"
+        },
+        "retention": {
+          "type": "string",
+          "description": "Data retention e.g. 30d, 1h"
+        }
+      }
+    },
+    "tokenEfficiencySummary": {
+      "type": "object",
+      "description": "Token efficiency hints for routing and cost (SoD: defined in OSSA manifest, projected here)",
+      "properties": {
+        "serializationProfile": {
+          "type": "string",
+          "enum": ["compact", "full", "fingerprint"]
+        },
+        "observationFormat": {
+          "type": "string",
+          "enum": ["projected", "summary", "diff", "full"]
+        },
+        "maxInputTokens": { "type": "integer" },
+        "cascade": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Model cascade e.g. haiku, sonnet, opus"
+        },
+        "consolidationStrategy": { "type": "string" }
+      }
+    },
+    "manifestRef": {
+      "type": "string",
+      "format": "uri",
+      "description": "URL to full OSSA manifest (single source of truth)"
+    },
+    "manifestDigest": {
+      "type": "string",
+      "description": "Content digest of manifest (e.g. SHA-256) for integrity and deduplication"
+    },
+    "separation": {
+      "type": "object",
+      "description": "Separation of duties for discovery and policy (SoD: defined in OSSA spec.access and spec.separation)",
+      "properties": {
+        "accessTier": {
+          "type": "string",
+          "enum": ["tier_1_read", "tier_2_write_limited", "tier_3_write_elevated", "tier_4_policy"]
+        },
+        "role": {
+          "type": "string",
+          "description": "Primary role (e.g. reviewer, deployer)"
+        },
+        "conflictsWith": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Roles this agent must not also perform"
+        }
+      }
+    },
+    "cardProfile": {
+      "type": "string",
+      "enum": ["minimal", "discovery", "full"],
+      "description": "Card profile: minimal (uri,name,capabilities), discovery (+ state, tokenEfficiency), full (all)"
+    },
+    "extensions": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "Extension data for platform-specific fields"
+    }
+  },
+  "additionalProperties": false
+}