feat(schema): improve MCP and A2A modules

schema/dictionary.json

@@ -4,24 +4,24 @@
   "name": "dictionary",
   "attributes": {
     "a2a_capabilities": {
-      "caption": "Capabilities",
-      "description": "List of capabilities supported by the agent for A2A communication.",
-      "type": "string_t",
-      "is_array": true,
-      "enum": {
-        "push_notifications": {
-          "caption": "Push Notifications",
-          "description": "Indicates whether the agent supports push notifications for A2A communication."
-        },
-        "streaming": {
-          "caption": "Streaming",
-          "description": "Indicates whether the agent supports streaming for A2A communication."
-        },
-        "state_transition_history": {
-          "caption": "State Transition History",
-          "description": "Indicates whether the agent supports state transition history for A2A communication."
-        }
-      }
+      "caption": "A2A Capabilities",
+      "description": "Defines optional capabilities supported by an A2A agent.",
+      "type": "a2a_capabilities"
+    },
+    "a2a_capability_push_notifications": {
+      "caption": "Push Notifications Capability",
+      "description": "Indicates if the agent supports sending push notifications for asynchronous task updates.",
+      "type": "boolean_t"
+    },
+    "a2a_capability_state_transition_history": {
+      "caption": "State Transition History Capability",
+      "description": "Indicates if the agent provides a history of state transitions for a task.",
+      "type": "boolean_t"
+    },
+    "a2a_capability_streaming": {
+      "caption": "Streaming Capability",
+      "description": "Indicates if the agent supports streaming responses.",
+      "type": "boolean_t"
     },
     "a2a_card_data": {
       "caption": "A2A Agent Card Data",
@@ -70,11 +70,32 @@
         }
       }
     },
+    "a2a_protocol_binding": {
+      "caption": "Protocol Binding",
+      "description": "The protocol binding used by an A2A interface (e.g., 'http+json', 'grpc').",
+      "type": "string_t"
+    },
     "a2a_protocol_version": {
       "caption": "Protocol Version",
       "description": "Version of the A2A protocol used by the agent.",
       "type": "string_t"
     },
+    "a2a_provider": {
+      "caption": "Provider Information",
+      "description": "Information about the A2A agent provider including organization, URL, and extensions.",
+      "type": "a2a_provider"
+    },
+    "a2a_provider_extensions": {
+      "caption": "Provider Extensions",
+      "description": "List of provider extensions for A2A protocol capability discovery.",
+      "type": "a2a_provider_extension",
+      "is_array": true
+    },
+    "a2a_provider_organization": {
+      "caption": "Provider Organization",
+      "description": "Name of the A2A provider organization.",
+      "type": "string_t"
+    },
     "a2a_security_schemes": {
       "caption": "Supported Security Schemes",
       "description": "Supported security schemes for A2A communication.",
@@ -107,25 +128,16 @@
         }
       }
     },
