@bluefly/openstandardagents 0.4.9 → 0.5.1

package/dist/spec/v0.5/role.schema.json

@@ -0,0 +1,268 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://openstandardagents.org/schemas/v0.5/role.schema.json",
+  "title": "OSSA v0.5 Role Manifest Schema",
+  "description": "Open Standard for Software Agents (OSSA) v0.5 - Role manifest. Defines behavioral overlays for IDE/CLI agents (Claude Code, Cursor, etc.) with instructions, tool sets, hooks, MCP connections, and activation conditions.",
+  "type": "object",
+  "required": ["apiVersion", "kind", "metadata", "spec"],
+  "properties": {
+    "apiVersion": {
+      "type": "string",
+      "pattern": "^ossa/v[0-9]+(\\.[0-9]+)*(-[a-zA-Z0-9.]+)?$",
+      "description": "OSSA API version",
+      "examples": ["ossa/v0.5", "ossa/v1"]
+    },
+    "kind": {
+      "type": "string",
+      "const": "Role",
+      "description": "Resource type — must be Role"
+    },
+    "metadata": {
+      "$ref": "#/definitions/RoleMetadata"
+    },
+    "spec": {
+      "$ref": "#/definitions/RoleSpec"
+    },
+    "extensions": {
+      "type": "object",
+      "description": "Platform-specific extensions",
+      "additionalProperties": true
+    }
+  },
+  "definitions": {
+    "RoleMetadata": {
+      "type": "object",
+      "required": ["name"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "description": "DNS-style role name (lowercase, hyphens)",
+          "examples": ["drupal-developer", "security-auditor", "platform-operator"]
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(-[a-zA-Z0-9.]+)?$",
+          "description": "Semantic version",
+          "examples": ["1.0.0", "2.1.0-beta"]
+        },
+        "description": {
+          "type": "string",
+          "description": "Human-readable description"
+        },
+        "labels": {
+          "type": "object",
+          "additionalProperties": { "type": "string" },
+          "description": "Key-value labels for filtering and categorization"
+        },
+        "annotations": {
+          "type": "object",
+          "additionalProperties": { "type": "string" },
+          "description": "Non-identifying metadata"
+        }
+      }
+    },
+    "RoleSpec": {
+      "type": "object",
+      "properties": {
+        "role": {
+          "type": "string",
+          "description": "System prompt / persona definition"
+        },
+        "instructions": {
+          "$ref": "#/definitions/RoleInstructions"
+        },
+        "tools": {
+          "$ref": "#/definitions/RoleTools"
+        },
+        "hooks": {
+          "$ref": "#/definitions/RoleHooks"
+        },
+        "context": {
+          "$ref": "#/definitions/RoleContext"
+        },
+        "protocols": {
+          "$ref": "#/definitions/RoleProtocols"
+        },
+        "extends": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/RoleExtension" },
+          "description": "Role composition — inherit from other roles"
+        },
+        "activation": {
+          "$ref": "#/definitions/RoleActivation"
+        }
+      }
+    },
+    "RoleInstructions": {
+      "type": "object",
+      "properties": {
+        "preamble": {
+          "type": "string",
+          "description": "Markdown content prepended to every conversation"
+        },
+        "constraints": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Hard rules — MUST/MUST NOT statements"
+        }
+      }
+    },
+    "RoleTools": {
+      "type": "object",
+      "properties": {
+        "allowed": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Whitelist of allowed tool names"
+        },
+        "denied": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Blacklist of denied tool names (overrides allowed)"
+        },
+        "skills": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "References to OSSA Skill manifests"
+        }
+      }
+    },
+    "RoleHooks": {
+      "type": "object",
+      "properties": {
+        "on_activate": {
+          "type": "string",
+          "description": "Run when role is activated"
+        },
+        "on_deactivate": {
+          "type": "string",
+          "description": "Run when switching away from this role"
+        },
+        "pre_commit": {
+          "type": "string",
+          "description": "Run before git commits"
+        },
+        "post_save": {
+          "type": "string",
+          "description": "Run after file saves"
+        }
+      }
+    },
+    "RoleContext": {
+      "type": "object",
+      "properties": {
+        "schemas": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Paths to JSON Schema or OpenAPI spec files"
+        },
+        "files": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/RoleContextFile" },
+          "description": "Files to include in agent context"
+        },
+        "knowledge": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Paths to knowledge base documents"
+        }
+      }
+    },
+    "RoleContextFile": {
+      "type": "object",
+      "required": ["path"],
+      "properties": {
+        "path": {
+          "type": "string",
+          "description": "File path or glob pattern"
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of what this file provides"
+        }
+      }
+    },
+    "RoleProtocols": {
+      "type": "object",
+      "properties": {
+        "mcp": {
+          "$ref": "#/definitions/RoleMCPConfig"
+        }
+      }
+    },
+    "RoleMCPConfig": {
+      "type": "object",
+      "properties": {
+        "servers": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/RoleMCPServer" },
+          "description": "MCP servers available when this role is active"
+        }
+      }
+    },
+    "RoleMCPServer": {
+      "type": "object",
+      "required": ["name", "transport"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Server identifier"
+        },
+        "transport": {
+          "type": "string",
+          "enum": ["stdio", "sse"],
+          "description": "Transport type"
+        },
+        "command": {
+          "type": "string",
+          "description": "Command to spawn (stdio transport)"
+        },
+        "args": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Command arguments (stdio transport)"
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "Endpoint URL (SSE transport)"
+        }
+      }
+    },
+    "RoleExtension": {
+      "type": "object",
+      "required": ["role"],
+      "properties": {
+        "role": {
+          "type": "string",
+          "description": "Name of the parent role to inherit from"
+        },
+        "override": {
+          "type": "boolean",
+          "default": false,
+          "description": "If true, child fields replace parent fields; if false, they merge"
+        }
+      }
+    },
+    "RoleActivation": {
+      "type": "object",
+      "properties": {
+        "file_patterns": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Glob patterns — activate when matching files are open"
+        },
+        "command": {
+          "type": "string",
+          "description": "CLI command to activate (e.g., /role drupal)"
+        },
+        "env": {
+          "type": "object",
+          "additionalProperties": { "type": "string" },
+          "description": "Environment variable conditions (all must match)"
+        }
+      }
+    }
+  }
+}

