multi-agent-protocol 0.0.3 → 0.0.6

package/schema/schema.json

@@ -61,7 +61,26 @@
         { "$ref": "#/$defs/AuthRefreshRequest" },
         { "$ref": "#/$defs/InjectRequest" },
         { "$ref": "#/$defs/FederationConnectRequest" },
-        { "$ref": "#/$defs/FederationRouteRequest" }
+        { "$ref": "#/$defs/FederationRouteRequest" },
+        { "$ref": "#/$defs/MailCreateRequest" },
+        { "$ref": "#/$defs/MailGetRequest" },
+        { "$ref": "#/$defs/MailListRequest" },
+        { "$ref": "#/$defs/MailCloseRequest" },
+        { "$ref": "#/$defs/MailJoinRequest" },
+        { "$ref": "#/$defs/MailLeaveRequest" },
+        { "$ref": "#/$defs/MailInviteRequest" },
+        { "$ref": "#/$defs/MailTurnRequest" },
+        { "$ref": "#/$defs/MailTurnsListRequest" },
+        { "$ref": "#/$defs/MailThreadCreateRequest" },
+        { "$ref": "#/$defs/MailThreadListRequest" },
+        { "$ref": "#/$defs/MailSummaryRequest" },
+        { "$ref": "#/$defs/MailReplayRequest" },
+        { "$ref": "#/$defs/CredGetRequest" },
+        { "$ref": "#/$defs/CredListRequest" },
+        { "$ref": "#/$defs/CredStatusRequest" },
+        { "$ref": "#/$defs/WorkspaceSearchRequest" },
+        { "$ref": "#/$defs/WorkspaceListRequest" },
+        { "$ref": "#/$defs/WorkspaceReadRequest" }
       ]
     },
     "MAPResponse": {
@@ -151,6 +170,7 @@
         "agent",
         "resource",
         "federation",
+        "mail",
         "internal"
       ],
       "description": "Category of error for handling decisions"
@@ -280,6 +300,30 @@
           },
           "additionalProperties": false
         },
+        "mail": {
+          "type": "object",
+          "description": "Mail protocol capabilities for conversation/turn tracking",
+          "properties": {
+            "enabled": { "type": "boolean", "description": "Whether mail is enabled (server response only)" },
+            "canCreate": { "type": "boolean", "description": "Can create new conversations" },
+            "canJoin": { "type": "boolean", "description": "Can join existing conversations" },
+            "canInvite": { "type": "boolean", "description": "Can invite participants to conversations" },
+            "canViewHistory": { "type": "boolean", "description": "Can view conversation history" },
+            "canCreateThreads": { "type": "boolean", "description": "Can create threads within conversations" }
+          },
+          "additionalProperties": false
+        },
+        "credentials": {
+          "type": "object",
+          "description": "Credential brokering capabilities",
+          "properties": {
+            "enabled": { "type": "boolean", "description": "Whether credential brokering is enabled (server response only)" },
+            "canGet": { "type": "boolean", "description": "Can request credentials via cred/get" },
+            "canList": { "type": "boolean", "description": "Can list available scopes via cred/list" },
+            "canStatus": { "type": "boolean", "description": "Can check broker status via cred/status" }
+          },
+          "additionalProperties": false
+        },
         "_meta": { "$ref": "#/$defs/Meta" }
       },
       "additionalProperties": false
@@ -385,6 +429,8 @@
         "visibility": { "$ref": "#/$defs/AgentVisibility" },
         "lifecycle": { "$ref": "#/$defs/AgentLifecycle" },
         "capabilities": { "$ref": "#/$defs/ParticipantCapabilities" },
+        "capabilityDescriptor": { "$ref": "#/$defs/MAPAgentCapabilityDescriptor" },
+        "environment": { "$ref": "#/$defs/AgentEnvironment" },
         "metadata": { "type": "object" },
         "_meta": { "$ref": "#/$defs/Meta" }
       },
@@ -392,6 +438,28 @@
       "additionalProperties": false
     },
 
+    "AgentEnvironment": {
+      "type": "object",
+      "description": "Compute environment information for an agent. Category names are normative; field conventions within categories are documented separately.",
+      "properties": {
+        "schemaVersion": { "type": "string", "description": "Schema version (e.g., '1.0')" },
+        "profiles": { "type": "array", "items": { "type": "string" }, "description": "Self-declared profile compliance" },
+        "host": { "type": "object", "additionalProperties": true, "description": "Host/machine info (arch, cpu, memory, gpu)" },
+        "os": { "type": "object", "additionalProperties": true, "description": "Operating system info (type, version)" },
+        "process": { "type": "object", "additionalProperties": true, "description": "Process/runtime info (pid, cwd, runtime)" },
+        "container": { "type": "object", "additionalProperties": true, "description": "Container info if containerized" },
+        "cloud": { "type": "object", "additionalProperties": true, "description": "Cloud provider info (provider, region)" },
+        "k8s": { "type": "object", "additionalProperties": true, "description": "Kubernetes info if in k8s" },
+        "filesystem": { "type": "object", "additionalProperties": true, "description": "Filesystem/workspace info (cwd, mounts, workspace)" },
+        "network": { "type": "object", "additionalProperties": true, "description": "Network info (connectivity, addresses)" },
+        "tools": { "type": "object", "additionalProperties": true, "description": "Available tools and runtimes" },
+        "resources": { "type": "object", "additionalProperties": true, "description": "Resource limits and constraints" },
+        "security": { "type": "object", "additionalProperties": true, "description": "Security/isolation context" },
+        "services": { "type": "object", "additionalProperties": true, "description": "External services and APIs (aiProviders, mcp)" }
+      },
+      "additionalProperties": true
+    },
+
     "Address": {
       "description": "Flexible addressing for any topology",
       "oneOf": [
@@ -580,6 +648,10 @@
           "type": "integer",
           "description": "Time-to-live in milliseconds"
         },
+        "mail": {
+          "$ref": "#/$defs/MailMessageMeta",
+          "description": "Mail turn tracking metadata. When present on map/send, an intercepted turn is recorded."
+        },
         "_meta": { "$ref": "#/$defs/Meta" }
       },
       "additionalProperties": false