-    "a2a_supported_transports": {
-      "caption": "Supported Transports",
-      "description": "Supported transport protocols for A2A communication.",
-      "type": "string_t",
-      "is_array": true,
-      "enum": {
-        "jsonrpc": {
-          "caption": "JSONRPC",
-          "description": "JSON-RPC transport protocol for A2A communication."
-        },
-        "grpc": {
-          "caption": "GRPC",
-          "description": "gRPC transport protocol for A2A communication."
-        },
-        "http": {
-          "caption": "HTTP+JS",
-          "description": "HTTP transport protocol for A2A communication."
-        }
-      }
+    "a2a_supported_interfaces": {
+      "caption": "Supported Interfaces",
+      "description": "List of supported interfaces for A2A communication with URLs and protocol bindings.",
+      "type": "a2a_supported_interface",
+      "is_array": true
+    },
+    "a2a_supports_authenticated_extended_card": {
+      "caption": "Supports Authenticated Extended Card",
+      "description": "Indicates whether the A2A agent supports authenticated extended card retrieval.",
+      "type": "boolean_t"
     },
     "acp_agent": {
       "caption": "Agent Connect Protocol Specs",
@@ -452,18 +464,20 @@
       "description": "Data supported by the agent for MCP.",
       "type": "mcp_data"
     },
-    "mcp_server_capabilities": {
-      "caption": "MCP Server Capabilities",
-      "description": "Describes the capabilities supported by an MCP server.",
-      "type": "string_t",
-      "enum": {
-        "subscribe": {
-          "caption": "The server can subscribe to events."
-        },
-        "notify": {
-          "caption": "The server can notify on events."
-        }
-      },
+    "mcp_original_data": {
+      "caption": "Original MCP Data",
+      "description": "The complete original MCP server JSON data structure for full fidelity storage.",
+      "type": "json_t"
+    },
+    "mcp_original_server_data": {
+      "caption": "Original Server Data",
+      "description": "The original server.json data structure from MCP Registry.",
+      "type": "json_t"
+    },
+    "mcp_server_connections": {
+      "caption": "MCP Server Connections",
+      "description": "List of connection configurations for accessing an MCP server (local packages or remote endpoints).",
+      "type": "mcp_server_connection",
       "is_array": true
     },
     "mcp_server_prompts": {
@@ -484,12 +498,6 @@
       "type": "mcp_server_tool",
       "is_array": true
     },
-    "mcp_servers": {
-      "caption": "MCP Servers",
-      "description": "Describes the list of MCP servers.",
-      "type": "mcp_server",
-      "is_array": true
-    },
     "mime_type": {
       "caption": "MIME Type",
       "description": "The MIME type of the content. For example: <code>application/json</code>, <code>text/plain</code>.",

schema/objects/a2a_capabilities.json

@@ -0,0 +1,32 @@
+{
+  "caption": "A2A Capabilities",
+  "description": "Defines optional capabilities supported by an A2A agent.",
+  "extends": "object",
+  "name": "a2a_capabilities",
+  "attributes": {
+    "streaming": {
+      "reference": "a2a_capability_streaming",
+      "caption": "Streaming",
+      "description": "Indicates if the agent supports streaming responses.",
+      "requirement": "optional"
+    },
+    "push_notifications": {
+      "reference": "a2a_capability_push_notifications",
+      "caption": "Push Notifications",
+      "description": "Indicates if the agent supports sending push notifications for asynchronous task updates.",
+      "requirement": "optional"
+    },
+    "extensions": {
+      "reference": "a2a_provider_extensions",
+      "caption": "Extensions",
+      "description": "List of protocol extensions supported by the agent.",
+      "requirement": "optional"
+    },
+    "state_transition_history": {
+      "reference": "a2a_capability_state_transition_history",
+      "caption": "State Transition History",
+      "description": "Indicates if the agent provides a history of state transitions for a task.",
+      "requirement": "optional"
+    }
+  }
+}

schema/objects/a2a_data.json

@@ -17,8 +17,8 @@
       "requirement": "required",
       "references": [
         {
-          "description": "A2A Card Data Schema",
-          "url": "https://github.com/google-a2a/A2A/blob/main/docs/specification.md#55-agentcard-object-structure"
+          "description": "A2A AgentCard Proto Message",
+          "url": "https://github.com/google-a2a/A2A/blob/main/specification/grpc/a2a.proto"
         }
       ]
     },
@@ -28,12 +28,6 @@
       "description": "List of capabilities supported by the agent for A2A communication.",
       "requirement": "optional"
     },
-    "transports": {
-      "reference": "a2a_supported_transports",
-      "caption": "Supported Transports",
-      "description": "Supported transport protocols for A2A communication.",
-      "requirement": "optional"
-    },
     "input_modes": {
       "reference": "a2a_input_modes",
       "caption": "Supported Input Modes",
@@ -51,6 +45,24 @@
       "caption": "Supported Security Schemes",
       "description": "Supported security schemes for A2A communication.",
       "requirement": "optional"
+    },
+    "supported_interfaces": {
+      "reference": "a2a_supported_interfaces",
+      "caption": "Supported Interfaces",
+      "description": "List of supported interfaces with URLs and protocol bindings for routing and protocol negotiation.",
+      "requirement": "optional"
+    },
+    "provider": {
+      "reference": "a2a_provider",
+      "caption": "Provider Information",
+      "description": "Information about the provider including organization and protocol extensions.",
+      "requirement": "optional"
+    },
+    "supports_authenticated_extended_card": {
+      "reference": "a2a_supports_authenticated_extended_card",
+      "caption": "Supports Authenticated Extended Card",
+      "description": "Indicates whether the agent supports authenticated extended card retrieval.",
+      "requirement": "optional"
     }
   }
 }

schema/objects/a2a_provider.json

@@ -0,0 +1,20 @@
+{
+  "caption": "A2A Provider",
+  "description": "Information about the A2A agent provider.",
+  "extends": "object",
+  "name": "a2a_provider",
+  "attributes": {
+    "organization": {
+      "reference": "a2a_provider_organization",
+      "caption": "Organization",
+      "description": "Name of the provider organization.",
+      "requirement": "optional"
+    },
+    "extensions": {
+      "reference": "a2a_provider_extensions",
+      "caption": "Extensions",
+      "description": "List of provider extensions for protocol capability discovery.",
+      "requirement": "optional"
+    }
+  }
+}