package/dist/spec/v1/agent-card.schema.json

@@ -0,0 +1,254 @@
+{
+  "$id": "https://ossa.dev/spec/v1/agent-card.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Agent Card v1.0",
+  "description": "Machine-readable agent passport enabling auto-discovery, auth negotiation, capability verification, and A2A protocol compatibility.",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "humanReadableId",
+    "agentVersion",
+    "name",
+    "description",
+    "url",
+    "capabilities",
+    "authSchemes"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "type": "string",
+      "const": "1.0",
+      "description": "Version of the Agent Card schema."
+    },
+    "humanReadableId": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9._-]*/[a-z0-9][a-z0-9._-]*$",
+      "description": "Unique namespace/agent identifier in 'org/agent-name' format.",
+      "examples": ["acme/weather-reporter", "blueflyio/code-review-agent"]
+    },
+    "agentVersion": {
+      "type": "string",
+      "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$",
+      "description": "Semantic version (MAJOR.MINOR.PATCH) of the agent software.",
+      "examples": ["1.0.0", "2.1.0-beta.1"]
+    },
+    "name": {
+      "type": "string",
+      "maxLength": 150,
+      "description": "Human-readable display name."
+    },
+    "description": {
+      "type": "string",
+      "maxLength": 2000,
+      "description": "Clear description of the agent's purpose and capabilities."
+    },
+    "url": {
+      "type": "string",
+      "format": "uri",
+      "description": "Primary A2A endpoint URL. MUST use HTTPS except for localhost.",
+      "examples": ["https://api.my-agent.example.com/a2a"]
+    },
+    "provider": {
+      "$ref": "#/$defs/Provider"
+    },
+    "capabilities": {
+      "$ref": "#/$defs/Capabilities"
+    },
+    "authSchemes": {
+      "type": "array",
+      "minItems": 1,
+      "description": "Authentication schemes supported. At least one is required.",
+      "items": {
+        "$ref": "#/$defs/AuthScheme"
+      }
+    },
+    "skills": {
+      "type": "array",
+      "description": "Discrete operations the agent can perform.",
+      "items": {
+        "$ref": "#/$defs/Skill"
+      }
+    },
+    "tags": {
+      "type": "array",
+      "description": "Searchable discovery keywords.",
+      "items": {
+        "type": "string"
+      }
+    },
+    "privacyPolicyUrl": {
+      "type": "string",
+      "format": "uri",
+      "description": "URL to the agent's privacy policy."
+    },
+    "termsOfServiceUrl": {
+      "type": "string",
+      "format": "uri",
+      "description": "URL to the agent's terms of service."
+    },
+    "iconUrl": {
+      "type": "string",
+      "format": "uri",
+      "description": "URL to the agent's icon image."
+    },
+    "lastUpdated": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp of last modification to this card."
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "Provider": {
+      "type": "object",
+      "required": ["name"],
+      "description": "Organization or individual operating this agent.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Display name of the provider."
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "description": "Provider's homepage URL."
+        },
+        "support_contact": {
+          "type": "string",
+          "description": "Support contact (email, URL, or mailto: URI)."
+        }
+      },
+      "additionalProperties": false
+    },
+    "Capabilities": {
+      "type": "object",
+      "required": ["a2aVersion"],
+      "description": "Protocol capabilities for this agent.",
+      "properties": {
+        "a2aVersion": {
+          "type": "string",
+          "description": "A2A protocol version supported.",
+          "examples": ["1.0"]
+        },
+        "mcpVersion": {
+          "type": "string",
+          "description": "MCP protocol version supported, if any.",
+          "examples": ["0.6"]
+        },
+        "supportedMessageParts": {
+          "type": "array",
+          "description": "Message part types this agent can consume/produce.",
+          "items": {
+            "type": "string",
+            "enum": ["text", "file", "data", "image", "audio", "video"]
+          }
+        },
+        "supportsPushNotifications": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether the agent supports async push notifications."
+        },
+        "teeDetails": {
+          "$ref": "#/$defs/TeeDetails"
+        }
+      },
+      "additionalProperties": false
+    },
+    "TeeDetails": {
+      "type": "object",
+      "required": ["type"],
+      "description": "Trusted Execution Environment attestation details.",
+      "properties": {
+        "type": {
+          "type": "string",
+          "description": "TEE technology type.",
+          "examples": ["Intel SGX", "AMD SEV", "AWS Nitro"]
+        },
+        "attestationEndpoint": {
+          "type": "string",
+          "format": "uri",
+          "description": "URL of the TEE remote attestation endpoint."
+        },
+        "publicKey": {
+          "type": "string",
+          "description": "PEM-encoded public key of the enclave."
+        },
+        "description": {
+          "type": "string",
+          "description": "Human-readable explanation of what the TEE protects."
+        }
+      },
+      "additionalProperties": false
+    },
+    "AuthScheme": {
+      "type": "object",
+      "required": ["scheme"],
+      "description": "A single authentication method supported by the agent.",
+      "properties": {
+        "scheme": {
+          "type": "string",
+          "enum": ["apiKey", "oauth2", "bearer", "none"],
+          "description": "Authentication scheme identifier."
+        },
+        "description": {
+          "type": "string",
+          "description": "How to obtain and use credentials for this scheme."
+        },
+        "tokenUrl": {
+          "type": "string",
+          "format": "uri",
+          "description": "OAuth2 token endpoint. Required when scheme is 'oauth2'."
+        },
+        "scopes": {
+          "type": "array",
+          "description": "OAuth2 scopes required (scheme: oauth2 only).",
+          "items": {
+            "type": "string"
+          }
+        },
+        "service_identifier": {
+          "type": "string",
+          "description": "Stable key for credential managers (e.g., 'acme-weather-api')."
+        }
+      },
+      "if": {
+        "properties": { "scheme": { "const": "oauth2" } }
+      },
+      "then": {
+        "required": ["tokenUrl"]
+      },
+      "additionalProperties": false
+    },
+    "Skill": {
+      "type": "object",
+      "required": ["id", "name", "description"],
+      "description": "A discrete callable operation the agent can perform.",
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_-]*$",
+          "description": "Stable machine-readable skill identifier, unique within the agent."
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable display name."
+        },
+        "description": {
+          "type": "string",
+          "description": "Purpose and behaviour of this skill."
+        },
+        "input_schema": {
+          "type": "object",
+          "description": "JSON Schema describing the expected input payload.",
+          "additionalProperties": true
+        },
+        "output_schema": {
+          "type": "object",
+          "description": "JSON Schema describing the response payload structure.",
+          "additionalProperties": true
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}