@@ -660,6 +732,7 @@
       "enum": [
         "agent_registered",
         "agent_state_changed",
+        "agent_environment_changed",
         "agent_unregistered",
         "message_sent",
         "message_delivered",
@@ -670,7 +743,15 @@
         "scope_member_left",
         "system_error",
         "federation_connected",
-        "federation_disconnected"
+        "federation_disconnected",
+        "mail.created",
+        "mail.closed",
+        "mail.participant.joined",
+        "mail.participant.left",
+        "mail.turn.added",
+        "mail.turn.updated",
+        "mail.thread.created",
+        "mail.summary.generated"
       ],
       "description": "Type of system event"
     },
@@ -725,6 +806,15 @@
           "items": { "$ref": "#/$defs/MessagePriority" },
           "description": "Only events with these priorities"
         },
+        "mail": {
+          "$ref": "#/$defs/MailSubscriptionFilter",
+          "description": "Mail-specific filter for conversation events"
+        },
+        "environmentMatch": {
+          "type": "object",
+          "description": "Filter by agent environment attributes (e.g., 'os.type', 'cloud.region', 'network.connectivity')",
+          "additionalProperties": true
+        },
         "_meta": { "$ref": "#/$defs/Meta" }
       },
       "additionalProperties": false
@@ -775,7 +865,10 @@
               "properties": {
                 "method": {
                   "type": "string",
-                  "enum": ["bearer", "api-key", "mtls", "none"]
+                  "oneOf": [
+                    { "enum": ["bearer", "api-key", "mtls", "none"] },
+                    { "type": "string", "pattern": "^x-" }
+                  ]
                 },
                 "token": { "type": "string" }
               }
@@ -802,6 +895,10 @@
             "version": { "type": "string" }
           }
         },
+        "serverEnvironment": {
+          "$ref": "#/$defs/AgentEnvironment",
+          "description": "Server's compute environment (if relevant)"
+        },
         "_meta": { "$ref": "#/$defs/Meta" }
       },
       "required": ["protocolVersion", "sessionId", "participantId", "capabilities"]
@@ -960,7 +1057,20 @@
                   "items": { "$ref": "#/$defs/ScopeId" }
                 },
                 "parent": { "$ref": "#/$defs/AgentId" },
-                "hasChildren": { "type": "boolean" }
+                "hasChildren": { "type": "boolean" },
+                "capabilityId": {
+                  "type": "string",
+                  "description": "Filter by structured capability ID from capabilityDescriptor"
+                },
+                "tags": {
+                  "type": "array",
+                  "items": { "type": "string" },
+                  "description": "Filter by semantic tags from capabilityDescriptor"
+                },
+                "accepts": {
+                  "type": "string",
+                  "description": "Filter by accepted content type from capabilityDescriptor (MIME type)"
+                }
               }
             },
             "limit": { "type": "integer", "minimum": 1 },
@@ -1170,6 +1280,8 @@
             },
             "visibility": { "$ref": "#/$defs/AgentVisibility" },
             "capabilities": { "$ref": "#/$defs/ParticipantCapabilities" },
+            "capabilityDescriptor": { "$ref": "#/$defs/MAPAgentCapabilityDescriptor" },
+            "environment": { "$ref": "#/$defs/AgentEnvironment" },
             "metadata": { "type": "object" },
             "_meta": { "$ref": "#/$defs/Meta" }
           }
@@ -1209,8 +1321,20 @@
             },
             "visibility": { "$ref": "#/$defs/AgentVisibility" },
             "capabilities": { "$ref": "#/$defs/ParticipantCapabilities" },
+            "capabilityDescriptor": { "$ref": "#/$defs/MAPAgentCapabilityDescriptor" },
+            "environment": { "$ref": "#/$defs/AgentEnvironment" },
             "initialMessage": { "$ref": "#/$defs/Message" },
             "metadata": { "type": "object" },
+            "requestedScopes": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Scopes to request for the delegated credential (defaults to parent's scopes)"
+            },
+            "ttlMinutes": {
+              "type": "integer",
+              "minimum": 1,
+              "description": "TTL in minutes for the delegated credential"
+            },
             "_meta": { "$ref": "#/$defs/Meta" }
           }
         }
@@ -1223,6 +1347,20 @@
       "properties": {
         "agent": { "$ref": "#/$defs/Agent" },
         "messageId": { "$ref": "#/$defs/MessageId" },
+        "delegatedCredentials": {
+          "type": "object",
+          "description": "Credentials delegated to the spawned child agent (when auth provider supports delegation)",
+          "properties": {
+            "method": { "type": "string", "description": "Auth method for the delegated credential" },
+            "credentials": { "type": "object", "description": "The delegated credential data" },
+            "env": {
+              "type": "object",
+              "additionalProperties": { "type": "string" },
+              "description": "Environment variables for the child agent"
+            }
+          },
+          "required": ["method", "credentials"]
+        },
         "_meta": { "$ref": "#/$defs/Meta" }
       },
       "required": ["agent"]
@@ -1706,7 +1844,7 @@
       "type": "object",
       "x-method": "map/federation/connect",
       "x-tier": "extension",