schema/objects/a2a_provider_extension.json

@@ -0,0 +1,26 @@
+{
+  "caption": "A2A Provider Extension",
+  "description": "Describes a provider extension for A2A protocol capability discovery.",
+  "extends": "object",
+  "name": "a2a_provider_extension",
+  "attributes": {
+    "uri": {
+      "reference": "uri",
+      "caption": "Extension URI",
+      "description": "URI identifier for the extension.",
+      "requirement": "required"
+    },
+    "description": {
+      "reference": "description",
+      "caption": "Description",
+      "description": "Description of the extension.",
+      "requirement": "optional"
+    },
+    "required": {
+      "reference": "required",
+      "caption": "Required",
+      "description": "Indicates whether this extension is required.",
+      "requirement": "optional"
+    }
+  }
+}

schema/objects/a2a_supported_interface.json

@@ -0,0 +1,20 @@
+{
+  "caption": "A2A Supported Interface",
+  "description": "Describes a supported interface for A2A communication.",
+  "extends": "object",
+  "name": "a2a_supported_interface",
+  "attributes": {
+    "url": {
+      "reference": "url",
+      "caption": "Interface URL",
+      "description": "URL of the interface endpoint.",
+      "requirement": "required"
+    },
+    "protocol_binding": {
+      "reference": "a2a_protocol_binding",
+      "caption": "Protocol Binding",
+      "description": "The protocol binding used by this interface (e.g., 'http+json', 'grpc').",
+      "requirement": "optional"
+    }
+  }
+}

schema/objects/mcp_data.json

@@ -1,22 +1,52 @@
 {
   "caption": "MCP Data",
-  "description": "Data for the MCP record module.",
+  "description": "Data for the MCP record module. Represents one MCP server with its capabilities and deployment options.",
   "extends": "module_data",
   "name": "mcp_data",
   "attributes": {
-    "servers": {
-      "reference": "mcp_servers",
-      "caption": "MCP Servers",
-      "description": "List of MCP servers supported by the agent. Exact properties may vary depending on the client or platform.",
-      "requirement": "required",
+    "name": {
+      "caption": "Server Name",
+      "description": "The name of the MCP server.",
+      "requirement": "required"
+    },
+    "description": {
+      "caption": "Server Description",
+      "description": "Description of the server's functionality and purpose.",
+      "requirement": "optional"
+    },
+    "prompts": {
+      "reference": "mcp_server_prompts",
+      "caption": "Prompts",
+      "description": "List of prompts supported by the server.",
+      "requirement": "optional"
+    },
+    "resources": {
+      "reference": "mcp_server_resources",
+      "caption": "Resources",
+      "description": "List of resources supported by the server.",
+      "requirement": "optional"
+    },
+    "tools": {
+      "reference": "mcp_server_tools",
+      "caption": "Tools",
+      "description": "List of tools supported by the server.",
+      "requirement": "optional"
+    },
+    "connections": {
+      "reference": "mcp_server_connections",
+      "caption": "Server Connections",
+      "description": "List of connection configurations for accessing this server (local packages or remote endpoints).",
+      "requirement": "required"
+    },
+    "mcp_data": {
+      "reference": "mcp_original_data",
+      "caption": "Original MCP Data",
+      "description": "The complete original MCP server JSON data structure for full fidelity storage.",
+      "requirement": "optional",
       "references": [
         {
-          "description": "VS Code MCP Server Extension",
-          "url": "https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_configuration-format"
-        },
-        {
-          "description": "Claude MCP Connector",
-          "url": "https://docs.anthropic.com/en/docs/agents-and-tools/mcp-connector#field-descriptions"
+          "description": "MCP Server Schema",
+          "url": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json"
         }
       ]
     }

schema/objects/mcp_original_data.json

@@ -0,0 +1,14 @@
+{
+  "caption": "MCP Original Data",
+  "description": "The complete original MCP server JSON data structure.",
+  "extends": "object",
+  "name": "mcp_original_data",
+  "attributes": {
+    "server": {
+      "reference": "mcp_original_server_data",
+      "caption": "Server Data",
+      "description": "The original server.json data structure from MCP Registry.",
+      "requirement": "required"
+    }
+  }
+}