-      "description": "Connect to a peer MAP system",
+      "description": "Connect to a peer MAP system. Supports single-request auth: include auth inline to complete federation handshake in one round-trip.",
       "properties": {
         "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
         "id": { "$ref": "#/$defs/RequestId" },
@@ -1717,15 +1855,49 @@
             "systemId": { "type": "string" },
             "endpoint": { "type": "string", "format": "uri" },
             "auth": {
+              "oneOf": [
+                {
+                  "type": "object",
+                  "description": "Standard federation auth (bearer, api-key, mtls, etc.)",
+                  "properties": {
+                    "method": {
+                      "type": "string",
+                      "oneOf": [
+                        { "enum": ["bearer", "api-key", "mtls", "none", "did:wba", "oauth2"] },
+                        { "type": "string", "pattern": "^x-" }
+                      ]
+                    },
+                    "credentials": { "type": "string" }
+                  },
+                  "required": ["method"]
+                },
+                { "$ref": "#/$defs/DIDWBACredentials" }
+              ]
+            },
+            "authContext": {
               "type": "object",
+              "description": "Additional auth context for single-request federation auth",
               "properties": {
-                "method": {
-                  "type": "string",
-                  "enum": ["bearer", "api-key", "mtls"]
-                },
-                "credentials": { "type": "string" }
-              },
-              "required": ["method"]
+                "challenge": { "type": "string", "description": "Challenge nonce for proof-based auth" }
+              }
+            },
+            "systemInfo": {
+              "type": "object",
+              "description": "Connecting system's self-description",
+              "properties": {
+                "name": { "type": "string" },
+                "version": { "type": "string" }
+              }
+            },
+            "protocolVersion": { "type": "integer", "description": "MAP protocol version (default: 1)" },
+            "exposure": {
+              "type": "object",
+              "description": "Which resources the connecting system exposes",
+              "properties": {
+                "agents": { "type": "boolean" },
+                "scopes": { "type": "boolean" },
+                "events": { "type": "boolean" }
+              }
             },
             "_meta": { "$ref": "#/$defs/Meta" }
           },
@@ -1736,9 +1908,33 @@
     },
     "FederationConnectResponse": {
       "type": "object",
-      "description": "Response to map/federation/connect",
+      "description": "Response to map/federation/connect. When single-request auth succeeds, includes sessionId and principal. When auth fails or is required, includes authRequired with supported methods and challenge.",
       "properties": {
         "connected": { "type": "boolean" },
+        "sessionId": { "type": "string", "description": "Session ID assigned on successful auth" },
+        "principal": {
+          "type": "object",
+          "description": "Authenticated principal (on successful auth)",
+          "properties": {
+            "id": { "type": "string" },
+            "issuer": { "type": "string" },
+            "claims": { "type": "object" }
+          }
+        },
+        "authRequired": {
+          "type": "object",
+          "description": "Auth negotiation data (when auth is required or failed)",
+          "properties": {
+            "methods": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Supported auth methods"
+            },
+            "challenge": { "type": "string", "description": "Challenge nonce for proof-based auth methods" },
+            "required": { "type": "boolean", "description": "Whether authentication is required to proceed" }
+          },
+          "required": ["methods", "challenge"]
+        },
         "systemInfo": {
           "type": "object",
           "properties": {
@@ -1823,6 +2019,1049 @@
         }
       },
       "required": ["jsonrpc", "method", "params"]
+    },
+
+    "ConversationId": {
+      "type": "string",
+      "description": "Unique identifier for a conversation"
+    },
+    "TurnId": {
+      "type": "string",
+      "description": "Unique identifier for a turn"
+    },
+    "ThreadId": {
+      "type": "string",
+      "description": "Unique identifier for a thread"
+    },
+    "ConversationType": {
+      "type": "string",
+      "enum": ["user-session", "agent-task", "multi-agent", "mixed"],
+      "description": "Type of conversation"
+    },
+    "ConversationStatus": {
+      "type": "string",
+      "enum": ["active", "paused", "completed", "failed", "archived"],
+      "description": "Status of a conversation"
+    },
+    "ParticipantRole": {
+      "type": "string",
+      "enum": ["initiator", "assistant", "worker", "observer", "moderator"],
+      "description": "Role of a participant within a conversation"
+    },
+    "TurnStatus": {
+      "type": "string",
+      "enum": ["pending", "streaming", "complete", "failed"],
+      "description": "Status of a turn's content lifecycle"
+    },
+    "TurnVisibility": {
+      "description": "Visibility of a turn within a conversation",
+      "oneOf": [
+        { "type": "object", "properties": { "type": { "const": "all" } }, "required": ["type"] },
+        { "type": "object", "properties": { "type": { "const": "participants" }, "ids": { "type": "array", "items": { "$ref": "#/$defs/ParticipantId" } } }, "required": ["type", "ids"] },
+        { "type": "object", "properties": { "type": { "const": "role" }, "roles": { "type": "array", "items": { "$ref": "#/$defs/ParticipantRole" } } }, "required": ["type", "roles"] },
+        { "type": "object", "properties": { "type": { "const": "private" } }, "required": ["type"] }
+      ]
+    },
+    "TurnSource": {
+      "description": "How a turn was created",
+      "oneOf": [
+        { "type": "object", "properties": { "type": { "const": "explicit" }, "method": { "const": "mail/turn" } }, "required": ["type", "method"] },
+        { "type": "object", "properties": { "type": { "const": "intercepted" }, "messageId": { "$ref": "#/$defs/MessageId" } }, "required": ["type", "messageId"] }
+      ]
+    },
+    "ConversationPermissions": {
+      "type": "object",
+      "description": "Permissions for a participant within a conversation",
+      "properties": {
+        "canSend": { "type": "boolean" },
+        "canObserve": { "type": "boolean" },
+        "canInvite": { "type": "boolean" },
+        "canRemove": { "type": "boolean" },
+        "canCreateThreads": { "type": "boolean" },
+        "historyAccess": { "type": "string", "enum": ["none", "from-join", "full"] },
+        "canSeeInternal": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    },
+    "Conversation": {
+      "type": "object",
+      "description": "A conversation - container for tracking related interactions",
+      "properties": {
+        "id": { "$ref": "#/$defs/ConversationId" },
+        "type": { "$ref": "#/$defs/ConversationType" },
+        "status": { "$ref": "#/$defs/ConversationStatus" },
+        "subject": { "type": "string" },
+        "participantCount": { "type": "integer" },
+        "parentConversationId": { "$ref": "#/$defs/ConversationId" },
+        "parentTurnId": { "$ref": "#/$defs/TurnId" },
+        "createdAt": { "$ref": "#/$defs/Timestamp" },
+        "updatedAt": { "$ref": "#/$defs/Timestamp" },
+        "closedAt": { "$ref": "#/$defs/Timestamp" },
+        "createdBy": { "$ref": "#/$defs/ParticipantId" },
+        "metadata": { "type": "object" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["id", "type", "status", "participantCount", "createdAt", "updatedAt", "createdBy"],
+      "additionalProperties": false
+    },
+    "ConversationParticipant": {
+      "type": "object",
+      "description": "A participant in a conversation with role and permissions",
+      "properties": {
+        "id": { "$ref": "#/$defs/ParticipantId" },
+        "type": { "type": "string", "enum": ["user", "agent", "system"] },
+        "role": { "$ref": "#/$defs/ParticipantRole" },
+        "joinedAt": { "$ref": "#/$defs/Timestamp" },
+        "leftAt": { "$ref": "#/$defs/Timestamp" },
+        "permissions": { "$ref": "#/$defs/ConversationPermissions" },
+        "agentInfo": {
+          "type": "object",
+          "properties": {
+            "agentId": { "$ref": "#/$defs/AgentId" },
+            "name": { "type": "string" },
+            "role": { "type": "string" }
+          },
+          "required": ["agentId"]
+        },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["id", "type", "role", "joinedAt", "permissions"],
+      "additionalProperties": false
+    },
+    "Turn": {
+      "type": "object",
+      "description": "A turn - the atomic unit of conversation",
+      "properties": {
+        "id": { "$ref": "#/$defs/TurnId" },
+        "conversationId": { "$ref": "#/$defs/ConversationId" },
+        "participant": { "$ref": "#/$defs/ParticipantId" },
+        "timestamp": { "$ref": "#/$defs/Timestamp" },
+        "contentType": { "type": "string", "description": "Content type: text, data, event, reference, or x-* custom" },
+        "content": { "description": "Content payload - shape determined by contentType" },
+        "threadId": { "$ref": "#/$defs/ThreadId" },
+        "inReplyTo": { "$ref": "#/$defs/TurnId" },
+        "source": { "$ref": "#/$defs/TurnSource" },
+        "visibility": { "$ref": "#/$defs/TurnVisibility" },
+        "status": { "$ref": "#/$defs/TurnStatus" },
+        "metadata": { "type": "object" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["id", "conversationId", "participant", "timestamp", "contentType", "content", "source"],
+      "additionalProperties": false
+    },
+    "Thread": {
+      "type": "object",
+      "description": "A thread within a conversation for focused discussion",
+      "properties": {
+        "id": { "$ref": "#/$defs/ThreadId" },
+        "conversationId": { "$ref": "#/$defs/ConversationId" },
+        "parentThreadId": { "$ref": "#/$defs/ThreadId" },
+        "subject": { "type": "string" },
+        "rootTurnId": { "$ref": "#/$defs/TurnId" },
+        "turnCount": { "type": "integer" },
+        "participantCount": { "type": "integer" },
+        "createdAt": { "$ref": "#/$defs/Timestamp" },
+        "updatedAt": { "$ref": "#/$defs/Timestamp" },
+        "createdBy": { "$ref": "#/$defs/ParticipantId" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["id", "conversationId", "rootTurnId", "turnCount", "participantCount", "createdAt", "updatedAt", "createdBy"],
+      "additionalProperties": false
+    },
+    "MailMessageMeta": {
+      "type": "object",
+      "description": "Mail metadata for map/send turn tracking",
+      "properties": {
+        "conversationId": { "$ref": "#/$defs/ConversationId" },
+        "threadId": { "$ref": "#/$defs/ThreadId" },
+        "inReplyTo": { "$ref": "#/$defs/TurnId" },
+        "visibility": { "$ref": "#/$defs/TurnVisibility" }
+      },
+      "required": ["conversationId"],
+      "additionalProperties": false
+    },
+    "MailSubscriptionFilter": {
+      "type": "object",
+      "description": "Mail-specific subscription filter for conversation events",
+      "properties": {
+        "conversationId": { "$ref": "#/$defs/ConversationId" },
+        "threadId": { "$ref": "#/$defs/ThreadId" },
+        "participantId": { "$ref": "#/$defs/ParticipantId" },
+        "contentType": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+
+    "MailCreateRequest": {
+      "type": "object",
+      "x-method": "mail/create",
+      "x-tier": "extension",
+      "description": "Create a new conversation",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "mail/create" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "type": { "$ref": "#/$defs/ConversationType" },
+            "subject": { "type": "string" },
+            "parentConversationId": { "$ref": "#/$defs/ConversationId" },
+            "parentTurnId": { "$ref": "#/$defs/TurnId" },
+            "initialParticipants": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": { "$ref": "#/$defs/ParticipantId" },
+                  "role": { "$ref": "#/$defs/ParticipantRole" },
+                  "permissions": { "$ref": "#/$defs/ConversationPermissions" }
+                },
+                "required": ["id"]
+              }
+            },
+            "initialTurn": {
+              "type": "object",
+              "properties": {
+                "contentType": { "type": "string" },
+                "content": {},
+                "visibility": { "$ref": "#/$defs/TurnVisibility" }
+              },
+              "required": ["contentType", "content"]
+            },
+            "metadata": { "type": "object" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          }
+        }
+      },
+      "required": ["jsonrpc", "id", "method"]
+    },
+    "MailCreateResponse": {
+      "type": "object",
+      "properties": {
+        "conversation": { "$ref": "#/$defs/Conversation" },
+        "participant": { "$ref": "#/$defs/ConversationParticipant" },
+        "initialTurn": { "$ref": "#/$defs/Turn" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["conversation", "participant"]
+    },
+    "MailGetRequest": {
+      "type": "object",
+      "x-method": "mail/get",
+      "x-tier": "extension",
+      "description": "Get conversation details",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "mail/get" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "conversationId": { "$ref": "#/$defs/ConversationId" },
+            "include": {
+              "type": "object",
+              "properties": {
+                "participants": { "type": "boolean" },
+                "threads": { "type": "boolean" },
+                "recentTurns": { "type": "integer" },
+                "stats": { "type": "boolean" }
+              }
+            },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["conversationId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "MailGetResponse": {
+      "type": "object",
+      "properties": {
+        "conversation": { "$ref": "#/$defs/Conversation" },
+        "participants": { "type": "array", "items": { "$ref": "#/$defs/ConversationParticipant" } },
+        "threads": { "type": "array", "items": { "$ref": "#/$defs/Thread" } },
+        "recentTurns": { "type": "array", "items": { "$ref": "#/$defs/Turn" } },
+        "stats": {
+          "type": "object",
+          "properties": {
+            "totalTurns": { "type": "integer" },
+            "turnsByContentType": { "type": "object" },
+            "activeParticipants": { "type": "integer" },
+            "threadCount": { "type": "integer" }
+          }
+        },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["conversation"]
+    },
+    "MailListRequest": {
+      "type": "object",
+      "x-method": "mail/list",
+      "x-tier": "extension",
+      "description": "List conversations with filtering",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "mail/list" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "filter": {
+              "type": "object",
+              "properties": {
+                "type": { "type": "array", "items": { "$ref": "#/$defs/ConversationType" } },
+                "status": { "type": "array", "items": { "$ref": "#/$defs/ConversationStatus" } },
+                "participantId": { "$ref": "#/$defs/ParticipantId" },
+                "createdAfter": { "$ref": "#/$defs/Timestamp" },
+                "createdBefore": { "$ref": "#/$defs/Timestamp" },
+                "parentConversationId": { "$ref": "#/$defs/ConversationId" }
+              }
+            },
+            "limit": { "type": "integer", "minimum": 1 },
+            "cursor": { "type": "string" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          }
+        }
+      },
+      "required": ["jsonrpc", "id", "method"]
+    },
+    "MailListResponse": {
+      "type": "object",
+      "properties": {
+        "conversations": { "type": "array", "items": { "$ref": "#/$defs/Conversation" } },
+        "nextCursor": { "type": "string" },
+        "hasMore": { "type": "boolean" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["conversations", "hasMore"]
+    },
+    "MailCloseRequest": {
+      "type": "object",
+      "x-method": "mail/close",
+      "x-tier": "extension",
+      "description": "Close a conversation",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "mail/close" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "conversationId": { "$ref": "#/$defs/ConversationId" },
+            "reason": { "type": "string" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["conversationId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "MailCloseResponse": {
+      "type": "object",
+      "properties": {
+        "conversation": { "$ref": "#/$defs/Conversation" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["conversation"]
+    },
+    "MailJoinRequest": {
+      "type": "object",
+      "x-method": "mail/join",
+      "x-tier": "extension",
+      "description": "Join a conversation",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "mail/join" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "conversationId": { "$ref": "#/$defs/ConversationId" },
+            "role": { "$ref": "#/$defs/ParticipantRole" },
+            "catchUp": {
+              "type": "object",
+              "properties": {
+                "from": { "oneOf": [{ "type": "string" }, { "type": "number" }] },
+                "limit": { "type": "integer" },
+                "includeSummary": { "type": "boolean" }
+              }
+            },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["conversationId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "MailJoinResponse": {
+      "type": "object",
+      "properties": {
+        "conversation": { "$ref": "#/$defs/Conversation" },
+        "participant": { "$ref": "#/$defs/ConversationParticipant" },
+        "history": { "type": "array", "items": { "$ref": "#/$defs/Turn" } },
+        "historyCursor": { "type": "string" },
+        "summary": { "type": "string" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["conversation", "participant"]
+    },
+    "MailLeaveRequest": {
+      "type": "object",
+      "x-method": "mail/leave",
+      "x-tier": "extension",
+      "description": "Leave a conversation",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "mail/leave" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "conversationId": { "$ref": "#/$defs/ConversationId" },
+            "reason": { "type": "string" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["conversationId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "MailLeaveResponse": {
+      "type": "object",
+      "properties": {
+        "success": { "type": "boolean" },
+        "leftAt": { "$ref": "#/$defs/Timestamp" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["success", "leftAt"]
+    },
+    "MailInviteRequest": {
+      "type": "object",
+      "x-method": "mail/invite",
+      "x-tier": "extension",
+      "description": "Invite a participant to a conversation",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "mail/invite" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "conversationId": { "$ref": "#/$defs/ConversationId" },
+            "participant": {
+              "type": "object",
+              "properties": {
+                "id": { "$ref": "#/$defs/ParticipantId" },
+                "role": { "$ref": "#/$defs/ParticipantRole" },
+                "permissions": { "$ref": "#/$defs/ConversationPermissions" }
+              },
+              "required": ["id"]
+            },
+            "message": { "type": "string" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["conversationId", "participant"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "MailInviteResponse": {
+      "type": "object",
+      "properties": {
+        "invited": { "type": "boolean" },
+        "participant": { "$ref": "#/$defs/ConversationParticipant" },
+        "invitationId": { "type": "string" },
+        "pending": { "type": "boolean" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["invited"]
+    },
+    "MailTurnRequest": {
+      "type": "object",
+      "x-method": "mail/turn",
+      "x-tier": "extension",
+      "description": "Record a turn in a conversation",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "mail/turn" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "conversationId": { "$ref": "#/$defs/ConversationId" },
+            "contentType": { "type": "string" },
+            "content": {},
+            "threadId": { "$ref": "#/$defs/ThreadId" },
+            "inReplyTo": { "$ref": "#/$defs/TurnId" },
+            "visibility": { "$ref": "#/$defs/TurnVisibility" },
+            "metadata": { "type": "object" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["conversationId", "contentType", "content"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "MailTurnResponse": {
+      "type": "object",
+      "properties": {
+        "turn": { "$ref": "#/$defs/Turn" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["turn"]
+    },
+    "MailTurnsListRequest": {
+      "type": "object",
+      "x-method": "mail/turns/list",
+      "x-tier": "extension",
+      "description": "List turns in a conversation",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "mail/turns/list" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "conversationId": { "$ref": "#/$defs/ConversationId" },
+            "filter": {
+              "type": "object",
+              "properties": {
+                "threadId": { "$ref": "#/$defs/ThreadId" },
+                "includeAllThreads": { "type": "boolean" },
+                "contentTypes": { "type": "array", "items": { "type": "string" } },
+                "participantId": { "$ref": "#/$defs/ParticipantId" },
+                "afterTurnId": { "$ref": "#/$defs/TurnId" },
+                "beforeTurnId": { "$ref": "#/$defs/TurnId" },
+                "afterTimestamp": { "$ref": "#/$defs/Timestamp" },
+                "beforeTimestamp": { "$ref": "#/$defs/Timestamp" }
+              }
+            },
+            "limit": { "type": "integer", "minimum": 1 },
+            "order": { "type": "string", "enum": ["asc", "desc"] },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["conversationId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "MailTurnsListResponse": {
+      "type": "object",
+      "properties": {
+        "turns": { "type": "array", "items": { "$ref": "#/$defs/Turn" } },
+        "hasMore": { "type": "boolean" },
+        "nextCursor": { "type": "string" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["turns", "hasMore"]
+    },
+    "MailThreadCreateRequest": {
+      "type": "object",
+      "x-method": "mail/thread/create",
+      "x-tier": "extension",
+      "description": "Create a thread within a conversation",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "mail/thread/create" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "conversationId": { "$ref": "#/$defs/ConversationId" },
+            "rootTurnId": { "$ref": "#/$defs/TurnId" },
+            "subject": { "type": "string" },
+            "parentThreadId": { "$ref": "#/$defs/ThreadId" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["conversationId", "rootTurnId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "MailThreadCreateResponse": {
+      "type": "object",
+      "properties": {
+        "thread": { "$ref": "#/$defs/Thread" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["thread"]
+    },
+    "MailThreadListRequest": {
+      "type": "object",
+      "x-method": "mail/thread/list",
+      "x-tier": "extension",
+      "description": "List threads in a conversation",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "mail/thread/list" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "conversationId": { "$ref": "#/$defs/ConversationId" },
+            "parentThreadId": { "$ref": "#/$defs/ThreadId" },
+            "limit": { "type": "integer", "minimum": 1 },
+            "cursor": { "type": "string" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["conversationId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "MailThreadListResponse": {
+      "type": "object",
+      "properties": {
+        "threads": { "type": "array", "items": { "$ref": "#/$defs/Thread" } },
+        "hasMore": { "type": "boolean" },
+        "nextCursor": { "type": "string" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["threads", "hasMore"]
+    },
+    "MailSummaryRequest": {
+      "type": "object",
+      "x-method": "mail/summary",
+      "x-tier": "extension",
+      "description": "Get or generate a conversation summary",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "mail/summary" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "conversationId": { "$ref": "#/$defs/ConversationId" },
+            "scope": {
+              "type": "object",
+              "properties": {
+                "fromTurnId": { "$ref": "#/$defs/TurnId" },
+                "toTurnId": { "$ref": "#/$defs/TurnId" },
+                "threadId": { "$ref": "#/$defs/ThreadId" }
+              }
+            },
+            "regenerate": { "type": "boolean" },
+            "include": {
+              "type": "object",
+              "properties": {
+                "keyPoints": { "type": "boolean" },
+                "keyDecisions": { "type": "boolean" },
+                "openQuestions": { "type": "boolean" },
+                "participants": { "type": "boolean" }
+              }
+            },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["conversationId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "MailSummaryResponse": {
+      "type": "object",
+      "properties": {
+        "summary": { "type": "string" },
+        "keyPoints": { "type": "array", "items": { "type": "string" } },
+        "keyDecisions": { "type": "array", "items": { "type": "string" } },
+        "openQuestions": { "type": "array", "items": { "type": "string" } },
+        "generated": { "type": "boolean" },
+        "cachedAt": { "$ref": "#/$defs/Timestamp" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["summary", "generated"]
+    },
+    "MailReplayRequest": {
+      "type": "object",
+      "x-method": "mail/replay",
+      "x-tier": "extension",
+      "description": "Replay conversation turns from a point",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "mail/replay" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "conversationId": { "$ref": "#/$defs/ConversationId" },
+            "fromTurnId": { "$ref": "#/$defs/TurnId" },
+            "fromTimestamp": { "$ref": "#/$defs/Timestamp" },
+            "threadId": { "$ref": "#/$defs/ThreadId" },
+            "limit": { "type": "integer", "minimum": 1 },
+            "contentTypes": { "type": "array", "items": { "type": "string" } },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["conversationId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "MailReplayResponse": {
+      "type": "object",
+      "properties": {
+        "turns": { "type": "array", "items": { "$ref": "#/$defs/Turn" } },
+        "hasMore": { "type": "boolean" },
+        "nextCursor": { "type": "string" },
+        "missedCount": { "type": "integer" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["turns", "hasMore", "missedCount"]
+    },
+
+    "CredGetRequest": {
+      "type": "object",
+      "x-method": "cred/get",
+      "x-tier": "extension",
+      "description": "Request a short-lived credential for a scope and resource",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "cred/get" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "scope": { "type": "string", "description": "Scope to request (e.g. 'github:repo:write')" },
+            "resource": { "type": "string", "description": "Resource to access (e.g. 'acme-corp/frontend')" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["scope", "resource"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "CredGetResponse": {
+      "type": "object",
+      "description": "Response to cred/get",
+      "properties": {
+        "credentialType": {
+          "type": "string",
+          "enum": ["bearer_token", "aws_credentials", "api_key"],
+          "description": "Type of credential returned"
+        },
+        "credential": { "type": "object", "description": "Provider-specific credential data" },
+        "expiresAt": { "type": "string", "format": "date-time", "description": "When the credential expires (ISO 8601)" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["credentialType", "credential"]
+    },
+    "CredListRequest": {
+      "type": "object",
+      "x-method": "cred/list",
+      "x-tier": "extension",
+      "description": "List available scopes for the authenticated token",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "cred/list" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "_meta": { "$ref": "#/$defs/Meta" }
+          }
+        }
+      },
+      "required": ["jsonrpc", "id", "method"]
+    },
+    "CredListResponse": {
+      "type": "object",
+      "description": "Response to cred/list",
+      "properties": {
+        "agentId": { "type": "string", "description": "Agent ID from the authenticated token" },
+        "scopes": { "type": "array", "items": { "type": "string" }, "description": "Available scopes" },
+        "constraints": { "type": "object", "description": "Token constraints" },
+        "expiresAt": { "type": "string", "format": "date-time", "description": "Token expiration" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["agentId", "scopes"]
+    },
+    "CredStatusRequest": {
+      "type": "object",
+      "x-method": "cred/status",
+      "x-tier": "extension",
+      "description": "Check credential broker status and available providers",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "cred/status" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "_meta": { "$ref": "#/$defs/Meta" }
+          }
+        }
+      },
+      "required": ["jsonrpc", "id", "method"]
+    },
+    "CredStatusResponse": {
+      "type": "object",
+      "description": "Response to cred/status",
+      "properties": {
+        "providers": { "type": "array", "items": { "type": "string" }, "description": "Available credential providers" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["providers"]
+    },
+
+    "WorkspaceSearchRequest": {
+      "type": "object",
+      "x-method": "workspace/search",
+      "x-tier": "extension",
+      "description": "Search for files matching a query in an agent's workspace",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "workspace/search" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "agentId": { "type": "string", "description": "Agent whose workspace to search" },
+            "query": { "type": "string", "description": "Search query (matched against filenames)" },
+            "cwd": { "type": "string", "description": "Subdirectory to search within (relative to workspace root)" },
+            "limit": { "type": "integer", "description": "Max results to return (default 50)" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["agentId", "query"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "WorkspaceSearchResponse": {
+      "type": "object",
+      "description": "Response to workspace/search",
+      "properties": {
+        "files": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/WorkspaceFileResult" },
+          "description": "Matching files"
+        },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["files"]
+    },
+    "WorkspaceListRequest": {
+      "type": "object",
+      "x-method": "workspace/list",
+      "x-tier": "extension",
+      "description": "List files in a directory of an agent's workspace",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "workspace/list" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "agentId": { "type": "string", "description": "Agent whose workspace to list" },
+            "directory": { "type": "string", "description": "Directory to list (relative to workspace root, default '.')" },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["agentId"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "WorkspaceListResponse": {
+      "type": "object",
+      "description": "Response to workspace/list",
+      "properties": {
+        "files": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/WorkspaceFileResult" },
+          "description": "Files in the directory"
+        },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["files"]
+    },
+    "WorkspaceReadRequest": {
+      "type": "object",
+      "x-method": "workspace/read",
+      "x-tier": "extension",
+      "description": "Read file contents from an agent's workspace",
+      "properties": {
+        "jsonrpc": { "$ref": "#/$defs/JsonRpcVersion" },
+        "id": { "$ref": "#/$defs/RequestId" },
+        "method": { "const": "workspace/read" },
+        "params": {
+          "type": "object",
+          "properties": {
+            "agentId": { "type": "string", "description": "Agent whose workspace to read from" },
+            "path": { "type": "string", "description": "File path relative to workspace root" },
+            "lineRange": {
+              "type": "object",
+              "description": "Optional line range to read (1-indexed)",
+              "properties": {
+                "start": { "type": "integer", "description": "Start line (1-indexed, inclusive)" },
+                "end": { "type": "integer", "description": "End line (1-indexed, inclusive)" }
+              },
+              "required": ["start", "end"]
+            },
+            "_meta": { "$ref": "#/$defs/Meta" }
+          },
+          "required": ["agentId", "path"]
+        }
+      },
+      "required": ["jsonrpc", "id", "method", "params"]
+    },
+    "WorkspaceReadResponse": {
+      "type": "object",
+      "description": "Response to workspace/read",
+      "properties": {
+        "text": { "type": "string", "description": "File text content" },
+        "mime": { "type": "string", "description": "MIME type" },
+        "size": { "type": "integer", "description": "File size in bytes" },
+        "_meta": { "$ref": "#/$defs/Meta" }
+      },
+      "required": ["text", "mime", "size"]
+    },
+    "WorkspaceFileResult": {
+      "type": "object",
+      "description": "A file or directory entry in a workspace",
+      "properties": {
+        "path": { "type": "string", "description": "Relative path from workspace root" },
+        "isDirectory": { "type": "boolean", "description": "Whether this is a directory" },
+        "size": { "type": "integer", "description": "File size in bytes (undefined for directories)" },
+        "mime": { "type": "string", "description": "MIME type guess based on extension" }
+      },
+      "required": ["path", "isDirectory"]
+    },
+
+    "MAPAgentCapabilityDescriptor": {
+      "type": "object",
+      "description": "Structured capability descriptor for rich agent discovery",
+      "properties": {
+        "id": { "type": "string", "description": "Globally unique capability descriptor ID (e.g., 'urn:map:cap:code-review')" },
+        "version": { "type": "string", "description": "Semantic version of the capability descriptor" },
+        "name": { "type": "string", "description": "Human-readable name" },
+        "description": { "type": "string", "description": "Human-readable description" },
+        "capabilities": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/MAPCapabilityDeclaration" },
+          "description": "Individual capabilities this agent provides"
+        },
+        "tags": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Semantic tags for categorization (e.g., 'code', 'review', 'testing')"
+        },
+        "accepts": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/MAPInterfaceSpec" },
+          "description": "Input interfaces this agent accepts"
+        },
+        "provides": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/MAPInterfaceSpec" },
+          "description": "Output interfaces this agent provides"
+        }
+      }
+    },
+    "MAPCapabilityDeclaration": {
+      "type": "object",
+      "description": "A single capability declared by an agent",
+      "properties": {
+        "id": { "type": "string", "description": "Capability identifier (e.g., 'code-review', 'translation')" },
+        "version": { "type": "string", "description": "Capability version" },
+        "description": { "type": "string" },
+        "interfaces": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/MAPInterfaceSpec" },
+          "description": "Interfaces for this specific capability"
+        }
+      },
+      "required": ["id"]
+    },
+    "MAPInterfaceSpec": {
+      "type": "object",
+      "description": "Content type interface specification",
+      "properties": {
+        "contentType": { "type": "string", "description": "MIME type (e.g., 'application/json', 'text/plain')" },
+        "schema": { "type": "string", "description": "Optional JSON Schema URI for the content" },
+        "description": { "type": "string" }
+      },
+      "required": ["contentType"]
+    },
+
+    "DIDDocument": {
+      "type": "object",
+      "description": "W3C DID Document for did:wba method",
+      "properties": {
+        "@context": {
+          "oneOf": [
+            { "type": "string" },
+            { "type": "array", "items": { "type": "string" } }
+          ]
+        },
+        "id": { "type": "string", "description": "The DID (e.g., 'did:wba:agents.example.com:gateway')" },
+        "verificationMethod": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/DIDVerificationMethod" }
+        },
+        "authentication": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Key references for authentication (e.g., 'did:wba:...#key-1')"
+        },
+        "service": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/DIDService" }
+        }
+      },
+      "required": ["id"]
+    },
+    "DIDVerificationMethod": {
+      "type": "object",
+      "description": "A verification method in a DID Document",
+      "properties": {
+        "id": { "type": "string" },
+        "type": { "type": "string", "description": "Key type (e.g., 'JsonWebKey2020')" },
+        "controller": { "type": "string" },
+        "publicKeyJwk": { "type": "object", "description": "Public key in JWK format" }
+      },
+      "required": ["id", "type", "controller"]
+    },
+    "DIDService": {
+      "type": "object",
+      "description": "A service endpoint in a DID Document",
+      "properties": {
+        "id": { "type": "string" },
+        "type": { "type": "string", "description": "Service type (e.g., 'MAPFederationEndpoint')" },
+        "serviceEndpoint": {
+          "oneOf": [
+            { "type": "string" },
+            { "type": "object" }
+          ]
+        },
+        "mapProtocolVersion": { "type": "integer" },
+        "mapCapabilities": { "type": "object" }
+      },
+      "required": ["id", "type", "serviceEndpoint"]
+    },
+    "DIDWBAProof": {
+      "type": "object",
+      "description": "Cryptographic proof for DID:WBA authentication",
+      "properties": {
+        "type": { "type": "string", "description": "Proof type (e.g., 'JsonWebSignature2020')" },
+        "created": { "type": "string", "format": "date-time", "description": "ISO 8601 timestamp" },
+        "challenge": { "type": "string", "description": "Server-provided challenge nonce" },
+        "jws": { "type": "string", "description": "JWS compact serialization of the proof signature" }
+      },
+      "required": ["type", "created", "challenge", "jws"]
+    },
+    "DIDWBACredentials": {
+      "type": "object",
+      "description": "Federation auth credentials using did:wba",
+      "properties": {
+        "method": { "const": "did:wba" },
+        "metadata": {
+          "type": "object",
+          "properties": {
+            "did": { "type": "string", "description": "The DID of the authenticating system" },
+            "proof": { "$ref": "#/$defs/DIDWBAProof" }
+          },
+          "required": ["did", "proof"]
+        }
+      },
+      "required": ["method", "metadata"]
     }
   }
 }